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 : }
|