Gráficos en Movimiento Procedurales Basados en el Ritmo
Produce videos de tipografía cinética y gráficos en movimiento procedurales de estilo estudio utilizando un pipeline de código de cuatro etapas:
index.html (renderizador basado en el ritmo con Canvas HTML5)
↓ captura fotograma a fotograma (desenfoque de movimiento 10×)
scripts/render.py (Chrome sin interfaz gráfica CDP → ffmpeg H.264)
↓
make_audio.py (forma de onda procedural y síntesis de EDM en la misma cuadrícula de ritmo)
↓
ffmpeg mux → final.mp4 (1920×1080, 60 fps, AAC estéreo)
Todo (imágenes, transiciones, sacudidas de cámara, impactos de glitch, batería, acordes y ascensores) se programa mediante números de ritmo en una única cuadrícula de tempo compartida (por defecto 128 BPM). Sin alineación manual de la línea de tiempo, sin material de archivo externo, sin paquetes de Python de terceros.
Flujo de Trabajo
Paso 1 — Verificación del Entorno
Antes de crear archivos, verifica los requisitos previos locales:
ffmpeg/ffprobe(con los codificadoreslibx264yaac).- Navegador Chrome / Chromium sin interfaz gráfica (
Google Chromeen macOS,chromium/google-chromeen Linux). - Fuentes del sistema disponibles que coincidan con el script objetivo (por ejemplo, sans-serif geométrica negrita para latín, PingFang / Hiragino / Noto Sans para CJK, monoespaciada para HUD/código).
Paso 2 — Storyboard Mapeado por Ritmo
Convierte el tema del usuario en una hoja de ritmo antes de escribir cualquier código de renderizado.
- Elige la duración: 15 s = 32 compases o 30 s = 64 compases a
128 BPM(SPB = 60 / 128 = 0.46875 s/compás). - Sigue el arco narrativo en storyboard-prompt-template.md: Gancho → Tensión / Contraste → Visuales Conceptuales (Gráfico / Túnel / Morfología / 3D) → Construcción Rápida + Cuenta Regresiva → 0.1 s de Apagón Silencioso → Final de Partículas.
- Mantén el texto en pantalla ultra contundente: 1–3 palabras heroicas en inglés (200–400 px) acompañadas de como máximo una línea de subtítulo corta (36–70 px). Nunca escribas párrafos.
Paso 3 — Construir index.html (Motor Visual)
Crea un renderizador Canvas HTML5 autónomo de un solo archivo (1920×1080) que exponga:
window.READY === truedespués de que las fuentes, sprites fuera de pantalla, formas de morph y objetivos de partículas terminen de inicializarse.window.TOTAL(número entero total de fotogramas, por ejemplo,900o1800).window.MB(número configurable de submuestras de desenfoque de movimiento, por defecto10para renderizado final,1para vista previa rápida).window.frameData(frameIndex, quality)que devuelve una URL de datos JPEG para ese fotograma exacto.
Sigue las primitivas visuales y el pipeline de postprocesamiento en visual-style-guide.md.
Paso 4 — Inspección de Fotogramas Fijos Visuales (Puerta Obligatoria)
Nunca ejecutes un renderizado completo de 900–1800 fotogramas a ciegas. Siempre captura primero 12–16 fotogramas clave representativos e inspecciónalos como una hoja de contactos:
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
Inspecciona preview/sheet.jpg y verifica:
- Ningún texto choca con el HUD de las esquinas (mantén el contenido principal dentro de
y ∈ [100, 980],x ∈ [100, 1820]). - Todas las fuentes se cargaron correctamente (sin glifos de tofu/serif de respaldo).
- El contraste es legible en escenas claras y oscuras; la mezcla de
differencedel HUD sigue siendo legible. - El desenfoque de movimiento, el brillo y la convergencia de partículas se ven limpios y centrados.
Corrige cualquier problema de diseño y vuelve a verificar antes del renderizado completo.
Paso 5 — Generar Banda Sonora Procedural (make_audio.py)
Adapta make_audio_template.py para que coincida exactamente con BPM, BEATS, SCENE_TRANSITIONS y DROP_BEAT utilizados en index.html. Consulta audio-synthesis-guide.md para las reglas de síntesis.
Verifica el music.wav generado antes de la multiplexión:
- La duración coincide exactamente con
BEATS * 60 / BPM. - Renderiza un espectrograma (
showspectrumpic) o una comprobación RMS por segundo para confirmar dinámicas limpias, una estructura de ritmo clara y el silencio previo a la caída de aproximadamente 0.1 s.
Paso 6 — Renderizado Completo y Multiplexión
- Renderiza todos los fotogramas a 60 fps con desenfoque de movimiento
MB=10:python3 scripts/render.py --html ./index.html --out video.mp4 --mb 10 - Multiplexa video y audio con copia de flujo en el video:
ffmpeg -y -loglevel error -i video.mp4 -i music.wav \ -c:v copy -c:a aac -b:a 256k -shortest final.mp4 - Ejecuta una comprobación final de
ffprobe+ hoja de contactos de 6 fotogramas enfinal.mp4para confirmar1920x1080,60 fps,h264 + aac, duración exacta y salida limpia.
Restricciones Estrictas y Reglas de Ingeniería
- Reloj de Ritmo Único: Tanto
index.htmlcomomake_audio.pydeben derivar el tiempo estrictamente debeat = t / (60 / BPM). Nunca codifiques desplazamientos mágicos en milisegundos que puedan desviarse de la música. - Renderizado Determinista: Usa un PRNG con semilla (por ejemplo,
mulberry32) indexado en el fotograma/elemento —nuncaMath.random()dentro del bucle de renderizado— para que 10 submuestras de desenfoque de movimiento se mantengan coherentes sin parpadeo caótico. - Desenfoque de Movimiento de Obturador 10×: Promedia
10subfotogramas en una ventana de obturador de0.75fotogramas (acumulaciónalpha = 1 / (k + 1)). Menos de 8 muestras crea un fantasma escalonado en la tipografía cinética rápida. - Python de Cero Dependencias:
render.pyymake_audio.pydeben usar solo la biblioteca estándar de Python (os,json,subprocess,base64,math,random,wave,array) para que se ejecuten en cualquier lugar sinpip installonumpy. - Pre-cocinar Brillos Costosos: Evita llamar a
ctx.shadowBlurpor fotograma en 10 pasos de desenfoque de movimiento en texto/tarjetas complejas. Pre-renderiza sprites heroicos brillantes en canvases fuera de pantalla duranteinit()o usa trazos apilados de baja alfa (glowStroke). - Silencio Previo a la Caída: Inserta aproximadamente
0.10 sde apagón visual total y silencio de audio total justo antes del ritmo culminante de la caída para maximizar el impacto percibido. - Disciplina de Hechos: Si el video presenta afirmaciones técnicas/de productos del mundo real, verifica los hechos primero y omite números no confirmados (como precios contradictorios o porcentajes de referencia no verificados).