@openglobus/og 0.11.8 → 0.12.0

package/src/og/entity/Entity.js

@@ -1,742 +1,742 @@
-/**
- * @module og/entity/Entity
- */
-
-"use strict";
-
-import * as mercator from "../mercator.js";
-import * as utils from "../utils/shared.js";
-import { Billboard } from "./Billboard.js";
-import { Strip } from "./Strip.js";
-import { Extent } from "../Extent.js";
-import { Geometry } from "./Geometry.js";
-import { Label } from "./Label.js";
-import { LonLat } from "../LonLat.js";
-import { Polyline } from "./Polyline.js";
-import { Ray } from "./Ray.js";
-import { PointCloud } from "./PointCloud.js";
-import { Sphere } from "../shapes/Sphere.js";
-import { Vec3 } from "../math/Vec3.js";
-import { GeoObject } from "./GeoObject.js";
-
-/**
- * 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, sphere etc. cartesian position.
- * @param {LonLat} [options.lonlat] - Geodetic coordiantes for an entities like billboard, label, sphere 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 og.Billboard}).
- * @param {*} [options.label] - Label options(see {@link og.Label}).
- * @param {*} [options.sphere] - Sphere options(see {@link og.shape.Sphere}).
- * @param {*} [options.box] - Sphere options(see {@link og.shape.Box}).
- * @param {*} [options.polyline] - Polyline options(see {@link og.Polyline}).
- * @param {*} [options.ray] - Ray options(see {@link og.Ray}).
- * @param {*} [options.pointCloud] - Point cloud options(see {@link og.PointCloud}).
- * @param {*} [options.geometry] - Geometry options (see {@link og.Geometry}), available for vector layer only.
- * @param {*} [options.properties] - Entity custom properties.
- */
-class Entity {
-    constructor(options) {
-        options = options || {};
-
-        options.properties = options.properties || {};
-
-        /**
-         * Unic identifier.
-         * @public
-         * @readonly
-         */
-        this.id = Entity._staticCounter++;
-
-        /**
-         * Entity user defined properties.
-         * @public
-         * @type {Object}
-         */
-        this.properties = options.properties || {};
-
-        /**
-         * Entity name.
-         * @public
-         * @type {string}
-         */
-        this.properties.name = this.properties.name || options.name || "";
-
-        /**
-         * Children entities.
-         * @public
-         * @type {Array.<Entity>}
-         */
-        this.childrenNodes = [];
-
-        /**
-         * Parent entity.
-         * @public
-         * @type {Entity}
-         */
-        this.parent = null;
-
-        /**
-         * Entity cartesian position.
-         * @protected
-         * @type {Vec3}
-         */
-        this._cartesian = utils.createVector3(options.cartesian);
-
-        /**
-         * Geodetic entity coordiantes.
-         * @protected
-         * @type {LonLat}
-         */
-        this._lonlat = utils.createLonLat(options.lonlat);
-
-        /**
-         * World Mercator entity coordinates.
-         * @protected
-         * @type {LonLat}
-         */
-        this._lonlatMerc = null;
-
-        /**
-         * Entity visible terrain altitude.
-         * @protected
-         * @type {number}
-         */
-        this._altitude = options.altitude || 0.0;
-
-        /**
-         * Visibility flag.
-         * @protected
-         * @type {boolean}
-         */
-        this._visibility = options.visibility != undefined ? options.visibility : true;
-
-        /**
-         * Entity collection that this entity belongs to.
-         * @protected
-         * @type {EntityCollection}
-         */
-        this._entityCollection = null;
-
-        /**
-         * Entity collection array store index.
-         * @protected
-         * @type {number}
-         */
-        this._entityCollectionIndex = -1;
-
-        /**
-         * Assigned vector layer pointer.
-         * @protected
-         * @type {layer.Vector}
-         */
-        this._layer = null;
-
-        /**
-         * Assigned vector layer entity array index.
-         * @protected
-         * @type {number}
-         */
-        this._layerIndex = -1;
-
-        /**
-         * Picking color.
-         * @protected
-         * @type {Vec3}
-         */
-        this._pickingColor = new Vec3(0, 0, 0);
-
-        this._featureConstructorArray = {
-            billboard: [Billboard, this.setBillboard],
-            label: [Label, this.setLabel],
-            sphere: [Sphere, this.setShape],
-            // box: [Box, this.setShape],
-            polyline: [Polyline, this.setPolyline],
-            pointCloud: [PointCloud, this.setPointCloud],
-            geometry: [Geometry, this.setGeometry],
-            geoObject: [GeoObject, this.setGeoObject],
-            strip: [Strip, this.setStrip],
-            ray: [Ray, this.setRay]
-        };
-
-        /**
-         * Billboard entity.
-         * @public
-         * @type {Billboard}
-         */
-        this.billboard = this._createOptionFeature("billboard", options.billboard);
-
-        /**
-         * Text label entity.
-         * @public
-         * @type {Label}
-         */
-        this.label = this._createOptionFeature("label", options.label);
-
-        /**
-         * Shape entity.
-         * @public
-         * @type {shape.BaseShape}
-         */
-        this.shape = this._createOptionFeature("sphere", options.sphere || options.box);
-
-        /**
-         * Polyline entity.
-         * @public
-         * @type {Polyline}
-         */
-        this.polyline = this._createOptionFeature("polyline", options.polyline);
-
-        /**
-         * Ray entity.
-         * @public
-         * @type {ray}
-         */
-        this.ray = this._createOptionFeature("ray", options.ray);
-
-        /**
-         * PointCloud entity.
-         * @public
-         * @type {PointCloud}
-         */
-        this.pointCloud = this._createOptionFeature("pointCloud", options.pointCloud);
-
-        /**
-         * Geometry entity(available for vector layer only).
-         * @public
-         * @type {Geometry}
-         */
-        this.geometry = this._createOptionFeature("geometry", options.geometry);
-
-        /**
-         * Geo object entity
-         * @public
-         * @type {og.Geometry}
-         */
-        this.geoObject = this._createOptionFeature("geoObject", options.geoObject);
-
-        /**
-         * Strip entity.
-         * @public
-         * @type {Strip}
-         */
-        this.strip = this._createOptionFeature("strip", options.strip);
-    }
-
-    static get _staticCounter() {
-        if (!this._counter && this._counter !== 0) {
-            this._counter = 0;
-        }
-        return this._counter;
-    }
-
-    static set _staticCounter(n) {
-        this._counter = n;
-    }
-
-    get instanceName() {
-        return "Entity";
-    }
-
-    _createOptionFeature(featureName, options) {
-        if (options) {
-            var c = this._featureConstructorArray[featureName];
-            return c[1].call(this, new c[0](options));
-        }
-        return null;
-    }
-
-    getCollectionIndex() {
-        return this._entityCollectionIndex;
-    }
-
-    /**
-     * 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, rightNow) {
-        collection.add(this, rightNow);
-        return this;
-    }
-
-    /**
-     * Removes current entity from collection and layer.
-     * @public
-     */
-    remove() {
-        this._layer && this._layer.removeEntity(this);
-        this._entityCollection && this._entityCollection.removeEntity(this);
-    }
-
-    /**
-     * Sets the entity visibility.
-     * @public
-     * @param {boolean} visibility - Entity visibility.
-     */
-    setVisibility(visibility) {
-        this._visibility = visibility;
-
-        // billboards
-        this.billboard && this.billboard.setVisibility(visibility);
-
-        // billboards
-        this.geoObject && this.geoObject.setVisibility(visibility);
-
-        // labels
-        this.label && this.label.setVisibility(visibility);
-
-        // shape
-        this.shape && this.shape.setVisibility(visibility);
-
-        // polyline
-        this.polyline && this.polyline.setVisibility(visibility);
-
-        // ray
-        this.ray && this.ray.setVisibility(visibility);
-
-        // geometry
-        this.geometry && this.geometry.setVisibility(visibility);
-
-        for (var i = 0; i < this.childrenNodes.length; i++) {
-            this.childrenNodes[i].setVisibility(visibility);
-        }
-    }
-
-    /**
-     * Returns entity visibility.
-     * @public
-     * @returns {boolean} -
-     */
-    getVisibility() {
-        return this._visibility;
-    }
-
-    /**
-     * Sets entity cartesian position.
-     * @public
-     * @param {Vec3} cartesian - Cartesian position in 3d space.
-     */
-    setCartesian3v(cartesian) {
-        this.setCartesian(cartesian.x, cartesian.y, cartesian.z);
-    }
-
-    /**
-     * 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, y, z) {
-        var p = this._cartesian;
-
-        p.x = x;
-        p.y = y;
-        p.z = z;
-
-        // billboards
-        this.billboard && this.billboard.setPosition3v(p);
-
-        // geoObject
-        this.geoObject && this.geoObject.setPosition3v(p);
-
-        // labels
-        this.label && this.label.setPosition3v(p);
-
-        // shape
-        this.shape && this.shape.setPosition3v(p);
-
-        for (var i = 0; i < this.childrenNodes.length; i++) {
-            this.childrenNodes[i].setCartesian(x, y, z);
-        }
-
-        var ec = this._entityCollection;
-
-        if (ec && ec.renderNode && ec.renderNode.ellipsoid) {
-            this._lonlat = ec.renderNode.ellipsoid.cartesianToLonLat(p);
-
-            if (Math.abs(this._lonlat.lat) < mercator.MAX_LAT) {
-                this._lonlatMerc = this._lonlat.forwardMercator();
-            } else {
-                this._lonlatMerc = null;
-            }
-        }
-
-        ec && ec.events.dispatch(ec.events.entitymove, this);
-    }
-
-    /**
-     * Sets entity cartesian position without event dispatching.
-     * @protected
-     * @param {Vec3} cartesian - Cartesian position in 3d space.
-     * @param {boolean} skipLonLat - skip geodetic calculation.
-     */
-    _setCartesian3vSilent(cartesian, skipLonLat) {
-        var p = this._cartesian;
-
-        p.x = cartesian.x;
-        p.y = cartesian.y;
-        p.z = cartesian.z;
-
-        // billboards
-        this.billboard && this.billboard.setPosition3v(p);
-
-        // geoObject
-        this.geoObject && this.geoObject.setPosition3v(p);
-
-        // labels
-        this.label && this.label.setPosition3v(p);
-
-        // shape
-        this.shape && this.shape.setPosition3v(p);
-
-        for (var i = 0; i < this.childrenNodes.length; i++) {
-            this.childrenNodes[i].setCartesian(p.x, p.y, p.z);
-        }
-
-        var ec = this._entityCollection;
-
-        if (!skipLonLat && ec && ec.renderNode && ec.renderNode.ellipsoid) {
-            this._lonlat = ec.renderNode.ellipsoid.cartesianToLonLat(p);
-
-            if (Math.abs(this._lonlat.lat) < mercator.MAX_LAT) {
-                this._lonlatMerc = this._lonlat.forwardMercator();
-            } else {
-                this._lonlatMerc = null;
-            }
-        }
-    }
-
-    /**
-     * Gets entity geodetic coordinates.
-     * @public
-     * @returns {LonLat} -
-     */
-    getLonLat() {
-        return this._lonlat.clone();
-    }
-
-    /**
-     * Sets geodetic coordinates of the entity point object.
-     * @public
-     * @param {LonLat} lonlat - WGS84 coordinates.
-     */
-    setLonLat(lonlat) {
-        var l = this._lonlat;
-
-        l.lon = lonlat.lon;
-        l.lat = lonlat.lat;
-        l.height = lonlat.height;
-
-        var ec = this._entityCollection;
-        if (ec && ec.renderNode && ec.renderNode.ellipsoid) {
-            if (Math.abs(lonlat.lat) < mercator.MAX_LAT) {
-                this._lonlatMerc = lonlat.forwardMercator();
-            } else {
-                this._lonlatMerc = null;
-            }
-
-            ec.renderNode.ellipsoid.lonLatToCartesianRes(lonlat, this._cartesian);
-            this.setCartesian3v(this._cartesian);
-        }
-    }
-
-    /**
-     * Sets entity altitude over the planet.
-     * @public
-     * @param {number} altitude - Altitude.
-     */
-    setAltitude(altitude) {
-        this._altitude = altitude;
-    }
-
-    /**
-     * Sets entity altitude over the planet.
-     * @public
-     * @return {number} Altitude.
-     */
-    getAltitude() {
-        return this._altitude;
-    }
-
-    /**
-     * Returns carteain position.
-     * @public
-     * @returns {Vec3} -
-     */
-    getCartesian() {
-        return this._cartesian.clone();
-    }
-
-    /**
-     * Sets entity billboard.
-     * @public
-     * @param {Billboard} billboard - Billboard object.
-     * @returns {Billboard} -
-     */
-    setBillboard(billboard) {
-        if (this.billboard) {
-            this.billboard.remove();
-        }
-        this.billboard = billboard;
-        this.billboard._entity = this;
-        this.billboard.setPosition3v(this._cartesian);
-        this.billboard.setVisibility(this._visibility);
-        this._entityCollection && this._entityCollection._billboardHandler.add(billboard);
-        return billboard;
-    }
-
-    /**
-     * Sets entity label.
-     * @public
-     * @param {Label} label - Text label.
-     * @returns {Label} -
-     */
-    setLabel(label) {
-        if (this.label) {
-            this.label.remove();
-        }
-        this.label = label;
-        this.label._entity = this;
-        this.label.setPosition3v(this._cartesian);
-        this.label.setVisibility(this._visibility);
-        this._entityCollection && this._entityCollection._labelHandler.add(label);
-        return label;
-    }
-
-    /**
-     * Sets entity ray.
-     * @public
-     * @param {Ray} ray - Ray object.
-     * @returns {Ray} -
-     */
-    setRay(ray) {
-        if (this.ray) {
-            this.ray.remove();
-        }
-        this.ray = ray;
-        this.ray._entity = this;
-        this.ray.setVisibility(this._visibility);
-        this._entityCollection && this._entityCollection._rayHandler.add(ray);
-        return ray;
-    }
-
-    /**
-     * Sets entity shape.
-     * @public
-     * @param {BaseShape} shape - Shape object.
-     * @returns {Polyline} -
-     */
-    setShape(shape) {
-        if (this.shape) {
-            this.shape.remove();
-        }
-        this.shape = shape;
-        this.shape._entity = this;
-        this.shape.setPosition3v(this._cartesian);
-        this.shape.setVisibility(this._visibility);
-        this._entityCollection && this._entityCollection._shapeHandler.add(shape);
-        return shape;
-    }
-
-    /**
-     * Sets entity polyline.
-     * @public
-     * @param {Polyline} polyline - Polyline object.
-     * @returns {Polyline} -
-     */
-    setPolyline(polyline) {
-        if (this.polyline) {
-            this.polyline.remove();
-        }
-        this.polyline = polyline;
-        this.polyline._entity = this;
-        this.polyline.setVisibility(this._visibility);
-        this._entityCollection && this._entityCollection._polylineHandler.add(polyline);
-        return polyline;
-    }
-
-    /**
-     * Sets entity pointCloud.
-     * @public
-     * @param {PointCloud} pointCloud - PointCloud object.
-     * @returns {PointCloud} -
-     */
-    setPointCloud(pointCloud) {
-        if (this.pointCloud) {
-            this.pointCloud.remove();
-        }
-        this.pointCloud = pointCloud;
-        this.pointCloud._entity = this;
-        this.pointCloud.setVisibility(this._visibility);
-        this._entityCollection && this._entityCollection._pointCloudHandler.add(pointCloud);
-        return pointCloud;
-    }
-
-    /**
-     * Sets entity geometry.
-     * @public
-     * @param {Geometry} geometry - Geometry object.
-     * @returns {Geometry} -
-     */
-    setGeometry(geometry) {
-        if (this.geometry) {
-            this.geometry.remove();
-        }
-        this.geometry = geometry;
-        this.geometry._entity = this;
-        this.geometry.setVisibility(this._visibility);
-        this._layer && this._layer.add(this);
-        return geometry;
-    }
-
-    /**
-     * Sets entity geoObject.
-     * @public
-     * @param {GeoObject} geoObject - GeoObject.
-     * @returns {GeoObject} -
-     */
-    setGeoObject(geoObject) {
-        if (this.geoObject) {
-            this.geoObject.remove();
-        }
-        this.geoObject = geoObject;
-        this.geoObject._entity = this;
-        this.geoObject.setPosition3v(this._cartesian);
-        this.geoObject.setVisibility(this._visibility);
-        this._entityCollection && this._entityCollection._geoObjectHandler.add(geoObject);
-        return geoObject;
-    }
-
-    /**
-     * Sets entity strip.
-     * @public
-     * @param {Strip} strip - Strip object.
-     * @returns {Strip} -
-     */
-    setStrip(strip) {
-        if (this.strip) {
-            this.strip.remove();
-        }
-        this.strip = strip;
-        this.strip._entity = this;
-        this.strip.setVisibility(this._visibility);
-        this._entityCollection && this._entityCollection._stripHandler.add(strip);
-        return strip;
-    }
-
-    get layer() {
-        return this._layer;
-    }
-
-    get rendererEvents() {
-        if (this._layer) {
-            return this._layer.events;
-        } else if (this._entityCollection) {
-            return this._entityCollection.events;
-        }
-        return null;
-    }
-
-    /**
-     * Append child entity.
-     * @public
-     * @param {Entity} entity - Child entity.
-     */
-    appendChild(entity) {
-        entity._entityCollection = this._entityCollection;
-        entity._pickingColor = this._pickingColor;
-        entity.parent = this;
-        this.childrenNodes.push(entity);
-        this._entityCollection && this._entityCollection._addRecursively(entity);
-    }
-
-    /**
-     * Appends entity items(billboard, label etc.) picking color.
-     * @public
-     */
-    setPickingColor() {
-        var c = this._pickingColor;
-
-        // billboard
-        this.billboard && this.billboard.setPickingColor3v(c);
-
-        // label
-        this.label && this.label.setPickingColor3v(c);
-
-        // shape
-        this.shape && this.shape.setPickingColor3v(c);
-
-        // polyline
-        this.polyline && this.polyline.setPickingColor3v(c);
-
-        // ray
-        this.ray && this.ray.setPickingColor3v(c);
-
-        // strip
-        this.strip && this.strip.setPickingColor3v(c);
-
-        // billboard
-        this.geoObject && this.geoObject.setPickingColor3v(c);
-        for (var i = 0; i < this.childrenNodes.length; i++) {
-            this.childrenNodes[i].setPickingColor();
-        }
-    }
-
-    /**
-     * Return geodethic extent.
-     * @returns {Extent} -
-     */
-    getExtent() {
-        var res;
-        var c = this._lonlat;
-        if (this.billboard || this.label) {
-            res = new Extent(new LonLat(c.lon, c.lat), new LonLat(c.lon, c.lat));
-        } else {
-            res = new Extent(new LonLat(180.0, 90.0), new LonLat(-180.0, -90.0));
-        }
-
-        var sw = res.southWest,
-            ne = res.northEast;
-
-        if (this.polyline) {
-            let e = this.polyline.getExtent();
-            if (e.southWest.lon < sw.lon) sw.lon = e.southWest.lon;
-            if (e.southWest.lat < sw.lat) sw.lat = e.southWest.lat;
-            if (e.northEast.lon > ne.lon) ne.lon = e.northEast.lon;
-            if (e.northEast.lat > ne.lat) ne.lat = e.northEast.lat;
-        }
-
-        if (this.geometry) {
-            let e = this.geometry.getExtent();
-            if (e.southWest.lon < sw.lon) sw.lon = e.southWest.lon;
-            if (e.southWest.lat < sw.lat) sw.lat = e.southWest.lat;
-            if (e.northEast.lon > ne.lon) ne.lon = e.northEast.lon;
-            if (e.northEast.lat > ne.lat) ne.lat = e.northEast.lat;
-        }
-
-        for (var i = 0; i < this.childrenNodes.length; i++) {
-            let e = this.childrenNodes[i].getExtent();
-            if (e.southWest.lon < sw.lon) sw.lon = e.southWest.lon;
-            if (e.southWest.lat < sw.lat) sw.lat = e.southWest.lat;
-            if (e.northEast.lon > ne.lon) ne.lon = e.northEast.lon;
-            if (e.northEast.lat > ne.lat) ne.lat = e.northEast.lat;
-        }
-
-        return res;
-    }
-
-    isEqual(entity) {
-        return this.id === entity.id;
-    }
-}
-
-export { Entity };
+/**
+ * @module og/entity/Entity
+ */
+
+"use strict";
+
+import * as mercator from "../mercator.js";
+import * as utils from "../utils/shared.js";
+import { Billboard } from "./Billboard.js";
+import { Strip } from "./Strip.js";
+import { Extent } from "../Extent.js";
+import { Geometry } from "./Geometry.js";
+import { Label } from "./Label.js";
+import { LonLat } from "../LonLat.js";
+import { Polyline } from "./Polyline.js";
+import { Ray } from "./Ray.js";
+import { PointCloud } from "./PointCloud.js";
+import { Sphere } from "../shapes/Sphere.js";
+import { Vec3 } from "../math/Vec3.js";
+import { GeoObject } from "./GeoObject.js";
+
+/**
+ * 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, sphere etc. cartesian position.
+ * @param {LonLat} [options.lonlat] - Geodetic coordiantes for an entities like billboard, label, sphere 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 og.Billboard}).
+ * @param {*} [options.label] - Label options(see {@link og.Label}).
+ * @param {*} [options.sphere] - Sphere options(see {@link og.shape.Sphere}).
+ * @param {*} [options.box] - Sphere options(see {@link og.shape.Box}).
+ * @param {*} [options.polyline] - Polyline options(see {@link og.Polyline}).
+ * @param {*} [options.ray] - Ray options(see {@link og.Ray}).
+ * @param {*} [options.pointCloud] - Point cloud options(see {@link og.PointCloud}).
+ * @param {*} [options.geometry] - Geometry options (see {@link og.Geometry}), available for vector layer only.
+ * @param {*} [options.properties] - Entity custom properties.
+ */
+class Entity {
+    constructor(options) {
+        options = options || {};
+
+        options.properties = options.properties || {};
+
+        /**
+         * Unic identifier.
+         * @public
+         * @readonly
+         */
+        this.id = Entity._staticCounter++;
+
+        /**
+         * Entity user defined properties.
+         * @public
+         * @type {Object}
+         */
+        this.properties = options.properties || {};
+
+        /**
+         * Entity name.
+         * @public
+         * @type {string}
+         */
+        this.properties.name = this.properties.name || options.name || "";
+
+        /**
+         * Children entities.
+         * @public
+         * @type {Array.<Entity>}
+         */
+        this.childrenNodes = [];
+
+        /**
+         * Parent entity.
+         * @public
+         * @type {Entity}
+         */
+        this.parent = null;
+
+        /**
+         * Entity cartesian position.
+         * @protected
+         * @type {Vec3}
+         */
+        this._cartesian = utils.createVector3(options.cartesian);
+
+        /**
+         * Geodetic entity coordiantes.
+         * @protected
+         * @type {LonLat}
+         */
+        this._lonlat = utils.createLonLat(options.lonlat);
+
+        /**
+         * World Mercator entity coordinates.
+         * @protected
+         * @type {LonLat}
+         */
+        this._lonlatMerc = null;
+
+        /**
+         * Entity visible terrain altitude.
+         * @protected
+         * @type {number}
+         */
+        this._altitude = options.altitude || 0.0;
+
+        /**
+         * Visibility flag.
+         * @protected
+         * @type {boolean}
+         */
+        this._visibility = options.visibility != undefined ? options.visibility : true;
+
+        /**
+         * Entity collection that this entity belongs to.
+         * @protected
+         * @type {EntityCollection}
+         */
+        this._entityCollection = null;
+
+        /**
+         * Entity collection array store index.
+         * @protected
+         * @type {number}
+         */
+        this._entityCollectionIndex = -1;
+
+        /**
+         * Assigned vector layer pointer.
+         * @protected
+         * @type {layer.Vector}
+         */
+        this._layer = null;
+
+        /**
+         * Assigned vector layer entity array index.
+         * @protected
+         * @type {number}
+         */
+        this._layerIndex = -1;
+
+        /**
+         * Picking color.
+         * @protected
+         * @type {Vec3}
+         */
+        this._pickingColor = new Vec3(0, 0, 0);
+
+        this._featureConstructorArray = {
+            billboard: [Billboard, this.setBillboard],
+            label: [Label, this.setLabel],
+            sphere: [Sphere, this.setShape],
+            // box: [Box, this.setShape],
+            polyline: [Polyline, this.setPolyline],
+            pointCloud: [PointCloud, this.setPointCloud],
+            geometry: [Geometry, this.setGeometry],
+            geoObject: [GeoObject, this.setGeoObject],
+            strip: [Strip, this.setStrip],
+            ray: [Ray, this.setRay]
+        };
+
+        /**
+         * Billboard entity.
+         * @public
+         * @type {Billboard}
+         */
+        this.billboard = this._createOptionFeature("billboard", options.billboard);
+
+        /**
+         * Text label entity.
+         * @public
+         * @type {Label}
+         */
+        this.label = this._createOptionFeature("label", options.label);
+
+        /**
+         * Shape entity.
+         * @public
+         * @type {shape.BaseShape}
+         */
+        this.shape = this._createOptionFeature("sphere", options.sphere || options.box);
+
+        /**
+         * Polyline entity.
+         * @public
+         * @type {Polyline}
+         */
+        this.polyline = this._createOptionFeature("polyline", options.polyline);
+
+        /**
+         * Ray entity.
+         * @public
+         * @type {ray}
+         */
+        this.ray = this._createOptionFeature("ray", options.ray);
+
+        /**
+         * PointCloud entity.
+         * @public
+         * @type {PointCloud}
+         */
+        this.pointCloud = this._createOptionFeature("pointCloud", options.pointCloud);
+
+        /**
+         * Geometry entity(available for vector layer only).
+         * @public
+         * @type {Geometry}
+         */
+        this.geometry = this._createOptionFeature("geometry", options.geometry);
+
+        /**
+         * Geo object entity
+         * @public
+         * @type {og.Geometry}
+         */
+        this.geoObject = this._createOptionFeature("geoObject", options.geoObject);
+
+        /**
+         * Strip entity.
+         * @public
+         * @type {Strip}
+         */
+        this.strip = this._createOptionFeature("strip", options.strip);
+    }
+
+    static get _staticCounter() {
+        if (!this._counter && this._counter !== 0) {
+            this._counter = 0;
+        }
+        return this._counter;
+    }
+
+    static set _staticCounter(n) {
+        this._counter = n;
+    }
+
+    get instanceName() {
+        return "Entity";
+    }
+
+    _createOptionFeature(featureName, options) {
+        if (options) {
+            let c = this._featureConstructorArray[featureName];
+            return c[1].call(this, new c[0](options));
+        }
+        return null;
+    }
+
+    getCollectionIndex() {
+        return this._entityCollectionIndex;
+    }
+
+    /**
+     * 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, rightNow) {
+        collection.add(this, rightNow);
+        return this;
+    }
+
+    /**
+     * Removes current entity from collection and layer.
+     * @public
+     */
+    remove() {
+        this._layer && this._layer.removeEntity(this);
+        this._entityCollection && this._entityCollection.removeEntity(this);
+    }
+
+    /**
+     * Sets the entity visibility.
+     * @public
+     * @param {boolean} visibility - Entity visibility.
+     */
+    setVisibility(visibility) {
+        this._visibility = visibility;
+
+        // billboards
+        this.billboard && this.billboard.setVisibility(visibility);
+
+        // geoObject
+        this.geoObject && this.geoObject.setVisibility(visibility);
+
+        // labels
+        this.label && this.label.setVisibility(visibility);
+
+        // shape
+        this.shape && this.shape.setVisibility(visibility);
+
+        // polyline
+        this.polyline && this.polyline.setVisibility(visibility);
+
+        // ray
+        this.ray && this.ray.setVisibility(visibility);
+
+        // geometry
+        this.geometry && this.geometry.setVisibility(visibility);
+
+        for (let i = 0; i < this.childrenNodes.length; i++) {
+            this.childrenNodes[i].setVisibility(visibility);
+        }
+    }
+
+    /**
+     * Returns entity visibility.
+     * @public
+     * @returns {boolean} -
+     */
+    getVisibility() {
+        return this._visibility;
+    }
+
+    /**
+     * Sets entity cartesian position.
+     * @public
+     * @param {Vec3} cartesian - Cartesian position in 3d space.
+     */
+    setCartesian3v(cartesian) {
+        this.setCartesian(cartesian.x, cartesian.y, cartesian.z);
+    }
+
+    /**
+     * 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, y, z) {
+        let p = this._cartesian;
+
+        p.x = x;
+        p.y = y;
+        p.z = z;
+
+        // billboards
+        this.billboard && this.billboard.setPosition3v(p);
+
+        // geoObject
+        this.geoObject && this.geoObject.setPosition3v(p);
+
+        // labels
+        this.label && this.label.setPosition3v(p);
+
+        // shape
+        this.shape && this.shape.setPosition3v(p);
+
+        for (let i = 0; i < this.childrenNodes.length; i++) {
+            this.childrenNodes[i].setCartesian(x, y, z);
+        }
+
+        let ec = this._entityCollection;
+
+        if (ec && ec.renderNode && ec.renderNode.ellipsoid) {
+            this._lonlat = ec.renderNode.ellipsoid.cartesianToLonLat(p);
+
+            if (Math.abs(this._lonlat.lat) < mercator.MAX_LAT) {
+                this._lonlatMerc = this._lonlat.forwardMercator();
+            } else {
+                this._lonlatMerc = null;
+            }
+        }
+
+        ec && ec.events.dispatch(ec.events.entitymove, this);
+    }
+
+    /**
+     * Sets entity cartesian position without event dispatching.
+     * @protected
+     * @param {Vec3} cartesian - Cartesian position in 3d space.
+     * @param {boolean} skipLonLat - skip geodetic calculation.
+     */
+    _setCartesian3vSilent(cartesian, skipLonLat) {
+        let p = this._cartesian;
+
+        p.x = cartesian.x;
+        p.y = cartesian.y;
+        p.z = cartesian.z;
+
+        // billboards
+        this.billboard && this.billboard.setPosition3v(p);
+
+        // geoObject
+        this.geoObject && this.geoObject.setPosition3v(p);
+
+        // labels
+        this.label && this.label.setPosition3v(p);
+
+        // shape
+        this.shape && this.shape.setPosition3v(p);
+
+        for (let i = 0; i < this.childrenNodes.length; i++) {
+            this.childrenNodes[i].setCartesian(p.x, p.y, p.z);
+        }
+
+        let ec = this._entityCollection;
+
+        if (!skipLonLat && ec && ec.renderNode && ec.renderNode.ellipsoid) {
+            this._lonlat = ec.renderNode.ellipsoid.cartesianToLonLat(p);
+
+            if (Math.abs(this._lonlat.lat) < mercator.MAX_LAT) {
+                this._lonlatMerc = this._lonlat.forwardMercator();
+            } else {
+                this._lonlatMerc = null;
+            }
+        }
+    }
+
+    /**
+     * Gets entity geodetic coordinates.
+     * @public
+     * @returns {LonLat} -
+     */
+    getLonLat() {
+        return this._lonlat.clone();
+    }
+
+    /**
+     * Sets geodetic coordinates of the entity point object.
+     * @public
+     * @param {LonLat} lonlat - WGS84 coordinates.
+     */
+    setLonLat(lonlat) {
+        let l = this._lonlat;
+
+        l.lon = lonlat.lon;
+        l.lat = lonlat.lat;
+        l.height = lonlat.height;
+
+        let ec = this._entityCollection;
+        if (ec && ec.renderNode && ec.renderNode.ellipsoid) {
+            if (Math.abs(lonlat.lat) < mercator.MAX_LAT) {
+                this._lonlatMerc = lonlat.forwardMercator();
+            } else {
+                this._lonlatMerc = null;
+            }
+
+            ec.renderNode.ellipsoid.lonLatToCartesianRes(lonlat, this._cartesian);
+            this.setCartesian3v(this._cartesian);
+        }
+    }
+
+    /**
+     * Sets entity altitude over the planet.
+     * @public
+     * @param {number} altitude - Altitude.
+     */
+    setAltitude(altitude) {
+        this._altitude = altitude;
+    }
+
+    /**
+     * Sets entity altitude over the planet.
+     * @public
+     * @return {number} Altitude.
+     */
+    getAltitude() {
+        return this._altitude;
+    }
+
+    /**
+     * Returns carteain position.
+     * @public
+     * @returns {Vec3} -
+     */
+    getCartesian() {
+        return this._cartesian.clone();
+    }
+
+    /**
+     * Sets entity billboard.
+     * @public
+     * @param {Billboard} billboard - Billboard object.
+     * @returns {Billboard} -
+     */
+    setBillboard(billboard) {
+        if (this.billboard) {
+            this.billboard.remove();
+        }
+        this.billboard = billboard;
+        this.billboard._entity = this;
+        this.billboard.setPosition3v(this._cartesian);
+        this.billboard.setVisibility(this._visibility);
+        this._entityCollection && this._entityCollection._billboardHandler.add(billboard);
+        return billboard;
+    }
+
+    /**
+     * Sets entity label.
+     * @public
+     * @param {Label} label - Text label.
+     * @returns {Label} -
+     */
+    setLabel(label) {
+        if (this.label) {
+            this.label.remove();
+        }
+        this.label = label;
+        this.label._entity = this;
+        this.label.setPosition3v(this._cartesian);
+        this.label.setVisibility(this._visibility);
+        this._entityCollection && this._entityCollection._labelHandler.add(label);
+        return label;
+    }
+
+    /**
+     * Sets entity ray.
+     * @public
+     * @param {Ray} ray - Ray object.
+     * @returns {Ray} -
+     */
+    setRay(ray) {
+        if (this.ray) {
+            this.ray.remove();
+        }
+        this.ray = ray;
+        this.ray._entity = this;
+        this.ray.setVisibility(this._visibility);
+        this._entityCollection && this._entityCollection._rayHandler.add(ray);
+        return ray;
+    }
+
+    /**
+     * Sets entity shape.
+     * @public
+     * @param {BaseShape} shape - Shape object.
+     * @returns {Polyline} -
+     */
+    setShape(shape) {
+        if (this.shape) {
+            this.shape.remove();
+        }
+        this.shape = shape;
+        this.shape._entity = this;
+        this.shape.setPosition3v(this._cartesian);
+        this.shape.setVisibility(this._visibility);
+        this._entityCollection && this._entityCollection._shapeHandler.add(shape);
+        return shape;
+    }
+
+    /**
+     * Sets entity polyline.
+     * @public
+     * @param {Polyline} polyline - Polyline object.
+     * @returns {Polyline} -
+     */
+    setPolyline(polyline) {
+        if (this.polyline) {
+            this.polyline.remove();
+        }
+        this.polyline = polyline;
+        this.polyline._entity = this;
+        this.polyline.setVisibility(this._visibility);
+        this._entityCollection && this._entityCollection._polylineHandler.add(polyline);
+        return polyline;
+    }
+
+    /**
+     * Sets entity pointCloud.
+     * @public
+     * @param {PointCloud} pointCloud - PointCloud object.
+     * @returns {PointCloud} -
+     */
+    setPointCloud(pointCloud) {
+        if (this.pointCloud) {
+            this.pointCloud.remove();
+        }
+        this.pointCloud = pointCloud;
+        this.pointCloud._entity = this;
+        this.pointCloud.setVisibility(this._visibility);
+        this._entityCollection && this._entityCollection._pointCloudHandler.add(pointCloud);
+        return pointCloud;
+    }
+
+    /**
+     * Sets entity geometry.
+     * @public
+     * @param {Geometry} geometry - Geometry object.
+     * @returns {Geometry} -
+     */
+    setGeometry(geometry) {
+        if (this.geometry) {
+            this.geometry.remove();
+        }
+        this.geometry = geometry;
+        this.geometry._entity = this;
+        this.geometry.setVisibility(this._visibility);
+        this._layer && this._layer.add(this);
+        return geometry;
+    }
+
+    /**
+     * Sets entity geoObject.
+     * @public
+     * @param {GeoObject} geoObject - GeoObject.
+     * @returns {GeoObject} -
+     */
+    setGeoObject(geoObject) {
+        if (this.geoObject) {
+            this.geoObject.remove();
+        }
+        this.geoObject = geoObject;
+        this.geoObject._entity = this;
+        this.geoObject.setPosition3v(this._cartesian);
+        this.geoObject.setVisibility(this._visibility);
+        this._entityCollection && this._entityCollection._geoObjectHandler.add(geoObject);
+        return geoObject;
+    }
+
+    /**
+     * Sets entity strip.
+     * @public
+     * @param {Strip} strip - Strip object.
+     * @returns {Strip} -
+     */
+    setStrip(strip) {
+        if (this.strip) {
+            this.strip.remove();
+        }
+        this.strip = strip;
+        this.strip._entity = this;
+        this.strip.setVisibility(this._visibility);
+        this._entityCollection && this._entityCollection._stripHandler.add(strip);
+        return strip;
+    }
+
+    get layer() {
+        return this._layer;
+    }
+
+    get rendererEvents() {
+        if (this._layer) {
+            return this._layer.events;
+        } else if (this._entityCollection) {
+            return this._entityCollection.events;
+        }
+        return null;
+    }
+
+    /**
+     * Append child entity.
+     * @public
+     * @param {Entity} entity - Child entity.
+     */
+    appendChild(entity) {
+        entity._entityCollection = this._entityCollection;
+        entity._pickingColor = this._pickingColor;
+        entity.parent = this;
+        this.childrenNodes.push(entity);
+        this._entityCollection && this._entityCollection._addRecursively(entity);
+    }
+
+    /**
+     * Appends entity items(billboard, label etc.) picking color.
+     * @public
+     */
+    setPickingColor() {
+        let c = this._pickingColor;
+
+        // billboard
+        this.billboard && this.billboard.setPickingColor3v(c);
+
+        // label
+        this.label && this.label.setPickingColor3v(c);
+
+        // shape
+        this.shape && this.shape.setPickingColor3v(c);
+
+        // polyline
+        this.polyline && this.polyline.setPickingColor3v(c);
+
+        // ray
+        this.ray && this.ray.setPickingColor3v(c);
+
+        // strip
+        this.strip && this.strip.setPickingColor3v(c);
+
+        // billboard
+        this.geoObject && this.geoObject.setPickingColor3v(c);
+        for (let i = 0; i < this.childrenNodes.length; i++) {
+            this.childrenNodes[i].setPickingColor();
+        }
+    }
+
+    /**
+     * Return geodethic extent.
+     * @returns {Extent} -
+     */
+    getExtent() {
+        let res;
+        let c = this._lonlat;
+        if (this.billboard || this.label) {
+            res = new Extent(new LonLat(c.lon, c.lat), new LonLat(c.lon, c.lat));
+        } else {
+            res = new Extent(new LonLat(180.0, 90.0), new LonLat(-180.0, -90.0));
+        }
+
+        let sw = res.southWest,
+            ne = res.northEast;
+
+        if (this.polyline) {
+            let e = this.polyline.getExtent();
+            if (e.southWest.lon < sw.lon) sw.lon = e.southWest.lon;
+            if (e.southWest.lat < sw.lat) sw.lat = e.southWest.lat;
+            if (e.northEast.lon > ne.lon) ne.lon = e.northEast.lon;
+            if (e.northEast.lat > ne.lat) ne.lat = e.northEast.lat;
+        }
+
+        if (this.geometry) {
+            let e = this.geometry.getExtent();
+            if (e.southWest.lon < sw.lon) sw.lon = e.southWest.lon;
+            if (e.southWest.lat < sw.lat) sw.lat = e.southWest.lat;
+            if (e.northEast.lon > ne.lon) ne.lon = e.northEast.lon;
+            if (e.northEast.lat > ne.lat) ne.lat = e.northEast.lat;
+        }
+
+        for (let i = 0; i < this.childrenNodes.length; i++) {
+            let e = this.childrenNodes[i].getExtent();
+            if (e.southWest.lon < sw.lon) sw.lon = e.southWest.lon;
+            if (e.southWest.lat < sw.lat) sw.lat = e.southWest.lat;
+            if (e.northEast.lon > ne.lon) ne.lon = e.northEast.lon;
+            if (e.northEast.lat > ne.lat) ne.lat = e.northEast.lat;
+        }
+
+        return res;
+    }
+
+    isEqual(entity) {
+        return this.id === entity.id;
+    }
+}
+
+export { Entity };