@woosh/meep-engine 3.52.0 → 3.53.0

package/src/shade/renderer/rasterize/forward/chunk_forward_shade_standard_fragment.js

@@ -24,7 +24,9 @@ import { MATERIAL_SHADING_INFO_STRUCT } from "../../shader/chunk/material/MATERI
 import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
 import { chunk_forward_sample_indirect } from "./chunk_forward_sample_indirect.js";
 import { FORWARD_VERTEX_SHADER_STRUCT } from "./FORWARD_VERTEX_SHADER_STRUCT.js";
-import { CAMERA_RESOURCE } from "../../camera/CAMERA_RESOURCE.js";
+import { CAMERA_RESOURCE } from "../../camera/CAMERA_RESOURCE.js";
+import { VIEW_RESOURCE } from "../../view/VIEW_RESOURCE.js";
+import { chunk_view_mip_bias } from "../../view/chunk_view_mip_bias.js";
 import {
     MATERIAL_DIFFUSE_SAMPLER_RESOURCE,
     MATERIAL_DIFFUSE_TEXTURE_RESOURCE,
@@ -55,7 +57,11 @@ fn forward_shade_standard_fragment(
 ) -> vec4f {
     let world_tangent_frame = build_orthonormal_matrix_nt(vert.normal, vert.tangent);
 
-    let t_normal = decode_tangent_normal(textureSample(texture_normal, texture_normal_sampler, vert.uv));
+    let uv_bias = view_uv_derivative_bias(view.upscale_ratio);
+    let uv_ddx = dpdx(vert.uv) * uv_bias.x;
+    let uv_ddy = dpdy(vert.uv) * uv_bias.y;
+
+    let t_normal = decode_tangent_normal(textureSampleGrad(texture_normal, texture_normal_sampler, vert.uv, uv_ddx, uv_ddy));
     var world_shading_normal:vec3<f32> = normalize( world_tangent_frame * t_normal );
 
     // flip the normal when looking at the surface's back. The raw front_facing cannot say:
@@ -77,9 +83,9 @@ fn forward_shade_standard_fragment(
         view_direction: 'view_direction',
     })};
 
-    let t_pbr = textureSample(texture_orm, texture_orm_sampler, vert.uv);
-    let t_diffuse = textureSample(texture_diffuse, texture_diffuse_sampler, vert.uv);
-    let t_emissive = textureSample(texture_emissive, texture_emissive_sampler, vert.uv);
+    let t_pbr = textureSampleGrad(texture_orm, texture_orm_sampler, vert.uv, uv_ddx, uv_ddy);
+    let t_diffuse = textureSampleGrad(texture_diffuse, texture_diffuse_sampler, vert.uv, uv_ddx, uv_ddy);
+    let t_emissive = textureSampleGrad(texture_emissive, texture_emissive_sampler, vert.uv, uv_ddx, uv_ddy);
 
     // the vertex stage hands on the vertex's own colour; the material's is applied here
     var diffuse = t_diffuse.rgb * vert.color * material_info.albedo_color.rgb;
@@ -203,11 +209,13 @@ fn forward_shade_standard_fragment(
         chunk_compute_indirect_specular,
         chunk_forward_sample_indirect,
         chunk_compute_specular_occlusion,
-        chunk_material_draw_side,
+        chunk_material_draw_side,
+        chunk_view_mip_bias,
     ]
 )
 
-chunk_forward_shade_standard_fragment.requireResource(CAMERA_RESOURCE);
+chunk_forward_shade_standard_fragment.requireResource(CAMERA_RESOURCE);
+chunk_forward_shade_standard_fragment.requireResource(VIEW_RESOURCE);
 chunk_forward_shade_standard_fragment.requireResource(MATERIAL_INFO_RESOURCE);
 chunk_forward_shade_standard_fragment.requireResource(MATERIAL_DIFFUSE_TEXTURE_RESOURCE);
 chunk_forward_shade_standard_fragment.requireResource(MATERIAL_DIFFUSE_SAMPLER_RESOURCE);

package/src/shade/renderer/rasterize/native/avboit/avboit_draw_fragment_body.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"avboit_draw_fragment_body.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/native/avboit/avboit_draw_fragment_body.js"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,uCAFU,MAAM,CAE2B;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wCAFU,MAAM,CAoEV;AAEN;;;GAGG;AACH,gDAFU,WAAW,CAWnB;AAEF;;;GAGG;AACH,kCAFU,qBAAqB,CAiB3B"}
+{"version":3,"file":"avboit_draw_fragment_body.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/native/avboit/avboit_draw_fragment_body.js"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,uCAFU,MAAM,CAE2B;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wCAFU,MAAM,CAsEV;AAEN;;;GAGG;AACH,gDAFU,WAAW,CAWnB;AAEF;;;GAGG;AACH,kCAFU,qBAAqB,CAiB3B"}

package/src/shade/renderer/rasterize/native/avboit/avboit_draw_fragment_body.js

@@ -1,6 +1,6 @@
 import { chunk_sample_volumetrics } from "../../../deferred/chunk_sample_volumetrics.js";
 import { chunk_get_view_space_depth } from "../../../shader/chunk/depth/chunk_get_view_space_depth.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 { FORWARD_VERTEX_SHADER_STRUCT } from "../../forward/FORWARD_VERTEX_SHADER_STRUCT.js";
 import { OIT_COVERAGE_MAX } from "../oit/OIT_CONSTANTS.js";
 import { AVBOIT_EXTINCT_TRANSMITTANCE } from "./AVBOIT_CONSTANTS.js";
@@ -66,7 +66,9 @@ fn main(
 
     // need to unjitter UV to account for TAA
     var vert_adjusted = vert;
-    vert_adjusted.uv = unjitter_uv(vert.uv, view.jitter);
+    let uv_bias = view_uv_derivative_bias(view.upscale_ratio);
+    let uv_ddx = dpdx(vert.uv) * uv_bias.x;
+    let uv_ddy = dpdy(vert.uv) * uv_bias.y;
 
     // linear view depth (vert.position is @builtin(position); .z is device depth) and screen uv,
     // for the volume lookup and the fog composite alike
@@ -98,7 +100,7 @@ fn main(
     var tint = vec3<f32>(1.0);
     let f_transmission = material_info.transmission_factor;
     if (f_transmission > 0.0) {
-        let t_diffuse = textureSample(texture_diffuse, texture_diffuse_sampler, vert_adjusted.uv);
+        let t_diffuse = textureSampleGrad(texture_diffuse, texture_diffuse_sampler, vert_adjusted.uv, uv_ddx, uv_ddy);
         let base_color = (t_diffuse.rgb / max(t_diffuse.a, 1e-7)) * vert.color * material_info.albedo_color.rgb;
         tint = avboit_transmission_tint(base_color, f_transmission * f32(warp.tint_from_base_color));
     }
@@ -122,7 +124,7 @@ fn main(
  */
 export const AVBOIT_DRAW_FRAGMENT_DEPENDENCIES = [
     FORWARD_VERTEX_SHADER_STRUCT.declaration_chunk,
-    chunk_unjitter_uv,
+    chunk_view_mip_bias,
     chunk_get_view_space_depth,
     chunk_sample_volumetrics,
     chunk_avboit_view_depth_to_virtual,

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/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"}

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

@@ -1,20 +1,28 @@
-import { SamplerDescriptor } from "../../descriptor/texture/SamplerDescriptor.js";
-
-export const SAMPLER_LINEAR_UPSCALE = Object.freeze(SamplerDescriptor.from({
-    magFilter: "linear",
-    addressModeU: "clamp-to-edge",
-    addressModeV: "clamp-to-edge",
-    addressModeW: "clamp-to-edge",
-}));
-
-export const SAMPLER_LINEAR_DOWNSCALE = Object.freeze(SamplerDescriptor.from({
-    minFilter: "linear",
-    addressModeU: "clamp-to-edge",
-    addressModeV: "clamp-to-edge"
-}))
-
-export const SAMPLER_NEAREST = Object.freeze(SamplerDescriptor.from({
-    magFilter: "nearest",
-    addressModeU: "clamp-to-edge",
-    addressModeV: "clamp-to-edge"
-}));
+import { SamplerDescriptor } from "../../descriptor/texture/SamplerDescriptor.js";
+
+/**
+ * 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 = Object.freeze(SamplerDescriptor.from({
+    magFilter: "linear",
+    addressModeU: "clamp-to-edge",
+    addressModeV: "clamp-to-edge",
+    addressModeW: "clamp-to-edge",
+}));
+
+export const SAMPLER_LINEAR_DOWNSCALE = Object.freeze(SamplerDescriptor.from({
+    minFilter: "linear",
+    addressModeU: "clamp-to-edge",
+    addressModeV: "clamp-to-edge"
+}))
+
+export const SAMPLER_NEAREST = Object.freeze(SamplerDescriptor.from({
+    magFilter: "nearest",
+    addressModeU: "clamp-to-edge",
+    addressModeV: "clamp-to-edge"
+}));

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

@@ -0,0 +1,8 @@
+/**
+ * Trilinear clamp-to-edge sampler (`magFilter: "linear"`, `minFilter: "linear"`, `mipmapFilter: "linear"`).
+ * Use for mipmapped 2D render targets and LUTs where linear filtering is required across both
+ * magnification/minification and mip levels without anisotropic footprint expansion.
+ */
+export const SAMPLER_TRILINEAR_CLAMP: Readonly<SamplerDescriptor>;
+import { SamplerDescriptor } from "../../descriptor/texture/SamplerDescriptor.js";
+//# sourceMappingURL=SAMPLER_TRILINEAR_CLAMP.d.ts.map

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

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

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

@@ -0,0 +1,15 @@
+import { SamplerDescriptor } from "../../descriptor/texture/SamplerDescriptor.js";
+
+/**
+ * Trilinear clamp-to-edge sampler (`magFilter: "linear"`, `minFilter: "linear"`, `mipmapFilter: "linear"`).
+ * Use for mipmapped 2D render targets and LUTs where linear filtering is required across both
+ * magnification/minification and mip levels without anisotropic footprint expansion.
+ */
+export const SAMPLER_TRILINEAR_CLAMP = Object.freeze(SamplerDescriptor.from({
+    addressModeU: "clamp-to-edge",
+    addressModeV: "clamp-to-edge",
+    addressModeW: "clamp-to-edge",
+    magFilter: "linear",
+    minFilter: "linear",
+    mipmapFilter: "linear",
+}));

package/src/shade/renderer/view/chunk_view_mip_bias.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Multiplier applied to screen-space UV derivatives before dividing by `view.upscale_ratio`
+ * to bias texture mip selection for temporal super-sampling (TAAU / NSS).
+ *
+ * @type {number}
+ */
+export const RENDER_MIP_DERIVATIVE_BIAS: number;
+/**
+ * Shared WGSL helpers for biasing screen-space UV derivatives and mip levels according to
+ * the active internal resolution scale (`view.upscale_ratio = output_resolution / internal_resolution`)
+ * and global TAA mip bias ({@link RENDER_GLOBAL_MIP_BIAS}).
+ *
+ * When rendering at reduced internal resolution (`upscale_ratio > 1.0`), raw screen-space
+ * derivatives (`dpdx` / `dpdy` or finite differences across internal pixels) measure the
+ * coarser internal pixel footprint rather than the final output pixel footprint reconstructed
+ * by temporal upscaling. Scaling derivatives by `view_uv_derivative_bias(view.upscale_ratio)`
+ * ensures mip selection and anisotropic filtering match the target output resolution.
+ */
+export const chunk_view_mip_bias: CodeChunk;
+import { CodeChunk } from "../shader/compiler/CodeChunk.js";
+//# sourceMappingURL=chunk_view_mip_bias.d.ts.map

package/src/shade/renderer/view/chunk_view_mip_bias.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk_view_mip_bias.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/view/chunk_view_mip_bias.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,yCAFU,MAAM,CAE2D;AAE3E;;;;;;;;;;GAUG;AACH,4CAqBE;0BA1CwB,iCAAiC"}

package/src/shade/renderer/view/chunk_view_mip_bias.js

@@ -0,0 +1,44 @@
+import { RENDER_GLOBAL_MIP_BIAS } from "../postprocess/taa/RENDER_GLOBAL_MIP_BIAS.js";
+import { CodeChunk } from "../shader/compiler/CodeChunk.js";
+
+/**
+ * Multiplier applied to screen-space UV derivatives before dividing by `view.upscale_ratio`
+ * to bias texture mip selection for temporal super-sampling (TAAU / NSS).
+ *
+ * @type {number}
+ */
+export const RENDER_MIP_DERIVATIVE_BIAS = 1 / (1 - RENDER_GLOBAL_MIP_BIAS);
+
+/**
+ * Shared WGSL helpers for biasing screen-space UV derivatives and mip levels according to
+ * the active internal resolution scale (`view.upscale_ratio = output_resolution / internal_resolution`)
+ * and global TAA mip bias ({@link RENDER_GLOBAL_MIP_BIAS}).
+ *
+ * When rendering at reduced internal resolution (`upscale_ratio > 1.0`), raw screen-space
+ * derivatives (`dpdx` / `dpdy` or finite differences across internal pixels) measure the
+ * coarser internal pixel footprint rather than the final output pixel footprint reconstructed
+ * by temporal upscaling. Scaling derivatives by `view_uv_derivative_bias(view.upscale_ratio)`
+ * ensures mip selection and anisotropic filtering match the target output resolution.
+ */
+export const chunk_view_mip_bias = CodeChunk.from(
+    //language=WGSL
+    `
+const RENDER_MIP_DERIVATIVE_BIAS: f32 = ${RENDER_MIP_DERIVATIVE_BIAS.toFixed(8)};
+const RENDER_GLOBAL_MIP_BIAS: f32 = ${RENDER_GLOBAL_MIP_BIAS.toFixed(8)};
+
+/**
+ * Per-axis multiplier for screen-space UV gradients (\`ddx\` by \`.x\`, \`ddy\` by \`.y\`)
+ * that accounts for both temporal upscaling (\`upscale_ratio\`) and global TAA mip bias.
+ */
+fn view_uv_derivative_bias(upscale_ratio: vec2<f32>) -> vec2<f32> {
+    return vec2<f32>(RENDER_MIP_DERIVATIVE_BIAS) / upscale_ratio;
+}
+
+/**
+ * Scalar LOD bias (in mip levels) corresponding to \`upscale_ratio\` and global TAA mip bias.
+ */
+fn view_mip_bias(upscale_ratio: vec2<f32>) -> f32 {
+    return -log2(max(upscale_ratio.x, upscale_ratio.y)) + RENDER_GLOBAL_MIP_BIAS;
+}
+`
+);

package/src/shade/wgsl/emulator/WGSLJavaScriptCompiler.js

@@ -2975,7 +2975,7 @@ function inferBuiltinReturnType(name, args) {
         // the two values; the third argument is the condition
         return commonArgumentType(args.slice(0, 2));
     }
-    if (name === 'textureLoad' || name === 'textureSampleLevel' || name === 'textureSample' || name === 'textureSampleGrad') {
+    if (name === 'textureLoad' || name === 'textureSampleLevel' || name === 'textureSample' || name === 'textureSampleBias' || name === 'textureSampleGrad') {
         return { kind: 'vec', size: 4, scalar: 'f32' };
     }
     // Both gathers return the four texels of a 2x2 footprint. Saying so here matters more than

package/src/shade/wgsl/emulator/WGSLLanguageCore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WGSLLanguageCore.d.ts","sourceRoot":"","sources":["../../../../../src/shade/wgsl/emulator/WGSLLanguageCore.js"],"names":[],"mappings":";IA6jDA;;;;;;;;;;;;;;OAcG;IACH,+DAmDC"}
+{"version":3,"file":"WGSLLanguageCore.d.ts","sourceRoot":"","sources":["../../../../../src/shade/wgsl/emulator/WGSLLanguageCore.js"],"names":[],"mappings":";IA4oDA;;;;;;;;;;;;;;OAcG;IACH,+DAmDC"}

package/src/shade/wgsl/emulator/WGSLLanguageCore.js

@@ -1067,7 +1067,8 @@ export const WGSLLanguageCore = {
     },
 
     /**
-     * `textureSampleLevel(t, s, coords, level) -> vec4<T>`
+     * `textureSampleLevel(t, s, coords, level[, offset]) -> vec4<T>` and the texture_2d_array form
+     * `textureSampleLevel(t, s, coords, array_index, level[, offset])`.
      *
      * Filtered sample at normalised UV coords. Honours the sampler's
      * address modes and `magFilter`. `coords` length matches the texture
@@ -1076,33 +1077,59 @@ export const WGSLLanguageCore = {
      * @param {import("./CPUBitmapData.js").CPUBitmapData} t
      * @param {import("../../descriptor/texture/SamplerDescriptor.js").SamplerDescriptor | null} sampler
      * @param {Float32Array | number[] | number} coords
-     * @param {number} [_level]
+     * @param {number} [p3] — `level`, or `array_index` in the array forms
+     * @param {number | Int32Array | number[]} [p4] — `level` in the array forms, or `offset`
+     * @param {Int32Array | number[]} [p5] — `offset` in the array form
      * @returns {Float32Array}
      */
-    textureSampleLevel(t, sampler, coords, _level_or_index = 0, _array_level = undefined) {
+    textureSampleLevel(t, sampler, coords, p3 = 0, p4 = undefined, p5 = undefined) {
         assert.defined(t, 'texture');
+
+        let array_index = undefined;
+        let offset = undefined;
+
+        if (p5 !== undefined) {
+            // (t, s, coords, array_index, level, offset)
+            array_index = p3;
+            offset = p5;
+        } else if (p4 === undefined) {
+            // (t, s, coords, level)
+        } else if (typeof p4 === 'number') {
+            // (t, s, coords, array_index, level)
+            array_index = p3;
+        } else {
+            // (t, s, coords, level, offset)
+            offset = p4;
+        }
+
         const dim = t.dimensionality;
         // Convert UV (normalised) to texel-space coords expected by
         // cpu_texture_sample. coords for a 1D texture is a scalar in WGSL.
         const u = dim >= 1 ? (typeof coords === 'number' ? coords : coords[0]) : 0;
         const v = dim >= 2 ? coords[1] : 0;
-        const tx = u * t.size[0];
-        const ty = v * t.size[1];
+        const ox = offset !== undefined ? (offset[0] | 0) : 0;
+        const oy = offset !== undefined && offset.length >= 2 ? (offset[1] | 0) : 0;
+        const tx = u * t.size[0] + ox;
+        const ty = v * t.size[1] + oy;
         /**
          * @type {number[]}
          */
         let texel_coord;
-        if (_array_level !== undefined) {
+        if (array_index !== undefined) {
             /*
-             Five arguments is the texture_2d_array form — (t, s, uv, array_index, level) — where the
-             fourth argument selects a slice. A slice's texel-space centre sits at index + 0.5, which
-             lands the linear filter's z weight on exactly that slice: filtering happens in xy and
-             never crosses into a neighbour.
+             The texture_2d_array form — (t, s, uv, array_index, level[, offset]) — where the
+             fourth argument selects a slice. The array index is clamped to the layer count rather
+             than wrapped by addressModeW, and a slice's texel-space centre sits at index + 0.5,
+             which lands the linear filter's z weight on exactly that slice: filtering happens in
+             xy and never crosses into a neighbour.
             */
-            texel_coord = [tx, ty, (_level_or_index | 0) + 0.5];
+            const d = t.size[2];
+            const z = d <= 0 ? 0 : Math.min(Math.max(array_index | 0, 0), d - 1);
+            texel_coord = [tx, ty, z + 0.5];
         } else {
             const w = dim >= 3 ? coords[2] : 0;
-            const tz = w * t.size[2];
+            const oz = offset !== undefined && offset.length >= 3 ? (offset[2] | 0) : 0;
+            const tz = w * t.size[2] + oz;
             texel_coord = dim === 1 ? [tx] : (dim === 2 ? [tx, ty] : [tx, ty, tz]);
         }
         const result = new Float32Array(4);
@@ -1111,8 +1138,8 @@ export const WGSLLanguageCore = {
     },
 
     /**
-     * `textureSample(t, s, coords) -> vec4<T>` and the texture_2d_array form
-     * `textureSample(t, s, coords, array_index)`.
+     * `textureSample(t, s, coords[, offset]) -> vec4<T>` and the texture_2d_array form
+     * `textureSample(t, s, coords, array_index[, offset])`.
      *
      * Implicit-LOD sample. Without mipmaps, this is just
      * `textureSampleLevel` at level 0.
@@ -1120,37 +1147,89 @@ export const WGSLLanguageCore = {
      * @param {import("./CPUBitmapData.js").CPUBitmapData} t
      * @param {import("../../descriptor/texture/SamplerDescriptor.js").SamplerDescriptor | null} sampler
      * @param {Float32Array | number[] | number} coords
-     * @param {number} [array_index]
+     * @param {number | Int32Array | number[]} [p3] — `array_index`, or `offset`
+     * @param {Int32Array | number[]} [p4] — `offset` in the array form
      * @returns {Float32Array}
      */
-    textureSample(t, sampler, coords, array_index = undefined) {
-        if (array_index !== undefined) {
-            return WGSLLanguageCore.textureSampleLevel(t, sampler, coords, array_index, 0);
+    textureSample(t, sampler, coords, p3 = undefined, p4 = undefined) {
+        if (p4 !== undefined) {
+            return WGSLLanguageCore.textureSampleLevel(t, sampler, coords, p3, 0, p4);
+        }
+
+        if (typeof p3 === 'number') {
+            return WGSLLanguageCore.textureSampleLevel(t, sampler, coords, p3, 0);
+        }
+
+        if (p3 !== undefined) {
+            return WGSLLanguageCore.textureSampleLevel(t, sampler, coords, 0, p3);
         }
 
         return WGSLLanguageCore.textureSampleLevel(t, sampler, coords, 0);
     },
 
     /**
-     * `textureSampleGrad(t, s, coords, ddx, ddy) -> vec4<T>` and the texture_2d_array form
-     * `textureSampleGrad(t, s, coords, array_index, ddx, ddy)`.
+     * `textureSampleBias(t, s, coords, bias[, offset]) -> vec4<T>` and the texture_2d_array form
+     * `textureSampleBias(t, s, coords, array_index, bias[, offset])`.
      *
-     * Explicit-gradient sample. Mipmaps are not modelled (see the header), so the gradients only
-     * disambiguate which call shape this is: six arguments carry an array index, five do not.
+     * Implicit-LOD sample with a mip bias. Mipmaps are not modelled (see the header), so the bias
+     * is ignored and this routes through `textureSampleLevel` at level 0. Overloads are told apart
+     * by argument shape: a scalar fifth argument is the array form's `bias` (making the fourth the
+     * `array_index`), while a vector is the const `offset`.
      *
      * @param {import("./CPUBitmapData.js").CPUBitmapData} t
      * @param {import("../../descriptor/texture/SamplerDescriptor.js").SamplerDescriptor | null} sampler
      * @param {Float32Array | number[] | number} coords
-     * @param {Float32Array | number[] | number} p3 gradient, or the array index
-     * @param {Float32Array | number[]} p4 gradient
-     * @param {Float32Array | number[]} [p5] gradient, in the array form
+     * @param {number} p3 — `bias`, or `array_index` in the array forms
+     * @param {number | Int32Array | number[]} [p4] — `bias` in the array forms, or `offset`
+     * @param {Int32Array | number[]} [p5] — `offset` in the array form
      * @returns {Float32Array}
      */
-    textureSampleGrad(t, sampler, coords, p3, p4, p5 = undefined) {
+    textureSampleBias(t, sampler, coords, p3, p4 = undefined, p5 = undefined) {
         if (p5 !== undefined) {
+            return WGSLLanguageCore.textureSampleLevel(t, sampler, coords, p3, 0, p5);
+        }
+
+        if (p4 === undefined) {
+            return WGSLLanguageCore.textureSampleLevel(t, sampler, coords, 0);
+        }
+
+        if (typeof p4 === 'number') {
             return WGSLLanguageCore.textureSampleLevel(t, sampler, coords, p3, 0);
         }
 
+        return WGSLLanguageCore.textureSampleLevel(t, sampler, coords, 0, p4);
+    },
+
+    /**
+     * `textureSampleGrad(t, s, coords, ddx, ddy[, offset]) -> vec4<T>` and the texture_2d_array form
+     * `textureSampleGrad(t, s, coords, array_index, ddx, ddy[, offset])`.
+     *
+     * Explicit-gradient sample. Mipmaps are not modelled (see the header), so the gradients are
+     * ignored and this routes through `textureSampleLevel` at level 0. A scalar fourth argument is
+     * the array form's `array_index`; a vector is `ddx`.
+     *
+     * @param {import("./CPUBitmapData.js").CPUBitmapData} t
+     * @param {import("../../descriptor/texture/SamplerDescriptor.js").SamplerDescriptor | null} sampler
+     * @param {Float32Array | number[] | number} coords
+     * @param {Float32Array | number[] | number} p3 gradient `ddx`, or the `array_index`
+     * @param {Float32Array | number[]} p4 gradient (`ddy`, or `ddx` in the array form)
+     * @param {Float32Array | Int32Array | number[]} [p5] `ddy` in the array form, or `offset`
+     * @param {Int32Array | number[]} [p6] `offset` in the array form
+     * @returns {Float32Array}
+     */
+    textureSampleGrad(t, sampler, coords, p3, p4, p5 = undefined, p6 = undefined) {
+        if (typeof p3 === 'number') {
+            if (p6 !== undefined) {
+                return WGSLLanguageCore.textureSampleLevel(t, sampler, coords, p3, 0, p6);
+            }
+
+            return WGSLLanguageCore.textureSampleLevel(t, sampler, coords, p3, 0);
+        }
+
+        if (p5 !== undefined) {
+            return WGSLLanguageCore.textureSampleLevel(t, sampler, coords, 0, p5);
+        }
+
         return WGSLLanguageCore.textureSampleLevel(t, sampler, coords, 0);
     },