SketchUp Ruby API入门指南：由Sugar编著

"SketchUp Ruby API by Sugar" 是一份针对SketchUp这款著名的三维建模软件的官方文档，它详细介绍了如何通过Ruby编程语言与SketchUp进行交互和扩展其功能。SketchUp是一款广泛应用于建筑设计、室内设计、工程制图等领域的专业3D建模工具，而Ruby API则提供了访问SketchUp内部结构和执行高级定制操作的接口。 这份文档分为两个主要部分：AppLevel Classes和Entity Classes。AppLevel Classes涵盖了与应用程序级别交互的核心类，如Sketchup对象（Model）、AttributeDictionary（属性字典）、Axes（坐标轴）等。它们在开发插件或自定义工具时至关重要，帮助开发者控制模型空间、处理用户界面和数据存储。 - Sketchup: 定义了整个应用的上下文环境，包括模型空间和视图管理。 - Model: 表示SketchUp中的模型容器，可以操作模型的几何体、材质和布局。 - AttributeDictionary: 存储模型对象的属性信息，允许开发者读取和修改这些属性。 - Axes: 用于定位和测量模型中的元素，如X、Y、Z轴和笛卡尔坐标系统。 - Animation: 提供动画相关的功能，支持创建和控制模型的运动路径。 - Camera: 控制视图的视角和摄像机设置，允许动态调整观察角度。 - Color: 用于定义模型的颜色和纹理。 - Importer: 实现导入外部3D模型格式的功能。 - LanguageHandler: 管理不同编程语言的集成，使得Ruby API能够与SketchUp其他组件协同工作。 - OptionsManager和OptionsProvider: 负责管理应用程序的全局设置和提供定制选项。 - Set: 代表模型空间中的选择集，用于选择多个元素。 - TextureWriter: 处理纹理的写入和管理。 - View: 创建和控制不同的视图，比如鸟瞰图、剖面图等。 - UVHelper: 提供与UV映射相关的工具，用于处理纹理贴图。 Entity Classes部分则专注于模型中的具体元素，如实体（Entity）、曲线（Curve）、尺寸（Dimension）、边（Edge）和面（Face）等。开发者可以利用这些类来创建、编辑和管理建模组件，如弧线、构造线、组件实例等。此外，文档还包含了如Group（组）、Image（图像）、Material（材质）、Loop（环）、Page（页面）、SectionPlane（截面平面）、ShadowInfo（阴影信息）、Style（样式）、Text（文本）、Texture（纹理）等对象的详细说明。 CollectionClasses和AttributeDictionaries类群则涉及到集合管理和对象的属性组织，而Classifications_class、DefinitionList_class、Entities_class、Layers_class、Materials_class、Pages_class等则是对模型层次结构、分类、层、材料、页面等更细致的管理类。 最后，RenderingOptions_class用于渲染设置，Selection_类则涉及到选择操作的管理。"SketchUp Ruby API by Sugar"文档为开发者提供了一套完整的工具，使他们能够通过Ruby编程语言深度集成和扩展SketchUp的功能，实现自动化任务、脚本化操作和创建定制插件。