CGA 编辑器

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

CGA 编辑器

CGA 编辑器窗口 CGA 编辑器 中,可以写入、修改和保存 CGA 规则。 要编辑 CGA 规则,请执行以下操作:

  1. 打开 CGA 规则文件。
    • 双击导航器窗口 导航器 中的规则文件。
    • 如果所选对象已分配规则文件,请在检查器窗口 检查器 中单击规则文件
  2. 进行必要的编辑。
  3. Ctrl+S 以保存 CGA 规则文件,或者单击主菜单中的文件 > 保存
注:
  • CGA 编辑器窗口 CGA 编辑器 突出显示了语法,以提高代码的可读性。
  • CGA 编辑器窗口 CGA 编辑器 可以检测语法错误,并在红色背景上以白色 X 突出显示错误。 在主菜单中单击窗口 > 显示问题以获取语法错误列表。
  • 输入时按 Ctrl+空格键以完成命令。

管理规则错误和警告

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

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

注:

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

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

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

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

在这种情况下,未定义规则 NewRule。 这不一定是问题。 警告指示存在潜在问题,但仍允许生成。

问题视图

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

模型错误
显示一个模型错误。

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

未找到资产错误
显示未找到资产错误。

配置

可以根据您的喜好和需求配置问题窗口 问题。 建议的设置如下:

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

代码完成

CGA 编辑器窗口 CGA 编辑器 具有自动完成代码的功能。 在 CGA 代码中的任何位置,您都可以按 Ctrl+空格键,随即显示一个弹出窗口,其中包含与当前上下文匹配的建议。 可以使用光标键或鼠标选择一项。

键盘快捷键

使用 CGA 编辑器 CGA 编辑器 的键盘快捷键包括:

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

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