Film promocional de producto, renderizado como código
Una página, un canvas, y seek(t) dibuja el fotograma en el tiempo t desde cero. Chrome Headless captura N subfotogramas por fotograma, ffmpeg los mezcla y codifica. El film es una función; el video es un muestreo de ella, lo que hace que cada fotograma sea revisable, cada cambio sea barato y el bucle exacto.
Estos archivos se envían con este skill. Cópialos en la carpeta de trabajo del film; no reescribas el motor.
| Archivo | Qué es |
|---|---|
template/promo.html | El motor más una demo de 8 segundos: resortes de forma cerrada, pistas de suma de resortes, una cámara, ayudas de texto (cifras tabulares, giros), titulares, un cursor real, una cadena de morph de un objeto y un compositor WebGL para 3D real. Se abre y renderiza tal cual. |
template/reel.html | Un film largo en una línea de tiempo: seis escenas, seis formatos (tipografía cinética, un navegador, una cuadrícula bento con enfoque selectivo, una terminal, un cover-flow 3D de dispositivos, una tarjeta final), cinco transiciones, un look por escena, capítulos. ~56 s, no es un bucle. El catálogo de §2, en ejecución. |
template/film.js | El motor que comparten las páginas: el escenario (jitter subpixel por subfotograma, para que nada se escalone o brille en movimientos lentos), FILM.draw para rasters, resortes y cámaras, la línea de tiempo (escenas, capítulos, puntos de control y veinticuatro transiciones: dieciséis en el canvas 2D, ocho como shaders de fragmento en un contexto WebGL2) y efectos (profundidad de campo, texto knockout, escritura). Documentado al inicio. |
template/parts.js | Partes vectoriales: una ventana de macOS, un navegador, una terminal, un iPhone, un iPad, una MacBook, un iMac, teclas, un interruptor, un anillo, un botón, el puntero. Cada una devuelve el rectángulo donde va su contenido. |
template/parts.html | Cada parte en una hoja 16:10, una página como las demás: PAGE=parts.html node render.mjs stills parts 0 hace el PNG del que se convierte docs/parts.jpg (sips -s format jpeg -s formatOptions 92). |
template/fx.js | El look, cargado por la página: un fondo (liso, degradado, campo o imagen; luz suave de marca; puntos, cuadrícula o líneas en paralaje; un suelo en perspectiva; un foco), un acabado (viñeta, grano) y los efectos que se apoyan en él (vidrio esmerilado, ondas de clic, titulares con enfoque selectivo). Veintitrés preajustes y photo, cada campo sobreescribible, documentado al inicio del archivo. Compartido con release-film. |
template/type.js | Titulares y tipografía cinética (§3): TYPE.draw(ctx, t, spec) en trece estilos — rise, focus, settle, track, wipe, cascade, weight, split, flap, type, swap, odometer, decode — con una marca de énfasis, un ritmo y TYPE.load para las caras de una familia. Una función pura de t, como el resto. |
template/fonts/ | Veinte familias con licencia abierta (latin + latin-ext woff2, cada una con su OFL.txt) y fonts.json, sus caras. Un film copia solo lo que usa en src/fonts/; scripts/fonts.mjs add obtiene otra. |
scripts/render.mjs | stills <dir> t…, sheet <dir> (los puntos de control de la línea de tiempo), looks <dir> <t>, loopcheck, video <out> [workers]. Lee el tamaño, fps, duración y capítulos de la página; aplica jitter a cada subfotograma; renderiza en fragmentos reanudables; FROM/TO, PREVIEW=1, RESUME=1, KEEP=1, AUDIO=, SHUTTER=; la extensión elige el formato (.mp4, .mov ProRes, .webm, .gif; HEVC=1; ALPHA=1 para un .mov o .webm transparente); verifica la pista antes del renderizado y el archivo después; falla en una captura cuya página perdió un contexto WebGL, y en un segundo renderizado de un corte mientras uno se ejecuta. Documentado al inicio. |
scripts/narrate.mjs | La historia de un film (story.json: una frase por paso, la de un tutorial o un promocional que habla) en una voz, un reloj y subtítulos: voice/*.aiff, narration.wav (el AUDIO del film), narration.js (el tiempo de cada paso, para la página) y captions.srt / .vtt. El say de la Mac, o --from una carpeta con tus propias grabaciones. "human": "natural" varía las pausas como lo haría una persona; los sonidos de un modelo ([risa]) se mantienen fuera de los subtítulos. Documentado al inicio. |
scripts/voice.mjs | La misma historia contada por un modelo de voz que se ejecuta en la Mac ("mlx" en story.json: Chatterbox para una lección, Orpheus para un promocional, Kokoro para un borrador rápido o un film en italiano), más cercano a una persona que say: dice cada paso (voice-mlx.py, a través de mlx-audio), lo ritma y nivela, luego llama a narrate.mjs. Una toma es una semilla; "tone" (calm, warm, bright) es cuán libremente lee el modelo, "human" varía el ritmo de cada línea dentro del 3 % y permite que una línea haga un sonido ([risa], [suspiro]: la ortografía de cada modelo, o se omite). --audition compara tomas, --recordings se detiene en las grabaciones, --setup hace el Python y obtiene los modelos una vez en cada Mac (voice-constraints.txt fija lo que instala) y dice si esa Mac repite las tomas grabadas aquí. Documentado al inicio. |
scripts/mix.mjs | Una voz y una pista de música en una banda sonora, para AUDIO=: ambas medidas (EBU R128), la música --under LU por debajo de la voz mientras habla, --lift dB arriba entre líneas, baja antes de que cada línea comience; imprime lo que salió, medido en el resultado. Documentado al inicio. |
scripts/contact.mjs | Una hoja de contacto con subtítulos de una carpeta de fotogramas o looks (subtítulos de labels.json en ella); --size WxH la hace exactamente de ese tamaño (--font, --gap, --pad; los fotogramas nunca se recortan; un .jpg se escribe como JPEG); --dark para una hoja oscura. --compare A=<dir> B=<dir> [C=<dir>] <out.png>: dos o tres carpetas lado a lado, una columna etiquetada cada una y una fila por fotograma que compartan, para una elección A/B en una imagen. |
scripts/beats.mjs | El ritmo de una banda sonora, a partir de sus muestras: el tempo, si se mantiene, cada pulso, los compases, las secciones, y el bpm y AUDIO_AT para dar a la página; --out beats.js para una página que sigue una pista que se desplaza (FILM.beats). render.mjs lo importa para medir los pulsos de la página contra los de la pista. --selftest. |
scripts/clickcheck.mjs | ¿Se ve cada clic?: para cada uno de los CLICKS de la página, qué tan rápido se mueve el punto clickeado en pantalla y qué distancia recorre el cursor antes de la presión y durante ella. Sale 1 en un clic que nadie verá (release-film §3b), 2 en una página sin cursor. |
scripts/layoutcheck.mjs | ¿Está cada titular en el marco, separado y legible?: en cada punto de control, cada titular que TYPE.draw dibuja, contra el área segura, los otros titulares y el fondo a su alrededor (los límites están en su encabezado). Sale 1 en un titular que falla, 2 en una página que no dibuja ninguno a través de TYPE.draw. |
scripts/deliver.mjs | El último paso (§8): los videos terminados y sus carátulas salen de la carpeta de trabajo a una carpeta propia; una vez que el film está listo, trash tira la carpeta de trabajo después de verificar que su fuente está segura en el kit. --selftest. |
scripts/fonts.mjs | Las fuentes del kit: add "<Familia>" [ejes] desde Google Fonts con su licencia, check, list. |
Además de ellos, studio/ (el Estudio, abajo), guide.md (el modo guiado, abajo) y README.md
(el catálogo en imágenes, y ejemplos de solicitudes para cada momento de un film).
Configuración: una carpeta de trabajo, ~/Downloads/<nombre>-trabajo/ (~/Downloads es la raíz de trabajo a menos que workRoot en el archivo de configuración, abajo, diga lo contrario), con la página y estos archivos en su src/,
y npm i playwright-core allí. Impulsa el Chrome instalado a través de channel: 'chrome', así que
no se descarga nada más. <nombre> es <producto>-<qué> (acme-promo,
acme-2.4-whats-new), y nombra la carpeta de entrega y cada archivo entregado también (§8).
Estudio: el brief en una ventana
La entrada visual. Un asistente en una ventana propia: recetas, formatos, looks, imágenes
desde la Mac, tipo y movimiento mostrados en movimiento en el motor real, en el color y aspecto del producto,
el sonido (las pistas de la biblioteca de música reproducidas, la voz de un modelo de voz escuchada diciendo una línea antes de que sea
elegida), y cada elección escrita en un brief.json. No se instala nada y no se renderiza nada.
/manovella:studio también lo abre.
-
Cuándo: invocado con
studio, o sin nada mientras nada en la conversación dice qué film hacer. Un usuario que ha dicho lo que quiere en palabras va directamente a §0. -
Ejecuta
node <directorio de este skill>/studio/studio.mjsdesde el espacio de trabajo, en segundo plano (sus repositorios hermanos son los productos ofrecidos), y di en una línea que la ventana está abierta. Sale por sí solo, imprimiendo una línea, y la salida te despierta:BRIEF <ruta>, oCANCELLED,CLOSED,TIMEOUT(dilo y detente). La ventana es la propia aplicación del Estudio donde esta Mac la ha construido (~/Applications/Manovella.app, su nombre, versión e icono en el Dock), de lo contrario una ventana de la aplicación Chrome;MANOVELLA_WINDOW=chromemantiene Chrome. Sin ninguno de ellos abre el navegador por defecto;--no-openimprime la URL en su lugar, para una sesión cuya pantalla está en otro lado. -
La biblioteca de música es opcional: una carpeta con la música de los films del usuario, guardada donde sea que les guste (una unidad sincronizada, una carpeta de proyecto). Está donde apunta
MANOVELLA_MUSICpara una ejecución, de lo contrariomusicLibraryen~/Library/Application Support/manovella/settings.json(~/.config/manovella/settings.jsonfuera de macOS; un~inicial se expande);musicLibraryIgnoreen el mismo archivo enumera nombres de carpeta que saltar, ydeliverToLibrary(true o false, por defecto false) dice si los films terminados también van a ella. Nada se detecta automáticamente. Un archivo anterior conbrandLibraryybrandLibraryIgnorese lee comomusicLibraryymusicLibraryIgnorecondeliverToLibraryactivado, lo que hacía antes, y se reescribe con las nuevas claves en el primer cambio realizado en la Configuración del Estudio. El mismo archivo tomaprojectFolders(donde el Estudio busca productos),pictureFolders(sus imágenes de fondo; sin establecer:~/Pictures) yworkRoot(donde van<nombre>-trabajoy, a menos que el film se entregue en la biblioteca o el proyecto tenga una instrucción,<nombre>/; sin establecer:~/Downloads); la ventana de Configuración del Estudio (el engranaje junto al logotipo, o ⌘, enManovella.app) escribe todas ellas, ydeliver.mjsleeworkRoottambién. Nada más en el código lee las claves de la biblioteca: para un film hecho sin el Estudio, este párrafo es la instrucción para mí.- El Estudio ofrece cada archivo de audio (mp3, m4a, aac, wav, aiff, flac, ogg) en el nivel superior de la biblioteca
y en cada carpeta dentro de ella, directamente o en la carpeta
audio/de esa carpeta; las carpetas ocultas y los nombres enmusicLibraryIgnorese saltan. Una carpeta por marca es opcional y agrupa sus pistas; la carpeta nombrada después del producto se enumera primero ("de este producto"). Un archivo de notas opcional junto a las pistas (…notes.txto.md: un párrafo por pista, comenzando con el nombre del archivo de la pista: qué es, su estado de ánimo, dónde encaja) dice para qué sirve cada una, y el Estudio lo muestra. - Films terminados: con
deliverToLibraryactivado y una biblioteca establecida,<biblioteca>/<Marca>/video/<nombre>/(§8); de lo contrario, donde las instrucciones del propio proyecto guardan los medios terminados, si no<nombre>/en la raíz de trabajo (~/Downloads/<nombre>/por defecto). - Una nueva pista que se ha hecho (abajo) se guarda en la biblioteca, en la carpeta del producto cuando
la biblioteca mantiene una por marca, con su párrafo en el archivo de notas de esa carpeta, cuando existe una
biblioteca; de lo contrario, solo va en el
src/audio/del film. Una carpeta en un proveedor de archivos (Google Drive, iCloud Drive, Dropbox) puede mantener sus archivos "sin datos" hasta que se abran, así que abre o copia un archivo antes de medirlo. Los archivos que una biblioteca guarda se copian, nunca se mueven fuera de ella.
- El Estudio ofrece cada archivo de audio (mp3, m4a, aac, wav, aiff, flac, ogg) en el nivel superior de la biblioteca
y en cada carpeta dentro de ella, directamente o en la carpeta
-
brief <ruta>, como argumento o desde una líneaBRIEF: lee el brief; responde §0.-
formats: []es mi elección de tres. Para un promocional o un film en capítulos, uno, dos o tres nombrados son los formatos de los storyboards, en ese orden, y yo elijo el resto, cada uno diferente; el formato de un release y el de un tutorial es el suyo (whatsnew,tutorial), nunca se llena.look: nulles la hoja de looks (§4). -
frame: en qué se muestra el producto, sea cual sea el formato;nulles el formato propio de cada uno (un navegador para un walkthrough, una terminal para una línea de comandos, una ventana de Mac para un tutorial), mi elección.window: la aplicación en su ventana de macOS (PARTS.window).macbook: una MacBook de frente, la ventana de la aplicación o el navegador del sitio en su pantalla (PARTS.laptop,PARTS.notchdibujado al final).imac: un iMac de frente, en su soporte, la ventana de la aplicación o el navegador del sitio en su escritorio (PARTS.desktop: su rect es el cuerpo, 547 : 375, y el soporte se dibuja debajo;colores uno de los siete de Apple, o el acento de la marca para el más cercano de ellos). Sin notch: la cámara está en el bisel blanco.iphone,ipad: el dispositivo (PARTS.phoneconPARTS.islanddibujado al final;PARTS.tablet, acostado o vertical por su rect, la cámara en su borde largo), el diseño propio del producto en él (§1), y cada clic un toque: un disco suave que presiona, con la ondulación del look, nuncaPARTS.ARROW; un tutorial dice tocar.browser: el producto como una página enPARTS.browser, su dirección real en el campo.terminal:PARTS.terminal, escrito conFILM.typed.bare(el Solo la UI del Estudio): la UI del producto por sí sola, un panel flotante con esquinas redondeadas y una sombra, sin cromo de ventana ni dispositivo alrededor. El producto todavía está en pantalla: un film sin ninguno es el formato Tipografía cinética, no este.
El marco se mantiene para cada escena que muestra el producto, en cada storyboard: un tutorial de una aplicación de iPhone se cuenta en un iPhone desde su primer paso hasta su último. Un formato que es en sí mismo una superficie se adapta a él: Browser walkthrough con
iphonees el sitio en el teléfono a ese ancho; Terminal conmacbookoimaces la ventana de la terminal en el escritorio de la Mac. Dispositivos en 3D es el único formato que muestra varios: el dispositivo elegido lidera el cover-flow (la primera tarjeta en mirar a la cámara, y a la que vuelve), y los demás lo siguen. Donde el marco y un formato chocan, gana lo que la persona que lo pidió espera ver: es un promocional de producto, no una demostración de la máquina: un film de pantalla sin marco es Just the UI. -
palette: un array de seis o siete colores, del brief, o de la marca, o de una imagen; el primer color es el fondo, el segundo es el acento, y el resto aparece en el look y el texto. Los looks de la hoja lo usan. El Estudio muestra un selector de color que devuelve una imagen o un color hexadecimal, y no acepta un blanco o un negro puro, sino los de la paleta. -
model: el modelo de voz elegido;voicees el ajuste del modelo (más grave o más agudo en pasos de semitono, o"original"),toneescalm,warm,bright(onaturalpara"human": "natural", no"mlx");pacees el ritmo de las líneas (slow, normal, fast).musices la pista elegida: su ruta de la biblioteca, o el nombre de un archivo ensrc/audio/(y"theme"y"mood"de su párrafo de notas, para conocimiento; no se usan más).mixes"under": -20, "lift": 6o un ajuste personalizado en el Estudio.revoicees el Repite conmigo que dice "lo haré de nuevo" después de escuchar la voz del usuario en la línea de los subtítulos, dejado fuera de los reales; los desarrolladores lo usan para grabaciones reales (§3c). -
silence:true(sin voz, sin música),music(solo música),voices(voces sin música),"music+voice"(ambas). El predeterminado del Estudio es la elección del usuario, guardada en las configuraciones. -
scenes: un array de escenas, cada una conname, cada una constory: [{caption, action, format, frame?, cursor, click?}](§0–2, en una sola lista cuando el formato es uno solo, por escena cuando no). Cada paso opcionalmente tieneid, y el último paso de una escena es opcionalmente un capítulo. El botón de reproducción del storyboard pone el cursor al inicio de la escena; el botón de reproducción alrededor de cada paso pone el cursor en el primer fotograma de ese paso. Los storyboards están en el archivo del brief, y cada escena tiene su aspecto de los creators del storyboard de la hoja, no del mío, a menos que yo haga esa hoja.- El formato es la superficie de toda la escena cuando es fijo; cuando no lo es, cada paso puede
elegir el suyo, y el fondo cambia con él (una demora que el Estudio muestra cuando se pasa el cursor
por encima). La Tipografía cinética es el formato en el que el producto no se ve. El formato de un
Walkthrough es
browser(§2a); Línea de comandos esterminal(§2b); Aplicación es una captura de pantalla (§2c); Mosaico es una cuadrícula (§2d). cursores el tipo de cursor del paso:arrow,beam,hand,none;pointeres un clic;dwelles tiempo de permanencia con un cursor redondo;tapes un toque en un dispositivo táctil;none, por defecto, es pulso por segundo, sin cursor (el clic sigue estando).clickes una etiqueta opcional que nombra la acción, mostrada en la nota del paso en el storyboard y como parámetro de cursor (y no hay transliteración).
Un brief sin storyboards (solo
scenes: []) es una historia que tengo que construir a partir del brief y las imágenes de la Mac, una historia en $\approx$10–40 pasos, detallada en el espacio de descripción del paso de §1 y sin requerir una fuente de comandos de mi parte: el agente del Estudio no ejecuta comandos. - El formato es la superficie de toda la escena cuando es fijo; cuando no lo es, cada paso puede
elegir el suyo, y el fondo cambia con él (una demora que el Estudio muestra cuando se pasa el cursor
por encima). La Tipografía cinética es el formato en el que el producto no se ve. El formato de un
Walkthrough es
-
storyboard: false (hecho: el usuario ha terminado con el storyboard), null (el usuario no tiene storyboards, así que el Estudio no los ofrece), o un array de arrays con las filas y columnas del storyboard, dibujado y recortado como un canvas de storyboard: formato, encuadre, texto de paso, notas y dimensión, un 35 mm dibujado en cada fotograma. El Estudio coloca estos arrays en el archivo del brief cuando se cambia al modo de revisión.
El brief sigue hasta la línea de tiempo (§5).
-
Modo guiado
Cuando no sabes qué hacer, pide ayuda. El flujo de trabajo está en guide.md: cada paso,
su comprobación y su salida, en secuencia. El modo guiado se invoca con ? y luego el número del paso
(?3), o ? solo para el siguiente paso. ?? imprime la guía completa. Cada paso tiene
un comando de ejemplo.
- Brief: qué hacer. Sin esto, no hay film. Lee el brief (§
brief.json), o pregúntale al usuario: qué producto, qué formato, qué historia. Escríbelo, resúmelo en una línea que lleve al siguiente paso. - Historia: una historia por formato. Si
brief.jsontiene escenas, ve a §2; de lo contrario, escribe una secuencia de pasos, cada uno un paso del usuario a través del producto: una línea por paso, el formato, el encuadre, el cursor y un vistazo de lo que se ve. Dibújala como storyboards en una página que se pueda ver. La salida:BRIEF <ruta>escrita arriba (el archivo del brief con las escenas) ystoryboard.htmlcon la página de storyboard. Comprobación: el usuario la ve y la confirma o la edita. - Página: el HTML en el que se renderiza el film. Una página html por escena, escenas y transiciones
en la línea de tiempo:
<canvas>en un<div>que llena la ventana,<link>al look,<script>al motor y a la página. No hay HTML compartido: cada escena es autónoma. Compilada ensrc/<escena>.html. La salida: la página que se renderiza por sí sola. Comprobación: se abre (open src/<escena>.html) y reproduce. - Motor: los datos de la escena y el control. Escribe las transiciones, los capítulos, los controles
de cursor (posición y clic). Prueba:
seek(0)aseek(duration)ensrc/<escena>.htmlmuestra cada paso. Narración: añade una pista de voz. El Estudio maneja las preguntas de voz; aquí, maneja el archivo de narración y el archivo de audio. - Look: el color y el sentimiento. Elige una paleta del
brief.jsono pregúntale a la Mac (elige una imagen y extrae los colores). Escribe el look: el fondo, el acabado, las fuentes, el tamaño del texto. Prueba:PAGE=<escena> node render.mjs stills <escena> 0.5hace un fotograma en el medio de la escena. Muestra cuatro o cinco looks, uno por escena, y el usuario elige. - Línea de tiempo: el ritmo. Escribe los tiempos de escena, los capítulos, los puntos de control.
Renderiza:
node render.mjs sheet <escena>imprime la hoja de la línea de tiempo con los tiempos. Aprueba. - Renderizado: haz el video.
node render.mjs video <out>.mp4desde la carpeta de trabajo. La salida: el archivo de video. Comprobación:open <out>.mp4. - Entrega: mueve el video fuera de la carpeta de trabajo.
node scripts/deliver.mjs(el último paso). La salida: un archivo en la carpeta de entrega, y la carpeta de trabajo se tira a la basura. - Hecho: el film está listo. Resúmelo: qué se hizo, qué formato, qué duración, y qué hacer a continuación.
El modo guiado no sustituye a la lectura de los archivos de la plantilla: las opciones de render.mjs, los
parámetros de TYPE.draw, los efectos en fx.js y las partes en parts.js son el lugar donde buscar.
guide.md es el mapa; el código es el territorio.