タイムライン状態と再生

タイムラインはMovie全体の時刻、書き出し範囲、フレームレート、キーフレームを管理します。Objectsの時間レポーター、動画、音声、render frameはこのタイムラインを共有します。

設定値

設定	既定値	正規化
duration	10秒	0.1〜3600秒。無効値は10秒
framerate	30 fps	1〜120 fps
width / height	ステージサイズ	設定UIでは各1〜4096 px
rangeStart	0秒	0〜duration
rangeEnd	duration	rangeStart〜duration
exportFormat	mp4	mp4、webm、png-sequence、png-frame、audio-wav
reuseFrames	true	falseならキャッシュを使わない

保存されるタイムラインの主なキーは、duration、exportFormat、framerate、height、keyframes、rangeEnd、rangeStart、reuseFrames、sound、widthです。

再生状態

• playは、現在時刻がduration以上なら0秒へ戻し、音声とVM実行を再初期化します。
• pauseは実時間から現在時刻をサンプルし、音声、実行スレッド、プレビューサイズを停止・復元します。
• stopは0秒へ戻し、未完了の書き出しをキャンセルします。
• seekは再生状態を維持したまま指定時刻へ移動し、次のフレームを再評価します。

UIでは、再生、ポーズ、停止、時刻のスクラブ、キーフレームの追加・削除、フレーム単位の移動、先頭・末尾移動、タイムライン表示のズームを行えます。

プレビューと書き出しの時刻

再生中のevent_renderframeは実時間に基づきます。書き出し中は、次の決定的な時刻を使います。

renderFrameIndex / framerate

この違いにより、プレビューは再生操作に追従し、書き出しはフレーム番号から再現可能になります。

キーフレーム

キーフレームは0〜durationへクランプし、昇順に並べます。ほぼ同じ時刻（差が1e-9以下）のキーフレームは重複排除されます。keyframe timeのIDは1始まりで、範囲外のIDは有効な範囲へクランプされます。

キーフレームがない場合の時刻は0です。小数のIDは隣接キーフレーム間を線形補間し、left keyframe timeは2つの結果の小さい方を返します。

表示プリセット

プリセット	FPS	出力サイズ
Preview 720p	24	1280×720
Final 1080p	30	1920×1080
Final 4K	30	3840×2160

書き出し範囲、解像度、FPS、形式、フレーム再利用の設定と、診断警告から該当ブロックへフォーカスする機能をタイムラインUIが提供します。出力処理の詳細はタイムラインと書き出しを参照してください。