导出模型

以下是导出模型的基本步骤：

1. 在视窗窗口或场景编辑器窗口中选择要导出的对象。
2. 从主菜单中单击文件 > 导出模型，或按 Ctrl + E。
3. 选择文件格式。

注：

模型导出器独立于当前场景中生成的模型，并可以导出大型场景。 这意味着在导出模型之前无需生成场景。

支持格式

下表将介绍支持的 3D 格式：

3D 格式	描述
ABC (Alembic)	开放式交换框架，专门用于 VFX 内容生产管道。
DAE (COLLADA)	用于加载大量 DCC 工具和渲染引擎，并支持资产实例化、分层纹理和文件引用。
DATASMITH（Unreal 和 Twinmotion）	提供从 CityEngine 到 Unreal Engine 编辑器和 Twinmotion 的简单数据传输。 它支持现代材料 (PBR) 以及几何实例化
DWG (Autodesk)	Autodesk AutoCAD 原生的专有 3D 几何格式。 它不具有现代材料支持，但是广泛用于 BIM 和 CAD 行业。
FBX (Autodesk)	提供导出到 Autodesk Maya、3ds Max、MotionBuilder 以及其他配备 FBX 导入器的 DCC 工具的功能。 它包含对分层纹理（多纹理）以及每个纹理的 UVW 转换（缩放、平移和旋转）的支持。
glTF (Khronos Group)	最近的基于 JSON 的 3D 几何传送格式。 该格式支持现代材料 (PBR) 以及几何实例化，并受到许多桌面和 Web 应用程序的支持。 目前，该格式为新工程的建议交换格式。
IFC (buildingSMART)	用于描述建筑物元素的开源 3D 几何交换格式。 它主要用在 BIM 和 CAD 行业中，用于存储设计、采购和施工阶段的工程信息以及操作参考。 CityEngine 仅支持版本 2x3。
OBJ (Wavefront)	将具有纯色或单个纹理图层的模型传送到 DCC 工具或渲染引擎。 材料定义将导出到随附的 .mtl 文件中。 它不支持实例化。
USD（通用场景描述）	存储大型 CityEngine 场景，同时最大程度降低信息丢失，由此其适合作为交换格式在 VFX 管道中进行进一步处理。
VOB (e-on VUE)	e-on 软件的 VUE 产品的原生对象格式。 CityEngine 支持 VUE 8.5 和更高版本。 建议您使用最新版本。

下表将介绍支持的 3D GIS 格式：

3D GIS 格式	描述
FileGDB（Esri 文件地理数据库）	GIS 工作流的常用文件格式。 将多面体、多点、点和折线几何类型导出到文件地理数据库。 支持纹理。
KMZ/KML（Keyhole 标记语言）	导出到地理配准的地球浏览器，例如 ArcGlobe 和 ArcGIS Earth。 模型可以共享，例如在 Google Warehouse 中共享。

下表将介绍支持的 ArcGIS Online 格式：

ArcGIS Online 格式	描述
MSPK（移动场景包）	移动场景包（.mspk 文件）是一种经过 Web 优化的自定义文件类型，可用于在 ArcGIS 平台上共享完整场景。
SLPK（Esri 场景图层包）	场景图层包（.slpk 文件）是一种经过 Web 优化的自定义格式，可以在 ArcGIS Online 上共享和发布，并使用 Scene Viewer 进行查看。
3VR (360 VR Experience)	导出 CityEngine 场景的全景照片。
3ws（CityEngine Web 场景）	可以使用 CityEngine Web 查看器在 Web 浏览器中查看 CityEngine Web 场景。 注： 3ws 格式已弃用，且在未来版本的 CityEngine 中可能不受支持。

下表描述了支持的 CGA 材料格式：

材料格式	描述
CGA 材料	将采集 CGA 模型的材料描述并将其写入单独的子目录。 每个子目录都包含所有材质（包括使用的纹理），可以将其复制到资产等文件夹中。 子目录和 .cgamat 文件的名称为 material.name 属性，但是，如果存在多个具有相同名称的材料，则该属性唯一。 <matName>.cgamat 文件采用 CSV 格式，与 CGA 函数 getMaterial(used, changed) 的结果相同。

下表描述了支持的自定义导出格式：

自定义导出格式	描述
Python（基于脚本的导出）	允许在批量导出过程中运行任意 Python 命令。

常规导出选项

常规选项可用于所有导出文件格式。 某些格式包含附加选项，将在下方相应的子部分中介绍这些选项。

注：

• 在导出向导中，每个导出选项都会显示工具提示以及说明。
• 要比较各种格式的材料和阴影功能，请参阅下方的格式功能对比。 .

常规选项

下表将介绍常规选项：

选项	描述
输出路径	导出位置的路径。 路径必须存在。
基本名称	已导出文件的基本名称。 将根据其他导出选项设置附加后缀。
导出几何	具有形状回退的模型 - 如果模型生成失败，则导出开始形状几何。 这是默认设置。 模型 - 如果模型生成失败，则将忽略形状。 形状 - 仅导出开始形状几何。
地形图层	不导出任何地形图层 导出所有可见地形图层 导出所有所选地形图层 - 此为默认设置 导出所有地形图层
简化地形	reduceGeometry 操作用于在导出之前简化地形几何。 这可能需要很长时间，对于具有较高分辨率的地形尤其如此。

粒度选项

下表将介绍粒度选项：

选项	描述
内存预算	最大内存消耗，以兆字节为单位。 如果内存预算为零，则将几何数据写入单个文件中。 否则，在达到内存预算时，会将新文件写入磁盘。 在进行任何优化之前，将在原始网格上测量几何大小。 文件大小通常小于设置。 将针对每个输入形状，而非每个规则输出形状执行该检查，即，非常复杂的规则可能会生成比限制设置更多的数据。
网格粒度	不合并任何网格 - 将不合并任何网格；单独对每个网格进行优化。 按材料合并网格 - 将合并并优化具有相同材料特性的所有网格。 重用资产实例，按材料合并生成的网格 - 将保留插入的资产/网格（请参阅 CGA insert 操作）并对其进行实例化。 将按材料合并由语法生成的网格。
要素粒度	一个要素/形状 - 将在包中为每个开始形状创建一个要素。 一个要素/叶子形状 - 将在包中为每个叶子形状创建一个要素。

几何选项

下表将介绍几何选项：

选项	描述
折点法线	写入折点法线 - 当折点法线存在于网格上时，会将其写入。 不写入任何折点法线 - 即使折点法线位于网格上，也不会将其写入。 如果折点法线缺失，则写入面法线 - 如果网格不包含折点法线，则使用面法线作为折点法线。 始终写入面法线 - 几何上存在的现有折点法线将被忽略，并被替换为面法线。
法线索引	在每个面的索引面法线或分离的法线副本之间进行选择。
纹理坐标	不写入任何 UV - 不会导出纹理坐标。 仅写入 UV 的第一个图层：将仅导出纹理坐标的第一个图层（uv-set 0 对应于色彩映射表）。 有关详细信息，请参阅纹理：基本知识。 写入所有 UV 图层 - 将导出所有图层。
局部偏移	仅当文件粒度设置为一个文件/开始形状时，局部偏移才有效，因为它是针对每个单独的形状计算的。 无 - 不使用局部偏移。 模型质心 - 将所生成模型的质心用于偏移。 模型质心底部 - 将投影在所生成模型底部边界上的质心用于偏移。 形状质心 - 将形状质心用于偏移。 形状质心底部 - 将投影在形状底部边界上的质心用于偏移。
全局偏移	所生成几何的全局偏移。 设置 x、y 和 z 轴的偏移（笛卡尔坐标值）。
折点精度	在文件输出之前，可以使用这些值降低不同几何数据的浮点精度（用于减小 OBJ 格式文件的大小）。
在精度内合并	将合并欧氏距离等于或小于精度的坐标（折点、法线和纹理坐标），并且将更新其对应的索引。
三角化网格	所有面都将转换为三角形。
带有孔洞的面	作为孔洞写入 - 将写入孔洞信息。 此选项仅适用于某些格式。 三角化带有孔洞的面 - 将对所有包含孔洞的面进行三角化。 放弃孔洞将忽略孔洞信息。 将孔洞转换成面孔洞将转换为面（将创建共面的面）。

材料选项

下表将介绍材料选项：

选项	描述
包含材料	启用此选项时，导出内容中将包含材料定义（例如，漫反射颜色）和纹理。 否则，将引用默认材料（如果格式需要）。

纹理选项

下表将介绍纹理选项：

选项	描述
创建纹理地图集	将一组纹理组合为一个纹理的纹理地图集，可减少纹理和材料数量。 将移除色彩映射表之外的所有纹理。 有关详细信息，请参阅 CGA 材料属性。 注： 如果重复（即 [0,1] 之外的 UV 坐标），则无法将纹理放入地图集中。
纹理地图集最大尺寸 (2^n)	以两个像素的幂指定纹理地图集的最大尺寸，例如 11 可提供 2048x2048 的地图集。
纹理地图集边界	添加了重复纹理内容的像素边框，以防止不正确的伪影缩放。

高级选项

下表将介绍高级选项：

选项	描述
文件类型	选择基于二进制或文本 (ASCII) 的文件创建。
嵌入纹理	引用文件路径（默认）或将纹理文件嵌入二进制文件中。
形状名称分隔符	指定字符用于解析重复的形状名称。 例如，分隔符“_”可将 {"shape", "shape", "shape"} 解析为 {"shape", "shape_1", "shape_2"}。 可以识别现有后缀“_1”。 注： 要手动使用名称解析器选择形状，请单击编辑 > 使名称唯一。
现有文件	覆盖现有文件 - 在写入几何文件之前不执行文件检查。 所有文件都将被覆盖。 跳过现有文件 - 将不会覆盖现有文件（几何、材料和纹理文件）。

其他选项

下表将介绍一个附加选项：

选项	描述
脚本	用于与导出并行的附加 python 操作的 python 脚本的工作空间路径。

格式功能对比

下表中的功能参考 CityEngine 输出，并非各个格式的理论功能。 将此列表与模型导出应用程序注释主题的格式建议部分中的已知互操作性限制和建议进行比较。

格式	实例化	着色器	多纹理	Tex Trafo	三角测量	引用
ABC	是	否 ^2	是	是	是	否
DAE	是	否	否	是	是 ^1	是
DWG	否	否	否	否	否	否
DATASMITH	是	是	是	否	是 ^4	否
FBX	是	否	是	是	是	否
文件地理数据库	否	否	否	否	是	否
glTF	是	否	否	否	否 ^3	否
KMZ/KML	是	否	否	是	是 ^1	是
OBJ	否	否	否	否	是	否
SLPK	否	否	否	否	否	否
USD	是	否	是	否	否	是
3ws	否	否	否	是	否	否

• 1. 在导出到 ArcGIS Earth 时需要进行三角化。 有关详细信息，请参阅模型导出应用程序注释主题的格式建议部分。
• 2. Alembic 不会存储着色器，但是您可以使用 CGA 报表将着色器名称写为属性，然后将其绑定到下游工具中。
• 3. glTF 格式仅允许三角化几何。
• 4. CityEngine 会始终将三角化几何传递到 DATASMITH。

要素类型

下表将介绍支持的功能类型：

要素	描述
实例化	支持几何实例化。 通常，资产将与节点和转换数据分开存储且处于未修改状态。
着色器	支持自定义着色器名称。
多纹理	支持多纹理通道。
Tex Trafo	支持独立于存储在网格中的纹理坐标的单独纹理坐标转换（例如，纹理旋转）。
三角测量	确认在导出时导出器是否支持可选的三角测量。
引用	确认是否支持文件之间的实体引用。 由此可定义主文件以合并所有场景元素。