Estilo de referência (passo 05 do curso)
Sem referência, o modelo deriva para um visual padrão: texto centralizado sobre um gradiente com todos os elementos aparecendo gradualmente. Rexan Wong (@rexan_wong) analisou um lote de clipes virais e descobriu que nomear um estilo funciona melhor do que descrevê-lo, e que uma referência fornece ao modelo o ritmo, o tipo e as transições a copiar. Esta habilidade transforma uma referência em dois documentos aprovados antes de qualquer código de filme existir.
Argumentos da requisição (podem estar vazios), mostrados uma vez:
A escada da referência
| Degrau | O que o usuário fornece | O que você extrai | Ferramenta |
|---|---|---|---|
| Um frame | uma imagem estática de um vídeo que ele ama | paleta, tipo, textura, densidade de composição | refs.mjs analyze refs/<pasta> + olhe para ele |
| Um vídeo | um arquivo local de um filme que ele admira | o acima mais tempos de corte, duração dos planos, energia de movimento por segundo, transições | refs.mjs extract + analyze |
| Uma biblioteca | uma pasta com imagens próprias ou trabalhos passados | um estilo de casa que ninguém mais pode copiar | refs.mjs analyze refs/<pasta> |
O TikTok de código puro da Pleometric começou a partir de um único frame de outra animação viral; seu filme estilo Donald apontou o Opus para sua própria galeria de imagens PC-98. Onde encontrar referências: vídeos de lançamento em whatships.com, motion no Dribbble e filmes de lançamento de concorrentes. Estude-os; nunca os incorpore ou redistribua.
1. Coloque a referência no disco
- Copie o arquivo ou pasta para
refs/no projeto (primeiro use/motion-studio:studio-initse não houverstudio.json). - Dado apenas um link para o vídeo de outra pessoa, peça ao usuário uma cópia local que ele tenha permissão para estudar. Não baixe mídia de terceiros por conta própria.
- Um único frame: coloque-o em sua própria pasta (
refs/frame/) para queanalyzeo trate como um conjunto de imagens. - Pergunte o que pegar e o que não pegar quando o usuário tiver uma opinião ("a granulação e o tipo, não os personagens").
2. Meça
Execute a partir da raiz do projeto:
| Referência | Comandos |
|---|---|
| vídeo | node tools/refs.mjs extract refs/<video> --every 0.5 em seguida node tools/refs.mjs analyze refs/<video> |
| frame ou biblioteca | node tools/refs.mjs analyze refs/<pasta> |
| cortador rápido (muitos cortes perdidos) | adicione --threshold 0.2 ao analyze |
Saídas: refs/frames/frame_NNNN.png, refs/frames/frames.json, refs/contact.png (folha legendada com até 60 quadros; uma folha alta é paginada como qualquer folha de contato: refs/contact.png é a página 1, depois refs/contact-2.png, contact-3.png ...; abra cada página, o resultado --json as lista em contacts) e refs/analysis.json com tempos de corte, duração dos planos (média, mediana, intervalo), uma paleta de 6 cores com proporções, brilho e contraste, energia de movimento por segundo com seu pico e uma dica de densidade de texto. O resumo impresso é um ponto de partida para o guia de estilo.
3. Escreva o guia de estilo e a lista de planos
Chame motion-studio:style-analyst (ele pode escrever docs/style_guide.md, docs/shotlist.md e refs/**):
Raiz do projeto: <caminho absoluto>. Referência: refs/<arquivo ou pasta>. Assunto: <assunto>. Duração: <S> s.
Abra refs/contact.png (e refs/contact-2.png ... quando estiver paginado) e alguns quadros próximos aos cortes, leia refs/analysis.json.
Escreva docs/style_guide.md seguindo as notas do guia de estilo, depois docs/shotlist.md para um filme de <S> s
sobre <assunto> naquele estilo, na grade de batidas de audio/beats.json (ou <BPM> BPM se ausente).
Capture a gramática da referência, nunca seu conteúdo, logotipos, personagens ou texto.
Retorne perguntas em vez de adivinhar.
As notas seção por seção estão em assets/style-guide-notes.md. Para usuários que desejam colar um prompt em uma nova sessão, os mesmos passos estão escritos como assets/reference-prompt.md.
4. Capture a gramática, nunca o conteúdo
| Capture | Nunca capture |
|---|---|
| relações de paleta (fundo escuro, um acento quente, proporção do acento) | logotipos, personagens, mascotes |
| famílias tipográficas por classe, peso, espaçamento, saltos de escala | composições ou frames exatos |
| duração dos planos e onde os cortes caem em relação à batida | o texto, alegações ou dados da referência |
| tipos de transição (corte seco, wipe de máscara, match cut) | sua filmagem, música ou voz |
| linguagem de câmera (zoom in, whip pan, câmera fixa) | formas específicas de marca ou identidade visual |
| textura (quantidade de granulação, papel, pontilhado) e como o texto entra e sai | qualquer coisa que o usuário não pediu para emprestar |
5. O portão
Mostre ambos os arquivos (um resumo compacto do guia de estilo e a tabela da lista de planos é suficiente) e aguarde o OK do usuário antes de qualquer código de filme. Quando ele rejeitar, reescreva a lista de planos (e o guia de estilo se o visual estiver errado), nunca ajuste código para "mostrar em vez disso". Registre a decisão na linha Status: no topo de docs/shotlist.md.
6. Deixe o modelo escolher a técnica
Especifique o visual e as restrições, não a biblioteca. Pleometric sugeriu p5.js e Opus escreveu seu próprio renderizador de papel. Dentro deste estúdio, isso significa: descreva a textura e o movimento desejados no guia de estilo, e deixe a construção escolher como desenhá-los no motor de canvas (helpers lib/draw.js ou desenho personalizado). Nomeie um framework apenas quando o usuário precisar dele para reuso (rota B, /motion-studio:seek-engine).
Próximo: construa com /motion-studio:motion-reel a partir do estágio 5; para um loop de estado de UI neste estilo, /motion-studio:ui-morph-spec.