Function tweenUpdate

plugins/tweenSystem.js:471–510

Engine plugin hook: advance every active tween by the appropriate delta. * Called once per render frame by the engine (no arguments). May also be * called explicitly with `(gameDelta, realDelta)` to drive tweens manually * — useful for headless tests or custom replay/scrubbing systems. * @pa

(gameDelta, realDelta)

 *  @param {number} [realDelta] - Real-time delta in seconds; default: timeReal - lastTimeReal
 *  @memberof TweenSystem */
function tweenUpdate(gameDelta, realDelta)
{
    if (gameDelta === undefined)
    {
        // Engine path: compute deltas from engine time globals.
        gameDelta = time - lastTime;
        realDelta = timeReal - lastTimeReal;
        lastTime = time;
        lastTimeReal = timeReal;
    }
    else if (realDelta === undefined)
    {
        // Manual path with one arg: real and game advance together.
        realDelta = gameDelta;
    }

    // Iterate in reverse so removals don't disturb iteration.
    for (let i = tweenActive.length; i--;)
    {
        const t = tweenActive[i];
        if (t.paused) continue;
        const dt = t.useRealTime ? realDelta : gameDelta;
        if (dt <= 0) continue;

        t.life -= dt;
        if (t.life > 0)
        {
            t.callback(t.interp(t.life));
        }
        else
        {
            // Completion: fire end value, remove from active, fire then-callback.
            t.callback(t.interp(0));
            tweenActive.splice(i, 1);
            const cb = t.thenCallback;
            t.thenCallback = undefined;
            if (cb) cb();
        }
    }
}

/** Stop every active tween and clear their then-callbacks. Useful for resets
 *  on level transitions or when changing scenes.