@woosh/meep-engine 3.0.1 → 3.1.0

package/src/engine/asset/loaders/material/computeTextureEquality.js

@@ -1,221 +0,0 @@
-import { fastArrayEquals } from "../../../../core/collection/array/fastArrayEquals.js";
-import { isArrayLike } from "../../../../core/collection/array/isArrayLike.js";
-import { computeImageCanvasEquality } from "../../../graphics/canvas/computeImageCanvasEquality.js";
-import { isImageBitmap } from "../../../graphics/texture/isImageBitmap.js";
-import { computeImageBitmapEquality } from "./computeImageBitmapEquality.js";
-
-
-/**
- * Compare two three.js textures for equality
- * @param {THREE.Texture} a
- * @param {THREE.Texture} b
- * @returns {boolean}
- */
-export function computeTextureEquality(a, b) {
-    if (a === b) {
-        return true;
-    }
-
-    if (
-        a === null
-        || b === null
-        || a === undefined
-        || b === undefined
-    ) {
-        return false;
-    }
-
-    // special methods
-    if (typeof a.equals === "function" && typeof b.equals === "function") {
-        // can check for equality using custom methods
-        return a.equals(b);
-    }
-
-    // revert to generic check
-
-    if (
-        a.mapping !== b.mapping
-        || a.wrapS !== b.wrapS
-        || a.wrapT !== b.wrapT
-        || a.magFilter !== b.magFilter
-        || a.minFilter !== b.minFilter
-        || a.anisotropy !== b.anisotropy
-        || a.format !== b.format
-        || a.type !== b.type
-        || !a.offset.equals(b.offset)
-        || !a.repeat.equals(b.repeat)
-        || !a.center.equals(b.center)
-        || a.rotation !== b.rotation
-        || a.generateMipmaps !== b.generateMipmaps
-        || a.premultiplyAlpha !== b.premultiplyAlpha
-        || a.flipY !== b.flipY
-        || a.unpackAlignment !== b.unpackAlignment
-        || a.encoding !== b.encoding
-        || !textureImagesEqual(a.image, b.image)
-    ) {
-        return false;
-    }
-
-
-    if (a.isCompressedTexture && b.isCompressedTexture) {
-        const aMipmaps = a.mipmaps;
-        const bMipmaps = b.mipmaps;
-
-        if (!textureMipChainEqual(aMipmaps, bMipmaps)) {
-            return false;
-        }
-
-    }
-
-    //TODO implement support for other texture types
-
-    // checks up until now were for rejection, so if we got until this point - textures must be equal
-    return true;
-}
-
-/**
- *
- * @param {Image|ImageBitmap|HTMLCanvasElement|[]|{width:number, height:number}} a
- * @param {Image|ImageBitmap|HTMLCanvasElement|[]|{width:number, height:number}} b
- * @returns {boolean}
- */
-export function textureImagesEqual(a, b) {
-    if (a === b) {
-        return true;
-    }
-
-    if (a instanceof Image && b instanceof Image) {
-        //both are images
-        if (a.src === b.src) {
-            //same source
-            return true;
-        } else {
-            // different source, assume images are different too
-            return false;
-        }
-    }
-
-    if (
-        (typeof a.width === "number" && a.width !== b.width)
-        || (typeof a.height === "number" && a.height !== b.height)
-    ) {
-        // dimensions are present, but are inconsistent
-        return false;
-    }
-
-    if (isImageBitmap(a) && isImageBitmap(b)) {
-
-        return computeImageBitmapEquality(a, b);
-
-    }
-
-    if (a instanceof HTMLCanvasElement && b instanceof HTMLCanvasElement) {
-        return computeImageCanvasEquality(a, b);
-    }
-
-    if (Array.isArray(a) && Array.isArray(b)) {
-        if (a.length !== b.length) {
-            return false;
-        }
-
-        for (let i = 0; i < a.length; i++) {
-            const ai = a[i];
-            const bi = b[i];
-
-            if (ai.format !== bi.format) {
-                return false;
-            }
-
-            const aMipmaps = ai.mipmaps;
-            const bMipmaps = bi.mipmaps;
-
-            //TODO should we ignore mipmaps if they are absent?
-            if (!textureMipChainEqual(aMipmaps, bMipmaps)) {
-                return false;
-            }
-        }
-
-        return true;
-    }
-
-    const a_data = a.data;
-    const b_data = b.data;
-
-    if (a_data === null && b_data === null) {
-        // special case, empty texture
-        return true;
-    }
-
-    if (isArrayLike(a_data) && isArrayLike(b_data)) {
-        return textureMipmapEqual(a, b);
-    }
-
-    // assume different
-    return false;
-}
-
-/**
- *
- * @param {Array} a
- * @param {Array} b
- * @returns {boolean}
- */
-function textureMipChainEqual(a, b) {
-    if (a === undefined) {
-        if (b === undefined) {
-            return true;
-        } else {
-            return false;
-        }
-    } else if (b === undefined) {
-        return false;
-    }
-
-    const a_length = a.length;
-
-    if (a_length !== b.length) {
-        // different mip chain length
-        return false;
-    }
-
-    for (let j = a_length - 1; j >= 0; j--) { //traverse chain top to bottom, starting from smallest mip for faster rejection
-
-        const aMipmap = a[j];
-        const bMipmap = b[j];
-
-        if (!textureMipmapEqual(aMipmap, bMipmap)) {
-            return false;
-        }
-
-    }
-
-    return true;
-}
-
-
-/**
- *
- * @param {{data:Uint8Array, width:number, height:number}} a
- * @param {{data:Uint8Array, width:number, height:number}} b
- * @returns {boolean}
- */
-function textureMipmapEqual(a, b) {
-    if (a.width !== b.width) {
-        return false;
-    }
-
-    if (a.height !== b.width) {
-        return false;
-    }
-
-    const aData = a.data;
-    const bData = b.data;
-
-
-    if (aData === bData) {
-        // special case
-        return true;
-    }
-
-    return fastArrayEquals(aData, bData);
-}

package/src/engine/asset/loaders/material/computeTextureEqualityById.d.ts

@@ -1,8 +0,0 @@
-/**
- *
- * @param {Texture} a
- * @param {Texture} b
- * @returns {boolean}
- */
-export function computeTextureEqualityById(a: Texture, b: Texture): boolean;
-//# sourceMappingURL=computeTextureEqualityById.d.ts.map

package/src/engine/asset/loaders/material/computeTextureEqualityById.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"computeTextureEqualityById.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/asset/loaders/material/computeTextureEqualityById.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,oEAFa,OAAO,CAiBnB"}

package/src/engine/asset/loaders/material/computeTextureEqualityById.js

@@ -1,22 +0,0 @@
-/**
- *
- * @param {Texture} a
- * @param {Texture} b
- * @returns {boolean}
- */
-export function computeTextureEqualityById(a, b) {
-    if (a === b) {
-        return true;
-    }
-
-    if (
-        a === null
-        || b === null
-        || a === undefined
-        || b === undefined
-    ) {
-        return false;
-    }
-
-    return a.id === b.id;
-}

package/src/engine/asset/loaders/material/computeTextureHash.d.ts

@@ -1,17 +0,0 @@
-/**
- *
- * @param {ImageBitmap|HTMLImageElement|{data,width:number,height:number}} image
- * @return {number}
- */
-export function computeImageDataHash(image: ImageBitmap | HTMLImageElement | {
-    data: any;
-    width: number;
-    height: number;
-}): number;
-/**
- *
- * @param {Texture|THREE.Texture} t
- * @returns {number}
- */
-export function computeTextureHash(t: Texture | THREE.Texture): number;
-//# sourceMappingURL=computeTextureHash.d.ts.map

package/src/engine/asset/loaders/material/computeTextureHash.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"computeTextureHash.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/asset/loaders/material/computeTextureHash.js"],"names":[],"mappings":"AA0BA;;;;GAIG;AACH;;WAHoD,MAAM;YAAQ,MAAM;IAC5D,MAAM,CA0CjB;AA4CD;;;;GAIG;AACH,sCAHW,UAAQ,MAAM,OAAO,GACnB,MAAM,CAgDlB"}

package/src/engine/asset/loaders/material/computeTextureHash.js

@@ -1,167 +0,0 @@
-import { assert } from "../../../../core/assert.js";
-import { combine_hash } from "../../../../core/collection/array/combine_hash.js";
-import { murmur3_32 } from "../../../../core/math/hash/murmur3_32.js";
-import { computeHashFloat } from "../../../../core/primitives/numbers/computeHashFloat.js";
-import { computeStringHash } from "../../../../core/primitives/strings/computeStringHash.js";
-import { computeHtmlCanvasElementHash } from "../../../graphics/canvas/computeHtmlCanvasElementHash.js";
-import { isImageBitmap } from "../../../graphics/texture/isImageBitmap.js";
-import { computeImageBitmapHash } from "./computeImageBitmapHash.js";
-
-/**
- *
- * @param {Vector2} v
- * @return {number}
- */
-function vector2Hash(v) {
-    const x = computeHashFloat(v.x);
-    const y = computeHashFloat(v.y);
-    return ((x << 5) - x) + y;
-}
-
-/**
- *
- * @type {WeakMap<object, number>}
- */
-const data_cache = new WeakMap();
-
-/**
- *
- * @param {ImageBitmap|HTMLImageElement|{data,width:number,height:number}} image
- * @return {number}
- */
-export function computeImageDataHash(image) {
-    const cached_value = data_cache.get(image);
-
-    if (cached_value !== undefined) {
-        return cached_value;
-    }
-
-    let result = 0;
-
-    if (isImageBitmap(image)) {
-
-        result = computeImageBitmapHash(image);
-
-    } else if (image instanceof HTMLImageElement) {
-
-        result = computeStringHash(image.src);
-
-    } else if (image instanceof HTMLCanvasElement) {
-
-        result = computeHtmlCanvasElementHash(image);
-
-    }
-
-    let width = 0;
-    let height = 0;
-
-    if (typeof image.width === "number") {
-        width = image.width;
-    }
-
-    if (typeof image.height === "number") {
-        height = image.height;
-    }
-
-    result = result ^ (((width & 0xFFFF) << 16) | (height & 0xFFFF));
-
-    // cache value
-    data_cache.set(image, result);
-
-    return result;
-}
-
-/**
- *
- * @param {Texture} texture
- * @return {number}
- */
-function computeSpecificHash(texture) {
-    let dataHash = 0;
-    let i;
-
-    if (texture.image !== null && texture.image !== undefined) {
-
-        const image = texture.image;
-
-        dataHash = computeImageDataHash(image);
-
-    }
-
-    const mipmaps = texture.mipmaps;
-
-    if (Array.isArray(mipmaps)) {
-        const nMipmaps = mipmaps.length;
-
-        for (i = 0; i < nMipmaps; i++) {
-            const mipmap = mipmaps[i];
-
-            const data = mipmap.data;
-            const dataSize = data.length;
-
-            if (dataSize > 1024) {
-                continue;
-            }
-
-            dataHash = ((dataHash << 5) - dataHash) + murmur3_32(data, 1337);
-
-            break;
-        }
-
-    }
-
-    return dataHash;
-}
-
-/**
- *
- * @param {Texture|THREE.Texture} t
- * @returns {number}
- */
-export function computeTextureHash(t) {
-    if (t === null) {
-        return 0;
-    }
-
-    if (t === undefined) {
-        return 1;
-    }
-
-    // special methods
-    if (typeof t.hash === "function") {
-        const hash = t.hash(); // must produce an integer value
-
-        assert.isInteger(hash, 'hash');
-
-        return hash;
-    }
-
-    // revert to generic check
-
-    const specificHash = computeSpecificHash(t);
-
-    return combine_hash(
-        t.mapping,
-        t.wrapS,
-        t.wrapT,
-        t.magFilter,
-        t.minFilter,
-        t.anisotropy,
-        t.format,
-        t.type,
-        vector2Hash(t.offset),
-        vector2Hash(t.repeat),
-        vector2Hash(t.center),
-        computeHashFloat(t.rotation),
-        t.generateMipmaps ? 1 : 0,
-        t.premultiplyAlpha ? 1 : 0,
-        t.flipY ? 1 : 0,
-        t.unpackAlignment,
-        /*
-         we are excluding encoding from hash, as this property has disappeared in later version of three.js
-         This property is rarely going to have the deciding role for the hash anyway. This notice is left for historical purposes only
-         */
-        // t.encoding,
-        specificHash
-    );
-}

package/src/engine/asset/loaders/material/planeHash.d.ts

@@ -1,7 +0,0 @@
-/**
- *
- * @param {Plane} plane
- * @returns {number}
- */
-export function planeHash(plane: Plane): number;
-//# sourceMappingURL=planeHash.d.ts.map

package/src/engine/asset/loaders/material/planeHash.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"planeHash.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/asset/loaders/material/planeHash.js"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,yCAFa,MAAM,CAIlB"}

package/src/engine/asset/loaders/material/planeHash.js

@@ -1,10 +0,0 @@
-import { v3_morton_encode_magicbits } from "../../../../core/geom/3d/morton/v3_morton_encode_magicbits.js";
-
-/**
- *
- * @param {Plane} plane
- * @returns {number}
- */
-export function planeHash(plane) {
-    return v3_morton_encode_magicbits(plane.normal.x, plane.normal.y, plane.normal.z) ^ plane.constant;
-}

package/src/engine/asset/loaders/material/planesEqual.d.ts

@@ -1,8 +0,0 @@
-/**
- *
- * @param {Plane} a
- * @param {Plane} b
- * @returns {boolean}
- */
-export function planesEqual(a: Plane, b: Plane): boolean;
-//# sourceMappingURL=planesEqual.d.ts.map

package/src/engine/asset/loaders/material/planesEqual.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"planesEqual.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/asset/loaders/material/planesEqual.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,iDAFa,OAAO,CAInB"}

package/src/engine/asset/loaders/material/planesEqual.js

@@ -1,9 +0,0 @@
-/**
- *
- * @param {Plane} a
- * @param {Plane} b
- * @returns {boolean}
- */
-export function planesEqual(a, b) {
-    return a.equals(b);
-}

package/src/engine/asset/loaders/material/textureHashById.d.ts

@@ -1,7 +0,0 @@
-/**
- *
- * @param {THREE.Texture} texture
- * @return {number}
- */
-export function textureHashById(texture: THREE.Texture): number;
-//# sourceMappingURL=textureHashById.d.ts.map

package/src/engine/asset/loaders/material/textureHashById.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"textureHashById.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/asset/loaders/material/textureHashById.js"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,yCAHW,MAAM,OAAO,GACZ,MAAM,CAQjB"}

package/src/engine/asset/loaders/material/textureHashById.js

@@ -1,12 +0,0 @@
-/**
- *
- * @param {THREE.Texture} texture
- * @return {number}
- */
-export function textureHashById(texture) {
-    if (texture === undefined || texture === null) {
-        return 0;
-    }
-
-    return texture.id;
-}

package/src/engine/asset/loaders/material/traverseMaterialTextures.d.ts

@@ -1,16 +0,0 @@
-/**
- * Visit every non-null texture attached to a material, along with the {@link TextureAttachment}
- * that reads/writes it. This is THE place that knows how to walk
- * {@link TextureAttachmentsByMaterialType} and what "no texture here" means; anything that needs to
- * inspect or replace a material's textures should go through it rather than re-deriving the walk.
- *
- * `material` is handed to the callback as well so write-back consumers
- * (`attachment.write(material, replacement)`) need no closure, and `thisArg` can carry whatever
- * cache the traversal is feeding.
- *
- * @param {Material} material
- * @param {function(THREE.Texture, TextureAttachment, Material)} callback
- * @param {*} [thisArg]
- */
-export function traverseMaterialTextures(material: Material, callback: (arg0: THREE.Texture, arg1: TextureAttachment, arg2: Material) => any, thisArg?: any): void;
-//# sourceMappingURL=traverseMaterialTextures.d.ts.map

package/src/engine/asset/loaders/material/traverseMaterialTextures.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"traverseMaterialTextures.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/asset/loaders/material/traverseMaterialTextures.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,8EAHoB,MAAM,OAAO,wEA+BhC"}

package/src/engine/asset/loaders/material/traverseMaterialTextures.js

@@ -1,45 +0,0 @@
-import { TextureAttachmentsByMaterialType } from "./TextureAttachmensByMaterialType.js";
-
-/**
- * Visit every non-null texture attached to a material, along with the {@link TextureAttachment}
- * that reads/writes it. This is THE place that knows how to walk
- * {@link TextureAttachmentsByMaterialType} and what "no texture here" means; anything that needs to
- * inspect or replace a material's textures should go through it rather than re-deriving the walk.
- *
- * `material` is handed to the callback as well so write-back consumers
- * (`attachment.write(material, replacement)`) need no closure, and `thisArg` can carry whatever
- * cache the traversal is feeding.
- *
- * @param {Material} material
- * @param {function(THREE.Texture, TextureAttachment, Material)} callback
- * @param {*} [thisArg]
- */
-export function traverseMaterialTextures(material, callback, thisArg) {
-
-    //patch textures
-    const materialType = material.type;
-
-    /**
-     *
-     * @type {TextureAttachment[]}
-     */
-    const attachments = TextureAttachmentsByMaterialType[materialType];
-
-
-    if (attachments !== undefined) {
-        const attachment_count = attachments.length;
-
-        for (let i = 0; i < attachment_count; i++) {
-            const attachment = attachments[i];
-
-            const texture = attachment.read(material);
-
-            if (texture === null || texture === undefined) {
-                continue;
-            }
-
-            callback.call(thisArg, texture, attachment, material);
-
-        }
-    }
-}

package/src/engine/asset/loaders/texture/TextureAssetLoader.d.ts

@@ -1,6 +0,0 @@
-export class TextureAssetLoader extends AssetLoader<any, any> {
-    constructor();
-    load(scope: any, path: any, success: any, failure: any, progress: any): void;
-}
-import { AssetLoader } from "../AssetLoader.js";
-//# sourceMappingURL=TextureAssetLoader.d.ts.map

package/src/engine/asset/loaders/texture/TextureAssetLoader.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"TextureAssetLoader.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/asset/loaders/texture/TextureAssetLoader.js"],"names":[],"mappings":"AAIA;;IACI,6EAmCC;CACJ;4BAzC2B,mBAAmB"}

package/src/engine/asset/loaders/texture/TextureAssetLoader.js

@@ -1,42 +0,0 @@
-import { AssetLoader } from "../AssetLoader.js";
-import { loadStandardImageTexture } from "./loadStandardImageTexture.js";
-import { computeFileExtension } from "../../../../core/path/computeFileExtension.js";
-
-export class TextureAssetLoader extends AssetLoader {
-    load(scope, path, success, failure, progress) {
-        //figure out what kind of a texture it is
-        let fileExtension = computeFileExtension(path);
-
-        // data URIs carry their payload inline, network path resolution must not touch them
-        let is_data_uri = false;
-
-        if (fileExtension === null) {
-            //check if it's a data path
-
-            const match = path.match(/^data\:image\/([a-zA-Z0-9]+)\;/);
-
-            if (match === null) {
-                throw new Error(`no file extension on path '${path}'`);
-
-            } else {
-                //seems ok
-                fileExtension = match[1];
-                is_data_uri = true;
-            }
-
-        }
-
-        const resolved_path = is_data_uri ? path : this.resolvePath(path);
-
-        const lowerCaseExtension = fileExtension.toLowerCase();
-        switch (lowerCaseExtension) {
-            case 'png':
-            case 'jpg':
-                loadStandardImageTexture(resolved_path, success, failure, progress);
-                break;
-            default:
-                throw new Error(`Unsupported texture file format: '${lowerCaseExtension}'`);
-
-        }
-    }
-}

package/src/engine/asset/loaders/texture/cloneTexture.d.ts

@@ -1,7 +0,0 @@
-/**
- *
- * @param {Texture} t
- * @returns {Texture}
- */
-export function cloneTexture(t: Texture): Texture;
-//# sourceMappingURL=cloneTexture.d.ts.map

package/src/engine/asset/loaders/texture/cloneTexture.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cloneTexture.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/asset/loaders/texture/cloneTexture.js"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,kDAOC"}

package/src/engine/asset/loaders/texture/cloneTexture.js

@@ -1,13 +0,0 @@
-/**
- *
- * @param {Texture} t
- * @returns {Texture}
- */
-export function cloneTexture(t) {
-    const clone = t.clone();
-
-    //apparently cloned textures need this trick to work
-    clone.needsUpdate = true;
-
-    return clone;
-}

package/src/engine/asset/loaders/texture/loadStandardImageTexture.d.ts

@@ -1,8 +0,0 @@
-/**
- *
- * @param {Texture} texture
- * @return {number}
- */
-export function computeTextureByteSize(texture: Texture): number;
-export function loadStandardImageTexture(path: any, success: any, failure: any, progress: any): void;
-//# sourceMappingURL=loadStandardImageTexture.d.ts.map

package/src/engine/asset/loaders/texture/loadStandardImageTexture.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"loadStandardImageTexture.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/asset/loaders/texture/loadStandardImageTexture.js"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,0DAFY,MAAM,CAWjB;AACD,qGAgBC"}