stage3d shorts
Um palco escuro com piso espelhado. Figuras brancas planas em forma de pílula, adereços desenhados com linhas de néon, um holofote teatral sobre a pessoa, uma câmera que se move em 3D real, uma palavra de legenda por vez. O visual foi obtido por engenharia reversa a partir de medições de vídeos de referência (material de estudo privado: nunca copie seu conteúdo, nomes ou roteiros) e depois melhorado.
Status: v0.1. Comprovado em um clipe de 9,7 s com duas estações (pricetag_demo) e um teste de 5 s (test5). Ainda não comprovado em um vídeo de tamanho completo. Leia "O que o kit ainda não tem" antes de prometer uma cena.
A ideia
- O kit é o visual.
kit/src/contém cores, brilho, lente, piso, luz, curvas de câmera, legendas. Um vídeo nunca o edita. - Um vídeo é um plano.
kit/plans/<nome>/plan.jsdiz o que está no palco, quando cada coisa acontece e como a câmera se move. Ele importa apenaskit/src/api.js. A construção recusa um plano que acesse o visual. - Números decidem, não opiniões. Cada renderização é medida por
scripts/qa.py. Um vídeo que falha não é entregue.
Onde o kit reside
Esta skill é apenas instruções. O código que desenha o vídeo e os arquivos de referência estão em uma pasta no PC do Pimbo: C:\Users\Pimbo\work\anymation\stage3d\skill (contém kit/, references/ e uma cópia deste arquivo). Todo caminho nesta skill é relativo a essa pasta.
- A pasta
anymationdeve estar conectada à conversa. Se não estiver, peça ao Pimbo para conectá-la: sem o kit nenhum vídeo pode ser feito, e nada aqui deve ser reconstruído de memória. - O Pimbo não executa scripts manualmente. Você os executa. Ele dá o tópico ou a pasta do vídeo, olha os stills e aprova.
- As entradas de um vídeo vêm do pipeline dele:
anymation/v2/v8/<video>/(script.json,asr_<lang>.jsonpara os timings das palavras,premix_<lang>.wavpara voz e música,events_<lang>.json). - Se você puder executar comandos no PC dele, trabalhe na própria pasta. Se você tiver apenas um espaço de trabalho em nuvem: copie
stage3d/skillpara ele (deixe de foranode_modules,outedist), executenpm installdentro dekit/, escreva o plano e renderize stills lá (cerca de 2 s cada sem placa de vídeo), mostre os stills a ele, depois escreva a pastakit/plans/<nome>/finalizada de volta na pasta dele. - A renderização final pertence ao PC dele: a placa de vídeo dele é cerca de 20 vezes mais rápida que uma máquina em nuvem. Se você não puder executar comandos lá, deixe um arquivo
.cmdemstage3d/skillque executenode scripts\make_video.cjs <nome> --gpu --workers=4a partir dekit, peça a ele para dar duplo clique e colar o que imprimir. Leia as linhas de QA antes de considerar o vídeo finalizado.
Regras que não são negociáveis
- Nunca edite
kit/src/para fazer um vídeo funcionar. Se um adereço ou tipo de tomada estiver faltando, adicione-o ao kit como uma parte reutilizável (vejareferences/PLAN_GUIDE.md, "Adicionando um adereço") e re-verifiquepricetag_demodepois. - Todo número de quadro em um plano vem do áudio real (tímings de palavras), nunca de um palpite.
- Todo movimento de câmera tem uma razão que você pode dizer em uma frase. Escreva essa frase como um comentário acima do movimento.
- Olhe os stills antes de renderizar um clipe. Olhe a imagem, não o código de saída.
- Diga o que foi medido e o que foi assumido. Se você não verificou algo, diga.
- Uma pessoa ouve o áudio antes de um vídeo sair: esses scripts definem níveis por números.
Pipeline
Trabalhe dentro de kit/. Primeira vez em uma máquina: npm install (three, esbuild, playwright-core; usa o Chrome ou Edge instalado, nada mais é baixado). A renderização precisa do ffmpeg no PATH; o QA precisa de Python com numpy e opencv (pip install numpy opencv-python); os scripts de áudio precisam de scipy.
| Etapa | O quê | Comando ou arquivo |
|---|---|---|
| 1 | Roteiro e voz, com um timing para cada palavra | fora desta skill; resultado: words.json = [{ w, t0, t1, line }], segundos |
| 1b | Verifique cada fato do roteiro no dia, antes de gravar a voz | pesquisa na web; escreva SOURCES.md junto ao plano (exemplo: plans/no_trick/SOURCES.md) |
| 2 | Divida o roteiro em estações: uma frase ou ideia cada | anotações no topo de plan.js |
| 3 | Escreva o plano: construir, animar, câmera | kit/plans/<nome>/plan.js; comece a partir de pricetag_demo |
| 4 | Áudio: mix base mais efeitos nos eventos | kit/plans/<nome>/make_audio.py -> audio.wav |
| 5 | Verificar e construir | node scripts/build.cjs <nome> |
| 6 | Stills nos quadros-chave; corrija o enquadramento; repita | node scripts/render.cjs <nome> stills 0,17,62,88 |
| 7 | Veja-o se mover com som | abra kit/dist/<nome>/preview.html em um navegador |
| 8 | Renderizar, codificar, QA de uma só vez | node scripts/make_video.cjs <nome> --gpu --workers=4 |
| 9 | Leia as linhas de QA; um FALHA significa corrigir e repetir | kit/out/<nome>/logs/qa.log, qa.json |
A etapa 8 imprime uma linha por etapa. Em um PC com placa de vídeo, um vídeo de 5 s leva cerca de 10 s; sem uma (omitindo --gpu) cada quadro leva cerca de 2 s, então renderize lá apenas o que for necessário.
Escrevendo um plano, em resumo
Guia completo e a lista de partes: references/PLAN_GUIDE.md. O exemplo trabalhado é kit/plans/pricetag_demo/plan.js.
- O palco é uma fileira de estações com 14 m de distância. Uma frase ou ideia por estação. A câmera permanece em uma estação para uma tomada e faz panorâmica chicote para a próxima entre as frases.
build(stage)cria as coisas e as coloca:stage.station(i).add(thing). Figuras ganham um holofote:stage.station(i).spotlight(figure).animate(f, o)define onde tudo está no quadrof. Deve ser uma função pura def: os quadros são renderizados em qualquer ordem e em paralelo. Sem estado carregado de um quadro para o próximo, semMath.random, sem relógio.- As coisas aparecem na sua palavra:
pop(thing, f, wordFrame). Um número que importa é executado enquanto está sendo falado. Algo que aterrissa ganha um anel de piso (pulse), um curtoflaree um som. - Cores apenas por nome. Dourado = a coisa valiosa. Vermelho = preço, custo, perigo. Branco = pessoas e rótulos neutros.
- Texto que muda (um contador) precisa de
maxCharspara que sua caixa não redimensione.
Câmera, em resumo
Regras completas com as medições por trás delas: references/CAMERA_RULES.md.
- Uma tomada tem um movimento, às vezes dois ou três. Entre movimentos a câmera segura (o kit adiciona um rastejar lento).
- Existem apenas três tipos de movimento:
hook(aproximação de abertura, a partir do quadro 0),reframe(20-28 quadros, entre duas frases, aterrissa alguns quadros antes da nova coisa aparecer),slow(uma aproximação ou órbita por toda uma tomada). - Enquanto um gráfico anima, a câmera segura. Uma lista ganha um deslocamento; uma afirmação mais ampla ganha um recuo; um objeto por uma linha longa ganha uma órbita lenta.
- Uma visão 3/4 (guinada em torno de 35-40 graus) é o que mostra profundidade. Use-a quando um segundo objeto precisar de espaço.
- Panorâmicas chicote apenas entre ideias. Cada uma precisa de um whoosh no áudio que começa cerca de 3 quadros antes.
Portões de qualidade
scripts/qa.py reprova o vídeo se: um quadro está faltando ou congelado; o fundo não é o preto levantado; o hook ou um reframe não está carregado na frente; a câmera não segura entre movimentos; uma panorâmica chicote não se move ou não escurece; o MP4 não é h264 / yuv420p / BT.709, tem o número errado de quadros, ou seu áudio está faltando ou com o comprimento errado.
Ele não verifica gosto, corte nas bordas do quadro, ou se as legendas dizem as palavras certas. Estes são verificados nos stills, a olho, antes da renderização: nada importante cortado pela borda do quadro, a faixa de legenda (75-83 % da altura) livre de linhas brilhantes, figuras entre 25 % e 85 % da altura (a lente estica coisas perto das bordas).
Após qualquer alteração em kit/src/: reconstrua pricetag_demo, renderize os stills 0,17,88,150,174,236 e compare-os com references/frames/. Na renderização por software eles devem corresponder exatamente; em uma placa de vídeo, dentro de cerca de 1 nível.
O que o kit tem
Figura (pessoa pílula com headset), pílula de rótulo, cartão com um rótulo e um grande valor, token, baú que abre (dourado, ou um cinza simples para uma multidão de baús), bússola redonda com agulha, faixa de bússola de uma tela de jogo, moldura de contorno (uma tela, uma miniatura), dado, botão de play, marcas de talha, guia tracejada, imagem (um SVG ou PNG preto e branco desenhado como luz), anel de piso, linha de chão tracejada, partículas flutuantes, holofote teatral com poça de luz no chão e sombra, poças de luz coloridas no chão, halo, raios, faíscas, panorâmica chicote com desfoque de movimento, legendas, uma biblioteca de sons (whoosh, tick, ding, thud, clunk, sparkle, fizz) e um mixer que coloca um arquivo de voz e um arquivo de música sob eles.
Dois planos para ler: pricetag_demo (10 s, duas estações, o visual aprovado) e no_trick (47 s, cinco estações, um curta completo com sua voz, música e fontes). starts_clean (62 s, seis estações) é branco até um único payoff dourado, como as regras de roteiro do Pimbo pedem. avatar não é um vídeo: ele faz stills para uma foto de perfil.
O que o kit ainda não tem
- Um deslocamento ao longo de uma fileira de coisas (para listas), barras e gráficos de linha.
- Mais de um holofote em uma estação: não testado (as partículas são iluminadas por no máximo dois holofotes por vez). Várias figuras em uma estação funcionam com um holofote e as outras escurecidas (
no_trick, estação 2). - Fades ou cortes: a única transição é a panorâmica chicote.
- Close-ups: a câmera precisa do chão sob seu sujeito dentro do quadro e perde a mira a menos de cerca de 2 m. Uma imagem mais próxima é recortada de uma mais ampla (
plans/avatar). - Mais do que os três tipos de movimento, e qualquer rotação de câmera.
- Voz, música e timing de palavras: eles vêm de fora (o pipeline
v2/v8do Pimbo os faz).
Cada um destes tem que ser construído no kit e testado em um vídeo real antes que um plano possa usá-lo.
Arquivos
| Caminho | O que é |
|---|---|
kit/src/ | O visual. api.js é o único arquivo que um plano importa |
kit/plans/<nome>/ | Um vídeo: plan.js, words.json, make_audio.py, audio.wav |
kit/scripts/ | build.cjs, render.cjs, encode.cjs, make_video.cjs, qa.py |
kit/audio/sfx.py | Efeitos sonoros e mixer |
references/STYLE_BIBLE.md | Cada número do visual, marcado como medido, nosso ou palpite |
references/CAMERA_RULES.md | Como a câmera é editada, com as medições |
references/PLAN_GUIDE.md | Como escrever um plano; toda função de api.js; adicionar um adereço |
references/KNOWN_ERRORS.md | Erros já cometidos uma vez, e o que agora impede cada um |
references/frames/ | Quadros alvo de pricetag_demo |