stage3d shorts
Un escenario oscuro con suelo espejo. Figuras píldora blancas planas, accesorios dibujados con líneas de neón, un foco teatral sobre la persona, una cámara que se mueve en 3D real, una palabra de subtítulo a la vez. El estilo fue obtenido mediante medición inversa a partir de videos de referencia (material de estudio privado: nunca copiar su contenido, nombres o guiones) y luego mejorado.
Estado: v0.1. Probado en un clip de 9.7 s con dos estaciones (pricetag_demo) y una prueba de 5 s (test5). Aún no probado en un video de duración completa. Lea "Lo que el kit aún no tiene" antes de prometer una escena.
La idea
- El kit es el estilo.
kit/src/contiene colores, brillo, lente, suelo, luz, curvas de cámara, subtítulos. Un video nunca lo edita. - Un video es un plan.
kit/plans/<nombre>/plan.jsdice qué hay en el escenario, cuándo sucede cada cosa y cómo se mueve la cámara. Solo importakit/src/api.js. La compilación rechaza un plan que acceda al estilo. - Los números deciden, no las opiniones. Cada renderizado se mide con
scripts/qa.py. Un video que falla no se entrega.
Dónde vive el kit
Esta habilidad es solo instrucciones. El código que dibuja el video y los archivos de referencia están en una carpeta en la PC de Pimbo: C:\Users\Pimbo\work\anymation\stage3d\skill (contiene kit/, references/ y una copia de este archivo). Cada ruta en esta habilidad es relativa a esa carpeta.
- La carpeta
anymationdebe estar conectada a la conversación. Si no lo está, pídale a Pimbo que la conecte: sin el kit no se puede hacer ningún video, y nada aquí debe reconstruirse de memoria. - Pimbo no ejecuta scripts manualmente. Usted los ejecuta. Él da el tema o la carpeta del video, mira los fotogramas y aprueba.
- Las entradas de un video provienen de su propio pipeline:
anymation/v2/v8/<video>/(script.json,asr_<lang>.jsonpara los tiempos de palabras,premix_<lang>.wavpara voz y música,events_<lang>.json). - Si puede ejecutar comandos en su PC, trabaje en la propia carpeta. Si solo tiene un espacio de trabajo en la nube: copie
stage3d/skilldentro (deje fueranode_modules,outydist), ejecutenpm installdentro dekit/, escriba el plan y renderice fotogramas allí (aproximadamente 2 s cada uno sin tarjeta gráfica), muéstrele los fotogramas, luego escriba la carpetakit/plans/<nombre>/terminada de vuelta en su carpeta. - El renderizado final pertenece a su PC: su tarjeta gráfica es aproximadamente 20 veces más rápida que una máquina en la nube. Si no puede ejecutar comandos allí, deje un archivo
.cmdenstage3d/skillque ejecutenode scripts\make_video.cjs <nombre> --gpu --workers=4desdekit, pídale que haga doble clic y que pegue lo que imprime. Lea las líneas de QA antes de dar el video por terminado.
Reglas que no son negociables
- Nunca edite
kit/src/para que funcione un solo video. Si falta un accesorio o un tipo de toma, agréguelo al kit como parte reutilizable (veareferences/PLAN_GUIDE.md, "Agregar un accesorio") y vuelva a verificarpricetag_demodespués. - Cada número de fotograma en un plan proviene del audio real (tiempos de palabras), nunca de una suposición.
- Cada movimiento de cámara tiene una razón que se puede decir en una oración. Escriba esa oración como un comentario encima del movimiento.
- Mire los fotogramas antes de renderizar un clip. Mire la imagen, no el código de salida.
- Diga qué se midió y qué se asumió. Si no verificó algo, dígalo.
- Una persona escucha el audio antes de que salga un video: estos scripts establecen niveles mediante números.
Pipeline
Trabaje dentro de kit/. Primera vez en una máquina: npm install (three, esbuild, playwright-core; usa el Chrome o Edge instalado, no se descarga nada más). El renderizado necesita ffmpeg en el PATH; QA necesita Python con numpy y opencv (pip install numpy opencv-python); los scripts de audio necesitan scipy.
| Paso | Qué | Comando o archivo |
|---|---|---|
| 1 | Guión y voz, con un tiempo para cada palabra | fuera de esta habilidad; resultado: words.json = [{ w, t0, t1, line }], segundos |
| 1b | Verifique cada hecho del guión el mismo día, antes de grabar la voz | búsqueda web; escriba SOURCES.md junto al plan (ejemplo: plans/no_trick/SOURCES.md) |
| 2 | Divida el guión en estaciones: una oración o idea cada una | notas al inicio de plan.js |
| 3 | Escriba el plan: construir, animar, cámara | kit/plans/<nombre>/plan.js; comience desde pricetag_demo |
| 4 | Audio: mezcla base más efectos en los eventos | kit/plans/<nombre>/make_audio.py -> audio.wav |
| 5 | Verifique y compile | node scripts/build.cjs <nombre> |
| 6 | Fotogramas en los fotogramas clave; corrija el encuadre; repita | node scripts/render.cjs <nombre> stills 0,17,62,88 |
| 7 | Véalo moverse con sonido | abra kit/dist/<nombre>/preview.html en un navegador |
| 8 | Renderice, codifique, QA de una vez | node scripts/make_video.cjs <nombre> --gpu --workers=4 |
| 9 | Lea las líneas de QA; un FALLO significa corregir y repetir | kit/out/<nombre>/logs/qa.log, qa.json |
El paso 8 imprime una línea por paso. En una PC con tarjeta gráfica, un video de 5 s toma aproximadamente 10 s; sin una (omitiendo --gpu) cada fotograma toma aproximadamente 2 s, así que renderice allí solo lo necesario.
Escribir un plan, en resumen
Guía completa y lista de partes: references/PLAN_GUIDE.md. El ejemplo trabajado es kit/plans/pricetag_demo/plan.js.
- El escenario es una fila de estaciones separadas 14 m. Una oración o idea por estación. La cámara permanece en una estación para una toma y hace un barrido panorámico a la siguiente entre oraciones.
build(stage)crea las cosas y las coloca:stage.station(i).add(thing). Las figuras reciben un foco:stage.station(i).spotlight(figure).animate(f, o)establece dónde está todo en el fotogramaf. Debe ser una función pura def: los fotogramas se renderizan en cualquier orden y en paralelo. Sin estado de un fotograma al siguiente, sinMath.random, sin reloj.- Las cosas aparecen en su palabra:
pop(thing, f, wordFrame). Un número que importa se ejecuta mientras se habla de él. Algo que aterriza recibe un anillo de suelo (pulse), un breve destello (flare) y un sonido. - Colores solo por nombre. Oro = la cosa valiosa. Rojo = precio, costo, peligro. Blanco = personas y etiquetas neutrales.
- El texto que cambia (un contador) necesita
maxCharspara que su cuadro no se redimensione.
Cámara, en resumen
Reglas completas con las mediciones detrás: references/CAMERA_RULES.md.
- Una toma tiene un movimiento, a veces dos o tres. Entre movimientos la cámara sostiene (el kit agrega un desplazamiento lento).
- Solo existen tres tipos de movimiento:
hook(acercamiento inicial, desde el fotograma 0),reframe(20-28 fotogramas, entre dos oraciones, aterriza unos fotogramas antes de que aparezca la nueva cosa),slow(un acercamiento u órbita a lo largo de una toma completa). - Mientras un gráfico se anima, la cámara sostiene. Una lista obtiene un recorrido; una afirmación más amplia obtiene un alejamiento; un objeto para una línea larga obtiene una órbita lenta.
- Una vista 3/4 (guiñada alrededor de 35-40 grados) es la que muestra profundidad. Úsela cuando un segundo objeto necesite espacio.
- Los barridos panorámicos solo entre ideas. Cada uno necesita un silbido en el audio que comienza aproximadamente 3 fotogramas antes.
Puertas de calidad
scripts/qa.py falla el video si: falta un fotograma o está congelado; el fondo no es el negro elevado; el hook o un reframe no están cargados al frente; la cámara no sostiene entre movimientos; un barrido panorámico no se mueve o no se oscurece; el MP4 no es h264 / yuv420p / BT.709, tiene el número incorrecto de fotogramas, o su audio falta o tiene la longitud incorrecta.
No verifica el gusto, el recorte en los bordes del fotograma, o que los subtítulos digan las palabras correctas. Esos se verifican en los fotogramas, a ojo, antes del renderizado: nada importante cortado por el borde del fotograma, la banda de subtítulos (75-83 % de la altura) libre de líneas brillantes, figuras entre el 25 % y el 85 % de la altura (la lente estira las cosas cerca de los bordes).
Después de cualquier cambio en kit/src/: reconstruya pricetag_demo, renderice los fotogramas 0,17,88,150,174,236 y compárelos con references/frames/. En renderizado por software deben coincidir exactamente; en una tarjeta gráfica, dentro de aproximadamente 1 nivel.
Lo que tiene el kit
Figura (persona píldora con auriculares), píldora de etiqueta, tarjeta con una etiqueta y un valor grande, token, cofre que se abre (oro, o uno gris liso para una multitud de cofres), brújula redonda con aguja, tira de brújula de una pantalla de juego, marco de contorno (una pantalla, una miniatura), dado, botón de reproducción, marcas de conteo, guía discontinua, imagen (un SVG o PNG en blanco y negro dibujado como luz), anillo de suelo, línea de suelo discontinua, motas flotantes, foco teatral con piscina de suelo y sombra, piscinas de suelo de colores, halo, rayos, chispas, barrido panorámico con desenfoque de movimiento, subtítulos, una biblioteca de sonidos (silbido, tic, ding, golpe sordo, clunk, chisporroteo, burbujeo) y un mezclador que coloca un archivo de voz y un archivo de música debajo.
Dos planes para leer: pricetag_demo (10 s, dos estaciones, el estilo aprobado) y no_trick (47 s, cinco estaciones, un corto completo con su voz, música y fuentes). starts_clean (62 s, seis estaciones) es blanco hasta un único pago de oro, como lo piden las reglas del guión de Pimbo. avatar no es un video: crea fotogramas para una foto de perfil.
Lo que el kit aún no tiene
- Un recorrido a lo largo de una fila de cosas (para listas), barras y gráficos de líneas.
- Más de un foco en una estación: no probado (las motas están iluminadas por como máximo dos focos a la vez). Varias figuras en una estación funcionan con un foco y las demás atenuadas (
no_trick, estación 2). - Fundidos o cortes: la única transición es el barrido panorámico.
- Primeros planos: la cámara necesita el suelo debajo de su sujeto dentro del fotograma y pierde su objetivo a menos de aproximadamente 2 m. Una imagen más cercana se recorta de una más amplia (
plans/avatar). - Más de los tres tipos de movimiento, y cualquier giro de cámara.
- Voz, música y tiempo de palabras: vienen de fuera (el pipeline
v2/v8de Pimbo los crea).
Cada uno de estos debe construirse en el kit y probarse en un video real antes de que un plan pueda usarlo.
Archivos
| Ruta | Qué es |
|---|---|
kit/src/ | El estilo. api.js es el único archivo que importa un plan |
kit/plans/<nombre>/ | Un video: plan.js, words.json, make_audio.py, audio.wav |
kit/scripts/ | build.cjs, render.cjs, encode.cjs, make_video.cjs, qa.py |
kit/audio/sfx.py | Efectos de sonido y mezclador |
references/STYLE_BIBLE.md | Cada número del estilo, etiquetado medido, nuestro o suposición |
references/CAMERA_RULES.md | Cómo se edita la cámara, con las mediciones |
references/PLAN_GUIDE.md | Cómo escribir un plan; cada función de api.js; agregar un accesorio |
references/KNOWN_ERRORS.md | Errores ya cometidos una vez, y lo que ahora previene cada uno |
references/frames/ | Fotogramas de destino de pricetag_demo |