Communitygithub.com

Bailipa/EZTor_FULLBLOOD

Verwenden beim Abspielen von Animationen, Überblenden zwischen Animationszuständen oder Laden von Skelett-Animationen aus GLTF in Three.js. Verhindert häufige Fehler wie das Vergessen von mixer.update(delta) pro Frame, falsche Crossfade-Einrichtung oder fehlende Clock.

Was ist EZTor_FULLBLOOD?

Diese Fähigkeit (Skill) bietet eine umfassende Referenz zur Implementierung von Animationen in Three.js, insbesondere für den Umgang mit dem Animationssystem (AnimationMixer, AnimationClip, AnimationAction, KeyframeTrack) und der Clock. Sie ist als zuverlässiger Leitfaden für Entwickler gedacht, die GLTF-Animationen laden, abspielen und überblenden (crossfaden) möchten, ohne in typische Fallstricke zu tappen. Der Skill beschreibt detailliert die Architektur (Mixer pro Wurzelobjekt, Clock für Delta-Zeit), die korrekte Einrichtung eines minimalen Animationsloops, die Verwendung von Blend-Modi (normal vs. additiv) und die Implementierung eines Zustandsautomaten für Charakter-Überblendungen. Er enthält auch wichtige Warnungen (z. B. niemals mixer.update vergessen, Clock statt performance.now verwenden) und deckt Plattformen wie Three.js ab. Die enthaltenen Codebeispiele, Tabellen zu Eigenschaften und Methoden sowie die Erklärung von KeyframeTrack-Typen machen ihn zu einem praktischen Nachschlagewerk für fortgeschrittene Animationstechniken in der 3D-Grafik.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

threejs-impl-animation

Kurzreferenz

Architektur

AnimationClip        (Daten: Array von KeyframeTrack-Objekten)
  └── AnimationAction  (Wiedergabesteuerung: play, pause, fade, crossfade)
        └── AnimationMixer (Master-Scheduler: einer pro animiertem Wurzelobjekt)
              └── Clock    (liefert Delta-Zeit für mixer.update)

ALWAYS genau EINEN AnimationMixer pro animiertem Wurzelobjekt erstellen. ALWAYS mixer.update(delta) in jedem Frame innerhalb der Render-Schleife aufrufen. NIEMALS AnimationAction direkt instanziieren – ALWAYS mixer.clipAction(clip) verwenden.

Wichtige Imports

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

Minimales Animations-Setup

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

  // Alle Animationen aus der GLTF-Datei abspielen
  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);

Kritische Warnungen

NIEMALS vergessen, mixer.update(delta) in der Render-Schleife aufzurufen – Animationen werden OHNE diesen Aufruf NICHT abgespielt.

NIEMALS new Date() oder performance.now() verwenden, um Delta manuell zu berechnen – ALWAYS THREE.Clock oder renderer.setAnimationLoop nutzen, die stabile Frame-Zeiten liefern.

NIEMALS mixer.clipAction(clip) wiederholt in der Render-Schleife aufrufen – es wird zwar intern gecached, aber der Lookup ist unnötiger Overhead. ALWAYS die zurückgegebene Aktion in einer Variablen speichern.

NIEMALS .play() in jedem Frame aufrufen – einmal aufrufen, um die Wiedergabe zu starten. Ein erneuter Aufruf von .play() bei einer bereits laufenden Aktion hat keine Wirkung, zeigt aber ein Missverständnis an.

ALWAYS .reset() vor .play() aufrufen, wenn eine gestoppte oder beendete Aktion neu gestartet wird – andernfalls kann die Aktion von ihrer letzten Position fortsetzen.

ALWAYS action.clampWhenFinished = true setzen, wenn LoopOnce verwendet wird – andernfalls setzt die Aktion beim Beenden auf den ersten Frame zurück.


AnimationMixer

Der Master-Scheduler, der alle Animationsaktionen für eine einzelne Objekthierarchie steuert.

Konstruktor

const mixer = new THREE.AnimationMixer(rootObject);

rootObject ist das Wurzel-Object3D des animierten Modells (normalerweise gltf.scene).

Eigenschaften

EigenschaftTypStandardBeschreibung
.timenumber0Globale Mixer-Zeit in Sekunden
.timeScalenumber1Globaler Geschwindigkeitsmultiplikator; 0 pausiert ALLE Aktionen

Methoden

MethodeRückgabeBeschreibung
.clipAction(clip, root?, blendMode?)AnimationActionGibt eine Aktion für den Clip zurück oder erstellt sie
.existingAction(clip, root?)AnimationAction | nullGibt eine zuvor erstellte Aktion oder null zurück
.update(delta)thisBewegt den Mixer um delta Sekunden vorwärts – MUSS in jedem Frame aufgerufen werden
.setTime(seconds)thisSetzt die globale Zeit, aktualisiert alle Aktionen
.stopAllAction()thisDeaktiviert alle geplanten Aktionen
.getRoot()Object3DGibt das Wurzelobjekt des Mixers zurück
.uncacheAction(clip, root?)voidGibt eine gecachte Aktion frei
.uncacheClip(clip)voidGibt Clip-Daten frei
.uncacheRoot(root)voidGibt Wurzelobjekt-Daten frei

Ereignisse

Hören Sie mit mixer.addEventListener(type, callback):

EreignisWird ausgelöst, wenn
'finished'Aktion abgeschlossen (NUR bei LoopOnce + clampWhenFinished = true)
'loop'Aktion eine Schleifeniteration abgeschlossen hat

Ereignisobjekt-Eigenschaften: { action, loopDelta, type }.

Blend-Modi

Als drittes Argument an mixer.clipAction(clip, root, blendMode) übergeben:

KonstanteVerhalten
THREE.NormalAnimationBlendModeStandard-Überblendung (Standard)
THREE.AdditiveAnimationBlendModeÜberlagert auf der Basis-Animation

AnimationAction

Steuert die Wiedergabe eines einzelnen Animationsclips. NIEMALS direkt instanziieren.

Eigenschaften

EigenschaftTypStandardBeschreibung
.blendModenumberNormalAnimationBlendModeÜberblendungsstrategie
.clampWhenFinishedbooleanfalseAm letzten Frame pausieren, wenn fertig
.enabledbooleantrueDeaktivieren ohne Zurücksetzen
.loopnumberLoopRepeatSchleifenmodus
.pausedbooleanfalseWiedergabe einfrieren
.repetitionsnumberInfinitySchleifenanzahl
.timenumber0Lokale Zeit in Sekunden
.timeScalenumber1Geschwindigkeit: 0 pausiert, negativ kehrt um
.weightnumber1Blend-Einfluss [0, 1]
.zeroSlopeAtEndbooleantrueGlatte Interpolation am Schleifenende
.zeroSlopeAtStartbooleantrueGlatte Interpolation am Schleifenstart

Schleifenmodi

KonstanteVerhalten
THREE.LoopOnceEinmal abspielen, dann anhalten
THREE.LoopRepeatAm Anfang jeder Schleife neu starten
THREE.LoopPingPongWechselt vorwärts/rückwärts

Wiedergabe-Methoden

MethodeBeschreibung
.play()Wiedergabe starten
.stop()Anhalten und auf Start zurücksetzen
.reset()Zeit, Gewicht und Geschwindigkeit auf Ausgangszustand zurücksetzen
.startAt(mixerTime)Start bis zur angegebenen Mixer-Zeit verzögern

Überblendungs- und Crossfade-Methoden

MethodeBeschreibung
.fadeIn(duration)Gewicht von 0 auf 1 überblenden
.fadeOut(duration)Gewicht von 1 auf 0 überblenden
.crossFadeFrom(fadeOutAction, duration, warp)Von einer anderen Aktion in diese überblenden
.crossFadeTo(fadeInAction, duration, warp)Von dieser Aktion in eine andere überblenden
.stopFading()Aktives Überblenden abbrechen

Geschwindigkeits- und Timing-Methoden

MethodeBeschreibung
.halt(duration)timeScale über die Dauer auf 0 verlangsamen
.warp(startScale, endScale, duration)Wiedergabegeschwindigkeit sanft überblenden
.stopWarping()Aktives Warp abbrechen
.setDuration(seconds)timeScale so anpassen, dass eine Schleife genau seconds dauert
.setEffectiveTimeScale(scale)Effektiven Zeitmaßstab setzen
.setEffectiveWeight(weight)Effektives Gewicht setzen
.setLoop(mode, repetitions)Schleifenmodus und -anzahl setzen
.syncWith(otherAction)Zeit mit einer anderen Aktion synchronisieren

Abfrage-Methoden

MethodeRückgabeBeschreibung
.isRunning()booleantrue nur, wenn aktiv abgespielt wird
.isScheduled()booleantrue, wenn .play() aufgerufen wurde
.getClip()AnimationClipDer zugehörige Clip
.getMixer()AnimationMixerDer besitzende Mixer
.getRoot()Object3DDas Wurzelobjekt
.getEffectiveTimeScale()numberBerechneter Zeitmaßstab
.getEffectiveWeight()numberBerechnetes Gewicht

AnimationClip

Ein wiederverwendbarer Satz von Keyframe-Spuren. Normalerweise aus GLTF-Dateien geladen.

Konstruktor

const clip = new THREE.AnimationClip(name, duration, tracks, blendMode);
  • name – Zeichenketten-Identifikator (GLTF-Clips verwenden Namen aus der Datei)
  • duration – Sekunden; -1 für automatische Berechnung aus den Spuren
  • tracks – Array von KeyframeTrack-Objekten
  • blendMode – optionaler Blend-Mode-Konstante

Wichtige statische Methoden

MethodeBeschreibung
AnimationClip.findByName(arrayOrObject, name)Clip nach Namen suchen
AnimationClip.CreateFromMorphTargetSequence(name, targets, fps, noLoop)Clip aus Morph-Zielen erstellen
AnimationClip.parse(json)Aus JSON deserialisieren

KeyframeTrack-Typen

SpurtypWerttypAnwendungsfall
VectorKeyframeTrackVector3Position, Skalierung
QuaternionKeyframeTrackQuaternionRotation (verwendet Slerp)
NumberKeyframeTracknumberDeckkraft, Intensität
BooleanKeyframeTrackbooleanSichtbarkeit umschalten
ColorKeyframeTrackColorFarbanimation
StringKeyframeTrackstringDiskrete Zeichenkettenwerte

Interpolationsmodi

KonstanteVerhalten
THREE.InterpolateDiscreteSprungfunktion, keine Glättung
THREE.InterpolateLinearLineare Interpolation (Standard)
THREE.InterpolateSmoothKubische Spline-Interpolation

PropertyBinding-Pfadformat

"meshName.position"                    // Position animieren
"meshName.material.opacity"            // Materialeigenschaft animieren
"meshName.morphTargetInfluences[0]"    // Morph-Ziel animieren
"boneName.quaternion"                  // Knochenrotation animieren

Clock

Konstruktor

const clock = new THREE.Clock(autoStart); // autoStart standardmäßig true

Methoden

MethodeRückgabeBeschreibung
.getDelta()numberSekunden seit dem letzten getDelta()-Aufruf
.getElapsedTime()numberGesamtverstrichene Zeit in Sekunden
.start()voidUhr starten
.stop()voidAnhalten ohne zurückzusetzen

Crossfade-Muster (Charakter-Zustandsautomat)

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

ALWAYS .reset() auf der eingehenden Aktion vor dem Crossfade aufrufen. ALWAYS die Referenz auf die aktuelle Aktion für die nächste Transition speichern.


Additive Animationsüberblendung

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

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

Additives Blending für überlagerte Effekte verwenden: Atmen, Schadensreaktionen, Zieloffsets.


Morph-Ziel-Animation

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

// Über GLTF-Animationsclip (bevorzugt)
const morphAction = mixer.clipAction(morphClip);
morphAction.play();

Referenzlinks

Offizielle Quellen

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.

Verwandte Skills