@babylonjs/core 5.32.1 → 5.33.0

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;
 /**