@volter/blender-engine 0.1.36 → 0.1.37

package/browser/protocol.ts

@@ -76,6 +76,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 }
+  /** 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' }
   | { id: number; op: 'read-file'; path: string }
   | { id: number; op: 'write-file'; path: string; bytes: Uint8Array }
   | { id: number; op: 'list-files'; path: string }

package/browser/runtime.ts

@@ -318,6 +318,12 @@ export class BlenderRuntime {
     })) as BlenderRnaWrite;
   }
 
+  /** Keep a person's shading pick in the file's own 3D View, as UI state (no save of its own). */
+  async viewShading(shading: 'WIREFRAME' | 'SOLID' | 'MATERIAL' | 'RENDERED'): Promise<void> {
+    await this.#ready();
+    await this.#request({ op: 'view-shading', shading });
+  }
+
   /** BLENDER'S VIEW LAYER TREE for the scene — what its Outliner shows, as
    *  rows (`./rna.ts`, `BlenderOutlinerTree`). `selected` is our viewport's
    *  selection by object name; reading it never writes the engine's. */

package/browser/session.py

@@ -789,6 +789,23 @@ def _saved_view():
     return None
 
 
+def _view_shading(shading):
+    """A person's shading pick, written where Blender keeps it: the `View3DShading.type` of the 3D
+    View `_saved_view` reads. UI STATE, NOT THE MODEL: nothing is marked changed, so it rides the
+    next save the model's own edits make, as a shading change in Blender is kept only by a save."""
+    screens = [window.screen for wm in bpy.data.window_managers for window in wm.windows
+               if window.screen is not None]
+    workspace = bpy.data.workspaces.get("Modeling")
+    screens.extend(workspace.screens if workspace is not None else [])
+    screens.extend(bpy.data.screens)
+    for screen in screens:
+        for area in screen.areas:
+            if area.type == "VIEW_3D":
+                area.spaces[0].shading.type = shading
+                return {"shading": area.spaces[0].shading.type}
+    return {"shading": None}
+
+
 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
@@ -5002,6 +5019,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 == "view-shading":
+        return _view_shading(request["shading"])
     if op == "rna-set":
         SESSION.mark_changed()
         answer = rna_set(request["path"], request["property"], request["value"],

package/browser/three/blender-runtime-view.ts

@@ -843,6 +843,10 @@ export class BlenderRuntimeView {
    * draw mode Blender reopens it in (null from a file whose view carried none). Null before a
    * frame or when the file saved no 3D View.
    */
+  noteSavedShading(shading: keyof typeof SAVED_SHADING): void {
+    if (this.frame?.view) this.frame.view.shading = shading;
+  }
+
   savedView(): {
     readonly target: readonly [number, number, number];
     readonly direction: readonly [number, number, number];

package/browser/worker.ts

@@ -508,6 +508,8 @@ async function handle(request: WorkerRequest): Promise<unknown> {
         ...(request.object === undefined ? {} : { object: request.object }),
         ...(request.collection === undefined ? {} : { collection: request.collection }),
       });
+    case 'view-shading':
+      return ask({ op: 'view-shading', shading: request.shading });
     case 'rna-set':
       return ask({
         op: 'rna-set',

package/package.json

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