@onerjs/core 8.41.6 → 8.41.8

package/scene.d.ts

@@ -62,6 +62,15 @@ import type { LensFlareSystem } from "./LensFlares/lensFlareSystem.js";
 import type { ProceduralTexture } from "./Materials/Textures/Procedurals/proceduralTexture.js";
 import type { ObjectRenderer } from "./Rendering/objectRenderer.js";
 import "./Rendering/boundingBoxRenderer.js";
+/**
+ * Options for creating a scene uniform buffer
+ */
+export interface ICreateSceneUboOptions {
+    /** Define if the UBOs should be tracked in the frame (default: undefined - will use the value from Engine._features.trackUbosInFrame) */
+    trackUBOsInFrame?: boolean;
+    /** When true, always creates a mono (non-multiview) UBO, bypassing any multiview override */
+    forceMono?: boolean;
+}
 /**
  * Define an interface for all classes that will hold resources
  */
@@ -1310,6 +1319,11 @@ export declare class Scene implements IAnimatable, IClipPlanesHolder, IAssetCont
      * Gets the unique id of the scene
      */
     get uniqueId(): number;
+    /**
+     * Changed the visibility check state in render loop
+     * @param ignoreEnabled
+     */
+    changeRenderVisibilityCheckState(ignoreEnabled: boolean): void;
     /**
      * Creates a new Scene
      * @param engine defines the engine to use to render this scene
@@ -1609,6 +1623,13 @@ export declare class Scene implements IAnimatable, IClipPlanesHolder, IAssetCont
      * @returns a new ubo
      */
     createSceneUniformBuffer(name?: string, trackUBOsInFrame?: boolean): UniformBuffer;
+    /**
+     * Creates a scene UBO
+     * @param name name of the uniform buffer (optional, for debugging purpose only)
+     * @param options options for creating the scene uniform buffer
+     * @returns a new ubo
+     */
+    createSceneUniformBuffer(name?: string, options?: ICreateSceneUboOptions): UniformBuffer;
     /**
      * Sets the scene ubo
      * @param ubo the ubo to set for the scene
@@ -2138,7 +2159,7 @@ export declare class Scene implements IAnimatable, IClipPlanesHolder, IAssetCont
      * @param data the data object to associate to the key for this Engine instance
      * @returns true if no such key were already present and the data was added successfully, false otherwise
      */
-    addExternalData<T extends object>(key: string, data: T): boolean;
+    addExternalData<T>(key: string, data: T): boolean;
     /**
      * Get an externally attached data from its key
      * @param key the unique key that identifies the data

package/scene.js

@@ -679,6 +679,13 @@ export class Scene {
     get uniqueId() {
         return this._uniqueId;
     }
+    /**
+     * Changed the visibility check state in render loop
+     * @param ignoreEnabled
+     */
+    changeRenderVisibilityCheckState(ignoreEnabled) {
+        this.addExternalData(`FORCE_IGNORE_RENDER_VISIBILITY_CHECK`, ignoreEnabled);
+    }
     /**
      * Creates a new Scene
      * @param engine defines the engine to use to render this scene
@@ -2135,11 +2142,9 @@ export class Scene {
      * @param projectionR defines the right Projection matrix to use (if provided)
      */
     setTransformMatrix(viewL, projectionL, viewR, projectionR) {
-        // clear the multiviewSceneUbo if no viewR and projectionR are defined
-        if (!viewR && !projectionR && this._multiviewSceneUbo) {
-            this._multiviewSceneUbo.dispose();
-            this._multiviewSceneUbo = null;
-        }
+        // Toggle the multiview flag based on whether stereo matrices are provided.
+        // The multiview UBO itself is kept alive for the XR session lifetime to avoid per-frame GPU alloc/dealloc.
+        this._multiviewSceneUboIsActive = !!(viewR && projectionR && this._multiviewSceneUbo);
         if (this._viewUpdateFlag === viewL.updateFlag && this._projectionUpdateFlag === projectionL.updateFlag) {
             return;
         }
@@ -2155,7 +2160,7 @@ export class Scene {
         else {
             Frustum.GetPlanesToRef(this._transformMatrix, this._frustumPlanes);
         }
-        if (this._multiviewSceneUbo && this._multiviewSceneUbo.useUbo) {
+        if (this._multiviewSceneUboIsActive && this._multiviewSceneUbo.useUbo) {
             this._updateMultiviewUbo(viewR, projectionR);
         }
         else if (this._sceneUbo.useUbo) {
@@ -2169,15 +2174,10 @@ export class Scene {
      * @returns a UniformBuffer
      */
     getSceneUniformBuffer() {
-        return this._multiviewSceneUbo ? this._multiviewSceneUbo : this._sceneUbo;
+        return this._multiviewSceneUboIsActive && this._multiviewSceneUbo ? this._multiviewSceneUbo : this._sceneUbo;
     }
-    /**
-     * Creates a scene UBO
-     * @param name name of the uniform buffer (optional, for debugging purpose only)
-     * @param trackUBOsInFrame define if the UBOs should be tracked in the frame (default: undefined - will use the value from Engine._features.trackUbosInFrame)
-     * @returns a new ubo
-     */
-    createSceneUniformBuffer(name, trackUBOsInFrame) {
+    createSceneUniformBuffer(name, trackUBOsInFrameOrOptions) {
+        const trackUBOsInFrame = typeof trackUBOsInFrameOrOptions === "boolean" ? trackUBOsInFrameOrOptions : trackUBOsInFrameOrOptions?.trackUBOsInFrame;
         const sceneUbo = new UniformBuffer(this._engine, undefined, false, name ?? "scene", undefined, trackUBOsInFrame);
         sceneUbo.addUniform("viewProjection", 16);
         sceneUbo.addUniform("view", 16);
@@ -3846,7 +3846,7 @@ export class Scene {
             }
             mesh._preActivate();
             if (mesh.isVisible &&
-                mesh.visibility > 0 &&
+                (this.getExternalData(`FORCE_IGNORE_RENDER_VISIBILITY_CHECK`) || mesh.visibility > 0) &&
                 (mesh.layerMask & this.activeCamera.layerMask) !== 0 &&
                 (this._skipFrustumClipping || mesh.alwaysSelectAsActiveMesh || mesh.isInFrustum(this._frustumPlanes))) {
                 this._activeMeshes.push(mesh);