@loaders.gl/i3s 4.0.0-alpha.1 → 4.0.0-alpha.11

package/dist/lib/parsers/parse-zip/local-file-header.d.ts

@@ -0,0 +1,25 @@
+import { FileProvider } from './file-provider';
+/**
+ * zip local file header info
+ * according to https://en.wikipedia.org/wiki/ZIP_(file_format)
+ */
+export type ZipLocalFileHeader = {
+    /** File name length */
+    fileNameLength: number;
+    /** File name */
+    fileName: string;
+    /** Extra field length */
+    extraFieldLength: number;
+    /** Offset of the file data */
+    fileDataOffset: number;
+    /** Compressed size */
+    compressedSize: number;
+};
+/**
+ * Parses local file header of zip file
+ * @param headerOffset - offset in the archive where header starts
+ * @param buffer - buffer containing whole array
+ * @returns Info from the header
+ */
+export declare const parseZipLocalFileHeader: (headerOffset: number, buffer: FileProvider) => Promise<ZipLocalFileHeader | undefined>;
+//# sourceMappingURL=local-file-header.d.ts.map

package/dist/lib/parsers/parse-zip/local-file-header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-file-header.d.ts","sourceRoot":"","sources":["../../../../src/lib/parsers/parse-zip/local-file-header.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAE7C;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,uBAAuB;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,8BAA8B;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAWF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,iBACpB,MAAM,UACZ,YAAY,KACnB,QAAQ,kBAAkB,GAAG,SAAS,CA2BxC,CAAC"}

package/dist/lib/parsers/parse-zip/local-file-header.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseZipLocalFileHeader = void 0;
+const offsets = {
+    COMPRESSED_SIZE_OFFSET: 18,
+    FILE_NAME_LENGTH_OFFSET: 26,
+    EXTRA_FIELD_LENGTH_OFFSET: 28,
+    FILE_NAME_OFFSET: 30
+};
+const signature = Buffer.from([0x50, 0x4b, 0x03, 0x04]);
+/**
+ * Parses local file header of zip file
+ * @param headerOffset - offset in the archive where header starts
+ * @param buffer - buffer containing whole array
+ * @returns Info from the header
+ */
+const parseZipLocalFileHeader = async (headerOffset, buffer) => {
+    if (Buffer.from(await buffer.slice(headerOffset, headerOffset + 4)).compare(signature) !== 0) {
+        return Promise.resolve(undefined);
+    }
+    const fileNameLength = await buffer.getUint16(headerOffset + offsets.FILE_NAME_LENGTH_OFFSET);
+    const fileName = new TextDecoder().decode(await buffer.slice(headerOffset + offsets.FILE_NAME_OFFSET, headerOffset + offsets.FILE_NAME_OFFSET + fileNameLength));
+    const extraFieldLength = await buffer.getUint16(headerOffset + offsets.EXTRA_FIELD_LENGTH_OFFSET);
+    const fileDataOffset = headerOffset + offsets.FILE_NAME_OFFSET + fileNameLength + extraFieldLength;
+    const compressedSize = await buffer.getUint32(headerOffset + offsets.COMPRESSED_SIZE_OFFSET);
+    return {
+        fileNameLength,
+        fileName,
+        extraFieldLength,
+        fileDataOffset,
+        compressedSize
+    };
+};
+exports.parseZipLocalFileHeader = parseZipLocalFileHeader;

package/dist/lib/utils/convert-i3s-obb-to-mbs.d.ts

@@ -0,0 +1,2 @@
+export declare function convertI3SObbToMbs(obb: any): any[];
+//# sourceMappingURL=convert-i3s-obb-to-mbs.d.ts.map

package/dist/lib/utils/convert-i3s-obb-to-mbs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-i3s-obb-to-mbs.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/convert-i3s-obb-to-mbs.ts"],"names":[],"mappings":"AAGA,wBAAgB,kBAAkB,CAAC,GAAG,KAAA,SAgBrC"}

package/dist/lib/utils/convert-i3s-obb-to-mbs.js

@@ -1,9 +1,20 @@
-import { BoundingSphere } from '@math.gl/culling';
-import { Ellipsoid } from '@math.gl/geospatial';
-export function convertI3SObbToMbs(obb) {
-  const halfSize = obb.halfSize;
-  const centerCartesian = Ellipsoid.WGS84.cartographicToCartesian(obb.center);
-  const sphere = new BoundingSphere().fromCornerPoints([centerCartesian[0] - halfSize[0], centerCartesian[1] - halfSize[1], centerCartesian[2] - halfSize[2]], [centerCartesian[0] + halfSize[0], centerCartesian[1] + halfSize[1], centerCartesian[2] + halfSize[2]]);
-  return [...obb.center, sphere.radius];
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertI3SObbToMbs = void 0;
+const culling_1 = require("@math.gl/culling");
+const geospatial_1 = require("@math.gl/geospatial");
+function convertI3SObbToMbs(obb) {
+    const halfSize = obb.halfSize;
+    const centerCartesian = geospatial_1.Ellipsoid.WGS84.cartographicToCartesian(obb.center);
+    const sphere = new culling_1.BoundingSphere().fromCornerPoints([
+        centerCartesian[0] - halfSize[0],
+        centerCartesian[1] - halfSize[1],
+        centerCartesian[2] - halfSize[2]
+    ], [
+        centerCartesian[0] + halfSize[0],
+        centerCartesian[1] + halfSize[1],
+        centerCartesian[2] + halfSize[2]
+    ]);
+    return [...obb.center, sphere.radius];
 }
-//# sourceMappingURL=convert-i3s-obb-to-mbs.js.map
+exports.convertI3SObbToMbs = convertI3SObbToMbs;

package/dist/lib/utils/customize-/321/201olors.d.ts

@@ -0,0 +1,14 @@
+import type { MeshAttribute } from '@loaders.gl/schema';
+import type { I3STileOptions, I3STilesetOptions } from '../../types';
+import { I3SLoaderOptions } from '../../i3s-loader';
+/**
+ * Modify vertex colors array to visualize 3D objects in a attribute driven way
+ * @param colors - vertex colors attribute
+ * @param featureIds - feature Ids attribute
+ * @param tileOptions - tile - related options
+ * @param tilesetOptions - tileset-related options
+ * @param options - loader options
+ * @returns midified colors attribute
+ */
+export declare function customizeColors(colors: MeshAttribute, featureIds: MeshAttribute, tileOptions: I3STileOptions, tilesetOptions: I3STilesetOptions, options?: I3SLoaderOptions): Promise<MeshAttribute>;
+//# sourceMappingURL=customize-%D1%81olors.d.ts.map

package/dist/lib/utils/customize-/321/201olors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customize-сolors.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/customize-сolors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAQ,cAAc,EAAE,iBAAiB,EAAC,MAAM,aAAa,CAAC;AAI1E,OAAO,EAAC,gBAAgB,EAAC,MAAM,kBAAkB,CAAC;AAGlD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,aAAa,EACzB,WAAW,EAAE,cAAc,EAC3B,cAAc,EAAE,iBAAiB,EACjC,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,aAAa,CAAC,CAwExB"}

package/dist/lib/utils/customize-/321/201olors.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.customizeColors = void 0;
+const core_1 = require("@loaders.gl/core");
+const i3s_attribute_loader_1 = require("../../i3s-attribute-loader");
+const url_utils_1 = require("./url-utils");
+/**
+ * Modify vertex colors array to visualize 3D objects in a attribute driven way
+ * @param colors - vertex colors attribute
+ * @param featureIds - feature Ids attribute
+ * @param tileOptions - tile - related options
+ * @param tilesetOptions - tileset-related options
+ * @param options - loader options
+ * @returns midified colors attribute
+ */
+async function customizeColors(colors, featureIds, tileOptions, tilesetOptions, options) {
+    if (!options?.i3s?.colorsByAttribute) {
+        return colors;
+    }
+    const colorizeAttributeField = tilesetOptions.fields.find(({ name }) => name === options?.i3s?.colorsByAttribute?.attributeName);
+    if (!colorizeAttributeField ||
+        !['esriFieldTypeDouble', 'esriFieldTypeInteger', 'esriFieldTypeSmallInteger'].includes(colorizeAttributeField.type)) {
+        return colors;
+    }
+    const colorizeAttributeData = await loadFeatureAttributeData(colorizeAttributeField.name, tileOptions, tilesetOptions, options);
+    if (!colorizeAttributeData) {
+        return colors;
+    }
+    const objectIdField = tilesetOptions.fields.find(({ type }) => type === 'esriFieldTypeOID');
+    if (!objectIdField) {
+        return colors;
+    }
+    const objectIdAttributeData = await loadFeatureAttributeData(objectIdField.name, tileOptions, tilesetOptions, options);
+    if (!objectIdAttributeData) {
+        return colors;
+    }
+    const attributeValuesMap = {};
+    // @ts-expect-error
+    for (let i = 0; i < objectIdAttributeData[objectIdField.name].length; i++) {
+        // @ts-expect-error
+        attributeValuesMap[objectIdAttributeData[objectIdField.name][i]] = calculateColorForAttribute(
+        // @ts-expect-error
+        colorizeAttributeData[colorizeAttributeField.name][i], options);
+    }
+    for (let i = 0; i < featureIds.value.length; i++) {
+        const color = attributeValuesMap[featureIds.value[i]];
+        if (!color) {
+            continue; // eslint-disable-line no-continue
+        }
+        /* eslint max-statements: ["error", 30] */
+        /* eslint complexity: ["error", 12] */
+        if (options.i3s.colorsByAttribute.mode === 'multiply') {
+            // multiplying original mesh and calculated for attribute rgba colors in range 0-255
+            color.forEach((colorItem, index) => {
+                colors.value[i * 4 + index] = (colors.value[i * 4 + index] * colorItem) / 255;
+            });
+        }
+        else {
+            colors.value.set(color, i * 4);
+        }
+    }
+    return colors;
+}
+exports.customizeColors = customizeColors;
+/**
+ * Calculate rgba color from the attribute value
+ * @param attributeValue - value of the attribute
+ * @param options - loader options
+ * @returns - color array for a specific attribute value
+ */
+function calculateColorForAttribute(attributeValue, options) {
+    if (!options?.i3s?.colorsByAttribute) {
+        return [255, 255, 255, 255];
+    }
+    const { minValue, maxValue, minColor, maxColor } = options.i3s.colorsByAttribute;
+    const rate = (attributeValue - minValue) / (maxValue - minValue);
+    const color = [255, 255, 255, 255];
+    for (let i = 0; i < minColor.length; i++) {
+        color[i] = Math.round((maxColor[i] - minColor[i]) * rate + minColor[i]);
+    }
+    return color;
+}
+/**
+ * Load feature attribute data from the ArcGIS rest service
+ * @param attributeName - attribute name
+ * @param tileOptions - tile-related options
+ * @param tilesetOptions - tileset-related options
+ * @param options - loader options
+ * @returns - Array-like list of the attribute values
+ */
+async function loadFeatureAttributeData(attributeName, { attributeUrls }, { attributeStorageInfo }, options) {
+    const attributeIndex = attributeStorageInfo.findIndex(({ name }) => attributeName === name);
+    if (attributeIndex === -1) {
+        return null;
+    }
+    const objectIdAttributeUrl = (0, url_utils_1.getUrlWithToken)(attributeUrls[attributeIndex], options?.i3s?.token);
+    const attributeType = (0, i3s_attribute_loader_1.getAttributeValueType)(attributeStorageInfo[attributeIndex]);
+    const objectIdAttributeData = await (0, core_1.load)(objectIdAttributeUrl, i3s_attribute_loader_1.I3SAttributeLoader, {
+        attributeName,
+        attributeType
+    });
+    // @ts-expect-error TODO action engine
+    return objectIdAttributeData;
+}

package/dist/lib/utils/url-utils.d.ts

@@ -0,0 +1,22 @@
+import { Node3DIndexDocument } from '../../types';
+/**
+ * Generates url with token if it is exists.
+ * @param url
+ * @param token
+ * @returns
+ */
+export declare function getUrlWithToken(url: string, token?: string | null): string;
+/**
+ * Generates attribute urls for tile.
+ * @param tile
+ * @returns list of attribute urls
+ */
+export declare function generateTileAttributeUrls(url: string, tile: Node3DIndexDocument): string[];
+/**
+ * Generates attribute urls for tileset based on tileset and resource
+ * @param {Object} tileset
+ * @param {number} resource
+ * @returns {Array}
+ */
+export declare function generateTilesetAttributeUrls(tileset: any, resource: any): string[];
+//# sourceMappingURL=url-utils.d.ts.map

package/dist/lib/utils/url-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/url-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,mBAAmB,EAAC,MAAM,aAAa,CAAC;AAEhD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,GAAG,IAAW,GAAG,MAAM,CAEhF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,MAAM,EAAE,CAU1F;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,KAAA,EAAE,QAAQ,KAAA,YAU7D"}

package/dist/lib/utils/url-utils.js

@@ -1,32 +1,44 @@
-export function getUrlWithToken(url, token = null) {
-  return token ? "".concat(url, "?token=").concat(token) : url;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateTilesetAttributeUrls = exports.generateTileAttributeUrls = exports.getUrlWithToken = void 0;
+/**
+ * Generates url with token if it is exists.
+ * @param url
+ * @param token
+ * @returns
+ */
+function getUrlWithToken(url, token = null) {
+    return token ? `${url}?token=${token}` : url;
 }
-export function generateTileAttributeUrls(tile) {
-  const {
-    url,
-    attributeData
-  } = tile;
-  const attributeUrls = [];
-
-  for (let index = 0; index < attributeData.length; index++) {
-    const attributeUrl = attributeData[index].href.replace('./', '');
-    attributeUrls.push("".concat(url, "/").concat(attributeUrl));
-  }
-
-  return attributeUrls;
+exports.getUrlWithToken = getUrlWithToken;
+/**
+ * Generates attribute urls for tile.
+ * @param tile
+ * @returns list of attribute urls
+ */
+function generateTileAttributeUrls(url, tile) {
+    const { attributeData = [] } = tile;
+    const attributeUrls = [];
+    for (let index = 0; index < attributeData.length; index++) {
+        const attributeUrl = attributeData[index].href.replace('./', '');
+        attributeUrls.push(`${url}/${attributeUrl}`);
+    }
+    return attributeUrls;
 }
-export function generateTilesetAttributeUrls(tileset, resource) {
-  const attributeUrls = [];
-  const {
-    attributeStorageInfo,
-    url
-  } = tileset;
-
-  for (let index = 0; index < attributeStorageInfo.length; index++) {
-    const fileName = attributeStorageInfo[index].key;
-    attributeUrls.push("".concat(url, "/nodes/").concat(resource, "/attributes/").concat(fileName, "/0"));
-  }
-
-  return attributeUrls;
+exports.generateTileAttributeUrls = generateTileAttributeUrls;
+/**
+ * Generates attribute urls for tileset based on tileset and resource
+ * @param {Object} tileset
+ * @param {number} resource
+ * @returns {Array}
+ */
+function generateTilesetAttributeUrls(tileset, resource) {
+    const attributeUrls = [];
+    const { attributeStorageInfo, url } = tileset;
+    for (let index = 0; index < attributeStorageInfo.length; index++) {
+        const fileName = attributeStorageInfo[index].key;
+        attributeUrls.push(`${url}/nodes/${resource}/attributes/${fileName}/0`);
+    }
+    return attributeUrls;
 }
-//# sourceMappingURL=url-utils.js.map
+exports.generateTilesetAttributeUrls = generateTilesetAttributeUrls;