Skip to content

Latest commit

 

History

History
114 lines (85 loc) · 3.47 KB

README.md

File metadata and controls

114 lines (85 loc) · 3.47 KB

p3dtiles 介绍

3dtiles 开发小工具，拟实现读取3dtiles数据集（非3d显示）、修改部分数据。 如有可能，考虑做数据融合和转换等工作。使用python3原生实现，当前暂无第三方依赖库。

现在能读取一个瓦片文件，把它从二进制转换为dict类型。

开发中的工作见TODO。 基本用法见Usage/用法

English Introduction

3dtiles sdk, aims to load the binary tile file(*.b3dm, *.i3dm, *.pnts, *.cmpt) , load the tileset, and modify some data in it.

Implement using python3 without any 3rd-part dependences.

Now it can load a tile file to jsonfile by using B3dm.toDict() method, return a <python dict> object. If you like, you can save it to a jsonfile.

Future work see TODO. Basic usage see Usage/用法

Usage / 用法

Load a tile file from given path / 从路径读取瓦片

from p3dtiles import B3dm

b3dm = B3dm('path to a *.b3dm file')
print(b3dm.toDict())

Load a tile file from fileHandle/从文件指针读取瓦片

from p3dtiles import B3dm

b3dm = B3dm(open('D:/XXX.b3dm', 'rb'))
print(b3dm.toDict())

Method 'toDict()' return b3dm's readable information. 方法'toDict()'返回人类可读的数据。

Load a tile file from bytes/从二进制变量读取瓦片

from p3dtiles import B3dm

b3dm = B3dm(open('D:/XXX.b3dm', 'rb').read())
print(b3dm.toDict())

get gltf or glb from *.b3dm/从b3dm瓦片中提取gltf或glb

from p3dtiles import B3dm

b3dm = B3dm(open('D:/XXX.b3dm', 'rb'))
b3dm.getGlb("D:/XXX.glb")

or

from p3dtiles import B3dm

b3dm = B3dm(open('D:/XXX.b3dm', 'rb'))
b3dm.getGltf("D:/XXX.gltf", False)

Note(注意): params2 I pass a 'False' which means I do not want to embbed gltfBinaryData using base64 encoding format in *.gltf > buffers[0] 参数2，我传递了一个False值（当然默认就是False），意思是我不想把gltf引用的二进制数据用base64编码来嵌入gltf文件内，即独立成一个二进制文件。

TODO

  • 完善GlTF模块的代码分离

  • 递归解构Tileset.json

  • 添加提取瓦片文件元数据的功能（ftJSON、btJSON等用于描述二进制文件的数据）

  • 优化解析逻辑，提升初始化速度

项目结构

目录
├─.gitignore // git忽略列表
├─README.md
|
├─p3dtiles // 主包
|    ├─Tileset.py   // 处理tileset.json文档的模块
|    ├─__init__.py
|    ├─TileFormat   // 子包，处理各种瓦片
|    |     ├─Tile.py    // 所有瓦片类的基类[TODO]
|    |     ├─B3dm.py    // 处理b3dm瓦片的模块
|    |     ├─Cmpt.py    // 处理cmpt瓦片的模块
|    |     ├─GlTF.py    // 处理glTF模型的模块
|    |     ├─Vctr.py    // 处理Vctr模型的模块
|    |     ├─I3dm.py    // 处理i3dm瓦片的模块
|    |     ├─Pnts.py    // 处理pnts瓦片的模块
|    |     ├─__init__.py
|    |     └─TileBodyTable  // 子包，处理瓦片中的要素表和批量表
|    |             ├─BatchTable.py  // 处理批量表的模块
|    |             ├─DataTypeTranslator.py  // 处理两大表时转译结构数据类型的模块
|    |             ├─FeatureTable.py    // 处理要素表的模块
|    |             └__init__.py
|    └─FileUtils
|          └FileHelper.py   // 文件处理的模块
|
└─.vscode   // vscode配置
     └─ ...

其他实现

  • typescript comming
  • golang coming