Film build (Construcción de filme)
Inicio
sh ~/.claude/skills/film-build/kit/init.sh marketing/videos/<film> # rechaza si la carpeta no está vacía
cd marketing/videos/<film> && npm i && npx playwright install chromium # si dice NEXT
El kit te proporciona:
| Archivo | Qué es |
|---|---|
film/core.js | el motor: scene({name, from, to, build, run, after}) (tiempos en beats = s × 2), put(el, {o, css}), reg(el, base), C.W/C.H/C.FMT, C.start() |
film/film.js | un iniciador con todos los helpers de abajo y cuatro planos de ejemplo (línea, prompt, split, tarjeta de persona). El comentario de cada helper dice de qué rechazo vino. Reemplaza los planos, conserva los helpers. |
film/mock.js | window.MOCK: HTML para piezas reales de UI (paneles, ventanas, pantallas de teléfono), en px de pantalla |
film/index.html | carga fuentes desde assets/fonts/{display,ui}.woff2 (con fallbacks sans locales) |
scripts/render.mjs | --sheet, --at t1,t2, --draft, --range a,b, --verify, final, --mux, --fmt 9x16, --all |
scripts/sync.mjs | copia timeline.json en la página |
scripts/review.py | kit de crítica a partir del MP4 renderizado: hoja de contactos, tiras de acción más rápida, vista de teléfono, zonas seguras 9:16, métricas |
tools/probe.mjs | cuts (cada corte y el punto medio de cada plano, en segundos de video) o cualquier expresión, ej. "window.UNWARP(12.4)" |
tools/sheet.py | organiza fotogramas fijos en una sola hoja etiquetada |
tools/pack_grid.py | recorta una hoja de personajes de 4×3 (transparente o sobre blanco) en una tira de 12 celdas para sprite(); imprime el tamaño de celda |
tools/cut_cast.py | recorta una fila de personajes en figuras individuales fijas |
assets/characters/ | cuatro personajes de ejemplo (fundador, dev, vendedor, estudiante), tiras de 12 fotogramas con celdas de 360 px |
tools/same.sh | save / check regresión PSNR entre fotogramas fijos de antes y después |
Helpers en el iniciador (úsalos, no reinventes)
io(quintic in-out) para movimientos de cámara y morphs;oq(quint-out) para entradas;backpara un pequeño sobrepaso.cam(e, s, fx, fy)coloca el punto de enfoque (fx, fy) de un plano de 1920×1080 en el centro del fotograma con escala s.camDhace lo mismo pero nunca muestra más allá de los bordes del plano (escala de cobertura; esencial en 9:16).posIn(e, root)lee la posición de un elemento dentro del plano en movimiento (para destinos del cursor, seguimiento del caret).typed()para palabras que aparecen letra por letra en una línea;keyed()para un teclado real: temporización irregular por carácter, pausas más largas en espacios, un caret parpadeante después.wordsHTML()coloca cada palabra en su ancho final desde el primer fotograma, transparente hasta su momento, para que la línea nunca se reajuste ("la transición de texto no es nada suave").cursor()/putCursor()/bump(): un cursor de flecha real que se desliza, llega temprano, se hunde 15 % al hacer clic.pop()para elementos pequeños que aparecen.sprite(parent, src, cellW, cellH, h)/putSprite(e, t, a, z, loops)para un personaje dibujado: recorre sus 12 fotogramas de a a z, con una pequeña respiración para que nunca esté quieto. Es un<img>, por lo que el motor espera por él.shot(name, t0, t1, build, run)envuelvesceneen segundos.- Warp de ritmo al final:
SLOW(estiramiento global),EVmantiene (congela un momento para lectura) e inserciones;window.CUTSywindow.UNWARPdan tiempos de video para ubicación de sonido y voz. PT/pk(a16, a9)elige valores por formato en un solo archivo.
Reglas del motor (determinismo)
El filme es una función pura de t. Cualquier fotograma debe pintarse igual tanto si se renderiza primero como después de cualquier otro fotograma.
- Solo transformaciones 2D: nada de
translate3d,will-change, transiciones CSS,Math.random(usa un hash de un índice). - Elementos ocultos al inicio:
reg(el, {o: 0}), nuncaopacity:0en línea. - Mide el diseño en
after()o una vez enbuild, nunca dentro derun(lee el fotograma anterior). - Vistas 3D: reinserta cada fotograma con
insertBefore(v, firstChild)para que no sobreviva ningún raster en caché. - Animaciones CSS incrustadas (ej. el widget de un producto): pausa y establece
animation-delay: calc(-1s * var(--t)). - Espera imágenes y fuentes (
decode(),document.fonts.ready) antes del primer fotograma. - Limita el CSS del producto bajo una clase raíz única; usa nombres de clase únicos en el filme (
.wse filtró una vez). classList.add, nuncaclassName =.node scripts/render.mjs --verifydebe imprimir 12/12 antes de cualquier render que envíes.
Realismo: lee references/realism.md antes de construir cualquier pantalla
Versión corta: apps reales a densidad real, logos reales de sitios propios de las marcas, chrome del SO con apps que existen en ese SO, fondos de pantalla reales, teléfonos en la cuadrícula real del launcher a tamaños dp reales dibujados por el propio renderizador del producto, UI del producto más rica de lo que crees necesaria, una línea de uso nominativo cada vez que aparece una marca.
Bucle de construcción (guiado por revisión)
- Lista de planos del storyboard aprobado en
film.js, unshot()cada uno, superpuestos para traspasos. - Primero fotogramas fijos.
node tools/probe.mjs cuts→ renderiza un fotograma fijo en cada punto medio de plano y en cada traspaso:node scripts/render.mjs --at …luegopython3 tools/sheet.py review/stills/16x9 review/sheet.jpg <times>. Lee tú mismo la hoja. Corrige. Repite. (Unos 1–2 min por vuelta, vs 25+ para un render completo). - Pase de control de calidad ANTES de cualquier revisión que envíes: recorre el filme a ≤ 1.5 s y en cada traspaso (hoja de contactos de 10–15 fps sobre cada transición). Revisa
references/qa.mdlínea por línea: solapamientos, recortes, fotogramas en blanco, tiempo de lectura, suavidad del texto, escritura, aviso de logo, realismo del SO, tamaños de teléfono. - Envía fotogramas fijos (la hoja) al propietario para la primera verificación. Espera.
- Borrador:
node scripts/render.mjs --draft(30 fps, ~4 min),python3 scripts/review.py 1 --draft, lee las tiras. Envía el MP4 borrador. Di claramente que es un borrador de 30 fps sin desenfoque (se ve más entrecortado que el final). - Al "render final":
node scripts/render.mjsen segundo plano (60 fps, motion blur; ~25–35 min para 60 s). Nunca editesfilm.jsmientras renderiza: copia primero el proyecto si necesitas seguir trabajando. - Haz commit del código del filme y de la línea de tiempo después de cada ronda aprobada.
Ritmo
Los primeros cortes casi siempre son demasiado rápidos. El texto en pantalla necesita aprox. 0.3 s por palabra + 1 s a opacidad completa (nunca menos de 1.5 s). Prefiere el warp (SLOW 1.1–1.25, EV mantiene en líneas) a reajustar cada plano. Después de cualquier cambio de ritmo, vuelve a ejecutar probe.mjs cuts porque las posiciones de sonido y voz se mueven.
9:16: lee references/formats.md
Reencuadra el mismo filme en un archivo con pk(); prueba que el 16:9 no cambia con tools/same.sh (cada fotograma fijo PSNR = inf); --verify --fmt 9x16; hoja de fotogramas para el propietario; luego final --fmt 9x16 en segundo plano, luego --mux --fmt 9x16.