@openglobus/og 0.28.7 → 1.0.0-rc10

package/lib/camera/Frustum.d.ts

@@ -9,6 +9,10 @@ interface IFrustumParams {
     aspect?: number;
     near?: number;
     far?: number;
+    isOrthographic?: boolean;
+    focusDistance?: number;
+    reverseDepth?: boolean;
+    depthZeroToOne?: boolean;
 }
 /**
  * Frustum object, part of the camera object.
@@ -17,6 +21,17 @@ interface IFrustumParams {
  */
 declare class Frustum {
     protected _f: [NumberArray4, NumberArray4, NumberArray4, NumberArray4, NumberArray4, NumberArray4];
+    protected _isOrthographic: boolean;
+    protected _aspect: number;
+    protected _tanViewAngle_hrad: number;
+    protected _reverseDepth: boolean;
+    protected _depthZeroToOne: boolean;
+    /**
+     * Reference distance used to compute orthographic frustum size.
+     * For orthographic frustums this value is synchronized with vertical bounds.
+     * @public
+     */
+    focusDistance: number;
     /**
      * Camera projection matrix.
      * @protected
@@ -67,6 +82,12 @@ declare class Frustum {
      * @public
      */
     near: number;
+    /**
+     * Near-plane safety value used by depth offset logic in shaders.
+     * Updated together with `near`.
+     * @public
+     */
+    depthOffsetNear: number;
     /**
      * Projection frustum far value.
      * @public
@@ -75,26 +96,120 @@ declare class Frustum {
     cameraFrustumIndex: number;
     _pickingColorU: Float32Array;
     constructor(options?: IFrustumParams);
+    /**
+     * Returns right clipping plane.
+     * @public
+     * @returns {NumberArray4} Right clipping plane coefficients.
+     */
     getRightPlane(): NumberArray4;
+    /**
+     * Returns left clipping plane.
+     * @public
+     * @returns {NumberArray4} Left clipping plane coefficients.
+     */
     getLeftPlane(): NumberArray4;
+    /**
+     * Returns bottom clipping plane.
+     * @public
+     * @returns {NumberArray4} Bottom clipping plane coefficients.
+     */
     getBottomPlane(): NumberArray4;
+    /**
+     * Returns top clipping plane.
+     * @public
+     * @returns {NumberArray4} Top clipping plane coefficients.
+     */
     getTopPlane(): NumberArray4;
+    /**
+     * Returns backward clipping plane.
+     * @public
+     * @returns {NumberArray4} Backward clipping plane coefficients.
+     */
     getBackwardPlane(): NumberArray4;
+    /**
+     * Returns forward clipping plane.
+     * @public
+     * @returns {NumberArray4} Forward clipping plane coefficients.
+     */
     getForwardPlane(): NumberArray4;
+    /**
+     * Returns projection-view matrix.
+     * @public
+     * @returns {NumberArray16} Projection-view matrix values.
+     */
     getProjectionViewMatrix(): NumberArray16;
+    /**
+     * Returns projection-view RTE matrix.
+     * @public
+     * @returns {NumberArray16} Projection-view RTE matrix values.
+     */
     getProjectionViewRTEMatrix(): NumberArray16;
+    /**
+     * Returns projection matrix.
+     * @public
+     * @returns {NumberArray16} Projection matrix values.
+     */
     getProjectionMatrix(): NumberArray16;
+    /**
+     * Returns inverse projection matrix.
+     * @public
+     * @returns {NumberArray16} Inverse projection matrix values.
+     */
     getInverseProjectionMatrix(): NumberArray16;
     /**
      * Sets up camera projection matrix.
      * @public
-     * @param {number} viewAngle - Camera's vertical fov view angle.
-     * @param {number} aspect - Screen aspect ratio.
-     * @param {number} near - Near camera distance.
-     * @param {number} far - Far camera distance.
+     * @param {number} viewAngle - Camera vertical field of view angle in degrees.
+     * @param {number} aspect - Viewport aspect ratio (`width / height`).
+     * @param {number} near - Near clipping plane distance.
+     * @param {number} far - Far clipping plane distance.
+     * @param {boolean} [isOrthographic=false] - Enables orthographic projection mode.
+     * @param {number} [focusDistance=this.focusDistance] - Reference distance used to compute orthographic frustum size.
+     * @param {boolean} [reverseDepth=false] - Enables reverse-Z infinite perspective projection.
+     * @param {boolean} [depthZeroToOne=false] - Uses `[0, 1]` NDC depth range for reverse-Z projection.
+     */
+    setProjectionMatrix(viewAngle: number, aspect: number, near: number, far: number, isOrthographic?: boolean, focusDistance?: number, reverseDepth?: boolean, depthZeroToOne?: boolean): void;
+    /**
+     * Sets reference distance used to compute orthographic bounds and rebuilds projection matrices.
+     * Keeps current near and far clipping planes unchanged.
+     * @public
+     * @param {number} focusDistance - Reference distance.
+     */
+    setFocusDistance(focusDistance: number): void;
+    /**
+     * Updates orthographic projection bounds and rebuilds projection matrices.
+     * Keeps the current near and far clipping planes unchanged.
+     * @public
+     * @param {number} left - Left orthographic bound.
+     * @param {number} right - Right orthographic bound.
+     * @param {number} bottom - Bottom orthographic bound.
+     * @param {number} top - Top orthographic bound.
      */
-    setProjectionMatrix(viewAngle: number, aspect: number, near: number, far: number, isOrthographic?: boolean, focusDistance?: number): void;
+    setOrthoBounds(left: number, right: number, bottom: number, top: number): void;
+    /**
+     * Updates orthographic projection bounds and clipping planes in one projection rebuild.
+     * @public
+     * @param {number} left - Left orthographic bound.
+     * @param {number} right - Right orthographic bound.
+     * @param {number} bottom - Bottom orthographic bound.
+     * @param {number} top - Top orthographic bound.
+     * @param {number} near - Near clipping plane distance.
+     * @param {number} far - Far clipping plane distance.
+     */
+    setOrthoProjection(left: number, right: number, bottom: number, top: number, near: number, far: number): void;
+    /**
+     * Updates near and far clipping planes.
+     * @public
+     * @param {number} near - Near clipping plane distance.
+     * @param {number} [far=this.far] - Far clipping plane distance.
+     */
+    setNearFar(near: number, far?: number): void;
     protected _setFrustumParams(top: number, right: number, near: number, far: number): void;
+    /**
+     * Updates projection-view RTE matrix.
+     * @public
+     * @param {Mat4} viewRTEMatrix - View matrix in RTE coordinates.
+     */
     setProjectionViewRTEMatrix(viewRTEMatrix: Mat4): void;
     /**
      * Camera's projection matrix values.
@@ -103,40 +218,46 @@ declare class Frustum {
      */
     setViewMatrix(viewMatrix: Mat4): void;
     /**
-     * Returns true if a point in the frustum.
+     * Returns true if the point is inside the frustum.
      * @public
      * @param {Vec3} point - Cartesian point.
-     * @returns {boolean} -
+     * @returns {boolean} `true` when the point is inside.
      */
     containsPoint(point: Vec3): boolean;
     /**
-     * Returns true if the frustum contains a bonding sphere, but bottom plane exclude.
+     * Returns true if the sphere is inside the frustum, ignoring the bottom plane.
      * @public
      * @param {Sphere} sphere - Bounding sphere.
-     * @returns {boolean} -
+     * @returns {boolean} `true` when the sphere passes all checked planes.
      */
     containsSphereBottomExc(sphere: Sphere): boolean;
+    /**
+     * Checks sphere intersection with the bottom frustum plane only.
+     * @public
+     * @param {Sphere} sphere - Bounding sphere.
+     * @returns {boolean} `true` when the sphere is not clipped by the bottom plane.
+     */
     containsSphereButtom(sphere: Sphere): boolean;
     /**
-     * Returns true if the frustum contains a bonding sphere.
+     * Returns true if the sphere is inside the frustum.
      * @public
      * @param {Sphere} sphere - Bounding sphere.
-     * @returns {boolean} -
+     * @returns {boolean} `true` when the sphere is inside.
      */
     containsSphere(sphere: Sphere): boolean;
     /**
-     * Returns true if the frustum contains a bonding sphere.
+     * Returns true if the sphere is inside the frustum.
      * @public
      * @param {Vec3} center - Sphere center.
      * @param {number} radius - Sphere radius.
-     * @returns {boolean} -
+     * @returns {boolean} `true` when the sphere is inside.
      */
     containsSphere2(center: Vec3, radius: number): boolean;
     /**
-     * Returns true if the frustum contains a bounding box.
+     * Returns true if the box intersects or is inside the frustum.
      * @public
      * @param {Box} box - Bounding box.
-     * @returns {boolean} -
+     * @returns {boolean} `true` when the box is not fully outside.
      */
     containsBox(box: Box): boolean;
 }

package/lib/camera/PlanetCamera.d.ts

@@ -12,9 +12,7 @@ export interface IPlanetCameraParams extends ICameraParams {
 export interface IPlanetFlyCartesianParams extends IFlyCartesianParams {
     amplitude?: number;
     preventLock?: boolean;
-}
-export interface IPlanetFlyDistanceParams extends IPlanetFlyCartesianParams {
-    distance?: number;
+    linearPath?: boolean;
 }
 /**
  * Planet camera.
@@ -28,14 +26,15 @@ export interface IPlanetFlyDistanceParams extends IPlanetFlyCartesianParams {
  * @param {number} [options.far] - Camera far plane distance. Default is og.math.MAX
  * @param {number} [options.minAltitude] - Minimal altitude for the camera. Default is 5
  * @param {number} [options.maxAltitude] - Maximal altitude for the camera. Default is 20000000
+ * @param {boolean} [options.reverseDepth=true] - Enables reverse-Z depth in perspective mode.
  * @param {Vec3} [options.eye] - Camera eye position. Default (0,0,0)
  * @param {Vec3} [options.look] - Camera look position. Default (0,0,0)
  * @param {Vec3} [options.up] - Camera eye position. Default (0,1,0)
- * @fires og.Camera#viewchange
- * @fires og.Camera#moveend
- * @fires og.Camera#flystart
- * @fires og.Camera#flyend
- * @fires og.Camera#flystop
+ * @fires viewchange
+ * @fires moveend
+ * @fires flystart
+ * @fires flyend
+ * @fires flystop
  */
 declare class PlanetCamera extends Camera {
     /**
@@ -86,11 +85,16 @@ declare class PlanetCamera extends Camera {
      * @type {Segment}
      */
     _insideSegment: Segment | null;
-    slope: number;
     protected _keyLock: Key;
     protected _checkTerrainCollision: boolean;
     eyeNorm: Vec3;
+    protected _extentFitRequestId: number;
     constructor(planet: Planet, options?: IPlanetCameraParams);
+    /**
+     * Enables or disables terrain collision checks.
+     * @public
+     * @param {boolean} isActive - Terrain collision flag.
+     */
     setTerrainCollisionActivity(isActive: boolean): void;
     /**
      * Updates camera view space.
@@ -98,6 +102,15 @@ declare class PlanetCamera extends Camera {
      * @virtual
      */
     update(): void;
+    /**
+     * Updates camera slope against the planet surface normal.
+     * @public
+     */
+    updateCameraSlope(): void;
+    /**
+     * Updates camera geographic coordinates from current cartesian position.
+     * @public
+     */
     updateGeodeticPosition(): void;
     /**
      * Sets altitude over the terrain.
@@ -138,6 +151,11 @@ declare class PlanetCamera extends Camera {
      * @returns {Vec3}
      */
     getExtentPosition(extent: Extent, height?: number | null): Vec3;
+    protected _getExtentCenterHeightInfo(extent: Extent): {
+        height: number;
+        segmentZoom: number;
+    };
+    protected _isSegmentHeightAccurate(extentHeight: number, segmentZoom: number): boolean;
     /**
      * View current extent.
      * @public
@@ -153,6 +171,12 @@ declare class PlanetCamera extends Camera {
      * @param {IPlanetFlyCartesianParams} [params] - Flight parameters
      */
     flyExtent(extent: Extent, height?: number | null, params?: IPlanetFlyCartesianParams): void;
+    /**
+     * Places camera at a fixed distance from a target point and looks at it.
+     * @public
+     * @param {Vec3} cartesian - Target cartesian point.
+     * @param {number} [distance=10000.0] - Distance from the target.
+     */
     viewDistance(cartesian: Vec3, distance?: number): void;
     /**
      * Flies to the geo coordinates.
@@ -161,6 +185,13 @@ declare class PlanetCamera extends Camera {
      * @param {IPlanetFlyCartesianParams} [params] - Flight parameters
      */
     flyLonLat(lonlat: LonLat, params?: IPlanetFlyCartesianParams): void;
+    /**
+     * Flies camera to a position at a fixed distance from the target point.
+     * @public
+     * @param {Vec3} cartesian - Target cartesian point.
+     * @param {number} [distance=10000.0] - Distance from the target.
+     * @param {IPlanetFlyCartesianParams} [params] - Flight parameters.
+     */
     flyDistance(cartesian: Vec3, distance?: number, params?: IPlanetFlyCartesianParams): void;
     flyCartesian(cartesian: Vec3, params?: IPlanetFlyCartesianParams): void;
     stopFlying(): void;
@@ -190,23 +221,95 @@ declare class PlanetCamera extends Camera {
      * @param {number} angle - Rotation angle.
      */
     rotateDown(angle: number): void;
+    /**
+     * Rotates camera vertically around the given center.
+     * @public
+     * @param {number} angle - Rotation angle in radians.
+     * @param {Vec3} center - Rotation center.
+     * @param {number} [minSlope=0] - Minimum allowed slope limit.
+     */
     rotateVertical(angle: number, center: Vec3, minSlope?: number): void;
+    /**
+     * Updates terrain altitude and keeps camera above minimum altitude.
+     * @public
+     * @returns {Vec3 | undefined} Terrain point under camera when available.
+     */
     checkTerrainCollision(): Vec3 | undefined;
+    protected _getInsideCollisionSegment(): Segment | null;
+    /**
+     * Returns visible surface arc distance from current altitude.
+     * @public
+     * @param {number} d - Additional height offset.
+     * @returns {number} Visible surface distance.
+     */
     getSurfaceVisibleDistance(d: number): number;
     /**
-     * should be yje same as getYaw
+     * Returns the ellipsoid intersection point for a screen-space ray.
+     * If the ray doesn't hit ellipsoid, it returns 'undefined'.
+     * @public
+     * @param {number} x - Screen X coordinate in pixels.
+     * @param {number} y - Screen Y coordinate in pixels.
+     * @returns {Vec3 | undefined} Cartesian intersection point.
+     */
+    getRayIntersectionEllipsoid(x: number, y: number): Vec3 | undefined;
+    /**
+     * Returns heading angle in degrees.
+     * Should match `getYaw()` in most cases.
+     * @public
+     * @returns {number} Heading in `[0, 360)` degrees.
      */
     getHeading(): number;
+    /**
+     * Checks whether a cartesian point is visible above the horizon.
+     * @public
+     * @param {Vec3} poi - Point in cartesian coordinates.
+     * @returns {boolean} `true` when the point is visible.
+     */
     isVisible(poi: Vec3): boolean;
+    /**
+     * Returns pitch angle in local planet frame.
+     * @public
+     * @returns {number} Pitch angle in radians.
+     */
     getPitch(): number;
     /**
-     * should be the same as getHeading
+     * Returns yaw angle in local planet frame.
+     * Should match `getHeading()` in most cases.
+     * @public
+     * @returns {number} Yaw angle in radians.
      */
     getYaw(): number;
+    /**
+     * Returns roll angle in local planet frame.
+     * @public
+     * @returns {number} Roll angle in radians.
+     */
     getRoll(): number;
+    /**
+     * Sets pitch angle in local planet frame.
+     * @public
+     * @param {number} a - Pitch angle in radians.
+     */
     setPitch(a: number): void;
+    /**
+     * Sets yaw angle in local planet frame.
+     * @public
+     * @param {number} a - Yaw angle in radians.
+     */
     setYaw(a: number): void;
+    /**
+     * Sets roll angle in local planet frame.
+     * @public
+     * @param {number} a - Roll angle in radians.
+     */
     setRoll(a: number): void;
+    /**
+     * Sets orientation from pitch, yaw and roll in local planet frame.
+     * @public
+     * @param {number} pitch - Pitch angle in radians.
+     * @param {number} yaw - Yaw angle in radians.
+     * @param {number} roll - Roll angle in radians.
+     */
     setPitchYawRoll(pitch: number, yaw: number, roll: number): void;
 }
 export { PlanetCamera };

package/lib/camera/index.d.ts

@@ -1,3 +1,3 @@
-import { Camera } from './Camera';
-import { PlanetCamera } from './PlanetCamera';
+import { Camera } from "./Camera";
+import { PlanetCamera } from "./PlanetCamera";
 export { Camera, PlanetCamera };

package/lib/control/CompassButton.d.ts

@@ -6,11 +6,11 @@ interface ICompasButtonParams extends IControlParams {
  */
 export declare class CompassButton extends Control {
     protected _heading: number;
-    protected _svg: HTMLElement | null;
+    protected _icon: HTMLElement | null;
     constructor(options?: ICompasButtonParams);
     oninit(): void;
     protected _onClick(): void;
-    protected _draw(): void;
+    protected _draw: () => void;
     setHeading(heading: number): void;
 }
 export {};

package/lib/control/EarthCoordinates.d.ts

@@ -1,5 +1,5 @@
-import { Control, type IControlParams } from './Control';
-import { LonLat } from '../LonLat';
+import { Control, type IControlParams } from "./Control";
+import { LonLat } from "../LonLat";
 import type { IMouseState } from "../renderer/RendererEvents";
 interface IEarthCoordinatesParams extends IControlParams {
     heightMode?: string;
@@ -34,6 +34,9 @@ export declare class EarthCoordinates extends Control {
     protected _createCenterEl(): HTMLElement;
     protected _updateUnits(): void;
     protected _refreshCoordinates(): void;
+    protected _getClipboardCoordinates(): string;
+    protected _copyCoordinates(): Promise<void>;
+    protected _onPanelClick: (event: MouseEvent) => void;
     oninit(): void;
     protected _grabCoordinates(e: IMouseState): void;
     protected _showHeight(): Promise<void>;

package/lib/control/FramebufferPreview.d.ts

@@ -1,25 +1,41 @@
 import { Dialog } from "../ui/Dialog";
 import { Framebuffer } from "../webgl/Framebuffer";
 import { Control, IControlParams } from "./Control";
-import { Program } from "../webgl/Program";
+import { ShaderProgram } from "../webgl/ShaderProgram";
 export interface IFramebufferDialogParams extends IControlParams {
     framebuffer?: Framebuffer;
+    arrayTexture?: WebGLTexture;
+    arrayLayer?: number;
+    width?: number;
+    height?: number;
+    left?: number;
+    top?: number;
     title?: string;
     common?: string;
     image?: string;
-    flippedUV?: boolean;
+    flippedY?: boolean;
 }
 export declare class FramebufferPreview extends Control {
     protected _dialog: Dialog<null>;
-    $canvas: HTMLCanvasElement;
     protected _framebuffer: Framebuffer | null;
+    protected _arrayTexture: WebGLTexture | null;
+    protected _arrayLayer: number;
+    protected _width: number;
+    protected _height: number;
+    protected _isArrayMode: boolean;
     protected _screenFramebuffer: Framebuffer | null;
+    protected _program: ShaderProgram;
+    $canvas: HTMLCanvasElement;
     framebufferCurrentTexture: number;
-    protected _program: Program;
     constructor(params: IFramebufferDialogParams);
     bindFramebuffer(framebuffer: Framebuffer): void;
+    bindArrayTexture(texture: WebGLTexture, layer: number): void;
     oninit(): void;
     activate(): void;
     deactivate(): void;
+    protected _isDrawSubscribed: boolean;
+    protected _subscribeDraw(): void;
+    protected _unsubscribeDraw(): void;
+    protected _onDialogVisibilityChange: (isVisible: boolean) => void;
     protected _onDraw: () => void;
 }

package/lib/control/GeoImageDragControl.d.ts

@@ -1,4 +1,4 @@
-import { Control, type IControlParams } from './Control';
+import { Control, type IControlParams } from "./Control";
 import { Layer } from "../layer/Layer";
 import { ToggleButton } from "../ui/ToggleButton";
 import type { IMouseState } from "../renderer/RendererEvents";

package/lib/control/LayerAnimation.d.ts

@@ -1,5 +1,5 @@
-import { type EventsHandler } from '../Events';
-import { Layer } from '../layer/Layer';
+import { type EventsHandler } from "../Events";
+import { Layer } from "../layer/Layer";
 import { Control, type IControlParams } from "./Control";
 type LayerAnimationEventsList = ["change", "idle", "play", "pause", "stop"];
 interface ILayerAnimationParams extends IControlParams {

package/lib/control/LayerSwitcher.d.ts

@@ -30,6 +30,9 @@ export declare class LayerSwitcher extends Control {
     oninit(): void;
     protected _initLayers(): void;
     protected _createLayerButton(layer: Layer): LayerButtonView;
+    protected _findLayerView(layer: Layer): LayerButtonView | null;
+    protected _placeLayerView(layerView: LayerButtonView): void;
+    protected _onLayerBaseLayerChange: (layer: Layer) => void;
     addLayer: (layer: Layer) => void;
     removeLayer: (layer: Layer) => void;
     onactivate(): void;

package/lib/control/Lighting.d.ts

@@ -1,10 +1,10 @@
 import { Control } from "./Control";
 import type { IControlParams } from "./Control";
-import { Dialog } from '../ui/Dialog';
+import { Dialog } from "../ui/Dialog";
 import { Layer } from "../layer/Layer";
 import { Slider } from "../ui/Slider";
 import { ToggleButton } from "../ui/ToggleButton";
-import { View } from '../ui/View';
+import { View } from "../ui/View";
 import { Color } from "../ui/Color";
 interface ILightingParams extends IControlParams {
 }
@@ -18,10 +18,12 @@ export declare class Lighting extends Control {
     protected _panel: View<null>;
     protected _atmosphereMaxOpacity: Slider;
     protected _atmosphereMinOpacity: Slider;
+    protected _atmosphereOpacityCurveShift: Slider;
     protected _simpleSkyBackgroundColorOne: Color;
     protected _simpleSkyBackgroundColorTwo: Color;
     protected _gamma: Slider;
     protected _exposure: Slider;
+    protected _whitepoint: Slider;
     protected _night: Slider;
     protected _opacity: Slider;
     protected _diffuse_r: Slider;
@@ -36,6 +38,7 @@ export declare class Lighting extends Control {
     protected _shininess: Slider;
     $gamma: HTMLElement | null;
     $exposure: HTMLElement | null;
+    $whitepoint: HTMLElement | null;
     $night: HTMLElement | null;
     $opacity: HTMLElement | null;
     $diffuse: HTMLElement | null;
@@ -47,6 +50,8 @@ export declare class Lighting extends Control {
     bindLayer(layer: Layer): void;
     oninit(): void;
     protected _update(): void;
+    protected _setSliderValue(slider: Slider, value: number): void;
+    protected _syncSelectedBaseLayerLighting(): void;
     protected _fetchLayers(): void;
     protected _onLayerAdd(e: Layer): void;
     protected _onLayerRemove(e: Layer): void;