Communitygithub.com

Aadi-110i/PEP-PROJECT

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

O que é PEP-PROJECT?

Esta habilidade fornece um guia abrangente para o sistema de animação Three.js. Ela cobre desde animações simples e procedurais com Clock até componentes avançados como AnimationClip, AnimationMixer e AnimationAction. É ideal para desenvolvedores que trabalham com modelos 3D animados em aplicações web, suportando tanto animações carregadas (GLTF) quanto animações procedurais programáticas. A habilidade explica como criar e manipular keyframes de diferentes tipos (número, vetor, quaternion, cor, booleano, string), configurar modos de interpolação, controlar a reprodução com fade in/out e crossfade, e trabalhar com animação esquelética e morph targets. Além disso, inclui padrões de animação procedural como damping suave, física de mola e oscilação, além de dicas de desempenho para otimizar múltiplos mixers e clips. A documentação é prática, com exemplos de código prontos para uso e referência direta às APIs do Three.js, sendo compatível com todas as plataformas que utilizam Three.js (web, WebXR, etc.).

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Aadi-110i/PEP-PROJECT/tree/HEAD/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

Início Rápido

import * as THREE from "three";

// Animação procedural simples
const clock = new THREE.Clock();

function animate() {
  const delta = clock.getDelta();
  const elapsed = clock.getElapsedTime();

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

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

Visão Geral do Sistema de Animação

O sistema de animação Three.js tem 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 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[smile]",
  [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

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 repetida:", 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 = reversa)
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/trás
action.repetitions = 3; // Número de repetições (Infinity padrão)

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

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

// Depois, 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 por nome
  const walkClip = THREE.AnimationClip.findByName(clips, "Walk");
  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 SkinnedMesh
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 por nome
const headBone = skeleton.bones.find((b) => b.name === "Head");
if (headBone) headBone.rotation.y = Math.PI / 4; // Virar cabeça

// Auxiliar de 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 === "Head");
  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 === "RightHand");
if (handBone) handBone.add(weapon);

// Deslocar 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 morph:", Object.keys(geometry.morphAttributes));

// Acessar influências dos morph targets
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["smile"];
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[smile]",
  [0, 0.5, 1],
  [0, 1, 0],
);
const clip = new THREE.AnimationClip("smile", 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 baseado 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 por nome
const clip = THREE.AnimationClip.findByName(clips, "Walk");

// 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

Damping Suave

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

  // Quique
  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. Compartilhar clips: O mesmo AnimationClip pode ser usado em vários mixers
  2. Otimizar clips: Chame clip.optimize() para remover keyframes redundantes
  3. Desabilitar quando fora da tela: Pare atualizações do mixer para objetos invisíveis
  4. Usar LOD para animações: Rigs mais simples para personagens distantes
  5. Limitar 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 será visível no próximo quadro
  if (!isInFrustum(mesh)) {
    action.paused = true;
  }
};

// Cache de 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 - Carregando 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 13 individual skills — each has its own dedicated page.

Aadi-110i/PEP-PROJECT

Create AI avatar and talking head videos via inference.sh CLI. Recommended: P-Video-Avatar (fastest, cheapest, built-in TTS). Also: OmniHuman, Fabric, PixVerse. Capabilities: audio-driven avatars, text-to-avatar, lipsync videos, talking head generation, virtual presenters. Use for: AI presenters, explainer videos, virtual influencers, dubbing, marketing videos. Triggers: ai avatar, talking head, lipsync, avatar video, virtual presenter, ai spokesperson, audio driven video, heygen alternative, synthesia alternative, talking avatar, lip sync, video avatar, ai presenter, digital human

Aadi-110i/PEP-PROJECT

Create AI marketing videos for ads, promos, product launches, and brand content. Models: Veo, Seedance, Wan, FLUX for visuals, Kokoro for voiceover. Types: product demos, testimonials, explainers, social ads, brand videos. Use for: Facebook ads, YouTube ads, product launches, brand awareness. Triggers: marketing video, ad video, promo video, commercial, brand video, product video, explainer video, ad creative, video ad, facebook ad video, youtube ad, instagram ad, tiktok ad, promotional video, launch video

Aadi-110i/PEP-PROJECT

Generate AI videos with Google Veo, Seedance 2.0, HappyHorse, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 2.0, HappyHorse 1.0, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, reference-to-video, video editing, lipsync, avatar animation, video upscaling, foley sound. Use for: social media videos, marketing content, explainer videos, product demos, AI avatars. Triggers: video generation, ai video, text to video, image to video, veo, animate image, video from image, ai animation, video generator, generate video, t2v, i2v, ai video maker, create video with ai, runway alternative, pika alternative, sora alternative, kling alternative, seedance, happyhorse

Aadi-110i/PEP-PROJECT

ElevenLabs text-to-speech with 22+ premium voices, multilingual support, and voice tuning via inference.sh CLI. Models: eleven_multilingual_v2 (highest quality), eleven_turbo_v2_5 (low latency), eleven_flash_v2_5 (ultra-fast). Capabilities: text-to-speech, voice selection, stability/style control, 32 languages. Use for: voiceovers, audiobooks, video narration, podcasts, accessibility, IVR. Triggers: elevenlabs, eleven labs, elevenlabs tts, premium tts, professional voice, ai voice, high quality tts, multilingual tts, eleven labs voice, voice generation, natural speech, realistic voice, voice over, speech synthesis

Aadi-110i/PEP-PROJECT

Explainer video production guide: scripting, voiceover, visuals, and assembly. Covers script formulas, pacing rules, scene planning, and multi-tool pipelines. Use for: product demos, how-it-works videos, onboarding videos, social explainers. Triggers: explainer video, how to make explainer, product video, demo video, video production, video script, animated explainer, product demo video, tutorial video, onboarding video, walkthrough video, video pipeline

Aadi-110i/PEP-PROJECT

Still-to-video conversion guide: model selection, motion prompting, and camera movement. Covers Wan 2.5 i2v, Seedance, Fabric, Grok Video with when to use each. Use for: animating images, creating video from stills, adding motion, product animations. Triggers: image to video, i2v, animate image, still to video, add motion to image, image animation, photo to video, animate still, wan i2v, image2video, bring image to life, animate photo, motion from image

Aadi-110i/PEP-PROJECT

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

Aadi-110i/PEP-PROJECT

Generate talking head avatar videos with Pruna P-Video-Avatar via inference.sh CLI. Turn a portrait image into a realistic speaking video with built-in TTS. 18x faster and 6x cheaper than competitors. Models: P-Video-Avatar, P-Image (for portrait generation). Capabilities: text-to-avatar, audio-driven avatars, 30 voices, 10 languages, 720p/1080p, built-in TTS, dynamic backgrounds, full-body control. Use for: AI presenters, product demos, explainer videos, virtual influencers, marketing, education, multilingual content, UGC, gaming avatars. Triggers: avatar video, talking head, ai avatar, p-video-avatar, pruna avatar, video avatar, ai presenter, digital human, virtual presenter, lipsync, talking avatar, ai spokesperson, heygen alternative, synthesia alternative, veed alternative, fabric alternative, omnihuman alternative

Aadi-110i/PEP-PROJECT

Generate videos with Pruna P-Video and WAN models via inference.sh CLI. Models: P-Video, WAN-T2V, WAN-I2V. Capabilities: text-to-video, image-to-video, audio support, 720p/1080p, fast inference. Pruna optimizes models for speed without quality loss. Triggers: pruna video, p-video, pruna ai video, fast video generation, optimized video, wan t2v, wan i2v, economic video generation, cheap video generation, pruna text to video, pruna image to video

Aadi-110i/PEP-PROJECT

Render videos from React/Remotion component code via inference.sh. Pass TSX code, get MP4. Supports all Remotion APIs: useCurrentFrame, useVideoConfig, spring, interpolate, AbsoluteFill, Sequence. Configurable resolution, FPS, duration, codec. Use for: programmatic video generation, animated graphics, motion design, data-driven videos, React animations to video. Triggers: remotion, render video from code, tsx to video, react video, programmatic video, remotion render, code to video, animated video, motion graphics code, react animation video

Aadi-110i/PEP-PROJECT

Video ad creation with exact platform-specific specs for TikTok, Instagram, YouTube, Facebook, LinkedIn. Covers dimensions, duration limits, AIDA framework, and caption requirements. Use for: video ads, social media ads, paid media creative, video marketing, ad production. Triggers: video ad, social media ad, tiktok ad, instagram ad, youtube ad, facebook ad, linkedin ad, video creative, ad specs, paid media, video marketing, ad production, reels ad, stories ad, pre roll, bumper ad

Aadi-110i/PEP-PROJECT

Best practices and techniques for writing effective AI video generation prompts. Covers: Veo, Seedance, Wan, Grok, Kling, Runway, Pika, Sora prompting strategies. Learn: shot types, camera movements, lighting, pacing, style keywords, negative prompts. Use for: improving video quality, getting consistent results, professional video prompts. Triggers: video prompt, how to prompt video, veo prompts, video generation tips, better ai video, video prompt engineering, video prompt guide, video prompt template, ai video tips, video prompt best practices, video prompt examples, cinematography prompts

Aadi-110i/PEP-PROJECT

YouTube thumbnail design with specific dimensions, contrast rules, and mobile preview optimization. Covers safe zones, text placement, face expression psychology, and A/B testing. Use for: YouTube thumbnails, video cover images, click-through optimization. Triggers: youtube thumbnail, thumbnail design, video thumbnail, click through rate, ctr optimization, youtube cover, video cover image, thumbnail maker, thumbnail tips, youtube design, video preview image

Habilidades Relacionadas