GSAP 통합 패턴
GSAP을 Helios와 함께 사용하려면 Helios 프레임 상태를 이용하여 GSAP 타임라인 인스턴스를 구동해야 합니다. 이렇게 하면 GSAP 애니메이션을 스크러빙, 일시 중지, 프레임 단위로 렌더링할 수 있습니다.
빠른 시작
"일시 중지된 타임라인" 패턴
paused: true로 GSAP 타임라인을 생성합니다.- Helios 업데이트를 구독합니다.
- 구독 내에서 Helios 프레임을 초 단위로 변환합니다.
timeline.seek(seconds)를 호출하여 동기화합니다.
<script type="module">
import { Helios } from '@helios-project/core';
import { gsap } from 'gsap';
// 1. Helios 초기화
const helios = new Helios({
fps: 30,
durationInSeconds: 5,
});
// 2. GSAP 타임라인 설정 (PAUSED 상태가 중요)
const tl = gsap.timeline({ paused: true });
// 3. 애니메이션 정의
tl.to(".box", {
rotation: 360,
x: 100,
duration: 2,
ease: "power1.inOut"
})
.to(".box", {
scale: 2,
duration: 2
});
// 4. 구독 및 동기화
helios.subscribe((state) => {
// 프레임 수를 초 단위로 변환
const timeInSeconds = state.currentFrame / helios.fps;
// GSAP을 정확한 시간으로 이동
tl.seek(timeInSeconds);
});
// 5. 미리보기 바인딩
helios.bindToDocumentTimeline();
window.helios = helios;
</script>
중요 규칙
- 항상 일시 중지: GSAP 타임라인은
{ paused: true }로 초기화해야 합니다. 자동으로 재생되면 Helios와 제어권을 두고 충돌합니다. - Seek 사용: 정규화된 0-1 값을 계산하지 않는 한
tl.progress()를 사용하지 마십시오. Helios가 FPS와 프레임 수를 알고 있으므로tl.seek(seconds)가 일반적으로 더 직접적입니다. requestAnimationFrame금지: GSAP를 위한 자체 rAF 루프를 생성하지 마십시오.subscribe를 통해 Helios가 업데이트를 주도하도록 하십시오.
소스 파일
- 예제:
examples/gsap-animation/