@pirireis/webglobeplugins 0.9.6 → 0.9.7

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

@@ -1,66 +0,0 @@
-import './types'
-
-/**
- * Represents the range of vertices or instances to draw.
- */
-interface DrawRange {
-    first?: number;
-    count: number;
-}
-
-/**
- * Parameters for drawing with optional element buffer and draw mode.
- */
-interface DrawRangeIndexParams {
-    drawRange: DrawRange;
-    elementBuffer?: WebGLBuffer | null;
-    elementBufferIndexType?: GLenum;
-    drawMode?: GLenum | null;
-}
-
-/**
- * Draws instanced geometry using WebGL2.
- */
-const drawInstanced = (
-    gl: WebGL2RenderingContext,
-    mode: GLenum,
-    drawOptions: DrawRangeIndexParams,
-    vertexCount: number
-): void => {
-    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, drawOptions.elementBuffer ?? null);
-        gl.drawElementsInstanced(mode, vertexCount, elementBufferIndexType, first, instanceCount);
-        gl.bindBuffer(gl.ELEMENT_ARRAY_BUFFER, null);
-    } else {
-        gl.drawArraysInstanced(mode, first, vertexCount, instanceCount);
-    }
-}
-
-/**
- * Draws geometry using WebGL2.
- */
-const drawArrays = (
-    gl: WebGL2RenderingContext,
-    defaultMode: GLenum,
-    drawOptions: DrawRangeIndexParams
-): void => {
-    const {
-        drawRange,
-        elementBuffer,
-        elementBufferIndexType = gl.UNSIGNED_INT,
-        drawMode = null
-    } = drawOptions;
-    const { first = 0, count } = drawRange;
-    const mode = 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);
-    }
-}
-
-export { drawArrays, drawInstanced }

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

@@ -1,28 +0,0 @@
-/**
- * @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
- * 
- */
-
-
-type DrawRange = {
-    first: number;
-    count: number;
-};
-
-type DrawRangeIndexParams = {
-    drawRange: DrawRange;
-    elementBuffer?: WebGLBuffer;
-    elementBufferIndexType?: number;
-    drawMode?: number;
-};
-

package/util/gl-util/uniform-block/manager.ts

@@ -1,187 +0,0 @@
-import "./types";
-
-const typeSizes = {
-    'float': 4,
-    'vec2': 8,
-    'vec3': 16,  // vec3 takes up same space as vec4 due to alignment
-    'vec4': 16,
-    'mat2': 32,  // 2 vec4s (16 * 2)
-    'mat3': 48,  // 3 vec4s (16 * 3)
-    'mat4': 64,  // 4 vec4s (16 * 4)
-    'int': 4,
-    'ivec2': 8,
-    'ivec3': 16,
-    'ivec4': 16,
-    'bool': 4
-};
-
-const typeAlignments = {
-    'float': 4,
-    'vec2': 8,
-    'vec3': 16,
-    'vec4': 16,
-    'mat2': 16,  // aligns to vec4 boundary
-    'mat3': 16,  // aligns to vec4 boundary
-    'mat4': 16,  // aligns to vec4 boundary
-    'int': 4,
-    'ivec2': 8,
-    'ivec3': 16,
-    'ivec4': 16,
-    'bool': 4
-};
-
-
-const typeArrayConstructors = {
-    'float': Float32Array,
-    'vec2': Float32Array,
-    'vec3': Float32Array,
-    'vec4': Float32Array,
-    'mat2': Float32Array,
-    'mat3': Float32Array,
-    'mat4': Float32Array,
-    'int': Int32Array,
-    'ivec2': Int32Array,
-    'ivec3': Int32Array,
-    'ivec4': Int32Array,
-    'bool': Float32Array
-};
-
-
-class UniformBlockManager {
-
-    /**
-     * 
-     * @param {UniformBlockName} blockName 
-     * @param {Array<UniformBlockMember} blockMembers 
-     * @param {string} prefix usage name of block in the shader 
-     */
-
-    blockName: string;
-    blockMembers: Array<UniformBlockMember>;
-    bindingPoint: number;
-    prefix: string;
-    offsetMap: Map<string, number>;
-    size: number;
-
-    constructor(blockName: string, blockMembers: Array<UniformBlockMember>, bindingPoint: number, prefix: string = "") {
-        this.blockName = blockName;
-        this.blockMembers = blockMembers;
-        this.bindingPoint = bindingPoint;
-        this.prefix = prefix;
-        this.offsetMap = this.__create_LayoutSTD140_OffsetMap();
-        this.size = this.__calculateSize();
-    }
-
-
-
-    glslCode() {
-        let code = `layout(std140) uniform ${this.blockName} {`;
-        for (const member of this.blockMembers) {
-            const { name, type } = member;
-            code += `${type} ${this.prefix}${name};`;
-        }
-        if (this.prefix) {
-            code += `} ${this.prefix};`;
-        } else {
-            code += `};`;
-        }
-        return code;
-    }
-
-
-    createUBO(gl: WebGL2RenderingContext, bufferWriteType: string = "STATIC_DRAW"): UBOHandler {
-        const ubo = gl.createBuffer();
-        gl.bindBuffer(gl.UNIFORM_BUFFER, ubo);
-        // @ts-ignore
-        gl.bufferData(gl.UNIFORM_BUFFER, this.size, gl[bufferWriteType]);
-        gl.bindBufferBase(gl.UNIFORM_BUFFER, 0, ubo);
-
-        for (const member of this.blockMembers) {
-            const { name, type, value = null } = member;;
-            const offset = this.offsetMap.get(name) as number;
-            const data = (value === null) ? new typeArrayConstructors[type](typeSizes[type] / 4).fill(NaN) : value;
-            gl.bufferSubData(gl.UNIFORM_BUFFER, offset, data);
-        }
-        gl.bindBuffer(gl.UNIFORM_BUFFER, null);
-
-        return { // TODO typedef this, encapsulate this in a class or something, ask ai
-            ubo,
-            update: (nameValueMap: NameValueMap) => this.updateUBO(gl, ubo, nameValueMap),
-            bind: () => this.bind(gl, ubo),
-            unbind: () => this.unbind(gl),
-            free: () => gl.deleteBuffer(ubo),
-        };
-    }
-
-
-    updateUBO(gl: WebGL2RenderingContext, ubo: WebGLBuffer, nameValueMap: NameValueMap) {
-        gl.bindBuffer(gl.UNIFORM_BUFFER, ubo);
-        for (const [name, value] of nameValueMap.entries()) {
-            const offset = this.offsetMap.get(name);
-            if (offset === undefined) {
-                throw new Error(`Uniform block member ${name} not found in offset map.`);
-            }
-            // @ts-ignore
-            const type = this.blockMembers.find(member => member.name === name).type;
-            let data: Float32Array | Int32Array | ArrayBuffer | DataView;
-            if (Array.isArray(value)) {
-                data = new typeArrayConstructors[type](value);
-            } else if (typeof value === 'number') {
-                data = new typeArrayConstructors[type]([value]);
-            } else if (value instanceof ArrayBuffer) {
-                data = new typeArrayConstructors[type](value);
-            } else if (ArrayBuffer.isView(value) && !(value instanceof DataView))
-                data = (typeof value === 'number') ? new typeArrayConstructors[type]([value]) : new typeArrayConstructors[type](value);
-            else {
-                throw new Error(`Unsupported value type for ${name}: ${typeof value}`);
-            }
-            console.log("Data to be uploaded:", data);
-            gl.bufferSubData(gl.UNIFORM_BUFFER, offset, data);
-        }
-        gl.bindBuffer(gl.UNIFORM_BUFFER, null);
-    }
-
-    // call this after linking the program
-    assignBindingPoint(gl: WebGL2RenderingContext, program: WebGLProgram) {
-        const blockIndex = gl.getUniformBlockIndex(program, this.blockName);
-        gl.uniformBlockBinding(program, blockIndex, this.bindingPoint);
-    }
-
-    // call this before drawing
-    bind(gl: WebGL2RenderingContext, ubo: WebGLBuffer) {
-        gl.bindBufferBase(gl.UNIFORM_BUFFER, this.bindingPoint, ubo);
-    }
-
-    // call this right after drawing
-    unbind(gl: WebGL2RenderingContext) {
-        gl.bindBufferBase(gl.UNIFORM_BUFFER, this.bindingPoint, null);
-    }
-
-
-    // implicit methods
-    __create_LayoutSTD140_OffsetMap(): Map<string, number> {
-        let offset = 0;
-        const offsetMap = new Map();
-        for (const member of this.blockMembers) {
-            const { name, type } = member;
-            const size = typeSizes[type];
-            const alignment = typeAlignments[type];
-            const padding = (alignment - (offset % alignment)) % alignment;
-            offset += padding;
-            offsetMap.set(name, offset);
-            offset += size;
-        }
-        return offsetMap;
-    }
-
-    // __create_LayoutSTD140_OffsetMap() should be called before this
-    __calculateSize() {
-        const lastOffset = Array.from(this.offsetMap.values()).pop() as number || 0;
-        const lastItemAlignment = typeAlignments[this.blockMembers[this.blockMembers.length - 1].type];
-        return lastOffset + lastItemAlignment;
-    }
-
-}
-
-
-export { UniformBlockManager };

package/util/gl-util/uniform-block/roadmap.md

@@ -1,70 +0,0 @@
-# UniformBlock Wrapper
-
-- Uniform shader string
-- bind/unbind
-- set/get uniform value generic
-
-## INPUT
-- uniform block name
-- Array<{type, name}> UniformBlockMembers
-
-
-## PROCESS
-
-- Calculate and save starting offset of each member
-- Create UBO
-- Bind UBO
-- Set uniform value
-
-### Calculate and save starting offset of each member
-
-layout(std140) is a convention. The calculation should be done according to this convention.
-
-
-type | size
---- | --- 
-float | 4 
-vec2 | 8 
-vec3 | 12 
-vec4 | 16 
-mat2 | 16 
-mat3 | 48 
-mat4 | 64 
-
-A line is 16 bytes aligned. Alignment can be shared if previous member is equal or bigger then the next member and the sum of the sizes are smaller then 16 bytes.
-
-
-
-
-
-
-
-
-
-
-## setMethod
-
-    update({
-        color = null,
-        bboxOffsetRad = null,
-        bboxSizeRad = null,
-        resolution = null,
-        tailLengthRatio = null,
-        wingLengthRatio = null,
-        height = null,
-        opacity = null,
-        noDataValue = null,
-    } = {}) {
-        const { gl, ubo } = this;
-        gl.bindBuffer(gl.UNIFORM_BUFFER, ubo);
-        if (color !== null) gl.bufferSubData(gl.UNIFORM_BUFFER, 0, new Float32Array(color));
-        if (opacity !== null) gl.bufferSubData(gl.UNIFORM_BUFFER, 12, new Float32Array([opacity]));
-        if (bboxOffsetRad !== null) gl.bufferSubData(gl.UNIFORM_BUFFER, 16, new Float32Array(bboxOffsetRad));
-        if (bboxSizeRad !== null) gl.bufferSubData(gl.UNIFORM_BUFFER, 24, new Float32Array(bboxSizeRad));
-        if (resolution !== null) gl.bufferSubData(gl.UNIFORM_BUFFER, 32, new Float32Array(resolution));
-        if (tailLengthRatio !== null) gl.bufferSubData(gl.UNIFORM_BUFFER, 40, new Float32Array([tailLengthRatio]));
-        if (wingLengthRatio !== null) gl.bufferSubData(gl.UNIFORM_BUFFER, 44, new Float32Array([wingLengthRatio]));
-        if (height !== null) gl.bufferSubData(gl.UNIFORM_BUFFER, 48, new Float32Array([height]));
-        if (noDataValue !== null) gl.bufferSubData(gl.UNIFORM_BUFFER, 52, new Float32Array([noDataValue]));
-        gl.bindBuffer(gl.UNIFORM_BUFFER, null);
-    }

package/util/gl-util/uniform-block/types.ts

@@ -1,27 +0,0 @@
-/**
- * @typedef {string} UniformBlockName
- *
- * @typedef {string} GLSLType | mat4, mat3, vec4, vec3, vec2, float, int, bool
- * @typedef {{name: string, type: GLSLType, value: null|Float32Array}} UniformBlockMember
- * 
- */
-
-
-type UniformBlockName = string;
-type GLSLType = "mat4" | "mat3" | "vec4" | "vec3" | "vec2" | "float" | "int" | "bool";
-type UniformBlockMember = {
-    name: string;
-    type: GLSLType;
-    value: Float32Array | null;
-};
-
-
-type NameValueMap = Map<string, Array<number> | DataView | ArrayBuffer>;
-
-type UBOHandler = {
-    ubo: WebGLBuffer;
-    update: (nameValueMap: Map<string, any>) => void;
-    bind: () => void;
-    unbind: () => void;
-    free: () => void;
-};

package/util/heatwavedatamanager/datamanager.js

@@ -1,168 +0,0 @@
-/**
- * todo: 
- * data must be processed before being set to the cache
- */
-
-export default class DataManager {
-    /**
-     * 
-     * @param {Array<number>} timeEpocs | array of time epocs
-     * @param {Function} fetchMethod | fetchMethod(time) => Promise<data> 
-     * @param {boolean} autoDownload | auto download data or not
-    */
-    constructor(timeEpocs, fetchMethod, { autoDownload = true } = {}) {
-
-        this._timeEpocs = timeEpocs.sort((a, b) => a - b);
-        this._datas = []; this._datas.length = timeEpocs.length;
-
-        // in construction
-        this._dataPromises = []; this._dataPromises.length = timeEpocs.length;
-
-        this._fetchMethod = fetchMethod;
-        this._callbackmethods = [];
-        this._callbackmethodOwners = [];
-        this._lastTime = -1;
-        this._lastIndex = -1;
-        this.autoDownload(autoDownload);
-    }
-
-
-    autoDownload(bool, time) {
-        if (!bool) {
-            this._autoDownload = false;
-            return;
-        }
-        let index = this._lastIndex === -1 ? 0 : this._lastIndex;
-        if (time !== undefined) {
-            if (time < this._timeEpocs[0] || time > this._timeEpocs[this._timeEpocs.length - 1]) {
-                this._autoDownload = bool;
-                return;
-            }
-            index = this._findIndex(time);
-        }
-
-        if (this._downloadStartIndex === index && this._autoDownload === bool) return;
-        this._downloadStartIndex = index;
-        this._autoDownload = bool;
-        const recursion = (startId, currentDownloadId) => {
-            if (startId !== this._downloadStartIndex) return;
-            if (currentDownloadId < this._timeEpocs.length && this._autoDownload) {
-                this._getData(currentDownloadId).then(() => {
-                    recursion(startId, currentDownloadId + 1);
-                });
-            }
-        }
-        recursion(index, index);
-        // save index as start index
-        //start recursive download
-
-        // use started id as a flag to stop the download
-    }
-
-
-
-    /**
-     * @param {number} time 
-     * It looks like async function is not needed here. changes just overwrites the previous changes.
-     */
-    updateTime(time) {
-        if (time < this._timeEpocs[0] || time > this._timeEpocs[this._timeEpocs.length - 1]) {
-            this._dontRender();
-            return;
-        }
-        this._lastTime = time;
-        const index = this._findIndex(time);
-        const ratio = this._getRatio(time, index);
-        Promise.all([this._getData(index - 1), this._getData(index)]).then((datas) => {
-            if (this._lastTime === time) {
-                this._lastIndex = index;
-                this._ratio = ratio;
-                this._pushCallback(ratio, datas);
-            }
-        });
-    }
-
-
-    register(key, callback) {
-        if (this._callbackmethodOwners.indexOf(key) !== -1) {
-            console.warn("key already registered, old one is unregistered");
-            this.unregister(key);
-        }
-        this._callbackmethods.push(callback);
-        this._callbackmethodOwners.push(key);
-        if (this._lastIndex !== -1) callback(this._ratio, this._datas[this._lastIndex - 1], this._datas[this._lastIndex]);
-    }
-
-
-    /**
-     * @param {*} key | id of the owner of the callback
-     */
-    unregister(key) {
-        let index = this._callbackmethodOwners.indexOf(key);
-        if (index !== -1) {
-            this._callbackmethods.splice(index, 1);
-            this._callbackmethodOwners.splice(index, 1);
-        }
-        if (this._callbackmethods.length === 0) {
-            this.free();
-        }
-    }
-
-
-    free() {
-        this._callbackmethods = [];
-        this._callbackmethodOwners = [];
-        this._autoDownload = false;
-    }
-
-    _findIndex(time) {
-        const { _timeEpocs } = this;
-        let index = this._lastIndex === -1 ? 1 : this._lastIndex;
-        if (this)
-            if (time < _timeEpocs[index - 1]) {
-                while (index > 1 && time < _timeEpocs[index - 1]) {
-                    index--;
-                }
-            } else if (time > _timeEpocs[index]) {
-                while (index < _timeEpocs.length - 1 && time > _timeEpocs[index]) {
-                    index++;
-                }
-            }
-        return index;
-    }
-
-
-    _getRatio(time, index) {
-        return (time - this._timeEpocs[index - 1]) / (this._timeEpocs[index] - this._timeEpocs[index - 1]);
-    }
-
-
-    _pushCallback(ratio, datas) {
-        for (let i = 0; i < this._callbackmethods.length; i++) {
-            this._callbackmethods[i](ratio, ...datas);
-        }
-    }
-
-
-    async _getData(index) {
-        if (index < 0 || index >= this._timeEpocs.length) {
-            throw new Error("Index out of range");
-        }
-        if (!this._datas[index]) {
-            if (!this._dataPromises[index]) this._dataPromises[index] = this._fetchMethod(this._timeEpocs[index]).then((data) => {
-                this._datas[index] = data;
-            }, (error) => {
-                console.error("error", error);
-            }).finally(() => {
-                this._dataPromises[index] = null;
-            });
-        }
-        await this._dataPromises[index];
-        return this._datas[index];
-    }
-
-    _dontRender() {
-        this._pushCallback(0, [null, null]);
-    }
-
-}

package/util/heatwavedatamanager/index.js

@@ -1,3 +0,0 @@
-import PointCoordinatesDataCalculator from "./pointcoordinatesdatacalculator";
-import HeatWaveDataManager from "./datamanager";
-export { HeatWaveDataManager, PointCoordinatesDataCalculator };

package/util/heatwavedatamanager/pointcoordinatesdatacalculator.js

@@ -1,133 +0,0 @@
-import PointCoordsMeta from "./pointcoordsmeta";
-
-
-const pointObject = (long, lat, posIndex, callback) => {
-    return { long, lat, posIndex, callback };
-}
-
-export default class PointCoordinatesDataCalculator {
-    constructor(bbox, width, height) {
-        this._pointObjects = {};
-
-        this._ratio = 0.0;
-
-        this._bbox = bbox;
-        this._width = width;
-        this._height = height;
-        this._metaCalculater = new PointCoordsMeta(bbox, width, height);
-
-        this._texture0 = null;
-        this._texture1 = null;
-    }
-
-    /**
-     * 
-     * @param {*} key 
-     * @param {*} lat 
-     * @param {*} long 
-     * @param {*} callback | callback(data0, data1, interpolated)
-     */
-    registerPoint(key, long, lat, callback) {
-        if (key in this._pointObjects) {
-            console.warn("key already registered, old one is unregistered");
-            this.unregisterPoint(key);
-        }
-        if (!this._isInBBox(long, lat)) return false;
-
-        const meta = this._metaCalculater.getFlooredMeta(long, lat)
-
-        this._pointObjects[key] = pointObject(long, lat, meta.index, callback);
-        if (this._texture0 && this._texture1) {
-            const { data0, data1, interpolated } = this._findAPoint(meta.index);
-            callback(data0, data1, interpolated);
-        }
-        return true;
-    }
-
-    _isInBBox(long, lat) {
-        return lat >= this._bbox[1] && lat <= this._bbox[3] && long >= this._bbox[0] && long <= this._bbox[2];
-    }
-
-
-    unregisterPoint(key) {
-        if (!(key in this._pointObjects)) return false;
-        delete this._pointObjects[key];
-        return true;
-    }
-
-    updatePoint(key, long, lat) {
-
-        if (!(key in this._pointObjects)) return false;
-        if (!this._isInBBox(long, lat)) return false;
-        this._pointObjects[key].long = long;
-        this._pointObjects[key].lat = lat;
-        const meta = this._metaCalculater.getFlooredMeta(long, lat);
-        this._pointObjects[key].posIndex = meta.index;
-        const { data0, data1, interpolated } = this._findAPoint(meta.index);
-        this._pointObjects[key].callback(data0, data1, interpolated);
-        return true;
-    }
-
-    /**
-     * @param {Number} ratio 0-1
-     * @param {} textureData0 
-     * @param {*} textureData1 
-     */
-    updateData(ratio, textureData0 = null, textureData1 = null) {
-        if (!textureData0 && !textureData1) {
-            this._pushPointCallBackEmpty();
-            return;
-        }
-        if (textureData0 && textureData1) {
-            this._texture0 = textureData0;
-            this._texture1 = textureData1;
-        }
-        this._ratio = ratio;
-        this._pushPointCallbackAll();
-    }
-
-
-    _findAPoint(posIndex) {
-        const data0 = this._texture0[posIndex];
-        const data1 = this._texture1[posIndex];
-        const interpolated = data0 * (1 - this._ratio) + data1 * this._ratio;
-        return { data0, data1, interpolated };
-    }
-
-    _pushPointCallbackAll() {
-        for (const key in this._pointObjects) {
-            const { posIndex, callback } = this._pointObjects[key];
-            const { data0, data1, interpolated } = this._findAPoint(posIndex);
-            callback(data0, data1, interpolated);
-        }
-    }
-
-    _pushPointCallBackEmpty() {
-        for (const key in this._pointObjects) {
-            const { callback } = this._pointObjects[key];
-            callback(null, null, null);
-        }
-    }
-
-    flush() {
-        this._pointObjects = {};
-    }
-}
-
-// function test() {
-//     const cp = window.plugin.getPointCoordinatesDataCalculator();
-//     const bbox = [-15, 25, 70, 60];
-//     cp.registerPoint("left up", -15, 60, (data0, data1, interpolated) => {
-//         console.log("left up", data0, data1, interpolated);
-//     });
-//     cp.registerPoint("right up", 70, 60, (data0, data1, interpolated) => {
-//         console.log("right up", data0, data1, interpolated);
-//     });
-//     cp.registerPoint("left down", -15, 25, (data0, data1, interpolated) => {
-//         console.log("right down", data0, data1, interpolated);
-//     });
-//     cp.registerPoint("right down", 70, 25, (data0, data1, interpolated) => {
-//         console.log("right down", data0, data1, interpolated);
-//     });
-//     return cp;
-// }