gltfgen

从网格文件编号序列生成 glTF 2.0 动画的命令行工具。

用法

最新的 gltfgen 构建可通过以下方式获取

> cargo install gltfgen

有关特殊构建，请参阅 发布。

以下是最基本的用法模式

> gltfgen [FLAGS] [OPTIONS] <OUTPUT> <PATTERN>

• <OUTPUT> 输出 glTF 文件

• <PATTERN> 匹配要包含在生成的 glTF 文档中的文件的 glob 模式。使用 # 匹配帧编号。使用 '{' 和 '}' 选择用于在输出 glTF 中命名网格的模式部分。

运行 gltfgen -h 获取更多选项，并使用 gltfgen --help 获取详细信息。

示例

以下示例假设存在位于 ./meshes/animation_#.vtk 的网格序列，其中 # 代表帧编号。要在当前目录中生成名为 output.glb 的动画二进制 glTF 文件，请运行

> gltfgen output.glb "./meshes/animation_#.vtk"

这将假定每秒 24 帧。您可以使用 -f 选项手动指定 FPS，如下所示

> gltfgen -f 100 output.glb "./meshes/animation_#.vtk"

或者，为了指定帧之间的时间步长，例如 0.01 秒，请使用 -t 选项

> gltfgen -t 0.01 output.glb "./meshes/animation_#.vtk"

功能

输入类型

• 支持双精度或单精度格式的历史和 XML VTK 多边形和四面体网格。特别是支持非结构化网格和多边形 VTK 格式。四面体 VTK 网格将实时转换为三角形网格。
• 包含多边形网格的基本 wavefront obj 文件（尚不支持 .mtl）。
• 支持 JPEG 和 PNG 图像纹理。

输出类型

• glTF 2.0 的二进制和标准格式。

其他特性

• 多个网格文件序列可以自动嵌入到单个 glTF 文件中。
• 未被编号的网格文件，如果被 glob 模式捕获，将被放置在帧 0。
• 跳过带有 -s 标志的帧以减小文件大小并提高性能。
• 图像纹理可以直接引用或嵌入到 glTF 文件中。
• 完全支持
  • 颜色属性，
  • 纹理属性，
  • 自定义属性，
• 完全支持纹理。
• VTK 原语上的材质属性用于引用命令行上提供的特定材质。

更新日志

请参阅 CHANGELOG.md 以获取更新。

许可证

此存储库根据 Mozilla Public License, v. 2.0 许可。

贡献

有关详细信息，请参阅 CONTRIBUTING.md。