ESRI.lib 是一个 CityEngine 工程，其中包含由大量有用资源（例如 CGA 规则和资产）组成的库。 它将自动安装在 CityEngine 工作空间中，并且可以在导航器中找到。
您可以应用规则并按原样使用资产，也可以将规则导入您自己的规则中。 例如，将 Plant_Loader.cga 规则应用于场景中的形状将会在该形状上插入植物模型。 在检查器中，可以调整该形状的属性，例如植物物种和高度。 或者，可以将 Plant_Loader.cga 规则导入到其中一个 CGA 文件中，然后使用 CGA 来控制植物模型的插入并设置物种、高度和其他属性。
Buildings
在使用建筑物规则时，可以创建不同类型的 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 规则。
植物
将植被模型插入场景或模型中。 ESRI.lib Vegetation 库是跨平台共享的 Webstyle。 该库包含各种物种，包括阔叶树、针叶树和棕榈树，适用于实际、逻辑示意图或扇形表示中。 可以使用 Plant_Loader.cga 规则插入单个植物模型，或者使用 Plant_Distributor.cga 规则将多个植物分散在一个区域上。
Streets
将规则应用于动态街道形状以生成纹理化街道。 Street_Modern_Simple.cga 规则将使用车道标记对街道进行纹理处理，而 Street_Modern_Standard.cga 规则还将添加停车标记和人行横道。
文本
Text.cga 规则将插入可用于标注 3D 模型的文本。 文本将插入范围的 xz 平面中。
栅栏
栅栏规则将沿街道形状或面边缘生成栅栏。 可以将 Fence_On_Graph.cga 规则应用于街道形状，以创建随沿街道形状弯曲或越过山体的栅栏。 可以将 Fence_On_Polygon.cga 应用于面以沿输入面的边创建栅栏。 可以通过属性和本地编辑来控制具有栅栏的面边缘。 可以使用预设样式来创建从木栅栏到高速公路障碍的各种栅栏。
城镇
可以使用城市规则来可视化分区规则，并根据规则自动生成建筑物。 可以输入分区规则，例如退缩尺度和天空暴露平面、地块覆盖范围和 FAR 限制，以及建筑物尺寸限制。 此外，可以将建筑物配置添加到规则，用于指定覆盖区形状、楼层数和高度以及质量分配策略。 借助这些约束，城市规则可将建筑物质量模型拟合到宗地上。 您也可以使用此规则来可视化由退缩尺度和天空暴露平面给定的 3D 分区包络。
Webstyles
Webstyles 是在整个 Esri 平台上共享的 3D 资产的集合。 这些集合包括 3D 资产，例如植被模型、车辆、街道设施和娱乐设备。
管理 ESRI.lib
要在线更新 ESRI.lib 和 Webstyles，请执行以下操作：
- 单击主菜单中的文件 > 管理 ESRI.lib...。
- 选择所需包。
- 单击更新。
将下载这些包并将其直接安装在当前工作空间中。 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) 约束。