LCOV - code coverage report
Current view: top level - vrt/replay - replay.go Coverage Total Hit
Test: coverage.lcov Lines: 88.5 % 26 23
Test Date: 2026-11-19 00:25:22 Functions: - 0 0

            Line data    Source code
       1              : // Package replay は実在メニュー state を本番の MainGame ループで Action 列から駆動する。
       2              : // 本番との違いは入力の出どころだけで、キーボードから変換する代わりに Action 列をそのまま
       3              : // 供給する。更新も描画も本番と同じ MainGame.Update・MainGame.Draw を通す。
       4              : //
       5              : // vrt 本体へ menuloop 依存を持ち込むと menuloop のテストとで import 循環になるため、
       6              : // ここを vrt のサブパッケージに分けて循環を避ける。vrt の公開シンボルだけ使う。
       7              : package replay
       8              : 
       9              : import (
      10              :         "testing"
      11              : 
      12              :         "github.com/hajimehoshi/ebiten/v2"
      13              :         "github.com/kijimaD/ruins/internal/consts"
      14              :         es "github.com/kijimaD/ruins/internal/engine/states"
      15              :         "github.com/kijimaD/ruins/internal/inputmapper"
      16              :         "github.com/kijimaD/ruins/internal/maingame"
      17              :         "github.com/kijimaD/ruins/internal/vrt"
      18              :         w "github.com/kijimaD/ruins/internal/world"
      19              : 
      20              :         "github.com/stretchr/testify/require"
      21              : )
      22              : 
      23              : // PlayScenario は buildStates で組んだ state を本番の MainGame ループで actions から駆動し、
      24              : // 駆動し終えた MainGame を返す。遷移結果は game.StateMachine から検査できる。
      25              : //
      26              : // フレーム数は len(actions)+1 になる。StateMachine は state が返した遷移を次フレーム冒頭で
      27              : // 適用するので、最後の Action の Push/Pop を確定させる1フレームを足す。capture は各フレームの
      28              : // 描画後に0起点のフレーム番号で呼ぶ。nil なら駆動のみで描画しない。画はフレームごとに
      29              : // 作るので、抱え込まずその場で撮り切る。明示的な解放はしない。別 goroutine から ebiten 画像を
      30              : // Deallocate すると、裏で回るレンダーループの atlas 処理と競合するため、解放は GC に委ねる。
      31              : //
      32              : // state 側に再生用の口は要らない。入力供給源は world が持ち、押し込んだ先の state にも同じ源が
      33              : // 効く。world は自前の独立フェイスを持つので、駆動と描画はロック無しで並列に走れる。
      34              : //
      35              : // overlay が Active な間は Screen の入力ゲートが overlay へ入力を渡すが、overlay も
      36              : // keybind.ReadInput で同じ供給源から読むので、詳細モーダルを開いた先も Action 列で駆動できる。
      37              : func PlayScenario(
      38              :         t *testing.T,
      39              :         buildStates func(w.World) []es.State[w.World],
      40              :         actions []inputmapper.ActionID,
      41              :         capture func(frame int, world w.World, shot vrt.Frame),
      42              : ) *maingame.MainGame {
      43            1 :         t.Helper()
      44            1 :         world := vrt.InitReplayWorld(t)
      45            1 : 
      46              :         // レイアウト確定フレームは供給源を差す前に回す。Action を消費させない
      47            1 :         sm := vrt.SetupStateMachine(t, world, buildStates)
      48            1 : 
      49            1 :         game, err := maingame.NewMainGame(world, sm)
      50            1 :         require.NoError(t, err)
      51            1 :         world.Resources.InputSource = actionSource(actions)
      52            1 : 
      53            1 :         for frame := range len(actions) + 1 {
      54            1 :                 if err := game.Update(); err != nil {
      55              :                         // 全ての state が Pop されたときの正常終了。以降は駆動するものが無い
      56            0 :                         require.ErrorIs(t, err, ebiten.Termination, "frame %d update failed", frame)
      57            0 :                         return game
      58            0 :                 }
      59            1 :                 if capture == nil {
      60            1 :                         continue
      61              :                 }
      62            1 :                 capture(frame, world, vrt.DrawFrame(consts.GameWidth, consts.GameHeight, game.Draw))
      63              :         }
      64            1 :         return game
      65              : }
      66              : 
      67              : // NoInput は入力の無いフレームを表す。本番はキーを押していないフレームが大半なので、
      68              : // 待ちが要る場面ではこれを並べる。state を push した直後のフレームは新しい Screen の
      69              : // タブ登録がまだ済んでいないため、続けて操作するなら1つ挟む
      70              : const NoInput inputmapper.ActionID = ""
      71              : 
      72              : // actionSource は Action 列を1フレーム1件で吐く供給源を作る。NoInput と列が尽きたあとは
      73              : // 偽を返す。供給源は非 nil のままなので ReadInput はキーボードへ戻らず、そのフレームは
      74              : // 入力なしとして扱われる
      75              : func actionSource(actions []inputmapper.ActionID) inputmapper.Source {
      76            1 :         rest := actions
      77            1 :         return func() (inputmapper.ActionID, bool) {
      78            1 :                 if len(rest) == 0 {
      79            1 :                         return NoInput, false
      80            1 :                 }
      81            1 :                 action := rest[0]
      82            1 :                 rest = rest[1:]
      83            1 :                 return action, action != NoInput
      84              :         }
      85              : }
        

Generated by: LCOV version 2.0-1