Communitygithub.com

Bailipa/EZTor_FULLBLOOD — Animación en Three.js

Usar al reproducir animaciones, transicionar entre estados de animación o cargar animaciones esqueléticas desde GLTF en Three.js. Evita el error común de no llamar a mixer.update(delta) cada frame, configurar mal un crossfade u olvidar el Clock. Cubre AnimationMixer, AnimationClip, AnimationAction, KeyframeTrack, crossfade y blending.

¿Qué es EZTor_FULLBLOOD — Animación en Three.js?

Esta skill proporciona una guía completa y práctica para implementar animaciones en Three.js, desde la carga de modelos GLTF con animaciones esqueléticas hasta el control preciso de la reproducción y las transiciones. Su principal valor es prevenir errores frecuentes como omitir la llamada a `mixer.update(delta)` en el bucle de renderizado, usar temporizadores manuales en lugar de `THREE.Clock`, o configurar incorrectamente los crossfades. La documentación cubre de forma detallada todos los componentes esenciales: `AnimationMixer` (el programador maestro que gestiona todas las acciones para un objeto raíz), `AnimationAction` (controlador de reproducción de un clip individual, con métodos para fading, crossfading, warp y loop), `AnimationClip` (conjunto reutilizable de keyframes), y `KeyframeTrack` (con sus tipos e interpolaciones). Además, incluye ejemplos y patrones avanzados como la máquina de estados para crossfade entre animaciones, el blending aditivo para efectos superpuestos (como respiración o reacciones a daño) y animación de morph targets. La skill es compatible con cualquier proyecto que use Three.js (incluyendo addons como GLTFLoader) y está diseñada tanto para desarrolladores que inician con animaciones 3D como para aquellos que buscan referencias rápidas de la API.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Bailipa/EZTor_FULLBLOOD/tree/HEAD/.opencode/skills/threejs/threejs-impl/threejs-impl-animation

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

threejs-impl-animation

Referencia Rápida

Arquitectura

AnimationClip        (datos: array de objetos KeyframeTrack)
  └── AnimationAction  (controlador de reproducción: play, pause, fade, crossfade)
        └── AnimationMixer (programador maestro: uno por objeto raíz animado)
              └── Clock    (proporciona el delta de tiempo para mixer.update)

SIEMPRE crea EXACTAMENTE UN AnimationMixer por objeto raíz animado. SIEMPRE llama a mixer.update(delta) cada frame dentro del bucle de renderizado. NUNCA instancies AnimationAction directamente — SIEMPRE usa mixer.clipAction(clip).

Importaciones Esenciales

import * as THREE from 'three';
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';

Configuración Mínima de Animación

import * as THREE from 'three';
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';

const clock = new THREE.Clock();
let mixer;

const loader = new GLTFLoader();
loader.load('character.glb', (gltf) => {
  scene.add(gltf.scene);
  mixer = new THREE.AnimationMixer(gltf.scene);

  // Reproducir todas las animaciones del archivo GLTF
  gltf.animations.forEach((clip) => {
    mixer.clipAction(clip).play();
  });
});

function animate() {
  const delta = clock.getDelta();
  if (mixer) mixer.update(delta);
  renderer.render(scene, camera);
}
renderer.setAnimationLoop(animate);

Advertencias Críticas

NUNCA olvides llamar a mixer.update(delta) en el bucle de renderizado — las animaciones NO se reproducirán sin ello.

NUNCA uses new Date() o performance.now() para calcular el delta manualmente — SIEMPRE usa THREE.Clock o renderer.setAnimationLoop, que proporcionan un tiempo de cuadro estable.

NUNCA llames a mixer.clipAction(clip) repetidamente en el bucle de renderizado — aunque hace caché internamente, la búsqueda es una sobrecarga innecesaria. SIEMPRE almacena la acción devuelta en una variable.

NUNCA llames a .play() cada frame — llámalo UNA VEZ para iniciar la reproducción. Llamar a .play() de nuevo sobre una acción que ya se está reproduciendo no tiene efecto, pero indica una mala comprensión.

SIEMPRE llama a .reset() antes de .play() al reiniciar una acción detenida o finalizada, de lo contrario la acción podría reanudarse desde su última posición.

SIEMPRE establece action.clampWhenFinished = true al usar LoopOnce — de lo contrario, la acción se reinicia al primer fotograma al terminar.


AnimationMixer

El programador maestro que gestiona todas las acciones de animación para una jerarquía de objetos.

Constructor

const mixer = new THREE.AnimationMixer(rootObject);

rootObject es el Object3D raíz del modelo animado (generalmente gltf.scene).

Propiedades

PropiedadTipoPor defectoDescripción
.timenumber0Tiempo global del mixer en segundos
.timeScalenumber1Multiplicador de velocidad global; 0 pausa TODAS las acciones

Métodos

MétodoRetornaDescripción
.clipAction(clip, root?, blendMode?)AnimationActionRetorna o crea una acción para el clip
.existingAction(clip, root?)AnimationAction | nullRetorna una acción creada previamente o null
.update(delta)thisAvanza el mixer en delta segundos — DEBE llamarse cada frame
.setTime(seconds)thisEstablece el tiempo global, actualiza todas las acciones
.stopAllAction()thisDesactiva todas las acciones programadas
.getRoot()Object3DRetorna el objeto raíz del mixer
.uncacheAction(clip, root?)voidLibera la acción almacenada en caché
.uncacheClip(clip)voidLibera los datos del clip
.uncacheRoot(root)voidLibera los datos del objeto raíz

Eventos

Escucha a través de mixer.addEventListener(type, callback):

EventoSe Dispara Cuando
'finished'La acción se completa (SOLO con LoopOnce + clampWhenFinished = true)
'loop'La acción completa una iteración del bucle

Propiedades del objeto de evento: { action, loopDelta, type }.

Modos de Mezcla

Pasa como tercer argumento a mixer.clipAction(clip, root, blendMode):

ConstanteComportamiento
THREE.NormalAnimationBlendModeMezcla estándar (por defecto)
THREE.AdditiveAnimationBlendModeSuperpuesta sobre la animación base

AnimationAction

Controla la reproducción de un clip de animación individual. NUNCA instanciar directamente.

Propiedades

PropiedadTipoPor defectoDescripción
.blendModenumberNormalAnimationBlendModeEstrategia de mezcla
.clampWhenFinishedbooleanfalsePausa en el último fotograma al terminar
.enabledbooleantrueDeshabilitar sin reiniciar
.loopnumberLoopRepeatModo de bucle
.pausedbooleanfalseCongela la reproducción
.repetitionsnumberInfinityNúmero de repeticiones
.timenumber0Tiempo local en segundos
.timeScalenumber1Velocidad: 0 pausa, negativo invierte
.weightnumber1Influencia de mezcla [0, 1]
.zeroSlopeAtEndbooleantrueInterpolación suave al final del bucle
.zeroSlopeAtStartbooleantrueInterpolación suave al inicio del bucle

Modos de Bucle

ConstanteComportamiento
THREE.LoopOnceSe reproduce una vez, se detiene
THREE.LoopRepeatSe reinicia desde el principio cada bucle
THREE.LoopPingPongAlterna hacia adelante/atrás

Métodos de Reproducción

MétodoDescripción
.play()Iniciar reproducción
.stop()Detener y reiniciar al inicio
.reset()Reiniciar tiempo, peso, velocidad al estado inicial
.startAt(mixerTime)Retrasar el inicio hasta el tiempo especificado del mixer

Métodos de Desvanecimiento y Transición (Crossfade)

MétodoDescripción
.fadeIn(duration)Desvanecer el peso de 0 a 1
.fadeOut(duration)Desvanecer el peso de 1 a 0
.crossFadeFrom(fadeOutAction, duration, warp)Transición desde otra acción hacia esta
.crossFadeTo(fadeInAction, duration, warp)Transición desde esta acción hacia otra
.stopFading()Cancelar cualquier desvanecimiento activo

Métodos de Velocidad y Tiempo

MétodoDescripción
.halt(duration)Desacelerar timeScale a 0 durante una duración
.warp(startScale, endScale, duration)Transicionar suavemente la velocidad de reproducción
.stopWarping()Cancelar cualquier warp activo
.setDuration(seconds)Ajustar timeScale para que un bucle dure exactamente seconds
.setEffectiveTimeScale(scale)Establecer la escala de tiempo efectiva
.setEffectiveWeight(weight)Establecer el peso efectivo
.setLoop(mode, repetitions)Establecer modo de bucle y número de repeticiones
.syncWith(otherAction)Sincronizar tiempo con otra acción

Métodos de Consulta

MétodoRetornaDescripción
.isRunning()booleantrue solo si está reproduciéndose activamente
.isScheduled()booleantrue si se llamó a .play()
.getClip()AnimationClipEl clip asociado
.getMixer()AnimationMixerEl mixer propietario
.getRoot()Object3DEl objeto raíz
.getEffectiveTimeScale()numberEscala de tiempo calculada
.getEffectiveWeight()numberPeso calculado

AnimationClip

Un conjunto reutilizable de pistas de fotogramas clave. Normalmente se carga desde archivos GLTF.

Constructor

const clip = new THREE.AnimationClip(name, duration, tracks, blendMode);
  • name -- identificador de texto (los clips GLTF usan nombres del archivo)
  • duration -- segundos; -1 para calcular automáticamente a partir de las pistas
  • tracks -- array de objetos KeyframeTrack
  • blendMode -- constante de modo de mezcla opcional

Métodos Estáticos Clave

MétodoDescripción
AnimationClip.findByName(arrayOrObject, name)Buscar clip por nombre
AnimationClip.CreateFromMorphTargetSequence(name, targets, fps, noLoop)Crear clip a partir de morph targets
AnimationClip.parse(json)Deserializar desde JSON

Tipos de KeyframeTrack

Tipo de PistaTipo de ValorCaso de Uso
VectorKeyframeTrackVector3Posición, escala
QuaternionKeyframeTrackQuaternionRotación (usa slerp)
NumberKeyframeTracknumberOpacidad, intensidad
BooleanKeyframeTrackbooleanAlternar visibilidad
ColorKeyframeTrackColorAnimación de color
StringKeyframeTrackstringValores discretos de texto

Modos de Interpolación

ConstanteComportamiento
THREE.InterpolateDiscreteFunción escalón, sin suavizado
THREE.InterpolateLinearInterpolación lineal (por defecto)
THREE.InterpolateSmoothInterpolación por spline cúbico

Formato de Ruta de PropertyBinding

"meshName.position"                    // animar posición
"meshName.material.opacity"            // animar propiedad del material
"meshName.morphTargetInfluences[0]"    // animar morph target
"boneName.quaternion"                  // animar rotación de hueso

Clock

Constructor

const clock = new THREE.Clock(autoStart); // autoStart por defecto es true

Métodos

MétodoRetornaDescripción
.getDelta()numberSegundos desde la última llamada a getDelta()
.getElapsedTime()numberTiempo total transcurrido en segundos
.start()voidIniciar el reloj
.stop()voidDetener sin reiniciar

Patrón de Transición (Máquina de Estados de Personaje)

const actions = {};
gltf.animations.forEach((clip) => {
  actions[clip.name] = mixer.clipAction(clip);
});

let currentAction = actions['Idle'];
currentAction.play();

function switchAction(toName, duration = 0.5) {
  const toAction = actions[toName];
  toAction.reset();
  toAction.setEffectiveTimeScale(1);
  toAction.setEffectiveWeight(1);
  toAction.crossFadeFrom(currentAction, duration, true);
  toAction.play();
  currentAction = toAction;
}

SIEMPRE llama a .reset() en la acción entrante antes de hacer crossfade. SIEMPRE almacena la referencia de la acción actual para la siguiente transición.


Mezcla de Animación Aditiva

const baseAction = mixer.clipAction(baseClip);
const additiveAction = mixer.clipAction(
  additiveClip, undefined, THREE.AdditiveAnimationBlendMode
);

baseAction.play();
additiveAction.play();
additiveAction.setEffectiveWeight(0.5);

Usa mezcla aditiva para efectos superpuestos: respiración, reacciones a daño, offsets de puntería.


Animación de Morph Targets

// Control manual
mesh.morphTargetInfluences[0] = Math.sin(elapsed) * 0.5 + 0.5;

// Mediante clip de animación GLTF (preferido)
const morphAction = mixer.clipAction(morphClip);
morphAction.play();

Enlaces de Referencia

Fuentes Oficiales

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

Bailipa/EZTor_FULLBLOOD

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For CLI commands (init, lint, preview, render, transcribe, tts) see the hyperframes-cli skill.

Bailipa/EZTor_FULLBLOOD

A single-frame motion-design composition with looping CSS animations — rotating type ring, animated globe, ticking timer, parallax labels. Renders as a hero video poster you can hand straight to HyperFrames or any keyframe-based exporter. Use when the brief asks for "motion design", "animated hero", "loop", "video poster", "title card", or pairs Open Claude Design with HyperFrames for a kinetic export.

Bailipa/EZTor_FULLBLOOD

Single-page SaaS landing with hero, features, social proof, pricing, and CTA. Respects the active DESIGN.md color/typography/layout tokens. Trigger keywords: "saas landing", "marketing page", "product landing".

Bailipa/EZTor_FULLBLOOD

A pixel / sprite-style animated explainer slide — full-bleed cream stage, bold display year, animated pixel-art mascot (e.g. Hanafuda card, mushroom, or 8-bit console), kinetic Japanese display type, ticking timeline ribbon. Reads like a single frame of an educational motion video — looping CSS keyframes, no JS, ready to be screen-recorded into a vertical video. Use when the brief asks for a "sprite animation", "pixel-art video", "8-bit explainer", "history of X explainer", "kinetic typography history", "Nintendo-style", "精灵图动画", "像素动画", or "复古动画".

Bailipa/EZTor_FULLBLOOD

Short-form video generation skill — 3-10 second clips for product reveals, motion teasers, ambient loops. Defaults to Seedance 2 but works the same with Kling 3 / 4, Veo 3 or Sora 2. Output is one MP4 saved to the project folder. When the workspace also ships an interactive-video / hyperframes skill, prefer composing several short shots into a single timeline rather than one long monolithic clip.

Skills relacionados