Animación 2D Artesanal (EffectCraft + FilmCraft)
Método general y reutilizable para diseñar, animar y ensamblar intros, demos de producto, escenas cortas o cortometrajes 2D en EffectCraft (con montaje/exportación opcional en FilmCraft), con o sin pista musical.
Referencia CLI/MCP y permisos Flatpak compartidos: ../craft-music-video/references/mcp-and-commands.md.
1. Dirección visual y legibilidad de escena
- Lugares identificables por el color: limitar una escena corta a 2 o 3 lugares como máximo, cada uno con una luz dominante y una paleta dedicada (p. ej., pasillo cálido/noche, puesto de trabajo iluminado por una pantalla, sala clara con un solo color de acento reservado para errores o alertas).
- Siluetas llenas en lugar de contornos huecos: construir los personajes y decorados con formas geométricas rellenas (curvas de Bézier o rectángulos redondeados) con rostros minimalistas (ojos, cejas, boca simples) y un ligero borde de contraluz (
rim light) del lado de la fuente de luz. - Contraste de siluetas: distinguir cada personaje desde la miniatura (p. ej., silueta redondeada que se encoge vs. silueta recta de hombros cuadrados y gestos bruscos).
- Decorados sobredimensionados para los movimientos de cámara: dibujar los fondos/paredes más anchos que el encuadre (
2200–2400 pxpara un zoom/shake en1920×1080, o3600+ pxpara un travelling panorámico) para evitar cualquier borde negro de 10–20 px en los bordes del encuadre.
2. Encuadres y gramática visual
Variar los valores de plano para narrar la acción sin texto superfluo:
| Valor de plano | Rol narrativo | Buenas prácticas técnicas |
|---|---|---|
| Plano general (Establishing) | Presentar el lugar, la iluminación y la posición relativa de los elementos | Mantener un punto de referencia espacial fijo (escritorio, pantalla, panel, puerta) al regresar al mismo lugar |
| Por encima del hombro (OTS) | Mostrar el objetivo del personaje y su punto de vista sobre una interfaz u objeto | Reutilizar exactamente el mismo encuadre OTS entre el primer intento y el éxito final para crear un recordatorio visual inmediato |
| Plano medio / Perfil | Seguir la postura, los desplazamientos y la evolución física de una escena | Ideal para mostrar un encogimiento progresivo, un retroceso en la silla o un gesto amplio |
| Primer plano (Close-up) | Aislar una intención, un detalle de interfaz, una mano sobre una tecla, una mirada o un gag | Mantener los movimientos cortos y legibles; aprovechar el primer plano para despejar zonas negativas limpias |
Cálculo de encuadre de cámara (cam_focus)
Con un nulo de cámara de ancla [0, 0], centrar un punto del mundo (tx, ty) en medio de un encuadre W × H a la escala sc % obedece exactamente a:
pos = [W / 2 - (sc / 100) * tx, H / 2 - (sc / 100) * ty]
(disponible directamente mediante cam_focus(tx, ty, scale_pct, width, height) en ec_runtime.py).
3. Cambios de pose, peso y ritmo visual
- Anticipación → Acción → Rebote / Mantenimiento:
- Nunca pasar linealmente de una pose A a una pose B.
- Añadir una pequeña anticipación de sentido opuesto antes de la acción (p. ej., dedo que se levanta y duda antes de golpear una tecla, puerta que se abre ligeramente antes de cerrarse de golpe, cuerpo que se apoya antes de retroceder).
- Terminar con un ligero rebasamiento (
overshoot) o una pausa legible (hold) para dar peso (p. ej., personaje que retrocede un paso y hace una pausa para admirar su trabajo).
- Escalones de postura progresivos: durante una espera o un aumento de tensión, hacer evolucionar la postura por escalones nítidos entre dos planos (inclinación del torso, bajada de la cabeza, relajación de los brazos) en lugar de un flotamiento permanente.
- Mantener los planos entre dos acciones: dejar respirar la composición entre los acentos (parpadeos, micro-zoom lento, cursor que parpadea) en lugar de agitar todas las capas continuamente.
- Prueba muda obligatoria: visionar toda escena de acción, intro o demo sin el sonido (o mediante 3–5 capturas clave
render-frame). El objetivo del personaje y la progresión de la escena deben seguir siendo 100 % comprensibles solo con la imagen.
4. Anclas de los personajes, de las cámaras y orden de apilamiento (Trampas EffectCraft)
Estas reglas evitan los errores de desfase, miembros separados o elementos ocultos en EffectCraft (comportamiento compatible con After Effects):
A. Nulos y cámaras
comp.layers.addNull()crea por defecto un ancla en[50, 50]y una posición en[960, 540]. Siempre forzaranchorPoint.setValue([0, 0])antes de posicionar o emparentar el nulo (esto es lo que hacemakeCamNullenec_runtime.py).- Siempre asignar
child.parent = parentANTES dechild.position.setValue(...), para que las coordenadas dechildse interpreten directamente en el sistema de referencia local del padre.
B. Regla absoluta sobre el parenting y las transformaciones
- Vincular a TODOS los hijos mientras el padre está en pose neutra (
rotation = 0°,scale = [100, 100]). - Aplicar las rotaciones iniciales, zooms de cámara o keyframes del padre solo DESPUÉS de la creación completa de toda la jerarquía hija.
- Por qué: modificar
parent.rotationoparent.scaleantes de asignarchild.parent = parentdesencadena una compensación inversa al estilo AE que proyecta la cabeza/los brazos fuera del cuerpo o encoge todo un decorado en una esquina del encuadre.
C. Jerarquía de anclas de un personaje 2D articulado
- Personaje sentado:
Rooten las caderas (hip_pos) →Chair,Legs,TorsoNull(pivote cintura[0, 0]) →BackUpperArm(hombro) →BackForeArm(codo) →TorsoBody→Head(base del cuello) →UpperArm→ForeArm. - Personaje de pie:
Rooten el suelo entre los pies (foot_pos) para mantener los zapatos plantados en el suelo durante un zoom o un paso atrás →LegBack/LegFront(pivote caderas) +TorsoPivot(pivote caderas) →Arms,Blazer/Body,Head. - Empalme cuello / collar: agregar siempre una forma sólida de cuello / collar que superponga la parte superior del torso y la parte inferior de la cabeza para que una inclinación fuerte (
25°–35°) nunca abra un hueco entre la barbilla y los hombros.
D. Orden de apilamiento (Stacking Order)
- Dentro de una misma capa de forma (
ADBE Root Vectors Group): el primer grupo agregado se dibuja ENCIMA, el último DEBAJO (orden delante → detrás). - Entre capas distintas de una composición: cada nueva capa se inserta en el índice
1(ENCIMA). Construir las capas en el orden detrás → delante (fondo → resplandor → decorado → personaje → primer plano).
5. Legibilidad del texto y separación diegética / superposición
- Sin banda negra permanente: colocar los títulos, subtítulos o leyendas en el espacio negativo libre de cada plano (encima de una pantalla, en una esquina oscura de la pared, debajo de una línea de horizonte), sin superponer nunca un rostro, un borde de pantalla o un panel del decorado.
- Contraste y márgenes de seguridad:
- Aplicar una sombra suave (
ADBE Drop Shadow, opacidad190–230, distancia4–6 px, desenfoque14–18 px) para garantizar la lectura sobre fondo claro u oscuro. - Respetar márgenes horizontales de seguridad (
>= 70 pxen1920×1080) y un tiempo de mantenimiento legible (>= 0.35 sdespués del final de la acción o de la última palabra, incluso a través de un corte de plano).
- Aplicar una sombra suave (
- Separación estricta Texto diegético (
V1) vs. Texto superpuesto (V2):- Texto integrado en el decorado (
V1): letreros, interfaces de pantalla, hojas, pizarras, teclas de teclado. Forma parte del mundo animado y permanece presente en todas las exportaciones. - Texto superpuesto (
V2, ProRes 4444 RGBA): títulos, cartelas, subtítulos, letras o anotaciones de interfaz de usuario. Colocarlo en composiciones transparentes separadas permite exportar con un clic una versión con títulos y una versión limpia en el montaje rigurosamente idéntica.
- Texto integrado en el decorado (
6. Verificación visual y renderizado eficiente en recursos
- Control mediante imágenes clave antes de cualquier renderizado de video: usar
effectcraft-cli render-frame --max-side 960en 1 o 2 instantes clave por plano (y--transparentpara las superposicionesV2) para verificar encuadres, empalmes de articulaciones y legibilidad del texto en pocos segundos. - Renderizado secuencial seguro (máquinas de 8 GB RAM / CPU modesta):
- Renderizar 1 sola composición a la vez (nunca renderizados ProRes 4444 RGBA en paralelo en 8 GB de RAM).
- Limitar los hilos (
RAYON_NUM_THREADS=2,OMP_NUM_THREADS=2), ejecutar en prioridad baja (nice -n 15 ionice -c 3), evitar--gpusi la VRAM está compartida con la RAM del sistema, y dejar 2 s entre dos renderizados para liberar memoria.
7. Herramientas compartidas T3 Code y dependencias
Los scripts reutilizables se encuentran en ~/.t3/shared/craft-video/:
| Herramienta | Ruta | Uso en animación 2D |
|---|---|---|
| Runtime JSX EffectCraft | ~/.t3/shared/craft-video/ec_runtime.py | Importar JsxBuilder, cam_focus, hex_to_rgba, run_effectcraft_script para generar correctamente un .ecproj (ancla [0,0], Bézier, brillos, keyframes suavizadas/hold) |
| Renderizado por lotes secuencial | ~/.t3/shared/craft-video/render_ec_batch.sh | Renderizar las escenas V* (ProRes HQ RGB) y superposiciones L*/T* (ProRes 4444 RGBA) en baja carga con reanudación automática mediante ffprobe |
| Ensamblaje y exportación FilmCraft | ~/.t3/shared/craft-video/assemble_filmcraft.py | Ensamblar V1 (+ V2 alpha y A1 audio opcionales) en Rec.709 en un .fcproj y exportar Master + Clean |
Dependencias necesarias
- Python 3.9+ (solo biblioteca estándar)
ffmpegyffprobe- CLI de EffectCraft (
effectcraft-clio Flatpakai.storyteller.effectcraftcon acceso--filesystem) - CLI de FilmCraft (
filmcraft-clio Flatpakai.storyteller.filmcraft) para el ensamblaje/exportación multipista - Opcionales Linux:
nice,ionice,taskset
Comandos de ejemplo
# Verificar las dependencias disponibles (sin renderizado)
python3 ~/.t3/shared/craft-video/ec_runtime.py --check-env
# Previsualizar el plan de renderizado secuencial de baja carga (escena + títulos alpha)
~/.t3/shared/craft-video/render_ec_batch.sh \
--project ./projects/demo_2d.ecproj \
--out-dir ./renders_vfx \
--rgb V01_Intro,V02_Demo \
--rgba T01_Intro,T02_Demo \
--threads 2 --cores 0-3 --dry-run
# Previsualizar el ensamblaje FilmCraft sin música (intro/demo muda, Master + Clean)
python3 ~/.t3/shared/craft-video/assemble_filmcraft.py \
--out-fcproj ./projects/demo_2d.fcproj \
--v1-clips ./renders_vfx/V01_Intro.mov,./renders_vfx/V02_Demo.mov \
--v2-clips ./renders_vfx/T01_Intro.mov,./renders_vfx/T02_Demo.mov \
--export-master ./exports/demo_2d_titles.mp4 \
--export-clean ./exports/demo_2d_clean.mp4 \
--dry-run