Communitygithub.com

Desesbraker/agentes-vip

Animação Three.js - animação por keyframes, animação esquelética, alvos de morph, mistura de animações. Use ao animar objetos, reproduzir animações GLTF, criar movimento procedural ou mesclar animações.

O que é agentes-vip?

Esta skill fornece um guia completo e prático para o sistema de animação do Three.js, abordando desde os conceitos fundamentais (AnimationClip, AnimationMixer, AnimationAction) até técnicas avançadas como blending aditivo, animação esquelética e morph targets. Inclui exemplos de código prontos para uso, padrões de animação procedural (suavização, molas, oscilações) e dicas de desempenho. É útil para qualquer desenvolvedor que precise animar objetos 3D em cenas Three.js, seja em aplicações web, jogos ou visualizações interativas, e suporta carregamento de animações de modelos GLTF. A skill é baseada na documentação oficial do Three.js, com ênfase nas práticas recomendadas a partir da versão r183, como o uso de `THREE.Timer`.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Desesbraker/agentes-vip/tree/HEAD/full%20skill/plugins/antigravity-awesome-skills-claude/skills/threejs-animation

Perguntar na sua IA favorita

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

Documentação

Animação Three.js

Introdução Rápida

import * as THREE from "three";

// Animação procedural simples com Timer (recomendado a partir de r183)
const timer = new THREE.Timer();

renderer.setAnimationLoop(() => {
  timer.update();
  const delta = timer.getDelta();
  const elapsed = timer.getElapsed();

  mesh.rotation.y += delta;
  mesh.position.y = Math.sin(elapsed) * 0.5;

  renderer.render(scene, camera);
});

Nota: THREE.Timer é recomendado em vez de THREE.Clock a partir da versão r183. O Timer pausa quando a página está oculta e possui uma API mais limpa. THREE.Clock ainda funciona, mas é considerado legado.

Visão Geral do Sistema de Animação

O sistema de animação do Three.js possui três componentes principais:

  1. AnimationClip – Contêiner para dados de keyframes
  2. AnimationMixer – Reproduz animações em um objeto raiz
  3. AnimationAction – Controla a reprodução de um clip

AnimationClip

Armazena dados de animação por keyframes.

// Criar um clip de animação
const times = [0, 1, 2]; // Tempos dos keyframes (segundos)
const values = [0, 1, 0]; // Valores em cada keyframe

const track = new THREE.NumberKeyframeTrack(
  ".position[y]", // Caminho da propriedade
  times,
  values,
);

const clip = new THREE.AnimationClip("bounce", 2, [track]);

Tipos de KeyframeTrack

// Track numérico (valor único)
new THREE.NumberKeyframeTrack(".opacity", times, [1, 0]);
new THREE.NumberKeyframeTrack(".material.opacity", times, [1, 0]);

// Track vetorial (posição, escala)
new THREE.VectorKeyframeTrack(".position", times, [
  0,
  0,
  0, // t=0
  1,
  2,
  0, // t=1
  0,
  0,
  0, // t=2
]);

// Track de quaternion (rotação)
const q1 = new THREE.Quaternion().setFromEuler(new THREE.Euler(0, 0, 0));
const q2 = new THREE.Quaternion().setFromEuler(new THREE.Euler(0, Math.PI, 0));
new THREE.QuaternionKeyframeTrack(
  ".quaternion",
  [0, 1],
  [q1.x, q1.y, q1.z, q1.w, q2.x, q2.y, q2.z, q2.w],
);

// Track de cor
new THREE.ColorKeyframeTrack(".material.color", times, [
  1,
  0,
  0, // vermelho
  0,
  1,
  0, // verde
  0,
  0,
  1, // azul
]);

// Track booleano
new THREE.BooleanKeyframeTrack(".visible", [0, 0.5, 1], [true, false, true]);

// Track de string (para morph targets)
new THREE.StringKeyframeTrack(
  ".morphTargetInfluences[sorriso]",
  [0, 1],
  ["0", "1"],
);

Modos de Interpolação

const track = new THREE.VectorKeyframeTrack(".position", times, values);

// Interpolação
track.setInterpolation(THREE.InterpolateLinear); // Padrão
track.setInterpolation(THREE.InterpolateSmooth); // Spline cúbica
track.setInterpolation(THREE.InterpolateDiscrete); // Função degrau

BezierInterpolant (r183)

O Three.js r183 adiciona THREE.BezierInterpolant para interpolação de curvas bezier em tracks de keyframes, permitindo curvas de animação mais suaves com controle de tangentes.

AnimationMixer

Reproduz animações em um objeto e seus descendentes.

const mixer = new THREE.AnimationMixer(model);

// Criar ação a partir do clip
const action = mixer.clipAction(clip);
action.play();

// Atualizar no loop de animação
function animate() {
  const delta = clock.getDelta();
  mixer.update(delta); // Obrigatório!

  requestAnimationFrame(animate);
  renderer.render(scene, camera);
}

Eventos do Mixer

mixer.addEventListener("finished", (e) => {
  console.log("Animação finalizada:", e.action.getClip().name);
});

mixer.addEventListener("loop", (e) => {
  console.log("Animação em loop:", e.action.getClip().name);
});

AnimationAction

Controla a reprodução de um clip de animação.

const action = mixer.clipAction(clip);

// Controle de reprodução
action.play();
action.stop();
action.reset();
action.halt(fadeOutDuration);

// Estado da reprodução
action.isRunning();
action.isScheduled();

// Controle de tempo
action.time = 0.5; // Tempo atual
action.timeScale = 1; // Velocidade de reprodução (negativo = reverso)
action.paused = false;

// Peso (para mesclagem)
action.weight = 1; // 0-1, contribuição para a pose final
action.setEffectiveWeight(1);

// Modos de loop
action.loop = THREE.LoopRepeat; // Padrão: loop infinito
action.loop = THREE.LoopOnce; // Reproduz uma vez e para
action.loop = THREE.LoopPingPong; // Alterna entre frente e trás
action.repetitions = 3; // Número de repetições (Infinity padrão)

// Fixação
action.clampWhenFinished = true; // Mantém o último quadro ao finalizar

// Mesclagem
action.blendMode = THREE.NormalAnimationBlendMode;
action.blendMode = THREE.AdditiveAnimationBlendMode;

Fade In/Out

// Fade in
action.reset().fadeIn(0.5).play();

// Fade out
action.fadeOut(0.5);

// Crossfade entre animações
const action1 = mixer.clipAction(clip1);
const action2 = mixer.clipAction(clip2);

action1.play();

// Mais tarde, fazer crossfade para action2
action1.crossFadeTo(action2, 0.5, true);
action2.play();

Carregando Animações GLTF

Fonte mais comum de animações esqueléticas.

import { GLTFLoader } from "three/examples/jsm/loaders/GLTFLoader.js";

const loader = new GLTFLoader();
loader.load("model.glb", (gltf) => {
  const model = gltf.scene;
  scene.add(model);

  // Criar mixer
  const mixer = new THREE.AnimationMixer(model);

  // Obter todos os clips
  const clips = gltf.animations;
  console.log(
    "Animações disponíveis:",
    clips.map((c) => c.name),
  );

  // Reproduzir primeira animação
  if (clips.length > 0) {
    const action = mixer.clipAction(clips[0]);
    action.play();
  }

  // Reproduzir animação específica pelo nome
  const walkClip = THREE.AnimationClip.findByName(clips, "Andar");
  if (walkClip) {
    mixer.clipAction(walkClip).play();
  }

  // Armazenar mixer para o loop de atualização
  window.mixer = mixer;
});

// Loop de animação
function animate() {
  const delta = clock.getDelta();
  if (window.mixer) window.mixer.update(delta);

  requestAnimationFrame(animate);
  renderer.render(scene, camera);
}

Animação Esquelética

Esqueleto e Ossos

// Acessar esqueleto a partir de um skinned mesh
const skinnedMesh = model.getObjectByProperty("type", "SkinnedMesh");
const skeleton = skinnedMesh.skeleton;

// Acessar ossos
skeleton.bones.forEach((bone) => {
  console.log(bone.name, bone.position, bone.rotation);
});

// Encontrar osso específico pelo nome
const headBone = skeleton.bones.find((b) => b.name === "Cabeça");
if (headBone) headBone.rotation.y = Math.PI / 4; // Virar cabeça

// Auxiliar do esqueleto
const helper = new THREE.SkeletonHelper(model);
scene.add(helper);

Animação Programática de Ossos

function animate() {
  const time = clock.getElapsedTime();

  // Animar osso
  const headBone = skeleton.bones.find((b) => b.name === "Cabeça");
  if (headBone) {
    headBone.rotation.y = Math.sin(time) * 0.3;
  }

  // Atualizar mixer se também estiver reproduzindo clips
  mixer.update(clock.getDelta());
}

Anexos a Ossos

// Anexar objeto a um osso
const weapon = new THREE.Mesh(weaponGeometry, weaponMaterial);
const handBone = skeleton.bones.find((b) => b.name === "MãoDireita");
if (handBone) handBone.add(weapon);

// Deslocamento do anexo
weapon.position.set(0, 0, 0.5);
weapon.rotation.set(0, Math.PI / 2, 0);

Morph Targets

Mescla entre diferentes formas da malha.

// Morph targets são armazenados na geometria
const geometry = mesh.geometry;
console.log("Atributos de morph:", Object.keys(geometry.morphAttributes));

// Acessar influências de morph target
mesh.morphTargetInfluences; // Array de pesos
mesh.morphTargetDictionary; // Mapeamento nome -> índice

// Definir morph target por índice
mesh.morphTargetInfluences[0] = 0.5;

// Definir por nome
const smileIndex = mesh.morphTargetDictionary["sorriso"];
mesh.morphTargetInfluences[smileIndex] = 1;

Animando Morph Targets

// Procedural
function animate() {
  const t = clock.getElapsedTime();
  mesh.morphTargetInfluences[0] = (Math.sin(t) + 1) / 2;
}

// Com animação por keyframes
const track = new THREE.NumberKeyframeTrack(
  ".morphTargetInfluences[sorriso]",
  [0, 0.5, 1],
  [0, 1, 0],
);
const clip = new THREE.AnimationClip("sorriso", 1, [track]);
mixer.clipAction(clip).play();

Mesclagem de Animações

Mistura múltiplas animações juntas.

// Configurar ações
const idleAction = mixer.clipAction(idleClip);
const walkAction = mixer.clipAction(walkClip);
const runAction = mixer.clipAction(runClip);

// Reproduzir todas com pesos diferentes
idleAction.play();
walkAction.play();
runAction.play();

// Definir pesos iniciais
idleAction.setEffectiveWeight(1);
walkAction.setEffectiveWeight(0);
runAction.setEffectiveWeight(0);

// Mesclar com base na velocidade
function updateAnimations(speed) {
  if (speed < 0.1) {
    idleAction.setEffectiveWeight(1);
    walkAction.setEffectiveWeight(0);
    runAction.setEffectiveWeight(0);
  } else if (speed < 5) {
    const t = speed / 5;
    idleAction.setEffectiveWeight(1 - t);
    walkAction.setEffectiveWeight(t);
    runAction.setEffectiveWeight(0);
  } else {
    const t = Math.min((speed - 5) / 5, 1);
    idleAction.setEffectiveWeight(0);
    walkAction.setEffectiveWeight(1 - t);
    runAction.setEffectiveWeight(t);
  }
}

Mesclagem Aditiva

// Pose base
const baseAction = mixer.clipAction(baseClip);
baseAction.play();

// Camada aditiva (ex.: respiração)
const additiveAction = mixer.clipAction(additiveClip);
additiveAction.blendMode = THREE.AdditiveAnimationBlendMode;
additiveAction.play();

// Converter clip para aditivo
THREE.AnimationUtils.makeClipAdditive(additiveClip);

Utilitários de Animação

import * as THREE from "three";

// Encontrar clip pelo nome
const clip = THREE.AnimationClip.findByName(clips, "Andar");

// Criar subclip
const subclip = THREE.AnimationUtils.subclip(clip, "subclip", 0, 30, 30);

// Converter para aditivo
THREE.AnimationUtils.makeClipAdditive(clip);
THREE.AnimationUtils.makeClipAdditive(clip, 0, referenceClip);

// Clonar clip
const clone = clip.clone();

// Obter duração do clip
clip.duration;

// Otimizar clip (remover keyframes redundantes)
clip.optimize();

// Redefinir clip para o primeiro quadro
clip.resetDuration();

Padrões de Animação Procedural

Suavização com Amortecimento

// Seguir suave / lerp
const target = new THREE.Vector3();
const current = new THREE.Vector3();
const velocity = new THREE.Vector3();

function smoothDamp(current, target, velocity, smoothTime, deltaTime) {
  const omega = 2 / smoothTime;
  const x = omega * deltaTime;
  const exp = 1 / (1 + x + 0.48 * x * x + 0.235 * x * x * x);
  const change = current.clone().sub(target);
  const temp = velocity
    .clone()
    .add(change.clone().multiplyScalar(omega))
    .multiplyScalar(deltaTime);
  velocity.sub(temp.clone().multiplyScalar(omega)).multiplyScalar(exp);
  return target.clone().add(change.add(temp).multiplyScalar(exp));
}

function animate() {
  current.copy(smoothDamp(current, target, velocity, 0.3, delta));
  mesh.position.copy(current);
}

Física de Mola

class Spring {
  constructor(stiffness = 100, damping = 10) {
    this.stiffness = stiffness;
    this.damping = damping;
    this.position = 0;
    this.velocity = 0;
    this.target = 0;
  }

  update(dt) {
    const force = -this.stiffness * (this.position - this.target);
    const dampingForce = -this.damping * this.velocity;
    this.velocity += (force + dampingForce) * dt;
    this.position += this.velocity * dt;
    return this.position;
  }
}

const spring = new Spring(100, 10);
spring.target = 1;

function animate() {
  mesh.position.y = spring.update(delta);
}

Oscilação

function animate() {
  const t = clock.getElapsedTime();

  // Onda senoidal
  mesh.position.y = Math.sin(t * 2) * 0.5;

  // Quicar
  mesh.position.y = Math.abs(Math.sin(t * 3)) * 2;

  // Movimento circular
  mesh.position.x = Math.cos(t) * 2;
  mesh.position.z = Math.sin(t) * 2;

  // Figura 8
  mesh.position.x = Math.sin(t) * 2;
  mesh.position.z = Math.sin(t * 2) * 1;
}

Dicas de Desempenho

  1. Compartilhe clips: O mesmo AnimationClip pode ser usado em vários mixers
  2. Otimize clips: Chame clip.optimize() para remover keyframes redundantes
  3. Desative quando fora da tela: Pare as atualizações do mixer para objetos invisíveis
  4. Use LOD para animações: Rigs mais simples para personagens distantes
  5. Limite mixers ativos: Cada mixer.update() tem um custo
// Pausar animação quando não visível
mesh.onBeforeRender = () => {
  action.paused = false;
};

mesh.onAfterRender = () => {
  // Verificar se estará visível no próximo quadro
  if (!isInFrustum(mesh)) {
    action.paused = true;
  }
};

// Cachear clips
const clipCache = new Map();
function getClip(name) {
  if (!clipCache.has(name)) {
    clipCache.set(name, loadClip(name));
  }
  return clipCache.get(name);
}

Veja Também

  • threejs-loaders – Carregar modelos GLTF animados
  • threejs-fundamentals – Clock e loop de animação
  • threejs-shaders – Animação de vértices em shaders

Individual skills in this repo

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

Desesbraker/agentes-vip

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Desesbraker/agentes-vip

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

Desesbraker/agentes-vip

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

Desesbraker/agentes-vip

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

Desesbraker/agentes-vip

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

Desesbraker/agentes-vip

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

Desesbraker/agentes-vip

Best practices for Remotion - Video creation in React

Desesbraker/agentes-vip

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

Desesbraker/agentes-vip

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

Desesbraker/agentes-vip

Automate TikTok tasks via Rube MCP (Composio): upload/publish videos, post photos, manage content, and view user profiles/stats. Always search tools first for current schemas.

Desesbraker/agentes-vip

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

Desesbraker/agentes-vip

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

Desesbraker/agentes-vip

Automate YouTube tasks via Rube MCP (Composio): upload videos, manage playlists, search content, get analytics, and handle comments. Always search tools first for current schemas.

Desesbraker/agentes-vip

Extract transcripts from YouTube videos and generate comprehensive, detailed summaries using intelligent analysis frameworks

Desesbraker/agentes-vip

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

Desesbraker/agentes-vip

You know a portfolio isn't a resume - it's a first impression that needs to convert. You balance creativity with usability. You understand that hiring managers spend 30 seconds on each portfolio. You make those 30 seconds count. You help people stand out without being gimmicky.

Habilidades Relacionadas