@volter/blender-engine 0.1.127 → 0.1.128

package/browser/blender-emscripten-engine.mts

@@ -151,7 +151,13 @@ function moduleFiles(module: BlenderModule): BlenderFiles {
  */
 const ARTIFACT_CACHE = 'volter-blender-artifacts';
 
-async function cachedArtifact(file: string, digest: string | undefined, checkpoint: () => Promise<void>): Promise<Response> {
+/**
+ * THE CACHE SPEEDS AN OPEN UP; IT NEVER DECIDES WHETHER BLENDER OPENS. A Cache Storage that cannot
+ * open or answer (measured 2026-10-07, headless Chrome on Windows: `caches.open` threw "Unexpected
+ * internal error", and the model failed to open on it) means the artifact is fetched from the editor
+ * as it would be with no digest; bytes that cannot be kept are used anyway. `note` says which, per artifact, as page output (not an unresolved console entry).
+ */
+async function cachedArtifact(file: string, digest: string | undefined, checkpoint: () => Promise<void>, note: (text: string) => void): Promise<Response> {
   const bounded = (response: Response): Response => response.ok && response.body
     ? new Response(checkpointStream(response.body, checkpoint), { status: response.status, headers: response.headers })
     : response;
@@ -159,18 +165,29 @@ async function cachedArtifact(file: string, digest: string | undefined, checkpoi
   const fetchArtifact = () => startupOperation(url, 'fetch artifact', () => fetch(url));
   if (!digest || typeof caches === 'undefined') return bounded(await fetchArtifact());
   const key = `${url}?sha256=${digest}`;
-  const cache = await startupOperation(url, 'open artifact cache', () => caches.open(ARTIFACT_CACHE));
-  const hit = await startupOperation(url, 'read artifact cache', () => cache.match(key));
-  if (hit) return bounded(hit);
+  const reason = (error: unknown) => (error instanceof Error ? error.message : String(error));
+  const opened = await startupOperation(url, 'open artifact cache', () => caches.open(ARTIFACT_CACHE))
+    .then(async (cache) => ({ cache, hit: await startupOperation(url, 'read artifact cache', () => cache.match(key)) }))
+    .catch((error: unknown) => {
+      note(`Blender's artifact cache is unavailable (${reason(error)}); ${file} is fetched from the editor instead.`);
+      return null;
+    });
+  if (!opened) return bounded(await fetchArtifact());
+  if (opened.hit) return bounded(opened.hit);
+  const { cache } = opened;
   const response = bounded(await fetchArtifact());
   if (!response.ok) return response;
-  // One build's bytes per file: an older build's are dropped as this one lands.
-  await startupOperation(url, 'prune previous artifact cache entries', async () => {
-    for (const old of await cache.keys()) if (old.url.startsWith(`${url}?sha256=`) && old.url !== key) await cache.delete(old);
-  });
   const body = await startupOperation(url, 'read artifact body for cache', () => response.blob());
   const kept = new Response(body, { headers: { 'content-type': response.headers.get('content-type') ?? 'application/octet-stream' } });
-  await startupOperation(url, 'write artifact cache', () => cache.put(key, kept.clone()));
+  try {
+    // One build's bytes per file: an older build's are dropped as this one lands.
+    await startupOperation(url, 'prune previous artifact cache entries', async () => {
+      for (const old of await cache.keys()) if (old.url.startsWith(`${url}?sha256=`) && old.url !== key) await cache.delete(old);
+    });
+    await startupOperation(url, 'write artifact cache', () => cache.put(key, kept.clone()));
+  } catch (error) {
+    note(`Blender's artifact cache could not keep ${file} (${reason(error)}); the next open fetches it again.`);
+  }
   return kept;
 }
 
@@ -187,7 +204,9 @@ export async function startEmscriptenBlenderEngine(
   const glueUrl = artifactUrl('blender_browser.js');
   const digests = status.digests ?? {};
   const checkpoint = async (phase: string): Promise<void> => { await options.ask({ checkpoint: phase }); };
-  const artifact = (file: string) => cachedArtifact(file, digests[file], () => checkpoint(`artifact/${file}`));
+  // Page output, not an editor-console condition: nothing in the project can resolve the browser's cache.
+  const noteCache = (text: string) => options.log('log', text);
+  const artifact = (file: string) => cachedArtifact(file, digests[file], () => checkpoint(`artifact/${file}`), noteCache);
   // The `.data` package is handed to the glue whole (`getPreloadedPackage`),
   // so it is read before the module starts; the wasm streams in beside it.
   const [factory, preloaded] = await Promise.all([
@@ -354,7 +373,7 @@ export async function startEmscriptenBlenderEngine(
   const files = moduleFiles(module);
   FS.chmod('/bw/datafiles', 0o755);
   await checkpoint('python-ready');
-  await mountEssentials(files, digests['essentials.bin'], checkpoint);
+  await mountEssentials(files, digests['essentials.bin'], checkpoint, noteCache);
   const { request } = openSessionChannel(files, options);
 
   return {
@@ -381,11 +400,11 @@ export async function startEmscriptenBlenderEngine(
 /** Assets are data, not a second engine. Ship them separately so a data update
  * does not relink the 86 MB Wasm binary. Both payload and per-file bounds are
  * checked before anything enters Blender's filesystem. */
-async function mountEssentials(files: BlenderFiles, digest: string | undefined, checkpoint: (phase: string) => Promise<void>): Promise<void> {
+async function mountEssentials(files: BlenderFiles, digest: string | undefined, checkpoint: (phase: string) => Promise<void>, noteCache: (text: string) => void): Promise<void> {
   const indexUrl = artifactUrl('essentials.json');
   const payloadUrl = artifactUrl('essentials.bin');
   const [indexResponse, payloadResponse] = await Promise.all([
-    startupOperation(indexUrl, 'fetch Essentials index', () => fetch(indexUrl)), cachedArtifact('essentials.bin', digest, () => checkpoint('artifact/essentials.bin')),
+    startupOperation(indexUrl, 'fetch Essentials index', () => fetch(indexUrl)), cachedArtifact('essentials.bin', digest, () => checkpoint('artifact/essentials.bin'), noteCache),
   ]);
   if (!indexResponse.ok || !payloadResponse.ok)
     throw new Error(`Blender Essentials assets are missing (${indexUrl}: HTTP ${indexResponse.status}; ${payloadUrl}: HTTP ${payloadResponse.status})`);

package/browser/blender-engine.mts

@@ -172,7 +172,7 @@ export interface BlenderEngine {
   readonly bootMs: number;
   /** The engine's memory in bytes, now. Linear memory on the standalone skew;
    *  null where the skew cannot see the module's memory from the host, which
-   *  is the WALI case and is why `volter-model-editor status` prints "unreported" rather than
+   *  is the WALI case and is why `cyclotron status` prints "unreported" rather than
    *  a zero. */
   memoryBytes(): number | null;
   /** Bytes of packed `.data` payload handed back after boot, or null when the
@@ -361,7 +361,7 @@ export function openSessionChannel(
    *
    * The loop below waits for `out/<id>.done` and nothing else. When the
    * program behind the directory DIES, that file is never written, so the
-   * call waits forever: `volter-model-editor status` reports it IN FLIGHT for as long as
+   * call waits forever: `cyclotron status` reports it IN FLIGHT for as long as
    * anyone looks, `blender-start` keeps answering from the host's cached
    * banner, and the harness has no answer to time out against. MEASURED
    * 2026-09-19 three times on the WALI skew -- 507 s, 621 s and 964 s of a

package/browser/blender-wali-engine.mts

@@ -574,7 +574,7 @@ export async function startWaliBlenderEngine(
     readArena: () => filesystem.readFile(ARENA_PATH),
     bootMs,
     // The module's memory is the program worker's and no door reports it.
-    // Null rather than zero: `volter-model-editor status` prints "unreported", which is true,
+    // Null rather than zero: `cyclotron status` prints "unreported", which is true,
     // where a zero would be a measurement that was never taken.
     memoryBytes: () => null,
     // There is no packed payload on this skew: Blender's runtime tree is

package/browser/protocol.ts

@@ -181,6 +181,8 @@ export interface RenderRequest {
    *  `'None'` means the base transform; anything else is a look the view holds
    *  a baked table for, because the renderer refuses the rest by name. */
   look?: string;
+  /** Display gamma, applied after the view transform; alpha is unaffected. */
+  gamma?: number;
   /** Hand back the SCENE-REFERRED half-float frame too. An EXR is written
    *  from it, and so is the COMPOSITOR's input. */
   linear?: boolean;

package/browser/runtime.ts

@@ -216,7 +216,7 @@ export class BlenderRuntime {
       // The page console is the editor's ledger (`installEditorConsoleReporting`
       // captures it, source-blind), and this package may import nothing of the
       // editor to say it any other way. Without this line the failure reached
-      // a toast and `volter-model-editor console` read 0/0 while no Model document could open
+      // a toast and `cyclotron console` read 0/0 while no Model document could open
       // (measured 2026-09-20 from a registry install).
       console.error(error.message);
       for (const id of [...this.#pending.keys()]) this.#settled(id);

package/browser/session.py

@@ -407,13 +407,13 @@ def _describe_world_socket(root_socket, camera_ray):
                 return float(default) if isinstance(default, (float, int)) else [float(c) for c in list(default)[:3]]
             if kind == "ShaderNodeTexSky" and socket == "Color":
                 model = node.sky_type
-                if model != "MULTIPLE_SCATTERING":
+                if model not in ("SINGLE_SCATTERING", "MULTIPLE_SCATTERING"):
                     raise NotImplementedError(
-                        "World Sky Texture: sky_type %r is not implemented (MULTIPLE_SCATTERING is)" % model)
+                        "World Sky Texture: sky_type %r is not implemented (SINGLE_SCATTERING and MULTIPLE_SCATTERING are)" % model)
                 vector = node.inputs.get("Vector")
                 if vector is not None and vector.links:
                     raise NotImplementedError("Linked World Sky Texture Vector")
-                return {"kind": "sky", "sun_elevation": float(node.sun_elevation),
+                return {"kind": "sky", "sky_model": model, "sun_elevation": float(node.sun_elevation),
                         "sun_rotation": float(node.sun_rotation), "altitude": float(node.altitude),
                         "air_density": float(node.air_density), "aerosol_density": float(node.aerosol_density),
                         "ozone_density": float(node.ozone_density)}
@@ -608,7 +608,7 @@ _GRAPH_NODES = frozenset((
     "ShaderNodeGamma", "ShaderNodeRGBToBW", "ShaderNodeSeparateColor", "ShaderNodeCombineColor",
     "ShaderNodeVectorRotate", "ShaderNodeFresnel", "ShaderNodeLayerWeight", "ShaderNodeBump",
     "ShaderNodeNormalMap", "ShaderNodeNewGeometry", "ShaderNodeVertexColor", "ShaderNodeAttribute",
-    "ShaderNodeRGBCurve", "ShaderNodeVectorCurve", "ShaderNodeFloatCurve",
+    "ShaderNodeRGBCurve", "ShaderNodeVectorCurve", "ShaderNodeFloatCurve", "ShaderNodeObjectInfo",
 ))
 # The surfaces whose inputs map onto the presenter's standard material, and
 # the inputs of each the presenter reads from a graph.
@@ -959,6 +959,10 @@ class _MaterialGraph:
         if node.bl_idname in _GENERATED_BY_DEFAULT and not bool(_links_into(node.inputs[0])):
             self.generated = True
         props = _node_properties(node)
+        if node.bl_idname == "ShaderNodeObjectInfo":
+            # node_shader_gpu_object_info: the index belongs to this material,
+            # even when the node itself is inside a shared node group.
+            props["material_index"] = float(self.material.pass_index)
         if props.get("image"):
             self.images.add(props["image"])
         return {
@@ -1133,6 +1137,33 @@ def _mixed_graph(material, stack, surface):
     }
 
 
+def _object_info_random(name):
+    """Ordinary-object Random, shared by EEVEE and Cycles: hash_string then
+    Jenkins hash_uint2(name_hash, 0), converted to float32 * 2**-32.
+    Instances must use depsgraph.random_id instead; their export is separate.
+    See draw_handle.hh::random and cycles/blender/object.cpp.
+    """
+    import struct
+
+    mask = 0xffffffff
+    h = 0
+    # Blender's platform flags specify -funsigned-char (native and WASM).
+    for byte in name.encode("utf8"):
+        h = (h * 37 + byte) & mask
+    a = (0xdeadbeef + 21 + h) & mask
+    b = c = (0xdeadbeef + 21) & mask
+    def rotate(x, bits):
+        return ((x << bits) | (x >> (32 - bits))) & mask
+    c = ((c ^ b) - rotate(b, 14)) & mask
+    a = ((a ^ c) - rotate(c, 11)) & mask
+    b = ((b ^ a) - rotate(a, 25)) & mask
+    c = ((c ^ b) - rotate(b, 16)) & mask
+    a = ((a ^ c) - rotate(c, 4)) & mask
+    b = ((b ^ a) - rotate(a, 14)) & mask
+    c = ((c ^ b) - rotate(b, 24)) & mask
+    return struct.unpack("f", struct.pack("f", c / 4294967296.0))[0]
+
+
 def material_graphs(scene):
     """Every graph the scene's materials need, by material name."""
     _TREE_LINKS.clear()
@@ -1454,6 +1485,12 @@ class Session:
                 if not any(m in graphs for m in row["materials"] if m is not None):
                     continue
                 obj = by_name.get(row["name"])
+                if obj is not None:
+                    row["object_info"] = {
+                        "color": [float(v) for v in obj.color],
+                        "index": float(obj.pass_index),
+                        "random": _object_info_random(obj.name),
+                    }
                 data = obj.evaluated_get(depsgraph).data if obj is not None else None
                 if getattr(data, "use_auto_texspace", True) is False:
                     row["texspace"] = [[float(v) for v in data.texspace_location],
@@ -2013,7 +2050,7 @@ _ASK_SEQUENCE = [0]
 def _drop(path):
     """Remove one of THIS side's own channel files. A failure here means the
     ownership rule was broken by the other side, so it is named rather than
-    swallowed -- and named where `volter-model-editor console` reads it, not into a log."""
+    swallowed -- and named where `cyclotron console` reads it, not into a log."""
     try:
         os.unlink(path)
     except OSError as error:
@@ -2140,15 +2177,12 @@ def _photograph(depsgraph, width, height, linear=False):
         "fov": _vertical_extent(camera.data, int(width), int(height)),
         "toneMapping": transform,
         "exposure": float(2.0 ** view.exposure),
+        "gamma": float(view.gamma),
         "orthographic": camera.data.type == "ORTHO",
         "transparent": bool(scene.render.film_transparent),
     }
-    # The renderer keys its baked look tables by the config's FULL name
-    # (`AgX - Medium High Contrast`), and `AgX - Base Contrast` is the AgX base
-    # view itself -- the same table as no look at all. Send the full name for a
-    # non-identity look and nothing for the identity; a look with no table is
-    # refused BY NAME on the other side (`blender-runtime-host.ts`).
-    if look not in ("None", "AgX - Base Contrast"):
+    # Preserve the full look name: the native OCIO display processor owns it.
+    if look != "None":
         render["look"] = look
     # The capture's scene-referred frame rides along when asked for: a render
     # result is what a render leaves, and it holds scene-linear pixels.
@@ -2215,6 +2249,20 @@ class VolterRenderEngine(bpy.types.RenderEngine):
     bl_label = "three.js"
     bl_use_preview = False
 
+    def view_update(self, context, depsgraph):
+        """The tab presents the depsgraph; Blender owns the shading selection."""
+        pass
+
+    def view_draw(self, context, depsgraph):
+        """Advertise viewport rendering to RNA without asking headless Blender for a GPU.
+
+        `rna_SpaceView3DShading_type_itemf` only offers RENDERED for a Python
+        engine with `view_draw`. The Three presenter draws that viewport; this
+        callback is never its drawing path. Without it, opening a Cycles file
+        makes the ordinary Rendered control reject its own enum value.
+        """
+        pass
+
     def render(self, depsgraph):
         scene = depsgraph.scene
         scale = scene.render.resolution_percentage / 100.0
@@ -2238,7 +2286,7 @@ def _fill_result(engine, result, answer, png, width, height):
     view transform over them wherever it shows or saves one (`write_still`, the
     Image Editor), as it does over Cycles'. The photograph's PNG is the display
     image -- the transform already ran -- so loading it put every render
-    through AgX or Filmic twice. Measured 2026-09-28 by the model editor's
+    through AgX or Filmic twice. Measured 2026-09-28 by Cyclotron's
     render view: a background 53 against the viewport's 59, a shadow's blue 2
     against 7. The same capture's linear frame goes in instead: half floats,
     RGBA, bottom row first, which is Blender's own row order. Linear 0.005,
@@ -4155,7 +4203,7 @@ def _node_row(node):
 
 
 def _node_tree_of(path, material):
-    """WHICH TREE. Either an explicit RNA address (so a `volter-model-editor eval` can open a
+    """WHICH TREE. Either an explicit RNA address (so a `cyclotron eval` can open a
     world's or a group's tree with the engine's own spelling), or a material by
     name, or -- given neither -- the active object's active material, which is
     what Blender's own Shading header resolves (`space_node.py:89-93`,
@@ -4413,7 +4461,7 @@ def rna_rig(object_name=None):
     presented frame carries every object at once, and the presenter has to know
     which of its meshes are `THREE.SkinnedMesh`es before it builds them. Asking
     per object would be one round trip per mesh; asking by NAME stays available
-    for a `volter-model-editor eval` that wants to read one.
+    for a `cyclotron eval` that wants to read one.
     """
     scene_frame = int(bpy.context.scene.frame_current)
     if object_name:
@@ -5150,7 +5198,7 @@ def _dispatch(request):
             # to the console and nothing else), so it logged at `log` level and
             # reached no counter -- measured 2026-09-19 (I4), when a throw in
             # the overlay walk froze the viewport through a dozen successful
-            # `blender-execute` calls with `volter-model-editor console` silent throughout.
+            # `blender-execute` calls with `cyclotron console` silent throughout.
             _say("@@VOLTER-ERROR the present after this call failed, so the Model document is "
                  "showing the state before it: " + repr(thrown))
         return answer
@@ -5200,7 +5248,7 @@ def _dispatch(request):
             # to the console and nothing else), so it logged at `log` level and
             # reached no counter -- measured 2026-09-19 (I4), when a throw in
             # the overlay walk froze the viewport through a dozen successful
-            # `blender-execute` calls with `volter-model-editor console` silent throughout.
+            # `blender-execute` calls with `cyclotron console` silent throughout.
             _say("@@VOLTER-ERROR the present after this call failed, so the Model document is "
                  "showing the state before it: " + repr(thrown))
         return answer
@@ -5223,7 +5271,7 @@ def _dispatch(request):
             # to the console and nothing else), so it logged at `log` level and
             # reached no counter -- measured 2026-09-19 (I4), when a throw in
             # the overlay walk froze the viewport through a dozen successful
-            # `blender-execute` calls with `volter-model-editor console` silent throughout.
+            # `blender-execute` calls with `cyclotron console` silent throughout.
             _say("@@VOLTER-ERROR the present after this call failed, so the Model document is "
                  "showing the state before it: " + repr(thrown))
         return answer

package/browser/three/blender-display-NOTICE.txt

@@ -0,0 +1,45 @@
+Blender display processors
+==========================
+
+blender-display-shaders.json and blender-display-shaders.lut are generated
+using OpenColorIO 2.5.0 from Blender's color-management configuration.
+The pinned configuration is publicly available at:
+https://github.com/volter-ai/blender/blob/071e080a21c09e07f2dac8593dca2f9a566e591e/release/datafiles/colormanagement/config.ocio
+
+Configuration SHA-256:
+47a7d83e79c1d21f49ba6c505efe311da723471688c614b5c366e1da7eb8ea3a
+
+Filmic configuration: Troy James Sobotka, with the contributors named in
+config.ocio. AgX: based on Troy Sobotka's AgX, further developed by Zijun Eary
+Zhou, Mark Faderbauer and Sakari Kapanen. The generated operations and table
+payload preserve the source configuration; Blender source/license information
+is available at that repository's release/license/ directory.
+
+OpenColorIO's license for the shader generator follows.
+
+Copyright Contributors to the OpenColorIO Project.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+* Redistributions of source code must retain the above copyright
+  notice, this list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright
+  notice, this list of conditions and the following disclaimer in the
+  documentation and/or other materials provided with the distribution.
+* Neither the name of the copyright holder nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.