GSAP 統合パターン
Helios で GSAP を使用するには、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 と制御を競合します。 - シークを使用する: 正規化された 0~1 の値を計算しない限り、
tl.progress()は使用しないでください。tl.seek(seconds)の方が、Helios が FPS とフレーム数を認識しているため、通常はより直接的です。 requestAnimationFrameは使わない: GSAP のために独自の rAF ループを作成しないでください。subscribeを介して Helios に更新を任せてください。
ソースファイル
- 例:
examples/gsap-animation/