Camera follow lerp is framerate-dependent

オープン
#7,352 コメント 2 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 3 日以内に返信

まだ誰も着手していません。

評価

難易度
3/5
見積もり時間
1〜2日
初心者へのやさしさ
72/100
issue の種類
バグ
明瞭さ
明確に書かれている
活発さ
静か
技術スタック
javascript

調査の方向性

まず src/cameras/2d/Camera.js と、その preRender() の follow および deadzone 分岐を確認し、次に提供されている単一ファイルの例を実行して、30Hz とそれより高いリフレッシュレートで settle times が異なることを再現します。利用可能な frame delta を使って lerp の動作を更新し、異なるフレームレート間で同等の follow timing になることを示すテストを追加します。レンダリング頻度に関係なくカメラが同じ速度で安定すれば完了です。

索引モデルが issue の本文から書いたものです。

説明

Camera follow smoothing (startFollow with lerpX/lerpY < 1) is framerate dependent. The lerp factor is applied once per rendered frame in Camera.preRender, so the camera's tracking speed scales with the display's refresh rate: a game tuned on a 60Hz monitor pans exactly 2x faster on a 120Hz display and ~2.4x faster at 144Hz, and slower under any frame drop. The same applies to the deadzone follow path, which uses the same per-frame lerp.

With high-refresh displays now common, the same build feels noticeably different from machine to machine, and there is no way to compensate from user code since the lerp is applied inside preRender where no delta is exposed.

Example Test Code

Runnable single file, no build step. Two identical games with identical startFollow lerp values — the only difference is fps: { limit: 30 } on the second one. Every 3 seconds the follow target teleports 500px and each game measures the wall-clock time the camera takes to close to within 10px.

Expected if follow were framerate independent: both games report the same settle time. Actual: the 30fps game takes exactly twice as long as a 60Hz display (~1560ms vs ~780ms), and on a 120Hz display the uncapped game halves again (~390ms).

<!DOCTYPE html>
<html>
<head>
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/phaser.min.js"></script>
<style>body { display: flex; gap: 8px; background: #000; margin: 0; padding: 8px; }</style>
</head>
<body>
<div id="uncapped"></div>
<div id="capped"></div>
<script>
const LERP = 0.08;
const JUMP = 500;
const SETTLE_THRESHOLD = 10;

function makeGame(parent, fps, label) {
    let target;
    let text;
    let jumpedAt = 0;
    let dir = 1;
    let settled = true;

    new Phaser.Game({
        parent,
        width: 480,
        height: 320,
        backgroundColor: '#1d2b53',
        fps,
        scene: {
            create() {
                for (let x = -800; x <= 1600; x += 100) {
                    this.add.rectangle(x, 160, 4, 320, 0x3a4a83);
                }
                target = this.add.rectangle(240, 160, 24, 24, 0xffffff);
                this.cameras.main.startFollow(target, false, LERP, LERP);
                text = this.add.text(10, 10, label, { font: '14px monospace' }).setScrollFactor(0);
                this.time.addEvent({
                    delay: 3000,
                    loop: true,
                    callback: () => {
                        target.x += dir * JUMP;
                        dir *= -1;
                        jumpedAt = performance.now();
                        settled = false;
                    }
                });
            },
            update() {
                if (!settled && Math.abs(this.cameras.main.midPoint.x - target.x) < SETTLE_THRESHOLD) {
                    settled = true;
                    text.setText(label + '\nsettle time: ' + Math.round(performance.now() - jumpedAt) + ' ms');
                }
            }
        }
    });
}

makeGame('uncapped', undefined, 'uncapped (display refresh rate)');
makeGame('capped', { limit: 30 }, 'fps limit: 30');
</script>
</body>
</html>

Additional Information

Root cause: src/cameras/2d/Camera.js, preRender() — the follow branch applies a constant factor once per render:

sx = Linear(sx, fx - originX, lerp.x);
sy = Linear(sy, fy - originY, lerp.y);

plus the four analogous Linear calls in the deadzone branch. More renders per second means more lerp steps per second.

Proposed fix (I'm happy to submit a PR with tests): normalize the per-frame factor to a 60fps reference using the frame delta, which is already reachable inside preRender without any signature changes:

var fpsFactor = this.scene.sys.game.loop.delta / (1000 / 60);
sx = Linear(sx, fx - originX, 1 - Math.pow(1 - lerp.x, fpsFactor));
sy = Linear(sy, fy - originY, 1 - Math.pow(1 - lerp.y, fpsFactor));
主要言語
JavaScript
スター
40.7k
フォーク
7.2k
PR マージ指標
30日以内にマージされた PR はありません

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

phaserjs/phaser のほかの issue

phaserjs/phaser の issue をすべて見る

似ている issue

JavaScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。