excalibur 0.25.2 → 0.25.3

package/build/dist/Debug/Debug.js

@@ -0,0 +1,375 @@
+import { ColorBlindFlags } from './DebugFlags';
+import { Color } from '../Color';
+/**
+ * Debug statistics and flags for Excalibur. If polling these values, it would be
+ * best to do so on the `postupdate` event for [[Engine]], after all values have been
+ * updated during a frame.
+ */
+export class Debug {
+    constructor(engine) {
+        /**
+         * Performance statistics
+         */
+        this.stats = {
+            /**
+             * Current frame statistics. Engine reuses this instance, use [[FrameStats.clone]] to copy frame stats.
+             * Best accessed on [[postframe]] event. See [[FrameStats]]
+             */
+            currFrame: new FrameStats(),
+            /**
+             * Previous frame statistics. Engine reuses this instance, use [[FrameStats.clone]] to copy frame stats.
+             * Best accessed on [[preframe]] event. Best inspected on engine event `preframe`. See [[FrameStats]]
+             */
+            prevFrame: new FrameStats()
+        };
+        /**
+         * Filter debug context to named entities or entity ids
+         */
+        this.filter = {
+            /**
+             * Toggle filter on or off (default off) must be on for DebugDraw to use filters
+             */
+            useFilter: false,
+            /**
+             * Query for entities by name, if the entity name contains `nameQuery` it will be included
+             */
+            nameQuery: '',
+            /**
+             * Query for Entity ids, if the id matches it will be included
+             */
+            ids: []
+        };
+        /**
+         * Entity debug settings
+         */
+        this.entity = {
+            showAll: false,
+            showId: true,
+            showName: false
+        };
+        /**
+         * Transform component debug settings
+         */
+        this.transform = {
+            showAll: false,
+            showPosition: false,
+            showPositionLabel: false,
+            positionColor: Color.Yellow,
+            showScale: false,
+            scaleColor: Color.Green,
+            showRotation: false,
+            rotationColor: Color.Blue
+        };
+        /**
+         * Graphics component debug settings
+         */
+        this.graphics = {
+            showAll: false,
+            showBounds: true,
+            boundsColor: Color.Yellow
+        };
+        /**
+         * Collider component debug settings
+         */
+        this.collider = {
+            showAll: false,
+            showBounds: true,
+            boundsColor: Color.Blue,
+            showOwner: false,
+            showGeometry: true,
+            geometryColor: Color.Green
+        };
+        /**
+         * Physics simulation debug settings
+         */
+        this.physics = {
+            showAll: false,
+            showBroadphaseSpacePartitionDebug: false,
+            showCollisionNormals: false,
+            collisionNormalColor: Color.Cyan,
+            showCollisionContacts: true,
+            collisionContactColor: Color.Red
+        };
+        /**
+         * Motion component debug settings
+         */
+        this.motion = {
+            showAll: false,
+            showVelocity: false,
+            velocityColor: Color.Yellow,
+            showAcceleration: false,
+            accelerationColor: Color.Red
+        };
+        /**
+         * Body component debug settings
+         */
+        this.body = {
+            showAll: false,
+            showCollisionGroup: false,
+            showCollisionType: false,
+            showSleeping: false,
+            showMotion: false,
+            showMass: false
+        };
+        /**
+         * Camera debug settings
+         */
+        this.camera = {
+            showAll: false,
+            showFocus: false,
+            focusColor: Color.Red,
+            showZoom: false
+        };
+        this._engine = engine;
+        this.colorBlindMode = new ColorBlindFlags(this._engine);
+    }
+    /**
+     * Switch the current excalibur clock with the [[TestClock]] and return
+     * it in the same running state.
+     *
+     * This is useful when you need to debug frame by frame.
+     */
+    useTestClock() {
+        const clock = this._engine.clock;
+        const wasRunning = clock.isRunning();
+        clock.stop();
+        const testClock = clock.toTestClock();
+        if (wasRunning) {
+            testClock.start();
+        }
+        this._engine.clock = testClock;
+        return testClock;
+    }
+    /**
+     * Switch the current excalibur clock with the [[StandardClock]] and
+     * return it in the same running state.
+     *
+     * This is useful when you need to switch back to normal mode after
+     * debugging.
+     */
+    useStandardClock() {
+        const currentClock = this._engine.clock;
+        const wasRunning = currentClock.isRunning();
+        currentClock.stop();
+        const standardClock = currentClock.toStandardClock();
+        if (wasRunning) {
+            standardClock.start();
+        }
+        this._engine.clock = standardClock;
+        return standardClock;
+    }
+}
+/**
+ * Implementation of a frame's stats. Meant to have values copied via [[FrameStats.reset]], avoid
+ * creating instances of this every frame.
+ */
+export class FrameStats {
+    constructor() {
+        this._id = 0;
+        this._delta = 0;
+        this._fps = 0;
+        this._actorStats = {
+            alive: 0,
+            killed: 0,
+            ui: 0,
+            get remaining() {
+                return this.alive - this.killed;
+            },
+            get total() {
+                return this.remaining + this.ui;
+            }
+        };
+        this._durationStats = {
+            update: 0,
+            draw: 0,
+            get total() {
+                return this.update + this.draw;
+            }
+        };
+        this._physicsStats = new PhysicsStats();
+        this._graphicsStats = {
+            drawCalls: 0,
+            drawnImages: 0
+        };
+    }
+    /**
+     * Zero out values or clone other IFrameStat stats. Allows instance reuse.
+     *
+     * @param [otherStats] Optional stats to clone
+     */
+    reset(otherStats) {
+        if (otherStats) {
+            this.id = otherStats.id;
+            this.delta = otherStats.delta;
+            this.fps = otherStats.fps;
+            this.actors.alive = otherStats.actors.alive;
+            this.actors.killed = otherStats.actors.killed;
+            this.actors.ui = otherStats.actors.ui;
+            this.duration.update = otherStats.duration.update;
+            this.duration.draw = otherStats.duration.draw;
+            this._physicsStats.reset(otherStats.physics);
+            this.graphics.drawCalls = otherStats.graphics.drawCalls;
+            this.graphics.drawnImages = otherStats.graphics.drawnImages;
+        }
+        else {
+            this.id = this.delta = this.fps = 0;
+            this.actors.alive = this.actors.killed = this.actors.ui = 0;
+            this.duration.update = this.duration.draw = 0;
+            this._physicsStats.reset();
+            this.graphics.drawnImages = this.graphics.drawCalls = 0;
+        }
+    }
+    /**
+     * Provides a clone of this instance.
+     */
+    clone() {
+        const fs = new FrameStats();
+        fs.reset(this);
+        return fs;
+    }
+    /**
+     * Gets the frame's id
+     */
+    get id() {
+        return this._id;
+    }
+    /**
+     * Sets the frame's id
+     */
+    set id(value) {
+        this._id = value;
+    }
+    /**
+     * Gets the frame's delta (time since last frame)
+     */
+    get delta() {
+        return this._delta;
+    }
+    /**
+     * Sets the frame's delta (time since last frame). Internal use only.
+     * @internal
+     */
+    set delta(value) {
+        this._delta = value;
+    }
+    /**
+     * Gets the frame's frames-per-second (FPS)
+     */
+    get fps() {
+        return this._fps;
+    }
+    /**
+     * Sets the frame's frames-per-second (FPS). Internal use only.
+     * @internal
+     */
+    set fps(value) {
+        this._fps = value;
+    }
+    /**
+     * Gets the frame's actor statistics
+     */
+    get actors() {
+        return this._actorStats;
+    }
+    /**
+     * Gets the frame's duration statistics
+     */
+    get duration() {
+        return this._durationStats;
+    }
+    /**
+     * Gets the frame's physics statistics
+     */
+    get physics() {
+        return this._physicsStats;
+    }
+    /**
+     * Gets the frame's graphics statistics
+     */
+    get graphics() {
+        return this._graphicsStats;
+    }
+}
+export class PhysicsStats {
+    constructor() {
+        this._pairs = 0;
+        this._collisions = 0;
+        this._contacts = new Map();
+        this._fastBodies = 0;
+        this._fastBodyCollisions = 0;
+        this._broadphase = 0;
+        this._narrowphase = 0;
+    }
+    /**
+     * Zero out values or clone other IPhysicsStats stats. Allows instance reuse.
+     *
+     * @param [otherStats] Optional stats to clone
+     */
+    reset(otherStats) {
+        if (otherStats) {
+            this.pairs = otherStats.pairs;
+            this.collisions = otherStats.collisions;
+            this.contacts = otherStats.contacts;
+            this.fastBodies = otherStats.fastBodies;
+            this.fastBodyCollisions = otherStats.fastBodyCollisions;
+            this.broadphase = otherStats.broadphase;
+            this.narrowphase = otherStats.narrowphase;
+        }
+        else {
+            this.pairs = this.collisions = this.fastBodies = 0;
+            this.fastBodyCollisions = this.broadphase = this.narrowphase = 0;
+            this.contacts.clear();
+        }
+    }
+    /**
+     * Provides a clone of this instance.
+     */
+    clone() {
+        const ps = new PhysicsStats();
+        ps.reset(this);
+        return ps;
+    }
+    get pairs() {
+        return this._pairs;
+    }
+    set pairs(value) {
+        this._pairs = value;
+    }
+    get collisions() {
+        return this._collisions;
+    }
+    set collisions(value) {
+        this._collisions = value;
+    }
+    get contacts() {
+        return this._contacts;
+    }
+    set contacts(contacts) {
+        this._contacts = contacts;
+    }
+    get fastBodies() {
+        return this._fastBodies;
+    }
+    set fastBodies(value) {
+        this._fastBodies = value;
+    }
+    get fastBodyCollisions() {
+        return this._fastBodyCollisions;
+    }
+    set fastBodyCollisions(value) {
+        this._fastBodyCollisions = value;
+    }
+    get broadphase() {
+        return this._broadphase;
+    }
+    set broadphase(value) {
+        this._broadphase = value;
+    }
+    get narrowphase() {
+        return this._narrowphase;
+    }
+    set narrowphase(value) {
+        this._narrowphase = value;
+    }
+}
+//# sourceMappingURL=Debug.js.map

package/build/dist/Debug/Debug.js.map

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

package/build/dist/Debug/DebugFlags.js

@@ -0,0 +1,40 @@
+import { ColorBlindnessMode } from '../Graphics/PostProcessor/ColorBlindnessMode';
+import { ColorBlindnessPostProcessor } from '../Graphics/PostProcessor/ColorBlindnessPostProcessor';
+import { ExcaliburGraphicsContextWebGL } from '..';
+export class ColorBlindFlags {
+    constructor(engine) {
+        this._engine = engine;
+        this._colorBlindPostProcessor = new ColorBlindnessPostProcessor(ColorBlindnessMode.Protanope);
+    }
+    /**
+     * Correct colors for a specified color blindness
+     * @param colorBlindness
+     */
+    correct(colorBlindness) {
+        if (this._engine.graphicsContext instanceof ExcaliburGraphicsContextWebGL) {
+            this.clear();
+            this._colorBlindPostProcessor.colorBlindnessMode = colorBlindness;
+            this._colorBlindPostProcessor.simulate = false;
+            this._engine.graphicsContext.addPostProcessor(this._colorBlindPostProcessor);
+        }
+    }
+    /**
+     * Simulate colors for a specified color blindness
+     * @param colorBlindness
+     */
+    simulate(colorBlindness) {
+        if (this._engine.graphicsContext instanceof ExcaliburGraphicsContextWebGL) {
+            this.clear();
+            this._colorBlindPostProcessor.colorBlindnessMode = colorBlindness;
+            this._colorBlindPostProcessor.simulate = true;
+            this._engine.graphicsContext.addPostProcessor(this._colorBlindPostProcessor);
+        }
+    }
+    /**
+     * Remove color blindness post processor
+     */
+    clear() {
+        this._engine.graphicsContext.removePostProcessor(this._colorBlindPostProcessor);
+    }
+}
+//# sourceMappingURL=DebugFlags.js.map

package/build/dist/Debug/DebugFlags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DebugFlags.js","sourceRoot":"","sources":["../../../src/engine/Debug/DebugFlags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAClF,OAAO,EAAE,2BAA2B,EAAE,MAAM,uDAAuD,CAAC;AAEpG,OAAO,EAAE,6BAA6B,EAAE,MAAM,IAAI,CAAC;AAMnD,MAAM,OAAO,eAAe;IAI1B,YAAY,MAAc;QACxB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,wBAAwB,GAAG,IAAI,2BAA2B,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAChG,CAAC;IAED;;;OAGG;IACI,OAAO,CAAC,cAAkC;QAC/C,IAAI,IAAI,CAAC,OAAO,CAAC,eAAe,YAAY,6BAA6B,EAAE;YACzE,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,wBAAwB,CAAC,kBAAkB,GAAG,cAAc,CAAC;YAClE,IAAI,CAAC,wBAAwB,CAAC,QAAQ,GAAG,KAAK,CAAC;YAC/C,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,gBAAgB,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;SAC9E;IACH,CAAC;IAED;;;OAGG;IACI,QAAQ,CAAC,cAAkC;QAChD,IAAI,IAAI,CAAC,OAAO,CAAC,eAAe,YAAY,6BAA6B,EAAE;YACzE,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,wBAAwB,CAAC,kBAAkB,GAAG,cAAc,CAAC;YAClE,IAAI,CAAC,wBAAwB,CAAC,QAAQ,GAAG,IAAI,CAAC;YAC9C,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,gBAAgB,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;SAC9E;IACH,CAAC;IAED;;OAEG;IACI,KAAK;QACV,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,mBAAmB,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IAClF,CAAC;CACF"}

package/build/dist/Debug/DebugSystem.js

@@ -0,0 +1,251 @@
+import { MotionComponent } from '../EntityComponentSystem/Components/MotionComponent';
+import { ColliderComponent } from '../Collision/ColliderComponent';
+import { CoordPlane, TransformComponent } from '../EntityComponentSystem';
+import { System, SystemType } from '../EntityComponentSystem/System';
+import { vec, Vector } from '../Math/vector';
+import { toDegrees } from '../Math/util';
+import { BodyComponent, CollisionSystem, CompositeCollider, GraphicsComponent, Particle } from '..';
+import { DebugGraphicsComponent } from '../Graphics/DebugGraphicsComponent';
+export class DebugSystem extends System {
+    constructor() {
+        super(...arguments);
+        this.types = ['ex.transform'];
+        this.systemType = SystemType.Draw;
+        this.priority = 999; // lowest priority
+    }
+    initialize(scene) {
+        this._graphicsContext = scene.engine.graphicsContext;
+        this._camera = scene.camera;
+        this._engine = scene.engine;
+        this._collisionSystem = scene.world.systemManager.get(CollisionSystem);
+    }
+    update(entities, _delta) {
+        var _a, _b;
+        if (!this._engine.isDebug) {
+            return;
+        }
+        const filterSettings = this._engine.debug.filter;
+        let id;
+        let name;
+        const entitySettings = this._engine.debug.entity;
+        let tx;
+        const txSettings = this._engine.debug.transform;
+        let motion;
+        const motionSettings = this._engine.debug.motion;
+        let colliderComp;
+        const colliderSettings = this._engine.debug.collider;
+        const physicsSettings = this._engine.debug.physics;
+        let graphics;
+        const graphicsSettings = this._engine.debug.graphics;
+        let debugDraw;
+        let body;
+        const bodySettings = this._engine.debug.body;
+        const cameraSettings = this._engine.debug.camera;
+        for (const entity of entities) {
+            if (entity.hasTag('offscreen')) {
+                // skip offscreen entities
+                continue;
+            }
+            if (entity instanceof Particle) {
+                // Particles crush the renderer :(
+                continue;
+            }
+            if (filterSettings.useFilter) {
+                const allIds = filterSettings.ids.length === 0;
+                const idMatch = allIds || filterSettings.ids.includes(entity.id);
+                if (!idMatch) {
+                    continue;
+                }
+                const allNames = filterSettings.nameQuery === '';
+                const nameMatch = allNames || entity.name.includes(filterSettings.nameQuery);
+                if (!nameMatch) {
+                    continue;
+                }
+            }
+            let cursor = Vector.Zero;
+            const lineHeight = vec(0, 16);
+            id = entity.id;
+            name = entity.name;
+            tx = entity.get(TransformComponent);
+            // This optionally sets our camera based on the entity coord plan (world vs. screen)
+            this._pushCameraTransform(tx);
+            this._graphicsContext.save();
+            this._applyTransform(entity);
+            if (tx) {
+                if (txSettings.showAll || txSettings.showPosition) {
+                    this._graphicsContext.debug.drawPoint(Vector.Zero, { size: 4, color: txSettings.positionColor });
+                }
+                if (txSettings.showAll || txSettings.showPositionLabel) {
+                    this._graphicsContext.debug.drawText(`pos${tx.pos.toString(2)}`, cursor);
+                    cursor = cursor.add(lineHeight);
+                }
+                if (entitySettings.showAll || entitySettings.showId) {
+                    this._graphicsContext.debug.drawText(`id(${id}) ${tx.parent ? 'child of id(' + ((_b = (_a = tx.parent) === null || _a === void 0 ? void 0 : _a.owner) === null || _b === void 0 ? void 0 : _b.id) + ')' : ''}`, cursor);
+                    cursor = cursor.add(lineHeight);
+                }
+                if (entitySettings.showAll || entitySettings.showName) {
+                    this._graphicsContext.debug.drawText(`name(${name})`, cursor);
+                    cursor = cursor.add(lineHeight);
+                }
+                if (txSettings.showAll || txSettings.showRotation) {
+                    this._graphicsContext.drawLine(Vector.Zero, Vector.fromAngle(tx.rotation).scale(50).add(Vector.Zero), txSettings.rotationColor, 2);
+                    this._graphicsContext.debug.drawText(`rot deg(${toDegrees(tx.rotation).toFixed(2)})`, cursor);
+                    cursor = cursor.add(lineHeight);
+                }
+                if (txSettings.showAll || txSettings.showScale) {
+                    this._graphicsContext.drawLine(Vector.Zero, tx.scale.add(Vector.Zero), txSettings.scaleColor, 2);
+                }
+            }
+            graphics = entity.get(GraphicsComponent);
+            if (graphics) {
+                if (graphicsSettings.showAll || graphicsSettings.showBounds) {
+                    const bounds = graphics.localBounds;
+                    bounds.draw(this._graphicsContext, graphicsSettings.boundsColor);
+                }
+            }
+            debugDraw = entity.get(DebugGraphicsComponent);
+            if (debugDraw) {
+                debugDraw.draw(this._graphicsContext);
+            }
+            body = entity.get(BodyComponent);
+            if (body) {
+                if (bodySettings.showAll || bodySettings.showCollisionGroup) {
+                    this._graphicsContext.debug.drawText(`collision group(${body.group.name})`, cursor);
+                    cursor = cursor.add(lineHeight);
+                }
+                if (bodySettings.showAll || bodySettings.showCollisionType) {
+                    this._graphicsContext.debug.drawText(`collision type(${body.collisionType})`, cursor);
+                    cursor = cursor.add(lineHeight);
+                }
+                if (bodySettings.showAll || bodySettings.showMass) {
+                    this._graphicsContext.debug.drawText(`mass(${body.mass})`, cursor);
+                    cursor = cursor.add(lineHeight);
+                }
+                if (bodySettings.showAll || bodySettings.showMotion) {
+                    this._graphicsContext.debug.drawText(`motion(${body.sleepMotion})`, cursor);
+                    cursor = cursor.add(lineHeight);
+                }
+                if (bodySettings.showAll || bodySettings.showSleeping) {
+                    this._graphicsContext.debug.drawText(`sleeping(${body.canSleep ? body.sleeping : 'cant sleep'})`, cursor);
+                    cursor = cursor.add(lineHeight);
+                }
+            }
+            this._graphicsContext.restore();
+            motion = entity.get(MotionComponent);
+            if (motion) {
+                if (motionSettings.showAll || motionSettings.showVelocity) {
+                    this._graphicsContext.debug.drawText(`vel${motion.vel.toString(2)}`, cursor.add(tx.globalPos));
+                    this._graphicsContext.drawLine(tx.globalPos, tx.globalPos.add(motion.vel), motionSettings.velocityColor, 2);
+                    cursor = cursor.add(lineHeight);
+                }
+                if (motionSettings.showAll || motionSettings.showAcceleration) {
+                    this._graphicsContext.drawLine(tx.globalPos, tx.globalPos.add(motion.acc), motionSettings.accelerationColor, 2);
+                }
+            }
+            // Colliders live in world space already so after the restore()
+            colliderComp = entity.get(ColliderComponent);
+            if (colliderComp) {
+                const collider = colliderComp.get();
+                if ((colliderSettings.showAll || colliderSettings.showGeometry) && collider) {
+                    collider.debug(this._graphicsContext, colliderSettings.geometryColor);
+                }
+                if (colliderSettings.showAll || colliderSettings.showBounds) {
+                    if (collider instanceof CompositeCollider) {
+                        const colliders = collider.getColliders();
+                        for (const collider of colliders) {
+                            const bounds = collider.bounds;
+                            const pos = vec(bounds.left, bounds.top);
+                            this._graphicsContext.debug.drawRect(pos.x, pos.y, bounds.width, bounds.height, { color: colliderSettings.boundsColor });
+                            if (colliderSettings.showAll || colliderSettings.showOwner) {
+                                this._graphicsContext.debug.drawText(`owner id(${collider.owner.id})`, pos);
+                            }
+                        }
+                        colliderComp.bounds.draw(this._graphicsContext, colliderSettings.boundsColor);
+                    }
+                    else if (collider) {
+                        const bounds = colliderComp.bounds;
+                        const pos = vec(bounds.left, bounds.top);
+                        this._graphicsContext.debug.drawRect(pos.x, pos.y, bounds.width, bounds.height, { color: colliderSettings.boundsColor });
+                        if (colliderSettings.showAll || colliderSettings.showOwner) {
+                            this._graphicsContext.debug.drawText(`owner id(${colliderComp.owner.id})`, pos);
+                        }
+                    }
+                }
+            }
+            this._popCameraTransform(tx);
+        }
+        this._graphicsContext.save();
+        this._camera.draw(this._graphicsContext);
+        if (physicsSettings.showAll || physicsSettings.showBroadphaseSpacePartitionDebug) {
+            this._collisionSystem.debug(this._graphicsContext);
+        }
+        if (physicsSettings.showAll || physicsSettings.showCollisionContacts || physicsSettings.showCollisionNormals) {
+            for (const [_, contact] of this._engine.debug.stats.currFrame.physics.contacts) {
+                if (physicsSettings.showAll || physicsSettings.showCollisionContacts) {
+                    for (const point of contact.points) {
+                        this._graphicsContext.debug.drawPoint(point, { size: 5, color: physicsSettings.collisionContactColor });
+                    }
+                }
+                if (physicsSettings.showAll || physicsSettings.showCollisionNormals) {
+                    for (const point of contact.points) {
+                        this._graphicsContext.debug.drawLine(point, contact.normal.scale(30).add(point), {
+                            color: physicsSettings.collisionNormalColor
+                        });
+                    }
+                }
+            }
+        }
+        this._graphicsContext.restore();
+        if (cameraSettings) {
+            this._graphicsContext.save();
+            this._camera.draw(this._graphicsContext);
+            if (cameraSettings.showAll || cameraSettings.showFocus) {
+                this._graphicsContext.drawCircle(this._camera.pos, 4, cameraSettings.focusColor);
+            }
+            if (cameraSettings.showAll || cameraSettings.showZoom) {
+                this._graphicsContext.debug.drawText(`zoom(${this._camera.zoom})`, this._camera.pos);
+            }
+            this._graphicsContext.restore();
+        }
+        this._graphicsContext.flush();
+    }
+    /**
+     * This applies the current entity transform to the graphics context
+     * @param entity
+     */
+    _applyTransform(entity) {
+        const ancestors = entity.getAncestors();
+        for (const ancestor of ancestors) {
+            const transform = ancestor === null || ancestor === void 0 ? void 0 : ancestor.get(TransformComponent);
+            if (transform) {
+                this._graphicsContext.translate(transform.pos.x, transform.pos.y);
+                this._graphicsContext.scale(transform.scale.x, transform.scale.y);
+                this._graphicsContext.rotate(transform.rotation);
+            }
+        }
+    }
+    /**
+     * Applies the current camera transform if in world coordinates
+     * @param transform
+     */
+    _pushCameraTransform(transform) {
+        // Establish camera offset per entity
+        if (transform.coordPlane === CoordPlane.World) {
+            this._graphicsContext.save();
+            if (this._camera) {
+                this._camera.draw(this._graphicsContext);
+            }
+        }
+    }
+    /**
+     * Resets the current camera transform if in world coordinates
+     * @param transform
+     */
+    _popCameraTransform(transform) {
+        if (transform.coordPlane === CoordPlane.World) {
+            // Apply camera world offset
+            this._graphicsContext.restore();
+        }
+    }
+}
+//# sourceMappingURL=DebugSystem.js.map