@openglobus/og 0.24.1 → 0.25.0

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

@@ -1,257 +0,0 @@
-import { Entity } from "./Entity";
-import { Quat, Vec3, Vec4 } from "../math/index";
-import { GeoObjectHandler } from "./GeoObjectHandler";
-import { InstanceData } from "./InstanceData";
-import type { NumberArray3 } from "../math/Vec3";
-import type { NumberArray4 } from "../math/Vec4";
-import { Object3d } from "../Object3d";
-export declare const LOCAL_FORWARD: Vec3;
-/**
- * Interface for GeoObject parameters.
- * @typedef {Object} IGeoObjectParams
- * @property {Object3d} [object3d] - 3D object associated with the geo object.
- * @property {string} [objSrc] - Source url of the 3D object.
- * @property {string} [tag] - Unique instancing drawing identifier tag.
- * @property {Vec3 | NumberArray3} [position] - Position in Cartesian coordinates.
- * @property {number | Vec3 | NumberArray3} [scale] - Scale of the object.
- * @property {Vec3 | NumberArray3} [translate] - Translation offset.
- * @property {Vec4 | NumberArray4 | string} [color] - RGBA color or HTML color string.
- * @property {boolean} [visibility] - Visibility flag.
- */
-export interface IGeoObjectParams {
-    object3d?: Object3d;
-    objSrc?: string;
-    tag?: string;
-    position?: Vec3 | NumberArray3;
-    scale?: number | Vec3 | NumberArray3;
-    translate?: Vec3 | NumberArray3;
-    color?: Vec4 | NumberArray4 | string;
-    visibility?: boolean;
-}
-/**
- * Represents 3D object on the the globe or 3d space
- * @class
- * @param {IGeoObjectParams} options -  Geo object parameters:
- * @param {Object3d} [options.object3d] - 3D object associated with the geo object.
- * @param {string} [options.objSrc] - Source url of the 3D object.
- * @param {string} [options.tag] - Unique instancing drawing identifier tag.
- * @param {Vec3 | NumberArray3} [options.position] - Position in Cartesian coordinates.
- * @param {number | Vec3 | NumberArray3} [options.scale=1] - Scale of the object.
- * @param {Vec3 | NumberArray3} [options.translate] - Translation offset.
- * @param {Vec4 | NumberArray4 | string} [options.color] - RGBA color or HTML color string.
- * @param {boolean} [options.visibility=true] - Visibility flag.
- *
- * @todo: GeoObject and GeoObjectHandler provides instanced objects only.
- * It would be nice if it could provide not instanced rendering loop too.
- */
-declare class GeoObject {
-    protected _tag: string;
-    static __counter__: number;
-    /**
-     * Entity instance that holds this geo object.
-     * @public
-     * @type {Entity}
-     */
-    _entity: Entity | null;
-    /**
-     * Geo object center cartesian position.
-     * @protected
-     * @type {Vec3}
-     */
-    protected _position: Vec3;
-    _rtcPositionHigh: Vec3;
-    _rtcPositionLow: Vec3;
-    protected _scale: Vec3;
-    protected _translate: Vec3;
-    protected _localPosition: Vec3;
-    /**
-     * RGBA color.
-     * @public
-     * @type {Vec4}
-     */
-    _color: Vec4;
-    protected _qFrame: Quat;
-    _qRot: Quat;
-    protected _direction: Vec3;
-    _handler: GeoObjectHandler | null;
-    _handlerIndex: number;
-    _tagData: InstanceData | null;
-    _tagDataIndex: number;
-    protected _object3d: Object3d;
-    _objectSrc?: string;
-    protected _visibility: boolean;
-    protected _children: GeoObject[];
-    constructor(options: IGeoObjectParams);
-    /**
-     * Gets the unique tag of the geo object.
-     * @returns {string}
-     */
-    get tag(): string;
-    /**
-     * Gets the position of the geo object.
-     * @public
-     * @returns {Vec3}
-     */
-    getPosition(): Vec3;
-    /**
-     * Gets the 3D object associated with this geo object.
-     * @public
-     * @returns {Object3d}
-     */
-    get object3d(): Object3d;
-    /**
-     * Gets geometry mesh vertices.
-     * @public
-     * @returns {number[]}
-     */
-    get vertices(): number[];
-    /**
-     * Gets geometry mesh normals.
-     * @public
-     * @returns {number[]}
-     */
-    get normals(): number[];
-    /**
-     * Gets geometry mesh texture coordinates.
-     * @public
-     * @returns {number[]}
-     */
-    get texCoords(): number[];
-    /**
-     * Gets geometry mesh indices.
-     * @public
-     * @returns {number[]}
-     */
-    get indices(): number[];
-    /**
-     * Sets the opacity of the geo object.
-     * @param {number} a - Opacity value (0 to 1).
-     */
-    setOpacity(a: number): void;
-    /**
-     * Gets the opacity of the geo object.
-     * @returns {number}
-     */
-    getOpacity(): number;
-    /**
-     * Sets the color of the geo object.
-     * @param {number} r - Red component.
-     * @param {number} g - Green component.
-     * @param {number} b - Blue component.
-     * @param {number} [a] - Alpha component.
-     */
-    setColor(r: number, g: number, b: number, a?: number): void;
-    /**
-     * Sets color.
-     * @public
-     * @param {Vec3 | Vec4} color - RGBA vector.
-     */
-    setColor4v(color: Vec3 | Vec4): void;
-    /**
-     * Sets geo object visibility.
-     * @public
-     * @param {boolean} visibility - Visibility flag.
-     */
-    setVisibility(visibility: boolean): void;
-    /**
-     * Returns geo object visibility.
-     * @public
-     * @returns {boolean}
-     */
-    getVisibility(): boolean;
-    /**
-     * Sets geo object position.
-     * @public
-     * @param {number} x - X coordinate.
-     * @param {number} y - Y coordinate.
-     * @param {number} z - Z coordinate.
-     */
-    setPosition(x: number, y: number, z: number): void;
-    updateRTCPosition(): void;
-    /**
-     * Sets geo object position.
-     * @public
-     * @param {Vec3} position - Cartesian coordinates.
-     */
-    setPosition3v(position: Vec3): void;
-    /**
-     * Sets Object3d for the object
-     * @param {Object3d} object
-     */
-    setObject(object: Object3d): void;
-    /**
-     * Sets the object url source.
-     * @param {string} src
-     */
-    setObjectSrc(src: string): void;
-    /**
-     * Sets object HTML color.
-     * @param {string} color
-     */
-    setColorHTML(color: string): void;
-    /**
-     * Sets scales.
-     * @public
-     * @param {number} scale
-     */
-    setScale(scale: number): void;
-    /**
-     * Sets X, Y, Z axis scales
-     * @public
-     * @param {Vec3} scale
-     */
-    setScale3v(scale: Vec3): void;
-    /**
-     * Gets scale.
-     * @publci
-     * @returns {Vec3}
-     */
-    getScale(): Vec3;
-    setTranslate3v(translate: Vec3): void;
-    getTranslate(): Vec3;
-    /**
-     * Sets local offset position.
-     * @param {Vec3} localPosition
-     */
-    setLocalPosition3v(localPosition: Vec3): void;
-    /**
-     * Gets local offset position.
-     * @public
-     * @returns {Vec3}
-     */
-    getLocalPosition(): Vec3;
-    /**
-     * Removes the geo object from the handler.
-     * @public
-     */
-    remove(): void;
-    /**
-     * Sets billboard picking color.
-     * @public
-     * @param {Vec3} color - Picking color.
-     */
-    setPickingColor3v(color: Vec3): void;
-    /**
-     * Sets the rotation quaternion.
-     * @public
-     * @param {Quat} qRot - Rotation quaternion.
-     */
-    setRotation(qRot: Quat): void;
-    /**
-     * Returns orientation quaternion.
-     * @public
-     * @returns {Quat}
-     */
-    getRotation(): Quat;
-    /**
-     * Update object rotation
-     */
-    updateRotation(): void;
-    /**
-     * Returns object direction
-     * @publcu
-     * @returns {Vec3}
-     */
-    getDirection(): Vec3;
-}
-export { GeoObject };

package/lib/js/entity/GeoObject.js

@@ -1,318 +0,0 @@
-import * as utils from "../utils/shared";
-import { Quat, Vec3, Vec4 } from "../math/index";
-import { Object3d } from "../Object3d";
-export const LOCAL_FORWARD = new Vec3(0.0, 0.0, -1.0);
-/**
- * Represents 3D object on the the globe or 3d space
- * @class
- * @param {IGeoObjectParams} options -  Geo object parameters:
- * @param {Object3d} [options.object3d] - 3D object associated with the geo object.
- * @param {string} [options.objSrc] - Source url of the 3D object.
- * @param {string} [options.tag] - Unique instancing drawing identifier tag.
- * @param {Vec3 | NumberArray3} [options.position] - Position in Cartesian coordinates.
- * @param {number | Vec3 | NumberArray3} [options.scale=1] - Scale of the object.
- * @param {Vec3 | NumberArray3} [options.translate] - Translation offset.
- * @param {Vec4 | NumberArray4 | string} [options.color] - RGBA color or HTML color string.
- * @param {boolean} [options.visibility=true] - Visibility flag.
- *
- * @todo: GeoObject and GeoObjectHandler provides instanced objects only.
- * It would be nice if it could provide not instanced rendering loop too.
- */
-class GeoObject {
-    constructor(options) {
-        this._handlerIndex = -1;
-        this._tag = options.tag || `tag_${GeoObject.__counter__++}`;
-        this._entity = null;
-        this._position = utils.createVector3(options.position);
-        this._rtcPositionHigh = new Vec3();
-        this._rtcPositionLow = new Vec3();
-        this._scale = utils.createVector3(options.scale, new Vec3(1, 1, 1));
-        this._translate = utils.createVector3(options.translate, new Vec3());
-        this._localPosition = new Vec3();
-        this._color = utils.createColorRGBA(options.color, new Vec4(0.15, 0.15, 0.15, 1.0));
-        this._handler = null;
-        this._handlerIndex = -1;
-        this._tagData = null;
-        this._tagDataIndex = -1;
-        let object3d = options.object3d;
-        if ((!options.object3d || options.object3d?.vertices.length === 0)) {
-            object3d = new Object3d();
-        }
-        if (options.objSrc) {
-            this.setObjectSrc(options.objSrc);
-            this._objectSrc = options.objSrc;
-        }
-        this._object3d = object3d;
-        // if (options.colorTexture) {
-        //     this.setColorTexture(options.colorTexture)
-        // }
-        this._visibility = (options.visibility != undefined ? options.visibility : true);
-        this._children = [];
-        this._direction = new Vec3();
-        this._qFrame = new Quat();
-        this._qRot = Quat.IDENTITY;
-    }
-    /**
-     * Gets the unique tag of the geo object.
-     * @returns {string}
-     */
-    get tag() {
-        return this._tag;
-    }
-    /**
-     * Gets the position of the geo object.
-     * @public
-     * @returns {Vec3}
-     */
-    getPosition() {
-        return this._position;
-    }
-    /**
-     * Gets the 3D object associated with this geo object.
-     * @public
-     * @returns {Object3d}
-     */
-    get object3d() {
-        return this._object3d;
-    }
-    /**
-     * Gets geometry mesh vertices.
-     * @public
-     * @returns {number[]}
-     */
-    get vertices() {
-        return this._object3d.vertices;
-    }
-    /**
-     * Gets geometry mesh normals.
-     * @public
-     * @returns {number[]}
-     */
-    get normals() {
-        return this._object3d.normals;
-    }
-    /**
-     * Gets geometry mesh texture coordinates.
-     * @public
-     * @returns {number[]}
-     */
-    get texCoords() {
-        return this._object3d.texCoords;
-    }
-    /**
-     * Gets geometry mesh indices.
-     * @public
-     * @returns {number[]}
-     */
-    get indices() {
-        return this._object3d.indices;
-    }
-    /**
-     * Sets the opacity of the geo object.
-     * @param {number} a - Opacity value (0 to 1).
-     */
-    setOpacity(a) {
-        this._color.w = a;
-        this.setColor(this._color.x, this._color.y, this._color.z, a);
-    }
-    /**
-     * Gets the opacity of the geo object.
-     * @returns {number}
-     */
-    getOpacity() {
-        return this._color.w;
-    }
-    /**
-     * Sets the color of the geo object.
-     * @param {number} r - Red component.
-     * @param {number} g - Green component.
-     * @param {number} b - Blue component.
-     * @param {number} [a] - Alpha component.
-     */
-    setColor(r, g, b, a) {
-        this._color.x = r;
-        this._color.y = g;
-        this._color.z = b;
-        a != undefined && (this._color.w = a);
-        this._handler && this._handler.setRgbaArr(this._tagData, this._tagDataIndex, this._color);
-    }
-    /**
-     * Sets color.
-     * @public
-     * @param {Vec3 | Vec4} color - RGBA vector.
-     */
-    setColor4v(color) {
-        this._color.x = color.x;
-        this._color.y = color.y;
-        this._color.z = color.z;
-        color.w != undefined && (this._color.w = color.w);
-        this._handler && this._handler.setRgbaArr(this._tagData, this._tagDataIndex, this._color);
-    }
-    /**
-     * Sets geo object visibility.
-     * @public
-     * @param {boolean} visibility - Visibility flag.
-     */
-    setVisibility(visibility) {
-        this._visibility = visibility;
-        this._handler && this._handler.setVisibility(this._tagData, this._tagDataIndex, visibility);
-    }
-    /**
-     * Returns geo object visibility.
-     * @public
-     * @returns {boolean}
-     */
-    getVisibility() {
-        return this._visibility;
-    }
-    /**
-     * Sets geo object position.
-     * @public
-     * @param {number} x - X coordinate.
-     * @param {number} y - Y coordinate.
-     * @param {number} z - Z coordinate.
-     */
-    setPosition(x, y, z) {
-        this._position.x = x;
-        this._position.y = y;
-        this._position.z = z;
-        this.updateRTCPosition();
-        this.updateRotation();
-    }
-    updateRTCPosition() {
-        //Vec3.doubleToTwoFloats(this._position, this._rtcPositionHigh, this._rtcPositionLow);
-        if (this._handler) {
-            this._handler.getRTCPosition(this._position, this._rtcPositionHigh, this._rtcPositionLow);
-            this._handler.setRTCPositionArr(this._tagData, this._tagDataIndex, this._rtcPositionHigh, this._rtcPositionLow);
-        }
-    }
-    /**
-     * Sets geo object position.
-     * @public
-     * @param {Vec3} position - Cartesian coordinates.
-     */
-    setPosition3v(position) {
-        this.setPosition(position.x, position.y, position.z);
-    }
-    /**
-     * Sets Object3d for the object
-     * @param {Object3d} object
-     */
-    setObject(object) {
-        this._object3d = object;
-    }
-    /**
-     * Sets the object url source.
-     * @param {string} src
-     */
-    setObjectSrc(src) {
-        this._objectSrc = src;
-        this._handler && this._handler.setObjectSrc(src, this.tag);
-    }
-    /**
-     * Sets object HTML color.
-     * @param {string} color
-     */
-    setColorHTML(color) {
-        this.setColor4v(utils.htmlColorToRgba(color));
-    }
-    /**
-     * Sets scales.
-     * @public
-     * @param {number} scale
-     */
-    setScale(scale) {
-        this._scale.x = this._scale.y = this._scale.z = scale;
-        this._handler && this._handler.setScaleArr(this._tagData, this._tagDataIndex, this._scale);
-    }
-    /**
-     * Sets X, Y, Z axis scales
-     * @public
-     * @param {Vec3} scale
-     */
-    setScale3v(scale) {
-        this._scale.copy(scale);
-        this._handler && this._handler.setScaleArr(this._tagData, this._tagDataIndex, scale);
-    }
-    /**
-     * Gets scale.
-     * @publci
-     * @returns {Vec3}
-     */
-    getScale() {
-        return this._scale;
-    }
-    setTranslate3v(translate) {
-        this._translate.copy(translate);
-        this._handler && this._handler.setTranslateArr(this._tagData, this._tagDataIndex, translate);
-    }
-    getTranslate() {
-        return this._translate.clone();
-    }
-    /**
-     * Sets local offset position.
-     * @param {Vec3} localPosition
-     */
-    setLocalPosition3v(localPosition) {
-        this._localPosition.copy(localPosition);
-        this._handler && this._handler.setLocalPositionArr(this._tagData, this._tagDataIndex, localPosition);
-    }
-    /**
-     * Gets local offset position.
-     * @public
-     * @returns {Vec3}
-     */
-    getLocalPosition() {
-        return this._localPosition.clone();
-    }
-    /**
-     * Removes the geo object from the handler.
-     * @public
-     */
-    remove() {
-        this._entity = null;
-        this._handler && this._handler.remove(this);
-    }
-    /**
-     * Sets billboard picking color.
-     * @public
-     * @param {Vec3} color - Picking color.
-     */
-    setPickingColor3v(color) {
-        this._handler && this._handler.setPickingColorArr(this._tagData, this._tagDataIndex, color);
-    }
-    /**
-     * Sets the rotation quaternion.
-     * @public
-     * @param {Quat} qRot - Rotation quaternion.
-     */
-    setRotation(qRot) {
-        this._qRot.copy(qRot);
-        this._qRot.mulVec3Res(LOCAL_FORWARD, this._direction).normalize();
-        this.updateRotation();
-    }
-    /**
-     * Returns orientation quaternion.
-     * @public
-     * @returns {Quat}
-     */
-    getRotation() {
-        return this._qRot;
-    }
-    /**
-     * Update object rotation
-     */
-    updateRotation() {
-        this._handler && this._handler.setQRotArr(this._tagData, this._tagDataIndex, this._qRot);
-    }
-    /**
-     * Returns object direction
-     * @publcu
-     * @returns {Vec3}
-     */
-    getDirection() {
-        return this._direction.clone();
-    }
-}
-GeoObject.__counter__ = 0;
-export { GeoObject };

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

@@ -1,81 +0,0 @@
-import { EntityCollection } from "./EntityCollection";
-import { GeoObject } from "./GeoObject";
-import { Vec3 } from "../math/Vec3";
-import { Vec4 } from "../math/Vec4";
-import { Quat } from "../math/Quat";
-import { Object3d } from "../Object3d";
-import { InstanceData } from "./InstanceData";
-import { Renderer } from "../renderer/Renderer";
-import { RenderNode } from "../scene/RenderNode";
-export declare const VERTEX_BUFFER = 0;
-export declare const RTC_POSITION_BUFFER = 1;
-export declare const RGBA_BUFFER = 2;
-export declare const NORMALS_BUFFER = 3;
-export declare const INDEX_BUFFER = 4;
-export declare const QROT_BUFFER = 5;
-export declare const SIZE_BUFFER = 6;
-export declare const PICKINGCOLOR_BUFFER = 7;
-export declare const VISIBLE_BUFFER = 8;
-export declare const TEXCOORD_BUFFER = 9;
-export declare const TRANSLATE_BUFFER = 10;
-export declare const LOCALPOSITION_BUFFER = 11;
-export declare class GeoObjectHandler {
-    static __counter__: number;
-    protected __id: number;
-    /**
-     * Picking rendering option.
-     * @public
-     * @type {boolean}
-     */
-    pickingEnabled: boolean;
-    protected _entityCollection: EntityCollection;
-    _renderNode: RenderNode | null;
-    _renderer: Renderer | null;
-    protected _geoObjects: GeoObject[];
-    protected _instanceDataMap: Map<string, InstanceData>;
-    protected _instanceDataMapValues: InstanceData[];
-    protected _dataTagUpdateQueue: InstanceData[];
-    protected _relativeCenter: Vec3;
-    protected _rtcEyePositionHigh: Float32Array;
-    protected _rtcEyePositionLow: Float32Array;
-    constructor(entityCollection: EntityCollection);
-    initProgram(): void;
-    setRenderNode(renderNode: RenderNode): void;
-    setColorTextureTag(src: string, tag: string): void;
-    setNormalTextureTag(src: string, tag: string): void;
-    setMetallicRoughnessTextureTag(src: string, tag: string): void;
-    setObjectSrc(src: string, tag: string): void;
-    _updateInstanceData(object: Object3d, tag: string): void;
-    protected _addGeoObjectToArray(geoObject: GeoObject): void;
-    protected _bindCommon(): void;
-    _displayOpaquePASS(): void;
-    _displayTransparentPASS(): void;
-    protected _depthPASS(): void;
-    drawDepth(): void;
-    drawPicking(): void;
-    protected _pickingPASS(): void;
-    _loadColorTexture(tagData: InstanceData): Promise<void>;
-    _loadNormalTexture(tagData: InstanceData): Promise<void>;
-    _loadMetallicRoughnessTexture(tagData: InstanceData): Promise<void>;
-    setQRotArr(tagData: InstanceData, tagDataIndex: number, qRot: Quat): void;
-    setVisibility(tagData: InstanceData, tagDataIndex: number, visibility: boolean): void;
-    setRTCPositionArr(tagData: InstanceData, tagDataIndex: number, rtcPositionHigh: Vec3, rtcPositionLow: Vec3): void;
-    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;
-    setLocalPositionArr(tagData: InstanceData, tagDataIndex: number, localPosition: Vec3): void;
-    protected _updateTag(dataTag: InstanceData): void;
-    update(): void;
-    _removeAll(): void;
-    clear(): void;
-    getRTCPosition(pos: Vec3, rtcPositionHigh: Vec3, rtcPositionLow: Vec3): void;
-    setRelativeCenter(c: Vec3): void;
-    protected _updateRTCEyePosition(): void;
-    draw(): void;
-    drawTransparent(): void;
-    add(geoObject: GeoObject): void;
-    remove(geoObject: GeoObject): void;
-    _clearDataTagQueue(): void;
-    _removeGeoObject(geoObject: GeoObject): void;
-}