@needle-tools/engine 5.1.3 → 5.1.4

package/src/engine-components/GroundProjection.ts

@@ -180,11 +180,15 @@ ${needleGroundProjectionFragmentPars}
     const cubeUvSize = texture.mapping === CubeUVReflectionMapping ? getCubeUvSize(texture) : null;
 
     if (cubeUvSize) {
+        // These are consumed as floats in three's cube_uv_reflection_fragment. GLSL ES has no
+        // implicit int→float conversion, so integer-valued numbers must be emitted as float
+        // literals (e.g. "1.0", not "1") or the shader fails to compile.
+        const glslFloat = (n: number) => Number.isInteger(n) ? `${n}.0` : `${n}`;
         defines.NEEDLE_USE_CUBE_UV_MAP = 1;
         defines.ENVMAP_TYPE_CUBE_UV = 1;
-        defines.CUBEUV_TEXEL_WIDTH = cubeUvSize.texelWidth;
-        defines.CUBEUV_TEXEL_HEIGHT = cubeUvSize.texelHeight;
-        defines.CUBEUV_MAX_MIP = `${cubeUvSize.maxMip}.0`;
+        defines.CUBEUV_TEXEL_WIDTH = glslFloat(cubeUvSize.texelWidth);
+        defines.CUBEUV_TEXEL_HEIGHT = glslFloat(cubeUvSize.texelHeight);
+        defines.CUBEUV_MAX_MIP = glslFloat(cubeUvSize.maxMip);
     }
     else {
         delete defines.NEEDLE_USE_CUBE_UV_MAP;
@@ -379,10 +383,19 @@ export class GroundProjectedEnv extends Behaviour {
             );
         }
 
-        if (this._projection && this.context.scene.background instanceof Texture) {
-            const blurriness = this.context.scene.backgroundBlurriness ?? 0;
-            const blurrinessChanged = this._lastBlurriness !== blurriness;
-            this.updateProjectionMaterial(this.context.scene.background, blurrinessChanged || this._needsTextureUpdate);
+        if (this._projection) {
+            // Same fallback as updateProjection: in AR/passthrough the camera clears
+            // scene.background — with arBlending > 0 keep updating the material (transparency +
+            // blending uniform) from the last projected texture so the blending actually renders.
+            const inXRPassthrough = this.context.xr?.isPassThrough === true || this.context.xr?.isAR === true;
+            const background = this.context.scene.background instanceof Texture
+                ? this.context.scene.background
+                : (inXRPassthrough && this.arBlending > 0 ? this._lastBackground : undefined);
+            if (background) {
+                const blurriness = this.context.scene.backgroundBlurriness ?? 0;
+                const blurrinessChanged = this._lastBlurriness !== blurriness;
+                this.updateProjectionMaterial(background, blurrinessChanged || this._needsTextureUpdate);
+            }
         }
     }
 
@@ -398,21 +411,29 @@ export class GroundProjectedEnv extends Behaviour {
      * Updates the ground projection. This is called automatically when the environment or settings change.
      */
     updateProjection() {
-        if (!this.context.scene.background) {
-            this._projection?.removeFromParent();
-            return;
+        const inXRPassthrough = this.context.xr?.isPassThrough === true || this.context.xr?.isAR === true;
+
+        // In AR/passthrough the camera clears scene.background so the real world shows through
+        // (Camera.applyClearFlags → backgroundShouldBeTransparent). With arBlending > 0 the
+        // projection must survive that: fall back to the texture we last projected instead of
+        // tearing the projection down — the projection is a scene mesh with its own material,
+        // so it blends over the camera feed while the background itself stays cleared.
+        let backgroundTexture: Texture;
+        const sceneBackground = this.context.scene.background;
+        if (sceneBackground instanceof Texture) {
+            backgroundTexture = sceneBackground;
         }
-        const backgroundTexture = this.context.scene.background;
-        if (!(backgroundTexture instanceof Texture)) {
+        else if (inXRPassthrough && this.arBlending > 0 && this._lastBackground) {
+            backgroundTexture = this._lastBackground;
+        }
+        else {
             this._projection?.removeFromParent();
             return;
         }
 
-        if (this.context.xr?.isPassThrough || this.context.xr?.isAR) {
-            if (this.arBlending === 0) {
-                this._projection?.removeFromParent();
-                return;
-            }
+        if (inXRPassthrough && this.arBlending === 0) {
+            this._projection?.removeFromParent();
+            return;
         }
         // If this is called from a setter during initialization
         if (!this.gameObject || this.destroyed) {

package/src/engine-components/export/usdz/USDZExporter.ts

@@ -3,7 +3,7 @@ import { Euler, Material, Matrix4, Mesh, Object3D, Quaternion, Vector3 } from "t
 
 import { isDevEnvironment, showBalloonMessage, showBalloonWarning } from "../../../engine/debug/index.js";
 import { findObjectOfType } from "../../../engine/engine_components.js";
-import { __OBvkie } from "../../../engine/engine_license.js";
+import { KLaEb } from "../../../engine/engine_license.js";
 import { serializable } from "../../../engine/engine_serialization.js";
 import { getFormattedDate, Progress } from "../../../engine/engine_time_utils.js";
 import { DeviceUtilities, getParam } from "../../../engine/engine_utils.js";
@@ -277,7 +277,7 @@ export class USDZExporter extends Behaviour {
         let name = this.exportFileName ?? this.objectToExport?.name ?? this.name;
         name += "-" + getFormattedDate(); // seems iOS caches the file in some cases, this ensures we always have a fresh file
 
-        if (!__OBvkie()) {
+        if (!KLaEb()) {
             if (name !== "") name += "-";
             name += "MadeWithNeedle";
         }
@@ -682,7 +682,7 @@ export class USDZExporter extends Behaviour {
                     if (debug)
                         showBalloonMessage("Quicklook url: " + callToActionURL);
                     if (callToActionURL) {
-                        if (!__OBvkie()) {
+                        if (!KLaEb()) {
                             console.warn("Quicklook closed: custom redirects require a Needle Engine Pro license: https://needle.tools/pricing", callToActionURL)
                         }
                         else {
@@ -697,7 +697,7 @@ export class USDZExporter extends Behaviour {
     private buildQuicklookOverlay(): CustomBranding {
         const obj: CustomBranding = {};
         if (this.customBranding) Object.assign(obj, this.customBranding);
-        if (!__OBvkie()) {
+        if (!KLaEb()) {
             console.log("Custom Quicklook banner text requires pro license: https://needle.tools/pricing");
             obj.callToAction = "Close";
             obj.checkoutTitle = "🌵 Made with Needle";