melonjs 17.0.0 → 17.1.0

package/dist/melonjs.mjs/level/tiled/TMXGroup.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/level/tiled/TMXLayer.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/level/tiled/TMXObject.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/level/tiled/TMXTile.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/level/tiled/TMXTileMap.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/level/tiled/TMXTileset.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/level/tiled/TMXTilesetGroup.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/level/tiled/TMXUtils.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/level/tiled/constants.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/level/tiled/renderer/TMXHexagonalRenderer.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/level/tiled/renderer/TMXIsometricRenderer.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/level/tiled/renderer/TMXOrthogonalRenderer.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/level/tiled/renderer/TMXRenderer.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/level/tiled/renderer/TMXStaggeredRenderer.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/level/tiled/renderer/autodetect.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/loader/cache.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/loader/loader.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/loader/loadingscreen.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/loader/melonjs_logo.png.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/loader/parsers/binary.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/loader/parsers/compressed_textures/compressed_image.js

@@ -0,0 +1,58 @@
+/*!
+ * melonJS Game Engine - v17.1.0
+ * http://www.melonjs.org
+ * melonjs is licensed under the MIT License.
+ * http://www.opensource.org/licenses/mit-license
+ * @copyright (C) 2011 - 2024 Olivier Biot (AltByte Pte Ltd)
+ */
+import { parseDDS } from './parseDDS.js';
+import { parseKTX } from './parseKTX.js';
+import { parseKTX2 } from './parseKTX2.js';
+import { parsePVR } from './parsePVR.js';
+import { parsePKM } from './parsePKM.js';
+import { once, VIDEO_INIT } from '../../../system/event.js';
+
+let _renderer;
+
+// gracefully capture a reference to the active renderer without adding more cyclic redundancy
+once(VIDEO_INIT, (renderer) => {
+    _renderer = renderer;
+});
+
+
+function parseCompressedImage(arrayBuffer, imgExt) {
+    let texture;
+
+    // check if the current renderer is WebGL
+    if (_renderer.type.includes("WebGL")) {
+        switch (imgExt) {
+            // Compressed texture
+            case "dds":
+                texture = parseDDS();
+                break;
+            case "pvr":
+                texture = parsePVR();
+                break;
+            case "pkm":
+                texture = parsePKM();
+                break;
+            case "ktx":
+                texture = parseKTX();
+                break;
+            case "ktx2":
+                texture = parseKTX2();
+                break;
+        }
+    }
+
+    if (typeof texture !== "undefined") {
+        if (_renderer.hasSupportedCompressedFormats(texture.format)) {
+            console.log("Compressed texture format supported: " + texture.format);
+            return texture;
+        }
+    }
+
+    throw ("unsupported texture format:" + imgExt + texture ? " (" + texture.format + ")" : "");
+}
+
+export { parseCompressedImage };

package/dist/melonjs.mjs/loader/parsers/compressed_textures/parseDDS.js

@@ -0,0 +1,13 @@
+/*!
+ * melonJS Game Engine - v17.1.0
+ * http://www.melonjs.org
+ * melonjs is licensed under the MIT License.
+ * http://www.opensource.org/licenses/mit-license
+ * @copyright (C) 2011 - 2024 Olivier Biot (AltByte Pte Ltd)
+ */
+// parse and return the compressed texture
+function parseDDS(/*data, formats*/) {
+    throw new Error("unsupported format");
+}
+
+export { parseDDS };

package/dist/melonjs.mjs/loader/parsers/compressed_textures/parseKTX.js

@@ -0,0 +1,13 @@
+/*!
+ * melonJS Game Engine - v17.1.0
+ * http://www.melonjs.org
+ * melonjs is licensed under the MIT License.
+ * http://www.opensource.org/licenses/mit-license
+ * @copyright (C) 2011 - 2024 Olivier Biot (AltByte Pte Ltd)
+ */
+// parse and return the compressed texture
+function parseKTX(/*data, formats*/) {
+    throw new Error("unsupported format");
+}
+
+export { parseKTX };

package/dist/melonjs.mjs/loader/parsers/compressed_textures/parseKTX2.js

@@ -0,0 +1,13 @@
+/*!
+ * melonJS Game Engine - v17.1.0
+ * http://www.melonjs.org
+ * melonjs is licensed under the MIT License.
+ * http://www.opensource.org/licenses/mit-license
+ * @copyright (C) 2011 - 2024 Olivier Biot (AltByte Pte Ltd)
+ */
+// parse and return the compressed texture
+function parseKTX2(/*data, formats*/) {
+    throw new Error("unsupported format");
+}
+
+export { parseKTX2 };

package/dist/melonjs.mjs/loader/parsers/compressed_textures/parsePKM.js

@@ -0,0 +1,13 @@
+/*!
+ * melonJS Game Engine - v17.1.0
+ * http://www.melonjs.org
+ * melonjs is licensed under the MIT License.
+ * http://www.opensource.org/licenses/mit-license
+ * @copyright (C) 2011 - 2024 Olivier Biot (AltByte Pte Ltd)
+ */
+// parse and return the compressed texture
+function parsePKM(/*data, formats*/) {
+    throw new Error("unsupported format");
+}
+
+export { parsePKM };

package/dist/melonjs.mjs/loader/parsers/compressed_textures/parsePVR.js

@@ -0,0 +1,136 @@
+/*!
+ * melonJS Game Engine - v17.1.0
+ * http://www.melonjs.org
+ * melonjs is licensed under the MIT License.
+ * http://www.opensource.org/licenses/mit-license
+ * @copyright (C) 2011 - 2024 Olivier Biot (AltByte Pte Ltd)
+ */
+/*
+const COMPRESSED_RGB_PVRTC_4BPPV1_IMG = 0x8C00;
+const COMPRESSED_RGB_PVRTC_2BPPV1_IMG = 0x8C01;
+const COMPRESSED_RGBA_PVRTC_4BPPV1_IMG = 0x8C02;
+const COMPRESSED_RGBA_PVRTC_2BPPV1_IMG = 0x8C03;
+
+const COMPRESSED_RGB_ETC1_WEBGL = 0x8D64;
+
+const PVR_HEADER_LENGTH = 13; // The header length in 32 bit ints.
+//const PVR_MAGIC = 0x03525650; //0x50565203;
+
+// Offsets into the header array.
+//const PVR_HEADER_MAGIC = 0;
+const PVR_HEADER_FORMAT = 2;
+const PVR_HEADER_HEIGHT = 6;
+const PVR_HEADER_WIDTH = 7;
+const PVR_HEADER_MIPMAPCOUNT = 11;
+const PVR_HEADER_METADATA = 12;
+
+const PVR_FORMAT_2BPP_RGB = 0;
+const PVR_FORMAT_2BPP_RGBA = 1;
+const PVR_FORMAT_4BPP_RGB = 2;
+const PVR_FORMAT_4BPP_RGBA = 3;
+//const PVR_COLOR_SPACE = 4;
+const PVR_FORMAT_ETC1 = 6;
+const PVR_FORMAT_DXT1 = 7;
+const PVR_FORMAT_DXT3 = 9;
+const PVR_FORMAT_DXT5 = 5;
+
+const COMPRESSED_RGB_S3TC_DXT1_EXT = 0x83F0;
+//const COMPRESSED_RGBA_S3TC_DXT1_EXT = 0x83F1;
+const COMPRESSED_RGBA_S3TC_DXT3_EXT = 0x83F2;
+const COMPRESSED_RGBA_S3TC_DXT5_EXT = 0x83F3;
+
+const PVR_TO_WEBGL_FORMAT = {
+    [PVR_FORMAT_2BPP_RGB] : COMPRESSED_RGB_PVRTC_2BPPV1_IMG,
+    [PVR_FORMAT_2BPP_RGBA] : COMPRESSED_RGBA_PVRTC_2BPPV1_IMG,
+    [PVR_FORMAT_4BPP_RGB] : COMPRESSED_RGB_PVRTC_4BPPV1_IMG,
+    [PVR_FORMAT_4BPP_RGBA] : COMPRESSED_RGBA_PVRTC_4BPPV1_IMG,
+    [PVR_FORMAT_ETC1] : COMPRESSED_RGB_ETC1_WEBGL,
+    [PVR_FORMAT_DXT1] : COMPRESSED_RGB_S3TC_DXT1_EXT,
+    [PVR_FORMAT_DXT3] : COMPRESSED_RGBA_S3TC_DXT3_EXT,
+    [PVR_FORMAT_DXT5] : COMPRESSED_RGBA_S3TC_DXT5_EXT
+};
+
+function levelBufferSize(format, width, height) {
+    switch (format) {
+        case COMPRESSED_RGB_S3TC_DXT1_EXT:
+        case COMPRESSED_RGB_ETC1_WEBGL:
+            return ((width + 3) >> 2) * ((height + 3) >> 2) * 8;
+
+        case COMPRESSED_RGBA_S3TC_DXT3_EXT:
+        case COMPRESSED_RGBA_S3TC_DXT5_EXT:
+            return ((width + 3) >> 2) * ((height + 3) >> 2) * 16;
+
+        case COMPRESSED_RGB_PVRTC_4BPPV1_IMG:
+        case COMPRESSED_RGBA_PVRTC_4BPPV1_IMG:
+            return Math.floor((Math.max(width, 8) * Math.max(height, 8) * 4 + 7) / 8);
+
+        case COMPRESSED_RGB_PVRTC_2BPPV1_IMG:
+        case COMPRESSED_RGBA_PVRTC_2BPPV1_IMG:
+            return Math.floor((Math.max(width, 16) * Math.max(height, 8) * 2 + 7) / 8);
+
+        default:
+            return 0;
+    }
+}
+*/
+
+// parse and return the compressed texture
+function parsePVR() {
+
+    throw new Error("unsupported format");
+
+    /*
+
+    // Create a new DataView from the data
+    let header = new Uint32Array(data, 0, PVR_HEADER_LENGTH);
+
+    //console.log(header);
+
+    // VERSION
+    //const version = header[PVR_HEADER_FORMAT];
+    //const versionMatch = version === PVR_MAGIC;
+
+    //  PIXEL_FORMAT_INDEX
+    const pvrFormat = PVR_TO_WEBGL_FORMAT[header[PVR_HEADER_FORMAT]] || -1;
+    const width = header[PVR_HEADER_WIDTH];
+    const height = header[PVR_HEADER_HEIGHT];
+    const dataOffset = header[PVR_HEADER_METADATA] + 52;
+    //const colorSpace = header[PVR_COLOR_SPACE];
+    const mipmapCount = header[PVR_HEADER_MIPMAPCOUNT];
+
+    var image = new Uint8Array(data, dataOffset);
+    var mipmaps = new Array(mipmapCount);
+
+    var offset = 0;
+    var levelWidth = width;
+    var levelHeight = height;
+
+    for (var i = 0; i < mipmapCount; i++)
+    {
+        var levelSize = levelBufferSize(pvrFormat, levelWidth, levelHeight);
+
+        mipmaps[i] = {
+            data: new Uint8Array(image.buffer, image.byteOffset + offset, levelSize),
+            width: levelWidth,
+            height: levelHeight
+        };
+
+        levelWidth = Math.max(1, levelWidth >> 1);
+        levelHeight = Math.max(1, levelHeight >> 1);
+
+        offset += levelSize;
+    }
+
+    return {
+        mipmaps: mipmaps,
+        width: width,
+        height: height,
+        format: pvrFormat,
+        compressed: true,
+        generateMipmap: false
+    };
+
+    */
+}
+
+export { parsePVR };

package/dist/melonjs.mjs/loader/parsers/fetchdata.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/loader/parsers/fontface.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/loader/parsers/image.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
@@ -8,6 +8,7 @@
 import { imgList } from '../cache.js';
 import { fetchData } from './fetchdata.js';
 import { getExtension } from '../../utils/file.js';
+import { parseCompressedImage } from './compressed_textures/compressed_image.js';
 
 /**
  * parse/preload an image
@@ -31,52 +32,98 @@ function preloadImage(img, onload, onerror, settings) {
         return 0;
     }
 
-    // handle SVG file loading
-    if (getExtension(img.src) === "svg") {
-        // handle SVG file
-        fetchData(img.src, "text", settings)
-            .then(svgText => {
-                const svgImage = new Image();
-                svgImage.onload = function() {
-                    imgList[img.name] = svgImage;
-                    if (typeof onload === "function") {
-                        // callback
-                        onload();
-                    }
-                };
-                svgImage.onerror = function(error) {
-                    if (typeof onerror === "function") {
-                        onerror(error);
-                    }
-                };
-                svgImage.src = "data:image/svg+xml;charset=utf8," + encodeURIComponent(svgText);
-            })
-            .catch(error => {
-                if (typeof onerror === "function") {
-                    onerror(error);
-                }
-            });
-    } else {
-        // handle all other image files
-        fetchData(img.src, "blob", settings)
-            .then(blob => {
-                globalThis.createImageBitmap(blob)
-                    .then((bitmap) => {
-                        imgList[img.name] = bitmap;
-                        if (typeof onload === "function") {
-                            // callback
-                            onload();
+    let sources = Array.isArray(img.src) ? img.src : [img.src];
+    let isFormatSupported = false;
+
+    for (const imgPath of sources) {
+        const imgExt = getExtension(imgPath);
+        // loop will stop as soon as a first supported format is detected
+        switch (imgExt) {
+            // Compressed texture
+            case "dds":
+            case "pvr":
+            case "pkm":
+            case "ktx":
+            case "ktx2":
+                fetchData(imgPath, "arrayBuffer", settings)
+                    .then(arrayBuffer => {
+                        try {
+                            imgList[img.name] = parseCompressedImage(arrayBuffer, imgExt);
+                            isFormatSupported = true;
+                            if (typeof onload === "function") {
+                                // callback
+                                onload();
+                            }
+                        } catch (e) {
+                            // parseCompressedImage will throw an error if a format is not supported or badly formatted
+                        }
+                    }).catch(error => {
+                        if (typeof onerror === "function") {
+                            // file cannot be loaded
+                            onerror(error);
+                        }
+                    });
+                break;
+
+            // SVG file
+            case "svg":
+                fetchData(imgPath, "text", settings)
+                    .then(svgText => {
+                        const svgImage = new Image();
+                        svgImage.onload = function() {
+                            imgList[img.name] = svgImage;
+                            if (typeof onload === "function") {
+                                // callback
+                                onload();
+                            }
+                        };
+                        svgImage.onerror = function(error) {
+                            if (typeof onerror === "function") {
+                                onerror(error);
+                            }
+                        };
+                        svgImage.src = "data:image/svg+xml;charset=utf8," + encodeURIComponent(svgText);
+                    })
+                    .catch(error => {
+                        if (typeof onerror === "function") {
+                            onerror(error);
                         }
                     });
-            })
-            .catch(error => {
-                if (typeof onerror === "function") {
-                    onerror(error);
-                }
-            });
+                isFormatSupported = true;
+                break;
+
+            // default is regular images (jpg, png and friends)
+            default:
+                fetchData(imgPath, "blob", settings)
+                    .then(blob => {
+                        globalThis.createImageBitmap(blob)
+                            .then((bitmap) => {
+                                imgList[img.name] = bitmap;
+                                if (typeof onload === "function") {
+                                    // callback
+                                    onload();
+                                }
+                            });
+                    })
+                    .catch(error => {
+                        if (typeof onerror === "function") {
+                            onerror(error);
+                        }
+                    });
+                isFormatSupported = true;
+                break;
+        }
+
+        // exit the loop as soon as the first supported format is detected
+        if (isFormatSupported === true) {
+            return 1;
+        }
     }
 
-    return 1;
+    // no compatible format was found
+    throw new Error(
+        "No suppported Image file format found for " + img.name
+    );
 }
 
 export { preloadImage };

package/dist/melonjs.mjs/loader/parsers/json.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/loader/parsers/script.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/loader/parsers/tmx.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/loader/parsers/video.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/math/color.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.0.0
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license