GeoForge 参数说明：3D Tiles 切片、LOD、瓦片与 Cesium 加载
覆盖“新建转换”与“编辑参数”界面的全部可配置项：切片流程选择、输入输出、坐标变换、LOD 与瓦片化、点云、GIS 矢量、实例模型与高级优化。
1. 先选择正确的转换流程
GeoForge 会根据所选流程，只显示该流程真正需要的参数。请先让流程与数据类型匹配：
| 转换流程 | 适用数据 | 输出成果 |
|---|---|---|
| 通用模型切片 | FBX、OBJ、glTF/GLB、3DS、DAE、CityGML、IndoorGML、OSGB 等 | 三维模型瓦片 |
| IFC 模型切片 | IFC 文件 | 三维模型瓦片 |
| Datasmith 模型切片 | .udatasmith 场景数据 | 三维模型瓦片 |
| 倾斜摄影切片 | OSGB 及倾斜摄影模型数据 | 三维模型瓦片 |
| 点云切片 | LAS、LAZ | 点云瓦片 |
| 面状建筑切片 | Shapefile、GeoJSON、GeoPackage 面要素 | 建筑体块瓦片 |
| 管道生成 | Shapefile、GeoJSON、GeoPackage 线要素 | 管道瓦片 |
| 实例模型切片 | Shapefile、GeoJSON、GeoPackage、KML 点要素 | 实例化模型瓦片 |
2. 输入输出设置
| 参数 | 作用 | 使用建议 |
|---|---|---|
| 输入路径 | 选择要转换的文件或目录。 | 必填。请保留文件及其关联资源目录；批量数据可直接选择上级目录。 |
| 输出目录 | 指定成果保存位置。完成后目录中会包含 tileset.json 和瓦片数据。 | 必填。建议为每次转换使用独立的空目录，便于检查和发布成果。 |
| 递归扫描子目录 | 让系统继续查找输入目录中的下级文件夹。 | 输入目录内有多层文件夹时开启；只需处理当前目录内容时关闭，可减少误读无关文件。 |
| 输入单位缩放 | 按比例放大或缩小模型尺寸。 | 源模型单位为米时保持 1；厘米转米填 0.01，毫米转米填 0.001。 |
3. 坐标与空间变换
这一组参数决定成果在地图或三维场景中的位置。坐标设置不明确时，先确认源数据的坐标系、单位和高程基准，再进行转换。
两种定位方式
界面提供两种互斥的定位方式，请二选一：
- EPSG / Proj4 投影坐标配准：适合已有明确坐标系的 GIS、测绘、倾斜摄影或工程数据。
- 经纬度坐标配准：适合本地坐标模型，需要把模型放到指定经纬度位置的情况。
经度和纬度必须同时填写；填写 EPSG 或 Proj4 后，不要同时再填写经纬度。
| 参数 | 作用 | 使用建议 |
|---|---|---|
| 输入坐标系 EPSG | 用 EPSG 编号说明源数据使用的坐标系。 | 例如 4326、3857、4978。已有可靠坐标信息时优先使用这一项。 |
| Proj4 字符串 | 用完整的 Proj4 参数定义坐标系。 | 仅在 EPSG 编号无法表达或项目已有 Proj4 定义时使用；填写后会优先于 EPSG。 |
| 原点经度、原点纬度 | 将本地坐标模型锚定到指定地理位置。 | 适合没有投影坐标、但知道模型应落在何处的数据；两项必须成对填写。 |
| X 偏移、Y 偏移、Z 偏移 | 在已选定位方式的基础上，分别沿三个方向微调位置。 | 用于修正模型整体偏移。建议先用小值试转并预览，确认方向后再调整。 |
| 绕 X 轴旋转 | 围绕 X 轴旋转模型，修正上下轴方向不一致的问题。 | 仅部分模型流程和实例模型流程提供。常见 FBX Z-up 转 Y-up 场景可尝试 90；无方向问题时保持 0。 |
4. LOD 与瓦片化参数
这一组参数用于平衡清晰度、成果体量和加载速度。没有明确性能目标时，先使用默认值完成一次转换，再根据预览效果调整。
| 参数 | 作用 | 使用建议 |
|---|---|---|
| 空间分割策略 | 选择四叉树或八叉树组织空间。 | 仅通用模型、IFC、Datasmith 流程提供。以地表扩展为主的场景优先用四叉树；高差很大、空间分布立体时可尝试八叉树。 |
| 体素重建层级 | 为模型外壳生成由粗到细的体素代理层，用于远景概览和逐级加载。 | 仅通用模型、IFC、Datasmith 流程提供，默认 0，表示关闭。建议先保持关闭；大型建筑群或城市外观模型需要更平滑的远景过渡时，再从 1 或 2 开始测试。 |
| 最小 LOD 级别 | 设置最精细的细节层级。0 表示最精细。 | 通常保持默认 0，用于保留近距离查看时的模型细节。 |
| 最大 LOD 级别 | 设置可生成的最粗糙细节层级。数值越大，远距离层级越粗略。 | 默认 5 适合多数模型。大范围或大体量场景可适度增大；小模型无需设置过大。 |
| 最大三角面数/节点 | 限制单个空间节点可容纳的最大三角面数。 | 数值较小会产生更多、更小的瓦片，利于按需加载但文件数量更多；数值较大则瓦片更少、单瓦片更重。 |
| 纹理容量上限(KB) | 限制单个瓦片估算的纹理负载。 | 仅通用模型、IFC、Datasmith 流程提供。调小可降低单瓦片纹理压力，但可能增加瓦片数量或降低局部纹理质量。 |
| 纹理尺寸上限 | 限制导出纹理的最大边长，单位为像素。 | 仅通用模型、IFC、Datasmith 流程提供。默认 1024；需要更清晰近景纹理时提高，面向移动端或网络较慢时降低。填 0 表示不限制。 |
体素重建层级：它能达到什么效果
体素重建可以理解为：系统先识别模型的主要外壳，再把外壳转化为适合远距离显示的简化代理模型。它不会让原始模型“变得更精细”，而是在完整细节模型之前，增加若干级更轻量的外观层。
开启后，浏览三维成果时通常会经历这样的过程：
- 远距离先加载整个模型的粗略外壳，优先保留建筑群、厂区或城市模型的大轮廓。
- 镜头靠近时，外壳按空间区域逐步换成更细的代理层。
- 继续靠近后，再加载常规 LOD 和原始细节内容。
因此，它主要能带来以下效果：
- 远景更容易看清整体形态：大型建筑、园区或城市模型在远距离下仍能保持连续的外轮廓，而不是一开始就加载大量细碎模型。
- 细节切换更平滑：从整体概览进入局部观察时，系统可先按空间块展示较细的外壳代理，再进入完整细节。
- 降低远景阶段的内容压力：远距离优先使用代理层，有助于避免一开始就使用复杂的原始外壳模型。
层级怎么选
“层级”表示代理外壳参与空间分块的深度，不代表模型精度翻倍。层级越高，代理层覆盖的空间区域越细，远近过渡更丰富，但转换时间、内存占用和新增成果数量也会明显增加。
| 设置 | 可达到的效果 | 适用建议 |
|---|---|---|
0 | 不生成体素代理层，直接使用常规 LOD。 | 默认选择。小型模型、室内模型、细节优先项目，或首次转换时使用。 |
1 | 为整个场景生成一层整体外壳代理。 | 用于需要远景概览、但希望控制处理成本的大型单体建筑或小型园区。 |
2 | 在整体外壳之外，再按空间区域生成更细的代理层。 | 适合建筑群、园区和中等规模城市片区；建议作为首次启用时的优先测试值。 |
3 | 提供更连续的由远到近外壳过渡。 | 适合规模较大、外观浏览需求明显且机器资源较充足的场景。 |
4 至 7 | 继续增加代理层的空间细度。 | 仅建议在完成小范围验证后使用。层级越高，处理成本增长很快，通常不必追求最大值。 |
从计算规模看，每增加一级都会把上一层的空间再分为八个区域：1 级需要生成 1 个代理，2 级累计 9 个，3 级累计 73 个，4 级累计 585 个。也就是说，较高层级更适合有明确远景浏览需求、且能够接受更长处理时间的项目。
推荐做法：先以 0 完成一次常规转换，确认坐标、纹理和模型外观无误；再复制任务，将体素重建层级设为 1 或 2，对比远景显示、转换耗时和成果体量后决定是否继续提高。
5. 点云参数
以下参数只在 LAS、LAZ 的点云切片流程中显示。
| 参数 | 作用 | 使用建议 |
|---|---|---|
| 最大点数/瓦片 | 限制每个点云瓦片最多包含的点数。 | 默认 200000。调小可减轻单瓦片加载和渲染压力，但会增加瓦片数量；调大适合性能充足、希望减少文件数量的环境。 |
| 采样百分比(%) | 按比例保留原始点云中的点。 | 范围为 1 至 100。首次检查成果可用较低比例快速试转；正式交付再提高比例。数值越低，成果越轻，但细节会减少。 |
| 强制 4 字节 RGB | 使用 4 字节颜色格式保存点云颜色。 | 默认关闭。遇到目标平台颜色兼容性问题时再开启；开启后数据量可能增加。 |
6. GIS 矢量参数
以下参数根据几何类型显示。填写“列名”时，应与源 Shapefile、GeoJSON、GeoPackage 或 KML 属性表中的字段名称完全一致。
| 参数 | 作用 | 使用建议 |
|---|---|---|
| 属性过滤表达式 | 只转换符合条件的要素。 | 格式为 字段=值1,值2;字段2=值3。例如 type=building;status=active。先确认属性值写法，避免因大小写或拼写不一致漏掉要素。 |
| 高度列名 | 指定面要素挤出为建筑体块时使用的高度字段。 | 仅面状建筑流程提供。字段值单位应为米；不填写时，无法按属性表达不同建筑高度。 |
| 海拔列名 | 指定要素底部的高程字段。 | 面状建筑、管道和实例模型流程提供。字段值单位应为米，用于让要素落在正确海拔。 |
| 绝对海拔(米) | 为全部要素指定同一个海拔高度。 | 填写后会覆盖“海拔列名”的逐要素高程。适合所有对象位于同一标高的项目。 |
| 最小挤出高度(米) | 给面状建筑设置允许的最小高度。 | 仅面状建筑流程提供。用于避免高度过小或缺失的要素生成几乎不可见的体块。 |
| 裙边高度(米) | 为建筑体块底部增加向下延伸的裙边。 | 仅面状建筑流程提供，默认 4。地形有起伏或建筑底部存在缝隙时可适当增大；平整场景可保持默认。 |
| 直径列名 | 指定线要素生成管道时使用的管径字段。 | 仅管道生成流程提供。字段值单位为毫米；确认源字段是直径而不是半径。 |
7. 实例模型参数
以下参数只在实例模型切片流程中显示，用于把点状要素批量布置为树木、路灯、设备等重复模型。
| 参数 | 作用 | 使用建议 |
|---|---|---|
| 实例参考模型 | 选择要重复布置的 glTF 或 GLB 模型。 | 必填。建议使用方向、单位和原点已整理好的轻量模型，避免每个实例都出现偏移或朝向错误。 |
| 朝向列名 | 指定控制实例旋转方向的属性字段。 | 字段值单位为度。道路设施、树木或设备需要按属性朝向摆放时填写。 |
| 缩放列名 | 指定控制实例大小的属性字段。 | 字段值为缩放倍数。源数据没有大小差异时留空，使用参考模型原始尺寸。 |
| 密度列名 | 指定控制实例分布密度的属性字段。 | 用于需要依据属性表达疏密变化的场景；无此需求时留空。 |
8. 高级与优化参数
以下参数仅在通用模型、IFC、Datasmith 和倾斜摄影流程中显示。它们主要影响瓦片内部的模型与纹理优化，常规任务建议保持默认设置。
| 参数 | 作用 | 使用建议 |
|---|---|---|
| 材质烘培 | 合并纯色材质，为后续纹理图集整理创造条件。 | 默认开启。除非在排查材质显示差异，否则保持开启。 |
| 纹理图集 | 将可合并的纹理打包为图集，减少材质和纹理切换。 | 默认开启。一般可降低渲染负担；若在排查 UV 或纹理异常，可临时关闭对比。 |
| 实例化 | 将重复对象转换为更适合 GPU 批量绘制的实例。 | 默认开启。重复构件较多时通常更有价值。 |
| 网格量化 | 量化网格数据以减小几何体量。 | 默认开启。通常能减少传输和显存压力；对极高精度要求的成果，应先做显示和精度验证。 |
| 纹理编码 | 选择原纹理保留方式或 KTX2 压缩方式。 | “默认”保留原纹理，适合优先保证兼容性；ETC1S 更偏向减小文件体量；UASTC 更偏向纹理质量。选择压缩方式前，应确认目标平台支持 KTX2。 |
9. 推荐的调整顺序
首次转换建议按以下顺序设置，能较快定位问题：
- 选择正确流程，填写输入路径和输出目录。
- 确认坐标定位方式；只有需要纠偏时再设置偏移和旋转。
- 先用默认 LOD 与优化参数完成一次转换。
- 查看成果的位置、清晰度、瓦片加载速度和文件体量。
- 再按问题调整参数：位置不对调坐标与偏移；加载压力大调体素重建、 LOD、三角面数、纹理或点云采样；矢量表达不对检查属性列名和单位。
对于重复处理同类数据的项目，可将验证过的配置保存为参数预设，后续直接复用。
返回文档中心