@woosh/meep-engine 2.163.1 → 2.163.3

package/src/core/geom/vec3/v3_uniform_sample_cone.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Uniformly sample a direction within a cone around +Z (solid-angle uniform).
+ *
+ * @param {number[]|Float32Array} out
+ * @param {number} out_offset
+ * @param {number} u random value in [0, 1] (controls polar angle)
+ * @param {number} v random value in [0, 1] (controls azimuth)
+ * @param {number} cos_theta_max cosine of the cone half-angle; 1 = a single direction, -1 = full sphere
+ */
+export function v3_uniform_sample_cone(out: number[] | Float32Array, out_offset: number, u: number, v: number, cos_theta_max: number): void;
+//# sourceMappingURL=v3_uniform_sample_cone.d.ts.map

package/src/core/geom/vec3/v3_uniform_sample_cone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v3_uniform_sample_cone.d.ts","sourceRoot":"","sources":["../../../../../src/core/geom/vec3/v3_uniform_sample_cone.js"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,4CANW,MAAM,EAAE,GAAC,YAAY,cACrB,MAAM,KACN,MAAM,KACN,MAAM,iBACN,MAAM,QAWhB"}

package/src/core/geom/vec3/v3_uniform_sample_cone.js

@@ -0,0 +1,21 @@
+const TWO_PI = Math.PI * 2;
+
+/**
+ * Uniformly sample a direction within a cone around +Z (solid-angle uniform).
+ *
+ * @param {number[]|Float32Array} out
+ * @param {number} out_offset
+ * @param {number} u random value in [0, 1] (controls polar angle)
+ * @param {number} v random value in [0, 1] (controls azimuth)
+ * @param {number} cos_theta_max cosine of the cone half-angle; 1 = a single direction, -1 = full sphere
+ */
+export function v3_uniform_sample_cone(out, out_offset, u, v, cos_theta_max) {
+    const cos_theta = (1.0 - u) + u * cos_theta_max;
+    const sin_theta = Math.sqrt(Math.max(0.0, 1.0 - cos_theta * cos_theta));
+
+    const phi = v * TWO_PI;
+
+    out[out_offset] = Math.cos(phi) * sin_theta;
+    out[out_offset + 1] = Math.sin(phi) * sin_theta;
+    out[out_offset + 2] = cos_theta;
+}

package/src/core/math/physics/brdf/cone_cosine_from_roughness.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Cosine of the importance-sampling cone aperture (cos of twice the half-angle)
+ * for a given perceptual roughness, derived by inverting the spherical-gaussian
+ * specular lobe. Roughness 1 maps to roughly a half-pi half-angle.
+ *
+ * Pairs with {@link reflection_sample_weight}; used to bound the set of sampled
+ * directions when convolving an environment map.
+ *
+ * @param {number} linear_roughness perceptual roughness in [0, 1]
+ * @returns {number} cone cosine in [-1, 1]
+ */
+export function cone_cosine_from_roughness(linear_roughness: number): number;
+//# sourceMappingURL=cone_cosine_from_roughness.d.ts.map

package/src/core/math/physics/brdf/cone_cosine_from_roughness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cone_cosine_from_roughness.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/brdf/cone_cosine_from_roughness.js"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,6DAHW,MAAM,GACJ,MAAM,CAgBlB"}

package/src/core/math/physics/brdf/cone_cosine_from_roughness.js

@@ -0,0 +1,28 @@
+import { lerp } from "../../lerp.js";
+
+/**
+ * Cosine of the importance-sampling cone aperture (cos of twice the half-angle)
+ * for a given perceptual roughness, derived by inverting the spherical-gaussian
+ * specular lobe. Roughness 1 maps to roughly a half-pi half-angle.
+ *
+ * Pairs with {@link reflection_sample_weight}; used to bound the set of sampled
+ * directions when convolving an environment map.
+ *
+ * @param {number} linear_roughness perceptual roughness in [0, 1]
+ * @returns {number} cone cosine in [-1, 1]
+ */
+export function cone_cosine_from_roughness(linear_roughness) {
+    // From linear roughness to GGX roughness input.
+    const m = linear_roughness * linear_roughness;
+
+    // Chosen so that roughness of 1.0 maps to a half-pi cone aperture.
+    const cutoff_value = lerp(0.01, 0.14, m);
+
+    // Inversion of the spherical gaussian: cutoff for the half angle from N.H.
+    const half_angle_cos = Math.log(cutoff_value) * (m * m) * 0.5 + 1.0;
+    const half_angle_cos_sqr = half_angle_cos * half_angle_cos;
+    const half_angle_sin_sqr = Math.max(0.0, 1.0 - half_angle_cos_sqr);
+
+    // cos(2 * half_angle) via the cosine double-angle identity.
+    return half_angle_cos_sqr - half_angle_sin_sqr;
+}

package/src/core/math/physics/brdf/reflection_sample_weight.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Spherical-gaussian approximation of the GGX specular weight for a sample,
+ * used when convolving an environment map for prefiltered reflections.
+ *
+ * From "SG Series Part 4: Specular Lighting From an SG Light Source" by MJP.
+ * Both directions are assumed unit length.
+ *
+ * @param {number} out_x reflection (output) direction
+ * @param {number} out_y
+ * @param {number} out_z
+ * @param {number} in_x sampled (input) direction
+ * @param {number} in_y
+ * @param {number} in_z
+ * @param {number} linear_roughness perceptual roughness in [0, 1]
+ * @returns {number} non-negative weight
+ */
+export function reflection_sample_weight(out_x: number, out_y: number, out_z: number, in_x: number, in_y: number, in_z: number, linear_roughness: number): number;
+//# sourceMappingURL=reflection_sample_weight.d.ts.map

package/src/core/math/physics/brdf/reflection_sample_weight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection_sample_weight.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/brdf/reflection_sample_weight.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,gDATW,MAAM,SACN,MAAM,SACN,MAAM,QACN,MAAM,QACN,MAAM,QACN,MAAM,oBACN,MAAM,GACJ,MAAM,CA+BlB"}

package/src/core/math/physics/brdf/reflection_sample_weight.js

@@ -0,0 +1,48 @@
+import { clamp01 } from "../../clamp01.js";
+
+/**
+ * Spherical-gaussian approximation of the GGX specular weight for a sample,
+ * used when convolving an environment map for prefiltered reflections.
+ *
+ * From "SG Series Part 4: Specular Lighting From an SG Light Source" by MJP.
+ * Both directions are assumed unit length.
+ *
+ * @param {number} out_x reflection (output) direction
+ * @param {number} out_y
+ * @param {number} out_z
+ * @param {number} in_x sampled (input) direction
+ * @param {number} in_y
+ * @param {number} in_z
+ * @param {number} linear_roughness perceptual roughness in [0, 1]
+ * @returns {number} non-negative weight
+ */
+export function reflection_sample_weight(
+    out_x, out_y, out_z,
+    in_x, in_y, in_z,
+    linear_roughness
+) {
+    // From linear roughness to GGX roughness input.
+    const m = linear_roughness * linear_roughness;
+
+    // Half vector H = normalize(out + in)
+    let h_x = out_x + in_x;
+    let h_y = out_y + in_y;
+    let h_z = out_z + in_z;
+
+    const h_length = Math.sqrt(h_x * h_x + h_y * h_y + h_z * h_z);
+
+    if (h_length === 0) {
+        // out and in are antiparallel; no contribution
+        return 0;
+    }
+
+    const inv = 1.0 / h_length;
+
+    // NH = saturate(dot(N = out, H))
+    const NH = clamp01((out_x * h_x + out_y * h_y + out_z * h_z) * inv);
+
+    const m2 = m * m;
+
+    // Spherical Gaussian: exp(2 * (NH - 1) / m^2)
+    return Math.exp(2.0 * (NH - 1.0) / m2);
+}

package/src/engine/graphics/GraphicsEngine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GraphicsEngine.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics/GraphicsEngine.js"],"names":[],"mappings":"AA4DA;IAOI;;;;;OAKG;IACH,+BAJW,MAAM,EAgLhB;IAtLD,gCAEC;IAgBG;;;;OAIG;IACH,2BAA+C;IAK/C;;;;;QAOI;;WAEG;;QAEH;;WAEG;;;;;MAMN;IAED;;OAEG;IACH,YAFU,OAAO,CAEe;IAEhC;;;;;;OAMG;IACH,4BAFU,OAAO,CAEyB;IAE1C;;;OAGG;IACH,QAFU,kBAAkB,CAEU;IAWtC;;;OAGG;IACH,aAAkB;IAGlB;;;OAGG;IACH,cAFU,KAAK,CAEgB;IAK/B;;;OAGG;IACH,QAFU,MAAM,CAEI;IAEpB;;;OAGG;IACH,UAFU,aAAa,CAEH;IAGpB,+BAA0C;IAU1C;;OAEG;IACH,eAA+B;IAI/B;;;OAGG;IACH,uBAFU,kBAAkB,CAEgB;IAE5C;;;OAGG;IACH,oBAFU,iBAAiB,CAEsB;IAEjD;;;OAGG;IACH,gBAFU,iBAAiB,CAES;IAEpC;;;OAGG;IACH,sBAAoC;IAGpC;;;;OAIG;IACH,UAFU,OAAO,CAEG;IAEpB;;;OAGG;IACH,UAFU,OAAO,CAEG;IAEpB;;;OAGG;IACH,YAFU,MAAM,CAEG;IACnB,kKAcI;IAGR;;;OAGG;IACH,sBAFa,eAAe,CAI3B;IAED;;;OAGG;IACH,eAFa,aAAa,CAIzB;IAED,mBA8BC;IAED;;;;OAIG;IACH,iCAEC;IAED;;;OAGG;IACH,0BAFa,MAAM,CAIlB;IAED,+BAcC;IAED,cAgEC;IAzBsB,8BAA0C;IA2BjE;;;OAGG;IACH,cAFa,MAAM,CAYlB;IAED;;OAEG;IACH,aAQC;IAED;;OAEG;IACH,yBAQC;IAED;;;;;;OAMG;IACH,yBALW,MAAM,KACN,MAAM,6CAMhB;IAED;;;;OAIG;IACH,8BAHW,OAAO,UAAQ,UACf,OAAO,UAAQ,QAczB;IAED;;;;;OAKG;IACH,8BAQC;IAED,0BAEC;IAED;;;OAGG;IACH,4BAFW,cAAc,QA8BxB;IAED;;OAEG;IACH,qBAqBC;IAED;;OAEG;IACH,0BAeC;IAED;;OAEG;IACH,eA8CC;;CACJ;mBA5lBkB,oCAAoC;oBACnC,4BAA4B;wBACxB,4BAA4B;mCAajB,uCAAuC;sBAlBnE,OAAO;uBAaS,wBAAwB;8BAbxC,OAAO;4BAYc,+BAA+B;mCAKxB,uCAAuC;kCAKxC,gCAAgC;kCADhC,oCAAoC;gCAPtC,uCAAuC;+BAKxC,4BAA4B"}
+{"version":3,"file":"GraphicsEngine.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics/GraphicsEngine.js"],"names":[],"mappings":"AAgEA;IAOI;;;;;OAKG;IACH,+BAJW,MAAM,EAgLhB;IAtLD,gCAEC;IAgBG;;;;OAIG;IACH,2BAA+C;IAK/C;;;;;QAOI;;WAEG;;QAEH;;WAEG;;;;;MAMN;IAED;;OAEG;IACH,YAFU,OAAO,CAEe;IAEhC;;;;;;OAMG;IACH,4BAFU,OAAO,CAEyB;IAE1C;;;OAGG;IACH,QAFU,kBAAkB,CAEU;IAWtC;;;OAGG;IACH,aAAkB;IAGlB;;;OAGG;IACH,cAFU,KAAK,CAEgB;IAK/B;;;OAGG;IACH,QAFU,MAAM,CAEI;IAEpB;;;OAGG;IACH,UAFU,aAAa,CAEH;IAGpB,+BAA0C;IAU1C;;OAEG;IACH,eAA+B;IAI/B;;;OAGG;IACH,uBAFU,kBAAkB,CAEgB;IAE5C;;;OAGG;IACH,oBAFU,iBAAiB,CAEsB;IAEjD;;;OAGG;IACH,gBAFU,iBAAiB,CAES;IAEpC;;;OAGG;IACH,sBAAoC;IAGpC;;;;OAIG;IACH,UAFU,OAAO,CAEG;IAEpB;;;OAGG;IACH,UAFU,OAAO,CAEG;IAEpB;;;OAGG;IACH,YAFU,MAAM,CAEG;IACnB,kKAcI;IAGR;;;OAGG;IACH,sBAFa,eAAe,CAI3B;IAED;;;OAGG;IACH,eAFa,aAAa,CAIzB;IAED;;;;;;;;;;;;;OAaG;IACH,iCAHW,MAAM,OAAO,eACb,4BAA4B,QAkCtC;IAED,mBA8BC;IAED;;;;OAIG;IACH,iCAEC;IAED;;;OAGG;IACH,0BAFa,MAAM,CAIlB;IAED,+BAcC;IAED,cAgEC;IAzBsB,8BAA0C;IA2BjE;;;OAGG;IACH,cAFa,MAAM,CAYlB;IAED;;OAEG;IACH,aAQC;IAED;;OAEG;IACH,yBAQC;IAED;;;;;;OAMG;IACH,yBALW,MAAM,KACN,MAAM,6CAMhB;IAED;;;;OAIG;IACH,8BAHW,OAAO,UAAQ,UACf,OAAO,UAAQ,QAczB;IAED;;;;;OAKG;IACH,8BAQC;IAED,0BAEC;IAED;;;OAGG;IACH,4BAFW,cAAc,QA8BxB;IAED;;OAEG;IACH,qBAqBC;IAED;;OAEG;IACH,0BAeC;IAED;;OAEG;IACH,eA8CC;;CACJ;mBA7oBkB,oCAAoC;oBACnC,4BAA4B;wBACxB,4BAA4B;mCAajB,uCAAuC;sBAlBnE,OAAO;uBAaS,wBAAwB;8BAbxC,OAAO;4BAYc,+BAA+B;mCAKxB,uCAAuC;kCAKxC,gCAAgC;kCADhC,oCAAoC;gCAPtC,uCAAuC;6CAW1B,2CAA2C;+BANzD,4BAA4B"}

package/src/engine/graphics/GraphicsEngine.js

@@ -1,7 +1,10 @@
 import {
+    CubeReflectionMapping,
+    EquirectangularReflectionMapping,
     Group,
     LinearEncoding,
     NoToneMapping,
+    PMREMGenerator,
     Raycaster as ThreeRaycaster,
     Scene as ThreeScene,
     Vector3 as ThreeVector3,
@@ -32,6 +35,7 @@ import { CameraViewManager } from "./render/view/CameraViewManager.js";
 import { ShadowMapRenderer } from "./shadows/ShadowMapRenderer.js";
 import { StandardFrameBuffers } from "./StandardFrameBuffers.js";
 import { three_setSceneAutoUpdate } from "./three/three_setSceneAutoUpdate.js";
+import { EnvironmentTextureProjection } from "./texture/EnvironmentTextureProjection.js";
 
 /**
  *
@@ -261,6 +265,54 @@ export class GraphicsEngine {
         return this.renderer;
     }
 
+    /**
+     * Set the scene's environment map. The supplied texture is treated as BOTH:
+     *   - the skybox background (shown directly), and
+     *   - the image-based-lighting (IBL) source for physically based materials.
+     *
+     * The texture is run through three.js' PMREMGenerator to produce the
+     * prefiltered radiance assigned to `scene.environment`, while the original
+     * texture is assigned to `scene.background`.
+     *
+     * Must be called after the renderer has started up.
+     *
+     * @param {THREE.Texture} texture environment texture (equirectangular or cube)
+     * @param {EnvironmentTextureProjection} [projection=EnvironmentTextureProjection.Equirectangular] how the texture is projected
+     */
+    set_environment_texture(texture, projection = EnvironmentTextureProjection.Equirectangular) {
+        assert.defined(texture, 'texture');
+
+        const renderer = this.renderer;
+
+        if (renderer === null || renderer === undefined) {
+            throw new Error('GraphicsEngine.set_environment_texture: renderer is not initialized, call after startup');
+        }
+
+        const pmrem = new PMREMGenerator(renderer);
+
+        let target;
+
+        if (projection === EnvironmentTextureProjection.Equirectangular) {
+            texture.mapping = EquirectangularReflectionMapping;
+            target = pmrem.fromEquirectangular(texture);
+        } else if (projection === EnvironmentTextureProjection.Cube) {
+            texture.mapping = CubeReflectionMapping;
+            target = pmrem.fromCubemap(texture);
+        } else {
+            pmrem.dispose();
+            throw new Error(`GraphicsEngine.set_environment_texture: unsupported projection '${projection}'`);
+        }
+
+        pmrem.dispose();
+
+        const scene = this.scene;
+
+        // prefiltered radiance used by PBR materials as the IBL source
+        scene.environment = target.texture;
+        // original texture shown as the skybox
+        scene.background = texture;
+    }
+
     updateSize() {
         const size = this.viewport.size;
 

package/src/engine/graphics/ecs/path/tube/build/build_geometry_catmullrom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build_geometry_catmullrom.d.ts","sourceRoot":"","sources":["../../../../../../../../src/engine/graphics/ecs/path/tube/build/build_geometry_catmullrom.js"],"names":[],"mappings":"AAoFA;;;;;;;;;;GAUG;AACH,mFAPW,MAAM,EAAE,gBACR,MAAM,EAAE,GAAC,YAAY,mBACrB,MAAM,EAAE,iBACR,MAAM,eACN,MAAM,GACL,MAAM,cAAc,CAoI/B"}
+{"version":3,"file":"build_geometry_catmullrom.d.ts","sourceRoot":"","sources":["../../../../../../../../src/engine/graphics/ecs/path/tube/build/build_geometry_catmullrom.js"],"names":[],"mappings":"AAsJA;;;;;;;;;;GAUG;AACH,mFAPW,MAAM,EAAE,gBACR,MAAM,EAAE,GAAC,YAAY,mBACrB,MAAM,EAAE,iBACR,MAAM,eACN,MAAM,GACL,MAAM,cAAc,CAkJ/B"}