@openglobus/og 0.12.1 → 0.12.3

package/types/Extent.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Represents geographical coordinates extent.
+ * @class
+ * @param {LonLat} [sw] - South West extent corner coordiantes.
+ * @param {LonLat} [ne] - North East extent corner coordiantes.
+ */
+export class Extent {
+    /**
+     * Whole mercator extent.
+     * @const
+     */
+    static get FULL_MERC(): Extent;
+    /**
+     * Degrees extent from north mercator limit to north pole.
+     * @const
+     */
+    static get NORTH_POLE_DEG(): Extent;
+    /**
+     * Degrees extent from south pole to south mercator limit.
+     * @const
+     */
+    static get SOUTH_POLE_DEG(): Extent;
+    /**
+     * Creates extent instance from values in array.
+     * @static
+     * @param {Array.<number>} arr - South west and north east longitude and latidudes packed in array. (exactly 4 entries)
+     * @return {Extent} Extent object.
+     */
+    static createFromArray(arr: Array<number>): Extent;
+    /**
+     * Creates bound extent instance by coordinate array.
+     * @static
+     * @param {Array.<LonLat>} arr - Coordinate array.
+     * @return {Extent} Extent object.
+     */
+    static createByCoordinates(arr: Array<LonLat>): Extent;
+    /**
+     * Creates bound extent instance by coordinate array.
+     * @static
+     * @param {Array.<Array<number>>} arr - Coordinate array. (exactly 2 entries)
+     * @return {Extent} Extent object.
+     */
+    static createByCoordinatesArr(arr: Array<Array<number>>): Extent;
+    /**
+     * Creates extent by meractor grid tile coordinates.
+     * @static
+     * @param {number} x -
+     * @param {number} y -
+     * @param {number} z -
+     * @param {number} width -
+     * @param {number} height -
+     * @returns {Extent} -
+     */
+    static fromTile(x: number, y: number, z: number, width: number, height: number): Extent;
+    /**
+     * @param {LonLat} [sw] - South West extent corner coordiantes.
+     * @param {LonLat} [ne] - North East extent corner coordiantes.
+     */
+    constructor(sw?: LonLat, ne?: LonLat);
+    /**
+     * @public
+     */
+    public southWest: LonLat;
+    /**
+     * @public
+     */
+    public northEast: LonLat;
+    /**
+     * Sets current bounding extent object by coordinate array.
+     * @public
+     * @param {Array.<LonLat>} arr - Coordinate array.
+     * @return {Extent} Current extent.
+     */
+    public setByCoordinates(arr: Array<LonLat>): Extent;
+    /**
+     * Determines if point inside extent.
+     * @public
+     * @param {LonLat} lonlat - Coordinate point.
+     * @return {boolean} Returns true if point inside extent.
+     */
+    public isInside(lonlat: LonLat): boolean;
+    /**
+     * Returns true if two extent overlap each other.
+     * @public
+     * @param {Extent} e - Another extent.
+     * @return {boolean} -
+     */
+    public overlaps(e: Extent): boolean;
+    /**
+     * Gets extent width.
+     * @public
+     * @return {number} Extent width.
+     */
+    public getWidth(): number;
+    /**
+     * Gets extent height.
+     * @public
+     * @return {number} Extent height.
+     */
+    public getHeight(): number;
+    /**
+     * Creates clone instance of the current extent.
+     * @public
+     * @return {Extent} Extent clone.
+     */
+    public clone(): Extent;
+    /**
+     * Gets the center coordinate of the extent.
+     * @public
+     * @return {number} Center coordinate.
+     */
+    public getCenter(): number;
+    /**
+     * @public
+     */
+    public getNorthWest(): LonLat;
+    /**
+     * @public
+     */
+    public getNorthEast(): LonLat;
+    getSouthWest(): LonLat;
+    /**
+     * @public
+     */
+    public getSouthEast(): LonLat;
+    /**
+     * @public
+     */
+    public getNorth(): number;
+    getEast(): number;
+    /**
+     * @public
+     */
+    public getWest(): number;
+    /**
+     * @public
+     */
+    public getSouth(): number;
+    /**
+     * Returns extents are equals.
+     * @param {Extent} extent - Extent.
+     * @returns {boolean} -
+     */
+    equals(extent: Extent): boolean;
+    /**
+     * Converts extent coordinates to mercator projection coordinates.
+     * @public
+     * @return {Extent} New instance of the current extent.
+     */
+    public forwardMercator(): Extent;
+    /**
+     * Converts extent coordinates from mercator projection to degrees.
+     * @public
+     * @return {Extent} New instance of the current extent.
+     */
+    public inverseMercator(): Extent;
+    /**
+     * Gets cartesian bounding bounds of the current ellipsoid.
+     * @public
+     * @param {Ellipsoid} ellipsoid - Ellipsoid.
+     * @return {Array.<number>} Cartesian 3d coordinate array. (exactly 6 entries)
+     */
+    public getCartesianBounds(ellipsoid: Ellipsoid): Array<number>;
+    toString(): string;
+}
+import { LonLat } from "./LonLat.js";

package/types/Globe.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Creates a WebGL context with globe.
+ * @class
+ *
+ * @example <caption>Basic initialization</caption>
+ * globus = new og.Globe({
+ *     'atmosphere': false,
+ *     'target': 'globus',
+ *     'name': 'Earth',
+ *     'controls': [
+ *          new og.control.MouseNavigation({ autoActivate: true }),
+ *          new og.control.KeyboardNavigation({ autoActivate: true }),
+ *          new og.control.EarthCoordinates({ autoActivate: true, center: false }),
+ *          new og.control.LayerSwitcher({ autoActivate: true }),
+ *          new og.control.ZoomControl({ autoActivate: true }),
+ *          new og.control.TouchNavigation({ autoActivate: true }),
+ *          new og.control.Sun({ autoActivate: true })
+ *      ],
+ *     'terrain': new og.terrain.GlobusTerrain(),
+ *     'layers': [
+ *          new og.layer.XYZ("OpenStreetMap", { isBaseLayer: true, url: "http://b.tile.openstreetmap.org/{z}/{x}/{y}.png", visibility: true, attribution: 'Data @ <a href="http://www.openstreetmap.org/">OpenStreetMap</a> contributors, <a href="http://www.openstreetmap.org/copyright">ODbL</a>' })
+ *      ],
+ *     'autoActivate': true
+ * });
+ *
+ * @param {object} options - Options:
+ * @param {string} options.target - HTML element id where planet canvas have to be created.
+ * @param {RenderNode} [options.skybox] - Render skybox. null - default.
+ * @param {string} [options.name] - Planet name. Default is unic identifier.
+ * @param {Terrain} [options.terrain] - Terrain provider. Default no terrain - og.terrain.EmptyTerrain.
+ * @param {Array.<control.Control>} [options.controls] - Renderer controls array.
+ * @param {Array.<Layer>} [options.layers] - Planet layers.
+ * @param {Extent} [options.viewExtent] - Viewable starting extent.
+ * @param {boolean} [options.autoActivate] - Globe rendering auto activation flag. True is default.
+ * @param {DOMElement} [options.attributionContainer] - Container for attribution list.
+ * @param {Number} [options.maxGridSize] = Maximal segment grid size. 128 is default
+ * @param {boolean} [options.useSpecularTexture] - use specular water mask
+ * @param {boolean} [options.useNightTexture] - show night cities
+ * @param {Number} [options.maxAltitude=15000000.0] - Maximal camera altitude above terrain
+ * @param {Number} [options.minAltitude=1.0] - Minimal camera altitude above terrain
+ * @param {Number} [options.maxEqualZoomAltitude=15000000.0] - Maximal altitude since segments on the screen bacame the same zoom level
+ * @param {Number} [options.minEqualZoomAltitude=10000.0] - Minimal altitude since segments on the screen bacame the same zoom level
+ * @param {Number} [options.minEqualZoomCameraSlope=0.8] - Minimal camera slope above te globe where segments on the screen bacame the same zoom level
+ * @param {Number} [options.loadingBatchSize=12] -
+ */
+export class Globe {
+    static set _staticCounter(arg: any);
+    static get _staticCounter(): any;
+    /**
+     * @param {*} options
+     */
+    constructor(options: any);
+    _canvas: HTMLCanvasElement;
+    div: any;
+    /**
+     * Interface for the renderer context(events, input states, renderer nodes etc.)
+     * @public
+     * @type {Renderer}
+     */
+    public renderer: Renderer;
+    /**
+     * Planet node name. Access with this.renderer.<name>
+     * @private
+     * @type {String}
+     */
+    private _planetName;
+    planet: Planet;
+    sun: any;
+    _opacityCounter: number;
+    _fadeHandler: any;
+    _stopHandler: any;
+    /**
+     * Starts screen brightness fading in effect by the duration time.
+     * @public
+     */
+    public fadeIn(): void;
+    /**
+     * Starts screen brightness fading out effect by the duration time.
+     * @public
+     * @param {number} duration - Fadeout duration time.
+     */
+    public fadeOut(): void;
+}
+import { Renderer } from "./renderer/Renderer.js";
+import { Planet } from "./scene/Planet.js";

package/types/ImageCanvas.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Usefull class for working with JS canvas object.
+ * @class
+ */
+export class ImageCanvas {
+    /**
+     * @param {number} [width] - Canvas width. Default 256.
+     * @param {number} [height] - Canvas height. Default 256.
+     */
+    constructor(width?: number, height?: number);
+    /**
+     * Canvas object.
+     * @protected
+     * @type {Object}
+     */
+    protected _canvas: any;
+    /**
+     * Canvas context.
+     * @protected
+     * @type {Object}
+     */
+    protected _context: any;
+    /**
+     * Returns canvas object.
+     * @public
+     * @returns {Object}
+     */
+    public getCanvas(): any;
+    /**
+     * Returns canvas context pointer.
+     * @public
+     * @returns {Object}
+     */
+    public getContext(): any;
+    /**
+     * Fills canvas RGBA with zeroes.
+     * @public
+     */
+    public fillEmpty(): void;
+    /**
+     * Gets canvas pixels RGBA data.
+     * @public
+     * @returns {Array.<number>}
+     */
+    public getData(): Array<number>;
+    /**
+     * Fill the canvas by color.
+     * @public
+     * @param {string} color - CSS string color.
+     */
+    public fillColor(color: string): void;
+    /**
+     * Sets RGBA pixel data.
+     * @public
+     * @param {Array.<number>} data - Array RGBA data.
+     */
+    public setData(data: Array<number>): void;
+    /**
+     * Resize canvas.
+     * @public
+     * @param {number} width - Width.
+     * @param {number} height - Height.
+     */
+    public resize(width: number, height: number): void;
+    /**
+     * Draw an image on the canvas.
+     * @public
+     * @param {Image} img - Draw image.
+     * @param {number} [x] - Left top image corner X coordinate on the canvas.
+     * @param {number} [y] - Left top image corner Y coordinate on the canvas.
+     * @param {number} [width] - Image width slice. Image width is default.
+     * @param {number} [height] - Image height slice. Image height is default.
+     */
+    public drawImage(img: new (width?: number, height?: number) => HTMLImageElement, x?: number, y?: number, width?: number, height?: number): void;
+    /**
+     * Converts canvas to JS image object.
+     * @public
+     * @returns {Image}
+     */
+    public getImage(): new (width?: number, height?: number) => HTMLImageElement;
+    /**
+     * Get measured text width.
+     * @public
+     * @param {string} text - Measured text.
+     * @returns {number}
+     */
+    public getTextWidth(text: string): number;
+    /**
+     * Draw a text on the canvas.
+     * @public
+     * @param {string} text - Text.
+     * @param {number} [x] - Canvas X - coordinate. 0 - default.
+     * @param {number} [y] - Canvas Y - coordinate. 0 - default.
+     * @param {string} [font] - Font style. 'normal 14px Verdana' - is default.
+     * @param {string} [color] - Css font color.
+     */
+    public drawText(text: string, x?: number, y?: number, font?: string, color?: string): void;
+    /**
+     * Gets canvas width.
+     * @public
+     * @returns {number}
+     */
+    public getWidth(): number;
+    /**
+     * Gets canvas height.
+     * @public
+     * @returns {number}
+     */
+    public getHeight(): number;
+    /**
+     * Load image to canvas.
+     * @public
+     * @param {string} url - Image url.
+     * @pararm {imageCallback} [callback] - Image onload callback.
+     */
+    public load(url: string, callback: any): void;
+    /**
+     * Open canvas image in the new window.
+     * @public
+     */
+    public openImage(): void;
+    destroy(): void;
+}

package/types/Lock.d.ts

@@ -0,0 +1,12 @@
+export class Lock {
+    _lock: number;
+    lock(key: any): void;
+    free(key: any): void;
+    isFree(): boolean;
+    isLocked(): boolean;
+}
+export class Key {
+    static set _staticCounter(arg: any);
+    static get _staticCounter(): any;
+    _id: number;
+}

package/types/LonLat.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Represents a geographical point with a certain latitude, longitude and height.
+ * @class
+ * @param {number} [lon] - Longitude.
+ * @param {number} [lat] - Latitude.
+ * @param {number} [height] - Height over the surface.
+ */
+export class LonLat {
+    /**
+     * Creates coordinates array.
+     * @static
+     * @param{Array.<Array<number>>} arr - Coordinates array data. (exactly 3 entries)
+     * @return{Array.<LonLat>} the same coordinates array but each element is LonLat instance.
+     */
+    static join(arr: Array<Array<number>>): Array<LonLat>;
+    /**
+     * Creates an object by coordinate array.
+     * @static
+     * @param {Array.<number>} arr - Coordiante array, where first is longitude, second is latitude and third is a height. (exactly 3 entries)
+     * @returns {LonLat} -
+     */
+    static createFromArray(arr: Array<number>): LonLat;
+    /**
+     * Converts degrees to mercator coordinates.
+     * @static
+     * @param {number} lon - Degrees longitude.
+     * @param {number} lat - Degrees latitude.
+     * @param {number} [height] - Height.
+     * @returns {LonLat} -
+     */
+    static forwardMercator(lon: number, lat: number, height?: number): LonLat;
+    /**
+     * Converts mercator to degrees coordinates.
+     * @static
+     * @param {number} x - Mercator longitude.
+     * @param {number} y - Mercator latitude.
+     * @param {number} [height] - Height.
+     * @returns {LonLat} -
+     */
+    static inverseMercator(x: number, y: number, height?: number): LonLat;
+    /**
+     * @param {number} [lon] - Longitude.
+     * @param {number} [lat] - Latitude.
+     * @param {number} [height] - Height over the surface.
+     */
+    constructor(lon?: number, lat?: number, height?: number);
+    /**
+     * Longitude.
+     * @public
+     * @type {number}
+     */
+    public lon: number;
+    /**
+     * Latitude.
+     * @public
+     * @type {number}
+     */
+    public lat: number;
+    /**
+     * Height.
+     * @public
+     * @type {number}
+     */
+    public height: number;
+    isZero(): boolean;
+    /**
+     * Sets coordinates.
+     * @public
+     * @param {number} [lon] - Longitude.
+     * @param {number} [lat] - Latitude.
+     * @param {number} [height] - Height.
+     * @returns {LonLat} -
+     */
+    public set(lon?: number, lat?: number, height?: number): LonLat;
+    /**
+     * Copy coordinates.
+     * @public
+     * @param {LonLat} [lonLat] - Coordinates to copy.
+     * @returns {LonLat} -
+     */
+    public copy(lonLat?: LonLat): LonLat;
+    /**
+     * Clone the coordiante.
+     * @public
+     * @returns {LonLat} -
+     */
+    public clone(): LonLat;
+    /**
+     * Converts to mercator coordinates.
+     * @public
+     * @returns {LonLat} -
+     */
+    public forwardMercator(): LonLat;
+    forwardMercatorEPS01(): LonLat;
+    /**
+     * Converts from mercator coordinates.
+     * @public
+     * @returns {LonLat} -
+     */
+    public inverseMercator(): LonLat;
+    /**
+     * Compares coordinates.
+     * @public
+     * @param {LonLat} b - Coordinate to compare with.
+     * @returns {boolean} -
+     */
+    public equal(b: LonLat): boolean;
+}

package/types/Popup.d.ts

@@ -0,0 +1,42 @@
+export class Popup {
+    static set _staticCounter(arg: any);
+    static get _staticCounter(): any;
+    /**
+     *
+     * @param {*} options
+     */
+    constructor(options: any);
+    _id: number;
+    events: Events;
+    _template: string;
+    el: ChildNode;
+    _title: any;
+    _content: any;
+    _contentEl: any;
+    _titleEl: any;
+    _planet: any;
+    _offset: any;
+    _lonLat: any;
+    _cartPos: Vec3;
+    _visibility: any;
+    _renderTemplate(): ChildNode;
+    _updatePosition(): void;
+    setScreen(p: any): void;
+    get clientWidth(): any;
+    get clientHeight(): any;
+    setOffset(x?: number, y?: number): Popup;
+    render(params: any): Popup;
+    _tipEl: any;
+    setVisibility(visibility: any): Popup;
+    getContainer(): any;
+    getToolbarContainer(): any;
+    show(): Popup;
+    hide(): Popup;
+    setCartesian3v(cart: any, height?: number): Popup;
+    setTitle(html: any): Popup;
+    setLonLat(lonLat: any): Popup;
+    setContent(content: any): Popup;
+    clear(): void;
+}
+import { Events } from "./Events.js";
+import { Vec3 } from "./math/Vec3.js";

package/types/QueueArray.d.ts

@@ -0,0 +1,19 @@
+export class QueueArray {
+    /**
+     *
+     * @param {number} [size]
+     */
+    constructor(size?: number);
+    _size: number;
+    _array: any[];
+    _popIndex: number;
+    _shiftIndex: number;
+    length: number;
+    reset(): void;
+    clear(): void;
+    push(data: any): void;
+    pop(): any;
+    unshift(data: any): void;
+    shift(): any;
+    each(callback: any): void;
+}

package/types/Rectangle.d.ts

@@ -0,0 +1,80 @@
+/**
+ * 2D Rectangle class.
+ * @class
+ * @param {number} [left] - Left coordinate. 0 - default.
+ * @param {number} [top] - Top coordinate. 0 - default.
+ * @param {number} [right] - Right coordinate. 0 - default.
+ * @param {number} [bottom] - Bottom coordinate. 0 - default.
+ */
+export class Rectangle {
+    /**
+     * @param {number} [left] - Left coordinate. 0 - default.
+     * @param {number} [top] - Top coordinate. 0 - default.
+     * @param {number} [right] - Right coordinate. 0 - default.
+     * @param {number} [bottom] - Bottom coordinate. 0 - default.
+     */
+    constructor(left?: number, top?: number, right?: number, bottom?: number);
+    /**
+     * Left coordinate.
+     * @public
+     * @type {number}
+     */
+    public left: number;
+    /**
+     * Right coordinate.
+     * @public
+     * @type {number}
+     */
+    public right: number;
+    /**
+     * Top coordinate.
+     * @public
+     * @type {number}
+     */
+    public top: number;
+    /**
+     * Top coordinate.
+     * @public
+     * @type {number}
+     */
+    public bottom: number;
+    /**
+     * Clone rectangle object.
+     * @public
+     * @returns {Rectangle}
+     */
+    public clone(): Rectangle;
+    /**
+     * Returns rectangle width.
+     * @public
+     * @type {number}
+     */
+    public getWidth(): number;
+    /**
+     * Returns rectangle height.
+     * @public
+     * @type {number}
+     */
+    public getHeight(): number;
+    /**
+     * Returns rectangle area.
+     * @public
+     * @type {number}
+     */
+    public getSquare(): number;
+    /**
+     * Returns rectangle diagonal size.
+     * @public
+     * @type {number}
+     */
+    public getDiagonal(): number;
+    /**
+     * Returns true if rectangle fits their size in width and height.
+     * @public
+     * @param {number} width - Width.
+     * @param {number} height - Height.
+     * @type {boolean}
+     */
+    public fit(width: number, height: number): boolean;
+    isInside(x: any, y: any): boolean;
+}

package/types/Stack.d.ts

@@ -0,0 +1,19 @@
+export class Stack {
+    /**
+     *
+     * @param {number} [size]
+     */
+    constructor(size?: number);
+    _current: Node;
+    _head: Node;
+    current(): Node;
+    push(data: any): void;
+    pop(data: any): any;
+    popPrev(data: any): any;
+}
+declare class Node {
+    next: any;
+    prev: any;
+    data: any;
+}
+export {};

package/types/ajax.d.ts

@@ -0,0 +1,24 @@
+export namespace ajax {
+    /**
+     * Send an ajax request.
+     * @function
+     * @param {string} url - Url path.
+     * @param {Object} [params] - Ajax parameters:
+     * @param {ajax.Method|string} [params.type] - 'POST' or 'GET' ajax method. 'GET' is default.
+     * @param {boolean} [params.async] - Asynchronous ajax flag. True is default.
+     * @param {Object} [params.data] - Qery data.
+     * @param {Object} [params.sender] - Sender object, that success callback binded with. ActiveXObject is default.
+     * @param {string} [params.responseType] - Responce data type. Culd be 'text', 'json', 'jsonp', 'html'. 'text' is default.
+     * @param {ajax.Xhr~successCallback} [params.success] - The callback that handles the success response.
+     * @param {ajax.Xhr~errorCallback} [params.error] - The callback that handles the failed response.
+     * @param {ajax.Xhr~abortCallback} [params.abort] - The callback that handles aborted requests.
+     * @returns {ajax.Xhr} - Returns object that could be aborted.
+     */
+    function request(url: string, params?: {
+        type?: any;
+        async?: boolean;
+        data?: any;
+        sender?: any;
+        responseType?: string;
+    }): ajax.Xhr;
+}