@openglobus/og 0.17.2 → 0.18.1

package/lib/js/ImageCanvas.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Usefull class for working with JS canvas object.
+ * @class
+ * @param {number} [width] - Canvas width. Default 256.
+ * @param {number} [height] - Canvas height. Default 256.
+ */
+declare class ImageCanvas {
+    /**
+     * Canvas object.
+     * @protected
+     * @type {HTMLCanvasElement}
+     */
+    protected _canvas: HTMLCanvasElement;
+    /**
+     * Canvas context.
+     * @protected
+     * @type {CanvasRenderingContext2D}
+     */
+    protected _context: CanvasRenderingContext2D;
+    constructor(width?: number, height?: number);
+    /**
+     * Returns canvas object.
+     * @public
+     * @returns {HTMLCanvasElement}
+     */
+    getCanvas(): HTMLCanvasElement;
+    /**
+     * Returns canvas context pointer.
+     * @public
+     * @returns {CanvasRenderingContext2D}
+     */
+    getContext(): CanvasRenderingContext2D;
+    /**
+     * Fills canvas RGBA with zeroes.
+     * @public
+     */
+    fillEmpty(): void;
+    /**
+     * Fills canvas RGBA with color.
+     * @public
+     * @param {string} color - CSS string color.
+     */
+    fill(color: string): void;
+    /**
+     * Gets canvas pixels RGBA data.
+     * @public
+     * @returns {Uint8ClampedArray}
+     */
+    getData(): Uint8ClampedArray;
+    /**
+     * Fill the canvas by color.
+     * @public
+     * @param {string} color - CSS string color.
+     */
+    fillColor(color: string): void;
+    /**
+     * Sets RGBA pixel data.
+     * @public
+     * @param {Array.<number>} data - Array RGBA data.
+     */
+    setData(data: ArrayLike<number>): void;
+    /**
+     * Resize canvas.
+     * @public
+     * @param {number} width - Width.
+     * @param {number} height - Height.
+     */
+    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.
+     */
+    drawImage(img: HTMLImageElement, x: number, y: number, width: number, height: number): void;
+    /**
+     * Converts canvas to JS image object.
+     * @public
+     * @returns {Image}
+     */
+    getImage(): HTMLImageElement;
+    /**
+     * Get measured text width.
+     * @public
+     * @param {string} text - Measured text.
+     * @returns {number}
+     */
+    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.
+     */
+    drawText(text: string, x?: number, y?: number, font?: string, color?: string): void;
+    /**
+     * Gets canvas width.
+     * @public
+     * @returns {number}
+     */
+    getWidth(): number;
+    /**
+     * Gets canvas height.
+     * @public
+     * @returns {number}
+     */
+    getHeight(): number;
+    /**
+     * Load image to canvas.
+     * @public
+     * @param {string} url - Image url.
+     * @param {Function} [callback] - Image onload callback.
+     */
+    load(url: string, callback: Function): void;
+    /**
+     * Open canvas image in the new window.
+     * @public
+     */
+    openImage(): void;
+    destroy(): void;
+}
+export { ImageCanvas };

package/lib/js/ImageCanvas.js

@@ -0,0 +1,203 @@
+/**
+ * Usefull class for working with JS canvas object.
+ * @class
+ * @param {number} [width] - Canvas width. Default 256.
+ * @param {number} [height] - Canvas height. Default 256.
+ */
+class ImageCanvas {
+    constructor(width = 256, height = 256) {
+        this._canvas = document.createElement("canvas");
+        this._canvas.width = width;
+        this._canvas.height = height;
+        this._context = this._canvas.getContext("2d", {
+            willReadFrequently: true
+        });
+    }
+    /**
+     * Returns canvas object.
+     * @public
+     * @returns {HTMLCanvasElement}
+     */
+    getCanvas() {
+        return this._canvas;
+    }
+    /**
+     * Returns canvas context pointer.
+     * @public
+     * @returns {CanvasRenderingContext2D}
+     */
+    getContext() {
+        return this._context;
+    }
+    /**
+     * Fills canvas RGBA with zeroes.
+     * @public
+     */
+    fillEmpty() {
+        let imgd = this._context.getImageData(0, 0, this._canvas.width, this._canvas.height);
+        let pixels = imgd.data;
+        for (let i = 0, n = pixels.length; i < n; i += 4) {
+            pixels[i] = pixels[i + 1] = pixels[i + 2] = pixels[i + 3] = 0;
+        }
+        this._context.putImageData(imgd, 0, 0);
+    }
+    /**
+     * Fills canvas RGBA with color.
+     * @public
+     * @param {string} color - CSS string color.
+     */
+    fill(color) {
+        this._context.fillStyle = color;
+        this._context.fill();
+    }
+    /**
+     * Gets canvas pixels RGBA data.
+     * @public
+     * @returns {Uint8ClampedArray}
+     */
+    getData() {
+        let imgd = this._context.getImageData(0, 0, this._canvas.width, this._canvas.height);
+        return imgd.data;
+    }
+    /**
+     * Fill the canvas by color.
+     * @public
+     * @param {string} color - CSS string color.
+     */
+    fillColor(color) {
+        this._context.fillStyle = color;
+        this._context.fillRect(0, 0, this._canvas.width, this._canvas.height);
+    }
+    /**
+     * Sets RGBA pixel data.
+     * @public
+     * @param {Array.<number>} data - Array RGBA data.
+     */
+    setData(data) {
+        let imageData = this._context.createImageData(this._canvas.width, this._canvas.height);
+        imageData.data.set(data);
+        this._context.putImageData(imageData, 0, 0);
+    }
+    /**
+     * Resize canvas.
+     * @public
+     * @param {number} width - Width.
+     * @param {number} height - Height.
+     */
+    resize(width, height) {
+        this._canvas.width = width;
+        this._canvas.height = height;
+        this._context = this._canvas.getContext("2d");
+    }
+    /**
+     * 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.
+     */
+    drawImage(img, x, y, width, height) {
+        this._context.drawImage(img, x || 0, y || 0, width || img.width, height || img.height);
+    }
+    /**
+     * Converts canvas to JS image object.
+     * @public
+     * @returns {Image}
+     */
+    getImage() {
+        let img = new Image();
+        img.width = this.getWidth();
+        img.height = this.getHeight();
+        img.src = this._canvas.toDataURL("image/png");
+        return img;
+    }
+    /**
+     * Get measured text width.
+     * @public
+     * @param {string} text - Measured text.
+     * @returns {number}
+     */
+    getTextWidth(text) {
+        let metrics = this._context.measureText(text);
+        return Math.round(metrics.width);
+    }
+    /**
+     * 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.
+     */
+    drawText(text, x = 0, y = 14, font = "normal 14px Verdana", color = "black") {
+        this._context.fillStyle = color;
+        this._context.font = font;
+        this._context.fillText(text, x, y);
+    }
+    /**
+     * Gets canvas width.
+     * @public
+     * @returns {number}
+     */
+    getWidth() {
+        return this._canvas.width;
+    }
+    /**
+     * Gets canvas height.
+     * @public
+     * @returns {number}
+     */
+    getHeight() {
+        return this._canvas.height;
+    }
+    /**
+     * Load image to canvas.
+     * @public
+     * @param {string} url - Image url.
+     * @param {Function} [callback] - Image onload callback.
+     */
+    load(url, callback) {
+        let img = new Image();
+        let that = this;
+        img.onload = function () {
+            that.resize(img.width, img.height);
+            that._context.drawImage(img, 0, 0, img.width, img.height);
+            callback && callback(img);
+        };
+        img.src = url;
+    }
+    /**
+     * Open canvas image in the new window.
+     * @public
+     */
+    openImage() {
+        let img = this.getImage();
+        let dataUrl = img.src;
+        let windowContent = "<!DOCTYPE html>";
+        windowContent += "<html>";
+        windowContent += "<head><title>Print</title></head>";
+        windowContent += "<body>";
+        windowContent += '<img src="' + dataUrl + '">';
+        windowContent += "</body>";
+        windowContent += "</html>";
+        let printWin = window.open("", "", "width=" + img.width + "px ,height=" + img.height + "px");
+        if (printWin) {
+            printWin.document.open();
+            printWin.document.write(windowContent);
+            printWin.document.close();
+            printWin.focus();
+        }
+    }
+    destroy() {
+        this._canvas.width = 1;
+        this._canvas.height = 1;
+        //@ts-ignore
+        this._canvas = null;
+        //@ts-ignore
+        this._context = null;
+    }
+}
+export { ImageCanvas };

package/lib/js/Lock.d.ts

@@ -0,0 +1,15 @@
+declare class Lock {
+    protected _lock: number;
+    constructor();
+    lock(key: Key): void;
+    free(key: Key): void;
+    isFree(): boolean;
+    isLocked(): boolean;
+}
+declare class Key {
+    static __counter__: number;
+    protected __id: number;
+    constructor();
+    get id(): number;
+}
+export { Lock, Key };

package/lib/js/Lock.js

@@ -0,0 +1,27 @@
+class Lock {
+    constructor() {
+        this._lock = 0;
+    }
+    lock(key) {
+        this._lock |= (1 << key.id);
+    }
+    free(key) {
+        this._lock &= ~(1 << key.id);
+    }
+    isFree() {
+        return this._lock === 0;
+    }
+    isLocked() {
+        return this._lock !== 0;
+    }
+}
+class Key {
+    constructor() {
+        this.__id = Key.__counter__++;
+    }
+    get id() {
+        return this.__id;
+    }
+}
+Key.__counter__ = 0;
+export { Lock, Key };

package/lib/js/LonLat.d.ts

@@ -0,0 +1,128 @@
+import { NumberArray2 } from "./math/Vec2";
+import { NumberArray3 } from "./math/Vec3";
+/**
+ * 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 declare class LonLat {
+    /**
+     * Longitude.
+     * @public
+     * @type {number}
+     */
+    lon: number;
+    /**
+     * Latitude.
+     * @public
+     * @type {number}
+     */
+    lat: number;
+    /**
+     * Height.
+     * @public
+     * @type {number}
+     */
+    height: number;
+    constructor(lon?: number, lat?: number, height?: number);
+    /**
+     * Check zero coordinates
+     * @returns {boolean} -
+     */
+    isZero(): boolean;
+    /**
+     * 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: NumberArray2[] | NumberArray3[]): LonLat[];
+    /**
+     * Creates an object by coordinate array.
+     * @static
+     * @param {Array.<number>} arr - Coordinates array, where first is longitude, second is latitude and third is a height. (exactly 3 entries)
+     * @returns {LonLat} -
+     */
+    static createFromArray(arr: [number, number, number]): LonLat;
+    /**
+     * Create array from lonLat
+     * @param lonLat
+     * @returns {number[]}
+     */
+    static toArray(lonLat: LonLat): [number, number, number];
+    /**
+     * Create array from lonLat
+     * @returns {number[]}
+     */
+    toArray(): [number, number, number];
+    /**
+     * 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 degrees to mercator coordinates.
+     * @static
+     * @param {LonLat} lonLat - Input geodetic degree coordinates
+     * @param {LonLat} res - Output mercator coordinates
+     * @returns {LonLat} - Output mercator coordinates
+     */
+    static forwardMercatorRes(lonLat: LonLat, res: LonLat): 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;
+    /**
+     * Sets coordinates.
+     * @public
+     * @param {number} [lon] - Longitude.
+     * @param {number} [lat] - Latitude.
+     * @param {number} [height] - Height.
+     * @returns {LonLat} -
+     */
+    set(lon?: number, lat?: number, height?: number): LonLat;
+    /**
+     * Copy coordinates.
+     * @public
+     * @param {LonLat} [lonLat] - Coordinates to copy.
+     * @returns {LonLat} -
+     */
+    copy(lonLat: LonLat): LonLat;
+    /**
+     * Clone the coordinates.
+     * @public
+     * @returns {LonLat} -
+     */
+    clone(): LonLat;
+    /**
+     * Converts to mercator coordinates.
+     * @public
+     * @returns {LonLat} -
+     */
+    forwardMercator(): LonLat;
+    forwardMercatorEPS01(): LonLat;
+    /**
+     * Converts from mercator coordinates.
+     * @public
+     * @returns {LonLat} -
+     */
+    inverseMercator(): LonLat;
+    /**
+     * Compares coordinates.
+     * @public
+     * @param {LonLat} b - Coordinate to compare with.
+     * @returns {boolean} -
+     */
+    equal(b: LonLat): boolean;
+}

package/lib/js/LonLat.js

@@ -0,0 +1,192 @@
+import * as mercator from "./mercator";
+const HALF_PI = Math.PI * 0.5;
+const INV_PI_BY_180 = 180.0 / Math.PI;
+const INV_PI_BY_360 = INV_PI_BY_180 * 2.0;
+const PI_BY_360 = Math.PI / 360.0;
+const INV_PI_BY_180_HALF_PI = INV_PI_BY_180 * HALF_PI;
+/**
+ * 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 {
+    constructor(lon = 0, lat = 0, height = 0) {
+        /**
+         * Longitude.
+         * @public
+         * @type {number}
+         */
+        this.lon = 0;
+        /**
+         * Latitude.
+         * @public
+         * @type {number}
+         */
+        this.lat = 0;
+        /**
+         * Height.
+         * @public
+         * @type {number}
+         */
+        this.height = 0;
+        this.lon = lon;
+        this.lat = lat;
+        this.height = height;
+    }
+    /**
+     * Check zero coordinates
+     * @returns {boolean} -
+     */
+    isZero() {
+        return this.lon === 0.0 && this.lat === 0.0 && this.height === 0.0;
+    }
+    /**
+     * 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) {
+        let res = [];
+        for (let i = 0; i < arr.length; i++) {
+            let ai = arr[i];
+            res[i] = new LonLat(ai[0], ai[1], ai[2]);
+        }
+        return res;
+    }
+    /**
+     * Creates an object by coordinate array.
+     * @static
+     * @param {Array.<number>} arr - Coordinates array, where first is longitude, second is latitude and third is a height. (exactly 3 entries)
+     * @returns {LonLat} -
+     */
+    static createFromArray(arr) {
+        return new LonLat(arr[0], arr[1], arr[2]);
+    }
+    /**
+     * Create array from lonLat
+     * @param lonLat
+     * @returns {number[]}
+     */
+    static toArray(lonLat) {
+        return [lonLat.lon, lonLat.lat, lonLat.height];
+    }
+    /**
+     * Create array from lonLat
+     * @returns {number[]}
+     */
+    toArray() {
+        return LonLat.toArray(this);
+    }
+    /**
+     * 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, lat, height) {
+        return new LonLat(lon * mercator.POLE_BY_180, Math.log(Math.tan((90.0 + lat) * PI_BY_360)) * mercator.POLE_BY_PI, height);
+    }
+    /**
+     * Converts degrees to mercator coordinates.
+     * @static
+     * @param {LonLat} lonLat - Input geodetic degree coordinates
+     * @param {LonLat} res - Output mercator coordinates
+     * @returns {LonLat} - Output mercator coordinates
+     */
+    static forwardMercatorRes(lonLat, res) {
+        res.lon = lonLat.lon * mercator.POLE_BY_180;
+        res.lat = Math.log(Math.tan((90.0 + lonLat.lat) * PI_BY_360)) * mercator.POLE_BY_PI,
+            res.height = lonLat.height;
+        return res;
+    }
+    /**
+     * 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, y, height = 0) {
+        return new LonLat(x * mercator.INV_POLE_BY_180, INV_PI_BY_360 * Math.atan(Math.exp(y * mercator.PI_BY_POLE)) - INV_PI_BY_180_HALF_PI, height);
+    }
+    /**
+     * Sets coordinates.
+     * @public
+     * @param {number} [lon] - Longitude.
+     * @param {number} [lat] - Latitude.
+     * @param {number} [height] - Height.
+     * @returns {LonLat} -
+     */
+    set(lon = 0, lat = 0, height = 0) {
+        this.lon = lon;
+        this.lat = lat;
+        this.height = height;
+        return this;
+    }
+    /**
+     * Copy coordinates.
+     * @public
+     * @param {LonLat} [lonLat] - Coordinates to copy.
+     * @returns {LonLat} -
+     */
+    copy(lonLat) {
+        this.lon = lonLat.lon;
+        this.lat = lonLat.lat;
+        this.height = lonLat.height;
+        return this;
+    }
+    /**
+     * Clone the coordinates.
+     * @public
+     * @returns {LonLat} -
+     */
+    clone() {
+        return new LonLat(this.lon, this.lat, this.height);
+    }
+    /**
+     * Converts to mercator coordinates.
+     * @public
+     * @returns {LonLat} -
+     */
+    forwardMercator() {
+        return LonLat.forwardMercator(this.lon, this.lat, this.height);
+    }
+    forwardMercatorEPS01() {
+        let lat = this.lat;
+        if (lat > 89.9) {
+            lat = 89.9;
+        }
+        else if (lat < -89.9) {
+            lat = -89.9;
+        }
+        return new LonLat(this.lon * mercator.POLE_BY_180, Math.log(Math.tan((90.0 + lat) * PI_BY_360)) * mercator.POLE_BY_PI);
+    }
+    /**
+     * Converts from mercator coordinates.
+     * @public
+     * @returns {LonLat} -
+     */
+    inverseMercator() {
+        return LonLat.inverseMercator(this.lon, this.lat, this.height);
+    }
+    /**
+     * Compares coordinates.
+     * @public
+     * @param {LonLat} b - Coordinate to compare with.
+     * @returns {boolean} -
+     */
+    equal(b) {
+        if (b.height) {
+            return this.lon === b.lon && this.lat === b.lat && this.height === b.height;
+        }
+        else {
+            return this.lon === b.lon && this.lat === b.lat;
+        }
+    }
+}