@woosh/meep-engine 3.11.1 → 3.11.2

package/src/shade/renderer/shadow/map/shader/chunk_shadowmap_sample_point2.d.ts

@@ -1,19 +1,20 @@
 /**
- * Cone-sampled point shadow PCF. Samples random directions inside a cone around the receiver-
- * to-light vector and re-encodes each one to the octahedral atlas. The cone aperture comes
- * from the GDC bulb-radius scaling in {@link chunk_max_penumbra_percentage}; the factor of 2
- * carries over the texels → tangent-plane conversion an earlier disk-based variant used (1
- * atlas texel ≈ 2/face_dim of Δn.xy near the +Z pole), so the angular footprint stays
- * comparable.
+ * Cone-sampled point shadow PCF: 8 random directions inside a cone around the receiver-to-light
+ * vector, each re-encoded to the light's octahedral map, one `textureLoad` per tap, ending in
+ * {@link chunk_contact_harden_pcf_kernel}. Tap directions come from {@link chunk_random}, which the
+ * calling shader (deferred lighting / volumetrics) initialises per invocation, so neighbouring
+ * pixels decorrelate without a rotation table or a blue-noise disk.
  *
- * No blue-noise disk, no rotation table, no atlas-border clamp. Random tap directions come
- * from {@link chunk_random}, which the calling shader (deferred lighting / volumetrics)
- * initialises per invocation, so neighbours decorrelate naturally. Each tap is one
- * \`textureLoad\` and the loop ends in {@link chunk_contact_harden_pcf_kernel} unchanged.
+ * The aperture is the GDC bulb-radius scaling in {@link chunk_max_penumbra_percentage}; the factor
+ * of 2 carries over the texels → tangent-plane conversion an earlier disk-based variant used (1
+ * atlas texel ≈ 2/face_dim of Δn.xy near the +Z pole), so the angular footprint stays comparable.
  *
- * No clamp on the aperture: the receiver direction is sampled in 3D and re-encoded per tap, so
- * the octahedral encode always lands in [0, 1]² — even a full-sphere aperture stays inside
- * this light's slot.
+ * Addressing: `atlas_aabb` is the INNER octahedral surface, and the cube → octahedral remap
+ * surrounds it with a `SHADOWMAP_ATLAS_BORDER`-texel skirt holding
+ * `inner[texture_octahedral_wrap_texel_coordinates(local)]`. Under the bilinear convention
+ * `uv * size - 0.5` a uv on the edge of the square rounds to -1 or `size` — one texel into that
+ * skirt, which is this light's own wrapped data. The encode always lands in [0, 1]² and the round
+ * can overshoot by at most one texel, so the aperture needs no clamp.
  *
  * @see chunk_cone_sample_direction
  * @type {CodeChunk}

package/src/shade/renderer/shadow/map/shader/chunk_shadowmap_sample_point2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_shadowmap_sample_point2.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shadow/map/shader/chunk_shadowmap_sample_point2.js"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,4CAFU,SAAS,CA8FjB;0BAvHwB,uCAAuC"}
+{"version":3,"file":"chunk_shadowmap_sample_point2.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shadow/map/shader/chunk_shadowmap_sample_point2.js"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,4CAFU,SAAS,CAiGjB;0BA3HwB,uCAAuC"}

package/src/shade/renderer/shadow/map/shader/chunk_shadowmap_sample_point2.js

@@ -1,129 +1,133 @@
-import { LIGHT_DATABASE_SPEC } from "../../../light/LIGHT_DATABASE_SPEC.js";
-import { chunk_cone_sample_direction } from "../../../shader/chunk/geometry/cone/chunk_cone_sample_direction.js";
-import {
-    chunk_uv_octahedral_unit_encode
-} from "../../../shader/chunk/geometry/octahedron/chunk_uv_octahedral_unit_encode.js";
-import { chunk_random } from "../../../shader/chunk/random/chunk_random.js";
-import { chunk_random_round_vec2 } from "../../../shader/chunk/random/chunk_random_round_vec2.js";
-import { chunk_random_vec2 } from "../../../shader/chunk/random/chunk_random_vec2.js";
-import { chunk_uv_to_texel_coordinate } from "../../../shader/chunk/texture/chunk_uv_to_texel_coordinate.js";
-import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
-import { chunk_get_shadow_offsets } from "./chunk_get_shadow_offsets.js";
-import { chunk_contact_harden_pcf_kernel } from "./dpcf/chunk_contact_harden_pcf_kernel.js";
-import { chunk_max_penumbra_percentage } from "./dpcf/chunk_max_penumbra_percentage.js";
-
-const SHADOW_POINT_DESCRIPTOR = LIGHT_DATABASE_SPEC.get('shadow_point');
-
-/**
- * Cone-sampled point shadow PCF. Samples random directions inside a cone around the receiver-
- * to-light vector and re-encodes each one to the octahedral atlas. The cone aperture comes
- * from the GDC bulb-radius scaling in {@link chunk_max_penumbra_percentage}; the factor of 2
- * carries over the texels → tangent-plane conversion an earlier disk-based variant used (1
- * atlas texel ≈ 2/face_dim of Δn.xy near the +Z pole), so the angular footprint stays
- * comparable.
- *
- * No blue-noise disk, no rotation table, no atlas-border clamp. Random tap directions come
- * from {@link chunk_random}, which the calling shader (deferred lighting / volumetrics)
- * initialises per invocation, so neighbours decorrelate naturally. Each tap is one
- * \`textureLoad\` and the loop ends in {@link chunk_contact_harden_pcf_kernel} unchanged.
- *
- * No clamp on the aperture: the receiver direction is sampled in 3D and re-encoded per tap, so
- * the octahedral encode always lands in [0, 1]² — even a full-sphere aperture stays inside
- * this light's slot.
- *
- * @see chunk_cone_sample_direction
- * @type {CodeChunk}
- */
-export const chunk_shadowmap_sample_point2 = CodeChunk.from(
-    //language=WGSL
-    `
-fn shadowmap_sample_point(
-    database: ptr<storage, array<u32>>,
-    shadow_id: u32,
-    position_ws: vec3f,
-    surface_normal_ws: vec3f,
-    light_position_ws: vec3f,
-    light_max_distance: f32,
-    light_radius: f32,
-) -> f32 {
-    const NORMAL_BIAS_SCALE = 2.0;
-    const DEPTH_OFFSET_BIAS = 0.0001;
-
-    let atlas_aabb = ${SHADOW_POINT_DESCRIPTOR.marshalling_method_read}(database, shadow_id);
-
-    // unbiased distance and light direction, used to compute the bias amounts
-    let to_light_unbiased = light_position_ws - position_ws;
-    let dist_to_light_unbiased = length(to_light_unbiased);
-    let light_direction = to_light_unbiased / max(dist_to_light_unbiased, 1e-6);
-
-    let world_pixel_size = 2.0 * dist_to_light_unbiased / max(atlas_aabb.z, 1.0);
-    let shadowmap_bias = get_shadow_offsets(surface_normal_ws, light_direction);
-    let normal_offset = world_pixel_size * shadowmap_bias.x * surface_normal_ws * NORMAL_BIAS_SCALE;
-
-    // re-evaluate direction and distance from the normal-biased position
-    let to_surface = (position_ws + normal_offset) - light_position_ws;
-    let distance_to_center = length(to_surface);
-
-    // Direction the cube faces captured: FROM LIGHT TO SURFACE
-    let dir_light_to_surface = to_surface / max(distance_to_center, 1e-6);
-
-    let face_size = vec2u(atlas_aabb.zw);
-
-    // reverse-Z convention: close to light -> 1, at or beyond light_max_distance -> 0.
-    let radial = distance_to_center / max(light_max_distance, 1e-6);
-    let depth_bias = DEPTH_OFFSET_BIAS * shadowmap_bias.y;
-    let reference_depth = (1.0 - saturate(radial)) + depth_bias;
-
-    // Cone aperture (~ tan of the half-angle). max_penumbra_percentage is the GDC formula
-    // mapping bulb radius to a fraction of the atlas face; the 2× factor is the texels →
-    // tangent-plane conversion. Unclamped: any aperture is valid because the octahedral
-    // re-encode in the loop always stays inside this light's slot.
-    let cone_aperture = 2.0 * max_penumbra_percentage(light_radius, light_radius);
-
-    var occluders: f32 = 0.0;
-    var occluder_dist_sum: f32 = 0.0;
-
-    for (var tap: u32 = 0u; tap < 8u; tap++) {
-
-        let xi = random_vec2();
-
-        let perturbed_dir = cone_sample_direction(dir_light_to_surface, cone_aperture, xi);
-
-        let octahedral_uv = uv_octahedral_unit_encode(perturbed_dir);
-        let local_texel = uv_to_texel_coordinate(octahedral_uv, face_size);
-
-        // instead of doing bilinear, we use stochastic sampling instead
-        let rounded_local_texel = random_round_vec2(local_texel);
-
-        let sample_texel = vec2<u32>(rounded_local_texel) + vec2<u32>(atlas_aabb.xy);
-
-        let stored = textureLoad(shadowmapAtlas, sample_texel, 0);
-        let dist = stored - reference_depth;
-
-        // Per-tap binary compare; reverse-Z + step(0, stored - ref) ⇒ 1 = occluded.
-        let occluded = step(0.0, dist);
-
-        occluders += occluded;
-        occluder_dist_sum += dist * occluded;
-    }
-
-    return contact_harden_pcf_kernel(
-        occluders,
-        occluder_dist_sum,
-        reference_depth,
-
-    );
-}
-    `, [
-        SHADOW_POINT_DESCRIPTOR.chunk_read,
-        chunk_cone_sample_direction,
-        chunk_contact_harden_pcf_kernel,
-        chunk_get_shadow_offsets,
-        chunk_max_penumbra_percentage,
-        chunk_random,
-        chunk_uv_octahedral_unit_encode,
-        chunk_uv_to_texel_coordinate,
-        chunk_random_round_vec2,
-        chunk_random_vec2,
-    ]
-);
+import { LIGHT_DATABASE_SPEC } from "../../../light/LIGHT_DATABASE_SPEC.js";
+import { chunk_cone_sample_direction } from "../../../shader/chunk/geometry/cone/chunk_cone_sample_direction.js";
+import {
+    chunk_uv_octahedral_unit_encode
+} from "../../../shader/chunk/geometry/octahedron/chunk_uv_octahedral_unit_encode.js";
+import { chunk_random } from "../../../shader/chunk/random/chunk_random.js";
+import { chunk_random_round_vec2 } from "../../../shader/chunk/random/chunk_random_round_vec2.js";
+import { chunk_random_vec2 } from "../../../shader/chunk/random/chunk_random_vec2.js";
+import { chunk_uv_to_texel_coordinate } from "../../../shader/chunk/texture/chunk_uv_to_texel_coordinate.js";
+import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
+import { chunk_get_shadow_offsets } from "./chunk_get_shadow_offsets.js";
+import { chunk_contact_harden_pcf_kernel } from "./dpcf/chunk_contact_harden_pcf_kernel.js";
+import { chunk_max_penumbra_percentage } from "./dpcf/chunk_max_penumbra_percentage.js";
+
+const SHADOW_POINT_DESCRIPTOR = LIGHT_DATABASE_SPEC.get('shadow_point');
+
+/**
+ * Cone-sampled point shadow PCF: 8 random directions inside a cone around the receiver-to-light
+ * vector, each re-encoded to the light's octahedral map, one `textureLoad` per tap, ending in
+ * {@link chunk_contact_harden_pcf_kernel}. Tap directions come from {@link chunk_random}, which the
+ * calling shader (deferred lighting / volumetrics) initialises per invocation, so neighbouring
+ * pixels decorrelate without a rotation table or a blue-noise disk.
+ *
+ * The aperture is the GDC bulb-radius scaling in {@link chunk_max_penumbra_percentage}; the factor
+ * of 2 carries over the texels → tangent-plane conversion an earlier disk-based variant used (1
+ * atlas texel ≈ 2/face_dim of Δn.xy near the +Z pole), so the angular footprint stays comparable.
+ *
+ * Addressing: `atlas_aabb` is the INNER octahedral surface, and the cube → octahedral remap
+ * surrounds it with a `SHADOWMAP_ATLAS_BORDER`-texel skirt holding
+ * `inner[texture_octahedral_wrap_texel_coordinates(local)]`. Under the bilinear convention
+ * `uv * size - 0.5` a uv on the edge of the square rounds to -1 or `size` — one texel into that
+ * skirt, which is this light's own wrapped data. The encode always lands in [0, 1]² and the round
+ * can overshoot by at most one texel, so the aperture needs no clamp.
+ *
+ * @see chunk_cone_sample_direction
+ * @type {CodeChunk}
+ */
+export const chunk_shadowmap_sample_point2 = CodeChunk.from(
+    //language=WGSL
+    `
+fn shadowmap_sample_point(
+    database: ptr<storage, array<u32>>,
+    shadow_id: u32,
+    position_ws: vec3f,
+    surface_normal_ws: vec3f,
+    light_position_ws: vec3f,
+    light_max_distance: f32,
+    light_radius: f32,
+) -> f32 {
+    const NORMAL_BIAS_SCALE = 2.0;
+    const DEPTH_OFFSET_BIAS = 0.0001;
+
+    let atlas_aabb = ${SHADOW_POINT_DESCRIPTOR.marshalling_method_read}(database, shadow_id);
+
+    // unbiased distance and light direction, used to compute the bias amounts
+    let to_light_unbiased = light_position_ws - position_ws;
+    let dist_to_light_unbiased = length(to_light_unbiased);
+    let light_direction = to_light_unbiased / max(dist_to_light_unbiased, 1e-6);
+
+    let world_pixel_size = 2.0 * dist_to_light_unbiased / max(atlas_aabb.z, 1.0);
+    let shadowmap_bias = get_shadow_offsets(surface_normal_ws, light_direction);
+    let normal_offset = world_pixel_size * shadowmap_bias.x * surface_normal_ws * NORMAL_BIAS_SCALE;
+
+    // re-evaluate direction and distance from the normal-biased position
+    let to_surface = (position_ws + normal_offset) - light_position_ws;
+    let distance_to_center = length(to_surface);
+
+    // Direction the cube faces captured: FROM LIGHT TO SURFACE
+    let dir_light_to_surface = to_surface / max(distance_to_center, 1e-6);
+
+    let face_size = vec2u(atlas_aabb.zw);
+
+    // reverse-Z convention: close to light -> 1, at or beyond light_max_distance -> 0.
+    let radial = distance_to_center / max(light_max_distance, 1e-6);
+    let depth_bias = DEPTH_OFFSET_BIAS * shadowmap_bias.y;
+    let reference_depth = (1.0 - saturate(radial)) + depth_bias;
+
+    // Cone aperture (~ tan of the half-angle). max_penumbra_percentage is the GDC formula mapping
+    // bulb radius to a fraction of the atlas face; the 2× factor is the texels → tangent-plane
+    // conversion. Unclamped — see the header on why any aperture stays addressable.
+    let cone_aperture = 2.0 * max_penumbra_percentage(light_radius, light_radius);
+
+    var occluders: f32 = 0.0;
+    var occluder_dist_sum: f32 = 0.0;
+
+    for (var tap: u32 = 0u; tap < 8u; tap++) {
+
+        let xi = random_vec2();
+
+        let perturbed_dir = cone_sample_direction(dir_light_to_surface, cone_aperture, xi);
+
+        let octahedral_uv = uv_octahedral_unit_encode(perturbed_dir);
+        let local_texel = uv_to_texel_coordinate(octahedral_uv, face_size);
+
+        // one of the two neighbours at random rather than a blend of them: stochastic bilinear
+        let rounded_local_texel = random_round_vec2(local_texel);
+
+        // Signed: the round reaches -1 at a uv of 0, and the skirt is where that tap belongs. Via
+        // u32 the -1 would be an indeterminate conversion — 0xFFFFFFFF reaches the skirt through
+        // the wrapping add, 0 silently reads the opposite edge of the inner surface. i32 is exact
+        // here, and the inner origin is at least SHADOWMAP_ATLAS_BORDER, so the sum is positive.
+        let sample_texel = vec2<u32>(vec2<i32>(rounded_local_texel) + vec2<i32>(atlas_aabb.xy));
+
+        let stored = textureLoad(shadowmapAtlas, sample_texel, 0);
+        let dist = stored - reference_depth;
+
+        // Per-tap binary compare; reverse-Z + step(0, stored - ref) ⇒ 1 = occluded.
+        let occluded = step(0.0, dist);
+
+        occluders += occluded;
+        occluder_dist_sum += dist * occluded;
+    }
+
+    return contact_harden_pcf_kernel(
+        occluders,
+        occluder_dist_sum,
+        reference_depth,
+
+    );
+}
+    `, [
+        SHADOW_POINT_DESCRIPTOR.chunk_read,
+        chunk_cone_sample_direction,
+        chunk_contact_harden_pcf_kernel,
+        chunk_get_shadow_offsets,
+        chunk_max_penumbra_percentage,
+        chunk_random,
+        chunk_uv_octahedral_unit_encode,
+        chunk_uv_to_texel_coordinate,
+        chunk_random_round_vec2,
+        chunk_random_vec2,
+    ]
+);

package/src/shade/renderer/volumetrics/GPUViewVolumetrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPUViewVolumetrics.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/volumetrics/GPUViewVolumetrics.js"],"names":[],"mappings":"AAkBA;IAgFI;;;;OAIG;IACH,qDAqBC;IAtED;;OAEG;IACH,8BAOC;IAjBD;;OAEG;IACH,2BAEC;IA6BD;;OAEG;IACH,4BAEC;IAZD;;OAEG;IACH,yBAEC;IA+CD,gBAWC;IAgGD;;;;;;;OAOG;IACH;;;MAwEC;;CAEJ"}
+{"version":3,"file":"GPUViewVolumetrics.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/volumetrics/GPUViewVolumetrics.js"],"names":[],"mappings":"AA4BA;IAyHI;;;;OAIG;IACH,qDAqBC;IA/GD;;OAEG;IACH,8BAOC;IAjBD;;OAEG;IACH,2BAEC;IA6BD;;OAEG;IACH,4BAEC;IAZD;;OAEG;IACH,yBAEC;IAwFD,gBAWC;IAiND;;;;;;;OAOG;IACH;;;MAyEC;;CAEJ"}