Communitygithub.com

Bailipa/EZTor_FULLBLOOD

Use ao reproduzir animações, fazer crossfade entre estados de animação ou carregar animações esqueléticas de GLTF no Three.js. Previne erros comuns como não chamar mixer.update(delta) a cada frame, configuração incorreta de crossfade ou falta do Clock. Cobre AnimationMixer, AnimationClip, AnimationAction, KeyframeTrack, crossfade, blending.

O que é EZTor_FULLBLOOD?

Este skill fornece um guia abrangente e detalhado para implementar animações no Three.js, cobrindo desde a configuração básica até técnicas avançadas como crossfade entre estados de animação e blending aditivo. Ele explica a arquitetura fundamental de animação do Three.js, composta por AnimationClip (dados), AnimationAction (controle de reprodução) e AnimationMixer (agendador mestre), além de destacar a importância do Clock para fornecer o delta de tempo correto a cada frame. O skill alerta sobre erros críticos, como esquecer de chamar mixer.update(delta) no loop de renderização ou usar performance.now() em vez de Clock, e fornece padrões de código prontos para uso, incluindo um exemplo completo de máquina de estados para crossfade entre animações. Suporta carregamento de animações de arquivos GLTF, animação de morph targets, blending aditivo para efeitos camada, e inclui referências a documentação oficial e links para exemplos práticos.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

threejs-impl-animation

Referência Rápida

Arquitetura

AnimationClip        (dados: array de objetos KeyframeTrack)
  └── AnimationAction  (controlador de reprodução: play, pause, fade, crossfade)
        └── AnimationMixer (agendador mestre: um por objeto raiz animado)
              └── Clock    (fornece tempo delta para mixer.update)

SEMPRE crie exatamente UM AnimationMixer por objeto raiz animado. SEMPRE chame mixer.update(delta) a cada frame dentro do loop de renderização. NUNCA instancie AnimationAction diretamente -- SEMPRE use mixer.clipAction(clip).

Importações Essenciais

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

Configuração Mínima de Animação

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);

  // Reproduz todas as animações do arquivo 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);

Avisos Críticos

NUNCA se esqueça de chamar mixer.update(delta) no loop de renderização -- as animações NÃO funcionarão sem isso.

NUNCA use new Date() ou performance.now() para calcular delta manualmente -- SEMPRE use THREE.Clock ou renderer.setAnimationLoop, que fornece temporização de frame estável.

NUNCA chame mixer.clipAction(clip) repetidamente no loop de renderização -- ele faz cache internamente, mas a busca é uma sobrecarga desnecessária. SEMPRE armazene a ação retornada em uma variável.

NUNCA chame .play() a cada frame -- chame-o UMA VEZ para iniciar a reprodução. Chamar .play() novamente em uma ação já em execução não tem efeito, mas indica falta de compreensão.

SEMPRE chame .reset() antes de .play() ao reiniciar uma ação parada ou finalizada, caso contrário a ação pode retomar da última posição.

SEMPRE defina action.clampWhenFinished = true ao usar LoopOnce -- caso contrário, a ação retorna ao primeiro quadro quando termina.


AnimationMixer

O agendador mestre que controla todas as ações de animação para uma única hierarquia de objetos.

Construtor

const mixer = new THREE.AnimationMixer(rootObject);

rootObject é o Object3D raiz do modelo animado (geralmente gltf.scene).

Propriedades

PropriedadeTipoPadrãoDescrição
.timenumber0Tempo global do mixer em segundos
.timeScalenumber1Multiplicador de velocidade global; 0 pausa TODAS as ações

Métodos

MétodoRetornoDescrição
.clipAction(clip, root?, blendMode?)AnimationActionRetorna ou cria uma ação para o clipe
.existingAction(clip, root?)AnimationAction | nullRetorna a ação criada anteriormente ou null
.update(delta)thisAvança o mixer em delta segundos -- DEVE ser chamado a cada frame
.setTime(seconds)thisDefine o tempo global, atualiza todas as ações
.stopAllAction()thisDesativa todas as ações agendadas
.getRoot()Object3DRetorna o objeto raiz do mixer
.uncacheAction(clip, root?)voidDesaloca a ação em cache
.uncacheClip(clip)voidDesaloca os dados do clipe
.uncacheRoot(root)voidDesaloca os dados do objeto raiz

Eventos

Escute via mixer.addEventListener(type, callback):

EventoDisparado Quando
'finished'A ação é concluída (APENAS com LoopOnce + clampWhenFinished = true)
'loop'A ação completa uma iteração do loop

Propriedades do objeto de evento: { action, loopDelta, type }.

Modos de Blending

Passe como terceiro argumento para mixer.clipAction(clip, root, blendMode):

ConstanteComportamento
THREE.NormalAnimationBlendModeBlending padrão (padrão)
THREE.AdditiveAnimationBlendModeCamadas sobrepostas à animação base

AnimationAction

Controla a reprodução de um único clipe de animação. NUNCA instancie diretamente.

Propriedades

PropriedadeTipoPadrãoDescrição
.blendModenumberNormalAnimationBlendModeEstratégia de blending
.clampWhenFinishedbooleanfalsePausa no último frame quando termina
.enabledbooleantrueDesabilitar sem redefinir
.loopnumberLoopRepeatModo de loop
.pausedbooleanfalseCongela a reprodução
.repetitionsnumberInfinityNúmero de repetições
.timenumber0Tempo local em segundos
.timeScalenumber1Velocidade: 0 pausa, negativo reverte
.weightnumber1Influência do blend [0, 1]
.zeroSlopeAtEndbooleantrueInterpolação suave no final do loop
.zeroSlopeAtStartbooleantrueInterpolação suave no início do loop

Modos de Loop

ConstanteComportamento
THREE.LoopOnceReproduz uma vez, para
THREE.LoopRepeatReinicia do início a cada loop
THREE.LoopPingPongAlterna entre avanço e retrocesso

Métodos de Reprodução

MétodoDescrição
.play()Iniciar reprodução
.stop()Parar e redefinir para o início
.reset()Redefinir tempo, peso, velocidade para o estado inicial
.startAt(mixerTime)Atrasar início até o tempo especificado do mixer

Métodos de Fade e Crossfade

MétodoDescrição
.fadeIn(duration)Transição de peso de 0 para 1
.fadeOut(duration)Transição de peso de 1 para 0
.crossFadeFrom(fadeOutAction, duration, warp)Crossfade de outra ação para esta
.crossFadeTo(fadeInAction, duration, warp)Crossfade desta ação para outra
.stopFading()Cancelar qualquer fade ativo

Métodos de Velocidade e Temporização

MétodoDescrição
.halt(duration)Desacelerar timeScale para 0 ao longo da duração
.warp(startScale, endScale, duration)Transição suave da velocidade de reprodução
.stopWarping()Cancelar qualquer warp ativo
.setDuration(seconds)Ajustar timeScale para que um loop dure exatamente seconds
.setEffectiveTimeScale(scale)Definir escala de tempo efetiva
.setEffectiveWeight(weight)Definir peso efetivo
.setLoop(mode, repetitions)Definir modo de loop e contagem
.syncWith(otherAction)Sincronizar tempo com outra ação

Métodos de Consulta

MétodoRetornoDescrição
.isRunning()booleantrue somente se estiver ativamente tocando
.isScheduled()booleantrue se .play() foi chamado
.getClip()AnimationClipO clipe associado
.getMixer()AnimationMixerO mixer proprietário
.getRoot()Object3DO objeto raiz
.getEffectiveTimeScale()numberEscala de tempo computada
.getEffectiveWeight()numberPeso computado

AnimationClip

Um conjunto reutilizável de trilhas de keyframe. Geralmente carregado de arquivos GLTF.

Construtor

const clip = new THREE.AnimationClip(name, duration, tracks, blendMode);
  • name -- identificador de string (clipes GLTF usam nomes do arquivo)
  • duration -- segundos; -1 para calcular automaticamente a partir das trilhas
  • tracks -- array de objetos KeyframeTrack
  • blendMode -- constante de modo de blending opcional

Principais Métodos Estáticos

MétodoDescrição
AnimationClip.findByName(arrayOrObject, name)Buscar clipe pelo nome
AnimationClip.CreateFromMorphTargetSequence(name, targets, fps, noLoop)Criar clipe a partir de sequência de morph targets
AnimationClip.parse(json)Desserializar de JSON

Tipos de KeyframeTrack

Tipo de TrilhaTipo de ValorCaso de Uso
VectorKeyframeTrackVector3Posição, escala
QuaternionKeyframeTrackQuaternionRotação (usa slerp)
NumberKeyframeTracknumberOpacidade, intensidade
BooleanKeyframeTrackbooleanAlternância de visibilidade
ColorKeyframeTrackColorAnimação de cor
StringKeyframeTrackstringValores discretos de string

Modos de Interpolação

ConstanteComportamento
THREE.InterpolateDiscreteFunção degrau, sem suavização
THREE.InterpolateLinearInterpolação linear (padrão)
THREE.InterpolateSmoothInterpolação spline cúbica

Formato do Caminho de PropertyBinding

"meshName.position"                    // animar posição
"meshName.material.opacity"            // animar propriedade de material
"meshName.morphTargetInfluences[0]"    // animar morph target
"boneName.quaternion"                  // animar rotação de osso

Clock

Construtor

const clock = new THREE.Clock(autoStart); // autoStart padrão é true

Métodos

MétodoRetornoDescrição
.getDelta()numberSegundos desde a última chamada de getDelta()
.getElapsedTime()numberTempo total decorrido em segundos
.start()voidIniciar o clock
.stop()voidParar sem redefinir

Padrão de Crossfade (Máquina de Estados do Personagem)

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;
}

SEMPRE chame .reset() na ação de entrada antes do crossfade. SEMPRE armazene a referência da ação atual para a próxima transição.


Blending Aditivo de Animação

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

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

Use blending aditivo para efeitos em camadas: respiração, reações de dano, ajustes de mira.


Animação de Morph Target

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

// Via clipe de animação GLTF (preferido)
const morphAction = mixer.clipAction(morphClip);
morphAction.play();

Links de Referência

Fontes Oficiais

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.

Habilidades Relacionadas