Sketchup 逆向工程 (五）从sketchup api入手

系列文章

一、逆向工程
Sketchup 逆向工程（一）逆向分析.skp文件数据结构
Sketchup 逆向工程（二）三维模型数据结构
Sketchup 逆向工程（三）软件逆向工程从何处入手
Sketchup 逆向工程（四）分析结果的利用 钩子 外挂 代码注入

二、OpenGL渲染模型
Python+OpenGL绘制3D模型（一）Python 和 PyQt环境搭建
Python+OpenGL绘制3D模型（二）程序框架PyQt5
Python+OpenGL绘制3D模型（三）程序框架PyQt6
Python+OpenGL绘制3D模型（四）绘制线段
Python+OpenGL绘制3D模型（五）绘制三角面

三、成果
疫情期间关在家里实在没事干，破解了Sketchup，成功做出可以读取并显示.skp文件的程序SuViewer

前言

Sketchup作为目前设计院最为流行的设计软件(非工程制图软件），深受设计师的喜爱，软件小巧，而功能强大，有不少为之开发的插件应运而生，不过呢，关于底层数据结构和工作原理相关的文章少之又少，本文意在填补一下这方面的空缺，通过逆向软件分析，展示软件内部奥秘。本文用到的工具：IDA Pro，Immunity Debugger，Visual Studio （逆向工程三件套）提示：数据结构属于机密数据：

版本问题

sketchup 从2017之后，只有x64的版本，对于逆向分析来说，x64编译出来的反编译难度要大很多，esp ebp edi esi这种看了就知道代码要干什么的寄存器，变成了带编号的通用寄存器，所以反汇编，最好从32位编译版入手。现在官网能下载到最老的C API版本是2015的。

C API

sketchup C API 是一套提供给C语言的接口，主要用来访问.skp文件的数据结构，可以用在standalone程序，包括模型导入/导出插件，缩略图插件，都会用到这个api

如何在主程序插件中用到C API

主程序的插件，主要是Ruby插件，如果要用到C API，可以把Ruby中得到的对象，转给C API来处理，当然，不能直接用C API中全局模型相关的接口，比如SUCreateSketchupModelFromFile，C API中有一个全局对象 ActiveModel，和主程序中的全局对象想在不同的程序段中，所以要以主程序中的ActiveModel来访问数据

api文件组织

这是C-Api的目录，主要用到的接口有：

// initialize.h
// api第一次调用前需要初始化
SU_EXPORT void SUInitialize();
SU_EXPORT void SUTerminate();

模型数据的接口
这个头文件，定义.skp文件顶层的对象SketchupModel，以及SketchupModel中的成员对象，如Entites，Materials，Layers，Camera，OptionManagers，等全局管理器

// model/model.h

// .skp文件的读写操作
SU_RESULT SUModelCreateFromFile(SUModelRef* model, const char* file_path);
SU_RESULT SUModelSaveToFile(SUModelRef model, const char* file_path);


// 模型的所有实体，编组的对象会放在ComponentDefinitions中，这里的对象，只有未成组的零散面或线，点不属于实体对象
SU_RESULT SUModelGetEntities(SUModelRef model,
                             SUEntitiesRef* entities);

SU_RESULT SUModelGetComponentDefinitions(SUModelRef model, size_t len,
                                         SUComponentDefinitionRef components[],
                                         size_t* count);
SU_RESULT SUModelGetMaterials(SUModelRef model, size_t len,
                              SUMaterialRef materials[], size_t* count);
SU_RESULT SUModelGetCamera(SUModelRef model, SUCameraRef* camera);
SU_RESULT SUModelGetLayers(SUModelRef model, size_t len,
                           SULayerRef layers[], size_t* count);

面相关的接口
访问面相关的线，点，并不是直接通过GetEdge访问的，而是通过OuterLoop->EdgeUse->Edge这样的路线访问的

// model/face.h
SU_EXPORT SUFaceRef SUFaceFromEntity(SUEntityRef entity);
SU_RESULT SUFaceGetOuterLoop(SUFaceRef face, SULoopRef* loop);
SU_RESULT SUFaceGetFrontMaterial(SUFaceRef face, SUMaterialRef* material);