@volter/blender-engine 0.1.151 → 0.1.153

package/browser/protocol.ts

@@ -99,6 +99,9 @@ export type WorkerRequest =
   /** 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 }
+  /** THE EDITOR'S SELECTION, written only where it differs from Blender's (`session.py`'s
+   *  `selection_set`): the named objects selected, the rest deselected, `active` made active when given. */
+  | { id: number; op: 'selection-set'; names: readonly string[]; active: string | null }
   /** A person's shading pick, kept in the file's own 3D View (`session.py`'s `_view_shading`);
    *  UI state, so it marks nothing changed and rides the next save. */
   | { id: number; op: 'view-shading'; shading: 'WIREFRAME' | 'SOLID' | 'MATERIAL' | 'RENDERED' }

package/browser/runtime.ts

@@ -488,6 +488,13 @@ export class BlenderRuntime {
     })) as BlenderOutlinerWrite;
   }
 
+  /** Select the named objects (the rest deselected) and make `active` active when given; `changed`
+   *  says whether Blender's selection differed, the only case that is written and saved. */
+  async selectionSet(names: readonly string[], active: string | null): Promise<{ changed: boolean }> {
+    await this.#ready();
+    return (await this.#request({ op: 'selection-set', names, active })) as { changed: boolean };
+  }
+
   /** Present the engine’s current state without capture. Documents ask on mount so an opened .blend draws before its first mutation. */
   async present(): Promise<void> {
     await this.#ready();

package/browser/session.py

@@ -708,6 +708,41 @@ def _view_shading(shading):
     return {"shading": None}
 
 
+def selection_set(names, active):
+    """THE EDITOR'S SELECTION, written into the view layer only where it differs from Blender's own.
+
+    `names` are the objects to select, every other object of the view layer deselected; `active`,
+    when given and in the view layer, becomes the active object (a deselect leaves Blender's active
+    base as it is, `object_select.cc::base_deselect_all_ex`). Selection is saved in the .blend, so a
+    write that changes it is a change to save. What changed is read back from Blender, never
+    assumed from the request: Blender keeps an object it will not select (selection disabled,
+    disabled in viewports, hidden: `base_select`) as it was, so a click on such a row changes
+    nothing and is not saved or presented."""
+    view_layer = bpy.context.view_layer
+
+    def held():
+        return {o.name for o in view_layer.objects if o.select_get()}, view_layer.objects.active
+
+    before = held()
+    wanted = set(names)
+    for o in view_layer.objects:
+        o.select_set(o.name in wanted)
+    target = bpy.data.objects.get(active) if active is not None else None
+    # (an object outside the view layer has no base to make active; Blender would refuse the assignment)
+    if target is not None and view_layer.objects.get(target.name) == target:
+        view_layer.objects.active = target
+    if held() == before:
+        return {"changed": False}
+    SESSION.mark_changed()
+    try:
+        SESSION.present()
+    except Exception as thrown:  # noqa: BLE001
+        # Escalate present failures because the displayed document still holds its preceding state.
+        _say("@@VOLTER-ERROR the present after this call failed, so the Model document is "
+             "showing the state before it: " + repr(thrown))
+    return {"changed": True}
+
+
 def _subject_line(scene, view_layer):
     """The 3D Viewport's second overlay line, as `draw_selected_name` (`view3d_draw.cc`) writes it,
     less the two parts that follow the playhead: the tab draws `(frame)` and the marker on it
@@ -5842,6 +5877,8 @@ def _dispatch(request):
             _say("@@VOLTER-ERROR the present after this call failed, so the Model document is "
                  "showing the state before it: " + repr(thrown))
         return answer
+    if op == "selection-set":
+        return selection_set(request["names"], request.get("active"))
     if op == "view-shading":
         return _view_shading(request["shading"])
     if op == "rna-set":

package/browser/worker.ts

@@ -837,6 +837,8 @@ async function handle(request: WorkerRequest): Promise<unknown> {
         column: request.column,
         value: request.value,
       });
+    case 'selection-set':
+      return ask({ op: 'selection-set', names: request.names, active: request.active });
     case 'screenshot-view':
       return JSON.parse((await session.screenshotView(request.maxSize)) as string);
     case 'read-file':

package/package.json

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