CGA(计算机图形架构)是一种独特的 ArcGIS CityEngine 编程语言,您可以指定它来生成城市规划的 3D 内容。 可以使用 CGA 编辑器窗口以创建和修改应用于形状的 CGA 规则,从而创建 3D 几何和架构。
CGA 编辑器
在 CGA 编辑器窗口 中,可以写入、修改和保存 CGA 规则。 要编辑 CGA 规则,请执行以下操作:
- 打开 CGA 规则文件。
- 双击导航器窗口
中的规则文件。
- 如果所选对象已分配规则文件,请在检查器窗口
中单击规则文件。
- 双击导航器窗口
- 进行必要的编辑。
- 按 Ctrl+S 以保存 CGA 规则文件,或者单击主菜单中的文件 > 保存。
注:
- CGA 编辑器窗口
突出显示了语法,以提高代码的可读性。
- CGA 编辑器窗口
可以检测语法错误,并在红色背景上以白色 X 突出显示错误。 在主菜单中单击窗口 > 显示问题以获取语法错误列表。
- 输入时按 Ctrl+空格键以完成命令。
管理规则错误和警告

将自动检测 CGA 代码中的语法错误,并将其标记为红色。
注:
错误的位置由右侧滚动条旁边的一个小红框指示。 可以在问题窗口 中找到有关错误的更多详细信息,将鼠标悬停在 CGA 编辑器窗口
中的红色指示器或错误标记上也可以找到相关详细信息。
应用规则之前,必须先解决错误。 如果分配的规则文件包含错误,则无法生成模型。
CGA 编辑器窗口 还会发出警告:

在这种情况下,未定义规则 NewRule。 这不一定是问题。 警告指示存在潜在问题,但仍允许生成。
问题视图
可以使用窗口 > 显示问题来打开问题窗口 。 在规则错误(静态编译错误)上方,问题窗口
还会显示模型错误(动态运行时错误),即模型生成过程中遇到的问题。 此类错误和警告将取决于规则以及初始形状(即其几何和属性,例如种子等)。 您可通过问题视图查找和解决此类问题。 在以下示例中,生成了大量建筑物,并返回了“未找到资产”错误。

要找到相应的模型或形状,请双击该错误,然后系统将选择并框定模型和形状。 下图显示了初始形状和生成的模型,其中生成导致了“未找到资产”错误。

配置
可以根据您的喜好和需求配置问题窗口 。 建议的设置如下:
- 在问题窗口
中右键单击,然后选择分组依据 > 类型以按错误的类型对其进行分组(即,区分“规则错误”和“模型错误”):
- 点击位置以按位置(即其初始形状)对错误进行排序。
- 右键单击并选择配置内容。
- 取消选择使用项目限制以禁用默认限制 100 个标记。
代码完成
CGA 编辑器窗口 具有自动完成代码的功能。 在 CGA 代码中的任何位置,您都可以按 Ctrl+空格键,随即显示一个弹出窗口,其中包含与当前上下文匹配的建议。 可以使用光标键或鼠标选择一项。
键盘快捷键
使用 CGA 编辑器 的键盘快捷键包括:
- Ctrl+S - 保存文件(在生成之前,必须保存更改;具有更改的文件将在选项卡中使用星号 (*) 标记)。
- Ctrl+G - 生成(所选对象,即形状或模型)。
- Ctrl+F5 - 重新生成所有模型。
- Ctrl+F - 打开“查找/搜索替换”对话框。
- Ctrl+L - 打开“转至行”对话框。
- Ctrl+Shift+L - 显示所有快捷键。
注:
仅当 CGA 编辑器窗口 为当前视图(即其选项卡突出显示)时,这些快捷键才有效。