导出 3ws（CityEngine Web 场景）

CityEngine Web 场景 (3ws) 是一种经过 Web 优化的自定义格式，可以在 ArcGIS Online 上共享以及使用 CityEngine Web Viewer 进行查看。

注：

3ws 格式已弃用，且在未来版本的 CityEngine 中可能不受支持。

在视窗窗口中选择要导出的内容，然后开始导出。 单击文件 > 导出模型 > CityEngine Web 场景。

导出选项

除了常规导出选项之外，3ws 导出还包括一个具有以下图层选项的导出页面：

选项	描述
导出	复选框表示是否导出图层的内容。
图层名称	在 CityEngine 场景中设置的图层名称。
图层组	可以将图层组合为图层组。 具有相同组名的所有图层都将被收集至一个图层组。 在 CityEngine Web Viewer 中，一次仅显示某个组的一个图层（独占可见性）。 所有图层组都可以在 CityEngine Web Viewer 中启用“滑动视图”。

可以使用模式 GROUPNAME.LAYERNAME 命名 CityEngine 场景图层以自动设置其图层组。

显示具有图层组命名的场景编辑器。

纹理质量选项

对于 3ws 导出，可以使用以下纹理质量选项：

选项	描述
场景设置	在第一个导出对话框中，使用纹理的全局设置。 （仅作为每个图层的选项提供。）
高质量	转换所有图层 RGB 纹理并以高质量存储。
中等质量	转换所有图层 RGB 纹理并以中等质量存储。
低质量	转换所有图层 RGB 纹理并以低质量存储。
大小的一半	将所有图层纹理的大小调整为 50%；RGB 纹理以中等质量 JPG 形式写入。
紧凑	将所有图层纹理的大小调整为 50%，但是最大为 256x256 像素；RGB 纹理以低质量 JPG 形式写入。
原始纹理	使用原始纹理。 注： 仅 JPG 和 PNG 纹理在 Web Viewer 中受支持。 其他纹理格式将显示为黑色。
无纹理	请勿在图层对象中包含纹理。

单个图层选项

对于 3ws 导出，可以使用下方介绍的单个图层选项。

图层状态选项

对于 3ws 导出，可以使用以下图层状态选项：

选项	描述
背景	图层不显示在图层窗格中；始终可见。
可见	图层显示在图层窗格中，并且可以设置为可见或隐藏。 初始状态为可见。
隐藏	图层显示在图层窗格中，并且可以设置为可见或隐藏。 初始状态为隐藏。

交互选项

对于 3ws 导出，可以使用以下交互选项：

选项	描述
场景设置	在第一个导出对话中，使用为对象交互设置的全局设置。
已锁定	无法选择此图层中的对象。 所有对象将组合到单个实体中。 锁定图层包含的对象数量小于可选图层，这通常可以提高 Web Viewer 的性能。 由于已组合所有对象，因此无法写入每个对象的元数据（仅限无元数据选项）。
可选择	此图层中的对象可供选择，且所有对象都将导出为单个实体（要素）。 图层中对象数量过多可能会降低性能。 建议您仅在需要时使用此选项。

元数据选项

对于 3ws 导出，可以使用以下元数据选项：

选项	描述
场景设置	在第一个导出对话中，使用对象元数据的全局设置。
全部	将对象属性和报表都写入对象元数据。
属性	将对象属性写入对象元数据。
报表	将生成的报表数据写入对象元数据。
无	不包含对象属性或报表数据。

纹理质量选项

对于 3ws 导出，可以使用以下纹理质量选项：

选项	描述
场景设置	在第一个导出对话框中，使用纹理的全局设置。
高质量	将所有图层 RGB 纹理转换为高质量 JPG。
中等质量	将所有图层 RGB 纹理转换为中等质量 JPG。
低质量	将所有图层 RGB 纹理转换为低质量 JPG。
大小的一半	将所有图层纹理的大小调整为 50%；RGB 纹理以中等质量 JPG 形式写入。
紧凑	将所有图层纹理的大小调整为 50%，但是最大为 256x256 像素；RGB 纹理以低质量 JPG 形式写入。

注：

在除原始纹理之外的所有纹理质量选项中，纹理大小均限制为 2,048 像素。

3ws 导出特性

在 CityEngine 场景中定义的书签将直接导出至 Web 场景，并在 CityEngine Web Viewer 的书签菜单中可用。

注：

• 当前不支持不同的照相机角度。 Web Viewer 将显示所有视图并使用默认 CityEngine 角度（54 度）查看书签。
• 在开始导出之前，当前照相机位置和方向将存储到 Web 场景中，并用作 CityEngine Web Viewer 中的初始视图。

CityEngine 场景的当前阴影和环境光遮蔽设置将导出到 .3ws 文件，并用作 Web Viewer 中的初始值。 在某些计算机上，当您在导出前启用阴影和环境光遮蔽时，Web Viewer 可能不支持直接或散射阴影，或者可能影响性能。

注：

由于将在导出过程中存储初始设置，因此在 Web 场景预览中更改选项（例如阴影设置）将不会更改 Web 场景的初始配置。

导出提示

由于浏览器限制以及要确保与性能不够强的系统兼容，建议您将 Web 场景大小（.3ws 文件大小）保持在 15MB 以下。 可以通过以下方法之一缩小 Web 场景：

• 选择较小的导出范围（选择更少的对象）。
• 使用较小的地形分辨率（512x512 或更低）。 可以在“地形图层”、“图层属性”、地形分辨率 u 和 v 的检查器窗格中设置地形分辨率。
• 微调纹理质量导出选项（使用紧凑或大小的一半）
• 将纹理手动转换为低分辨率 JPG 或 PNG，并使用原始纹理选项。
• 当不需要选择时，将交互导出选项设置为锁定。
• 降低模型的几何复杂度（例如，较低的细节层次或较少的街道细节）。

默认情况下，将在导出过程中简化地形几何。 对于复杂的地形，这可能需要一段时间。 要加快此过程，请执行以下操作之一：

• 请使用较小的地形分辨率（建议使用 512x512）。 可以在“地形图层”、“图层属性”、地形分辨率 u 和 v 的检查器窗格中设置地形分辨率。
• 关闭主要导出选项优化下的简化地形网格（不建议执行此操作，因为这将增加 .3ws 文件大小）。
• 将纹理质量设置为原始纹理时，请确保该图层仅使用 JPG 和 PNG 纹理。 WebGL 不支持其他格式，这些格式在 Web Viewer 中将显示为黑色。
• 在准备 Web 场景时，请记住 Web 场景在其他性能不够强的系统（内存较小，显卡性能不够强）上可能无法流畅运行（或根本无法运行）。 请减少导出的范围和 .3ws 文件大小，以确保更广泛的兼容性。

预览 CityEngine Web 场景

发布 Web 场景之前，建议您在本地预览场景，以确保其中包含所有适用的数据并且图层设置正确。

1. 在 CityEngine 导航器中找到导出的 Web 场景（.3ws 文件），默认情况下，Web 场景将导出到当前工程的模型文件夹。
2. 双击 .3ws 文件，或右键单击文件，然后单击打开方式 > CityEngine Web Scene Viewer。

   Web Viewer 将在默认 Web 浏览器中打开。

预览选项

您可以使用以下选项预览 Web 场景：

选项	描述
3D Web Scene Viewer	此选项将从 ArcGIS Online 中打开 CityEngine Web Viewer。 需要 Internet 连接。
3D Web Scene Viewer（离线）	将使用 CityEngine Web Viewer 的本地版本。 无需 Internet 连接。 本地查看器的版本可能早于在线版本。

在浏览器中打开的预览 URL 格式为 http://localhost:61351/ceviewer.html?3dWebScene=/PATH_TO/WEBSCENE.3ws，而在离线版本中为 http://localhost:61351/ceviewer_offline.html?3dWebScene=/PATH_TO/WEBSCENE.3ws。 webscene.3ws 的路径与 CityEngine 工作空间相关（CityEngine 工作空间中必须存在 Web 场景，才能对其进行预览）。 CityEngine 将自动设置一个随机变化的较高端口。

因为浏览器在加载本地文件（例如 .3ws 文件）时存在安全性限制，因此 Web Viewer 需要本地 Web 服务器。 使用文件协议 (file://...) 启动 Web Viewer 不起作用（例如通过双击 viewer.html 启动 Web Viewer）。

默认浏览器

在启动预览 Web Viewer 应用程序时，CityEngine 将启动在计算机上设置为默认浏览器的 Web 浏览器。 要在其他浏览器中预览，请更改系统的默认 Web 浏览器或将预览 URL 复制到新的 Web 浏览器。

预览注意事项

Web 场景的所有初始配置设置（例如，照相机位置或阴影设置）都在导出期间完成。 在 Web 场景预览中所做的更改不会存储到 Web 场景，并且不会影响初始配置。

上传至 ArcGIS Online

完成以下步骤以将 Web 场景上传到 ArcGIS Online：

1. 在导航器窗口中找到导出的 Web 场景。
2. 右键单击 Web 场景，然后单击共享为。

   随即显示 CityEngine Web Scene 包对话框。

3. 单击将包上传到我的 ArcGIS Online 帐户并命名 Web 场景包。
4. 填写项目描述的必填字段。
5. 单击分析以验证 Web 场景是否存在错误或问题。

   必须先对 Web 场景进行验证并解决所有错误，然后才能将其保存到磁盘或共享至 ArcGIS Online。 如果发现任何问题，系统将报告错误。 您必须先修复错误，然后才能继续。

6. 单击共享以将 Web 场景上传至 ArcGIS Online。
7. 单击文件 > ArcGIS Online，然后转至我的内容以在线查找要共享的 Web 场景。

注：

如果门户上已存在该 Web 场景，则将使用新版本对其进行更新，并将保留相同 ID。

将 Web 场景和 Web Viewer 打包为 .zip 文件

可以创建 Web 场景和 Web Viewer 应用程序的 .zip 文件，而非发布到 ArcGIS Online，您可以将该文件手动上传到自己的 Web 服务器。

• 按照上一部分中的步骤操作，但在 Web 场景包对话框中选择将包保存到文件。
• 创建的 .zip 文件包含两个文件夹：
  • webscenes - 包含 .3ws 文件
  • webviewer - 包含 Web Viewer 应用程序文件

上传至自定义服务器

将两个文件夹复制到您的 web 服务器。 要启动 Web Viewer，在浏览器中输入 URL (http://SERVER.DOMAIN/PATH/TO/WEBVIEWER/viewer.html?3dWebScene=../webscenes/NAME_OF_WEBSCENE.3ws)。

上传 Web Viewer 应用程序并创建 Web 场景后，您必须将 .3ws 文件上传至 webscenes 文件夹，然后修改 URL 以通过查询参数 ?3dWebScene 反映相应的 Web 场景。

注：

因为浏览器在加载本地文件（例如 .3ws 文件）时存在安全性限制，因此 Web Viewer 需要本地 Web 服务器。 使用文件协议（以 file://... 为开头的 URL）启动 Web Viewer 不起作用（例如通过双击 viewer.html 启动 Web Viewer）。