jeremyhan520/promo-film-looks

Looks de filme promocional: 苹果风格 e 华章版

Dois modelos de estilo prontos para filmes promocionais institucionais. Comece a partir de um motor funcional em vez de um projeto Remotion em branco.

• 苹果风格 (glass): Vidro fosco estilo Apple. Fundos branco / céu / azul por cena, acentos amarelos, títulos em 优设标题黑, molduras de fotos arredondadas sem moldura e gráficos de dados ao vivo atrás do vidro. Leia references/glass.md.
• 华章版 (aurum, Aurum Nocturne): fundo laca meia-noite, tipo champanhe e títulos em folha de ouro. Adiciona molduras de fotos com borda dourada, vazamentos de luz e alguns reflexos de lente. Leia references/aurum.md.

Uma base de código renderiza ambos. O look é uma propriedade de entrada (--props=glass.json ou --props=aurum.json), então a mesma linha do tempo e cenas podem ser enviadas como duas edições.

Escolhendo o look

O padrão é 苹果风格: claro, limpo e internacional, e é mais adequado para filmes de admissão e recrutamento. 华章版 é mais escuro e mais cerimonial. Ofereça-o para aniversários, galas, prêmios e filmes de marca premium, ou quando o usuário pedir 华丽 / 黑金 / luxury. Mostre alguns stills antes de renderizar um filme inteiro com ele.

Se a paleta da marca não for azul, mantenha o motor de vidro e recolorir os tokens (glassVars em looks.tsx, GLASS em theme.ts). Não crie um novo look do zero.

Iniciar um novo filme

python <skill-dir>/scripts/scaffold.py <new-project-dir>

Em seguida, no projeto:

npm install
npx tsc --noEmit -p .
PROPS=glass.json bash qa.sh demo 30 150 268 320 460 520

A linha do tempo de demonstração (src/scenes/Demo.tsx) tem uma cena por componente de assinatura. Renderize seus stills em ambos os looks antes de alterar qualquer coisa, para confirmar que as fontes e o navegador funcionam nesta máquina.

Notas de configuração:

• Fontes não são redistribuídas com a skill. assets/fonts/README.md lista cada arquivo, sua origem e sua licença. O scaffold copia o que estiver em assets/fonts/; fontes ausentes têm fallback sem quebrar a renderização.
• Navegador: remotion.config.ts aponta para o Edge local quando existe, porque o Chrome Headless Shell pode não baixar em algumas redes.
• Shell: os scripts são bash, e PROPS=… bash qa.sh é sintaxe bash. No Windows, execute-os no Git Bash. Do PowerShell, chame o Git Bash explicitamente, por exemplo & "C:\Program Files\Git\bin\bash.exe" -c "PROPS=glass.json bash qa.sh demo 30 150", porque um bash simples lá pode iniciar o WSL.

O que o modelo contém:

Arquivo	Função	Editar por filme?
src/config.ts	duração, SHOTS (tom por cena, lado do título, chips), CHAPTERS (motivo, palavra fantasma), FORMULAS, BRAND	sim
src/scenes/*.tsx	o filme: um arquivo por capítulo, construído a partir de componentes do kit	sim
src/kit.tsx	Scene, Ground, Night, Card, Print, DocPage, Caption, Rise, En, Rule, Heading, ChapterCard, useCount, StatHit, MaskTitle, CardRail, FeatureCard	raramente
src/looks.tsx	fundos, transições, molduras de fotos e luz para ambos os looks	raramente
src/glassfx.tsx	camadas de detalhe do vidro: motivos, discos, chips, palavras fantasmas, bokeh, cometa de borda	raramente
src/theme.ts	tokens C, fontes F, FOIL, easings EZ, r(), mix()	raramente
src/Film.tsx	linha do tempo mestre, GLASS_CSS, conexão de VO / SFX	sim (conexão)

As cenas devem permanecer independentes do look. Cor apenas através de tokens C.*, tipo apenas através de F.*, fotos através de Print, painéis através de Card ou C.card / C.fill. Nunca codifique uma cor hexadecimal em uma cena: a mesma cena precisa renderizar branco-sobre-azul, tinta-sobre-branco e ouro-sobre-meia-noite.

Fluxo de trabalho

1. Tempo a partir da narração.
   • Alinhe a narração (por exemplo, timestamps de palavras do Whisper) e anote os tempos dos chunks.
   • Cada Scene fica em segundos absolutos da narração. Cenas vizinhas se sobrepõem em cerca de 0,35 s.
   • Os tempos dos elementos (t0, at) também são segundos absolutos: o momento em que o narrador diz a coisa. O texto chegando na palavra falada é o que faz o filme parecer editado em vez de animado.
2. Tabela de cenas. Adicione uma linha SHOTS por cena em config.ts.
   • Alterne os tons para que cenas vizinhas difiram.
   • Coloque o título (head) no lado que o conteúdo deixa vazio.
   • Marque cenas full-bleed ou com modo de mesclagem como flat.
3. Construa cenas a partir de componentes do kit. Padrões que já funcionam estão nas referências, por exemplo:
   • um trilho de cartões quase tela cheia para figuras densas
   • um número de destaque que aparece inteiro
   • a abertura com texto como máscara
4. QA de stills (qa.sh) no momento mais movimentado de cada cena, em cada look que você for enviar. Olhe para eles você mesmo. Veja a lista de verificação em references/pipeline.md.
5. Masterização com master.sh: −16 LUFS, h264 crf 17, AAC 320k. Em seguida, relate os números do verify.sh.
6. Correções após entrega. Re-renderize apenas o trecho alterado com segment.sh. Ele extrai o áudio do master para que o volume corresponda e verifica se ambos os quadros de emenda são iguais ao master.

Princípios de design

Estes são os que fazem os dois looks se sustentarem. Cada um é seguido pela razão, porque as razões importam mais do que as regras.

• Deixe espaço para legendas e música. Entregue narração mais SFX, sem legendas embutidas e sem música de fundo (BGM), a menos que solicitado. Instituições geralmente adicionam legendas e música unificadas posteriormente, então a faixa inferior (cerca de y > 950) permanece livre de conteúdo importante.
• Mantenha o topo do quadro limpo. Cabeçalhos decorativos em inglês, kickers de capítulo e linhas de HUD são interpretados como poluição visual para um público chinês. No vidro, o kicker já está desligado e BRAND fica vazio por padrão. Linhas de acompanhamento em inglês sob os títulos são aceitáveis.
• Evite a aparência de apresentação de slides. Um layout fosco simples parece um PowerPoint. Cada cena de vidro carrega camadas lentas atrás do conteúdo: o motivo, discos, palavra fantasma e bokeh frontal, além da lenta rotação 3-D do plano de conteúdo. Cenas vizinhas alternam fundos. Não remova essas camadas para "limpar".
• A decoração não deve ser lida como conteúdo. Chips de fórmula são pura notação sem números, cerca de 60% de opacidade e sem sombra. Um chip como "R² = 0,98" é lido como uma afirmação sobre a instituição.
• Legível supera elegante. Quando um cartão contém uma figura densa (diagramas de pesquisa, resultados), dê a ele quase todo o quadro (CardRail). Cartões pequenos em uma fileira são ilegíveis.
• Números de destaque aparecem inteiros. Uma contagem longa de 0 a 100% parece uma barra de carregamento. Use StatHit para números de destaque e useCount apenas para números comuns.
• Pessoas e documentos:
  • Nunca corte uma cabeça. Verifique cada corte de retrato em um still e defina focus em Print para corrigi-lo.
  • Nunca repita uma foto dentro de um filme.
  • Certificados e páginas de periódicos devem ficar perfeitamente retos (DocPage não tem inclinação), dimensionados para a proporção real da página.
• Ícones devem ser literais. Prefira um objeto reconhecível, como um carro visto de frente para transporte, a um glifo abstrato.
• O conteúdo da instituição são dados. Pessoas, fotos, nomes e números são usados exatamente como fornecidos, nunca inventados. Quando uma foto de origem precisar de ajustes (fundo, cor), iguale-a às vizinhas e mostre um still antes de renderizar.

Relatório

Relate o que você verificou, com números: contagem de quadros, decodificação, duração, LUFS, pico e quais stills você analisou. Diga claramente o que você não fez, como "não assistido na íntegra" ou "áudio não ouvido". Nomeie os entregáveis <机构>宣传片_<版本>_无字幕无BGM_1080p25.mp4. Coloque os segmentos de substituição em uma pasta <版本>_替换片段/, nomeados com o timecode de início (detalhes em references/pipeline.md).

Referências

• references/glass.md: a especificação completa do 苹果风格. Abrange tokens, looks por cena, superfícies foscas, transições, camadas de detalhe, movimentos de assinatura e armadilhas.
• references/aurum.md: a especificação completa do 华章版. Abrange as camadas de palco, tipo folha de ouro, molduras, vazamentos de luz, reflexos e armadilhas de contraste.
• references/pipeline.md: tempo da narração, tabela de cues de SFX, lista de verificação de QA, masterização, verificação, segmentos de substituição, emenda e nomenclatura de entrega.