Patrones de Integración con GSAP
Para usar GSAP con Helios, debes controlar la instancia de la línea de tiempo de GSAP utilizando el estado de frame de Helios. Esto permite que las animaciones de GSAP se desplacen, pausen y rendericen frame por frame.
Inicio Rápido
El Patrón "Línea de Tiempo Pausada"
- Crea una línea de tiempo de GSAP con
paused: true. - Suscríbete a las actualizaciones de Helios.
- Dentro de la suscripción, convierte el frame de Helios a segundos.
- Llama a
timeline.seek(segundos)para sincronizar.
<script type="module">
import { Helios } from '@helios-project/core';
import { gsap } from 'gsap';
// 1. Inicializar Helios
const helios = new Helios({
fps: 30,
durationInSeconds: 5,
});
// 2. Configurar la línea de tiempo de GSAP (PAUSADO es crítico)
const tl = gsap.timeline({ paused: true });
// 3. Definir animaciones
tl.to(".box", {
rotation: 360,
x: 100,
duration: 2,
ease: "power1.inOut"
})
.to(".box", {
scale: 2,
duration: 2
});
// 4. Suscribirse y sincronizar
helios.subscribe((state) => {
// Convertir el número de frame a segundos
const timeInSeconds = state.currentFrame / helios.fps;
// Llevar GSAP al tiempo exacto
tl.seek(timeInSeconds);
});
// 5. Vincular para vista previa
helios.bindToDocumentTimeline();
window.helios = helios;
</script>
Reglas Críticas
- Siempre Pausar: La línea de tiempo de GSAP debe inicializarse con
{ paused: true }. Si se reproduce automáticamente, entrará en conflicto con Helios por el control. - Usar Seek: No uses
tl.progress()a menos que calcules el valor normalizado 0-1.tl.seek(segundos)suele ser más directo ya que Helios conoce el FPS y el número de frames. - Sin
requestAnimationFrame: No crees tu propio bucle rAF para GSAP. Deja que Helios maneje las actualizaciones mediantesubscribe.
Archivos Fuente
- Ejemplo:
examples/gsap-animation/