文章目录

- 1、工具下载
- 2、使用说明
- 3、详细说明
- - - 命令行格式
    - 示例命令
    - 参数说明
- 4、源码地址

1、工具下载

百度网盘下载链接
选择最新版本下载即可，支持Linux和Windows系统
打开后选择最新版本

2、使用说明

1）按住键盘win+r键，在弹出的窗口中输入cmd
在这里插入图片描述
2）点击确认后即可打开cmd窗口

3）用cd命令切换到工具目录

4）输入model23dtiles.exe -h查看转换工具参数说明

3、详细说明

命令行格式

model23dtiles -i <path> -o <DIR> -tf <jpg/png/webp/ktx2> -vf <draco/meshopt/quantize/quantize_meshopt> -t <quad/oc/kd> -sr <Number> -cl <low/medium/high> -tx <Number> -ty <Number> -tz <Number> -up <X/Y/Z> -tw <Number> -th <Number> -aw <Number> -ah <Number> -tri <Number> -dc <Number> -sx <Number> -sy <Number> -sz <Number> -lng <Number> -alt <Number> -nm <v/f> -nrm -unlit -ntf

或

model23dtiles -i <path> -o <DIR> -tf <jpg/png/webp/ktx2> -vf <draco/meshopt/quantize/quantize_meshopt> -t <quad/oc/kd> -sr <Number> -cl <low/medium/high> -tx <Number> -ty <Number> -tz <Number> -up <X/Y/Z> -tw <Number> -th <Number> -aw <Number> -ah <Number> -tri <Number> -dc <Number> -sx <Number> -sy <Number> -sz <Number> -epsg <Number> -nm <v/f> -nrm -unlit -ntf

示例命令

model23dtiles.exe -i D:\test.fbx -o D:\output -lat 30 -lng 116 -alt 100
# 输出使用ktx2进行纹理压缩和使用draco进行顶点压缩的3dtiles
model23dtiles.exe -i D:\test.fbx -tf ktx2 -vf draco -o D:\output -lat 30 -lng 116 -alt 100.5
# 设置3dtiles的中间节点的简化比例为0.6
model23dtiles.exe -i D:\test.fbx -sr 0.6 -o D:\output -lat 30 -lng 116 -alt 100
# 设置3dtiles的树结构为四叉树，顶点坐标为4549投影坐标系
model23dtiles.exe -i D:\test.fbx -t quad -o D:\output -epsg 4549
# 设置3dtiles的树结构为四叉树，顶点坐标为4549投影坐标系，并将原始模型单位从厘米转换为米
model23dtiles.exe -i D:\test.fbx -t quad -o D:\output -epsg 4549 -sx 0.01 -sy 0.01 -sz 0.01

参数说明

输入输出
- -i 输入文件
- -o 输出文件夹
坐标参数
- -lat 纬度，默认30.0
- -lng 经度，默认116.0
- -alt 高度，默认300
- -epsg 若模型顶点坐标为投影坐标系，指定epsg编码，与lat、lng和alt参数互斥，可以配合tx、ty、tz参数使用
变换参数
- -tx 重设模型原点位置的x坐标，默认0.0
- -ty 重设模型原点位置的y坐标，默认0.0
- -tz 重设模型原点位置的z坐标，默认0.0
- -sx x方向缩放（单位转换），默认1.0
- -sy y方向缩放（单位转换），默认1.0
- -sz z方向缩放（单位转换），默认1.0
- -up 模型向上方向轴，选项：X、Y、Z（大写），默认Y（FBX模型自动转换为Y轴向上）
组织结构参数
- -t 3dtiles组织结构，可选：kd（KD树）、quad（四叉树）、oc（八叉树），默认quad
压缩与简化参数
- -r 3dtiles中间节点简化比例，默认0.5
- -tf 纹理压缩格式，可选：png、jpg、webp、ktx2，默认ktx2
- -vf 顶点压缩格式，可选：draco、meshopt、quantize、quantize_meshopt，无默认值
- -cl draco压缩级别/顶点量化级别，选项：low、medium、high，默认medium，仅对quantize、quantize_meshopt和draco有效；压缩级别越高，模型精度损失越大
性能限制参数
- -tri 3dtiles瓦片最大三角面数，默认20w
- -dc 3dtiles瓦片最大drawcall数量，默认20
- 纹理尺寸参数
  - -tw 单个纹理最大宽度，默认256，需为2的幂
  - -th 单个纹理最大高度，默认256，需为2的幂
  - -aw 纹理图集最大宽度，默认2048，需为2的幂，且大于单个纹理最大宽度，否则不构建图集
  - -ah 纹理图集最大高度，默认2048，需为2的幂，且大于单个纹理最大高度，否则不构建图集
- 变换参数
  - -nft 不对顶点应用变换矩阵；默认会对顶点应用变换矩阵以提升渲染性能(减少drawcall)，但可能带来顶点位置精度损失(如果不启用该参数时，模型发生了变形，请启用该参数)
其他参数
- -nrm 重新计算法线
- -nm 配合 -nrm参数使用，指定法线模式：v表示顶点法线，f表示面法线（默认），可选：v、f（顶点法线适用于平滑曲面，面法线适用于棱角分明的物体）
- -unlit 启用 KHR_materials_unlit 扩展，适用于烘焙模型
- -gn 生成法线贴图（使用Sobel算子）和切线，瓦片会有更好的渲染效果（提升有限）但瓦片的体积也会变大并且处理时间也更长