@openglobus/og 0.21.0 → 0.22.1

package/LICENSE.md

@@ -1,7 +1,7 @@
-Copyright (C) 2013 Michael Gevlich
+Copyright (c) 2013-2025 Michael Gevlich
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 
 The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/lib/@openglobus/js/Globe.d.ts

@@ -45,6 +45,8 @@ export interface IGlobeParams {
     fontsSrc?: string;
     resourcesSrc?: string;
     atmosphereParameters?: IAtmosphereParams;
+    gamma?: number;
+    exposure?: number;
 }
 /**
  * Creates a WebGL context with globe.
@@ -97,6 +99,8 @@ export interface IGlobeParams {
  * @param {boolean} [options.atmosphereEnabled] - Enables atmosphere effect.
  * @param {boolean} [options.transtitionOpacityEnabled] - Enables terrain smooth opacity transition effect.
  * @param {IAtmosphereParams} [options.atmosphereParameters] - Atmosphere model parameters.
+ * @param {number} [options.gamma] - Gamma
+ * @param {number} [options.exposure] - Exposure
  */
 declare class Globe {
     static __counter__: number;

package/lib/@openglobus/js/Object3d.d.ts

@@ -1,5 +1,6 @@
 import { TypedArray } from './utils/shared';
 import { NumberArray3, Vec3 } from './math/Vec3';
+import { Mat4 } from "./math/Mat4";
 interface IObject3dParams {
     name?: string;
     vertices?: number[];
@@ -9,7 +10,7 @@ interface IObject3dParams {
     center?: boolean;
     src?: string;
     color?: number[] | TypedArray | string;
-    scale?: number;
+    scale?: number | Vec3;
 }
 declare class Object3d {
     protected _name: string;
@@ -27,6 +28,10 @@ declare class Object3d {
     protected _normals: number[];
     constructor(data?: IObject3dParams);
     static centering(verts: number[]): void;
+    centering(): this;
+    applyMat4(m: Mat4): this;
+    scale(s: Vec3): this;
+    translate(v: Vec3): this;
     get src(): string | null;
     set src(src: string | null);
     get name(): string;
@@ -35,7 +40,7 @@ declare class Object3d {
     get indices(): number[];
     get texCoords(): number[];
     get numVertices(): number;
-    static scale(vertices: number[], s: number): void;
+    static scale(vertices: number[], s: Vec3): void;
     static centroid(vertices: number[]): number[];
     static translate(vertices: number[], v: NumberArray3): void;
     static getNormals(vertices: number[]): number[];

package/lib/@openglobus/js/camera/Camera.d.ts

@@ -5,6 +5,7 @@ import { Mat4, NumberArray16 } from "../math/Mat4";
 import { Renderer } from "../renderer/Renderer";
 import { Vec2, NumberArray2 } from "../math/Vec2";
 import { Vec3 } from "../math/Vec3";
+import { Sphere } from "../bv/Sphere";
 type CameraEvents = ["viewchange", "moveend"];
 export interface ICameraParams {
     eye?: Vec3;
@@ -285,6 +286,7 @@ declare class Camera {
     getNormalMatrix(): NumberArray9;
     setCurrentFrustum(k: number): void;
     getCurrentFrustum(): number;
+    containsSphere(sphere: Sphere): boolean;
     get frustum(): Frustum;
     /**
      * Returns projection matrix.

package/lib/@openglobus/js/control/geoObjectEditor/GeoObjectEditorScene.d.ts

@@ -0,0 +1,58 @@
+import { EventsHandler } from '../../Events';
+import { Planet } from "../../scene/Planet";
+import { RenderNode } from '../../scene/RenderNode';
+import { Vector } from '../../layer/Vector';
+import { Vec2 } from '../../math/Vec2';
+import { IMouseState } from "../../renderer/RendererEvents";
+import { Ellipsoid } from "../../ellipsoid/Ellipsoid";
+export interface IGeoObjectEditorSceneParams {
+    planet?: Planet;
+}
+type GeoObjectSceneEventsList = [
+    "mousemove",
+    "mouseenter",
+    "mouseleave",
+    "lclick",
+    "rclick",
+    "mclick",
+    "ldblclick",
+    "rdblclick",
+    "mdblclick",
+    "lup",
+    "rup",
+    "mup",
+    "ldown",
+    "rdown",
+    "mdown",
+    "lhold",
+    "rhold",
+    "mhold",
+    "mousewheel",
+    "touchmove",
+    "touchstart",
+    "touchend",
+    "doubletouch",
+    "touchleave",
+    "touchenter"
+];
+declare class GeoObjectEditorScene extends RenderNode {
+    events: EventsHandler<GeoObjectSceneEventsList>;
+    protected _planet: Planet | null;
+    protected _startPos: Vec2 | null;
+    protected _startClick: Vec2;
+    protected _axisLayer: Vector;
+    protected _rotLayer: Vector;
+    constructor(options?: IGeoObjectEditorSceneParams);
+    init(): void;
+    onremove(): void;
+    _activate(): void;
+    protected _deactivate(): void;
+    protected _onLUp: () => void;
+    setVisibility(visibility: boolean): void;
+    protected _onLclick: (e: IMouseState) => void;
+    protected _onMouseMove: (e: IMouseState) => void;
+    clear(): void;
+    frame(): void;
+    get ellipsoid(): Ellipsoid | null;
+}
+export { GeoObjectEditorScene };

package/lib/@openglobus/js/ellipsoid/Ellipsoid.d.ts

@@ -98,7 +98,7 @@ declare class Ellipsoid {
      */
     lonLatToCartesianRes(lonlat: LonLat, res: Vec3): Vec3;
     /**
-     * Gets cartesian ECEF from Wgs84 geodetic coordinates.
+     * Gets cartesian ECEF 3d coordinates from geodetic coordinates.
      * @public
      * @param {Number} lon - Longitude.
      * @param {Number} lat - Latitude.
@@ -189,5 +189,6 @@ declare class Ellipsoid {
      */
     static getIntermediatePointOnGreatCircle(lonLat1: LonLat, lonLat2: LonLat, fraction: number): LonLat;
     static getRhumbBearing(lonLat1: LonLat, lonLat2: LonLat): number;
+    getLonLatVisibilitySimple(eye: Vec3, lonLat: LonLat, forward?: Vec3): boolean;
 }
 export { Ellipsoid };

package/lib/@openglobus/js/ellipsoid/index.d.ts

@@ -1,3 +1,4 @@
-import { Ellipsoid } from './Ellipsoid';
-import { wgs84 } from './wgs84';
-export { Ellipsoid, wgs84 };
+export * from './Ellipsoid';
+export * from './wgs84';
+export * from './mars';
+export * from './moon';

package/lib/@openglobus/js/ellipsoid/mars.d.ts

@@ -0,0 +1,6 @@
+import { Ellipsoid } from "./Ellipsoid";
+/**
+ * Mars ellipsoid object.
+ * @type {Ellipsoid}
+ */
+export declare const mars: Ellipsoid;

package/lib/@openglobus/js/ellipsoid/moon.d.ts

@@ -0,0 +1,6 @@
+import { Ellipsoid } from "./Ellipsoid";
+/**
+ * Moon ellipsoid object.
+ * @type {Ellipsoid}
+ */
+export declare const moon: Ellipsoid;

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

@@ -10,7 +10,7 @@ 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 { Strip, IStripParams } from "./Strip";
 import { Vector, VectorEventsType } from "../layer/Vector";
 import { EntityCollectionNode } from "../quadTree/EntityCollectionNode";
 export interface IEntityParams {
@@ -27,7 +27,8 @@ export interface IEntityParams {
     pointCloud?: PointCloud | IPointCloudParams;
     geometry?: Geometry | IGeometryParams;
     geoObject?: GeoObject | IGeoObjectParams;
-    strip?: Strip;
+    strip?: Strip | IStripParams;
+    independentPicking?: boolean;
 }
 /**
  * Entity instances aggregate multiple forms of visualization into a single high-level object.
@@ -134,6 +135,7 @@ declare class Entity {
      * @type {Vec3}
      */
     _pickingColor: Vec3;
+    _independentPicking: boolean;
     protected _featureConstructorArray: Record<string, [any, Function]>;
     /**
      * Billboard entity.

package/lib/@openglobus/js/entity/EntityCollection.d.ts

@@ -19,7 +19,7 @@ interface IEntityCollectionParams {
     labelMaxLetters?: number;
     pickingEnabled?: boolean;
     scaleByDistance?: NumberArray3;
-    pickingScale?: number;
+    pickingScale?: number | NumberArray3;
     opacity?: number;
     useLighting?: boolean;
     entities?: Entity[];
@@ -160,7 +160,7 @@ declare class EntityCollection {
      * @type {Array.<number>} - (exactly 3 entries)
      */
     scaleByDistance: NumberArray3;
-    pickingScale: number;
+    pickingScale: Float32Array;
     /**
      * Global opacity.
      * @protected
@@ -187,6 +187,7 @@ declare class EntityCollection {
     _quadNode?: EntityCollectionNode;
     _useLighting: number;
     constructor(options?: IEntityCollectionParams);
+    isEmpty(): boolean;
     get id(): number;
     get useLighting(): boolean;
     set useLighting(f: boolean);

package/lib/@openglobus/js/entity/GeoObject.d.ts

@@ -13,7 +13,8 @@ export interface IGeoObjectParams {
     pitch?: number;
     yaw?: number;
     roll?: number;
-    scale?: number | Vec3;
+    scale?: number | Vec3 | NumberArray3;
+    translate?: Vec3 | NumberArray3;
     color?: Vec4 | NumberArray4 | string;
     visibility?: boolean;
 }
@@ -49,6 +50,7 @@ declare class GeoObject {
     protected _yawRad: number;
     protected _rollRad: number;
     protected _scale: Vec3;
+    protected _translate: Vec3;
     /**
      * RGBA color.
      * @public
@@ -66,6 +68,7 @@ declare class GeoObject {
     protected _qNorthFrame: Quat;
     private _textureSrc?;
     _objectSrc?: string;
+    protected _children: GeoObject[];
     constructor(options: IGeoObjectParams);
     get tag(): string;
     getPosition(): Vec3;
@@ -139,6 +142,8 @@ declare class GeoObject {
     setScale(scale: number): void;
     setScale3v(scale: Vec3): void;
     getScale(): Vec3;
+    setTranslate3v(translate: Vec3): void;
+    getTranslate(): Vec3;
     /**
      * Removes geo object from handler.
      * @public

package/lib/@openglobus/js/entity/GeoObjectHandler.d.ts

@@ -16,6 +16,7 @@ declare class InstanceData {
     _textureSrc: string | null;
     _objectSrc?: string;
     _sizeArr: number[] | TypedArray;
+    _translateArr: number[] | TypedArray;
     _vertexArr: number[] | TypedArray;
     _positionHighArr: number[] | TypedArray;
     _positionLowArr: number[] | TypedArray;
@@ -27,6 +28,7 @@ declare class InstanceData {
     _visibleArr: number[] | TypedArray;
     _texCoordArr: number[] | TypedArray;
     _sizeBuffer: WebGLBufferExt | null;
+    _translateBuffer: WebGLBufferExt | null;
     _vertexBuffer: WebGLBufferExt | null;
     _positionHighBuffer: WebGLBufferExt | null;
     _positionLowBuffer: WebGLBufferExt | null;
@@ -46,6 +48,7 @@ declare class InstanceData {
     createVertexBuffer(): void;
     createVisibleBuffer(): void;
     createSizeBuffer(): void;
+    createTranslateBuffer(): void;
     createTexCoordBuffer(): void;
     createPositionBuffer(): void;
     createRgbaBuffer(): void;
@@ -88,6 +91,7 @@ declare class GeoObjectHandler {
     setRgbaArr(tagData: InstanceData, tagDataIndex: number, rgba: Vec4): void;
     setPickingColorArr(tagData: InstanceData, tagDataIndex: number, color: Vec3): void;
     setScaleArr(tagData: InstanceData, tagDataIndex: number, scale: Vec3): void;
+    setTranslateArr(tagData: InstanceData, tagDataIndex: number, translate: Vec3): void;
     protected _updateTag(dataTag: InstanceData): void;
     update(): void;
     _removeAll(): void;

package/lib/@openglobus/js/entity/Label.d.ts

@@ -11,6 +11,7 @@ export interface ILabelParams extends IBaseBillboardParams {
     outlineColor?: string | NumberArray4 | Vec4;
     align?: string;
     isRTL?: boolean;
+    letterSpacing?: number;
 }
 declare const ALIGN: Record<string, number>;
 /**
@@ -84,6 +85,7 @@ declare class Label extends BaseBillboard {
      */
     protected _fontAtlas: FontAtlas | null;
     protected _isRTL: boolean;
+    protected _letterSpacing: number;
     constructor(options?: ILabelParams);
     /**
      * Set label text.
@@ -92,6 +94,18 @@ declare class Label extends BaseBillboard {
      * It can't be bigger than maximum labelHandler _maxLetters value.
      */
     setText(text: string): void;
+    /**
+     * Set text letter spacing.
+     * @public
+     * @param {number} spacing - Letter spacing.
+     */
+    setLetterSpacing(letterSpacing: number): void;
+    /**
+     * Returns label text letter spacing.
+     * @public
+     * @param {number} spacing - Letter spacing.
+     */
+    getLetterSpacing(): number;
     /**
      * Change text direction.
      * @public

package/lib/@openglobus/js/entity/LabelHandler.d.ts

@@ -43,7 +43,7 @@ declare class LabelHandler extends BaseBillboardHandler {
     _displayPASS(): void;
     protected _pickingPASS(): void;
     protected _removeBillboard(label: Label): void;
-    setText(index: number, text: string, fontIndex: number, align: number, isRTL?: boolean): void;
+    setText(index: number, text: string, fontIndex: number, align: number, letterSpacing?: number, isRTL?: boolean): void;
     setPositionArr(index: number, positionHigh: Vec3, positionLow: Vec3): void;
     setPickingColorArr(index: number, color: Vec3): void;
     setSizeArr(index: number, size: number): void;

package/lib/@openglobus/js/index.d.ts

@@ -11,7 +11,7 @@ import * as webgl from './webgl/index';
 export * from './Globe';
 import { Geoid } from './terrain/Geoid';
 import { input } from './input/input';
-import { Ellipsoid, wgs84 } from './ellipsoid/index';
+import { Ellipsoid, wgs84, moon, mars } from './ellipsoid/index';
 import { Camera, PlanetCamera } from './camera/index';
 import { Line2, Line3, Mat3, Mat4, Plane, Quat, Ray, Vec2, Vec3, Vec4 } from './math/index';
 import { Renderer } from './renderer/Renderer';
@@ -23,11 +23,11 @@ import { LonLat } from './LonLat';
 import { RenderNode } from './scene/RenderNode';
 import { Planet } from './scene/Planet';
 import { Popup } from './Popup';
-import { EarthQuadTreeStrategy, MarsQuadTreeStrategy, QuadTreeStrategy, quadTreeStrategyType, Wgs84QuadTreeStrategy } from './quadTree/index';
+import { EarthQuadTreeStrategy, EquiQuadTreeStrategy, QuadTreeStrategy, quadTreeStrategyType, Wgs84QuadTreeStrategy } from './quadTree/index';
 import { Object3d } from './Object3d';
 import { Handler, Program, Framebuffer, Multisample } from './webgl/index';
 import { Control } from './control/Control';
 export * from './entity/index';
 export * from './layer/index';
 import { EmptyTerrain, GlobusTerrain, RgbTerrain, BilTerrain, GlobusRgbTerrain } from './terrain/index';
-export { bv, jd, math, mercator, utils, input, control, scene, quadTreeStrategyType, wgs84, terrain, layer, webgl, Framebuffer, EmptyTerrain, GlobusTerrain, RgbTerrain, GlobusRgbTerrain, BilTerrain, Control, Camera, Ellipsoid, Planet, PlanetCamera, LightSource, Program, Handler, Multisample, Renderer, Clock, Events, Extent, LonLat, RenderNode, Line2, Line3, Mat3, Mat4, Plane, Quat, Ray, Vec2, Vec3, Vec4, Geoid, Popup, QuadTreeStrategy, MarsQuadTreeStrategy, EarthQuadTreeStrategy, Wgs84QuadTreeStrategy, Object3d };
+export { bv, jd, math, mercator, utils, input, control, scene, quadTreeStrategyType, wgs84, moon, mars, terrain, layer, webgl, Framebuffer, EmptyTerrain, GlobusTerrain, RgbTerrain, GlobusRgbTerrain, BilTerrain, Control, Camera, Ellipsoid, Planet, PlanetCamera, LightSource, Program, Handler, Multisample, Renderer, Clock, Events, Extent, LonLat, RenderNode, Line2, Line3, Mat3, Mat4, Plane, Quat, Ray, Vec2, Vec3, Vec4, Geoid, Popup, QuadTreeStrategy, EquiQuadTreeStrategy, EarthQuadTreeStrategy, Wgs84QuadTreeStrategy, Object3d };

package/lib/@openglobus/js/layer/Vector.d.ts

@@ -1,12 +1,11 @@
 import { Entity, IEntityParams } from "../entity/Entity";
 import { EntityCollection } from "../entity/EntityCollection";
-import { EntityCollectionNode, EntityCollectionNodeWGS84 } from "../quadTree/EntityCollectionNode";
+import { EntityCollectionsTreeStrategy } from "../quadTree/EntityCollectionsTreeStrategy";
 import { EventsHandler } from "../Events";
 import { GeometryHandler } from "../entity/GeometryHandler";
 import { ILayerParams, Layer, LayerEventsList } from "./Layer";
 import { NumberArray3 } from "../math/Vec3";
 import { Planet } from "../scene/Planet";
-import { QueueArray } from "../QueueArray";
 import { Material } from "./Material";
 import { NumberArray4 } from "../math/Vec4";
 export interface IVectorParams extends ILayerParams {
@@ -16,7 +15,7 @@ export interface IVectorParams extends ILayerParams {
     relativeToGround?: boolean;
     clampToGround?: boolean;
     async?: boolean;
-    pickingScale?: number;
+    pickingScale?: number | NumberArray3;
     scaleByDistance?: NumberArray3;
     labelMaxLetters?: number;
     useLighting?: boolean;
@@ -75,13 +74,18 @@ declare class Vector extends Layer {
      * @type {NumberArray3} - (exactly 3 entries)
      */
     scaleByDistance: NumberArray3;
-    pickingScale: number;
+    pickingScale: Float32Array;
     /**
      * Asynchronous data handling before rendering.
      * @public
      * @type {boolean}
      */
     async: boolean;
+    /**
+     * Maximum entities quantity in the tree node.
+     * @public
+     */
+    _nodeCapacity: number;
     /**
      * Clamp vector data to the ground.
      * @public
@@ -94,34 +98,18 @@ declare class Vector extends Layer {
      * @type {boolean}
      */
     relativeToGround: boolean;
+    /** todo: combine into one */
     protected _stripEntityCollection: EntityCollection;
     protected _polylineEntityCollection: EntityCollection;
     protected _geoObjectEntityCollection: EntityCollection;
     _geometryHandler: GeometryHandler;
-    /**
-     * Maximum entities quantity in the tree node.
-     * @public
-     */
-    _nodeCapacity: number;
-    /**
-     * @todo: remove, or replace with node strategy
-     */
-    protected _entityCollectionsTree: EntityCollectionNode | null;
-    protected _entityCollectionsTreeNorth: EntityCollectionNodeWGS84 | null;
-    protected _entityCollectionsTreeSouth: EntityCollectionNodeWGS84 | null;
-    _renderingNodes: Record<number, boolean>;
-    _renderingNodesNorth: Record<number, boolean>;
-    _renderingNodesSouth: Record<number, boolean>;
-    protected _counter: number;
-    protected _deferredEntitiesPendingQueue: QueueArray<EntityCollectionNode>;
-    protected _pendingsQueue: Entity[];
+    protected _entityCollectionsTreeStrategy: EntityCollectionsTreeStrategy | null;
     /**
      * Specifies the scale Units for gl.polygonOffset function to calculate depth values, 0.0 is default.
      * @public
      * @type {Number}
      */
     polygonOffsetUnits: number;
-    _secondPASS: EntityCollectionNode[];
     protected _labelMaxLetters: number;
     protected _useLighting: boolean;
     constructor(name?: string | null, options?: IVectorParams);
@@ -198,7 +186,7 @@ declare class Vector extends Layer {
      */
     removeEntities(entities: Entity[]): this;
     /**
-     * TODO: Clear the layer.
+     * Clear the layer.
      * @public
      */
     clear(): void;
@@ -215,12 +203,9 @@ declare class Vector extends Layer {
      * @returns {Vector} - Returns layer instance.
      */
     setEntities(entities: Entity[]): this;
-    /**
-     * @todo: replace to a strategy node collecting algorithm
-     */
     protected _createEntityCollectionsTree(entitiesForTree: Entity[]): void;
     /**
-     * @todo (refactoring) could be used in somethig like bindEntityCollectionQuad(...)
+     * @todo (refactoring) could be used in something like bindEntityCollectionQuad(...)
      * @param entityCollection
      */
     _bindEventsDefault(entityCollection: EntityCollection): void;
@@ -228,8 +213,6 @@ declare class Vector extends Layer {
     protected _collectPolylineCollectionPASS(outArr: EntityCollection[]): void;
     protected _collectGeoObjectCollectionPASS(outArr: EntityCollection[]): void;
     collectVisibleCollections(outArr: EntityCollection[]): void;
-    _queueDeferredNode(node: EntityCollectionNode): void;
-    protected _execDeferredNode(node: EntityCollectionNode): void;
     /**
      * Start to load tile material.
      * @public

package/lib/@openglobus/js/proj/equi.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @module og/proj/equi
+ */
+import { Proj } from "./Proj";
+/**
+ * Any equrectangualr projection object.
+ * @type {Proj}
+ */
+export declare const equi: Proj;

package/lib/@openglobus/js/quadTree/{EPSG4326QuadTreeStrategy.d.ts → EPSG4326/EPSG4326QuadTreeStrategy.d.ts}

@@ -1,5 +1,5 @@
-import { Planet } from "../scene/Planet";
-import { QuadTreeStrategy } from "./QuadTreeStrategy";
+import { Planet } from "../../scene/Planet";
+import { QuadTreeStrategy } from "../QuadTreeStrategy";
 export declare class EPSG4326QuadTreeStrategy extends QuadTreeStrategy {
     constructor(planet: Planet);
     init(): void;

package/lib/@openglobus/js/quadTree/EntityCollectionNode.d.ts

@@ -7,12 +7,14 @@ import { Sphere } from '../bv/Sphere';
 import { Segment } from "../segment/Segment";
 import { Vector } from "../layer/Vector";
 import { Entity } from "../entity/Entity";
-type NodesDict = Record<number, Node>;
+import { EntityCollectionsTreeStrategy } from "./EntityCollectionsTreeStrategy";
+export type NodesDict = Record<number, Node>;
 /**
  * @todo: remove planet parameter. It's already available in the layer.
  */
 declare class EntityCollectionNode {
     layer: Vector;
+    strategy: EntityCollectionsTreeStrategy;
     parentNode: EntityCollectionNode | null;
     childrenNodes: EntityCollectionNode[];
     partId: number;
@@ -25,7 +27,7 @@ declare class EntityCollectionNode {
     zoom: number;
     bsphere: Sphere;
     _inTheQueue: boolean;
-    constructor(layer: Vector, partId: number, parent: EntityCollectionNode | null, extent: Extent, planet: Planet, zoom: number);
+    constructor(strategy: EntityCollectionsTreeStrategy, partId: number, parent: EntityCollectionNode | null, extent: Extent, planet: Planet, zoom: number);
     insertEntity(entity: Entity, rightNow?: boolean): void;
     protected _addEntitiesToCollection(entities: Entity[], rightNow?: boolean): void;
     protected _setExtentBounds(): void;
@@ -41,14 +43,4 @@ declare class EntityCollectionNode {
     alignEntityToTheGround(entity: Entity, segment: Segment): void;
     isVisible(): boolean;
 }
-declare class EntityCollectionNodeWGS84 extends EntityCollectionNode {
-    isNorth: boolean;
-    constructor(layer: Vector, partId: number, parent: EntityCollectionNodeWGS84 | null, extent: Extent, planet: Planet, zoom: number);
-    createChildrenNodes(): void;
-    protected _setExtentBounds(): void;
-    __setLonLat__(entity: Entity): LonLat;
-    isVisible(): boolean;
-    isInside(entity: Entity): boolean;
-    renderCollection(outArr: EntityCollection[], visibleNodes: NodesDict, renderingNode: number): void;
-}
-export { EntityCollectionNode, EntityCollectionNodeWGS84 };
+export { EntityCollectionNode };

package/lib/@openglobus/js/quadTree/EntityCollectionsTreeStrategy.d.ts

@@ -0,0 +1,25 @@
+import { Vector } from "../layer/Vector";
+import { EntityCollectionNode } from "./EntityCollectionNode";
+import { Entity } from "../entity/Entity";
+import { EntityCollection } from "../entity/EntityCollection";
+import { QueueArray } from "../QueueArray";
+export declare class EntityCollectionsTreeStrategy {
+    _layer: Vector;
+    /**
+     * Maximum entities quantity in the tree node.
+     * @public
+     */
+    _nodeCapacity: number;
+    _secondPASS: EntityCollectionNode[];
+    protected _counter: number;
+    protected _deferredEntitiesPendingQueue: QueueArray<EntityCollectionNode>;
+    _renderingNodes: Record<number, boolean>;
+    constructor(layer: Vector, nodeCapacity: number);
+    insertEntity(entity: Entity, rightNow?: boolean): void;
+    setPickingEnabled(pickingEnabled: boolean): void;
+    dispose(): void;
+    insertEntities(entitiesForTree: Entity[]): void;
+    collectVisibleEntityCollections(outArr: EntityCollection[]): void;
+    _queueDeferredNode(node: EntityCollectionNode): void;
+    protected _execDeferredNode(node: EntityCollectionNode): void;
+}

package/lib/@openglobus/js/quadTree/QuadTreeStrategy.d.ts

@@ -1,8 +1,10 @@
 import { Layer } from "../layer/Layer";
+import { Vector } from "../layer/Vector";
 import { Node } from "../quadTree/Node";
 import { Planet } from "../scene/Planet";
 import { Proj } from "../proj/Proj";
 import { LonLat } from "../LonLat";
+import { EntityCollectionsTreeStrategy } from "./EntityCollectionsTreeStrategy";
 export declare class QuadTreeStrategy {
     name: string;
     projection: Proj;
@@ -13,16 +15,25 @@ export declare class QuadTreeStrategy {
      * @type {Node[]}
      */
     protected _quadTreeList: Node[];
+    /**
+     * Current visible mercator segments tree nodes array.
+     * @public
+     * @type {Node}
+     */
+    _visibleNodes: Record<number, Node>;
     constructor(planet: Planet, name?: string, proj?: Proj);
+    createEntitiCollectionsTreeStrategy(layer: Vector, nodeCapacity: number): EntityCollectionsTreeStrategy;
     destroyBranches(): void;
     clearLayerMaterial(layer: Layer): void;
     get planet(): Planet;
     init(): void;
     preRender(): void;
     preLoad(): void;
+    protected _clearVisibleNodes(): void;
     collectRenderNodes(): void;
     clear(): void;
     get quadTreeList(): Node[];
     getTileXY(lonLat: LonLat, zoom: number): [number, number, number, number];
     getLonLatTileOffset(lonLat: LonLat, x: number, y: number, z: number, gridSize: number): [number, number];
+    collectVisibleNode(node: Node): void;
 }

package/lib/@openglobus/js/quadTree/earth/EarthEntityCollectionNodeLonLat.d.ts

@@ -0,0 +1,18 @@
+import { EarthEntityCollectionsTreeStrategy } from "./EarthEntityCollectionsTreeStrategy";
+import { Extent } from "../../Extent";
+import { Planet } from "../../scene/Planet";
+import { LonLat } from "../../LonLat";
+import { Entity } from "../../entity/Entity";
+import { EntityCollection } from "../../entity/EntityCollection";
+import { EntityCollectionNode, NodesDict } from "../EntityCollectionNode";
+export declare class EarthEntityCollectionNodeLonLat extends EntityCollectionNode {
+    isNorth: boolean;
+    strategy: EarthEntityCollectionsTreeStrategy;
+    constructor(strategy: EarthEntityCollectionsTreeStrategy, partId: number, parent: EarthEntityCollectionNodeLonLat | null, extent: Extent, planet: Planet, zoom: number);
+    createChildrenNodes(): void;
+    protected _setExtentBounds(): void;
+    __setLonLat__(entity: Entity): LonLat;
+    isVisible(): boolean;
+    isInside(entity: Entity): boolean;
+    renderCollection(outArr: EntityCollection[], visibleNodes: NodesDict, renderingNode: number): void;
+}

package/lib/@openglobus/js/quadTree/earth/EarthEntityCollectionsTreeStrategy.d.ts

@@ -0,0 +1,19 @@
+import { EntityCollectionNode } from "../EntityCollectionNode";
+import { EarthEntityCollectionNodeLonLat } from "./EarthEntityCollectionNodeLonLat";
+import { Vector } from "../../layer/Vector";
+import { Entity } from "../../entity/Entity";
+import { EntityCollection } from "../../entity/EntityCollection";
+import { EntityCollectionsTreeStrategy } from "../EntityCollectionsTreeStrategy";
+export declare class EarthEntityCollectionsTreeStrategy extends EntityCollectionsTreeStrategy {
+    protected _entityCollectionsTree: EntityCollectionNode;
+    protected _entityCollectionsTreeNorth: EarthEntityCollectionNodeLonLat;
+    protected _entityCollectionsTreeSouth: EarthEntityCollectionNodeLonLat;
+    _renderingNodesNorth: Record<number, boolean>;
+    _renderingNodesSouth: Record<number, boolean>;
+    constructor(layer: Vector, nodeCapacity: number);
+    insertEntity(entity: Entity, rightNow?: boolean): void;
+    setPickingEnabled(pickingEnabled: boolean): void;
+    dispose(): void;
+    insertEntities(entitiesForTree: Entity[]): void;
+    collectVisibleEntityCollections(outArr: EntityCollection[]): void;
+}