@woosh/meep-engine 3.54.0 → 3.55.0

package/src/shade/renderer/postprocess/gtao/chunk_gtao_resolve_hzb_depth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk_gtao_resolve_hzb_depth.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/gtao/chunk_gtao_resolve_hzb_depth.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;GAkBG;AACH,2CAFU,SAAS,CAiCjB;0BArDwB,oCAAoC"}

package/src/shade/renderer/postprocess/gtao/chunk_gtao_resolve_hzb_depth.js

@@ -0,0 +1,56 @@
+import { CAMERA_UNIFORM_STRUCT } from "../../camera/CAMERA_UNIFORM_STRUCT.js";
+import { chunk_get_view_space_depth } from "../../shader/chunk/depth/chunk_get_view_space_depth.js";
+import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
+import { GTAO_EFFECT_FALLOFF_RANGE, GTAO_EFFECT_RADIUS } from "./GTAO_CONSTANTS.js";
+
+/**
+ * Resolves a single reverse-Z device depth from an HZB `(d_min, d_max)` pair (`hzb.x` = farthest,
+ * `hzb.y` = closest in the $2^m \times 2^m$ footprint) using a discontinuity-aware slope filter.
+ *
+ * Why neither pure `hzb.y` (closest) nor pure `0.5 * (hzb.x + hzb.y)` (average) suffices alone
+ * (cf. Intel XeGTAO `DepthMIPFilter` and Tomasz Stachowiak / h3r2tic's Tiny Glade linear + point
+ * depth-sampling analysis):
+ *   - On a continuous sloped surface, reverse-Z device depth $1 / (-z_{\text{view}})$ is affine in
+ *     screen space. Taking only `hzb.y` treats each coarse $2^m \times 2^m$ texel as a flat "Duplo
+ *     brick" protruding toward the camera, causing false self-occlusion on slopes; averaging
+ *     `0.5 * (hzb.x + hzb.y)` reconstructs the smooth plane across the footprint.
+ *   - Across a silhouette edge (depth discontinuity), averaging `hzb.x` and `hzb.y` creates a
+ *     mid-air "shrink-wrap" phantom surface between foreground and background (or erodes silhouettes
+ *     against the sky). Weighting `hzb.x` down to zero when `depth_far - depth_near` exceeds the
+ *     effect falloff collapses the filter to `hzb.y` (the foreground surface).
+ *
+ * @see https://github.com/GameTechDev/XeGTAO/blob/a5b1686c7ea37788eeb3576b5be47f7c03db532c/Source/Rendering/Shaders/XeGTAO.hlsli#L622
+ * @type {CodeChunk}
+ */
+export const chunk_gtao_resolve_hzb_depth = CodeChunk.from(
+    //language=WGSL
+    `
+fn gtao_resolve_hzb_depth(
+    hzb: vec2<f32>,
+    camera: ${CAMERA_UNIFORM_STRUCT.wgsl_ref},
+) -> f32 {
+    // If any texel in the footprint is background/sky (reverse-Z depth <= 0), do not blend across
+    // the silhouette into the sky (which also avoids 0 / 0 or inf - inf under an infinite far plane).
+    if (hzb.x <= 0.0) {
+        return hzb.y;
+    }
+
+    // XeGTAO DepthMIPFilter falloff: empirically 0.75 * effectRadius works well across mips.
+    const effect_radius = 0.75 * ${GTAO_EFFECT_RADIUS};
+    const falloff_range = ${GTAO_EFFECT_FALLOFF_RANGE} * effect_radius;
+    const falloff_from = effect_radius * (1.0 - ${GTAO_EFFECT_FALLOFF_RANGE});
+    const falloff_mul = -1.0 / falloff_range;
+    const falloff_add = falloff_from / falloff_range + 1.0;
+
+    let depth_far = get_view_space_depth(hzb.x, camera);
+    let depth_near = get_view_space_depth(hzb.y, camera);
+
+    let w = saturate(fma(depth_far - depth_near, falloff_mul, falloff_add));
+
+    return mix(hzb.y, hzb.x, w / (1.0 + w));
+}
+`,
+    [
+        chunk_get_view_space_depth,
+    ]
+);

package/src/shade/renderer/postprocess/gtao/chunk_gtao_sample_depth.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Samples reverse-Z device depth for a GTAO horizon tap at `uv` and `mip_level`.
+ *
+ * - `mip_level <= 0.0` reads full-resolution `tDepth` (mip 0).
+ * - `mip_level > 0.0` reads `tHZB` at `mip_level - 1.0` (since `tHZB` mip 0 is half-resolution, i.e.
+ *   screen mip 1) in normalized UV space (matching `HierarchicalZBuffer`'s alignment-padded reduction)
+ *   and resolves the `(min, max)` depth pair through {@link chunk_gtao_resolve_hzb_depth}.
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_gtao_sample_depth: CodeChunk;
+import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
+//# sourceMappingURL=chunk_gtao_sample_depth.d.ts.map

package/src/shade/renderer/postprocess/gtao/chunk_gtao_sample_depth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk_gtao_sample_depth.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/gtao/chunk_gtao_sample_depth.js"],"names":[],"mappings":"AAQA;;;;;;;;;GASG;AACH,sCAFU,SAAS,CAqBjB;0BAnCwB,oCAAoC"}

package/src/shade/renderer/postprocess/gtao/chunk_gtao_sample_depth.js

@@ -0,0 +1,42 @@
+import { CAMERA_UNIFORM_STRUCT } from "../../camera/CAMERA_UNIFORM_STRUCT.js";
+import { SCREEN_DEPTH_RESOURCE, SCREEN_HZB_RESOURCE } from "../../shader/chunk/screen_space/SCREEN_SPACE_RESOURCES.js";
+import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
+import { ShaderResourceDescriptor } from "../../shader/resource/ShaderResourceDescriptor.js";
+import { chunk_gtao_resolve_hzb_depth } from "./chunk_gtao_resolve_hzb_depth.js";
+
+const POINT_SAMPLER_RESOURCE = ShaderResourceDescriptor.sampler("sPoint", "non-filtering");
+
+/**
+ * Samples reverse-Z device depth for a GTAO horizon tap at `uv` and `mip_level`.
+ *
+ * - `mip_level <= 0.0` reads full-resolution `tDepth` (mip 0).
+ * - `mip_level > 0.0` reads `tHZB` at `mip_level - 1.0` (since `tHZB` mip 0 is half-resolution, i.e.
+ *   screen mip 1) in normalized UV space (matching `HierarchicalZBuffer`'s alignment-padded reduction)
+ *   and resolves the `(min, max)` depth pair through {@link chunk_gtao_resolve_hzb_depth}.
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_gtao_sample_depth = CodeChunk.from(
+    //language=WGSL
+    `
+fn gtao_sample_depth(
+    uv: vec2<f32>,
+    mip_level: f32,
+    camera: ${CAMERA_UNIFORM_STRUCT.wgsl_ref},
+) -> f32 {
+    if (mip_level <= 0.0) {
+        return textureSampleLevel(tDepth, sPoint, uv, 0.0).x;
+    }
+
+    let hzb = textureSampleLevel(tHZB, sPoint, uv, mip_level - 1.0).xy;
+    return gtao_resolve_hzb_depth(hzb, camera);
+}
+`,
+    [
+        chunk_gtao_resolve_hzb_depth,
+    ]
+);
+
+chunk_gtao_sample_depth.requireResource(SCREEN_DEPTH_RESOURCE);
+chunk_gtao_sample_depth.requireResource(SCREEN_HZB_RESOURCE);
+chunk_gtao_sample_depth.requireResource(POINT_SAMPLER_RESOURCE);

package/src/shade/renderer/postprocess/gtao/fragment_shader_gtao.d.ts

@@ -1,7 +1,8 @@
 export const fragment_shader_gtao: ImageShader;
 import { GTAO_DEPTH_MIP_LEVELS } from "./GTAO_CONSTANTS.js";
+import { GTAO_DEPTH_MIP_SAMPLING_OFFSET } from "./GTAO_CONSTANTS.js";
 import { GTAO_EFFECT_FALLOFF_RANGE } from "./GTAO_CONSTANTS.js";
 import { GTAO_EFFECT_RADIUS } from "./GTAO_CONSTANTS.js";
 import { ImageShader } from "../../shader/ImageShader.js";
-export { GTAO_DEPTH_MIP_LEVELS, GTAO_EFFECT_FALLOFF_RANGE, GTAO_EFFECT_RADIUS };
+export { GTAO_DEPTH_MIP_LEVELS, GTAO_DEPTH_MIP_SAMPLING_OFFSET, GTAO_EFFECT_FALLOFF_RANGE, GTAO_EFFECT_RADIUS };
 //# sourceMappingURL=fragment_shader_gtao.d.ts.map

package/src/shade/renderer/postprocess/gtao/fragment_shader_gtao.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fragment_shader_gtao.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/gtao/fragment_shader_gtao.js"],"names":[],"mappings":"AAuUA,+CA6BG;sCAzUI,qBAAqB;0CAArB,qBAAqB;mCAArB,qBAAqB;4BAZA,6BAA6B"}
+{"version":3,"file":"fragment_shader_gtao.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/gtao/fragment_shader_gtao.js"],"names":[],"mappings":"AAgWA,+CA6BG;sCA/VI,qBAAqB;+CAArB,qBAAqB;0CAArB,qBAAqB;mCAArB,qBAAqB;4BAfA,6BAA6B"}