one-prompt-reel
A declaração que este filme faz: "funciona da mesma forma onde quer que você digite." A prova é a repetição. Uma string, quatro superfícies aparentemente diferentes, depois uma explosão do que foi produzido e, novamente, a string.
Entradas
| Entrada | Obrigatório | Notas |
|---|---|---|
prompt | sim | O comando ou frase exata. Com menos de cerca de 50 caracteres funciona melhor; é digitado quatro vezes mais uma vez no fechamento. |
imagens reel | sim | 16 a 24 resultados reais: capturas de tela, telas de produto, imagens estáticas extraídas de renderizações anteriores. Apenas material próprio. |
| nome da marca, slogan, url | sim | Usado no cartão de fechamento. |
| logotipo | não | PNG quadrado com alpha. Omita para um fechamento apenas com texto. |
| música | não | Uma faixa que você tem licença para usar comercialmente. Se não tiver certeza da licença, envie sem áudio. |
Fluxo de trabalho
- Estrutura. Crie uma pasta de projeto, copie
template/para dentro dela (index.htmlmaisassets/gsap.min.js) e coloque as imagens do reel emassets/reel/. Depois:npx --yes hyperframes check - Preencha o bloco CONFIG no topo da
<script>emindex.html. Tudo específico do projeto está lá:prompt,bpm, lista de arquivosreel,brand,tagline,url,logo. Não reestruturar o resto, a menos que uma regra abaixo force. - Escolha a grade de corte.
- Sem música: mantenha
cuts: null. Os cortes vêm debpmereelPattern(padrão: 8 cortes de uma batida, depois 16 cortes de meia batida, a 120 bpm = 4 s + 4 s). As superfícies duramsurfaceBeatsbatidas cada, então todo o filme permanece na grade. - Com música: adicione a faixa como
<audio id="music" data-timeline-role="music" src="assets/music.mp3" data-start="0" data-duration="24" data-track-index="5">, executenpx hyperframes beats, abrabeats/assets/music.mp3.jsone copie os tempos das batidas (em segundos) que caem após ou no início do reel paraCONFIG.cuts(uma entrada extra marca o fim do último corte, que é quando o fechamento começa). Definabpmpara o andamento da faixa para que a seção de digitação também se alinhe. Se as batidas forem mais densas que 0,2 s, pegue cada segunda batida. Desvaneça a música no último segundo (/hyperframes-audio).
- Sem música: mantenha
- Pré-visualize antes de renderizar.
npx --yes hyperframes snapshot --at 1.8,4.3,6.8,9.2,11,15,20,23e abra os PNGs. Verifique cada superfície no meio da digitação, um corte do reel e o fechamento. - Renderize.
npx --yes hyperframes render --workers 2 -o final.mp4. - Extraia 4-6 quadros do MP4 com ffmpeg (um por superfície, um corte do reel, o fechamento) e analise-os. Corrija e renderize novamente se algo estiver cortado, ilegível ou vazio.
Formato do filme (24 s nos padrões)
| Tempo | Batida |
|---|---|
| 0-10 s | Quatro superfícies, 2,5 s cada. Deslizam da direita, digitam por aproximadamente 1,5 s, pressionam ENTER, deslizam para a esquerda. Um pequeno rótulo nomeia a superfície e sua posição (1/4). |
| 10-18 s | Corte brusco com um flash branco. 24 imagens de saída de página inteira, cada uma com um zoom lento. O comando fica em um comprimido (pill) no canto inferior esquerdo durante todo o reel; um contador fica no canto inferior direito. |
| 18-24 s | Fechamento escuro: logotipo, nome, slogan, o comando digitado mais uma vez dentro de um comprimido com borda de brasa, url, um único pulso de brilho. |
Regras que fazem funcionar
- As quatro superfícies devem diferir na silhueta, não apenas na cor. Larga e baixa, alta e estreita, flutuando sobre um gradiente, escura com uma árvore lateral. Se você consegue apertar os olhos e confundir duas, redesenhe uma. Construa-as com HTML e CSS simples; nunca imite o chrome, logotipo ou paleta de nenhum produto real.
- Mesma string, mesma velocidade de digitação. Cada superfície digita o
promptidêntico na mesma duração. Essa mesmice é o ponto. - Digite com um tween de timeline, não com um temporizador. Um tween sobre um contador
{n}cujoonUpdatefatia a string é seguro para busca;setIntervalnão é. - Faça o cursor piscar com
tl.setem um loop de meia batida, nunca com animação CSS ourepeat: -1. - Corte na grade. Cada limite de superfície, corte e entrada de fechamento cai em uma batida, seja a grade musical ou um andamento simples. Edições fora da grade são a primeira coisa que parece desleixada.
- Acelere uma vez. Cortes lentos primeiro, depois cortes de metade da duração. Não acelere repetidamente.
- Imagens do reel são evidência. Resultado real, não decoração. Prefira imagens estáticas 1920x1080; dimensione tamanhos ímpares com
object-fit: cover. Alterne vizinhos escuros e claros para que cada corte seja percebido. - Sem mídia de terceiros. Sem logotipos, capturas de tela de outros produtos, imagens de stock ou fontes que você não pode distribuir. Fontes: nomeie uma família explicitamente (para monoespaçada use
"JetBrains Mono", que a CLI resolve sozinha); a pilha genéricaui-monospacefoi renderizada proporcionalmente nos testes. - Mantenha as legendas legíveis. Verifique o contraste;
hyperframes checkaplica WCAG AA em texto, então os rótulos precisam de uma tinta média-escura sobre o fundo creme. - Silêncio é aceitável. Não adicione música de licença desconhecida; faixas geradas por IA com termos não comerciais estão descartadas.
- Mantenha o flash tween
immediateRender: false, caso contrário a auditoria de layout vê uma sobreposição branca em t=0.
Validação
npx --yes hyperframes checkdeve terminar com "Check passed" (lint, layout, contraste).- Os quadros de snapshot mostram todas as quatro superfícies totalmente digitadas antes de sua saída, nenhum rótulo sobrepondo uma superfície, nenhuma imagem de reel vazia ou parcialmente carregada.
ffproberelata 1920x1080, h264, duração dentro da janela de 20 a 30 s.
Entrega
Coloque final.mp4 ao lado do projeto (index.html, assets/). Se a convenção do repositório pedir uma nota curta, liste: prompt, andamento ou fonte da batida, fontes das imagens do reel, licença da música (ou "silencioso") e o comando de renderização. Mencione que o Studio (npx hyperframes preview) pode reajustar qualquer coisa.
Veja references/surfaces.md para as especificações das quatro superfícies e references/grid.md para a aritmética de temporização.