@woosh/meep-engine 3.47.0 → 3.49.0

package/src/shade/renderer/shadow/ray/shader_ray_shadow_code.js

@@ -5,7 +5,8 @@ import { chunk_ray_shaded_query_occluded } from "../../path_tracer/shader/chunk_
 import { chunk_is_background } from "../../shader/chunk/depth/chunk_is_background.js";
 import { chunk_project_position_from_depth } from "../../shader/chunk/camera/chunk_project_position_from_depth.js";
 import { chunk_decode_g_buffer_normal } from "../../shader/chunk/geometry/normal/chunk_decode_g_buffer_normal.js";
-import { chunk_offset_ray } from "../../shader/chunk/geometry/ray/chunk_offset_ray.js";
+import { chunk_mat4_extract_position } from "../../shader/chunk/geometry/mat4/chunk_mat4_extract_position.js";
+import { chunk_offset_ray_from_depth } from "../../shader/chunk/geometry/ray/chunk_offset_ray_from_depth.js";
 import { RAY_STRUCT } from "../../shader/chunk/geometry/ray/RAY_STRUCT.js";
 import {
     chunk_directional_lights_iteration_mask
@@ -28,27 +29,25 @@ import { VIEW_UNIFORM_STRUCT } from "../../view/VIEW_UNIFORM_STRUCT.js";
 
 const resources = new ShaderResourceSetDescriptor();
 
+// A device offers four bind groups (`maxBindGroups`), and the RTX group takes one.
 sr_create_group_RTX(resources);
 
-resources.createGroup()
-    .addStorageBuffer("light_data", WebGPUArray.u32);
-
-resources.createGroup()
-    .addStorageTexture("i_Output", "r32uint");
-
-// Material-aware shadow attenuation: ray_shaded_query_occluded reads the
+// Lights, and the materials their shadow rays meet: ray_shaded_query_occluded reads the
 // resident-material atlas (same one the path tracer uses) so glass occluders
 // get the view-Fresnel mix instead of being treated as fully opaque.
 resources.createGroup()
+    .addStorageBuffer("light_data", WebGPUArray.u32)
     .addUniform("materials", INDIRECT_MATERIAL_ARRAY_TYPE)
-    .addTexture("textures", "unfilterable-float", "2d-array")
+    .addTexture("textures", "unfilterable-float", "2d-array");
 
+// The view: what the pass reads of it, and what it writes for it.
 resources.createGroup()
     .addTexture("texture_depth")
     .addTexture("texture_normal", "uint")
     .addTexture("texture_noise", "uint", "2d", false, HILBERT_R2_INDEX_TEXTURE)
     .addUniform("camera", CAMERA_UNIFORM_STRUCT)
-    .addUniform("view", VIEW_UNIFORM_STRUCT);
+    .addUniform("view", VIEW_UNIFORM_STRUCT)
+    .addStorageTexture("i_Output", "r32uint");
 
 /**
  * @see https://www.shadertoy.com/view/3tycWd for contact shadows (screen space shadow trace)
@@ -111,7 +110,7 @@ fn main(
     
             let jitter = spatio_temporal_noise_r2_64(pixel_position, view.frame_index, texture_noise);
 
-            var ray_origin = offset_ray(position_ws, geometric_normal);
+            var ray_origin = offset_ray_from_depth(position_ws, geometric_normal, mat4_extract_position(camera.transform));
 
             // Pick the first occupied directional light from the
             // iteration mask (max 32 directionals enforced by
@@ -162,7 +161,8 @@ fn main(
         chunk_directional_lights_iteration_mask,
         chunk_sample_directional_light_record,
         chunk_spatio_temporal_noise_r2_64,
-        chunk_offset_ray,
+        chunk_mat4_extract_position,
+        chunk_offset_ray_from_depth,
         chunk_texel_coordinate_to_uv,
         chunk_project_position_from_depth,
         chunk_is_background,

package/src/shade/renderer/shadow/ray/staged/gen/shader_generate_rays.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_generate_rays.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/shadow/ray/staged/gen/shader_generate_rays.js"],"names":[],"mappings":"AA0BA,0CAEG;AAEH;;;GAGG;AACH,oCAFU,MAAM,CAEuB;AAiHvC,iDAIE;6BArJ2B,yCAAyC;8BAmBxC,qCAAqC"}
+{"version":3,"file":"shader_generate_rays.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/shadow/ray/staged/gen/shader_generate_rays.js"],"names":[],"mappings":"AA2BA,0CAEG;AAEH;;;GAGG;AACH,oCAFU,MAAM,CAEuB;AAkHvC,iDAIE;6BAvJ2B,yCAAyC;8BAoBxC,qCAAqC"}

package/src/shade/renderer/shadow/ray/staged/gen/shader_generate_rays.js

@@ -1,152 +1,154 @@
-import { atomic_u32, u32 } from "../../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { WebGPUArray } from "../../../../shader/type/WebGPUArray.js";
-import { WebGPUStruct } from "../../../../shader/type/WebGPUStruct.js";
-import { CAMERA_UNIFORM_STRUCT } from "../../../../camera/CAMERA_UNIFORM_STRUCT.js";
-import { chunk_is_background } from "../../../../shader/chunk/depth/chunk_is_background.js";
-import {
-    chunk_project_position_from_depth
-} from "../../../../shader/chunk/camera/chunk_project_position_from_depth.js";
-import { chunk_decode_g_buffer_normal } from "../../../../shader/chunk/geometry/normal/chunk_decode_g_buffer_normal.js";
-import { chunk_offset_ray } from "../../../../shader/chunk/geometry/ray/chunk_offset_ray.js";
-import { RAY_STRUCT } from "../../../../shader/chunk/geometry/ray/RAY_STRUCT.js";
-import { chunk_grid2d_to_index } from "../../../../shader/chunk/grid/chunk_grid2d_to_index.js";
-import {
-    chunk_directional_lights_iteration_mask
-} from "../../../../shader/chunk/light/io/chunk_directional_lights_iteration_mask.js";
-import {
-    chunk_sample_directional_light_record
-} from "../../../../shader/chunk/light/sample/chunk_sample_directional_light_record.js";
-import { chunk_spatio_temporal_noise_r2_64 } from "../../../../shader/chunk/noise/chunk_spatio_temporal_noise_r2_64.js";
-import { chunk_texel_coordinate_to_uv } from "../../../../shader/chunk/texture/chunk_texel_coordinate_to_uv.js";
-import { CodeChunk } from "../../../../shader/compiler/CodeChunk.js";
-import { ComputeShader } from "../../../../shader/ComputeShader.js";
-import { ShaderResourceSetDescriptor } from "../../../../shader/resource/ShaderResourceSetDescriptor.js";
-import { HILBERT_R2_INDEX_TEXTURE } from "../../../../texture/noise/HILBERT_R2_INDEX_TEXTURE.js";
-import { chunk_pack_ray } from "../chunk_pack_ray.js";
-
-export const PUSH_CONSTANTS = WebGPUStruct.from({
-    frame_index: u32
-});
-
-/**
- * How many f32's make up a single packed ray
- * @type {number}
- */
-export const PACKED_RAY_WORD_COUNT = 8;
-
-const STRUCT_OUTPUT = WebGPUStruct.from({
-    count: atomic_u32,
-    // rays are packed
-    rays: WebGPUArray.vec4f,
-});
-
-const resources = new ShaderResourceSetDescriptor();
-
-// per-dispatch, four bytes, read-only: immediate data rather than a uniform buffer — the struct was
-// already named PUSH_CONSTANTS. camera stays bound.
-resources.setImmediate("settings", PUSH_CONSTANTS);
-
-resources.createGroup()
-    .addStorageBuffer("light_data", WebGPUArray.u32);
-
-resources.createGroup()
-    .addTexture("texture_depth")
-    .addTexture("texture_normal", "uint")
-    .addTexture("texture_noise", "uint", "2d", false, HILBERT_R2_INDEX_TEXTURE)
-    .addUniform("camera", CAMERA_UNIFORM_STRUCT)
-
-resources.createGroup()
-    .addStorageBuffer("output", STRUCT_OUTPUT, true);
-
-const body = CodeChunk.from(
-    //language=WGSL
-    `
-@compute @workgroup_size(8,4,1)
-fn main(
-    @builtin(global_invocation_id) global_invocation_id: vec3<u32>,
-){
-    let pixel_position = global_invocation_id.xy;
-    let texture_size = textureDimensions(texture_depth);
-  
-    if(any(pixel_position >= texture_size)){
-        // outside of the viewport
-        return;
-    }
-        
-    let texel_depth = textureLoad(
-        texture_depth,
-        pixel_position,
-        0
-    ).r;
-        
-    if(is_background(texel_depth)){
-        return;
-    }
-    
-    let uv = texel_coordinate_to_uv( vec2<f32>(pixel_position), texture_size);
-            
-    let position_ws = project_position_from_depth(
-        uv,
-        texel_depth,
-        camera.view_projection_matrix_inverse 
-    );
-    
-    let g_buffer_sample_normal = textureLoad( texture_normal,
-        pixel_position,
-        0
-    );
-    
-    let geometric_normal = decode_g_buffer_normal( g_buffer_sample_normal.zw );
-    let shading_normal = decode_g_buffer_normal( g_buffer_sample_normal.xy );
-                
-    let jitter = spatio_temporal_noise_r2_64(pixel_position, settings.frame_index, texture_noise);
-
-    var ray_origin = offset_ray(position_ws, geometric_normal);
-
-    // Pick the first occupied directional light from the iteration
-    // mask (max 32 directionals enforced by GPULightCollection). One
-    // ray per pixel; multi-directional shadowing would multiply ray
-    // budget and require the trace pass to scale accordingly.
-    let directional_bits = directional_lights_iteration_mask(&light_data);
-    if (directional_bits == 0u) {
-        return;
-    }
-    let directional_index = countTrailingZeros(directional_bits);
-    let light_record = sample_directional_light_record(&light_data, directional_index, ray_origin, jitter);
-    
-    var _ray: ${RAY_STRUCT.wgsl_ref};
-    
-    _ray.origin = ray_origin;
-    _ray.direction = light_record.direction;
-    _ray.tmax = light_record.distance;
-    
-    if(dot(_ray.direction, shading_normal) <= 0){
-        // ray points backways
-        return;
-    }
-    
-    let texel_index = grid2d_to_index(pixel_position, texture_size.x);
-    
-    let output_index = atomicAdd(&output.count, 1);
-    
-    pack_ray(&output.rays, output_index, _ray, texel_index);
-}
-    `, [
-        chunk_decode_g_buffer_normal,
-        chunk_directional_lights_iteration_mask,
-        chunk_sample_directional_light_record,
-        chunk_spatio_temporal_noise_r2_64,
-        chunk_offset_ray,
-        chunk_texel_coordinate_to_uv,
-        chunk_project_position_from_depth,
-        chunk_is_background,
-        chunk_pack_ray,
-        chunk_grid2d_to_index,
-    ]
-);
-
-export const shader_generate_rays = ComputeShader.from({
-    label: "Generate Shadow Rays",
-    body,
-    resources,
+import { atomic_u32, u32 } from "../../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { WebGPUArray } from "../../../../shader/type/WebGPUArray.js";
+import { WebGPUStruct } from "../../../../shader/type/WebGPUStruct.js";
+import { CAMERA_UNIFORM_STRUCT } from "../../../../camera/CAMERA_UNIFORM_STRUCT.js";
+import { chunk_is_background } from "../../../../shader/chunk/depth/chunk_is_background.js";
+import {
+    chunk_project_position_from_depth
+} from "../../../../shader/chunk/camera/chunk_project_position_from_depth.js";
+import { chunk_decode_g_buffer_normal } from "../../../../shader/chunk/geometry/normal/chunk_decode_g_buffer_normal.js";
+import { chunk_mat4_extract_position } from "../../../../shader/chunk/geometry/mat4/chunk_mat4_extract_position.js";
+import { chunk_offset_ray_from_depth } from "../../../../shader/chunk/geometry/ray/chunk_offset_ray_from_depth.js";
+import { RAY_STRUCT } from "../../../../shader/chunk/geometry/ray/RAY_STRUCT.js";
+import { chunk_grid2d_to_index } from "../../../../shader/chunk/grid/chunk_grid2d_to_index.js";
+import {
+    chunk_directional_lights_iteration_mask
+} from "../../../../shader/chunk/light/io/chunk_directional_lights_iteration_mask.js";
+import {
+    chunk_sample_directional_light_record
+} from "../../../../shader/chunk/light/sample/chunk_sample_directional_light_record.js";
+import { chunk_spatio_temporal_noise_r2_64 } from "../../../../shader/chunk/noise/chunk_spatio_temporal_noise_r2_64.js";
+import { chunk_texel_coordinate_to_uv } from "../../../../shader/chunk/texture/chunk_texel_coordinate_to_uv.js";
+import { CodeChunk } from "../../../../shader/compiler/CodeChunk.js";
+import { ComputeShader } from "../../../../shader/ComputeShader.js";
+import { ShaderResourceSetDescriptor } from "../../../../shader/resource/ShaderResourceSetDescriptor.js";
+import { HILBERT_R2_INDEX_TEXTURE } from "../../../../texture/noise/HILBERT_R2_INDEX_TEXTURE.js";
+import { chunk_pack_ray } from "../chunk_pack_ray.js";
+
+export const PUSH_CONSTANTS = WebGPUStruct.from({
+    frame_index: u32
+});
+
+/**
+ * How many f32's make up a single packed ray
+ * @type {number}
+ */
+export const PACKED_RAY_WORD_COUNT = 8;
+
+const STRUCT_OUTPUT = WebGPUStruct.from({
+    count: atomic_u32,
+    // rays are packed
+    rays: WebGPUArray.vec4f,
+});
+
+const resources = new ShaderResourceSetDescriptor();
+
+// per-dispatch, four bytes, read-only: immediate data rather than a uniform buffer — the struct was
+// already named PUSH_CONSTANTS. camera stays bound.
+resources.setImmediate("settings", PUSH_CONSTANTS);
+
+resources.createGroup()
+    .addStorageBuffer("light_data", WebGPUArray.u32);
+
+resources.createGroup()
+    .addTexture("texture_depth")
+    .addTexture("texture_normal", "uint")
+    .addTexture("texture_noise", "uint", "2d", false, HILBERT_R2_INDEX_TEXTURE)
+    .addUniform("camera", CAMERA_UNIFORM_STRUCT)
+
+resources.createGroup()
+    .addStorageBuffer("output", STRUCT_OUTPUT, true);
+
+const body = CodeChunk.from(
+    //language=WGSL
+    `
+@compute @workgroup_size(8,4,1)
+fn main(
+    @builtin(global_invocation_id) global_invocation_id: vec3<u32>,
+){
+    let pixel_position = global_invocation_id.xy;
+    let texture_size = textureDimensions(texture_depth);
+  
+    if(any(pixel_position >= texture_size)){
+        // outside of the viewport
+        return;
+    }
+        
+    let texel_depth = textureLoad(
+        texture_depth,
+        pixel_position,
+        0
+    ).r;
+        
+    if(is_background(texel_depth)){
+        return;
+    }
+    
+    let uv = texel_coordinate_to_uv( vec2<f32>(pixel_position), texture_size);
+            
+    let position_ws = project_position_from_depth(
+        uv,
+        texel_depth,
+        camera.view_projection_matrix_inverse 
+    );
+    
+    let g_buffer_sample_normal = textureLoad( texture_normal,
+        pixel_position,
+        0
+    );
+    
+    let geometric_normal = decode_g_buffer_normal( g_buffer_sample_normal.zw );
+    let shading_normal = decode_g_buffer_normal( g_buffer_sample_normal.xy );
+                
+    let jitter = spatio_temporal_noise_r2_64(pixel_position, settings.frame_index, texture_noise);
+
+    var ray_origin = offset_ray_from_depth(position_ws, geometric_normal, mat4_extract_position(camera.transform));
+
+    // Pick the first occupied directional light from the iteration
+    // mask (max 32 directionals enforced by GPULightCollection). One
+    // ray per pixel; multi-directional shadowing would multiply ray
+    // budget and require the trace pass to scale accordingly.
+    let directional_bits = directional_lights_iteration_mask(&light_data);
+    if (directional_bits == 0u) {
+        return;
+    }
+    let directional_index = countTrailingZeros(directional_bits);
+    let light_record = sample_directional_light_record(&light_data, directional_index, ray_origin, jitter);
+    
+    var _ray: ${RAY_STRUCT.wgsl_ref};
+    
+    _ray.origin = ray_origin;
+    _ray.direction = light_record.direction;
+    _ray.tmax = light_record.distance;
+    
+    if(dot(_ray.direction, shading_normal) <= 0){
+        // ray points backways
+        return;
+    }
+    
+    let texel_index = grid2d_to_index(pixel_position, texture_size.x);
+    
+    let output_index = atomicAdd(&output.count, 1);
+    
+    pack_ray(&output.rays, output_index, _ray, texel_index);
+}
+    `, [
+        chunk_decode_g_buffer_normal,
+        chunk_directional_lights_iteration_mask,
+        chunk_sample_directional_light_record,
+        chunk_spatio_temporal_noise_r2_64,
+        chunk_mat4_extract_position,
+        chunk_offset_ray_from_depth,
+        chunk_texel_coordinate_to_uv,
+        chunk_project_position_from_depth,
+        chunk_is_background,
+        chunk_pack_ray,
+        chunk_grid2d_to_index,
+    ]
+);
+
+export const shader_generate_rays = ComputeShader.from({
+    label: "Generate Shadow Rays",
+    body,
+    resources,
 })

package/src/shade/renderer/shadow/vsm/shader/chunk_shadowmap_sample_directional_virtual.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `shadowmap_sample_directional` under {@link ShadowDirectionalTechnique.Virtual}: the light's
+ * `shadow_directional` record names its virtual shadow map, sampled by {@link shadowmap_sample_virtual}.
+ *
+ * A light whose record names none — a frame where the renderer has just switched from cascades and not
+ * yet rebuilt the light's map — is lit. The view direction is the cascades' to choose a cascade by;
+ * a virtual map's pages are chosen by position alone.
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_shadowmap_sample_directional_virtual: CodeChunk;
+import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
+//# sourceMappingURL=chunk_shadowmap_sample_directional_virtual.d.ts.map

package/src/shade/renderer/shadow/vsm/shader/chunk_shadowmap_sample_directional_virtual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk_shadowmap_sample_directional_virtual.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shadow/vsm/shader/chunk_shadowmap_sample_directional_virtual.js"],"names":[],"mappings":"AAQA;;;;;;;;;GASG;AACH,yDAFU,SAAS,CA+BjB;0BA5CwB,uCAAuC"}

package/src/shade/renderer/shadow/vsm/shader/chunk_shadowmap_sample_directional_virtual.js

@@ -0,0 +1,48 @@
+import { GPU_DATABASE_NULL } from "../../../buffer/table/GPU_DATABASE_NULL.js";
+import { LIGHT_DATABASE_SPEC } from "../../../light/LIGHT_DATABASE_SPEC.js";
+import { INCIDENT_LIGHT_STRUCT } from "../../../shader/chunk/light/INCIDENT_LIGHT_STRUCT.js";
+import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
+import { chunk_shadowmap_sample_virtual } from "./chunk_shadowmap_sample_virtual.js";
+
+const SHADOW_DIRECTIONAL_DESCRIPTOR = LIGHT_DATABASE_SPEC.get('shadow_directional');
+
+/**
+ * `shadowmap_sample_directional` under {@link ShadowDirectionalTechnique.Virtual}: the light's
+ * `shadow_directional` record names its virtual shadow map, sampled by {@link shadowmap_sample_virtual}.
+ *
+ * A light whose record names none — a frame where the renderer has just switched from cascades and not
+ * yet rebuilt the light's map — is lit. The view direction is the cascades' to choose a cascade by;
+ * a virtual map's pages are chosen by position alone.
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_shadowmap_sample_directional_virtual = CodeChunk.from(
+    //language=WGSL
+    `
+fn shadowmap_sample_directional(
+    database: ptr<storage, array<u32>>,
+    shadow_id: u32,
+    position_ws: vec3f,
+    view_direction_ws: vec3f,
+    surface_normal_ws: vec3f,
+    light: ${INCIDENT_LIGHT_STRUCT.wgsl_ref},
+) -> f32 {
+    let shadowmap = ${SHADOW_DIRECTIONAL_DESCRIPTOR.marshalling_method_read}(database, shadow_id);
+
+    if (shadowmap.virtual_map == ${GPU_DATABASE_NULL}u) {
+        return 1.0;
+    }
+
+    return shadowmap_sample_virtual(
+        database,
+        shadowmap.virtual_map,
+        position_ws,
+        surface_normal_ws,
+        light,
+    );
+}
+    `, [
+        SHADOW_DIRECTIONAL_DESCRIPTOR.chunk_read,
+        chunk_shadowmap_sample_virtual,
+    ]
+);

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

@@ -114,6 +114,16 @@ export class GPUTextureContext {
      * @param {boolean} [preserve_data]
      */
     allocate(preserve_data?: boolean): void;
+    /**
+     * Hold `gpu_texture` in place of the texture held now, which is destroyed. For a caller that
+     * lays out the new texture's contents itself — {@link resize} can only keep the old extent at
+     * the origin. Make `gpu_texture` from {@link descriptor} as it stands, and submit any copy out of
+     * the old texture before calling this: destroying it waits for submitted work, not for work
+     * still being recorded. Views are re-made.
+     *
+     * @param {GPUTexture} gpu_texture
+     */
+    replace(gpu_texture: GPUTexture): void;
     /**
      * Whether the texture is resident in GPU memory
      * @returns {boolean}

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

@@ -1 +1 @@
-{"version":3,"file":"GPUTextureContext.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/texture/GPUTextureContext.js"],"names":[],"mappings":"AAmBA;;;GAGG;AACH;IAmKI;;;;;OAKG;IACH,iEAFa,iBAAiB,CAY7B;IA9BD;;;OAGG;IACH,+BAQC;IAzJD;;;OAGG;IACH,iBAEC;IAED;;;OAGG;IACH,mCAEC;IAED;;;OAGG;IACH;eAF8B,MAAM;gBAAU,MAAM;4BAAsB,MAAM;MAI/E;IAED;;;OAGG;IACH,oBAEC;IAED;;;OAGG;IACH,qBAEC;IAED;;;OAGG;IACH,oBAEC;IAED;;;OAGG;IACH,YAFU,iBAAiB,CAEU;IAErC;;;OAGG;IACH,oBAEC;IA4BD;;;OAGG;IACH,2BAMC;IAlBD;;;OAGG;IACH,sBAEC;IAcD;;OAEG;IACH,yBAEC;IAED;;;;OAIG;IACH,8BAOC;IAED;;;OAGG;IACH,+BAEC;IA8CD;;;;OAIG;IACH,wBAHW,qBAAqB,kBAS/B;IAqBD;;;;OAIG;IACH,wBAFa,QAAQ,UAAU,CAAC,CAU/B;IAED;;;;;;;;OAQG;IACH,wBALW,MAAM,EAAE,YACR,MAAM,EAAE,QACR,MAAM,GACJ,QAAQ,UAAU,CAAC,CAU/B;IAED;;;;;;OAMG;IACH,yBAFW,OAAO,QA4DjB;IAED;;;OAGG;IACH,eAFa,OAAO,CAInB;IAED;;;OAGG;IACH,2BAEC;IAED;;OAEG;IACH,gBAUC;IAED;;;;;;OAMG;IACH,UALW,MAAM,MACN,MAAM,MACN,MAAM,kBACN,OAAO,QAoCjB;;CACJ;yBAjZY,OAAO,wCAAwC,EAAE,UAAU;kCAPtC,+CAA+C;sCAC3C,mDAAmD"}
+{"version":3,"file":"GPUTextureContext.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/texture/GPUTextureContext.js"],"names":[],"mappings":"AAmBA;;;GAGG;AACH;IAmKI;;;;;OAKG;IACH,iEAFa,iBAAiB,CAY7B;IA9BD;;;OAGG;IACH,+BAQC;IAzJD;;;OAGG;IACH,iBAEC;IAED;;;OAGG;IACH,mCAEC;IAED;;;OAGG;IACH;eAF8B,MAAM;gBAAU,MAAM;4BAAsB,MAAM;MAI/E;IAED;;;OAGG;IACH,oBAEC;IAED;;;OAGG;IACH,qBAEC;IAED;;;OAGG;IACH,oBAEC;IAED;;;OAGG;IACH,YAFU,iBAAiB,CAEU;IAErC;;;OAGG;IACH,oBAEC;IA4BD;;;OAGG;IACH,2BAMC;IAlBD;;;OAGG;IACH,sBAEC;IAcD;;OAEG;IACH,yBAEC;IAED;;;;OAIG;IACH,8BAOC;IAED;;;OAGG;IACH,+BAEC;IA8CD;;;;OAIG;IACH,wBAHW,qBAAqB,kBAS/B;IAqBD;;;;OAIG;IACH,wBAFa,QAAQ,UAAU,CAAC,CAU/B;IAED;;;;;;;;OAQG;IACH,wBALW,MAAM,EAAE,YACR,MAAM,EAAE,QACR,MAAM,GACJ,QAAQ,UAAU,CAAC,CAU/B;IAED;;;;;;OAMG;IACH,yBAFW,OAAO,QA4DjB;IAED;;;;;;;;OAQG;IACH,uCAaC;IAED;;;OAGG;IACH,eAFa,OAAO,CAInB;IAED;;;OAGG;IACH,2BAEC;IAED;;OAEG;IACH,gBAUC;IAED;;;;;;OAMG;IACH,UALW,MAAM,MACN,MAAM,MACN,MAAM,kBACN,OAAO,QAoCjB;;CACJ;yBAzaY,OAAO,wCAAwC,EAAE,UAAU;kCAPtC,+CAA+C;sCAC3C,mDAAmD"}

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

@@ -335,6 +335,30 @@ export class GPUTextureContext {
         this.#state = TEXTURE_STATE_ALLOCATED;
     }
 
+    /**
+     * Hold `gpu_texture` in place of the texture held now, which is destroyed. For a caller that
+     * lays out the new texture's contents itself — {@link resize} can only keep the old extent at
+     * the origin. Make `gpu_texture` from {@link descriptor} as it stands, and submit any copy out of
+     * the old texture before calling this: destroying it waits for submitted work, not for work
+     * still being recorded. Views are re-made.
+     *
+     * @param {GPUTexture} gpu_texture
+     */
+    replace(gpu_texture) {
+        assert.defined(gpu_texture, 'gpu_texture');
+
+        const size = this.descriptor.size;
+
+        assert.equal(gpu_texture.width, size[0], 'gpu_texture.width differs from the descriptor');
+        assert.equal(gpu_texture.height, size[1], 'gpu_texture.height differs from the descriptor');
+        assert.equal(gpu_texture.depthOrArrayLayers, size[2], 'gpu_texture.depthOrArrayLayers differs from the descriptor');
+
+        this.destroy();
+
+        this.#gpu_texture = gpu_texture;
+        this.#state = TEXTURE_STATE_ALLOCATED;
+    }
+
     /**
      * Whether the texture is resident in GPU memory
      * @returns {boolean}