@openglobus/og 0.22.2 → 0.24.0

package/lib/@openglobus/js/light/LightSource.d.ts

@@ -2,173 +2,35 @@ import { Vec3 } from "../math/Vec3";
 import { RenderNode } from "../scene/RenderNode";
 export interface ILightSourceParams {
     position?: Vec3;
-    directional?: boolean;
     ambient?: Vec3;
     diffuse?: Vec3;
     specular?: Vec3;
     shininess?: number;
 }
-/**
- * Represents basic light source.
- * @class
- * @param {string} [name] - Light source name.
- * @param {ILightSourceParams} [params] - Light parameters:
- * @param {Vec3} [params.position] - Light source position if it is a point light, otherwise it is a light direction vector.
- * @param {Vec3} [params.ambient]  - Ambient RGB color.
- * @param {Vec3} [params.diffuse]  - Diffuse RGB color.
- * @param {Vec3} [params.specular]  - Specular RGB color.
- * @param {number} [params.shininess]  - Specular shininess.
- */
 declare class LightSource {
-    static __counter__: number;
-    /**
-     * Light name.
-     * @protected
-     * @type {string}
-     */
-    protected _name: string;
-    /**
-     * Render node where light is shines.
-     * @protected
-     * @type {RenderNode}
-     */
     protected _renderNode: RenderNode | null;
-    /**
-     * Light position.
-     * @public
-     * @type {Vec3}
-     */
     _position: Vec3;
-    /**
-     * True if the light is directional.
-     * @public
-     * @type {boolean}
-     */
-    directional: boolean;
-    /**
-     * Ambient color.
-     * @protected
-     * @type {Vec3}
-     */
     protected _ambient: Vec3;
-    /**
-     * Diffuse color.
-     * @protected
-     * @type {Vec3}
-     */
     protected _diffuse: Vec3;
-    /**
-     * Specular color.
-     * @protected
-     * @type {Vec3}
-     */
     protected _specular: Vec3;
-    /**
-     * Shininess.
-     * @protected
-     * @type {number}
-     */
     protected _shininess: number;
-    /**
-     * Light activity.
-     * @protected
-     * @type {boolean}
-     */
     protected _active: boolean;
     protected _tempAmbient: Vec3;
     protected _tempDiffuse: Vec3;
     protected _tempSpecular: Vec3;
     protected _tempShininess: number;
-    constructor(name: string, params: ILightSourceParams);
-    /**
-     * Creates clone of the current light object.
-     * @todo: TODO
-     * @public
-     * @returns {LightSource}
-     */
-    clone(): void;
-    /**
-     * Set light activity. If activity is false the light doesn't shine.
-     * @public
-     * @param {boolean} active - Light activity.
-     */
-    setActive(active: boolean): void;
-    /**
-     * Gets light activity.
-     * @public
-     * @returns {boolean}
-     */
+    constructor(params: ILightSourceParams);
     isActive(): boolean;
-    /**
-     * Set light source position, or if it is a directional type sets light direction vector.
-     * @public
-     * @param {Vec3} position - Light position or direction vector.
-     */
     setPosition3v(position: Vec3): void;
-    /**
-     * Set light source position, or if it is a directional type sets light direction vector.
-     * @public
-     */
     setPosition(x: number, y: number, z: number): void;
-    /**
-     * Returns light source position, or if it is a directional type sets light direction vector.
-     * @public
-     * @returns {Vec3} - Light source position/direction.
-     */
     getPosition(): Vec3;
-    /**
-     * Set ambient color.
-     * @public
-     * @param {Vec3} rgb - Ambient color.
-     */
     setAmbient3v(rgb: Vec3): void;
-    /**
-     * Set diffuse color.
-     * @public
-     * @param {Vec3} rgb - Diffuse color.
-     */
     setDiffuse3v(rgb: Vec3): void;
-    /**
-     * Set specular color.
-     * @public
-     * @param {Vec3} rgb - Specular color.
-     */
     setSpecular3v(rgb: Vec3): void;
-    /**
-     * Set ambient color.
-     * @public
-     */
     setAmbient(r: number, g: number, b: number): void;
-    /**
-     * Set diffuse color.
-     * @public
-     */
     setDiffuse(r: number, g: number, b: number): void;
-    /**
-     * Set specular color.
-     * @public
-     */
     setSpecular(r: number, g: number, b: number): void;
-    /**
-     * Set material shininess.
-     * @public
-     */
     setShininess(shininess: number): void;
-    /**
-     * Sets light to black.
-     * @public
-     */
-    setBlack(): void;
-    /**
-     * Adds current light to the render node scene.
-     * @public
-     * @param {RenderNode} renderNode - Render node scene.
-     */
     addTo(renderNode: RenderNode): void;
-    /**
-     * Removes from render node scene.
-     * @public
-     */
-    remove(): void;
 }
 export { LightSource };

package/lib/@openglobus/js/math/Mat3.d.ts

@@ -67,7 +67,7 @@ export declare class Mat3 {
      * @public
      * @returns {Mat4}
      */
-    toMatrix4(): Mat4;
+    getMat4(): Mat4;
 }
 /**
  * Mat3 factory.

package/lib/@openglobus/js/math/Mat4.d.ts

@@ -37,6 +37,15 @@ export declare class Mat4 {
      * @returns {Mat4} -
      */
     static identity(): Mat4;
+    /**
+     * Get rotation matrix around the point
+     * @public
+     * @param {number} angle - Rotation angle in radians
+     * @param {Vec3} [center] - Point that the camera rotates around
+     * @param {Vec3} [up] - Camera up vector
+     */
+    static getRotationAroundPoint(angle: number, center?: Vec3, up?: Vec3): Mat4;
+    static getRotation(angle: number, up?: Vec3): Mat4;
     /**
      * Sets column-major order array matrix.
      * @public
@@ -62,7 +71,7 @@ export declare class Mat4 {
      * @public
      * @returns {Mat3} -
      */
-    toMatrix3(): Mat3;
+    getMat3(): Mat3;
     /**
      * Multiply to 3d vector.
      * @public

package/lib/@openglobus/js/math/Plane.d.ts

@@ -9,7 +9,9 @@ import { Line3 } from "./Line3";
 declare class Plane {
     p: Vec3;
     n: Vec3;
-    constructor(p: Vec3, n: Vec3);
+    constructor(p?: Vec3, n?: Vec3);
+    setByPoints(v0: Vec3, v1: Vec3, v2: Vec3): Plane;
+    static fromPoints(v0: Vec3, v1: Vec3, v2: Vec3): Plane;
     set(p: Vec3, n: Vec3): void;
     getNormal(): Vec3;
     distance(p: Vec3): number;

package/lib/@openglobus/js/math/Quat.d.ts

@@ -118,13 +118,18 @@ export declare class Quat {
      * @returns {Quat} -
      */
     static getRotationBetweenVectorsUp(source: Vec3, dest: Vec3, up: Vec3): Quat;
-    static setFromEulerAngles(pitch: number, yaw: number, roll: number): Quat;
     /**
      * Returns true if the components are zero.
      * @public
      * @returns {boolean} -
      */
     isZero(): boolean;
+    /**
+     * Returns true if a component is NaN.
+     * @public
+     * @returns {boolean} -
+     */
+    isNaN(): boolean;
     /**
      * Clear Quat. Sets zeroes.
      * @public
@@ -167,6 +172,13 @@ export declare class Quat {
      * @returns {Quat} -
      */
     add(q: Quat): Quat;
+    /**
+     * Computes the componentwise sum of two Quats.
+     * @public
+     * @param {Quat} q - Quat to add.
+     * @returns {Quat} -
+     */
+    addRes(q: Quat, res: Quat): Quat;
     /**
      * Computes the componentwise difference of two Quats.
      * @public
@@ -194,6 +206,15 @@ export declare class Quat {
      * @returns {Array.<number>} - (exactly 4 entries)
      */
     toVec(): [number, number, number, number];
+    get xyz(): Vec3;
+    /**
+     * Sets rotation with the given heading and up vectors.
+     * @static
+     * @param {Vec3} forward - Heading target coordinates.
+     * @param {Vec3} up - Up vector.
+     * @returns {Quat} -
+     */
+    setLookRotation(forward: Vec3, up: Vec3): Quat;
     /**
      * Sets current quaternion by spherical coordinates.
      * @public
@@ -203,20 +224,12 @@ export declare class Quat {
      * @returns {Quat} -
      */
     setFromSphericalCoords(lat: number, lon: number, angle: number): Quat;
-    /**
-     * Sets rotation with the given heading and up vectors.
-     * @static
-     * @param {Vec3} forward - Heading target coordinates.
-     * @param {Vec3} up - Up vector.
-     * @returns {Quat} -
-     */
-    setLookRotation(forward: Vec3, up: Vec3): Quat;
     /**
      * Gets spherical coordinates.
      * @public
      * @returns {Object} Returns object with latitude, longitude and alpha.
      */
-    toSphericalCoords(): any;
+    getSphericalCoords(): any;
     /**
      * Sets current Quat representing a rotation around an axis.
      * @public
@@ -228,9 +241,16 @@ export declare class Quat {
     /**
      * Returns axis and angle of the current Quat.
      * @public
-     * @returns {Object} -
+     * @returns { axis: Vec3, angle: number } -
      */
-    getAxisAngle(): any;
+    getAxisAngle(): {
+        axis: Vec3;
+        angle: number;
+    };
+    getPitch(): number;
+    getYaw(): number;
+    getRoll(): number;
+    setPitchYawRoll(pitchRad: number, yawRad: number, rollRad: number, frame?: Quat): Quat;
     /**
      * Sets current Quat by Euler's angles.
      * @public
@@ -274,6 +294,14 @@ export declare class Quat {
      * @returns {Vec3} -
      */
     mulVec3(v: Vec3): Vec3;
+    /**
+     * Returns quaternion and vector production.
+     * @public
+     * @param {Vec3} v - 3d Vector.
+     * @param {Vec3} res - result output vector.
+     * @returns {Vec3} -
+     */
+    mulVec3Res(v: Vec3, res: Vec3): Vec3;
     /**
      * Computes the product of two Quats.
      * @public
@@ -281,6 +309,13 @@ export declare class Quat {
      * @returns {Quat} -
      */
     mul(q: Quat): Quat;
+    /**
+     * Computes the product of two Quats.
+     * @public
+     * @param {Quat} q - Quat to multiply.
+     * @returns {Quat} -
+     */
+    mulRes(q: Quat, res: Quat): Quat;
     /**
      * Computes the product of two Quats.
      * @public
@@ -340,27 +375,6 @@ export declare class Quat {
      * @returns {Quat} -
      */
     slerp(b: Quat, t: number): Quat;
-    /**
-     * Returns a roll angle in radians.
-     * @public
-     * @param {Boolean} [reprojectAxis] -
-     * @returns {Number} -
-     */
-    getRoll(reprojectAxis?: boolean): number;
-    /**
-     * Returns a pitch angle in radians.
-     * @public
-     * @param {Boolean} [reprojectAxis] -
-     * @returns {number} -
-     */
-    getPitch(reprojectAxis?: boolean): number;
-    /**
-     * Returns a yaw angle in radians.
-     * @public
-     * @param {Boolean} [reprojectAxis] -
-     * @returns {number} -
-     */
-    getYaw(reprojectAxis?: boolean): number;
 }
 /**
  * Creates Quat instance.

package/lib/@openglobus/js/math/Ray.d.ts

@@ -1,6 +1,7 @@
 import { Box } from "../bv/Box";
 import { Sphere } from "../bv/Sphere";
 import { Vec3 } from "./Vec3";
+import { Plane } from "./Plane";
 /**
  * Represents a ray that extends infinitely from the provided origin in the provided direction.
  * @class
@@ -38,14 +39,13 @@ export declare class Ray {
      */
     set(origin: Vec3, direction: Vec3): Ray;
     /**
-     * Computes the point along the ray on the distance.
-     * @public
-     * @param {number} distance - Point distance.
-     * @returns {Vec3}
+     * Get a point on the ray at a given distance `t`.
+     * @param {number} distance - Distance from the origin along the ray.
+     * @returns {Vec3} The point at distance `t`.
      */
     getPoint(distance: number): Vec3;
     /**
-     * Returns ray hit a triange result.
+     * Returns ray hit a triangle result.
      * @public
      * @param {Vec3} v0 - First triangle corner coordinate.
      * @param {Vec3} v1 - Second triangle corner coordinate.
@@ -54,17 +54,13 @@ export declare class Ray {
      * @returns {number} - Hit code, could 0 - og.Ray.OUTSIDE, 1 - og.Ray.INSIDE,
      *      2 - og.Ray.INPLANE and 3 - og.Ray.AWAY(ray goes away from triangle).
      */
-    hitTriangle(v0: Vec3, v1: Vec3, v2: Vec3, res: Vec3): number;
+    hitTriangleRes(v0: Vec3, v1: Vec3, v2: Vec3, res: Vec3): number;
     /**
-     * Gets a ray hit a plane result. If the ray cross the plane returns 1 - og.Ray.INSIDE otherwise returns 0 - og.Ray.OUTSIDE.
-     * @public
-     * @param {Vec3} v0 - First plane point.
-     * @param {Vec3} v1 - Second plane point.
-     * @param {Vec3} v2 - Third plane point.
-     * @param {Vec3} res - Hit point object pointer that stores hit result.
-     * @returns {number}
+     * Finds the intersection of the ray with a plane.
+     * @param {Plane} plane - The plane to intersect with.
+     * @returns {Vec3 | null} The intersection point or null if no intersection.
      */
-    hitPlane(v0: Vec3, v1: Vec3, v2: Vec3, res: Vec3): number;
+    hitPlaneRes(plane: Plane, res: Vec3): number;
     /**
      * Returns a ray hit sphere coordiante. If there isn't hit returns null.
      * @public

package/lib/@openglobus/js/math/Vec2.d.ts

@@ -92,6 +92,15 @@ export declare class Vec2 {
      * @returns {Vec2}
      */
     static orthoNormalize(normal: Vec2, tangent: Vec2): Vec2;
+    /**
+     * Get projection of the vector to plane where n - normal to the plane.
+     * @static
+     * @param {Vec2} b - Vector to project.
+     * @param {Vec2} n - Plane normal.
+     * @param {Vec2} [def] - Default value for non existed result.
+     * @returns {Vec2} -
+     */
+    static proj_b_to_plane(b: Vec2, n: Vec2, def?: Vec3): Vec2;
     /**
      * Converts to 3d vector, third value is 0.0.
      * @public
@@ -221,10 +230,17 @@ export declare class Vec2 {
     clear(): Vec2;
     /**
      * Returns normalized vector.
+     * @deprecated
      * @public
      * @returns {Vec2}
      */
     normal(): Vec2;
+    /**
+     * Returns normalized vector.
+     * @public
+     * @returns {Vec2}
+     */
+    getNormal(): Vec2;
     /**
      * Normalize current vector.
      * @public
@@ -299,6 +315,12 @@ export declare class Vec2 {
      * @returns {Vec2}
      */
     slerp(v2: Vec2, t: number): Vec2;
+    /**
+     * Returns true if vector's values are zero.
+     * @public
+     * @returns {boolean} -
+     */
+    isZero(): boolean;
 }
 /**
  * Vector 2d object creator.

package/lib/@openglobus/js/math/Vec3.d.ts

@@ -241,6 +241,13 @@ export declare class Vec3 {
      * @returns {Vec3} Returns a sum vector.
      */
     add(p: Vec3): Vec3;
+    /**
+     * Gets two vectors summarization.
+     * @public
+     * @param {Vec3} p - Vector to add.
+     * @returns {Vec3} Returns a sum vector.
+     */
+    addRes(p: Vec3, res: Vec3): Vec3;
     /**
      * Subtract vector from the current.
      * @public
@@ -283,6 +290,13 @@ export declare class Vec3 {
      * @returns {Vec3} -
      */
     mul(vec: Vec3): Vec3;
+    /**
+     * Multiply current vector object to another and returns new vector instance.
+     * @public
+     * @param {Vec3} vec - Multiply vector.
+     * @returns {Vec3} -
+     */
+    mulRes(vec: Vec3, res: Vec3): Vec3;
     /**
      * Divide current vector's components to another. Results stores in the current vector object.
      * @public
@@ -452,6 +466,7 @@ export declare class Vec3 {
      * @returns {Vec3} -
      */
     slerp(v2: Vec3, t: number): Vec3;
+    mulVecA(a: Vec3): Vec3;
     /**
      * Gets the shortest arc quaternion to rotate this vector to the destination vector.
      * @param {Vec3} dest -

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

@@ -70,7 +70,7 @@ export declare function log(n: number, base: number): number;
 /**
  * Clamp the number.
  * @function
- * @param {number} number - Input number.
+ * @param {number} value - Input number.
  * @param {number} min - Minimal edge.
  * @param {number} max - Maximal edge.
  * @returns {number} -
@@ -78,7 +78,7 @@ export declare function log(n: number, base: number): number;
  * clamp(12, 1, 5)
  * //returns 5
  */
-export declare function clamp(number: number, min: number, max: number): number;
+export declare function clamp(value: number, min: number, max: number): number;
 /**
  * Converts degrees value to radians.
  * @function

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

@@ -16,7 +16,7 @@ declare class EntityCollectionNode {
     layer: Vector;
     strategy: EntityCollectionsTreeStrategy;
     parentNode: EntityCollectionNode | null;
-    childrenNodes: EntityCollectionNode[];
+    childNodes: EntityCollectionNode[];
     partId: number;
     nodeId: number;
     state: number | null;
@@ -34,7 +34,7 @@ declare class EntityCollectionNode {
     __setLonLat__(entity: Entity): LonLat;
     buildTree(entities: Entity[], rightNow?: boolean): void;
     isInside(entity: Entity): boolean;
-    createChildrenNodes(): void;
+    createChildNodes(): void;
     collectRenderCollectionsPASS1(visibleNodes: NodesDict, outArr: EntityCollection[]): void;
     collectRenderCollectionsPASS2(visibleNodes: NodesDict, outArr: EntityCollection[], renderingNodeId: number): void;
     applyCollection(): void;

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

@@ -33,7 +33,7 @@ declare class Node {
     inFrustum: number;
     _fadingNodes: Node[];
     constructor(SegmentPrototype: typeof Segment, planet: Planet, partId: number, parent: Node | null, tileZoom: number, extent: Extent);
-    createChildrenNodes(): void;
+    createChildNodes(): void;
     createBounds(): void;
     getState(): number | null;
     /**

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

@@ -9,7 +9,7 @@ export declare class EarthEntityCollectionNodeLonLat extends EntityCollectionNod
     isNorth: boolean;
     strategy: EarthEntityCollectionsTreeStrategy;
     constructor(strategy: EarthEntityCollectionsTreeStrategy, partId: number, parent: EarthEntityCollectionNodeLonLat | null, extent: Extent, planet: Planet, zoom: number);
-    createChildrenNodes(): void;
+    createChildNodes(): void;
     protected _setExtentBounds(): void;
     __setLonLat__(entity: Entity): LonLat;
     isVisible(): boolean;

package/lib/@openglobus/js/quadTree/equi/EquiEntityCollectionNodeLonLat.d.ts

@@ -8,7 +8,7 @@ import { EquiEntityCollectionsTreeStrategy } from "./EquiEntityCollectionsTreeSt
 export declare class EquiEntityCollectionNodeLonLat extends EntityCollectionNode {
     strategy: EquiEntityCollectionsTreeStrategy;
     constructor(strategy: EquiEntityCollectionsTreeStrategy, partId: number, parent: EquiEntityCollectionNodeLonLat | null, extent: Extent, planet: Planet, zoom: number);
-    createChildrenNodes(): void;
+    createChildNodes(): void;
     protected _setExtentBounds(): void;
     __setLonLat__(entity: Entity): LonLat;
     isVisible(): boolean;