Visual CGA 编辑器是一个基于节点的编程界面，可以简化程序化设计的构建。 它基于随 ESRI.lib 一起发布的一组高级建筑组件和材料，旨在支持可在 VCGA、CGA 和城市环境中使用的多种大体量类型。
下载 VCGA Playground 示例以获取以下内容：
- 多个 VCGA 设计示例。
- 丰富的 CGA 组件库。 CGA 组件是 VCGA 设计中的节点，您可以使用该库来创建自己的设计。
打开 CityEngine 并单击主菜单中的帮助 > 下载教程和示例 > Example VCGA Playground。 将自动下载 Example VCGA Playground 工程并将其添加至您的 CityEngine 工作空间。
您还可以在 ArcGIS Online 上访问 VCGA Playground 示例。 此外，配套视频教程可为您提供入门帮助。
Visual CGA 编辑器
在 Visual CGA 编辑器窗口中，可以编写和修改由 .vcga 扩展标识的 VCGA 设计。 要编辑 VCGA 设计，请执行以下操作：
- 打开 VCGA 设计文件：
- 双击 Navigator 窗口中的设计文件。
- 如果所选对象已分配 VCGA 设计文件，请单击检查器窗口中的规则文件以将其打开。
- 编辑设计。
Visual CGA 编辑器会在每次更改后自动保存 VCGA 设计，并在将其分配给视口窗口中的所选形状时生成 3D 模型。 这意味着无需手动保存和生成 VCGA 设计。
Visual CGA 编辑器节点
Visual CGA 编辑器采用基于节点的系统，其中节点连接在一起以实现程序化设计。 每个节点都具有输入和输出空位，其中圆形空位表示值，方形空位表示形状。
要添加节点，请在 Visual CGA 编辑器窗口中双击任何位置，或者在该窗口中单击鼠标右键并选择添加节点。 由此将打开添加节点对话框。
添加节点对话框具有以下类型的节点：
- 库 - 显示 ESRI.lib 提供的建筑组件。
- 自定义 - 显示位于当前工程 rules 文件夹中的自定义组件。
- 内置 - 显示编辑器提供的内置节点，例如输入、属性、扩展和流控制节点。
此布局可帮助您快速找到并使用不同类型的节点来高效构建程序化设计。
组件节点
Visual CGA 编辑器窗口中的每个组件节点对应于 CGA 或 VCGA 文件。 可以使用右键单击节点时随即显示的节点快捷菜单中的打开组件文件选项直接打开此文件。
主体
每个组件节点的主体包括以下三个不同的空位部分：
- 输入形状空位 - 此空位表示组件的输入形状。
- 扩展空位 - 这些空位表示组件的扩展点形状。
- 属性空位 - 这些空位表示组件的输入参数。 每个空位允许以两种方式设置值：
- 可以创建值或属性节点并将其连接到空位。
- 可以使用在将鼠标悬停在空位上时单击编辑
时随即打开的节点迷你检查器弹出窗口。 最初，每个属性空位均使用组件的默认值，但您可以选择设置新值。
标题栏
在组件节点的标题栏中，存在具有以下功能的按钮：
- 方形按钮用于切换打开或关闭节点。 关闭节点将激活 NIL 操作，该操作用于从形状树中移除输入形状。
- 圆形按钮用于切换组件属性在检查器窗口中的可见性，默认隐藏这些属性。
- 三角形按钮用于在视口窗口中可视化输入形状在优先选择上的范围。
可视化
可以选择一个组件节点，以在视口窗口的优先选择上高亮显示其扩展点：
通过将鼠标悬停在相应输出空位上，您也可以高亮显示单个扩展点。 此功能对于在视口窗口中直观地识别特定的扩展点非常有用。
内置节点
在 Visual CGA 编辑器窗口中，可以使用内置节点（如形状、属性或值节点）来创建 VCGA 设计。
形状节点
形状节点是可视图形的根，无法对其进行删除或克隆。 它表示将规则分配到的形状（在 .cej 场景中）。
输入节点
可以使用以下不同类型的输入节点：
- 值节点：
- 这些节点仅仅提供一个数值。
- 属性节点：
- 这些节点可定义 VCGA 设计的属性，并显示在检查器窗口中。
注：
通过将连接从属性空位拖放到画布中，可以方便地自动创建属性节点。 此操作将打开下拉快捷菜单，由此提供在检查器中链接属性选项。
- 它们可以采用默认属性值，也可以指定新值。
注：
- 默认值取决于已连接的初始形状，并在运行时对其进行评估。 因此，其无法显示在属性节点中。 但是，可以在检查器窗口的规则部分中查看特定形状的默认值。
- 当属性节点采用默认属性值时，它们也会继承其注记。 相反，当属性节点指定新值时，它们允许通过注记编辑器配置自定义注记。
- 这些节点可定义 VCGA 设计的属性，并显示在检查器窗口中。
附加内置节点
您也可以使用以下附加内置节点：
- 扩展节点：
- 这些节点用于指定 VCGA 设计的扩展点。
- 它们可以遵循默认行为实现，也可以定义新的叶子形状。
- 开关节点：
- 开关节点可以通过自定义属性来激活和禁用可视图形内的不同分支。
- 条件流控制节点：
- 这些节点通过属性上的条件语句来激活或禁用可视图形的不同分支。
Visual CGA 编辑器工具栏
Visual CGA 编辑器工具栏包含以下工具：
选择并框选 | 在视口窗口中选择并框选已分配当前 VCGA 设计的对象。 |
分配 | 将当前 VCGA 设计分配给视口窗口中的所选对象。 |
导出 | 导出当前 Visual CGA 设计作为 CGA 规则文件。 |
框选 | 框选所选节点 (F)，如果未选择任何节点，则框选所有节点。 |
放大 | 放大/前推。 |
缩小 | 缩小/后推。 |
查看迷你地图 | 在编辑器中切换迷你地图。 |
管理规则错误
将自动检测 VCGA 文件中的错误，并根据错误类型进行不同的标记。
组件节点错误
组件节点可以显示以下可能的错误状态：
- 错误：文件 *** 已更改 - 请重新加载该节点以解决此错误：此错误指示链接到组件节点的 CGA/VCGA 文件已被修改，从而改变了其签名（例如，已引入、修改或移除属性或扩展）。 可以使用快捷菜单中的重新加载节点选项来修复该错误。
- 错误：文件 *** 包含错误 - 此错误指示链接到组件节点的 CGA/VCGA 文件包含错误。 可以通过手动修复相应 CGA 或 VCGA 文件内的错误来解决此问题。
- 错误：未找到文件 *** - 当已删除或重命名链接到组件节点的 CGA/VCGA 文件时，会出现此错误。 可以通过从快捷菜单中选择更改组件文件来修复此问题。
输入节点错误
输入节点将验证输入的值。 如果验证失败，则将根据节点的类型显示错误。 解释性弹出窗口将提供有关验证失败原因的详细信息。
VCGA 文件错误
当 VCGA 文件内存在编译错误时，窗口选项卡中将显示一个红色十字：
可以在问题窗口（窗口 > 问题）中找到有关该错误的更多详细信息。 应用规则之前，必须先解决错误。 如果分配的规则文件包含错误，则无法生成模型。
快速链接
在 Visual CGA 编辑器窗口中，可以使用导航和键盘快捷键以更加高效地工作。
可以在 CityEngine 首选项中配置全局导航鼠标方案。 由此可自定义节点选择、平移（滚动）和缩放快捷键。
在 Visual CGA 编辑器窗口中工作时，可以使用以下键盘快捷键：
Ctrl+Z | 撤消 |
Ctrl+Y | 恢复 |
Ctrl+A | 选择所有节点 |
Ctrl+C | 将选择内容复制到剪贴板 |
Ctrl+V | 将剪贴板粘贴到画布 |
F | 框选所选节点，如果未选择任何节点，则框选所有节点。 |
空间 | 最大化或最小化 Visual CGA 编辑器窗口 |