bevy_mod_fbx

Bevy引擎的Autodesk Filmbox (*.fbx) 加载器。

特别感谢：感谢原始作者HeavyRain266开始此项目。《bevy_mod_fbx》现在由其他人维护。

功能

• 加载网格、纹理和材质属性
• 支持材质属性
  • 法线贴图
  • 遮挡贴图
  • 漫反射纹理
• 支持Maya PBR材质
• 支持场景树转换层次结构

计划中的功能

• 骨骼绑定导入
• bevy_animation 支持
• 可选的Lambert材质着色器支持
• 可选的Phong阴影模型支持
• 扩展兼容性
  • IndexToDirect
  • 处理基于文件的轴属性
  • 处理后置摄像头和光源
  • N-边形三角剖分

限制

• 仅支持FBX v7.4 & 7.5版本
• FBX不支持单个文件中的多个场景，请使用多个文件
• 没有计划加载ASCII格式，请将FBX导出为二进制v7.4/7.5
• 目前不支持复杂形状，请参阅#11

Cargo特性

profile

启用spans，结合bevy的bevy/trace特性，您可以生成可以打开的跟踪报告。这对于调试为什么您的资源加载速度如此慢非常有用。

maya_3dsmax_pbr

启用处理Maya的PBR材质扩展FBX（可能也适用于3DS max）。这是高度实验性的，并且仅针对单个模型进行了测试！如果您的模型的材质无法正确加载，请报告。

此材质加载器不适用于所有类型的纹理文件，纹理必须可以从CPU读取，并且每个组件（颜色通道）必须是正好8位（例如PNG）。

示例

• cube：加载简单的立方体并带有点光源
• scene_viewer：从/path/to/file.fbx加载任何FBX文件，默认为assets/cube.fbx

运行示例

# Regular dev build
cargo run --example <example_name>

# Faster asset loading
cargu run --example <example_name> --release --features bevy/dynamic

版本矩阵

贡献

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

许可

原始加载器和三角化代码（loader.rs 和 triangulate.rs）来自 YOSHIOKA Takuma 的 fbx_viewer。原始场景查看器代码（scene_viewer.rs）来自 Bevy 贡献者。[scene_viewer]。所有新增和修改均由 bevy_mod_fbx 贡献者完成（见 git 日志）。

代码版权归各自作者所有。

bevy_mod_fbx 中的所有代码均受以下任一许可证的许可：

• Apache License 2.0
• MIT License

根据您的选择。