闪电君主:CG与实拍合成工作流 是做什么的?
一套用于在实拍演员身后或周围放置CG的工作流和工具。这些工具以三种形式存在,均运行相同代码:
MCP服务器(lightning-emperor-mcp)、CLI(lightning-emperor ...)和Blender插件。当MCP工具可用时优先使用;否则使用CLI。本文档是判断依据:应该测量什么、什么地方可能出错、如何检查自己的工作。
预防代价高昂错误的规则
- 在决定任何事情之前先测量实拍画面。 镜头、传感器、曝光、白平衡、屏幕颜色和强度、噪点、光线来源。十秒钟的测量胜过一小时的猜测。
- 首先通过两种方式获得绝对比例尺。 CG相对于演员的比例尺直接取决于相机到主体的距离。通过已知物体的像素大小(头部从头顶到下巴约0.24米)和镜头文件中的对焦距离分别测量距离。如果两者不一致,停下来解决。测量错误的距离会使整个CG场景在每一帧中大小都出错。永远不要添加修正因子来隐藏比例尺错误。
- 从演员身上找到主光,而不是从简介或场景照片中。 在线性光下比较脸部的两侧。场景照片显示有哪些灯具存在;实拍画面显示哪个占主导。
- 在线性光下合成,并说明实拍画面的色彩空间。 显示参考视频:线性化,混合,重新编码。不要因为图像看起来很平就假设是对数色彩空间。
- 以全尺寸和裁剪方式查看图像。 缩略图会隐藏溢出、空洞和边缘。在信任遮罩之前,始终打开工具写入的预览。
- 修复可能比错误更糟。 每次修复后,重新查看整个画面,并重新测量你本应保护的内容。
- 你不能观看视频。 用数字(步长、抖动)测量运动,并清楚说明哪些只能由用户的眼睛判断。
- 永远不要覆盖原始文件。 在长时间渲染前检查输入大小/持续时间;保持源文件不变。
- 对局限坦诚相告。 当用户说某处看起来不对时,他们几乎总是对的:调查,报告数值,说明你哪里做错了。
工作流
0. 素材导入。 探测每个文件。如果格式允许,读取相机元数据(read_camera_metadata / lightning-emperor metadata):焦距(是否变焦?)、对焦距离、ISO、白平衡。只询问那些会影响工作的问题:CG相对于演员的位置、相机高度、交付格式。
1. 相机。 从实拍画面中的已知尺寸和镜头对焦距离计算相机距离(solve_camera_distance),要求一致性为真(agree: true)。然后规划相机(plan_camera)(姿态、过扫描尺寸、每米像素数)。使用过扫描渲染(约1.25倍),这样跟踪的运动永远不会暴露渲染边缘。
2. 光照。 从脸部确定主光源侧。plan_lights 提供起始位置和颜色(方位角0度=从相机方向,+90度=相机右侧,色温值)。通过实拍画面上的测量值(皮肤区域、背景)校准CG曝光,而不是凭眼睛判断。闪烁的实用灯:practical_states 给出需要渲染的帧(开/关)。
3. 抠像。 执行 key_frame 并打开 preview_on_grey.png。抠像会自动校准到屏幕,但请阅读 references/keying.md 了解要检查的内容(深色衣物中的空洞、溢色偏色、留下的孤立点)。
4. 跟踪(仅当相机移动且背景被替换时)。track_markers 使用每帧单应矩阵跟踪标记点星座。阅读 references/tracking.md:标记点少的帧噪声大,平坦背景是一个平面(单应矩阵是正确模型),没有可见标记点意味着正在保持或插值。
5. 阴影。 shadow_offset 根据光照几何和演员到墙壁的间隙计算演员阴影落在背景上的位置。参见 references/shadows-and-grain.md。
6. 颗粒。 从平坦屏幕区域测量颗粒(measure_grain);将其应用到CG上,使其看起来不像粘贴上去的。在最终分辨率下测量。
7. 合成。 首先在单帧上执行 composite_frame。检查墙壁尺寸与演员的比例、阴影侧、边缘、黑电平,然后放大。将长时间运行的渲染任务分块进行,并验证帧数。
8. 交付。 当跟踪在某个时间段内不可靠时,向艺术家提供分层渲染结果和诚实的逐帧质量标记,而不是一个假装完成的合成。
工具映射表
| 需求 | MCP工具 | CLI | 插件 |
|---|---|---|---|
| 从相机文件获取镜头/曝光 | read_camera_metadata | metadata | 画面面板 |
| 将导出素材与相机文件对齐 | align_clip | align | |
| 主体距离 | solve_camera_distance | distance | 主体 + 相机 |
| 相机姿态、渲染尺寸 | plan_camera, build_shot_scene | 创建镜头相机 | |
| 灯光布局 | plan_lights | 灯光 | |
| 实用灯亮/灭帧 | practical_states | 闪烁 | |
| 渲染CG各状态 | render_states | 渲染CG | |
| 遮罩 + 去溢色 | key_frame | key | 画面工具 |
| 标记点跟踪 | track_markers | track | 画面工具 |
| 阴影偏移 | shadow_offset | shadow-offset | |
| 颗粒 | measure_grain | grain | 画面工具 |
| 单帧合成 | composite_frame | comp |
工具错误返回格式为 {"error": "..."} 及原因;修正输入后重试。
Blender以无头作业方式运行。切勿尝试打开一个在正在运行的Blender窗口中执行代码的套接字。
参考资料(在适用的阶段阅读)
references/failure-modes.md- 什么地方会出错、原因及修复方法。先快速浏览。references/scale-and-distance.md- 相机距离错误及其防范规则。references/lighting.md- 找到真实主光、构建和校准灯光布局。references/compositing.md- 遮罩、四种溢色、基准电平、柔化度、光晕、检查项。references/camera-metadata.md- 相机文件告诉你的信息,以及如何将导出素材与它们对齐。references/review.md- 如何在不自欺的情况下使用评论代理。references/keying.md- 遮罩、去溢色、边缘处理以及从真实素材中获得的经验。references/tracking.md- 标记点跟踪、稳定化、间隙处理。references/shadows-and-grain.md- 阴影几何、颗粒测量与匹配。references/blender-notes.md- Blender 4.2-5.x 用于无头工作的脚本编写笔记。