CGA 编辑器

计算机图形架构 (CGA) 是一种独特的 ArcGIS CityEngine 编程语言，您可以指定它来生成城市规划的 3D 内容。 可以使用 CGA 编辑器窗口 创建和修改应用于形状的 CGA 规则，从而创建 3D 几何和架构。

创建 CGA 规则文件

通过执行以下操作之一打开向导对话框：

• 在导航器窗口中，右键单击任意文件夹，然后选择新建 > CGA 规则文件。
• 在主菜单中，单击文件 > 新建 (Ctrl+N) > CityEngine > CGA 规则文件。

选择目标文件夹和文件名，然后单击完成。

编辑 CGA 规则

要编辑 CGA 规则，请完成以下步骤：

1. 通过执行以下步骤之一打开 CGA 规则文件：
   • 双击导航器窗口 中的规则文件。
   • 如果所选对象已分配规则文件，请在检查器窗口 中单击规则文件。
2. 进行必要的编辑。
3. 按 Ctrl+S 或单击主菜单中的文件 > 保存保存 CGA 规则文件。

代码完成

CGA 编辑器窗口 包含自动完成代码功能，可帮助您编写 CGA 规则。 当您键入内容时，将自动显示上下文相关的建议。 您也可以在任意位置按 Ctrl+空格键以手动触发代码完成。 随即显示一个弹出窗口，其中包含与当前上下文相匹配的建议。 请使用箭头键或鼠标选择一项。

可以在编辑 > 首选项 > CGA 编辑器下的首选项中启用或禁用自动完成代码，也可以在编辑器内单击鼠标右键，然后从快捷菜单中单击首选项。

悬停时显示代码文档

CGA 编辑器窗口 提供悬停时显示代码文档功能，可显示 CGA 函数、运算符和属性的上下文信息。 将鼠标悬停在 CGA 元素上时，弹出窗口将显示相应的 CGA 参考文档，其中包含有效语法、参数和简短描述。

可以在编辑 > 首选项 > CGA 编辑器下的首选项中启用或禁用悬停时显示代码文档。

键盘快捷键

可以在 CGA 编辑器窗口 中使用以下键盘快捷键：

• Ctrl+S - 保存文件（在生成之前，必须保存更改；具有更改的文件将在选项卡中使用星号 (*) 标记）。
• Ctrl+G - 生成所选对象（形状或模型）。
• Ctrl+F5 - 重新生成所有模型。
• Ctrl+F - 打开“查找-搜索替换”对话框。
• Ctrl+L - 打开“转至行”对话框。
• Ctrl+Shift+L - 显示所有快捷键。
• Ctrl+空格键 - 触发代码完成。

注：

仅当 CGA 编辑器窗口 为当前视图（其选项卡突出显示）时，这些快捷键才有效。

管理规则错误和警告

将自动检测 CGA 代码中的语法错误，并将其标记为红色。

显示一个具有语法错误的规则文件。

注：

错误的位置由一侧滚动条旁边的一个小红框指示。 可以在问题窗口 中找到有关错误的更多详细信息，将鼠标悬停在 CGA 编辑器窗口 中的红色指示器或错误标记上也可以找到相关详细信息。

应用规则之前，必须先解决错误。 如果分配的规则文件包含错误，则无法生成模型。

CGA 编辑器窗口 还会发出警告：

显示规则文件未定义警告。

在上图中，NewRule 规则未定义。 这不一定是问题。 警告指示存在潜在问题，但仍允许生成。

问题窗口

要打开问题窗口 ，单击窗口 > 显示问题。 除了规则错误（静态编译错误）之外，问题窗口 还会显示模型错误（动态运行时错误），即模型生成期间遇到的问题。 此类错误和警告将取决于规则以及初始形状（其几何和属性，例如种子等）。 可在问题窗口中查找和解决这些类型的问题。 在下图中，生成了大量建筑物，并返回了“未找到资产”错误。

显示一个模型错误。

要查找相关模型或形状，请双击该错误，即会选中并框定模型和形状。 下图显示了初始形状和生成的模型，其中生成导致了“未找到资产”错误。

显示未找到资产错误。

配置

可根据需要配置问题窗口 。 下面是推荐设置：

• 在问题窗口 中右键单击，然后单击分组依据 > 类型以按错误的类型对其进行分组（区分“规则错误”和“模型错误”）。
• 单击位置按位置（按其初始形状）对错误进行排序。
• 右键单击并单击配置内容。
  • 取消选中使用项目限制以禁用默认限制 100 个标记。