babylonjs-addons 8.33.4 → 8.34.1

package/babylonjs.addons.d.ts

@@ -2423,10 +2423,15 @@ declare module ADDONS {
         get clampedCameraHeight(): number;
         /**
          * The camera position in global space kilometers.
+         *
+         * The behavior of this value depends on whether floating origin mode is enabled:
+         * - If floating origin mode is enabled, this is simply the camera's global position scaled to kilometers. The atmosphere's origin height is used to offset the camera position along its geocentric normal.
+         * - If floating origin mode is disabled, the camera's y position is offset by the planet radius plus any origin height.
          */
         get cameraPositionGlobal(): BABYLON.IVector3Like;
         /**
          * The camera position, clamped to the planet radius offset, in global space kilometers.
+         * See {@link cameraPositionGlobal} for details on how the value is computed.
          */
         get clampedCameraPositionGlobal(): BABYLON.IVector3Like;
         /**
@@ -2439,6 +2444,7 @@ declare module ADDONS {
         get sinCameraAtmosphereHorizonAngleFromNadir(): number;
         /**
          * The geocentric normal of the camera in global space i.e., the normalization of {@link cameraPositionGlobal}.
+         * Note the behavior of this value depends on whether floating origin mode is enabled. See {@link cameraPositionGlobal} for details.
          */
         get cameraGeocentricNormal(): BABYLON.IVector3Like;
         /**
@@ -2753,11 +2759,11 @@ declare module ADDONS {
         /**
          * Called before the LUTs are rendered for this camera. This happens after the per-camera UBO update.
          */
-        readonly onBeforeRenderLutsForCameraObservable: BABYLON.Observable<void>;
+        readonly onBeforeRenderLutsForCameraObservable: BABYLON.Observable<BABYLON.Camera>;
         /**
          * Called after the LUTs were rendered.
          */
-        readonly onAfterRenderLutsForCameraObservable: BABYLON.Observable<void>;
+        readonly onAfterRenderLutsForCameraObservable: BABYLON.Observable<BABYLON.Camera>;
         /**
          * If provided, this is the depth texture used for composition passes.
          * Expects an infinite far plane on the camera (camera.maxZ = 0) and the non-linear depth accessible in red channel.
@@ -3011,6 +3017,7 @@ declare module ADDONS {
         /**
          * Renders the lookup tables, some of which can vary per-camera.
          * It is expected that updatePerCameraVariables was previously called.
+         * @param camera - The camera to render the LUTs for.
          */
         private _renderLutsForCamera;
         /**