@babylonjs/core 5.23.0 → 5.25.0

package/scene.d.ts

@@ -30,7 +30,6 @@ import type { LoadFileError, RequestFileError, ReadFileError } from "./Misc/file
 import type { IClipPlanesHolder } from "./Misc/interfaces/iClipPlanesHolder";
 import type { IPointerEvent } from "./Events/deviceInputEvents";
 import type { IComputePressureData } from "./Misc/computePressure";
-import type { INotifyArrayChangeType } from "./Misc/arrayTools";
 declare type Ray = import("./Culling/ray").Ray;
 declare type TrianglePickingPredicate = import("./Culling/ray").TrianglePickingPredicate;
 declare type Animation = import("./Animations/animation").Animation;
@@ -130,13 +129,13 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
      * @returns The collision coordinator
      */
     static CollisionCoordinatorFactory(): ICollisionCoordinator;
-    /** @hidden */
+    /** @internal */
     _inputManager: InputManager;
     /** Define this parameter if you are using multiple cameras and you want to specify which one should be used for pointer position */
     cameraToUseForPointers: Nullable<Camera>;
-    /** @hidden */
+    /** @internal */
     readonly _isScene = true;
-    /** @hidden */
+    /** @internal */
     _blockEntityCollection: boolean;
     /**
      * Gets or sets a boolean that indicates if the scene must clear the render buffer before rendering a frame
@@ -182,7 +181,7 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
      * this is easier to reference from here than from all the materials.
      */
     environmentIntensity: number;
-    /** @hidden */
+    /** @internal */
     protected _imageProcessingConfiguration: ImageProcessingConfiguration;
     /**
      * Default image processing configuration used either in the rendering
@@ -479,7 +478,7 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
     /**
      * An event triggered when the activeCameras property is updated
      */
-    onActiveCamerasChanged: Observable<INotifyArrayChangeType<import("./Cameras/camera").Camera>>;
+    onActiveCamerasChanged: Observable<Scene>;
     /**
      * This Observable will be triggered before rendering each renderingGroup of each rendered camera.
      * The RenderingGroupInfo class contains all the information about the context in which the observable is called
@@ -505,7 +504,7 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
      * By default this function is undefined and Babylon.js will select LOD based on distance to camera
      */
     customLODSelector: (mesh: AbstractMesh, camera: Camera) => Nullable<AbstractMesh>;
-    /** @hidden */
+    /** @internal */
     _registeredForLateAnimationBindings: SmartArrayNoDuplicate<any>;
     /**
      * Gets or sets a predicate used to select candidate meshes for a pointer down event
@@ -579,7 +578,7 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
      * @param effect The effect to be bound
      * @param variableName name of the shader variable that will hold the eye position
      * @param isVector3 true to indicates that variableName is a Vector3 and not a Vector4
-     * @return the computed eye position
+     * @returns the computed eye position
      */
     bindEyePosition(effect: Nullable<Effect>, variableName?: string, isVector3?: boolean): Vector4;
     /**
@@ -587,7 +586,7 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
      * @returns the scene UniformBuffer
      */
     finalizeSceneUbo(): UniformBuffer;
-    /** @hidden */
+    /** @internal */
     _mirroredCameraPosition: Nullable<Vector3>;
     /**
      * This observable event is triggered when any keyboard event si raised and registered during Scene.attachControl()
@@ -691,10 +690,11 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
     set lightsEnabled(value: boolean);
     get lightsEnabled(): boolean;
     private _activeCameras;
+    private _unObserveActiveCameras;
     /** All of the active cameras added to this scene. */
     get activeCameras(): Nullable<Camera[]>;
     set activeCameras(cameras: Nullable<Camera[]>);
-    /** @hidden */
+    /** @internal */
     _activeCamera: Nullable<Camera>;
     /** Gets or sets the current active camera */
     get activeCamera(): Nullable<Camera>;
@@ -738,7 +738,7 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
      */
     collisionsEnabled: boolean;
     private _collisionCoordinator;
-    /** @hidden */
+    /** @internal */
     get collisionCoordinator(): ICollisionCoordinator;
     /**
      * Defines the gravity applied to this scene (used only for collisions)
@@ -796,27 +796,27 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
     proceduralTexturesEnabled: boolean;
     private _engine;
     private _totalVertices;
-    /** @hidden */
+    /** @internal */
     _activeIndices: PerfCounter;
-    /** @hidden */
+    /** @internal */
     _activeParticles: PerfCounter;
-    /** @hidden */
+    /** @internal */
     _activeBones: PerfCounter;
     private _animationRatio;
-    /** @hidden */
+    /** @internal */
     _animationTimeLast: number;
-    /** @hidden */
+    /** @internal */
     _animationTime: number;
     /**
      * Gets or sets a general scale for animation speed
      * @see https://www.babylonjs-playground.com/#IBU2W7#3
      */
     animationTimeScale: number;
-    /** @hidden */
+    /** @internal */
     _cachedMaterial: Nullable<Material>;
-    /** @hidden */
+    /** @internal */
     _cachedEffect: Nullable<Effect>;
-    /** @hidden */
+    /** @internal */
     _cachedVisibility: Nullable<number>;
     private _renderId;
     private _frameId;
@@ -825,10 +825,10 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
     private _defaultFrameBufferCleared;
     private _viewUpdateFlag;
     private _projectionUpdateFlag;
-    /** @hidden */
+    /** @internal */
     _toBeDisposed: Nullable<IDisposable>[];
     private _activeRequests;
-    /** @hidden */
+    /** @internal */
     _pendingData: any[];
     private _isDisposed;
     /**
@@ -840,22 +840,22 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
     private _processedMaterials;
     private _renderTargets;
     private _materialsRenderTargets;
-    /** @hidden */
+    /** @internal */
     _activeParticleSystems: SmartArray<IParticleSystem>;
     private _activeSkeletons;
     private _softwareSkinnedMeshes;
     private _renderingManager;
-    /** @hidden */
+    /** @internal */
     _activeAnimatables: import("./Animations/animatable").Animatable[];
     private _transformMatrix;
     private _sceneUbo;
-    /** @hidden */
+    /** @internal */
     _viewMatrix: Matrix;
-    /** @hidden */
+    /** @internal */
     _projectionMatrix: Matrix;
-    /** @hidden */
+    /** @internal */
     _forcedViewPosition: Nullable<Vector3>;
-    /** @hidden */
+    /** @internal */
     _frustumPlanes: Plane[];
     /**
      * Gets the list of frustum planes (built from the active camera)
@@ -866,19 +866,19 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
      * This is useful if there are more lights that the maximum simulteanous authorized
      */
     requireLightSorting: boolean;
-    /** @hidden */
+    /** @internal */
     readonly useMaterialMeshMap: boolean;
-    /** @hidden */
+    /** @internal */
     readonly useClonedMeshMap: boolean;
     private _externalData;
     private _uid;
     /**
-     * @hidden
+     * @internal
      * Backing store of defined scene components.
      */
     _components: ISceneComponent[];
     /**
-     * @hidden
+     * @internal
      * Backing store of defined scene components.
      */
     _serializableComponents: ISceneSerializableComponent[];
@@ -891,7 +891,7 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
      */
     private _registerTransientComponents;
     /**
-     * @hidden
+     * @internal
      * Add a component to the scene.
      * Note that the ccomponent could be registered on th next frame if this is called after
      * the register component stage.
@@ -899,119 +899,119 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
      */
     _addComponent(component: ISceneComponent): void;
     /**
-     * @hidden
+     * @internal
      * Gets a component from the scene.
      * @param name defines the name of the component to retrieve
      * @returns the component or null if not present
      */
     _getComponent(name: string): Nullable<ISceneComponent>;
     /**
-     * @hidden
+     * @internal
      * Defines the actions happening before camera updates.
      */
     _beforeCameraUpdateStage: Stage<SimpleStageAction>;
     /**
-     * @hidden
+     * @internal
      * Defines the actions happening before clear the canvas.
      */
     _beforeClearStage: Stage<SimpleStageAction>;
     /**
-     * @hidden
+     * @internal
      * Defines the actions happening before clear the canvas.
      */
     _beforeRenderTargetClearStage: Stage<RenderTargetStageAction>;
     /**
-     * @hidden
+     * @internal
      * Defines the actions when collecting render targets for the frame.
      */
     _gatherRenderTargetsStage: Stage<RenderTargetsStageAction>;
     /**
-     * @hidden
+     * @internal
      * Defines the actions happening for one camera in the frame.
      */
     _gatherActiveCameraRenderTargetsStage: Stage<RenderTargetsStageAction>;
     /**
-     * @hidden
+     * @internal
      * Defines the actions happening during the per mesh ready checks.
      */
     _isReadyForMeshStage: Stage<MeshStageAction>;
     /**
-     * @hidden
+     * @internal
      * Defines the actions happening before evaluate active mesh checks.
      */
     _beforeEvaluateActiveMeshStage: Stage<SimpleStageAction>;
     /**
-     * @hidden
+     * @internal
      * Defines the actions happening during the evaluate sub mesh checks.
      */
     _evaluateSubMeshStage: Stage<EvaluateSubMeshStageAction>;
     /**
-     * @hidden
+     * @internal
      * Defines the actions happening during the active mesh stage.
      */
     _preActiveMeshStage: Stage<PreActiveMeshStageAction>;
     /**
-     * @hidden
+     * @internal
      * Defines the actions happening during the per camera render target step.
      */
     _cameraDrawRenderTargetStage: Stage<CameraStageFrameBufferAction>;
     /**
-     * @hidden
+     * @internal
      * Defines the actions happening just before the active camera is drawing.
      */
     _beforeCameraDrawStage: Stage<CameraStageAction>;
     /**
-     * @hidden
+     * @internal
      * Defines the actions happening just before a render target is drawing.
      */
     _beforeRenderTargetDrawStage: Stage<RenderTargetStageAction>;
     /**
-     * @hidden
+     * @internal
      * Defines the actions happening just before a rendering group is drawing.
      */
     _beforeRenderingGroupDrawStage: Stage<RenderingGroupStageAction>;
     /**
-     * @hidden
+     * @internal
      * Defines the actions happening just before a mesh is drawing.
      */
     _beforeRenderingMeshStage: Stage<RenderingMeshStageAction>;
     /**
-     * @hidden
+     * @internal
      * Defines the actions happening just after a mesh has been drawn.
      */
     _afterRenderingMeshStage: Stage<RenderingMeshStageAction>;
     /**
-     * @hidden
+     * @internal
      * Defines the actions happening just after a rendering group has been drawn.
      */
     _afterRenderingGroupDrawStage: Stage<RenderingGroupStageAction>;
     /**
-     * @hidden
+     * @internal
      * Defines the actions happening just after the active camera has been drawn.
      */
     _afterCameraDrawStage: Stage<CameraStageAction>;
     /**
-     * @hidden
+     * @internal
      * Defines the actions happening just after a render target has been drawn.
      */
     _afterRenderTargetDrawStage: Stage<RenderTargetStageAction>;
     /**
-     * @hidden
+     * @internal
      * Defines the actions happening just after rendering all cameras and computing intersections.
      */
     _afterRenderStage: Stage<SimpleStageAction>;
     /**
-     * @hidden
+     * @internal
      * Defines the actions happening when a pointer move event happens.
      */
     _pointerMoveStage: Stage<PointerMoveStageAction>;
     /**
-     * @hidden
+     * @internal
      * Defines the actions happening when a pointer down event happens.
      */
     _pointerDownStage: Stage<PointerUpDownStageAction>;
     /**
-     * @hidden
+     * @internal
      * Defines the actions happening when a pointer up event happens.
      */
     _pointerUpStage: Stage<PointerUpDownStageAction>;
@@ -1032,13 +1032,12 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
     getClassName(): string;
     private _defaultMeshCandidates;
     /**
-     * @hidden
+     * @internal
      */
     _getDefaultMeshCandidates(): ISmartArrayLike<AbstractMesh>;
     private _defaultSubMeshCandidates;
     /**
-     * @param mesh
-     * @hidden
+     * @internal
      */
     _getDefaultSubMeshCandidates(mesh: AbstractMesh): ISmartArrayLike<SubMesh>;
     /**
@@ -1196,7 +1195,7 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
      * This function will check if the scene can be rendered (textures are loaded, shaders are compiled)
      * Delay loaded resources are not taking in account
      * @param checkRenderTargets true to also check that the meshes rendered as part of a render target are ready (default: true)
-     * @return true if all required resources are ready
+     * @returns true if all required resources are ready
      */
     isReady(checkRenderTargets?: boolean): boolean;
     /** Resets all cached information relative to material (including effect and visibility) */
@@ -1262,8 +1261,7 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
      */
     whenReadyAsync(checkRenderTargets?: boolean): Promise<void>;
     /**
-     * @param checkRenderTargets
-     * @hidden
+     * @internal
      */
     _checkIsReady(checkRenderTargets?: boolean): void;
     /**
@@ -1491,7 +1489,7 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
     /**
      * sets the active camera of the scene using its Id
      * @param id defines the camera's Id
-     * @return the new active camera or null if none found.
+     * @returns the new active camera or null if none found.
      */
     setActiveCameraById(id: string): Nullable<Camera>;
     /**
@@ -1503,44 +1501,44 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
     /**
      * get an animation group using its name
      * @param name defines the material's name
-     * @return the animation group or null if none found.
+     * @returns the animation group or null if none found.
      */
     getAnimationGroupByName(name: string): Nullable<AnimationGroup>;
     /**
      * Get a material using its unique id
      * @param uniqueId defines the material's unique id
-     * @return the material or null if none found.
+     * @returns the material or null if none found.
      */
     getMaterialByUniqueID(uniqueId: number): Nullable<Material>;
     /**
      * get a material using its id
      * @param id defines the material's Id
-     * @return the material or null if none found.
+     * @returns the material or null if none found.
      */
     getMaterialById(id: string): Nullable<Material>;
     /**
      * Gets a the last added material using a given id
      * @param id defines the material's Id
      * @param allowMultiMaterials determines whether multimaterials should be considered
-     * @return the last material with the given id or null if none found.
+     * @returns the last material with the given id or null if none found.
      */
     getLastMaterialById(id: string, allowMultiMaterials?: boolean): Nullable<Material>;
     /**
      * Gets a material using its name
      * @param name defines the material's name
-     * @return the material or null if none found.
+     * @returns the material or null if none found.
      */
     getMaterialByName(name: string): Nullable<Material>;
     /**
      * Get a texture using its unique id
      * @param uniqueId defines the texture's unique id
-     * @return the texture or null if none found.
+     * @returns the texture or null if none found.
      */
     getTextureByUniqueId(uniqueId: number): Nullable<BaseTexture>;
     /**
      * Gets a texture using its name
      * @param name defines the texture's name
-     * @return the texture or null if none found.
+     * @returns the texture or null if none found.
      */
     getTextureByName(name: string): Nullable<BaseTexture>;
     /**
@@ -1558,49 +1556,49 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
     /**
      * Gets a camera using its name
      * @param name defines the camera's name
-     * @return the camera or null if none found.
+     * @returns the camera or null if none found.
      */
     getCameraByName(name: string): Nullable<Camera>;
     /**
      * Gets a bone using its Id
      * @param id defines the bone's Id
-     * @return the bone or null if not found
+     * @returns the bone or null if not found
      */
     getBoneById(id: string): Nullable<Bone>;
     /**
      * Gets a bone using its id
      * @param name defines the bone's name
-     * @return the bone or null if not found
+     * @returns the bone or null if not found
      */
     getBoneByName(name: string): Nullable<Bone>;
     /**
      * Gets a light node using its name
      * @param name defines the the light's name
-     * @return the light or null if none found.
+     * @returns the light or null if none found.
      */
     getLightByName(name: string): Nullable<Light>;
     /**
      * Gets a light node using its Id
      * @param id defines the light's Id
-     * @return the light or null if none found.
+     * @returns the light or null if none found.
      */
     getLightById(id: string): Nullable<Light>;
     /**
      * Gets a light node using its scene-generated unique Id
      * @param uniqueId defines the light's unique Id
-     * @return the light or null if none found.
+     * @returns the light or null if none found.
      */
     getLightByUniqueId(uniqueId: number): Nullable<Light>;
     /**
      * Gets a particle system by Id
      * @param id defines the particle system Id
-     * @return the corresponding system or null if none found
+     * @returns the corresponding system or null if none found
      */
     getParticleSystemById(id: string): Nullable<IParticleSystem>;
     /**
      * Gets a geometry using its Id
      * @param id defines the geometry's Id
-     * @return the geometry or null if none found.
+     * @returns the geometry or null if none found.
      */
     getGeometryById(id: string): Nullable<Geometry>;
     private _getGeometryByUniqueId;
@@ -1608,13 +1606,13 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
      * Add a new geometry to this scene
      * @param geometry defines the geometry to be added to the scene.
      * @param force defines if the geometry must be pushed even if a geometry with this id already exists
-     * @return a boolean defining if the geometry was added or not
+     * @returns a boolean defining if the geometry was added or not
      */
     pushGeometry(geometry: Geometry, force?: boolean): boolean;
     /**
      * Removes an existing geometry
      * @param geometry defines the geometry to be removed from the scene
-     * @return a boolean defining if the geometry was removed or not
+     * @returns a boolean defining if the geometry was removed or not
      */
     removeGeometry(geometry: Geometry): boolean;
     /**
@@ -1625,7 +1623,7 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
     /**
      * Gets the first added mesh found of a given Id
      * @param id defines the Id to search for
-     * @return the mesh found or null if not found at all
+     * @returns the mesh found or null if not found at all
      */
     getMeshById(id: string): Nullable<AbstractMesh>;
     /**
@@ -1637,13 +1635,13 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
     /**
      * Gets the first added transform node found of a given Id
      * @param id defines the Id to search for
-     * @return the found transform node or null if not found at all.
+     * @returns the found transform node or null if not found at all.
      */
     getTransformNodeById(id: string): Nullable<TransformNode>;
     /**
      * Gets a transform node with its auto-generated unique Id
      * @param uniqueId defines the unique Id to search for
-     * @return the found transform node or null if not found at all.
+     * @returns the found transform node or null if not found at all.
      */
     getTransformNodeByUniqueId(uniqueId: number): Nullable<TransformNode>;
     /**
@@ -1655,91 +1653,91 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
     /**
      * Gets a mesh with its auto-generated unique Id
      * @param uniqueId defines the unique Id to search for
-     * @return the found mesh or null if not found at all.
+     * @returns the found mesh or null if not found at all.
      */
     getMeshByUniqueId(uniqueId: number): Nullable<AbstractMesh>;
     /**
      * Gets a the last added mesh using a given Id
      * @param id defines the Id to search for
-     * @return the found mesh or null if not found at all.
+     * @returns the found mesh or null if not found at all.
      */
     getLastMeshById(id: string): Nullable<AbstractMesh>;
     /**
      * Gets a the last added node (Mesh, Camera, Light) using a given Id
      * @param id defines the Id to search for
-     * @return the found node or null if not found at all
+     * @returns the found node or null if not found at all
      */
     getLastEntryById(id: string): Nullable<Node>;
     /**
      * Gets a node (Mesh, Camera, Light) using a given Id
      * @param id defines the Id to search for
-     * @return the found node or null if not found at all
+     * @returns the found node or null if not found at all
      */
     getNodeById(id: string): Nullable<Node>;
     /**
      * Gets a node (Mesh, Camera, Light) using a given name
      * @param name defines the name to search for
-     * @return the found node or null if not found at all.
+     * @returns the found node or null if not found at all.
      */
     getNodeByName(name: string): Nullable<Node>;
     /**
      * Gets a mesh using a given name
      * @param name defines the name to search for
-     * @return the found mesh or null if not found at all.
+     * @returns the found mesh or null if not found at all.
      */
     getMeshByName(name: string): Nullable<AbstractMesh>;
     /**
      * Gets a transform node using a given name
      * @param name defines the name to search for
-     * @return the found transform node or null if not found at all.
+     * @returns the found transform node or null if not found at all.
      */
     getTransformNodeByName(name: string): Nullable<TransformNode>;
     /**
      * Gets a skeleton using a given Id (if many are found, this function will pick the last one)
      * @param id defines the Id to search for
-     * @return the found skeleton or null if not found at all.
+     * @returns the found skeleton or null if not found at all.
      */
     getLastSkeletonById(id: string): Nullable<Skeleton>;
     /**
      * Gets a skeleton using a given auto generated unique id
      * @param  uniqueId defines the unique id to search for
-     * @return the found skeleton or null if not found at all.
+     * @returns the found skeleton or null if not found at all.
      */
     getSkeletonByUniqueId(uniqueId: number): Nullable<Skeleton>;
     /**
      * Gets a skeleton using a given id (if many are found, this function will pick the first one)
      * @param id defines the id to search for
-     * @return the found skeleton or null if not found at all.
+     * @returns the found skeleton or null if not found at all.
      */
     getSkeletonById(id: string): Nullable<Skeleton>;
     /**
      * Gets a skeleton using a given name
      * @param name defines the name to search for
-     * @return the found skeleton or null if not found at all.
+     * @returns the found skeleton or null if not found at all.
      */
     getSkeletonByName(name: string): Nullable<Skeleton>;
     /**
      * Gets a morph target manager  using a given id (if many are found, this function will pick the last one)
      * @param id defines the id to search for
-     * @return the found morph target manager or null if not found at all.
+     * @returns the found morph target manager or null if not found at all.
      */
     getMorphTargetManagerById(id: number): Nullable<MorphTargetManager>;
     /**
      * Gets a morph target using a given id (if many are found, this function will pick the first one)
      * @param id defines the id to search for
-     * @return the found morph target or null if not found at all.
+     * @returns the found morph target or null if not found at all.
      */
     getMorphTargetById(id: string): Nullable<MorphTarget>;
     /**
      * Gets a morph target using a given name (if many are found, this function will pick the first one)
      * @param name defines the name to search for
-     * @return the found morph target or null if not found at all.
+     * @returns the found morph target or null if not found at all.
      */
     getMorphTargetByName(name: string): Nullable<MorphTarget>;
     /**
      * Gets a post process using a given name (if many are found, this function will pick the first one)
      * @param name defines the name to search for
-     * @return the found post process or null if not found at all.
+     * @returns the found post process or null if not found at all.
      */
     getPostProcessByName(name: string): Nullable<PostProcess>;
     /**
@@ -1758,26 +1756,26 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
      * If you don't care and just want to get the data no matter what, use the more convenient getOrAddExternalDataWithFactory() method.
      * @param key the unique key that identifies the data
      * @param data the data object to associate to the key for this Engine instance
-     * @return true if no such key were already present and the data was added successfully, false otherwise
+     * @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;
     /**
      * Get an externally attached data from its key
      * @param key the unique key that identifies the data
-     * @return the associated data, if present (can be null), or undefined if not present
+     * @returns the associated data, if present (can be null), or undefined if not present
      */
     getExternalData<T>(key: string): Nullable<T>;
     /**
      * Get an externally attached data from its key, create it using a factory if it's not already present
      * @param key the unique key that identifies the data
      * @param factory the factory that will be called to create the instance if and only if it doesn't exists
-     * @return the associated data, can be null if the factory returned null.
+     * @returns the associated data, can be null if the factory returned null.
      */
     getOrAddExternalDataWithFactory<T extends Object>(key: string, factory: (k: string) => T): T;
     /**
      * Remove an externally attached data from the Engine instance
      * @param key the unique key that identifies the data
-     * @return true if the data was successfully removed, false if it doesn't exist
+     * @returns true if the data was successfully removed, false if it doesn't exist
      */
     removeExternalData(key: string): boolean;
     private _evaluateSubMesh;
@@ -1801,7 +1799,7 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
      * Clear the info related to rendering groups preventing retention points during dispose.
      */
     freeRenderingGroups(): void;
-    /** @hidden */
+    /** @internal */
     _isInIntermediateRendering(): boolean;
     /**
      * Lambda returning the list of potentially active meshes.
@@ -1819,7 +1817,7 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
      * Lambda returning the list of potentially colliding sub meshes.
      */
     getCollidingSubMeshCandidates: (mesh: AbstractMesh, collider: Collider) => ISmartArrayLike<SubMesh>;
-    /** @hidden */
+    /** @internal */
     _activeMeshesFrozen: boolean;
     _activeMeshesFrozenButKeepClipping: boolean;
     private _skipEvaluateActiveMeshesCompletely;
@@ -1848,27 +1846,23 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
     updateTransformMatrix(force?: boolean): void;
     private _bindFrameBuffer;
     private _clearFrameBuffer;
-    /** @hidden */
+    /** @internal */
     _allowPostProcessClearColor: boolean;
     /**
-     * @param camera
-     * @param rigParent
-     * @param bindFrameBuffer
-     * @hidden
+     * @internal
      */
     _renderForCamera(camera: Camera, rigParent?: Camera, bindFrameBuffer?: boolean): void;
     private _processSubCameras;
     private _checkIntersections;
     /**
-     * @param step
-     * @hidden
+     * @internal
      */
     _advancePhysicsEngineStep(step: number): void;
     /**
      * User updatable function that will return a deterministic frame time when engine is in deterministic lock step mode
      */
     getDeterministicFrameTime: () => number;
-    /** @hidden */
+    /** @internal */
     _animate(): void;
     /** Execute all animations (for a frame) */
     animate(): void;
@@ -2020,9 +2014,9 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
      * @returns a Mesh or null if no mesh is under the pointer
      */
     getPointerOverMesh(): Nullable<AbstractMesh>;
-    /** @hidden */
+    /** @internal */
     _rebuildGeometries(): void;
-    /** @hidden */
+    /** @internal */
     _rebuildTextures(): void;
     private _getByTags;
     /**
@@ -2097,59 +2091,27 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
      */
     markAllMaterialsAsDirty(flag: number, predicate?: (mat: Material) => boolean): void;
     /**
-     * @param fileOrUrl
-     * @param onSuccess
-     * @param onProgress
-     * @param useOfflineSupport
-     * @param useArrayBuffer
-     * @param onError
-     * @param onOpened
-     * @hidden
+     * @internal
      */
     _loadFile(fileOrUrl: File | string, onSuccess: (data: string | ArrayBuffer, responseURL?: string) => void, onProgress?: (ev: ProgressEvent) => void, useOfflineSupport?: boolean, useArrayBuffer?: boolean, onError?: (request?: WebRequest, exception?: LoadFileError) => void, onOpened?: (request: WebRequest) => void): IFileRequest;
     /**
-     * @param fileOrUrl
-     * @param onProgress
-     * @param useOfflineSupport
-     * @param useArrayBuffer
-     * @param onOpened
-     * @hidden
+     * @internal
      */
     _loadFileAsync(fileOrUrl: File | string, onProgress?: (data: any) => void, useOfflineSupport?: boolean, useArrayBuffer?: boolean, onOpened?: (request: WebRequest) => void): Promise<string | ArrayBuffer>;
     /**
-     * @param url
-     * @param onSuccess
-     * @param onProgress
-     * @param useOfflineSupport
-     * @param useArrayBuffer
-     * @param onError
-     * @param onOpened
-     * @hidden
+     * @internal
      */
     _requestFile(url: string, onSuccess: (data: string | ArrayBuffer, request?: WebRequest) => void, onProgress?: (ev: ProgressEvent) => void, useOfflineSupport?: boolean, useArrayBuffer?: boolean, onError?: (error: RequestFileError) => void, onOpened?: (request: WebRequest) => void): IFileRequest;
     /**
-     * @param url
-     * @param onProgress
-     * @param useOfflineSupport
-     * @param useArrayBuffer
-     * @param onOpened
-     * @hidden
+     * @internal
      */
     _requestFileAsync(url: string, onProgress?: (ev: ProgressEvent) => void, useOfflineSupport?: boolean, useArrayBuffer?: boolean, onOpened?: (request: WebRequest) => void): Promise<string | ArrayBuffer>;
     /**
-     * @param file
-     * @param onSuccess
-     * @param onProgress
-     * @param useArrayBuffer
-     * @param onError
-     * @hidden
+     * @internal
      */
     _readFile(file: File, onSuccess: (data: string | ArrayBuffer) => void, onProgress?: (ev: ProgressEvent) => any, useArrayBuffer?: boolean, onError?: (error: ReadFileError) => void): IFileRequest;
     /**
-     * @param file
-     * @param onProgress
-     * @param useArrayBuffer
-     * @hidden
+     * @internal
      */
     _readFileAsync(file: File, onProgress?: (ev: ProgressEvent) => any, useArrayBuffer?: boolean): Promise<string | ArrayBuffer>;
     /**
@@ -2174,28 +2136,28 @@ declare module "./scene" {
         /**
          * Sets the active camera of the scene using its Id
          * @param id defines the camera's Id
-         * @return the new active camera or null if none found.
+         * @returns the new active camera or null if none found.
          * @deprecated Please use setActiveCameraById instead
          */
         setActiveCameraByID(id: string): Nullable<Camera>;
         /**
          * Get a material using its id
          * @param id defines the material's Id
-         * @return the material or null if none found.
+         * @returns the material or null if none found.
          * @deprecated Please use getMaterialById instead
          */
         getMaterialByID(id: string): Nullable<Material>;
         /**
          * Gets a the last added material using a given id
          * @param id defines the material's Id
-         * @return the last material with the given id or null if none found.
+         * @returns the last material with the given id or null if none found.
          * @deprecated Please use getLastMaterialById instead
          */
         getLastMaterialByID(id: string): Nullable<Material>;
         /**
          * Get a texture using its unique id
          * @param uniqueId defines the texture's unique id
-         * @return the texture or null if none found.
+         * @returns the texture or null if none found.
          * @deprecated Please use getTextureByUniqueId instead
          */
         getTextureByUniqueID(uniqueId: number): Nullable<BaseTexture>;
@@ -2216,56 +2178,56 @@ declare module "./scene" {
         /**
          * Gets a bone using its Id
          * @param id defines the bone's Id
-         * @return the bone or null if not found
+         * @returns the bone or null if not found
          * @deprecated Please use getBoneById instead
          */
         getBoneByID(id: string): Nullable<Bone>;
         /**
          * Gets a light node using its Id
          * @param id defines the light's Id
-         * @return the light or null if none found.
+         * @returns the light or null if none found.
          * @deprecated Please use getLightById instead
          */
         getLightByID(id: string): Nullable<Light>;
         /**
          * Gets a light node using its scene-generated unique Id
          * @param uniqueId defines the light's unique Id
-         * @return the light or null if none found.
+         * @returns the light or null if none found.
          * @deprecated Please use getLightByUniqueId instead
          */
         getLightByUniqueID(uniqueId: number): Nullable<Light>;
         /**
          * Gets a particle system by Id
          * @param id defines the particle system Id
-         * @return the corresponding system or null if none found
+         * @returns the corresponding system or null if none found
          * @deprecated Please use getParticleSystemById instead
          */
         getParticleSystemByID(id: string): Nullable<IParticleSystem>;
         /**
          * Gets a geometry using its Id
          * @param id defines the geometry's Id
-         * @return the geometry or null if none found.
+         * @returns the geometry or null if none found.
          * @deprecated Please use getGeometryById instead
          */
         getGeometryByID(id: string): Nullable<Geometry>;
         /**
          * Gets the first added mesh found of a given Id
          * @param id defines the Id to search for
-         * @return the mesh found or null if not found at all
+         * @returns the mesh found or null if not found at all
          * @deprecated Please use getMeshById instead
          */
         getMeshByID(id: string): Nullable<AbstractMesh>;
         /**
          * Gets a mesh with its auto-generated unique Id
          * @param uniqueId defines the unique Id to search for
-         * @return the found mesh or null if not found at all.
+         * @returns the found mesh or null if not found at all.
          * @deprecated Please use getMeshByUniqueId instead
          */
         getMeshByUniqueID(uniqueId: number): Nullable<AbstractMesh>;
         /**
          * Gets a the last added mesh using a given Id
          * @param id defines the Id to search for
-         * @return the found mesh or null if not found at all.
+         * @returns the found mesh or null if not found at all.
          * @deprecated Please use getLastMeshById instead
          */
         getLastMeshByID(id: string): Nullable<AbstractMesh>;
@@ -2279,14 +2241,14 @@ declare module "./scene" {
         /**
          * Gets the first added transform node found of a given Id
          * @param id defines the Id to search for
-         * @return the found transform node or null if not found at all.
+         * @returns the found transform node or null if not found at all.
          * @deprecated Please use getTransformNodeById instead
          */
         getTransformNodeByID(id: string): Nullable<TransformNode>;
         /**
          * Gets a transform node with its auto-generated unique Id
          * @param uniqueId defines the unique Id to search for
-         * @return the found transform node or null if not found at all.
+         * @returns the found transform node or null if not found at all.
          * @deprecated Please use getTransformNodeByUniqueId instead
          */
         getTransformNodeByUniqueID(uniqueId: number): Nullable<TransformNode>;
@@ -2300,21 +2262,21 @@ declare module "./scene" {
         /**
          * Gets a node (Mesh, Camera, Light) using a given Id
          * @param id defines the Id to search for
-         * @return the found node or null if not found at all
+         * @returns the found node or null if not found at all
          * @deprecated Please use getNodeById instead
          */
         getNodeByID(id: string): Nullable<Node>;
         /**
          * Gets a the last added node (Mesh, Camera, Light) using a given Id
          * @param id defines the Id to search for
-         * @return the found node or null if not found at all
+         * @returns the found node or null if not found at all
          * @deprecated Please use getLastEntryById instead
          */
         getLastEntryByID(id: string): Nullable<Node>;
         /**
          * Gets a skeleton using a given Id (if many are found, this function will pick the last one)
          * @param id defines the Id to search for
-         * @return the found skeleton or null if not found at all.
+         * @returns the found skeleton or null if not found at all.
          * @deprecated Please use getLastSkeletonById instead
          */
         getLastSkeletonByID(id: string): Nullable<Skeleton>;