excalibur 0.25.2 → 0.25.3

package/build/dist/Graphics/Raster.js

@@ -0,0 +1,207 @@
+import { Graphic } from './Graphic';
+import { Color } from '../Color';
+import { ensurePowerOfTwo } from './Context/webgl-util';
+import { Vector } from '../Math/vector';
+import { BoundingBox } from '../Collision/BoundingBox';
+import { watch } from '../Util/Watch';
+import { TextureLoader } from './Context/texture-loader';
+/**
+ * A Raster is a Graphic that needs to be first painted to a HTMLCanvasElement before it can be drawn to the
+ * [[ExcaliburGraphicsContext]]. This is useful for generating custom images using the 2D canvas api.
+ *
+ * Implementors must implement the [[Raster.execute]] method to rasterize their drawing.
+ */
+export class Raster extends Graphic {
+    constructor(options) {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        super(options);
+        this.filtering = null;
+        this._dirty = true;
+        this._smoothing = false;
+        this._color = watch(Color.Black, () => this.flagDirty());
+        this._lineWidth = 1;
+        this._lineDash = [];
+        this._padding = 0;
+        if (options) {
+            this.color = (_a = options.color) !== null && _a !== void 0 ? _a : Color.Black;
+            this.strokeColor = options === null || options === void 0 ? void 0 : options.strokeColor;
+            this.smoothing = (_b = options.smoothing) !== null && _b !== void 0 ? _b : this.smoothing;
+            this.lineWidth = (_c = options.lineWidth) !== null && _c !== void 0 ? _c : this.lineWidth;
+            this.lineDash = (_d = options.lineDash) !== null && _d !== void 0 ? _d : this.lineDash;
+            this.padding = (_e = options.padding) !== null && _e !== void 0 ? _e : this.padding;
+            this.filtering = (_f = options.filtering) !== null && _f !== void 0 ? _f : this.filtering;
+        }
+        this._bitmap = document.createElement('canvas');
+        // get the default canvas width/height as a fallback
+        const bitmapWidth = (_g = options === null || options === void 0 ? void 0 : options.width) !== null && _g !== void 0 ? _g : this._bitmap.width;
+        const bitmapHeight = (_h = options === null || options === void 0 ? void 0 : options.height) !== null && _h !== void 0 ? _h : this._bitmap.height;
+        // Rasters use power of two images as an optimization for webgl
+        this.width = ensurePowerOfTwo(bitmapWidth);
+        this.height = ensurePowerOfTwo(bitmapHeight);
+        const maybeCtx = this._bitmap.getContext('2d');
+        if (!maybeCtx) {
+            /* istanbul ignore next */
+            throw new Error('Browser does not support 2d canvas drawing, cannot create Raster graphic');
+        }
+        else {
+            this._ctx = maybeCtx;
+        }
+    }
+    cloneRasterOptions() {
+        return {
+            color: this.color ? this.color.clone() : null,
+            strokeColor: this.strokeColor ? this.strokeColor.clone() : null,
+            smoothing: this.smoothing,
+            lineWidth: this.lineWidth,
+            lineDash: this.lineDash,
+            padding: this.padding
+        };
+    }
+    /**
+     * Gets whether the graphic is dirty, this means there are changes that haven't been re-rasterized
+     */
+    get dirty() {
+        return this._dirty;
+    }
+    /**
+     * Flags the graphic as dirty, meaning it must be re-rasterized before draw.
+     * This should be called any time the graphics state changes such that it affects the outputted drawing
+     */
+    flagDirty() {
+        this._dirty = true;
+    }
+    /**
+     * Gets or sets the current width of the Raster graphic. Setting the width will cause the raster
+     * to be flagged dirty causing a re-raster on the next draw.
+     *
+     * Any `padding`s set will be factored into the width
+     */
+    get width() {
+        return Math.abs(this._getTotalWidth() * this.scale.x);
+    }
+    set width(value) {
+        value /= Math.abs(this.scale.x);
+        this._bitmap.width = value;
+        this._originalWidth = value;
+        this.flagDirty();
+    }
+    /**
+     * Gets or sets the current height of the Raster graphic. Setting the height will cause the raster
+     * to be flagged dirty causing a re-raster on the next draw.
+     *
+     * Any `padding` set will be factored into the height
+     */
+    get height() {
+        return Math.abs(this._getTotalHeight() * this.scale.y);
+    }
+    set height(value) {
+        value /= Math.abs(this.scale.y);
+        this._bitmap.height = value;
+        this._originalHeight = value;
+        this.flagDirty();
+    }
+    _getTotalWidth() {
+        var _a;
+        return ((_a = this._originalWidth) !== null && _a !== void 0 ? _a : this._bitmap.width) + this.padding * 2;
+    }
+    _getTotalHeight() {
+        var _a;
+        return ((_a = this._originalHeight) !== null && _a !== void 0 ? _a : this._bitmap.height) + this.padding * 2;
+    }
+    /**
+     * Returns the local bounds of the Raster including the padding
+     */
+    get localBounds() {
+        return BoundingBox.fromDimension(this._getTotalWidth() * this.scale.x, this._getTotalHeight() * this.scale.y, Vector.Zero);
+    }
+    /**
+     * Gets or sets the smoothing (anti-aliasing of the graphic). Setting the height will cause the raster
+     * to be flagged dirty causing a re-raster on the next draw.
+     */
+    get smoothing() {
+        return this._smoothing;
+    }
+    set smoothing(value) {
+        this._smoothing = value;
+        this.flagDirty();
+    }
+    /**
+     * Gets or sets the fillStyle of the Raster graphic. Setting the fillStyle will cause the raster to be
+     * flagged dirty causing a re-raster on the next draw.
+     */
+    get color() {
+        return this._color;
+    }
+    set color(value) {
+        this.flagDirty();
+        this._color = watch(value, () => this.flagDirty());
+    }
+    /**
+     * Gets or sets the strokeStyle of the Raster graphic. Setting the strokeStyle will cause the raster to be
+     * flagged dirty causing a re-raster on the next draw.
+     */
+    get strokeColor() {
+        return this._strokeColor;
+    }
+    set strokeColor(value) {
+        this.flagDirty();
+        this._strokeColor = watch(value, () => this.flagDirty());
+    }
+    /**
+     * Gets or sets the line width of the Raster graphic. Setting the lineWidth will cause the raster to be
+     * flagged dirty causing a re-raster on the next draw.
+     */
+    get lineWidth() {
+        return this._lineWidth;
+    }
+    set lineWidth(value) {
+        this._lineWidth = value;
+        this.flagDirty();
+    }
+    get lineDash() {
+        return this._lineDash;
+    }
+    set lineDash(value) {
+        this._lineDash = value;
+        this.flagDirty();
+    }
+    get padding() {
+        return this._padding;
+    }
+    set padding(value) {
+        this._padding = value;
+        this.flagDirty();
+    }
+    /**
+     * Rasterize the graphic to a bitmap making it usable as in excalibur. Rasterize is called automatically if
+     * the graphic is [[Raster.dirty]] on the next [[Graphic.draw]] call
+     */
+    rasterize() {
+        this._dirty = false;
+        this._ctx.clearRect(0, 0, this._getTotalWidth(), this._getTotalHeight());
+        this._ctx.save();
+        this._applyRasterProperties(this._ctx);
+        this.execute(this._ctx);
+        this._ctx.restore();
+        // The webgl texture needs to be updated if it exists after a raster cycle
+        TextureLoader.load(this._bitmap, this.filtering, true);
+    }
+    _applyRasterProperties(ctx) {
+        var _a, _b, _c;
+        this._bitmap.width = this._getTotalWidth();
+        this._bitmap.height = this._getTotalHeight();
+        ctx.translate(this.padding, this.padding);
+        ctx.imageSmoothingEnabled = this.smoothing;
+        ctx.lineWidth = this.lineWidth;
+        ctx.setLineDash((_a = this.lineDash) !== null && _a !== void 0 ? _a : ctx.getLineDash());
+        ctx.strokeStyle = (_b = this.strokeColor) === null || _b === void 0 ? void 0 : _b.toString();
+        ctx.fillStyle = (_c = this.color) === null || _c === void 0 ? void 0 : _c.toString();
+    }
+    _drawImage(ex, x, y) {
+        if (this._dirty) {
+            this.rasterize();
+        }
+        ex.drawImage(this._bitmap, x, y);
+    }
+}
+//# sourceMappingURL=Raster.js.map

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

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

package/build/dist/Graphics/Rectangle.js

@@ -0,0 +1,29 @@
+import { Raster } from './Raster';
+/**
+ * A Rectangle [[Graphic]] for drawing rectangles to the [[ExcaliburGraphicsContext]]
+ */
+export class Rectangle extends Raster {
+    constructor(options) {
+        super(options);
+        this.width = options.width;
+        this.height = options.height;
+        this.rasterize();
+    }
+    clone() {
+        return new Rectangle({
+            width: this.width,
+            height: this.height,
+            ...this.cloneGraphicOptions(),
+            ...this.cloneRasterOptions()
+        });
+    }
+    execute(ctx) {
+        if (this.color) {
+            ctx.fillRect(0, 0, this.width, this.height);
+        }
+        if (this.strokeColor) {
+            ctx.strokeRect(0, 0, this.width, this.height);
+        }
+    }
+}
+//# sourceMappingURL=Rectangle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Rectangle.js","sourceRoot":"","sources":["../../../src/engine/Graphics/Rectangle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAiB,MAAM,UAAU,CAAC;AAOjD;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,MAAM;IACnC,YAAY,OAAyC;QACnD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,SAAS,EAAE,CAAC;IACnB,CAAC;IAEM,KAAK;QACV,OAAO,IAAI,SAAS,CAAC;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,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,KAAK,EAAE;YACd,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;SAC7C;QACD,IAAI,IAAI,CAAC,WAAW,EAAE;YACpB,GAAG,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;SAC/C;IACH,CAAC;CACF"}

package/build/dist/Graphics/Sprite.js

@@ -0,0 +1,103 @@
+import { Graphic } from './Graphic';
+import { ImageSource } from './ImageSource';
+import { Sprite as LegacySprite } from '../Drawing/Sprite';
+import { Texture } from '../Drawing/Texture';
+export class Sprite extends Graphic {
+    constructor(options) {
+        var _a, _b;
+        super(options);
+        this._dirty = true;
+        this.image = options.image;
+        const { width, height } = options;
+        this.sourceView = (_a = options.sourceView) !== null && _a !== void 0 ? _a : { x: 0, y: 0, width: width !== null && width !== void 0 ? width : 0, height: height !== null && height !== void 0 ? height : 0 };
+        this.destSize = (_b = options.destSize) !== null && _b !== void 0 ? _b : { width: width !== null && width !== void 0 ? width : 0, height: height !== null && height !== void 0 ? height : 0 };
+        this._updateSpriteDimensions();
+        this.image.ready.then(() => {
+            this._updateSpriteDimensions();
+        });
+    }
+    static from(image) {
+        return new Sprite({
+            image: image
+        });
+    }
+    get width() {
+        return Math.abs(this.destSize.width * this.scale.x);
+    }
+    get height() {
+        return Math.abs(this.destSize.height * this.scale.y);
+    }
+    set width(newWidth) {
+        newWidth /= Math.abs(this.scale.x);
+        this.destSize.width = newWidth;
+        super.width = Math.ceil(this.destSize.width);
+    }
+    set height(newHeight) {
+        newHeight /= Math.abs(this.scale.y);
+        this.destSize.height = newHeight;
+        super.height = Math.ceil(this.destSize.height);
+    }
+    _updateSpriteDimensions() {
+        var _a, _b, _c, _d, _e, _f;
+        const { width: nativeWidth, height: nativeHeight } = this.image;
+        // This code uses || to avoid 0's
+        // If the source is not specified, use the native dimension
+        this.sourceView.width = ((_a = this.sourceView) === null || _a === void 0 ? void 0 : _a.width) || nativeWidth;
+        this.sourceView.height = ((_b = this.sourceView) === null || _b === void 0 ? void 0 : _b.height) || nativeHeight;
+        // If the destination is not specified, use the source if specified, then native
+        this.destSize.width = ((_c = this.destSize) === null || _c === void 0 ? void 0 : _c.width) || ((_d = this.sourceView) === null || _d === void 0 ? void 0 : _d.width) || nativeWidth;
+        this.destSize.height = ((_e = this.destSize) === null || _e === void 0 ? void 0 : _e.height) || ((_f = this.sourceView) === null || _f === void 0 ? void 0 : _f.height) || nativeHeight;
+        this.width = Math.ceil(this.destSize.width) * this.scale.x;
+        this.height = Math.ceil(this.destSize.height) * this.scale.y;
+    }
+    _preDraw(ex, x, y) {
+        if (this.image.isLoaded() && this._dirty) {
+            this._dirty = false;
+            this._updateSpriteDimensions();
+        }
+        super._preDraw(ex, x, y);
+    }
+    _drawImage(ex, x, y) {
+        if (this.image.isLoaded()) {
+            ex.drawImage(this.image.image, this.sourceView.x, this.sourceView.y, this.sourceView.width, this.sourceView.height, x, y, this.destSize.width, this.destSize.height);
+        }
+    }
+    /**
+     * Create a ImageSource from legacy texture
+     * @param sprite
+     */
+    static fromLegacySprite(sprite) {
+        const tex = sprite.texture;
+        const image = ImageSource.fromLegacyTexture(tex);
+        return new Sprite({
+            image,
+            sourceView: {
+                x: sprite.x,
+                y: sprite.y,
+                width: sprite.width,
+                height: sprite.height
+            }
+        });
+    }
+    /**
+     * Converts a sprite to a Legacy sprite
+     * @deprecated
+     * @param sprite
+     * @returns LegacyDrawing.Sprite
+     */
+    static toLegacySprite(sprite) {
+        const image = sprite.image;
+        const tex = new Texture(image.path);
+        tex.data = image.image;
+        return new LegacySprite(tex, sprite.sourceView.x, sprite.sourceView.y, sprite.sourceView.width, sprite.sourceView.height);
+    }
+    clone() {
+        return new Sprite({
+            image: this.image,
+            sourceView: { ...this.sourceView },
+            destSize: { ...this.destSize },
+            ...this.cloneGraphicOptions()
+        });
+    }
+}
+//# sourceMappingURL=Sprite.js.map

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

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

package/build/dist/Graphics/SpriteFont.js

@@ -0,0 +1,120 @@
+import { Vector } from '../Math/vector';
+import { Logger } from '../Util/Log';
+import { Graphic } from './Graphic';
+import { Sprite } from './Sprite';
+import { SpriteSheet } from './SpriteSheet';
+import { BoundingBox } from '..';
+export class SpriteFont extends Graphic {
+    constructor(options) {
+        super(options);
+        this._text = '';
+        this.alphabet = '';
+        this.shadow = null;
+        this.caseInsensitive = false;
+        this.spacing = 0;
+        this._logger = Logger.getInstance();
+        this._alreadyWarnedAlphabet = false;
+        this._alreadyWarnedSpriteSheet = false;
+        const { alphabet, spriteSheet, caseInsensitive, spacing, shadow } = options;
+        this.alphabet = alphabet;
+        this.spriteSheet = spriteSheet;
+        this.caseInsensitive = caseInsensitive !== null && caseInsensitive !== void 0 ? caseInsensitive : this.caseInsensitive;
+        this.spacing = spacing !== null && spacing !== void 0 ? spacing : this.spacing;
+        this.shadow = shadow !== null && shadow !== void 0 ? shadow : this.shadow;
+    }
+    static fromLegacySpriteFont(spriteFont) {
+        const sprites = spriteFont.sprites.map(Sprite.fromLegacySprite);
+        return new SpriteFont({
+            alphabet: spriteFont.alphabet,
+            spacing: 0,
+            caseInsensitive: spriteFont.caseInsensitive,
+            spriteSheet: new SpriteSheet({
+                sprites
+            })
+        });
+    }
+    _getCharacterSprites(text) {
+        const results = [];
+        // handle case insensitive
+        const textToRender = this.caseInsensitive ? text.toLocaleLowerCase() : text;
+        const alphabet = this.caseInsensitive ? this.alphabet.toLocaleLowerCase() : this.alphabet;
+        // for each letter in text
+        for (let letterIndex = 0; letterIndex < textToRender.length; letterIndex++) {
+            // find the sprite index in alphabet , if there is an error pick the first
+            const letter = textToRender[letterIndex];
+            let spriteIndex = alphabet.indexOf(letter);
+            if (spriteIndex === -1) {
+                spriteIndex = 0;
+                if (!this._alreadyWarnedAlphabet) {
+                    this._logger.warn(`SpriteFont - Cannot find letter '${letter}' in configured alphabet '${alphabet}'.`);
+                    this._logger.warn('There maybe be more issues in the SpriteFont configuration. No additional warnings will be logged.');
+                    this._alreadyWarnedAlphabet = true;
+                }
+            }
+            const letterSprite = this.spriteSheet.sprites[spriteIndex];
+            if (letterSprite) {
+                results.push(letterSprite);
+            }
+            else {
+                if (!this._alreadyWarnedSpriteSheet) {
+                    this._logger.warn(`SpriteFont - Cannot find sprite for '${letter}' at index '${spriteIndex}' in configured SpriteSheet`);
+                    this._logger.warn('There maybe be more issues in the SpriteFont configuration. No additional warnings will be logged.');
+                    this._alreadyWarnedSpriteSheet = true;
+                }
+            }
+        }
+        return results;
+    }
+    measureText(text) {
+        const lines = text.split('\n');
+        const maxWidthLine = lines.reduce((a, b) => {
+            return a.length > b.length ? a : b;
+        });
+        const sprites = this._getCharacterSprites(maxWidthLine);
+        let width = 0;
+        let height = 0;
+        for (const sprite of sprites) {
+            width += sprite.width + this.spacing;
+            height = Math.max(height, sprite.height);
+        }
+        return BoundingBox.fromDimension(width, height * lines.length, Vector.Zero);
+    }
+    _drawImage(ex, x, y) {
+        let xCursor = 0;
+        let yCursor = 0;
+        let height = 0;
+        const lines = this._text.split('\n');
+        for (const line of lines) {
+            for (const sprite of this._getCharacterSprites(line)) {
+                // draw it in the right spot and increase the cursor by sprite width
+                sprite.draw(ex, x + xCursor, y + yCursor);
+                xCursor += sprite.width + this.spacing;
+                height = Math.max(height, sprite.height);
+            }
+            xCursor = 0;
+            yCursor += height;
+        }
+    }
+    render(ex, text, _color, x, y) {
+        // SpriteFont doesn't support _color, yet...
+        this._text = text;
+        const bounds = this.measureText(text);
+        this.width = bounds.width;
+        this.height = bounds.height;
+        if (this.shadow) {
+            ex.save();
+            ex.translate(this.shadow.offset.x, this.shadow.offset.y);
+            this.draw(ex, x, y);
+            ex.restore();
+        }
+        this.draw(ex, x, y);
+    }
+    clone() {
+        return new SpriteFont({
+            alphabet: this.alphabet,
+            spriteSheet: this.spriteSheet,
+            spacing: this.spacing
+        });
+    }
+}
+//# sourceMappingURL=SpriteFont.js.map

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

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

package/build/dist/Graphics/SpriteSheet.js

@@ -0,0 +1,115 @@
+import { Sprite } from './Sprite';
+import { SpriteSheet as LegacySpriteSheet } from '../Drawing/SpriteSheet';
+import { Logger } from '..';
+/**
+ * Represents a collection of sprites from a source image with some organization in a grid
+ */
+export class SpriteSheet {
+    /**
+     * Build a new sprite sheet from a list of sprites
+     *
+     * Use [[SpriteSheet.fromImageSource]] to create a SpriteSheet from an [[ImageSource]] organized in a grid
+     * @param options
+     */
+    constructor(options) {
+        this._logger = Logger.getInstance();
+        this.sprites = [];
+        const { sprites, rows, columns } = options;
+        this.sprites = sprites;
+        this.rows = rows !== null && rows !== void 0 ? rows : 1;
+        this.columns = columns !== null && columns !== void 0 ? columns : this.sprites.length;
+    }
+    /**
+     * Find a sprite by their x/y position in the SpriteSheet, for example `getSprite(0, 0)` is the [[Sprite]] in the top-left
+     * @param x
+     * @param y
+     */
+    getSprite(x, y) {
+        if (x >= this.columns || x < 0) {
+            this._logger.warn(`No sprite exists in the SpriteSheet at (${x}, ${y}), x: ${x} should be between 0 and ${this.columns - 1}`);
+            return null;
+        }
+        if (y >= this.rows || y < 0) {
+            this._logger.warn(`No sprite exists in the SpriteSheet at (${x}, ${y}), y: ${y} should be between 0 and ${this.rows - 1}`);
+            return null;
+        }
+        const spriteIndex = x + y * this.columns;
+        return this.sprites[spriteIndex];
+    }
+    /**
+     * To a graphics sprite sheet from a legacy sprite sheet
+     */
+    static fromLegacySpriteSheet(legacySpriteSheet) {
+        const sprites = legacySpriteSheet.sprites.map(oldSprite => Sprite.fromLegacySprite(oldSprite));
+        return new SpriteSheet({
+            sprites
+        });
+    }
+    /**
+     * @deprecated
+     * @param spriteSheet
+     */
+    static toLegacySpriteSheet(spriteSheet) {
+        const sprites = spriteSheet.sprites.map(sprite => Sprite.toLegacySprite(sprite));
+        return new LegacySpriteSheet(sprites);
+    }
+    /**
+     * Create a SpriteSheet from an [[ImageSource]] organized in a grid
+     *
+     * Example:
+     * ```
+     * const spriteSheet = SpriteSheet.fromImageSource({
+     *   image: imageSource,
+     *   grid: {
+     *     rows: 5,
+     *     columns: 2,
+     *     spriteWidth: 32, // pixels
+     *     spriteHeight: 32 // pixels
+     *   },
+     *   // Optionally specify spacing
+     *   spacing: {
+     *     // pixels from the top left to start the sprite parsing
+     *     originOffset: {
+     *       x: 5,
+     *       y: 5
+     *     },
+     *     // pixels between each sprite while parsing
+     *     margin: {
+     *       x: 1,
+     *       y: 1
+     *     }
+     *   }
+     * })
+     * ```
+     *
+     * @param options
+     */
+    static fromImageSource(options) {
+        var _a;
+        const sprites = [];
+        options.spacing = (_a = options.spacing) !== null && _a !== void 0 ? _a : {};
+        const { image, grid: { rows, columns: cols, spriteWidth, spriteHeight }, spacing: { originOffset, margin } } = options;
+        const offsetDefaults = { x: 0, y: 0, ...originOffset };
+        const marginDefaults = { x: 0, y: 0, ...margin };
+        for (let x = 0; x < cols; x++) {
+            for (let y = 0; y < rows; y++) {
+                sprites[x + y * cols] = new Sprite({
+                    image: image,
+                    sourceView: {
+                        x: x * spriteWidth + marginDefaults.x * x + offsetDefaults.x,
+                        y: y * spriteHeight + marginDefaults.y * y + offsetDefaults.y,
+                        width: spriteWidth,
+                        height: spriteHeight
+                    },
+                    destSize: { height: spriteHeight, width: spriteWidth }
+                });
+            }
+        }
+        return new SpriteSheet({
+            sprites: sprites,
+            rows: rows,
+            columns: cols
+        });
+    }
+}
+//# sourceMappingURL=SpriteSheet.js.map

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

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