@woosh/meep-engine 2.109.1 → 2.109.2

package/src/engine/graphics/sh3/path_tracer/geometry/sort_triangles_by_distance_to_point.js

@@ -0,0 +1,48 @@
+import { split_by_3 } from "../../../../../core/binary/split_by_3.js";
+import { array_quick_sort_by_comparator } from "../../../../../core/collection/array/array_quick_sort_by_comparator.js";
+import { v3_distance_sqr } from "../../../../../core/geom/vec3/v3_distance_sqr.js";
+
+/**
+ *
+ * @param {number[]} triangles
+ * @param {number} offset
+ * @param {number} count
+ * @param {number} point_x
+ * @param {number} point_y
+ * @param {number} point_z
+ * @param morton_codes
+ * @param bounds
+ */
+export function sort_triangles_by_distance_to_point(
+    triangles, offset, count,
+    morton_codes, bounds,
+    point_x, point_y, point_z,
+) {
+    const bounds_x0 = bounds.x0;
+    const bounds_y0 = bounds.y0;
+    const bounds_z0 = bounds.z0;
+
+    const bounds_scale_x = bounds.getExtentsX() / 1023;
+    const bounds_scale_y = bounds.getExtentsY() / 1023;
+    const bounds_scale_z = bounds.getExtentsZ() / 1023;
+
+    array_quick_sort_by_comparator(triangles, (a, b) => {
+
+        const morton_a = morton_codes[a];
+        const morton_b = morton_codes[b];
+
+        const ax = bounds_x0 + bounds_scale_x * split_by_3(morton_a);
+        const ay = bounds_y0 + bounds_scale_y * split_by_3(morton_a >>> 1);
+        const az = bounds_z0 + bounds_scale_z * split_by_3(morton_a >>> 2);
+
+        const bx = bounds_x0 + bounds_scale_x * split_by_3(morton_b);
+        const by = bounds_y0 + bounds_scale_y * split_by_3(morton_b >>> 1);
+        const bz = bounds_z0 + bounds_scale_z * split_by_3(morton_b >>> 2);
+
+        const delta_a = v3_distance_sqr(ax, ay, az, point_x, point_y, point_z);
+        const delta_b = v3_distance_sqr(bx, by, bz, point_x, point_y, point_z);
+
+        return delta_b - delta_a;
+    }, undefined, offset, count - 1);
+
+}

package/src/engine/graphics/sh3/path_tracer/material/StandardMaterial.d.ts

@@ -1,4 +1,5 @@
 export class StandardMaterial {
+    id: number;
     diffuse: StandardTexture;
     normal: StandardTexture;
     emissive: StandardTexture;

package/src/engine/graphics/sh3/path_tracer/material/StandardMaterial.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StandardMaterial.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/sh3/path_tracer/material/StandardMaterial.js"],"names":[],"mappings":"AASA;IACI,yBAA+C;IAC/C,wBAA6C;IAC7C,0BAAiD;IACjD,2BAAmD;IACnD,2BAAmD;CACtD;gCAd+B,sBAAsB"}
+{"version":3,"file":"StandardMaterial.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/sh3/path_tracer/material/StandardMaterial.js"],"names":[],"mappings":"AAWA;IACI,WAAkB;IAElB,yBAA+C;IAC/C,wBAA6C;IAC7C,0BAAiD;IACjD,2BAAmD;IACnD,2BAAmD;CACtD;gCAlB+B,sBAAsB"}

package/src/engine/graphics/sh3/path_tracer/material/StandardMaterial.js

@@ -7,7 +7,11 @@ const DEFAULT_EMISSIVE = one_pixel_sampler_uint8([0, 0, 0]);
 const DEFAULT_ROUGHNESS = one_pixel_sampler_uint8([255]);
 const DEFAULT_METALNESS = one_pixel_sampler_uint8([0]);
 
+let id_counter = 0;
+
 export class StandardMaterial {
+    id = id_counter++;
+
     diffuse = StandardTexture.from(DEFAULT_DIFFUSE)
     normal = StandardTexture.from(DEFAULT_NORMAL)
     emissive = StandardTexture.from(DEFAULT_EMISSIVE)

package/src/engine/graphics/sh3/path_tracer/material/StandardTexture.d.ts

@@ -5,6 +5,7 @@ export class StandardTexture {
      * @returns {StandardTexture}
      */
     static from(sampler: Sampler2D): StandardTexture;
+    id: number;
     /**
      * @type {Sampler2D}
      */

package/src/engine/graphics/sh3/path_tracer/material/StandardTexture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StandardTexture.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/sh3/path_tracer/material/StandardTexture.js"],"names":[],"mappings":"AAOA;IA8BI;;;;OAIG;IACH,iCAFa,eAAe,CAQ3B;IAxCD;;OAEG;IACH,mBAAO;IACP,kBAAsC;IACtC,qBAA2B;IAC3B,cAA2C;IAC3C,cAA2C;IAE3C;;;OAGG;IACH,YAFW,eAAe,QAQzB;IAED,yBAMC;IAeD;;;;;OAKG;IACH,YAJW,MAAM,EAAE,GAAC,YAAY,KACrB,MAAM,KACN,MAAM,QA6BhB;CACJ;+BAnF8B,mDAAmD"}
+{"version":3,"file":"StandardTexture.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/sh3/path_tracer/material/StandardTexture.js"],"names":[],"mappings":"AAQA;IAgCI;;;;OAIG;IACH,iCAFa,eAAe,CAQ3B;IA1CD,WAAkB;IAElB;;OAEG;IACH,mBAAO;IACP,kBAAsC;IACtC,qBAA2B;IAC3B,cAA2C;IAC3C,cAA2C;IAE3C;;;OAGG;IACH,YAFW,eAAe,QAQzB;IAED,yBAMC;IAeD;;;;;OAKG;IACH,YAJW,MAAM,EAAE,GAAC,YAAY,KACrB,MAAM,KACN,MAAM,QA6BhB;CACJ;+BAvF8B,mDAAmD"}

package/src/engine/graphics/sh3/path_tracer/material/StandardTexture.js

@@ -1,11 +1,14 @@
-import { LinearFilter, LinearMipmapLinearFilter, NearestFilter, NearestMipMapLinearFilter } from "three";
 import { BinaryDataType } from "../../../../../core/binary/type/BinaryDataType.js";
 import { apply_texture_clamping_to_coordinate } from "../texture/apply_texture_clamping_to_coordinate.js";
 import { vec3_uint8_to_float } from "../vec3_uint8_to_float.js";
 import { TextureFilter } from "./TextureFilter.js";
 import { TextureWrapping } from "./TextureWrapping.js";
 
+let id_counter = 0;
+
 export class StandardTexture {
+    id = id_counter++;
+
     /**
      * @type {Sampler2D}
      */
@@ -66,13 +69,13 @@ export class StandardTexture {
 
         switch (magFilter) {
             default:
-            case NearestFilter:
-            case NearestMipMapLinearFilter:
+            case TextureFilter.NearestFilter:
+            case TextureFilter.NearestMipMapLinearFilter:
                 sampler.sampleNearestUV(_u, _v, out);
                 break;
 
-            case LinearFilter:
-            case LinearMipmapLinearFilter:
+            case TextureFilter.LinearFilter:
+            case TextureFilter.LinearMipmapLinearFilter:
 
                 sampler.sampleBilinearUV(_u, _v, out);
                 break;

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

@@ -40,8 +40,10 @@ import { DirectionalLight } from "../../render/forward_plus/model/DirectionalLig
 import { sampler2d_scale } from "../../texture/sampler/resize/sampler2d_scale.js";
 import { Sampler2D } from "../../texture/sampler/Sampler2D.js";
 import sampler2D2Canvas from "../../texture/sampler/Sampler2D2Canvas.js";
+import { three_object_replace_materials } from "../../three/three_object_replace_materials.js";
 import { PathTracedScene } from "./PathTracedScene.js";
 import { PathTracer } from "./PathTracer.js";
+import { three_object_to_path_traced_scene } from "./three_object_to_path_traced_scene.js";
 
 document.body.style.margin = 0;
 document.body.style.overflow = "hidden";
@@ -74,11 +76,13 @@ vCanvas.css({
  * How many rays to use per-pixel
  * @type {number}
  */
-const PIXEL_SAMPLE_COUNT = 256;
+const PIXEL_SAMPLE_COUNT = 32;
 
 const scene = new PathTracedScene();
 const pt = new PathTracer();
 
+window.scene = scene;
+
 function make_sun({
                       temperature = 5000, // around clear-sky day
                       color = '#FFFFFF',
@@ -114,7 +118,7 @@ function prepare_scene_sphere_01(pt, camera) {
     const sphere_geo = new OctahedronBufferGeometry(1, 9);
     makeGeometryIndexed(sphere_geo);
 
-    pt.addMesh(
+    pt.createMesh(
         sphere_geo,
         // new MeshStandardMaterial({ color: '#FF0000' }),
         new MeshStandardMaterial({ color: '#FFFFFF' }),
@@ -126,7 +130,7 @@ function prepare_scene_sphere_01(pt, camera) {
     const ground_material = new MeshStandardMaterial({
         color: '#FFFFFF'
     });
-    pt.addMesh(new PlaneBufferGeometry(), ground_material, Transform.fromJSON({
+    pt.createMesh(new PlaneBufferGeometry(), ground_material, Transform.fromJSON({
         position: new Vector3(0, -0.5, 0),
         scale: 50,
         rotation: Quaternion.fromEulerAngles(-Math.PI / 2, 0, 0)
@@ -168,6 +172,7 @@ function promise_gltf(url) {
  * @param {number} [zoom]
  * @param {number} [floor_level]
  * @param {Object} [sun]
+ * @param {boolean} [no_materials]
  * @return {Promise<void>}
  */
 async function prepare_scene_gltf({
@@ -176,7 +181,8 @@ async function prepare_scene_gltf({
                                       url,
                                       zoom = 1,
                                       floor_level = 0,
-                                      sun
+                                      sun,
+                                      no_materials = false
                                   }) {
     const gltf = await promise_gltf(url);
 
@@ -184,23 +190,23 @@ async function prepare_scene_gltf({
     const ground_material = new MeshStandardMaterial({
         color: '#ffceae'
     });
-    scene.addMesh(new PlaneBufferGeometry(), ground_material, Transform.fromJSON({
+    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);
 
 
-    gltf.scene.updateMatrixWorld();
+    const gltf_scene = gltf.scene;
 
-    gltf.scene.traverse((m) => {
-        if (m.isMesh) {
-            scene.addMesh(m.geometry, m.material, m.matrixWorld.elements);
-        }
-    });
+    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);
+    box3.setFromObject(gltf_scene);
 
     const sphere = new Sphere();
 
@@ -229,7 +235,7 @@ async function prepare_scene_lucy(scene, camera) {
     const lucy_material = new MeshStandardMaterial({
         color: '#95c9ff'
     });
-    scene.addMesh(lucy_geom, lucy_material, Transform.fromJSON({
+    scene.createMesh(lucy_geom, lucy_material, Transform.fromJSON({
         position: new Vector3(0, 0, 0),
         scale: 1,
         // rotation: Quaternion.fromEulerAngles(-Math.PI / 2, 0, 0)
@@ -238,7 +244,7 @@ async function prepare_scene_lucy(scene, camera) {
     const ground_material = new MeshStandardMaterial({
         color: '#ffceae'
     });
-    scene.addMesh(new PlaneBufferGeometry(), ground_material, Transform.fromJSON({
+    scene.createMesh(new PlaneBufferGeometry(), ground_material, Transform.fromJSON({
         position: new Vector3(0, -800, 0),
         scale: 5000,
         rotation: Quaternion.fromEulerAngles(-Math.PI / 2, 0, 0)
@@ -347,7 +353,7 @@ async function prepare_scene_rtiow(pt, camera) {
     const ground_material = new MeshStandardMaterial({
         color: '#ffffff'
     });
-    scene.addMesh(new PlaneBufferGeometry(), ground_material, Transform.fromJSON({
+    scene.createMesh(new PlaneBufferGeometry(), ground_material, Transform.fromJSON({
         position: new Vector3(0, 0, 0),
         scale: 50,
         rotation: Quaternion.fromEulerAngles(-Math.PI / 2, 0, 0)
@@ -374,7 +380,7 @@ async function prepare_scene_rtiow(pt, camera) {
         const mat = new Float32Array(16);
         mat4.fromRotationTranslationScale(mat, [0, 0, 0, 1], center, [radius, radius, radius])
 
-        scene.addMesh(sphere_geo, material, mat);
+        scene.createMesh(sphere_geo, material, mat);
 
         spheres.push([
             center[0],
@@ -597,9 +603,9 @@ async function start_renderer(camera) {
     // const path = 'data/models/road_bike/road_bike.gltf'; //large CAD-type model
 
     // await prepare_scene_lucy(scene, camera);
-    await prepare_scene_rtiow(pt, camera);
+    // await prepare_scene_rtiow(pt, camera);
     // await prepare_scene_sphere_01(pt, camera);
-    // await prepare_gi_box_scene(scene, camera);
+    await prepare_gi_box_scene(scene, camera);
     // await prepare_sponza(scene, camera);
     // await prepare_scene_gltf(scene, camera, path);
 

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

@@ -11,7 +11,7 @@ export function transform_normal_m4(output: number[], output_offset: number, nor
  *
  * @param {number[]} output
  * @param {number[]} hit
- * @param {number[]} m 4x4 matrix
+ * @param {number[]|Float32Array} m 4x4 matrix
  */
-export function ray_hit_apply_transform(output: number[], hit: number[], m: number[]): void;
+export function ray_hit_apply_transform(output: number[], hit: number[], m: number[] | Float32Array): void;
 //# sourceMappingURL=ray_hit_apply_transform.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ray_hit_apply_transform.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/sh3/path_tracer/ray_hit_apply_transform.js"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,4CANW,MAAM,EAAE,iBACR,MAAM,UACN,MAAM,EAAE,iBACR,MAAM,KACN,MAAM,EAAE,QAmBlB;AAED;;;;;GAKG;AACH,gDAJW,MAAM,EAAE,OACR,MAAM,EAAE,KACR,MAAM,EAAE,QAuBlB"}
+{"version":3,"file":"ray_hit_apply_transform.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/sh3/path_tracer/ray_hit_apply_transform.js"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,4CANW,MAAM,EAAE,iBACR,MAAM,UACN,MAAM,EAAE,iBACR,MAAM,KACN,MAAM,EAAE,QAmBlB;AAED;;;;;GAKG;AACH,gDAJW,MAAM,EAAE,OACR,MAAM,EAAE,KACR,MAAM,EAAE,GAAC,YAAY,QAuB/B"}

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

@@ -31,7 +31,7 @@ export function transform_normal_m4(output, output_offset, normal, normal_offset
  *
  * @param {number[]} output
  * @param {number[]} hit
- * @param {number[]} m 4x4 matrix
+ * @param {number[]|Float32Array} m 4x4 matrix
  */
 export function ray_hit_apply_transform(output, hit, m) {
 

package/src/engine/graphics/sh3/path_tracer/sampling/getBiasedNormalSample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBiasedNormalSample.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/sh3/path_tracer/sampling/getBiasedNormalSample.js"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,2CAPW,MAAM,EAAE,cACR,MAAM,UACN,MAAM,EAAE,iBACR,MAAM,SACN,MAAM,gBACK,MAAM,QAsD3B;AAED;;;;;;;GAOG;AACH,wCANW,MAAM,EAAE,cACR,MAAM,UACN,MAAM,EAAE,iBACR,MAAM,gBACK,MAAM,QAgC3B"}

package/src/engine/graphics/sh3/path_tracer/{getBiasedNormalSample.js → sampling/getBiasedNormalSample.js}

@@ -1,4 +1,4 @@
-import { PI2 } from "../../../../core/math/PI2.js";
+import { PI2 } from "../../../../../core/math/PI2.js";
 
 /**
  * @see 2003 "Global Illumination Compendium" by Philip Dutré (equation 36)

package/src/engine/graphics/sh3/path_tracer/sampling/random_in_hemisphere.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random_in_hemisphere.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/sh3/path_tracer/sampling/random_in_hemisphere.js"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,+DALW,MAAM,EAAE,iBACR,MAAM,UACN,MAAM,EAAE,iBACR,MAAM,QAoChB"}

package/src/engine/graphics/sh3/path_tracer/{random_in_hemisphere.js → sampling/random_in_hemisphere.js}

@@ -1,4 +1,4 @@
-import { v3_dot } from "../../../../core/geom/vec3/v3_dot.js";
+import { v3_dot } from "../../../../../core/geom/vec3/v3_dot.js";
 
 /**
  *

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

@@ -0,0 +1,12 @@
+/**
+ *
+ * @param {BVH} bvh
+ * @param {number[]|Uint32Array} node_list
+ * @param {number} node_list_offset
+ * @param {number} node_list_size
+ * @param {number} ref_x
+ * @param {number} ref_y
+ * @param {number} ref_z
+ */
+export function sort_bvh_nodes_by_distance_to_point(bvh: BVH, node_list: number[] | Uint32Array, node_list_offset: number, node_list_size: number, ref_x: number, ref_y: number, ref_z: number): void;
+//# sourceMappingURL=sort_bvh_nodes_by_distance_to_point.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sort_bvh_nodes_by_distance_to_point.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/sh3/path_tracer/sort_bvh_nodes_by_distance_to_point.js"],"names":[],"mappings":"AAMA;;;;;;;;;GASG;AACH,yEAPW,MAAM,EAAE,GAAC,WAAW,oBACpB,MAAM,kBACN,MAAM,SACN,MAAM,SACN,MAAM,SACN,MAAM,QA+BhB"}

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

@@ -0,0 +1,46 @@
+import { ELEMENT_WORD_COUNT } from "../../../../core/bvh2/bvh3/BVH.js";
+import { arrayQuickSort } from "../../../../core/collection/array/arrayQuickSort.js";
+import {
+    aabb3_unsigned_distance_sqr_to_point
+} from "../../../../core/geom/3d/aabb/aabb3_unsigned_distance_sqr_to_point.js";
+
+/**
+ *
+ * @param {BVH} bvh
+ * @param {number[]|Uint32Array} node_list
+ * @param {number} node_list_offset
+ * @param {number} node_list_size
+ * @param {number} ref_x
+ * @param {number} ref_y
+ * @param {number} ref_z
+ */
+export function sort_bvh_nodes_by_distance_to_point(
+    bvh,
+    node_list, node_list_offset, node_list_size,
+    ref_x, ref_y, ref_z
+) {
+    if (node_list_size <= 1) {
+        // no sort necessary
+        return;
+    }
+
+    /*
+     For performance, we bind data directly to avoid extra copies required to read out AABB
+     */
+    const float32 = bvh.__data_float32;
+    arrayQuickSort(node_list, (node) => {
+            const address = node * ELEMENT_WORD_COUNT;
+
+            const aabb_distance_sqr = aabb3_unsigned_distance_sqr_to_point(
+                float32[address], float32[address + 1], float32[address + 2],
+                float32[address + 3], float32[address + 4], float32[address + 5],
+                ref_x, ref_y, ref_z
+            );
+
+            return aabb_distance_sqr;
+        },
+        null,
+        node_list_offset, node_list_offset + node_list_size - 1
+    );
+
+}

package/src/engine/graphics/sh3/path_tracer/texture/sample_material.js

@@ -2,8 +2,8 @@ import { vec3 } from "gl-matrix";
 import { dataTypeFromTypedArray } from "../../../../../core/binary/type/dataTypeFromTypedArray.js";
 import { decode_attribute_value } from "../../../geometry/decode_attribute_value.js";
 import { geometry_construct_triangle_normal } from "../../../geometry/geometry_construct_triangle_normal.js";
+import { sample_triangle_attribute } from "../geometry/sample_triangle_attribute.js";
 import { transform_normal_m4 } from "../ray_hit_apply_transform.js";
-import { sample_triangle_attribute } from "../sample_triangle_attribute.js";
 
 const texture_uv = [0, 0];
 const color = new Float64Array([1, 1, 1]);
@@ -25,7 +25,7 @@ function sample_color_attribute(
     u, v
 ) {
     const color_array = color_attribute.array;
-    sample_triangle_attribute(color, 0, index_0, index_1, index_2, color_array, 3, u, v);
+    sample_triangle_attribute(color, 0, index_0, index_1, index_2, color_array, color_attribute.itemSize, u, v);
 
     const type = dataTypeFromTypedArray(color_array);
 

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

@@ -0,0 +1,7 @@
+/**
+ *
+ * @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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,69 @@
+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
+            );
+        }
+    });
+}

package/src/engine/graphics/sh3/prototypeSH3Probe.js

@@ -20,9 +20,11 @@ import { is_typed_array_equals } from "../../../core/collection/array/typed/is_t
 import { Color } from "../../../core/color/Color.js";
 import { kelvin_to_rgb } from "../../../core/color/kelvin/kelvin_to_rgb.js";
 import { compose_matrix4_array } from "../../../core/geom/3d/compose_matrix4_array.js";
+import { visualize_tetrahedral_mesh } from "../../../core/geom/3d/tetrahedra/visualize_tetrahedral_mesh.js";
 import Quaternion from "../../../core/geom/Quaternion.js";
 import Vector3 from "../../../core/geom/Vector3.js";
 import { max2 } from "../../../core/math/max2.js";
+import { min2 } from "../../../core/math/min2.js";
 import { randomFloatBetween } from "../../../core/math/random/randomFloatBetween.js";
 import { seededRandom } from "../../../core/math/random/seededRandom.js";
 import { number_pretty_print } from "../../../core/primitives/numbers/number_pretty_print.js";
@@ -51,7 +53,7 @@ import { GizmoRenderingPlugin } from "../render/gizmo/GizmoRenderingPlugin.js";
 import { MaterialTransformer } from "./gi/material/MaterialTransformer.js";
 import { build_probes_for_scene } from "./lpv/build_probes_for_scene.js";
 import { LightProbeVolume } from "./lpv/LightProbeVolume.js";
-import { LightProbeVolumeSerializationAdapter } from "./lpv/LightProbeVolumeSerializationAdapter.js";
+import { LightProbeVolumeSerializationAdapter } from "./lpv/serialization/LightProbeVolumeSerializationAdapter.js";
 
 /**
  *
@@ -355,26 +357,27 @@ async function main(engine) {
     const ecd = engine.entityManager.dataset;
 
 
+    // const path = 'data/models/samples/sd_macross_city_standoff_diorama/scene.gltf';
     // const path = 'data/models/LowPolyTownshipSet/Small_house/Small_house.gltf';
     // const path = 'data/models/sibenik/2/model.gltf';
     // const path = 'data/models/vokselia_spawn/model.gltf';
     // const path = 'data/models/LowPolyTownshipSet/Town_Hall/model.gltf';
-    // const path = 'data/models/pica_pica/pica_pica.gltf';
     // const path = 'data/models/samples/low_poly_classroom/no-glass/model.gltf';
     // const path = 'data/models/samples/just_a_girl/scene.gltf';
     // const path = 'data/models/samples/slum_house/scene.gltf';
     // const path = 'data/models/samples/jack_trigger/scene.gltf';
     // const path = 'data/models/samples/cornell_box/scene.gltf';
-    // const path = 'data/models/samples/cyberpunk_bike/scene.gltf';
-    // const path = 'data/models/samples/sd_macross_city_standoff_diorama/scene.gltf';
     // const path = 'data/models/Slaughter Mech/Slaugter Mech.gltf';
     // const path = 'data/models/samples/gi_box_01/model-thick-1.glb';
     // const path = 'data/models/sibenik/3-window-less/model.gltf';
     // const path = 'data/models/samples/ancient_bath_house_-_modular_set/scene.gltf';
     // const path = 'data/models/samples/environment_-_library/scene.gltf';
     // const path = 'data/models/samples/the_attic_environment/scene1.gltf';
+    // const path = 'data/models/samples/cyberpunk_bike/scene.gltf';
     const path = 'data/models/sponza-pbr/gltf/sponza.glb';
     // const path = 'data/models/samples/gi_box_01/model.glb';
+    // const path = 'data/models/Scans/green_car_wreck/scene.gltf';
+    // const path = 'data/models/pica_pica/pica_pica.gltf';
 
     const mesh_asset = await engine.assetManager.promise(path, 'model/gltf+json');
     const gltf = mesh_asset.gltf;
@@ -438,6 +441,7 @@ async function main(engine) {
     camera.component.clip_far = max2(100, model_footprint);
     const camera_controller = ecd.getComponent(camera.entity, TopDownCameraController);
     camera_controller.distanceMax = model_footprint * 1.1;
+    camera_controller.distanceMin = min2(camera_controller.distanceMin, model_footprint * 0.01);
     mesh_bounds.getCenter(camera_controller.target)
 
     const random = seededRandom();
@@ -486,6 +490,12 @@ async function main(engine) {
     const probe_viz = volume.visualize_probes({ size: model_footprint * 0.002 });
     probe_viz.build(ecd);
 
+    const mesh_viz = visualize_tetrahedral_mesh({
+        mesh: volume.mesh,
+        positions: volume.points,
+        opacity: 0.5
+    });
+
     // volume.visualize_mesh({ ecd, opacity: 0.5 });
 
     const gui = new GUI();
@@ -503,14 +513,26 @@ async function main(engine) {
         get probe_vis() {
             return probe_viz.isBuilt
         },
-        set probe_vis(v){
-            if(v){
+        set probe_vis(v) {
+            if (v) {
                 probe_viz.build(ecd);
-            }else{
+            } else {
                 probe_viz.destroy();
             }
         }
     }, "probe_vis").name("Visualise Probes");
+    gui.add({
+        get mesh_vis() {
+            return mesh_viz.isBuilt
+        },
+        set mesh_vis(v) {
+            if (v) {
+                mesh_viz.build(ecd);
+            } else {
+                mesh_viz.destroy();
+            }
+        }
+    }, "mesh_vis").name("Visualise Mesh");
 
 
     // mesh_entity.addEventListener(SGMeshEvents.AssetLoaded, build);

package/src/engine/graphics/texture/formatToChannelCount.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formatToChannelCount.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics/texture/formatToChannelCount.js"],"names":[],"mappings":"AASA;;;;GAIG;AACH,6CAHW,MAAM,GACJ,MAAM,CAgBlB"}
+{"version":3,"file":"formatToChannelCount.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics/texture/formatToChannelCount.js"],"names":[],"mappings":"AAkBA;;;;GAIG;AACH,6CAHW,MAAM,GACJ,MAAM,CAoBlB"}

package/src/engine/graphics/texture/formatToChannelCount.js

@@ -1,4 +1,13 @@
-import { RedFormat, RedIntegerFormat, RGBAFormat, RGFormat } from "three";
+import {
+    RedFormat,
+    RedIntegerFormat,
+    RGB_S3TC_DXT1_Format,
+    RGBA_S3TC_DXT1_Format,
+    RGBA_S3TC_DXT3_Format,
+    RGBA_S3TC_DXT5_Format,
+    RGBAFormat,
+    RGFormat
+} from "three";
 
 
 /**
@@ -20,8 +29,12 @@ export function formatToChannelCount(format) {
         case RGFormat:
             return 2;
         case RGBFormat:
+        case RGB_S3TC_DXT1_Format:
             return 3;
         case RGBAFormat:
+        case RGBA_S3TC_DXT1_Format:
+        case RGBA_S3TC_DXT3_Format:
+        case RGBA_S3TC_DXT5_Format:
             return 4;
         default:
             throw new Error(`Unsupported format '${format}'`);

package/src/engine/graphics/three/three_object_replace_materials.d.ts

@@ -0,0 +1,7 @@
+/**
+ *
+ * @param {THREE.Object3D} root
+ * @param {THREE.Material} replacement
+ */
+export function three_object_replace_materials(root: THREE.Object3D, replacement: THREE.Material): void;
+//# sourceMappingURL=three_object_replace_materials.d.ts.map

package/src/engine/graphics/three/three_object_replace_materials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"three_object_replace_materials.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics/three/three_object_replace_materials.js"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qDAHW,MAAM,QAAQ,eACd,MAAM,QAAQ,QASxB"}

package/src/engine/graphics/three/three_object_replace_materials.js

@@ -0,0 +1,13 @@
+/**
+ *
+ * @param {THREE.Object3D} root
+ * @param {THREE.Material} replacement
+ */
+export function three_object_replace_materials(root, replacement) {
+
+    root.traverse(o => {
+        if (o.isMesh) {
+            o.material = replacement;
+        }
+    })
+}

package/src/core/collection/array/array_quick_sort_by_lookup.d.ts

@@ -1,8 +0,0 @@
-/**
- * @param {number[]|Uint32Array} data
- * @param {number[]|Uint32Array} lookup
- * @param {number} start
- * @param {number} end
- */
-export function array_quick_sort_by_lookup(data: number[] | Uint32Array, lookup: number[] | Uint32Array, start: number, end: number): void;
-//# sourceMappingURL=array_quick_sort_by_lookup.d.ts.map