@openglobus/og 0.11.1 → 0.11.6

package/types/segment/Segment.d.ts

@@ -0,0 +1,279 @@
+export const MAX_NORMAL_ZOOM: 7;
+/**
+ * Planet segment Web Mercator tile class that stored and rendered with quad tree.
+ * @class
+ * @param {quadTree.Node} node - Segment node.
+ * @param {Planet} planet - Current planet scene.
+ * @param {Number} tileZoom - Zoom index.
+ * @param {Extent} extent - Segment extent.
+ */
+export class Segment {
+    /**
+     * @param {quadTree.Node} node - Segment node.
+     * @param {Planet} planet - Current planet scene.
+     * @param {number} tileZoom - Zoom index.
+     * @param {Extent} extent - Segment extent.
+     */
+    constructor(node: quadTree.Node, planet: Planet, tileZoom: number, extent: Extent);
+    isPole: boolean;
+    _tileGroup: number;
+    _projection: import("../proj/Proj.js").Proj;
+    /**
+     * Quad tree node of the segment.
+     * @type {quadTree.Node}
+     */
+    node: quadTree.Node;
+    /**
+     * Planet pointer.
+     * @type {Planet}
+     */
+    planet: Planet;
+    /**
+     * WebGl handler pointer.
+     * @type {Handler}
+     */
+    handler: Handler;
+    /**
+     * Segment bounding sphere
+     * @type {Sphere}
+     */
+    bsphere: Sphere;
+    _plainRadius: number;
+    /**
+     * Segment bounding box.
+     * @type {Box}
+     */
+    bbox: Box;
+    _swNorm: any;
+    _nwNorm: any;
+    _seNorm: any;
+    _neNorm: any;
+    /**
+     * Geographical extent.
+     * @type {Extent}
+     */
+    _extent: Extent;
+    _extentLonLat: Extent;
+    /**
+     * Vertices grid size.
+     * @type {number}
+     */
+    gridSize: number;
+    fileGridSize: number;
+    /**
+     * Tile zoom index.
+     * @type {number}
+     */
+    tileZoom: number;
+    /**
+     * Horizontal tile index.
+     * @type {number}
+     */
+    tileX: number;
+    tileXE: number;
+    tileXW: number;
+    tileYN: number;
+    tileYS: number;
+    /**
+     * Vertical tile index.
+     * @type {number}
+     */
+    tileY: number;
+    tileIndex: string;
+    /**
+     * Texture materials array.
+     * @type {Array.<planetSegment.Material>}
+     */
+    materials: Array<planetSegment.Material>;
+    /**
+     * Plain segment vertices was created.
+     * @type {boolean}
+     */
+    plainReady: boolean;
+    /**
+     * Segment is ready to create plain vertices.
+     * @type {boolean}
+     */
+    initialized: boolean;
+    /**
+     * Normal map is allready made.
+     * @type {boolean}
+     */
+    normalMapReady: boolean;
+    /**
+     * Parent normal map is made allready(optimization parameter).
+     * @type {boolean}
+     */
+    parentNormalMapReady: boolean;
+    /**
+     * Terrain is allready applied flag.
+     * @type {boolean}
+     */
+    terrainReady: boolean;
+    /**
+     * Terrain is loading now flag.
+     * @type {boolean}
+     */
+    terrainIsLoading: boolean;
+    /**
+     * Terrain existing flag.
+     * @type {boolean}
+     */
+    terrainExists: boolean;
+    plainVertices: any;
+    plainVerticesHigh: any;
+    plainVerticesLow: any;
+    plainNormals: any;
+    terrainVertices: any;
+    terrainVerticesHigh: any;
+    terrainVerticesLow: any;
+    noDataVertices: any;
+    tempVertices: any;
+    tempVerticesHigh: any;
+    tempVerticesLow: any;
+    normalMapTexture: any;
+    normalMapTextureBias: Float32Array;
+    normalMapVertices: any;
+    normalMapVerticesHigh: any;
+    normalMapVerticesLow: any;
+    normalMapNormals: any;
+    vertexNormalBuffer: any;
+    vertexPositionBuffer: any;
+    vertexPositionBufferHigh: any;
+    vertexPositionBufferLow: any;
+    vertexTextureCoordBuffer: any;
+    _globalTextureCoordinates: Float32Array;
+    _inTheQueue: boolean;
+    _appliedNeighborsZoom: number[];
+    _renderingSlices: any[];
+    _indexBuffer: any;
+    readyToEngage: boolean;
+    plainProcessing: boolean;
+    /**
+     * Returns that segment good for rendering with camera by current lod ratio.
+     * @public
+     * @param {Camera} camera - Camera object.
+     * @returns {boolean} -
+     */
+    public acceptForRendering(camera: Camera): boolean;
+    /**
+     * Returns entity terrain point.
+     * @public
+     * @param {Entity} entity - Entity.
+     * @param {Vec3} res - Point coordinates.
+     * @param {Vec3} [normal] - Terrain point normal.
+     * @returns {Vec3} -
+     */
+    public getEntityTerrainPoint(entity: Entity, res: Vec3, normal?: Vec3): Vec3;
+    isEntityInside(e: any): boolean;
+    /**
+     * Returns distance from object to terrain coordinates and terrain point that calculates out in the res parameter.
+     * @public
+     * @param {Vec3} xyz - Cartesian object position.
+     * @param {LonLat} insideSegmentPosition - Geodetic object position.
+     * @param {Vec3} [res] - Result cartesian coordiantes on the terrain.
+     * @param {Vec3} [normal] - Terrain point normal.
+     * @returns {number} -
+     */
+    public getTerrainPoint(xyz: Vec3, insideSegmentPosition: LonLat, res?: Vec3, normal?: Vec3): number;
+    /**
+     * Project wgs86 to segment native projection.
+     * @public
+     * @param {LonLat} lonlat - Coordinates to project.
+     * @returns {LonLat} -
+     */
+    public projectNative(lonlat: LonLat): LonLat;
+    /**
+     *
+     * @param {boolean} forceLoading
+     */
+    loadTerrain(forceLoading: boolean): void;
+    /**
+     * Terrain obtained from server.
+     * @param {Float32Array} elevations - Elevation data.
+     */
+    elevationsExists(elevations: Float32Array): void;
+    _checkEqualization(neighborSide: any, neigborNode: any): boolean;
+    equalize(): void;
+    engage(): void;
+    _plainSegmentWorkerCallback(data: any): void;
+    _terrainWorkerCallback(data: any): void;
+    normalMapTexturePtr: any;
+    /**
+     * Terrain is not obtained or not exists on the server.
+     */
+    elevationsNotExists(): void;
+    _normalMapEdgeEqualize(side: any): void;
+    applyTerrain(elevations: any): void;
+    /**
+     * Delete segment gl buffers.
+     */
+    deleteBuffers(): void;
+    /**
+     * Delete materials.
+     */
+    deleteMaterials(): void;
+    /**
+     * Delete elevation data.
+     */
+    deleteElevations(): void;
+    /**
+     * Clear but not destroy segment data.
+     */
+    clearSegment(): void;
+    /**
+     * Removes cache records.
+     */
+    _freeCache(): void;
+    /**
+     * Clear and destroy all segment data.
+     */
+    destroySegment(): void;
+    _tileOffsetArr: any;
+    _visibleExtentOffsetArr: any;
+    _setExtentLonLat(): void;
+    /**
+     * Creates bound volumes by segment geographical extent.
+     */
+    createBoundsByExtent(): void;
+    createBoundsByParent(): void;
+    setBoundingSphere(x: any, y: any, z: any, v: any): void;
+    setBoundingVolume(xmin: any, ymin: any, zmin: any, xmax: any, ymax: any, zmax: any): void;
+    setBoundingVolume3v(vmin: any, vmax: any): void;
+    setBoundingVolumeArr(bounds: any): void;
+    createCoordsBuffers(verticesHigh: any, verticesLow: any, gridSize: any): void;
+    _addViewExtent(): void;
+    _assignTileIndexes(): void;
+    initialize(): void;
+    _assignGlobalTextureCoordinates(): void;
+    createPlainSegmentAsync(): void;
+    createPlainSegment(): void;
+    _createPlainVertices(): void;
+    /**
+     * Gets specific layer material.
+     * @public
+     * @param {Layer} layer - Layer object.
+     * @returns {planetSegment.Material} - Segment material.
+     */
+    public getMaterialByLayer(layer: Layer): planetSegment.Material;
+    _getLayerExtentOffset(layer: any): number[];
+    screenRendering(sh: any, layerSlice: any, sliceIndex: any, defaultTexture: any, isOverlay: any): void;
+    heightPickingRendering(sh: any, layerSlice: any, sliceIndex: any, defaultTexture: any, isOverlay: any): void;
+    colorPickingRendering(sh: any, layerSlice: any, sliceIndex: any, defaultTexture: any, isOverlay: any): void;
+    depthRendering(sh: any, layerSlice: any, sliceIndex: any, defaultTexture: any, isOverlay: any): void;
+    _getIndexBuffer(): any;
+    _collectVisibleNodes(): void;
+    layerOverlap(layer: any): boolean;
+    getDefaultTexture(): any;
+    getExtentLonLat(): Extent;
+    getExtentMerc(): Extent;
+    getExtent(): Extent;
+    getNodeState(): any;
+    getNeighborSide(b: any): 0 | 1 | 2 | 3 | -1;
+}
+import { Sphere } from "../bv/Sphere.js";
+import { Box } from "../bv/Box.js";
+import { Extent } from "../Extent.js";
+import { Vec3 } from "../math/Vec3.js";
+import { LonLat } from "../LonLat.js";
+import { Layer } from "../layer/Layer.js";

package/types/segment/SegmentLonLat.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Planet segment Web Mercator tile class that stored and rendered with quad tree.
+ * @class
+ * @extends {Segment}
+ * @param {quadNode.Node} node - Quad tree segment node.
+ * @param {Planet} planet - Scene planet.
+ * @param {Number} tileZoom - Segment tile zoom index.
+ * @param {Extent} extent - Segment WGS84 extent.
+ */
+export class SegmentLonLat extends Segment {
+    _extentMerc: Extent;
+    _isNorth: boolean;
+    normalMapNormalsRaw: Float32Array;
+}
+import { Segment } from "./Segment.js";
+import { Extent } from "../Extent.js";

package/types/shaders/geoObject.d.ts

@@ -0,0 +1,3 @@
+export function geo_object(): Program;
+export function geo_object_picking(): Program;
+import { Program } from "../webgl/Program.js";

package/types/shapes/BaseShape.d.ts

@@ -2,10 +2,10 @@
  * Base geometry shape class.
  * @class
  * @param {Object} options - Shape parameters:
- * @param {og.Vec3} [options.position] - Shape position.
- * @param {og.Quat} [options.orientation] - Shape orientation(rotation).
- * @param {og.Vec3} [options.scale] - Scale vector.
- * @param {Array.<number,number,number,number>} [options.color] - Shape RGBA color.
+ * @param {Vec3} [options.position] - Shape position.
+ * @param {Quat} [options.orientation] - Shape orientation(rotation).
+ * @param {Vec3} [options.scale] - Scale vector.
+ * @param {Array.<number>} [options.color] - Shape RGBA color. (exactly 4 entries)
  * @param {string} [options.src] - Texture image url source.
  * @param {boolean} [options.visibility] - Shape visibility.
  */
@@ -23,27 +23,27 @@ export class BaseShape {
     /**
      * Shape position.
      * @public
-     * @type {og.Vec3}
+     * @type {Vec3}
      */
-    public position: any;
+    public position: Vec3;
     /**
      * Shape orientation(rotation)
      * @public
-     * @type {og.Quat}
+     * @type {Quat}
      */
-    public orientation: any;
+    public orientation: Quat;
     /**
      * Scale.
      * @public
-     * @type {og.Vec3}
+     * @type {Vec3}
      */
-    public scale: any;
+    public scale: Vec3;
     /**
      * Shape RGBA color.
      * @public
-     * @type {Array.<number,number,number,number>}
+     * @type {Array.<number>} - (exactly 4 entries)
      */
-    public color: Array<number, number, number, number>;
+    public color: Array<number>;
     /**
      * Shape visibility.
      * @public
@@ -103,21 +103,21 @@ export class BaseShape {
     /**
      * Scale matrix.
      * @protected
-     * @type {og.Mat4}
+     * @type {Mat4}
      */
-    protected _mxScale: any;
+    protected _mxScale: Mat4;
     /**
      * Translation matrix.
      * @protected
-     * @type {og.Mat4}
+     * @type {Mat4}
      */
-    protected _mxTranslation: any;
+    protected _mxTranslation: Mat4;
     /**
      * Model matrix.
      * @protected
-     * @type {og.Mat4}
+     * @type {Mat4}
      */
-    protected _mxModel: any;
+    protected _mxModel: Mat4;
     /**
      * Gl texture pointer.
      * @protected
@@ -126,27 +126,27 @@ export class BaseShape {
     /**
      * Assigned render node.
      * @protected
-     * @type {og.scene.RenderNode}
+     * @type {RenderNode}
      */
-    protected _renderNode: any;
+    protected _renderNode: RenderNode;
     /**
      * Assigned picking color.
      * @protected
-     * @type {Array.<number,number,number>}
+     * @type {Array.<number>} - (exactly 3 entries)
      */
-    protected _pickingColor: Array<number, number, number>;
+    protected _pickingColor: Array<number>;
     /**
      * Entity instance that holds this shape.
      * @protected
-     * @type {og.Entity}
+     * @type {Entity}
      */
-    protected _entity: any;
+    protected _entity: Entity;
     /**
      * Handler that stores and renders this shape object.
      * @protected
-     * @type {og.ShapeHandler}
+     * @type {ShapeHandler}
      */
-    protected _handler: any;
+    protected _handler: ShapeHandler;
     /**
      * Shape handler array index.
      * @protected
@@ -161,15 +161,15 @@ export class BaseShape {
     /**
      * Sets shape color.
      * @public
-     * @param {Array.<number,number,number,number>} color - RGBA color values array.
+     * @param {Array.<number>} color - RGBA color values array. (exactly 4 entries)
      */
-    public setColor(color: Array<number, number, number, number>): void;
+    public setColor(color: Array<number>): void;
     /**
      * Sets shape color.
      * @public
-     * @param {og.Vec4} color - RGBA color vector.
+     * @param {Vec4} color - RGBA color vector.
      */
-    public setColor4v(color: any): void;
+    public setColor4v(color: Vec4): void;
     /**
      * Sets shape opacity value.
      * @public
@@ -196,26 +196,26 @@ export class BaseShape {
     /**
      * Assign render node.
      * @public
-     * @param {og.scene.RenderNode} renderNode - Render node to assign.
+     * @param {RenderNode} renderNode - Render node to assign.
      */
-    public setRenderNode(renderNode: any): void;
+    public setRenderNode(renderNode: RenderNode): void;
     /**
      * Sets shape position.
      * @public
-     * @param {og.Vec3} position - Shape position.
+     * @param {Vec3} position - Shape position.
      */
-    public setPosition3v(position: any): void;
+    public setPosition3v(position: Vec3): void;
     /**
      * Translate shape position to vector.
      * @public
-     * @param {og.Vec3} vec - Translation vector.
+     * @param {Vec3} vec - Translation vector.
      */
-    public translate3v(vec: any): void;
+    public translate3v(vec: Vec3): void;
     /**
      * Sets shape scale.
-     * @param {og.Vec3} scale - Scale vector.
+     * @param {Vec3} scale - Scale vector.
      */
-    setScale3v(scale: any): void;
+    setScale3v(scale: Vec3): void;
     setScale(scale: any): void;
     /**
      * Removes shape from shape handler.
@@ -225,9 +225,9 @@ export class BaseShape {
     /**
      * Assign picking color.
      * @protected
-     * @param {og.Vec3} color - Picking RGB color.
+     * @param {Vec3} color - Picking RGB color.
      */
-    protected setPickingColor3v(color: any): void;
+    protected setPickingColor3v(color: Vec3): void;
     /**
      * Creates buffers.
      * @protected
@@ -245,3 +245,6 @@ export class BaseShape {
     public draw(): void;
     drawPicking(): void;
 }
+import { Vec3 } from "../math/Vec3.js";
+import { Quat } from "../math/Quat.js";
+import { Mat4 } from "../math/Mat4.js";

package/types/shapes/Sphere.d.ts

@@ -1,19 +1,18 @@
 /**
  * @class
- * @extends {og.shape.BaseShape}
+ * @extends {BaseShape}
  * @param {Object} options - Sphere parameters:
- * @param {og.Vec3} [options.position] - Sphere position.
- * @param {og.Quat} [options.orientation] - Sphere orientation(rotation).
- * @param {og.Vec3} [options.scale] - Scale vector.
- * @param {Array.<number,number,number,number>} [options.color] - Sphere RGBA color.
+ * @param {Vec3} [options.position] - Sphere position.
+ * @param {Quat} [options.orientation] - Sphere orientation(rotation).
+ * @param {Vec3} [options.scale] - Scale vector.
+ * @param {Array.<number>} [options.color] - Sphere RGBA color. (exactly 4 entries)
  * @param {string} [options.src] - Texture image url source.
  * @param {boolean} [options.visibility] - Sphere visibility.
  * @param {number} [options.radius=100] - Sphere radius.
  * @param {number} [options.latBands=16] - Number of latitude bands.
  * @param {number} [options.lonBands=16] - Number of longitude bands.
  */
-export class Sphere {
-    constructor(options: any);
+export class Sphere extends BaseShape {
     /**
      * Sphere radius.
      * @protected
@@ -39,3 +38,4 @@ export class Sphere {
      */
     protected _createData(): void;
 }
+import { BaseShape } from "./BaseShape.js";

package/types/terrain/BilTerrain.d.ts

@@ -1,6 +1,5 @@
 export class BilTerrain extends GlobusTerrain {
     constructor(options: any);
-    equalizeVertices: boolean;
     _format: string;
     _layers: any;
     _imageSize: any;

package/types/terrain/EmptyTerrain.d.ts

@@ -40,9 +40,9 @@ export class EmptyTerrain {
     /**
      * Planet node.
      * @protected
-     * @type {og.scene.Planet}
+     * @type {Planet}
      */
-    protected _planet: any;
+    protected _planet: Planet;
     _geoid: any;
     isBlur(): boolean;
     set maxNodeZoom(arg: number);
@@ -53,9 +53,9 @@ export class EmptyTerrain {
      * Loads or creates segment elevation data.
      * @public
      * @virtual
-     * @param {og.planetSegment.Segment} segment - Segment to create elevation data.
+     * @param {Segment} segment - Segment to create elevation data.
      */
-    public handleSegmentTerrain(segment: any): void;
+    public handleSegmentTerrain(segment: Segment): void;
     isReady(): any;
     /**
      * Abstract function

package/types/terrain/GlobusTerrain.d.ts

@@ -1,7 +1,7 @@
 /**
  * Class that loads segment elevation data, converts it to the array and passes it to the planet segment.
  * @class
- * @extends {og.terrain.EmptyTerrain}
+ * @extends {EmptyTerrain}
  * @param {string} [name=""] - Terrain provider name.
  * @param {Object} [options] - Provider options:
  * @param {number} [options.minZoom=3] - Minimal visible zoom index when terrain handler works.
@@ -15,7 +15,7 @@
  * @fires og.terrain.GlobusTerrain#load
  * @fires og.terrain.GlobusTerrain#loadend
  */
-export class GlobusTerrain {
+export class GlobusTerrain extends EmptyTerrain {
     /**
      * @param {string} [name]
      * @param {*} [options]
@@ -24,51 +24,18 @@ export class GlobusTerrain {
     /**
      * Events handler.
      * @public
-     * @type {og.Events}
+     * @type {Events}
      */
-    public events: any;
-    equalizeNormals: boolean;
-    /**
-     * Provider name.
-     * @public
-     * @type {string}
-     */
-    public name: string;
-    /**
-     * Minimal visible zoom index when terrain handler works.
-     * @public
-     * @type {number}
-     */
-    public minZoom: number;
-    /**
-     * Maximal visible zoom index when terrain handler works.
-     * @public
-     * @type {number}
-     */
-    public maxZoom: number;
+    public events: Events;
     /**
      * Terrain source path url template.
      * @public
      * @type {string}
      */
     public url: string;
-    /**
-     * Array of segment triangulation grid sizes where array index agreed to the segment zoom index.
-     * @public
-     * @type {Array.<number>}
-     */
-    public gridSizeByZoom: Array<number>;
     noDataValues: any;
-    /**
-     * Elevation tile grid size.
-     * @public
-     * @type {number}
-     */
-    public plainGridSize: number;
-    _geoid: any;
     _extent: any;
     _dataType: string;
-    _maxNodeZoom: number;
     _elevationCache: {};
     _fetchCache: {};
     _loader: Loader;
@@ -76,22 +43,15 @@ export class GlobusTerrain {
      * Rewrites elevation storage url query.
      * @private
      * @callback og.terrain.GlobusTerrain~_urlRewriteCallback
-     * @param {og.planetSegment.Segment} segment - Segment to load.
+     * @param {Segment} segment - Segment to load.
      * @param {string} url - Created url.
      * @returns {string} - Url query string.
      */
     private _urlRewriteCallback;
-    clearCache(): void;
     getGeoid(): any;
-    isBlur(segment: any): boolean;
     getHeightAsync(lonLat: any, callback: any, zoom: any): boolean;
     getTileCache(lonLat: any, z: any): any;
     _getGroundHeightMerc(merc: any, tileData: any): number;
-    /**
-     * Stop loading.
-     * @public
-     */
-    public abortLoading(): void;
     /**
      * Sets terrain data url template.
      * @public
@@ -111,28 +71,29 @@ export class GlobusTerrain {
      * Starts to load segment data.
      * @public
      * @virtual
-     * @param {og.planetSegment.Segment} segment - Segment that wants a terrain data.
+     * @param {Segment} segment - Segment that wants a terrain data.
+     * @param {boolean} forceLoading
      */
-    public loadTerrain(segment: any, forceLoading: any): void;
+    public loadTerrain(segment: Segment, forceLoading: boolean): void;
     /**
      * Creates query url.
      * @protected
      * @virtual
-     * @param {og.planetSegment.Segment} segment -
+     * @param {Segment} segment -
      * @returns {string} -
      */
-    protected _createUrl(segment: any): string;
+    protected _createUrl(segment: Segment): string;
     /**
      * Returns actual url query string.
      * @protected
-     * @param {og.planetSegment.Segment} segment - Segment that loads image data.
+     * @param {Segment} segment - Segment that loads image data.
      * @returns {string} - Url string.
      */
-    protected _getHTTPRequestString(segment: any): string;
+    protected _getHTTPRequestString(segment: Segment): string;
     /**
      * Sets url rewrite callback, used for custom url rewriting for every tile laoding.
      * @public
-     * @param {og.terrain.GlobusTerrain~_urlRewriteCallback} ur - The callback that returns tile custom created url.
+     * @param {GlobusTerrain~_urlRewriteCallback} ur - The callback that returns tile custom created url.
      */
     public setUrlRewriteCallback(ur: any): void;
     /**
@@ -145,9 +106,11 @@ export class GlobusTerrain {
     public _createHeights(data: any): Array<number>;
     /**
      * @protected
-     * @param {og.planetSegment.Segment} segment -
+     * @param {Segment} segment -
      * @param {*} data -
      */
-    protected _applyElevationsData(segment: any, elevations: any): void;
+    protected _applyElevationsData(segment: Segment, elevations: any): void;
 }
+import { EmptyTerrain } from "./EmptyTerrain.js";
+import { Events } from "../Events.js";
 import { Loader } from "../utils/Loader.js";