@woosh/meep-engine 3.51.0 → 3.53.0

package/src/engine/graphics3/animation/write_clip_playback.d.ts

@@ -1,26 +1,32 @@
 /**
- * Hand one clip list's blend down to the renderer: what each of the entity's clips weighs, and where
- * each of the audible ones is playing.
+ * @typedef {import("../../../shade/renderer/animation/GPUAnimationManager.js").GPUAnimationManager} GPUAnimationManager
+ * @typedef {import("./AnimationClips.js").AnimationClips} AnimationClips
+ */
+/**
+ * Hand an entity's {@link AnimationClips} blend down to the renderer: what each of its playable
+ * clips weighs, and where each of the audible ones is playing.
  *
  * **Time is written every frame and weight only when it moves.** The clock is the reason this
  * function exists — Shade can advance a clip itself and is never asked to, because the pose gameplay
- * reads and the pose on the screen have to be the same one (I-4) — while a building looping one clip
- * has the weight it had last frame and there is nothing to say. Both calls go through the clip
- * table's upload dedupe, so a repeated value costs a comparison rather than a transfer; skipping the
- * unchanged weights is about not doing the read either.
+ * reads and the pose on the screen have to be the same one (I-4) — while an entity looping one clip
+ * or sitting in one graph state has the weights it had last frame and there is nothing to say. Both
+ * calls go through the clip table's upload dedupe, so a repeated value costs a comparison rather
+ * than a transfer; skipping the unchanged weights is about not doing the read either.
  *
  * A clip at zero weight has its time left alone. It contributes nothing wherever it is, and where it
  * is, is where it stopped.
  *
  * @param {GPUAnimationManager} manager
- * @param {ClipListPlayer} player
- * @param {ArrayLike<number>} clip_ids the manager's id for each of the entity's clips, in its
- * `AnimationClips`' order, or {@link CLIP_NOT_REGISTERED} for one this driver does not play. Those are
+ * @param {AnimationClips} clips
+ * @param {ArrayLike<number>} [clip_ids] the manager's id for each of the entity's clips, in
+ * `clips.clips`' order, or {@link CLIP_NOT_REGISTERED} for one the driver does not play. Those are
  * skipped rather than written at weight zero: an unregistered clip has no row, and it is unregistered
  * precisely so that it marks no joints (D37)
- * @param {Float32Array} written the weight each of those clips was last given; updated in place.
+ * @param {Float32Array} [written] the weight each of those clips was last given; updated in place.
  * A value no weight can take — `-1` — is how a caller says it does not know, which is the case
  * after a renderer restart
  */
-export function write_clip_playback(manager: GPUAnimationManager, player: ClipListPlayer, clip_ids: ArrayLike<number>, written: Float32Array): void;
+export function write_clip_playback(manager: GPUAnimationManager, clips: AnimationClips, clip_ids?: ArrayLike<number>, written?: Float32Array): void;
+export type GPUAnimationManager = import("../../../shade/renderer/animation/GPUAnimationManager.js").GPUAnimationManager;
+export type AnimationClips = import("./AnimationClips.js").AnimationClips;
 //# sourceMappingURL=write_clip_playback.d.ts.map

package/src/engine/graphics3/animation/write_clip_playback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write_clip_playback.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics3/animation/write_clip_playback.js"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,oGARW,UAAU,MAAM,CAAC,WAIjB,YAAY,QAoCtB"}
+{"version":3,"file":"write_clip_playback.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics3/animation/write_clip_playback.js"],"names":[],"mappings":"AAGA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,6CAVW,mBAAmB,SACnB,cAAc,aACd,UAAU,MAAM,CAAC,YAIjB,YAAY,QAwCtB;kCAhEY,OAAO,0DAA0D,EAAE,mBAAmB;6BACtF,OAAO,qBAAqB,EAAE,cAAc"}

package/src/engine/graphics3/animation/write_clip_playback.js

@@ -2,59 +2,68 @@ import { assert } from "../../../core/assert.js";
 import { CLIP_NOT_REGISTERED } from "../register_clips.js";
 
 /**
- * Hand one clip list's blend down to the renderer: what each of the entity's clips weighs, and where
- * each of the audible ones is playing.
+ * @typedef {import("../../../shade/renderer/animation/GPUAnimationManager.js").GPUAnimationManager} GPUAnimationManager
+ * @typedef {import("./AnimationClips.js").AnimationClips} AnimationClips
+ */
+
+/**
+ * Hand an entity's {@link AnimationClips} blend down to the renderer: what each of its playable
+ * clips weighs, and where each of the audible ones is playing.
  *
  * **Time is written every frame and weight only when it moves.** The clock is the reason this
  * function exists — Shade can advance a clip itself and is never asked to, because the pose gameplay
- * reads and the pose on the screen have to be the same one (I-4) — while a building looping one clip
- * has the weight it had last frame and there is nothing to say. Both calls go through the clip
- * table's upload dedupe, so a repeated value costs a comparison rather than a transfer; skipping the
- * unchanged weights is about not doing the read either.
+ * reads and the pose on the screen have to be the same one (I-4) — while an entity looping one clip
+ * or sitting in one graph state has the weights it had last frame and there is nothing to say. Both
+ * calls go through the clip table's upload dedupe, so a repeated value costs a comparison rather
+ * than a transfer; skipping the unchanged weights is about not doing the read either.
  *
  * A clip at zero weight has its time left alone. It contributes nothing wherever it is, and where it
  * is, is where it stopped.
  *
  * @param {GPUAnimationManager} manager
- * @param {ClipListPlayer} player
- * @param {ArrayLike<number>} clip_ids the manager's id for each of the entity's clips, in its
- * `AnimationClips`' order, or {@link CLIP_NOT_REGISTERED} for one this driver does not play. Those are
+ * @param {AnimationClips} clips
+ * @param {ArrayLike<number>} [clip_ids] the manager's id for each of the entity's clips, in
+ * `clips.clips`' order, or {@link CLIP_NOT_REGISTERED} for one the driver does not play. Those are
  * skipped rather than written at weight zero: an unregistered clip has no row, and it is unregistered
  * precisely so that it marks no joints (D37)
- * @param {Float32Array} written the weight each of those clips was last given; updated in place.
+ * @param {Float32Array} [written] the weight each of those clips was last given; updated in place.
  * A value no weight can take — `-1` — is how a caller says it does not know, which is the case
  * after a renderer restart
  */
-export function write_clip_playback(manager, player, clip_ids, written) {
+export function write_clip_playback(
+    manager,
+    clips,
+    clip_ids = clips.clip_registration.ids,
+    written = clips.written
+) {
     assert.defined(manager, 'manager');
-    assert.defined(player, 'player');
+    assert.defined(clips, 'clips');
 
-    const weights = player.weights;
+    const weights = clips.weights;
+    const times = clips.times;
+    const played = clips.played_slots;
 
     assert.equal(clip_ids.length, weights.length, 'clip_ids.length');
     assert.equal(written.length, weights.length, 'written.length');
 
-    for (let i = 0; i < weights.length; i++) {
-        if (clip_ids[i] === CLIP_NOT_REGISTERED) {
+    for (let i = 0; i < played.length; i++) {
+        const slot = played[i];
+        const clip_id = clip_ids[slot];
+
+        if (clip_id === CLIP_NOT_REGISTERED) {
             continue;
         }
 
-        const weight = weights[i];
+        const weight = weights[slot];
 
-        if (weight !== written[i]) {
-            manager.set_playback_weight(clip_ids[i], weight);
+        if (weight !== written[slot]) {
+            manager.set_playback_weight(clip_id, weight);
 
-            written[i] = weight;
+            written[slot] = weight;
         }
-    }
-
-    const playbacks = player.playbacks;
-
-    for (let i = 0; i < playbacks.length; i++) {
-        const playback = playbacks[i];
 
-        if (playback.weight > 0) {
-            manager.set_time(clip_ids[playback.slot], playback.time);
+        if (weight > 0) {
+            manager.set_time(clip_id, times[slot]);
         }
     }
 }

package/src/engine/graphics3/decal/GPUDecalRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPUDecalRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics3/decal/GPUDecalRenderer.js"],"names":[],"mappings":"AA4CA;;;;;;;GAOG;AACH;IA6BI;;;;;;;;;;;OAWG;IACH;QAP8B,KAAK;QACL,OAAO,EAA1B,YAAY;QACC,YAAY,EAAzB,MAAM;QACU,YAAY;QACZ,YAAY;QACZ,SAAS;aAuBnC;IAgPD,gBAoBC;;CACJ"}
+{"version":3,"file":"GPUDecalRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics3/decal/GPUDecalRenderer.js"],"names":[],"mappings":"AA4CA;;;;;;;GAOG;AACH;IA6BI;;;;;;;;;;;OAWG;IACH;QAP8B,KAAK;QACL,OAAO,EAA1B,YAAY;QACC,YAAY,EAAzB,MAAM;QACU,YAAY;QACZ,YAAY;QACZ,SAAS;aAuBnC;IAkPD,gBAoBC;;CACJ"}

package/src/engine/graphics3/decal/GPUDecalRenderer.js

@@ -7,7 +7,7 @@ import { TextureViewDescriptor } from "../../../shade/descriptor/texture/Texture
 import { TextureResourceDescriptor } from "../../../shade/device/graph/TextureResourceDescriptor.js";
 import { G_BUFFER_ALBEDO_FORMAT } from "../../../shade/renderer/gbuffer/G_BUFFER_ALBEDO_FORMAT.js";
 import { TextureFilterType } from "../../../shade/renderer/texture/TextureFilterType.js";
-import { SAMPLER_LINEAR_UPSCALE } from "../../../shade/renderer/texture/SAMPLER_LINEAR_UPSCALE.js";
+import { SAMPLER_ANISOTROPIC_CLAMP } from "../../../shade/renderer/texture/SAMPLER_ANISOTROPIC_CLAMP.js";
 import { graph_build_decal_clusters } from "./graph_build_decal_clusters.js";
 import { DECAL_RECORD_WORD_COUNT } from "./DECAL_GPU_RECORD.js";
 import { shader_decal_composite } from "./shader_decal_composite.js";
@@ -138,7 +138,7 @@ export class GPUDecalRenderer {
         const data = {};
 
         const pass = graph.add('decals / composite', data, (data, resources, execution) => {
-            this.#execute(data, resources, execution, camera, cluster_params, resolution);
+            this.#execute(data, resources, execution, frame.view, cluster_params, resolution);
         });
 
         data.depth = pass.read(frame.get(ViewTextures).depth);
@@ -182,11 +182,12 @@ export class GPUDecalRenderer {
      * @param data
      * @param {FramePassResources} resources
      * @param {GraphicsExecutionContext} context
-     * @param {GPUCameraContext} camera
+     * @param {GPUViewContext} view_context
      * @param {number[]} cluster_params
      * @param {number[]} resolution
      */
-    #execute(data, resources, context, camera, cluster_params, resolution) {
+    #execute(data, resources, context, view_context, cluster_params, resolution) {
+        const camera = view_context.camera;
         const encoder = context.encoder;
         const graphics = context.graphics;
 
@@ -197,7 +198,7 @@ export class GPUDecalRenderer {
             distance_max: camera.camera.far,
         };
 
-        const sampler = graphics.samplers.obtain(SAMPLER_LINEAR_UPSCALE);
+        const sampler = graphics.samplers.obtain(SAMPLER_ANISOTROPIC_CLAMP);
 
         /**
          * @param {number} handle
@@ -217,7 +218,8 @@ export class GPUDecalRenderer {
         shader_decal_composite.draw({
             encoder,
             bindings: {
-                camera: camera.buffer,
+                camera: camera.buffer,
+                view: view_context.uniform_buffer.buffer,
                 settings,
                 gBufferPBR: view(data.in_pbr),
                 gBufferNormal: view(data.in_normal),

package/src/engine/graphics3/decal/shader_decal_composite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_decal_composite.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics3/decal/shader_decal_composite.js"],"names":[],"mappings":"AA8DA,oDAKG;AAqSH;;;;;;;;;;;;GAYG;AACH,qCAFU,WAAW,CAclB;6BAtV0B,qDAAqD;4BAPtD,+CAA+C"}
+{"version":3,"file":"shader_decal_composite.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics3/decal/shader_decal_composite.js"],"names":[],"mappings":"AAgEA,oDAKG;AAySH;;;;;;;;;;;;GAYG;AACH,qCAFU,WAAW,CAclB;6BA1V0B,qDAAqD;4BAPtD,+CAA+C"}

package/src/engine/graphics3/decal/shader_decal_composite.js

@@ -1,4 +1,6 @@
-import { CAMERA_UNIFORM_STRUCT } from "../../../shade/renderer/camera/CAMERA_UNIFORM_STRUCT.js";
+import { CAMERA_UNIFORM_STRUCT } from "../../../shade/renderer/camera/CAMERA_UNIFORM_STRUCT.js";
+import { VIEW_UNIFORM_STRUCT } from "../../../shade/renderer/view/VIEW_UNIFORM_STRUCT.js";
+import { chunk_view_mip_bias } from "../../../shade/renderer/view/chunk_view_mip_bias.js";
 import { G_BUFFER_ALBEDO_FORMAT } from "../../../shade/renderer/gbuffer/G_BUFFER_ALBEDO_FORMAT.js";
 import {
     chunk_cluster_depth_to_z_slice
@@ -73,7 +75,8 @@ const resources = new ShaderResourceSetDescriptor();
 resources.setImmediate("settings", DECAL_COMPOSITE_SETTINGS);
 
 resources.createGroup()
-    .addUniform("camera", CAMERA_UNIFORM_STRUCT);
+    .addUniform("camera", CAMERA_UNIFORM_STRUCT)
+    .addUniform("view", VIEW_UNIFORM_STRUCT);
 
 /*
  The two integer targets are declared as such, exactly as `shader_deferred_main` declares the same
@@ -243,6 +246,8 @@ fn main(
     var normal = shading_normal;
     var emissive = rgbe9995_decode(old_emissive);
 
+    let uv_bias = view_uv_derivative_bias(view.upscale_ratio);
+
     for (var i = 0u; i < metadata.count; i++) {
         let decal_index = cluster_data[metadata.offset + i];
 
@@ -274,8 +279,8 @@ fn main(
         let local_x = (inverse * vec4<f32>(position_x, 1.0)).xy;
         let local_y = (inverse * vec4<f32>(position_y, 1.0)).xy;
 
-        let duv_dx = local_x - local.xy;
-        let duv_dy = local_y - local.xy;
+        let duv_dx = (local_x - local.xy) * uv_bias.x;
+        let duv_dy = (local_y - local.xy) * uv_bias.y;
 
         let lod = decal_vec4(decal_index, ${DECAL_RECORD_OFFSET_LOD}u);
 
@@ -354,7 +359,8 @@ fn main(
         chunk_rgbe9995_encode,
         chunk_light_cluster_resolution_xy_from_screen,
         chunk_cluster_depth_to_z_slice,
-        chunk_grid3d_to_index
+        chunk_grid3d_to_index,
+        chunk_view_mip_bias
     ]
 );
 

package/src/engine/graphics3/pose/collect_entity_playbacks.d.ts

@@ -1,12 +1,12 @@
 /**
- * Collect what every animation driver is playing on an entity, in the form the
- * CPU pose evaluator takes.
+ * Collect what is playing on an entity, in the form the CPU pose evaluator
+ * takes.
  *
- * Both drivers are asked because either may be the one driving it — a combat
- * unit runs a state machine, a building runs a clip list — and an entity has
- * one of them, so the two sets do not overlap in practice. What they hand back
- * is one entry per clip of the model, silent clips included, because that is
- * what the GPU's accumulator is summing.
+ * Whichever animation driver is running (`AnimationSystem` for a clip list,
+ * `AnimationGraphSystem` for a state machine) writes this tick's weights and
+ * times into the entity's {@link AnimationClips} sink. What it hands back is
+ * one entry per clip the driver plays, silent clips included, because that is
+ * what the GPU's accumulator is summing (D37).
  *
  * A free function rather than a private helper of
  * {@link query_entity_node_world_pose} because M3 gave it a second caller:

package/src/engine/graphics3/pose/collect_entity_playbacks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collect_entity_playbacks.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics3/pose/collect_entity_playbacks.js"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,iDARW,cAAc,yCAEd,MAAM,GACJ,IAAI,CAiBhB"}
+{"version":3,"file":"collect_entity_playbacks.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics3/pose/collect_entity_playbacks.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,iDARW,cAAc,yCAEd,MAAM,GACJ,IAAI,CAiBhB"}

package/src/engine/graphics3/pose/collect_entity_playbacks.js

@@ -1,15 +1,14 @@
-import { AnimationGraphSystem } from "../AnimationGraphSystem.js";
-import { AnimationSystem } from "../AnimationSystem.js";
+import { AnimationClips } from "../animation/AnimationClips.js";
 
 /**
- * Collect what every animation driver is playing on an entity, in the form the
- * CPU pose evaluator takes.
+ * Collect what is playing on an entity, in the form the CPU pose evaluator
+ * takes.
  *
- * Both drivers are asked because either may be the one driving it — a combat
- * unit runs a state machine, a building runs a clip list — and an entity has
- * one of them, so the two sets do not overlap in practice. What they hand back
- * is one entry per clip of the model, silent clips included, because that is
- * what the GPU's accumulator is summing.
+ * Whichever animation driver is running (`AnimationSystem` for a clip list,
+ * `AnimationGraphSystem` for a state machine) writes this tick's weights and
+ * times into the entity's {@link AnimationClips} sink. What it hands back is
+ * one entry per clip the driver plays, silent clips included, because that is
+ * what the GPU's accumulator is summing (D37).
  *
  * A free function rather than a private helper of
  * {@link query_entity_node_world_pose} because M3 gave it a second caller:
@@ -26,15 +25,15 @@ import { AnimationSystem } from "../AnimationSystem.js";
  * @copyright Company Named Limited (c) 2026
  */
 export function collect_entity_playbacks(target, entity_manager, entity) {
-    const graphs = entity_manager.getSystem(AnimationGraphSystem);
+    const dataset = entity_manager.dataset;
 
-    if (graphs !== null) {
-        graphs.write_pose_playbacks(target, entity);
+    if (dataset === null || entity < 0 || !dataset.entityExists(entity)) {
+        return;
     }
 
-    const clips = entity_manager.getSystem(AnimationSystem);
+    const clips = dataset.getComponent(entity, AnimationClips);
 
-    if (clips !== null) {
-        clips.write_pose_playbacks(target, entity);
+    if (clips !== undefined) {
+        clips.write_pose_playbacks(target);
     }
 }

package/src/engine/graphics3/prefab/Prefab.d.ts

@@ -103,6 +103,12 @@ export class Prefab {
      * @type {ShadeAnimationClip[]}
      */
     clips: ShadeAnimationClip[];
+    /**
+     * Aeroelastic foliage wind rigs whose `root` and joint `target`s address prefab node indices.
+     *
+     * @type {import("../../../shade/renderer/animation/foliage/FoliageWindRig.js").FoliageWindRig[]}
+     */
+    foliage_rigs: import("../../../shade/renderer/animation/foliage/FoliageWindRig.js").FoliageWindRig[];
     /**
      * Which node the asset calls `name`. A name authored twice answers with the first node in
      * pre-order, which is the same answer a search would have given.

package/src/engine/graphics3/prefab/Prefab.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Prefab.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics3/prefab/Prefab.js"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH;IACI;;;;OAIG;IACH,MAFU,MAAM,CAEP;IAET;;OAEG;IACH,UAFU,eAAe,CAET;IAEhB;;OAEG;IACH,UAFU,aAAa,CAEP;IAEhB;;;;;OAKG;IACH,MAFU,MAAM,CAEN;CACb;AAED;;;;;;;;;;;;;;;GAeG;AACH;IACI;;OAEG;IACH,YAFU,MAAM,CAED;IAEf;;;;OAIG;IACH,QAFU,UAAU,CAEO;IAE3B;;;;OAIG;IACH,MAFU,MAAM,EAAE,CAER;IAEV;;;;;OAKG;IACH,OAFU,WAAW,EAAE,CAEZ;IAEX;;;;;OAKG;IACH,OAFU,YAAY,EAAE,CAEb;IAEX;;;;;;;OAOG;IACH,UAFU,UAAU,CAES;IAE7B;;OAEG;IACH,YAFU,eAAe,EAAE,CAEX;IAEhB;;;;OAIG;IACH,OAFU,IAAI,EAAE,CAEL;IAEX;;;;OAIG;IACH,OAFU,kBAAkB,EAAE,CAEnB;IAOX;;;;;;OAMG;IACH,eAHW,MAAM,GACJ,MAAM,CAMlB;IAED;;OAEG;IACH,oBAcC;IAGL;;;OAGG;IACH,mBAFU,OAAO,CAEQ;;CANxB;8BA1JY,OAAO,qDAAqD,EAAE,eAAe;4BAC7E,OAAO,mDAAmD,EAAE,aAAa;mBACzE,OAAO,2CAA2C,EAAE,IAAI;iCACxD,OAAO,yDAAyD,EAAE,kBAAkB;0BACpF,OAAO,oCAAoC,EAAE,WAAW"}
+{"version":3,"file":"Prefab.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics3/prefab/Prefab.js"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH;IACI;;;;OAIG;IACH,MAFU,MAAM,CAEP;IAET;;OAEG;IACH,UAFU,eAAe,CAET;IAEhB;;OAEG;IACH,UAFU,aAAa,CAEP;IAEhB;;;;;OAKG;IACH,MAFU,MAAM,CAEN;CACb;AAED;;;;;;;;;;;;;;;GAeG;AACH;IACI;;OAEG;IACH,YAFU,MAAM,CAED;IAEf;;;;OAIG;IACH,QAFU,UAAU,CAEO;IAE3B;;;;OAIG;IACH,MAFU,MAAM,EAAE,CAER;IAEV;;;;;OAKG;IACH,OAFU,WAAW,EAAE,CAEZ;IAEX;;;;;OAKG;IACH,OAFU,YAAY,EAAE,CAEb;IAEX;;;;;;;OAOG;IACH,UAFU,UAAU,CAES;IAE7B;;OAEG;IACH,YAFU,eAAe,EAAE,CAEX;IAEhB;;;;OAIG;IACH,OAFU,IAAI,EAAE,CAEL;IAEX;;;;OAIG;IACH,OAFU,kBAAkB,EAAE,CAEnB;IAEX;;;;OAIG;IACH,cAFU,OAAO,6DAA6D,EAAE,cAAc,EAAE,CAE9E;IAOlB;;;;;;OAMG;IACH,eAHW,MAAM,GACJ,MAAM,CAMlB;IAED;;OAEG;IACH,oBAcC;IAGL;;;OAGG;IACH,mBAFU,OAAO,CAEQ;;CANxB;8BAjKY,OAAO,qDAAqD,EAAE,eAAe;4BAC7E,OAAO,mDAAmD,EAAE,aAAa;mBACzE,OAAO,2CAA2C,EAAE,IAAI;iCACxD,OAAO,yDAAyD,EAAE,kBAAkB;0BACpF,OAAO,oCAAoC,EAAE,WAAW"}