@volter/blender-engine 0.1.76 → 0.1.77

package/browser/three/blender-motion-geometry.ts

@@ -306,10 +306,18 @@ export class BlenderMotionGeometry {
     for (const [source, entry] of this.cache) {
       for (const mesh of this.groups.get(source) ?? []) {
         if (!instanceObjectShown(mesh) || (mesh.frustumCulled && !this.frustum.intersectsObject(mesh))) continue;
-        // Frobenius norm bounds the linear transform even under shear; the
-        // longest axis alone can understate the projected simplifier error.
+        // Bound the largest singular value by the maximum absolute row sum
+        // of AᵀA. Unlike Frobenius this is tight for orthogonal TRS columns,
+        // while still bounding shear. A uniform rotation must not inflate
+        // both error and radius by sqrt(3) and veto nearby placements.
         const e = mesh.matrixWorld.elements;
-        const scale = Math.hypot(e[0]!, e[1]!, e[2]!, e[4]!, e[5]!, e[6]!, e[8]!, e[9]!, e[10]!);
+        const x2 = e[0]! ** 2 + e[1]! ** 2 + e[2]! ** 2;
+        const y2 = e[4]! ** 2 + e[5]! ** 2 + e[6]! ** 2;
+        const z2 = e[8]! ** 2 + e[9]! ** 2 + e[10]! ** 2;
+        const xy = Math.abs(e[0]! * e[4]! + e[1]! * e[5]! + e[2]! * e[6]!);
+        const xz = Math.abs(e[0]! * e[8]! + e[1]! * e[9]! + e[2]! * e[10]!);
+        const yz = Math.abs(e[4]! * e[8]! + e[5]! * e[9]! + e[6]! * e[10]!);
+        const scale = Math.sqrt(Math.max(x2 + xy + xz, y2 + xy + yz, z2 + xz + yz));
         const sphere = source.boundingSphere!;
         this.centre.copy(sphere.center).applyMatrix4(mesh.matrixWorld).applyMatrix4(camera.matrixWorldInverse);
         const depth = (camera as THREE.PerspectiveCamera).isPerspectiveCamera

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

@@ -1243,12 +1243,19 @@ export class BlenderRuntimeView {
     presenterChanged();
   }
 
+  private drawPreparation: {
+    last: {opaqueMs: number; motionMs: number; transparentMs: number} | null;
+    navigation: {opaqueMs: number; motionMs: number; transparentMs: number} | null;
+  } = {last: null, navigation: null};
+
   /** Before the renderer uploads attributes/builds its queues, for this area's
    * actual camera. Transparent instance runs are camera-order dependent. */
   prepareDraw(camera: THREE.Camera, options?: {interactive: boolean; height: number}): () => void {
     try {
+      const start = performance.now();
       this.instances.prepareDraw(camera);
       this.root.updateMatrixWorld(true);
+      const opaqueDone = performance.now();
       const motion = this.motionGeometry.prepare(camera, !this.rendered && (this.mode ?? this.frame?.mode) === 'OBJECT' &&
         options?.interactive === true, options?.height ?? 0);
       // A changed navigation geometry is an ordinary-draw fallback for an
@@ -1256,7 +1263,12 @@ export class BlenderRuntimeView {
       // runs are planned AFTER per-placement geometry selection, preserving
       // their sorting barriers and compatible geometry grouping.
       if (motion) this.instances.sync();
+      const motionDone = performance.now();
       this.transparentInstances.prepare(camera);
+      const timing = {opaqueMs: opaqueDone - start, motionMs: motionDone - opaqueDone,
+        transparentMs: performance.now() - motionDone};
+      this.drawPreparation.last = timing;
+      if (motion) this.drawPreparation.navigation = timing;
     } catch (error) {
       this.motionGeometry.finish();
       this.instances.finishDraw();
@@ -2075,7 +2087,7 @@ export class BlenderRuntimeView {
   }
 
   drawStatistics() {
-    return {enabled: this.drawBatching, opaque: this.instances.inspect(), transparent: this.transparentInstances.inspect(), motion: this.motionGeometry.inspect()};
+    return {enabled: this.drawBatching, preparation: {...this.drawPreparation}, opaque: this.instances.inspect(), transparent: this.transparentInstances.inspect(), motion: this.motionGeometry.inspect()};
   }
 
   snapshot() {

package/browser/three/blender-transparent-instances.ts

@@ -29,6 +29,7 @@ export class BlenderTransparentInstances {
   private readonly depth = new THREE.Vector4();
   private batches = 0;
   private instances = 0;
+  private excluded: Record<string, number> = {};
   private readonly planState: (number | string)[] = [];
   private readonly planned: Draw[] = [];
   private stateIndex = 0;
@@ -65,6 +66,7 @@ export class BlenderTransparentInstances {
       draw.members.length = 0;
     }
     this.batches = this.instances = 0;
+    this.excluded = {};
     this.frustum.setFromProjectionMatrix(this.projection);
     this.inverse.copy(this.root.matrixWorld).invert();
     const entries: Entry[] = [];
@@ -118,6 +120,14 @@ export class BlenderTransparentInstances {
           key = groupKey;
         }
       }
+      if (key === null) {
+        const reason = !candidate ? 'multipleMaterials'
+          : (candidate as THREE.ShaderMaterial).isShaderMaterial ? 'customShader'
+          : (candidate as THREE.MeshPhysicalMaterial).transmission > 0 ? 'transmission'
+          : candidate.side === THREE.DoubleSide && !candidate.forceSinglePass ? 'twoPass'
+          : 'geometryLayersOrTransform';
+        this.excluded[reason] = (this.excluded[reason] ?? 0) + 1;
+      }
       entries.push({mesh, material, key, groupOrder: order, z, centre});
     }
     entries.sort((a, b) => a.groupOrder - b.groupOrder || a.mesh.renderOrder - b.mesh.renderOrder || b.z - a.z || a.mesh.id - b.mesh.id);
@@ -189,7 +199,7 @@ export class BlenderTransparentInstances {
     }
   }
 
-  inspect() { return {batches: this.batches, instances: this.instances}; }
+  inspect() { return {batches: this.batches, instances: this.instances, excluded: {...this.excluded}}; }
 
   private observe(value: number | string): void {
     if (this.planState[this.stateIndex] !== value) {

package/package.json

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