在 Blender 中渲染图像或动画时如何选引擎…

当需要从 Blender 场景生成最终图像或动画（渲染静帧、动画、导出图片）时，按场景类型选择 Cycles/EEVEE 并配置采样、降噪、色彩管理与输出格式。

适用场景

解决思路

1. 按决策树选引擎：需要照片级真实、焦散、精确 SSS、大量玻璃时用 Cycles（路径追踪）；需要速度、风格化、动画迭代时用 EEVEE；否则默认回退 Cycles。静帧、建筑可视化、产品、主视觉用 Cycles；动画预览、动态图形、风格化用 EEVEE。
2. 若目标是匹配参考图而非做通用好看渲染，先链式加载 reference-look-calibration，由它负责色相/饱和度/明度、物体范围、辉光颜色及前后对比指标的测量，本技能在其校准目标内应用材质/灯光/渲染改动。
3. Cycles 生产预设：scene.render.engine='CYCLES'；scene.cycles.device='GPU'；samples=256；use_adaptive_sampling=True；adaptive_threshold=0.01；adaptive_min_samples=32；use_denoising=True；denoiser='OPENIMAGEDENOISE'（NVIDIA RTX 上改用 'OPTIX'）；max_bounces=12；transmission_bounces=12（玻璃多的场景调高）；resolution_x=1920、resolution_y=1080、resolution_percentage=100。
4. Cycles 草稿预设（快速迭代）：engine='CYCLES'；device='GPU'；samples=64；use_adaptive_sampling=True；adaptive_threshold=0.05；use_denoising=True；resolution_percentage=50。
5. EEVEE 预设：引擎名随版本变化——Blender ≤4.1 用 'BLENDER_EEVEE'，4.2 用 'BLENDER_EEVEE_NEXT'，≥5.0 用 'BLENDER_EEVEE'；先试新名，失败则回退。设置 taa_render_samples=64、taa_samples=16；use_gtao=True、gtao_distance=0.2；use_bloom=True；use_ssr=True；use_ssr_refraction=True（玻璃）；use_volumetric_lights=True；分辨率 1920x1080。注意 EEVEE 反射/折射是屏幕空间（无法反射屏幕外物体，需加 Reflection Plane / Cubemap 探针），间接光是烘焙的（需烘焙 Light Probes），且无精确焦散。
6. 色彩管理：scene.view_settings.view_transform='AgX'（Blender 4.x 默认，替代 Filmic），look='AgX - Medium High Contrast'；也可用 'Filmic' 或 'Standard'；exposure=0.0；gamma=1.0。规则：摄影级输出绝不用 'Standard'，它会爆掉高光，几乎总是用 AgX 或 Filmic。
7. 渲染单帧 PNG：先运行相机守卫 ensure_camera(scene)——若 scene.camera 非 None 直接返回其名，否则取第一个 type=='CAMERA' 的对象赋给 scene.camera，若没有相机则抛 RuntimeError('No camera in scene — add one before rendering')；然后设置 image_settings.file_format='PNG'、color_mode='RGBA'、color_depth='16'（便于后期合成）、filepath='/tmp/output_hero.png'，调用 bpy.ops.render.render(write_still=True)，最后用 Bash 执行 ls -la 确认文件存在并报告大小。
8. 渲染动画为 PNG 序列：同样先跑 ensure_camera 守卫；设置 frame_start=1、frame_end=240、fps=24；file_format='PNG'；filepath='/tmp/anim/frame_'（输出 frame_0001.png 等）；use_placeholder=True 和 use_overwrite=False 以在崩溃时保留部分成果；use_persistent_data=True 以在帧间复用网格数据加速；调用 bpy.ops.render.render(animation=True)。推荐做法：先渲染 PNG 序列，再用 ffmpeg 编码为 MP4：ffmpeg -framerate 24 -i frame_%04d.png -c:v libx264 -pix_fmt yuv420p -crf 18 anim.mp4。
9. 渲染过慢的性能调优：use_simplify=True、simplify_subdivision=1、simplify_subdivision_render=2；adaptive_threshold=0.05（更快但更依赖降噪）；max_bounces=8、diffuse_bounces=3、glossy_bounces=3（损失部分真实感）。
10. 一次性配置 GPU 计算设备：prefs=bpy.context.preferences.addons['cycles'].preferences；prefs.compute_device_type='OPTIX'（或 'CUDA'、AMD 用 'HIP'、Mac 用 'METAL'）；遍历 prefs.devices 设 device.use=True。这是 Blender 偏好设置，每台机器只需运行一次。
11. 按场景类型选采样数：户外直射阳光 64–128（多为直接光）；一般产品/人像 256（标准质量）；室内带反弹 512（间接光多、噪点多）；焦散、玻璃、复杂 SSS 1024–2048（最难收敛）。始终配合降噪——256 采样 + 降噪在视觉质量上约等于 4096 原始采样。
12. 常见问题排查：报 'Cannot render, no camera' 时用 ensure_camera() 守卫；渲染耗时数小时则降采样、开自适应、降反弹；Cycles 未用 GPU 则在偏好设置里配置计算设备；直接渲染 MP4 崩溃丢数据则改渲染 PNG 序列后编码；Standard 视图变换爆高光则改 AgX/Filmic；玻璃渲染发黑则把 transmission_bounces 提到 16+；EEVEE 缺反射则加 Reflection Plane / Cubemap 探针；动画帧间闪烁则用 persistent data 并考虑时域降噪；输出文件为空则先设 scene.render.filepath，静帧检查 write_still=True。
13. 需要详细引擎对比（Cycles vs EEVEE 功能矩阵）、按场景调光路反弹（焦散、植被、毛发）、合成器重打光用的 light groups、AOV/自定义渲染通道、分布式/农场渲染时，加载 references/overview.md。

适用边界 · 注意事项

• 需要照片级真实、焦散、精确次表面散射或大量玻璃时不要用 EEVEE（其反射/折射为屏幕空间、间接光为烘焙、无精确焦散）。
• 摄影级输出不要使用 'Standard' 视图变换，会爆掉高光。
• 场景中没有相机对象时无法渲染，必须先添加相机。