Build Game Docs
9. 解像度・ループ・停止処理
表示サイズとゲーム内部座標を分けて考えるのがこのエンジンの大きな特徴です。ここでは resize、loop、stop、dispose の役割をまとめます。
論理解像度と実表示サイズは別物
ゲーム内部では Game.width と Game.height を基準に座標を組み、実際の Canvas 表示サイズは別に合わせ込みます。これにより、画面が大きくなっても小さくなっても、ゲームのロジックは同じまま保てます。
width/height: ゲーム内部の世界の大きさです。viewportScale: 実画面へ何倍で拡大するかです。viewportOffsetX/viewportOffsetY: 中央寄せするための余白です。pixelRatio: 高解像度ディスプレイ用の倍率です。
表示とループに関わる関数
Game.resize()
現在の表示領域に合わせて Canvas の実サイズとビューポート倍率を計算し直します。ウィンドウサイズ変更時や全画面切り替え時に呼ばれます。
- 引数: なし。
- 戻り値: なし。
この関数があるため、ゲーム内部を 600 x 400 のような固定座標系で作っても、表示だけを自然に拡大縮小できます。
Game.loop(timestamp)
毎フレーム呼ばれるゲームループ本体です。timestamp から dt を計算し、現在 Scene の更新と描画を行い、最後に次のフレームを予約します。
timestamp:requestAnimationFrameが渡す時刻ミリ秒です。- 戻り値: なし。
内部では、極端に大きい dt を 0.016 に丸めて、タブ復帰直後の不自然なワープを防いでいます。
Game.stop()
現在の描画ループを止めます。再実行前に古いループが残らないようにする時や、ゲームを一時停止したい時の土台になります。
- 引数: なし。
- 戻り値: なし。
Game.dispose()
stop() に加えて、resize と fullscreenchange のイベント購読も解除します。コードを再評価する前に環境をきれいにしたい時に使います。
- 引数: なし。
- 戻り値: なし。
再実行 UI と相性が良い関数で、同じページ上で何度もゲームを作り直す時に役立ちます。