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で段差移動→遠隔攻撃→敵ターン→再開始です。 表示だけでなく、追加機能の切替後も元の操作を続けられるか確認します。
自分のアプリへ変える順序
- 元の場所で実行し、移動・攻撃・敵ターン・再開始を確認する。
scene.jsまたはvisuals.jsで一つの材質を変え、同じ照明で比較する。rules.mjsで一人の移動力を変え、合法な経路と表示範囲を確認する。move()の表示時間を変え、マスの確定と入力停止を確認する。- 粒子の二つの色を変え、再開始時に粒子が消去され、次の行動では新しい色で発生することを確認する。
- カメラと画面幅を変え、選択・ラベル・描画寸法の対応を確認する。
- 集光を切り替え、波の高さだけを変える。移動・攻撃・再開始を再確認する。
node --test samples/fantasy/rules.test.mjsは経路と戦闘の計算を確認します。
PBRの見え方、アニメーション、粒子、クリックはブラウザで別に確認します。
一つの機能を足すたびに「どの状態を、誰が、いつ更新し、いつ解放するか」を
この例の関数へ対応させると、AIも人も同じ手順で組み立てられます。