Needle Engine 3.25.4

Files changed (6) hide show

src/engine-components/Camera.ts CHANGED Viewed

@@ -96,6 +96,10 @@
     @serializable()
     public ARBackgroundAlpha: number = 0;
+    /**
+     * The [`mask`](https://threejs.org/docs/#api/en/core/Layers.mask) value of the three camera object layers
+     * If you want to just see objects on one layer (e.g. layer 2) then you can use `cullingLayer = 2` on this camera component instead
+    */
     @serializable()
     public set cullingMask(val: number) {
         this._cullingMask = val;
@@ -109,6 +113,11 @@
     }
     private _cullingMask: number = 0xffffffff;
+    /** Set only a specific layer active to be rendered by the camera. This is equivalent to calling `layers.set(val)` */
+    public set cullingLayer(val: number) {
+        this.cullingMask = (1 << val | 0) >>> 0;
+    }
     @serializable()
     public set backgroundBlurriness(val: number | undefined) {
         if (val === this._backgroundBlurriness) return;

src/engine/engine_context.ts CHANGED Viewed

@@ -828,6 +828,7 @@
 				this.domElement?.internalSetLoadingMessage("finish loading");
 			await res;
 		}
+		invokeLifecycleFunctions(this, ContextEvent.ContextCreated)
 		this._isCreating = false;
 		if (!this.isManagedExternally)

src/engine/engine_lifecycle_api.ts CHANGED Viewed

@@ -1,16 +1,30 @@
+import { ContextEvent } from "./engine_context_registry.js";
 import { FrameEvent } from "./engine_context.js";
 import { LifecycleMethod, registerCallback } from "./engine_lifecycle_functions_internal.js";
-/** Register a callback in the engine start event */
+/**
+ * Register a callback in the engine context created event.
+ * This happens once per context (after the context has been created and the first content has been loaded)
+ */
+export function onInitialized(cb: LifecycleMethod) {
+    registerCallback(cb, ContextEvent.ContextCreated);
+}
+/** Register a callback in the engine start event.
+ * This happens at the beginning of each frame */
 export function onStart(cb: LifecycleMethod) {
     registerCallback(cb, FrameEvent.Start);
 }
 /** Register a callback in the engine update event
- * called every frame
+ * This is called every frame
  * */
 export function onUpdate(cb: LifecycleMethod) {
     registerCallback(cb, FrameEvent.Update);
+}
+export function onBeforeRender(cb: LifecycleMethod) {
+    registerCallback(cb, FrameEvent.OnBeforeRender);
 }

src/engine/engine_lifecycle_functions_internal.ts CHANGED Viewed

@@ -1,18 +1,20 @@
 import { safeInvoke } from "./engine_generic_utils.js";
 import { FrameEvent, type Context } from "./engine_context.js";
+import type { ContextEvent } from "./engine_context_registry.js";
 export declare type LifecycleMethod = (ctx: Context) => void;
+export declare type Event = ContextEvent | FrameEvent;
-const allMethods = new Map<FrameEvent, Array<LifecycleMethod>>();
+const allMethods = new Map<Event, Array<LifecycleMethod>>();
-export function registerCallback(cb: LifecycleMethod, evt: FrameEvent) {
+export function registerCallback(cb: LifecycleMethod, evt: Event) {
     if (!allMethods.has(evt)) {
         allMethods.set(evt, new Array<LifecycleMethod>());
     }
     allMethods.get(evt)!.push(cb);
 }
-export function invokeLifecycleFunctions(ctx: Context, evt: FrameEvent) {
+export function invokeLifecycleFunctions(ctx: Context, evt: Event) {
     const methods = allMethods.get(evt);
     if (methods) {
         if (methods.length > 0) {

src/engine/engine_physics_rapier.ts CHANGED Viewed

@@ -456,6 +456,7 @@
     public get world(): World | undefined { return this._world };
     private _tempPosition: Vector3 = new Vector3();
+    private _tempPosition2: Vector3 = new Vector3();
     private _tempQuaternion: Quaternion = new Quaternion();
     private _tempScale: Vector3 = new Vector3();
     private _tempMatrix: Matrix4 = new Matrix4();
@@ -1092,12 +1093,15 @@
     private tryApplyCenter(collider: ICollider, targetVector: Vector3) {
         const center = collider.center;
         if (center && collider.gameObject) {
-            getWorldScale(collider.gameObject, this._tempScale);
-            center.multiply(this._tempScale);
+            getWorldScale(collider.gameObject, this._tempScale);
+            this._tempPosition2.x = center.x;
+            this._tempPosition2.y = center.y;
+            this._tempPosition2.z = center.z;
+            this._tempPosition2.multiply(this._tempScale);
             // TODO: fix export of center in editor integrations so we dont have to flip here
-            targetVector.x -= center.x;
-            targetVector.y += center.y;
-            targetVector.z += center.z;
+            targetVector.x -= this._tempPosition2.x;
+            targetVector.y += this._tempPosition2.y;
+            targetVector.z += this._tempPosition2.z;
         }
     }

src/engine/codegen/register_types.ts CHANGED Viewed

@@ -1,5 +1,5 @@
 import { TypeStore } from "./../engine_typestore.js"
 // Import types
 import { __Ignore } from "../../engine-components/codegen/components.js";
 import { ActionBuilder } from "../../engine-components/export/usdz/extensions/behavior/BehavioursBuilder.js";
@@ -219,7 +219,7 @@
 import { XRGrabRendering } from "../../engine-components/webxr/WebXRGrabRendering.js";
 import { XRRig } from "../../engine-components/webxr/WebXRRig.js";
 import { XRState } from "../../engine-components/XRFlag.js";
 // Register types
 TypeStore.add("__Ignore", __Ignore);
 TypeStore.add("ActionBuilder", ActionBuilder);