@woosh/meep-engine 3.39.0 → 3.41.0

package/src/shade/renderer/shader/type/serde/read_gpu_typed_buffer.js

@@ -79,11 +79,12 @@ function read_multiple_f32(buffer, count) {
  *
  * @param {BinaryBuffer} buffer
  * @param {number} count
- * @returns {Uint32Array}
+ * @returns {Int32Array}
  */
 function read_multiple_i32(buffer, count) {
 
-    const r = new Uint32Array(count);
+    // signed storage, or every negative component reads back as its u32 bit pattern
+    const r = new Int32Array(count);
     buffer.readInt32Array(r, 0, count);
     return r;
 }

package/src/shade/renderer/shadow/map/DIRECTIONAL_SHADOWMAP_STRUCT.d.ts

@@ -0,0 +1,19 @@
+/**
+ * A directional light's shadow map: a row of the light database's `shadow_directional` table,
+ * which the light's `shadow_id` names. It says where the map is, which is one of two things:
+ *
+ * - **cascades** — a range over the `shadow_cascade` table, one row per cascade, nearest first, with
+ *   `virtual_map` naming nothing;
+ * - **a virtual shadow map** — `virtual_map` names its row of the `shadow_virtual` table, and the
+ *   cascade range is empty.
+ *
+ * Neither the range nor the link owns its rows: the shadow context claims a map's rows when it
+ * builds the map and gives them back when it evicts it, while the record itself sits in a slot that
+ * is reassigned densely as maps come and go. A record written without `virtual_map` leaves it
+ * naming nothing, which is how a cascaded map's record is written.
+ *
+ * @type {WebGPUStruct}
+ */
+export const DIRECTIONAL_SHADOWMAP_STRUCT: WebGPUStruct;
+import { WebGPUStruct } from "../../shader/type/WebGPUStruct.js";
+//# sourceMappingURL=DIRECTIONAL_SHADOWMAP_STRUCT.d.ts.map

package/src/shade/renderer/shadow/map/DIRECTIONAL_SHADOWMAP_STRUCT.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DIRECTIONAL_SHADOWMAP_STRUCT.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shadow/map/DIRECTIONAL_SHADOWMAP_STRUCT.js"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;GAeG;AACH,2CAFU,YAAY,CASY;6BAzBL,mCAAmC"}

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

@@ -0,0 +1,27 @@
+import { u32 } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { WebGPUStruct } from "../../shader/type/WebGPUStruct.js";
+
+/**
+ * A directional light's shadow map: a row of the light database's `shadow_directional` table,
+ * which the light's `shadow_id` names. It says where the map is, which is one of two things:
+ *
+ * - **cascades** — a range over the `shadow_cascade` table, one row per cascade, nearest first, with
+ *   `virtual_map` naming nothing;
+ * - **a virtual shadow map** — `virtual_map` names its row of the `shadow_virtual` table, and the
+ *   cascade range is empty.
+ *
+ * Neither the range nor the link owns its rows: the shadow context claims a map's rows when it
+ * builds the map and gives them back when it evicts it, while the record itself sits in a slot that
+ * is reassigned densely as maps come and go. A record written without `virtual_map` leaves it
+ * naming nothing, which is how a cascaded map's record is written.
+ *
+ * @type {WebGPUStruct}
+ */
+export const DIRECTIONAL_SHADOWMAP_STRUCT = WebGPUStruct.from({
+    /** row of the map's nearest cascade in `shadow_cascade` */
+    first_cascade: u32,
+    /** how many cascades follow it, the nearest included */
+    cascade_count: u32,
+    /** the map's row in `shadow_virtual`, or NULL for a cascaded map */
+    virtual_map: u32,
+}, "DirectionalShadowmap").pack();

package/src/shade/renderer/shadow/map/DirectionalLightShadowmap.d.ts

@@ -66,6 +66,7 @@ export class DirectionalLightShadowmap extends Shadowmap {
     make_record(): {
         first_cascade: number;
         cascade_count: number;
+        virtual_map: number;
     };
     /**
      * The CPU's half of cascade `index`'s `shadow_cascade` row: where it is in the atlas, and the

package/src/shade/renderer/shadow/map/DirectionalLightShadowmap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DirectionalLightShadowmap.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shadow/map/DirectionalLightShadowmap.js"],"names":[],"mappings":"AAwGA;IAsEI;;OAEG;IACH,2BAFW,MAAM,EAiBhB;IAvFD;;;OAGG;IACH,cAFU,MAAM,CAEC;IAEjB;;;OAGG;IACH,cAFU,MAAM,CAEC;IAEjB;;;;;OAKG;IACH,eAFU,MAAM,CAEF;IAEd;;;;OAIG;IACH,QAFU,YAAY,CAEf;IAEP;;;;;;OAMG;IACH,eAFU,MAAM,CAEG;IAEnB;;;;;;;OAOG;IACH,cAFU,YAAY,CAET;IASb;;;;OAIG;IACH,oBAFU,OAAO,CAEU;IAE3B;;;;;;OAMG;IACH,iBAFU;QAAC,MAAM,EAAE,YAAY,CAAC;QAAC,YAAY,EAAE,YAAY,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAC,CAEjF;IAsBhB,+CA0QC;IAED;;;MAKC;IAED;;;;;;;OAOG;IACH,2BAJW,MAAM,UACN;QAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,UAAU,MAAM,CAAC,CAAA;KAAC,GAC9C;QAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,UAAU,MAAM,CAAC,CAAA;KAAC,CAiB5D;;CAEJ;0BArdyB,gBAAgB"}
+{"version":3,"file":"DirectionalLightShadowmap.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shadow/map/DirectionalLightShadowmap.js"],"names":[],"mappings":"AAyGA;IAsEI;;OAEG;IACH,2BAFW,MAAM,EAiBhB;IAvFD;;;OAGG;IACH,cAFU,MAAM,CAEC;IAEjB;;;OAGG;IACH,cAFU,MAAM,CAEC;IAEjB;;;;;OAKG;IACH,eAFU,MAAM,CAEF;IAEd;;;;OAIG;IACH,QAFU,YAAY,CAEf;IAEP;;;;;;OAMG;IACH,eAFU,MAAM,CAEG;IAEnB;;;;;;;OAOG;IACH,cAFU,YAAY,CAET;IASb;;;;OAIG;IACH,oBAFU,OAAO,CAEU;IAE3B;;;;;;OAMG;IACH,iBAFU;QAAC,MAAM,EAAE,YAAY,CAAC;QAAC,YAAY,EAAE,YAAY,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAC,CAEjF;IAsBhB,+CA0QC;IAED;;;;MAQC;IAED;;;;;;;OAOG;IACH,2BAJW,MAAM,UACN;QAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,UAAU,MAAM,CAAC,CAAA;KAAC,GAC9C;QAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,UAAU,MAAM,CAAC,CAAA;KAAC,CAiB5D;;CAEJ;0BAxdyB,gBAAgB"}

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

@@ -20,6 +20,7 @@ import { inverseLerp } from "../../../../core/math/inverseLerp.js";
 import {
     quaternion_invert_orientation
 } from "../../../../engine/graphics/ecs/camera/quaternion_invert_orientation.js";
+import { GPU_DATABASE_NULL } from "../../buffer/table/GPU_DATABASE_NULL.js";
 import { CSM_CASCADE_STRUCT, CSM_CASTER_RANGE_UNKNOWN } from "./csm/CSM_CASCADE_STRUCT.js";
 import { SHADOWMAP_CSM_CASCADE_BLEND_FRACTION } from "./csm/SHADOWMAP_CSM_CASCADE_BLEND_FRACTION.js";
 import { SHADOWMAP_CSM_CASTER_RANGE_MARGIN_FRACTION } from "./csm/SHADOWMAP_CSM_CASTER_RANGE_MARGIN_FRACTION.js";
@@ -464,6 +465,9 @@ export class DirectionalLightShadowmap extends Shadowmap {
         return {
             first_cascade: this.first_cascade,
             cascade_count: this.cascade_count,
+            // said outright: the slot may have held a virtual map's record a moment ago, and a write
+            // that leaves a field out keeps what the row had
+            virtual_map: GPU_DATABASE_NULL,
         };
     }
 

package/src/shade/renderer/shadow/map/GPUSceneShadowmapContext.d.ts

@@ -50,6 +50,43 @@ export class GPUSceneShadowmapContext {
      * @type {boolean}
      */
     use_tetrahedron_point_shadows: boolean;
+    /**
+     * Gives directional lights virtual shadow maps instead of cascades. The renderer pushes this
+     * from its `feature_virtual_shadow_maps` flag before each light update, alongside
+     * {@link enabled}; a flip is picked up in {@link process_lights}, which rebuilds every
+     * directional map of the other kind on the same pass, as it does for the point-light generator.
+     * @type {boolean}
+     */
+    use_virtual_shadow_maps: boolean;
+    /**
+     * The renderer pushes this from {@link Renderer.shadow_virtual_page_budget} every frame. Pages a
+     * frame wants beyond it wait, best first, for the next.
+     *
+     * @param {number} v pages per frame; zero draws none and leaves every page as it is
+     */
+    set virtual_page_budget(v: number);
+    /**
+     * @returns {number} pages per frame, across the scene's virtual shadow maps
+     */
+    get virtual_page_budget(): number;
+    /**
+     * Added to the level every point of a virtual shadow map selects; positive is coarser. Pushed by
+     * the renderer every frame and written into each map's record, so a change takes effect on the
+     * next frame's demand and sampling alike.
+     * @type {number}
+     */
+    virtual_lod_bias: number;
+    /**
+     * Pushed from {@link Renderer.shadow_virtual_first_texel_size}. A change rebuilds every virtual
+     * shadow map in {@link process_lights}: every page of the clipmap changes size.
+     *
+     * @param {number} v metres, positive
+     */
+    set virtual_first_texel_size(v: number);
+    /**
+     * @returns {number}
+     */
+    get virtual_first_texel_size(): number;
     /**
      * The renderer pushes this from {@link Renderer.shadow_cascade_count} before each light update,
      * alongside {@link enabled}. A change is picked up in {@link process_lights}: every directional
@@ -100,6 +137,22 @@ export class GPUSceneShadowmapContext {
      * @returns {number}
      */
     get cascade_table(): number;
+    /**
+     * Record this frame's virtual shadow map feedback — the casters that moved, the pages they made
+     * stale, the pages the view's pixels ask for — into the frame's `Shading` graph once the main
+     * view's depth exists, and read it back for the maps' next frames. Does nothing in a scene
+     * without virtual shadow maps. See {@link graph_vsm_feedback}.
+     *
+     * @param {Object} options
+     * @param {FrameGraph} options.graph
+     * @param {import("../../view/GPUViewContext.js").GPUViewContext} options.view the main view
+     * @param {number} options.depth graph handle of the main view's depth
+     */
+    graph_virtual_feedback({ graph, view, depth }: {
+        graph: FrameGraph;
+        view: import("../../view/GPUViewContext.js").GPUViewContext;
+        depth: number;
+    }): void;
     /**
      *
      * @param {Light} light
@@ -227,5 +280,6 @@ export type GPURecordWriter = import("../../buffer/table/serde/generate_record_w
 import { MaxRectanglesPacker } from "../../../../core/geom/packing/max-rect/MaxRectanglesPacker.js";
 import { GPUTextureContext } from "../../texture/GPUTextureContext.js";
 import { ViewManager } from "../../view/ViewManager.js";
+import { FrameGraph } from "../../../../engine/graphics/render/frame_graph/FrameGraph.js";
 import AABB2 from "../../../../core/geom/2d/aabb/AABB2.js";
 //# sourceMappingURL=GPUSceneShadowmapContext.d.ts.map

package/src/shade/renderer/shadow/map/GPUSceneShadowmapContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPUSceneShadowmapContext.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shadow/map/GPUSceneShadowmapContext.js"],"names":[],"mappings":"AAsGA;;GAEG;AACH;IAsQI;;;;;;;;OAQG;IACH,sBAPW,eAAe,aACf,eAAe,SAGf,kBAAkB,EAiE5B;IA5UD,2BAAwG;IAExG;;;OAGG;IACH,SAFU,iBAAiB,CAEnB;IAQR;;;;;;;;OAQG;IACH,qBAFU,WAAW,CAED;IAsCpB;;;;;;;;OAQG;IACH,SAFU,OAAO,CAEF;IAEf;;;;;;;;;;OAUG;IACH,+BAFU,OAAO,CAEqB;IAetC;;;;;;;;OAQG;IACH,6BAIC;IApBD;;OAEG;IACH,4BAEC;IA0CD;;;;OAIG;IACH,6BAIC;IAhBD;;OAEG;IACH,4BAEC;IAwED;;OAEG;IACH,iCAEC;IAED;;;;;;OAMG;IACH,oCAEC;IAED;;;;;OAKG;IACH,oCAEC;IAoGD;;;;;OAKG;IACH,4BAMC;IA2LD;;;;OAIG;IACH,eAHW,KAAK,GACH,SAAS,GAAC,SAAS,CAI/B;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4CG;IACH,6BAPW,MAAM,SAEN,eAAe,eACf,MAAM,mBACN,UAAU,MAAM,CAAC,QAoE3B;IAsGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,kBAFW,sBAAsB,QAwFhC;IAsbD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,kBALa,OAAO,CAiQnB;IAED;;;;OAIG;IACH,iBAHW,MAAM,GACJ,KAAK,CAWjB;IAED,gBAiBC;;CACJ;qCA1nDY,OAAO,2CAA2C,EAAE,sBAAsB;8BAC1E,OAAO,0BAA0B,EAAE,eAAe;qBAClD,OAAO,wBAAwB,EAAE,MAAM;iCACvC,OAAO,mCAAmC,EAAE,kBAAkB;oBAC9D,OAAO,4BAA4B,EAAE,KAAK;8BAC1C,OAAO,gCAAgC,EAAE,eAAe;wBACxD,OAAO,gBAAgB,EAAE,SAAS;8BAClC,OAAO,oDAAoD,EAAE,eAAe;oCAtErD,+DAA+D;kCAkBjE,oCAAoC;4BAG1C,2BAA2B;kBAtBrC,wCAAwC"}
+{"version":3,"file":"GPUSceneShadowmapContext.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shadow/map/GPUSceneShadowmapContext.js"],"names":[],"mappings":"AAkJA;;GAEG;AACH;IAoWI;;;;;;;;OAQG;IACH,sBAPW,eAAe,aACf,eAAe,SAGf,kBAAkB,EAiE5B;IA1aD,2BAAwG;IAExG;;;OAGG;IACH,SAFU,iBAAiB,CAEnB;IAQR;;;;;;;;OAQG;IACH,qBAFU,WAAW,CAED;IAsCpB;;;;;;;;OAQG;IACH,SAFU,OAAO,CAEF;IAEf;;;;;;;;;;OAUG;IACH,+BAFU,OAAO,CAEqB;IAEtC;;;;;;OAMG;IACH,yBAFU,OAAO,CAEe;IAehC;;;;;OAKG;IACH,mCAIC;IAjBD;;OAEG;IACH,kCAEC;IAcD;;;;;OAKG;IACH,kBAFU,MAAM,CAEK;IAerB;;;;;OAKG;IACH,wCAKC;IAlBD;;OAEG;IACH,uCAEC;IA4BD;;;;;;;;OAQG;IACH,6BAIC;IApBD;;OAEG;IACH,4BAEC;IA0CD;;;;OAIG;IACH,6BAIC;IAhBD;;OAEG;IACH,4BAEC;IAkGD;;OAEG;IACH,iCAEC;IAED;;;;;;OAMG;IACH,oCAEC;IAED;;;;;OAKG;IACH,oCAEC;IAoGD;;;;;OAKG;IACH,4BAMC;IA2MD;;;;;;;;;;OAUG;IACH;QAJ+B,KAAK,EAAzB,UAAU;QACqD,IAAI,EAAnE,OAAO,8BAA8B,EAAE,cAAc;QACrC,KAAK,EAArB,MAAM;aAuChB;IA0LD;;;;OAIG;IACH,eAHW,KAAK,GACH,SAAS,GAAC,SAAS,CAI/B;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4CG;IACH,6BAPW,MAAM,SAEN,eAAe,eACf,MAAM,mBACN,UAAU,MAAM,CAAC,QAuG3B;IA2GD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,kBAFW,sBAAsB,QA0FhC;IA2bD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,kBALa,OAAO,CAqTnB;IAED;;;;OAIG;IACH,iBAHW,MAAM,GACJ,KAAK,CAWjB;IAED,gBAsBC;;CACJ;qCA/lEY,OAAO,2CAA2C,EAAE,sBAAsB;8BAC1E,OAAO,0BAA0B,EAAE,eAAe;qBAClD,OAAO,wBAAwB,EAAE,MAAM;iCACvC,OAAO,mCAAmC,EAAE,kBAAkB;oBAC9D,OAAO,4BAA4B,EAAE,KAAK;8BAC1C,OAAO,gCAAgC,EAAE,eAAe;wBACxD,OAAO,gBAAgB,EAAE,SAAS;8BAClC,OAAO,oDAAoD,EAAE,eAAe;oCA7ErD,+DAA+D;kCAkBjE,oCAAoC;4BAG1C,2BAA2B;2BApB5B,8DAA8D;kBAFvE,wCAAwC"}