gltf

这个crate旨在加载glTF 2.0，这是一种用于高效传输3D资源的数据格式。

需要 Rustc 版本 1.61 或以上。

参考信息图

来自 javagl/gltfOverview

PDF版本

用法

有关示例用法，请参阅crate 文档。

特性

额外和名称

默认情况下，gltf 会忽略glTF资产中包含的所有 extras 和 names。您可以通过分别启用 extras 和 names 特性来否定这一点。

[dependencies.gltf]
version = "1.4"
features = ["extras", "names"]

glTF 扩展

该crate支持以下glTF扩展

• 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

要使用扩展，请在 features 部分列出其名称。

[dependencies.gltf]
features = ["KHR_materials_unlit"]

示例

gltf-display

演示了如何反序列化 glTF JSON。

cargo run --example gltf-display path/to/asset.gltf

gltf-export

演示了如何使用 gltf-json crate 构建并导出 glTF JSON。

cargo run --example gltf-export

gltf-roundtrip

反序列化和序列化 glTF 资产的 JSON 部分。

cargo run --example gltf-roundtrip path/to/asset.gltf

gltf-tree

可视化 glTF 资产的场景层次结构，它是一个严格的节点树。

cargo run --example gltf-tree path/to/asset.gltf

测试

在本地运行测试需要首先克隆 glTF-Sample-Models 仓库。

git clone https://github.com/KhronosGroup/glTF-Sample-Models.git