From javagl/gltfOverview
### Usage See the [crate documentation](https://docs.rs/gltf) for example usage. ### Features #### Extras and names By default, `gltf` ignores all `extras` and `names` included with glTF assets. You can negate this by enabling the `extras` and `names` features, respectively. ```toml [dependencies.gltf] version = "1.4" features = ["extras", "names"] ``` #### glTF extensions The following glTF extensions are supported by the crate: - `KHR_lights_punctual` - `KHR_materials_pbrSpecularGlossiness` - `KHR_materials_unlit` - `KHR_texture_transform` - `KHR_materials_variants` - `KHR_materials_volume` - `KHR_materials_specular` - `KHR_materials_transmission` - `KHR_materials_ior` - `KHR_materials_emissive_strength ` To use an extension, list its name in the `features` section. ```toml [dependencies.gltf] features = ["KHR_materials_unlit"] ``` ### Examples #### gltf-display Demonstrates how the glTF JSON is deserialized. ```sh cargo run --example gltf-display path/to/asset.gltf ``` #### gltf-export Demonstrates how glTF JSON can be built and exported using the `gltf-json` crate. ```sh cargo run --example gltf-export ``` #### gltf-roundtrip Deserializes and serializes the JSON part of a glTF asset. ```sh cargo run --example gltf-roundtrip path/to/asset.gltf ``` #### gltf-tree Visualises the scene heirarchy of a glTF asset, which is a strict tree of nodes. ```sh cargo run --example gltf-tree path/to/asset.gltf ``` ### Tests Running tests locally requires to clone the [`glTF-Sample-Models`](https://github.com/KhronosGroup/glTF-Sample-Models) repository first. ```sh git clone https://github.com/KhronosGroup/glTF-Sample-Models.git ```