Storyboard interativo
Transforme um storyboard finalizado em uma história visual interativa: uma página web onde o espectador avança a história clicando, segurando e arrastando sobre os próprios desenhos, com som, legendas/diálogos e transições que respeitam o ritmo do filme. É para pessoas que já sabem o que é um storyboard (quadros, planos, slugs, anotações); não é um gerador de animatic.
Exemplos de casos do autor desta skill, Ding Yilin: The Joy of the White Room e Fahrenheit 451 (cenas 1, 8, 9) — veja em examples/; experimente-os ao vivo: The Joy of the White Room, Fahrenheit 451, cenas 1 → 8 → 9.
0. Pergunte antes de construir (uma rodada, depois vá)
Pergunte apenas o que muda a construção; assuma valores sensatos para o restante e informe quais.
- Quais cenas / quadros (um storyboard longo: pilote uma cena primeiro, depois faça as outras da mesma forma).
- Visual: um dos presets abaixo, ou "manter meus desenhos como estão".
- Texto: somente diálogo / narração / ambos / nenhum. Use as falas do próprio storyboard; nunca invente diálogo ou narração.
- Som: gravações do usuário (peça os arquivos e a qual quadro cada um pertence) ou som sintetizado.
- Idiomas: sempre pergunte quais idiomas a peça precisa; não há conjunto padrão. Construa apenas esses. Cada string na tela (títulos, slugs, dicas, balões, créditos) reside em uma tabela por idioma e é alternável ao vivo; com mais de um idioma, o inicial pode seguir uma página hospedeira (
?lang=, um postMessage, ou<html lang>). As traduções que você fizer são rascunhos que o usuário deve verificar. - Onde viverá: apenas uma página compartilhável, ou também embutida no site do usuário (então pergunte pelo pacote do site e edite a cópia deles).
- Linha de crédito: use exatamente as palavras que o usuário fornecer (ex.: "Feito por …"); não adicione papéis que ele não listou.
1. Leia o storyboard
- Storyboarder / exportações PDF:
pdfimages -pngfornece cada quadro no tamanho completo incluindo a área de NOTA; encontre o quadro de desenho uma vez (varra linhas/colunas em busca das linhas do quadro) e corte todos os quadros da mesma forma para a área de desenho (mantenha uma janela 16:9 se o palco for 16:9). Renderize as páginas compdftoppm -r 150e leia as notas, slugs (EXT./INT. … – DIA/NOITE), durações e diálogos;pdftotext -layoutobtém os slugs. - Faça uma folha de contato e uma vista gradeada (linhas a cada 0,1 da largura/altura) de cada quadro: toda coordenada posterior (onde uma figura está, onde tocar, onde uma tela está) é medida nestas, em frações da imagem, nunca adivinhada.
- Escreva uma lista de batidas: quadro → o que acontece → o gesto que faria o espectador realizar essa ação → som → texto.
2. Planos antes de efeitos
- Encontre as tomadas longas. Quadros consecutivos com a mesma configuração e sujeitos em movimento (A→B→C de pessoas andando) são uma tomada contínua: construa um fundo limpo (remova o sujeito usando os outros quadros), recorte o sujeito e mova-o, com a câmera acompanhando. Não faça cross-dissolve de quadros inteiros aqui.
- Plano fechado → plano aberto dos mesmos sujeitos (ou o inverso) é um movimento: enquadre o quadro aberto ampliado para que seus sujeitos tenham o mesmo tamanho e posição que no quadro fechado (calcule o zoom e o centro a partir das posições medidas da cabeça/pés), finalize o cross-fade nesse enquadramento correspondente, então recue. Verifique o quadro correspondente em uma captura de tela; fantasmas significam que os números estão errados.
- Quadros que devem ser lidos como um movimento compartilham uma paleta (processe-os com a mesma cor predefinida).
- Quando o usuário disser que um quadro mostra a parte de trás de uma TV, uma porta vista por trás, etc., não desenhe nada que o quadro não mostre: luz e som podem sugerir o que está fora da tela.
3. Presets visuais
Todos os presets mantêm o desenho a traço do usuário; nunca o redesenham.
- Filme / risografia (o visual da White Room): gradagem por cena (cor brilhante e saturada contra escuridão), textura suave de papel, grão leve; oscilação de quadro, cintilação e arranhões sutis ocasionais — não constantes; uma sombra de registro. Efeitos são raros e silenciosos: cintilação ou tremor constantes cansam.
- Quadrinho americano: suavização bilateral; uma camada de tinta a partir de um limite escuro mais black-hat para que traços finos a lápis sejam entintados; uma cor chapada plana nas áreas desenhadas, pontos Ben-Day a 45° nos meios-tons e uma tela clara sobre todo o painel, mais densa nas bordas; a placa de cor deslocada 1–2 px da placa de tinta; saída ~1,5×. Uma cor chapada por local/horário (dia quente, noite azul, CCTV verde, alarme vermelho…). Lettering: caixas de legenda amarelas para slugs, palavras SFX em quadrinhos na imagem, balões de fala para diálogo.
- Pixel: reduza para uma grade pequena com uma paleta limitada e dithering ordenado, amplie com nearest-neighbour; texto em fonte pixel.
A cromática da página segue o preset (sala de projeção, página de jornal, tela de jogo). As fontes web carregam com uma corrida de fallback de 2–3 s para que a história nunca espere por elas.
4. Construção: uma página HTML, um canvas
- Um palco 16:9, um canvas, uma área de legenda/dica abaixo dele, um seletor de idioma (se houver mais de um) e um botão de som.
- Máquina de estados de cena: cada cena é um objeto com
enter / render(t) / tap / drag / down / up / hover / key;go(cena)alterna;st()é o tempo na cena. Um auxiliar de câmera (setCam(img, zoom, cx, cy),toScreen,toImg) para que toda área de clique e efeito seja posicionada em frações da imagem e siga a câmera. - Toda cena tem uma saída: uma tecla de atalho e um fallback automático lento (10–20 s) para que ninguém fique preso, além de um link "pular" nas cenas longas.
- Envolva toda chamada de som para que um contexto de áudio ausente ou uma decodificação falhada nunca quebre a história.
- Carregue imagens com
<img>(funciona também emfile://); áudio viafetch+decodeAudioData, com fallback para elementos<audio>quando fetch estiver bloqueado.
5. Design de interação
- O gesto é a ação da história. Correr = cliques rápidos; prender a respiração = não tocar; inclinar-se para olhar = segurar; escalar = arrastar repetidamente para cima; entregar algo = carregá-lo; virar uma página = arrastar sobre o livro; desligar = segurar na mão sobre o botão. Prefira estes gestos a "clique para continuar" genérico; mantenha toques simples para diálogo e para batidas que são puro ritmo.
- Carregue o desenho do próprio usuário, nunca um adereço inventado. Recorte a figura/objeto ao longo de seu contorno (polígono traçado no zoom gradeado, borda suave), adicione uma fina borda branca como um recorte de papel, levante com uma pequena sombra e incline enquanto arrasta, deixe o papel vazio onde estava, encaixe de volta se soltar no lugar errado. Verifique o recorte em relação ao quadro: não inclua escadas, móveis ou a mão de outro personagem por engano.
- Efeitos adicionados sobre um quadro (uma tela acendendo, ondas de rádio, um visor) devem seguir a geometria do desenho — recorte um brilho de tela ao quadrilátero de perspectiva da tela, não a um retângulo — e devem ser apontados ao usuário como adições.
- Dicas dizem onde e como: "Segure no peixe e rabisque para frente e para trás", não "interaja". Maior que o corpo do texto, sob a imagem.
- Guias na imagem, silenciosas por padrão (pense em What Remains of Edith Finch): um pequeno sinal no ponto de toque que já diz a ação — um pulso para toque, um anel preenchendo para segurar, chevrons fluindo na direção do arrasto, um arco giratório para circulação (no estilo quadrinho: marcas de tinta "olhe aqui"). Uma mão demonstra o gesto duas vezes quando o passo começa, então recua; ela retorna somente após ~3 s de hesitação. Esconda tudo enquanto o dedo estiver pressionado. Nunca cubra a imagem com longos caminhos tracejados.
6. Transições
- Combine com o tom: suave por padrão (dissolves onde o novo painel se assenta de um pouco maior, tinta-saindo/tinta-entrando, um leve bloom para uma TV ligando ou um fogo pegando). Mantenha um corte seco (quadro negativo, linhas de velocidade, tremor) para o único choque da cena. Todos os cortes secos = rígidos.
- Um avanço contínuo para o próximo espaço é um movimento longo: o que estiver entre eles (uma parede) pega a cor e textura do painel de destino e se funde nele; sem calhas no meio de um movimento.
- Nunca mostre as bordas pretas de uma imagem girada ou ampliada: trave a câmera.
7. Som
- Som gravado: corte para a ação (uma porta abrindo sincronizada com a maçaneta desenhada), nivele tudo, loop de ambientes com fades.
- Som sintetizado (WebAudio, sem arquivos): passos, papel, portas, cães mecânicos, alarmes, batimentos cardíacos, murmúrio de TV… Randomize cada batida (tempo, tom, envelope) e modele envelopes de forma irregular para que nada soe repetido por máquina; evite cliques e bipes secos em cenas silenciosas.
- Use pontes sonoras para significado (uma máquina de lavar se tornando lentamente o mar do sonho; um som continuando sobre o título). Pergunte antes de adicionar sons que o storyboard não implica.
8. Texto
- Diálogo: balões de fala (quadrinhos) ou legendas (filme), rabo apontando para a cabeça do falante, mantido dentro do painel, quebrado medindo, nunca começando uma linha com pontuação de fechamento. Preencha o corpo e o rabo de cada balão separadamente para que nenhum traço cruze o texto.
- Slugs como caixas de legenda no canto; mantenha-os fora de desenhos importantes (pule a legenda em um quadro onde cobriria o sujeito).
- Citações que você adicionar (ex.: o que personagens recitam) devem ser de domínio público e sinalizadas ao usuário.
9. Performance
- Limite o canvas a ~1600 px de largura (
DPR = max(1, min(devicePixelRatio, 2, 1600 / cssWidth))). - Pré-renderize sobreposições estáticas (textura de papel, vinheta) uma vez por tamanho e aplique-as em cada quadro; nunca reconstrua gradientes ou padrões por quadro.
- Para dissolves, mantenha o quadro anterior na metade do tamanho, não uma cópia completa a cada quadro.
- Carregamento preguiçoso da história na página hospedeira (pôster + botão "Entrar na história"); cada página de cena carrega apenas suas próprias imagens.
10. Teste como um espectador
- Uma execução em navegador headless (ex.: Playwright) com gestos reais de mouse (cliques, segurar, arrastar medidos a partir de
toScreen) através de toda a história, em todos os idiomas, falhando em qualquer erro de página. Exponha um__go(cena, estado)somente para teste para pular para uma batida. - Capturas de tela de cada quadro-chave e do meio de cada transição/combinação; olhe para elas.
- Verifique a sintaxe do script após edições (
node --check). Não coloque comentários//no meio de uma instrução de uma linha (isso comenta silenciosamente o resto da linha e a página fica em branco). - Meça a taxa de quadros antes/depois de mudanças pesadas. Diga claramente que o som e a sensação foram verificados por medição e capturas de tela, não por reprodução.
11. Entrega
- Uma página hospedada compartilhável para revisão; para o site do usuário, um zip do pacote do site deles com a história em sua própria pasta (ex.:
story/<projeto>/), um bloco de incorporação com carregamento preguiçoso, e nada mais alterado. Se o usuário adaptou a história dentro de seu site, sempre edite essa cópia (faça merge de 3 vias de suas alterações nela), nunca sobrescreva com o original. - Várias cenas: uma página por cena compartilhando uma pasta de assets, encadeada (fim da cena → próxima cena, idioma mantido; a última retorna à primeira). A capa de cada cena precisa de um clique para desbloquear o áudio após a navegação.
- Nunca implemente nada em nome do usuário; entregue o zip.
- Um único arquivo aberto por conta própria ficará preto: a página precisa da pasta de assets
a/ao lado dele. Diga isso ao entregar os arquivos.