Padrões de Integração GSAP
Para usar GSAP com Helios, você deve conduzir a instância da Timeline GSAP usando o estado de frame do Helios. Isso permite que animações GSAP sejam controladas (scrubbed), pausadas e renderizadas frame a frame.
Início Rápido
O Padrão "Timeline Pausada"
- Crie uma Timeline GSAP com
paused: true. - Inscreva-se nas atualizações do Helios.
- Dentro da inscrição, converta o frame do Helios em segundos.
- Chame
timeline.seek(segundos)para sincronizar.
<script type="module">
import { Helios } from '@helios-project/core';
import { gsap } from 'gsap';
// 1. Inicialize o Helios
const helios = new Helios({
fps: 30,
durationInSeconds: 5,
});
// 2. Configure a Timeline GSAP (PAUSADA é crítico)
const tl = gsap.timeline({ paused: true });
// 3. Defina as animações
tl.to(".box", {
rotation: 360,
x: 100,
duration: 2,
ease: "power1.inOut"
})
.to(".box", {
scale: 2,
duration: 2
});
// 4. Inscreva-se e sincronize
helios.subscribe((state) => {
// Converta a contagem de frames em segundos
const timeInSeconds = state.currentFrame / helios.fps;
// Busque o GSAP para o tempo exato
tl.seek(timeInSeconds);
});
// 5. Vincule para Preview
helios.bindToDocumentTimeline();
window.helios = helios;
</script>
Regras Críticas
- Sempre Pausar: A timeline GSAP deve ser inicializada com
{ paused: true }. Se ela reproduzir automaticamente, entrará em conflito com o Helios pelo controle. - Usar Seek: Não use
tl.progress()a menos que calcule o valor normalizado de 0 a 1.tl.seek(segundos)geralmente é mais direto, pois o Helios conhece FPS e a contagem de frames. - Sem
requestAnimationFrame: Não crie seu próprio loop rAF para o GSAP. Deixe o Helios conduzir as atualizações através desubscribe.
Arquivos Fonte
- Exemplo:
examples/gsap-animation/