CGA 属性—ArcGIS CityEngine 资源

属性是在具有以下属性的规则文件中定义的一组全局变量：

相对于规则文件的范围而言，这些属性为全局属性。
每个属性都将在规则文件中初始化为一个特定的值。
可以基于每个形状单独更改属性值。

您可以在检查器窗口的规则窗格中执行此操作。

注：

不同于函数，系统在生成过程开始时仅会评估一次属性。

示例

attr height = 150
attr landuse = "residential"

Lot --> extrude(height) Envelope(landuse)

在本例中，使用 attr 关键字定义了两个属性：height（其类型为浮点型）和 landuse（其类型为字符串型）。这些属性将在 Lot 规则中使用。

属性也可以是条件属性或随机属性：

attr landuse = 50% : "residential" 
               else : "industrial"

在本例中，landuse 有 50% 的可能性被评估为 "residential"，还有 50% 的可能性被评估为 "industrial"。对于每种形状，系统都会评估一次条件或随机属性，并在生成过程中使其保持不变。

同样，您可以使用 rand() 函数：

attr height = rand(30,50)

Lot --> extrude(height) Envelope

Envelope --> 
    case height < 40 : SmallBuilding
    else: LargeBuilding

对于每个开始规则为 Lot 的形状，height 的估算值将介于 30 到 50 个单位之间。该高度为恒定值，且可用于规则文件中的任意位置。

注：

您可以单击并编辑该值，或使用滑块修改该值。有关使用不同的源控制规则属性输入的详细信息，请参阅使用连接编辑器映射属性。
可以通过 CGA 注记来控制检查器窗口中属性的显示。
您可以使用交互式控点在 3D 视图中编辑属性。

在“检查器”窗口中更改属性

您可以在检查器窗口中针对每个初始形状单独设置标有 attr 的函数值。例如，下面的定义将在规则参数部分中产生一个条目。

@Range(min=10, max=40)
attr height = 20

使用材料属性

由于 CGA 材料包含多种属性，因此可以使用 .cgamat 文件来管理 CGA 材料。通常使用 CGA 材料编码器创建这些文件，可通过模型导出器访问该编码器。

version "2024.0"

@MaterialFile
attr myMaterial = "/ESRI.lib/assets/Materials/Architectural/Walls/Brick/Brick_StretcherBond_10x10_Black.cgamat"

Init -->
	primitiveCube()
	setMaterial(readMaterial(myMaterial))

为 CGA 模型分配材料的典型工作流涉及显示相应字符串属性，这些属性表示 .cgamat 文件的路径。例如，以上规则将 ESRI.lib 中其中一种材料的路径分配给 myMaterial 属性。 readMaterial 函数将读取该材料文件，并将其转换为可传递给 setMaterial 操作的键值对数组。

可以使用 @MaterialFile 注记来注释字符串属性，该注记可为属性启用材料浏览器窗口。要访问材料浏览器窗口，请单击材料按钮，或从检查器窗口的下拉菜单中单击浏览器。