从3D Tiles到I3S：使用loaders.gl实现不同瓦片格式的转换

从3D Tiles到I3S：使用loaders.gl实现不同瓦片格式的转换

【免费下载链接】loaders.glLoaders for big data visualization. Website:项目地址: https://gitcode.com/gh_mirrors/lo/loaders.gl

在地理信息和3D可视化领域，瓦片格式的转换是连接不同系统的关键环节。loaders.gl作为一个功能强大的开源项目，提供了高效的工具链，帮助开发者轻松实现3D Tiles与I3S（Indexed 3D Scene Layer）之间的双向转换。本文将详细介绍如何使用loaders.gl的tile-converter工具，快速掌握两种主流瓦片格式的转换技巧。

为什么需要瓦片格式转换？

3D Tiles和I3S是目前主流的两种3D地理数据瓦片格式。3D Tiles由Cesium主导，广泛应用于开源生态系统；而I3S是Esri推出的格式，在ArcGIS等专业GIS平台中被广泛采用。实现这两种格式的转换，能够打破平台壁垒，实现数据的跨系统共享和可视化。

图：使用loaders.gl转换后的I3S建筑模型在可视化工具中的展示效果

快速开始：安装tile-converter工具

loaders.gl提供了专门的瓦片转换工具——tile-converter，支持3D Tiles与I3S之间的双向转换。通过以下简单步骤即可完成安装：

npm install @loaders.gl/tile-converter

安装完成后，可通过以下命令验证安装是否成功：

npx tile-converter --help

首次使用前，需要安装必要的依赖项：

npx tile-converter --install-dependencies

核心功能：3D Tiles与I3S的双向转换

tile-converter工具支持两种方向的转换：3D Tiles到I3S，以及I3S到3D Tiles。下面分别介绍这两种转换的基本用法。

从3D Tiles转换到I3S

将3D Tiles转换为I3S格式的基本命令如下：

npx tile-converter --input-type 3DTILES --tileset ./path/to/tileset.json --name my-i3s-tileset --output ./output-folder

关键参数说明：

• --input-type：指定输入类型为3DTILES
• --tileset：3D Tiles的tileset.json文件路径
• --name：输出I3S瓦片集的名称
• --output：指定输出目录

从I3S转换到3D Tiles

将I3S转换为3D Tiles格式的命令如下：

npx tile-converter --input-type I3S --tileset http://example.com/SceneServer/layers/0 --name my-3dtiles-tileset --output ./output-folder

I3S通常通过URL提供，因此--tileset参数可以直接使用远程地址。

图：转换后的I3S纽约城市模型，通过高度着色展示建筑分布

高级选项：优化转换过程

tile-converter提供了多种高级选项，帮助用户根据需求优化转换过程：

控制转换深度

使用--max-depth参数限制瓦片树的遍历深度，适用于测试或需要快速预览的场景：

npx tile-converter --input-type 3DTILES --tileset ./tileset.json --name my-tileset --max-depth 4

处理纹理和压缩

• --generate-textures：自动生成压缩纹理（KTX2格式）
• --no-draco：禁用Draco几何压缩

npx tile-converter --input-type 3DTILES --tileset ./tileset.json --name my-tileset --generate-textures --no-draco

内存优化

对于大型数据集，使用--instant-node-writing选项可以减少内存占用：

npx tile-converter --input-type 3DTILES --tileset ./large-tileset.json --name my-tileset --instant-node-writing

使用Docker简化转换流程

为了避免环境配置问题，loaders.gl提供了Docker镜像，预装了所有依赖：

docker pull visgl/tile-converter

使用Docker运行转换命令：

docker run \ --rm \ -v /path/to/output:/loaders-bundle/data \ visgl/tile-converter \ --input-type 3DTILES \ --tileset /loaders-bundle/input/tileset.json \ --name my-tileset \ --output data

验证转换结果

转换完成后，可以使用I3S服务器查看结果：

PORT=8080 I3sLayerPath="./output-folder" npx i3s-server

然后在浏览器中访问：http://localhost:8080/my-tileset/SceneServer/layers/0

总结

loaders.gl的tile-converter工具为3D Tiles和I3S格式之间的转换提供了便捷高效的解决方案。无论是简单的格式转换还是复杂的大型数据集处理，都能通过灵活的参数配置满足需求。通过本文介绍的方法，您可以轻松实现不同3D瓦片格式之间的转换，为跨平台数据共享和可视化提供有力支持。

更多详细文档和API参考，请查看项目中的docs/modules/tile-converter/目录。

【免费下载链接】loaders.glLoaders for big data visualization. Website:项目地址: https://gitcode.com/gh_mirrors/lo/loaders.gl