Cesium 3dtile 数据格式调度源码解析

最新推荐文章于 2025-10-21 09:14:41 发布

原创

最新推荐文章于 2025-10-21 09:14:41 发布 · 1.2k 阅读

4 ·

CC 4.0 BY-SA版权

本文主要介绍了Cesium 1.81-1.82版本中关于3DTiles内容处理的源码解析，特别是针对tileset.json几何误差属性问题的修复。在这一版本中，由于geometricError字段缺失导致的错误，通过将json.geometricError改为json.root得以解决。文章还探讨了Cesium与大型商业软件如ArcGIS在数据处理上的差异，并展示了Cesium的开源优势。源码解析部分详细阐述了Cesium如何通过Cesium3DTile模块的makeContent函数、preprocess3DTileContent模块以及Cesium3DTileContentFactory转换工厂来处理不同类型的3DTiles内容。

1 背景

Cesium的1.81-1.82版本的更新导致如果tileset.json的初始化字段中不包含geometricError属性字段即将进入下一个类型判断。
因为拿不到数据导致undefined，错误报在ModelUtility.computeBoundingSphere的位置。
具体错误如下
在这里插入图片描述

2 源码解析

这里简单解析，具体怎么玩转的，还是自己要调试一回。

2.1入口模块

Cesium3DTile模块的makeContent(tile, arrayBuffer)函数。此函数主要是用来装载3ditile的单个内容，言外之意就是Cesium在加载三维数据（3dtiles）时，每一个切片都会调用这个方法来获取元数据信息和流。

2.2 类型获取

preprocess3DTileContent模块，使用Most likely a XXX，本身设计上就不严谨。
解决背景中error的方法：将原来为json.geometricError，修改为json.root即可，本质是解析tileset.json的文件。
更早的版本还只是在使用getMagic来取固定字符串，然后匹配类型解决问题。

这可能就是跟ArcGIS这种大型商业软件的提供了稳定的数据处理工具的差距。
反过来，Cesium的优势也是ArcGIS不可比拟的，比如开源，比如免费，只是增加了学习成本，但这带来的却是正在的理解GIS体系和个人以及团队的知识积累，不再是简单的调用API了，更多的需要自己去思考如何解决这些实际存在的问题。

export default function preprocess3DTileContent(arrayBuffer) {
   
   
  var uint8Array = new Uint8Array(arrayBuffer);
  var contentType = getMagic(uint8Array);

  // We use glTF for JSON glTF files. For binary glTF, we rename this
  // to glb to disambiguate
  if (contentType === "glTF") {
   
   
    contentType = "glb";
  }

  if (Cesium3DTileContentType.isBinaryFormat(contentType)) {
   
   
    return {
   
   
      // For binary files, the enum value is the magic number
      contentType: contentType,
      binaryPayload: uint8Array,
    };
  }
  var json = getJsonContent(uint8Array);
  // 原来为json.geometricError,修改为js