@woosh/meep-engine 2.109.6 → 2.109.8

package/src/engine/graphics/sh3/lpv/find_max_depth_radius_for_point.js

@@ -0,0 +1,50 @@
+import { v3_distance_sqr } from "../../../../core/geom/vec3/v3_distance_sqr.js";
+import {
+    tetrahedral_mesh_find_tets_attached_to_vertex
+} from "../../../../core/geometry/3d/tetrahedra/tetrahedral_mesh_find_tets_attached_to_vertex.js";
+import { max2 } from "../../../../core/math/max2.js";
+
+/**
+ *
+ * @type {number[]}
+ */
+const tets = [];
+
+/**
+ *
+ * @param {number} vertex_index
+ * @param {TetrahedralMesh} mesh
+ * @param {number[]} points
+ */
+export function find_max_depth_radius_for_point(vertex_index, mesh, points) {
+
+    const count = tetrahedral_mesh_find_tets_attached_to_vertex(
+        tets, 0,
+        mesh,
+        vertex_index
+    );
+
+    const ref_x = points[vertex_index * 3];
+    const ref_y = points[vertex_index * 3 + 1];
+    const ref_z = points[vertex_index * 3 + 2];
+
+    let radius_sqr = 0;
+
+    for (let i = 0; i < count; i++) {
+        const tet = tets[i];
+
+        for (let j = 0; j < 4; j++) {
+            const v = mesh.getVertexIndex(tet, j);
+
+            const x = points[v * 3];
+            const y = points[v * 3 + 1];
+            const z = points[v * 3 + 2];
+
+            const r2 = v3_distance_sqr(ref_x, ref_y, ref_z, x, y, z);
+
+            radius_sqr = max2(r2, radius_sqr);
+        }
+    }
+
+    return Math.sqrt(radius_sqr);
+}

package/src/engine/graphics/sh3/lpv/probe_volume_to_textures.d.ts

@@ -1,13 +1,10 @@
 /**
  *
  * @param {LightProbeVolume} lpv
+ * @param {number[]} atlas_data
+ * @param {number} atlas_width
  */
-export function probe_volume_to_textures(lpv: LightProbeVolume): {
-    mesh_vertices: AttributeDataTexture;
-    mesh_neighbours: AttributeDataTexture;
-    probe_positions: AttributeDataTexture;
-    probe_values: AttributeDataTexture;
-};
+export function octahedral_depth_to_atlas(lpv: LightProbeVolume, atlas_data: number[], atlas_width: number): void;
 /**
  *
  * @param {AttributeDataTexture} target

package/src/engine/graphics/sh3/lpv/probe_volume_to_textures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"probe_volume_to_textures.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/sh3/lpv/probe_volume_to_textures.js"],"names":[],"mappings":"AAMA;;;GAGG;AACH;;;;;EAuDC;AAED;;;;;;GAMG;AACH,2DALW,oBAAoB,UACpB,MAAM,EAAE,eACR,MAAM,eACN,MAAM,QAiBhB;qCAtFoC,uCAAuC"}
+{"version":3,"file":"probe_volume_to_textures.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/sh3/lpv/probe_volume_to_textures.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,6EAHW,MAAM,EAAE,eACR,MAAM,QAiChB;AAGD;;;;;;GAMG;AACH,2DALW,oBAAoB,UACpB,MAAM,EAAE,eACR,MAAM,eACN,MAAM,QAiBhB;qCAhEoC,uCAAuC"}

package/src/engine/graphics/sh3/lpv/probe_volume_to_textures.js

@@ -1,70 +1,46 @@
-import { BinaryDataType } from "../../../../core/binary/type/BinaryDataType.js";
 import { array_copy } from "../../../../core/collection/array/array_copy.js";
-import { AttributeSpec } from "../../geometry/AttributeSpec.js";
 import { AttributeDataTexture } from "../../texture/AttributeDataTexture.js";
-import { tetrahedral_mesh_to_texture } from "../gi/tetrahedral_mesh_to_texture.js";
 
 /**
  *
  * @param {LightProbeVolume} lpv
+ * @param {number[]} atlas_data
+ * @param {number} atlas_width
  */
-export function probe_volume_to_textures(lpv) {
-
-    const tex_vertices = new AttributeDataTexture(
-        AttributeSpec.fromJSON({
-            name: "vertex",
-            type: BinaryDataType.Uint16,
-            itemSize: 4,
-            normalized: false
-        }),
-        256, 1
-    );
-
-    const tex_neighbours = new AttributeDataTexture(
-        AttributeSpec.fromJSON({
-            name: "neighbour",
-            type: BinaryDataType.Uint32,
-            itemSize: 4,
-            normalized: false
-        }),
-        256, 1
-    );
-
-    const tex_positions = new AttributeDataTexture(
-        AttributeSpec.fromJSON({
-            name: "positions",
-            type: BinaryDataType.Float32,
-            itemSize: 3,
-            normalized: false
-        }),
-        256, 1
-    );
-
-    const tex_harmonics = new AttributeDataTexture(
-        AttributeSpec.fromJSON({
-            name: "harmonics",
-            type: BinaryDataType.Float32,
-            itemSize: 3,
-            normalized: false
-        }),
-        256, 9
-    );
-
-    vector_buffer_to_attribute_texture(tex_positions, lpv.points, lpv.count, 3);
-    vector_buffer_to_attribute_texture(tex_harmonics, lpv.harmonics, lpv.count * 9, 3);
-    tetrahedral_mesh_to_texture(
-        tex_vertices, tex_neighbours, lpv.mesh
-    );
-
-    return {
-        mesh_vertices: tex_vertices,
-        mesh_neighbours: tex_neighbours,
-
-        probe_positions: tex_positions,
-        probe_values: tex_harmonics
-    };
+export function octahedral_depth_to_atlas(lpv, atlas_data, atlas_width) {
+    const tile_resolution = lpv.depth_map_resolution;
+    const probe_count = lpv.count;
+    const probe_depth = lpv.depth;
+
+    const tiles_per_row = Math.floor(atlas_width / tile_resolution);
+
+    // populate atlas
+    for (let i = 0; i < probe_count; i++) {
+
+        const tile_x = i % tiles_per_row;
+        const tile_y = (i / tiles_per_row) >>> 0;
+
+        for (let pixel_y = 0; pixel_y < tile_resolution; pixel_y++) {
+            for (let pixel_x = 0; pixel_x < tile_resolution; pixel_x++) {
+
+                const source_offset = i * tile_resolution * tile_resolution;
+
+                const tile_pixel_index = pixel_y * tile_resolution + pixel_x;
+
+                const source_value = probe_depth[source_offset + tile_pixel_index];
+
+                const target_pixel_x = tile_x * tile_resolution + pixel_x;
+                const target_pixel_y = tile_y * tile_resolution + pixel_y;
+
+                const target_pixel_index = target_pixel_y * atlas_width + target_pixel_x;
+
+                atlas_data[target_pixel_index] = source_value;
+            }
+        }
+    }
 }
 
+
 /**
  *
  * @param {AttributeDataTexture} target

package/src/engine/graphics/sh3/lpv/serialization/LightProbeVolumeSerializationAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LightProbeVolumeSerializationAdapter.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/sh3/lpv/serialization/LightProbeVolumeSerializationAdapter.js"],"names":[],"mappings":"AAGA;IAEI,+BAAwB;IAGxB;;;;OAIG;IACH,8BAFW,gBAAgB,QAY1B;IAED;;;;OAIG;IACH,gCAFW,gBAAgB,QAc1B;CACJ;gDA3C+C,mEAAmE;iCAClF,wBAAwB"}
+{"version":3,"file":"LightProbeVolumeSerializationAdapter.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/sh3/lpv/serialization/LightProbeVolumeSerializationAdapter.js"],"names":[],"mappings":"AAGA;IAEI,+BAAwB;IAGxB;;;;OAIG;IACH,8BAFW,gBAAgB,QAiB1B;IAED;;;;OAIG;IACH,gCAFW,gBAAgB,QAiB1B;CACJ;gDAnD+C,mEAAmE;iCAClF,wBAAwB"}

package/src/engine/graphics/sh3/lpv/serialization/LightProbeVolumeSerializationAdapter.js

@@ -20,6 +20,11 @@ export class LightProbeVolumeSerializationAdapter extends BinaryClassSerializati
         // probe values
         buffer.writeFloat32Array(value.harmonics, 0, count * 27);
 
+        // depth
+        const depth_resolution = value.depth_map_resolution;
+        buffer.writeUint32(depth_resolution);
+        buffer.writeFloat32Array(value.depth, 0, depth_resolution * depth_resolution * count);
+
         value.mesh.serialize(buffer);
     }
 
@@ -38,6 +43,9 @@ export class LightProbeVolumeSerializationAdapter extends BinaryClassSerializati
         buffer.readFloat32Array(value.points, 0, count * 3);
         buffer.readFloat32Array(value.harmonics, 0, count * 27);
 
+        // depth
+        const depth_resolution = buffer.readUint32();
+        buffer.readFloat32Array(value.depth, 0, depth_resolution * depth_resolution * count);
 
         value.mesh.deserialize(buffer);
     }

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

@@ -30,9 +30,9 @@ export class BufferedGeometryBVH {
     private __triangle_count;
     /**
      *
-     * @param {THREE.BufferGeometry} geometry
+     * @param {THREE.BufferGeometry} geo
      */
-    build(geometry: THREE.BufferGeometry): void;
+    build(geo: THREE.BufferGeometry): void;
     /**
      * Tests ray for occlusion
      * Returns true if ray hits anything at all

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

@@ -1 +1 @@
-{"version":3,"file":"BufferedGeometryBVH.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/sh3/path_tracer/BufferedGeometryBVH.js"],"names":[],"mappings":"AAwBA;IAkBI;;;OAGG;IACH,eAFW,KAAK,GAAC,MAAM,EAAE,QAIxB;IAIG;;;;OAIG;IACH,mBAAsB;IAEtB;;;;OAIG;IACH,yBAA4B;IAE5B;;;;OAIG;IACH,6BAAgC;IAGhC;;;;OAIG;IACH,yBAAyB;IAG7B;;;OAGG;IACH,gBAFW,MAAM,cAAc,QAsC9B;IAED;;;;;OAKG;IACH,qBAFa,OAAO,CAkDnB;IAED;;;;;OAKG;IACH,gBAJW,MAAM,EAAE,OACR,MAAM,EAAE,OAAK,GACX,MAAM,CA2ElB;;CACJ;sBAhQqB,wCAAwC"}
+{"version":3,"file":"BufferedGeometryBVH.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/sh3/path_tracer/BufferedGeometryBVH.js"],"names":[],"mappings":"AAyBA;IAkBI;;;OAGG;IACH,eAFW,KAAK,GAAC,MAAM,EAAE,QAIxB;IAIG;;;;OAIG;IACH,mBAAsB;IAEtB;;;;OAIG;IACH,yBAA4B;IAE5B;;;;OAIG;IACH,6BAAgC;IAGhC;;;;OAIG;IACH,yBAAyB;IAG7B;;;OAGG;IACH,WAFW,MAAM,cAAc,QAwC9B;IAED;;;;;OAKG;IACH,qBAFa,OAAO,CAkDnB;IAED;;;;;OAKG;IACH,gBAJW,MAAM,EAAE,OACR,MAAM,EAAE,OAAK,GACX,MAAM,CA2ElB;;CACJ;sBAnQqB,wCAAwC"}

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

@@ -8,6 +8,7 @@ import {
     computeTriangleRayIntersectionBarycentricGeometry
 } from "../../../../core/geom/3d/triangle/computeTriangleRayIntersectionBarycentricGeometry.js";
 import Vector4 from "../../../../core/geom/Vector4.js";
+import { makeGeometryIndexed } from "../../geometry/buffered/makeGeometryIndexed.js";
 import { computeBoundingSphereFromVertexData } from "../../geometry/computeBoundingSphereFromVertexData.js";
 import { construct_ray_hit_from_geometry } from "./geometry/construct_ray_hit_from_geometry.js";
 
@@ -82,16 +83,18 @@ export class BufferedGeometryBVH {
 
     /**
      *
-     * @param {THREE.BufferGeometry} geometry
+     * @param {THREE.BufferGeometry} geo
      */
-    build(geometry) {
-        this.__geometry = geometry;
+    build(geo) {
+        makeGeometryIndexed(geo);
 
-        const index = geometry.getIndex();
+        this.__geometry = geo;
+
+        const index = geo.getIndex();
         const index_array = index.array;
 
 
-        const attribute_position = geometry.getAttribute('position');
+        const attribute_position = geo.getAttribute('position');
         const array_positions = attribute_position.array;
 
         this.__geometry_positions = array_positions;

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"populate_path_traced_scene_from_ecd.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/sh3/path_tracer/populate_path_traced_scene_from_ecd.js"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,+GAqCC"}

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

@@ -0,0 +1,50 @@
+import { assert } from "../../../../core/assert.js";
+import { Transform } from "../../../ecs/transform/Transform.js";
+import { Light } from "../../ecs/light/Light.js";
+import { LightType } from "../../ecs/light/LightType.js";
+import { ShadedGeometry } from "../../ecs/mesh-v2/ShadedGeometry.js";
+import { DirectionalLight } from "../../render/forward_plus/model/DirectionalLight.js";
+
+/**
+ *
+ * @param {EntityComponentDataset} ecd
+ * @param {PathTracedScene} scene
+ */
+export function populate_path_traced_scene_from_ecd(ecd, scene) {
+    assert.defined(ecd, 'ecd');
+    assert.defined(scene, 'scene');
+
+    ecd.traverseEntities([ShadedGeometry, Transform],
+        /**
+         *
+         * @param {ShadedGeometry} sg
+         * @param {Transform} transform
+         */
+        (sg, transform) => {
+
+            scene.createMesh(sg.geometry, sg.material, transform.matrix)
+
+        });
+
+
+    ecd.traverseEntities([Light, Transform],
+        /**
+         *
+         * @param {Light} light
+         * @param {Transform} transform
+         */
+        (light, transform) => {
+
+            if (light.type.getValue() === LightType.DIRECTION) {
+
+                const l = new DirectionalLight();
+
+                l.color.copy(light.color);
+                l.direction.copy(transform.forward);
+                l.intensity.copy(light.intensity);
+
+                scene.addLight(l);
+            }
+
+        });
+}

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

@@ -67,8 +67,8 @@ vCanvas.css({
  * How many rays to use per-pixel
  * @type {number}
  */
-const PIXEL_SAMPLE_COUNT = 256;
-const PIXEL_RENDER_RATIO = 1;
+const PIXEL_SAMPLE_COUNT = 1;
+const PIXEL_RENDER_RATIO = 0.5;
 
 const scene = new PathTracedScene();
 const pt = new PathTracer();
@@ -201,6 +201,42 @@ async function prepare_gi_box_scene(scene, camera) {
 
 }
 
+/**
+ *
+ * @param {PathTracedScene} scene
+ * @param {THREE.Camera} camera
+ * @returns {Promise<void>}
+ */
+async function prepare_attic_scene(scene, camera) {
+    const path = 'data/models/samples/the_attic_environment/scene1.gltf';
+    await prepare_scene_gltf({
+        scene: scene,
+        camera: camera,
+        url: path,
+        sun: {
+            direction: new Vector3(1.2, -1, 0.2)
+        }
+    });
+
+    const transform = Transform.fromJSON({
+        "position": {
+            "x": -11.027168212431539,
+            "y": 1.0396201881596159,
+            "z": -2.9677969519799223
+        },
+        "rotation": {
+            "x": 0.024907147178871554,
+            "y": -0.08487115365830479,
+            "z": 0.0021222209892540838,
+            "w": 0.9960783189459508
+        },
+        "scale": { "x": 1, "y": 1, "z": 1 }
+    });
+
+    set_camera_from_transform(camera, transform);
+
+}
+
 /**
  *
  * @param {PathTracedScene} scene
@@ -505,8 +541,9 @@ async function start_renderer(camera) {
     // await prepare_scene_lucy(scene, 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_attic_scene(scene, camera);
     // await prepare_scene_gltf({scene, camera, path, url: path});
 
 

package/src/engine/graphics/sh3/path_tracer/sorting/build_bvh_nodes_distances_along_ray.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build_bvh_nodes_distances_along_ray.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/sh3/path_tracer/sorting/build_bvh_nodes_distances_along_ray.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;;GAYG;AACH,4DAXW,MAAM,EAAE,iBACR,MAAM,uBAEN,MAAM,EAAE,oBACR,MAAM,kBACN,MAAM,kBACN,MAAM,kBACN,MAAM,kBACN,MAAM,gBACN,MAAM,QA4BhB"}

package/src/engine/graphics/sh3/path_tracer/{build_bvh_nodes_distances_along_ray.js → sorting/build_bvh_nodes_distances_along_ray.js}

@@ -1,7 +1,7 @@
-import { ELEMENT_WORD_COUNT } from "../../../../core/bvh2/bvh3/BVH.js";
+import { ELEMENT_WORD_COUNT } from "../../../../../core/bvh2/bvh3/BVH.js";
 import {
     aabb3_compute_distance_above_plane_min
-} from "../../../../core/geom/3d/aabb/aabb3_compute_distance_above_plane_min.js";
+} from "../../../../../core/geom/3d/aabb/aabb3_compute_distance_above_plane_min.js";
 
 /**
  *

package/src/engine/graphics/sh3/path_tracer/sorting/build_bvh_nodes_distances_sqr_to_point.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build_bvh_nodes_distances_sqr_to_point.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/sh3/path_tracer/sorting/build_bvh_nodes_distances_sqr_to_point.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;GAWG;AACH,+DAVW,MAAM,EAAE,iBACR,MAAM,uBAEN,MAAM,EAAE,oBACR,MAAM,kBACN,MAAM,KACN,MAAM,KACN,MAAM,KACN,MAAM,QA2BhB"}

package/src/engine/graphics/sh3/path_tracer/{build_bvh_nodes_distances_sqr_to_point.js → sorting/build_bvh_nodes_distances_sqr_to_point.js}

@@ -1,7 +1,7 @@
-import { ELEMENT_WORD_COUNT } from "../../../../core/bvh2/bvh3/BVH.js";
+import { ELEMENT_WORD_COUNT } from "../../../../../core/bvh2/bvh3/BVH.js";
 import {
     aabb3_unsigned_distance_sqr_to_point
-} from "../../../../core/geom/3d/aabb/aabb3_unsigned_distance_sqr_to_point.js";
+} from "../../../../../core/geom/3d/aabb/aabb3_unsigned_distance_sqr_to_point.js";
 
 /**
  *

package/src/engine/graphics/sh3/path_tracer/sorting/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/sorting/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 → sorting/sort_bvh_nodes_by_distance_to_point.js}

@@ -1,8 +1,8 @@
-import { ELEMENT_WORD_COUNT } from "../../../../core/bvh2/bvh3/BVH.js";
-import { arrayQuickSort } from "../../../../core/collection/array/arrayQuickSort.js";
+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";
+} from "../../../../../core/geom/3d/aabb/aabb3_unsigned_distance_sqr_to_point.js";
 
 /**
  *

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

@@ -52,6 +52,8 @@ import { three_object_to_entity_composition } from "../ecs/mesh-v2/three_object_
 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 { OctahedralDepthDebuggerWidget } from "./lpv/depth/octahedral/OctahedralDepthDebuggerWidget.js";
+import { VLPDepthMapVisualisation } from "./lpv/depth/octahedral/v2/VLPDepthMapVisualisation.js";
 import { LightProbeVolume } from "./lpv/LightProbeVolume.js";
 import { LightProbeVolumeSerializationAdapter } from "./lpv/serialization/LightProbeVolumeSerializationAdapter.js";
 
@@ -218,7 +220,7 @@ async function getVolume({
     const adapter = new LightProbeVolumeSerializationAdapter();
 
     if (await engine.storage.promiseContains(key)
-        && false // TODO re-enable
+        // && false // TODO re-enable
     ) {
         const data = await engine.storage.promiseLoadBinary(key);
 
@@ -360,26 +362,26 @@ async function main(engine) {
 
 
     // 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/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/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/Scans/green_car_wreck/scene.gltf';
+    // const path = 'data/models/samples/low_poly_classroom/no-glass/model.gltf';
     // const path = 'data/models/samples/the_attic_environment/scene1.gltf';
+    // const path = 'data/models/LowPolyTownshipSet/Small_house/Small_house.gltf';
     // const path = 'data/models/samples/cyberpunk_bike/scene.gltf';
-    const path = 'data/models/sponza-pbr/gltf/sponza.glb';
+    // const path = 'data/models/LowPolyTownshipSet/Town_Hall/model.gltf';
+    // const path = 'data/models/sibenik/3-window-less/model.gltf';
     // 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 path = 'data/models/samples/low_poly_classroom/no-glass/model.gltf';
+    // const path = 'data/models/sponza-pbr/gltf/sponza.glb';
+    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;
@@ -498,6 +500,8 @@ async function main(engine) {
         opacity: 0.5
     });
 
+    const depth_viz = VLPDepthMapVisualisation.from(volume).build();
+
     // volume.visualize_mesh({ ecd, opacity: 0.5 });
 
     const gui = new GUI();
@@ -536,12 +540,41 @@ async function main(engine) {
         }
     }, "mesh_vis").name("Visualise Mesh");
 
+    gui.add({
+        get depth_vis() {
+            return depth_viz.isBuilt
+        },
+        set depth_vis(v) {
+            if (v) {
+                depth_viz.build(ecd);
+            } else {
+                depth_viz.destroy();
+            }
+        }
+    }, "depth_vis").name("Visualise Depth");
+
+    // makeDebugGizmo(engine, mesh_bounds.getCenter());
+
 
     // mesh_entity.addEventListener(SGMeshEvents.AssetLoaded, build);
     //
     // mesh_entity.build(ecd);
 }
 
+/**
+ *
+ * @param {Engine} engine
+ * @param {Vector3} position
+ */
+function makeDebugGizmo(engine, position) {
+
+    const widget = new OctahedralDepthDebuggerWidget();
+
+    widget.entity.getComponentSafe(Transform).position.copy(position);
+
+    widget.build(engine.entityManager.dataset, engine);
+}
+
 new EngineHarness().initialize({
     configuration(config, engine) {
         config.addSystem(new ShadedGeometrySystem(engine));

package/src/engine/graphics/sh3/shader/SH3VisualisationMaterial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SH3VisualisationMaterial.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/sh3/shader/SH3VisualisationMaterial.js"],"names":[],"mappings":"AAIA;IAEI,cAoBC;CAEJ;+BA5BuC,OAAO"}

package/src/engine/graphics/sh3/shader/SH3VisualisationMaterial.js

@@ -0,0 +1,29 @@
+import { ShaderMaterial, Vector3 } from "three";
+import shader_fg from './visualize.frag.glsl';
+import shader_vx from './visualize.vert.glsl';
+
+export class SH3VisualisationMaterial extends ShaderMaterial {
+
+    constructor() {
+        const sh = [];
+
+        for (let i = 0; i < 9; i++) {
+            sh.push(new Vector3());
+        }
+
+        super({
+            fragmentShader: shader_fg,
+            vertexShader: shader_vx,
+            lights: false,
+            uniforms: {
+                intensity: {
+                    value: 1,
+                },
+                sh: {
+                    value: sh
+                }
+            }
+        })
+    }
+
+}

package/src/engine/graphics/sh3/shader/visualize.frag.glsl

@@ -0,0 +1,41 @@
+#define RECIPROCAL_PI 0.318309886
+
+vec3 inverseTransformDirection( in vec3 normal, in mat4 matrix ) {
+    // matrix is assumed to be orthogonal
+    return normalize( ( vec4( normal, 0.0 ) * matrix ).xyz );
+}
+
+// source: https://graphics.stanford.edu/papers/envmap/envmap.pdf
+vec3 shGetIrradianceAt( in vec3 normal, in vec3 shCoefficients[ 9 ] ) {
+    // normal is assumed to have unit length
+    float x = normal.x, y = normal.y, z = normal.z;
+
+    // band 0
+    vec3 result = shCoefficients[ 0 ] * 0.8862269254527579;
+
+    // band 1
+    result -= shCoefficients[ 1 ] * 1.0233267079464885 * y;
+    result += shCoefficients[ 2 ] * 1.0233267079464885 * z;
+    result -= shCoefficients[ 3 ] * 1.0233267079464885 * x;
+
+    // band 2
+    result += shCoefficients[ 4 ] * 0.8580855308097834 * x * y;
+    result -= shCoefficients[ 5 ] * 0.8580855308097834 * y * z;
+    result += shCoefficients[ 6 ] * ( 0.7431238683011272 * z * z - 0.24770795610037571 );
+    result -= shCoefficients[ 7 ] * 0.8580855308097834 * x * z;
+    result += shCoefficients[ 8 ] * 0.4290427654048917 * ( x * x - y * y );
+
+    return result;
+}
+
+uniform vec3 sh[ 9 ]; // sh coefficients
+uniform float intensity; // light probe intensity
+varying vec3 vNormal;
+
+void main() {
+    vec3 normal = normalize( vNormal );
+    vec3 worldNormal = normalize(inverseTransformDirection( normal, viewMatrix ));
+    vec3 irradiance = shGetIrradianceAt( worldNormal, sh );
+    vec3 outgoingLight = 1.0  * irradiance * intensity;
+    gl_FragColor = linearToOutputTexel( vec4( outgoingLight, 1.0 ) );
+}

package/src/engine/graphics/sh3/shader/visualize.vert.glsl

@@ -0,0 +1,9 @@
+varying vec3 vNormal;
+
+void main() {
+
+    vNormal = normalize( normalMatrix * normal );
+
+    gl_Position = projectionMatrix * modelViewMatrix * vec4( position, 1.0 );
+
+}

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

@@ -3,7 +3,7 @@ import Entity from "../../ecs/Entity.js";
 import { Transform } from "../../ecs/transform/Transform.js";
 import { ShadedGeometry } from "../ecs/mesh-v2/ShadedGeometry.js";
 import { ShadedGeometryFlags } from "../ecs/mesh-v2/ShadedGeometryFlags.js";
-import { SH3VisualisationMaterial } from "./SH3VisualisationMaterial.js";
+import { SH3VisualisationMaterial } from "./shader/SH3VisualisationMaterial.js";
 
 const geometry = new OctahedronBufferGeometry(1, 5);
 

package/src/engine/graphics/texture/debug_preview_texture.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Useful tool for previewing textures
+ * @param {THREE.Texture} texture
+ * @param {number} resolution
+ * @param {boolean} flipY
+ */
+export function debug_preview_texture({ texture, resolution, flipY }: THREE.Texture): void;
+//# sourceMappingURL=debug_preview_texture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"debug_preview_texture.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics/texture/debug_preview_texture.js"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,sEAJW,MAAM,OAAO,QA+BvB"}