SuperAPI AI 工具集

blender-interchange

设计与创作

查看项目

更新于 10-15 20:34

技能介绍

用途:blender-interchange 是面向 Blender 场景交换的带类型导入/导出技能,适用于需要在 DCC、游戏与渲染管线之间搬运资产的工作流;当流程需要导入 FBX、OBJ、USD,或需要 GLTF/USD/Alembic 导出、批量导出时加载。

主要能力(工具):import_file 支持 FBX/OBJ 并自动识别格式;import_fbx 使用 Blender 自带 FBX 导入器;import_obj 使用 Blender 自带 OBJ 导入器;import_usd 导入 .usd/.usda/.usdc/.usdz,支持网格、材质、相机、灯光、贴图等带类型选项;export_gltf 导出 GLTF/GLB,面向游戏引擎与 Web;export_usd 导出 USD 用于管线交换;export_alembic 导出 Alembic,可选帧范围;batch_export 可带预设执行多次导出。

用法要点:选项使用当前宿主 Blender 的 RNA 名称;枚举标志以 JSON 数组表示,例如 {"object_types": ["MESH"], "bake_anim": false},标量枚举仍用字符串;适配器会把枚举标志转成原生集合,同时在导出回执与存储的预设中保留 JSON 数组。可复用导出设置优先用 blender-export-preset,镜头/分镜元数据优先用 blender-shot-export,只有在检查过这些带类型交换工具后才用 blender-scripting。

限制与行为:未知名称、无效值、未完成的操作符以及缺失输出文件都会返回失败;被请求的选项不会被丢弃,也不会用默认值重试。仅当不存在原生 OBJ 导出器且未请求任何选项时,才使用 OBJ 基础写出器。带类型的 USD 选项中,import_textures 映射到 import_textures_mode(IMPORT_PACK 或 IMPORT_NONE),import_subdiv 映射到宿主的 import_subdiv(4.5)或 import_subdivision(5.2)RNA 属性。GLTF/GLB 每个唯一法线与 UV 组合存一个顶点,导出资产报告的顶点数通常高于 Blender 中该网格的共享顶点数,属预期行为;export_gltf 不返回顶点/面/材质指标,可比对导出的资产(重新用 import_file 导入并以 get_mesh_info 查看,或用 validate_mesh、validate_export_readiness 等校验),不应仅凭顶点数差异判定导出失败。