¿Qué hace Animación Cinematográfica?
El carril premium junto a robloxmaxxing. Esa habilidad crea activos de juego y mundos explicativos brillantes y concurridos. Esta hace una película: pocos personajes, habitaciones oscuras, una lámpara, una historia que se puede seguir sin sonido, renderizada en Cycles (el aspecto de referencia) o EEVEE (el mismo aspecto en una fracción del tiempo, con las reglas en "Motor" más abajo).
SKILL = esta carpeta. B = /Applications/Blender.app/Contents/MacOS/Blender (5.1). BP = Python de Blender (/Applications/Blender.app/Contents/Resources/5.1/python/bin/python3.13), necesario solo para beatgrid.py. Otros scripts: python3 -I.
Lee una vez por sesión: references/craft.md (historia, planos, montaje, animación, sonido) y references/look.md (luz, materiales, lente, etalonaje, tiempo de renderizado). references/reference-films.md es la evidencia: ambas películas medidas plano a plano. Léelo antes de discutir un número en este archivo.
El aspecto en seis líneas
- Personajes de juguete, mundo real. Bloques con caras dibujadas; todo lo que los rodea fotorrealista, desgastado y a pequeña escala.
- Oscuro. Brillo medio del fotograma entre 0.10-0.26 del rango completo. Una lámpara visible es la clave. Sin luz de relleno, sin cielo.
- Altura del atrezo. La cámara se sitúa a nivel de mesa, cerca, con enfoque reducido y algo suave en primer plano.
- Los insertos llevan la historia. Manos, objetos, atrezo legible. Aproximadamente la mitad de los planos no tienen cara.
- Corte en la cuadrícula. La duración de los planos es de pulsos enteros o medios de la música. La velocidad cambia con la historia.
- El silencio es un plano. La música se detiene una vez, en el giro. El final es una cara o un objeto, luego negro.
Motor: Cycles o EEVEE
K.setup(..., engine="CYCLES" | "EEVEE"). Medido en un M4 a 1080x1920:
| motor | por fotograma | un carrete de 60 s (1440 fotogramas, dos procesos) | usar cuando |
|---|---|---|---|
| Cycles, 160 muestras | 70-90 s | 28-36 h | un fotograma principal, una portada, un teaser corto |
| Cycles, 16 muestras, 40% de tamaño | 11 s | 2 h (suave: una vista previa, no una entrega) | comprobando un corte |
| EEVEE, 64 muestras, tamaño completo, solo cargado el set del plano | 6-8 s | 1-1.5 h | la entrega de cualquier cosa que dure más de ~15 s |
EEVEE mantiene el aspecto (neblina, bokeh, plástico retroiluminado, AgX) si se siguen estas reglas. Cada una costó una ronda en Negara Angin:
- Llama a
K.eevee_lights(keep=(...))después de construir la escena. Solo las grandes luces motivadas proyectan sombras; muchas luces de sombra pequeñas desbordan el grupo de sombras y parpadean fotograma a fotograma. - Un panel de ventana es alfa, no vidrio. El vidrio de transmisión en EEVEE refracta el espacio de pantalla (lo que está detrás se mancha) y la transmisión combinada se renderiza en negro. Usa Principled alpha ~0.14,
surface_render_method = "BLENDED", caídas de reflexión + relieve. - EEVEE no puede enfocar a través de un panel. La profundidad de campo lee la profundidad de la superficie más cercana, por lo que todo detrás del vidrio se desenfoca como si estuviera en el vidrio. Muestra el panel solo mientras es el sujeto (
K.visible), ocúltalo una vez que el enfoque lo supere. - El vidrio no proyecta sombra (
eevee_lightslo hace): EEVEE lo trata como opaco, por lo que la luz a través de una ventana o un frasco se detendría. - Renderiza cada plano con solo su set cargado (
--sets): cada set cargado se evalúa en cada fotograma (campos instanciados, lluvia). En Negara Angin esto redujo el tiempo a la mitad. Dos trabajadores pueden recorrer la misma lista de trabajos;render_rangereclama fotogramas con archivos de bloqueo. - El desenfoque de movimiento y el tamaño de tesela de volumen cuestan poco; las muestras por encima de 64 no compran nada que un pase de grano no oculte.
- Cycles tiene cáusticas desactivadas: una luz detrás de un vidrio de ventana nunca llega a la habitación. Coloca la "luz de ventana" dentro del panel.
Pipeline
| etapa | hacer | puerta |
|---|---|---|
| 0. brief | logline, el bucle o cadena, el objeto de apuesta, paleta por ubicación, la pista y su BPM (beatgrid.py) | PUERTA B: cada línea del brief es algo observable |
| 1. plan de planos | planos como filas: tamaño, lente, qué se mueve, duración en pulsos; un maestro por escena | PUERTA S: las reglas en craft.md se mantienen en papel |
| 2. mundo + reparto | cine_kit: habitación/calle, atrezo, lámparas, neblina; figuras K.Char | fotogramas del maestro, describe cada uno en una frase |
| 3. luz | clave desde una lámpara visible, acentos, borde; still cada cámara a tamaño de previsualización | PUERTA L en el fotograma de cada plano (look_gate.py) |
| 4. actuación | poses en pulsos (hit, pose, face, talk), movimientos de cámara, life() | una hoja de contactos se lee como la historia sin sonido |
| 5. renderizado | render_range en 2-3 procesos, PNG de 16 bits, saltar existentes | recuento de fotogramas = duración de la película |
| 6. finalización | finish.py (brillo, etalonaje, suavizado, viñeta, grano) + mezcla de sonido | PUERTA L en la película, PUERTA E (shotlist.py --bpm), -14 LUFS |
Una puerta que falla se arregla en su propia etapa: un fotograma brillante es un problema de iluminación, nunca de etalonaje.
PUERTA B - el brief (un docstring al inicio del script de construcción)
- Logline en una frase con un deseo y un precio.
- Forma: un bucle que se acorta (regla mostrada una vez, luego repetida más rápido) o una cadena (cada escena termina en el objeto que inicia la siguiente).
- El objeto de apuesta: una cosa pequeña con una cara o un número (una foto, una factura, un billete). Donde la cámara se acerca a él.
- Paleta por ubicación: un color de luz dominante, un color de sombra, un acento. Diferente para cada lugar.
- Sonido: la pista, su BPM, dónde entra la música, los 3-8 s donde se detiene.
- Final: la última imagen (una cara o un objeto) y la o dos palabras en negro después.
- Exclusiones: lo que esta película no debe parecer.
PUERTA L - el aspecto (números de las referencias; scripts/look_gate.py)
| medida (0-1 del rango completo) | aprobado | referencias |
|---|---|---|
| brillo medio del fotograma | 0.10-0.26 | 0.20, 0.17 |
| nivel de sombra (percentil 10 del píxel) | por debajo de 0.09 | 0.06, 0.04 |
| nivel brillante (percentil 90 del píxel) | 0.22-0.56 | 0.46, 0.36 |
| pico (píxel más brillante) | por encima de 0.85 | 0.91, 0.98 |
| suelo negro | por debajo de 0.05 | 0.02, 0.02 |
| saturación | ámbar 0.10-0.30, negro 0.03-0.14 | 0.18, 0.07 |
Ejecútalo en el fotograma terminado de cada plano, luego en toda la película. Un solo inserto brillante puede ADVERTIR; un FALLO se arregla. "Pico por debajo de 0.85" significa que no hay un destello real en el fotograma: coloca una lámpara, un destello o un tubo de neón donde la lente pueda verlo.
PUERTA E - el montaje (scripts/shotlist.py film.mp4 --bpm N)
Cada duración de plano es un número entero o medio de pulsos. Plano promedio 1-3.5 s. Los dos primeros planos son los más largos de su escena. No hay dos planos consecutivos con el mismo tamaño y ángulo. Un tramo de 3-8 s no tiene música. La película termina dentro de un segundo de negro.
Construcción de una escena
"$B" -b --factory-startup -P build.py -- --out out --stills # un fotograma por plano, mitad de tamaño, unos 10 s cada uno
python3 -I "$SKILL/scripts/finish.py" out/still_master.png --out out/fin_master.jpg --look amber
python3 -I "$SKILL/scripts/look_gate.py" out/fin_master.jpg --look amber
"$B" -b --factory-startup -P build.py -- --out out --frames --final & # inícialo 2-3 veces: los fotogramas existentes se saltan
python3 -I "$SKILL/scripts/finish.py" out/frames --out out/film.mp4 --look amber --audio mix.wav
import sys; sys.path.insert(0, SKILL + "/blender"); import cine_kit as K
K.setup(aspect="16:9", height=1080, preview=True) # "9:16" para un reel; preview=False para la entrega
K.room(26, 22, 10); K.round_table("Table", 3.2, 2.9); K.pendant("Lamp", (0, 0, 6.5), power=2600, spot=125)
K.neon("Ring", (0, 10.8, 5.6), radius=1.7, color="#FFB020"); K.bokeh_lights("Shelf", ((-11, 10.2, 2.5), (11, 10.6, 8)))
K.light("TableBounce", "AREA", (0, 0, 3.05), 260, 2300, target=(0, 0, 9), size=4); K.haze((26, 22, 10), (0, 0, 5), 0.006)
hero = K.Char("Hero", skin="#F2C230", shirt="#20242C", hat="hair", at=(-4.5, 0, 0), yaw=90); hero.sit(1)
master = K.Cam("Master", (-2.2, -9.6, 3.1), (0.2, 0, 4.3), lens=28, stop=5.6)
cu = K.Cam("HeroCU", (-1.6, -6.2, 4.1), (-4.4, 0, 4.4), lens=50, stop=4, focus=hero.head)
S = K.cut_list([("master", master, 4), ("hero", cu, 2.5)], bpm=100); B = K.beats(100)
hero.hit(B(4.5), 3, head=(2, -60, -5)).face(B(4.5), "smirk"); cu.push(*S["hero"], 0.06).handheld(0.3); hero.life()
examples/standoff/build.py es la versión completa y probada (4 planos, 7.2 s): cópiala como punto de partida de una nueva película.
cine_kit en una tabla
| necesidad | llamada |
|---|---|
| escena | setup(aspect, height, samples, preview), world(), room(), haze(size, loc, density) |
| superficies | plastic (piel de juguete, brilla cuando está retroiluminada), cloth(kind=weave/knit/leather), wood(planks=), brick, asphalt(wet=), flat (fieltro, yeso, metal), glass, emit (neón, bombillas, pantallas) |
| formas | box (siempre biselado), cyl, torus(arc=), text (letras 3D, palabras de neón), paper (póster/factura/tarjeta con líneas legibles), round_table, chair |
| lámparas | pendant (pantalla visible + bombilla + foco), neon (tubo + relleno coincidente), bokeh_lights, light(kind, loc, power, color=kelvin o hex, target, size) |
| reparto | Char(name, skin, shirt, pants, hat=hair/cap/fedora/beanie): .pose(frame, arm_l=(fwd, out, twist), head=(nod, turn, tilt), torso, leg_l, at, yaw), .hit(frame, dur, ...) (chasquido + mantener), .face(frame, expr), .talk(f0, f1), .sit, .walk, .life() |
| personajes suministrados | Rigged("bugis_man" / "bugis_woman" / path.blend, at, yaw): un modelo de personaje de un archivo, a altura Char, con los mismos canales de pose que Char (arm_l, head, torso, leg_l, .hit, .sit, .walk, .life, .head). Caras pintadas: sin intercambios, por lo que la emoción proviene de la cabeza, los brazos y el corte. Un nuevo modelo de una pieza se riggea una vez con scripts/rig_block.py (mide primero el cuello, la cadera y el borde del brazo a partir de rebanadas) y se añade a K.CAST; el rig es rígido excepto el cuello, que neck_blend.py suaviza (ver "Costura del cuello") |
| el avatar del usuario | Avatar(at, yaw, pose): el personaje Roblox riggeado de Aksa (Roblox/blender/hero_face.blend) a altura Char. .pose(frame, "table" / "stand" / "relax" / "reach" / "chin" / "hips", head=(nod, tilt, turn), arm_L=...), .hit, .sit, .life(), .head (objetivo de cámara), .face.expr(f, eyes, brows, mouth) / .face.lipsync(words, vo_frame, fps=24) / .face.blink, luego .finish() una vez. El usuario es el héroe de sus propias películas: usa Avatar para el protagonista a menos que él diga lo contrario, Char para todos los demás |
| caras | K.EXPRESSIONS: neutral, smirk, grin, angry, shout, shock, sad, shut, talk_a, talk_o, talk_m, side. Solo intercambios, nunca morphs |
| canto en una cara pintada | una vez: Blender -b cast/x.blend -P scripts/prep_mouth.py -- cast/x_sing.blend (encuentra la boca pintada en un renderizado frontal ortográfico, dibuja un atlas de boca con 10 formas en sus colores sobre su propia piel, coloca una placa en la cara esqueletizada al hueso de la cabeza; la celda 0 = la pintura, por lo que en reposo es invisible; luego re-mezcla el cuello para que todo debajo de la placa viaje sobre la cabeza). En la escena: K.Rigged(".../x_sing.blend").sing(words, f0, f1) con words = [{"word","start","end"}] de una transcripción de la pista (tiempos de palabra de faster-whisper). Gira la cabeza hacia la lente mientras ella canta: un perfil oculta la boca |
| cámara | Cam(name, loc, target, lens, stop, focus, roll): .at(frame, loc, target, focus, roll), .push(f0, f1, 0.06), .handheld(amount); Cam.distance_for(lens, height) = qué tan lejos pararse para llenar el fotograma con un sujeto de esa altura (coloca las cámaras cercanas por tamaño, nunca por suposición); .clip_follow(f0, f1, subject) = clip cercano animado, para bucear sobre una cabeza hacia el teléfono en sus manos |
| visibilidad | K.visible(ob, [(f0, f1), ...]): visible en render solo en esos rangos; toca solo la curva de ocultación (nunca establezcas cada curva de un objeto a CONSTANTE: su movimiento se vuelve escalonado) |
| edición | beats(bpm) -> fotograma del pulso n; cut_list([(name, cam, beats), ...], bpm) vincula cámaras a marcadores y devuelve los fotogramas de cada plano |
| salida | still(path, frame), render_range(dir, f0, f1) |
stop es el número f como si la figura fuera un coleccionable de 40 cm: 2-2.8 insertos, 4 caras, 5.6-8 maestros. Más pequeño = más borroso.
Ajuste con otras habilidades del usuario
- Guion:
scriptmaxxingpara cualquier voz en off en indonesio. Mantenlo en pocas líneas; la referencia con 13.7 M de visitas no tiene ninguna. - Música y efectos:
~/Ngonten/Maxxing/audio-lib(CC0). Ejecutabeatgrid.pyen la pista antes de planificar los planos. - El propio avatar del usuario:
K.Avatar()lo carga con su rig facial (parpadeo, cejas, sincronización labial precisa en indonesio desdeRoblox/blender/face/face_rig.py).K.Char.talk()es animación limitada solo para otros hablantes. Pruébalo:build.py -- --avatar --stills. - Atrezo y sets:
robloxmaxxing/blender/rbx_kit.pyconstruye a la misma escala de stud; Poly Haven (MCP para Blendersearch_assets, o el MCP de 3d-assets) para texturas PBR CC0 y atrezo del mundo real; Meshy para un atrezo heroico. El atrezo realista es el objetivo. - Reels verticales:
--aspect 9:16. Todo aquí se mantiene; los maestros van a 24-28 mm y la profundidad se apila a lo largo del eje de la lente.
Reglas ganadas con esfuerzo para trabajo cercano (Negara Angin, 2026-11-21)
- Mide, luego encuadra. Imprime las posiciones evaluadas de la cabeza, las manos y el atrezo en los fotogramas del plano, luego coloca la cámara con
Cam.distance_for. Las cámaras macro colocadas a ojo terminaron a 0.5 studs de objetos que necesitaban 2. - Las manos de Roblox son grandes bloques. Un teléfono sostenido "en" ellas está enterrado; sostén el atrezo frente a las manos a lo largo de la normal de la pantalla.
- No le des un padre de hueso a un atrezo y luego establezcas su matriz mundial (aterriza en el origen). Mantén el atrezo fijo al mundo mientras la pose se mantiene, o emparenta con el operador.
- Los fotogramas ignoran los marcadores de corte. Un marcador vinculado a una cámara anula
scene.cameraen ese fotograma: bórralos para los fotogramas. - El gancho es una imagen y un evento. El fotograma 1 ya debe ser hermoso (Negara Angin: una gota de lluvia deslizándose por la ventana en macro extremo, con las luces de la habitación refractadas dentro), y el primer pulso debe cambiarlo (el bombo enfoca a través de la gota).
- Las transiciones se diseñan, no se añaden: empujar a través de una pantalla hacia el mundo que muestra (renderiza el primer fotograma del siguiente plano como la imagen de la pantalla), salir girando de un plano y entrar en el siguiente.
- Cada escena tiene un color de luz y un color de sombra. Negara Angin: la sala de estar era ámbar + púrpura oscuro, la cocina era azul verdoso + naranja, el techo era rojo + azul. Esto es lo que hace que el corte se sienta como un viaje.
- La cámara siempre se mueve lentamente. 0.1 m/s como máximo en un push, a menos que esté atada al sujeto. Un push que termina en el fotograma del pulso mantiene la energía; un push que cruza el corte la disipa. El handheld nunca excede 0.4 y nunca es constante - un 0.5 de tres segundos se siente como un terremoto.
- El tiempo de renderizado es propiedad de la iluminación. Un plano con cuatro luces de sombra renderiza en la mitad del tiempo que uno con ocho. Después de la PUERTA L, prueba el tiempo del peor plano y multiplica por el recuento de planos.
- Renderiza en dos lotes: primero todos los planos en
--final, luego el plano que tiene el fotograma más lento solo en Cycles. El ojo no ve la diferencia en un corte. - Prueba la mezcla en un altavoz de portátil. Si la voz se pierde bajo la música o los pasos suenan como ladrillos, arréglalo antes de la PUERTA E.
Flujo de trabajo típico
# 1. Brief
cat > build.py << 'EOF'
"""
Logline: Un cartero encuentra una carta sin remitente que lo lleva a una puerta que no debería existir.
Forma: cadena (la carta -> la puerta -> la llave -> la mano al otro lado).
Objeto de apuesta: la carta (un sobre de papel arrugado con un sello roto).
Paletas: exterior (azul+gris, acento naranja), interior (ámbar+negro, acento verde).
Pista: "neon_stroll.wav", 120 BPM, la música cae en el segundo 5, se detiene 3 s en el segundo 12.
Final: la mano desaparece, un segundo de negro, "¿Quién eres?"
Exclusiones: sin explosiones, sin sangre, sin primeros planos de sonrisas.
"""
EOF
# 2. Plan de planos
python3 -I beatgrid.py ~/Ngonten/Maxxing/audio-lib/neon_stroll.wav # escribe BPM y tiempos de palabra
# 3. Construir y renderizar
$B -b --factory-startup -P build.py -- --out out --stills
python3 -I scripts/look_gate.py out/still_master_*.png --look amber
$B -b --factory-startup -P build.py -- --out out --frames --final &
# 4. Finalizar
python3 -I scripts/finish.py out/frames --out out/film.mp4 --look amber --audio mix.wav
python3 -I scripts/shotlist.py out/film.mp4 --bpm 120
Errores comunes
| error | síntoma | arreglo |
|---|---|---|
| "No se puede encontrar el archivo" | falta la ruta de SKILL | export SKILL=/ruta/a/skill |
| fotograma negro | la cámara no tiene objetivo, o la escena no tiene luz | K.setup(engine=...) antes de cualquier otra llamada |
| parpadeo EEVEE | demasiadas luces de sombra | K.eevee_lights(keep=("Lamp", "Key")) |
| vidrio negro | transmisión en EEVEE | usa surface_render_method="BLENDED" y alpha |
| audio desincronizado | BPM incorrecto | beatgrid.py en la pista real, no en un mp3 de vista previa |
| fotogramas saltados en el montaje | marcador de cámara aún activo para fotogramas | bpy.data.scenes["Scene"].timeline_markers.clear() en build.py |
"El cine es un oficio, no un milagro." -- cada fotograma pasado por look_gate.py