什么是 Datasmith 格式？3D Tiles 切片与 IFC 的区别
Datasmith 是一种带场景信息的三维交换数据。本文说明它保存什么、与 RVT / IFC / FBX 的区别，以及用于 BIM+GIS 时的检查要点。
Datasmith 是面向三维设计、建筑、工程和可视化场景的一种场景交换格式。它的目标不是只保存某一个模型的几何形状，而是尽可能把一个完整三维场景中的模型结构、材质、纹理、层级关系和场景组织方式一起交给下游软件使用。
在实际项目中，Datasmith 常见于 Revit、3ds Max、SketchUp、Rhino、SolidWorks、Navisworks、Archicad 等设计或建模软件与 Unreal Engine、Twinmotion 以及其他三维应用之间的数据交换。Revit 用户也可以将模型导出为 Datasmith，再使用 GeoForge 将其转换为 3D Tiles，用于 BIM+GIS 场景的浏览和发布。
一、Datasmith 格式到底是什么？
简单来说，Datasmith 是一种“带场景信息的三维交换数据”。它通常由一个 .udatasmith 文件和一组配套资源组成。
.udatasmith 文件可以理解为场景的描述文件，其中记录了模型对象、场景层级、对象之间的组织关系以及对象所引用的材质和纹理等信息。模型的几何数据、贴图和其他资源可能位于与它配套的资源目录中。
因此，Datasmith 文件通常不能按照普通单文件模型来理解。一个完整的 Datasmith 场景往往包括：
- 一个
.udatasmith场景文件； - 与场景文件对应的几何或资源文件；
- 材质相关文件；
- 纹理图片；
- 可能存在的其他依赖资源。
不同导出工具和版本生成的目录结构可能有所不同。使用时最重要的原则是：将 .udatasmith 文件及其导出目录中的配套资源视为一个整体进行管理。
二、Datasmith 主要保存哪些信息？
1. 模型几何
Datasmith 场景包含建筑、设备、构件、家具和其他三维对象的几何数据。下游软件可以根据这些数据重建可视化场景，而不必只面对一个缺少结构信息的整体网格。
2. 场景层级和对象关系
建筑模型通常不是一个单独物体，而是由楼层、房间、墙、门、窗、设备等许多对象组成。Datasmith 会尽量保留这些对象在原始场景中的组织关系，便于下游软件按照场景层级进行加载、管理和展示。
3. 材质和纹理
材质决定模型表面的颜色、透明度、粗糙度和反射等视觉效果；纹理则通常是贴在模型表面的图片。Datasmith 会记录对象与材质、纹理之间的引用关系，使场景导入后能够尽量接近原始模型的外观。
不过，材质并不是所有软件都能完全等价地互相转换。源软件中的专有材质节点、程序化材质或特殊渲染效果，在进入其他软件后可能需要重新解释或烘焙，因此不能简单理解为“所有材质参数都能原样保留”。
4. 场景位置和变换
对象的平移、旋转、缩放以及场景中的相对位置也是 Datasmith 场景的重要组成部分。这些信息对于建筑可视化很重要，但它们不一定等同于 GIS 系统所需的经纬度、投影坐标和高程基准。
在 BIM+GIS 项目中，仍然需要单独核对模型单位、项目基点、朝向、高程和目标坐标位置。
三、.udatasmith 文件和资源目录是什么关系？
可以把 .udatasmith 文件理解为“场景索引和关系描述”，把资源目录理解为“场景实际引用的内容”。.udatasmith 中的对象可能引用外部纹理、材质或几何资源；如果这些文件被删除、改名或移动，导入软件就可能无法找到对应内容。
常见错误包括：
- 只复制了
.udatasmith文件，没有复制资源目录； - 只复制了部分纹理图片；
- 改变了文件夹层级，导致相对路径失效；
- 将不同批次导出的
.udatasmith文件和资源混在一起； - 在导出完成后单独重命名或移动资源文件。
更稳妥的做法是保留原始导出目录，或者将 .udatasmith 文件及其全部配套资源整体复制到新的位置。导入前还应先检查场景在源工具或目标工具中的材质、纹理和模型完整性。
四、Datasmith 与常见三维格式有什么区别？
Datasmith 与 RVT
.rvt 是 Revit 的原生项目文件，包含 Revit 软件内部的参数化构件、族、视图和项目数据。Datasmith 是从 Revit 等软件导出的交换成果，重点是把场景带到其他三维应用中。
两者不是同一种格式，也不能互相等同。GeoForge 当前不支持直接解析 .rvt 文件。需要接入 Revit 模型时，可以先从 Revit 导出 Datasmith 或 IFC，再选择对应流程进行转换。
Datasmith 与 IFC
IFC 是建筑信息模型领域常用的开放交换格式，适合不同 BIM 软件之间进行模型和工程信息交换。Datasmith 则更侧重实时三维可视化、场景组织、材质和视觉效果。
可以根据目标选择：
| 目标 | 更适合优先考虑 |
|---|---|
| 关注开放交换和多软件协作 | IFC |
| 关注 Revit 场景效果、材质和层级 | Datasmith |
| 需要把 BIM 场景发布到 BIM+GIS 平台 | 根据数据来源和成果要求选择 IFC 或 Datasmith |
这不是绝对的格式优劣判断。实际选择还要结合源软件、模型复杂度、材质要求、属性需求和目标平台能力。
Datasmith 与 FBX
FBX 常用于交换几何、骨骼、动画和材质等三维内容，但不同导出器对场景结构和材质的处理方式可能不同。Datasmith 更强调建筑、工程和设计场景的组织方式以及面向实时可视化的导入流程。
如果项目只需要交换一个简单网格，其他格式可能已经足够；如果需要处理由许多建筑构件、材质和纹理组成的完整场景，Datasmith 往往更符合使用需求。
五、Datasmith 适合哪些场景？
Datasmith 比较适合以下类型的三维项目：
- Revit 建筑模型的实时可视化；
- 建筑、园区和厂房场景展示；
- 设备、管线和室内场景浏览；
- BIM 模型与地形、影像或倾斜摄影数据叠加；
- 需要保留较完整材质和纹理效果的三维发布；
- 将设计软件中的场景交给实时渲染或三维平台继续使用。
它尤其适合“模型已经在设计软件中完成，需要带着场景效果进入下游平台”的工作流程。
六、Datasmith 用于 BIM+GIS 时要注意什么？
Datasmith 解决的是三维场景交换问题，但 BIM+GIS 还需要解决空间定位和大场景加载问题。因此，导出 Datasmith 之后，通常还需要进行以下检查：
1. 检查模型位置
确认模型使用的单位、项目基点、真实世界坐标、朝向和高程。模型位置错误时，即使几何和材质都完整，也可能无法与地形或影像正确重合。
2. 检查资源完整性
确保 .udatasmith 文件和配套资源目录来自同一次导出，并且纹理没有丢失。建议先用小范围场景进行验证，再处理完整项目。
3. 进行适合平台的轻量化
原始 BIM 场景通常包含大量构件、三角面和纹理。直接把原始场景交给浏览器加载，可能造成首次打开慢、内存占用高或视角切换不流畅。
GeoForge 可以将 Datasmith 场景转换为 3D Tiles，并根据项目需要配置 LOD、空间分割、纹理尺寸、纹理容量和网格优化等选项。参数应根据模型规模和目标平台逐步调整，不建议一开始就追求最高画质。
4. 验收近景和远景效果
转换完成后，应同时检查模型远景概览和近景细节，重点关注：
- 模型是否位于正确的地理位置；
- 建筑构件是否出现明显缺失；
- 材质和纹理是否正常显示；
- 透明、反射和镂空效果是否符合预期；
- 远近景切换是否平滑；
- 输出目录是否包含
tileset.json和对应瓦片数据。
七、在 GeoForge 中如何使用 Datasmith？
GeoForge 面向 GUI 用户提供 Datasmith 模型切片流程，基本步骤如下：
- 从源软件导出
.udatasmith文件，并保留完整资源目录； - 打开 GeoForge，创建转换作业，选择 Datasmith 模型切片流程；
- 载入
.udatasmith文件或对应场景目录，设置输出目录； - 配置模型坐标、单位、位置、高程和旋转等空间参数；
- 根据目标平台配置 LOD、空间分割和纹理优化参数；
- 保存并运行作业，在任务列表中查看转换状态；
- 检查输出的
tileset.json和瓦片数据，并进行三维预览或服务发布。
具体界面和参数说明可参考 Datasmith 模型切片 与 GeoForge 使用手册。
八、常见问题
.udatasmith 是不是一个压缩包？
不能简单把它当成只包含全部数据的压缩包。它通常是场景文件，实际项目还可能依赖同目录或相关目录中的外部资源。是否包含某些资源，取决于导出工具和导出方式。
只有 .udatasmith 文件可以吗？
不建议。若场景依赖外部材质、纹理或几何资源，只提供单个 .udatasmith 文件可能导致模型缺失或材质丢失。应尽量保留完整导出目录。
Datasmith 能不能直接替代 IFC？
不能。两者的设计重点不同：IFC 更偏向开放 BIM 数据交换，Datasmith 更偏向带场景效果的三维可视化交换。应根据项目目标选择格式。
Datasmith 能不能直接导入 GeoForge？
可以使用 GeoForge 的 Datasmith 模型切片流程，但输入应是完整的 Datasmith 场景，而不是只挑出一个孤立的 .udatasmith 文件。GeoForge 当前不支持直接导入 .rvt，Revit 模型需要先导出 Datasmith 或 IFC。
九、总结
Datasmith 可以理解为一种面向三维场景的交换格式。它不仅关注模型几何，还关注场景层级、材质、纹理和对象关系，因此适合建筑、工程和实时三维可视化场景。
使用 Datasmith 时，最需要记住三点：
.udatasmith文件通常要和配套资源目录一起使用；- Datasmith 不等于 Revit 原生
.rvt，也不等于 IFC； - 用于 BIM+GIS 时，除了模型和材质，还必须检查坐标定位、轻量化和 3D Tiles 成果。
通过 GeoForge，用户可以将准备好的 Datasmith 场景转换为包含 tileset.json 和瓦片数据的 3D Tiles 成果，再用于 BIM+GIS 平台的预览、联调和发布。