SuperAPI AI 工具集

blender-render

设计与创作

查看项目

更新于 10-15 20:34

技能介绍

用途:用于 Blender 场景的渲染与输出,覆盖静帧、动画后台作业、视口截图以及多视角渲染。

主要能力:短静帧可用 render_scene;动画、多层 EXR 或显示用 PNG 可用 start_render_job 启动后台作业,并用 get_render_job 轮询,取消需通过返回的 job id。start_multiview_render_job 支持最多 8 个相机的有界列表,产出 beauty/wire PNG,并在不修改当前场景文件名、选择、材质或设置的情况下保存隔离副本。

用法:后台渲染作业的 device 默认为 null,不传 --cycles-device,使用 .blend 中保存的 Cycles 设备(新场景为 CPU)。仅在明确指定设备时传入 OPTIX、CUDA、HIP、ONEAPI、METAL、CPU 之一;OPTIX 需要 NVIDIA GPU,且仅支持 Windows 与 Linux。失败时 get_render_job 会附上 worker 的 stderr_tail 与 stdout_tail。

输出配置:可用 get/set_view_layer_passes 管理 AOV 开关,set_render_denoise 配置 Cycles 降噪,get/set_render_output 设置路径、格式、色彩模式/位深、EXR 编码与多层模式,set_render_region 与 clear_render_region 控制边界渲染。未指定 scene_name 或 view_layer_name 时,这些工具作用于 bpy.context.view_layer。

限制:降噪设置仅适用于 Cycles,EEVEE 忽略。多层 EXR 会切换为 OPEN_EXR_MULTILAYER 并清除 render.use_single_layer;use_single_layer 本身无法生成多层文件。多视角 wire 使用 Cycles CPU,显示原网格边,禁用修改器与形态键,隐藏渲染对象保持隐藏;超过 max_source_edges 预算(默认 100,000,最大 500,000)会被拒绝。多视角取消采用协作方式,无法中断进行中的渲染。外部资源需保持可访问,插件生成的渲染依赖不会加载。部分细节暂未提供。