GeoForge Documentation

GeoForge 使用文档

围绕真实三维数据交付组织:安装与授权、3D Tiles 切片、GIS 数据转换、BIM / Datasmith、坐标落位、LOD 优化、本地预览和成果交付。

推荐阅读路径

  1. 安装授权安装桌面版
  2. 第一次转换完成第一次转换
  3. 数据准备数据准备与格式
  4. 坐标设置空间位置与坐标
  5. LOD 优化LOD 与资源优化
  6. 本地预览本地预览
  7. 成果交付成果检查与交付
01

产品能力总览

GeoForge 是面向多平台桌面环境的三维数据转换与交付准备工具。它把不同来源的数据整理成可在三维平台加载的 3D Tiles 成果,并在本地完成结果核验。

#

可以处理什么

  • 工程模型:IFC、Datasmith。
  • 通用三维模型:OBJ、FBX、glTF / GLB、DAE,以及文档中列出的其他模型格式。
  • 点云与倾斜摄影:LAS / LAZ,以及适合切片处理的倾斜摄影成果。
  • GIS 数据:SHP、GeoJSON、GeoPackage 等矢量数据,可按属性和范围准备建筑或管线成果。

核心能力

  • 多源数据转换:按数据类型选择对应工作流,输出统一的 3D Tiles 成果。
  • 空间参考处理:设置经纬度、投影参数、原点、偏移、单位和方向,帮助模型正确落位。
  • LOD 与资源优化:配置细节层级、空间分割、纹理尺寸和编码,在画面质量与成果体量之间取平衡。
  • 任务与成果管理:查看任务状态、保留配置、定位输出目录,并通过本地服务打开预览。

使用优势

  • 本地处理原始数据,适合对数据不便上传的项目环境。
  • 图形化界面组织输入、参数、进度和结果,减少重复记忆命令或参数。
  • 先用小样本验证,再复用已核验配置,降低大批量处理的返工风险。
  • 输出目录包含 tileset.json 与瓦片数据,可接入支持 3D Tiles 的三维平台继续验证。
02

标准使用流程

从准备数据到交付成果,建议始终沿着“样本验证 -> 参数调整 -> 本地预览 -> 目标平台核验”的顺序进行。

#

1. 准备输入

  • 确认文件可以正常读取,模型的贴图、材质和引用目录完整。
  • 为输入和输出分别准备本地目录,避免把成果写回原始数据目录。
  • 记录坐标参考、单位、原点、轴向和高度基准;不确定时先向数据提供方确认。

2. 创建任务

  • 打开转换工作台,选择与数据匹配的流程:通用模型、IFC、Datasmith、倾斜摄影、点云或 GIS。
  • 填写输入路径和输出目录,按页面提示配置必要的空间参数。
  • 第一次处理优先使用默认值和较小范围,确保先得到可检查的结果。

3. 设置质量与体量

  • 按目标视距设置最小和最大 LOD,近景需要看的细节应保留。
  • 根据设备和网络条件调整单节点三角面数、空间分割和纹理上限。
  • 需要压缩时逐项调整,并在同一视角比较优化前后的真实效果。

4. 运行与检查

  • 提交任务后查看进度、完成状态和日志信息。
  • 检查输出目录中的 tileset.json、瓦片文件和关联资源是否齐全。
  • 打开本地预览,核对位置、方向、尺度、材质、纹理、覆盖范围和远近景切换。

5. 交付与复用

  • 在目标三维平台再加载一次,确认实际客户端的兼容性。
  • 记录输入版本、关键参数、处理日期和检查结论。
  • 将通过核验的配置用于同类型数据;数据来源或目标平台变化时重新验证样本。
03

安装桌面版

GeoForge 提供多平台桌面版支持。准备好一组小范围数据,就可以开始第一次转换。

#

开始前准备

  • 为输入数据和输出成果准备可读写的本地目录。
  • 大型模型或点云会占用更多内存和磁盘,先用代表性样本评估。
  • 保留输入数据的纹理、材质与其他关联资源。

安装与授权

  • 按平台选择对应版本并完成安装。
  • 在授权页填写邮箱,查收授权信息及激活说明。
  • 打开桌面版,按照收到的说明完成激活。
04

完成第一次转换

先完成一个小任务,再处理整个项目。这样更容易检查坐标、材质和细节设置是否合适。

#

推荐流程

  • 新建转换任务,选择与输入数据匹配的类型。
  • 选择输入和输出目录,确认关联资源齐全。
  • 填写已知的坐标参考,初次运行先采用适合数据的默认设置。
  • 启动任务,查看进度和完成状态。
  • 打开本地预览,检查位置、纹理与远近景切换。
05

认识工作区

桌面工作区围绕转换任务组织数据、设置和结果,让一次处理过程更容易追踪。

#

工作区中的主要内容

  • 任务:选择输入类型,创建和查看处理任务。
  • 设置:确认坐标、LOD 和资源优化选项。
  • 进度:查看处理状态,遇到异常时保留日志。
  • 结果:打开输出目录和预览入口,核验最终成果。

复用配置

  • 给配置使用清晰的名称,记录输入类型、坐标参考和目标场景。
  • 数据来源或目标平台发生变化时,重新用样本验证。
06

数据准备与格式

格式只是第一步。完整的资源、正确的坐标和清晰的输入范围,决定了后续转换是否顺利。

#

常见输入

  • 工程模型:IFC、Datasmith。
  • 三维模型:OBJ、FBX、glTF / GLB、DAE 等。
  • 点云:LAS / LAZ。
  • GIS 矢量:SHP、GeoJSON 等。
  • 倾斜摄影:先用具有代表性的区域验证数据结构与纹理。

转换前检查

  • 将模型与其引用的贴图、材质放在完整的目录结构中。
  • SHP 数据要保留同名的关联文件。
  • 确保输出目录与原始数据目录分开,并预留充足空间。
07

IFC 与 Datasmith

工程模型通常有密集构件、复杂层级和多种材质,适合从一个楼层或一个区域开始验证。

#

IFC 数据

  • 确认数据版本、坐标说明与单位。
  • 检查关键构件、模型朝向和材质是否符合预期。

Datasmith 数据

  • 保留场景文件及其引用的资源目录。
  • 在本地核验模型层级、纹理和重复构件的表现。
  • 根据目标视距选择细节策略,不必为远景保留所有微小构件。
08

空间位置与坐标

模型正确落位需要坐标、单位、原点、轴向和高度基准相互匹配。不要只凭画面猜测坐标。

#

按顺序核对

  • 向数据提供方确认坐标参考及高度基准。
  • 核对模型单位,确认是否存在局部原点或偏移。
  • 按实际情况设置空间位置和朝向。
  • 转换小范围样本,与底图或已知位置对照。
09

LOD 与资源优化

优化没有一套适合所有项目的参数。以目标设备、网络环境和常用视距为出发点,逐步调整。

#

LOD 层级

  • 近景保留检查所需的细节,远景优先控制加载体量。
  • 在预览中拉近与拉远,检查切换是否连续。

几何与纹理

  • 优先确认材质、轮廓和法线正确,再进行体量调整。
  • 比较优化前后的细节,不只关注输出文件大小。
  • 为经过核验的配置保留名称及适用数据类型。
10

本地预览

在桌面版完成转换后,通过本地预览查看成果。原始数据不需要上传到官网。

#

观察重点

  • 初始视角能否看到完整主体。
  • 模型位置、朝向和高度是否正确。
  • 纹理、透明材质和关键构件是否正常。
  • 远近景切换与局部放大是否符合预期。
11

成果检查与交付

一次完整交付应包含可加载的成果,以及足够复现处理过程的项目记录。

#

交付清单

  • 保留完整输出目录,不单独移动入口文件。
  • 确认成果入口与所引用的瓦片资源齐全。
  • 记录原始数据版本、配置和处理日期。
  • 在目标三维平台完成一次实际加载验证。
12

常见问题排查

保留输入样本、转换设置和任务日志,有助于更快地复现问题。

#

模型不在正确位置

  • 检查坐标参考、单位、局部原点和轴向,先用小样本重新验证。

纹理或材质缺失

  • 检查关联图片是否完整,文件名和引用路径是否一致。

任务无法完成

  • 检查输入文件可读性、输出目录权限和剩余磁盘空间。
  • 缩小输入范围后重试,保留异常信息并联系团队。

远景加载负担较大

  • 复查 LOD 与纹理设置,以目标设备中的实际预览结果为准。
Guides

专题文章与参数手册

更完整的格式说明、GUI 参数、Datasmith 交付路径与 3D Tiles 性能调优。

FAQ

文档常见问题

围绕免费 3D Tiles 切片工具、GIS 数据转换教程、IFC / Datasmith 转 3D Tiles 的常见问题。

第一次使用 GeoForge 应该先看哪一份文档?

建议按文档中心的标准使用流程阅读:先安装桌面版并申请免费授权,再用一份小样本完成第一次 3D Tiles 转换,最后检查坐标、材质、LOD 与目标平台加载效果。

GeoForge 文档适合哪些数据类型?

文档覆盖 IFC、Datasmith、OBJ、FBX、glTF、LAS / LAZ、SHP、GeoJSON、倾斜摄影等常见三维、BIM、点云与 GIS 数据,并围绕 3D Tiles 切片、瓦片优化和交付核验组织说明。

个人使用是否需要为高级参数额外付费?

不需要。GeoForge 个人使用完全免费,LOD 优化、瓦片切分、纹理压缩、本地预览和高级优化参数都可以使用,申请免费授权即可开始。

转换完成后为什么还要在目标平台检查?

本地预览可以快速发现位置、方向、材质和层级问题,但不同三维平台的加载策略与客户端环境不同,正式交付前仍建议在 Cesium 或目标平台中完成一次实际加载验证。