GSAP-Integrationsmuster
Um GSAP mit Helios zu verwenden, musst du die GSAP-Timeline-Instanz mit dem Helios-Frame-Zustand steuern. So können GSAP-Animationen durchsucht (gescrubbt), pausiert und frame-genau gerendert werden.
Schnellstart
Das „Pausierte Timeline“-Muster
- Erstelle eine GSAP-Timeline mit
paused: true. - Abonniere die Helios-Updates.
- Konvertiere innerhalb des Abonnements den Helios-Frame in Sekunden.
- Rufe
timeline.seek(seconds)zur Synchronisation auf.
<script type="module">
import { Helios } from '@helios-project/core';
import { gsap } from 'gsap';
// 1. Helios initialisieren
const helios = new Helios({
fps: 30,
durationInSeconds: 5,
});
// 2. GSAP-Timeline einrichten (PAUSED ist entscheidend)
const tl = gsap.timeline({ paused: true });
// 3. Animationen definieren
tl.to(".box", {
rotation: 360,
x: 100,
duration: 2,
ease: "power1.inOut"
})
.to(".box", {
scale: 2,
duration: 2
});
// 4. Abonnieren und synchronisieren
helios.subscribe((state) => {
// Frame-Anzahl in Sekunden umrechnen
const timeInSeconds = state.currentFrame / helios.fps;
// GSAP zur exakten Zeit bringen
tl.seek(timeInSeconds);
});
// 5. Für die Vorschau binden
helios.bindToDocumentTimeline();
window.helios = helios;
</script>
Kritische Regeln
- Immer pausieren: Die GSAP-Timeline muss mit
{ paused: true }initialisiert werden. Wenn sie automatisch abläuft, konkurriert sie mit Helios um die Kontrolle. seekverwenden: Verwende nichttl.progress(), es sei denn, du berechnest den normalisierten Wert zwischen 0 und 1.tl.seek(seconds)ist in der Regel direkter, da Helios FPS und Frame-Anzahl kennt.- Kein
requestAnimationFrame: Erstelle keine eigene rAF-Schleife für GSAP. Lass Helios die Updates übersubscribesteuern.
Quelldateien
- Beispiel:
examples/gsap-animation/