Modèles d'intégration GSAP
Pour utiliser GSAP avec Helios, vous devez piloter l'instance GSAP Timeline en utilisant l'état d'image d'Helios. Cela permet aux animations GSAP d'être contrôlées, mises en pause et rendues image par image.
Démarrage rapide
Le modèle "Timeline en pause"
- Créez une timeline GSAP avec
paused: true. - Abonnez-vous aux mises à jour d'Helios.
- Dans l'abonnement, convertissez l'image Helios en secondes.
- Appelez
timeline.seek(seconds)pour synchroniser.
<script type="module">
import { Helios } from '@helios-project/core';
import { gsap } from 'gsap';
// 1. Initialisation d'Helios
const helios = new Helios({
fps: 30,
durationInSeconds: 5,
});
// 2. Configuration de la timeline GSAP (PAUSED est essentiel)
const tl = gsap.timeline({ paused: true });
// 3. Définition des animations
tl.to(".box", {
rotation: 360,
x: 100,
duration: 2,
ease: "power1.inOut"
})
.to(".box", {
scale: 2,
duration: 2
});
// 4. Abonnement et synchronisation
helios.subscribe((state) => {
// Conversion du nombre d'images en secondes
const timeInSeconds = state.currentFrame / helios.fps;
// Recherche GSAP à l'instant exact
tl.seek(timeInSeconds);
});
// 5. Liaison pour la prévisualisation
helios.bindToDocumentTimeline();
window.helios = helios;
</script>
Règles critiques
- Toujours mettre en pause : La timeline GSAP doit être initialisée avec
{ paused: true }. Si elle joue automatiquement, elle entrera en conflit avec Helios pour le contrôle. - Utiliser Seek : N'utilisez pas
tl.progress()sauf si vous calculez la valeur normalisée 0-1.tl.seek(seconds)est généralement plus direct car Helios connaît le FPS et le nombre d'images. - Pas de
requestAnimationFrame: Ne créez pas votre propre boucle rAF pour GSAP. Laissez Helios piloter les mises à jour viasubscribe.
Fichiers sources
- Exemple :
examples/gsap-animation/