@loaders.gl/core 5.0.0-alpha.12 → 5.0.0-alpha.13

package/dist/schema-utils/lib/mesh/convert-mesh-to-table.js

@@ -0,0 +1,187 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { getFloat16Storage, isNativeFloat16Array } from '@loaders.gl/core/schema';
+import { indexedMeshArrowSchema, meshArrowSchema } from '@loaders.gl/core/schema';
+import * as arrow from 'apache-arrow';
+import { getFixedSizeListVector } from "../arrow-utils/arrow-fixed-size-list-utils.js";
+import { deserializeArrowField, deserializeArrowMetadata, serializeArrowSchema } from "../schema/convert-arrow-schema.js";
+const MESH_ARROW_ATTRIBUTE_ORDER = ['POSITION'];
+/**
+ * Convert a mesh to a specific table shape.
+ * @param mesh Mesh to convert.
+ * @param shape Target table shape.
+ * @returns Mesh data in the requested table shape.
+ */
+export function convertMeshToTable(mesh, shape) {
+    switch (shape) {
+        case 'columnar-table':
+            return convertMeshToColumnarTable(mesh);
+        case 'arrow-table':
+            return convertMeshToArrowTable(mesh);
+        default:
+            throw new Error(shape);
+    }
+}
+/**
+ * Convert a loaders.gl Mesh to a columnar table.
+ * @param mesh Mesh to convert.
+ * @returns Mesh data as a columnar table.
+ */
+export function convertMeshToColumnarTable(mesh) {
+    const columns = {};
+    const hasIndices = hasMeshIndices(mesh);
+    for (const [columnName, attribute] of Object.entries(mesh.attributes)) {
+        columns[columnName] = attribute.value;
+    }
+    return {
+        shape: 'columnar-table',
+        schema: mesh.schema,
+        data: columns,
+        topology: mesh.topology,
+        indices: hasIndices ? mesh.indices : undefined
+    };
+}
+/**
+ * Convert a loaders.gl Mesh to an Apache Arrow table.
+ * @param mesh Mesh to convert.
+ * @param batchSize Reserved for future chunked Arrow conversion.
+ * @returns Mesh data as an Apache Arrow table wrapper.
+ */
+export function convertMeshToArrowTable(mesh, batchSize) {
+    return makeMeshArrowTable(mesh.attributes, {
+        schema: mesh.schema,
+        topology: mesh.topology,
+        mode: mesh.mode,
+        boundingBox: mesh.header?.boundingBox,
+        indices: hasMeshIndices(mesh) ? mesh.indices : undefined
+    });
+}
+/**
+ * Create a MeshArrowTable directly from mesh attribute typed arrays.
+ * @param attributes Mesh attributes to expose as Arrow columns.
+ * @param options Mesh table metadata and optional schema.
+ * @returns Mesh data as an Apache Arrow table wrapper.
+ */
+export function makeMeshArrowTable(attributes, options = {}) {
+    const fields = [];
+    const columns = {};
+    const attributeNames = getOrderedAttributeNames(attributes);
+    for (const attributeName of attributeNames) {
+        const attribute = attributes[attributeName];
+        const { value, size = 1 } = attribute;
+        const column = getAttributeArrowVector(value, size, attribute.componentType);
+        columns[attributeName] = column;
+        fields.push(getAttributeArrowField(options.schema, attributeName, column, attribute.componentType));
+        if (attributeName === 'POSITION' && options.indices?.value?.length) {
+            const indicesField = indexedMeshArrowSchema.fields.find(field => field.name === 'indices');
+            columns.indices = getIndicesVector(options.indices.value, column.length, indicesField.type);
+            fields.push(indicesField);
+        }
+    }
+    const arrowSchema = new arrow.Schema(fields, getMeshArrowMetadata(options));
+    // Arrow's column-object constructor synthesizes an incompatible batch schema for empty
+    // fixed-size-list vectors. A schema-only table preserves the declared mesh fields instead.
+    const table = columns[attributeNames[0]]?.length === 0
+        ? new arrow.Table(arrowSchema)
+        : new arrow.Table(arrowSchema, columns);
+    const schema = serializeArrowSchema(table.schema);
+    return {
+        shape: 'arrow-table',
+        schema,
+        data: table,
+        topology: options.topology || 'point-list',
+        indices: options.indices
+    };
+}
+/** Return an Arrow vector for a mesh attribute. */
+function getAttributeArrowVector(value, size, componentType) {
+    if (componentType === 'float16') {
+        const storage = isNativeFloat16Array(value) ? getFloat16Storage(value) : value;
+        if (size === 1) {
+            const data = new arrow.Data(new arrow.Float16(), 0, storage.length, 0, {
+                [arrow.BufferType.DATA]: storage
+            });
+            return new arrow.Vector([data]);
+        }
+        return getFixedSizeListVector(value, size, componentType);
+    }
+    return size === 1 ? arrow.makeVector(value) : getFixedSizeListVector(value, size);
+}
+/** Return mesh attribute names with predefined Mesh Arrow fields first. */
+function getOrderedAttributeNames(attributes) {
+    const attributeNames = Object.keys(attributes);
+    const orderedAttributeNames = MESH_ARROW_ATTRIBUTE_ORDER.filter(attributeName => attributeName in attributes);
+    const remainingAttributeNames = attributeNames.filter(attributeName => !MESH_ARROW_ATTRIBUTE_ORDER.includes(attributeName));
+    return [...orderedAttributeNames, ...remainingAttributeNames];
+}
+/** Return true when a mesh has a non-empty top-level index accessor. */
+function hasMeshIndices(mesh) {
+    return Boolean(mesh.indices?.value?.length);
+}
+/** Return the Arrow field for a mesh attribute column. */
+function getAttributeArrowField(schema, attributeName, column, componentType) {
+    if (attributeName === 'POSITION' && isMeshPositionColumn(column)) {
+        const canonicalField = meshArrowSchema.fields[0];
+        const suppliedField = schema?.fields.find(schemaField => schemaField.name === attributeName);
+        if (!suppliedField?.metadata) {
+            return canonicalField;
+        }
+        const metadata = new Map(canonicalField.metadata);
+        for (const [key, value] of Object.entries(suppliedField.metadata)) {
+            metadata.set(key, value);
+        }
+        return new arrow.Field(canonicalField.name, canonicalField.type, canonicalField.nullable, metadata);
+    }
+    const field = schema?.fields.find(schemaField => schemaField.name === attributeName);
+    if (componentType === 'float16') {
+        const metadata = new Map(Object.entries(field?.metadata || {}));
+        metadata.set('componentType', 'float16');
+        return new arrow.Field(attributeName, column.type, false, metadata);
+    }
+    if (field && field.type.toString() !== column.type.toString()) {
+        const deserializedField = deserializeArrowField(field);
+        return new arrow.Field(attributeName, column.type, deserializedField.nullable, deserializedField.metadata);
+    }
+    return field ? deserializeArrowField(field) : new arrow.Field(attributeName, column.type, false);
+}
+/** Return true when an Arrow column matches the predefined Mesh POSITION field. */
+function isMeshPositionColumn(column) {
+    return (column.type instanceof arrow.FixedSizeList &&
+        column.type.listSize === 3 &&
+        column.type.children[0].type instanceof arrow.Float32);
+}
+/** Return an IndexedMesh indices column with the full index list stored in row 0. */
+function getIndicesVector(indices, vertexCount, type) {
+    const indicesType = type;
+    const values = indices instanceof Uint32Array ? indices : Uint32Array.from(indices);
+    const valueOffsets = new Int32Array(vertexCount + 1);
+    if (vertexCount > 0) {
+        valueOffsets.fill(values.length, 1);
+    }
+    const nullBitmap = new Uint8Array(Math.ceil(vertexCount / 8));
+    if (vertexCount > 0) {
+        nullBitmap[0] = 1;
+    }
+    const valuesData = new arrow.Data(indicesType.children[0].type, 0, values.length, 0, { [arrow.BufferType.DATA]: values });
+    const indicesData = new arrow.Data(indicesType, 0, vertexCount, Math.max(0, vertexCount - 1), {
+        [arrow.BufferType.OFFSET]: valueOffsets,
+        [arrow.BufferType.VALIDITY]: nullBitmap
+    }, [valuesData]);
+    return new arrow.Vector([indicesData]);
+}
+/** Return Arrow schema metadata for mesh-level properties. */
+function getMeshArrowMetadata(options) {
+    const metadata = { ...options.schema?.metadata };
+    if (options.topology) {
+        metadata.topology ||= options.topology;
+    }
+    if (Number.isFinite(options.mode)) {
+        metadata.mode ||= String(options.mode);
+    }
+    if (options.boundingBox) {
+        metadata.boundingBox ||= JSON.stringify(options.boundingBox);
+    }
+    return deserializeArrowMetadata(metadata);
+}
+//# sourceMappingURL=convert-mesh-to-table.js.map

package/dist/schema-utils/lib/mesh/convert-mesh-to-table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-mesh-to-table.js","sourceRoot":"","sources":["../../../../src/schema-utils/lib/mesh/convert-mesh-to-table.ts"],"names":[],"mappings":"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"}

package/dist/schema-utils/lib/mesh/convert-table-to-mesh.d.ts

@@ -0,0 +1,14 @@
+import type { Mesh, ColumnarTable, ArrowTable } from '@loaders.gl/core/schema';
+/**
+ * Convert a table to a mesh.
+ * @param table Table to convert.
+ * @returns Mesh reconstructed from the table.
+ */
+export declare function convertTableToMesh(table: ColumnarTable | ArrowTable): Mesh;
+/**
+ * Convert an Apache Arrow mesh table to a loaders.gl Mesh.
+ * @param table Arrow table wrapper to convert.
+ * @returns Mesh reconstructed from the Arrow table.
+ */
+export declare function convertArrowTableToMesh(table: ArrowTable): Mesh;
+//# sourceMappingURL=convert-table-to-mesh.d.ts.map

package/dist/schema-utils/lib/mesh/convert-table-to-mesh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-table-to-mesh.d.ts","sourceRoot":"","sources":["../../../../src/schema-utils/lib/mesh/convert-table-to-mesh.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,IAAI,EAAiB,aAAa,EAAE,UAAU,EAAS,MAAM,yBAAyB,CAAC;AAMpG;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,GAAG,IAAI,CAS1E;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAsD/D"}

package/dist/schema-utils/lib/mesh/convert-table-to-mesh.js

@@ -0,0 +1,217 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { createFloat16Array, getFloat16Value, setFloat16Value } from '@loaders.gl/core/schema';
+import * as arrow from 'apache-arrow';
+import { getFixedSizeListSize } from "../arrow-utils/arrow-fixed-size-list-utils.js";
+import { serializeArrowSchema } from "../schema/convert-arrow-schema.js";
+import { getMeshBoundingBox } from "./mesh-utils.js";
+/**
+ * Convert a table to a mesh.
+ * @param table Table to convert.
+ * @returns Mesh reconstructed from the table.
+ */
+export function convertTableToMesh(table) {
+    switch (table.shape) {
+        // case 'columnar-table':
+        //   return convertColumnarTableToMesh(table);
+        case 'arrow-table':
+            return convertArrowTableToMesh(table);
+        default:
+            throw new Error(table.shape);
+    }
+}
+/**
+ * Convert an Apache Arrow mesh table to a loaders.gl Mesh.
+ * @param table Arrow table wrapper to convert.
+ * @returns Mesh reconstructed from the Arrow table.
+ */
+export function convertArrowTableToMesh(table) {
+    const arrowTable = table.data;
+    const schema = serializeArrowSchema(arrowTable.schema);
+    const fields = schema.fields;
+    const attributes = {};
+    const columns = [];
+    for (const field of fields) {
+        const { name } = field;
+        if (name === 'indices') {
+            continue;
+        }
+        const attributeData = arrowTable.getChild(name);
+        const size = getFixedSizeListSize(attributeData);
+        const typedArray = getAttributeTypedArray(attributeData, size);
+        const metadata = getMeshAttributeMetadata(field.metadata);
+        const value = metadata.componentType === 'float16' ? restoreFloat16Array(typedArray) : typedArray;
+        // Preserve exact physical-storage aliases across column copies without merging equal values.
+        const shared = columns.find(column => column.data.length === attributeData.data.length &&
+            attributes[column.name].value.constructor === value.constructor &&
+            column.data.every((chunk, index) => shareArrowStorage(chunk, attributeData.data[index])));
+        attributes[name] = {
+            value: shared ? attributes[shared.name].value : value,
+            size,
+            ...metadata
+        };
+        if (!shared)
+            columns.push({ name, data: attributeData.data });
+    }
+    fixMetadata(schema);
+    const topology = schema.metadata.topology;
+    const mode = getMeshMode(schema);
+    const indices = getIndices(arrowTable);
+    const boundingBox = attributes.POSITION?.transform?.type === 'quantization'
+        ? getMeshBoundingBoxFromSchema(schema) || getMeshBoundingBox(attributes)
+        : getMeshBoundingBox(attributes);
+    return {
+        schema,
+        attributes,
+        topology,
+        mode,
+        indices,
+        header: {
+            vertexCount: arrowTable.numRows,
+            boundingBox: boundingBox ?? undefined
+        }
+    };
+}
+/** Restores a serialized logical bounding box when one is available. */
+function getMeshBoundingBoxFromSchema(schema) {
+    const serializedBoundingBox = schema.metadata?.boundingBox;
+    if (!serializedBoundingBox) {
+        return null;
+    }
+    try {
+        const boundingBox = JSON.parse(serializedBoundingBox);
+        if (Array.isArray(boundingBox) &&
+            boundingBox.length === 2 &&
+            boundingBox.every((corner) => Array.isArray(corner) &&
+                corner.length === 3 &&
+                corner.every(value => typeof value === 'number'))) {
+            return boundingBox;
+        }
+    }
+    catch {
+        // Ignore malformed optional metadata and recompute from decoded values.
+    }
+    return null;
+}
+/** Restores Mesh attribute properties serialized into Arrow field metadata. */
+function getMeshAttributeMetadata(metadata = {}) {
+    const result = {};
+    if (metadata.byteOffset !== undefined) {
+        result.byteOffset = Number(metadata.byteOffset);
+    }
+    if (metadata.byteStride !== undefined) {
+        result.byteStride = Number(metadata.byteStride);
+    }
+    if (metadata.normalized !== undefined) {
+        result.normalized = metadata.normalized === 'true';
+    }
+    if (metadata.componentType === 'float16') {
+        result.componentType = 'float16';
+    }
+    if (metadata['loaders.gl.transform']) {
+        try {
+            const transform = JSON.parse(metadata['loaders.gl.transform']);
+            if (isMeshAttributeTransform(transform)) {
+                result.transform = transform;
+            }
+        }
+        catch {
+            // Ignore malformed optional metadata and preserve the decoded values.
+        }
+    }
+    return result;
+}
+/** Validates the compact transform representation stored in Arrow metadata. */
+function isMeshAttributeTransform(value) {
+    if (!value || typeof value !== 'object' || !('type' in value)) {
+        return false;
+    }
+    const transform = value;
+    if (transform.type === 'octahedron') {
+        return (Number.isInteger(transform.bits) &&
+            transform.bits >= 1 &&
+            transform.bits <= 30);
+    }
+    return (transform.type === 'quantization' &&
+        Number.isInteger(transform.bits) &&
+        transform.bits >= 1 &&
+        transform.bits <= 30 &&
+        Array.isArray(transform.origin) &&
+        transform.origin.every((component) => typeof component === 'number') &&
+        typeof transform.range === 'number');
+}
+/** Ensure required mesh metadata defaults are present on a schema. */
+function fixMetadata(schema) {
+    schema.metadata ||= {};
+    schema.metadata.topology ||= 'point-list';
+    schema.metadata.mode ||= '0';
+}
+/** Return a typed attribute array from an Arrow attribute column. */
+function getAttributeTypedArray(attributeData, size) {
+    if (!(attributeData.type instanceof arrow.FixedSizeList)) {
+        return attributeData.toArray();
+    }
+    const values = attributeData.data[0].children[0].values;
+    const TypedArrayConstructor = values.constructor;
+    const typedArray = new TypedArrayConstructor(attributeData.length * size);
+    let targetOffset = 0;
+    for (const data of attributeData.data) {
+        const child = data.children[0];
+        const sourceLength = data.length * size;
+        const sourceOffset = child.offset || data.offset * size;
+        // Arrow chunks can either slice child values eagerly or retain offsets into the source buffer.
+        const sourceStart = sourceOffset + sourceLength <= child.values.length ? sourceOffset : 0;
+        const source = child.values.subarray(sourceStart, sourceStart + sourceLength);
+        typedArray.set(source, targetOffset);
+        targetOffset += sourceLength;
+    }
+    return typedArray;
+}
+/** Restore native Float16 storage when the runtime supports it. */
+function restoreFloat16Array(typedArray) {
+    const result = createFloat16Array(typedArray.length);
+    for (let index = 0; index < typedArray.length; index++) {
+        setFloat16Value(result, index, getFloat16Value(typedArray, index));
+    }
+    return result;
+}
+/** Return the mesh drawing mode stored in Arrow schema metadata. */
+function getMeshMode(schema) {
+    const mode = Number(schema.metadata?.mode);
+    return Number.isFinite(mode) ? mode : 0;
+}
+/** Return top-level mesh indices from the predefined IndexedMesh Arrow column. */
+function getIndices(arrowTable) {
+    const indicesColumn = arrowTable.getChild('indices');
+    if (!indicesColumn?.isValid(0)) {
+        return undefined;
+    }
+    const indicesData = indicesColumn.data[0];
+    const valueOffsets = indicesData.valueOffsets;
+    const start = valueOffsets[indicesData.offset];
+    const end = valueOffsets[indicesData.offset + 1];
+    const values = indicesData.children[0].values.subarray(start, end);
+    return { value: values, size: 1 };
+}
+/** Checks complete Arrow chunk regions, including child buffers and validity/offset metadata. */
+function shareArrowStorage(left, right) {
+    const rightBuffers = Object.values(right.buffers);
+    return (left.type.toString() === right.type.toString() &&
+        left.offset === right.offset &&
+        left.length === right.length &&
+        left.nullCount === right.nullCount &&
+        left.dictionary === right.dictionary &&
+        Object.values(left.buffers).every((buffer, index) => {
+            const other = rightBuffers[index];
+            return (buffer === other ||
+                Boolean(buffer &&
+                    other &&
+                    buffer.buffer === other.buffer &&
+                    buffer.byteOffset === other.byteOffset &&
+                    buffer.byteLength === other.byteLength));
+        }) &&
+        left.children.length === right.children.length &&
+        left.children.every((child, index) => shareArrowStorage(child, right.children[index])));
+}
+//# sourceMappingURL=convert-table-to-mesh.js.map

package/dist/schema-utils/lib/mesh/convert-table-to-mesh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-table-to-mesh.js","sourceRoot":"","sources":["../../../../src/schema-utils/lib/mesh/convert-table-to-mesh.ts"],"names":[],"mappings":"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"}

package/dist/schema-utils/lib/mesh/deduce-mesh-schema.d.ts

@@ -0,0 +1,23 @@
+import { MeshAttribute, MeshAttributes, Schema, Field } from '@loaders.gl/core/schema';
+/**
+ * Create a schema for mesh attributes data
+ * @param attributes
+ * @param metadata
+ * @returns
+ */
+export declare function deduceMeshSchema(attributes: MeshAttributes, metadata?: Record<string, string>): Schema;
+/**
+ * Create arrow-like schema field for mesh attribute
+ * @param attributeName
+ * @param attribute
+ * @param optionalMetadata
+ * @returns
+ */
+export declare function deduceMeshField(name: string, attribute: MeshAttribute, optionalMetadata?: Record<string, string>): Field;
+/**
+ * Make metadata by mesh attribute properties
+ * @param attribute
+ * @returns
+ */
+export declare function makeMeshAttributeMetadata(attribute: MeshAttribute): Record<string, string>;
+//# sourceMappingURL=deduce-mesh-schema.d.ts.map

package/dist/schema-utils/lib/mesh/deduce-mesh-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deduce-mesh-schema.d.ts","sourceRoot":"","sources":["../../../../src/schema-utils/lib/mesh/deduce-mesh-schema.ts"],"names":[],"mappings":"AAIA,OAAO,EAAW,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,EAAC,MAAM,yBAAyB,CAAC;AAG/F;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,cAAc,EAC1B,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACpC,MAAM,CAGR;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,aAAa,EACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACxC,KAAK,CAaP;AAgBD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkB1F"}

package/dist/schema-utils/lib/mesh/deduce-mesh-schema.js

@@ -0,0 +1,72 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { getDataTypeFromTypedArray } from "../schema/data-type.js";
+/**
+ * Create a schema for mesh attributes data
+ * @param attributes
+ * @param metadata
+ * @returns
+ */
+export function deduceMeshSchema(attributes, metadata = {}) {
+    const fields = deduceMeshFields(attributes);
+    return { fields, metadata };
+}
+/**
+ * Create arrow-like schema field for mesh attribute
+ * @param attributeName
+ * @param attribute
+ * @param optionalMetadata
+ * @returns
+ */
+export function deduceMeshField(name, attribute, optionalMetadata) {
+    const type = attribute.componentType || getDataTypeFromTypedArray(attribute.value);
+    const metadata = optionalMetadata ? optionalMetadata : makeMeshAttributeMetadata(attribute);
+    const dataType = attribute.size === 1
+        ? type
+        : { type: 'fixed-size-list', listSize: attribute.size, children: [{ name: 'value', type }] };
+    return {
+        name,
+        type: dataType,
+        nullable: false,
+        metadata
+    };
+}
+/**
+ * Create fields array for mesh attributes
+ * @param attributes
+ * @returns
+ */
+function deduceMeshFields(attributes) {
+    const fields = [];
+    for (const attributeName in attributes) {
+        const attribute = attributes[attributeName];
+        fields.push(deduceMeshField(attributeName, attribute));
+    }
+    return fields;
+}
+/**
+ * Make metadata by mesh attribute properties
+ * @param attribute
+ * @returns
+ */
+export function makeMeshAttributeMetadata(attribute) {
+    const result = {};
+    if ('byteOffset' in attribute) {
+        result.byteOffset = attribute.byteOffset.toString(10);
+    }
+    if ('byteStride' in attribute) {
+        result.byteStride = attribute.byteStride.toString(10);
+    }
+    if ('normalized' in attribute) {
+        result.normalized = attribute.normalized.toString();
+    }
+    if (attribute.componentType) {
+        result.componentType = attribute.componentType;
+    }
+    if (attribute.transform) {
+        result['loaders.gl.transform'] = JSON.stringify(attribute.transform);
+    }
+    return result;
+}
+//# sourceMappingURL=deduce-mesh-schema.js.map

package/dist/schema-utils/lib/mesh/deduce-mesh-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deduce-mesh-schema.js","sourceRoot":"","sources":["../../../../src/schema-utils/lib/mesh/deduce-mesh-schema.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAGpC,OAAO,EAAC,yBAAyB,EAAC,+BAA4B;AAE9D;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,UAA0B,EAC1B,WAAmC,EAAE;IAErC,MAAM,MAAM,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC5C,OAAO,EAAC,MAAM,EAAE,QAAQ,EAAC,CAAC;AAC5B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,SAAwB,EACxB,gBAAyC;IAEzC,MAAM,IAAI,GAAG,SAAS,CAAC,aAAa,IAAI,yBAAyB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACnF,MAAM,QAAQ,GAAG,gBAAgB,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,yBAAyB,CAAC,SAAS,CAAC,CAAC;IAC5F,MAAM,QAAQ,GACZ,SAAS,CAAC,IAAI,KAAK,CAAC;QAClB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,EAAC,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAC,CAAC,EAAC,CAAC;IAC7F,OAAO;QACL,IAAI;QACJ,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,KAAK;QACf,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,gBAAgB,CAAC,UAA0B;IAClD,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,KAAK,MAAM,aAAa,IAAI,UAAU,EAAE,CAAC;QACvC,MAAM,SAAS,GAAkB,UAAU,CAAC,aAAa,CAAC,CAAC;QAC3D,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,SAAwB;IAChE,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,IAAI,YAAY,IAAI,SAAS,EAAE,CAAC;QAC9B,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC,UAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,YAAY,IAAI,SAAS,EAAE,CAAC;QAC9B,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC,UAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,YAAY,IAAI,SAAS,EAAE,CAAC;QAC9B,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC,UAAW,CAAC,QAAQ,EAAE,CAAC;IACvD,CAAC;IACD,IAAI,SAAS,CAAC,aAAa,EAAE,CAAC;QAC5B,MAAM,CAAC,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC;IACjD,CAAC;IACD,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;QACxB,MAAM,CAAC,sBAAsB,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/schema-utils/lib/mesh/mesh-utils.d.ts

@@ -0,0 +1,23 @@
+import { MeshAttributes } from '@loaders.gl/core/schema';
+import { TypedArray } from "../../types/types.js";
+type TypedArrays = {
+    [key: string]: TypedArray;
+};
+/**
+ * Holds an axis aligned bounding box
+ * TODO - make sure AxisAlignedBoundingBox in math.gl/culling understands this format (or change this format)
+ */
+type BoundingBox = [[number, number, number], [number, number, number]];
+/**
+ * Get number of vertices in mesh
+ * @param attributes
+ */
+export declare function getMeshSize(attributes: TypedArrays): number;
+/**
+ * Get the (axis aligned) bounding box of a mesh
+ * @param attributes
+ * @returns array of two vectors representing the axis aligned bounding box
+ */
+export declare function getMeshBoundingBox(attributes: MeshAttributes | null): BoundingBox | null;
+export {};
+//# sourceMappingURL=mesh-utils.d.ts.map

package/dist/schema-utils/lib/mesh/mesh-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-utils.d.ts","sourceRoot":"","sources":["../../../../src/schema-utils/lib/mesh/mesh-utils.ts"],"names":[],"mappings":"AAMA,OAAO,EAAC,cAAc,EAAC,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAC,UAAU,EAAC,6BAA0B;AAE7C,KAAK,WAAW,GAAG;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAA;CAAC,CAAC;AAE/C;;;GAGG;AACH,KAAK,WAAW,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAExE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,WAAW,GAAG,MAAM,CAU3D;AAED;;;;GAIG;AAEH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,GAAG,WAAW,GAAG,IAAI,CAiCxF"}

package/dist/schema-utils/lib/mesh/mesh-utils.js

@@ -0,0 +1,54 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/**
+ * Get number of vertices in mesh
+ * @param attributes
+ */
+export function getMeshSize(attributes) {
+    let size = 0;
+    for (const attributeName in attributes) {
+        const attribute = attributes[attributeName];
+        if (ArrayBuffer.isView(attribute)) {
+            // @ts-ignore DataView doesn't have BYTES_PER_ELEMENT
+            size += attribute.byteLength * attribute.BYTES_PER_ELEMENT;
+        }
+    }
+    return size;
+}
+/**
+ * Get the (axis aligned) bounding box of a mesh
+ * @param attributes
+ * @returns array of two vectors representing the axis aligned bounding box
+ */
+// eslint-disable-next-line complexity
+export function getMeshBoundingBox(attributes) {
+    const positionAttribute = attributes?.POSITION;
+    if (!positionAttribute || !('value' in positionAttribute) || !positionAttribute.value.length) {
+        return null;
+    }
+    let minX = Infinity;
+    let minY = Infinity;
+    let minZ = Infinity;
+    let maxX = -Infinity;
+    let maxY = -Infinity;
+    let maxZ = -Infinity;
+    const positions = positionAttribute.value;
+    const len = positions.length;
+    for (let i = 0; i < len; i += 3) {
+        const x = positions[i];
+        const y = positions[i + 1];
+        const z = positions[i + 2];
+        minX = x < minX ? x : minX;
+        minY = y < minY ? y : minY;
+        minZ = z < minZ ? z : minZ;
+        maxX = x > maxX ? x : maxX;
+        maxY = y > maxY ? y : maxY;
+        maxZ = z > maxZ ? z : maxZ;
+    }
+    return [
+        [minX, minY, minZ],
+        [maxX, maxY, maxZ]
+    ];
+}
+//# sourceMappingURL=mesh-utils.js.map

package/dist/schema-utils/lib/mesh/mesh-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-utils.js","sourceRoot":"","sources":["../../../../src/schema-utils/lib/mesh/mesh-utils.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAepC;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,UAAuB;IACjD,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,MAAM,aAAa,IAAI,UAAU,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;QAC5C,IAAI,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YAClC,qDAAqD;YACrD,IAAI,IAAI,SAAS,CAAC,UAAU,GAAG,SAAS,CAAC,iBAAiB,CAAC;QAC7D,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,sCAAsC;AACtC,MAAM,UAAU,kBAAkB,CAAC,UAAiC;IAClE,MAAM,iBAAiB,GAAG,UAAU,EAAE,QAAQ,CAAC;IAC/C,IAAI,CAAC,iBAAiB,IAAI,CAAC,CAAC,OAAO,IAAI,iBAAiB,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAC7F,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,IAAI,GAAG,QAAQ,CAAC;IACpB,IAAI,IAAI,GAAG,QAAQ,CAAC;IACpB,IAAI,IAAI,GAAG,QAAQ,CAAC;IACpB,IAAI,IAAI,GAAG,CAAC,QAAQ,CAAC;IACrB,IAAI,IAAI,GAAG,CAAC,QAAQ,CAAC;IACrB,IAAI,IAAI,GAAG,CAAC,QAAQ,CAAC;IAErB,MAAM,SAAS,GAAG,iBAAiB,CAAC,KAAK,CAAC;IAC1C,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC;IAE7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QACvB,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3B,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAE3B,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3B,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3B,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAE3B,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3B,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3B,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7B,CAAC;IACD,OAAO;QACL,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAClB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;KACnB,CAAC;AACJ,CAAC"}