SuperAPI AI 工具集

rendering

设计与创作

查看项目

更新于 10-31 12:23

技能介绍

用途

该技能用于 Blender 项目的最终渲染设置,目标是选择合适的渲染引擎、优化采样与降噪、配置分辨率与色彩管理,并按需输出后续合成用的渲染通道。适用场景包括:最终作品集或影视级渲染、外观开发(Look Dev)验证、为合成输出渲染通道、游戏资产转台预览、现实与风格化风格验证,以及按参考图进行视觉匹配。

主要能力

引擎选择

  • Cycles:最终质量、写实、作品集渲染。
  • EEVEE(BLENDER_EEVEE):实时预览、风格化、游戏外观开发;Blender 4.2+/5.x 支持光线追踪反射与虚拟阴影贴图。
  • Workbench:快速粘土与质量检查渲染,用于轮廓与拓扑检查。

摄像机设置

  • 命名采用 CAM_[Shot]_[Number]。
  • 焦距参考:35mm(环境)、85mm(主体细节)、24mm(广角惊悚)。
  • 景深以主体距离对焦;构图采用三分法、引导线。
  • 转台:以空物体为父级旋转 360° 用于资产预览。

Cycles 参数参考

  • 采样:预览 64–128,生产 512–2048。
  • 降噪:OpenImageDenoise。
  • 最大反弹:预览 8,生产 12。
  • 焦散:默认关闭;玻璃或水为主体时开启。

EEVEE 参数参考

  • 光线追踪(eevee.use_raytracing):金属或光泽地面时开启。
  • Fast GI(eevee.use_fast_gi):用于接触遮蔽,取代旧的 AO 开关。
  • Bloom:使用合成器 Glare 节点,类型为 Bloom(4.2 已移除 EEVEE 的 Bloom 开关)。
  • 阴影(eevee.use_shadows):开启;降低灯光 shadow_maximum_resolution(如 0.001)以获得清晰主体阴影,用 shadow_filter_radius 控制柔和度。
  • 灯光阈值与采样:最终渲染 taa_render_samples 设为 64 及以上。

渲染通道

可输出 Combined(最终合成)、Diffuse Direct/Indirect(重打光)、Glossy(反射控制)、Normal(合成特效)、AO(接触阴影增强)、Z 深度(合成中的景深与雾)、Cryptomatte(对象遮罩)、Emission(屏幕辉光)等通道。

色彩管理

  • 视图变换:AgX(默认)、Khronos PBR Neutral(产品准确性)、Standard(风格化或像素精确)。
  • Look:AgX - Base Contrast(中性)、AgX - High Contrast / AgX - Punchy(戏剧化)。
  • 曝光建议在合成器中调整,而不是靠过曝灯光。

渲染优化

使用渲染区域做测试裁切、Cycles 自适应采样、在渲染层禁用不可见对象、可用时默认 GPU 渲染、动画序列使用持久数据。

资产转台模板

  1. CAM_Turntable 位于 3/4 高度、45° 角。
  2. 空物体置于资产原点,旋转动画 0–360°(120 帧)。
  3. 三点布光。
  4. 渲染 1280×1280 或项目指定分辨率。
  5. 输出 PNG 序列或 MP4。

使用方式

脚本在 Blender 5.2 LTS 上通过官方 Blender MCP 测试。使用 execute_blender_code 运行(或参考 blender-mcp-workflow 技能以无头方式运行),使用前阅读脚本头部的全部参数说明。若由用户自行在 Blender 中粘贴代码,应提供指向已安装脚本绝对路径的简短 runpy 调用及对应 ARGS,不要内联或改写脚本,因为经过测试的文件才是关键。

scripts/render_preset.py 的作用是应用渲染预设(引擎、采样、降噪、分辨率、色彩管理),并返回此前的数值以便回退。调用示例:

import runpy result = runpy.run_path("<skill_dir>/scripts/render_preset.py", init_globals={"ARGS": {...}})["result"]

ARGS 包含:preset、resolution_percentage、device。

MCP 集成方面,可通过 MCP 配置渲染引擎设置、设置摄像机、触发测试渲染(如支持)、查询渲染设置验证、设置输出路径。

参考图匹配

当需要匹配照片或概念图时:主体摄像机先匹配参考角度再调色;AgX Look 默认 Base Contrast,参考图对比强则用 High Contrast;曝光常用 0.15–0.45,保证船体等主体可读而不死白;预览播放用 EEVEE、关闭运动模糊、taa_samples 1–8;最终静帧在主体 CAM_* 上渲染并与参考图对比;对比工具可用 get_screenshot_of_area_as_image("VIEW_3D") 或 bpy 渲染静帧。交付前运行 blender-mcp-workflow 技能中的 references/visual-match-checklist.md 检查。

约束

必须:渲染引擎匹配项目风格;提供参考图时做截图或渲染对比;Cycles 生产渲染使用降噪;最终渲染前设置色彩管理;主体资产渲染验证转台;摄像机归入 COL_Cameras。 禁止:为 Blender 5.2 之前的版本编写代码或添加版本回退(本插件面向 5.2+,旧分支会教授已不存在的 API);未经采样测试直接生产渲染;忽略色彩管理(sRGB 与 Linear);无目的地渲染过高分辨率;计划合成却跳过渲染通道;在需要实时游戏预览时使用 Cycles。

限制

该技能针对 Blender 5.2+,不提供旧版本兼容代码。资料未提供插件安装方式、收费信息或 Blender 以外平台的支持情况。