CityEngine规则中变量的定义和显示

 

规则文件可以自定义变量值，而且还可以定义变量的分组、排序、值域等显示方式。以下就列举几个常用的关键字：

1.   1.@Group("level_1-group", ..., "level_n-group")

控制变量的分组，可以将变量在属性窗口中分组显示，并且可以多层分组。

@Group("Main","Node_1") attr height = 20 @Group("Main","Node_2") attr name = "" Lot --> extrude(height)

根据上面代码，我们把height变量分在Main组下的Node_1分组内，name变量分在Main组下的Node_2分组内。在属性窗体中效果如下图：

2.  2. @Order(order)

控制变量在其分组中的排序，其参数值可以为负数，参数值越高，排序越后。

@Group("Main") @Order(0) attr height = 20 @Group("Main") @Order(-1) attr name = "" Lot --> extrude(height)

上面的代码表示将height变量和name变量放在Main组中，name排在height前面，效果如下图：

3.  3. @Description("description")

为变量添加MouseTips信息，当鼠标指向变量时即可显示描述信息，效果如下：

4.  4. @File

将变量值定义成以文件选择器的方式显示，可以利用文件选择窗体来对变量赋值，也可以加入参数：@File("tif")来设置文件选择器的文件类型限制。效果如下：

5.  5. @Color

将变量值定义成以颜色选择器的方式显示，可以利用颜色选择窗体来对变量赋值。效果如下：

6.  6. @Range

用于定于变量的值域，可以定义数值性的范围，也可以定义字符等类型值的属性域。

@Range(5, 50) attr height = 20    @Range(Low="Low", Mid="Mid", High="High") attr size = "" @Range(Red="#ff0000",Green="#00ff00",Blue="#0000ff") attr color = "#000000"

以上代码表示将height变量设置在5至50的范围，将size变量设置了三个值域，分别是Low、Mid、High可选值，将color变量设置了Red、Green、Blue三个可选值。效果如下：