motion-graphics
Un video es una página HTML cuyos píxeles son una función pura del tiempo t, renderizada fotograma a fotograma en Chromium sin interfaz gráfica y codificada con ffmpeg. El estándar es el reel de un diseñador senior de motion graphics, nunca una presentación de diapositivas.
1. Elegir el formato
| Solicitud | Leer |
|---|---|
| Lanzamiento, promoción, comercial, reel de características, tráiler de app para un producto real | formats/launch-video.md |
| Shorts, Reels, TikTok, explicativo o historia vertical | formats/shorts.md |
Sigue el archivo de formato para el resumen, los pasos de contenido y la estructura de tiempos. Después regresa aquí para la construcción. También lee references/pitfalls.md antes de escribir la composición.
Concepto fresco en cada ejecución. Cada video tiene su propia idea, guion y aspecto. Cuando el usuario indique que no se revise trabajo anterior, deja los videos y composiciones previos en el espacio de trabajo sin abrir.
2. Carpeta de trabajo
Crea <slug>-<AAAAMMDD>/ donde el usuario quiera (por defecto: el directorio actual):
brief.md parámetros de la tabla de resumen del formato
beats.md la hoja de tiempos (tiempo, texto, recurso, movimiento, transición, acento)
assets/ capturas, imágenes, fuentes, audio
assets/manifest.md una línea por archivo de recurso: fuente, licencia o "capturado de <superficie>", qué muestra
motion.html la composición
motion.json {"size": [W, H], "fps": 60, "duration": 30, "stills": [tiempos de beats], "captions": []}
engine/ copiado del motor de esta habilidad
out/ fotogramas fijos, renderizados, hoja de contacto
Configura el motor una vez por carpeta:
cp -R <esta-habilidad>/engine engine && (cd engine && npm install && npx playwright install chromium)
3. Componer
motion.html carga engine/runtime.css y engine/runtime.js, construye su DOM, registra escenas y luego llama a MG.ready().
| Helper | Uso |
|---|---|
MG.scene(start, end, fn, el) | fn(local, t, dur) se ejecuta mientras start <= t < end; el está oculto fuera. Establece cada propiedad animada en cada llamada. |
MG.always(fn) | Se ejecuta en cada fotograma: fondos, grano, barras de progreso. |
MG.prog(t, a, b, ease) | Progreso suavizado 0..1. Suavizados: MG.ease.* (linear, in/out/inOut Quad, Cubic, Quart, Expo, inBack, outBack, outElastic, outBounce) o cualquier función. |
MG.tween(t, [[t0, v0], [t1, v1, ease], …]) | Fotogramas clave; los valores pueden ser arrays. |
MG.spring(t, {stiffness, damping}) | Físico 0 → 1 con rebasamiento. |
| `MG.split(el, "grapheme" | "word")` |
MG.set(el, {x, y, s, sx, sy, r, o, blur, ...css}) | Una llamada por elemento por fotograma. |
MG.clip(videoEl, start, rate) | Reproduce una grabación de pantalla con precisión de fotograma desde start. |
MG.rng(seed), MG.noise(x, seed) | Aleatoriedad determinista y ondulación. |
MG.fmt(n, {decimals}) | Formato de números localizado para contadores. |
MG.captions() | Dibuja los subtítulos de motion.json encima del bloque inferior de la interfaz. |
Determinismo: no usar Date, performance.now(), requestAnimationFrame ni Math.random en la lógica de renderizado. @keyframes de CSS están permitidos; el runtime los pausa en t, así que temporízalos con animation-delay. Usa solo las fuentes e imágenes listadas en el manifiesto.
Previsualizar un fotograma: open "motion.html?w=1920&h=1080&t=3.2&guides=1" (las guías muestran zonas seguras). Tiempo real: ?play=1. Los subtítulos solo se muestran en los renderizados.
4. Nivel de calidad
- El fotograma 0 ya está en movimiento. Sin fundido desde negro, sin introducción de logotipo.
- Algo significativo cambia cada 0.8–2 s: diseño, escala, color, número o cámara.
- Las entradas usan resortes o ease-out-expo con ligero rebasamiento; escalonamientos de 30–60 ms; solo lineal para marcadores.
- Desenfoque de movimiento solo durante movimientos rápidos; un push lento (escala 1 → 1.04) en tomas fijas; paralaje en 2–3 capas de profundidad.
- Una familia de fondo, un color de texto, un acento. Añade grano o ruido degradado para que los rellenos planos no se bandeen después de la subida.
- El texto en pantalla permanece el tiempo suficiente para leerlo dos veces; el texto clave se mantiene dentro de las zonas seguras.
- Los beats coinciden con el sonido: un whoosh, un golpe o un beat musical en cada cambio.
5. Renderizar
node engine/render.mjs --html motion.html --config motion.json --stills <t1,t2,...> --stills-dir out/stills
node engine/render.mjs --html motion.html --config motion.json --out out/video.mp4 --workers 4
Ajusta el diseño primero con fotogramas fijos: uno por beat, uno dentro de cada interpolación, uno en cada pico de rebasamiento de resorte. Ejecuta un renderizado completo a la vez (aproximadamente 10 minutos para 25 s a 1080p60 con 4 workers).
6. Audio
Usa solo música y SFX listados en el manifiesto con una licencia que permita su uso, o archivos que el usuario proporcione. Sin ellos, entrega sin sonido e indícalo. Mezcla las pistas, luego multiplexa:
ffmpeg -i music.wav -i whoosh.wav -filter_complex \
"[0]volume=-16dB[m];[1]adelay=1200|1200,volume=-8dB[a];[m][a]amix=inputs=2:normalize=0[out]" -map "[out]" out/mix.wav
ffmpeg -i out/video.mp4 -i out/mix.wav -map 0:v -map 1:a -c:v copy \
-af "loudnorm=I=-14:TP=-1.5:LRA=11" -c:a aac -b:a 256k -shortest -movflags +faststart out/final.mp4
ffmpeg -i out/final.mp4 -af ebur128=peak=true -f null - 2>&1 | grep -E "^ +(I|Peak):"
Apuntar a aproximadamente −14 LUFS integrado y pico verdadero en o por debajo de −1 dBFS. Los SFX deben estar alrededor de −6 a −14 dB, la música −14 a −18 dB. La música bajo texto en pantalla debe ser instrumental.
7. QA
ffprobeduración, tamaño y fps coinciden con el resumen.- Hoja de contacto:
ffmpeg -i out/final.mp4 -vf "fps=2,scale=360:-1,tile=10x6" -frames:v 1 out/contact.png. Revísala junto con un fotograma a tamaño completo en cada cambio de beat (ffmpeg -ss <t> -i out/final.mp4 -frames:v 1 out/check-<t>.png). - Cada fotograma: nada recortado en los bordes, sin fotogramas en blanco o medio fundidos, sin guías sobrantes, sin errores tipográficos ni texto de relleno, nada estático por más de 2 s.
- Las comprobaciones propias del archivo de formato.
Corrige y vuelve a renderizar hasta que todas las comprobaciones pasen. Añade cualquier nueva lección a references/pitfalls.md en la habilidad como fecha · video · lección.
Entregar
Informa la ruta del MP4 final, duración, tamaño y fps, qué muestra, estado del audio con créditos necesarios y los comandos de re-renderizado. Mantén la carpeta de trabajo. Sube o publica solo cuando el usuario lo solicite.