個人開発 » beatoraja

作業開始¶

#151 のFPSプリセット、#152 のLow Latency Modeと近い領域のため、次に #155 を進めます。

まず既存の描画ループ、FPS制御、VSync/Low Latency設定との関係を確認し、各モードが実際に変更する挙動を明確にしてから実装します。

実装内容¶

VIDEO設定に Frame Pacing を追加しました。

モード定義¶

• Balanced
  • 既存挙動を維持します。
  • Max FPS / VSync / Low Latency Mode の個別設定をそのまま使います。
• Stability
  • 無制限FPS、または表示リフレッシュレートを超えるFPS上限が指定されている場合、起動時の foreground/idle FPS を表示リフレッシュレートへ丸めます。
  • 既に表示リフレッシュレート以下の上限が指定されている場合は、その値を尊重します。
  • 目的は過剰描画を抑えてフレーム時間のばらつきを減らすことです。
• Low Latency
  • フレーム描画の終端で Gdx.gl.glFinish() を呼び出します。
  • #152 の Low Latency Mode: On と同じく、GPUコマンドの蓄積を抑える挙動です。
  • 環境によってはCPU/GPU同期コストでFPS低下やフレームタイム悪化が起きる可能性があります。

その他¶

• config_sys.json に framePacingMode を保存・復元します。
• 既存設定ファイルでは未指定時に Balanced へフォールバックします。
• 起動ログに frame pacing を出力するようにしました。

確認済み¶

• ./gradlew.bat test --tests bms.player.beatoraja.ConfigFileCompatibilityTest --tests bms.player.beatoraja.launcher.LauncherFxmlLoadSmokeTest
• ./gradlew.bat test

完了サマリー¶

• VIDEO設定に Frame Pacing を追加しました。
  • Balanced は既存挙動を維持します。
  • Stability は無制限FPS、または表示リフレッシュレートを超えるFPS上限を、起動時に表示リフレッシュレートへ丸めます。
  • Low Latency はフレーム描画終端で Gdx.gl.glFinish() を呼び出し、GPUコマンドの蓄積を抑えます。
• config_sys.json に framePacingMode を保存・復元するようにしました。
• 既存設定ファイルでは未指定時に Balanced へフォールバックします。
• 起動ログに frame pacing を出力するようにしました。

確認¶

• ./gradlew.bat test --tests bms.player.beatoraja.ConfigFileCompatibilityTest --tests bms.player.beatoraja.launcher.LauncherFxmlLoadSmokeTest
• ./gradlew.bat test
• 実機確認OK

Commit¶

• 0fc8c482 refs#155 Add frame pacing mode