@datamoc/mw_games 0.43.0 → 0.45.0

package/dist/two-d/Game.js

@@ -1,463 +0,0 @@
-import { Application, Container, TextureSource } from 'pixi.js';
-import { SceneStack } from '../core/SceneStack.js';
-import { Signal } from '../core/Signal.js';
-import { Logger } from '../core/Log.js';
-import { fitResolution } from './ResolutionFit.js';
-import { QualityScaler } from './QualityScaler.js';
-import * as Input from '../core/Input.js';
-import { reducedMotion } from '../core/Motion.js';
-import { TransitionRunner } from './render/SceneTransition.js';
-const PIXEL_ART_CLASS = 'mwg-pixel-art';
-const log = new Logger('renderer');
-/**
- * A class beats an inline `canvas.style.imageRendering` because Pixi's own `autoDensity`/
- * `resizeTo` rewrite the canvas's `style` attribute wholesale (see `start()`); this rule
- * lives in the CSSOM instead, in a stylesheet Pixi never touches, so it survives that.
- * Injected once per page, however many `Game`s end up on it.
- */
-function ensurePixelArtStylesheet() {
-    if (document.getElementById(PIXEL_ART_CLASS))
-        return;
-    const style = document.createElement('style');
-    style.id = PIXEL_ART_CLASS;
-    style.textContent = `.${PIXEL_ART_CLASS} { image-rendering: pixelated; }`;
-    document.head.appendChild(style);
-}
-/**
- * Calls back whenever `devicePixelRatio` changes - a browser zoom, or dragging the window
- * to a display with a different scale factor. There is no direct DOM event for this: a
- * `matchMedia` query only fires once, for the specific ratio it was created against, so
- * catching the *next* change means building a fresh query after every firing.
- *
- * @returns a function that stops watching
- */
-function watchDevicePixelRatio(onChange) {
-    let query = null;
-    const rearm = () => {
-        query = matchMedia(`(resolution: ${window.devicePixelRatio}dppx)`);
-        query.addEventListener('change', fire, { once: true });
-    };
-    const fire = () => {
-        onChange();
-        rearm();
-    };
-    rearm();
-    return () => query?.removeEventListener('change', fire);
-}
-/**
- * The application: owns the renderer, the loop, and the current scene.
- *
- * Construct it, `await start(FirstScene)`, and the rest is scenes.
- *
- * The canvas is drawn at the display's `devicePixelRatio`, up to what the device can actually
- * make: a backing store of `viewport * devicePixelRatio` pixels is refused past the GPU's
- * `MAX_TEXTURE_SIZE` (WebGL clamps it rather than failing, with nothing reported), so the
- * resolution is reduced to the largest whole number that fits and a warning says so. A game
- * therefore keeps rendering on a device with a small limit, softer than the display asked for
- * rather than wrong; nothing changes on a device that can afford what it asked for.
- */
-export class Game {
-    static { this.instance = null; }
-    constructor(options = {}) {
-        this.app = new Application();
-        /** seconds elapsed in the previous frame, clamped by `maxDelta` */
-        this.elapsed = 0;
-        /** total seconds since the current scene was created */
-        this.timeTotal = 0;
-        /** multiplies elapsed time; 0 pauses the game without stopping the renderer */
-        this.timeScale = 1;
-        /** fires after every frame's update, for systems that are not scene-owned */
-        this.onFrame = new Signal();
-        this.hitStopRemaining = 0;
-        this.hitStopScale = 0;
-        this.stack = new SceneStack();
-        this.pending = [];
-        this.running = null;
-        this.started = false;
-        this.stopWatchingDpr = null;
-        this.stopWatchingVisibility = null;
-        this.suspended_ = false;
-        this.timeScaleBeforeSuspend = 1;
-        this.scaler = null;
-        this.options = {
-            canvas: options.canvas ?? document.createElement('canvas'),
-            background: options.background ?? 0x000000,
-            maxDelta: options.maxDelta ?? 0.25,
-            pixelArt: options.pixelArt ?? true,
-            resizeTo: options.resizeTo ?? window,
-            extensions: options.extensions ?? [],
-            autoPause: options.autoPause ?? true,
-            audio: options.audio ?? null,
-            qualityScaling: options.qualityScaling ?? null,
-        };
-        if (this.options.pixelArt) {
-            //set here rather than in start(), because textures are usually loaded before
-            //the game starts and each one takes the default that was current when it was
-            //created. nearest sampling is what keeps magnified pixel art crisp - but only
-            //inside the game's own rendering; the browser then does a second, entirely
-            //separate resize when it composites the canvas element onto the page (its
-            //backing buffer is rarely the same size as its CSS display size, especially at
-            //a devicePixelRatio other than 1), and that step defaults to smooth
-            //interpolation regardless of anything Pixi does - see `start()` for the other
-            //half of this, since `app.init()` overwrites whatever style is set here.
-            TextureSource.defaultOptions.scaleMode = 'nearest';
-        }
-        Game.instance = this;
-    }
-    /** the viewport width in css pixels, which is what scenes lay out against */
-    get width() {
-        return this.app.renderer.screen.width;
-    }
-    get height() {
-        return this.app.renderer.screen.height;
-    }
-    /** the running game, or null before one exists, for code that works with or without one */
-    static get active() {
-        return Game.instance;
-    }
-    /** the running game, for the few places that genuinely need a global */
-    static get current() {
-        if (!Game.instance)
-            throw new Error('no Game has been created yet');
-        return Game.instance;
-    }
-    async start(first) {
-        if (this.started)
-            throw new Error('this Game has already been started');
-        this.started = true;
-        //batchers and pipes have to be registered before the renderer is built - see
-        //GameOptions.extensions for why this is a caller-supplied list rather than mwg/core
-        //reaching into mwg/render itself
-        for (const register of this.options.extensions)
-            register();
-        Input.attach();
-        await this.app.init({
-            canvas: this.options.canvas,
-            background: this.options.background,
-            resizeTo: this.options.resizeTo,
-            antialias: false,
-            //the game clears and redraws every frame, so the buffer need not be preserved
-            preserveDrawingBuffer: false,
-            //drawing at device resolution is what keeps pixel art on whole device pixels
-            resolution: window.devicePixelRatio || 1,
-            autoDensity: true,
-        });
-        if (!this.options.canvas.isConnected) {
-            document.body.appendChild(this.options.canvas);
-        }
-        //`autoDensity` (and `resizeTo`, on its own asynchronous schedule) rewrite the canvas
-        //element's `style` attribute wholesale to keep its CSS size matching the backing
-        //buffer - which loses anything else set through `canvas.style`, including right
-        //after `init` and again from inside pixi's own 'resize' event. A class, rather than
-        //an inline style, lives in a different attribute entirely and survives that.
-        if (this.options.pixelArt) {
-            ensurePixelArtStylesheet();
-            this.options.canvas.classList.add(PIXEL_ART_CLASS);
-        }
-        //`screen` is the logical size in css pixels; `renderer.width` is the backing store,
-        //which is larger on a hidpi display. Scenes lay out in logical units, so handing
-        //them the backing size would push everything they centre off the screen.
-        this.app.renderer.on('resize', () => {
-            this.stack.resize(this.width, this.height);
-            //a rotation or a window resize changes how much of a backing store this device
-            //can afford, so re-fit rather than keeping whatever was chosen at startup
-            this.fitResolutionToDevice();
-        });
-        this.fitResolutionToDevice();
-        //the resolution passed to app.init() above is a one-time snapshot of
-        //devicePixelRatio; a later browser zoom (or dragging the window to a display with a
-        //different scale factor) changes that ratio without Pixi noticing on its own. Left
-        //stale, the backing buffer and the browser's own CSS scaling of the canvas element
-        //fall out of a whole-pixel relationship, and nearest-neighbour upscaling of a
-        //non-integer ratio duplicates pixel columns inconsistently - the seams a pixel-art
-        //tilemap shows between tiles that were perfectly adjacent in the buffer itself.
-        this.stopWatchingDpr = watchDevicePixelRatio(() => {
-            this.fitResolutionToDevice();
-        });
-        if (this.options.autoPause && typeof document !== 'undefined') {
-            const onVisibility = () => {
-                if (document.hidden)
-                    this.suspend();
-                else
-                    this.resume();
-            };
-            document.addEventListener('visibilitychange', onVisibility);
-            this.stopWatchingVisibility = () => document.removeEventListener('visibilitychange', onVisibility);
-        }
-        this.expose();
-        this.switchNow(first);
-        //pixi's ticker drives the loop, so its own systems stay in step with the game
-        this.app.ticker.add((ticker) => this.frame(ticker.deltaMS / 1000));
-    }
-    /**
-     * Queues a scene change; it happens at the start of the next frame.
-     *
-     * The whole stack goes: every scene is destroyed, suspended or not, and the
-     * new one starts alone. For a scene that returns, push it instead.
-     */
-    switchScene(next, options) {
-        this.pending.push({ kind: 'switch', next, transition: options });
-    }
-    /**
-     * Changes what the current scene shows under a transition: `swap` runs at the start of the next
-     * frame, once the outgoing picture has been photographed, and the transition then plays over the
-     * result. For a scene that replaces its decor, level or layout in place rather than switching scenes;
-     * `Scene2D.transitionTo` is the same call from inside the scene.
-     */
-    transition(swap, options) {
-        this.pending.push({ kind: 'swap', swap, transition: options });
-    }
-    /** true while a transition is playing, for a scene that should ignore input until it ends */
-    get transitioning() {
-        return this.running !== null;
-    }
-    /**
-     * Queues a scene on top of the current one; it starts at the next frame.
-     *
-     * The scene underneath suspends but is not destroyed: it stops updating and
-     * keeps rendering, so the new scene can layer over it or replace it
-     * outright, and `popScene` resumes exactly where play left off.
-     */
-    pushScene(next) {
-        this.pending.push({ kind: 'push', next });
-    }
-    /**
-     * Queues the top scene's removal; it happens at the start of the next frame.
-     *
-     * @param result reported back to the resumed scene's `onResume`
-     */
-    popScene(result) {
-        this.pending.push({ kind: 'pop', result });
-    }
-    /** the scene currently updating: the top of the stack */
-    get currentScene() {
-        return this.stack.current;
-    }
-    /**
-     * Briefly dips `timeScale` toward `scale` for `duration` real seconds, then restores it
-     * to 1 - a heavy hit's momentary freeze-frame, distinct from `render.Camera.shake` (which
-     * moves the view, not the clock) and from `ui.FloatingText` (a damage number, not a time
-     * effect). A second call while one is still running simply replaces it, the same way
-     * `Camera.shake` restarts rather than stacking.
-     */
-    hitStop(duration, scale = 0) {
-        this.hitStopRemaining = duration;
-        this.hitStopScale = scale;
-    }
-    /**
-     * Advances the game by one frame and draws it, without waiting for the browser.
-     *
-     * The loop normally runs on requestAnimationFrame, which browsers suspend while a tab
-     * is not visible. That is right for a game and wrong for a test or a screenshot, so
-     * this drives a frame directly.
-     *
-     * @param dt seconds to advance by
-     */
-    step(dt) {
-        this.frame(dt);
-        this.app.renderer.render(this.app.stage);
-    }
-    /** true while suspended by `suspend` (a page hide, usually) */
-    get suspended() {
-        return this.suspended_;
-    }
-    /**
-     * Freezes the simulation for a page hide: the clock (`timeScale`) parks at 0, the top
-     * scene hears `onSuspend`, and the game's own audio rig is silenced. The renderer keeps
-     * going and `step(dt)` still works, so consoles and screenshots are unaffected.
-     * Idempotent; `resume` restores the parked clock and audio, and the player's own mute
-     * setting is never touched.
-     */
-    suspend() {
-        if (this.suspended_)
-            return;
-        this.suspended_ = true;
-        this.timeScaleBeforeSuspend = this.timeScale;
-        this.timeScale = 0;
-        this.stack.current?.onSuspend();
-        this.options.audio?.suspend();
-    }
-    /**
-     * The counterpart to `suspend`: restores the parked clock, fires `onResume` on the top
-     * scene, and unsilences the audio rig. Calling it without a `suspend` does nothing.
-     */
-    resume() {
-        if (!this.suspended_)
-            return;
-        this.suspended_ = false;
-        this.timeScale = this.timeScaleBeforeSuspend;
-        this.stack.current?.onResume(undefined);
-        this.options.audio?.resume();
-    }
-    /**
-     * Publishes the running game on the global object, for tools and for the console.
-     *
-     * `__PIXI_APP__` is the name the PixiJS devtools extension looks for, so declaring it
-     * costs nothing and makes the scene graph inspectable. `__MWG__` is the game itself,
-     * which is what makes `__MWG__.step(1/60)` possible from a console: the only way to
-     * advance a game whose tab the browser has suspended, and the difference between
-     * diagnosing a frozen page and guessing at it.
-     *
-     * Neither is read by the framework. Nothing depends on them existing.
-     */
-    expose() {
-        const target = globalThis;
-        target.__PIXI_APP__ = this.app;
-        target.__MWG__ = this;
-    }
-    /**
-     * Resizes the renderer to a resolution this device can actually afford.
-     *
-     * A full-window canvas at device resolution can ask for a backing store larger than the
-     * GPU's `MAX_TEXTURE_SIZE`, and WebGL clamps that silently instead of failing: the canvas
-     * keeps its size, the scene keeps being rendered into a surface that is not the one asked
-     * for, and nothing anywhere says so. A 1080-wide phone at `devicePixelRatio` 2.625 asks for
-     * 2121x4709 against the 4096 limit one emulator reported, and got a 2121x4096 drawing
-     * buffer; see `fitResolution` for the arithmetic and for what that investigation did and
-     * did not establish about the black screen that process showed.
-     *
-     * Called after `init`, whenever the renderer is resized (a rotation changes which one fits),
-     * and when `devicePixelRatio` itself changes. It returns immediately when the device can
-     * afford what was asked for, which is every ordinary case, so nothing about a normal
-     * startup changes.
-     */
-    fitResolutionToDevice() {
-        const gl = this.app.renderer.gl;
-        const limit = gl ? gl.getParameter(gl.MAX_TEXTURE_SIZE) : Number.POSITIVE_INFINITY;
-        const wanted = window.devicePixelRatio || 1;
-        const fitted = fitResolution(this.width, this.height, wanted, limit);
-        if (!this.scaler && this.options.qualityScaling) {
-            this.scaler = new QualityScaler({ ...this.options.qualityScaling, ceiling: fitted });
-        }
-        const target = this.scaler ? this.scaler.setCeiling(fitted) : fitted;
-        if (target === this.app.renderer.resolution)
-            return;
-        log.warn(`this device cannot render a ${this.width}x${this.height} canvas at ${wanted}x ` +
-            `(its limit is ${limit}); using ${fitted}x instead, which is softer than the display`);
-        this.app.renderer.resize(this.width, this.height, target);
-    }
-    frame(deltaSeconds) {
-        //queued scene changes run first, in order, so a frame never updates a
-        //scene that was already asked to leave
-        if (this.pending.length > 0)
-            this.endTransition();
-        for (const request of this.pending) {
-            if (request.kind === 'switch')
-                this.applySwitch(request.next, request.transition);
-            else if (request.kind === 'swap')
-                this.applySwap(request.swap, request.transition);
-            else if (request.kind === 'push')
-                this.applyPush(request.next);
-            else
-                this.applyPop(request.result);
-        }
-        this.pending.length = 0;
-        if (this.hitStopRemaining > 0 && !this.suspended_) {
-            //counts down in real time, not scaled time, or a hit-stop would extend itself
-            this.hitStopRemaining -= deltaSeconds;
-            this.timeScale = this.hitStopRemaining > 0 ? this.hitStopScale : 1;
-        }
-        //a transition counts real time, and may hold the scene still while it plays
-        if (this.running && this.running.runner.update(deltaSeconds))
-            this.endTransition();
-        const frozen = this.running?.runner.pause === true;
-        this.elapsed = frozen ? 0 : Math.min(deltaSeconds, this.options.maxDelta) * this.timeScale;
-        //a parked clock reads 0, which is always inside budget - observing it would ratchet
-        //the ratio back up while hidden or hit-stopped, so only real frames count
-        const scaler = this.suspended_ || this.elapsed <= 0 ? null : this.scaler;
-        if (scaler) {
-            const ratio = scaler.observe(this.elapsed);
-            if (ratio !== this.app.renderer.resolution)
-                this.app.renderer.resize(this.width, this.height, ratio);
-        }
-        this.timeTotal += this.elapsed;
-        //no native "gamepad button pressed" event exists to attach a listener to, so this
-        //has to run once a frame instead, before the scene reads isDown/justPressed
-        Input.pollGamepads();
-        this.stack.update(this.elapsed);
-        this.onFrame.dispatch(this.elapsed);
-        //after everything has had a chance to poll it, so nothing misses a press
-        Input.endFrame();
-    }
-    switchNow(next) {
-        this.applySwitch(next);
-    }
-    /** a picture of everything on screen now, or null when there is nothing to show or motion is reduced */
-    snapshot(options) {
-        if (!options || reducedMotion())
-            return null;
-        return this.app.renderer.generateTexture(this.app.stage);
-    }
-    /** puts what is on the stage into a container the transition may move, between its two layers */
-    beginTransition(options, snapshot) {
-        const wrapper = new Container();
-        wrapper.addChild(...this.app.stage.removeChildren());
-        const runner = new TransitionRunner(options, { width: this.width, height: this.height }, snapshot, wrapper);
-        this.app.stage.addChild(runner.under, wrapper, runner.over);
-        this.running = { runner, wrapper };
-    }
-    /** finishes a transition that is still playing and puts the scenes back on the stage */
-    endTransition() {
-        const running = this.running;
-        if (!running)
-            return;
-        this.running = null;
-        running.runner.finish();
-        const scenes = running.wrapper.removeChildren();
-        this.app.stage.removeChildren();
-        this.app.stage.addChild(...scenes);
-        running.wrapper.destroy();
-    }
-    applySwap(swap, options) {
-        const snapshot = this.snapshot(options);
-        swap();
-        if (snapshot)
-            this.beginTransition(options, snapshot);
-        else
-            options.onDone?.();
-    }
-    /** a new scene alone: everything else is destroyed, the clocks restart */
-    applySwitch(next, transition) {
-        const snapshot = this.snapshot(transition);
-        const scene = new next();
-        this.stack.replace(scene);
-        this.app.stage.removeChildren();
-        this.app.stage.addChild(scene.stage);
-        this.elapsed = 0;
-        this.timeTotal = 0;
-        this.timeScale = 1;
-        scene.resize(this.width, this.height);
-        if (snapshot && transition)
-            this.beginTransition(transition, snapshot);
-        else
-            transition?.onDone?.();
-    }
-    /** a new scene over the current one, which suspends but survives underneath */
-    applyPush(next) {
-        const scene = new next();
-        this.stack.push(scene);
-        this.app.stage.addChild(scene.stage);
-        this.elapsed = 0;
-        this.timeTotal = 0;
-        this.timeScale = 1;
-        scene.resize(this.width, this.height);
-    }
-    /** the top scene leaves, reporting back to whatever it covered */
-    applyPop(result) {
-        const top = this.stack.current;
-        this.stack.pop(result);
-        if (top)
-            this.app.stage.removeChild(top.stage);
-    }
-    destroy() {
-        Input.detach();
-        this.stopWatchingDpr?.();
-        this.stopWatchingVisibility?.();
-        this.stack.destroy();
-        this.onFrame.removeAll();
-        this.app.destroy(true, { children: true });
-        if (Game.instance === this)
-            Game.instance = null;
-    }
-}
-//# sourceMappingURL=Game.js.map

package/dist/two-d/Game.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Game.js","sourceRoot":"","sources":["../../src/two-d/Game.ts"],"names":[],"mappings":"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"}

package/dist/two-d/QualityScaler.d.ts

@@ -1,63 +0,0 @@
-export interface QualityScalerOptions {
-    /** the ratio a fresh scaler starts at: the device-fitted ratio from `fitResolution` */
-    ceiling: number;
-    /** the floor stepping down never crosses; defaults to 1 */
-    minRatio?: number;
-    /** frames per second the game budgets for; defaults to 60 */
-    targetFps?: number;
-    /** consecutive over-budget frames before one step down; defaults to 60 */
-    overBudgetFrames?: number;
-    /** consecutive under-budget frames before one step up; defaults to 600 (cautious) */
-    underBudgetFrames?: number;
-    /** ratio lost per step down (and regained per step up); defaults to 0.25 */
-    step?: number;
-}
-/**
- * Frame-time-driven quality scaling over item 360's static fit: `fitResolution` answers
- * what a device can afford once, and this watches what actually happens, stepping the
- * backing-store ratio down when frames keep missing their budget and stepping back up
- * only after a much longer streak inside it. Pure numbers in and out - the game (see
- * `Game`'s `qualityScaling` option) applies the returned ratio to its renderer, so this
- * stays renderer-free and headless-testable.
- *
- * Stepping up is deliberately an order of magnitude slower than stepping down: a frame
- * inside budget at a reduced ratio proves nothing about the next ratio up, so recovery
- * needs a sustained streak, not a good moment.
- *
- * @example
- * ```ts
- * import { QualityScaler } from '@datamoc/mw_games/two-d';
- *
- * const scaler = new QualityScaler({ ceiling: 2 });
- * for (let i = 0; i < 60; i++) scaler.observe(1 / 30);
- * console.log(scaler.ratio); // 1.75
- * ```
- */
-export declare class QualityScaler {
-    private ceiling;
-    private readonly floor;
-    private readonly budget;
-    private readonly downAfter;
-    private readonly upAfter;
-    private readonly step;
-    private ratio_;
-    private over;
-    private under;
-    constructor(options: QualityScalerOptions);
-    /** the ratio the renderer should currently use */
-    get ratio(): number;
-    /**
-     * A new device-fitted ceiling (rotation, display change): the current ratio is clamped
-     * down to it, never up - stepping back up stays the streak's job. Returns the ratio.
-     */
-    setCeiling(ceiling: number): number;
-    /**
-     * Feeds one frame's seconds; returns the ratio the renderer should use, unchanged most
-     * frames. Non-finite or non-positive frames are ignored rather than counted either way,
-     * so a parked clock (a `timeScale` 0 pause) can never drive the policy.
-     */
-    observe(frameSeconds: number): number;
-    /** back to the ceiling with both streaks cleared */
-    reset(): void;
-}
-//# sourceMappingURL=QualityScaler.d.ts.map

package/dist/two-d/QualityScaler.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"QualityScaler.d.ts","sourceRoot":"","sources":["../../src/two-d/QualityScaler.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACpC,uFAAuF;IACvF,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qFAAqF;IACrF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,aAAa;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,KAAK,CAAK;IAElB,YAAY,OAAO,EAAE,oBAAoB,EAUxC;IAED,kDAAkD;IAClD,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQlC;IAED;;;;OAIG;IACH,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAkBpC;IAED,oDAAoD;IACpD,KAAK,IAAI,IAAI,CAIZ;CACD"}

package/dist/two-d/QualityScaler.js

@@ -1,92 +0,0 @@
-/**
- * Frame-time-driven quality scaling over item 360's static fit: `fitResolution` answers
- * what a device can afford once, and this watches what actually happens, stepping the
- * backing-store ratio down when frames keep missing their budget and stepping back up
- * only after a much longer streak inside it. Pure numbers in and out - the game (see
- * `Game`'s `qualityScaling` option) applies the returned ratio to its renderer, so this
- * stays renderer-free and headless-testable.
- *
- * Stepping up is deliberately an order of magnitude slower than stepping down: a frame
- * inside budget at a reduced ratio proves nothing about the next ratio up, so recovery
- * needs a sustained streak, not a good moment.
- *
- * @example
- * ```ts
- * import { QualityScaler } from '@datamoc/mw_games/two-d';
- *
- * const scaler = new QualityScaler({ ceiling: 2 });
- * for (let i = 0; i < 60; i++) scaler.observe(1 / 30);
- * console.log(scaler.ratio); // 1.75
- * ```
- */
-export class QualityScaler {
-    constructor(options) {
-        this.over = 0;
-        this.under = 0;
-        this.ceiling = normalizeCeiling(options.ceiling);
-        const min = options.minRatio ?? 1;
-        this.floor = Number.isFinite(min) && min > 0 ? Math.min(min, this.ceiling) : Math.min(1, this.ceiling);
-        const fps = options.targetFps ?? 60;
-        this.budget = Number.isFinite(fps) && fps > 0 ? 1 / fps : 1 / 60;
-        this.downAfter = streakLength(options.overBudgetFrames, 60);
-        this.upAfter = streakLength(options.underBudgetFrames, 600);
-        this.step = Number.isFinite(options.step) && options.step > 0 ? options.step : 0.25;
-        this.ratio_ = this.ceiling;
-    }
-    /** the ratio the renderer should currently use */
-    get ratio() {
-        return this.ratio_;
-    }
-    /**
-     * A new device-fitted ceiling (rotation, display change): the current ratio is clamped
-     * down to it, never up - stepping back up stays the streak's job. Returns the ratio.
-     */
-    setCeiling(ceiling) {
-        this.ceiling = normalizeCeiling(ceiling);
-        if (this.ratio_ > this.ceiling) {
-            this.ratio_ = this.ceiling;
-            this.over = 0;
-            this.under = 0;
-        }
-        return this.ratio_;
-    }
-    /**
-     * Feeds one frame's seconds; returns the ratio the renderer should use, unchanged most
-     * frames. Non-finite or non-positive frames are ignored rather than counted either way,
-     * so a parked clock (a `timeScale` 0 pause) can never drive the policy.
-     */
-    observe(frameSeconds) {
-        if (!Number.isFinite(frameSeconds) || frameSeconds <= 0)
-            return this.ratio_;
-        if (frameSeconds > this.budget) {
-            this.over++;
-            this.under = 0;
-            if (this.over >= this.downAfter && this.ratio_ > this.floor) {
-                this.ratio_ = Math.max(this.floor, this.ratio_ - this.step);
-                this.over = 0;
-            }
-        }
-        else {
-            this.under++;
-            this.over = 0;
-            if (this.under >= this.upAfter && this.ratio_ < this.ceiling) {
-                this.ratio_ = Math.min(this.ceiling, this.ratio_ + this.step);
-                this.under = 0;
-            }
-        }
-        return this.ratio_;
-    }
-    /** back to the ceiling with both streaks cleared */
-    reset() {
-        this.ratio_ = this.ceiling;
-        this.over = 0;
-        this.under = 0;
-    }
-}
-function normalizeCeiling(ceiling) {
-    return Number.isFinite(ceiling) && ceiling > 0 ? ceiling : 1;
-}
-function streakLength(value, fallback) {
-    return Number.isFinite(value) ? Math.max(1, Math.floor(value)) : fallback;
-}
-//# sourceMappingURL=QualityScaler.js.map

package/dist/two-d/QualityScaler.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"QualityScaler.js","sourceRoot":"","sources":["../../src/two-d/QualityScaler.ts"],"names":[],"mappings":"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"}