Sketchup二次开发教程

Sketchup提供了两套API：

这次我们主要关注Ruby API，因为它是实现更丰富的SU扩展功能的主要方式

不得不承认Sketchup的Ruby API开发文档相对于React，或是Inventor/Revit这些都太不友好了。不过从这篇文档开始我们还是能按图索骥，找到门径。

如果不想读这篇文档，那么也可以遵循如下步骤：

去Github把官方tutorial教程项目clone下来
clone下来之后，直接把tutorial里面的rb源文件拷贝到Sketchup的Plugins目录（e.g. C:\Users\kzhan\AppData\Roaming\SketchUp\SketchUp 2018\SketchUp\Plugins），重启SU，就可以执行tutorial里面的插件了

==》
用VS code把官方tutorial项目打开，阅读代码。代码里有详细的注释，解释了插件代码要怎么写

代码全都是Ruby的，但我觉得也没必要再专门去学Ruby语言了。对着代码看，大部分还是能理解意思。遇到不熟悉的语法可以查Ruby官方文档以及SU的 Ruby API文档
个人查阅过，觉得值得了解的Ruby语法知识点有：

Ruby Syntax
1. Ruby的方法名可以包含！，？这些标点符号。包含！的方法名一般表示这是一个“危险”的操作，包含？的方法名一般表示它会return一个boolean。注意这些是coding convention而不是编译要求
2. Ruby有unless语句，unless [condition] then 中，condition为false，then后面的语句才会执行。且 unless和if 都可以放到待执行表达式的后面，如 a += 1 if a.zero
3. Sketchup::InputPoint.new, Sketchup是module name，InputPoint是class name，此语句new了一个InputPoint对象
4. Ruby调用一个方法时，如果不带参数，则方法后的括号可以省略。e.g. my_method()也可写成my_method
5. 以$开头的变量名是全局变量，以@开头的变量名是类的成员变量（instance variable），以@@开头的变量名是类的静态成员变量（class variable）

从tut_custom_tool的程序结构看，SU插件和Inventor/Revit插件的程序结构其实很相似。它要定义一个custom tool的类，然后实现activate/deactivate/onCancle/onMouseMove/onLButtonDown等方法，在这些方法里实现业务逻辑

从tut_custom_tool的调用的API来看，SU Ruby API还是提供了相当丰富的、封装层次较高的基础设施，包括：

交互操作工具类。如InputPoint类，可完成从屏幕上交互拾取一个点的功能。其pick方法的输入参数还可打开“本次拾取的点与上次拾取的点的连线与坐标轴平行吸附“这样的高级功能。打开后，我们的插件画线工具和原生画直线工具一样，可以红/绿/蓝灯不同颜色的虚线，表示此时推断的连线和哪个坐标轴平行。而这样的交互能力的获取，只需要在调用API时传入一个参数即可
几何造型工具类。如Sketchup.active_model.active_entities.add_line，根据拾取的点在模型上加边；edge.find_faces，用于根据刚加好的边生成面
实现undo/redo管理util，如start_operation/commit_opeation等
视图操作util，如view.tool_tip, Sketchup.status_text, view.invalidate 等直接修改/更新视图对象的方法

感觉按照这样的API能力，SU Ruby API也和Onshape的FeatureScript一样，可以将其原生的建模功能完全用API重写一遍。