@joshtol/emotive-engine 3.3.3 → 3.3.4

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "@joshtol/emotive-engine",
-  "version": "3.3.3",
+  "version": "3.3.4",
   "description": "Open-source animation engine for AI-controlled emotional visualizations with musical time synchronization",
   "main": "dist/emotive-mascot.umd.js",
   "module": "dist/mascot.js",

package/src/3d/Core3DManager.js

@@ -1878,7 +1878,10 @@ export class Core3DManager {
             calibrationRotation: this.calibrationRotation,  // Applied on top of animated rotation
             solarEclipse: this.effectManager.getSolarEclipse(),  // Pass eclipse manager for synchronized updates
             deltaTime,  // Pass deltaTime for eclipse animation
-            morphProgress: morphState.isTransitioning ? morphState.visualProgress : null  // For corona fade-in
+            morphProgress: morphState.isTransitioning ? morphState.visualProgress : null,  // For corona fade-in
+            // OPTIMIZATION FLAGS: Skip render passes when not needed
+            hasSoul: this.customMaterialType === 'crystal' && this.crystalSoul !== null,
+            hasParticles: this.particleVisibility && this.particleOrchestrator !== null
         });
 
         // Update lunar eclipse animation (Blood Moon)

package/src/3d/ThreeRenderer.js

@@ -1270,6 +1270,8 @@ export class ThreeRenderer {
      * @param {number} [params.cameraRoll=0] - Camera-space roll rotation
      * @param {SolarEclipse} [params.solarEclipse=null] - Solar eclipse manager for synchronized updates
      * @param {number} [params.deltaTime=0] - Delta time for eclipse animation (seconds)
+     * @param {boolean} [params.hasSoul=false] - Whether this geometry has a soul layer (optimization)
+     * @param {boolean} [params.hasParticles=true] - Whether particles are enabled (optimization)
      */
     render(params = {}) {
         // Guard against calls after destroy
@@ -1347,7 +1349,9 @@ export class ThreeRenderer {
             cameraRoll = 0,  // Camera-space roll rotation applied after all other rotations
             solarEclipse = null,  // Solar eclipse manager for synchronized updates
             deltaTime = 0,  // Delta time for eclipse animation
-            morphProgress = null  // Morph progress for corona fade-in (null = no morph, 0-1 = morphing)
+            morphProgress = null,  // Morph progress for corona fade-in (null = no morph, 0-1 = morphing)
+            hasSoul = false,  // Whether this geometry has a soul layer (skip soul pass if false)
+            hasParticles = true  // Whether particles are enabled (skip particle pass if false)
         } = params;
 
         // Update camera controls FIRST before any rendering
@@ -1488,7 +1492,8 @@ export class ThreeRenderer {
         // Render with post-processing if enabled, otherwise direct render
         if (this.composer) {
             // === STEP 0: Render soul (layer 2) to texture for refraction sampling ===
-            if (this.soulRenderTarget) {
+            // OPTIMIZATION: Skip soul pass entirely if geometry doesn't have a soul
+            if (this.soulRenderTarget && hasSoul) {
                 // Find soul mesh in scene (needed for screen center calculation)
                 let soulMesh = null;
                 this.scene.traverse(obj => {
@@ -1533,7 +1538,8 @@ export class ThreeRenderer {
             this.composer.render();
 
             // === STEP 2: Render particles (layer 1) to separate render target ===
-            if (this.particleRenderTarget && this.particleBloomPass) {
+            // OPTIMIZATION: Skip particle pass entirely if particles are disabled
+            if (hasParticles && this.particleRenderTarget && this.particleBloomPass) {
                 // Clear particle render target with WHITE (non-black) to prevent dark halos
                 this.renderer.setRenderTarget(this.particleRenderTarget);
                 this.renderer.setClearColor(0xffffff, 0); // White RGB, but 0 alpha
@@ -1565,7 +1571,7 @@ export class ThreeRenderer {
                 // Reset clear color
                 this.renderer.setClearColor(0x000000, 0);
                 this.renderer.setRenderTarget(null);
-            } else {
+            } else if (hasParticles) {
                 // Fallback: Render particles directly (no bloom)
                 this.camera.layers.set(1);
                 this.renderer.render(this.scene, this.camera);

package/src/3d/effects/CrystalSoul.js

@@ -95,18 +95,14 @@ const soulFragmentShader = `
 
         if (driftEnabled > 0.5) {
             float t = time * driftSpeed;
-            // Primary drift - moving in one direction
+            // OPTIMIZED: Reduced from 4 noise calls to 2 for better performance
+            // Primary drift - single noise call with combined coordinates
             float drift1 = noise3D(vPosition * 2.0 + vec3(t, t * 0.7, t * 0.3));
-            float drift2 = noise3D(vPosition * 3.0 - vec3(t * 0.5, t, t * 0.8));
-            // Use max instead of multiply to avoid near-zero products
-            primaryDrift = max(drift1, drift2);
-            primaryDrift = max(0.0, primaryDrift - 0.4) * 2.0; // Rescale after threshold
-
-            // Secondary drift - offset in opposite direction to fill gaps
-            float drift3 = noise3D(vPosition * 2.5 - vec3(t * 0.8, t * 0.4, t));
-            float drift4 = noise3D(vPosition * 1.8 + vec3(t * 0.6, t * 0.9, t * 0.2));
-            secondaryDrift = max(drift3, drift4);
-            secondaryDrift = max(0.0, secondaryDrift - 0.4) * 2.0;
+            primaryDrift = max(0.0, drift1 - 0.3) * 1.5; // Adjusted threshold for single noise
+
+            // Secondary drift - offset phase to fill gaps
+            float drift2 = noise3D(vPosition * 2.5 - vec3(t * 0.6, t * 0.4, t));
+            secondaryDrift = max(0.0, drift2 - 0.3) * 1.5;
 
             driftEnergy = primaryDrift + secondaryDrift;
         }