@openglobus/og 0.17.2 → 0.18.1

package/lib/js/entity/Billboard.js

@@ -0,0 +1,127 @@
+import { BaseBillboard } from "./BaseBillboard";
+/**
+ * Represents basic quad billboard image.
+ * @class
+ * @extends {BaseBillboard}
+ * @param {Object} [options] - Options:
+ * @param {Vec3|Array.<number>} [options.position] - Billboard spatial position.
+ * @param {number} [options.rotation] - Screen angle rotation.
+ * @param {Vec4|string|Array.<number>} [options.color] - Billboard color.
+ * @param {Vec3|Array.<number>} [options.alignedAxis] - Billboard aligned vector.
+ * @param {Vec3|Array.<number>} [options.offset] - Billboard center screen offset.
+ * @param {boolean} [options.visibility] - Visibility.
+ * @param {string} [options.src] - Billboard image url source.
+ * @param {Image} [options.image] - Billboard image object.
+ * @param {number} [options.width] - Screen width.
+ * @param {number} [options.height] - Screen height.
+ * @param {number} [options.scale] - Billboard scale.
+ */
+class Billboard extends BaseBillboard {
+    constructor(options = {}) {
+        super(options);
+        this._handler = null;
+        this._src = options.src || null;
+        this._image = options.image || null;
+        this._scale = 1.0;
+        this._width = options.width || (options.size ? options.size[0] : 30);
+        this._height = options.height || (options.size ? options.size[1] : 30);
+    }
+    /**
+     * Sets billboard image url source.
+     * @public
+     * @param {string} src - Image url.
+     */
+    setSrc(src) {
+        this._src = src;
+        let bh = this._handler;
+        if (bh && src && src.length) {
+            let rn = bh._entityCollection.renderNode;
+            if (rn && rn.renderer) {
+                let ta = rn.renderer.billboardsTextureAtlas;
+                let that = this;
+                ta.loadImage(src, function (img) {
+                    if (img.__nodeIndex != undefined && ta.get(img.__nodeIndex)) {
+                        that._image = img;
+                        bh.setTexCoordArr(that._handlerIndex, ta.get(that._image.__nodeIndex).texCoords);
+                    }
+                    else {
+                        ta.addImage(img);
+                        ta.createTexture();
+                        that._image = img;
+                        rn.updateBillboardsTexCoords();
+                    }
+                });
+            }
+        }
+    }
+    getSrc() {
+        return this._src;
+    }
+    /**
+     * Sets image object.
+     * @public
+     * @param {Object} image - JavaScript image object.
+     */
+    setImage(image) {
+        this.setSrc(image.src);
+    }
+    getImage() {
+        return this._image;
+    }
+    /**
+     * Sets billboard screen size in pixels.
+     * @public
+     * @param {number} width - Billboard width.
+     * @param {number} height - Billboard height.
+     */
+    setSize(width, height) {
+        this._width = width;
+        this._height = height;
+        this._handler &&
+            this._handler.setSizeArr(this._handlerIndex, width * this._scale, height * this._scale);
+    }
+    /**
+     * Returns billboard screen size.
+     * @public
+     * @returns {Object}
+     */
+    getSize() {
+        return {
+            width: this._width,
+            height: this._height
+        };
+    }
+    /**
+     * Sets billboard screen width.
+     * @public
+     * @param {number} width - Width.
+     */
+    setWidth(width) {
+        this.setSize(width, this._height);
+    }
+    /**
+     * Gets billboard screen width.
+     * @public
+     * @returns {number}
+     */
+    getWidth() {
+        return this._width;
+    }
+    /**
+     * Sets billboard screen heigh.
+     * @public
+     * @param {number} height - Height.
+     */
+    setHeight(height) {
+        this.setSize(this._width, height);
+    }
+    /**
+     * Gets billboard screen height.
+     * @public
+     * @returns {number}
+     */
+    getHeight() {
+        return this._height;
+    }
+}
+export { Billboard };

package/lib/js/entity/BillboardHandler.d.ts

@@ -0,0 +1,15 @@
+import { BaseBillboardHandler } from "./BaseBillboardHandler";
+import { Billboard } from "./Billboard";
+import { EntityCollection } from "./EntityCollection";
+/**
+ * @class BillboardHandler
+ */
+declare class BillboardHandler extends BaseBillboardHandler {
+    protected _billboards: Billboard[];
+    constructor(props: EntityCollection);
+    add(billboard: Billboard): void;
+    protected _addBillboardToArrays(billboard: Billboard): void;
+    get billboards(): Billboard[];
+    refreshTexCoordsArr(): void;
+}
+export { BillboardHandler };

package/lib/js/entity/BillboardHandler.js

@@ -0,0 +1,103 @@
+import { BaseBillboardHandler } from "./BaseBillboardHandler";
+import { concatTypedArrays } from "../utils/shared";
+/**
+ * @class BillboardHandler
+ */
+class BillboardHandler extends BaseBillboardHandler {
+    constructor(props) {
+        super(props);
+        this._billboards = [];
+    }
+    add(billboard) {
+        if (billboard._handlerIndex == -1) {
+            super.add(billboard);
+            this._addBillboardToArrays(billboard);
+            this.refresh();
+            let src = billboard.getSrc() || (billboard.getImage() && billboard.getImage().src);
+            if (src) {
+                billboard.setSrc(src);
+            }
+        }
+    }
+    _addBillboardToArrays(billboard) {
+        if (billboard.getVisibility()) {
+            this._vertexArr = concatTypedArrays(this._vertexArr, [-0.5, 0.5, -0.5, -0.5, 0.5, -0.5, 0.5, -0.5, 0.5, 0.5, -0.5, 0.5]);
+        }
+        else {
+            this._vertexArr = concatTypedArrays(this._vertexArr, [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]);
+        }
+        this._texCoordArr = concatTypedArrays(this._texCoordArr, [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]);
+        let x = billboard._positionHigh.x, y = billboard._positionHigh.y, z = billboard._positionHigh.z, w;
+        this._positionHighArr = concatTypedArrays(this._positionHighArr, [
+            x, y, z,
+            x, y, z,
+            x, y, z,
+            x, y, z,
+            x, y, z,
+            x, y, z
+        ]);
+        x = billboard._positionLow.x;
+        y = billboard._positionLow.y;
+        z = billboard._positionLow.z;
+        this._positionLowArr = concatTypedArrays(this._positionLowArr, [
+            x, y, z,
+            x, y, z,
+            x, y, z,
+            x, y, z,
+            x, y, z,
+            x, y, z
+        ]);
+        x = billboard._width;
+        y = billboard._height;
+        this._sizeArr = concatTypedArrays(this._sizeArr, [x, y, x, y, x, y, x, y, x, y, x, y]);
+        x = billboard._offset.x;
+        y = billboard._offset.y;
+        z = billboard._offset.z;
+        this._offsetArr = concatTypedArrays(this._offsetArr, [
+            x, y, z,
+            x, y, z,
+            x, y, z,
+            x, y, z,
+            x, y, z,
+            x, y, z
+        ]);
+        x = billboard._color.x;
+        y = billboard._color.y;
+        z = billboard._color.z;
+        w = billboard._color.w;
+        this._rgbaArr = concatTypedArrays(this._rgbaArr, [
+            x, y, z, w,
+            x, y, z, w,
+            x, y, z, w,
+            x, y, z, w,
+            x, y, z, w,
+            x, y, z, w
+        ]);
+        x = billboard._rotation;
+        this._rotationArr = concatTypedArrays(this._rotationArr, [x, x, x, x, x, x]);
+        x = billboard._entity._pickingColor.x / 255;
+        y = billboard._entity._pickingColor.y / 255;
+        z = billboard._entity._pickingColor.z / 255;
+        this._pickingColorArr = concatTypedArrays(this._pickingColorArr, [x, y, z, x, y, z, x, y, z, x, y, z, x, y, z, x, y, z]);
+    }
+    get billboards() {
+        return this._billboards;
+    }
+    refreshTexCoordsArr() {
+        let bc = this._entityCollection;
+        if (bc && this._renderer) {
+            let ta = this._renderer.billboardsTextureAtlas;
+            for (let i = 0; i < this._billboards.length; i++) {
+                let bi = this._billboards[i];
+                let img = bi.getImage();
+                if (img) {
+                    let imageNode = ta.get(img.__nodeIndex);
+                    if (imageNode) {
+                        this.setTexCoordArr(bi._handlerIndex, imageNode.texCoords);
+                    }
+                }
+            }
+        }
+    }
+}
+export { BillboardHandler };

package/lib/js/entity/Entity.d.ts

@@ -0,0 +1,354 @@
+import { Billboard, IBillboardParams } from "./Billboard";
+import { EntityCollection, EntityCollectionEvents } from "./EntityCollection";
+import { Extent } from "../Extent";
+import { Geometry, IGeometryParams } from "./Geometry";
+import { GeoObject, IGeoObjectParams } from "./GeoObject";
+import { LonLat } from "../LonLat";
+import { Label, ILabelParams } from "./Label";
+import { NumberArray3, Vec3 } from "../math/Vec3";
+import { NumberArray2 } from "../math/Vec2";
+import { IPointCloudParams, PointCloud } from "./PointCloud";
+import { IPolylineParams, Polyline } from "./Polyline";
+import { IRayParams, Ray } from "./Ray";
+import { Strip } from "./Strip";
+import { Vector, VectorEventsType } from "../layer/Vector";
+import { EntityCollectionNode } from "../quadTree/EntityCollectionNode";
+export interface IEntityParams {
+    name?: string;
+    properties?: any;
+    cartesian?: Vec3 | NumberArray3;
+    lonlat?: LonLat | NumberArray3 | NumberArray2;
+    altitude?: number;
+    visibility?: boolean;
+    billboard?: Billboard | IBillboardParams;
+    label?: Label | ILabelParams;
+    polyline?: Polyline | IPolylineParams;
+    ray?: Ray | IRayParams;
+    pointCloud?: PointCloud | IPointCloudParams;
+    geometry?: Geometry | IGeometryParams;
+    geoObject?: GeoObject | IGeoObjectParams;
+    strip?: Strip;
+}
+/**
+ * Entity instances aggregate multiple forms of visualization into a single high-level object.
+ * They can be created manually and added to entity collection.
+ *
+ * @class
+ * @param {Object} [options] - Entity options:
+ * @param {string} [options.name] - A human-readable name to display to users. It does not have to be unique.
+ * @param {Vec3|Array.<number>} [options.cartesian] - Spatial entities like billboard, label etc. cartesian position.
+ * @param {LonLat} [options.lonlat] - Geodetic coordinates for an entities like billboard, label etc.
+ * @param {boolean} [options.aground] - True for entities that have to be placed on the relief.
+ * @param {boolean} [options.visibility] - Entity visibility.
+ * @param {*} [options.billboard] - Billboard options(see {@link Billboard}).
+ * @param {*} [options.label] - Label options(see {@link Label}).
+ * @param {*} [options.polyline] - Polyline options(see {@link Polyline}).
+ * @param {*} [options.ray] - Ray options(see {@link Ray}).
+ * @param {*} [options.pointCloud] - Point cloud options(see {@link PointCloud}).
+ * @param {*} [options.geometry] - Geometry options (see {@link Geometry}), available for vector layer only.
+ * @param {*} [options.properties] - Entity custom properties.
+ */
+declare class Entity {
+    static __counter__: number;
+    /**
+     * Uniq identifier.
+     * @public
+     * @readonly
+     */
+    protected __id: number;
+    /**
+     * Entity user defined properties.
+     * @public
+     * @type {Object}
+     */
+    properties: any;
+    /**
+     * Children entities.
+     * @public
+     * @type {Array.<Entity>}
+     */
+    childrenNodes: Entity[];
+    /**
+     * Parent entity.
+     * @public
+     * @type {Entity}
+     */
+    parent: Entity | null;
+    /**
+     * Entity cartesian position.
+     * @protected
+     * @type {Vec3}
+     */
+    _cartesian: Vec3;
+    /**
+     * Geodetic entity coordinates.
+     * @public
+     * @type {LonLat}
+     */
+    _lonLat: LonLat;
+    /**
+     * World Mercator entity coordinates.
+     * @public
+     * @type {LonLat}
+     */
+    _lonLatMerc: LonLat;
+    /**
+     * Entity visible terrain altitude.
+     * @public
+     * @type {number}
+     */
+    _altitude: number;
+    /**
+     * Visibility flag.
+     * @protected
+     * @type {boolean}
+     */
+    protected _visibility: boolean;
+    /**
+     * Entity collection that this entity belongs to.
+     * @public
+     * @type {EntityCollection}
+     */
+    _entityCollection: EntityCollection | null;
+    /**
+     * Entity collection array store index.
+     * @public
+     * @type {number}
+     */
+    _entityCollectionIndex: number;
+    /**
+     * Assigned vector layer pointer.
+     * @public
+     * @type {Vector}
+     */
+    _layer: Vector | null;
+    /**
+     * Assigned vector layer entity array index.
+     * @public
+     * @type {number}
+     */
+    _layerIndex: number;
+    /**
+     * Picking color.
+     * @public
+     * @type {Vec3}
+     */
+    _pickingColor: Vec3;
+    protected _featureConstructorArray: Record<string, [any, Function]>;
+    /**
+     * Billboard entity.
+     * @public
+     * @type {Billboard | null}
+     */
+    billboard: Billboard | null;
+    /**
+     * Text label entity.
+     * @public
+     * @type {Label | null}
+     */
+    label: Label | null;
+    /**
+     * Polyline entity.
+     * @public
+     * @type {Polyline | null}
+     */
+    polyline: Polyline | null;
+    /**
+     * Ray entity.
+     * @public
+     * @type {Ray | null}
+     */
+    ray: Ray | null;
+    /**
+     * PointCloud entity.
+     * @public
+     * @type {PointCloud | null}
+     */
+    pointCloud: PointCloud | null;
+    /**
+     * Geometry entity(available for vector layer only).
+     * @public
+     * @type {Geometry | null}
+     */
+    geometry: Geometry | null;
+    /**
+     * Geo object entity
+     * @public
+     * @type {Geometry | null}
+     */
+    geoObject: GeoObject | null;
+    /**
+     * Strip entity.
+     * @public
+     * @type {Strip | null}
+     */
+    strip: Strip | null;
+    _nodePtr?: EntityCollectionNode;
+    constructor(options?: IEntityParams);
+    get id(): number;
+    isEqual(entity: Entity): boolean;
+    get layerIndex(): number;
+    get instanceName(): string;
+    protected _createOptionFeature<T, K>(featureName: string, options?: T | K): T | null;
+    getCollectionIndex(): number;
+    /**
+     * Adds current entity into the specified entity collection.
+     * @public
+     * @param {EntityCollection | Vector} collection - Specified entity collection or vector layer.
+     * @param {Boolean} [rightNow=false] - Entity insertion option for vector layer.
+     * @returns {Entity} - This object.
+     */
+    addTo(collection: EntityCollection | Vector, rightNow?: boolean): this;
+    /**
+     * Removes current entity from collection and layer.
+     * @public
+     */
+    remove(): void;
+    /**
+     * Sets the entity visibility.
+     * @public
+     * @param {boolean} visibility - Entity visibility.
+     */
+    setVisibility(visibility: boolean): void;
+    /**
+     * Returns entity visibility.
+     * @public
+     * @returns {boolean} -
+     */
+    getVisibility(): boolean;
+    /**
+     * Sets entity cartesian position.
+     * @public
+     * @param {Vec3} cartesian - Cartesian position in 3d space.
+     */
+    setCartesian3v(cartesian: Vec3): void;
+    /**
+     * Sets entity cartesian position.
+     * @public
+     * @param {number} x - 3d space X - position.
+     * @param {number} y - 3d space Y - position.
+     * @param {number} z - 3d space Z - position.
+     */
+    setCartesian(x?: number, y?: number, z?: number): void;
+    /**
+     * Sets entity cartesian position without event dispatching.
+     * @public
+     * @param {Vec3} cartesian - Cartesian position in 3d space.
+     * @param {boolean} skipLonLat - skip geodetic calculation.
+     */
+    _setCartesian3vSilent(cartesian: Vec3, skipLonLat?: boolean): void;
+    /**
+     * Gets entity geodetic coordinates.
+     * @public
+     * @returns {LonLat} -
+     */
+    getLonLat(): LonLat;
+    /**
+     * Sets geodetic coordinates of the entity point object.
+     * @public
+     * @param {LonLat} lonlat - WGS84 coordinates.
+     */
+    setLonLat(lonlat: LonLat): void;
+    /**
+     * Sets geodetic coordinates of the entity point object.
+     * @public
+     * @param {number} lon - Longitude.
+     * @param {number} lat - Latitude
+     * @param {number} [height] - Height
+     */
+    setLonLat2(lon: number, lat: number, height?: number): void;
+    /**
+     * Sets entity altitude over the planet.
+     * @public
+     * @param {number} altitude - Altitude.
+     */
+    setAltitude(altitude: number): void;
+    /**
+     * Sets entity altitude over the planet.
+     * @public
+     * @return {number} Altitude.
+     */
+    getAltitude(): number;
+    /**
+     * Returns cartesian position.
+     * @public
+     * @returns {Vec3} -
+     */
+    getCartesian(): Vec3;
+    /**
+     * Sets entity billboard.
+     * @public
+     * @param {Billboard} billboard - Billboard object.
+     * @returns {Billboard} -
+     */
+    setBillboard(billboard: Billboard): Billboard;
+    /**
+     * Sets entity label.
+     * @public
+     * @param {Label} label - Text label.
+     * @returns {Label} -
+     */
+    setLabel(label: Label): Label;
+    /**
+     * Sets entity ray.
+     * @public
+     * @param {Ray} ray - Ray object.
+     * @returns {Ray} -
+     */
+    setRay(ray: Ray): Ray;
+    /**
+     * Sets entity polyline.
+     * @public
+     * @param {Polyline} polyline - Polyline object.
+     * @returns {Polyline} -
+     */
+    setPolyline(polyline: Polyline): Polyline;
+    /**
+     * Sets entity pointCloud.
+     * @public
+     * @param {PointCloud} pointCloud - PointCloud object.
+     * @returns {PointCloud} -
+     */
+    setPointCloud(pointCloud: PointCloud): PointCloud;
+    /**
+     * Sets entity geometry.
+     * @public
+     * @param {Geometry} geometry - Geometry object.
+     * @returns {Geometry} -
+     */
+    setGeometry(geometry: Geometry): Geometry;
+    /**
+     * Sets entity geoObject.
+     * @public
+     * @param {GeoObject} geoObject - GeoObject.
+     * @returns {GeoObject} -
+     */
+    setGeoObject(geoObject: GeoObject): GeoObject;
+    /**
+     * Sets entity strip.
+     * @public
+     * @param {Strip} strip - Strip object.
+     * @returns {Strip} -
+     */
+    setStrip(strip: Strip): Strip;
+    get layer(): Vector | null;
+    get rendererEvents(): VectorEventsType | EntityCollectionEvents | null;
+    /**
+     * Append child entity.
+     * @public
+     * @param {Entity} entity - Child entity.
+     */
+    appendChild(entity: Entity): void;
+    /**
+     * Appends entity items(billboard, label etc.) picking color.
+     * @public
+     */
+    setPickingColor(): void;
+    /**
+     * Return geodetic extent.
+     * @public
+     * @returns {Extent} -
+     */
+    getExtent(): Extent;
+}
+export { Entity };