@pirireis/webglobeplugins 0.15.34 → 0.16.0

package/dist/programs/rings/distancering/circlepaddingfreeangleprogram.js

@@ -0,0 +1,326 @@
+import { createProgram, shaderfunctions } from "../../../util";
+import { BufferOffsetManager } from "../../../util/account";
+import CameraUniformBlockTotem, { CameraUniformBlockString } from "../../totems/camerauniformblock";
+import { globeProgramCache, noRegisterGlobeProgramCache } from "../../programcache";
+const vertexShader = `#version 300 es ` +
+    shaderfunctions.PI +
+    shaderfunctions.R +
+    shaderfunctions.POLE +
+    CameraUniformBlockString +
+    shaderfunctions.mercatorXYToGLPosition +
+    shaderfunctions.longLatRadToMercator +
+    shaderfunctions.longLatRadToCartesian3D +
+    shaderfunctions.circleLimpFromLongLatRadCenterCartesian3D +
+    shaderfunctions.circleLimpFromLongLatRadCenterMercatorCompass +
+    shaderfunctions.circleLimpFromLongLatRadCenterMercatorRealDistance + `
+
+in vec2 center;
+in float radius;
+in float pad_range;
+in vec4 color;
+in float flag;
+in float pad_angle;
+
+uniform int compass;
+
+uniform float opacity;
+
+out vec2 v_limp;
+out vec4 v_color;
+
+
+void main() {   
+    if( flag == 1.0 || radius == 0.0 ) return; // 1.0 is hide 
+    v_color = vec4(color.rgb, color.a * opacity);
+
+    if ( pad_angle == 0.0 ) v_color.rgb -= 0.2;
+    gl_PointSize = 2.0;
+
+    float odd = mod(float(gl_VertexID), 2.0);
+    float index = (float(gl_VertexID)- odd ) / 2.0;
+    float angle = pad_angle - 1.5707963267948966192313216916398;
+    float radius_ = radius - (pad_range * odd);
+
+    if (is3D){  
+        gl_Position = projection * view * vec4(
+            circleLimpFromLongLatRadCenterCartesian3D( center, radius_, angle) - translate, 1.0);
+        v_limp = vec2(0.0, 0.0);
+        return;
+    }
+    vec2 limp;
+    if ( compass == 1 ){
+        limp = circleLimpFromLongLatRadCenterMercatorCompass(center , radius_, angle);
+    } else {
+        limp = circleLimpFromLongLatRadCenterMercatorRealDistance(center, radius_, angle);
+    }
+    v_limp = limp;
+    gl_Position = mercatorXYToGLPosition(limp);
+}`;
+const fragmentShader = `#version 300 es
+precision highp float; ` +
+    shaderfunctions.POLE + `
+in vec4 v_color;
+in vec2 v_limp;
+out vec4 outColor;
+void main() {
+    if ( v_limp.x < -POLE || v_limp.x > POLE || v_limp.y < -POLE || v_limp.y > POLE ){ discard; }
+    outColor = v_color;
+}`;
+class Logic {
+    constructor(globe) {
+        this.globe = globe;
+        this.gl = globe.gl;
+        this.program = createProgram(this.gl, vertexShader, fragmentShader);
+        {
+            const gl = this.gl;
+            // assign attribute locations
+            gl.bindAttribLocation(this.program, 0, "center");
+            gl.bindAttribLocation(this.program, 1, "radius");
+            gl.bindAttribLocation(this.program, 2, "pad_range");
+            gl.bindAttribLocation(this.program, 3, "color");
+            gl.bindAttribLocation(this.program, 4, "flag");
+            gl.bindAttribLocation(this.program, 5, "pad_angle");
+        }
+        this.cameraBlockBindingPoint = 0;
+        const cameraBlockIndex = this.gl.getUniformBlockIndex(this.program, "CameraUniformBlock");
+        this.gl.uniformBlockBinding(this.program, cameraBlockIndex, this.cameraBlockBindingPoint);
+        this.cameraBlockTotem = globeProgramCache.getProgram(globe, CameraUniformBlockTotem);
+        this._compassLocation = this.gl.getUniformLocation(this.program, "compass");
+        this._opacityLocation = this.gl.getUniformLocation(this.program, "opacity");
+        this._opacity = 1.0;
+        {
+            const currentProgram = this.gl.getParameter(this.gl.CURRENT_PROGRAM);
+            this.gl.useProgram(this.program);
+            this.gl.uniform1i(this._compassLocation, 1);
+            this.gl.uniform1f(this._opacityLocation, 1.0);
+            this._lastCompass = 1;
+            this.gl.useProgram(currentProgram);
+        }
+    }
+    draw(attrBufferManager, compass, opacity) {
+        const { gl, program, cameraBlockBindingPoint, cameraBlockTotem, _compassLocation } = this;
+        gl.useProgram(program);
+        attrBufferManager.bindPaddingVAO();
+        cameraBlockTotem.bind(cameraBlockBindingPoint);
+        if (compass !== this._lastCompass) {
+            gl.uniform1i(_compassLocation, compass);
+            this._lastCompass = compass;
+        }
+        if (opacity !== this._opacity) {
+            gl.uniform1f(this._opacityLocation, opacity);
+            this._opacity = opacity;
+        }
+        gl.disable(gl.DEPTH_TEST);
+        gl.drawArraysInstanced(gl.LINES, 0, 2, attrBufferManager.length);
+        cameraBlockTotem.unbind(cameraBlockBindingPoint);
+        gl.enable(gl.DEPTH_TEST);
+        gl.bindVertexArray(null);
+    }
+    createBuffer({ bufferType = "DYNAMIC_DRAW", initialRingCapacity = 10 } = {}) {
+        return new BufferManager(this.gl, bufferType, initialRingCapacity);
+    }
+}
+const PaddingFreeAngleCache = Object.freeze({
+    getProgram: (globe) => noRegisterGlobeProgramCache.getProgram(globe, Logic),
+    releaseProgram: (globe) => globeProgramCache.releaseProgram(globe, Logic)
+});
+export class BufferManager extends BufferOffsetManager {
+    constructor(gl, bufferType, initialRingCapacity = 10) {
+        super(10, { capacity: initialRingCapacity, bufferType });
+        this.gl = gl;
+        this.bufferType = bufferType;
+        this.buffer = gl.createBuffer();
+        gl.bindBuffer(gl.ARRAY_BUFFER, this.buffer);
+        gl.bufferData(gl.ARRAY_BUFFER, this.capacity * this.itemSize * 4, gl[bufferType]);
+        gl.bindBuffer(gl.ARRAY_BUFFER, null);
+        this._centerMaps = new Map();
+        this.vao = gl.createVertexArray();
+        {
+            gl.bindVertexArray(this.vao);
+            gl.bindBuffer(gl.ARRAY_BUFFER, this.buffer);
+            gl.enableVertexAttribArray(0);
+            gl.enableVertexAttribArray(1);
+            gl.enableVertexAttribArray(2);
+            gl.enableVertexAttribArray(3);
+            gl.enableVertexAttribArray(4);
+            gl.enableVertexAttribArray(5);
+            gl.vertexAttribPointer(0, 2, gl.FLOAT, false, 40, 0);
+            gl.vertexAttribPointer(1, 1, gl.FLOAT, false, 40, 8);
+            gl.vertexAttribPointer(2, 1, gl.FLOAT, false, 40, 12);
+            gl.vertexAttribPointer(3, 4, gl.FLOAT, false, 40, 16);
+            gl.vertexAttribPointer(4, 1, gl.FLOAT, false, 40, 32);
+            gl.vertexAttribPointer(5, 1, gl.FLOAT, false, 40, 36);
+            // divisor
+            gl.vertexAttribDivisor(0, 1);
+            gl.vertexAttribDivisor(1, 1);
+            gl.vertexAttribDivisor(2, 1);
+            gl.vertexAttribDivisor(3, 1);
+            gl.vertexAttribDivisor(4, 1);
+            gl.vertexAttribDivisor(5, 1);
+            gl.bindBuffer(gl.ARRAY_BUFFER, null);
+            gl.bindVertexArray(null);
+        }
+    }
+    bindPaddingVAO() {
+        this.gl.bindVertexArray(this.vao);
+    }
+    insertBulk(data) {
+        const { gl, buffer } = this;
+        const deleteCentersList = [];
+        for (const { centerID } of data) {
+            if (this._centerMaps.has(centerID)) {
+                deleteCentersList.push(centerID);
+            }
+        }
+        if (deleteCentersList.length > 0) {
+            this.removeCenters(deleteCentersList);
+        }
+        const requiredSpace = this.__requiredSpaceForBulk(data);
+        const spaceLeft = this.spaceLeft;
+        // console.log("space left:", spaceLeft, "required space:", requiredSpace);
+        if (requiredSpace > spaceLeft) {
+            // console.log("new capacity:", this.capacity + requiredSpace - spaceLeft)
+            this.extendBuffer(this.capacity + requiredSpace - spaceLeft);
+        }
+        const items = [];
+        for (const { centerID, x, y, rgba, paddingAngles, hide = 0, rings } of data) {
+            this._centerMaps.set(centerID, this.__centerMapMethod(rings, paddingAngles)); // x,y, rgba, hide prograbably not needed
+            for (const { ringID, radius, padding } of rings) {
+                for (const paddingAngle of paddingAngles) {
+                    const _offsetMapKey = `${centerID}_${ringID}_${paddingAngle}`;
+                    const offset = this.getOffset(_offsetMapKey) | this.nextOffset();
+                    items.push({
+                        offset: offset,
+                        payload: new Float32Array([x, y, radius, padding, rgba[0], rgba[1], rgba[2], rgba[3], hide, paddingAngle])
+                    });
+                    this.offSetMap.set(_offsetMapKey, offset);
+                }
+            }
+        }
+        gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
+        for (let { offset, payload } of items) {
+            gl.bufferSubData(gl.ARRAY_BUFFER, offset, payload);
+        }
+    }
+    updateCentersXY(data) {
+        const { gl, buffer } = this;
+        const items = [];
+        for (const { centerID, x, y } of data) {
+            const center = this._centerMaps.get(centerID);
+            const payload = new Float32Array([x, y]);
+            const paddingAngles = center.get("paddingAngles");
+            const rings = center.get("rings");
+            for (const { ringID } of rings) {
+                for (const paddingAngle of paddingAngles) {
+                    const offsetKey = offsetMapKey(centerID, ringID, paddingAngle);
+                    items.push({ offset: this.getOffset(offsetKey), payload });
+                }
+            }
+        }
+        gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
+        for (let { offset, payload } of items) {
+            gl.bufferSubData(gl.ARRAY_BUFFER, offset, payload);
+        }
+        gl.bindBuffer(gl.ARRAY_BUFFER, null);
+    }
+    updateCentersHide(data) {
+        const { gl, buffer } = this;
+        const items = [];
+        for (const { centerID, hide = null } of data) {
+            if (hide === null)
+                continue;
+            const block = new Float32Array([hide]);
+            const center = this._centerMaps.get(centerID);
+            if (!center)
+                continue;
+            const paddingAngles = center.get("paddingAngles");
+            const rings = center.get("rings");
+            for (const { ringID } of rings) {
+                for (const paddingAngle of paddingAngles) {
+                    const offsetKey = offsetMapKey(centerID, ringID, paddingAngle);
+                    items.push({ key: offsetKey, payload: block });
+                }
+            }
+        }
+        this._updatePartial(items, 8, gl, buffer);
+    }
+    updateCentersColor(data) {
+        const { gl, buffer } = this;
+        const items = [];
+        for (const { centerID, rgba } of data) {
+            const center = this._centerMaps.get(centerID);
+            if (!center)
+                continue;
+            center.set("rgba", rgba);
+            const paddingAngles = center.get("paddingAngles");
+            const rings = center.get("rings");
+            const payload = new Float32Array(rgba);
+            for (const { ringID } of rings) {
+                for (const paddingAngle of paddingAngles) {
+                    const offsetKey = offsetMapKey(centerID, ringID, paddingAngle);
+                    items.push({ key: offsetKey, payload });
+                }
+            }
+        }
+        this._updatePartial(items, 4, gl, buffer);
+    }
+    removeCenters(centerIDs) {
+        const keys = [];
+        for (const centerID of centerIDs) {
+            const center = this._centerMaps.get(centerID);
+            if (!center)
+                continue;
+            const rings = center.get("rings");
+            const paddingAngles = center.get("paddingAngles");
+            for (const { ringID } of rings) {
+                for (const paddingAngle of paddingAngles) {
+                    keys.push(offsetMapKey(centerID, ringID, paddingAngle));
+                }
+            }
+            this._centerMaps.delete(centerID);
+        }
+        this._removeFromBuffer(keys);
+    }
+    __requiredSpaceForBulk(data) {
+        let space = 0;
+        for (const { paddingAngles, rings } of data) {
+            space += paddingAngles.length * rings.length;
+        }
+        return space;
+    }
+    __centerMapMethod(rings, paddingAngles) {
+        return new Map([
+            ["rings", rings],
+            ["paddingAngles", paddingAngles]
+        ]);
+    }
+}
+const offsetMapKey = (centerID, ringID, paddingAngle) => `${centerID}_${ringID}_${paddingAngle}`;
+/**
+ * {center has x,y, color, paddingAngles, rings} key: centerID
+ * {ring has ranges, paddings} key: ringKey
+ * _offSetMap => | key: centerID_ringKey_paddingAngle | value: offset |
+ *
+ * insertCenter
+ *
+ * insertRing
+ *
+ * updateCenter ---> updatesRings ---> updatesPaddings
+ *  centerMap          ringMap
+ *   keeps              keeps
+ *  list of Rings   list of Paddings
+ *
+ *
+ * needs an adaptor to convert currently implemented data into this format.
+ * current format:
+ * center = {
+ *  centerID,
+ * x,
+ * y,
+ * rings: [
+ *  radius,
+ *  paddingRadius,
+ *  rgba,
+ * ]
+ * }
+ */ 

package/dist/programs/rings/distancering/circlepaddysharedbuffer.js

@@ -0,0 +1,368 @@
+"use strict";
+// TODO: Delete this file if it is not needed anymore.
+// /**
+//  * ring data model
+//  *  [centerX, centerY, range, padding, r, g, b, a, hide]
+//  *
+//  *  Buffer is initialized with ring capacity and buffer is created with that capacity. It might be called buffer orphaning.
+//  *
+//  * */
+// /**
+//  * TODO
+//  * delete registerCenter
+//  *
+//  *
+//  */
+// const RING_SIZE = 9;
+// export default class {
+//     /**
+//      * @param {WebGL2RenderingContext} gl
+//      * @param {Object} options
+//      * @param {Number} options.initialRingCapacity
+//      * @param {String} options.bufferType - "static" or "dynamic"
+//      * */
+//     constructor(gl, globe, { initialRingCapacity = 20, bufferType = "STATIC_DRAW", implicitExtentionRate = 1.2 } = {}) {
+//         this.gl = gl;
+//         this.globe = globe;
+//         this._capacity = initialRingCapacity;
+//         this._ringCounter = 0;
+//         this._length = 0;
+//         this._centerMap = new Map(); // key, new MAP(x,y, rings:[])
+//         this._ringOffsets = new Map();
+//         this._removedRingsOffsetStack = [];
+//         this._bufferType = gl[bufferType.toUpperCase()];
+//         this.implicitExtentionRate = implicitExtentionRate;
+//         this.buffer = gl.createBuffer();
+//         { // initilize data
+//             gl.bindBuffer(gl.ARRAY_BUFFER, this.buffer);
+//             gl.bufferData(gl.ARRAY_BUFFER, initialRingCapacity * 4 * RING_SIZE, this._bufferType);
+//             gl.bindBuffer(gl.ARRAY_BUFFER, null);
+//         }
+//         {
+//             this._circleVAO = gl.createVertexArray();
+//             gl.bindVertexArray(this._circleVAO);
+//             gl.bindBuffer(gl.ARRAY_BUFFER, this.buffer);
+//             gl.enableVertexAttribArray(0);
+//             gl.vertexAttribPointer(0, 2, gl.FLOAT, false, RING_SIZE * 4, 0);
+//             gl.enableVertexAttribArray(1);
+//             gl.vertexAttribPointer(1, 1, gl.FLOAT, false, RING_SIZE * 4, 2 * 4);
+//             gl.enableVertexAttribArray(2);
+//             gl.vertexAttribPointer(2, 4, gl.FLOAT, false, RING_SIZE * 4, 4 * 4);
+//             gl.enableVertexAttribArray(3);
+//             gl.vertexAttribPointer(3, 3, gl.FLOAT, false, RING_SIZE * 4, 8 * 4);
+//             // set divisors to 1
+//             gl.vertexAttribDivisor(0, 1);
+//             gl.vertexAttribDivisor(1, 1);
+//             gl.vertexAttribDivisor(2, 1);
+//             gl.vertexAttribDivisor(3, 1);
+//             gl.bindVertexArray(null);
+//         }
+//         {
+//             this._paddingVAO = gl.createVertexArray();
+//             gl.bindVertexArray(this._paddingVAO);
+//             gl.bindBuffer(gl.ARRAY_BUFFER, this.buffer);
+//             gl.enableVertexAttribArray(0);
+//             gl.vertexAttribPointer(0, 2, gl.FLOAT, false, RING_SIZE * 4, 0);
+//             gl.enableVertexAttribArray(1);
+//             gl.vertexAttribPointer(1, 1, gl.FLOAT, false, RING_SIZE * 4, 2 * 4);
+//             gl.enableVertexAttribArray(2);
+//             gl.vertexAttribPointer(2, 1, gl.FLOAT, false, RING_SIZE * 4, 3 * 4);
+//             gl.enableVertexAttribArray(3);
+//             gl.vertexAttribPointer(3, 4, gl.FLOAT, false, RING_SIZE * 4, 4 * 4);
+//             gl.enableVertexAttribArray(4);
+//             gl.vertexAttribPointer(4, 3, gl.FLOAT, false, RING_SIZE * 4, 8 * 4);
+//             gl.vertexAttribDivisor(0, 1);
+//             gl.vertexAttribDivisor(1, 1);
+//             gl.vertexAttribDivisor(2, 1);
+//             gl.vertexAttribDivisor(3, 1);
+//             gl.vertexAttribDivisor(4, 1);
+//             gl.bindVertexArray(null);
+//         }
+//     }
+//     /**
+//      * @param {String} centerID
+//      * @param {Object} options
+//      * @param {Number} options.x
+//      * @param {Number} options.y
+//      * */
+//     registerCenter(centerID, { x = 0, y = 0 } = {}) {
+//         this._centerMap.set(centerID, new Map(
+//             [
+//                 ["x", x],
+//                 ["y", y],
+//                 ["rings", []] // ring keys
+//             ]
+//         ));
+//     }
+//     /**
+//      *
+//      * @param {null | number} newCapacity if null, vacuum defragmentation is applied -> capacity is set to the current ring count
+//      */
+//     defrag(newCapacity = null) {
+//         const { _removedRingsOffsetStack, _ringOffsets } = this;
+//         _removedRingsOffsetStack.sort();
+//         this._capacity = newCapacity || this._ringCounter;
+//         const arrayToLoad = new Float32Array(this._capacity * RING_SIZE);
+//         const bufferData = this._getBufferData();
+//         let arrayOffset = 0;
+//         const newRingOffsets = new Map();
+//         for (const [key, offset] of _ringOffsets) {
+//             const ringOffset = offset / 4
+//             const ringData = bufferData.slice(ringOffset, ringOffset + RING_SIZE);
+//             arrayToLoad.set(ringData, arrayOffset);
+//             newRingOffsets.set(key, arrayOffset * 4);
+//             arrayOffset += RING_SIZE;
+//         }
+//         const { gl, buffer } = this;
+//         gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
+//         gl.bufferData(gl.ARRAY_BUFFER, arrayToLoad, this._bufferType);
+//         gl.bindBuffer(gl.ARRAY_BUFFER, null);
+//         this._ringOffsets = newRingOffsets;
+//         this._removedRingsOffsetStack = [];
+//         this._length = this._ringCounter;
+//     }
+//     extendBuffer(newCapacity) {
+//         if (this._capacity >= newCapacity) {
+//             console.warn("New capacity is smaller than the current capacity");
+//             return;
+//         }
+//         this._capacity = newCapacity;
+//         const { gl, buffer } = this;
+//         const bufferData = this._getBufferData();
+//         gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
+//         gl.bufferData(gl.ARRAY_BUFFER, newCapacity * RING_SIZE * 4, this._bufferType);
+//         gl.bufferSubData(gl.ARRAY_BUFFER, 0, bufferData);
+//         gl.bindBuffer(gl.ARRAY_BUFFER, null);
+//     }
+//     checkCapacity(sizeLeft = 1) {
+//         return sizeLeft <= this._capacity - this._ringCounter;
+//     }
+//     capacityLeft() {
+//         return this._capacity - this._ringCounter;
+//     }
+//     get capacity() {
+//         return this._capacity;
+//     }
+//     get length() {
+//         return this._length;
+//     }
+//     get ringCount() {
+//         return this._ringCounter;
+//     }
+//     /**
+//      * @param {Array<string>} centerIDs
+//      * */
+//     removeCenters(centerIDs) {
+//         const { gl, buffer } = this;
+//         const zero = new Float32Array([0]);
+//         gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
+//         for (let centerID of centerIDs) {
+//             if (!this._centerMap.has(centerID)) {
+//                 // console.warn("Center is not registered yet");
+//                 // return;
+//                 continue;
+//             }
+//             const center = this._centerMap.get(centerID);
+//             const rings = center.get("rings");
+//             for (let i = 0; i < rings.length; i++) {
+//                 // set range to 0, 3rd index of float32array
+//                 const offset = this._ringOffsets.get(rings[i]);
+//                 gl.bufferSubData(gl.ARRAY_BUFFER, offset + 8, zero);
+//                 this._removedRingsOffsetStack.push(offset);
+//                 this._ringOffsets.delete(rings[i]);
+//             }
+//             this._ringCounter -= rings.length;
+//             this._centerMap.delete(centerID);
+//         }
+//         gl.bindBuffer(gl.ARRAY_BUFFER, null);
+//         this.globe.DrawRender();
+//     }
+//     /**
+//      *
+//      * @property {String} centerID
+//      * @property {Number} x radians x
+//      * @property {Number} y radians y
+//      * @param {*} centerIDxyList
+//      */
+//     updateCentersXY(centerIDxyList) {
+//         const { gl, buffer } = this;
+//         gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
+//         for (let { centerID, x, y } of centerIDxyList) {
+//             const center = this._centerMap.get(centerID);
+//             center.set("x", x);
+//             center.set("y", y);
+//             const xyBlock = new Float32Array([x, y]);
+//             const rings = center.get("rings");
+//             for (let i = 0; i < rings.length; i++) {
+//                 const offset = this._ringOffsets.get(rings[i]);
+//                 gl.bufferSubData(gl.ARRAY_BUFFER, offset, xyBlock);
+//             }
+//         }
+//         gl.bindBuffer(gl.ARRAY_BUFFER, null);
+//         this.globe.DrawRender();
+//     }
+//     updateCentersHide(data) {
+//         const { gl, buffer } = this;
+//         gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
+//         for (let { centerID, hide = null } of data) {
+//             if (hide === null) continue;
+//             const rings = this._centerMap.get(centerID).get("rings");
+//             for (let i = 0; i < rings.length; i++) {
+//                 const offset = this._ringOffsets.get(rings[i]);
+//                 gl.bufferSubData(gl.ARRAY_BUFFER, offset + 32, new Float32Array([hide]));
+//             }
+//         }
+//         gl.bindBuffer(gl.ARRAY_BUFFER, null);
+//         this.globe.DrawRender();
+//     }
+//     insertBulk(rangeRingDatas) {
+//         const { gl, buffer } = this;
+//         {// remove existring centers
+//             const existingCenterIDs = [];
+//             for (let { centerID } of rangeRingDatas) {
+//                 if (this._centerMap.has(centerID)) {
+//                     existingCenterIDs.push(centerID);
+//                 }
+//             }
+//             this.removeCenters(existingCenterIDs);
+//         }
+//         { // capacity check
+//             let incomingRingSize = 0;
+//             for (let { rings } of rangeRingDatas) {
+//                 incomingRingSize += rings.length;
+//                 // It should check if ring is already registered but for now it is not implemented.
+//                 // Reasons: increase in complexity and performance
+//             }
+//             this._implicitExtendBufferInNeed(incomingRingSize);
+//         }
+//         gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
+//         for (const { centerID, x, y, rings, hide = 0 } of rangeRingDatas) {
+//             this.registerCenter(centerID, { x, y })
+//             for (const { ringID, radius, padding, rgba } of rings) {
+//                 const key = this._ringKey(centerID, ringID);
+//                 const bufferData = new Float32Array([x, y, radius, padding, ...rgba, hide]);
+//                 const offset = this._nextBufferOffset();
+//                 gl.bufferSubData(gl.ARRAY_BUFFER, offset, bufferData);
+//                 this._ringOffsets.set(key, offset);
+//                 this._centerMap.get(centerID).get("rings").push(key);
+//             }
+//         }
+//         gl.bindBuffer(gl.ARRAY_BUFFER, null);
+//         this.globe.DrawRender();
+//     }
+//     /**
+//      *
+//      * @param {Array<{centerID, rgba}} centersColors
+//      */
+//     updateCentersColor(centersColors) {
+//         const { gl, buffer } = this;
+//         gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
+//         for (let { centerID, rgba } of centersColors) {
+//             if (!this._centerMap.has(centerID)) {
+//                 console.warn("Center is not registered yet");
+//                 continue;
+//             }
+//             const rings = this._centerMap.get(centerID).get("rings");
+//             const block = new Float32Array(rgba);
+//             for (let i = 0; i < rings.length; i++) {
+//                 const offset = this._ringOffsets.get(rings[i]);
+//                 gl.bufferSubData(gl.ARRAY_BUFFER, offset + 16, block);
+//             }
+//         }
+//         gl.bindBuffer(gl.ARRAY_BUFFER, null);
+//         this.globe.DrawRender();
+//     }
+//     // ----------------- INTERNAL METHODS ----------------- //
+//     bindCircleVAO() {
+//         this.gl.bindVertexArray(this._circleVAO);
+//     }
+//     bindPaddingVAO() {
+//         this.gl.bindVertexArray(this._paddingVAO);
+//     }
+//     free() {
+//         this.gl.deleteBuffer(this.buffer);
+//         this.gl.deleteVertexArray(this._circleVAO);
+//         this.gl.deleteVertexArray(this._paddingVAO);
+//     }
+//     // ----------------- PRIVATE METHODS ----------------- //
+//     _getBufferData() {
+//         const { gl, buffer } = this;
+//         const size = new Float32Array(this._length * RING_SIZE);
+//         const bufferData = new Float32Array(size);
+//         gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
+//         gl.getBufferSubData(gl.ARRAY_BUFFER, 0, bufferData);
+//         gl.bindBuffer(gl.ARRAY_BUFFER, null);
+//         return bufferData;
+//     }
+//     _ringKey(centerID, ringID) {
+//         return `C=${centerID},R=${ringID}`;
+//     }
+//     _nextBufferOffset() {
+//         if (!this.checkCapacity()) {
+//             throw new Error("Buffer is full");
+//             return;
+//         }
+//         let offset;
+//         if (this._removedRingsOffsetStack.length > 0) {
+//             offset = this._removedRingsOffsetStack.pop();
+//         } else {
+//             offset = this._ringCounter * RING_SIZE * 4;
+//             this._length++;
+//         }
+//         this._ringCounter++;
+//         return offset;
+//     }
+//     _implicitExtendBufferInNeed(incomingRingSize) {
+//         const overCapacity = incomingRingSize - this.capacityLeft();
+//         if (overCapacity <= 0) return;
+//         const newCapacity = Math.ceil((this._capacity + overCapacity) * this.implicitExtentionRate);
+//         this.extendBuffer(newCapacity);
+//     }
+//     async readRing(centerID, ringID) {
+//         const key = this._ringKey(centerID, ringID);
+//         if (!this._ringOffsets.has(key)) {
+//             console.warn("Ring is not registered yet");
+//             return;
+//         }
+//         const offset = this._ringOffsets.get(key);
+//         const { gl, buffer } = this;
+//         gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
+//         const bufferData = new Float32Array(9);
+//         gl.getBufferSubData(gl.ARRAY_BUFFER, offset, bufferData);
+//         return {
+//             centerX: bufferData[0],
+//             centerY: bufferData[1],
+//             range: bufferData[2],
+//             padding: bufferData[3],
+//             rgba: [bufferData[4], bufferData[5], bufferData[6], bufferData[7]],
+//             hide: bufferData[8]
+//         }
+//     }
+//     /**
+//      * TODOS:
+//      * - bulk ring registration. This must be managed here to avoid binding and unbinding buffer multiple times
+//      * - bulk centers and rings registration
+//      *
+//      * - Check capacity on extend buffer and collect garbage
+//      * - set length to the filled part of the buffer. used for draw calls
+//      * */
+//     /**
+//      * collectGarbage with Defragmantation
+//      * Basic idea: on unregistration the last ring is moved to the removed ring's place. length is decreased by 1
+//      * Optimization: Reading buffer is expensive. So bulk defragmentation is needed to work with this approach
+//      * */
+// }
+// /**
+//  * Documentation
+//  *
+//  * Methods:
+//  * - insertRings(centerIdringIdRadiusPaddingRgbaHide)
+//  * - removeRings(centerIDringIDs)
+//  * - removeCenters(centerIDs)
+//  * - updateCentersXY(centerIDxyList)
+//  * - updateCenters(centerDatas)
+//  * - insertBulk(rangeRingDatas)
+//  * - updateRing(centerID, ringID, { radius, padding, rgba, hide })
+//  * - readRing(centerID, ringID)
+//  *
+//  */