@woosh/meep-engine 2.106.1 → 2.108.0

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

@@ -12,23 +12,21 @@ import '../../../../../../../css/game.scss';
 import { BinaryBuffer } from "../../../core/binary/BinaryBuffer.js";
 import { array_copy } from "../../../core/collection/array/array_copy.js";
 import { is_typed_array_equals } from "../../../core/collection/array/typed/is_typed_array_equals.js";
-import { AABB3 } from "../../../core/geom/3d/aabb/AABB3.js";
-import { make_justified_point_grid } from "../../../core/geom/3d/util/make_justified_point_grid.js";
-import Vector2 from "../../../core/geom/Vector2.js";
+import { Color } from "../../../core/color/Color.js";
 import Vector3 from "../../../core/geom/Vector3.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";
 import { delay } from "../../../core/process/delay.js";
+import ButtonView from "../../../view/elements/button/ButtonView.js";
 import { GLTFAssetLoader } from "../../asset/loaders/GLTFAssetLoader.js";
 import Entity from "../../ecs/Entity.js";
 import GUIElement from "../../ecs/gui/GUIElement.js";
 import GUIElementSystem from "../../ecs/gui/GUIElementSystem.js";
-import ViewportPosition from "../../ecs/gui/position/ViewportPosition.js";
 import ViewportPositionSystem from "../../ecs/gui/position/ViewportPositionSystem.js";
 import { TransformAttachmentSystem } from "../../ecs/transform-attachment/TransformAttachmentSystem.js";
 import { Transform } from "../../ecs/transform/Transform.js";
 import { EngineHarness } from "../../EngineHarness.js";
-import { makeSimpleTaskProgressView } from "../../makeSimpleTaskProgressView.js";
 import { Light } from "../ecs/light/Light.js";
 import LightSystem from "../ecs/light/LightSystem.js";
 import { LightType } from "../ecs/light/LightType.js";
@@ -39,7 +37,10 @@ import { ShadedGeometryFlags } from "../ecs/mesh-v2/ShadedGeometryFlags.js";
 import { ShadedGeometrySystem } from "../ecs/mesh-v2/ShadedGeometrySystem.js";
 import { three_object_to_entity_composition } from "../ecs/mesh-v2/three_object_to_entity_composition.js";
 import { GizmoRenderingPlugin } from "../render/gizmo/GizmoRenderingPlugin.js";
-import { LightProbeVolume } from "./LightProbeVolume.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 { probe_volume_to_textures } from "./lpv/probe_volume_to_textures.js";
 
 /**
  *
@@ -146,12 +147,14 @@ function make_cornel_box(ecd) {
         direction: Vector3.forward,
         material: new MeshBasicMaterial({ color: 0xFF0000 })
     }).build(ecd);
+
     make_plane({
         scale: 20,
-        offset: new Vector3(10, 10, 20),
+        offset: new Vector3(20, 10, 10),
         direction: Vector3.left,
         material: new MeshBasicMaterial({ color: 0x00FF00 })
     }).build(ecd);
+
     make_plane({
         scale: 20,
         offset: new Vector3(0, 10, 10),
@@ -185,113 +188,50 @@ function make_test_texture(t = 1) {
 /**
  *
  * @param {Engine} engine
- * @param {EntityComponentDataset} ecd
- * @param {AABB3} bounds
+ * @param {string} path
+ * @return {Promise<LightProbeVolume>}
  */
-async function build_probes(engine, ecd, bounds) {
-
-    const lpv = new LightProbeVolume();
+async function getVolume({ engine, path }) {
 
-    // lpv.add_point(10, 5, 10);
+    const key = `lpv:${path}`;
 
-    const desired_density = 10;
+    const adapter = new LightProbeVolumeSerializationAdapter();
 
+    if (await engine.storage.promiseContains(key)) {
+        const volume = new LightProbeVolume();
 
-    // const light_volume_bounds = new AABB3(-10, 0.5, -10, 10, 11, 10);
-    const probe_grid_spacing_dense = Math.min(bounds.getExtentsX(), bounds.getExtentsY(), bounds.getExtentsZ()) / desired_density;
-    const probe_grid_spacing_sparse = Math.max(bounds.getExtentsX(), bounds.getExtentsY(), bounds.getExtentsZ()) / desired_density;
-
-    const probe_grid_spacing = (probe_grid_spacing_sparse / probe_grid_spacing_dense) < 2 ? probe_grid_spacing_dense : probe_grid_spacing_sparse * 0.5;
-    //
-    // const probe_grid_spacing =desired_density/ (mesh_asset.boundingBox.getExtentsX()* mesh_asset.boundingBox.getExtentsY()* mesh_asset.boundingBox.getExtentsZ());
-
-    const model_bounds = new AABB3(-10, 0.5, -10, 10, 11, 10);
-    model_bounds.copy(bounds);
-    // model_bounds._translate(composition.transform.position.x, composition.transform.position.y, composition.transform.position.z);
-    model_bounds.grow(probe_grid_spacing * 1.1);
+        const data = await engine.storage.promiseLoadBinary(key);
 
+        console.log(`LPV data size ${number_pretty_print(data.byteLength)} bytes`);
 
-    // sg_hierarchy_compute_bounding_box_via_parent_entity(light_volume_bounds, composition.entity.entity, ecd);
+        const buffer = BinaryBuffer.fromArrayBuffer(data);
 
-    // for (let i = 0; i < 100; i++) {
-    //     lpv.add_point(
-    //         randomFloatBetween(random, light_volume_bounds.x0, light_volume_bounds.x1),
-    //         randomFloatBetween(random,  light_volume_bounds.y0, light_volume_bounds.y1),
-    //         randomFloatBetween(random,  light_volume_bounds.z0, light_volume_bounds.z1),
-    //     );
-    // }
+        adapter.deserialize(buffer, volume);
 
-    make_justified_point_grid(model_bounds, probe_grid_spacing, (x, y, z) => {
-        lpv.add_point(x, y, z);
-    });
-
-    // lpv.add_point(10, 1, -10);
+        return volume;
+    }
 
-    await delay(2000);
+    const mesh_asset = await engine.assetManager.promise(path, 'model/gltf+json');
+    const mesh_bounds = mesh_asset.boundingBox;
 
-    //
-    // console.profile('lpv build');
-    //
-    const task = lpv.build(engine);
-    // console.profileEnd('lpv build');
+    const ecd = engine.entityManager.dataset;
 
-    const progress = makeSimpleTaskProgressView({
-        task,
-        localization: engine.localization,
-        size: new Vector2(512, 64)
+    const volume = await build_probes_for_scene({
+        engine,
+        ecd,
+        bounds: mesh_bounds,
+        density: 10000
     });
 
-    const progress_entity = new Entity();
-    progress_entity
-        .add(GUIElement.fromView(progress))
-        .add(ViewportPosition.fromJSON({
-            position: new Vector2(0, 1),
-            anchor: new Vector2(0, 1),
-            offset: new Vector2(16, -16)
-        }))
-        .build(ecd);
-
-    task.promise().finally(() => progress_entity.destroy())
-
-    engine.executor.runGroup(task);
-
-    // fill probes with random data
-    // for (let i = 0; i < lpv.__length * 27; i++) {
-    //     lpv.__probe_data[i] = random();
-    // }
-
-    // for (let i = 0; i < lpv.__length; i++) {
-    //
-    //     for (let j = 0; j < 9; j++) {
-    //         lpv.__probe_data[(i * 9 + j) * 3] = max2(0, (lpv.__positions[i * 3] + 10) / 20);
-    //         lpv.__probe_data[(i * 9 + j) * 3 + 1] = max2(0, (lpv.__positions[i * 3 + 1] - 0.5) / 10.5);
-    //         lpv.__probe_data[(i * 9 + j) * 3 + 2] = max2(0, (lpv.__positions[i * 3 + 2] + 10) / 20);
-    //     }
-    // }
-
-    // lpv.white_probe(0, [
-    //     0.7953949, 0.4405923, 0.5459412,
-    //     0.3981450, 0.3526911, 0.6097158,
-    //     -0.3424573, -0.1838151, -0.2715583,
-    //
-    //     -0.2944621, -0.0560606, 0.0095193,
-    //     -0.1123051, -0.0513088, -0.1232869,
-    //     -0.2645007, -0.2257996, -0.4785847,
-    //
-    //     -0.1569444, -0.0954703, -0.1485053,
-    //     0.5646247, 0.2161586, 0.1402643,
-    //     0.2137442, -0.0547578, -0.3061700], 0);
-
-
-    // lpv.visualize_mesh({ ecd: ecd });
+    const buffer = new BinaryBuffer();
 
-    task.promise().then(() => {
+    adapter.serialize(buffer, volume);
 
-        lpv.visualize_probes({ ecd: ecd, size: probe_grid_spacing * 0.08 });
+    buffer.trim();
 
-    })
+    engine.storage.promiseStoreBinary(key, buffer.data)
 
-    console.log(lpv);
+    return volume;
 }
 
 /**
@@ -304,8 +244,8 @@ async function main(engine) {
         engine,
         enableWater: false,
         enableTerrain: false,
-        // enableLights: false,
-        enableLights: true,
+        enableLights: false,
+        // enableLights: true,
         cameraFarDistance: 200,
         focus: { x: 0, y: 0, z: 0 },
         pitch: 1,
@@ -314,6 +254,15 @@ async function main(engine) {
         // shadowmapResolution: 4096
     });
 
+    await EngineHarness.buildLights({
+        engine,
+        shadowmapResolution: 4096,
+        ambientIntensity: 0.03,
+        sun: Color.white,
+        sunIntensity: 17,
+        sunDirection: new Vector3(0.5, -1, 0.3)
+    })
+
     engine.graphics.getRenderer().setClearColor('#1e3441', 1);
 
     // load_and_set_cubemap_v0(engine.graphics, 'data/textures/cubemaps/hip_miramar/32/', '.png');
@@ -323,14 +272,17 @@ async function main(engine) {
 
     // 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/sponza-pbr/gltf/sponza.glb';
+    // const path = 'data/models/sibenik/3-window-less/model.gltf';
+    // const path = 'data/models/vokselia_spawn/model.gltf';
+    const path = 'data/models/sponza-pbr/gltf/sponza.glb';
     // const path = 'data/models/LowPolyTownshipSet/Town_Hall/model.gltf';
     // const path = 'data/models/Slaughter Mech/Slaugter Mech.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;
 
+    // make_cornel_box(ecd);
 
     const mesh_entity = new Entity();
     mesh_entity
@@ -349,103 +301,21 @@ async function main(engine) {
         const sg = n.entity.getComponent(ShadedGeometry);
 
         if (sg !== null) {
-            sg.writeFlag(ShadedGeometryFlags.CastShadow, false);
-            sg.writeFlag(ShadedGeometryFlags.ReceiveShadow, false);
+            sg.writeFlag(ShadedGeometryFlags.CastShadow, true);
+            sg.writeFlag(ShadedGeometryFlags.ReceiveShadow, true);
         }
     });
 
-
-    // model_bounds.setNegativelyInfiniteBounds();
-    // composition.traverse((n) => {
-    //
-    //     /**
-    //      * @type {ShadedGeometry}
-    //      */
-    //     const sg = n.entity.getComponent(ShadedGeometry);
-    //
-    //     if (sg !== null) {
-    //         const aabb3 = new AABB3();
-    //         sg.getBoundingBox(aabb3);
-    //
-    //         model_bounds.expandToFit(aabb3);
-    //     }
-    // })
-
     composition.transform.scale.setScalar(1);
-    // composition.transform.position.set(0, -mesh_asset.boundingBox.y0, 0);
 
     composition.build(ecd);
 
-    const model_footprint = Math.hypot(mesh_asset.boundingBox.getExtentsX(), mesh_asset.boundingBox.getExtentsY(), mesh_asset.boundingBox.getExtentsZ());
 
+    const mesh_bounds = mesh_asset.boundingBox;
+    // const mesh_bounds = new AABB3(0, 0, 0, 20, 20, 20);
 
-    // make_plane({
-    //     engine,
-    //     scale: 2 * model_footprint,
-    //     offset: new Vector3(0, 0, 0),
-    //     direction: Vector3.up,
-    //     up: Vector3.forward,
-    //     material: new MeshStandardMaterial({
-    //         color: 0x111111,
-    //         map: make_test_texture(),
-    //     }),
-    //     shadow: true,
-    // }).build(ecd);
+    const model_footprint = Math.hypot(mesh_bounds.getExtentsX(), mesh_bounds.getExtentsY(), mesh_bounds.getExtentsZ());
 
-    //
-    // make_plane({
-    //     scale: 3 * model_footprint,
-    //     offset: new Vector3(0, mesh_asset.boundingBox.y1 + 2, 0),
-    //     direction: Vector3.down,
-    //     up: Vector3.forward,
-    //     shadow: false,
-    //     material: new MeshStandardMaterial({ color: '#c6f5ff' })
-    // }).build(ecd);
-
-    const points = [
-        0, 0, 0,
-        10, 0, 0,
-        10, 0, 10,
-        0, 0, 10,
-
-        0, 10, 0,
-        10, 10, 0,
-        10, 10, 10,
-        0, 10, 10,
-    ];
-
-    //
-    // new Entity()
-    //     .add(Transform.fromJSON({
-    //         position: {
-    //             x: mesh_asset.boundingBox.x0,
-    //             y: mesh_asset.boundingBox.getCenterY(),
-    //             z: mesh_asset.boundingBox.getCenterZ()
-    //         }
-    //     }))
-    //     .add(Light.fromJSON({
-    //         distance: model_footprint * 2,
-    //         type: LightType.POINT,
-    //         intensity: 10,
-    //         color: 0xFF0000
-    //     }))
-    //     .build(ecd);
-    //
-    // new Entity()
-    //     .add(Transform.fromJSON({
-    //         position: {
-    //             x: mesh_asset.boundingBox.x1,
-    //             y: mesh_asset.boundingBox.getCenterY(),
-    //             z: mesh_asset.boundingBox.getCenterZ()
-    //         }
-    //     }))
-    //     .add(Light.fromJSON({
-    //         distance: model_footprint * 2,
-    //         type: LightType.POINT,
-    //         intensity: 10,
-    //         color: '#00f7ff'
-    //     }))
-    //     .build(ecd);
 
     const random = seededRandom();
 
@@ -454,9 +324,9 @@ async function main(engine) {
         new Entity()
             .add(Transform.fromJSON({
                 position: {
-                    x: randomFloatBetween(random, mesh_asset.boundingBox.x0, mesh_asset.boundingBox.x1),
-                    y: randomFloatBetween(random, mesh_asset.boundingBox.y0, mesh_asset.boundingBox.y1),
-                    z: randomFloatBetween(random, mesh_asset.boundingBox.z0, mesh_asset.boundingBox.z1),
+                    x: randomFloatBetween(random, mesh_bounds.x0, mesh_bounds.x1),
+                    y: randomFloatBetween(random, mesh_bounds.y0, mesh_bounds.y1),
+                    z: randomFloatBetween(random, mesh_bounds.z0, mesh_bounds.z1),
                 }
             }))
             .add(Light.fromJSON({
@@ -468,12 +338,34 @@ async function main(engine) {
             .build(ecd);
     }
 
-    function build() {
+    new Entity()
+        .add(GUIElement.fromView(new ButtonView({
+            name: "Toggle Model",
+            action() {
+                composition.isBuilt ? composition.destroy() : composition.build(ecd)
+            }
+        })))
+        .build(ecd);
 
-        build_probes(engine, ecd, mesh_asset.boundingBox);
-    }
+    await delay(200);
+
+    console.time('getVolume');
+    // console.profile('getVolume');
+    const volume = await getVolume({ engine, path });
+    // console.profileEnd('getVolume');
+    console.timeEnd('getVolume');
+
+    console.log('LPV:', volume);
+
+
+    volume.visualize_probes({ ecd, size: model_footprint * 0.002 });
+    // volume.visualize_mesh({ ecd , opacity: 0.2});
+
+    console.time('prepareTextures');
+    const textures = probe_volume_to_textures(volume);
+    console.timeEnd('prepareTextures');
 
-    build();
+    console.log(textures);
 
     // mesh_entity.addEventListener(SGMeshEvents.AssetLoaded, build);
     //
@@ -485,7 +377,7 @@ new EngineHarness().initialize({
         config.addSystem(new ShadedGeometrySystem(engine));
         config.addSystem(new TransformAttachmentSystem());
         config.addSystem(new LightSystem(engine, {
-            shadowResolution: 2048
+            shadowResolution: 8192
         }));
         config.addSystem(new SGMeshSystem(engine));
         config.addSystem(new GUIElementSystem(engine.gui.view, engine));

package/src/engine/graphics/sh3/sky/hosek/sky_hosek_compute_irradiance_by_direction.d.ts

@@ -11,14 +11,14 @@
 export function sky_hosek_precompute(mCoeffsXYZ: number[], mRadXYZ: number[], sun_direction: vec3, turbidity: number, rgbAlbedo: vec3, overcast: number): void;
 /**
  *
- * @param {number[]} out vec3 in RGB color space
- * @param {number[]} mCoeffsXYZ float[3][9]
- * @param {number[]} mRadXYZ vec3
- * @param {number[]} mToSun vec3
+ * @param {number[]|Float32Array} out vec3 in RGB color space
+ * @param {number[]|Float32Array} mCoeffsXYZ float[3][9]
+ * @param {number[]|Float32Array} mRadXYZ vec3
+ * @param {number[]|Float32Array} mToSun vec3
  * @param {number} direction_x
  * @param {number} direction_y
  * @param {number} direction_z
  */
-export function sky_hosek_compute_irradiance_by_direction(out: number[], mCoeffsXYZ: number[], mRadXYZ: number[], mToSun: number[], direction_x: number, direction_y: number, direction_z: number): void;
+export function sky_hosek_compute_irradiance_by_direction(out: number[] | Float32Array, mCoeffsXYZ: number[] | Float32Array, mRadXYZ: number[] | Float32Array, mToSun: number[] | Float32Array, direction_x: number, direction_y: number, direction_z: number): void;
 import { vec3 } from "gl-matrix";
 //# sourceMappingURL=sky_hosek_compute_irradiance_by_direction.d.ts.map

package/src/engine/graphics/sh3/sky/hosek/sky_hosek_compute_irradiance_by_direction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sky_hosek_compute_irradiance_by_direction.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/sh3/sky/hosek/sky_hosek_compute_irradiance_by_direction.js"],"names":[],"mappings":";AA+NA;;;;;;;;GAQG;AACH,iDAPW,MAAM,EAAE,WACR,MAAM,EAAE,iBACR,IAAI,aACJ,MAAM,aACN,IAAI,YACJ,MAAM,QA4HhB;AAGD;;;;;;;;;GASG;AACH,+DARW,MAAM,EAAE,cACR,MAAM,EAAE,WACR,MAAM,EAAE,UACR,MAAM,EAAE,eACR,MAAM,eACN,MAAM,eACN,MAAM,QA6BhB;qBAvYoB,WAAW"}
+{"version":3,"file":"sky_hosek_compute_irradiance_by_direction.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/sh3/sky/hosek/sky_hosek_compute_irradiance_by_direction.js"],"names":[],"mappings":";AA+NA;;;;;;;;GAQG;AACH,iDAPW,MAAM,EAAE,WACR,MAAM,EAAE,iBACR,IAAI,aACJ,MAAM,aACN,IAAI,YACJ,MAAM,QA4HhB;AAGD;;;;;;;;;GASG;AACH,+DARW,MAAM,EAAE,GAAC,YAAY,cACrB,MAAM,EAAE,GAAC,YAAY,WACrB,MAAM,EAAE,GAAC,YAAY,UACrB,MAAM,EAAE,GAAC,YAAY,eACrB,MAAM,eACN,MAAM,eACN,MAAM,QA6BhB;qBAxYoB,WAAW"}

package/src/engine/graphics/sh3/sky/hosek/sky_hosek_compute_irradiance_by_direction.js

@@ -1,13 +1,13 @@
 // --- Mathematical constants -------------------------------------------------
 
-import { clamp } from "../../../../../core/math/clamp.js";
 import { vec3 } from "gl-matrix";
+import { rgb_to_xyz } from "../../../../../core/color/xyz/rgb_to_xyz.js";
+import { xyz_to_rgb } from "../../../../../core/color/xyz/xyz_to_rgb.js";
+import { v3_dot } from "../../../../../core/geom/vec3/v3_dot.js";
+import { clamp } from "../../../../../core/math/clamp.js";
 import { clamp01 } from "../../../../../core/math/clamp01.js";
 import { lerp } from "../../../../../core/math/lerp.js";
-import { v3_dot } from "../../../../../core/geom/vec3/v3_dot.js";
 import { kHosekCoeffsX, kHosekCoeffsY, kHosekCoeffsZ, kHosekRadX, kHosekRadY, kHosekRadZ } from "./data.js";
-import { xyz_to_rgb } from "../../../../../core/color/xyz/xyz_to_rgb.js";
-import { rgb_to_xyz } from "../../../../../core/color/xyz/rgb_to_xyz.js";
 
 const vl_pi = (3.14159265358979323846);
 const vl_halfPi = (vl_pi / 2.0);
@@ -357,10 +357,10 @@ export function sky_hosek_precompute(
 
 /**
  *
- * @param {number[]} out vec3 in RGB color space
- * @param {number[]} mCoeffsXYZ float[3][9]
- * @param {number[]} mRadXYZ vec3
- * @param {number[]} mToSun vec3
+ * @param {number[]|Float32Array} out vec3 in RGB color space
+ * @param {number[]|Float32Array} mCoeffsXYZ float[3][9]
+ * @param {number[]|Float32Array} mRadXYZ vec3
+ * @param {number[]|Float32Array} mToSun vec3
  * @param {number} direction_x
  * @param {number} direction_y
  * @param {number} direction_z

package/src/engine/graphics/sh3/visualise_spherical_harmonic_sphere.d.ts

@@ -0,0 +1,13 @@
+/**
+ *
+ * @param {number} [size]
+ * @param {boolean} [shadow]
+ * @param position
+ * @param [position_offset]
+ * @param sh
+ * @param [sh_offset]
+ * @return {Entity}
+ */
+export function visualise_spherical_harmonic_sphere({ size, shadow, position, position_offset, sh, sh_offset }?: number): Entity;
+import Entity from "../../ecs/Entity.js";
+//# sourceMappingURL=visualise_spherical_harmonic_sphere.d.ts.map

package/src/engine/graphics/sh3/visualise_spherical_harmonic_sphere.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visualise_spherical_harmonic_sphere.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics/sh3/visualise_spherical_harmonic_sphere.js"],"names":[],"mappings":"AASA;;;;;;;;;GASG;AACH,iHARW,MAAM,GAML,MAAM,CAoCjB;mBApDkB,qBAAqB"}

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

@@ -0,0 +1,54 @@
+import { OctahedronBufferGeometry } from "three";
+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";
+
+const geometry = new OctahedronBufferGeometry(1, 5);
+
+/**
+ *
+ * @param {number} [size]
+ * @param {boolean} [shadow]
+ * @param position
+ * @param [position_offset]
+ * @param sh
+ * @param [sh_offset]
+ * @return {Entity}
+ */
+export function visualise_spherical_harmonic_sphere({
+                                                        size = 1,
+                                                        shadow = false,
+                                                        position,
+                                                        position_offset = 0,
+                                                        sh,
+                                                        sh_offset = 0
+                                                    }) {
+
+    const mat = new SH3VisualisationMaterial();
+
+    const uniform_value = mat.uniforms.sh.value;
+    for (let i = 0; i < 9; i++) {
+        uniform_value[i].fromArray(sh, sh_offset + i * 3);
+    }
+
+    const shadedGeometry = ShadedGeometry.from(geometry, mat);
+
+    // prevent instanced rendering
+    shadedGeometry.setFlag(ShadedGeometryFlags.DrawMethodLocked);
+
+    shadedGeometry.writeFlag(ShadedGeometryFlags.ReceiveShadow, shadow);
+    shadedGeometry.writeFlag(ShadedGeometryFlags.CastShadow, shadow);
+
+    return new Entity()
+        .add(Transform.fromJSON({
+            position: {
+                x: position[position_offset],
+                y: position[position_offset + 1],
+                z: position[position_offset + 2],
+            },
+            scale: size
+        }))
+        .add(shadedGeometry);
+}

package/src/engine/graphics/shaders/AlphaBlendShader.js

@@ -1,6 +1,4 @@
-/**
- * Created by Alex on 20/09/2015.
- */
+
 const AlphaBlendShader = {
 
     uniforms: {

package/src/engine/graphics/shaders/AmbientOcclusionShader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AmbientOcclusionShader.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics/shaders/AmbientOcclusionShader.js"],"names":[],"mappings":";AAKA;;;;;;;;;;;;;;;;;;;;;;;;;EA4HC;wBA9HuB,OAAO"}
+{"version":3,"file":"AmbientOcclusionShader.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics/shaders/AmbientOcclusionShader.js"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;;EA4HC;wBA9HuB,OAAO"}

package/src/engine/graphics/shaders/AmbientOcclusionShader.js

@@ -1,6 +1,3 @@
-/**
- * Created by Alex on 10/11/2014.
- */
 import { Vector2 } from "three";
 
 const AmbientOcclusionShader = function () {

package/src/engine/graphics/shaders/ClearShader.js

@@ -1,6 +1,4 @@
-/**
- * Created by Alex on 20/09/2015.
- */
+
 const ClearShader = {
 
     defines: {},

package/src/engine/graphics/shaders/CopyShader.d.ts

@@ -1,7 +1,4 @@
 export default CopyShader;
-/**
- * Created by Alex on 10/11/2014.
- */
 declare function CopyShader(): {
     uniforms: {
         tDiffuse: {

package/src/engine/graphics/shaders/CopyShader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CopyShader.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics/shaders/CopyShader.js"],"names":[],"mappings":";AAAA;;GAEG;AAIH;;;;;;;;;;;;;EA0CC"}
+{"version":3,"file":"CopyShader.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics/shaders/CopyShader.js"],"names":[],"mappings":";AAIA;;;;;;;;;;;;;EA0CC"}

package/src/engine/graphics/shaders/CopyShader.js

@@ -1,6 +1,4 @@
-/**
- * Created by Alex on 10/11/2014.
- */
+
 
 
 

package/src/engine/graphics/shaders/NormalMapShader2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NormalMapShader2.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics/shaders/NormalMapShader2.js"],"names":[],"mappings":";AAkCA;;;;;;;;;;;;IAuBQ;;OAEG;;EAgCV;uBA3DsB,OAAO"}
+{"version":3,"file":"NormalMapShader2.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics/shaders/NormalMapShader2.js"],"names":[],"mappings":";AA6BA;;;;;;;;;;;;IAuBQ;;OAEG;;EAgCV;uBA3DsB,OAAO"}

package/src/engine/graphics/shaders/NormalMapShader2.js

@@ -1,8 +1,3 @@
-/**
- * Created by Alex on 10/11/2014.
- */
-
-
 //var current = getValue(x, y);
 ////
 //var top = getValue(x, y - 1);

package/src/engine/graphics/shaders/TerrainShader.js

@@ -1,7 +1,3 @@
-/**
- * Created by Alex on 22/06/2015.
- */
-
 import ShaderChunks from './lib/ShaderChunks.js';
 
 function vertex() {

package/src/engine/graphics/shaders/WaterShader.js

@@ -1,6 +1,3 @@
-/**
- * Created by Alex on 06/04/2016.
- */
 import * as THREE from 'three';
 import ShaderChunks from './lib/ShaderChunks.js';
 

package/src/engine/graphics/shaders/lib/ShaderChunks.js

@@ -1,6 +1,4 @@
-/**
- * Created by Alex on 06/04/2016.
- */
+
 const chunks = {
     random: [
         "float rand(float v){",

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

@@ -49,9 +49,9 @@ export class AttributeDataTexture {
     computeSlotWidth(): number;
     /**
      *
-     * @param {number} row_count
+     * @param {number} slot_count
      */
-    resize(row_count: number): void;
+    resize(slot_count: number): void;
     build(): void;
     /**
      *

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

@@ -1 +1 @@
-{"version":3,"file":"AttributeDataTexture.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics/texture/AttributeDataTexture.js"],"names":[],"mappings":"AAYA;IAwRI;;;;;;OAMG;IACH,+CAHW,MAAM,cACN,MAAM,GAHL,oBAAoB,CAO/B;IAhSD;;;;;OAKG;IACH,+CAHW,MAAM,cACN,MAAM,EA2ChB;IA/BG;;;;OAIG;IACH,eAAkB;IAElB,mBAAoB;IAEpB;;;;OAIG;IACH,uBAAkC;IAElC;;;;OAIG;IACH,kBAAqB;IAErB;;;;OAIG;IACH,qBAA8B;IAKlC;;;OAGG;IACH,0BAEC;IAED,cASC;IAED,0BAGC;IAED,2BAEC;IAED;;;OAGG;IACH,kBAFW,MAAM,QAwChB;IAED,cA4BC;IAED;;;;;;OAMG;IACH,yBALW,MAAM,WACN,MAAM,EAAE,UACR,MAAM,EAAE,GACN,OAAO,CAoCnB;IAED;;;;;OAKG;IACH,8BAJW,MAAM,WACN,MAAM,EAAE,UACR,MAAM,EAAE,QAmClB;IAED;;;OAGG;IACH,sBAFW,MAAM,QAgBhB;IAED;;;OAGG;IACH,sCAEC;IAED;;;OAGG;IACH,2BAEC;IAED;;;OAGG;IACH,oBAFY,MAAM,CAIjB;CAYJ;4BA3S0C,OAAO"}
+{"version":3,"file":"AttributeDataTexture.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics/texture/AttributeDataTexture.js"],"names":[],"mappings":"AAYA;IAwRI;;;;;;OAMG;IACH,+CAHW,MAAM,cACN,MAAM,GAHL,oBAAoB,CAO/B;IAhSD;;;;;OAKG;IACH,+CAHW,MAAM,cACN,MAAM,EA2ChB;IA/BG;;;;OAIG;IACH,eAAkB;IAElB,mBAAoB;IAEpB;;;;OAIG;IACH,uBAAkC;IAElC;;;;OAIG;IACH,kBAAqB;IAErB;;;;OAIG;IACH,qBAA8B;IAKlC;;;OAGG;IACH,0BAEC;IAED,cASC;IAED,0BAGC;IAED,2BAEC;IAED;;;OAGG;IACH,mBAFW,MAAM,QAwChB;IAED,cA4BC;IAED;;;;;;OAMG;IACH,yBALW,MAAM,WACN,MAAM,EAAE,UACR,MAAM,EAAE,GACN,OAAO,CAoCnB;IAED;;;;;OAKG;IACH,8BAJW,MAAM,WACN,MAAM,EAAE,UACR,MAAM,EAAE,QAmClB;IAED;;;OAGG;IACH,sBAFW,MAAM,QAgBhB;IAED;;;OAGG;IACH,sCAEC;IAED;;;OAGG;IACH,2BAEC;IAED;;;OAGG;IACH,oBAFY,MAAM,CAIjB;CAYJ;4BA9S0C,OAAO"}