@openglobus/og 0.24.1 → 0.25.0

package/lib/js/entity/Entity.js

@@ -1,957 +0,0 @@
-import * as mercator from "../mercator";
-import * as utils from "../utils/shared";
-import { Billboard } from "./Billboard";
-import { Extent } from "../Extent";
-import { Geometry } from "./Geometry";
-import { GeoObject } from "./GeoObject";
-import { LonLat } from "../LonLat";
-import { Label } from "./Label";
-import { Vec3 } from "../math/Vec3";
-import { PointCloud } from "./PointCloud";
-import { Polyline } from "./Polyline";
-import { Ray } from "./Ray";
-import { Strip } from "./Strip";
-import { Quat } from "../math/Quat";
-import { clamp } from "../math";
-/**
- * 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 {IEntityParams} [options] - Entity options:
- * @param {string} [options.name] - Name of the entity.
- * @param {any} [options.properties] - Additional properties of the entity.
- * @param {Vec3 | NumberArray3} [options.cartesian] - Cartesian position.
- * @param {LonLat | NumberArray3 | NumberArray2} [options.lonlat] - Geographic coordinates.
- * @param {number} [options.altitude] - Altitude.
- * @param {boolean} [options.visibility] - Visibility flag.
- * @param {Billboard | IBillboardParams} [options.billboard] - Billboard object or parameters.
- * @param {Label | ILabelParams} [options.label] - Label object or parameters.
- * @param {Polyline | IPolylineParams} [options.polyline] - Polyline object or parameters.
- * @param {Ray | IRayParams} [options.ray] - Ray object or parameters.
- * @param {PointCloud | IPointCloudParams} [options.pointCloud] - Point cloud object or parameters.
- * @param {Geometry | IGeometryParams} [options.geometry] - Geometry object or parameters.
- * @param {GeoObject | IGeoObjectParams} [options.geoObject] - Geo object or parameters.
- * @param {Strip | IStripParams} [options.strip] - Strip object or parameters.
- * @param {boolean} [options.independentPicking] - Independent picking flag.
- * @param {boolean} [options.relativePosition] - Parent relative position flag, otherwise position is absolute.
- * @param {number} [options.pitch] - Rotation around local X-axis in radians.
- * @param {number} [options.yaw] - Rotation around local Y-axis in radians.
- * @param {number} [options.roll] - Rotation around local Z-axis in radians.
- * @param {number | Vec3 | NumberArray3} [options.scale] - Scaling factor.
- * @param {boolean} [options.forceGlobalPosition] - Forces global position for the entity make the same position as its parent.
- * @param {boolean} [options.forceGlobalRotation] - Forces global rotation for the entity make the same rotation as its parent.
- * @param {boolean} [options.forceGlobalScale] - Forces global scale for the entity make the same scale as its parent.
- */
-class Entity {
-    constructor(options = {}) {
-        options.properties = options.properties || {};
-        this.__id = Entity.__counter__++;
-        this.properties = options.properties || {};
-        this.properties.name = this.properties.name != undefined ? this.properties.name : "";
-        this.childEntities = [];
-        this.parent = null;
-        this.forceGlobalPosition = options.forceGlobalPosition || false;
-        this.forceGlobalRotation = options.forceGlobalRotation || false;
-        this.forceGlobalScale = options.forceGlobalScale || false;
-        this._cartesian = utils.createVector3(options.cartesian);
-        this._rootCartesian = new Vec3();
-        this._localPosition = utils.createVector3(options.localPosition);
-        this._absoluteLocalPosition = new Vec3();
-        this._lonLat = utils.createLonLat(options.lonlat);
-        this._lonLatMerc = new LonLat();
-        this._altitude = options.altitude || 0.0;
-        this._visibility = options.visibility != undefined ? options.visibility : true;
-        this._entityCollection = null;
-        this._entityCollectionIndex = -1;
-        this._layer = null;
-        this._layerIndex = -1;
-        this._pickingColor = new Vec3(0, 0, 0);
-        this._independentPicking = options.independentPicking || false;
-        this._relativePosition = options.relativePosition || false;
-        this._pitchRad = options.pitch || 0;
-        this._yawRad = options.yaw || 0;
-        this._rollRad = options.roll || 0;
-        this._scale = utils.createVector3(options.scale, new Vec3(1, 1, 1));
-        this._qFrame = Quat.IDENTITY;
-        this._qRot = Quat.IDENTITY;
-        this._absoluteQRot = Quat.IDENTITY;
-        this._featureConstructorArray = {
-            billboard: [Billboard, this.setBillboard],
-            label: [Label, this.setLabel],
-            polyline: [Polyline, this.setPolyline],
-            pointCloud: [PointCloud, this.setPointCloud],
-            geometry: [Geometry, this.setGeometry],
-            geoObject: [GeoObject, this.setGeoObject],
-            strip: [Strip, this.setStrip],
-            ray: [Ray, this.setRay]
-        };
-        this.billboard = this._createOptionFeature("billboard", options.billboard);
-        this.label = this._createOptionFeature("label", options.label);
-        this.polyline = this._createOptionFeature("polyline", options.polyline);
-        this.ray = this._createOptionFeature("ray", options.ray);
-        this.pointCloud = this._createOptionFeature("pointCloud", options.pointCloud);
-        this.geometry = this._createOptionFeature("geometry", options.geometry);
-        this.geoObject = this._createOptionFeature("geoObject", options.geoObject);
-        this.strip = this._createOptionFeature("strip", options.strip);
-    }
-    /**
-     * Returns root entity object.
-     * @public
-     * @return {Entity}
-     */
-    get rootEntity() {
-        let pn = this;
-        while (pn) {
-            if (!pn.parent) {
-                return pn;
-            }
-            pn = pn.parent;
-        }
-        return this;
-    }
-    /**
-     * Sets relative position property
-     * @param isRelative
-     */
-    set relativePosition(isRelative) {
-        if (isRelative !== this._relativePosition) {
-            let cart = this.getAbsoluteCartesian(), pitch = this.getAbsolutePitch(), yaw = this.getAbsoluteYaw(), roll = this.getAbsoluteRoll();
-            this._relativePosition = isRelative;
-            // probably need to take root this.rootEntity
-            if (this.parent) {
-                this._rootCartesian.copy(this.parent._rootCartesian);
-            }
-            if (!isRelative) {
-                this.setCartesian3v(cart);
-                this.setPitch(pitch);
-                this.setYaw(yaw);
-                this.setRoll(roll);
-            }
-            else if (this.parent) {
-                this.setAbsoluteCartesian3v(cart);
-                this.setAbsolutePitch(pitch);
-                this.setAbsoluteYaw(yaw);
-                this.setAbsoluteRoll(roll);
-            }
-        }
-    }
-    /**
-     * Gets relative position property
-     * @public
-     * @returns{boolean}
-     */
-    get relativePosition() {
-        return this._relativePosition;
-    }
-    /**
-     * Gets current entity collection container.
-     * @public
-     * @returns {EntityCollection | null}
-     */
-    get entityCollection() {
-        return this._entityCollection;
-    }
-    /**
-     * Gets entity uniq id
-     * @public
-     * @returns {number}
-     */
-    get id() {
-        return this.__id;
-    }
-    /**
-     * Checks if the given entity is equal to the current entity.
-     * @param {Entity} entity - The entity to compare.
-     * @returns {boolean} True if entities are equal, otherwise false.
-     */
-    isEqual(entity) {
-        return this.__id === entity.__id;
-    }
-    /**
-     * Gets the layer index of the entity.
-     * @returns {number} The layer index.
-     */
-    get layerIndex() {
-        return this._layerIndex;
-    }
-    /**
-     * Gets the instance class name of the entity.
-     * @returns {string} The instance name "Entity".
-     */
-    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;
-    }
-    /**
-     * Gets the collection index of the entity.
-     * @returns {number} The entity collection index.
-     */
-    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 = false) {
-        collection.add(this, rightNow);
-        return this;
-    }
-    /**
-     * Removes current entity from its collection or 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);
-        // 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.childEntities.length; i++) {
-            this.childEntities[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);
-    }
-    /**
-     * Gets scale factor
-     * @public
-     * @returns {Vec3}
-     */
-    getScale() {
-        return this._scale;
-    }
-    /**
-     * Sets XYZ axis scale for the inner object such as GeoObject
-     * @public
-     * @param {Vec3} scale - Scale factor
-     */
-    setScale3v(scale) {
-        this._scale.copy(scale);
-        this.geoObject && this.geoObject.setScale3v(this._scale);
-        for (let i = 0; i < this.childEntities.length; i++) {
-            let chi = this.childEntities[i];
-            if (chi.forceGlobalScale) {
-                chi.setScale3v(this._scale);
-            }
-            else {
-                chi.setScale3v(this.childEntities[i].getScale());
-            }
-        }
-    }
-    /**
-     * Sets scale for the inner object such as GeoObject
-     * @public
-     * @param {number} val - Scale factor
-     */
-    setScale(val) {
-        this._scale.set(val, val, val);
-        this.geoObject && this.geoObject.setScale(val);
-        for (let i = 0; i < this.childEntities.length; i++) {
-            let chi = this.childEntities[i];
-            if (chi.forceGlobalScale) {
-                chi.setScale(val);
-            }
-            else {
-                chi.setScale3v(this.childEntities[i].getScale());
-            }
-        }
-    }
-    /**
-     * Gets the absolute rotation direction of the entity.
-     * @public
-     * @returns {Quat} The absolute rotation quaternion.
-     */
-    getAbsoluteRotation() {
-        return this._absoluteQRot.clone();
-    }
-    /**
-     * Gets the local rotation of the entity. For the root entity it is equal to the absolute rotation.
-     * @public
-     * @returns {Quat} The rotation quaternion.
-     */
-    getRotation() {
-        return this._qRot;
-    }
-    /**
-     * Rotates the entity to look at a given point in world coordinates.
-     * @public
-     * @param {Vec3} cart - The target position to look at.
-     */
-    setLook3v(cart) {
-        let lq = new Quat();
-        let p0 = this.getAbsoluteCartesian();
-        let rot;
-        if (this._entityCollection) {
-            let up = this._entityCollection.renderNode.ellipsoid.getSurfaceNormal3v(p0);
-            rot = lq.setLookRotation(cart.sub(p0), up).conjugate();
-        }
-        else {
-            rot = lq.setLookRotation(cart.sub(p0), Vec3.UP).conjugate();
-        }
-        this.setAbsoluteRotation(rot);
-    }
-    /**
-     * Rotates the entity to look at a given geographic coordinate.
-     * @public
-     * @param {LonLat} lonLat - The longitude and latitude to look at.
-     */
-    setLookLonLat(lonLat) {
-        if (this._entityCollection) {
-            let cart = this._entityCollection.renderNode.ellipsoid.lonLatToCartesian(lonLat);
-            this.setLook3v(cart);
-        }
-    }
-    /**
-     * Sets the absolute rotation of the entity.
-     * @public
-     * @param {Quat} rot - The new absolute rotation quaternion.
-     */
-    setAbsoluteRotation(rot) {
-        this._absoluteQRot.copy(rot);
-        this._updatePitchYawRoll();
-    }
-    /**
-     * Sets the local rotation of the entity.
-     * @param {Quat} rot - The new rotation quaternion.
-     */
-    setRotation(rot) {
-        //this._qRot.copy(rot);
-        //
-        //@todo when necessary
-        //
-    }
-    /**
-     * Sets the pitch rotation of the entity.
-     * @param {number} val - The new pitch angle in radians.
-     */
-    setPitch(val) {
-        this._pitchRad = val;
-        this._updateAbsolutePosition();
-    }
-    /**
-     * Sets the yaw rotation of the entity.
-     * @param {number} val - The new yaw angle in radians.
-     */
-    setYaw(val) {
-        this._yawRad = val;
-        this._updateAbsolutePosition();
-    }
-    /**
-     * Sets the roll rotation of the entity.
-     * @public
-     * @param {number} val - The new roll angle in radians.
-     */
-    setRoll(val) {
-        this._rollRad = val;
-        this._updateAbsolutePosition();
-    }
-    /**
-     * Gets the pitch angle of the entity.
-     * @public
-     * @returns {number} The pitch angle in radians.
-     */
-    getPitch() {
-        return this._pitchRad;
-    }
-    /**
-     * Gets the yaw angle of the entity.
-     * @public
-     * @returns {number} The yaw angle in radians.
-     */
-    getYaw() {
-        return this._yawRad;
-    }
-    /**
-     * Gets the roll angle of the entity.
-     * @public
-     * @returns {number} The roll angle in radians.
-     */
-    getRoll() {
-        return this._rollRad;
-    }
-    /**
-     * Sets the absolute pitch of the entity.
-     * @public
-     * @param {number} val - The absolute pitch angle in radians.
-     */
-    setAbsolutePitch(val) {
-        if (this._relativePosition) {
-            this._absoluteQRot.setPitchYawRoll(val, this.getAbsoluteYaw(), this.getAbsoluteRoll(), this._qFrame);
-            this._updatePitchYawRoll();
-        }
-        else {
-            this.setPitch(val);
-        }
-    }
-    /**
-     * Sets the absolute yaw of the entity.
-     * @public
-     * @param {number} val - The absolute yaw angle in radians.
-     */
-    setAbsoluteYaw(val) {
-        if (this._relativePosition) {
-            this._absoluteQRot.setPitchYawRoll(this.getAbsolutePitch(), val, this.getAbsoluteRoll(), this._qFrame);
-            this._updatePitchYawRoll();
-        }
-        else {
-            this.setYaw(val);
-        }
-    }
-    /**
-     * Sets the absolute roll of the entity.
-     * @public
-     * @param {number} val - The absolute roll angle in radians.
-     */
-    setAbsoluteRoll(val) {
-        if (this._relativePosition) {
-            this._absoluteQRot.setPitchYawRoll(this.getAbsolutePitch(), this.getAbsoluteYaw(), val, this._qFrame);
-            this._updatePitchYawRoll();
-        }
-        else {
-            this.setRoll(val);
-        }
-    }
-    /**
-     * Gets the absolute pitch angle of the entity.
-     * @public
-     * @returns {number} The absolute pitch angle in radians.
-     */
-    getAbsolutePitch() {
-        if (this.parent && this._relativePosition) {
-            return this._qFrame.conjugate().inverse().mul(this._absoluteQRot).getPitch();
-        }
-        return this._pitchRad;
-    }
-    /**
-     * Gets the absolute yaw angle of the entity.
-     * @public
-     * @returns {number} The absolute yaw angle in radians.
-     */
-    getAbsoluteYaw() {
-        if (this.parent && this._relativePosition) {
-            return this._qFrame.conjugate().inverse().mul(this._absoluteQRot).getYaw();
-        }
-        return this._yawRad;
-    }
-    /**
-     * Gets the absolute roll angle of the entity.
-     * @public
-     * @returns {number} The absolute roll angle in radians.
-     */
-    getAbsoluteRoll() {
-        if (this.parent && this._relativePosition) {
-            return this._qFrame.conjugate().inverse().mul(this._absoluteQRot).getRoll();
-        }
-        return this._rollRad;
-    }
-    _getScaleByDistance() {
-        let scd = 1;
-        if (this._entityCollection) {
-            let scaleByDistance = this._entityCollection.scaleByDistance;
-            let lookLength = 1;
-            if (this._entityCollection.renderNode && this._entityCollection.renderNode.renderer) {
-                lookLength = this._entityCollection.renderNode.renderer.activeCamera.eye.distance(this._rootCartesian);
-            }
-            //the same in the shader
-            scd = scaleByDistance[2] * clamp(lookLength, scaleByDistance[0], scaleByDistance[1]) / scaleByDistance[0];
-        }
-        return scd;
-    }
-    /**
-     * Sets the absolute cartesian position of the entity.
-     * @public
-     * @param {number} x - X coordinate.
-     * @param {number} y - Y coordinate.
-     * @param {number} z - Z coordinate.
-     */
-    setAbsoluteCartesian(x, y, z) {
-        this.setAbsoluteCartesian3v(new Vec3(x, y, z));
-    }
-    /**
-     * Sets the absolute cartesian position of the entity using a Vec3.
-     * @public
-     * @param {Vec3} absolutCartesian - The absolute cartesian position.
-     */
-    setAbsoluteCartesian3v(absolutCartesian) {
-        let pos = absolutCartesian;
-        if (this.parent && this._relativePosition) {
-            let scd = this._getScaleByDistance();
-            pos = absolutCartesian.sub(this.parent.getAbsoluteCartesian()).scale(1 / scd);
-            pos = this.parent._absoluteQRot.conjugate().mulVec3(pos);
-        }
-        this.setCartesian3v(pos);
-    }
-    /**
-     * Returns absolute cartesian position.
-     * @public
-     * @returns {Vec3} -
-     */
-    getAbsoluteCartesian() {
-        if (this.parent && this._relativePosition) {
-            let scd = this._getScaleByDistance();
-            return this._rootCartesian.add(this._absoluteLocalPosition.scaleTo(scd));
-        }
-        return this._cartesian.clone();
-    }
-    /**
-     * 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) {
-        this._cartesian.set(x, y, z);
-        this._updateAbsolutePosition();
-        for (let i = 0; i < this.childEntities.length; i++) {
-            let chi = this.childEntities[i];
-            if (chi._relativePosition) {
-                chi.setCartesian3v(chi.getCartesian());
-            }
-            else if (chi.forceGlobalPosition) {
-                chi.setCartesian(x, y, z);
-            }
-        }
-        this._updateLonLat();
-        //ec && ec.events.dispatch(ec.events.entitymove, this);
-    }
-    _updatePitchYawRoll() {
-        if (this.parent) {
-            this._qRot = this.parent._absoluteQRot.conjugate().mul(this._absoluteQRot);
-            this._pitchRad = this._qRot.getPitch();
-            this._yawRad = this._qRot.getYaw();
-            this._rollRad = this._qRot.getRoll();
-            // this._pitch = this._pitchRad * DEGREES;
-            // this._yaw = this._yawRad * DEGREES;
-            // this._roll = this._rollRad * DEGREES;
-            if (this.geoObject) {
-                this.geoObject.setRotation(this._absoluteQRot);
-            }
-            for (let i = 0; i < this.childEntities.length; i++) {
-                this.childEntities[i]._updateAbsolutePosition();
-            }
-        }
-    }
-    _updateAbsolutePosition() {
-        let parent = this.parent;
-        if (parent && this._relativePosition) {
-            this._qFrame.copy(parent._qFrame);
-            this._rootCartesian.copy(parent._rootCartesian);
-            this._qRot.setPitchYawRoll(this._pitchRad, this._yawRad, this._rollRad);
-            parent._absoluteQRot.mulRes(this._qRot, this._absoluteQRot);
-            let rotCart = parent._absoluteQRot.mulVec3(this._cartesian.add(this._localPosition));
-            parent._absoluteLocalPosition.addRes(rotCart, this._absoluteLocalPosition);
-        }
-        else {
-            this._qFrame = Quat.IDENTITY;
-            if (this._entityCollection && this._entityCollection.renderNode) {
-                this._qFrame = this._entityCollection.renderNode.getFrameRotation(this._cartesian);
-            }
-            if (parent && this.forceGlobalRotation) {
-                this._qRot.setPitchYawRoll(parent._pitchRad, parent._yawRad, parent._rollRad, this._qFrame);
-            }
-            else {
-                this._qRot.setPitchYawRoll(this._pitchRad, this._yawRad, this._rollRad, this._qFrame);
-            }
-            this._absoluteQRot.copy(this._qRot);
-            this._rootCartesian.copy(this._cartesian);
-            this._absoluteLocalPosition.copy(this._localPosition);
-        }
-        if (this.geoObject) {
-            this.geoObject.setRotation(this._absoluteQRot);
-            this.geoObject.setPosition3v(this._rootCartesian);
-            this.geoObject.setLocalPosition3v(this._absoluteLocalPosition);
-        }
-        this.billboard && this.billboard.setPosition3v(this._rootCartesian);
-        this.label && this.label.setPosition3v(this._rootCartesian);
-        for (let i = 0, len = this.childEntities.length; i < len; i++) {
-            this.childEntities[i]._updateAbsolutePosition();
-        }
-        this._updateLonLat();
-    }
-    /**
-     * Sets entity cartesian position without event dispatching.
-     * @public
-     * @param {Vec3} cartesian - Cartesian position in 3d space.
-     * @param {boolean} skipLonLat - skip geodetic calculation.
-     */
-    _setCartesian3vSilent(cartesian, skipLonLat = false) {
-        this._cartesian.copy(cartesian);
-        this._updateAbsolutePosition();
-        for (let i = 0; i < this.childEntities.length; i++) {
-            this.childEntities[i].setCartesian(this._cartesian.x, this._cartesian.y, this._cartesian.z);
-        }
-        if (!skipLonLat) {
-            this._updateLonLat();
-        }
-    }
-    _updateLonLat() {
-        let ec = this._entityCollection;
-        if (ec && ec.renderNode && ec.renderNode.ellipsoid) {
-            //let cart = this._rootCartesian.add(this._absoluteLocalPosition);
-            this._lonLat = ec.renderNode.ellipsoid.cartesianToLonLat(this.getAbsoluteCartesian());
-            if (Math.abs(this._lonLat.lat) < mercator.MAX_LAT) {
-                this._lonLatMerc = this._lonLat.forwardMercator();
-            }
-            else {
-                this._lonLatMerc.lon = this._lonLatMerc.lat = 0;
-            }
-        }
-    }
-    /**
-     * Gets entity geodetic coordinates.
-     * @public
-     * @returns {LonLat} -
-     */
-    getLonLat() {
-        return this._lonLat.clone();
-    }
-    /**
-     * Sets geodetic coordinates of the entity point object.
-     * @public
-     * @param {LonLat} lonlat - 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(l.lat) < mercator.MAX_LAT) {
-                this._lonLatMerc = l.forwardMercator();
-            }
-            else {
-                //this._lonLatMerc = null;
-            }
-            let temp = new Vec3();
-            ec.renderNode.ellipsoid.lonLatToCartesianRes(l, temp);
-            this.setAbsoluteCartesian3v(temp);
-        }
-    }
-    /**
-     * Sets geodetic coordinates of the entity point object.
-     * @public
-     * @param {number} lon - Longitude.
-     * @param {number} lat - Latitude
-     * @param {number} [height] - Height
-     */
-    setLonLat2(lon, lat, height) {
-        let l = this._lonLat;
-        l.lon = lon;
-        l.lat = lat;
-        l.height = height != undefined ? height : l.height;
-        let ec = this._entityCollection;
-        if (ec && ec.renderNode && ec.renderNode.ellipsoid) {
-            if (Math.abs(l.lat) < mercator.MAX_LAT) {
-                this._lonLatMerc = l.forwardMercator();
-            }
-            else {
-                this._lonLatMerc.lon = this._lonLatMerc.lat = this._lonLatMerc.height = 0;
-            }
-            let temp = new Vec3();
-            ec.renderNode.ellipsoid.lonLatToCartesianRes(l, temp);
-            this.setAbsoluteCartesian3v(temp);
-        }
-    }
-    /**
-     * 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 cartesian 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 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);
-        let layer = this._layer;
-        if (this._layer) {
-            this._layer.removeEntity(this);
-        }
-        layer && 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;
-    }
-    /**
-     * Gets layer container
-     * @public
-     * @returns {Vector | null}
-     */
-    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;
-        if (!entity._independentPicking) {
-            entity._pickingColor = this._pickingColor;
-        }
-        entity.parent = this;
-        this.childEntities.push(entity);
-        this._entityCollection && this._entityCollection.appendChildEntity(entity);
-    }
-    /**
-     * Appends entity items(billboard, label etc.) picking color.
-     * @public
-     */
-    setPickingColor() {
-        let c = this._pickingColor;
-        this.billboard && this.billboard.setPickingColor3v(c);
-        this.label && this.label.setPickingColor3v(c);
-        this.polyline && this.polyline.setPickingColor3v(c);
-        this.ray && this.ray.setPickingColor3v(c);
-        this.strip && this.strip.setPickingColor3v(c);
-        this.geoObject && this.geoObject.setPickingColor3v(c);
-        for (let i = 0; i < this.childEntities.length; i++) {
-            this.childEntities[i].setPickingColor();
-        }
-    }
-    /**
-     * Return geodetic extent.
-     * @public
-     * @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.childEntities.length; i++) {
-            let e = this.childEntities[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;
-    }
-}
-Entity.__counter__ = 0;
-export { Entity };