excalibur 0.28.3 → 0.28.4

package/build/dist/Graphics/Animation.js

@@ -0,0 +1,344 @@
+import { Graphic } from './Graphic';
+import { Logger } from '../Util/Log';
+import { clamp } from '../Math/util';
+import { EventEmitter } from '../EventEmitter';
+export var AnimationDirection;
+(function (AnimationDirection) {
+    /**
+     * Animation is playing forwards
+     */
+    AnimationDirection["Forward"] = "forward";
+    /**
+     * Animation is playing backwards
+     */
+    AnimationDirection["Backward"] = "backward";
+})(AnimationDirection || (AnimationDirection = {}));
+export var AnimationStrategy;
+(function (AnimationStrategy) {
+    /**
+     * Animation ends without displaying anything
+     */
+    AnimationStrategy["End"] = "end";
+    /**
+     * Animation loops to the first frame after the last frame
+     */
+    AnimationStrategy["Loop"] = "loop";
+    /**
+     * Animation plays to the last frame, then backwards to the first frame, then repeats
+     */
+    AnimationStrategy["PingPong"] = "pingpong";
+    /**
+     * Animation ends stopping on the last frame
+     */
+    AnimationStrategy["Freeze"] = "freeze";
+})(AnimationStrategy || (AnimationStrategy = {}));
+export const AnimationEvents = {
+    Frame: 'frame',
+    Loop: 'loop',
+    End: 'end'
+};
+/**
+ * Create an Animation given a list of [[Frame|frames]] in [[AnimationOptions]]
+ *
+ * To create an Animation from a [[SpriteSheet]], use [[Animation.fromSpriteSheet]]
+ */
+export class Animation extends Graphic {
+    constructor(options) {
+        var _a, _b;
+        super(options);
+        this.events = new EventEmitter();
+        this.frames = [];
+        this.strategy = AnimationStrategy.Loop;
+        this.frameDuration = 100;
+        this.timeScale = 1;
+        this._idempotencyToken = -1;
+        this._firstTick = true;
+        this._currentFrame = 0;
+        this._timeLeftInFrame = 0;
+        this._pingPongDirection = 1;
+        this._done = false;
+        this._playing = true;
+        this._reversed = false;
+        this.frames = options.frames;
+        this.strategy = (_a = options.strategy) !== null && _a !== void 0 ? _a : this.strategy;
+        this.frameDuration = options.totalDuration ? options.totalDuration / this.frames.length : (_b = options.frameDuration) !== null && _b !== void 0 ? _b : this.frameDuration;
+        if (options.reverse) {
+            this.reverse();
+        }
+        this.goToFrame(0);
+    }
+    clone() {
+        return new Animation({
+            frames: this.frames.map((f) => ({ ...f })),
+            frameDuration: this.frameDuration,
+            reverse: this._reversed,
+            strategy: this.strategy,
+            ...this.cloneGraphicOptions()
+        });
+    }
+    get width() {
+        const maybeFrame = this.currentFrame;
+        if (maybeFrame) {
+            return Math.abs(maybeFrame.graphic.width * this.scale.x);
+        }
+        return 0;
+    }
+    get height() {
+        const maybeFrame = this.currentFrame;
+        if (maybeFrame) {
+            return Math.abs(maybeFrame.graphic.height * this.scale.y);
+        }
+        return 0;
+    }
+    /**
+     * Create an Animation from a [[SpriteSheet]], a list of indices into the sprite sheet, a duration per frame
+     * and optional [[AnimationStrategy]]
+     *
+     * Example:
+     * ```typescript
+     * const spriteSheet = SpriteSheet.fromImageSource({...});
+     *
+     * const anim = Animation.fromSpriteSheet(spriteSheet, range(0, 5), 200, AnimationStrategy.Loop);
+     * ```
+     * @param spriteSheet
+     * @param frameIndices
+     * @param durationPerFrameMs
+     * @param strategy
+     */
+    static fromSpriteSheet(spriteSheet, frameIndices, durationPerFrameMs, strategy = AnimationStrategy.Loop) {
+        const maxIndex = spriteSheet.sprites.length - 1;
+        const invalidIndices = frameIndices.filter((index) => index < 0 || index > maxIndex);
+        if (invalidIndices.length) {
+            Animation._LOGGER.warn(`Indices into SpriteSheet were provided that don\'t exist: ${invalidIndices.join(',')} no frame will be shown`);
+        }
+        return new Animation({
+            frames: spriteSheet.sprites
+                .filter((_, index) => frameIndices.indexOf(index) > -1)
+                .map((f) => ({
+                graphic: f,
+                duration: durationPerFrameMs
+            })),
+            strategy: strategy
+        });
+    }
+    /**
+     * Create an [[Animation]] from a [[SpriteSheet]] given a list of coordinates
+     *
+     * Example:
+     * ```typescript
+     * const spriteSheet = SpriteSheet.fromImageSource({...});
+     *
+     * const anim = Animation.fromSpriteSheetCoordinates({
+     *  spriteSheet,
+     *  frameCoordinates: [
+     *    {x: 0, y: 5, duration: 100},
+     *    {x: 1, y: 5, duration: 200},
+     *    {x: 2, y: 5, duration: 100},
+     *    {x: 3, y: 5, duration: 500}
+     *  ],
+     *  strategy: AnimationStrategy.PingPong
+     * });
+     * ```
+     * @param options
+     * @returns Animation
+     */
+    static fromSpriteSheetCoordinates(options) {
+        const { spriteSheet, frameCoordinates, durationPerFrameMs, strategy, reverse } = options;
+        const defaultDuration = durationPerFrameMs !== null && durationPerFrameMs !== void 0 ? durationPerFrameMs : 100;
+        const frames = [];
+        for (const coord of frameCoordinates) {
+            const { x, y, duration } = coord;
+            const sprite = spriteSheet.getSprite(x, y);
+            if (sprite) {
+                frames.push({
+                    graphic: sprite,
+                    duration: duration !== null && duration !== void 0 ? duration : defaultDuration
+                });
+            }
+            else {
+                Animation._LOGGER.warn(`Skipping frame! SpriteSheet does not have coordinate (${x}, ${y}), please check your SpriteSheet to confirm that sprite exists`);
+            }
+        }
+        return new Animation({
+            frames,
+            strategy,
+            reverse
+        });
+    }
+    /**
+     * Returns the current Frame of the animation
+     *
+     * Use [[Animation.currentFrameIndex]] to get the frame number and
+     * [[Animation.goToFrame]] to set the current frame index
+     */
+    get currentFrame() {
+        if (this._currentFrame >= 0 && this._currentFrame < this.frames.length) {
+            return this.frames[this._currentFrame];
+        }
+        return null;
+    }
+    /**
+     * Returns the current frame index of the animation
+     *
+     * Use [[Animation.currentFrame]] to grab the current [[Frame]] object
+     */
+    get currentFrameIndex() {
+        return this._currentFrame;
+    }
+    /**
+     * Returns `true` if the animation is playing
+     */
+    get isPlaying() {
+        return this._playing;
+    }
+    /**
+     * Reverses the play direction of the Animation, this preserves the current frame
+     */
+    reverse() {
+        // Don't mutate with the original frame list, create a copy
+        this.frames = this.frames.slice().reverse();
+        this._reversed = !this._reversed;
+    }
+    /**
+     * Returns the current play direction of the animation
+     */
+    get direction() {
+        // Keep logically consistent with ping-pong direction
+        // If ping-pong is forward = 1 and reversed is true then we are logically reversed
+        const reversed = (this._reversed && this._pingPongDirection === 1) ? true : false;
+        return reversed ? AnimationDirection.Backward : AnimationDirection.Forward;
+    }
+    /**
+     * Plays or resumes the animation from the current frame
+     */
+    play() {
+        this._playing = true;
+    }
+    /**
+     * Pauses the animation on the current frame
+     */
+    pause() {
+        this._playing = false;
+        this._firstTick = true; // firstTick must be set to emit the proper frame event
+    }
+    /**
+     * Reset the animation back to the beginning, including if the animation were done
+     */
+    reset() {
+        this._done = false;
+        this._firstTick = true;
+        this._currentFrame = 0;
+    }
+    /**
+     * Returns `true` if the animation can end
+     */
+    get canFinish() {
+        switch (this.strategy) {
+            case AnimationStrategy.End:
+            case AnimationStrategy.Freeze: {
+                return true;
+            }
+            default: {
+                return false;
+            }
+        }
+    }
+    /**
+     * Returns `true` if the animation is done, for looping type animations
+     * `ex.AnimationStrategy.PingPong` and `ex.AnimationStrategy.Loop` this will always return `false`
+     *
+     * See the `ex.Animation.canFinish()` method to know if an animation type can end
+     */
+    get done() {
+        return this._done;
+    }
+    /**
+     * Jump the animation immediately to a specific frame if it exists
+     * @param frameNumber
+     */
+    goToFrame(frameNumber) {
+        this._currentFrame = frameNumber;
+        this._timeLeftInFrame = this.frameDuration;
+        const maybeFrame = this.frames[this._currentFrame];
+        if (maybeFrame && !this._done) {
+            this._timeLeftInFrame = (maybeFrame === null || maybeFrame === void 0 ? void 0 : maybeFrame.duration) || this.frameDuration;
+            this.events.emit('frame', { ...maybeFrame, frameIndex: this.currentFrameIndex });
+        }
+    }
+    _nextFrame() {
+        const currentFrame = this._currentFrame;
+        if (this._done) {
+            return currentFrame;
+        }
+        let next = -1;
+        switch (this.strategy) {
+            case AnimationStrategy.Loop: {
+                next = (currentFrame + 1) % this.frames.length;
+                if (next === 0) {
+                    this.events.emit('loop', this);
+                }
+                break;
+            }
+            case AnimationStrategy.End: {
+                next = currentFrame + 1;
+                if (next >= this.frames.length) {
+                    this._done = true;
+                    this._currentFrame = this.frames.length;
+                    this.events.emit('end', this);
+                }
+                break;
+            }
+            case AnimationStrategy.Freeze: {
+                next = clamp(currentFrame + 1, 0, this.frames.length - 1);
+                if (next >= this.frames.length - 1) {
+                    this._done = true;
+                    this.events.emit('end', this);
+                }
+                break;
+            }
+            case AnimationStrategy.PingPong: {
+                if (currentFrame + this._pingPongDirection >= this.frames.length) {
+                    this._pingPongDirection = -1;
+                    this.events.emit('loop', this);
+                }
+                if (currentFrame + this._pingPongDirection < 0) {
+                    this._pingPongDirection = 1;
+                    this.events.emit('loop', this);
+                }
+                next = currentFrame + (this._pingPongDirection % this.frames.length);
+                break;
+            }
+        }
+        return next;
+    }
+    /**
+     * Called internally by Excalibur to update the state of the animation potential update the current frame
+     * @param elapsedMilliseconds Milliseconds elapsed
+     * @param idempotencyToken Prevents double ticking in a frame by passing a unique token to the frame
+     */
+    tick(elapsedMilliseconds, idempotencyToken = 0) {
+        if (this._idempotencyToken === idempotencyToken) {
+            return;
+        }
+        this._idempotencyToken = idempotencyToken;
+        if (!this._playing) {
+            return;
+        }
+        // if it's the first frame emit frame event
+        if (this._firstTick) {
+            this._firstTick = false;
+            this.events.emit('frame', { ...this.currentFrame, frameIndex: this.currentFrameIndex });
+        }
+        this._timeLeftInFrame -= elapsedMilliseconds * this.timeScale;
+        if (this._timeLeftInFrame <= 0) {
+            this.goToFrame(this._nextFrame());
+        }
+    }
+    _drawImage(ctx, x, y) {
+        if (this.currentFrame) {
+            this.currentFrame.graphic.draw(ctx, x, y);
+        }
+    }
+}
+Animation._LOGGER = Logger.getInstance();
+//# sourceMappingURL=Animation.js.map

package/build/dist/Graphics/Animation.js.map

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

package/build/dist/Graphics/Canvas.js

@@ -0,0 +1,38 @@
+import { Raster } from './Raster';
+/**
+ * A canvas [[Graphic]] to provide an adapter between the 2D Canvas API and the [[ExcaliburGraphicsContext]].
+ *
+ * The [[Canvas]] works by re-rastering a draw handler to a HTMLCanvasElement for every draw which is then passed
+ * to the [[ExcaliburGraphicsContext]] implementation as a rendered image.
+ *
+ * **Low performance API**
+ */
+export class Canvas extends Raster {
+    /**
+     * Return the 2D graphics context of this canvas
+     */
+    get ctx() {
+        return this._ctx;
+    }
+    constructor(_options) {
+        super(_options);
+        this._options = _options;
+    }
+    clone() {
+        return new Canvas({
+            ...this._options,
+            ...this.cloneGraphicOptions(),
+            ...this.cloneRasterOptions()
+        });
+    }
+    execute(ctx) {
+        var _a, _b;
+        if ((_a = this._options) === null || _a === void 0 ? void 0 : _a.draw) {
+            (_b = this._options) === null || _b === void 0 ? void 0 : _b.draw(ctx);
+        }
+        if (!this._options.cache) {
+            this.flagDirty();
+        }
+    }
+}
+//# sourceMappingURL=Canvas.js.map

package/build/dist/Graphics/Canvas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Canvas.js","sourceRoot":"","sources":["../../../src/engine/Graphics/Canvas.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAiB,MAAM,UAAU,CAAC;AAOjD;;;;;;;GAOG;AACH,MAAM,OAAO,MAAO,SAAQ,MAAM;IAChC;;OAEG;IACH,IAAW,GAAG;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,YAAoB,QAAwD;QAC1E,KAAK,CAAC,QAAQ,CAAC,CAAC;QADE,aAAQ,GAAR,QAAQ,CAAgD;IAE5E,CAAC;IAEM,KAAK;QACV,OAAO,IAAI,MAAM,CAAC;YAChB,GAAG,IAAI,CAAC,QAAQ;YAChB,GAAG,IAAI,CAAC,mBAAmB,EAAE;YAC7B,GAAG,IAAI,CAAC,kBAAkB,EAAE;SAC7B,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,GAA6B;;QACnC,IAAI,MAAA,IAAI,CAAC,QAAQ,0CAAE,IAAI,EAAE,CAAC;YACxB,MAAA,IAAI,CAAC,QAAQ,0CAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;CACF"}

package/build/dist/Graphics/Circle.js

@@ -0,0 +1,48 @@
+import { ImageFiltering } from '.';
+import { Raster } from './Raster';
+/**
+ * A circle [[Graphic]] for drawing circles to the [[ExcaliburGraphicsContext]]
+ *
+ * Circles default to [[ImageFiltering.Blended]]
+ */
+export class Circle extends Raster {
+    get radius() {
+        return this._radius;
+    }
+    set radius(value) {
+        this._radius = value;
+        this.width = this._radius * 2;
+        this.height = this._radius * 2;
+        this.flagDirty();
+    }
+    constructor(options) {
+        var _a, _b, _c;
+        super(options);
+        this._radius = 0;
+        const lineWidth = (_a = options.lineWidth) !== null && _a !== void 0 ? _a : (options.strokeColor ? 1 : 0); // default lineWidth in canvas is 1px
+        this.padding = (_b = options.padding) !== null && _b !== void 0 ? _b : 2 + (lineWidth / 2); // default 2 padding for circles looks nice
+        this.radius = options.radius;
+        this.filtering = (_c = options.filtering) !== null && _c !== void 0 ? _c : ImageFiltering.Blended;
+        this.rasterize();
+    }
+    clone() {
+        return new Circle({
+            radius: this.radius,
+            ...this.cloneGraphicOptions(),
+            ...this.cloneRasterOptions()
+        });
+    }
+    execute(ctx) {
+        if (this.radius > 0) {
+            ctx.beginPath();
+            ctx.arc(this.radius, this.radius, this.radius, 0, Math.PI * 2);
+            if (this.color) {
+                ctx.fill();
+            }
+            if (this.strokeColor) {
+                ctx.stroke();
+            }
+        }
+    }
+}
+//# sourceMappingURL=Circle.js.map

package/build/dist/Graphics/Circle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Circle.js","sourceRoot":"","sources":["../../../src/engine/Graphics/Circle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,GAAG,CAAC;AACnC,OAAO,EAAE,MAAM,EAAiB,MAAM,UAAU,CAAC;AAMjD;;;;GAIG;AACH,MAAM,OAAO,MAAO,SAAQ,MAAM;IAEhC,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IACD,IAAW,MAAM,CAAC,KAAa;QAC7B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,SAAS,EAAE,CAAC;IACnB,CAAC;IACD,YAAY,OAAsC;;QAChD,KAAK,CAAC,OAAO,CAAC,CAAC;QAXT,YAAO,GAAW,CAAC,CAAC;QAY1B,MAAM,SAAS,GAAG,MAAA,OAAO,CAAC,SAAS,mCAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,qCAAqC;QAC3G,IAAI,CAAC,OAAO,GAAG,MAAA,OAAO,CAAC,OAAO,mCAAI,CAAC,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,2CAA2C;QAClG,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,MAAA,OAAO,CAAC,SAAS,mCAAI,cAAc,CAAC,OAAO,CAAC;QAC7D,IAAI,CAAC,SAAS,EAAE,CAAC;IACnB,CAAC;IAEM,KAAK;QACV,OAAO,IAAI,MAAM,CAAC;YAChB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,IAAI,CAAC,mBAAmB,EAAE;YAC7B,GAAG,IAAI,CAAC,kBAAkB,EAAE;SAC7B,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,GAA6B;QACnC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,GAAG,CAAC,SAAS,EAAE,CAAC;YAChB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YAE/D,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACf,GAAG,CAAC,IAAI,EAAE,CAAC;YACb,CAAC;YAED,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACrB,GAAG,CAAC,MAAM,EAAE,CAAC;YACf,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/build/dist/Graphics/Context/ExcaliburGraphicsContext.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ExcaliburGraphicsContext.js.map

package/build/dist/Graphics/Context/ExcaliburGraphicsContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExcaliburGraphicsContext.js","sourceRoot":"","sources":["../../../../src/engine/Graphics/Context/ExcaliburGraphicsContext.ts"],"names":[],"mappings":""}