@woosh/meep-engine 3.52.0 → 3.54.0

package/src/shade/renderer/rasterize/native/oit/oit_resolve_fragment_body.js

@@ -2,7 +2,7 @@ import { chunk_sample_volumetrics } from "../../../deferred/chunk_sample_volumet
 import {
     chunk_resolve_power_moments_4
 } from "../../../shader/chunk/mboit/moments/power/chunk_resolve_power_moments_4.js";
-import { chunk_unjitter_uv } from "../../../shader/chunk/texture/chunk_unjitter_uv.js";
+
 import { FORWARD_VERTEX_SHADER_STRUCT } from "../../forward/FORWARD_VERTEX_SHADER_STRUCT.js";
 import { chunk_oit_linearize_depth } from "./chunk_oit_linearize_depth.js";
 import { OIT_COVERAGE_MAX } from "./OIT_CONSTANTS.js";
@@ -51,7 +51,7 @@ fn main(
 
     // need to unjitter UV to account for TAA
     var vert_adjusted = vert;
-    vert_adjusted.uv = unjitter_uv(vert.uv, view.jitter);
+
 
     let shaded = forward_shade_standard_fragment(vert_adjusted, front_facing, ${OIT_RESOLVE_LIGHT_BUDGET}u, ${OIT_RESOLVE_LIGHT_BUDGET}u);
 
@@ -99,7 +99,7 @@ export const OIT_RESOLVE_FRAGMENT_DEPENDENCIES = [
     FORWARD_VERTEX_SHADER_STRUCT.declaration_chunk,
     chunk_resolve_power_moments_4,
     chunk_oit_linearize_depth,
-    chunk_unjitter_uv,
+
     chunk_sample_volumetrics,
 ];
 

package/src/shade/renderer/rasterize/native/oit/shader_oit_generate_moments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_oit_generate_moments.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/native/oit/shader_oit_generate_moments.js"],"names":[],"mappings":"AAgJA;;;;GAIG;AACH,0CAFU,sBAAsB,CAgE7B;uCArMoC,iCAAiC"}
+{"version":3,"file":"shader_oit_generate_moments.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/native/oit/shader_oit_generate_moments.js"],"names":[],"mappings":"AAmJA;;;;GAIG;AACH,0CAFU,sBAAsB,CAgE7B;uCAxMoC,iCAAiC"}

package/src/shade/renderer/rasterize/native/oit/shader_oit_generate_moments.js

@@ -6,7 +6,7 @@ import { STANDARD_MATERIAL_TEMPLATE } from "../../../material/standard/STANDARD_
 import { chunk_F_Schlick } from "../../../shader/chunk/brdf/fresnel/chunk_F_Schlick.js";
 import { chunk_mat4_extract_position } from "../../../shader/chunk/geometry/mat4/chunk_mat4_extract_position.js";
 import { chunk_dielectric_specular_color } from "../../../shader/chunk/material/chunk_dielectric_specular_color.js";
-import { chunk_unjitter_uv } from "../../../shader/chunk/texture/chunk_unjitter_uv.js";
+import { chunk_view_mip_bias } from "../../../view/chunk_view_mip_bias.js";
 import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
 import { RenderPassColorAttachmentDescriptor } from "../../../shader/pass/RenderPassColorAttachmentDescriptor.js";
 import { ShaderResourceGroupDescriptor } from "../../../shader/resource/ShaderResourceGroupDescriptor.js";
@@ -74,9 +74,12 @@ fn main(
 ) -> Output {
 
     // compensate for TAA jitter
-    var uv = unjitter_uv(vert.uv, view.jitter);
+    let uv = vert.uv;
+    let uv_bias = view_uv_derivative_bias(view.upscale_ratio);
+    let uv_ddx = dpdx(uv) * uv_bias.x;
+    let uv_ddy = dpdy(uv) * uv_bias.y;
 
-    let t_diffuse = textureSample(texture_diffuse, texture_diffuse_sampler, uv);
+    let t_diffuse = textureSampleGrad(texture_diffuse, texture_diffuse_sampler, uv, uv_ddx, uv_ddy);
     let surface_alpha = t_diffuse.a * material_info.albedo_color.a;
 
     // MaterialX/OpenPBR transmission: when transmission_factor > 0, coverage
@@ -87,7 +90,7 @@ fn main(
     var opacity = surface_alpha;
     let f_transmission = material_info.transmission_factor;
     if (f_transmission > 0.0) {
-        let t_pbr = textureSample(texture_orm, texture_orm_sampler, uv);
+        let t_pbr = textureSampleGrad(texture_orm, texture_orm_sampler, uv, uv_ddx, uv_ddy);
         var diffuse_rgb = t_diffuse.rgb;
         diffuse_rgb /= max(t_diffuse.a, 1e-7);
         let f_metalness = t_pbr.b * material_info.metallic_factor;
@@ -135,7 +138,7 @@ fn main(
     `, [
         FORWARD_VERTEX_SHADER_STRUCT.declaration_chunk,
         chunk_oit_linearize_depth,
-        chunk_unjitter_uv,
+        chunk_view_mip_bias,
         chunk_mat4_extract_position,
         chunk_dielectric_specular_color,
         chunk_F_Schlick,

package/src/shade/renderer/rasterize/native/viz/viz_rasterization_alpha_tested_pass_descriptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"viz_rasterization_alpha_tested_pass_descriptor.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/native/viz/viz_rasterization_alpha_tested_pass_descriptor.js"],"names":[],"mappings":"AAyLA;;;;GAIG;AACH,6DAFU,sBAAsB,CAqC7B;uCA3LoC,iCAAiC"}
+{"version":3,"file":"viz_rasterization_alpha_tested_pass_descriptor.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/native/viz/viz_rasterization_alpha_tested_pass_descriptor.js"],"names":[],"mappings":"AA0LA;;;;GAIG;AACH,6DAFU,sBAAsB,CAqC7B;uCA5LoC,iCAAiC"}

package/src/shade/renderer/rasterize/native/viz/viz_rasterization_alpha_tested_pass_descriptor.js

@@ -10,7 +10,7 @@ import { chunk_scene_database_access } from "../../../scene/chunk_scene_database
 import {
     chunk_triangle_list_reverse_winding
 } from "../../../shader/chunk/geometry/triangle/chunk_triangle_list_reverse_winding.js";
-import { RENDER_GLOBAL_MIP_BIAS } from "../../../postprocess/taa/RENDER_GLOBAL_MIP_BIAS.js";
+import { chunk_view_mip_bias } from "../../../view/chunk_view_mip_bias.js";
 import {
     chunk_encode_meshlet_element
 } from "../../../shader/chunk/geometry/meshlet/chunk_encode_meshlet_element.js";
@@ -72,7 +72,7 @@ fn main(
     // Calculate mip bias based on upscale ratio. 
     // We take the average or the min of the vec2 upscale_ratio.
     // log2(2.0) = 1.0, so we subtract that to get sharper mips.
-    let mip_bias = -log2(max(view.upscale_ratio.x, view.upscale_ratio.y)) + ${RENDER_GLOBAL_MIP_BIAS};
+    let mip_bias = view_mip_bias(view.upscale_ratio);
     
     let gradient_scale = exp2(mip_bias);
     
@@ -105,7 +105,8 @@ fn main(
     `, [
         chunk_material_opacity_contract,
         chunk_transparency_hashed_alpha_threshold,
-        chunk_spatio_temporal_noise_r2_64,
+        chunk_spatio_temporal_noise_r2_64,
+        chunk_view_mip_bias,
     ]
 );
 

package/src/shade/renderer/shader/chunk/depth/chunk_query_depth_from_screen_space_bb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_query_depth_from_screen_space_bb.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/depth/chunk_query_depth_from_screen_space_bb.js"],"names":[],"mappings":"AAMA;;;GAGG;AACH,qDAFU,SAAS,CAqDZ;0BA7DmB,6BAA6B"}
+{"version":3,"file":"chunk_query_depth_from_screen_space_bb.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/depth/chunk_query_depth_from_screen_space_bb.js"],"names":[],"mappings":"AAKA;;;GAGG;AACH,qDAFU,SAAS,CAsDZ;0BA7DmB,6BAA6B"}

package/src/shade/renderer/shader/chunk/depth/chunk_query_depth_from_screen_space_bb.js

@@ -1,62 +1,62 @@
-import { CodeChunk } from "../../compiler/CodeChunk.js";
-import { AABB3_STRUCT } from "../geometry/aabb3/AABB3_STRUCT.js";
-import { chunk_min4 } from "../math/chunk_min4.js";
-import { chunk_ndc_to_uv } from "../texture/chunk_ndc_to_uv.js";
-import { chunk_uv_to_texel_coordinate } from "../texture/chunk_uv_to_texel_coordinate.js";
-
-/**
- * TODO check out this post https://x.com/anki3d/status/1713238150418518023
- * @type {CodeChunk}
- */
-export const chunk_query_depth_from_screen_space_bb = CodeChunk.from(
-    //language=WGSL
-    `
-fn query_depth_from_screen_space_bb( 
-    pb: ${AABB3_STRUCT.wgsl_ref},
-    hzb: texture_2d<f32>,
-) -> f32 {
-    var n_min = saturate( ndc_to_uv(pb.min.xy) );
-    var n_max = saturate( ndc_to_uv(pb.max.xy) );
-
-    let bb_dim = abs(n_max - n_min);
-
-    let hzb_size_u = textureDimensions(hzb);
-    let hzb_size_f = vec2<f32>(hzb_size_u);
-
-    let bb_dim_hz = bb_dim * hzb_size_f;
-    
-    let longest_edge = max(bb_dim_hz.x, bb_dim_hz.y);
-
-    let mip_level_count = textureNumLevels(hzb);
-
-    let mip_level = min( 
-        u32( ceil(log2( max(longest_edge, 1.0) ) ) ),
-        mip_level_count - 1
-    );
-    
-    let mip_resolution = hzb_size_u >> vec2(mip_level);
-
-    // sample 4 corners, we know that they fit in a 2x2 footprint at most
-    let p0 = vec2<u32>((uv_to_texel_coordinate( n_min, mip_resolution)));
-    let p3 = vec2<u32>((uv_to_texel_coordinate( n_max, mip_resolution)));
-    let p1 = vec2(p3.x, p0.y);
-    let p2 = vec2(p0.x, p3.y);
-
-    let d0 = textureLoad(hzb, p0, mip_level).x;
-    let d1 = textureLoad(hzb, p1, mip_level).x;
-    let d2 = textureLoad(hzb, p2, mip_level).x;
-    let d3 = textureLoad(hzb, p3, mip_level).x;
-
-    // value that's most far away from us
-    let min_depth = min4(d0, d1, d2, d3);
-
-    let depth_delta = pb.max.z - min_depth;
-
-    return depth_delta;
-}
-`, [
-        AABB3_STRUCT.declaration_chunk,
-        chunk_min4,
-        chunk_uv_to_texel_coordinate,
-        chunk_ndc_to_uv
-    ]);
+import { CodeChunk } from "../../compiler/CodeChunk.js";
+import { AABB3_STRUCT } from "../geometry/aabb3/AABB3_STRUCT.js";
+import { chunk_min4 } from "../math/chunk_min4.js";
+import { chunk_ndc_to_uv } from "../texture/chunk_ndc_to_uv.js";
+
+/**
+ * TODO check out this post https://x.com/anki3d/status/1713238150418518023
+ * @type {CodeChunk}
+ */
+export const chunk_query_depth_from_screen_space_bb = CodeChunk.from(
+    //language=WGSL
+    `
+fn query_depth_from_screen_space_bb( 
+    pb: ${AABB3_STRUCT.wgsl_ref},
+    hzb: texture_2d<f32>,
+) -> f32 {
+    var n_min = saturate( ndc_to_uv(pb.min.xy) );
+    var n_max = saturate( ndc_to_uv(pb.max.xy) );
+
+    let bb_dim = abs(n_max - n_min);
+
+    let hzb_size_u = textureDimensions(hzb);
+    let hzb_size_f = vec2<f32>(hzb_size_u);
+
+    let bb_dim_hz = bb_dim * hzb_size_f;
+    
+    let longest_edge = max(bb_dim_hz.x, bb_dim_hz.y);
+
+    let mip_level_count = textureNumLevels(hzb);
+
+    let mip_level = min( 
+        u32( ceil(log2( max(longest_edge, 1.0) ) ) ),
+        mip_level_count - 1
+    );
+    
+    let mip_resolution = textureDimensions(hzb, mip_level);
+    let mip_resolution_f = vec2<f32>(mip_resolution);
+    let max_coord = mip_resolution - vec2(1u);
+
+    // sample 4 corners, we know that they fit in a 2x2 footprint at most
+    let p0 = min(vec2<u32>(n_min * mip_resolution_f), max_coord);
+    let p3 = min(vec2<u32>(n_max * mip_resolution_f), max_coord);
+    let p1 = vec2(p3.x, p0.y);
+    let p2 = vec2(p0.x, p3.y);
+
+    let d0 = textureLoad(hzb, p0, mip_level).x;
+    let d1 = textureLoad(hzb, p1, mip_level).x;
+    let d2 = textureLoad(hzb, p2, mip_level).x;
+    let d3 = textureLoad(hzb, p3, mip_level).x;
+
+    // value that's most far away from us
+    let min_depth = min4(d0, d1, d2, d3);
+
+    let depth_delta = pb.max.z - min_depth;
+
+    return depth_delta;
+}
+`, [
+        AABB3_STRUCT.declaration_chunk,
+        chunk_min4,
+        chunk_ndc_to_uv
+    ]);

package/src/shade/renderer/shader/chunk/random/lowbias/chunk_hash_lowbias32_vec2u.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @type {CodeChunk}
+ */
+export const chunk_hash_lowbias32_vec2u: CodeChunk;
+import { CodeChunk } from "../../../compiler/CodeChunk.js";
+//# sourceMappingURL=chunk_hash_lowbias32_vec2u.d.ts.map

package/src/shade/renderer/shader/chunk/random/lowbias/chunk_hash_lowbias32_vec2u.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk_hash_lowbias32_vec2u.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/shader/chunk/random/lowbias/chunk_hash_lowbias32_vec2u.js"],"names":[],"mappings":"AAGA;;GAEG;AACH,yCAFU,SAAS,CAclB;0BAlByB,gCAAgC"}

package/src/shade/renderer/shader/chunk/random/lowbias/chunk_hash_lowbias32_vec2u.js

@@ -0,0 +1,19 @@
+import { CodeChunk } from "../../../compiler/CodeChunk.js";
+import { chunk_hash_lowbias32 } from "../chunk_hash_lowbias32.js";
+
+/**
+ * @type {CodeChunk}
+ */
+export const chunk_hash_lowbias32_vec2u = CodeChunk.from(
+    //language=WGSL
+    `
+fn hash_lowbias32_vec2u(v:vec2<u32>) -> u32{
+    let combined = v.x * 0x85ebca6bu + 
+                   v.y * 0xc2b2ae35u;
+                   
+    return hash_lowbias32(combined);
+}
+    `,[
+        chunk_hash_lowbias32,
+    ]
+)

package/src/shade/renderer/shader/chunk/screen_space/chunk_ffx_sssr_get_mip_resolution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_ffx_sssr_get_mip_resolution.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/screen_space/chunk_ffx_sssr_get_mip_resolution.js"],"names":[],"mappings":"AAEA,0DAOE;0BATwB,6BAA6B"}
+{"version":3,"file":"chunk_ffx_sssr_get_mip_resolution.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/screen_space/chunk_ffx_sssr_get_mip_resolution.js"],"names":[],"mappings":"AAGA,0DAUE;0BAbwB,6BAA6B"}

package/src/shade/renderer/shader/chunk/screen_space/chunk_ffx_sssr_get_mip_resolution.js

@@ -1,10 +1,16 @@
-import { CodeChunk } from "../../compiler/CodeChunk.js";
-
-export const chunk_ffx_sssr_get_mip_resolution = CodeChunk.from(
-    //language=WGSL
-    `
-fn ffx_sssr_get_mip_resolution(screen_dimensions:vec2<f32>, mip_level:i32) -> vec2<f32>{
-    return screen_dimensions * pow(0.5, f32(mip_level));
-}
-    `
-);
+import { CodeChunk } from "../../compiler/CodeChunk.js";
+import { SCREEN_HZB_RESOURCE } from "./SCREEN_SPACE_RESOURCES.js";
+
+export const chunk_ffx_sssr_get_mip_resolution = CodeChunk.from(
+    //language=WGSL
+    `
+fn ffx_sssr_get_mip_resolution(screen_dimensions:vec2<f32>, mip_level:i32) -> vec2<f32>{
+    if (mip_level <= 0) {
+        return screen_dimensions;
+    }
+    return vec2<f32>(textureDimensions(tHZB, mip_level - 1));
+}
+    `
+);
+
+chunk_ffx_sssr_get_mip_resolution.requireResource(SCREEN_HZB_RESOURCE);

package/src/shade/renderer/shader/chunk/screen_space/chunk_ffx_sssr_hierarchical_raymarch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_ffx_sssr_hierarchical_raymarch.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/screen_space/chunk_ffx_sssr_hierarchical_raymarch.js"],"names":[],"mappings":"AASA;;;;;;GAMG;AACH,mDAFU,SAAS,CAqGZ;0BAlHmB,6BAA6B"}
+{"version":3,"file":"chunk_ffx_sssr_hierarchical_raymarch.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/screen_space/chunk_ffx_sssr_hierarchical_raymarch.js"],"names":[],"mappings":"AASA;;;;;;GAMG;AACH,mDAFU,SAAS,CAuGZ;0BApHmB,6BAA6B"}

package/src/shade/renderer/shader/chunk/screen_space/chunk_ffx_sssr_hierarchical_raymarch.js

@@ -1,117 +1,118 @@
-import { chunk_is_background } from "../depth/chunk_is_background.js";
-import { CodeChunk } from "../../compiler/CodeChunk.js";
-import { chunk_rcp_v2 } from "../geometry/vec2/chunk_rcp_v2.js";
-import { F32_MAX_DEFINITION } from "../math/F32_MAX_DEFINITION.js";
-import { chunk_ffx_sssr_advance_ray } from "./chunk_ffx_sssr_advance_ray.js";
-import { chunk_ffx_sssr_get_mip_resolution } from "./chunk_ffx_sssr_get_mip_resolution.js";
-import { chunk_ffx_sssr_initial_advance_ray } from "./chunk_ffx_sssr_initial_advance_ray.js";
-import { chunk_ffx_sssr_load_depth } from "./chunk_ffx_sssr_load_depth.js";
-
-/**
- *
- * Requires origin and direction of the ray to be in screen space [0, 1] x [0, 1]
- * NOTE: "low occupancy" exit was removed, as WebGPU doesn't have pre-requisite API for it
- * @see https://github.com/GPUOpen-LibrariesAndSDKs/FidelityFX-SDK/blob/1bbe66e7ea0d358e84af4471a90aa9c35b583de0/samples/hybridreflections/shaders/ffx_sssr_intersect.h#L110
- * @type {CodeChunk}
- */
-export const chunk_ffx_sssr_hierarchical_raymarch = CodeChunk.from(
-    //language=WGSL
-    `
-fn ffx_sssr_hierarchical_raymarch(
-    origin: vec3<f32>,
-    direction: vec3<f32>,
-    screen_size: vec2<f32>,
-    most_detailed_mip: i32,
-    max_traversal_intersections:u32,
-    valid_hit: ptr<function, bool>,
-    _num_iters: ptr<function, u32>,
-) -> vec3<f32> {
-
-    let inv_direction = select( vec3(F32_MAX), 1.0 / direction, abs(direction) > vec3(1.0e-12));
-
-    // Start on mip with highest detail.
-    var current_mip = most_detailed_mip;
-
-    // Could recompute these every iteration, but it's faster to hoist them out and update them.
-    var current_mip_resolution     = ffx_sssr_get_mip_resolution(screen_size, current_mip);
-    var current_mip_resolution_inv = 1.0 / (current_mip_resolution);
-
-    // Offset to the bounding boxes uv space to intersect the ray with the center of the next pixel.
-    // This means we ever so slightly over shoot into the next region.
-    var uv_offset = 0.005 * exp2(f32(most_detailed_mip)) / screen_size;
-    uv_offset        = select( uv_offset, -uv_offset, direction.xy < vec2(0.0) );
-
-    // Offset applied depending on current mip resolution to move the boundary to the left/right upper/lower border depending on ray direction.
-    let floor_offset = select(vec2(1.0), vec2(0.0), direction.xy < vec2(0.0)); // TODO can replace with 'step'
-
-    // Initially advance ray to avoid immediate self intersections.
-    var current_t:f32;
-    var position:vec3<f32>;
-    
-    ffx_sssr_initial_advance_ray(
-        origin, 
-        direction,
-        inv_direction,
-        current_mip_resolution,
-        current_mip_resolution_inv,
-        floor_offset,
-        uv_offset,
-        &position,
-        &current_t
-    );
-    
-    var i = 0u;
-    for (
-        ;
-        i < max_traversal_intersections && current_mip >= most_detailed_mip;
-        i++
-    ) {
-        
-        if (any(position.xy > vec2(1.0, 1.0)) || any(position.xy < vec2(0.0, 0.0))){
-            // outside of the viewport
-            break;
-        }
-
-        if (is_background(position.z)){
-            // hit sky/background, out of Z bounds basically
-            break;
-        }
-
-        let current_mip_position = current_mip_resolution * position.xy;
-        let surface_z            = ffx_sssr_load_depth(vec2<i32>(current_mip_position), current_mip);
-        
-        let skipped_tile = ffx_sssr_advance_ray(
-                origin,
-                direction,
-                inv_direction,
-                current_mip_position,
-                current_mip_resolution_inv,
-                floor_offset,
-                uv_offset,
-                surface_z,
-                &position,
-                &current_t
-        );
-        
-        current_mip += select(-1, 1, skipped_tile );
-        current_mip_resolution *= select(2.0, 0.5, skipped_tile);
-        current_mip_resolution_inv *=  select(0.5, 2.0, skipped_tile);
-        
-    }
-    
-    *_num_iters = i;
-    
-    *valid_hit = (current_mip <= most_detailed_mip && i > 0);
-
-    return position;
-}
-`, [
-        F32_MAX_DEFINITION,
-        chunk_rcp_v2,
-        chunk_ffx_sssr_get_mip_resolution,
-        chunk_ffx_sssr_initial_advance_ray,
-        chunk_ffx_sssr_advance_ray,
-        chunk_ffx_sssr_load_depth,
-        chunk_is_background
-    ]);
-
+import { chunk_is_background } from "../depth/chunk_is_background.js";
+import { CodeChunk } from "../../compiler/CodeChunk.js";
+import { chunk_rcp_v2 } from "../geometry/vec2/chunk_rcp_v2.js";
+import { F32_MAX_DEFINITION } from "../math/F32_MAX_DEFINITION.js";
+import { chunk_ffx_sssr_advance_ray } from "./chunk_ffx_sssr_advance_ray.js";
+import { chunk_ffx_sssr_get_mip_resolution } from "./chunk_ffx_sssr_get_mip_resolution.js";
+import { chunk_ffx_sssr_initial_advance_ray } from "./chunk_ffx_sssr_initial_advance_ray.js";
+import { chunk_ffx_sssr_load_depth } from "./chunk_ffx_sssr_load_depth.js";
+
+/**
+ *
+ * Requires origin and direction of the ray to be in screen space [0, 1] x [0, 1]
+ * NOTE: "low occupancy" exit was removed, as WebGPU doesn't have pre-requisite API for it
+ * @see https://github.com/GPUOpen-LibrariesAndSDKs/FidelityFX-SDK/blob/1bbe66e7ea0d358e84af4471a90aa9c35b583de0/samples/hybridreflections/shaders/ffx_sssr_intersect.h#L110
+ * @type {CodeChunk}
+ */
+export const chunk_ffx_sssr_hierarchical_raymarch = CodeChunk.from(
+    //language=WGSL
+    `
+fn ffx_sssr_hierarchical_raymarch(
+    origin: vec3<f32>,
+    direction: vec3<f32>,
+    screen_size: vec2<f32>,
+    most_detailed_mip: i32,
+    max_traversal_intersections:u32,
+    valid_hit: ptr<function, bool>,
+    _num_iters: ptr<function, u32>,
+) -> vec3<f32> {
+
+    let inv_direction = select( vec3(F32_MAX), 1.0 / direction, abs(direction) > vec3(1.0e-12));
+    let max_mip = i32(textureNumLevels(tHZB));
+
+    // Start on mip with highest detail.
+    var current_mip = min(most_detailed_mip, max_mip);
+
+    var current_mip_resolution     = ffx_sssr_get_mip_resolution(screen_size, current_mip);
+    var current_mip_resolution_inv = 1.0 / (current_mip_resolution);
+
+    // Offset to the bounding boxes uv space to intersect the ray with the center of the next pixel.
+    // This means we ever so slightly over shoot into the next region.
+    var uv_offset = 0.005 * exp2(f32(most_detailed_mip)) / screen_size;
+    uv_offset        = select( uv_offset, -uv_offset, direction.xy < vec2(0.0) );
+
+    // Offset applied depending on current mip resolution to move the boundary to the left/right upper/lower border depending on ray direction.
+    let floor_offset = select(vec2(1.0), vec2(0.0), direction.xy < vec2(0.0)); // TODO can replace with 'step'
+
+    // Initially advance ray to avoid immediate self intersections.
+    var current_t:f32;
+    var position:vec3<f32>;
+    
+    ffx_sssr_initial_advance_ray(
+        origin, 
+        direction,
+        inv_direction,
+        current_mip_resolution,
+        current_mip_resolution_inv,
+        floor_offset,
+        uv_offset,
+        &position,
+        &current_t
+    );
+    
+    var i = 0u;
+    for (
+        ;
+        i < max_traversal_intersections && current_mip >= most_detailed_mip;
+        i++
+    ) {
+        
+        if (any(position.xy > vec2(1.0, 1.0)) || any(position.xy < vec2(0.0, 0.0))){
+            // outside of the viewport
+            break;
+        }
+
+        if (is_background(position.z)){
+            // hit sky/background, out of Z bounds basically
+            break;
+        }
+
+        let current_mip_position = current_mip_resolution * position.xy;
+        let surface_z            = ffx_sssr_load_depth(vec2<i32>(current_mip_position), current_mip);
+        
+        let skipped_tile = ffx_sssr_advance_ray(
+                origin,
+                direction,
+                inv_direction,
+                current_mip_position,
+                current_mip_resolution_inv,
+                floor_offset,
+                uv_offset,
+                surface_z,
+                &position,
+                &current_t
+        );
+        
+        current_mip = min(current_mip + select(-1, 1, skipped_tile), max_mip);
+        if (current_mip >= most_detailed_mip) {
+            current_mip_resolution = ffx_sssr_get_mip_resolution(screen_size, current_mip);
+            current_mip_resolution_inv = 1.0 / current_mip_resolution;
+        }
+        
+    }
+    
+    *_num_iters = i;
+    
+    *valid_hit = (current_mip <= most_detailed_mip && i > 0);
+
+    return position;
+}
+`, [
+        F32_MAX_DEFINITION,
+        chunk_rcp_v2,
+        chunk_ffx_sssr_get_mip_resolution,
+        chunk_ffx_sssr_initial_advance_ray,
+        chunk_ffx_sssr_advance_ray,
+        chunk_ffx_sssr_load_depth,
+        chunk_is_background
+    ]);

package/src/shade/renderer/shadow/map/GPUSceneShadowmapContext.js

@@ -82,7 +82,7 @@ import { VSM_SLOT_EMPTY } from "../vsm/VSM_SLOT_STRUCT.js";
  * @typedef {import("../../buffer/table/serde/generate_record_writer.js").GPURecordWriter} GPURecordWriter
  */
 
-const DEFAULT_SHADOWMAP_ATLAS_RESOLUTION = 4096 * 2;
+const DEFAULT_SHADOWMAP_ATLAS_RESOLUTION = 4096;
 
 /**
  * Resolution by cascade.

package/src/shade/renderer/texture/SAMPLER_ANISOTROPIC_CLAMP.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Anisotropic trilinear clamp-to-edge sampler (`magFilter: "linear"`, `minFilter: "linear"`,
+ * `mipmapFilter: "linear"`, `maxAnisotropy: 16`).
+ * Use for mipmapped 3D scene atlases (such as decal and particle atlases) that undergo both
+ * minification and oblique-angle projection in world space.
+ */
+export const SAMPLER_ANISOTROPIC_CLAMP: Readonly<SamplerDescriptor>;
+import { SamplerDescriptor } from "../../descriptor/texture/SamplerDescriptor.js";
+//# sourceMappingURL=SAMPLER_ANISOTROPIC_CLAMP.d.ts.map

package/src/shade/renderer/texture/SAMPLER_ANISOTROPIC_CLAMP.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SAMPLER_ANISOTROPIC_CLAMP.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/texture/SAMPLER_ANISOTROPIC_CLAMP.js"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,oEAQI;kCAhB8B,+CAA+C"}

package/src/shade/renderer/texture/SAMPLER_ANISOTROPIC_CLAMP.js

@@ -0,0 +1,17 @@
+import { SamplerDescriptor } from "../../descriptor/texture/SamplerDescriptor.js";
+
+/**
+ * Anisotropic trilinear clamp-to-edge sampler (`magFilter: "linear"`, `minFilter: "linear"`,
+ * `mipmapFilter: "linear"`, `maxAnisotropy: 16`).
+ * Use for mipmapped 3D scene atlases (such as decal and particle atlases) that undergo both
+ * minification and oblique-angle projection in world space.
+ */
+export const SAMPLER_ANISOTROPIC_CLAMP = Object.freeze(SamplerDescriptor.from({
+    addressModeU: "clamp-to-edge",
+    addressModeV: "clamp-to-edge",
+    addressModeW: "clamp-to-edge",
+    magFilter: "linear",
+    minFilter: "linear",
+    mipmapFilter: "linear",
+    maxAnisotropy: 16,
+}));

package/src/shade/renderer/texture/SAMPLER_LINEAR_UPSCALE.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Magnification-only linear clamp sampler (`magFilter: "linear"`, `minFilter: "nearest"`,
+ * `mipmapFilter: "nearest"`, `maxAnisotropy: 1`).
+ *
+ * Intended ONLY for upscaling single-mip 2D render targets (e.g. post-processing upsampling).
+ * Do NOT use for 3D scene textures, atlases, or mipmapped targets that undergo minification —
+ * use `SAMPLER_TRILINEAR_CLAMP` or `SAMPLER_ANISOTROPIC_CLAMP` instead.
+ */
 export const SAMPLER_LINEAR_UPSCALE: Readonly<SamplerDescriptor>;
 export const SAMPLER_LINEAR_DOWNSCALE: Readonly<SamplerDescriptor>;
 export const SAMPLER_NEAREST: Readonly<SamplerDescriptor>;

package/src/shade/renderer/texture/SAMPLER_LINEAR_UPSCALE.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SAMPLER_LINEAR_UPSCALE.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/texture/SAMPLER_LINEAR_UPSCALE.js"],"names":[],"mappings":"AAEA,iEAKI;AAEJ,mEAIG;AAEH,0DAII;kCAnB8B,+CAA+C"}
+{"version":3,"file":"SAMPLER_LINEAR_UPSCALE.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/texture/SAMPLER_LINEAR_UPSCALE.js"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,iEAKI;AAEJ,mEAIG;AAEH,0DAII;kCA3B8B,+CAA+C"}