@pirireis/webglobeplugins 0.9.9 → 0.9.11

package/rangerings/plugin.js

@@ -0,0 +1,610 @@
+"use strict";
+/**
+ * @typedef RangeRingData
+ * @property {number} centerX
+ * @property {number} centerY
+ * @property {Array<Ring>} rings
+ *
+ * @typedef Ring
+ * @property {number} radius
+ * @property {number} padding
+ * @property {[number, number, number]} color
+ *
+ *
+ * @method insertBulk
+ * @typedef {Array<{ringID, radius, padding}>} rings
+ * @param {Array<centerID:string, x:number, y:number, stepAngle:number, rgba:[4 numbers], rings:rings} items
+ 
+ * @method updateCentersCoordinate    @param {Array<{centerID, long,lat}>} items
+ * @method updateCentersColor  @param {Array<{centerID, rgba:[4 numbers]}>} centerColors
+ *
+ * @method updateCentersHide   @param {Array<{centerID, hide, textHide}>} centerHides
+ * @method removeCenters       @param {Array<{centerID}>} centerIds
+ * @method setOpacity          @param {number} opacity
+ *
+ * @method setOneDegreePaddingOn //  performance consuming, might be removed
+ *
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Z_ALPHA_MODE = exports.RangeRings = void 0;
+var circle_accurate_flat_1 = require("../programs/line-on-globe/circle-accurate-flat");
+var circle_accurate_3d_1 = require("../programs/line-on-globe/circle-accurate-3d");
+var lines_color_instanced_flat_1 = require("../programs/line-on-globe/lines-color-instanced-flat");
+var account_1 = require("../util/account");
+var get_1 = require("../util/check/get");
+var data_filler_1 = require("../util/jshelpers/data-filler");
+var ring_account_1 = require("./ring-account");
+var degree_padding_around_circle_3d_1 = require("../programs/line-on-globe/degree-padding-around-circle-3d");
+var naive_accurate_flexible_1 = require("../programs/line-on-globe/naive-accurate-flexible");
+var rangeringangletext_1 = __importDefault(require("./rangeringangletext"));
+var util_1 = require("../programs/line-on-globe/util");
+Object.defineProperty(exports, "Z_ALPHA_MODE", { enumerable: true, get: function () { return util_1.Z_ALPHA_MODE; } });
+var enum_1 = require("./enum");
+var typecheck_1 = require("../util/check/typecheck");
+var geometry_1 = require("../util/geometry");
+var CIRCLE_FLAT_EDGE_COUNT = 362; // 360 + 2 for closing the circle and a cutting point
+var coordOnSphere = function (long, lat, globe, altitude) {
+    if (altitude === void 0) { altitude = 0; }
+    var coord = globe.api_GetCartesian3DPoint(long, lat, 0, 0);
+    return (0, geometry_1.normalize)(coord, 6378.137 + altitude);
+};
+/**
+ *
+ *
+ * @typedef {string} centerID
+ *
+ * @typedef {Object} RangeRing
+ * @property {string} ringID
+ * @property {number} radius in range meters
+ * @property {number} padding badding range in meter
+ *
+ *
+ *  Array < centerID: string, long: number, lat: number, stepAngle: number, rgba: [4 numbers], rings: rings, hide, textHide
+ * @typedef {Object} RangeRingsItem
+ * @property {centerID} centerID
+ * @property {number} long
+ * @property {number} lat
+ * @property {number} stepAngle
+ * @property {number} altitude
+ * @property {number} hide
+ * @property {number} textHide
+ * @property {number} rgba
+ * @property {Array<RangeRing>} rings
+ */
+var RangeRings = /** @class */ (function () {
+    function RangeRings(id, _a, _b) {
+        var _c = _a === void 0 ? {} : _a, _d = _c.oneDegreePadding, oneDegreePadding = _d === void 0 ? true : _d, _e = _c.showNumbers, showNumbers = _e === void 0 ? true : _e, _f = _c.numbersStyle, numbersStyle = _f === void 0 ? null : _f, _g = _c.opacity, opacity = _g === void 0 ? 1 : _g, _h = _c.zAlphaOnDegreePadding, zAlphaOnDegreePadding = _h === void 0 ? util_1.Z_ALPHA_MODE.ON : _h;
+        var _j = _b === void 0 ? {} : _b, _k = _j.textDataPreAdaptor, textDataPreAdaptor = _k === void 0 ? null : _k, _l = _j.textWritersMap, textWritersMap = _l === void 0 ? new Map() : _l;
+        this.id = id;
+        this._oneDegreePadding = oneDegreePadding;
+        this._zAlphaOnDegreePadding = zAlphaOnDegreePadding;
+        this._showNumbers = showNumbers;
+        this._numbersStyle = numbersStyle;
+        this._opacity = opacity;
+        this._ringAccount = new ring_account_1.RingAccount();
+        this._textWritersMap = textWritersMap;
+        this._textDataPreAdaptor = textDataPreAdaptor;
+        this._textWritersMap.forEach(function (textWriter) { return textWriter.setKeyAdaptor(function (item) { return item.__identity__; }); });
+    }
+    // USER API
+    /**
+     * @method updateCentersCoordinate @param { Array < { centerID, long,lat } >} items
+    */
+    RangeRings.prototype.updateCentersCoordinate = function (items, _a) {
+        // Algorithm
+        /**
+         * 1. ask centerRingAccount for existing rings COORDINATE RELATED KEYS
+         * 2. update centers
+         * 3. update buffer orchestators
+         */
+        var _b;
+        var _c = _a === void 0 ? {} : _a, _d = _c.textWriterIDs, textWriterIDs = _d === void 0 ? [] : _d;
+        this._ringAccount.updateCentersCoordinate(items);
+        var _e = this, globe = _e.globe, bufferOrchestrator = _e.bufferOrchestrator, bufferManagersCompMap = _e.bufferManagersCompMap, paddingBufferOrchestrator = _e.paddingBufferOrchestrator, bufferManagersCompMapPadding = _e.bufferManagersCompMapPadding;
+        for (var _i = 0, items_1 = items; _i < items_1.length; _i++) {
+            var centerID = items_1[_i].centerID;
+            var datas = this.__reconstructCentralRings(centerID);
+            bufferOrchestrator.updateBulk(datas, bufferManagersCompMap, ["centerCoords3d", "centerCoords2dflat", "targetCoords3d", "centerCoords2dflatForPadding"]);
+            var paddingDatas = this.__reconstructCentralRingsBigPaddings(centerID);
+            paddingBufferOrchestrator.updateBulk(paddingDatas, bufferManagersCompMapPadding, ["circlePoint2d", "paddingPoint2d", "circlePoint3d", "paddingPoint3d"]);
+        }
+        (_b = this.paddingTextPlugin) === null || _b === void 0 ? void 0 : _b.updateCentersXY(items);
+        this.__contextTextWriterUpdate(items.map(function (_a) {
+            var centerID = _a.centerID;
+            return centerID;
+        }), textWriterIDs);
+        globe.DrawRender();
+    };
+    /**
+     * @method insertBulk
+     * @param { Array < RangeRingsItem> } items
+    */
+    RangeRings.prototype.insertBulk = function (items, _a) {
+        var _b;
+        var _c = _a === void 0 ? {} : _a, _d = _c.textWriterIDs, textWriterIDs = _d === void 0 ? [] : _d;
+        // Algorithm
+        /**
+         * 1 ask centerRingAccount for existing rings
+         * 2. delete all existing keys with buffer orchestators
+         * 3. insert new centerRings to centerRingAccount
+         * 4. insert new keys with buffer orchestators
+         */
+        var _e = this, globe = _e.globe, _ringAccount = _e._ringAccount, bufferOrchestrator = _e.bufferOrchestrator, bufferManagersCompMap = _e.bufferManagersCompMap, paddingBufferOrchestrator = _e.paddingBufferOrchestrator, bufferManagersCompMapPadding = _e.bufferManagersCompMapPadding;
+        for (var _i = 0, items_2 = items; _i < items_2.length; _i++) {
+            var item = items_2[_i];
+            var existingKeys = _ringAccount.ringKeys(item.centerID);
+            if (existingKeys.length) {
+                bufferOrchestrator.deleteBulk(existingKeys, bufferManagersCompMap);
+            }
+            var paddingKeys = _ringAccount.ringBigPaddingKeys(item.centerID);
+            if (paddingKeys.length) {
+                paddingBufferOrchestrator.deleteBulk(paddingKeys, bufferManagersCompMapPadding);
+            }
+        }
+        for (var _f = 0, items_3 = items; _f < items_3.length; _f++) {
+            var item = items_3[_f];
+            _ringAccount.insertCenter(item);
+            var datas = this.__reconstructCentralRings(item.centerID);
+            bufferOrchestrator.insertBulk(datas, bufferManagersCompMap);
+            var paddingDatas = this.__reconstructCentralRingsBigPaddings(item.centerID);
+            paddingBufferOrchestrator.insertBulk(paddingDatas, bufferManagersCompMapPadding);
+        }
+        (_b = this.paddingTextPlugin) === null || _b === void 0 ? void 0 : _b.insertBulk(items);
+        this.__contextTextWriterUpdate(items.map(function (_a) {
+            var centerID = _a.centerID;
+            return centerID;
+        }), textWriterIDs);
+        globe.DrawRender();
+    };
+    /**
+     * @method updateCentersColor @param { Array < { centerID, rgba: [4 numbers] } >} centerColors
+    */
+    RangeRings.prototype.updateCentersColor = function (centerColors, _a) {
+        var _b = _a === void 0 ? {} : _a, _c = _b.textWriterIDs, textWriterIDs = _c === void 0 ? [] : _c;
+        // Algorithm
+        /**
+         * 1. ask centerRingAccount for existing rings COLOR KEYS
+         * 2. update centers
+         * 3. update buffer orchestators
+         */
+        this._ringAccount.updateCentersColor(centerColors);
+        var _d = this, globe = _d.globe, bufferOrchestrator = _d.bufferOrchestrator, bufferManagersCompMap = _d.bufferManagersCompMap, paddingBufferOrchestrator = _d.paddingBufferOrchestrator, bufferManagersCompMapPadding = _d.bufferManagersCompMapPadding;
+        for (var _i = 0, centerColors_1 = centerColors; _i < centerColors_1.length; _i++) {
+            var centerID = centerColors_1[_i].centerID;
+            var datas = this.__reconstructCentralProperties(centerID);
+            bufferOrchestrator.updateBulk(datas, bufferManagersCompMap, ["rgba", "rgbaMercator"]);
+            var paddingDatas = this.__reconstructCentralPaddingProperties(centerID);
+            paddingBufferOrchestrator.updateBulk(paddingDatas, bufferManagersCompMapPadding, ["rgba"]);
+        }
+        this.__contextTextWriterUpdate(centerColors.map(function (_a) {
+            var centerID = _a.centerID;
+            return centerID;
+        }), textWriterIDs);
+        globe.DrawRender();
+    };
+    /**
+     *
+     * @method updateCentersHide @param { Array < { centerID, hide, textHide } >} centerHides
+    */
+    RangeRings.prototype.updateCentersHide = function (centerHides, _a) {
+        var _b;
+        var _c = _a === void 0 ? {} : _a, _d = _c.textWriterIDs, textWriterIDs = _d === void 0 ? [] : _d;
+        // Algorithm
+        /**
+         * Simple
+         * 1. update centers
+         * 2. reconstruct data,
+         * 3. update color buffer
+         * */
+        this._ringAccount.updateCentersHide(centerHides);
+        var _e = this, globe = _e.globe, bufferOrchestrator = _e.bufferOrchestrator, bufferManagersCompMap = _e.bufferManagersCompMap, paddingBufferOrchestrator = _e.paddingBufferOrchestrator, bufferManagersCompMapPadding = _e.bufferManagersCompMapPadding;
+        for (var _i = 0, centerHides_1 = centerHides; _i < centerHides_1.length; _i++) {
+            var centerID = centerHides_1[_i].centerID;
+            var datas = this.__reconstructCentralProperties(centerID);
+            bufferOrchestrator.updateBulk(datas, bufferManagersCompMap, ["rgba", "rgbaMercator"]);
+            var paddingDatas0 = this.__reconstructCentralRings(centerID);
+            bufferOrchestrator.updateBulk(paddingDatas0, bufferManagersCompMap, ["radius3dsmall", "centerCoords2dflatForPadding"]);
+            var paddingDatas = this.__reconstructCentralPaddingProperties(centerID);
+            paddingBufferOrchestrator.updateBulk(paddingDatas, bufferManagersCompMapPadding, ["rgba"]);
+        }
+        (_b = this.paddingTextPlugin) === null || _b === void 0 ? void 0 : _b.updateCentersHide(centerHides);
+        this.__contextTextWriterUpdate(centerHides.map(function (_a) {
+            var centerID = _a.centerID;
+            return centerID;
+        }), textWriterIDs);
+        globe.DrawRender();
+        /**
+         * Complicated
+         * 1. ask centerRingAccount for existing rings HIDE KEYS
+         * 2. delete from buffer orchestators
+         * 3. mark centers as hidden
+         */
+    };
+    /**
+     * @param {Array<string>} textWriterIDs textWritersMap keys to be used for writing text.
+     * @param {Array<string>} itemKeys if empty, all texts will be updated. Use  {@link ringKeyMethod} method to get keys
+     */
+    RangeRings.prototype.updateText = function (textWriterIDs, itemKeys) {
+        var _this = this;
+        if (textWriterIDs === void 0) { textWriterIDs = []; }
+        if (itemKeys === void 0) { itemKeys = null; }
+        var textWritersMap = textWriterGetOrThrow(this._textWritersMap, textWriterIDs);
+        if (itemKeys === null) {
+            this._ringAccount.updateAllText(textWritersMap, this._textDataPreAdaptor);
+            this.globe.DrawRender();
+        }
+        else {
+            itemKeys.forEach(function (key) {
+                var item = _this._ringAccount.getCenter(key);
+                if (item === undefined)
+                    throw new Error("Center not found");
+                var textData = _this._textDataPreAdaptor(item);
+                textWritersMap.forEach(function (textWriter) { return textWriter.insertText(textData); });
+            });
+        }
+        this.globe.DrawRender();
+    };
+    /**
+     * @method removeCenters @param { Array < { centerID } >} centerIDs
+    */
+    RangeRings.prototype.removeCenters = function (centerIDs) {
+        var _a;
+        var _b = this, globe = _b.globe, bufferOrchestrator = _b.bufferOrchestrator, bufferManagersCompMap = _b.bufferManagersCompMap, paddingBufferOrchestrator = _b.paddingBufferOrchestrator, bufferManagersCompMapPadding = _b.bufferManagersCompMapPadding, _ringAccount = _b._ringAccount;
+        var _loop_1 = function (centerID) {
+            var existingKeys = _ringAccount.ringKeys(centerID);
+            if (existingKeys.length) {
+                bufferOrchestrator.deleteBulk(existingKeys, bufferManagersCompMap);
+                this_1._textWritersMap.forEach(function (textWriter) { return textWriter.deleteTextBulk(existingKeys); });
+            }
+        };
+        var this_1 = this;
+        for (var _i = 0, centerIDs_1 = centerIDs; _i < centerIDs_1.length; _i++) {
+            var centerID = centerIDs_1[_i];
+            _loop_1(centerID);
+        }
+        for (var _c = 0, centerIDs_2 = centerIDs; _c < centerIDs_2.length; _c++) {
+            var centerID = centerIDs_2[_c];
+            var paddingKeys = _ringAccount.ringBigPaddingKeys(centerID);
+            if (paddingKeys.length) {
+                paddingBufferOrchestrator.deleteBulk(paddingKeys, bufferManagersCompMapPadding);
+            }
+        }
+        (_a = this.paddingTextPlugin) === null || _a === void 0 ? void 0 : _a.removeCenters(centerIDs);
+        this._ringAccount.removeCenters(centerIDs);
+        globe.DrawRender();
+    };
+    /**
+     * @method setOpacity @param { number } opacity
+    */
+    RangeRings.prototype.setOpacity = function (opacity) {
+        var _a;
+        (0, typecheck_1.opacityCheck)(opacity);
+        this._opacity = opacity;
+        (_a = this.paddingTextPlugin) === null || _a === void 0 ? void 0 : _a.setOpacity(opacity);
+        this._textWritersMap.forEach(function (writer) { return writer.setOpacity(opacity); });
+        this.globe.DrawRender();
+    };
+    /**
+     * @method setOneDegreePaddingOn //  performance consuming, might be removed
+    */
+    RangeRings.prototype.setOneDegreePaddingOn = function (isOneDegreePaddingOn) {
+        if (typeof isOneDegreePaddingOn !== "boolean")
+            throw new Error("Invalid value for one degree padding");
+        if (this._oneDegreePadding === isOneDegreePaddingOn)
+            return;
+        this._oneDegreePadding = isOneDegreePaddingOn;
+        this.globe.DrawRender();
+    };
+    RangeRings.prototype.setZAlphaOnDegreePadding = function (zAlphaOnDegreePadding) {
+        if (zAlphaOnDegreePadding !== 0 && zAlphaOnDegreePadding !== 1)
+            throw new Error("Invalid value for zAlphaOnDegreePadding");
+        if (this._zAlphaOnDegreePadding === zAlphaOnDegreePadding)
+            return;
+        this._zAlphaOnDegreePadding = zAlphaOnDegreePadding;
+        this.globe.DrawRender();
+    };
+    // PRIVATE METHODS
+    RangeRings.prototype._initPrograms = function () {
+        var globe = this.globe;
+        this._circleProgram2D = circle_accurate_flat_1.CircleCache.get(globe);
+        this._circleProgram3D = circle_accurate_3d_1.CircleCache.get(globe);
+        this._padding2dProgram = lines_color_instanced_flat_1.LinesColorInstancedFlatCache.get(globe);
+        this._padding3dProgram = degree_padding_around_circle_3d_1.CirclePadding3DCache.get(globe);
+        this._lineOnGlobe_bigPadding = naive_accurate_flexible_1.LineOnGlobeCache.get(globe);
+    };
+    RangeRings.prototype._initBufferManagers = function () {
+        var _a, _b, _c, _d;
+        var _this = this;
+        var gl = this.gl;
+        var initialCapacity = 10;
+        var bufferType = "DYNAMIC_DRAW";
+        // circle2d, circle3d, 1 degree paddings,
+        this.bufferOrchestrator = new account_1.BufferOrchestrator({ capacity: initialCapacity });
+        this.bufferManagersCompMap = new Map([
+            // circle 3D
+            ["centerCoords3d", {
+                    'bufferManager': new account_1.BufferManager(gl, 3, { bufferType: bufferType, initialCapacity: initialCapacity }),
+                    'adaptor': function (item) { return new Float32Array(item.centerCoords3d); },
+                }],
+            ["targetCoords3d", {
+                    'bufferManager': new account_1.BufferManager(gl, 3, { bufferType: bufferType, initialCapacity: initialCapacity }),
+                    'adaptor': function (item) { return new Float32Array(item.targetCoords3d); },
+                }],
+            ["rgba", {
+                    'bufferManager': new account_1.BufferManager(gl, 4, { bufferType: bufferType, initialCapacity: initialCapacity }),
+                    'adaptor': function (item) { return new Float32Array(item.hide === enum_1.ENUM_HIDE.HIDE ? [0, 0, 0, 0] : item.rgba); }
+                }],
+            ["radius3d", {
+                    'bufferManager': new account_1.BufferManager(gl, 1, { bufferType: bufferType, initialCapacity: initialCapacity }),
+                    'adaptor': function (item) { return new Float32Array([item.radius]); }
+                }],
+            ["radius3dsmall", {
+                    'bufferManager': new account_1.BufferManager(gl, 1, { bufferType: bufferType, initialCapacity: initialCapacity }),
+                    'adaptor': function (item) {
+                        if (item.hide === enum_1.ENUM_HIDE.HIDE_1_DEGREE_PADDINGS)
+                            return new Float32Array([item.radius]);
+                        return new Float32Array([item.radius - item.padding / 3]);
+                    }
+                }],
+            ["circleDashAngle", {
+                    'bufferManager': new account_1.BufferManager(gl, 1, { bufferType: bufferType, initialCapacity: initialCapacity }),
+                    'adaptor': function (item) { return new Float32Array([1]); },
+                }],
+            ["dashOpacity", {
+                    'bufferManager': new account_1.BufferManager(gl, 1, { bufferType: bufferType, initialCapacity: initialCapacity }),
+                    'adaptor': function (item) { return new Float32Array([1]); },
+                }],
+            // circle 2D 
+            ["centerCoords2dflatForPadding", {
+                    'bufferManager': new account_1.BufferManager(gl, CIRCLE_FLAT_EDGE_COUNT * 2, { bufferType: bufferType, initialCapacity: initialCapacity }),
+                    'adaptor': function (item) { return item.centerCoords2dflatForPadding; },
+                }],
+            ["centerCoords2dflat", {
+                    'bufferManager': new account_1.BufferManager(gl, CIRCLE_FLAT_EDGE_COUNT * 2, { bufferType: bufferType, initialCapacity: initialCapacity }),
+                    'adaptor': function (item) { return item.centerCoords2dflat; },
+                }],
+            ["rgbaMercator", {
+                    'bufferManager': new account_1.BufferManager(gl, 4 * CIRCLE_FLAT_EDGE_COUNT, { bufferType: bufferType, initialCapacity: initialCapacity }),
+                    'adaptor': function (item) { return data_filler_1.populateFloat32Array.fillWithListData(CIRCLE_FLAT_EDGE_COUNT, item.hide === enum_1.ENUM_HIDE.HIDE ? [0, 0, 0, 0] : item.rgba); },
+                }],
+            ["circleDashAngleMercator", {
+                    'bufferManager': new account_1.BufferManager(gl, CIRCLE_FLAT_EDGE_COUNT, { bufferType: bufferType, initialCapacity: initialCapacity }),
+                    'adaptor': function (item) { return data_filler_1.populateFloat32Array.fillFloat32Array(CIRCLE_FLAT_EDGE_COUNT, 1); },
+                }],
+            ["dashOpacityMercator", {
+                    'bufferManager': new account_1.BufferManager(gl, CIRCLE_FLAT_EDGE_COUNT, { bufferType: bufferType, initialCapacity: initialCapacity }),
+                    'adaptor': function (item) { return data_filler_1.populateFloat32Array.fillFloat32Array(CIRCLE_FLAT_EDGE_COUNT, 1); },
+                }],
+        ]);
+        var obj = function (bufferManagerComp, divisor) {
+            if (divisor === void 0) { divisor = 1; }
+            if (bufferManagerComp === null)
+                return null;
+            return { 'buffer': bufferManagerComp.bufferManager.buffer, 'stride': 0, 'offset': 0, divisor: divisor };
+        };
+        this._circle2DVao = (_a = this._circleProgram2D).createVAO.apply(_a, ["centerCoords2dflat", "rgbaMercator", "circleDashAngleMercator", "dashOpacityMercator"].map(function (key) { return obj(_this.bufferManagersCompMap.get(key)); }));
+        this._circle3DVao = (_b = this._circleProgram3D).createVAO.apply(_b, ["centerCoords3d", "targetCoords3d", "rgba", "circleDashAngle", "dashOpacity"].map(function (key) { return obj(_this.bufferManagersCompMap.get(key)); }));
+        this._oneDegree2DPaddingVao = this._padding2dProgram.createVAO({ buffer: this.bufferManagersCompMap.get("centerCoords2dflat").bufferManager.buffer, size: 2, stride: 0, offset: 0 }, { buffer: this.bufferManagersCompMap.get("centerCoords2dflatForPadding").bufferManager.buffer, size: 2, stride: 0, offset: 0 }, { buffer: this.bufferManagersCompMap.get("rgbaMercator").bufferManager.buffer, size: 4, stride: 0, offset: 0 });
+        // PADDING 
+        // this one needs glue to assosiate rings and their big paddings since the count for center is not fixed
+        this.paddingBufferOrchestrator = new account_1.BufferOrchestrator({ capacity: initialCapacity });
+        this.bufferManagersCompMapPadding = new Map([
+            ["circlePoint2d", {
+                    'bufferManager': new account_1.BufferManager(gl, 2, { bufferType: bufferType, initialCapacity: initialCapacity }),
+                    'adaptor': function (item) { return item.circlePoint2d; },
+                }],
+            ["paddingPoint2d", {
+                    'bufferManager': new account_1.BufferManager(gl, 2, { bufferType: bufferType, initialCapacity: initialCapacity }),
+                    'adaptor': function (item) { return item.paddingPoint2d; },
+                }],
+            ["circlePoint3d", {
+                    'bufferManager': new account_1.BufferManager(gl, 3, { bufferType: bufferType, initialCapacity: initialCapacity }),
+                    'adaptor': function (item) { return item.circlePoint3d; }
+                }],
+            ["paddingPoint3d", {
+                    'bufferManager': new account_1.BufferManager(gl, 3, { bufferType: bufferType, initialCapacity: initialCapacity }),
+                    'adaptor': function (item) { return item.paddingPoint3d; }
+                }],
+            ["rgba", {
+                    'bufferManager': new account_1.BufferManager(gl, 4, { bufferType: bufferType, initialCapacity: initialCapacity }),
+                    'adaptor': function (item) { return new Float32Array(item.rgba); }
+                }],
+            // ["dashOpacity", {
+            //     'bufferManager': new BufferManager(gl, 1, { bufferType, initialCapacity }),
+            //     'adaptor': (item) => new Float32Array([1]),
+            // }],
+            // ["dashRatio", {
+            //     'bufferManager': new BufferManager(gl, 1, { bufferType, initialCapacity }),
+            //     'adaptor': (item) => new Float32Array([1]),
+            // }],
+        ]);
+        this._bigPadding3dFlatVAO = (_c = this._lineOnGlobe_bigPadding).createVAO.apply(_c, ["circlePoint2d", "circlePoint3d", "paddingPoint2d", "paddingPoint3d", null, null, "rgba",].map(function (key) {
+            return (key === null) ? null : obj(_this.bufferManagersCompMapPadding.get(key));
+        }));
+        this._padding3dOneDegreeVao = (_d = this._padding3dProgram).createVAO.apply(_d, ["centerCoords3d", "radius3d", "radius3dsmall", "rgba"].map(function (key) { return obj(_this.bufferManagersCompMap.get(key)); }));
+    };
+    // IMPLICIT METHODS
+    RangeRings.prototype.__reconstructCentralRingsBigPaddings = function (centerID) {
+        var globe = this.globe;
+        var centerItem = this._ringAccount.getCenter(centerID);
+        if (centerItem === undefined)
+            throw new Error("Center not found");
+        var long = centerItem.long, lat = centerItem.lat, stepAngle = centerItem.stepAngle, rgba = centerItem.rgba, rings = centerItem.rings, _a = centerItem.hide, hide = _a === void 0 ? 0 : _a, _b = centerItem.textHide, textHide = _b === void 0 ? 0 : _b, _c = centerItem.altitude, centerAltitude = _c === void 0 ? 0 : _c;
+        var result = [];
+        var color = hide === 1 ? new Float32Array([0, 0, 0, 0]) : new Float32Array(rgba);
+        for (var _i = 0, rings_1 = rings; _i < rings_1.length; _i++) {
+            var _d = rings_1[_i], ringID = _d.ringID, radius = _d.radius, padding = _d.padding, _e = _d.altitude, altitude = _e === void 0 ? centerAltitude : _e;
+            var azimuthAngle = 0;
+            while (azimuthAngle < 360) {
+                var circlePoint = globe.Math.FindPointByPolar(long, lat, radius, azimuthAngle); // long lat
+                var paddingPoint = globe.Math.FindPointByPolar(long, lat, radius - padding, azimuthAngle); // long lat
+                result.push({
+                    key: (0, ring_account_1.ringBigPaddingKeyMethod)(centerID, ringID, azimuthAngle),
+                    circlePoint2d: new Float32Array(globe.api_GetMercator2DPoint(circlePoint.long, circlePoint.lat)),
+                    paddingPoint2d: new Float32Array(globe.api_GetMercator2DPoint(paddingPoint.long, paddingPoint.lat)),
+                    circlePoint3d: coordOnSphere(circlePoint.long, circlePoint.lat, globe, altitude / 1000),
+                    paddingPoint3d: coordOnSphere(paddingPoint.long, paddingPoint.lat, globe, altitude / 1000),
+                    rgba: color,
+                    hide: hide,
+                    textHide: textHide
+                });
+                azimuthAngle += stepAngle;
+            }
+        }
+        return result;
+    };
+    RangeRings.prototype.__reconstructCentralRings = function (centerID) {
+        var globe = this.globe;
+        var centerItem = this._ringAccount.getCenter(centerID);
+        if (centerItem === undefined)
+            throw new Error("Center not found");
+        var long = centerItem.long, lat = centerItem.lat, rgba = centerItem.rgba, rings = centerItem.rings, _a = centerItem.hide, hide = _a === void 0 ? 0 : _a, _b = centerItem.textHide, textHide = _b === void 0 ? 0 : _b, _c = centerItem.altitude, centralAltitude = _c === void 0 ? 0 : _c;
+        var centerCoords3d = coordOnSphere(long, lat, globe, centralAltitude / 1000);
+        var result = [];
+        for (var _i = 0, rings_2 = rings; _i < rings_2.length; _i++) {
+            var _d = rings_2[_i], ringID = _d.ringID, radius = _d.radius, padding = _d.padding, __identity__ = _d.__identity__, _e = _d.altitude, altitude = _e === void 0 ? centralAltitude : _e;
+            var key = __identity__;
+            var centerCoords2dflat = (0, circle_accurate_flat_1.centerCoords2dflatDataCreatorWithRadius)(globe, long, lat, radius, { edgeCount: CIRCLE_FLAT_EDGE_COUNT });
+            var radiusPadding = hide === enum_1.ENUM_HIDE.HIDE_1_DEGREE_PADDINGS ? radius : radius - padding / 3;
+            var targetPoint = globe.Math.FindPointByPolar(long, lat, radius, 0); // long lat
+            var targetCoords3d = coordOnSphere(targetPoint.long, targetPoint.lat, globe, altitude / 1000);
+            var centerCoords2dflatForPadding = (0, circle_accurate_flat_1.centerCoords2dflatDataCreatorWithRadius)(globe, long, lat, radiusPadding, { edgeCount: CIRCLE_FLAT_EDGE_COUNT });
+            result.push({
+                key: key,
+                centerCoords3d: centerCoords3d,
+                targetCoords3d: targetCoords3d,
+                centerCoords2dflat: centerCoords2dflat,
+                radius: radius,
+                padding: padding,
+                rgba: rgba,
+                centerCoords2dflatForPadding: centerCoords2dflatForPadding,
+                hide: hide,
+                textHide: textHide
+            });
+        }
+        return result;
+    };
+    RangeRings.prototype.__reconstructCentralPaddingProperties = function (centerID) {
+        var centerItem = this._ringAccount.getCenter(centerID);
+        if (centerItem === undefined)
+            throw new Error("Center not found");
+        var stepAngle = centerItem.stepAngle, rgba = centerItem.rgba, rings = centerItem.rings, _a = centerItem.hide, hide = _a === void 0 ? 0 : _a, _b = centerItem.textHide, textHide = _b === void 0 ? 0 : _b;
+        var result = [];
+        for (var _i = 0, rings_3 = rings; _i < rings_3.length; _i++) {
+            var ringID = rings_3[_i].ringID;
+            var angle = 0;
+            while (angle < 360) {
+                result.push({
+                    key: (0, ring_account_1.ringBigPaddingKeyMethod)(centerID, ringID, angle),
+                    rgba: hide === 1 ? new Float32Array([0, 0, 0, 0]) : rgba,
+                    textHide: textHide
+                });
+                angle += stepAngle;
+            }
+        }
+        return result;
+    };
+    RangeRings.prototype.__reconstructCentralProperties = function (centerID) {
+        var centerItem = this._ringAccount.getCenter(centerID);
+        if (centerItem === undefined)
+            throw new Error("Center not found");
+        var rgba = centerItem.rgba, rings = centerItem.rings, _a = centerItem.hide, hide = _a === void 0 ? 0 : _a, _b = centerItem.textHide, textHide = _b === void 0 ? 0 : _b;
+        var result = [];
+        for (var _i = 0, rings_4 = rings; _i < rings_4.length; _i++) {
+            var _c = rings_4[_i], ringID = _c.ringID, __identity__ = _c.__identity__;
+            var key = __identity__;
+            result.push({
+                key: key,
+                rgba: hide === enum_1.ENUM_HIDE.HIDE ? new Float32Array([0, 0, 0, 0]) : rgba,
+                textHide: textHide
+            });
+        }
+        return result;
+    };
+    // GLOBE API
+    RangeRings.prototype.init = function (globe, gl) {
+        this.globe = globe;
+        this.gl = gl;
+        this._initPrograms();
+        this._initBufferManagers();
+        if (this._showNumbers) {
+            this.paddingTextPlugin = new rangeringangletext_1.default(globe, this.id + "text", { style: this._numbersStyle, opacity: this._opacity });
+            delete this._numbersStyle;
+        }
+    };
+    RangeRings.prototype.draw3D = function () {
+        var _a = this, globe = _a.globe, gl = _a.gl, _circleProgram2D = _a._circleProgram2D, _circleProgram3D = _a._circleProgram3D, _padding2dProgram = _a._padding2dProgram, _padding3dProgram = _a._padding3dProgram, _lineOnGlobe_bigPadding = _a._lineOnGlobe_bigPadding, _circle2DVao = _a._circle2DVao, _circle3DVao = _a._circle3DVao, _oneDegree2DPaddingVao = _a._oneDegree2DPaddingVao, _padding3dOneDegreeVao = _a._padding3dOneDegreeVao, _bigPadding3dFlatVAO = _a._bigPadding3dFlatVAO, bufferOrchestrator = _a.bufferOrchestrator, paddingBufferOrchestrator = _a.paddingBufferOrchestrator, _opacity = _a._opacity, _oneDegreePadding = _a._oneDegreePadding, _zAlphaOnDegreePadding = _a._zAlphaOnDegreePadding;
+        gl.disable(gl.DEPTH_TEST);
+        var is3D = globe.api_GetCurrentGeometry() === 0;
+        // const lod = globe.api_GetCurrentLOD();
+        if (is3D) {
+            _circleProgram3D.draw(_circle3DVao, bufferOrchestrator.length, _opacity);
+            if (_oneDegreePadding)
+                _padding3dProgram.draw(_padding3dOneDegreeVao, bufferOrchestrator.length, 360, 1, _opacity, _zAlphaOnDegreePadding);
+        }
+        else {
+            _circleProgram2D.draw(_circle2DVao, bufferOrchestrator.length, CIRCLE_FLAT_EDGE_COUNT, _opacity);
+            // _padding2dProgram.draw(bigPaddingVAO, paddingBufferOrchestrator.length, _opacity);
+            if (_oneDegreePadding)
+                _padding2dProgram.draw(_oneDegree2DPaddingVao, bufferOrchestrator.length * CIRCLE_FLAT_EDGE_COUNT, _opacity, _zAlphaOnDegreePadding);
+        }
+        var drawOptions = { drawRange: { first: 0, count: paddingBufferOrchestrator.length } };
+        _lineOnGlobe_bigPadding.draw(_bigPadding3dFlatVAO, drawOptions, _opacity);
+        this._textWritersMap.forEach(function (textWriter) { return textWriter.draw(); });
+        gl.enable(gl.DEPTH_TEST);
+    };
+    RangeRings.prototype.free = function () {
+        var _a;
+        if (this._isFreed)
+            return;
+        var globe = this.globe;
+        this.bufferManagersCompMap.forEach(function (_a) {
+            var bufferManager = _a.bufferManager;
+            return bufferManager.free();
+        });
+        this.bufferManagersCompMapPadding.forEach(function (_a) {
+            var bufferManager = _a.bufferManager;
+            return bufferManager.free();
+        });
+        // delete vaos
+        this.gl.deleteVertexArray(this._circle2DVao);
+        this.gl.deleteVertexArray(this._circle3DVao);
+        this.gl.deleteVertexArray(this._oneDegree2DPaddingVao);
+        this.gl.deleteVertexArray(this._padding3dOneDegreeVao);
+        this.gl.deleteVertexArray(this._bigPadding3dFlatVAO);
+        // delete programs
+        circle_accurate_flat_1.CircleCache.release(globe);
+        circle_accurate_3d_1.CircleCache.release(globe);
+        lines_color_instanced_flat_1.LinesColorInstancedFlatCache.release(globe);
+        degree_padding_around_circle_3d_1.CirclePadding3DCache.release(globe);
+        naive_accurate_flexible_1.LineOnGlobeCache.release(globe);
+        this._circleProgram2D = null;
+        this._circleProgram3D = null;
+        this._padding2dProgram = null;
+        this._padding3dProgram = null;
+        this._lineOnGlobe_bigPadding = null;
+        (_a = this.paddingTextPlugin) === null || _a === void 0 ? void 0 : _a.free();
+        this._isFreed = true;
+    };
+    RangeRings.prototype.__contextTextWriterUpdate = function (centerIDs, textWriterIDs) {
+        var _this = this;
+        if (textWriterIDs === void 0) { textWriterIDs = null; }
+        var textWriters = null;
+        if (textWriterIDs === null) {
+            textWriters = Array.from(this._textWritersMap.values());
+        }
+        else if (textWriterIDs.length === 0) {
+            return;
+        }
+        else {
+            textWriters = textWriterGetOrThrow(this._textWritersMap, textWriterIDs);
+        }
+        centerIDs.forEach(function (centerID) { _this._ringAccount.textUpdate(centerID, textWriters, _this._textDataPreAdaptor); });
+    };
+    return RangeRings;
+}());
+exports.RangeRings = RangeRings;
+var textWriterGetOrThrow = (0, get_1.mapGetOrThrow)("textWriterIDs is invalid");