excalibur 0.25.2 → 0.25.3

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

@@ -0,0 +1,236 @@
+import { ExcaliburWebGLContextAccessor } from './webgl-adapter';
+import { getAttributeComponentSize, getAttributePointerType } from './webgl-util';
+export class Shader {
+    /**
+     * Create a shader program in excalibur
+     * @param options specify shader vertex and fragment source
+     */
+    constructor(options) {
+        this._gl = ExcaliburWebGLContextAccessor.gl;
+        this.uniforms = {};
+        this.attributes = {};
+        this._compiled = false;
+        const { vertexSource, fragmentSource } = options;
+        this.vertexSource = vertexSource;
+        this.fragmentSource = fragmentSource;
+    }
+    get compiled() {
+        return this._compiled;
+    }
+    /**
+     * Binds the shader program
+     */
+    use() {
+        const gl = this._gl;
+        gl.useProgram(this.program);
+        Shader._ACTIVE_SHADER_INSTANCE = this;
+    }
+    isCurrentlyBound() {
+        return Shader._ACTIVE_SHADER_INSTANCE === this;
+    }
+    /**
+     * Compile the current shader against a webgl context
+     */
+    compile() {
+        const gl = this._gl;
+        const vertexShader = this._compileShader(gl, this.vertexSource, gl.VERTEX_SHADER);
+        const fragmentShader = this._compileShader(gl, this.fragmentSource, gl.FRAGMENT_SHADER);
+        this.program = this._createProgram(gl, vertexShader, fragmentShader);
+        const attributes = this.getAttributes();
+        for (const attribute of attributes) {
+            this.attributes[attribute.name] = attribute;
+        }
+        const uniforms = this.getUniforms();
+        for (const uniform of uniforms) {
+            this.uniforms[uniform.name] = uniform;
+        }
+        this._compiled = true;
+        return this.program;
+    }
+    getUniforms() {
+        const gl = this._gl;
+        const uniformCount = gl.getProgramParameter(this.program, gl.ACTIVE_UNIFORMS);
+        const uniforms = [];
+        for (let i = 0; i < uniformCount; i++) {
+            const uniform = gl.getActiveUniform(this.program, i);
+            const uniformLocation = gl.getUniformLocation(this.program, uniform.name);
+            uniforms.push({
+                name: uniform.name,
+                glType: uniform.type,
+                location: uniformLocation
+            });
+        }
+        return uniforms;
+    }
+    getAttributes() {
+        const gl = this._gl;
+        const attributeCount = gl.getProgramParameter(this.program, gl.ACTIVE_ATTRIBUTES);
+        const attributes = [];
+        for (let i = 0; i < attributeCount; i++) {
+            const attribute = gl.getActiveAttrib(this.program, i);
+            const attributeLocation = gl.getAttribLocation(this.program, attribute.name);
+            attributes.push({
+                name: attribute.name,
+                glType: getAttributePointerType(gl, attribute.type),
+                size: getAttributeComponentSize(gl, attribute.type),
+                location: attributeLocation,
+                normalized: false
+            });
+        }
+        return attributes;
+    }
+    /**
+     * Set a texture in a gpu texture slot
+     * @param slotNumber
+     * @param texture
+     */
+    setTexture(slotNumber, texture) {
+        const gl = this._gl;
+        gl.activeTexture(gl.TEXTURE0 + slotNumber);
+        gl.bindTexture(gl.TEXTURE_2D, texture);
+    }
+    /**
+     * Set an integer uniform for the current shader
+     *
+     * **Important** Must call ex.Shader.use() before setting a uniform!
+     *
+     * @param name
+     * @param value
+     */
+    setUniformInt(name, value) {
+        this.setUniform('uniform1i', name, ~~value);
+    }
+    /**
+     * Set an integer array uniform for the current shader
+     *
+     * **Important** Must call ex.Shader.use() before setting a uniform!
+     *
+     * @param name
+     * @param value
+     */
+    setUniformIntArray(name, value) {
+        this.setUniform('uniform1iv', name, value);
+    }
+    /**
+     * Set a boolean uniform for the current shader
+     *
+     * **Important** Must call ex.Shader.use() before setting a uniform!
+     *
+     * @param name
+     * @param value
+     */
+    setUniformBoolean(name, value) {
+        this.setUniform('uniform1i', name, value ? 1 : 0);
+    }
+    /**
+     * Set a float uniform for the current shader
+     *
+     * **Important** Must call ex.Shader.use() before setting a uniform!
+     *
+     * @param name
+     * @param value
+     */
+    setUniformFloat(name, value) {
+        this.setUniform('uniform1f', name, value);
+    }
+    /**
+     * Set a float array uniform for the current shader
+     *
+     * **Important** Must call ex.Shader.use() before setting a uniform!
+     *
+     * @param name
+     * @param value
+     */
+    setUniformFloatArray(name, value) {
+        this.setUniform('uniform1fv', name, value);
+    }
+    /**
+     * Set a [[Vector]] uniform for the current shader
+     *
+     * **Important** Must call ex.Shader.use() before setting a uniform!
+     *
+     * @param name
+     * @param value
+     */
+    setUniformFloatVector(name, value) {
+        this.setUniform('uniform2f', name, value.x, value.y);
+    }
+    /**
+     * Set an [[Matrix]] uniform for the current shader
+     *
+     * **Important** Must call ex.Shader.use() before setting a uniform!
+     *
+     * @param name
+     * @param value
+     */
+    setUniformMatrix(name, value) {
+        this.setUniform('uniformMatrix4fv', name, false, value.data);
+    }
+    /**
+     * Set any available uniform type in webgl
+     *
+     * For example setUniform('uniformMatrix2fv', 'u_my2x2_mat`, ...);
+     */
+    setUniform(uniformType, name, ...value) {
+        if (!this._compiled) {
+            throw Error(`Must compile shader before setting a uniform ${uniformType}:${name}`);
+        }
+        if (!this.isCurrentlyBound()) {
+            throw Error('Currently accessed shader instance is not the current active shader in WebGL,' +
+                ' must call `shader.use()` before setting uniforms');
+        }
+        const gl = this._gl;
+        const location = gl.getUniformLocation(this.program, name);
+        if (location) {
+            const args = [location, ...value];
+            this._gl[uniformType].apply(this._gl, args);
+        }
+        else {
+            throw Error(`Uniform ${uniformType}:${name} doesn\'t exist or is not used in the shader source code,` +
+                ' unused uniforms are optimized away by most browsers');
+        }
+    }
+    _createProgram(gl, vertexShader, fragmentShader) {
+        const program = gl.createProgram();
+        if (program === null) {
+            throw Error('Could not create graphics shader program');
+        }
+        // attach the shaders.
+        gl.attachShader(program, vertexShader);
+        gl.attachShader(program, fragmentShader);
+        // link the program.
+        gl.linkProgram(program);
+        const success = gl.getProgramParameter(program, gl.LINK_STATUS);
+        if (!success) {
+            throw Error(`Could not link the program: [${gl.getProgramInfoLog(program)}]`);
+        }
+        return program;
+    }
+    _compileShader(gl, source, type) {
+        const typeName = gl.VERTEX_SHADER === type ? 'vertex' : 'fragment';
+        const shader = gl.createShader(type);
+        if (shader === null) {
+            throw Error(`Could not build shader: [${source}]`);
+        }
+        gl.shaderSource(shader, source);
+        gl.compileShader(shader);
+        const success = gl.getShaderParameter(shader, gl.COMPILE_STATUS);
+        if (!success) {
+            const errorInfo = gl.getShaderInfoLog(shader);
+            throw Error(`Could not compile ${typeName} shader:\n\n${errorInfo}${this._processSourceForError(source, errorInfo)}`);
+        }
+        return shader;
+    }
+    _processSourceForError(source, errorInfo) {
+        const lines = source.split('\n');
+        const errorLineStart = errorInfo.search(/\d:\d/);
+        const errorLineEnd = errorInfo.indexOf(' ', errorLineStart);
+        const [_, error2] = errorInfo.slice(errorLineStart, errorLineEnd).split(':').map(v => Number(v));
+        for (let i = 0; i < lines.length; i++) {
+            lines[i] = `${i + 1}: ${lines[i]}${error2 === (i + 1) ? ' <----- ERROR!' : ''}`;
+        }
+        return '\n\nSource:\n' + lines.join('\n');
+    }
+}
+Shader._ACTIVE_SHADER_INSTANCE = null;
+//# sourceMappingURL=shader.js.map

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

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

package/build/dist/Graphics/Context/state-stack.js

@@ -0,0 +1,27 @@
+export class StateStack {
+    constructor() {
+        this._states = [];
+        this._currentState = this._getDefaultState();
+    }
+    _getDefaultState() {
+        return {
+            opacity: 1
+        };
+    }
+    _cloneState() {
+        return {
+            opacity: this._currentState.opacity
+        };
+    }
+    save() {
+        this._states.push(this._currentState);
+        this._currentState = this._cloneState();
+    }
+    restore() {
+        this._currentState = this._states.pop();
+    }
+    get current() {
+        return this._currentState;
+    }
+}
+//# sourceMappingURL=state-stack.js.map

package/build/dist/Graphics/Context/state-stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-stack.js","sourceRoot":"","sources":["../../../../src/engine/Graphics/Context/state-stack.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,UAAU;IAAvB;QACU,YAAO,GAAoC,EAAE,CAAC;QAC9C,kBAAa,GAAkC,IAAI,CAAC,gBAAgB,EAAE,CAAC;IA0BjF,CAAC;IAxBS,gBAAgB;QACtB,OAAO;YACL,OAAO,EAAE,CAAC;SACX,CAAC;IACJ,CAAC;IAEO,WAAW;QACjB,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,OAAO;SACpC,CAAC;IACJ,CAAC;IAEM,IAAI;QACT,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACtC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAC1C,CAAC;IAEM,OAAO;QACZ,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1C,CAAC;IAED,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;CACF"}

package/build/dist/Graphics/Context/texture-loader.d.ts

@@ -4,6 +4,7 @@ import { HTMLImageSource } from './ExcaliburGraphicsContext';
  * Manages loading image sources into webgl textures, a unique id is associated with all sources
  */
 export declare class TextureLoader {
+    private static _LOGGER;
     /**
      * Sets the default filtering for the Excalibur texture loader, default [[ImageFiltering.Blended]]
      */
@@ -12,6 +13,7 @@ export declare class TextureLoader {
     private static _POT_CTX;
     private static _GL;
     private static _TEXTURE_MAP;
+    private static _MAX_TEXTURE_SIZE;
     static register(context: WebGLRenderingContext): void;
     /**
      * Get the WebGL Texture from a source image
@@ -36,4 +38,10 @@ export declare class TextureLoader {
      * @param image
      */
     static toPowerOfTwoImage(image: HTMLImageSource): HTMLImageSource;
+    /**
+     * Takes an image and returns if it meets size criteria for hardware
+     * @param image
+     * @returns if the image will be supported at runtime
+     */
+    static checkImageSizeSupportedAndLog(image: HTMLImageSource): boolean;
 }

package/build/dist/Graphics/Context/texture-loader.js

@@ -0,0 +1,121 @@
+import { Logger } from '../../Util/Log';
+import { ImageFiltering } from '../Filtering';
+import { ensurePowerOfTwo, isPowerOfTwo } from './webgl-util';
+/**
+ * Manages loading image sources into webgl textures, a unique id is associated with all sources
+ */
+export class TextureLoader {
+    static register(context) {
+        TextureLoader._GL = context;
+        TextureLoader._MAX_TEXTURE_SIZE = context.getParameter(context.MAX_TEXTURE_SIZE);
+    }
+    /**
+     * Get the WebGL Texture from a source image
+     * @param image
+     */
+    static get(image) {
+        return TextureLoader._TEXTURE_MAP.get(image);
+    }
+    /**
+     * Returns whether a source image has been loaded as a texture
+     * @param image
+     */
+    static has(image) {
+        return TextureLoader._TEXTURE_MAP.has(image);
+    }
+    /**
+     * Loads a graphic into webgl and returns it's texture info, a webgl context must be previously registered
+     * @param image Source graphic
+     * @param filtering {ImageFiltering} The ImageFiltering mode to apply to the loaded texture
+     * @param forceUpdate Optionally force a texture to be reloaded, useful if the source graphic has changed
+     */
+    static load(image, filtering, forceUpdate = false) {
+        // Ignore loading if webgl is not registered
+        const gl = TextureLoader._GL;
+        if (!gl) {
+            return null;
+        }
+        let tex = null;
+        // If reuse the texture if it's from the same source
+        if (TextureLoader.has(image)) {
+            tex = TextureLoader.get(image);
+        }
+        // Update existing webgl texture and return early
+        if (tex) {
+            if (forceUpdate) {
+                gl.bindTexture(gl.TEXTURE_2D, tex);
+                const source = TextureLoader.toPowerOfTwoImage(image);
+                gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, source);
+            }
+            return tex;
+        }
+        // No texture exists create a new one
+        tex = gl.createTexture();
+        const source = TextureLoader.toPowerOfTwoImage(image);
+        TextureLoader.checkImageSizeSupportedAndLog(image);
+        gl.bindTexture(gl.TEXTURE_2D, tex);
+        gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, true);
+        gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE);
+        gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);
+        // NEAREST for pixel art, LINEAR for hi-res
+        const filterMode = filtering !== null && filtering !== void 0 ? filtering : TextureLoader.filtering;
+        gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, filterMode === ImageFiltering.Pixel ? gl.NEAREST : gl.LINEAR);
+        gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, filterMode === ImageFiltering.Pixel ? gl.NEAREST : gl.LINEAR);
+        gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, source);
+        TextureLoader._TEXTURE_MAP.set(image, tex);
+        return tex;
+    }
+    /**
+     * Converts source images into power of two images, WebGL only supports POT images
+     * https://www.khronos.org/webgl/wiki/WebGL_and_OpenGL_Differences#Non-Power_of_Two_Texture_Support
+     * @param image
+     */
+    static toPowerOfTwoImage(image) {
+        const potCanvas = TextureLoader._POT_CANVAS;
+        const potCtx = TextureLoader._POT_CTX;
+        if (!isPowerOfTwo(image.width) || !isPowerOfTwo(image.height)) {
+            // Scale up the texture to the next highest power of two dimensions.
+            potCanvas.width = ensurePowerOfTwo(image.width);
+            potCanvas.height = ensurePowerOfTwo(image.height);
+            potCtx.imageSmoothingEnabled = false;
+            potCtx.clearRect(0, 0, potCanvas.width, potCanvas.height);
+            potCtx.drawImage(image, 0, 0, image.width, image.height);
+            image = potCanvas;
+        }
+        return image;
+    }
+    /**
+     * Takes an image and returns if it meets size criteria for hardware
+     * @param image
+     * @returns if the image will be supported at runtime
+     */
+    static checkImageSizeSupportedAndLog(image) {
+        var _a;
+        const originalSrc = (_a = image.dataset.originalSrc) !== null && _a !== void 0 ? _a : 'internal canvas bitmap';
+        if (image.width > TextureLoader._MAX_TEXTURE_SIZE || image.height > TextureLoader._MAX_TEXTURE_SIZE) {
+            TextureLoader._LOGGER.error(`The image [${originalSrc}] provided to Excalibur is too large for the device's maximum texture size of ` +
+                `(${TextureLoader._MAX_TEXTURE_SIZE}x${TextureLoader._MAX_TEXTURE_SIZE}) please resize to an image `
+                + `for excalibur to render properly.\n\nImages will likely render as black rectangles.\n\n` +
+                `Read more here: https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API/WebGL_best_practices#understand_system_limits`);
+            return false;
+        }
+        else if (image.width > 4096 || image.height > 4096) {
+            // https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API/WebGL_best_practices#understand_system_limits
+            TextureLoader._LOGGER.warn(`The image [${originalSrc}] provided to excalibur is too large may not work on all mobile devices, ` +
+                `it is recommended you resize images to a maximum (4096x4096).\n\n` +
+                `Images will likely render as black rectangles on some mobile platforms.\n\n` +
+                `Read more here: https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API/WebGL_best_practices#understand_system_limits`);
+        }
+        return true;
+    }
+}
+TextureLoader._LOGGER = Logger.getInstance();
+/**
+ * Sets the default filtering for the Excalibur texture loader, default [[ImageFiltering.Blended]]
+ */
+TextureLoader.filtering = ImageFiltering.Blended;
+TextureLoader._POT_CANVAS = document.createElement('canvas');
+TextureLoader._POT_CTX = TextureLoader._POT_CANVAS.getContext('2d');
+TextureLoader._TEXTURE_MAP = new Map();
+TextureLoader._MAX_TEXTURE_SIZE = 0;
+//# sourceMappingURL=texture-loader.js.map

package/build/dist/Graphics/Context/texture-loader.js.map

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

package/build/dist/Graphics/Context/transform-stack.js

@@ -0,0 +1,30 @@
+import { Matrix } from '../../Math/matrix';
+export class TransformStack {
+    constructor() {
+        this._transforms = [];
+        this._currentTransform = Matrix.identity();
+    }
+    save() {
+        this._transforms.push(this._currentTransform);
+        this._currentTransform = this._currentTransform.clone();
+    }
+    restore() {
+        this._currentTransform = this._transforms.pop();
+    }
+    translate(x, y) {
+        return this._currentTransform.translate(x, y);
+    }
+    rotate(angle) {
+        return this._currentTransform.rotate(angle);
+    }
+    scale(x, y) {
+        return this._currentTransform.scale(x, y);
+    }
+    set current(matrix) {
+        this._currentTransform = matrix;
+    }
+    get current() {
+        return this._currentTransform;
+    }
+}
+//# sourceMappingURL=transform-stack.js.map

package/build/dist/Graphics/Context/transform-stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-stack.js","sourceRoot":"","sources":["../../../../src/engine/Graphics/Context/transform-stack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,MAAM,OAAO,cAAc;IAA3B;QACU,gBAAW,GAAa,EAAE,CAAC;QAC3B,sBAAiB,GAAW,MAAM,CAAC,QAAQ,EAAE,CAAC;IA8BxD,CAAC;IA5BQ,IAAI;QACT,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC9C,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;IAC1D,CAAC;IAEM,OAAO;QACZ,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;IAClD,CAAC;IAEM,SAAS,CAAC,CAAS,EAAE,CAAS;QACnC,OAAO,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAChD,CAAC;IAEM,MAAM,CAAC,KAAa;QACzB,OAAO,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IAEM,KAAK,CAAC,CAAS,EAAE,CAAS;QAC/B,OAAO,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,IAAW,OAAO,CAAC,MAAc;QAC/B,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAAC;IAClC,CAAC;IAED,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/build/dist/Graphics/Context/vertex-buffer.js

@@ -0,0 +1,45 @@
+import { ExcaliburWebGLContextAccessor } from './webgl-adapter';
+/**
+ * Helper around vertex buffer to simplify creating and uploading geometry
+ *
+ * Under the hood uses Float32Array
+ */
+export class VertexBuffer {
+    constructor(options) {
+        this._gl = ExcaliburWebGLContextAccessor.gl;
+        /**
+         * If the vertices never change switching 'static' can be more efficient on the gpu
+         *
+         * Default is 'dynamic'
+         */
+        this.type = 'dynamic';
+        const { size, type, data } = options;
+        this.buffer = this._gl.createBuffer();
+        if (!data && !size) {
+            throw Error('Must either provide data or a size to the VertexBuffer');
+        }
+        if (!data) {
+            this.bufferData = new Float32Array(size);
+        }
+        else {
+            this.bufferData = data;
+        }
+        this.type = type !== null && type !== void 0 ? type : this.type;
+    }
+    /**
+     * Bind this vertex buffer
+     */
+    bind() {
+        const gl = this._gl;
+        gl.bindBuffer(gl.ARRAY_BUFFER, this.buffer);
+    }
+    /**
+     * Upload vertex buffer geometry to the GPU
+     */
+    upload() {
+        const gl = this._gl;
+        gl.bindBuffer(gl.ARRAY_BUFFER, this.buffer);
+        gl.bufferData(gl.ARRAY_BUFFER, this.bufferData, this.type === 'static' ? gl.STATIC_DRAW : gl.DYNAMIC_DRAW);
+    }
+}
+//# sourceMappingURL=vertex-buffer.js.map

package/build/dist/Graphics/Context/vertex-buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vertex-buffer.js","sourceRoot":"","sources":["../../../../src/engine/Graphics/Context/vertex-buffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAsBhE;;;;GAIG;AACH,MAAM,OAAO,YAAY;IAmBvB,YAAY,OAA4B;QAlBhC,QAAG,GAA0B,6BAA6B,CAAC,EAAE,CAAC;QAWtE;;;;WAIG;QACI,SAAI,GAAyB,SAAS,CAAC;QAG5C,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;QACtC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE;YAClB,MAAM,KAAK,CAAC,wDAAwD,CAAC,CAAC;SACvE;QAED,IAAI,CAAC,IAAI,EAAE;YACT,IAAI,CAAC,UAAU,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;SAC1C;aAAM;YACL,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;SACxB;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,aAAJ,IAAI,cAAJ,IAAI,GAAI,IAAI,CAAC,IAAI,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,IAAI;QACF,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,YAAY,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC;IAC7G,CAAC;CACF"}

package/build/dist/Graphics/Context/vertex-layout.js

@@ -0,0 +1,93 @@
+import { Logger } from '../..';
+import { ExcaliburWebGLContextAccessor } from './webgl-adapter';
+import { getGlTypeSizeBytes } from './webgl-util';
+/**
+ * Helper around creating vertex attributes in a given [[VertexBuffer]], this is useful for describing
+ * the memory layout for your vertices inside a particular buffer
+ *
+ * Note: This helper assumes interleaved attributes in one [[VertexBuffer]], not many.
+ *
+ * Working with `gl.vertexAttribPointer` can be tricky, and this attempts to double check you
+ */
+export class VertexLayout {
+    constructor(options) {
+        this._gl = ExcaliburWebGLContextAccessor.gl;
+        this._logger = Logger.getInstance();
+        this._layout = [];
+        this._attributes = [];
+        this._vertexTotalSizeBytes = 0;
+        const { shader, vertexBuffer, attributes } = options;
+        this._vertexBuffer = vertexBuffer;
+        this._attributes = attributes;
+        this._shader = shader;
+        this.initialize();
+    }
+    get vertexBuffer() {
+        return this._vertexBuffer;
+    }
+    get attributes() {
+        return this._attributes;
+    }
+    /**
+     * Total number of bytes that the vertex will take up
+     */
+    get totalVertexSizeBytes() {
+        return this._vertexTotalSizeBytes;
+    }
+    /**
+     * Layouts need shader locations and must be bound to a shader
+     */
+    initialize() {
+        if (!this._shader.compiled) {
+            throw Error('Shader not compiled, shader must be compiled before defining a vertex layout');
+        }
+        this._layout.length = 0;
+        const shaderAttributes = this._shader.attributes;
+        for (const attribute of this._attributes) {
+            const attrib = shaderAttributes[attribute[0]];
+            if (!attrib) {
+                throw Error(`The attribute named: ${attribute[0]} size ${attribute[1]}` +
+                    ` not found in the shader source code:\n ${this._shader.vertexSource}`);
+            }
+            if (attrib.size !== attribute[1]) {
+                throw Error(`VertexLayout size definition for attribute: [${attribute[0]}, ${attribute[1]}],`
+                    + ` doesnt match shader source size ${attrib.size}:\n ${this._shader.vertexSource}`);
+            }
+            this._layout.push(attrib);
+        }
+        // calc size
+        let componentsPerVertex = 0;
+        for (const vertAttribute of this._layout) {
+            const typeSize = getGlTypeSizeBytes(this._gl, vertAttribute.glType);
+            this._vertexTotalSizeBytes += typeSize * vertAttribute.size;
+            componentsPerVertex += vertAttribute.size;
+        }
+        if (this._vertexBuffer.bufferData.length % componentsPerVertex !== 0) {
+            this._logger.warn(`The vertex component size (${componentsPerVertex})  does divide evenly into the specified vertex buffer`
+                + ` (${this._vertexBuffer.bufferData.length})`);
+        }
+    }
+    /**
+     * Bind this layout with it's associated vertex buffer
+     *
+     * @param uploadBuffer Optionally indicate you wish to upload the buffer to the GPU associated with this layout
+     */
+    use(uploadBuffer = false) {
+        const gl = this._gl;
+        if (!this._shader.isCurrentlyBound()) {
+            throw Error('Shader associated with this vertex layout is not active! Call shader.use() before layout.use()');
+        }
+        this._vertexBuffer.bind();
+        if (uploadBuffer) {
+            this._vertexBuffer.upload();
+        }
+        let offset = 0;
+        // TODO switch to VAOs if the extension is
+        for (const vert of this._layout) {
+            gl.vertexAttribPointer(vert.location, vert.size, vert.glType, vert.normalized, this.totalVertexSizeBytes, offset);
+            gl.enableVertexAttribArray(vert.location);
+            offset += getGlTypeSizeBytes(gl, vert.glType) * vert.size;
+        }
+    }
+}
+//# sourceMappingURL=vertex-layout.js.map

package/build/dist/Graphics/Context/vertex-layout.js.map

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

package/build/dist/Graphics/Context/webgl-adapter.js

@@ -0,0 +1,19 @@
+/**
+ * Must be accessed after Engine construction time to ensure the context has been created
+ */
+export class ExcaliburWebGLContextAccessor {
+    static clear() {
+        ExcaliburWebGLContextAccessor._GL = null;
+    }
+    static register(gl) {
+        ExcaliburWebGLContextAccessor._GL = gl;
+    }
+    // current webgl context
+    static get gl() {
+        if (!ExcaliburWebGLContextAccessor._GL) {
+            throw Error('Attempted gl access before init');
+        }
+        return ExcaliburWebGLContextAccessor._GL;
+    }
+}
+//# sourceMappingURL=webgl-adapter.js.map

package/build/dist/Graphics/Context/webgl-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webgl-adapter.js","sourceRoot":"","sources":["../../../../src/engine/Graphics/Context/webgl-adapter.ts"],"names":[],"mappings":"AACA;;GAEG;AACH,MAAM,OAAO,6BAA6B;IAEjC,MAAM,CAAC,KAAK;QACjB,6BAA6B,CAAC,GAAG,GAAG,IAAI,CAAC;IAC3C,CAAC;IACM,MAAM,CAAC,QAAQ,CAAC,EAAyB;QAC9C,6BAA6B,CAAC,GAAG,GAAG,EAAE,CAAC;IACzC,CAAC;IACD,wBAAwB;IACjB,MAAM,KAAK,EAAE;QAClB,IAAI,CAAC,6BAA6B,CAAC,GAAG,EAAE;YACtC,MAAM,KAAK,CAAC,iCAAiC,CAAC,CAAC;SAChD;QACD,OAAO,6BAA6B,CAAC,GAAG,CAAC;IAC3C,CAAC;CACF"}