CityEngine规则变量详解：自定义、分组与显示

在CityEngine规则中，变量的定义和显示是关键要素，允许用户自定义变量值并控制其在规则文件中的展示方式。规则文件通过一系列关键字来管理这些变量，以增强用户体验和工作效率。 首先，`@Group`关键字用于控制变量的分组。它接受三个参数：组名、子组名（可选）和顶级组名。例如，`@Group("level_1-group", "Node_1")`会将变量`height`放入`Main`组的`Node_1`子组，这样可以在属性窗口中清晰地组织和查找变量。分组不仅有助于视觉上的层次结构，还能帮助用户更快地定位到所需的变量。 `@Order`关键字用于设定变量在组内的排序顺序。通过指定负数作为参数值，如`@Order(-1)`，变量会被放置到组的末尾，实现自定义的排列顺序，这对于逻辑清晰和操作便捷至关重要。 `@Description`允许为变量添加鼠标提示（MouseTips），即在鼠标悬停时显示的描述信息，有助于提供变量的上下文信息，提升用户的理解度。 `@File`和`@Color`这两个关键字分别用于定义变量值为文件选择器和颜色选择器的形式。前者允许用户从文件系统中选择文件，后者则让用户选择预设的颜色或输入自定义颜色。这些特性为用户提供了灵活性，便于设置和调整与视觉效果相关的变量值。 最后，`@Range`关键字用于设定变量的值域。对于数值型变量，它可以指定一个范围，如`@Range(5, 50)`；对于字符或枚举类型的变量，可以设置一系列预定义的选项，如`@Range(Low="Low", Mid="Mid", High="High")`或`@Range(Red="#ff0000", Green="#00ff00", Blue="#0000ff")`。这有助于确保变量值在合理范围内，并提供了直观的交互界面。 CityEngine规则中的变量定义和显示功能允许用户精细地定制规则，提高工作流程的效率和一致性。通过熟练运用这些关键字，开发者和设计师能够创建出更易理解和使用的规则，提升项目质量和用户体验。