@woosh/meep-engine 3.38.0 → 3.40.0

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

@@ -50,6 +50,57 @@ 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
+     * map built with another count is evicted and rebuilt with this one in the same pass, which
+     * gives its atlas rects back first. A rebuilt map has no caster range until its first readback
+     * lands, two frames on, so its near planes are its slices' own until then.
+     *
+     * @param {number} v at least one
+     */
+    set cascade_count(v: number);
+    /**
+     * @returns {number} cascades per directional shadow map
+     */
+    get cascade_count(): number;
     /**
      * @param {number} v views per frame, at least one. A higher budget keeps more lights current
      *        and rasterizes more per frame; a lower one refreshes fewer of them per frame and
@@ -80,12 +131,28 @@ export class GPUSceneShadowmapContext {
      */
     get debug_drop_size_scale(): number;
     /**
-     * The readback service's handle for the light database's `shadow_csm_caster_range` table —
-     * what a directional map asks its range through.
+     * The readback service's handle for the light database's `shadow_cascade` table — what a
+     * directional map asks its caster range through.
      *
      * @returns {number}
      */
-    get caster_range_table(): 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
@@ -110,7 +177,8 @@ export class GPUSceneShadowmapContext {
      *     up (no forced redraw).
      *  4. **Score + select.** Delegated to {@link ShadowmapDrawSelector}, which sets `should_draw`
      *     on the winners and reports the view spend and whether any candidate went unmet:
-     *        - **Directional** → always selected (infinite score); view cost still charged.
+     *        - **Directional** → always selected (infinite score); its views are counted in the
+     *          frame's spend but not charged against the budget the local lights compete for.
      *        - **Local, off-screen** (`projected_area_px <= 0`) → skipped entirely.
      *        - **Local, in-view, invalid** → MUST draw. `is_invalid` means the committed layout
      *          has never held valid depth (freshly created map); sampling it would display
@@ -208,8 +276,10 @@ export type GPULightCollection = import("../../light/GPULightCollection.js").GPU
 export type Light = import("../../light/model/Light.js").Light;
 export type GPUSceneContext = import("../../scene/GPUSceneContext.js").GPUSceneContext;
 export type Shadowmap = import("./Shadowmap.js").Shadowmap;
+export type GPURecordWriter = import("../../buffer/table/serde/generate_record_writer.js").GPURecordWriter;
 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":"AA0FA;;GAEG;AACH;IAgPI;;;;;;;;OAQG;IACH,sBAPW,eAAe,aACf,eAAe,SAGf,kBAAkB,EAiE5B;IAtTD,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;IA2BtC;;;;OAIG;IACH,6BAIC;IAhBD;;OAEG;IACH,4BAEC;IA8ED;;OAEG;IACH,iCAEC;IAED;;;;;;OAMG;IACH,oCAEC;IAED;;;;;OAKG;IACH,oCAEC;IAoGD;;;;;OAKG;IACH,iCAMC;IAoKD;;;;OAIG;IACH,eAHW,KAAK,GACH,SAAS,GAAC,SAAS,CAI/B;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2CG;IACH,6BAPW,MAAM,SAEN,eAAe,eACf,MAAM,mBACN,UAAU,MAAM,CAAC,QAoE3B;IAyED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,kBAFW,sBAAsB,QAwFhC;IAsbD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,kBALa,OAAO,CAwOnB;IAED;;;;OAIG;IACH,iBAHW,MAAM,GACJ,KAAK,CAWjB;IAED,gBAiBC;;CACJ;qCA/gDY,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;oCAhEX,+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"}