@volter/blender-engine 0.1.141 → 0.1.143

package/browser/protocol.ts

@@ -72,7 +72,7 @@ export type WorkerRequest =
    *  bone, the LOCAL transform at every integer frame of the action's range,
    *  plus the scene's frame range/fps and the summary row's key columns.
    *  READ ONLY: keying, moving a key and setting a range are edits. */
-  | { id: number; op: 'action-clip'; object?: string; bake?: boolean; action?: string }
+  | { id: number; op: 'action-clip'; object?: string; bake?: boolean; action?: string; summary?: boolean }
   /** ONE RESTRICTION COLUMN, written (`session.py`'s `outliner_set`). A column
    *  Blender draws on no row of that type is refused by name. */
   | { id: number; op: 'outliner-set'; path: string; column: string; value: boolean }

package/browser/rna.ts

@@ -602,6 +602,8 @@ export interface BlenderActionClip {
   readonly armature: string | null;
   readonly action: string | null;
   readonly slot: string | null;
+  /** The action's object slots: at most one means every armature reads the same curves. */
+  readonly objectSlots?: number;
   /** `layered` at this pin — an `Action` has no `.fcurves`; they live at
    *  `layers[0].strips[0].channelbags[0].fcurves`. `legacy` is the branch for
    *  a build where the old attribute is still there. */

package/browser/runtime.ts

@@ -424,13 +424,14 @@ export class BlenderRuntime {
    *  false` answers the header and the summary row's key columns without the
    *  sampled tracks, which is what a Timeline that only needs to DRAW asks
    *  for. */
-  async actionClip(options?: { object?: string; bake?: boolean; action?: string }): Promise<BlenderActionClip> {
+  async actionClip(options?: { object?: string; bake?: boolean; action?: string; summary?: boolean }): Promise<BlenderActionClip> {
     await this.#ready();
     return (await this.#request({
       op: 'action-clip',
       ...(options?.object === undefined ? {} : { object: options.object }),
       ...(options?.bake === undefined ? {} : { bake: options.bake }),
       ...(options?.action === undefined ? {} : { action: options.action }),
+      ...(options?.summary === undefined ? {} : { summary: options.summary }),
     })) as BlenderActionClip;
   }
 

package/browser/session.py

@@ -5081,7 +5081,7 @@ def _summary_objects():
     return out
 
 
-def rna_action_clip(object_name=None, bake=True, action_name=None):
+def rna_action_clip(object_name=None, bake=True, action_name=None, summary=True):
     """ONE ACTION AS A THREE.JS CLIP: per bone, the LOCAL transform it has at
     every integer frame of the action's own range.
 
@@ -5148,7 +5148,10 @@ def rna_action_clip(object_name=None, bake=True, action_name=None):
         # (`show_keys_from_selected_only`) and the view is what decides which
         # side of that filter it is on, so the door answers both halves even
         # when the subject below turns out to be nothing at all.
-        "summary": _summary_objects(),
+        # `summary=False` for a reader that plays the clip (a game's clip library): the row walks
+        # every animated object in the view layer, which was ~690 of a ~700 ms read on a level of
+        # 23 armatures (measured 2026-10-08), and nothing that plays a clip draws it.
+        "summary": _summary_objects() if summary else [],
     }
     adt = arm_obj.animation_data if arm_obj is not None else None
     assigned = adt.action if adt is not None else None
@@ -5181,6 +5184,11 @@ def rna_action_clip(object_name=None, bake=True, action_name=None):
                 header["reason"] = ("%r has %d object slots and none named for %r; the first, %r, is played."
                                     % (action.name, len(slots), arm_obj.name, getattr(slot, "identifier", "?")))
     curves, shape = _action_channelbag(action, getattr(slot, "handle", None))
+    # HOW MANY OBJECT SLOTS THE ACTION HAS: with one (or a legacy action, none) every armature
+    # reads the same curves, so a reader may share the clip across armatures with the same bones;
+    # with several, which one plays depends on the armature, so it may not.
+    header["objectSlots"] = len([one for one in getattr(action, "slots", ())
+                                 if getattr(one, "target_id_type", "OBJECT") == "OBJECT"])
     header.update({
         "action": action.name,
         "slot": getattr(slot, "name_display", None),
@@ -5882,7 +5890,8 @@ def _dispatch(request):
     # and neither owes a derivation. There is deliberately no writer beside
     # them -- keying, moving a key and setting a range are edits.
     if op == "action-clip":
-        return rna_action_clip(request.get("object"), request.get("bake", True), request.get("action"))
+        return rna_action_clip(request.get("object"), request.get("bake", True), request.get("action"),
+                               request.get("summary", True))
     if op == "outliner":
         return rna_outliner(request.get("selected"))
     if op == "outliner-set":

package/browser/worker.ts

@@ -811,6 +811,7 @@ async function handle(request: WorkerRequest): Promise<unknown> {
         ...(request.object === undefined ? {} : { object: request.object }),
         ...(request.bake === undefined ? {} : { bake: request.bake }),
         ...(request.action === undefined ? {} : { action: request.action }),
+        ...(request.summary === undefined ? {} : { summary: request.summary }),
       });
     case 'outliner-set':
       return ask({

package/package.json

@@ -2,7 +2,7 @@
   "name": "@volter/blender-engine",
   "author": "Volter AI, Inc.",
   "license": "GPL-3.0-or-later",
-  "version": "0.1.141",
+  "version": "0.1.143",
   "publishConfig": {
     "access": "public"
   },