Communitygithub.com

Motion gráfico no beat

Gerar um curto de 15 ou 30 segundos preso ao beat, em código: Canvas procedural, frames com Chrome headless e uma faixa sintetizada, sem banco de assets.

O que é Motion gráfico no beat?

Um processo só com código para promo, explicação, lançamento ou montra a 1080p60. A imagem é Canvas HTML5 procedural, os frames são capturados sem interface e a música é sintetizada no beat em vez de importada. Não há stock nem editor de timeline.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cccPhoenix/beat-motion-graphics/tree/HEAD

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Motion Graphics Processuais Guiados por Batida

Produza tipografia cinética e vídeos de motion graphics processuais de nível profissional usando um pipeline de código de quatro estágios:

index.html (Renderizador orientado por batida em Canvas HTML5)
    ↓  captura quadro a quadro (borrão de movimento obturador 10×)
scripts/render.py (Headless Chrome CDP → ffmpeg H.264)
    ↓
make_audio.py (Síntese procedural de forma de onda e EDM na mesma grade de batidas)
    ↓
ffmpeg mux → final.mp4 (1920×1080, 60 fps, AAC estéreo)

Tudo—visuais, transições, trepidação de câmera, efeitos de glitch, batidas, acordes e crescendos—é agendado por números de batida em uma única grade de tempo compartilhada (padrão 128 BPM). Zero alinhamento manual de linha do tempo, zero imagens de arquivo externas, zero pacotes Python de terceiros.


Fluxo de Trabalho

Etapa 1 — Verificação do Ambiente

Antes de criar arquivos, verifique os pré-requisitos locais:

  1. ffmpeg / ffprobe (com codificadores libx264 e aac).
  2. Navegador Chrome/Chromium headless (Google Chrome no macOS, chromium / google-chrome no Linux).
  3. Fontes do sistema disponíveis que correspondam ao script alvo (ex.: sans-serif geométrica e negrito para latim, PingFang / Hiragino / Noto Sans para CJK, monoespaçada para HUD/código).

Etapa 2 — Storyboard Mapeado por Batida

Converta o tópico do usuário em uma folha de batidas antes de escrever qualquer código de renderização.

  • Escolha a duração: 15 s = 32 batidas ou 30 s = 64 batidas a 128 BPM (SPB = 60 / 128 = 0,46875 s/batida).
  • Siga o arco narrativo em storyboard-prompt-template.md: Gancho → Tensão / Contraste → Conceitos Visuais (Gráfico / Túnel / Morfismo / 3D) → Construção Rápida + Contagem Regressiva → 0,1 s Apagão de Silêncio → Final com Chuva de Partículas.
  • Mantenha o texto na tela extremamente impactante: 1–3 palavras heróicas em inglês (200–400 px) emparelhadas com no máximo uma linha curta de legenda (36–70 px). Nunca escreva parágrafos.

Etapa 3 — Construir index.html (Mecanismo Visual)

Crie um renderizador autossuficiente em Canvas HTML5 (1920×1080) que exponha:

  • window.READY === true após fontes, sprites fora da tela, formas de morph e alvos de partículas finalizarem a inicialização.
  • window.TOTAL (número inteiro total de quadros, ex.: 900 ou 1800).
  • window.MB (contagem configurável de sub-amostras de borrão de movimento, padrão 10 para render final, 1 para pré-visualização rápida).
  • window.frameData(frameIndex, quality) retornando um Data URL JPEG daquele quadro exato.

Siga os primitivos visuais e o pipeline de pós-processamento em visual-style-guide.md.

Etapa 4 — Inspeção de Quadro Estático Visual (Portão Obrigatório)

Nunca execute uma renderização completa de 900–1800 quadros às cegas. Sempre capture primeiro 12–16 quadros-chave representativos e inspecione-os como uma folha de contato:

python3 scripts/render.py --html ./index.html --stills 60,200,330,420,560,780,920,1110,1280,1450,1560,1650,1760
ffmpeg -y -loglevel error -pattern_type glob -i 'preview/f*.jpg' -vf "scale=640:360,tile=4x4" -frames:v 1 preview/sheet.jpg

Inspecione preview/sheet.jpg e verifique:

  • Nenhum texto colide com o HUD do canto (mantenha o conteúdo principal dentro de y ∈ [100, 980], x ∈ [100, 1820]).
  • Todas as fontes foram carregadas corretamente (sem tofu / falhas de serifa substituta).
  • O contraste é legível em cenas claras e escuras; a mesclagem difference do HUD permanece legível.
  • Borrão de movimento, brilho e convergência de partículas parecem limpos e centralizados.

Corrija quaisquer problemas de layout e re-verifique antes da renderização completa.

Etapa 5 — Gerar Trilha Sonora Processual (make_audio.py)

Adapte make_audio_template.py para corresponder exatamente ao BPM, BEATS, SCENE_TRANSITIONS e DROP_BEAT usados em index.html. Veja audio-synthesis-guide.md para regras de síntese.

Verifique o music.wav gerado antes da multiplexação:

  • A duração corresponde exatamente a BEATS * 60 / BPM.
  • Renderize um espectrograma (showspectrumpic) ou uma verificação RMS por segundo para confirmar dinâmicas limpas, estrutura de batida clara e a lacuna de silêncio de ~0,1 s antes da queda.

Etapa 6 — Renderização Completa e Multiplexação

  1. Renderize todos os quadros a 60 fps com borrão de movimento MB=10:
    python3 scripts/render.py --html ./index.html --out video.mp4 --mb 10
    
  2. Multiplexe vídeo e áudio com cópia de stream no vídeo:
    ffmpeg -y -loglevel error -i video.mp4 -i music.wav \
      -c:v copy -c:a aac -b:a 256k -shortest final.mp4
    
  3. Execute uma verificação final com ffprobe + folha de contato de 6 quadros em final.mp4 para confirmar 1920x1080, 60 fps, h264 + aac, duração exata e saída limpa.

Restrições Rígidas e Regras de Engenharia

  1. Relógio de Batida Único: Tanto index.html quanto make_audio.py devem derivar o tempo estritamente de beat = t / (60 / BPM). Nunca codifique deslocamentos mágicos em milissegundos que possam divergir da música.
  2. Renderização Determinística: Use um PRNG baseado em semente (ex.: mulberry32) indexado pelo quadro/elemento—nunca Math.random() dentro do loop de renderização—para que sub-amostras de borrão de movimento 10× permaneçam coerentes sem oscilações caóticas.
  3. Borrão de Movimento Obturador 10×: Faça a média de 10 sub-quadros em uma janela de obturador de 0,75 quadros (acumulação alpha = 1 / (k + 1)). Menos de 8 amostras cria fantasmas escalonados em tipografia cinética rápida.
  4. Python Sem Dependências: render.py e make_audio.py devem usar apenas a biblioteca padrão do Python (os, json, subprocess, base64, math, random, wave, array) para que sejam executados em qualquer lugar sem pip install ou numpy.
  5. Pré-processamento de Brilhos Caros: Evite chamar ctx.shadowBlur por quadro em 10 passagens de borrão de movimento em texto/cartões complexos. Pré-renderize sprites heróicos brilhantes em canvases fora da tela durante init() ou use traçados empilhados de baixa alfa (glowStroke).
  6. Silêncio Pré-Queda: Insira ~0,10 s de apagão visual total e silêncio de áudio total imediatamente antes da batida culminante da queda para maximizar o impacto percebido.
  7. Disciplina Factual: Se o vídeo apresentar alegações reais de produto/técnica, verifique os fatos primeiro e omita números não confirmados (como preços conflitantes ou percentuais de benchmark não verificados).

Habilidades Relacionadas