@woosh/meep-engine 3.9.0 → 3.10.0

package/src/engine/asset/loaders/image/png/PNG.d.ts

@@ -71,25 +71,10 @@ export class PNG {
      */
     setPalette(palette: Uint8Array): void;
     /**
-     * get the pixel color on a certain location in a normalized way
-     * result is an array: [red, green, blue, alpha]
+     * Expand a palette (colour type 3) image to interleaved RGB, or RGBA when a `tRNS` chunk gave
+     * the palette entries an alpha.
+     * @returns {{data: Uint8Array, itemSize: number}}
      */
-    getPixel(result: any, result_offset: any, x: any, y: any): void;
-    /**
-     * Assumes pixels are stored as RGB without A component, will set A to 255
-     * @param {Uint8Array} destination
-     */
-    getRGBA8Array_fromRGB(destination: Uint8Array): void;
-    /**
-     *
-     * @param {Uint8Array} destination
-     */
-    getRGBA8Array_generic(destination: Uint8Array): void;
-    /**
-     * get the pixels of the image as a RGBA array of the form [r1, g1, b1, a1, r2, b2, g2, a2, ...]
-     * Matches the api of canvas.getImageData
-     */
-    getRGBA8Array(): Uint8Array;
     getUint8Data_case3(): {
         data: Uint8Array;
         itemSize: number;

package/src/engine/asset/loaders/image/png/PNG.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PNG.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/asset/loaders/image/png/PNG.js"],"names":[],"mappings":"AAAA;IAEI;;;OAGG;IACH,OAFU,MAAM,CAEN;IACV;;;OAGG;IACH,QAFU,MAAM,CAEL;IAEX;;;OAGG;IACH,UAFU,MAAM,CAEH;IAEb,kBAAc;IACd,0BAAsB;IACtB,qBAAiB;IACjB,wBAAoB;IAEpB;;;;OAIG;IACH,QAFU,MAAM,CAEL;IACX,eAAc;IAEd;;;OAGG;IACH,SAFU,UAAU,GAAC,IAAI,CAEV;IAEf;;;OAGG;IACH,QAFU,UAAU,GAAC,IAAI,CAEX;IAEd;;;OAGG;IACH,qBAFU,UAAU,GAAC,IAAI,CAEE;IAG3B;;;OAGG;IACH,UAAU;IAGV,mBAEC;IAED,2BAEC;IAED,oBAEC;IAED,6BAEC;IAED,sBAEC;IAED,iCAKC;IAED,uBAEC;IAED,mCA6CC;IAED;;;OAGG;IACH,wCAFW,MAAM,QAOhB;IAED;;;OAGG;IACH,8BAFW,MAAM,QAOhB;IAED,6BAEC;IAED,+CAKC;IAED;;;OAGG;IACH,oBAFW,UAAU,QAUpB;IAED;;;OAGG;IACH,gEA+DC;IAED;;;OAGG;IACH,mCAFW,UAAU,QAqBpB;IAED;;;OAGG;IACH,mCAFW,UAAU,QAiBpB;IAED;;;OAGG;IACH,4BAoBC;IAED;;;MA4DC;IAED;;OAEG;IACH;kBAFuB,MAAM;cAAO,UAAU;kBAAY,MAAM;MA0C/D;CACJ"}
+{"version":3,"file":"PNG.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/asset/loaders/image/png/PNG.js"],"names":[],"mappings":"AAAA;IAEI;;;OAGG;IACH,OAFU,MAAM,CAEN;IACV;;;OAGG;IACH,QAFU,MAAM,CAEL;IAEX;;;OAGG;IACH,UAFU,MAAM,CAEH;IAEb,kBAAc;IACd,0BAAsB;IACtB,qBAAiB;IACjB,wBAAoB;IAEpB;;;;OAIG;IACH,QAFU,MAAM,CAEL;IACX,eAAc;IAEd;;;OAGG;IACH,SAFU,UAAU,GAAC,IAAI,CAEV;IAEf;;;OAGG;IACH,QAFU,UAAU,GAAC,IAAI,CAEX;IAEd;;;OAGG;IACH,qBAFU,UAAU,GAAC,IAAI,CAEE;IAG3B;;;OAGG;IACH,UAAU;IAGV,mBAEC;IAED,2BAEC;IAED,oBAEC;IAED,6BAEC;IAED,sBAEC;IAED,iCAKC;IAED,uBAEC;IAED,mCA6CC;IAED;;;OAGG;IACH,wCAFW,MAAM,QAOhB;IAED;;;OAGG;IACH,8BAFW,MAAM,QAOhB;IAED,6BAEC;IAED,+CAKC;IAED;;;OAGG;IACH,oBAFW,UAAU,QAUpB;IAED;;;;OAIG;IACH;cAFoB,UAAU;kBAAY,MAAM;MA8D/C;IAED;;OAEG;IACH;kBAFuB,MAAM;cAAO,UAAU;kBAAY,MAAM;MA0C/D;CACJ"}

package/src/engine/asset/loaders/image/png/PNG.js

@@ -182,146 +182,10 @@ export class PNG {
     }
 
     /**
-     * get the pixel color on a certain location in a normalized way
-     * result is an array: [red, green, blue, alpha]
+     * Expand a palette (colour type 3) image to interleaved RGB, or RGBA when a `tRNS` chunk gave
+     * the palette entries an alpha.
+     * @returns {{data: Uint8Array, itemSize: number}}
      */
-    getPixel(result, result_offset, x, y) {
-        const pixels = this.pixels;
-
-        if (!pixels) {
-            throw new Error("pixel data is empty");
-        }
-
-        if (x >= this.width || y >= this.height) {
-            throw new Error("x,y position out of bound");
-        }
-
-        const i = this.colors * this.bitDepth / 8 * (y * this.width + x);
-
-        let r, g, b, a;
-
-        switch (this.colorType) {
-            case 0:
-                r = pixels[i];
-                g = r;
-                b = r;
-                a = 255;
-                break;
-            case 2:
-                r = pixels[i];
-                g = pixels[i + 1];
-                b = pixels[i + 2];
-                a = 255;
-                break;
-            case 3:
-                a = 255;
-
-                if (this.transparency_lookup != null) {
-                    a = this.transparency_lookup[pixels[i]];
-                }
-
-                const offset = pixels[i] * 3;
-
-                const palette = this.palette;
-                r = palette[offset];
-                g = palette[offset + 1];
-                b = palette[offset + 2];
-
-                break;
-            case 4:
-                r = pixels[i];
-                g = r;
-                b = r;
-                a = pixels[i + 1];
-                break;
-            case 6:
-                r = pixels[i];
-                g = pixels[i + 1];
-                b = pixels[i + 2];
-                a = pixels[i + 3];
-                break;
-            default:
-                throw new Error('Unsupported color type');
-        }
-
-        result[result_offset + 0] = r;
-        result[result_offset + 1] = g;
-        result[result_offset + 2] = b;
-        result[result_offset + 3] = a;
-    }
-
-    /**
-     * Assumes pixels are stored as RGB without A component, will set A to 255
-     * @param {Uint8Array} destination
-     */
-    getRGBA8Array_fromRGB(destination) {
-
-        const height = this.height;
-        const width = this.width;
-
-        const pixel_count = width * height;
-
-        const source = this.pixels;
-
-        for (let i = 0; i < pixel_count; i++) {
-            const i3 = i * 3;
-            const i4 = i3 + i;
-
-            destination[i4] = source[i3];
-            destination[i4 + 1] = source[i3 + 1];
-            destination[i4 + 2] = source[i3 + 2];
-            destination[i4 + 3] = 255;
-        }
-
-    }
-
-    /**
-     *
-     * @param {Uint8Array} destination
-     */
-    getRGBA8Array_generic(destination) {
-
-        const height = this.height;
-        const width = this.width;
-
-        for (let y = 0; y < height; y++) {
-            const row_index = y * width;
-
-            for (let x = 0; x < width; x++) {
-                const address = (row_index + x) * 4;
-
-                this.getPixel(destination, address, x, y);
-            }
-        }
-
-    }
-
-    /**
-     * get the pixels of the image as a RGBA array of the form [r1, g1, b1, a1, r2, b2, g2, a2, ...]
-     * Matches the api of canvas.getImageData
-     */
-    getRGBA8Array() {
-        if (this.colorType === 6) {
-            // RGBA color type, return pixels directly
-            return this.pixels;
-        }
-
-        const height = this.height;
-        const width = this.width;
-
-        const data = new Uint8Array(width * height * 4);
-
-        if (this.colorType === 2) {
-            // RGB color type
-            this.getRGBA8Array_fromRGB(data);
-        } else {
-            // original, slow generic method
-            this.getRGBA8Array_generic(data);
-        }
-
-        return data;
-    }
-
     getUint8Data_case3() {
         const w = this.width;
         const h = this.height;

package/src/engine/asset/loaders/image/png/PNGReader.d.ts

@@ -11,16 +11,6 @@ export class PNGReader {
      * @constructor
      */
     constructor(bytes: ArrayBuffer);
-    /**
-     * current pointer
-     * @type {number}
-     */
-    i: number;
-    /**
-     * bytes buffer
-     * @type {Uint8Array}
-     */
-    bytes: Uint8Array;
     /**
      * Output object
      * @type {PNG}
@@ -41,11 +31,6 @@ export class PNGReader {
      * @type {boolean}
      */
     crc_enabled: boolean;
-    /**
-     *
-     * @type {Uint8Array}
-     */
-    header: Uint8Array;
     /**
      *
      * @param {number} length
@@ -125,15 +110,30 @@ export class PNGReader {
      */
     decodePixels(): void;
     /**
+     * Reconstruct a non-interlaced image.
+     *
+     * Filtering is byte-wise, so at bit depths below eight the reconstructed scanline is still packed
+     * and has to be unpacked into the output separately. At eight bits and above the two are the same
+     * thing, and the reconstruction is written straight into the output with no intermediate row.
+     *
      * @param {Uint8Array} data
+     * @returns {Uint8Array}
      */
     interlaceNone(data: Uint8Array): Uint8Array;
     /**
-     * De-interlace image according to Adam 7 scheme
+     * De-interlace an image according to the Adam7 scheme.
+     *
+     * Each of the seven passes is its own little image with its own scanline width, so its own
+     * filtering and — below eight bits — its own packing. Reconstructed rows land in a two-row scratch
+     * (the filters predict from the previous row of the same pass) and are scattered into the output.
+     *
      * @param {Uint8Array} data
+     * @returns {Uint8Array}
      */
     interlaceAdam7(data: Uint8Array): Uint8Array;
     /**
+     * Reconstruct one filtered scanline. Kept as a method so the reader's surface is unchanged; the
+     * dispatch itself lives in {@link png_unfilter}.
      *
      * @param {number} filter_type
      * @param {Uint8Array} data

package/src/engine/asset/loaders/image/png/PNGReader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PNGReader.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/asset/loaders/image/png/PNGReader.js"],"names":[],"mappings":"AA6CA;;;;GAIG;AACH,iCAHW,WAAW,QAkDrB;;IApDD;;;;OAIG;IACH,mBAHW,WAAW,EAkDrB;IA9CG;;;OAGG;IACH,GAFU,MAAM,CAEN;IAEV;;;OAGG;IACH,OAFU,UAAU,CAEc;IAElC;;;OAGG;IACH,KAFU,GAAG,CAEO;IAEpB;;;OAGG;IACH,YAFU,UAAU,EAAE,CAEF;IAEpB;;;OAGG;IACH,QAFU,YAAY,CAEU;IAOhC;;;OAGG;IACH,aAFU,OAAO,CAEO;IAExB;;;OAGG;IACH,QAFU,UAAU,CAEW;IAGnC;;;;OAIG;IACH,kBAHW,MAAM,GACL,UAAU,CAarB;IAED;;OAEG;IACH,qBAkBC;IAED;;;;;;;;;OASG;IACH,eAFa,MAAM,CA4ElB;IAGD;;;OAGG;IACH,kBAFW,UAAU,QAOpB;IAED;;;OAGG;IACH,kBAFW,UAAU,QAapB;IAED;;;OAGG;IACH,kBAFW,UAAU,QASpB;IACD;;;;OAIG;IACH,kBAFW,UAAU,QAwBpB;IAED;;;;;;;;;;;OAWG;IACH,6BAWC;IAED;;;;OAIG;IACH,kBAFW,UAAU,QAIpB;IAED;;OAEG;IACH,6BAGC;IAED;;;OAGG;IACH,kBAFW,UAAU,QAIpB;IAED;;OAEG;IACH,mBACC;IAED;;OAEG;IACH,qBAyDC;IAID;;OAEG;IACH,oBAFW,UAAU,cA+CpB;IAGD;;;OAGG;IACH,qBAFW,UAAU,cAyFpB;IAID;;;;;;;;;;;;OAYG;IACH,sBAXW,MAAM,QACN,UAAU,oBACV,MAAM,UACN,UAAU,mBACV,MAAM,iBACN,MAAM,0BACN,MAAM,UACN,MAAM,QA4EhB;IAED;;;OAGG;IACH,SAFa,GAAG,CAqBf;;oBA9oBmB,UAAU;6BAbD,4CAA4C"}
+{"version":3,"file":"PNGReader.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/asset/loaders/image/png/PNGReader.js"],"names":[],"mappings":"AAyCA;;;;GAIG;AACH,iCAHW,WAAW,QAgCrB;;IAlCD;;;;OAIG;IACH,mBAHW,WAAW,EAgCrB;IA5BG;;;OAGG;IACH,KAFU,GAAG,CAEO;IAEpB;;;OAGG;IACH,YAFU,UAAU,EAAE,CAEF;IAEpB;;;OAGG;IACH,QAFU,YAAY,CAEU;IAOhC;;;OAGG;IACH,aAFU,OAAO,CAEO;IAG5B;;;;OAIG;IACH,kBAHW,MAAM,GACL,UAAU,CAarB;IAED;;OAEG;IACH,qBAcC;IAED;;;;;;;;;OASG;IACH,eAFa,MAAM,CA4ElB;IAGD;;;OAGG;IACH,kBAFW,UAAU,QAOpB;IAED;;;OAGG;IACH,kBAFW,UAAU,QAapB;IAED;;;OAGG;IACH,kBAFW,UAAU,QASpB;IACD;;;;OAIG;IACH,kBAFW,UAAU,QAwBpB;IAED;;;;;;;;;;;OAWG;IACH,6BAWC;IAED;;;;OAIG;IACH,kBAFW,UAAU,QAIpB;IAED;;OAEG;IACH,6BAGC;IAED;;;OAGG;IACH,kBAFW,UAAU,QAIpB;IAED;;OAEG;IACH,mBACC;IAED;;OAEG;IACH,qBA0BC;IAID;;;;;;;;;OASG;IACH,oBAHW,UAAU,GACR,UAAU,CAkDtB;IAsDD;;;;;;;;;OASG;IACH,qBAHW,UAAU,GACR,UAAU,CAgHtB;IAID;;;;;;;;;;;;;;OAcG;IACH,sBAXW,MAAM,QACN,UAAU,oBACV,MAAM,UACN,UAAU,mBACV,MAAM,iBACN,MAAM,0BACN,MAAM,UACN,MAAM,QAwBhB;IAED;;;OAGG;IACH,SAFa,GAAG,CAqBf;;oBAjoBmB,UAAU;6BAXD,4CAA4C"}