PBRシーンから小さなゲームへ

小さな機能例でPBR、Node、選択、粒子を理解した後は、 それらを一つのゲームに接続する境界を確認します。 samples/fantasy/の「翠の砦」は、段差を移動して戦う一戦分のゲームです。 大きなゲーム基盤を持ち込まず、初期シーン、ルール、表示、入力、解放を分けています。 現在の戦場は水に沈んだ砦です。コースティクスと青緑の照明・フォグを加え、 同じゲームへ描画機能を追加する具体例としても読めます。

まず動かして読む場所を決める

リポジトリをHTTPで配信し、samples/fantasy/fantasy.htmlを開きます。 例えばhttp://localhost:8000/samples/fantasy/fantasy.htmlです。 操作と確認ポイントはsamples/fantasy/README.md、 ブラウザの説明ページはsamples/fantasy/index.htmlです。

まずリオを選び、青いマスへ歩かせてから、他の味方を選びます。 移動中は入力が止まり、到着後に攻撃を選べることを確認します。 次に敵ターン、HP減少、再開始を試します。 この順序が、コードで読む行動の順序にもなります。 右側の「水中のコースティクス」を切り替え、 OFFでもゲームの状態を保ち、ONで地形へ動く集光が戻ることを確認します。

必要な原理を短い例で確認する場合は、03_01の親子Node、 15章の画面座標からのraycast、30_01のPBR材質、 samples/compute_particle_emitter/の発生・消去へ戻ります。 短い例で各機能を確かめ、この統合例でゲームへの接続を確認できます。

起動する入口は一つにする

samples/fantasy/main.jsのstart()から読みます。 FantasyAppはWebgSceneAppを継承し、画面サイズの追従だけを足します。 PBRの描画、登録したGPU粒子の更新と合成には標準callbackを使います。 既存のフレームループへ更新処理を接続し、粒子の進行は標準callbackへ任せます。

scene.jsのcreateManifest()は、SceneYAMLと同じ構造の初期データです。 配置、共通材質、renderer、粒子をここへ置きます。 projectにはURLだけでなくmanifest objectも渡せるので、 地形をJavaScriptで生成する場合も同じ高水準入口を使えます。 保存・編集する文書が必要になったらSceneYAMLへ進みます。

このゲームはphysics:falseです。高低差があっても、 マスへの進入と高さの表示は、地形の段数と経路の規則から決められます。 ルールはrules.mjs、描画位置も同じ地形の段数から求めます。 地形の段数を高さの基準にし、ユニットの表示位置にも同じ値を使います。

直接作ったShapeにPBR材質を渡す

シーンのmaterialsで宣言する材質と、 Shape.setMaterial()へ直接渡すパラメーターを区別します。 後者ではRGBAのcolorと、specular、roughness、metallicを指定します。 RGBAの4成分を指定し、30章の最小形を保って値を変えます。

shape.setMaterial("armor", {
  color: [0.48, 0.59, 0.62, 1.0],
  specular: 1.0,
  roughness: 0.28,
  metallic: 0.88,
  emissive_factor: [0.0, 0.0, 0.0]
});

visuals.jsのpart()は、形状の確定、材質、Nodeへの取り付けをまとめます。 パレットのRGBには、この関数でalphaを足します。 シーン側の発光はemissiveFactor、直接Shapeではemissive_factorです。 似た名前を推測して混ぜず、使う経路の例を確認します。

WebgSceneAppのPBR設定で環境光を有効にする場合、 renderer.pipeline.lighting.ambientは0です。 この入口と低水準のDeferredLightingPassは、環境光と固定環境光の重複を入力検証で確認します。 鎧の粗さを変える実験では、照明と露出を固定して材質の変化を見比べます。

マスの移動とNodeの更新をつなぐ

choose()→move()→updateMotion()の順に読みます。 paths()が合法な経路を返し、move()が一区間ずつ表示の完了を待ちます。 updateMotion()はonUpdate({ deltaSec })から呼ばれ、 秒単位で位置と四肢を補間します。 rotateX()は加算なので、望む角度と前回角度の差を渡します。

一区間の表示が完了した時点で論理上のマスを確定し、次の区間へ進みます。 行動中はbusyで入力を止め、古い移動範囲への二重入力を防ぎます。 移動後の選択肢はrefresh()で作り直します。

リオの移動力を4から3へ変えると、初期位置から「列4 行5」の上りへ 届かなくなります。次に区間のdurationだけを増やし、 同じ経路をゆっくり歩かせます。経路の規則と表示速度を別々に確認できます。

選択と頭上ラベルに同じカメラを使う

makePointerRay()とpickTile()は15章の逆投影を使います。 透視成分を含む行列はMatrix.mul_()で合成し、 depthはCAMERA_REVERSE_Zから取ります。 カメラの行列は選択前に更新します。

Space.raycast()は表示物を選ぶAABBのクエリです。 攻撃の射程や移動の可否は、ヒットしたユニットのマス座標から rules.mjsで判断します。戦闘ルールの判定には、マス座標と地形データを使います。 ドラッグ終了のクリックは移動量で除きます。 補助盤のボタンも同じchoose()へ入り、クリックとボタンで同じ規則を使います。

updateLabels()は現在のNode位置を同じprojectionとviewで投影し、 名前とHPのDOMをCanvasの表示寸法へ置きます。 カメラを回した後も、名前とクリック位置が一致するか確認します。

CanvasとPBRの描画先を一緒に変える

CSSだけでCanvasを引き伸ばすと、描画寸法と表示寸法が分かれます。 FantasyApp.jsは.stageをResizeObserverで監視し、 fixedCanvasSizeとapplyViewportLayout()でCanvasを更新してから、 renderer.resize(width, height)でPBRの描画先をそろえます。 この例ではCSSピクセルを使い、useDevicePixelRatio:falseです。

幅を変えて、Canvasだけでなく、粒子、ラベル、クリックも確認します。 リサイズは描画・DOM・入力が同じ寸法を使うかを見る操作です。

粒子と再開始・解放の所有者を決める

scene.jsで装置を宣言し、行動のイベントからemit()を呼びます。 appearance.colorsは二つのRGB配列です。 1色だけにする場合も、同じ色を二つ指定します。 足元の色を変える実験では、発生位置と経路を固定して色の変化を見比べます。

main.jsのreset()はゲームの再開始です。 HP、行動権、ターン、既存Node、ログを戻し、装置のclear()を呼びます。 独自のHPとDOMはゲーム側のreset()、宣言シーンの状態はWebgSceneApp.reset()が担当します。

終了では先にフレームを止めます。 Visualsが手動生成したShapeはVisuals.destroy()、 登録された粒子・PBR・宣言シーンはWebgSceneApp.destroy()が解放します。 FantasyApp.destroy()は作品が登録したObserverを外します。 所有者を決めておくと、通常の再開始では既存のGPU資源を再利用できます。

動く部隊へ集光を追加する

先に35章とsamples/water/water.htmlで、水面と集光を別々に比較します。 ゲームへの接続はsamples/fantasy/main.jsのconnectWater()へ戻って読みます。 ここではWaterBodyを作り、起動済みのsceneApp.renderer.setWater()へ接続します。 描画ループとWGSLは、接続先の標準パイプラインが担当します。

origin: [0, -2, 0]は照度の基準面、surfaceHeight: 6は平均水面のYです。 幅・奥行き18mの水域で、地形・部隊・装飾の親Nodeを登録します。 子の手足や装備にも受光登録が引き継がれるので、歩行で部品を動かすたびに 最初に行った親Nodeへの登録を継続して使えます。選択リングと移動範囲は登録から外します。 金属の鏡面や発光は元のPBR経路で評価し、集光は直接光の拡散成分へ当てます。

water.addReceiver(unitRoot); // 子部品にも適用する
await sceneApp.renderer.setWater(water, {
  causticsEnabled: true,
  surfaceEnabled: false,
  quality: "high"
});

集光は鉛直方向光に対応します。 connectWater()はrenderer.pipeline.lightOptions.directionを[0, -1, 0]へ設定し、 scene.jsでは影のup方向を[0, 0, 1]にします。 この方向光の設定は、manifestの読込み後にJavaScriptから適用します。 水域は設定と受光登録を保持し、rendererが追加GPU資源を所有します。

ゲーム側のupdate()では、秒単位のwaterTimeを進めてwater.setTime()へ渡します。 同じ更新で部隊のNodeも動くので、集光は現在の位置・法線へ追従します。 波はamplitude、wavelength、speed、waveMixで変えます。 water.setOptions()で波の値を変えた後も、既存のsetWater()の接続を継続して使えます。

水面の屈折表示はOFFにし、青緑の照明と距離フォグで水中の雰囲気を作ります。 これは戦闘のマスを読みやすくする照明演出です。 この例の水中表示は、集光・照明・距離フォグによる近似です。水面越しの屈折を見る場合は、samples/water/の上空カメラによる表示を参照します。 集光の吸収はRGB係数の平均、視点側の濁りは標準Fogによる近似です。 水面越しに見るRGB透過色の比較はsamples/water/で行います。

チェックボックスの処理は、sceneApp.stop()→await setWater()→sceneApp.start()です。 準備中のframeを止め、ゲームのHP・行動権・既存Nodeを保って再開します。 集光OFFかつ水面OFFでは専用GPU資源を解放し、再ONに同じWaterBodyを使います。 reset()は部隊・粒子・戦闘状態を戻し、水域は生成済みの設定と資源を再利用します。 終了時はWebgSceneApp.destroy()からrendererが追加資源も解放します。

確認する順序は、集光OFFで移動→ONで段差移動→遠隔攻撃→敵ターン→再開始です。 表示だけでなく、追加機能の切替後も元の操作を続けられるか確認します。

自分のアプリへ変える順序

  1. 元の場所で実行し、移動・攻撃・敵ターン・再開始を確認する。
  2. scene.jsまたはvisuals.jsで一つの材質を変え、同じ照明で比較する。
  3. rules.mjsで一人の移動力を変え、合法な経路と表示範囲を確認する。
  4. move()の表示時間を変え、マスの確定と入力停止を確認する。
  5. 粒子の二つの色を変え、再開始時に粒子が消去され、次の行動では新しい色で発生することを確認する。
  6. カメラと画面幅を変え、選択・ラベル・描画寸法の対応を確認する。
  7. 集光を切り替え、波の高さだけを変える。移動・攻撃・再開始を再確認する。

node --test samples/fantasy/rules.test.mjsは経路と戦闘の計算を確認します。 PBRの見え方、アニメーション、粒子、クリックはブラウザで別に確認します。 一つの機能を足すたびに「どの状態を、誰が、いつ更新し、いつ解放するか」を この例の関数へ対応させると、AIも人も同じ手順で組み立てられます。