Build Game Create / Docs / 9. 解像度・ループ・停止処理
Create へ戻る

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 と相性が良い関数で、同じページ上で何度もゲームを作り直す時に役立ちます。