Blendergltf插件技术文档

Blendergltf插件技术文档

---

安装指南

下载插件

前往GitHub下载Blendergltf插件的不同版本ZIP文件：

• 稳定版: 点击下载
• 测试版: 点击下载
• 发布版本: 访问发布页面

在Blender中安装

1. 启动Blender，点击文件 > 用户偏好设置...。
2. 切换到插件标签页。
3. 点击底部的“从文件安装...”按钮，浏览并选择你下载的ZIP文件进行安装。
4. 展开“支持级别”筛选器，确保选择了“社区”。
5. 在搜索框中输入“gltf”，快速定位到插件。
6. 对应“Import-Export: glTF format”插件行打勾以激活它。
7. 最后，点击“保存用户设置”以保留更改。

使用说明

1. 打开你想导出为glTF格式的场景。
2. 转到文件 > 导出 > glTF (.gltf)。
3. 出现导出选项和保存文件对话框。设定导出路径和需要的选项。

项目API使用文档

本插件作为Blender的添加剂使用，并不直接提供API调用接口。但您可以利用Blender的脚本环境来间接控制插件行为，通过编写Python脚本来设置导出参数和执行导出操作。例如：

import bpy
# 假设我们已将插件激活
bpy.ops.export_scene.gltf(
    export_format='GLTF_EMBEDDED',  # 或'GLTF_SEPARATE'
    path_mode='COPY',
    apply_modifiers=True,
    export_selected=False,  # 根据需求调整
    ...
)

请注意，上述代码片段是示意性质的，具体API使用细节需要根据实际版本的Blender和插件文档调整。

API与特性

设置详解

• 轴转换: 上轴与前轴的选择，影响坐标系统的映射。
• 节点: 控制隐藏对象、仅导入选中的对象等。
• 网格(Meshes): 应用修改器、数据交织、是否导出顶点颜色等。
• 材质(Materials): 是否禁用材料导出、嵌入着色器数据。
• 动画_Animations: 控制骨骼动画、对象动画、形状键动作的导出策略。
• 图像_Images: 图像存储方式（内嵌、引用或复制），sRGB纹理支持等。
• 缓冲_Buffers: 缓冲数据是否内嵌、是否合并成单个缓冲。
• 扩展_Extensions: 如物理、灯光、材料等特定功能的支持。

注意事项

• Blendergltf版本1.2.0起不再支持glTF 1.0，后续版本可能完全移除该支持。
• 报告遇到的问题对插件改进至关重要，鼓励用户积极参与反馈。

此文档基于给定Readme内容编制，旨在帮助用户了解和使用Blendergltf插件，进行高效glTF格式导出。