渲染与交付
运行 pnpm mg check <client>/<project> 作为第一步;只有当它报告无问题时才进行渲染。
渲染
pnpm mg render <client>/<project> 所有镜头
pnpm mg render <client>/<project> lt-ceo 单个镜头
pnpm mg render <client>/<project> --force 即使未更改也重新渲染
输出:renders/<shot>_v<NNN>.<ext>。每次像素发生变化的渲染都会获得下一个版本号;旧版本会保留。renders/manifest.json 记录了所有影响像素的因素的哈希值(属性、解析后的令牌、字体/Logo/资源内容、预设、工具箱版本、客户端模板代码)。未更改的镜头会被跳过。
预设
| 预设 | 文件 | 用途 |
|---|---|---|
overlay(默认) | 带Alpha通道的ProRes 4444 .mov | 在Resolve/Premiere/FCP中覆盖在素材上的下三分之一和标题 |
delivery | H.264 .mp4,透明区域为黑色 | 审阅链接、全帧图形 |
webm-alpha | 带Alpha通道的VP9 .webm | Web播放器;大多数编辑器忽略WebM的Alpha通道 |
通过每个镜头设置 ("preset")、每个项目设置 (project.json) 或每次运行设置 (--preset) 来指定。
交付
当用户完成项目交接(或确认图形为最终版)时:
pnpm mg deliver <client>/<project> [shot…]
它会渲染已更改的内容,验证每个文件(overlay/webm-alpha预设的Alpha通道、帧大小、帧率),冻结项目,并将最终文件复制到 deliver/<YYYY-MM-DD>/<shot>.<ext>。如果验证失败,不会冻结或复制任何内容;修复报告的问题后重新运行。告知用户 deliver/ 文件夹的路径。
冻结意味着:后续的室内修改、客户修改或变体编辑不会更改此项目的渲染结果。
应用品牌变更
在用户更改客户或变体令牌(新颜色、字体、Logo)之后:
- 预览:
pnpm mg rebrand <client>(或pnpm mg rebrand <client>/<project>用于单个项目)。它不会更改任何内容,而是按项目列出当前品牌将更改的内容。设置"extends": "none"的项目会被跳过。 - 向用户展示列表,并询问要更新哪些:全部、部分项目,或都不改(仅新项目使用新品牌)。
- 应用用户选择的更改:
pnpm mg rebrand <client> --apply或针对单个项目的pnpm mg rebrand <client>/<project> --apply。冻结的项目会重新锁定到当前品牌;每个列出的项目都会重新渲染为新版本。旧版本保留在renders/中。 - 对新渲染结果运行
motion-qa。对于需要再次交付的项目,运行pnpm mg deliver以刷新deliver/。
不运行重新品牌化也是一个有效的选项:冻结的项目保持其已交付的外观,只有未冻结的项目在下次渲染时遵循品牌。
其他品牌命令:
pnpm mg diff <client>/<project>:显示单个项目与其锁定版本(冻结)或上次渲染(未冻结)之间的差异。- 如果未冻结项目自上次渲染以来品牌已更改,其渲染过程会打印警告并列出更改内容。
- 对冻结项目仅编辑项目级令牌:编辑
tokens.json,然后运行pnpm mg rebrand <client>/<project> --apply。
故障处理
- 错误信息中提及属性、令牌、字体或文本宽度的错误来自验证;请修正 JSON,而不是模板。
pnpm mg check会一次性列出所有此类问题。 - 浏览器启动、缺少库、编解码器或路径错误:运行
pnpm mg doctor。