@babylonjs/core 7.26.5 → 7.27.1

package/assetContainer.d.ts

@@ -1,15 +1,155 @@
-import { AbstractScene } from "./abstractScene";
 import type { Scene } from "./scene";
 import { Mesh } from "./Meshes/mesh";
+import { TransformNode } from "./Meshes/transformNode";
 import type { Skeleton } from "./Bones/skeleton";
 import type { AnimationGroup } from "./Animations/animationGroup";
 import type { Animatable } from "./Animations/animatable";
+import { AbstractMesh } from "./Meshes/abstractMesh";
+import type { MultiMaterial } from "./Materials/multiMaterial";
+import type { Material } from "./Materials/material";
 import type { Nullable } from "./types";
 import type { Node } from "./node";
+import { Light } from "./Lights/light";
+import { Camera } from "./Cameras/camera";
+import type { IParticleSystem } from "./Particles/IParticleSystem";
+import type { IAssetContainer } from "./IAssetContainer";
+import type { Animation } from "./Animations/animation";
+import type { MorphTargetManager } from "./Morph/morphTargetManager";
+import type { Geometry } from "./Meshes/geometry";
+import type { AbstractActionManager } from "./Actions/abstractActionManager";
+import type { BaseTexture } from "./Materials/Textures/baseTexture";
+import type { PostProcess } from "./PostProcesses/postProcess";
+import type { Sound } from "./Audio/sound";
+import type { Layer } from "./Layers/layer";
+import type { EffectLayer } from "./Layers/effectLayer";
+import type { ReflectionProbe } from "./Probes/reflectionProbe";
+import type { LensFlareSystem } from "./LensFlares/lensFlareSystem";
+import type { ProceduralTexture } from "./Materials/Textures/Procedurals/proceduralTexture";
+/**
+ * Root class for AssetContainer and KeepAssets
+ */
+export declare class AbstractAssetContainer implements IAssetContainer {
+    /**
+     * Gets the list of root nodes (ie. nodes with no parent)
+     */
+    rootNodes: Node[];
+    /** All of the cameras added to this scene
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/cameras
+     */
+    cameras: Camera[];
+    /**
+     * All of the lights added to this scene
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/lights/lights_introduction
+     */
+    lights: Light[];
+    /**
+     * All of the (abstract) meshes added to this scene
+     */
+    meshes: AbstractMesh[];
+    /**
+     * The list of skeletons added to the scene
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/mesh/bonesSkeletons
+     */
+    skeletons: Skeleton[];
+    /**
+     * All of the particle systems added to this scene
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/particles/particle_system/particle_system_intro
+     */
+    particleSystems: IParticleSystem[];
+    /**
+     * Gets a list of Animations associated with the scene
+     */
+    animations: Animation[];
+    /**
+     * All of the animation groups added to this scene
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/animation/groupAnimations
+     */
+    animationGroups: AnimationGroup[];
+    /**
+     * All of the multi-materials added to this scene
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/materials/using/multiMaterials
+     */
+    multiMaterials: MultiMaterial[];
+    /**
+     * 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
+     */
+    materials: Material[];
+    /**
+     * The list of morph target managers added to the scene
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/mesh/dynamicMeshMorph
+     */
+    morphTargetManagers: MorphTargetManager[];
+    /**
+     * The list of geometries used in the scene.
+     */
+    geometries: Geometry[];
+    /**
+     * 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
+     */
+    transformNodes: TransformNode[];
+    /**
+     * ActionManagers available on the scene.
+     * @deprecated
+     */
+    actionManagers: AbstractActionManager[];
+    /**
+     * Textures to keep.
+     */
+    textures: BaseTexture[];
+    /** @internal */
+    protected _environmentTexture: Nullable<BaseTexture>;
+    /**
+     * 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(): Nullable<BaseTexture>;
+    set environmentTexture(value: Nullable<BaseTexture>);
+    /**
+     * The list of postprocesses added to the scene
+     */
+    postProcesses: PostProcess[];
+    /**
+     * The list of sounds
+     */
+    sounds: Nullable<Sound[]>;
+    /**
+     * The list of effect layers added to the scene
+     */
+    effectLayers: EffectLayer[];
+    /**
+     * The list of layers added to the scene
+     */
+    layers: Layer[];
+    /**
+     * The list of reflection probes added to the scene
+     */
+    reflectionProbes: ReflectionProbe[];
+    /**
+     * The list of lens flare systems added to the scene
+     */
+    lensFlareSystems: LensFlareSystem[];
+    /**
+     * The list of procedural textures added to the scene
+     */
+    proceduralTextures: ProceduralTexture[];
+    /**
+     * @returns all meshes, lights, cameras, transformNodes and bones
+     */
+    getNodes(): Array<Node>;
+}
 /**
  * Set of assets to keep when moving a scene into an asset container.
  */
-export declare class KeepAssets extends AbstractScene {
+export declare class KeepAssets extends AbstractAssetContainer {
 }
 /**
  * Class used to store the output of the AssetContainer.instantiateAllMeshesToScene function
@@ -35,7 +175,7 @@ export declare class InstantiatedEntries {
 /**
  * Container with a set of assets that can be added or removed from a scene.
  */
-export declare class AssetContainer extends AbstractScene {
+export declare class AssetContainer extends AbstractAssetContainer {
     private _wasAddedToScene;
     private _onContextRestoredObserver;
     /**

package/assetContainer.js

@@ -1,4 +1,3 @@
-import { AbstractScene } from "./abstractScene.js";
 import { Mesh } from "./Meshes/mesh.js";
 import { TransformNode } from "./Meshes/transformNode.js";
 import { AbstractMesh } from "./Meshes/abstractMesh.js";
@@ -8,10 +7,137 @@ import { InstancedMesh } from "./Meshes/instancedMesh.js";
 import { Light } from "./Lights/light.js";
 import { Camera } from "./Cameras/camera.js";
 import { Tools } from "./Misc/tools.js";
+/**
+ * Root class for AssetContainer and KeepAssets
+ */
+export class AbstractAssetContainer {
+    constructor() {
+        /**
+         * 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 = [];
+        /**
+         * The list of sounds
+         */
+        this.sounds = null;
+        /**
+         * The list of effect layers added to the scene
+         */
+        this.effectLayers = [];
+        /**
+         * The list of layers added to the scene
+         */
+        this.layers = [];
+        /**
+         * The list of reflection probes added to the scene
+         */
+        this.reflectionProbes = [];
+    }
+    /**
+     * 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;
+    }
+    set environmentTexture(value) {
+        this._environmentTexture = value;
+    }
+    /**
+     * @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;
+    }
+}
 /**
  * Set of assets to keep when moving a scene into an asset container.
  */
-export class KeepAssets extends AbstractScene {
+export class KeepAssets extends AbstractAssetContainer {
 }
 /**
  * Class used to store the output of the AssetContainer.instantiateAllMeshesToScene function
@@ -52,7 +178,7 @@ export class InstantiatedEntries {
 /**
  * Container with a set of assets that can be added or removed from a scene.
  */
-export class AssetContainer extends AbstractScene {
+export class AssetContainer extends AbstractAssetContainer {
     /**
      * Instantiates an AssetContainer.
      * @param scene The scene the AssetContainer belongs to.
@@ -65,12 +191,7 @@ export class AssetContainer extends AbstractScene {
             return;
         }
         this.scene = scene;
-        this["sounds"] = [];
-        this["effectLayers"] = [];
-        this["layers"] = [];
-        this["lensFlareSystems"] = [];
         this["proceduralTextures"] = [];
-        this["reflectionProbes"] = [];
         scene.onDisposeObservable.add(() => {
             if (!this._wasAddedToScene) {
                 this.dispose();