CityEngine Web 场景 (3ws) 是一种经过 web 优化的自定义格式，可以在 ArcGIS Online 上共享以及使用 CityEngine Web Viewer 进行查看。
注：
3ws 格式已弃用，且在未来版本的 CityEngine 中可能不受支持。
在 3D 窗口中选择要导出的内容，然后启动导出器。 单击文件 > 导出模型... > CityEngine Web 场景。
导出设置
除了常规导出选项之外，Web 场景导出还具有一个附加导出页面，可用于控制各个图层的设置：
导出 | 复选框表示是否导出图层的内容。 |
图层名称 | 在 CityEngine 场景中设置的图层名称。 |
图层组 | 可以将图层组合为图层组：将在图层组中采集具有相同组名的所有图层。 在 CityEngine Web Viewer 中，一次仅显示某个组的一个图层（独占可见性）。 此外，所有图层组都可以在 CityEngine Web Viewer 中启用“滑动视图”。 |
可以使用模式 GROUPNAME.LAYERNAME 命名 CityEngine 场景图层以自动设置其图层组。
纹理质量设置
场景设置 | 在第一个导出对话框页面中使用在纹理中设置的全局选项。 （仅作为每个图层的选项提供。） |
高质量 | 转换所有图层 RGB 纹理并以高质量存储 |
中等质量 | 转换所有图层 RGB 纹理并以中等质量存储 |
低质量 | 转换所有图层 RGB 纹理并以低质量存储 |
大小的一半 | 将所有图层纹理的大小调整 50%；写入 RGB 纹理作为中等质量 JPG |
紧凑 | 将所有图层纹理的大小调整 50%，但是最大为 256x256 像素；写入 RGB 纹理作为低质量 JPG |
原始纹理 | 使用原始纹理 注：仅 JPG 和 PNG 纹理在 Web Viewer 中受支持。 其他纹理格式将显示为黑色 |
无纹理 | 请勿在图层对象中包含纹理。 |
单个图层设置
图层状态设置
背景 | 图层将不会显示在图层窗格中，始终可见。 |
可见 | 图层将显示在图层窗格中，可以将其设置为可见或隐藏。 初始状态可见。 |
隐藏 | 图层将显示在图层窗格中，可以将其设置为可见或隐藏。 初始状态隐藏。 |
交互设置
场景设置 | 在第一个导出对话框页面中使用在对象交互中设置的全局选项。 |
已锁定 | 该图层中的对象将无法选择。 将所有对象组合到一个实体中。 因此，锁定图层包含的对象数量比可选取的图层少，这通常可以提高 Web Viewer 的性能。 由于已组合所有对象，因此无法写入每个对象的元数据（仅限“无元数据”选项）。 |
可选择 | 可以选择此图层中的对象，所有对象都将导出为单个实体（要素）。 图层中的对象数量过多会降低性能，因此建议仅在需要时将图层设置为可选择。 |
元数据设置
场景设置 | 在第一个导出对话框页面中使用在对象元数据中设置的全局选项。 |
全部 | 将对象属性和报表都写入对象元数据。 |
属性 | 将对象属性写入对象元数据。 |
报表 | 将生成的报表数据写入对象元数据。 |
无 | 请勿包含对象属性或报表数据。 |
纹理质量
场景设置 | 在第一个导出对话框页面中使用在纹理中设置的全局选项。 |
高质量 | 将所有图层 RGB 纹理转换为高质量 JPG |
中等质量 | 将所有图层 RGB 纹理转换为中等质量 JPG |
低质量 | 将所有图层 RGB 纹理转换为低质量 JPG |
大小的一半 | 将所有图层纹理的大小调整 50%；写入 RGB 纹理作为中等质量 JPG |
紧凑 | 将所有图层纹理的大小调整 50%，但是最大为 256x256 像素；写入 RGB 纹理作为低质量 JPG |
注：
在除了“原始纹理”之外的所有纹理质量模式中，纹理大小将限制为 2048 像素。
其他 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 场景之前，最好在本地对其进行预览，以确保其包含所有需要的数据，并且导出器选项中的图层设置正确完成。
- 在 CityEngine 导航器中定位导出的 Web 场景（.3ws 文件）（默认情况下，Web 场景将导出到当前工程的模型文件夹）。
- 双击 .3ws 文件或者右键单击 .3ws Web 场景文件，然后选择使用 > CityEngine Web Scene Viewer 打开
Web Viewer 将在系统的默认 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 场景。
- 右键单击 Web 场景并选择共享为...
随即显示 CityEngine CityEngine Web Scene 包对话框。
- 单击将包上传到我的 ArcGIS Online 帐户并命名新的 Web 场景包。
- 填写项目描述的必填字段。
- 单击分析，验证 Web 场景是否存在错误或问题。
必须先对地图进行验证并解决所有错误，然后才能将其保存到磁盘或共享至 ArcGIS Online。 如果发现任何问题，则系统将报告错误。 您必须先修复错误，然后才能继续。
- 单击共享以将 SLPK 上传至 ArcGIS Online。
- 单击文件 > ArcGIS Online，然后转至我的内容以在线查找您的 Web 场景以进行共享。
注：
如果门户上已存在该 Web 场景，则将使用新版本对其进行更新，并将保留相同 ID。
将 Web Scene and Viewer 打包为 zip 文件
可以创建 Web Scene and Viewer 应用程序的 zip 文件，而非发布到 ArcGIS Online，可以手动将该 zip 文件上传到您自己的 web 服务器。
- 可以使用上述相同步骤，但是在 Web 场景包对话框中选择将包保存到文件。
- 创建的 zip 文件包含两个文件夹
- webscenes 包含 Web 场景文件 .3ws
- webviewer 包含 Web Viewer 应用程序文件
上传至自定义服务器
将两个文件夹复制到您的 web 服务器。 要启用此应用程序，请将浏览器指向
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 时，将不起作用。