Command line tool for generating a glTF 2.0 animation from a sequence of meshes
MPL-2.0 License
gltfgen
A command line tool for generating glTF 2.0 animations from numbered sequences of mesh files.
The latest gltfgen
builds are available via
> cargo install gltfgen
For special builds see Releases.
The following is the most basic usage pattern:
> gltfgen [FLAGS] [OPTIONS] <OUTPUT> <PATTERN>
<OUTPUT>
Output glTF file
<PATTERN>
A glob pattern matching files to be included in the generated glTF document. Use #
to match a frame number. Use '{' and '}' to select parts of the pattern to be used to name meshes in the output glTF.
Run gltfgen -h
for more options and gltfgen --help
for full details.
The following example assumes that there is a sequence of meshes located at
./meshes/animation_#.vtk
where #
represents the frame number.
To generate an animated binary glTF file named output.glb
in the current directory, run:
> gltfgen output.glb "./meshes/animation_#.vtk"
This will assume 24 frames per second (FPS). You can specify FPS manually with the -f
option as
follows:
> gltfgen -f 100 output.glb "./meshes/animation_#.vtk"
Alternatively, to specify a time step like 0.01 seconds between frames, use the -t
option:
> gltfgen -t 0.01 output.glb "./meshes/animation_#.vtk"
-s
flag to reduce file size and improve performance.Please see CHANGELOG.md for updates.
This repository is licensed under the Mozilla Public License, v. 2.0.
See CONTRIBUTING.md for details.