@babylonjs/core 7.27.0 → 7.27.2

package/scene.js

@@ -5,7 +5,6 @@ import { SmartArrayNoDuplicate, SmartArray } from "./Misc/smartArray.js";
 import { StringDictionary } from "./Misc/stringDictionary.js";
 import { Tags } from "./Misc/tags.js";
 import { Vector3, Matrix, TmpVectors } from "./Maths/math.vector.js";
-import { AbstractScene } from "./abstractScene.js";
 import { ImageProcessingConfiguration } from "./Materials/imageProcessingConfiguration.js";
 import { UniformBuffer } from "./Materials/uniformBuffer.js";
 import { PickingInfo } from "./Collisions/pickingInfo.js";
@@ -44,7 +43,7 @@ export var ScenePerformancePriority;
  * Represents a scene to be rendered by the engine.
  * @see https://doc.babylonjs.com/features/featuresDeepDive/scene
  */
-export class Scene extends AbstractScene {
+export class Scene {
     // eslint-disable-next-line jsdoc/require-returns-check
     /**
      * Factory used to create the default material.
@@ -62,26 +61,6 @@ export class Scene extends AbstractScene {
     static CollisionCoordinatorFactory() {
         throw _WarnImport("DefaultCollisionCoordinator");
     }
-    /**
-     * Texture used in all pbr material as the reflection texture.
-     * As in the majority of the scene they are the same (exception for multi room and so on),
-     * this is easier to reference from here than from all the materials.
-     */
-    get environmentTexture() {
-        return this._environmentTexture;
-    }
-    /**
-     * Texture used in all pbr material as the reflection texture.
-     * As in the majority of the scene they are the same (exception for multi room and so on),
-     * this is easier to set here than in all the materials.
-     */
-    set environmentTexture(value) {
-        if (this._environmentTexture === value) {
-            return;
-        }
-        this._environmentTexture = value;
-        this.markAllMaterialsAsDirty(1);
-    }
     /**
      * Default image processing configuration used either in the rendering
      * Forward main pass or through the imageProcessingPostProcess if present.
@@ -164,6 +143,38 @@ export class Scene extends AbstractScene {
     get forcePointsCloud() {
         return this._forcePointsCloud;
     }
+    /**
+     * Texture used in all pbr material as the reflection texture.
+     * As in the majority of the scene they are the same (exception for multi room and so on),
+     * this is easier to reference from here than from all the materials.
+     */
+    get environmentTexture() {
+        return this._environmentTexture;
+    }
+    /**
+     * Texture used in all pbr material as the reflection texture.
+     * As in the majority of the scene they are the same (exception for multi room and so on),
+     * this is easier to set here than in all the materials.
+     */
+    set environmentTexture(value) {
+        if (this._environmentTexture === value) {
+            return;
+        }
+        this._environmentTexture = value;
+        this.markAllMaterialsAsDirty(1);
+    }
+    /**
+     * @returns all meshes, lights, cameras, transformNodes and bones
+     */
+    getNodes() {
+        let nodes = [];
+        nodes = nodes.concat(this.meshes);
+        nodes = nodes.concat(this.lights);
+        nodes = nodes.concat(this.cameras);
+        nodes = nodes.concat(this.transformNodes); // dummies
+        this.skeletons.forEach((skeleton) => (nodes = nodes.concat(skeleton.bones)));
+        return nodes;
+    }
     /**
      * Gets or sets the animation properties override
      */
@@ -600,7 +611,6 @@ export class Scene extends AbstractScene {
      * @param options defines the scene options
      */
     constructor(engine, options) {
-        super();
         // Members
         /** @internal */
         this._inputManager = new InputManager(this);
@@ -641,6 +651,87 @@ export class Scene extends AbstractScene {
         this._forceWireframe = false;
         this._skipFrustumClipping = false;
         this._forcePointsCloud = false;
+        /**
+         * Gets the list of root nodes (ie. nodes with no parent)
+         */
+        this.rootNodes = [];
+        /** All of the cameras added to this scene
+         * @see https://doc.babylonjs.com/features/featuresDeepDive/cameras
+         */
+        this.cameras = [];
+        /**
+         * All of the lights added to this scene
+         * @see https://doc.babylonjs.com/features/featuresDeepDive/lights/lights_introduction
+         */
+        this.lights = [];
+        /**
+         * All of the (abstract) meshes added to this scene
+         */
+        this.meshes = [];
+        /**
+         * The list of skeletons added to the scene
+         * @see https://doc.babylonjs.com/features/featuresDeepDive/mesh/bonesSkeletons
+         */
+        this.skeletons = [];
+        /**
+         * All of the particle systems added to this scene
+         * @see https://doc.babylonjs.com/features/featuresDeepDive/particles/particle_system/particle_system_intro
+         */
+        this.particleSystems = [];
+        /**
+         * Gets a list of Animations associated with the scene
+         */
+        this.animations = [];
+        /**
+         * All of the animation groups added to this scene
+         * @see https://doc.babylonjs.com/features/featuresDeepDive/animation/groupAnimations
+         */
+        this.animationGroups = [];
+        /**
+         * All of the multi-materials added to this scene
+         * @see https://doc.babylonjs.com/features/featuresDeepDive/materials/using/multiMaterials
+         */
+        this.multiMaterials = [];
+        /**
+         * All of the materials added to this scene
+         * In the context of a Scene, it is not supposed to be modified manually.
+         * Any addition or removal should be done using the addMaterial and removeMaterial Scene methods.
+         * Note also that the order of the Material within the array is not significant and might change.
+         * @see https://doc.babylonjs.com/features/featuresDeepDive/materials/using/materials_introduction
+         */
+        this.materials = [];
+        /**
+         * The list of morph target managers added to the scene
+         * @see https://doc.babylonjs.com/features/featuresDeepDive/mesh/dynamicMeshMorph
+         */
+        this.morphTargetManagers = [];
+        /**
+         * The list of geometries used in the scene.
+         */
+        this.geometries = [];
+        /**
+         * All of the transform nodes added to this scene
+         * In the context of a Scene, it is not supposed to be modified manually.
+         * Any addition or removal should be done using the addTransformNode and removeTransformNode Scene methods.
+         * Note also that the order of the TransformNode within the array is not significant and might change.
+         * @see https://doc.babylonjs.com/features/featuresDeepDive/mesh/transforms/parent_pivot/transform_node
+         */
+        this.transformNodes = [];
+        /**
+         * ActionManagers available on the scene.
+         * @deprecated
+         */
+        this.actionManagers = [];
+        /**
+         * Textures to keep.
+         */
+        this.textures = [];
+        /** @internal */
+        this._environmentTexture = null;
+        /**
+         * The list of postprocesses added to the scene
+         */
+        this.postProcesses = [];
         /**
          * Gets or sets a boolean indicating if animations are enabled
          */
@@ -3734,59 +3825,67 @@ export class Scene extends AbstractScene {
         }
         // Before render
         this.onBeforeRenderObservable.notifyObservers(this);
-        const engine = this.getEngine();
-        // Customs render targets
-        this.onBeforeRenderTargetsRenderObservable.notifyObservers(this);
-        const currentActiveCamera = this.activeCameras?.length ? this.activeCameras[0] : this.activeCamera;
-        if (this.renderTargetsEnabled) {
-            Tools.StartPerformanceCounter("Custom render targets", this.customRenderTargets.length > 0);
-            this._intermediateRendering = true;
-            for (let customIndex = 0; customIndex < this.customRenderTargets.length; customIndex++) {
-                const renderTarget = this.customRenderTargets[customIndex];
-                if (renderTarget._shouldRender()) {
-                    this._renderId++;
-                    this.activeCamera = renderTarget.activeCamera || this.activeCamera;
-                    if (!this.activeCamera) {
-                        throw new Error("Active camera not set");
+        // Custom render function?
+        if (this.customRenderFunction) {
+            this._renderId++;
+            this._engine.currentRenderPassId = 0;
+            this.customRenderFunction();
+        }
+        else {
+            const engine = this.getEngine();
+            // Customs render targets
+            this.onBeforeRenderTargetsRenderObservable.notifyObservers(this);
+            const currentActiveCamera = this.activeCameras?.length ? this.activeCameras[0] : this.activeCamera;
+            if (this.renderTargetsEnabled) {
+                Tools.StartPerformanceCounter("Custom render targets", this.customRenderTargets.length > 0);
+                this._intermediateRendering = true;
+                for (let customIndex = 0; customIndex < this.customRenderTargets.length; customIndex++) {
+                    const renderTarget = this.customRenderTargets[customIndex];
+                    if (renderTarget._shouldRender()) {
+                        this._renderId++;
+                        this.activeCamera = renderTarget.activeCamera || this.activeCamera;
+                        if (!this.activeCamera) {
+                            throw new Error("Active camera not set");
+                        }
+                        // Viewport
+                        engine.setViewport(this.activeCamera.viewport);
+                        // Camera
+                        this.updateTransformMatrix();
+                        renderTarget.render(currentActiveCamera !== this.activeCamera, this.dumpNextRenderTargets);
                     }
-                    // Viewport
-                    engine.setViewport(this.activeCamera.viewport);
-                    // Camera
-                    this.updateTransformMatrix();
-                    renderTarget.render(currentActiveCamera !== this.activeCamera, this.dumpNextRenderTargets);
                 }
+                Tools.EndPerformanceCounter("Custom render targets", this.customRenderTargets.length > 0);
+                this._intermediateRendering = false;
+                this._renderId++;
             }
-            Tools.EndPerformanceCounter("Custom render targets", this.customRenderTargets.length > 0);
-            this._intermediateRendering = false;
-            this._renderId++;
-        }
-        this._engine.currentRenderPassId = currentActiveCamera?.renderPassId ?? 0;
-        // Restore back buffer
-        this.activeCamera = currentActiveCamera;
-        if (this._activeCamera && this._activeCamera.cameraRigMode !== 22 && !this.prePass) {
-            this._bindFrameBuffer(this._activeCamera, false);
-        }
-        this.onAfterRenderTargetsRenderObservable.notifyObservers(this);
-        for (const step of this._beforeClearStage) {
-            step.action();
-        }
-        // Clear
-        this._clearFrameBuffer(this.activeCamera);
-        // Collects render targets from external components.
-        for (const step of this._gatherRenderTargetsStage) {
-            step.action(this._renderTargets);
-        }
-        // Multi-cameras?
-        if (this.activeCameras && this.activeCameras.length > 0) {
-            for (let cameraIndex = 0; cameraIndex < this.activeCameras.length; cameraIndex++) {
-                this._processSubCameras(this.activeCameras[cameraIndex], cameraIndex > 0);
+            this._engine.currentRenderPassId = currentActiveCamera?.renderPassId ?? 0;
+            // Restore back buffer
+            this.activeCamera = currentActiveCamera;
+            if (this._activeCamera && this._activeCamera.cameraRigMode !== 22 && !this.prePass) {
+                this._bindFrameBuffer(this._activeCamera, false);
             }
-        }
-        else {
-            if (!this.activeCamera) {
-                throw new Error("No camera defined");
+            this.onAfterRenderTargetsRenderObservable.notifyObservers(this);
+            for (const step of this._beforeClearStage) {
+                step.action();
+            }
+            // Clear
+            this._clearFrameBuffer(this.activeCamera);
+            // Collects render targets from external components.
+            for (const step of this._gatherRenderTargetsStage) {
+                step.action(this._renderTargets);
+            }
+            // Multi-cameras?
+            if (this.activeCameras && this.activeCameras.length > 0) {
+                for (let cameraIndex = 0; cameraIndex < this.activeCameras.length; cameraIndex++) {
+                    this._processSubCameras(this.activeCameras[cameraIndex], cameraIndex > 0);
+                }
+            }
+            else {
+                if (!this.activeCamera) {
+                    throw new Error("No camera defined");
+                }
+                this._processSubCameras(this.activeCamera, !!this.activeCamera.outputRenderTarget);
             }
-            this._processSubCameras(this.activeCamera, !!this.activeCamera.outputRenderTarget);
         }
         // Intersection checks
         this._checkIntersections();