Sketchup::ComponentDefinition
类是 SketchUp Ruby API 中用于表示组件定义的类。每个组件都有一个对应的组件定义,它包含了组件的几何形状以及与之关联的材质、纹理等信息。
下面是该类的一些常用方法:
entities
: 返回一个指向组件定义中实体集合的引用。可以使用此方法访问和操作组件中的实体。name
: 返回组件定义的名称。name=
: 设置组件定义的名称。description
: 返回组件定义的描述信息。description=
: 设置组件定义的描述信息。count_instances
: 返回当前场景中使用该组件定义的实例数。instances
: 返回一个数组,包含当前场景中使用该组件定义的所有实例。bounds
: 返回一个包围盒,用于表示组件定义的边界。
例如,要创建一个新的组件定义并设置其名称和描述,可以按照以下步骤进行:
# 创建一个新的组件定义并获取对实体集合的引用
cd = Sketchup.active_model.definitions.add("MyComponent").entities
# 设置组件定义的名称和描述
cd.name = "MyComponent"
cd.description = "This is my component."
在上面的例子中,我们首先创建了一个名为 MyComponent
的新组件定义,并获取了对其中实体集合的引用。然后,我们使用 name
和 description
方法设置了组件定义的名称和描述信息。
您还可以使用该类的其他方法来访问和操作组件定义,以实现更为复杂的功能。有关 Sketchup::ComponentDefinition
类的详细信息,请参阅 SketchUp Ruby API 文档。