@woosh/meep-engine 3.0.1 → 3.0.2

package/src/engine/graphics/material/manager/MaterialManager.js

@@ -1,215 +0,0 @@
-import { Cache } from "../../../../core/cache/Cache.js";
-import { HashMap } from "../../../../core/collection/map/HashMap.js";
-import { computeMaterialEquality } from "../../../asset/loaders/material/computeMaterialEquality.js";
-import { computeMaterialHash } from "../../../asset/loaders/material/computeMaterialHash.js";
-import { ManagedMaterial } from "./ManagedMaterial.js";
-
-export class MaterialManager {
-
-    /**
-     * Stores links from uncompiled (source) materials to managed containers
-     * @type {HashMap<Material, ManagedMaterial>}
-     * @private
-     */
-    __library = new HashMap({
-        keyHashFunction: computeMaterialHash,
-        keyEqualityFunction: computeMaterialEquality,
-        capacity: 1024
-    });
-
-    /**
-     * Cache for unused materials, gives them a second chance to be used before being disposed completely
-     * @type {Cache<Material, ManagedMaterial>}
-     * @private
-     */
-    __cache = new Cache({
-        keyHashFunction: computeMaterialHash,
-        keyEqualityFunction: computeMaterialEquality,
-        maxWeight: 100
-    });
-
-    /**
-     * Stores links from compiled materials back to the container
-     * @type {HashMap<Material, ManagedMaterial>}
-     * @private
-     */
-    __reverse_library = new HashMap({
-        keyHashFunction: computeMaterialHash,
-        keyEqualityFunction: computeMaterialEquality,
-        capacity: 1024
-    });
-
-    /**
-     * Identity-keyed shortcut over {@link __library} + {@link __reverse_library}.
-     * Maps both a source material and its compiled material (by object identity) to
-     * the managed container, letting {@link obtain} skip the content-hash lookups
-     * for exact repeat calls - the common case. Kept in lockstep with
-     * {@link __library} membership: entries are added when a material is registered
-     * and removed in {@link __handle_last_reference_removed}, so a hit here always
-     * denotes a library-resident (live) material and never a cached one.
-     * @type {WeakMap<Material, ManagedMaterial>}
-     * @private
-     */
-    __reverse_library_weak = new WeakMap();
-
-    /**
-     *
-     * @type {AbstractMaterialTransformer[]}
-     * @private
-     */
-    __transform_chain = [];
-
-    constructor() {
-        this.__cache.onEvicted.add(this.__dispose_material, this);
-    }
-
-
-    /**
-     * handle material disposal
-     * @param {Material} m
-     * @param {ManagedMaterial} managed_material
-     * @private
-     */
-    __dispose_material(m, managed_material) {
-        managed_material.getMaterial().dispose();
-    }
-
-    /**
-     *
-     * @param {ManagedMaterial} material
-     * @private
-     */
-    __handle_last_reference_removed(material) {
-        const compiled_material = material.getMaterial();
-
-        // remove from library
-        const source = material.getSource();
-        this.__library.delete(source);
-        this.__reverse_library.delete(compiled_material);
-
-        // keep the identity shortcut in lockstep with library membership
-        this.__reverse_library_weak.delete(source);
-        this.__reverse_library_weak.delete(compiled_material);
-
-        // put material into cache
-        this.__cache.put(source, material);
-    }
-
-    /**
-     *
-     * @param {Function} klass
-     * @return {AbstractMaterialTransformer[]}
-     */
-    getCompilationSteps(klass) {
-        return this.__transform_chain.filter(x => x instanceof klass);
-    }
-
-    /**
-     *
-     * @param {AbstractMaterialTransformer} def
-     */
-    addCompileStep(def) {
-        this.__transform_chain.push(def);
-    }
-
-    /**
-     *
-     * @param {AbstractMaterialTransformer} def
-     * @returns {boolean}
-     */
-    removeCompileStep(def) {
-        const i = this.__transform_chain.indexOf(def);
-
-        if (i === -1) {
-            return false;
-        }
-
-        this.__transform_chain.splice(i, 1);
-
-        return true;
-    }
-
-    /**
-     *
-     * @param {Material} m
-     * @returns {Material}
-     * @private
-     */
-    __compile(m) {
-        let r = m;
-
-        const transformers = this.__transform_chain;
-
-        const n = transformers.length;
-
-        for (let i = 0; i < n; i++) {
-            const transformer = transformers[i];
-
-            r = transformer.transform(r);
-        }
-
-        return r;
-    }
-
-
-    /**
-     *
-     * @param {Material} source
-     * @returns {Reference<Material>}
-     */
-    obtain(source) {
-        // fast path: exact identity match against a library-resident material.
-        // Populated in the registration block below for both the source and the
-        // compiled material, and invalidated in __handle_last_reference_removed, so a
-        // hit here always denotes a live (non-cached) managed material - which lets us
-        // skip the content-hash lookups entirely for the common repeat-obtain case.
-        const exact = this.__reverse_library_weak.get(source);
-
-        if (exact !== undefined) {
-            return exact.getRef();
-        }
-
-        // reverse check to see if this is actually an already compiled/managed material
-        let material = this.__reverse_library.get(source);
-
-        if (material !== undefined) {
-            // already compiled material
-            return material.getRef();
-        }
-
-        // forward check
-        material = this.__library.get(source);
-
-        if (material === undefined) {
-            // not found in library, check cache
-            material = this.__cache.get(source);
-
-            if (material !== null) {
-                // remove from cache
-                this.__cache.remove(source);
-
-            } else {
-                // material not found in cache
-                const mat = this.__compile(source);
-
-                material = new ManagedMaterial(mat);
-                material.setSource(source);
-            }
-
-            material.onLastReleased.addOne(this.__handle_last_reference_removed, this);
-
-            this.__library.set(source, material);
-            this.__reverse_library.set(material.getMaterial(), material);
-
-            // record identity shortcuts for the source and compiled material; these are
-            // exactly the keys removed in __handle_last_reference_removed. We key on
-            // material.getSource() rather than `source` so the entry matches what
-            // cleanup deletes even when `source` is a content-equal duplicate resolved
-            // through the cache.
-            this.__reverse_library_weak.set(material.getSource(), material);
-            this.__reverse_library_weak.set(material.getMaterial(), material);
-        }
-
-        return material.getRef();
-    }
-}

package/src/engine/graphics/material/manager/compilers/CoalesceTextures.d.ts

@@ -1,11 +0,0 @@
-export class CoalesceTextures extends AbstractMaterialTransformer {
-    /**
-     * Cache of retained textures
-     * @returns {Cache<Texture, Texture>}
-     */
-    get textureCache(): any;
-    transform(material: any): any;
-    #private;
-}
-import { AbstractMaterialTransformer } from "../AbstractMaterialTransformer.js";
-//# sourceMappingURL=CoalesceTextures.d.ts.map

package/src/engine/graphics/material/manager/compilers/CoalesceTextures.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"CoalesceTextures.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/material/manager/compilers/CoalesceTextures.js"],"names":[],"mappings":"AAGA;IAQI;;;OAGG;IACH,wBAEC;IAED,8BAIC;;CACJ;4CAvB2C,mCAAmC"}

package/src/engine/graphics/material/manager/compilers/CoalesceTextures.js

@@ -1,25 +0,0 @@
-import { TextureCoalescer } from "../../../../asset/loaders/material/TextureCoalescer.js";
-import { AbstractMaterialTransformer } from "../AbstractMaterialTransformer.js";
-
-export class CoalesceTextures extends AbstractMaterialTransformer {
-
-    /**
-     *
-     * @type {TextureCoalescer}
-     */
-    #coalescer = new TextureCoalescer();
-
-    /**
-     * Cache of retained textures
-     * @returns {Cache<Texture, Texture>}
-     */
-    get textureCache() {
-        return this.#coalescer.cache;
-    }
-
-    transform(material) {
-        this.#coalescer.coalesce(material);
-
-        return material;
-    }
-}

package/src/engine/graphics/material/optimization/BUFFER_GEOMETRY_UVS.d.ts

@@ -1,5 +0,0 @@
-export const BUFFER_GEOMETRY_UVS: {
-    name: string;
-    index: number;
-}[];
-//# sourceMappingURL=BUFFER_GEOMETRY_UVS.d.ts.map

package/src/engine/graphics/material/optimization/BUFFER_GEOMETRY_UVS.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"BUFFER_GEOMETRY_UVS.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/material/optimization/BUFFER_GEOMETRY_UVS.js"],"names":[],"mappings":"AAAA;;;IASE"}

package/src/engine/graphics/material/optimization/BUFFER_GEOMETRY_UVS.js

@@ -1,10 +0,0 @@
-export const BUFFER_GEOMETRY_UVS = [
-    {
-        name: 'uv',
-        index: 0,
-    },
-    {
-        name: 'uv2',
-        index: 1
-    }
-];

package/src/engine/graphics/material/optimization/MaterialDescriptor.d.ts

@@ -1,15 +0,0 @@
-export class MaterialDescriptor {
-    /**
-     *
-     * @type {THREE.Material|null}
-     */
-    source_material: THREE.Material | null;
-    /**
-     *
-     * @type {UvContext[]}
-     */
-    uvs: UvContext[];
-    build_uvs(): void;
-}
-import { UvContext } from "./UvContext.js";
-//# sourceMappingURL=MaterialDescriptor.d.ts.map

package/src/engine/graphics/material/optimization/MaterialDescriptor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"MaterialDescriptor.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/material/optimization/MaterialDescriptor.js"],"names":[],"mappings":"AAIA;IACI;;;OAGG;IACH,iBAFU,MAAM,QAAQ,GAAC,IAAI,CAEN;IAEvB;;;OAGG;IACH,KAFU,SAAS,EAAE,CAEZ;IAET,kBAuBC;CAEJ;0BAzCyB,gBAAgB"}

package/src/engine/graphics/material/optimization/MaterialDescriptor.js

@@ -1,43 +0,0 @@
-import { traverseMaterialTextures } from "../../../asset/loaders/material/traverseMaterialTextures.js";
-import { UvContext } from "./UvContext.js";
-import { max2 } from "../../../../core/math/max2.js";
-
-export class MaterialDescriptor {
-    /**
-     *
-     * @type {THREE.Material|null}
-     */
-    source_material = null;
-
-    /**
-     *
-     * @type {UvContext[]}
-     */
-    uvs = [];
-
-    build_uvs() {
-
-        traverseMaterialTextures(this.source_material, (t, attachment) => {
-            const uv_index = attachment.uv_index;
-
-            let uv_context = this.uvs[uv_index];
-
-            if (uv_context === undefined) {
-                uv_context = new UvContext();
-                uv_context.resolution.set(1, 1);
-
-                this.uvs[uv_index] = uv_context;
-            }
-
-            const image = t.image;
-
-            if (image !== undefined && image.width !== undefined) {
-                uv_context.resolution.x = max2(uv_context.resolution.x, image.width);
-                uv_context.resolution.y = max2(uv_context.resolution.y, image.height);
-            }
-
-        });
-
-    }
-
-}

package/src/engine/graphics/material/optimization/UvContext.d.ts

@@ -1,14 +0,0 @@
-export class UvContext {
-    /**
-     * Resolution of texture
-     * @type {Vector2}
-     */
-    resolution: Vector2;
-    /**
-     *
-     * @type {AABB2}
-     */
-    atlas_patch: AABB2;
-}
-import Vector2 from "../../../../core/geom/Vector2.js";
-//# sourceMappingURL=UvContext.d.ts.map

package/src/engine/graphics/material/optimization/UvContext.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"UvContext.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/material/optimization/UvContext.js"],"names":[],"mappings":"AAGA;IACI;;;OAGG;IACH,YAFU,OAAO,CAEc;IAE/B;;;OAGG;IACH,mBAA0B;CAC7B;oBAfmB,kCAAkC"}

package/src/engine/graphics/material/optimization/UvContext.js

@@ -1,16 +0,0 @@
-import Vector2 from "../../../../core/geom/Vector2.js";
-import AABB2 from "../../../../core/geom/AABB2.js";
-
-export class UvContext {
-    /**
-     * Resolution of texture
-     * @type {Vector2}
-     */
-    resolution = new Vector2(1, 1);
-
-    /**
-     *
-     * @type {AABB2}
-     */
-    atlas_patch = new AABB2();
-}

package/src/engine/graphics/material/optimization/is_compliant_mesh.d.ts

@@ -1,7 +0,0 @@
-/**
- * Is this mesh qualified to be optimized?
- * @param {THREE.Mesh} mesh
- * @returns {boolean}
- */
-export function is_compliant_mesh(mesh: THREE.Mesh): boolean;
-//# sourceMappingURL=is_compliant_mesh.d.ts.map

package/src/engine/graphics/material/optimization/is_compliant_mesh.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"is_compliant_mesh.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/material/optimization/is_compliant_mesh.js"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wCAHW,MAAM,IAAI,GACR,OAAO,CA+DnB"}

package/src/engine/graphics/material/optimization/is_compliant_mesh.js

@@ -1,71 +0,0 @@
-import { TextureAttachmentsByMaterialType } from "../../../asset/loaders/material/TextureAttachmensByMaterialType.js";
-import { max2 } from "../../../../core/math/max2.js";
-import { BUFFER_GEOMETRY_UVS } from "./BUFFER_GEOMETRY_UVS.js";
-
-/**
- * Is this mesh qualified to be optimized?
- * @param {THREE.Mesh} mesh
- * @returns {boolean}
- */
-export function is_compliant_mesh(mesh) {
-    const material = mesh.material;
-
-    const attachments = TextureAttachmentsByMaterialType[material.type];
-
-    const uv_scales = [1, 1, 1, 1];
-
-    const texture_attachment_count = attachments.length;
-
-    for (let i = 0; i < texture_attachment_count; i++) {
-        const attachment = attachments[i];
-
-        const texture = attachment.read(material);
-        if (texture === undefined || texture === null) {
-            continue;
-        }
-
-        const uv_index = attachment.uv_index;
-
-        uv_scales[uv_index * 2] = max2(uv_scales[uv_index * 2], texture.repeat.x)
-        uv_scales[uv_index * 2 + 1] = max2(uv_scales[uv_index * 2 + 1], texture.repeat.y)
-    }
-
-    const geometry = mesh.geometry;
-
-    for (let i = 0; i < BUFFER_GEOMETRY_UVS.length; i++) {
-        const uv_metadata = BUFFER_GEOMETRY_UVS[i];
-
-        /**
-         *
-         * @type {THREE.BufferAttribute }
-         */
-        const attribute = geometry.attributes[uv_metadata.name];
-
-        if (attribute === undefined) {
-            continue;
-        }
-
-        const attribute_data = attribute.array;
-        const n = attribute_data.length;
-
-        const uv_index = uv_metadata.index;
-        const uv_index_2 = uv_index * 2;
-
-        for (let j = 0; j < n; j += 2) {
-            const x = attribute_data[j];
-            const y = attribute_data[j + 1];
-
-            const scaled_u = x * uv_scales[uv_index_2];
-            const scaled_v = y * uv_scales[uv_index_2 + 1];
-
-            if (scaled_u > 1 || scaled_u < 0 || scaled_v > 1 || scaled_v < 0) {
-                // repeating/negative UV value
-                return false;
-            }
-
-        }
-
-    }
-
-    return true;
-}

package/src/engine/graphics/sh3/path_tracer/prepare_scene_gltf.d.ts

@@ -1,21 +0,0 @@
-export function make_sun({ temperature, color, intensity, direction }?: {
-    temperature?: number;
-    color?: string;
-    intensity?: number;
-    direction?: Vector3;
-}): DirectionalLight;
-/**
- *
- * @param {PathTracedScene} scene
- * @param {THREE.Camera} camera
- * @param {string} url
- * @param {number} [zoom]
- * @param {number} [floor_level]
- * @param {Object} [sun]
- * @param {boolean} [no_materials]
- * @return {Promise<void>}
- */
-export function prepare_scene_gltf({ scene, camera, url, zoom, floor_level, sun, no_materials }: PathTracedScene): Promise<void>;
-import Vector3 from "../../../../core/geom/Vector3.js";
-import { DirectionalLight } from "../../render/forward_plus/model/DirectionalLight.js";
-//# sourceMappingURL=prepare_scene_gltf.d.ts.map

package/src/engine/graphics/sh3/path_tracer/prepare_scene_gltf.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"prepare_scene_gltf.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/sh3/path_tracer/prepare_scene_gltf.js"],"names":[],"mappings":"AAeA;;;;;qBAyBC;AAaD;;;;;;;;;;GAUG;AACH,mHAFY,QAAQ,IAAI,CAAC,CA8CxB;oBAnGmB,kCAAkC;iCAErB,qDAAqD"}

package/src/engine/graphics/sh3/path_tracer/prepare_scene_gltf.js

@@ -1,109 +0,0 @@
-import { Box3, MeshStandardMaterial, PlaneBufferGeometry, Sphere } from "three";
-import { v3_length } from "../../../../core/geom/vec3/v3_length.js";
-import { v3_scale } from "../../../../core/geom/vec3/v3_scale.js";
-import { GLTFLoader } from "three/examples/jsm/loaders/GLTFLoader.js";
-import { Color } from "../../../../core/color/Color.js";
-import { kelvin_to_rgb } from "../../../../core/color/kelvin/kelvin_to_rgb.js";
-import { noop } from "../../../../core/function/noop.js";
-import { v3_multiply } from "../../../../core/geom/vec3/v3_multiply.js";
-import Quaternion from "../../../../core/geom/Quaternion.js";
-import Vector3 from "../../../../core/geom/Vector3.js";
-import { Transform } from "../../../ecs/transform/Transform.js";
-import { DirectionalLight } from "../../render/forward_plus/model/DirectionalLight.js";
-import { three_object_replace_materials } from "../../three/three_object_replace_materials.js";
-import { three_object_to_path_traced_scene } from "./three_object_to_path_traced_scene.js";
-
-export function make_sun({
-                             temperature = 5000, // around clear-sky day
-                             color = '#FFFFFF',
-                             intensity = 1,
-                             direction = new Vector3(-0.5, -1, -0.05)
-                         } = {}) {
-
-    const temp_c = new Color();
-
-    kelvin_to_rgb(temp_c, 0, temperature);
-
-    const light = new DirectionalLight();
-
-    light.color.parse(color);
-    v3_multiply(light.color, 0, light.color[0], light.color[1], light.color[2], temp_c[0], temp_c[1], temp_c[2]);
-
-    const n = v3_length(light.color[0], light.color[1], light.color[2]);
-    v3_scale(light.color, 0, light.color[0], light.color[1], light.color[2], 1 / n); // normalize color vector
-
-    light.intensity.set(intensity * n);
-    light.direction.copy(direction);
-    light.direction.normalize();
-
-
-    return light;
-}
-
-/**
- *
- * @param {string} url
- * @return {Promise<GLTF>}
- */
-function promise_gltf(url) {
-    return new Promise((resolve, reject) => {
-        new GLTFLoader().load(url, resolve, noop, reject);
-    });
-}
-
-/**
- *
- * @param {PathTracedScene} scene
- * @param {THREE.Camera} camera
- * @param {string} url
- * @param {number} [zoom]
- * @param {number} [floor_level]
- * @param {Object} [sun]
- * @param {boolean} [no_materials]
- * @return {Promise<void>}
- */
-export async function prepare_scene_gltf({
-                                             scene,
-                                             camera,
-                                             url,
-                                             zoom = 1,
-                                             floor_level = 0,
-                                             sun,
-                                             no_materials = false
-                                         }) {
-    const gltf = await promise_gltf(url);
-
-
-    const ground_material = new MeshStandardMaterial({
-        color: '#ffceae'
-    });
-    scene.createMesh(new PlaneBufferGeometry(), ground_material, Transform.fromJSON({
-        position: new Vector3(0, floor_level, 0),
-        scale: 5000,
-        rotation: Quaternion.fromEulerAngles(-Math.PI / 2, 0, 0)
-    }).matrix);
-
-
-    const gltf_scene = gltf.scene;
-
-    if (no_materials) {
-        three_object_replace_materials(gltf_scene, new MeshStandardMaterial({ color: 'white' }));
-    }
-
-    three_object_to_path_traced_scene(gltf_scene, scene);
-
-    const box3 = new Box3();
-    box3.setFromObject(gltf_scene);
-
-    const sphere = new Sphere();
-
-    box3.getBoundingSphere(sphere);
-
-    scene.addLight(make_sun(sun));
-
-    camera.position.set(1, 1.3, 1)
-        .normalize()
-        .multiplyScalar(sphere.radius * 2.6 * (1 / zoom));
-
-    camera.lookAt(sphere.center);
-}

package/src/engine/graphics/sh3/path_tracer/three_object_to_path_traced_scene.d.ts

@@ -1,7 +0,0 @@
-/**
- *
- * @param {THREE.Object3D} gltf_scene
- * @param {PathTracedScene} scene
- */
-export function three_object_to_path_traced_scene(gltf_scene: THREE.Object3D, scene: PathTracedScene): void;
-//# sourceMappingURL=three_object_to_path_traced_scene.d.ts.map

package/src/engine/graphics/sh3/path_tracer/three_object_to_path_traced_scene.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"three_object_to_path_traced_scene.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/sh3/path_tracer/three_object_to_path_traced_scene.js"],"names":[],"mappings":"AAuBA;;;;GAIG;AACH,8DAHW,MAAM,QAAQ,gCA2CxB"}

package/src/engine/graphics/sh3/path_tracer/three_object_to_path_traced_scene.js

@@ -1,69 +0,0 @@
-import { meshopt_optimizeVertexCache } from "../../geometry/optimization/VertexCacheOptimizer.js";
-
-/**
- *
- * @param {THREE.BufferGeometry} geo
- * @returns {THREE.BufferGeometry}
- */
-function optimize_buffer_geometry(geo) {
-
-    const clone = geo.clone();
-
-    const result_index_attribute = clone.getIndex();
-    const source_index_attribute = geo.getIndex();
-
-    meshopt_optimizeVertexCache(
-        result_index_attribute.array, source_index_attribute.array,
-        source_index_attribute.count, geo.getAttribute("position").count
-    );
-
-    return clone;
-
-}
-
-/**
- *
- * @param {THREE.Object3D} gltf_scene
- * @param {PathTracedScene} scene
- */
-export function three_object_to_path_traced_scene(gltf_scene, scene) {
-    const optimized_geometry = new Map();
-
-
-    /**
-     *
-     * @param {THREE.BufferGeometry} geo
-     * @returns {THREE.BufferGeometry}
-     */
-    function process_geometry(geo) {
-        const existing = optimized_geometry.get(geo);
-        if (existing !== undefined) {
-            return existing;
-        }
-
-        let result;
-
-        try {
-            result = optimize_buffer_geometry(geo);
-        } catch (e) {
-            // failed to optimize, use original
-            result = geo;
-        }
-
-        optimized_geometry.set(geo, result);
-
-        return result;
-    }
-
-    gltf_scene.updateMatrixWorld();
-
-    gltf_scene.traverse((m) => {
-        if (m.isMesh) {
-            scene.createMesh(
-                process_geometry(m.geometry),
-                m.material,
-                m.matrixWorld.elements
-            );
-        }
-    });
-}