Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fanvanzh/3dtiles
The fastest tools for 3dtiles convert in the world!
https://github.com/fanvanzh/3dtiles
3d-tiles 3dtiles b3dm cesium-3dtiles gltf osgb
Last synced: 6 days ago
JSON representation
The fastest tools for 3dtiles convert in the world!
- Host: GitHub
- URL: https://github.com/fanvanzh/3dtiles
- Owner: fanvanzh
- License: apache-2.0
- Created: 2018-02-09T15:07:43.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2024-05-23T11:23:53.000Z (7 months ago)
- Last Synced: 2024-10-29T15:37:00.356Z (about 1 month ago)
- Topics: 3d-tiles, 3dtiles, b3dm, cesium-3dtiles, gltf, osgb
- Language: C++
- Homepage:
- Size: 67.9 MB
- Stars: 1,962
- Watchers: 80
- Forks: 593
- Open Issues: 87
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-3d-tiles - 3dtiles - Tools for 3D-Tiles conversion. (Tile creation (Community))
- AwesomeCppGameDev - 3dtiles
README
**English | [简体中文](#简介)**
# Introduction
[](https://github.com/KhronosGroup/glTF)
[](https://github.com/fanvanzh/3dtiles/actions/workflows/linux.yml)
[](https://github.com/fanvanzh/3dtiles/actions/workflows/windows.yml)
3D-Tiles convertion:
- `Osgb(OpenSceneGraph Binary)` to `3D-Tiles`: convert huge of osgb file to 3D-Tiles.
- `Esri Shapefile` to `3D-Tiles`: convert shapefile to 3D-Tiles.
- `Fbx` to `3D-Tiles`: convert fbx file to 3D-Tiles, include auto_lod\texture convertion etc.
You may intereted in:
- [How to build?](https://github.com/fanvanzh/3dtiles/wiki/How-to-build)
- [How to debug?](https://github.com/fanvanzh/3dtiles/wiki/How-to-debug)
- [Download Windows Pre-build](https://github.com/fanvanzh/3dtiles/releases/download/v0.4/3dtile.zip)
- [Docker Image](https://hub.docker.com/r/winner1/3dtiles)
# Build
## Ubuntu
```
sudo apt-get update
sudo apt-get install -y g++ libgdal-dev libopenscenegraph-dev cargo
git clone https://github.com/fanvanzh/3dtiles
cd 3dtiles
cargo build --release
```
## Centos
```
sudo yum install -y gdal-devel cargo g++
git clone https://github.com/fanvanzh/3dtiles
cd 3dtiles
git clone https://github.com/microsoft/vcpkg.git
./vcpkg/bootstrap-vcpkg.sh
./vcpkg/vcpkg install osg:x64-linux-release
cargo build --release
```
## Windows
```
curl https://sh.rustup.rs -sSf -o rustup-init.exe
./rustup-init.exe -y
git clone https://github.com/fanvanzh/3dtiles
cd 3dtiles
git clone https://github.com/microsoft/vcpkg.git
./vcpkg/bootstrap-vcpkg.bat
./vcpkg/vcpkg install osg:x64-windows-release
./vcpkg/vcpkg install gdal:x64-windows-release
cargo build --release
```
# Usage
## ① Command Line
```sh
_3dtile.exe [FLAGS] [OPTIONS] --format --input --output
```
## ② Examples
```sh
# from osgb dataset
_3dtile.exe -f osgb -i E:\osgb_path -o E:\out_path
_3dtile.exe -f osgb -i E:\osgb_path -o E:\out_path -c "{\"offset\": 0}"
# use pbr-texture
_3dtile.exe -f osgb -i E:\osgb_path -o E:\out_path -c "{\"pbr\": true}"
# from single shp file
_3dtile.exe -f shape -i E:\Data\aa.shp -o E:\Data\aa --height height
# from single osgb file to glb file
_3dtile.exe -f gltf -i E:\Data\TT\001.osgb -o E:\Data\TT\001.glb
# from single obj file to glb file
_3dtile.exe -f gltf -i E:\Data\TT\001.obj -o E:\Data\TT\001.glb
# convert single b3dm file to glb file
_3dtile.exe -f b3dm -i E:\Data\aa.b3dm -o E:\Data\aa.glb
```
---
**[English](#Introduction) | 简体中文**
简介
3D-Tile 转换工具集，高效快速的 3D-Tiles 生产工具。
提供了如下的子工具：
- `Osgb(OpenSceneGraph Binary)` 转 `3D-Tiles`
- `Esri Shapefile` 转 `3D-Tiles`
- `Fbx` 转 `3D-Tiles`
- ...
# 编译
## Ubuntu
```
sudo apt-get update
sudo apt-get install -y g++ libgdal-dev libopenscenegraph-dev cargo
git clone https://github.com/fanvanzh/3dtiles
cd 3dtiles
cargo build --release
```
## Centos
```
sudo yum install -y gdal-devel cargo g++
git clone https://github.com/fanvanzh/3dtiles
cd 3dtiles
git clone https://github.com/microsoft/vcpkg.git
./vcpkg/bootstrap-vcpkg.sh
./vcpkg/vcpkg install osg:x64-linux-release
cargo build --release
```
## Windows
```
curl https://sh.rustup.rs -sSf -o rustup-init.exe
./rustup-init.exe -y
git clone https://github.com/fanvanzh/3dtiles
cd 3dtiles
git clone https://github.com/microsoft/vcpkg.git
./vcpkg/bootstrap-vcpkg.bat
./vcpkg/vcpkg install osg:x64-windows-release
./vcpkg/vcpkg install gdal:x64-windows-release
cargo build --release
```
# 使用说明
## ① 命令行格式
```sh
_3dtile.exe [FLAGS] [OPTIONS] --format --input --output
```
## ② 示例命令
```sh
# from osgb dataset
_3dtile.exe -f osgb -i E:\osgb_path -o E:\out_path
_3dtile.exe -f osgb -i E:\osgb_path -o E:\out_path -c "{\"offset\": 0}"
# from single shp file
_3dtile.exe -f shape -i E:\Data\aa.shp -o E:\Data\aa --height height
# from single osgb file to glb file
_3dtile.exe -f gltf -i E:\Data\TT\001.osgb -o E:\Data\TT\001.glb
# from single obj file to glb file
_3dtile.exe -f gltf -i E:\Data\TT\001.obj -o E:\Data\TT\001.glb
# convert single b3dm file to glb file
_3dtile.exe -f b3dm -i E:\Data\aa.b3dm -o E:\Data\aa.glb
```
## ③ 参数说明
- `-c, --config ` 在命令行传入 json 配置的字符串，json 内容为选配，可部分实现
json 示例：
``` json
{
"x": 120,
"y": 30,
"offset": 0,
"max_lvl" : 20
}
```
- `-f, --format ` 输入数据格式。
`FORMAT` 可选：osgb, shape, gltf, b3dm
`osgb` 为倾斜摄影格式数据, `shape` 为 Shapefile 面数据, `gltf` 为单一通用模型转gltf, `b3dm` 为单个3dtile二进制数据转gltf
- `-i, --input ` 输入数据的目录，osgb数据截止到 `/Data` 目录的上一级，其他格式具体到文件名。
- `-o, --output ` 输出目录。输出的数据文件位于 `/Data` 目录。
- `--height` 高度字段。指定shapefile中的高度属性字段，此项为转换 shp 时的必须参数。
# 数据要求及说明
### ① 倾斜摄影数据
倾斜摄影数据仅支持 smart3d 格式的 osgb 组织方式：
- 数据目录必须有一个 `“Data”` 目录的总入口；
- `“Data”` 目录同级放置一个 `metadata.xml` 文件用来记录模型的位置信息；
- 每个瓦片目录下，必须有个和目录名同名的 osgb 文件，否则无法识别根节点；
正确的目录结构示意：
```
- Your-data-folder
├ metadata.xml
└ Data\Tile_000_000\Tile_000_000.osgb
```
### ② Shapefile
目前仅支持 Shapefile 的面数据，可用于建筑物轮廓批量生成 3D-Tiles.
Shapefile 中需要有字段来表示高度信息。
### ③ 通用模型转 glTF：
支持 osg、osgb、obj、fbx、3ds 等单一通用模型数据转为 gltf、glb 格式。
转出格式为 2.0 的gltf，可在以下网址验证查看： https://pissang.github.io/clay-viewer/editor/
### ④ B3dm 单文件转 glb
支持将 b3dm 单个文件转成 glb 格式，便于调试程序和测试数据