@math.gl/geometry-utils 4.2.0-alpha.5

package/dist/geometry.d.ts

@@ -0,0 +1,20 @@
+import type { TypedArray } from '@math.gl/types';
+/** A typed geometry attribute with either loaders.gl-style `value` or legacy `values` storage. */
+export type GeometryAttribute = {
+    value?: TypedArray;
+    values?: TypedArray;
+    size?: number;
+};
+/** Minimal geometry shape understood by the geometry utilities. */
+export type Geometry = {
+    mode: number;
+    indices?: GeometryAttribute | TypedArray;
+    attributes: Record<string, GeometryAttribute>;
+};
+/** Returns whether a value has the minimal geometry shape. */
+export declare function isGeometry(value: unknown): value is Geometry;
+/** Returns the typed array stored in a geometry attribute. */
+export declare function getAttributeValues(attribute: GeometryAttribute | TypedArray): TypedArray;
+/** Returns a geometry's position attribute. */
+export declare function getPositionAttribute(geometry: Geometry): GeometryAttribute;
+//# sourceMappingURL=geometry.d.ts.map

package/dist/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../src/geometry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,gBAAgB,CAAC;AAE/C,kGAAkG;AAClG,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,mEAAmE;AACnE,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,iBAAiB,GAAG,UAAU,CAAC;IACzC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAC/C,CAAC;AAEF,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAM5D;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,iBAAiB,GAAG,UAAU,GAAG,UAAU,CASxF;AAED,+CAA+C;AAC/C,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,iBAAiB,CAM1E"}

package/dist/geometry.js

@@ -0,0 +1,31 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/** Returns whether a value has the minimal geometry shape. */
+export function isGeometry(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const geometry = value;
+    return typeof geometry.mode === 'number' && Boolean(geometry.attributes);
+}
+/** Returns the typed array stored in a geometry attribute. */
+export function getAttributeValues(attribute) {
+    if (ArrayBuffer.isView(attribute)) {
+        return attribute;
+    }
+    const values = attribute.value || attribute.values;
+    if (!values) {
+        throw new Error('Geometry attribute does not contain typed-array values');
+    }
+    return values;
+}
+/** Returns a geometry's position attribute. */
+export function getPositionAttribute(geometry) {
+    const position = geometry.attributes['POSITION'] || geometry.attributes['positions'];
+    if (!position) {
+        throw new Error('Geometry does not contain a position attribute');
+    }
+    return position;
+}
+//# sourceMappingURL=geometry.js.map

package/dist/geometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.js","sourceRoot":"","sources":["../src/geometry.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,oCAAoC;AAkBpC,8DAA8D;AAC9D,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,QAAQ,GAAG,KAA0B,CAAC;IAC5C,OAAO,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AAC3E,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,kBAAkB,CAAC,SAAyC;IAC1E,IAAI,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAClC,OAAO,SAAuB,CAAC;IACjC,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,IAAI,SAAS,CAAC,MAAM,CAAC;IACnD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,oBAAoB,CAAC,QAAkB;IACrD,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IACrF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/gl-type.d.ts

@@ -0,0 +1,17 @@
+import type { TypedArray, TypedArrayConstructor } from '@math.gl/types';
+/** Converts between WebGL component constants and JavaScript typed arrays. */
+export default class GLType {
+    /** Returns the WebGL component constant for a typed array or typed-array constructor. */
+    static fromTypedArray(arrayOrType: TypedArray | TypedArrayConstructor): number;
+    /** Returns a WebGL component constant from its uppercase name. */
+    static fromName(name: string): number;
+    /** Returns the typed-array constructor for a WebGL component constant. */
+    static getArrayType(glType: number): TypedArrayConstructor;
+    /** Returns the size in bytes of one element of a WebGL component type. */
+    static getByteSize(glType: number): number;
+    /** Returns whether a value is a supported WebGL component type. */
+    static validate(glType: number): boolean;
+    /** Creates a typed view over an ArrayBuffer or an existing ArrayBuffer view. */
+    static createTypedArray(glType: number, buffer: ArrayBufferLike | ArrayBufferView, byteOffset?: number, length?: number): TypedArray;
+}
+//# sourceMappingURL=gl-type.d.ts.map

package/dist/gl-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gl-type.d.ts","sourceRoot":"","sources":["../src/gl-type.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,UAAU,EAAE,qBAAqB,EAAC,MAAM,gBAAgB,CAAC;AAuBtE,8EAA8E;AAC9E,MAAM,CAAC,OAAO,OAAO,MAAM;IACzB,yFAAyF;IACzF,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,UAAU,GAAG,qBAAqB,GAAG,MAAM;IAa9E,kEAAkE;IAClE,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQrC,0EAA0E;IAC1E,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB;IAQ1D,0EAA0E;IAC1E,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAI1C,mEAAmE;IACnE,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIxC,gFAAgF;IAChF,MAAM,CAAC,gBAAgB,CACrB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,eAAe,GAAG,eAAe,EACzC,UAAU,SAAI,EACd,MAAM,CAAC,EAAE,MAAM,GACd,UAAU;CASd"}

package/dist/gl-type.js

@@ -0,0 +1,69 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { GL_TYPE } from "./constants.js";
+const GL_TYPE_TO_ARRAY_TYPE = {
+    [GL_TYPE.DOUBLE]: Float64Array,
+    [GL_TYPE.FLOAT]: Float32Array,
+    [GL_TYPE.UNSIGNED_SHORT]: Uint16Array,
+    [GL_TYPE.UNSIGNED_INT]: Uint32Array,
+    [GL_TYPE.UNSIGNED_BYTE]: Uint8Array,
+    [GL_TYPE.BYTE]: Int8Array,
+    [GL_TYPE.SHORT]: Int16Array,
+    [GL_TYPE.INT]: Int32Array,
+    [GL_TYPE.UNSIGNED_SHORT_4_4_4_4]: Uint16Array,
+    [GL_TYPE.UNSIGNED_SHORT_5_5_5_1]: Uint16Array,
+    [GL_TYPE.UNSIGNED_SHORT_5_6_5]: Uint16Array
+};
+const NAME_TO_GL_TYPE = Object.fromEntries(Object.entries(GL_TYPE).map(([name, glType]) => [name, glType]));
+const TYPE_CONVERSION_ERROR = 'Failed to convert GL type';
+/** Converts between WebGL component constants and JavaScript typed arrays. */
+export default class GLType {
+    /** Returns the WebGL component constant for a typed array or typed-array constructor. */
+    static fromTypedArray(arrayOrType) {
+        const arrayType = ArrayBuffer.isView(arrayOrType) ? arrayOrType.constructor : arrayOrType;
+        if (arrayType === Uint8ClampedArray) {
+            return GL_TYPE.UNSIGNED_BYTE;
+        }
+        for (const [glType, candidateArrayType] of Object.entries(GL_TYPE_TO_ARRAY_TYPE)) {
+            if (candidateArrayType === arrayType) {
+                return Number(glType);
+            }
+        }
+        throw new Error(TYPE_CONVERSION_ERROR);
+    }
+    /** Returns a WebGL component constant from its uppercase name. */
+    static fromName(name) {
+        const glType = NAME_TO_GL_TYPE[name];
+        if (glType === undefined) {
+            throw new Error(TYPE_CONVERSION_ERROR);
+        }
+        return glType;
+    }
+    /** Returns the typed-array constructor for a WebGL component constant. */
+    static getArrayType(glType) {
+        const ArrayType = GL_TYPE_TO_ARRAY_TYPE[glType];
+        if (!ArrayType) {
+            throw new Error(TYPE_CONVERSION_ERROR);
+        }
+        return ArrayType;
+    }
+    /** Returns the size in bytes of one element of a WebGL component type. */
+    static getByteSize(glType) {
+        return GLType.getArrayType(glType).BYTES_PER_ELEMENT;
+    }
+    /** Returns whether a value is a supported WebGL component type. */
+    static validate(glType) {
+        return Boolean(GL_TYPE_TO_ARRAY_TYPE[glType]);
+    }
+    /** Creates a typed view over an ArrayBuffer or an existing ArrayBuffer view. */
+    static createTypedArray(glType, buffer, byteOffset = 0, length) {
+        const ArrayType = GLType.getArrayType(glType);
+        const arrayBuffer = ArrayBuffer.isView(buffer) ? buffer.buffer : buffer;
+        const viewByteOffset = ArrayBuffer.isView(buffer) ? buffer.byteOffset : 0;
+        const resolvedByteOffset = viewByteOffset + byteOffset;
+        const resolvedLength = length ?? Math.floor((buffer.byteLength - byteOffset) / ArrayType.BYTES_PER_ELEMENT);
+        return new ArrayType(arrayBuffer, resolvedByteOffset, resolvedLength);
+    }
+}
+//# sourceMappingURL=gl-type.js.map

package/dist/gl-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gl-type.js","sourceRoot":"","sources":["../src/gl-type.ts"],"names":[],"mappings":"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"}