プロジェクト

全般

プロフィール

機能 #157

完了

VIDEO設定: BGA Quality / 負荷軽減設定の追加

機能 #157: VIDEO設定: BGA Quality / 負荷軽減設定の追加

エージェント ちゃん さんが27日前に追加. 22日前に更新.

ステータス:
完了
優先度:
通常
担当者:
対象バージョン:
開始日:
2026/06/09
期日:
進捗率:

100%

予定工数:

説明

#143 から分割。

概要

BGAのON/OFFだけでなく、負荷調整用のグローバル設定を追加する。

想定UI

  • BGA Quality: Low / Medium / High
  • BGA FPS Limit: 30 / 60 / Unlimited
  • BGA Brightness: 0% - 100%

目的

  • BGAは表示したいが、ゲーム本体の描画安定性を優先したい場合に使えるようにする
  • 動画再生負荷によるフレーム落ちを抑える
  • 視認性向上のためBGAを暗くできるようにする

実装前に確認すること

既存のスキン設定側BGA関連項目との関係を整理し、グローバル設定として上書きする範囲を定義する。


関連するチケット 1 (0件未完了1件完了)

関連している beatoraja - 機能 #143: ディスプレイ設定機能の改善完了いづ さん2026/06/09

操作

いづ さん さんが27日前に更新 操作 #1

  • 関連している 機能 #143: ディスプレイ設定機能の改善 を追加

エージェント ちゃん さんが27日前に更新 操作 #2

  • ステータス未着手 から 設計中 に変更
  • 進捗率0 から 10 に変更

作業開始

#157 を実装します。

既存のスキン側BGA設定との関係は、スキンのBGA配置・拡大設定は維持し、今回追加する設定はグローバルなBGA負荷調整として適用する方針で進めます。まず BGAProcessor / FFmpegProcessor / SkinBGA 周辺を確認し、動画FPS制限・明るさ・品質設定を実際の描画/デコードに接続します。

エージェント ちゃん さんが27日前に更新 操作 #3

  • ステータス設計中 から テスト中 に変更
  • 進捗率10 から 50 に変更

実装内容

VIDEO設定のBGAセクションに以下を追加しました。

  • BGA Quality
    • Low / Medium / High
    • 通常BGA静止画の描画フィルタを切り替えます。
    • レイヤーBGAは既存スキン表現を維持するため、従来のレイヤー描画を使います。
  • BGA FPS Limit
    • 30 / 60 / Unlimited
    • 動画BGAの実FPSから必要な間引き率を計算し、既存 frameskip と比較して大きい方を適用します。
    • 例: 120fps動画を 60 にした場合はおおむね1/2間引きになります。
  • BGA Brightness
    • 0 - 100
    • BGA描画時のRGB係数として適用します。

既存設定との関係

  • 既存の BGA On/Auto/Off は読み込み可否の制御として維持しています。
  • 既存の BGA Expand はスキン側BGA領域への拡大方法として維持しています。
  • 今回の設定はグローバルな負荷軽減/視認性調整として、BGAが表示される場合に上乗せで適用します。

保存/互換性

  • config_sys.json に以下を保存・復元します。
    • bgaQuality
    • bgaFpsLimit
    • bgaBrightness
  • 既存設定ファイルでは以下へフォールバックします。
    • BGA Quality: Medium
    • BGA FPS Limit: Unlimited
    • BGA Brightness: 100
  • 起動ログにBGA設定を出力するようにしました。

確認済み

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

エージェント ちゃん さんが27日前に更新 操作 #4

  • ステータステスト中 から 完了 に変更
  • 進捗率50 から 100 に変更

完了サマリー

  • VIDEO設定のBGAセクションに以下を追加しました。
    • BGA Quality: Low / Medium / High
    • BGA FPS Limit: 30 / 60 / Unlimited
    • BGA Brightness: 0 - 100
  • 通常BGA静止画の描画フィルタを BGA Quality で切り替えるようにしました。
  • 動画BGAは実FPSから必要な間引き率を計算し、既存 frameskip と比較して大きい方を適用するようにしました。
  • BGA描画時に BGA Brightness をRGB係数として適用するようにしました。
  • 既存の BGA On/Auto/OffBGA Expand は維持し、今回の設定はBGA表示時のグローバル負荷軽減/視認性調整として上乗せしています。
  • config_sys.json に新設定を保存・復元し、既存設定では Medium / Unlimited / 100 へフォールバックします。
  • 起動ログにBGA設定を出力するようにしました。

確認

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

Commit

  • 13f82a8c refs#157 Add BGA quality controls

いづ さん さんが22日前に更新 操作 #5

  • 対象バージョン1.0.0 にセット

他の形式にエクスポート: PDF Atom