ESRI.lib

ESRI.lib 是一个 CityEngine 工程，其中包含由大量有用资源（例如 CGA 规则和资产）组成的库。 它将自动安装在 CityEngine 工作空间中，并且可以在导航器中找到。

导航器中的 ESRI.lib

您可以应用规则并按原样使用资产，也可以将规则导入您自己的规则中。 例如，将 Plant_Loader.cga 规则应用于场景中的形状将会在该形状上插入植物模型。 在检查器中，可以调整该形状的属性，例如植物物种和高度。 或者，可以将 Plant_Loader.cga 规则导入到其中一个 CGA 文件中，然后使用 CGA 来控制植物模型的插入并设置物种、高度和其他属性。

 

建筑物

在使用建筑物规则时，可以创建不同类型的 3D 建筑物模型。 将 Building_From_Footprint.cga 规则应用于 2D 建筑物覆盖区以生成合理的 3D 建筑物模型。 Building_From_OpenStreetMap.cga 规则将自动应用于使用获取地图数据下载的 2D 面。 该规则与 Building_From_Footprint.cga 规则相同，但是还会根据可用性使用 OpenStreetMap 数据（height、building:levels、roof:height、roof:shape、building:colour、roof:colour）来确定建筑物高度、屋顶形态、层数、建筑物颜色以及屋顶颜色。 将 3D 质量模型作为初始形状时，请应用 Building_Mass_Texturizer.cga 规则。

显示根据覆盖区（左）、OpenStreetMap 数据（中）以及 3D 体量模型（右）生成的建筑物。

 

植物

将植被模型插入场景或模型中。 ESRI.lib Vegetation 库是跨平台共享的 Webstyle。 该库包含各种物种，包括阔叶树、针叶树和棕榈树，适用于实际、逻辑示意图或扇形表示中。 可以使用 Plant_Loader.cga 规则插入单个植物模型，或者使用 Plant_Distributor.cga 规则将多个植物分散在一个区域上。

显示实际（左）、逻辑示意图（中）和扇形（右）植被模型。

 

街道

将规则应用于动态街道形状以生成纹理化街道。 Street_Modern_Simple.cga 规则将使用车道标记对街道进行纹理处理，而 Street_Modern_Standard.cga 规则还将添加停车标记和人行横道。

显示具有车道的纹理化街道（左）以及具有车道、停车标记和人行横道的纹理化街道（右）。

 

文本

Text.cga 规则将插入可用于标注 3D 模型的文本。 文本将插入范围的 xz 平面中。

已应用文本规则。

 

栅栏

栅栏规则将沿街道形状或面边缘生成栅栏。 可以将 Fence_On_Graph.cga 规则应用于街道形状，以创建随沿街道形状弯曲或越过山体的栅栏。 可以将 Fence_On_Polygon.cga 应用于面以沿输入面的边创建栅栏。 可以通过属性和本地编辑来控制具有栅栏的面边缘。 可以使用预设样式来创建从木栅栏到高速公路障碍的各种栅栏。

显示沿街道形状（左）和面边缘（右）生成的栅栏。

 

城镇

可以使用城市规则来可视化分区规则，并根据规则自动生成建筑物。 可以输入分区规则，例如退缩尺度和天空暴露平面、地块覆盖范围和 FAR 限制，以及建筑物尺寸限制。 此外，可以将建筑物配置添加到规则，用于指定覆盖区形状、楼层数和高度以及质量分配策略。 借助这些约束，城市规则可将建筑物质量模型拟合到宗地上。 您也可以使用此规则来可视化由退缩尺度和天空暴露平面给定的 3D 分区包络。

城市规则已应用于分区区域。

 

材料

材料是 CityEngine 的 cgmat 材料的集合。 材料按 Architectural/Cladding 等应用程序进行组织，并针对无缝分块和性能进行了优化。 文件名表示以米为单位的现实世界尺寸，例如 10 米 X 10 米。

材料显示在导航器窗口中。

 

组件

组件是现成的 CGA 规则，可以合并成单个建筑物或城市街区的完整 VCGA 设计。

可用的组件类别：

站点分区

• 允许根据分区代码对退缩尺度进行编码
• 输入：宗地
• 输出：BuildableArea

体量

• 允许快速生成最常见的块类型
• 按块类型组织
• 输入：BuildableArea
• 输出：质量，码
  显示体量类型。

 

Webstyles

Webstyles 是在整个 Esri 平台上共享的 3D 资产的集合。 这些集合包括 3D 资产，例如植被模型、车辆、街道设施和娱乐设备。

显示 Webstyles。

 

管理 ESRI.lib

要在线更新 ESRI.lib 和 Webstyles，请执行以下操作：

1. 单击主菜单中的文件 > 管理 ESRI.lib。
2. 选择所需包。
3. 单击更新。

   将下载这些包并将其直接安装在当前工作空间中。 Webstyle 资产位于 ESRI.lib/assets/Webstyles 子文件夹中。

ESRI.lib 注意事项

使用 ESRI.lib 时，请考虑以下内容：

• 在使用新版本 CityEngine 打开工作空间时，将自动更新 ESRI.lib。
• 除非您拥有特殊设置，否则每个工作空间都将具有不同的 ESRI.lib 副本。
• 在使用不同版本的 CityEngine 时，建议使用版本匹配的 ESRI.lib 和 Webstyle 库。 CityEngine 通常保持兼容性，但是如果版本不匹配，则规则可能会产生意外结果。
• 要使已安装的 ce.lib 和 ESRI.lib（包括 webstyles）的大小保持最小，您可以将 CITYENGINE_LIB_MINIMAL 环境变量设置为 1。 此举可最大限度减少存在自动生成工作空间和工程的工作流中的磁盘空间占用。

自定义编辑内容

不建议编辑 ESRI.lib 内的文件，因为更新 ESRI.lib 或 CityEngine 会导致文件被覆盖。 要对规则进行自定义编辑，请首先将规则复制到您的工程文件夹中，然后对副本进行相应更改。 对资产的任何引用仍将指回 ESRI.lib，因此，无需将资产复制到您的工程文件夹中。

注：

ESRI.lib 的使用和分发受 CityEngine 安装文件夹中的 Esri 主协议 (EULA) 约束。