SuperAPI AI 工具集

blendertorcp-cli

设计与创作

查看项目

更新于 10-16 06:15

技能介绍

用途:从终端控制 BlenderToRCP 插件,导出 Blender 场景为 USDA/USDC/USDZ,为 RealityKit 烘焙纹理,并校验材质兼容性。

主要能力:

  • 场景检查:blendertorcp info <file.blend>、list-objects(可按 --type MESH、--type LIGHT、--selected 过滤)、list-materials(支持 --unused)。
  • 材质校验:blendertorcp validate <file.blend>,可加 --material "名称" --strict、--only-errors。退出码 0 表示通过,1 表示有错误。
  • 场景导出:blendertorcp export <file.blend> -o out.usdz --format USDZ,支持 --selected-only、--diagnostics、--no-diagnostics,并可在可选标志前传 key=value 覆盖导出设置。
  • 烘焙并导出:blendertorcp bake-export <file.blend> -o out.usdz,默认新场景为 Lighting & Shadows(LIT_IBL)。烘焙模式有 UNLIT_ALBEDO、LIT_ALBEDO、LIT_IBL。常用标志:--resolution(默认 2048)、--image-format(默认 AVIF,AVIF 依赖外部 avifenc,不可用回退 PNG)、--margin(默认 8)、--ibl-source、--ibl-filepath、--ibl-strength、--ibl-rotation、--isolate-meshes、--no-base-color、--no-opacity、--keep-materials、--timeout。
  • 设置读写:settings get / set / list,可指定 --group、--keys、--save、--dry-run。
  • 其它:preferences get/set、version、support-bundle(可带 --job-dir 等选项,默认脱敏,除非加 --include-blend 或 --include-output)。全局标志:--blender、--json、--verbose、--quiet。

使用前提:需配置 blendertorcp 别名,或设置 BLENDERTORCP_BLENDER 环境变量并知晓插件路径。

适用场景:需要批量或自动化地将 Blender 资产导出用于 RealityKit/Apple 生态,或在无界面环境下烘焙、校验材质。

限制:bake-export 会跳过源材质图校验,需用 validate 或 export 检查 RealityKit 兼容性;缺失或未打包的外部图片会以 MISSING_EXTERNAL_TEXTURES 失败,需先打包或重新链接;ORIGINAL 纹理格式/分辨率仅对已有纹理暂存有意义,新烘焙输出会回退为 PNG/2048。退出码 0 成功,1 命令失败,2 Blender 未找到或启动失败,3 插件未安装或加载失败。资料未提供价格、平台支持范围等其它信息。