网格转换工具，包括 glTF/GLB 支持和 Draco 网格压缩-GLB下载网

网状史密斯

GitHub – Smithsonian/dpo-meshsmith：网格转换工具，包括 glTF/GLB 支持和 Draco 网格压缩

基于 Assimp 网格库和 Google Draco 网格压缩库的网格格式转换的命令行工具。

MeshSmith 是开源软件，是史密森尼 3D 基金会项目的一部分。该工具集成在史密森尼的 3D 处理管道库克中。

特征

从/转换为所有可用的 Assimp 格式（OBJ、FBX、PLY、Collada 等）
导出压缩的 glTF 和 glb 文件（格式和gltfxglbx)
简单的网格作，例如坐标重排、缩放、平移
检查功能生成 JSON 格式的网格统计信息

作者

Ralph Wiedemeier，框架工厂有限公司

用法

命令行选项

MeshSmith.exe [OPTION...]

-c, --config arg          JSON configuration file
-i, --input arg           Input file name
-o, --output arg          Output file name
-f, --format arg          Output file format

-j, --joinvertices        Join identical vertices
-n, --stripnormals        Strip normals
-u, --striptexcoords      Strip texture coords
-z, --swizzle arg         Swizzle coordinates
-s, --scale arg           Scale scene by given factor
    --flipuv              Flip UV y coordinate

-a, --diffusemap arg      Diffuse map to be included (gltfx/glbx only)
-b, --occlusionmap arg    Occlusion map to be included (gltfx/glbx only)
-m, --normalmap arg       Normal map to be included (gltfx/glbx only)
-e, --embedmaps           Embed maps (gltfx/glbx only)
-t, --objectspacenormals  Use object space normals (gltfx/glbx only)
-p, --compress            Compress mesh data using Draco (gltfx/glbx only)

-r, --report              Print JSON-formatted report
-l, --list                Print JSON-formatted list of export formats
-v, --verbose             Print log messages to std out
-h, --help                Displays this message

示例 JSON 配置文件

无需在命令行上指定所有参数，而是可以通过参数指定 JSON 配置文件。--config

如果命令行选项和具有相同选项的配置文件同时存在，则命令行选项优先。请注意，一些高级选项只能通过配置文件获得。

{
    "input": "input-mesh.obj",
    "output": "output.glb",
    "format": "glbx",

    "verbose": false,
    "report": false,
    "list": false,
    
    "joinVertices": false,
    "stripNormals": false,
    "stripTexCoords": false,
    
    "swizzle": "X+Y+Z+",
    "scale": 1.0,
    "translate": [ 0.0, 0.0, 0.0 ],
    "alignX": 0, // 0 = center, -1 = minimum, 1 = maximum
    "alignY": -1,
    "alignZ": 1,
    "flipUV": false,
    "matrix": [ 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1 ],
    
    "gltfx": {
        "metallicFactor": 0.1,
        "roughnessFactor": 0.8,
        "diffuseMap": "diffuse.jpg",
        "occlusionMap": "occlusion.jpg",
        "emissiveMap": "emissive.jpg",
        "metallicRoughnessMap": "metallic-roughness.jpg",
        "normalMap": "normals.jpg",
        "zoneMap": "zones.jpg",
  
        "objectSpaceNormals":  true,
        "embedMaps": false,
        "useCompression": true
      },
    "compression": {
      "positionQuantizationBits": 14,
      "texCoordsQuantizationBits": 12,
      "normalsQuantizationBits": 10,
      "genericQuantizationBits": 8,
      "compressionLevel": 8
    }
  }

例子

打印所有可用的输入和输出格式（JSON 格式）

MeshSmith.exe --list

使用配置文件调用

MeshSmith.exe --config my_config.json

将网格从 OBJ 转换为 PLY 格式

MeshSmith.exe -i input.obj -o output.ply -f plyb

按系数 0.1 缩放网格

MeshSmith.exe -i input.obj -o output.obj -f objnomtl -s 0.1

创建 glTF 文件（未压缩）

MeshSmith.exe -i mesh.obj -a diffuse.jpg -f gltfx

创建包含嵌入式地图的压缩 GLB 文件

MeshSmith.exe -i mesh.obj -a diffuse.jpg -b occlusion.jpg -m normals.jpg --compress --embedmaps -f glbx

生成和安装（Windows）

自行构建 MeshSmith 需要有关使用 CMake 和 Visual Studio 构建和维护 C++ 项目的基本知识。目前唯一支持的作系统是 Windows。

先决条件

第三 Pary 图书馆

阿辛普

Assimp 是一个用于导入和导出各种 3D 模型格式的库，包括场景后处理以生成缺失的渲染数据。

MeshSmith 使用 Assimp 的修改版本，其中包含许多用于处理大型 OBJ 文件的修复程序。

修改版本：https://github.com/framelab/assimp
原始存储库：https://github.com/assimp/assimp

天龙座

Draco 是一个用于压缩和解压缩 3D 几何网格和点云的库。它旨在改进 3D 图形的存储和传输。

存储库：https://github.com/google/draco

构建库

Assimp 和 Draco 作为子模块包含在 MeshSmith 存储库中。它们可以在子文件夹中找到。为了正确克隆子模块，您需要使用MeshSmith 使用选项。libs--recurse-submodules

git clone --recurse-submodules https://github.com/Smithsonian/dpo-meshsmith

为方便起见，MeshSmith 根文件夹中提供了生成脚本。它要求将 Visual Studio 2019 安装在其默认位置。打开命令提示符并输入以下内容：

.build-libs-win64.bat

构建 MeshSmith CLI 应用程序

构建库后，可以按如下方式启动应用程序构建（调试和发布版本）：

.build-app-win64.bat

生成输出

调试版本：bindebug
发布版本：binrelease

Name
框架工厂修复了报表生成中的错误 62a116b · 6 years ago
库	添加了库子模块：assimp、draco、flow-libs	6 years ago
源	修复了报表生成中的错误	6 years ago
.gitignore 域名	新的库和应用程序构建脚本，清理	6 years ago
.git模块	添加了库子模块：assimp、draco、flow-libs	6 years ago
CMakeLists.txt	新的库和应用程序构建脚本，清理	6 years ago
LICENSE.md	更新的许可证标头和自述文件	6 years ago
README.md	更新的许可证标头和自述文件	6 years ago
THIRD_PARTY_LICENSES.md	更新的许可证标头和自述文件	6 years ago
build-app-win64.bat	新的库和应用程序构建脚本，清理	6 years ago
build-libs-win64.bat	新的库和应用程序构建脚本，清理	6 years ago
config.json	更新的许可证标头和自述文件	6 years ago
formats.json	更新的许可证标头和自述文件	6 years ago
generate-app-win64.bat	新的库和应用程序构建脚本，清理	6 years ago