@loaders.gl/pointclouds 0.0.0-stage → 5.0.0-beta.2

package/dist/las/lib/copc/parse-las.js

@@ -0,0 +1,215 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { concatenateArrayBuffersAsync } from '@loaders.gl/core/loader-utils';
+import { getMeshBoundingBox } from '@loaders.gl/core/schema-utils';
+import { Las } from 'copc';
+import { getLASSchema } from "../get-las-schema.js";
+const DEFAULT_BATCH_SIZE = 1000 * 100;
+/**
+ * Parse LAS/LAZ data using the laz-perf decoder shipped by the COPC package.
+ * @param arrayBuffer Complete LAS/LAZ file data
+ * @param options LAS loader options
+ * @returns Parsed LAS mesh
+ */
+export async function parseCOPCLAS(arrayBuffer, options = {}) {
+    const header = Las.Header.parse(new Uint8Array(arrayBuffer));
+    const batches = parseCOPCLASBatches(arrayBuffer, options, header.pointCount)[Symbol.asyncIterator]();
+    const firstBatch = await batches.next();
+    if (!firstBatch.value) {
+        throw new Error('LAS file contained no points');
+    }
+    return firstBatch.value;
+}
+/**
+ * Parse LAS/LAZ data in decoded point batches using the COPC package.
+ * @param arrayBufferIterator Iterator yielding LAS/LAZ binary chunks
+ * @param options LAS loader options
+ * @returns Async iterable of mesh batches
+ */
+export async function* parseCOPCLASInBatches(arrayBufferIterator, options = {}) {
+    const arrayBuffer = await concatenateArrayBuffersAsync(arrayBufferIterator);
+    yield* parseCOPCLASBatches(arrayBuffer, options, getBatchSize(options));
+}
+/**
+ * Parse LAS/LAZ data in decoded point batches using the COPC package.
+ * @param arrayBuffer Complete LAS/LAZ file data
+ * @param options LAS loader options
+ * @param batchSize Number of returned points per batch
+ * @returns Async iterable of mesh batches
+ */
+async function* parseCOPCLASBatches(arrayBuffer, options, batchSize) {
+    const header = Las.Header.parse(new Uint8Array(arrayBuffer));
+    const pointData = await getCOPCPointData(arrayBuffer, header);
+    const view = Las.View.create(pointData, header);
+    const totalToRead = view.pointCount;
+    const lasHeader = getLASHeader(arrayBuffer, header, totalToRead);
+    for (let pointIndex = 0; pointIndex < totalToRead; pointIndex += batchSize) {
+        const batchPointCount = Math.min(batchSize, totalToRead - pointIndex);
+        lasHeader.totalRead = pointIndex + batchPointCount;
+        yield getLASMeshBatch(view, lasHeader, options, pointIndex, batchPointCount);
+    }
+}
+/**
+ * Decompress or slice LAS point records for the COPC package parser.
+ * @param arrayBuffer Complete LAS/LAZ file data
+ * @param header COPC package LAS header
+ * @returns Uncompressed point records
+ */
+async function getCOPCPointData(arrayBuffer, header) {
+    if (isCompressedLAS(arrayBuffer)) {
+        return await Las.PointData.decompressFile(new Uint8Array(arrayBuffer));
+    }
+    const byteOffset = header.pointDataOffset;
+    const byteLength = header.pointCount * header.pointDataRecordLength;
+    return new Uint8Array(arrayBuffer, byteOffset, byteLength);
+}
+/**
+ * Convert a COPC package header into loaders.gl LAS header metadata.
+ * @param arrayBuffer Complete LAS/LAZ file data
+ * @param header COPC package LAS header
+ * @param totalToRead Number of output points
+ * @returns loaders.gl LAS header
+ */
+function getLASHeader(arrayBuffer, header, totalToRead) {
+    return {
+        pointsOffset: header.pointDataOffset,
+        pointsFormatId: header.pointDataRecordFormat,
+        pointsStructSize: header.pointDataRecordLength,
+        pointsCount: header.pointCount,
+        scale: header.scale,
+        offset: header.offset,
+        maxs: header.max,
+        mins: header.min,
+        totalToRead,
+        totalRead: 0,
+        hasColor: hasCOPCColor(header.pointDataRecordFormat),
+        versionAsString: `${header.majorVersion}.${header.minorVersion}`,
+        isCompressed: isCompressedLAS(arrayBuffer)
+    };
+}
+/**
+ * Return true when the LAS point format includes compressed LAZ flags.
+ * @param arrayBuffer Complete LAS/LAZ file data
+ * @returns Whether the file uses LAZ compression
+ */
+function isCompressedLAS(arrayBuffer) {
+    const rawPointFormat = new DataView(arrayBuffer).getUint8(104);
+    return Boolean(rawPointFormat & 0xc0);
+}
+/**
+ * Return true when a COPC-supported LAS point format includes RGB color.
+ * @param pointDataRecordFormat LAS point data record format
+ * @returns Whether the point format has color
+ */
+function hasCOPCColor(pointDataRecordFormat) {
+    return pointDataRecordFormat === 2 || pointDataRecordFormat === 3 || pointDataRecordFormat >= 7;
+}
+/**
+ * Build one LAS mesh batch from a COPC package point view.
+ * @param view COPC package point view
+ * @param lasHeader LAS header metadata
+ * @param options LAS loader options
+ * @param pointOffset Output point offset
+ * @param batchPointCount Number of points in this batch
+ * @returns LAS mesh batch
+ */
+function getLASMeshBatch(view, lasHeader, options, pointOffset, batchPointCount) {
+    const PositionsType = options.las?.fp64 ? Float64Array : Float32Array;
+    const positions = new PositionsType(batchPointCount * 3);
+    const colors = lasHeader.hasColor ? new Uint8Array(batchPointCount * 4) : null;
+    const intensities = new Uint16Array(batchPointCount);
+    const classifications = new Uint8Array(batchPointCount);
+    const getX = view.getter('X');
+    const getY = view.getter('Y');
+    const getZ = view.getter('Z');
+    const getIntensity = view.getter('Intensity');
+    const getClassification = view.getter('Classification');
+    const getRed = colors ? view.getter('Red') : null;
+    const getGreen = colors ? view.getter('Green') : null;
+    const getBlue = colors ? view.getter('Blue') : null;
+    const twoByteColor = detectTwoByteColors(view, pointOffset, batchPointCount, options);
+    for (let i = 0; i < batchPointCount; i++) {
+        const sourcePointIndex = pointOffset + i;
+        positions[i * 3] = getX(sourcePointIndex);
+        positions[i * 3 + 1] = getY(sourcePointIndex);
+        positions[i * 3 + 2] = getZ(sourcePointIndex);
+        intensities[i] = getIntensity(sourcePointIndex);
+        classifications[i] = getClassification(sourcePointIndex);
+        if (colors && getRed && getGreen && getBlue) {
+            const red = getRed(sourcePointIndex);
+            const green = getGreen(sourcePointIndex);
+            const blue = getBlue(sourcePointIndex);
+            colors[i * 4] = twoByteColor ? red / 256 : red;
+            colors[i * 4 + 1] = twoByteColor ? green / 256 : green;
+            colors[i * 4 + 2] = twoByteColor ? blue / 256 : blue;
+            colors[i * 4 + 3] = 255;
+        }
+    }
+    const attributes = {
+        POSITION: { value: positions, size: 3 },
+        intensity: { value: intensities, size: 1 },
+        classification: { value: classifications, size: 1 }
+    };
+    if (colors) {
+        attributes.COLOR_0 = { value: colors, size: 4 };
+    }
+    const batchHeader = { ...lasHeader };
+    const lasMesh = {
+        loader: 'las',
+        loaderData: batchHeader,
+        schema: { fields: [], metadata: {} },
+        header: {
+            vertexCount: batchPointCount,
+            boundingBox: getMeshBoundingBox(attributes)
+        },
+        attributes,
+        topology: 'point-list',
+        mode: 0,
+        progress: lasHeader.totalRead / lasHeader.totalToRead
+    };
+    lasMesh.schema = getLASSchema(batchHeader, lasMesh.attributes);
+    return lasMesh;
+}
+/**
+ * Detect whether color values use 16-bit LAS color range.
+ * @param view COPC package point view
+ * @param pointOffset Output point offset
+ * @param batchPointCount Number of points in this batch
+ * @param options LAS loader options
+ * @returns Whether color values should be downscaled from 16-bit to 8-bit
+ */
+function detectTwoByteColors(view, pointOffset, batchPointCount, options) {
+    switch (options.las?.colorDepth) {
+        case 8:
+            return false;
+        case 16:
+            return true;
+        case 'auto': {
+            const getRed = view.getter('Red');
+            const getGreen = view.getter('Green');
+            const getBlue = view.getter('Blue');
+            for (let i = 0; i < batchPointCount; i++) {
+                const sourcePointIndex = pointOffset + i;
+                if (getRed(sourcePointIndex) > 255 ||
+                    getGreen(sourcePointIndex) > 255 ||
+                    getBlue(sourcePointIndex) > 255) {
+                    return true;
+                }
+            }
+            return false;
+        }
+        default:
+            return false;
+    }
+}
+/**
+ * Get the requested LAS point batch size.
+ * @param options LAS loader options
+ * @returns Point count per decoded batch
+ */
+function getBatchSize(options) {
+    const batchSize = options.batchSize ?? options.core?.batchSize;
+    return typeof batchSize === 'number' ? batchSize : DEFAULT_BATCH_SIZE;
+}
+//# sourceMappingURL=parse-las.js.map

package/dist/las/lib/copc/parse-las.js.map

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

package/dist/las/lib/get-las-schema.cjs

@@ -0,0 +1,62 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/las/lib/get-las-schema.ts
+var get_las_schema_exports = {};
+__export(get_las_schema_exports, {
+  getLASSchema: () => getLASSchema,
+  makeMetadataFromLasHeader: () => makeMetadataFromLasHeader
+});
+module.exports = __toCommonJS(get_las_schema_exports);
+var import_schema_utils = require("@loaders.gl/core/schema-utils");
+function getLASSchema(lasHeader, attributes) {
+  const metadataMap = makeMetadataFromLasHeader(lasHeader);
+  const schema = (0, import_schema_utils.deduceMeshSchema)(attributes, metadataMap);
+  return schema;
+}
+function makeMetadataFromLasHeader(lasHeader) {
+  const metadata = {};
+  metadata.las_pointsOffset = lasHeader.pointsOffset.toString(10);
+  metadata.las_pointsFormatId = lasHeader.pointsFormatId.toString(10);
+  metadata.las_pointsStructSize = lasHeader.pointsStructSize.toString(10);
+  metadata.las_pointsCount = lasHeader.pointsCount.toString(10);
+  metadata.las_scale = JSON.stringify(lasHeader.scale);
+  metadata.las_offset = JSON.stringify(lasHeader.offset);
+  if (lasHeader.maxs !== void 0) {
+    metadata.las_maxs = JSON.stringify(lasHeader.maxs);
+  }
+  if (lasHeader.mins !== void 0) {
+    metadata.las_mins = JSON.stringify(lasHeader.mins);
+  }
+  metadata.las_totalToRead = lasHeader.totalToRead.toString(10);
+  metadata.las_pointsFortotalReadmatId = lasHeader.totalRead.toString(10);
+  if (lasHeader.versionAsString !== void 0) {
+    metadata.las_versionAsString = lasHeader.versionAsString;
+  }
+  if (lasHeader.isCompressed !== void 0) {
+    metadata.las_isCompressed = lasHeader.isCompressed.toString();
+  }
+  return metadata;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getLASSchema,
+  makeMetadataFromLasHeader
+});
+//# sourceMappingURL=get-las-schema.cjs.map

package/dist/las/lib/get-las-schema.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/las/lib/get-las-schema.ts"],
+  "sourcesContent": ["// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nimport {Schema, MeshAttributes} from '@loaders.gl/core/schema';\nimport {deduceMeshSchema} from '@loaders.gl/core/schema-utils';\nimport type {LASHeader} from './las-types';\n\n/**\n * Gets schema from LAS header\n * @param lasHeader\n * @param metadata\n * @returns Schema\n */\nexport function getLASSchema(lasHeader: LASHeader, attributes: MeshAttributes): Schema {\n  const metadataMap = makeMetadataFromLasHeader(lasHeader);\n  const schema = deduceMeshSchema(attributes, metadataMap);\n  return schema;\n}\n\n/**\n * Make arrow like schema metadata by LASHeader properties\n * @param lasHeader\n * @returns\n */\nexport function makeMetadataFromLasHeader(lasHeader: LASHeader): Record<string, string> {\n  const metadata: Record<string, string> = {};\n  /* eslint-disable camelcase */\n  metadata.las_pointsOffset = lasHeader.pointsOffset.toString(10);\n  metadata.las_pointsFormatId = lasHeader.pointsFormatId.toString(10);\n  metadata.las_pointsStructSize = lasHeader.pointsStructSize.toString(10);\n  metadata.las_pointsCount = lasHeader.pointsCount.toString(10);\n  metadata.las_scale = JSON.stringify(lasHeader.scale);\n  metadata.las_offset = JSON.stringify(lasHeader.offset);\n  if (lasHeader.maxs !== undefined) {\n    metadata.las_maxs = JSON.stringify(lasHeader.maxs);\n  }\n  if (lasHeader.mins !== undefined) {\n    metadata.las_mins = JSON.stringify(lasHeader.mins);\n  }\n  metadata.las_totalToRead = lasHeader.totalToRead.toString(10);\n  metadata.las_pointsFortotalReadmatId = lasHeader.totalRead.toString(10);\n  if (lasHeader.versionAsString !== undefined) {\n    metadata.las_versionAsString = lasHeader.versionAsString;\n  }\n  if (lasHeader.isCompressed !== undefined) {\n    metadata.las_isCompressed = lasHeader.isCompressed.toString();\n  }\n  return metadata;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,0BAA+B;AASxB,SAAS,aAAa,WAAsB,YAAoC;AACrF,QAAM,cAAc,0BAA0B,SAAS;AACvD,QAAM,aAAS,sCAAiB,YAAY,WAAW;AACvD,SAAO;AACT;AAOO,SAAS,0BAA0B,WAA8C;AACtF,QAAM,WAAmC,CAAC;AAE1C,WAAS,mBAAmB,UAAU,aAAa,SAAS,EAAE;AAC9D,WAAS,qBAAqB,UAAU,eAAe,SAAS,EAAE;AAClE,WAAS,uBAAuB,UAAU,iBAAiB,SAAS,EAAE;AACtE,WAAS,kBAAkB,UAAU,YAAY,SAAS,EAAE;AAC5D,WAAS,YAAY,KAAK,UAAU,UAAU,KAAK;AACnD,WAAS,aAAa,KAAK,UAAU,UAAU,MAAM;AACrD,MAAI,UAAU,SAAS,QAAW;AAChC,aAAS,WAAW,KAAK,UAAU,UAAU,IAAI;AAAA,EACnD;AACA,MAAI,UAAU,SAAS,QAAW;AAChC,aAAS,WAAW,KAAK,UAAU,UAAU,IAAI;AAAA,EACnD;AACA,WAAS,kBAAkB,UAAU,YAAY,SAAS,EAAE;AAC5D,WAAS,8BAA8B,UAAU,UAAU,SAAS,EAAE;AACtE,MAAI,UAAU,oBAAoB,QAAW;AAC3C,aAAS,sBAAsB,UAAU;AAAA,EAC3C;AACA,MAAI,UAAU,iBAAiB,QAAW;AACxC,aAAS,mBAAmB,UAAU,aAAa,SAAS;AAAA,EAC9D;AACA,SAAO;AACT;",
+  "names": []
+}

package/dist/las/lib/get-las-schema.d.ts

@@ -0,0 +1,16 @@
+import { Schema, MeshAttributes } from '@loaders.gl/core/schema';
+import type { LASHeader } from "./las-types.js";
+/**
+ * Gets schema from LAS header
+ * @param lasHeader
+ * @param metadata
+ * @returns Schema
+ */
+export declare function getLASSchema(lasHeader: LASHeader, attributes: MeshAttributes): Schema;
+/**
+ * Make arrow like schema metadata by LASHeader properties
+ * @param lasHeader
+ * @returns
+ */
+export declare function makeMetadataFromLasHeader(lasHeader: LASHeader): Record<string, string>;
+//# sourceMappingURL=get-las-schema.d.ts.map

package/dist/las/lib/get-las-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-las-schema.d.ts","sourceRoot":"","sources":["../../../src/las/lib/get-las-schema.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,MAAM,EAAE,cAAc,EAAC,MAAM,yBAAyB,CAAC;AAE/D,OAAO,KAAK,EAAC,SAAS,EAAC,uBAAoB;AAE3C;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,GAAG,MAAM,CAIrF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwBtF"}

package/dist/las/lib/get-las-schema.js

@@ -0,0 +1,46 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { deduceMeshSchema } from '@loaders.gl/core/schema-utils';
+/**
+ * Gets schema from LAS header
+ * @param lasHeader
+ * @param metadata
+ * @returns Schema
+ */
+export function getLASSchema(lasHeader, attributes) {
+    const metadataMap = makeMetadataFromLasHeader(lasHeader);
+    const schema = deduceMeshSchema(attributes, metadataMap);
+    return schema;
+}
+/**
+ * Make arrow like schema metadata by LASHeader properties
+ * @param lasHeader
+ * @returns
+ */
+export function makeMetadataFromLasHeader(lasHeader) {
+    const metadata = {};
+    /* eslint-disable camelcase */
+    metadata.las_pointsOffset = lasHeader.pointsOffset.toString(10);
+    metadata.las_pointsFormatId = lasHeader.pointsFormatId.toString(10);
+    metadata.las_pointsStructSize = lasHeader.pointsStructSize.toString(10);
+    metadata.las_pointsCount = lasHeader.pointsCount.toString(10);
+    metadata.las_scale = JSON.stringify(lasHeader.scale);
+    metadata.las_offset = JSON.stringify(lasHeader.offset);
+    if (lasHeader.maxs !== undefined) {
+        metadata.las_maxs = JSON.stringify(lasHeader.maxs);
+    }
+    if (lasHeader.mins !== undefined) {
+        metadata.las_mins = JSON.stringify(lasHeader.mins);
+    }
+    metadata.las_totalToRead = lasHeader.totalToRead.toString(10);
+    metadata.las_pointsFortotalReadmatId = lasHeader.totalRead.toString(10);
+    if (lasHeader.versionAsString !== undefined) {
+        metadata.las_versionAsString = lasHeader.versionAsString;
+    }
+    if (lasHeader.isCompressed !== undefined) {
+        metadata.las_isCompressed = lasHeader.isCompressed.toString();
+    }
+    return metadata;
+}
+//# sourceMappingURL=get-las-schema.js.map

package/dist/las/lib/get-las-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-las-schema.js","sourceRoot":"","sources":["../../../src/las/lib/get-las-schema.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAGpC,OAAO,EAAC,gBAAgB,EAAC,MAAM,+BAA+B,CAAC;AAG/D;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,SAAoB,EAAE,UAA0B;IAC3E,MAAM,WAAW,GAAG,yBAAyB,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,gBAAgB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IACzD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,SAAoB;IAC5D,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,8BAA8B;IAC9B,QAAQ,CAAC,gBAAgB,GAAG,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAChE,QAAQ,CAAC,kBAAkB,GAAG,SAAS,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACpE,QAAQ,CAAC,oBAAoB,GAAG,SAAS,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACxE,QAAQ,CAAC,eAAe,GAAG,SAAS,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC9D,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACrD,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACvD,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACjC,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACjC,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;IACD,QAAQ,CAAC,eAAe,GAAG,SAAS,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC9D,QAAQ,CAAC,2BAA2B,GAAG,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACxE,IAAI,SAAS,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QAC5C,QAAQ,CAAC,mBAAmB,GAAG,SAAS,CAAC,eAAe,CAAC;IAC3D,CAAC;IACD,IAAI,SAAS,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACzC,QAAQ,CAAC,gBAAgB,GAAG,SAAS,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;IAChE,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/las/lib/las-compatibility.cjs

@@ -0,0 +1,110 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/las/lib/las-compatibility.ts
+var las_compatibility_exports = {};
+__export(las_compatibility_exports, {
+  getLASCompatibilityLayout: () => getLASCompatibilityLayout,
+  populateLASCompatibilityPoint: () => populateLASCompatibilityPoint
+});
+module.exports = __toCommonJS(las_compatibility_exports);
+function getLASCompatibilityLayout(header, metadata) {
+  const record = metadata.vlrs.find(
+    (variableLengthRecord) => variableLengthRecord.userId === "lascompatible" && variableLengthRecord.recordId === 22204
+  );
+  if (!record) return void 0;
+  if (!["1.0", "1.1", "1.2", "1.3"].includes(header.versionAsString || "") || ![1, 3, 4, 5].includes(header.pointsFormatId)) {
+    throw new Error("LASLoader: compatibility mode requires a legacy LAS point format");
+  }
+  const view = new DataView(record.data.buffer, record.data.byteOffset, record.data.byteLength);
+  if (view.byteLength < 4) throw new Error("LASLoader: truncated LASzip compatibility VLR");
+  const version = view.getUint16(2, true);
+  if (version !== 3 && version !== 4 || view.byteLength !== (version === 3 ? 156 : 174)) {
+    throw new Error(`LASLoader: unsupported LASzip compatibility VLR version ${version} or length`);
+  }
+  const offsets = /* @__PURE__ */ new Map();
+  let byteOffset = 0;
+  for (const descriptor of metadata.extraBytes) {
+    const scalarDataType = descriptor.dataType > 20 ? descriptor.dataType - 20 : descriptor.dataType > 10 ? descriptor.dataType - 10 : descriptor.dataType;
+    const size = descriptor.dataType > 20 ? 3 : descriptor.dataType > 10 ? 2 : 1;
+    const byteLength = descriptor.dataType === 0 ? descriptor.options : scalarDataType <= 2 ? size : scalarDataType <= 4 ? 2 * size : scalarDataType <= 6 || scalarDataType === 9 ? 4 * size : 8 * size;
+    if (descriptor.dataType > 30 || !byteLength)
+      throw new Error("LASLoader: invalid compatibility Extra Bytes layout");
+    offsets.set(descriptor.name, { byteOffset, dataType: descriptor.dataType });
+    byteOffset += byteLength;
+  }
+  const baseLength = { 1: 28, 3: 34, 4: 57, 5: 63 }[header.pointsFormatId];
+  if (byteOffset !== header.pointsStructSize - baseLength)
+    throw new Error("LASLoader: compatibility descriptors do not match point record length");
+  const scanAngleByteOffset = getCompatibilityFieldOffset(offsets, "LAS 1.4 scan angle", 4);
+  const returnsByteOffset = getCompatibilityFieldOffset(offsets, "LAS 1.4 extended returns", 1);
+  const classificationByteOffset = getCompatibilityFieldOffset(
+    offsets,
+    "LAS 1.4 classification",
+    1
+  );
+  const flagsByteOffset = getCompatibilityFieldOffset(offsets, "LAS 1.4 flags and channel", 1);
+  const nirByteOffset = offsets.has("LAS 1.4 NIR band") ? getCompatibilityFieldOffset(offsets, "LAS 1.4 NIR band", 3) : void 0;
+  const pointDataRecordFormat = header.pointsFormatId === 1 ? 6 : header.pointsFormatId === 3 ? nirByteOffset === void 0 ? 7 : 8 : header.pointsFormatId === 4 ? 9 : 10;
+  if (header.pointsFormatId === 5 && nirByteOffset === void 0)
+    throw new Error("LASLoader: compatibility waveform color points require NIR");
+  return {
+    pointDataRecordFormat,
+    version: version === 3 ? "1.4" : "1.5",
+    scanAngleByteOffset,
+    returnsByteOffset,
+    classificationByteOffset,
+    flagsByteOffset,
+    nirByteOffset
+  };
+}
+function getCompatibilityFieldOffset(offsets, name, dataType) {
+  const field = offsets.get(name);
+  if (!field || field.dataType !== dataType)
+    throw new Error(`LASLoader: missing or invalid compatibility field ${name}`);
+  return field.byteOffset;
+}
+function populateLASCompatibilityPoint(view, extraByteOffset, pointIndex, layout, target) {
+  if (!target.classifications && !target.returnNumbers && !target.numberOfReturns && !target.scanAngles && !target.overlapFlags && !target.scannerChannels && !target.nir)
+    return;
+  const extendedReturns = view.getUint8(extraByteOffset + layout.returnsByteOffset);
+  const flags = view.getUint8(extraByteOffset + layout.flagsByteOffset);
+  if (target.classifications)
+    target.classifications[pointIndex] += view.getUint8(
+      extraByteOffset + layout.classificationByteOffset
+    );
+  if (target.returnNumbers) target.returnNumbers[pointIndex] += extendedReturns >> 4;
+  if (target.numberOfReturns) target.numberOfReturns[pointIndex] += extendedReturns & 15;
+  if (target.scanAngles) {
+    const rank = target.scanAngles[pointIndex];
+    const prediction = Math.fround(rank / Math.fround(6e-3));
+    const quantized = Math.sign(prediction) * Math.floor(Math.abs(prediction) + 0.5);
+    target.scanAngles[pointIndex] = quantized + view.getInt16(extraByteOffset + layout.scanAngleByteOffset, true);
+  }
+  if (target.overlapFlags) target.overlapFlags[pointIndex] = flags & 1;
+  if (target.scannerChannels) target.scannerChannels[pointIndex] = flags >> 1 & 3;
+  if (target.nir && layout.nirByteOffset !== void 0)
+    target.nir[pointIndex] = view.getUint16(extraByteOffset + layout.nirByteOffset, true);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getLASCompatibilityLayout,
+  populateLASCompatibilityPoint
+});
+//# sourceMappingURL=las-compatibility.cjs.map

package/dist/las/lib/las-compatibility.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/las/lib/las-compatibility.ts"],
+  "sourcesContent": ["// loaders.gl\n// SPDX-License-Identifier: MIT AND Apache-2.0\n// Copyright (c) vis.gl contributors\n// Compatibility reconstruction follows LASzip, copyright rapidlasso GmbH.\n// See LASZIP-LICENSE and LASZIP-NOTICE in this directory.\n\nimport type {LASHeader, LASMetadata} from './las-types';\n\n/** Descriptor offsets for LASzip's legacy representation of modern point records. */\nexport type LASCompatibilityLayout = {\n  /** Logical modern point format, while the source header retains its physical legacy format. */\n  pointDataRecordFormat: number;\n  /** Logical LAS version stored in the compatibility VLR. */\n  version: '1.4' | '1.5';\n  /** Packed Extra Bytes offset of the scan angle remainder. */\n  scanAngleByteOffset: number;\n  /** Packed Extra Bytes offset of the return increments. */\n  returnsByteOffset: number;\n  /** Packed Extra Bytes offset of the classification increment. */\n  classificationByteOffset: number;\n  /** Packed Extra Bytes offset of overlap and scanner channel. */\n  flagsByteOffset: number;\n  /** Packed Extra Bytes offset of optional NIR data. */\n  nirByteOffset?: number;\n};\n\n/** Selected column targets that can be reconstructed from compatibility Extra Bytes. */\nexport type LASCompatibilityTarget = {\n  /** Classification codes. */\n  classifications: Uint8Array | null;\n  /** Return numbers. */\n  returnNumbers: Uint8Array | null;\n  /** Return counts. */\n  numberOfReturns: Uint8Array | null;\n  /** Scan angles in modern 0.006-degree units. */\n  scanAngles: Int16Array | null;\n  /** Overlap flags. */\n  overlapFlags: Uint8Array | null;\n  /** Scanner channels. */\n  scannerChannels: Uint8Array | null;\n  /** Optional NIR values. */\n  nir: Uint16Array | null;\n};\n\n/** Validate the explicit compatibility marker and locate its descriptor-defined fields. */\nexport function getLASCompatibilityLayout(\n  header: LASHeader,\n  metadata: LASMetadata\n): LASCompatibilityLayout | undefined {\n  const record = metadata.vlrs.find(\n    variableLengthRecord =>\n      variableLengthRecord.userId === 'lascompatible' && variableLengthRecord.recordId === 22204\n  );\n  if (!record) return undefined;\n  if (\n    !['1.0', '1.1', '1.2', '1.3'].includes(header.versionAsString || '') ||\n    ![1, 3, 4, 5].includes(header.pointsFormatId)\n  ) {\n    throw new Error('LASLoader: compatibility mode requires a legacy LAS point format');\n  }\n  const view = new DataView(record.data.buffer, record.data.byteOffset, record.data.byteLength);\n  if (view.byteLength < 4) throw new Error('LASLoader: truncated LASzip compatibility VLR');\n  const version = view.getUint16(2, true);\n  if ((version !== 3 && version !== 4) || view.byteLength !== (version === 3 ? 156 : 174)) {\n    throw new Error(`LASLoader: unsupported LASzip compatibility VLR version ${version} or length`);\n  }\n  const offsets = new Map<string, {byteOffset: number; dataType: number}>();\n  let byteOffset = 0;\n  for (const descriptor of metadata.extraBytes) {\n    const scalarDataType =\n      descriptor.dataType > 20\n        ? descriptor.dataType - 20\n        : descriptor.dataType > 10\n          ? descriptor.dataType - 10\n          : descriptor.dataType;\n    const size = descriptor.dataType > 20 ? 3 : descriptor.dataType > 10 ? 2 : 1;\n    const byteLength =\n      descriptor.dataType === 0\n        ? descriptor.options\n        : scalarDataType <= 2\n          ? size\n          : scalarDataType <= 4\n            ? 2 * size\n            : scalarDataType <= 6 || scalarDataType === 9\n              ? 4 * size\n              : 8 * size;\n    if (descriptor.dataType > 30 || !byteLength)\n      throw new Error('LASLoader: invalid compatibility Extra Bytes layout');\n    offsets.set(descriptor.name, {byteOffset, dataType: descriptor.dataType});\n    byteOffset += byteLength;\n  }\n  const baseLength = {1: 28, 3: 34, 4: 57, 5: 63}[header.pointsFormatId]!;\n  if (byteOffset !== header.pointsStructSize - baseLength)\n    throw new Error('LASLoader: compatibility descriptors do not match point record length');\n  const scanAngleByteOffset = getCompatibilityFieldOffset(offsets, 'LAS 1.4 scan angle', 4);\n  const returnsByteOffset = getCompatibilityFieldOffset(offsets, 'LAS 1.4 extended returns', 1);\n  const classificationByteOffset = getCompatibilityFieldOffset(\n    offsets,\n    'LAS 1.4 classification',\n    1\n  );\n  const flagsByteOffset = getCompatibilityFieldOffset(offsets, 'LAS 1.4 flags and channel', 1);\n  const nirByteOffset = offsets.has('LAS 1.4 NIR band')\n    ? getCompatibilityFieldOffset(offsets, 'LAS 1.4 NIR band', 3)\n    : undefined;\n  const pointDataRecordFormat =\n    header.pointsFormatId === 1\n      ? 6\n      : header.pointsFormatId === 3\n        ? nirByteOffset === undefined\n          ? 7\n          : 8\n        : header.pointsFormatId === 4\n          ? 9\n          : 10;\n  if (header.pointsFormatId === 5 && nirByteOffset === undefined)\n    throw new Error('LASLoader: compatibility waveform color points require NIR');\n  return {\n    pointDataRecordFormat,\n    version: version === 3 ? '1.4' : '1.5',\n    scanAngleByteOffset,\n    returnsByteOffset,\n    classificationByteOffset,\n    flagsByteOffset,\n    nirByteOffset\n  };\n}\n\n/** Require the named field to have the scalar representation used by LASzip. */\nfunction getCompatibilityFieldOffset(\n  offsets: Map<string, {byteOffset: number; dataType: number}>,\n  name: string,\n  dataType: number\n): number {\n  const field = offsets.get(name);\n  if (!field || field.dataType !== dataType)\n    throw new Error(`LASLoader: missing or invalid compatibility field ${name}`);\n  return field.byteOffset;\n}\n\n/** Restore selected modern fields from one legacy record without changing raw point bytes. */\nexport function populateLASCompatibilityPoint(\n  view: DataView,\n  extraByteOffset: number,\n  pointIndex: number,\n  layout: LASCompatibilityLayout,\n  target: LASCompatibilityTarget\n): void {\n  if (\n    !target.classifications &&\n    !target.returnNumbers &&\n    !target.numberOfReturns &&\n    !target.scanAngles &&\n    !target.overlapFlags &&\n    !target.scannerChannels &&\n    !target.nir\n  )\n    return;\n  const extendedReturns = view.getUint8(extraByteOffset + layout.returnsByteOffset);\n  const flags = view.getUint8(extraByteOffset + layout.flagsByteOffset);\n  if (target.classifications)\n    target.classifications[pointIndex] += view.getUint8(\n      extraByteOffset + layout.classificationByteOffset\n    );\n  if (target.returnNumbers) target.returnNumbers[pointIndex] += extendedReturns >> 4;\n  if (target.numberOfReturns) target.numberOfReturns[pointIndex] += extendedReturns & 15;\n  if (target.scanAngles) {\n    const rank = target.scanAngles[pointIndex];\n    const prediction = Math.fround(rank / Math.fround(0.006));\n    const quantized = Math.sign(prediction) * Math.floor(Math.abs(prediction) + 0.5);\n    target.scanAngles[pointIndex] =\n      quantized + view.getInt16(extraByteOffset + layout.scanAngleByteOffset, true);\n  }\n  if (target.overlapFlags) target.overlapFlags[pointIndex] = flags & 1;\n  if (target.scannerChannels) target.scannerChannels[pointIndex] = (flags >> 1) & 3;\n  if (target.nir && layout.nirByteOffset !== undefined)\n    target.nir[pointIndex] = view.getUint16(extraByteOffset + layout.nirByteOffset, true);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/las/lib/las-compatibility.d.ts

@@ -0,0 +1,40 @@
+import type { LASHeader, LASMetadata } from "./las-types.js";
+/** Descriptor offsets for LASzip's legacy representation of modern point records. */
+export type LASCompatibilityLayout = {
+    /** Logical modern point format, while the source header retains its physical legacy format. */
+    pointDataRecordFormat: number;
+    /** Logical LAS version stored in the compatibility VLR. */
+    version: '1.4' | '1.5';
+    /** Packed Extra Bytes offset of the scan angle remainder. */
+    scanAngleByteOffset: number;
+    /** Packed Extra Bytes offset of the return increments. */
+    returnsByteOffset: number;
+    /** Packed Extra Bytes offset of the classification increment. */
+    classificationByteOffset: number;
+    /** Packed Extra Bytes offset of overlap and scanner channel. */
+    flagsByteOffset: number;
+    /** Packed Extra Bytes offset of optional NIR data. */
+    nirByteOffset?: number;
+};
+/** Selected column targets that can be reconstructed from compatibility Extra Bytes. */
+export type LASCompatibilityTarget = {
+    /** Classification codes. */
+    classifications: Uint8Array | null;
+    /** Return numbers. */
+    returnNumbers: Uint8Array | null;
+    /** Return counts. */
+    numberOfReturns: Uint8Array | null;
+    /** Scan angles in modern 0.006-degree units. */
+    scanAngles: Int16Array | null;
+    /** Overlap flags. */
+    overlapFlags: Uint8Array | null;
+    /** Scanner channels. */
+    scannerChannels: Uint8Array | null;
+    /** Optional NIR values. */
+    nir: Uint16Array | null;
+};
+/** Validate the explicit compatibility marker and locate its descriptor-defined fields. */
+export declare function getLASCompatibilityLayout(header: LASHeader, metadata: LASMetadata): LASCompatibilityLayout | undefined;
+/** Restore selected modern fields from one legacy record without changing raw point bytes. */
+export declare function populateLASCompatibilityPoint(view: DataView, extraByteOffset: number, pointIndex: number, layout: LASCompatibilityLayout, target: LASCompatibilityTarget): void;
+//# sourceMappingURL=las-compatibility.d.ts.map

package/dist/las/lib/las-compatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"las-compatibility.d.ts","sourceRoot":"","sources":["../../../src/las/lib/las-compatibility.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,SAAS,EAAE,WAAW,EAAC,uBAAoB;AAExD,qFAAqF;AACrF,MAAM,MAAM,sBAAsB,GAAG;IACnC,+FAA+F;IAC/F,qBAAqB,EAAE,MAAM,CAAC;IAC9B,2DAA2D;IAC3D,OAAO,EAAE,KAAK,GAAG,KAAK,CAAC;IACvB,6DAA6D;IAC7D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,0DAA0D;IAC1D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iEAAiE;IACjE,wBAAwB,EAAE,MAAM,CAAC;IACjC,gEAAgE;IAChE,eAAe,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,wFAAwF;AACxF,MAAM,MAAM,sBAAsB,GAAG;IACnC,4BAA4B;IAC5B,eAAe,EAAE,UAAU,GAAG,IAAI,CAAC;IACnC,sBAAsB;IACtB,aAAa,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,qBAAqB;IACrB,eAAe,EAAE,UAAU,GAAG,IAAI,CAAC;IACnC,gDAAgD;IAChD,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,qBAAqB;IACrB,YAAY,EAAE,UAAU,GAAG,IAAI,CAAC;IAChC,wBAAwB;IACxB,eAAe,EAAE,UAAU,GAAG,IAAI,CAAC;IACnC,2BAA2B;IAC3B,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,2FAA2F;AAC3F,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,WAAW,GACpB,sBAAsB,GAAG,SAAS,CA8EpC;AAcD,8FAA8F;AAC9F,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,QAAQ,EACd,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE,sBAAsB,GAC7B,IAAI,CA8BN"}