@pirireis/webglobeplugins 0.9.9 → 0.9.10

package/util/account/single-attribute-buffer-management/buffer-orchestrator.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BufferOrchestrator = void 0;
+const EXTRA_SIZE = 10;
+class BufferOrchestrator {
+    constructor({ capacity = 10 } = {}) {
+        this._capacity = capacity;
+        this.offsetMap = new Map();
+        this.tombstoneOffsets = [];
+        this._length = 0;
+    }
+    resetWithCapacity(bufferManagersMap, capacity = null) {
+        this._capacity = capacity !== null ? capacity : this._capacity;
+        for (const [key, { bufferManager }] of bufferManagersMap) {
+            bufferManager.resetWithCapacity(this._capacity);
+        }
+        this.offsetMap.clear();
+        this.tombstoneOffsets = [];
+        this._length = 0;
+    }
+    insertBulk(items, bufferManagersMap) {
+        this.autoExtendBuffers(items.length, bufferManagersMap);
+        const { offsetMap } = this;
+        const offsets = [];
+        for (const item of items) {
+            let o = offsetMap.get(item.key);
+            const offset = o !== undefined ? o : this.nextOffset();
+            offsetMap.set(item.key, offset);
+            offsets.push(offset);
+        }
+        for (const [key, { bufferManager, adaptor }] of bufferManagersMap) {
+            bufferManager.insertBulk(items.map(adaptor), offsets);
+        }
+    }
+    // does not assign offset to the new items.
+    updateBulk(items, bufferManagersMap, bufferKeys = null) {
+        const { offsetMap } = this;
+        const offsets = [];
+        for (const item of items) {
+            const offset = offsetMap.get(item.key);
+            if (offset !== undefined) {
+                offsets.push(offset);
+            }
+            else {
+                throw new Error("updateBulk item Key does not exist");
+            }
+        }
+        if (bufferKeys) {
+            for (const key of bufferKeys) {
+                const bufferManagerComp = bufferManagersMap.get(key);
+                if (bufferManagerComp === undefined)
+                    throw new Error("updateBulk bufferKey does not exist");
+                const { bufferManager, adaptor } = bufferManagerComp;
+                bufferManager.insertBulk(items.map(adaptor), offsets);
+            }
+        }
+        else {
+            for (const [key, { bufferManager, adaptor }] of bufferManagersMap) {
+                bufferManager.insertBulk(items.map(adaptor), offsets);
+            }
+        }
+    }
+    deleteBulk(keys, bufferManagersMap) {
+        const offsets = [];
+        for (const key of keys) {
+            const offset = this.getOffset(key);
+            if (offset !== undefined) {
+                offsets.push(offset);
+                this.offsetMap.delete(key);
+                this.tombstoneOffsets.push(offset);
+            }
+        }
+        for (const [key, { bufferManager }] of bufferManagersMap) {
+            bufferManager.deleteBulk(offsets);
+        }
+    }
+    getOffset(key) {
+        return this.offsetMap.get(key);
+    }
+    nextOffset() {
+        if (this.tombstoneOffsets.length > 0) {
+            const offset = this.tombstoneOffsets.pop();
+            return offset;
+        }
+        if (this._length < this._capacity) {
+            return this._length++;
+        }
+        return false;
+    }
+    autoExtendBuffers(itemsLength, bufferManagersMap) {
+        if (itemsLength <= this.emptySpace)
+            return;
+        const newCapacity = this.length + itemsLength;
+        for (const [key, { bufferManager }] of bufferManagersMap) {
+            bufferManager.extendBuffer(this.length, newCapacity);
+        }
+        this._capacity = newCapacity;
+    }
+    defrag(bufferManagers, bufferKeys) {
+        const offsetMap = this.offsetMap;
+        const newCapacity = offsetMap.size + EXTRA_SIZE;
+        if (bufferKeys) {
+            for (const key of bufferKeys) {
+                const offset = offsetMap.get(key);
+                if (offset !== undefined) {
+                    for (const [key, { bufferManager }] of bufferManagers) {
+                        bufferManager.defrag([offset], this.length, newCapacity);
+                    }
+                }
+            }
+        }
+        else {
+            for (const [key, { bufferManager }] of bufferManagers) {
+                bufferManager.defrag(offsetMap.values(), this.length, newCapacity);
+            }
+        }
+        this._defrag();
+        this._length = offsetMap.size;
+        this._capacity = newCapacity;
+        this.tombstoneOffsets = [];
+    }
+    /**
+     * Flushes metadata and sets length to 0 without actualize change on buffers
+     * This method created for cases in which data is loaded on each frame
+     */
+    flush({ capacity = 10 } = {}) {
+        this._length = 0;
+        this._capacity = capacity;
+        this.tombstoneOffsets = [];
+        this.offsetMap.clear();
+    }
+    _defrag() {
+        const newOffsetMap = new Map();
+        let newOffset = 0;
+        for (const [key, offset] of this.offsetMap) {
+            newOffsetMap.set(key, newOffset++);
+        }
+        this.offsetMap = newOffsetMap;
+    }
+    get length() {
+        return this._length;
+    }
+    get emptySpace() {
+        return this._capacity - this.offsetMap.size;
+    }
+    get capacity() {
+        return this._capacity;
+    }
+}
+exports.BufferOrchestrator = BufferOrchestrator;

package/util/account/single-attribute-buffer-management/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObjectStore = exports.BufferManager = exports.BufferOrchestrator = void 0;
+const buffer_orchestrator_1 = require("./buffer-orchestrator");
+Object.defineProperty(exports, "BufferOrchestrator", { enumerable: true, get: function () { return buffer_orchestrator_1.BufferOrchestrator; } });
+const buffer_manager_1 = require("./buffer-manager");
+Object.defineProperty(exports, "BufferManager", { enumerable: true, get: function () { return buffer_manager_1.BufferManager; } });
+const object_store_1 = require("./object-store");
+Object.defineProperty(exports, "ObjectStore", { enumerable: true, get: function () { return object_store_1.ObjectStore; } });

package/util/account/single-attribute-buffer-management/object-store.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObjectStore = void 0;
+class ObjectStore {
+    constructor({ initialCapcity = 10 } = {}) {
+        this._container = this._createEmptyList(initialCapcity);
+    }
+    resetWithCapacity(capacity) {
+        this._container = this._createEmptyList(capacity);
+    }
+    deleteBulk(offsets) {
+        for (let i = 0; i < offsets.length; i++) {
+            const offset = offsets[i];
+            if (offset !== undefined) {
+                this._container[offset] = null;
+            }
+        }
+    }
+    insertBulk(objects, offsets) {
+        for (let i = 0; i < objects.length; i++) {
+            const object = objects[i];
+            const offset = offsets[i];
+            if (offset !== undefined) {
+                this._container[offset] = object;
+            }
+        }
+    }
+    defrag(offsetValues, occupiedCapacity, newCapacity) {
+        const hold = this._createEmptyList(newCapacity);
+        for (let i = 0; i < offsetValues.length; i++) {
+            const offset = offsetValues[i];
+            if (offset !== undefined) {
+                hold[i] = this._container[offset];
+            }
+        }
+        this._container = hold;
+    }
+    extendBuffer(occupiedCapacity, newCapacity) {
+        const oldCapacity = this._container.length;
+        this._container = this._container.concat(this._createEmptyList(newCapacity - oldCapacity));
+    }
+    _createEmptyList(size) {
+        return new Array(size).fill(null);
+    }
+    get(index) {
+        return this._container[index];
+    }
+    free() {
+    }
+}
+exports.ObjectStore = ObjectStore;

package/util/account/single-attribute-buffer-management/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/util/account/util.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.vaoAttributeLoader = void 0;
+const vaoAttributeLoader = (gl, buffer, index, size, stride, offset, divisor = null, type = null) => {
+    if (!gl || !buffer) {
+        throw new Error("Invalid WebGL context or buffer");
+    }
+    if (index < 0) {
+        throw new Error("Attribute index must be non-negative");
+    }
+    if (stride < 0 || offset < 0) {
+        throw new Error("Stride and offset must be non-negative");
+    }
+    const attribType = type === null ? gl.FLOAT : type;
+    gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
+    gl.enableVertexAttribArray(index);
+    gl.vertexAttribPointer(index, size, attribType, false, stride, offset);
+    if (divisor !== null) {
+        gl.vertexAttribDivisor(index, divisor);
+    }
+};
+exports.vaoAttributeLoader = vaoAttributeLoader;

package/util/algorithms/index.js

@@ -0,0 +1 @@
+"use strict";

package/util/algorithms/search-binary.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * @typedef {Array<number>} ListLike
+ * @typedef {number || null} Index
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findFirstIndexInRange = void 0;
+/**
+ * @param {ListLike} container
+ * @param {number} value
+ * @returns {Index}
+ */
+const findFirstIndexInRange = (container, value) => {
+    let start = 0;
+    let end = container.length - 1;
+    let mid = 0;
+    while (start <= end) {
+        mid = Math.floor((start + end) / 2);
+        if (container[mid] <= value && value <= container[mid + 1])
+            return mid;
+        if (container[mid] < value)
+            start = mid + 1;
+        else
+            end = mid - 1;
+    }
+    return null;
+};
+exports.findFirstIndexInRange = findFirstIndexInRange;

package/util/check/get.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapGetOrThrow = void 0;
+const mapGetOrThrow = (errorNote) => {
+    return (mapInstance, ids) => {
+        if (!ids)
+            throw new Error("There is no map keys to get");
+        const result = [];
+        for (let i = 0; i < ids.length; i++) {
+            const e = mapInstance.get(ids[i]);
+            if (e === undefined)
+                throw new Error(errorNote + " " + ids[i]);
+            result.push(e);
+        }
+        return result;
+    };
+};
+exports.mapGetOrThrow = mapGetOrThrow;

package/util/check/index.js

@@ -0,0 +1 @@
+"use strict";

package/util/check/typecheck.js

@@ -0,0 +1,49 @@
+"use strict";
+// Generic
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isBoolean = exports.constraintFloat = exports.isTextFont = exports.opacityCheck = exports.isHexColorWithOpacity = exports.isHexColor = void 0;
+const doesOwnProperties = (properties, errorMessage) => {
+    return (object) => {
+        properties.forEach(element => {
+            if (!Object.hasOwn(object, element))
+                throw new TypeError(errorMessage + ':' + element);
+        });
+    };
+};
+const isHexColor = (hexColor) => /^#[0-9A-F]{6}$/i.test(hexColor);
+exports.isHexColor = isHexColor;
+const isHexColorWithOpacity = (hexColor) => /^#[0-9A-F]{6}[0-9a-f]{0,2}$/i.test(hexColor);
+exports.isHexColorWithOpacity = isHexColorWithOpacity;
+const opacityCheck = (opacity) => {
+    if (typeof opacity !== "number")
+        throw new TypeError("style.opacity must a number");
+    if (opacity < 0 || 1 < opacity)
+        throw new RangeError("Opacity Range Must be 0-1");
+};
+exports.opacityCheck = opacityCheck;
+// Text Related 
+const fontCheckTypes = doesOwnProperties(["name", "textColor", "hollowColor", "size", "bold", "italic"], "font does not have");
+const fontCheckColors = (textColor, hollowColor) => (0, exports.isHexColor)(textColor) && (0, exports.isHexColor)(hollowColor);
+const isTextFont = (textFont) => {
+    fontCheckTypes(textFont);
+    fontCheckColors(textFont.textColor, textFont.hollowColor);
+    if (typeof textFont.size !== "number")
+        throw new TypeError("textFont size is not a number");
+};
+exports.isTextFont = isTextFont;
+const constraintFloat = (x, lowerBound = null, upperBound = null) => {
+    if (typeof x !== "number")
+        throw new Error("type must be numberic");
+    if (lowerBound === null && upperBound === null)
+        return;
+    if (lowerBound !== null && lowerBound > x)
+        throw new Error(`input must be greater than ${lowerBound}`);
+    if (upperBound !== null && x > upperBound)
+        throw new Error(`input must be less than ${upperBound}`);
+};
+exports.constraintFloat = constraintFloat;
+const isBoolean = (x) => {
+    if (typeof x !== "boolean")
+        throw new TypeError("type must be boolean");
+};
+exports.isBoolean = isBoolean;

package/util/geometry/index.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBBoxMatrix = createBBoxMatrix;
+exports.latLongToPixelXY = latLongToPixelXY;
+exports.latLongBboxtoPixelXYBbox = latLongBboxtoPixelXYBbox;
+exports.sphereCoord = sphereCoord;
+exports.normalize = normalize;
+function latLongToPixelXY(latitude, longitude) {
+    return {
+        x: (longitude + 180) / 360,
+        y: (90 - latitude) / 180
+    };
+}
+/**
+ * createBBoxMatrix( minX, maxX, minY, maxY)
+ * use this matrix to transform a point from 0 to 1 range to the bounding box
+ * for example: Transform image coordinates to map coordinates
+ * glsl`vec3 pos = u_bbox_matrix * vec3(v_particle_pos.x, v_particle_pos.y, 1.0);`
+ */
+function createBBoxMatrix(minX, maxX, minY, maxY) {
+    return new Float32Array([
+        maxX - minX, 0, 0,
+        0, maxY - minY, 0,
+        minX, minY, 1
+    ]);
+}
+function latLongBboxtoPixelXYBbox(minX, minY, maxX, maxY) {
+    const minXY = latLongToPixelXY(minY, minX);
+    const maxXY = latLongToPixelXY(maxY, maxX);
+    return createBBoxMatrix(minXY.x, maxXY.x, minXY.y, maxXY.y);
+}
+/**
+ *
+ * @param {Float32List} array
+ * @returns {Float32Array}
+ */
+function normalize(array, newLength = 1) {
+    let total = 0;
+    for (let i = 0; i < array.length; i++) {
+        total += array[i] * array[i];
+    }
+    const len = newLength / Math.sqrt(total);
+    const result = new Float32Array(array.length);
+    for (let i = 0; i < array.length; i++) {
+        result[i] = array[i] * len;
+    }
+    return result;
+}
+function sphereCoord(long, lat, globe, height = 0) {
+    return normalize(globe.api_GetCartesian3DPoint(long, lat, 0, 0), 6378.137 + height);
+}

package/util/gl-util/buffer/attribute-loader.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBufferAndReadInfo = exports.attributeLoader = void 0;
+require("./types");
+/**
+ * @typedef BufferAndReadInfo Buffers can be intertwined or interleaved.
+ * This object forces user to adapt generic convention of buffer and read information.
+ * @type {Object}
+ * @property {WebGLBuffer} buffer
+ * @property {number} stride
+ * @property {number} offset
+ */
+/**
+ *
+ * @param {WebGLBuffer} gl
+ * @param {BufferAndReadInfo} bufferAndReadInfo
+ * @param {number} index
+ * @param {number} size
+ * @param {Object} options
+ * @param {*} options.type | default gl.FLOAT, gl.UNSIGNED_BYTE, gl.SHORT, gl.UNSIGNED_SHORT, gl.INT, gl.UNSIGNED_INT
+ * @param {number} options.divisor
+ * @param {Array<number>} options.escapeValues
+ * @returns
+ */
+const attributeLoader = (gl, bufferAndReadInfo, index, size, { divisor = null, type = null, escapeValues = null, normalized = false } = {}) => {
+    if (size < 1 || size > 4)
+        throw new Error("Size must be between 1 and 4");
+    if (bufferAndReadInfo == null) {
+        if (escapeValues !== null)
+            constantFunction(gl, index, size, escapeValues);
+        return;
+    }
+    const { buffer, stride, offset } = bufferAndReadInfo;
+    if (!gl || !buffer) {
+        throw new Error("Invalid WebGL context or buffer");
+    }
+    if (index < 0) {
+        throw new Error("Attribute index must be non-negative");
+    }
+    if (stride < 0 || offset < 0) {
+        throw new Error("Stride and offset must be non-negative");
+    }
+    const attribType = type === null ? gl.FLOAT : type;
+    gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
+    gl.enableVertexAttribArray(index);
+    gl.vertexAttribPointer(index, size, attribType, normalized, stride, offset);
+    if (divisor !== null) {
+        gl.vertexAttribDivisor(index, divisor);
+    }
+};
+exports.attributeLoader = attributeLoader;
+/**
+ *
+ * @param {WebGLBuffer} buffer
+ * @param {number} stride
+ * @param {number} offset
+ * @returns {BufferAndReadInfo}
+ */
+const createBufferAndReadInfo = (buffer, stride = 0, offset = 0) => {
+    if (buffer == null)
+        return null;
+    return { buffer, stride, offset };
+};
+exports.createBufferAndReadInfo = createBufferAndReadInfo;
+const constantFunction = (gl, index, size, escapeValues) => {
+    const func = `vertexAttrib${size}f`;
+    // @ts-ignore
+    gl[func](index, ...escapeValues);
+};

package/util/gl-util/buffer/index.js

@@ -0,0 +1,6 @@
+"use strict";
+// import './types';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.attributeLoader = void 0;
+const attribute_loader_1 = require("./attribute-loader");
+Object.defineProperty(exports, "attributeLoader", { enumerable: true, get: function () { return attribute_loader_1.attributeLoader; } });

package/util/gl-util/buffer/types.js

@@ -0,0 +1 @@
+"use strict";

package/util/gl-util/draw-options/methods.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.drawInstanced = exports.drawArrays = void 0;
+require("./types");
+/**
+ * Draws instanced geometry using WebGL2.
+ */
+const drawInstanced = (gl, mode, drawOptions, vertexCount) => {
+    var _a;
+    const { drawRange, elementBufferIndexType = gl.UNSIGNED_INT } = drawOptions;
+    const { first = 0, count: instanceCount = 1 } = drawRange;
+    if (first > 0 || drawOptions.elementBuffer) {
+        gl.bindBuffer(gl.ELEMENT_ARRAY_BUFFER, (_a = drawOptions.elementBuffer) !== null && _a !== void 0 ? _a : null);
+        gl.drawElementsInstanced(mode, vertexCount, elementBufferIndexType, first, instanceCount);
+        gl.bindBuffer(gl.ELEMENT_ARRAY_BUFFER, null);
+    }
+    else {
+        gl.drawArraysInstanced(mode, first, vertexCount, instanceCount);
+    }
+};
+exports.drawInstanced = drawInstanced;
+/**
+ * Draws geometry using WebGL2.
+ */
+const drawArrays = (gl, defaultMode, drawOptions) => {
+    const { drawRange, elementBuffer, elementBufferIndexType = gl.UNSIGNED_INT, drawMode = null } = drawOptions;
+    const { first = 0, count } = drawRange;
+    const mode = drawMode !== null && drawMode !== void 0 ? drawMode : defaultMode;
+    if (elementBuffer) {
+        gl.bindBuffer(gl.ELEMENT_ARRAY_BUFFER, elementBuffer);
+        gl.drawElements(mode, count, elementBufferIndexType, first);
+        gl.bindBuffer(gl.ELEMENT_ARRAY_BUFFER, null);
+    }
+    else {
+        gl.drawArrays(mode, first, count);
+    }
+};
+exports.drawArrays = drawArrays;

package/util/gl-util/draw-options/types.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * @typedef DrawRange
+ * @type {Object}
+ * @property {int} first
+ * @property {int} count
+ *
+ * @typedef DrawRangeIndexParams
+ * @type {Object}
+ * @property {null|DrawRange} drawRange
+ * @property {null|ElementBuffer} elementBuffer
+ * @property {null|indexType} indexType
+ * @property {null|int} drawMode
+ *
+ */