@pirireis/webglobeplugins 0.16.0 → 0.16.1

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

@@ -1,210 +0,0 @@
-import { UBOHandler } from "../../../types";
-
-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
-};
-
-
-export 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),
-            updateSingle: (key: string, value: Float32Array | Int32Array | ArrayBuffer | DataView) => this.updateUboSingle(gl, ubo, key, value),
-            bind: () => this.bind(gl, ubo),
-            unbind: () => this.unbind(gl),
-            free: () => gl.deleteBuffer(ubo),
-        };
-    }
-
-    updateUboSingle(gl: WebGL2RenderingContext, ubo: WebGLBuffer, key: string, value: Float32Array | Int32Array | ArrayBuffer | DataView) { // TEST THIS
-        gl.bindBuffer(gl.UNIFORM_BUFFER, ubo);
-        const offset = this.offsetMap.get(key);
-        if (offset === undefined) {
-            throw new Error(`Uniform block member ${key} not found in offset map.`);
-        }
-        // @ts-ignore
-        const type = this.blockMembers.find(member => member.name === key).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 ${key}: ${typeof value}`);
-        }
-        gl.bufferSubData(gl.UNIFORM_BUFFER, offset, data);
-        gl.bindBuffer(gl.UNIFORM_BUFFER, null);
-
-    }
-
-    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}`);
-            }
-            gl.bufferSubData(gl.UNIFORM_BUFFER, offset, data);
-        }
-        gl.bindBuffer(gl.UNIFORM_BUFFER, null);
-    }
-
-    // call this after linking the program
-    assignBindingPoint(gl: WebGL2RenderingContext, program: WebGLProgram) { // TODO: this can cause bugs on multiglobe
-        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;
-    }
-
-}

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,20 +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>;
-

package/util/heatwavedatamanager/pointcoordsmeta.ts

@@ -1,28 +0,0 @@
-export default class PointCoordsMeta {
-
-    _bbox: [number, number, number, number];
-    _width: number;
-    _height: number;
-    _xRatio: number;
-    _yRatio: number;
-
-    constructor(bbox: [number, number, number, number], width: number, height: number) {
-        this._bbox = bbox;
-        this._width = width;
-        this._height = height;
-        this._xRatio = this._width / (this._bbox[2] - this._bbox[0]);
-        this._yRatio = this._height / (this._bbox[3] - this._bbox[1]);
-
-    }
-
-    getFlooredIndex(long: number, lat: number): number {
-        let x = (long - this._bbox[0]) * this._xRatio;
-        let y = (this._bbox[3] - lat) * this._yRatio;
-        x = x > 0 ? x - 1 : 0;
-        y = y > 0 ? y - 1 : 0;
-        const index = Math.floor(y) * this._width + Math.floor(x);
-        return index;
-    }
-}
-
-

package/util/heatwavedatamanager/texture-point-sampler.ts

@@ -1,198 +0,0 @@
-import PointCoordsMeta from "./pointcoordsmeta";
-
-type BBOX = [number, number, number, number];
-type CallBackFunction = (data0: number | null, data1: number | null, interpolated: number | null) => void;
-type PointObject = {
-    long: number;
-    lat: number;
-    posIndex: number;
-    callback: CallBackFunction;
-}
-type TypedArray = Float32Array | Uint8Array | Uint16Array | Uint32Array;
-
-const pointObject = (long: number, lat: number, posIndex: number, callback: CallBackFunction): PointObject => {
-    return { long, lat, posIndex, callback };
-}
-
-
-
-
-export class TexturePointSampler {
-    _bbox: BBOX;
-    _width: number;
-    _height: number;
-    _textureCount: 1 | 2;
-    _metaCalculater: PointCoordsMeta;
-    _pointObjects: Map<string, PointObject>;
-    _textures: Array<TypedArray>;
-    _ratio: number;
-    _isReady: boolean = false;
-
-    constructor(bbox: BBOX, width: number, height: number, textureCount: 1 | 2 = 2) {
-        this._pointObjects = new Map<string, PointObject>();
-
-        this._ratio = 0.0;
-        this._bbox = bbox;
-        this._width = width;
-        this._height = height;
-        this._textureCount = textureCount;
-        this._metaCalculater = new PointCoordsMeta(bbox, width, height);
-        this._textures = new Array(textureCount).fill(null);
-        this._isReady = false;
-    }
-
-    setTextureCount(textureCount: 1 | 2) {
-        if (textureCount !== 1 && textureCount !== 2) {
-            throw new Error("Texture count must be 1 or 2");
-        }
-
-        this._textureCount = textureCount;
-        this._pushPointCallbackAll();
-    }
-
-    registerPoint(key: string, long: number, lat: number, callback: CallBackFunction): boolean {
-        if (key in this._pointObjects) {
-            console.warn("key already registered, old one is unregistered");
-            this.unregisterPoint(key);
-        }
-        if (!this._isInBBox(long, lat)) {
-            this._pointObjects.set(key, pointObject(long, lat, -1, callback));
-            this._findAndSend(key);
-
-            return false;
-        } else {
-            const index = this._metaCalculater.getFlooredIndex(long, lat)
-            this._pointObjects.set(key, pointObject(long, lat, index, callback));
-        }
-
-        this._findAndSend(key);
-        return true;
-    }
-
-
-
-    unregisterPoint(key: string): boolean {
-        return this._pointObjects.delete(key);
-    }
-
-    updatePoint(key: string, long: number, lat: number): boolean {
-        const pointObject = this._pointObjects.get(key);
-        if (!pointObject) {
-            console.warn("Point not registered, use registerPoint first");
-            return false;
-        }
-        pointObject.long = long;
-        pointObject.lat = lat;
-        if (!this._isInBBox(long, lat)) {
-            pointObject.posIndex = -1; // Mark as invalid
-            pointObject.callback(null, null, null);
-            return false
-        };
-
-        const index = this._metaCalculater.getFlooredIndex(long, lat);
-        pointObject.posIndex = index;
-        this._findAndSend(key);
-
-        return true;
-    }
-
-    updateTextureData(ratio: number, textureData0: TypedArray | null = null, textureData1: TypedArray | null = null,) {
-
-        if (this._textureCount === 1) {
-            if (textureData0 === null) {
-                this._isReady = false;
-            } else {
-                this._textures[0] = textureData0;
-                this._isReady = true;
-            }
-        } else if (this._textureCount === 2) {
-            if (textureData0 === null || textureData1 === null) {
-                this._isReady = false;
-            } else {
-                this._textures[0] = textureData0;
-                this._textures[1] = textureData1;
-                this._isReady = true;
-            }
-        } else {
-            throw new Error("Invalid texture count, must be 1 or 2");
-        }
-        this.updateRatio(ratio);
-    }
-
-
-    updateRatio(ratio: number) {
-        if (typeof ratio !== "number") {
-            throw new Error("Ratio must be a number");
-        }
-        this._ratio = ratio;
-        this._pushPointCallbackAll();
-    }
-
-    flush(callEmptyCallback: boolean = false) {
-        if (callEmptyCallback) {
-            for (const [key, { callback }] of this._pointObjects.entries()) {
-                callback(null, null, null);
-            }
-        }
-        this._pointObjects.clear();
-    }
-
-    // ------- PRIVATE METHODS -------
-
-    _isInBBox(long: number, lat: number) {
-        return lat >= this._bbox[1] && lat <= this._bbox[3] && long >= this._bbox[0] && long <= this._bbox[2];
-    }
-
-
-    _findAndSend(key: string) {
-        const pointObject = this._pointObjects.get(key);
-        if (!pointObject) {
-            console.warn("Point not registered, use registerPoint first");
-            return;
-        }
-        const { posIndex, callback } = pointObject;
-        if (posIndex === -1 || !this._isReady || this._ratio < 0 || this._ratio > 1) {
-            callback(null, null, null);
-            return;
-        }
-        const data0 = this._textures[0][posIndex];
-
-        if (this._textureCount === 1) {
-            callback(data0, data0, data0);
-        } else if (this._textureCount === 2) {
-            const data1 = this._textures[1][posIndex];
-            const interpolated = data0 * (1 - this._ratio) + data1 * this._ratio;
-            callback(data0, data1, interpolated);
-        }
-    }
-
-    _pushPointCallbackAll() {
-        if (this._isReady && this._ratio >= 0 && this._ratio <= 1) {
-            for (const key of this._pointObjects.keys()) {
-                this._findAndSend(key);
-            }
-        } else {
-            for (const [key, { callback }] of this._pointObjects.entries()) {
-                callback(null, null, null);
-            }
-        }
-    }
-}
-
-// 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;
-// }