@needle-tools/engine 2.65.2-pre → 2.67.0-pre

package/plugins/vite/poster-client.js

@@ -1,5 +1,4 @@
 
-
 async function generatePoster() {
     const { screenshot } = await import("@needle-tools/engine/src/engine/engine_utils_screenshot");
 
@@ -7,12 +6,15 @@ async function generatePoster() {
         const needleEngine = document.querySelector("needle-engine");
         if (!needleEngine) return null;
 
-        const width = 1920;
-        const height = 1920;
+        // Keep in sync with og:image:width meta tags
+        // https://developers.facebook.com/docs/sharing/best-practices/
+        const width = 1080;
+        const height = 1080;
         const context = await needleEngine.getContext();
 
         // wait a fixed time for e.g. fonts to load
-        await new Promise((resolve) => setTimeout(resolve, 200));
+        while(context.time.frameCount < 2)
+            await new Promise((resolve) => setTimeout(resolve, 200));
 
         const mimeType = "image/webp";
         console.log("Generating poster...");

package/src/engine/api.ts

@@ -1,4 +1,7 @@
+
 export { TypeStore } from "./engine_typestore";
+export * from "./engine_context_registry";
+export * from "./extensions/extensions"
 export { InstancingUtil } from "./engine_instancing";
 export * from "./engine_gameobject";
 export * from "./engine_components"
@@ -9,4 +12,30 @@ export { validate } from "./engine_util_decorator"
 export { Gizmos } from "./engine_gizmos"
 export * from "./engine_scenetools";
 export * from "./engine_math"
-export * from "./js-extensions"
+export * from "./js-extensions"
+
+
+export {
+    // url params
+    getParam,
+    setParamWithoutReload,
+    setParam,
+    setOrAddParamsToUrl,
+
+    // timing
+    delay,
+
+    // device checks
+    isMobileDevice,
+    isMozillaXR,
+    isiOS,
+    isSafari,
+    isQuest,
+} from "./engine_utils";
+
+export {
+    setUsageTrackingEnabled,
+    isUsageTrackingEnabled,
+    findUsers,
+    getUserCount
+} from "./engine_assetdatabase"

package/src/engine/codegen/register_types.js

@@ -1,5 +1,5 @@
 import { TypeStore } from "./../engine_typestore"
-
+
 // Import types
 import { __Ignore } from "../../engine-components/codegen/components";
 import { AlignmentConstraint } from "../../engine-components/AlignmentConstraint";
@@ -9,6 +9,7 @@ import { AnimationExtension } from "../../engine-components/export/usdz/extensio
 import { AnimationTrackHandler } from "../../engine-components/timeline/TimelineTracks";
 import { Animator } from "../../engine-components/Animator";
 import { AnimatorController } from "../../engine-components/AnimatorController";
+import { Antialiasing } from "../../engine-components/postprocessing/Effects/Antialiasing";
 import { AttachedObject } from "../../engine-components/WebXRController";
 import { AudioListener } from "../../engine-components/AudioListener";
 import { AudioSource } from "../../engine-components/AudioSource";
@@ -25,6 +26,7 @@ import { AvatarModel } from "../../engine-components/AvatarLoader";
 import { AxesHelper } from "../../engine-components/AxesHelper";
 import { BaseUIComponent } from "../../engine-components/ui/BaseUIComponent";
 import { BasicIKConstraint } from "../../engine-components/BasicIKConstraint";
+import { Bloom } from "../../engine-components/postprocessing/Effects/Bloom";
 import { BoxCollider } from "../../engine-components/Collider";
 import { BoxGizmo } from "../../engine-components/Gizmos";
 import { BoxHelperComponent } from "../../engine-components/BoxHelperComponent";
@@ -36,13 +38,15 @@ import { CanvasGroup } from "../../engine-components/ui/CanvasGroup";
 import { CapsuleCollider } from "../../engine-components/Collider";
 import { CharacterController } from "../../engine-components/CharacterController";
 import { CharacterControllerInput } from "../../engine-components/CharacterController";
+import { ChromaticAberration } from "../../engine-components/postprocessing/Effects/ChromaticAberration";
 import { Collider } from "../../engine-components/Collider";
-import { ColorAdjustments } from "../../engine-components/Volume";
+import { ColorAdjustments } from "../../engine-components/postprocessing/Effects/ColorAdjustments";
 import { ColorBySpeedModule } from "../../engine-components/ParticleSystemModules";
 import { ColorOverLifetimeModule } from "../../engine-components/ParticleSystemModules";
 import { ControlTrackHandler } from "../../engine-components/timeline/TimelineTracks";
 import { Deletable } from "../../engine-components/DeleteBox";
 import { DeleteBox } from "../../engine-components/DeleteBox";
+import { DepthOfField } from "../../engine-components/postprocessing/Effects/DepthOfField";
 import { DeviceFlag } from "../../engine-components/DeviceFlag";
 import { DragControls } from "../../engine-components/DragControls";
 import { DropListener } from "../../engine-components/DropListener";
@@ -94,11 +98,13 @@ import { ParticleBurst } from "../../engine-components/ParticleSystemModules";
 import { ParticleSubEmitter } from "../../engine-components/ParticleSystemSubEmitter";
 import { ParticleSystem } from "../../engine-components/ParticleSystem";
 import { ParticleSystemRenderer } from "../../engine-components/ParticleSystem";
+import { PixelationEffect } from "../../engine-components/postprocessing/Effects/Pixelation";
 import { PlayableDirector } from "../../engine-components/timeline/PlayableDirector";
 import { PlayerColor } from "../../engine-components/PlayerColor";
 import { PlayerState } from "../../engine-components-experimental/networking/PlayerSync";
 import { PlayerSync } from "../../engine-components-experimental/networking/PlayerSync";
 import { PointerEventData } from "../../engine-components/ui/PointerEvents";
+import { PostProcessingHandler } from "../../engine-components/postprocessing/PostProcessingHandler";
 import { PresentationMode } from "../../engine-components-experimental/Presentation";
 import { RawImage } from "../../engine-components/ui/Image";
 import { Raycaster } from "../../engine-components/ui/Raycaster";
@@ -114,6 +120,7 @@ import { Rigidbody } from "../../engine-components/RigidBody";
 import { RotationBySpeedModule } from "../../engine-components/ParticleSystemModules";
 import { RotationOverLifetimeModule } from "../../engine-components/ParticleSystemModules";
 import { ScreenCapture } from "../../engine-components/ScreenCapture";
+import { ScreenSpaceAmbientOcclusion } from "../../engine-components/postprocessing/Effects/ScreenspaceAmbientOcclusion";
 import { ShadowCatcher } from "../../engine-components/ShadowCatcher";
 import { ShapeModule } from "../../engine-components/ParticleSystemModules";
 import { SignalAsset } from "../../engine-components/timeline/SignalAsset";
@@ -142,7 +149,7 @@ import { TestRunner } from "../../engine-components/TestRunner";
 import { TestSimulateUserData } from "../../engine-components/TestRunner";
 import { Text } from "../../engine-components/ui/Text";
 import { TextureSheetAnimationModule } from "../../engine-components/ParticleSystemModules";
-import { ToneMapping } from "../../engine-components/Volume";
+import { ToneMapping } from "../../engine-components/postprocessing/Effects/Tonemapping";
 import { TrailModule } from "../../engine-components/ParticleSystemModules";
 import { TransformData } from "../../engine-components/export/usdz/extensions/Animation";
 import { TransformGizmo } from "../../engine-components/TransformGizmo";
@@ -153,13 +160,14 @@ import { USDZExporter } from "../../engine-components/export/usdz/USDZExporter";
 import { VelocityOverLifetimeModule } from "../../engine-components/ParticleSystemModules";
 import { VerticalLayoutGroup } from "../../engine-components/ui/Layout";
 import { VideoPlayer } from "../../engine-components/VideoPlayer";
+import { Vignette } from "../../engine-components/postprocessing/Effects/Vignette";
 import { Voip } from "../../engine-components/Voip";
-import { Volume } from "../../engine-components/Volume";
-import { VolumeComponent } from "../../engine-components/Volume";
-import { VolumeParameter } from "../../engine-components/Volume";
-import { VolumeProfile } from "../../engine-components/Volume";
+import { Volume } from "../../engine-components/postprocessing/Volume";
+import { VolumeParameter } from "../../engine-components/postprocessing/VolumeParameter";
+import { VolumeProfile } from "../../engine-components/postprocessing/VolumeProfile";
 import { VRUserState } from "../../engine-components/WebXRSync";
 import { WebAR } from "../../engine-components/WebXR";
+import { WebARCameraBackground } from "../../engine-components/WebARCameraBackground";
 import { WebARSessionRoot } from "../../engine-components/WebARSessionRoot";
 import { WebXR } from "../../engine-components/WebXR";
 import { WebXRAvatar } from "../../engine-components/WebXRAvatar";
@@ -170,7 +178,7 @@ import { XRGrabModel } from "../../engine-components/WebXRGrabRendering";
 import { XRGrabRendering } from "../../engine-components/WebXRGrabRendering";
 import { XRRig } from "../../engine-components/WebXRRig";
 import { XRState } from "../../engine-components/XRFlag";
-
+
 // Register types
 TypeStore.add("__Ignore", __Ignore);
 TypeStore.add("AlignmentConstraint", AlignmentConstraint);
@@ -180,6 +188,7 @@ TypeStore.add("AnimationExtension", AnimationExtension);
 TypeStore.add("AnimationTrackHandler", AnimationTrackHandler);
 TypeStore.add("Animator", Animator);
 TypeStore.add("AnimatorController", AnimatorController);
+TypeStore.add("Antialiasing", Antialiasing);
 TypeStore.add("AttachedObject", AttachedObject);
 TypeStore.add("AudioListener", AudioListener);
 TypeStore.add("AudioSource", AudioSource);
@@ -196,6 +205,7 @@ TypeStore.add("AvatarModel", AvatarModel);
 TypeStore.add("AxesHelper", AxesHelper);
 TypeStore.add("BaseUIComponent", BaseUIComponent);
 TypeStore.add("BasicIKConstraint", BasicIKConstraint);
+TypeStore.add("Bloom", Bloom);
 TypeStore.add("BoxCollider", BoxCollider);
 TypeStore.add("BoxGizmo", BoxGizmo);
 TypeStore.add("BoxHelperComponent", BoxHelperComponent);
@@ -207,6 +217,7 @@ TypeStore.add("CanvasGroup", CanvasGroup);
 TypeStore.add("CapsuleCollider", CapsuleCollider);
 TypeStore.add("CharacterController", CharacterController);
 TypeStore.add("CharacterControllerInput", CharacterControllerInput);
+TypeStore.add("ChromaticAberration", ChromaticAberration);
 TypeStore.add("Collider", Collider);
 TypeStore.add("ColorAdjustments", ColorAdjustments);
 TypeStore.add("ColorBySpeedModule", ColorBySpeedModule);
@@ -214,6 +225,7 @@ TypeStore.add("ColorOverLifetimeModule", ColorOverLifetimeModule);
 TypeStore.add("ControlTrackHandler", ControlTrackHandler);
 TypeStore.add("Deletable", Deletable);
 TypeStore.add("DeleteBox", DeleteBox);
+TypeStore.add("DepthOfField", DepthOfField);
 TypeStore.add("DeviceFlag", DeviceFlag);
 TypeStore.add("DragControls", DragControls);
 TypeStore.add("DropListener", DropListener);
@@ -265,11 +277,13 @@ TypeStore.add("ParticleBurst", ParticleBurst);
 TypeStore.add("ParticleSubEmitter", ParticleSubEmitter);
 TypeStore.add("ParticleSystem", ParticleSystem);
 TypeStore.add("ParticleSystemRenderer", ParticleSystemRenderer);
+TypeStore.add("PixelationEffect", PixelationEffect);
 TypeStore.add("PlayableDirector", PlayableDirector);
 TypeStore.add("PlayerColor", PlayerColor);
 TypeStore.add("PlayerState", PlayerState);
 TypeStore.add("PlayerSync", PlayerSync);
 TypeStore.add("PointerEventData", PointerEventData);
+TypeStore.add("PostProcessingHandler", PostProcessingHandler);
 TypeStore.add("PresentationMode", PresentationMode);
 TypeStore.add("RawImage", RawImage);
 TypeStore.add("Raycaster", Raycaster);
@@ -285,6 +299,7 @@ TypeStore.add("Rigidbody", Rigidbody);
 TypeStore.add("RotationBySpeedModule", RotationBySpeedModule);
 TypeStore.add("RotationOverLifetimeModule", RotationOverLifetimeModule);
 TypeStore.add("ScreenCapture", ScreenCapture);
+TypeStore.add("ScreenSpaceAmbientOcclusion", ScreenSpaceAmbientOcclusion);
 TypeStore.add("ShadowCatcher", ShadowCatcher);
 TypeStore.add("ShapeModule", ShapeModule);
 TypeStore.add("SignalAsset", SignalAsset);
@@ -324,13 +339,14 @@ TypeStore.add("USDZExporter", USDZExporter);
 TypeStore.add("VelocityOverLifetimeModule", VelocityOverLifetimeModule);
 TypeStore.add("VerticalLayoutGroup", VerticalLayoutGroup);
 TypeStore.add("VideoPlayer", VideoPlayer);
+TypeStore.add("Vignette", Vignette);
 TypeStore.add("Voip", Voip);
 TypeStore.add("Volume", Volume);
-TypeStore.add("VolumeComponent", VolumeComponent);
 TypeStore.add("VolumeParameter", VolumeParameter);
 TypeStore.add("VolumeProfile", VolumeProfile);
 TypeStore.add("VRUserState", VRUserState);
 TypeStore.add("WebAR", WebAR);
+TypeStore.add("WebARCameraBackground", WebARCameraBackground);
 TypeStore.add("WebARSessionRoot", WebARSessionRoot);
 TypeStore.add("WebXR", WebXR);
 TypeStore.add("WebXRAvatar", WebXRAvatar);

package/src/engine/debug/debug_overlay.ts

@@ -36,12 +36,21 @@ export function makeErrorsVisibleForDevelopment() {
         };
         window.addEventListener("error", (event) => {
             if (!event) return;
-            addLog(LogType.Error, event.error, event.filename, event.lineno);
+            let message = event.error;
+            if (message === undefined) {
+                if (isLocalNetwork())
+                    console.warn("Received unknown error", event, event.target);
+                return;
+            }
+            addLog(LogType.Error, message, event.filename, event.lineno);
             onReceivedError();
         }, true);
         window.addEventListener("unhandledrejection", (event) => {
             if (!event) return;
-            addLog(LogType.Error, event.reason.message, event.reason.stack);
+            if (event.reason)
+                addLog(LogType.Error, event.reason.message, event.reason.stack);
+            else
+                addLog(LogType.Error, "unhandled rejection");
             onReceivedError();
         });
     }

package/src/engine/engine_addressables.ts

@@ -121,8 +121,8 @@ export class AssetReference {
             if (debug) console.log("Unload", this.asset);
             // TODO: we need a way to remove objects from the context (including components) without actually "destroying" them
             if (this.asset.scene)
-                destroy(this.asset.scene, true);
-            else destroy(this.asset, true);
+                destroy(this.asset.scene, true, true);
+            else destroy(this.asset, true, true);
         }
         this.asset = null;
         this._rawBinary = undefined;
@@ -237,8 +237,8 @@ export class AssetReference {
             }
 
             let count = AssetReference.currentlyInstantiating.get(this.uri);
-            // allow up to 100 instantiations of the same prefab in the same frame
-            if (count !== undefined && count >= 100) {
+            // allow up to 10000 instantiations of the same prefab in the same frame
+            if (count !== undefined && count >= 10000) {
                 console.error("Recursive or too many instantiations of " + this.uri + " in the same frame (" + count + ")");
                 return null;
             }