CGA 编辑器

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

编辑 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 编辑器 为当前视图(其选项卡突出显示)时,这些快捷键才有效。