@babylonjs/core 5.32.1 → 5.32.2

package/scene.d.ts

@@ -97,7 +97,7 @@ export declare enum ScenePerformancePriority {
 }
 /**
  * Represents a scene to be rendered by the engine.
- * @see https://doc.babylonjs.com/features/scene
+ * @see https://doc.babylonjs.com/features/featuresDeepDive/scene
  */
 export declare class Scene extends AbstractScene implements IAnimatable, IClipPlanesHolder {
     /** The fog is deactivated */
@@ -110,12 +110,12 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
     static readonly FOGMODE_LINEAR = 3;
     /**
      * Gets or sets the minimum deltatime when deterministic lock step is enabled
-     * @see https://doc.babylonjs.com/babylon101/animations#deterministic-lockstep
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/animation/advanced_animations#deterministic-lockstep
      */
     static MinDeltaTime: number;
     /**
      * Gets or sets the maximum deltatime when deterministic lock step is enabled
-     * @see https://doc.babylonjs.com/babylon101/animations#deterministic-lockstep
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/animation/advanced_animations#deterministic-lockstep
      */
     static MaxDeltaTime: number;
     /**
@@ -531,13 +531,13 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
      */
     skipPointerUpPicking: boolean;
     /** Callback called when a pointer move is detected */
-    onPointerMove: (evt: IPointerEvent, pickInfo: PickingInfo, type: PointerEventTypes) => void;
+    onPointerMove?: (evt: IPointerEvent, pickInfo: PickingInfo, type: PointerEventTypes) => void;
     /** Callback called when a pointer down is detected  */
-    onPointerDown: (evt: IPointerEvent, pickInfo: PickingInfo, type: PointerEventTypes) => void;
+    onPointerDown?: (evt: IPointerEvent, pickInfo: PickingInfo, type: PointerEventTypes) => void;
     /** Callback called when a pointer up is detected  */
-    onPointerUp: (evt: IPointerEvent, pickInfo: Nullable<PickingInfo>, type: PointerEventTypes) => void;
+    onPointerUp?: (evt: IPointerEvent, pickInfo: Nullable<PickingInfo>, type: PointerEventTypes) => void;
     /** Callback called when a pointer pick is detected */
-    onPointerPick: (evt: IPointerEvent, pickInfo: PickingInfo) => void;
+    onPointerPick?: (evt: IPointerEvent, pickInfo: PickingInfo) => void;
     /**
      * Gets or sets a predicate used to select candidate faces for a pointer move event
      */
@@ -551,6 +551,11 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
      * Observable event triggered each time an input event is received from the rendering canvas
      */
     onPointerObservable: Observable<PointerInfo>;
+    /**
+     * Observable to handle camera pointer inputs
+     * @internal
+     */
+    _onCameraInputObservable: Observable<PointerInfo>;
     /**
      * Gets the pointer coordinates without any translation (ie. straight out of the pointer event)
      */
@@ -608,26 +613,26 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
     private _currentInternalStep;
     /**
      * Sets the step Id used by deterministic lock step
-     * @see https://doc.babylonjs.com/babylon101/animations#deterministic-lockstep
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/animation/advanced_animations#deterministic-lockstep
      * @param newStepId defines the step Id
      */
     setStepId(newStepId: number): void;
     /**
      * Gets the step Id used by deterministic lock step
-     * @see https://doc.babylonjs.com/babylon101/animations#deterministic-lockstep
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/animation/advanced_animations#deterministic-lockstep
      * @returns the step Id
      */
     getStepId(): number;
     /**
      * Gets the internal step used by deterministic lock step
-     * @see https://doc.babylonjs.com/babylon101/animations#deterministic-lockstep
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/animation/advanced_animations#deterministic-lockstep
      * @returns the internal step
      */
     getInternalStep(): number;
     private _fogEnabled;
     /**
      * Gets or sets a boolean indicating if fog is enabled on this scene
-     * @see https://doc.babylonjs.com/babylon101/environment#fog
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/environment/environment_introduction#fog
      * (Default is true)
      */
     set fogEnabled(value: boolean);
@@ -635,7 +640,7 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
     private _fogMode;
     /**
      * Gets or sets the fog mode to use
-     * @see https://doc.babylonjs.com/babylon101/environment#fog
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/environment/environment_introduction#fog
      * | mode | value |
      * | --- | --- |
      * | FOGMODE_NONE | 0 |
@@ -647,25 +652,25 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
     get fogMode(): number;
     /**
      * Gets or sets the fog color to use
-     * @see https://doc.babylonjs.com/babylon101/environment#fog
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/environment/environment_introduction#fog
      * (Default is Color3(0.2, 0.2, 0.3))
      */
     fogColor: Color3;
     /**
      * Gets or sets the fog density to use
-     * @see https://doc.babylonjs.com/babylon101/environment#fog
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/environment/environment_introduction#fog
      * (Default is 0.1)
      */
     fogDensity: number;
     /**
      * Gets or sets the fog start distance to use
-     * @see https://doc.babylonjs.com/babylon101/environment#fog
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/environment/environment_introduction#fog
      * (Default is 0)
      */
     fogStart: number;
     /**
      * Gets or sets the fog end distance to use
-     * @see https://doc.babylonjs.com/babylon101/environment#fog
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/environment/environment_introduction#fog
      * (Default is 1000)
      */
     fogEnd: number;
@@ -734,7 +739,7 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
     lensFlaresEnabled: boolean;
     /**
      * Gets or sets a boolean indicating if collisions are enabled on this scene
-     * @see https://doc.babylonjs.com/babylon101/cameras,_mesh_collisions_and_gravity
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/cameras/camera_collisions
      */
     collisionsEnabled: boolean;
     private _collisionCoordinator;
@@ -742,7 +747,7 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
     get collisionCoordinator(): ICollisionCoordinator;
     /**
      * Defines the gravity applied to this scene (used only for collisions)
-     * @see https://doc.babylonjs.com/babylon101/cameras,_mesh_collisions_and_gravity
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/cameras/camera_collisions
      */
     gravity: Vector3;
     /**
@@ -781,12 +786,12 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
     probesEnabled: boolean;
     /**
      * Gets or sets the current offline provider to use to store scene data
-     * @see https://doc.babylonjs.com/how_to/caching_resources_in_indexeddb
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/scene/optimizeCached
      */
     offlineProvider: IOfflineProvider;
     /**
      * Gets or sets the action manager associated with the scene
-     * @see https://doc.babylonjs.com/how_to/how_to_use_actions
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/events/actions
      */
     actionManager: AbstractActionManager;
     private _meshesForIntersections;
@@ -1108,7 +1113,7 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
     getTotalVertices(): number;
     /**
      * Gets the performance counter for total vertices
-     * @see https://doc.babylonjs.com/how_to/optimizing_your_scene#instrumentation
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/scene/optimize_your_scene#instrumentation
      */
     get totalVerticesPerfCounter(): PerfCounter;
     /**
@@ -1118,7 +1123,7 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
     getActiveIndices(): number;
     /**
      * Gets the performance counter for active indices
-     * @see https://doc.babylonjs.com/how_to/optimizing_your_scene#instrumentation
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/scene/optimize_your_scene#instrumentation
      */
     get totalActiveIndicesPerfCounter(): PerfCounter;
     /**
@@ -1128,7 +1133,7 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
     getActiveParticles(): number;
     /**
      * Gets the performance counter for active particles
-     * @see https://doc.babylonjs.com/how_to/optimizing_your_scene#instrumentation
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/scene/optimize_your_scene#instrumentation
      */
     get activeParticlesPerfCounter(): PerfCounter;
     /**
@@ -1138,7 +1143,7 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
     getActiveBones(): number;
     /**
      * Gets the performance counter for active bones
-     * @see https://doc.babylonjs.com/how_to/optimizing_your_scene#instrumentation
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/scene/optimize_your_scene#instrumentation
      */
     get activeBonesPerfCounter(): PerfCounter;
     /**

package/scene.js

@@ -39,7 +39,7 @@ export var ScenePerformancePriority;
 })(ScenePerformancePriority || (ScenePerformancePriority = {}));
 /**
  * Represents a scene to be rendered by the engine.
- * @see https://doc.babylonjs.com/features/scene
+ * @see https://doc.babylonjs.com/features/featuresDeepDive/scene
  */
 export class Scene extends AbstractScene {
     /**
@@ -350,6 +350,11 @@ export class Scene extends AbstractScene {
          * Observable event triggered each time an input event is received from the rendering canvas
          */
         this.onPointerObservable = new Observable();
+        /**
+         * Observable to handle camera pointer inputs
+         * @internal
+         */
+        this._onCameraInputObservable = new Observable();
         // Keyboard
         /**
          * This observable event is triggered when any keyboard event si raised and registered during Scene.attachControl()
@@ -371,25 +376,25 @@ export class Scene extends AbstractScene {
         this._fogMode = Scene.FOGMODE_NONE;
         /**
          * Gets or sets the fog color to use
-         * @see https://doc.babylonjs.com/babylon101/environment#fog
+         * @see https://doc.babylonjs.com/features/featuresDeepDive/environment/environment_introduction#fog
          * (Default is Color3(0.2, 0.2, 0.3))
          */
         this.fogColor = new Color3(0.2, 0.2, 0.3);
         /**
          * Gets or sets the fog density to use
-         * @see https://doc.babylonjs.com/babylon101/environment#fog
+         * @see https://doc.babylonjs.com/features/featuresDeepDive/environment/environment_introduction#fog
          * (Default is 0.1)
          */
         this.fogDensity = 0.1;
         /**
          * Gets or sets the fog start distance to use
-         * @see https://doc.babylonjs.com/babylon101/environment#fog
+         * @see https://doc.babylonjs.com/features/featuresDeepDive/environment/environment_introduction#fog
          * (Default is 0)
          */
         this.fogStart = 0;
         /**
          * Gets or sets the fog end distance to use
-         * @see https://doc.babylonjs.com/babylon101/environment#fog
+         * @see https://doc.babylonjs.com/features/featuresDeepDive/environment/environment_introduction#fog
          * (Default is 1000)
          */
         this.fogEnd = 1000.0;
@@ -428,12 +433,12 @@ export class Scene extends AbstractScene {
         // Collisions
         /**
          * Gets or sets a boolean indicating if collisions are enabled on this scene
-         * @see https://doc.babylonjs.com/babylon101/cameras,_mesh_collisions_and_gravity
+         * @see https://doc.babylonjs.com/features/featuresDeepDive/cameras/camera_collisions
          */
         this.collisionsEnabled = true;
         /**
          * Defines the gravity applied to this scene (used only for collisions)
-         * @see https://doc.babylonjs.com/babylon101/cameras,_mesh_collisions_and_gravity
+         * @see https://doc.babylonjs.com/features/featuresDeepDive/cameras/camera_collisions
          */
         this.gravity = new Vector3(0, -9.807, 0);
         // Postprocesses
@@ -982,7 +987,7 @@ export class Scene extends AbstractScene {
     }
     /**
      * Sets the step Id used by deterministic lock step
-     * @see https://doc.babylonjs.com/babylon101/animations#deterministic-lockstep
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/animation/advanced_animations#deterministic-lockstep
      * @param newStepId defines the step Id
      */
     setStepId(newStepId) {
@@ -990,7 +995,7 @@ export class Scene extends AbstractScene {
     }
     /**
      * Gets the step Id used by deterministic lock step
-     * @see https://doc.babylonjs.com/babylon101/animations#deterministic-lockstep
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/animation/advanced_animations#deterministic-lockstep
      * @returns the step Id
      */
     getStepId() {
@@ -998,7 +1003,7 @@ export class Scene extends AbstractScene {
     }
     /**
      * Gets the internal step used by deterministic lock step
-     * @see https://doc.babylonjs.com/babylon101/animations#deterministic-lockstep
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/animation/advanced_animations#deterministic-lockstep
      * @returns the internal step
      */
     getInternalStep() {
@@ -1006,7 +1011,7 @@ export class Scene extends AbstractScene {
     }
     /**
      * Gets or sets a boolean indicating if fog is enabled on this scene
-     * @see https://doc.babylonjs.com/babylon101/environment#fog
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/environment/environment_introduction#fog
      * (Default is true)
      */
     set fogEnabled(value) {
@@ -1021,7 +1026,7 @@ export class Scene extends AbstractScene {
     }
     /**
      * Gets or sets the fog mode to use
-     * @see https://doc.babylonjs.com/babylon101/environment#fog
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/environment/environment_introduction#fog
      * | mode | value |
      * | --- | --- |
      * | FOGMODE_NONE | 0 |
@@ -1301,7 +1306,7 @@ export class Scene extends AbstractScene {
     }
     /**
      * Gets the performance counter for total vertices
-     * @see https://doc.babylonjs.com/how_to/optimizing_your_scene#instrumentation
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/scene/optimize_your_scene#instrumentation
      */
     get totalVerticesPerfCounter() {
         return this._totalVertices;
@@ -1315,7 +1320,7 @@ export class Scene extends AbstractScene {
     }
     /**
      * Gets the performance counter for active indices
-     * @see https://doc.babylonjs.com/how_to/optimizing_your_scene#instrumentation
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/scene/optimize_your_scene#instrumentation
      */
     get totalActiveIndicesPerfCounter() {
         return this._activeIndices;
@@ -1329,7 +1334,7 @@ export class Scene extends AbstractScene {
     }
     /**
      * Gets the performance counter for active particles
-     * @see https://doc.babylonjs.com/how_to/optimizing_your_scene#instrumentation
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/scene/optimize_your_scene#instrumentation
      */
     get activeParticlesPerfCounter() {
         return this._activeParticles;
@@ -1343,7 +1348,7 @@ export class Scene extends AbstractScene {
     }
     /**
      * Gets the performance counter for active bones
-     * @see https://doc.babylonjs.com/how_to/optimizing_your_scene#instrumentation
+     * @see https://doc.babylonjs.com/features/featuresDeepDive/scene/optimize_your_scene#instrumentation
      */
     get activeBonesPerfCounter() {
         return this._activeBones;
@@ -3833,6 +3838,7 @@ export class Scene extends AbstractScene {
         this.onTextureRemovedObservable.clear();
         this.onPrePointerObservable.clear();
         this.onPointerObservable.clear();
+        this._onCameraInputObservable.clear();
         this.onPreKeyboardObservable.clear();
         this.onKeyboardObservable.clear();
         this.onActiveCameraChanged.clear();
@@ -4333,12 +4339,12 @@ Scene.FOGMODE_EXP2 = 2;
 Scene.FOGMODE_LINEAR = 3;
 /**
  * Gets or sets the minimum deltatime when deterministic lock step is enabled
- * @see https://doc.babylonjs.com/babylon101/animations#deterministic-lockstep
+ * @see https://doc.babylonjs.com/features/featuresDeepDive/animation/advanced_animations#deterministic-lockstep
  */
 Scene.MinDeltaTime = 1.0;
 /**
  * Gets or sets the maximum deltatime when deterministic lock step is enabled
- * @see https://doc.babylonjs.com/babylon101/animations#deterministic-lockstep
+ * @see https://doc.babylonjs.com/features/featuresDeepDive/animation/advanced_animations#deterministic-lockstep
  */
 Scene.MaxDeltaTime = 1000.0;
 /**