Sketchup::ComponentDefinition类介绍及所有方法

Sketchup::ComponentDefinition 类是 SketchUp Ruby API 中用于表示组件定义的类。每个组件都有一个对应的组件定义,它包含了组件的几何形状以及与之关联的材质、纹理等信息。

下面是该类的一些常用方法:

  1. entities: 返回一个指向组件定义中实体集合的引用。可以使用此方法访问和操作组件中的实体。
  2. name: 返回组件定义的名称。
  3. name=: 设置组件定义的名称。
  4. description: 返回组件定义的描述信息。
  5. description=: 设置组件定义的描述信息。
  6. count_instances: 返回当前场景中使用该组件定义的实例数。
  7. instances: 返回一个数组,包含当前场景中使用该组件定义的所有实例。
  8. bounds: 返回一个包围盒,用于表示组件定义的边界。

例如,要创建一个新的组件定义并设置其名称和描述,可以按照以下步骤进行:

# 创建一个新的组件定义并获取对实体集合的引用
cd = Sketchup.active_model.definitions.add("MyComponent").entities

# 设置组件定义的名称和描述
cd.name = "MyComponent"
cd.description = "This is my component."

在上面的例子中,我们首先创建了一个名为 MyComponent 的新组件定义,并获取了对其中实体集合的引用。然后,我们使用 namedescription 方法设置了组件定义的名称和描述信息。

您还可以使用该类的其他方法来访问和操作组件定义,以实现更为复杂的功能。有关 Sketchup::ComponentDefinition 类的详细信息,请参阅 SketchUp Ruby API 文档。