Renderização e entrega
Execute pnpm mg check <cliente>/<projeto> primeiro; renderize apenas quando não houver problemas relatados.
Renderizar
pnpm mg render <cliente>/<projeto> todas as cenas
pnpm mg render <cliente>/<projeto> lt-ceo uma cena
pnpm mg render <cliente>/<projeto> --force re-renderizar mesmo se inalterado
Saída: renders/<cena>_v<NNN>.<ext>. Cada renderização que alterar pixels recebe a próxima versão; versões anteriores permanecem. renders/manifest.json registra o hash de tudo que afeta pixels (props, tokens resolvidos, conteúdo de fontes/logotipos/ativos, preset, versão do toolkit, código do modelo do cliente). Cenas inalteradas são puladas.
Presets
| Preset | Arquivo | Uso |
|---|---|---|
overlay (padrão) | ProRes 4444 .mov com alpha | Terços inferiores, títulos sobre footage no Resolve/Premiere/FCP |
delivery | H.264 .mp4, áreas transparentes em preto | Links de revisão, gráficos em tela cheia |
webm-alpha | VP9 .webm com alpha | Players web; a maioria dos editores ignora alpha WebM |
Defina por cena ("preset"), por projeto (project.json) ou por execução (--preset).
Entregar
Quando o usuário entregar o projeto (ou disser que os gráficos estão finais):
pnpm mg deliver <cliente>/<projeto> [cena…]
Isso renderiza o que mudou, verifica cada arquivo (alpha para overlay/webm-alpha, tamanho do quadro, fps), congela o projeto e copia os finais para deliver/<AAAA-MM-DD>/<cena>.<ext>. Se a verificação falhar, nada é congelado ou copiado; corrija o problema relatado e execute novamente. Informe ao usuário o caminho da pasta deliver/.
Congelado significa: edições futuras de casa, cliente ou variante não alteram os renders deste projeto.
Aplicar alterações de marca
Após o usuário alterar tokens de cliente ou variante (novas cores, fontes, logotipos):
- Visualizar:
pnpm mg rebrand <cliente>(ou<cliente>/<projeto>para um projeto). Não altera nada e lista, por projeto, o que a marca atual mudaria. Projetos com"extends": "none"são pulados. - Mostre a lista ao usuário e pergunte quais atualizar: todos, alguns projetos ou nenhum (apenas trabalho novo).
- Aplique o que escolheram:
pnpm mg rebrand <cliente> --applyoupnpm mg rebrand <cliente>/<projeto> --applypor projeto. Projetos congelados são relocados para a marca atual; cada projeto listado é re-renderizado em uma nova versão. Versões antigas permanecem emrenders/. - Execute
motion-qanos novos renders. Para projetos que o usuário entregar novamente, executepnpm mg deliverpara atualizardeliver/.
Não executar rebrand também é uma resposta válida: projetos congelados mantêm sua aparência entregue, e apenas projetos não congelados seguem a marca em sua próxima renderização.
Outros comandos de marca:
pnpm mg diff <cliente>/<projeto>: diferenças de um projeto em relação ao seu bloqueio (congelado) ou última renderização (não congelado).- Uma renderização de um projeto não congelado cuja marca mudou desde sua última renderização exibe um aviso com as alterações.
- Edições de tokens apenas no projeto em um projeto congelado: edite
tokens.json, depoispnpm mg rebrand <cliente>/<projeto> --apply.
Falhas
- Erros que nomeiam uma prop, token, fonte ou largura de texto vêm da validação; corrija o JSON, não o modelo.
pnpm mg checklista todos de uma vez. - Inicialização do navegador, bibliotecas ausentes, codec ou erros de caminho:
pnpm mg doctor.