@loaders.gl/3d-tiles 4.0.0-alpha.5 → 4.0.0-alpha.6

package/dist/lib/parsers/parse-3d-tile.js

@@ -1,32 +1,37 @@
-import { TILE3D_TYPE } from '../constants';
-import { getMagicString } from './helpers/parse-utils';
-import { parsePointCloud3DTile } from './parse-3d-tile-point-cloud';
-import { parseBatchedModel3DTile } from './parse-3d-tile-batched-model';
-import { parseInstancedModel3DTile } from './parse-3d-tile-instanced-model';
-import { parseComposite3DTile } from './parse-3d-tile-composite';
-import { parseGltf3DTile } from './parse-3d-tile-gltf';
-export async function parse3DTile(arrayBuffer, byteOffset = 0, options, context, tile = {}) {
-  tile.byteOffset = byteOffset;
-  tile.type = getMagicString(arrayBuffer, byteOffset);
-
-  switch (tile.type) {
-    case TILE3D_TYPE.COMPOSITE:
-      return await parseComposite3DTile(tile, arrayBuffer, byteOffset, options, context, parse3DTile);
-
-    case TILE3D_TYPE.BATCHED_3D_MODEL:
-      return await parseBatchedModel3DTile(tile, arrayBuffer, byteOffset, options, context);
-
-    case TILE3D_TYPE.GLTF:
-      return await parseGltf3DTile(tile, arrayBuffer, options, context);
-
-    case TILE3D_TYPE.INSTANCED_3D_MODEL:
-      return await parseInstancedModel3DTile(tile, arrayBuffer, byteOffset, options, context);
-
-    case TILE3D_TYPE.POINT_CLOUD:
-      return await parsePointCloud3DTile(tile, arrayBuffer, byteOffset, options, context);
-
-    default:
-      throw new Error("3DTileLoader: unknown type ".concat(tile.type));
-  }
+"use strict";
+// This file is derived from the Cesium code base under Apache 2 license
+// See LICENSE.md and https://github.com/AnalyticalGraphicsInc/cesium/blob/master/LICENSE.md
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parse3DTile = void 0;
+const constants_1 = require("../constants");
+const parse_utils_1 = require("./helpers/parse-utils");
+const parse_3d_tile_point_cloud_1 = require("./parse-3d-tile-point-cloud");
+const parse_3d_tile_batched_model_1 = require("./parse-3d-tile-batched-model");
+const parse_3d_tile_instanced_model_1 = require("./parse-3d-tile-instanced-model");
+const parse_3d_tile_composite_1 = require("./parse-3d-tile-composite");
+const parse_3d_tile_gltf_1 = require("./parse-3d-tile-gltf");
+// Extracts
+async function parse3DTile(arrayBuffer, byteOffset = 0, options, context, tile = {}) {
+    // @ts-expect-error
+    tile.byteOffset = byteOffset;
+    // @ts-expect-error
+    tile.type = (0, parse_utils_1.getMagicString)(arrayBuffer, byteOffset);
+    // @ts-expect-error
+    switch (tile.type) {
+        case constants_1.TILE3D_TYPE.COMPOSITE:
+            // Note: We pass this function as argument so that embedded tiles can be parsed recursively
+            return await (0, parse_3d_tile_composite_1.parseComposite3DTile)(tile, arrayBuffer, byteOffset, options, context, parse3DTile);
+        case constants_1.TILE3D_TYPE.BATCHED_3D_MODEL:
+            return await (0, parse_3d_tile_batched_model_1.parseBatchedModel3DTile)(tile, arrayBuffer, byteOffset, options, context);
+        case constants_1.TILE3D_TYPE.GLTF:
+            return await (0, parse_3d_tile_gltf_1.parseGltf3DTile)(tile, arrayBuffer, options, context);
+        case constants_1.TILE3D_TYPE.INSTANCED_3D_MODEL:
+            return await (0, parse_3d_tile_instanced_model_1.parseInstancedModel3DTile)(tile, arrayBuffer, byteOffset, options, context);
+        case constants_1.TILE3D_TYPE.POINT_CLOUD:
+            return await (0, parse_3d_tile_point_cloud_1.parsePointCloud3DTile)(tile, arrayBuffer, byteOffset, options, context);
+        default:
+            // @ts-expect-error
+            throw new Error(`3DTileLoader: unknown type ${tile.type}`); // eslint-disable-line
+    }
 }
-//# sourceMappingURL=parse-3d-tile.js.map
+exports.parse3DTile = parse3DTile;

package/dist/lib/utils/obb/s2-corners-to-obb.d.ts

@@ -0,0 +1,15 @@
+export type S2VolumeInfo = {
+    /** S2 key or token */
+    token: string;
+    /** minimum height in meters */
+    minimumHeight: number;
+    /** maximum height in meters */
+    maximumHeight: number;
+};
+/**
+ * Converts S2VolumeInfo to OrientedBoundingBox
+ * @param {S2VolumeInfo} s2VolumeInfo - s2 volume to convert
+ * @returns Oriented Bounding Box of type Box
+ */
+export declare function convertS2BoundingVolumetoOBB(s2VolumeInfo: S2VolumeInfo): number[];
+//# sourceMappingURL=s2-corners-to-obb.d.ts.map

package/dist/lib/utils/obb/s2-corners-to-obb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s2-corners-to-obb.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/obb/s2-corners-to-obb.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,YAAY,GAAG;IACzB,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,EAAE,CA2BjF"}

package/dist/lib/utils/obb/s2-corners-to-obb.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertS2BoundingVolumetoOBB = void 0;
+const core_1 = require("@math.gl/core");
+const culling_1 = require("@math.gl/culling");
+const index_1 = require("../../utils/s2/index");
+const index_2 = require("../../utils/s2/index");
+const geospatial_1 = require("@math.gl/geospatial");
+/**
+ * Converts S2VolumeInfo to OrientedBoundingBox
+ * @param {S2VolumeInfo} s2VolumeInfo - s2 volume to convert
+ * @returns Oriented Bounding Box of type Box
+ */
+function convertS2BoundingVolumetoOBB(s2VolumeInfo) {
+    const token = s2VolumeInfo.token;
+    const heightInfo = {
+        minimumHeight: s2VolumeInfo.minimumHeight,
+        maximumHeight: s2VolumeInfo.maximumHeight
+    };
+    const corners = (0, index_1.getS2OrientedBoundingBoxCornerPoints)(token, heightInfo);
+    // Add a point that doesn't allow the box dive under the Earth
+    const center = (0, index_2.getS2LngLat)(token);
+    const centerLng = center[0];
+    const centerLat = center[1];
+    const point = geospatial_1.Ellipsoid.WGS84.cartographicToCartesian([
+        centerLng,
+        centerLat,
+        heightInfo.maximumHeight
+    ]);
+    const centerPointAdditional = new core_1.Vector3(point[0], point[1], point[2]);
+    corners.push(centerPointAdditional);
+    // corners should be an array of Vector3 (XYZ)
+    const obb = (0, culling_1.makeOrientedBoundingBoxFromPoints)(corners);
+    const box = [...obb.center, ...obb.halfAxes];
+    return box;
+}
+exports.convertS2BoundingVolumetoOBB = convertS2BoundingVolumetoOBB;

package/dist/lib/utils/s2/converters/s2-to-boundary.d.ts

@@ -0,0 +1,9 @@
+import type { S2Cell } from '../s2geometry/s2-geometry';
+/**
+ * Get a polygon with corner coordinates for an S2 cell
+ * @param s2cell {S2Cell} S2 cell
+ * @return {Float64Array} - a simple polygon in flat array format: [lng0, lat0, lng1, lat1, ...]
+ *   - the polygon is closed, i.e. last coordinate is a copy of the first coordinate
+ */
+export declare function getS2BoundaryFlatFromS2Cell(s2cell: S2Cell): Float64Array;
+//# sourceMappingURL=s2-to-boundary.d.ts.map

package/dist/lib/utils/s2/converters/s2-to-boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s2-to-boundary.d.ts","sourceRoot":"","sources":["../../../../../src/lib/utils/s2/converters/s2-to-boundary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,2BAA2B,CAAC;AAKtD;;;;;GAKG;AAEH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAsDxE"}

package/dist/lib/utils/s2/converters/s2-to-boundary.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getS2BoundaryFlatFromS2Cell = void 0;
+const s2_geometry_1 = require("../s2geometry/s2-geometry");
+const MAX_RESOLUTION = 100;
+/**
+ * Get a polygon with corner coordinates for an S2 cell
+ * @param s2cell {S2Cell} S2 cell
+ * @return {Float64Array} - a simple polygon in flat array format: [lng0, lat0, lng1, lat1, ...]
+ *   - the polygon is closed, i.e. last coordinate is a copy of the first coordinate
+ */
+// eslint-disable-next-line max-statements
+function getS2BoundaryFlatFromS2Cell(s2cell) {
+    const { face, ij, level } = s2cell;
+    const offsets = [
+        [0, 0],
+        [0, 1],
+        [1, 1],
+        [1, 0],
+        [0, 0]
+    ];
+    // The S2 cell edge is curved: http://s2geometry.io/
+    // This is more prominent at lower levels
+    // resolution is the number of segments to generate per edge.
+    // We exponentially reduce resolution as level increases so it doesn't affect perf
+    // when there are a large number of cells
+    const resolution = Math.max(1, Math.ceil(MAX_RESOLUTION * Math.pow(2, -level)));
+    const result = new Float64Array(4 * resolution * 2 + 2);
+    let ptIndex = 0;
+    let prevLng = 0;
+    for (let i = 0; i < 4; i++) {
+        const offset = offsets[i].slice(0);
+        const nextOffset = offsets[i + 1];
+        const stepI = (nextOffset[0] - offset[0]) / resolution;
+        const stepJ = (nextOffset[1] - offset[1]) / resolution;
+        for (let j = 0; j < resolution; j++) {
+            offset[0] += stepI;
+            offset[1] += stepJ;
+            // Cell can be represented by coordinates IJ, ST, UV, XYZ
+            // http://s2geometry.io/devguide/s2cell_hierarchy#coordinate-systems
+            const st = (0, s2_geometry_1.IJToST)(ij, level, offset);
+            const uv = (0, s2_geometry_1.STToUV)(st);
+            const xyz = (0, s2_geometry_1.FaceUVToXYZ)(face, uv);
+            const lngLat = (0, s2_geometry_1.XYZToLngLat)(xyz);
+            // Adjust longitude for Web Mercator projection
+            if (Math.abs(lngLat[1]) > 89.999) {
+                lngLat[0] = prevLng;
+            }
+            const deltaLng = lngLat[0] - prevLng;
+            lngLat[0] += deltaLng > 180 ? -360 : deltaLng < -180 ? 360 : 0;
+            result[ptIndex++] = lngLat[0];
+            result[ptIndex++] = lngLat[1];
+            prevLng = lngLat[0];
+        }
+    }
+    // close the loop
+    result[ptIndex++] = result[0];
+    result[ptIndex++] = result[1];
+    return result;
+}
+exports.getS2BoundaryFlatFromS2Cell = getS2BoundaryFlatFromS2Cell;

package/dist/lib/utils/s2/converters/s2-to-obb-points.d.ts

@@ -0,0 +1,15 @@
+import { Vector3 } from '@math.gl/core';
+export type S2HeightInfo = {
+    minimumHeight: number;
+    maximumHeight: number;
+};
+/**
+ * Converts S2HeightInfo to corner points of an oriented bounding box
+ * Can be used to constuct an OrientedBoundingBox instance
+ * @param tokenOrKey {string} A string that is the cell's hex token or the Hilbert quad key (containing /)
+ * @param heightInfo {S2HeightInfo} min and max height of the box
+ * @returns corner points of the oriented bounding box
+ */
+export declare function getS2OrientedBoundingBoxCornerPoints(tokenOrKey: string, // This can be an S2 key or token
+heightInfo?: S2HeightInfo): Vector3[];
+//# sourceMappingURL=s2-to-obb-points.d.ts.map

package/dist/lib/utils/s2/converters/s2-to-obb-points.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s2-to-obb-points.d.ts","sourceRoot":"","sources":["../../../../../src/lib/utils/s2/converters/s2-to-obb-points.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,OAAO,EAAC,MAAM,eAAe,CAAC;AAEtC,MAAM,MAAM,YAAY,GAAG;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,oCAAoC,CAClD,UAAU,EAAE,MAAM,EAAE,iCAAiC;AACrD,UAAU,CAAC,EAAE,YAAY,GACxB,OAAO,EAAE,CA0BX"}

package/dist/lib/utils/s2/converters/s2-to-obb-points.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getS2OrientedBoundingBoxCornerPoints = void 0;
+const s2_cell_utils_1 = require("../s2geometry/s2-cell-utils");
+const s2_to_region_1 = require("./s2-to-region");
+const core_1 = require("@math.gl/core");
+/**
+ * Converts S2HeightInfo to corner points of an oriented bounding box
+ * Can be used to constuct an OrientedBoundingBox instance
+ * @param tokenOrKey {string} A string that is the cell's hex token or the Hilbert quad key (containing /)
+ * @param heightInfo {S2HeightInfo} min and max height of the box
+ * @returns corner points of the oriented bounding box
+ */
+function getS2OrientedBoundingBoxCornerPoints(tokenOrKey, // This can be an S2 key or token
+heightInfo) {
+    const min = heightInfo?.minimumHeight || 0;
+    const max = heightInfo?.maximumHeight || 0;
+    const s2cell = (0, s2_cell_utils_1.getS2Cell)(tokenOrKey);
+    const region = (0, s2_to_region_1.getS2Region)(s2cell);
+    // region lng/lat are in degrees
+    const W = region.west;
+    const S = region.south;
+    const E = region.east;
+    const N = region.north;
+    const points = [];
+    points.push(new core_1.Vector3(W, N, min));
+    points.push(new core_1.Vector3(E, N, min));
+    points.push(new core_1.Vector3(E, S, min));
+    points.push(new core_1.Vector3(W, S, min));
+    points.push(new core_1.Vector3(W, N, max));
+    points.push(new core_1.Vector3(E, N, max));
+    points.push(new core_1.Vector3(E, S, max));
+    points.push(new core_1.Vector3(W, S, max));
+    return points;
+}
+exports.getS2OrientedBoundingBoxCornerPoints = getS2OrientedBoundingBoxCornerPoints;

package/dist/lib/utils/s2/converters/s2-to-region.d.ts

@@ -0,0 +1,13 @@
+import type { S2Cell } from '../s2geometry/s2-geometry';
+/**
+ * Converts S2 cell to the 2D region
+ * @param s2cell {S2Cell} S2 cell to convert to 2D region
+ * @returns 2D region as an object containing: west, north, east, south in degrees
+ */
+export declare function getS2Region(s2cell: S2Cell): {
+    west: number;
+    east: number;
+    north: number;
+    south: number;
+};
+//# sourceMappingURL=s2-to-region.d.ts.map

package/dist/lib/utils/s2/converters/s2-to-region.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s2-to-region.d.ts","sourceRoot":"","sources":["../../../../../src/lib/utils/s2/converters/s2-to-region.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,2BAA2B,CAAC;AAItD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAqBA"}

package/dist/lib/utils/s2/converters/s2-to-region.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getS2Region = void 0;
+const s2_to_boundary_1 = require("./s2-to-boundary");
+const s2_cell_utils_1 = require("../s2geometry/s2-cell-utils");
+/**
+ * Converts S2 cell to the 2D region
+ * @param s2cell {S2Cell} S2 cell to convert to 2D region
+ * @returns 2D region as an object containing: west, north, east, south in degrees
+ */
+function getS2Region(s2cell) {
+    let region;
+    if (s2cell.face === 2 || s2cell.face === 5) {
+        //    let corners: Float64Array;
+        let corners = null;
+        let len = 0;
+        for (let i = 0; i < 4; i++) {
+            const key = `${s2cell.face}/${i}`;
+            const cell = (0, s2_cell_utils_1.getS2Cell)(key);
+            const corns = (0, s2_to_boundary_1.getS2BoundaryFlatFromS2Cell)(cell);
+            if (typeof corners === 'undefined' || corners === null)
+                corners = new Float64Array(4 * corns.length);
+            corners.set(corns, len);
+            len += corns.length;
+        }
+        region = get2DRegionFromS2Corners(corners);
+    }
+    else {
+        const corners = (0, s2_to_boundary_1.getS2BoundaryFlatFromS2Cell)(s2cell);
+        region = get2DRegionFromS2Corners(corners);
+    }
+    return region;
+}
+exports.getS2Region = getS2Region;
+/**
+ * Converts the S2 cell defined by its corners to the 2D region
+ * @param corners {Float64Array} - a simple polygon in flat array format: [lng0, lat0, lng1, lat1, ...]
+ * @returns 2D region as an object containing: west, north, east, south in degrees
+ */
+function get2DRegionFromS2Corners(corners) {
+    if (corners.length % 2 !== 0) {
+        throw new Error('Invalid corners');
+    }
+    const longitudes = [];
+    const latitudes = [];
+    for (let i = 0; i < corners.length; i += 2) {
+        longitudes.push(corners[i]);
+        latitudes.push(corners[i + 1]);
+    }
+    longitudes.sort((a, b) => a - b);
+    latitudes.sort((a, b) => a - b);
+    // Return the region in degrees
+    return {
+        west: longitudes[0],
+        east: longitudes[longitudes.length - 1],
+        north: latitudes[latitudes.length - 1],
+        south: latitudes[0]
+    };
+}

package/dist/lib/utils/s2/index.d.ts

@@ -0,0 +1,8 @@
+export { getS2CellIdFromToken, getS2TokenFromCellId, getS2ChildCellId } from './s2-token-functions';
+export { getS2BoundaryFlat, getS2LngLat } from './s2-geometry-functions';
+export { getS2Cell, getS2QuadKey } from './s2geometry/s2-cell-utils';
+export { getS2QuadkeyFromCellId, getS2CellFromQuadKey, getS2CellIdFromQuadkey, getS2LngLatFromS2Cell } from './s2geometry/s2-geometry';
+export { getS2Region } from './converters/s2-to-region';
+export type { S2HeightInfo } from './converters/s2-to-obb-points';
+export { getS2OrientedBoundingBoxCornerPoints } from './converters/s2-to-obb-points';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/utils/s2/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/s2/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,oBAAoB,EAAE,oBAAoB,EAAE,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AAClG,OAAO,EAAC,iBAAiB,EAAE,WAAW,EAAC,MAAM,yBAAyB,CAAC;AAEvE,OAAO,EAAC,SAAS,EAAE,YAAY,EAAC,MAAM,4BAA4B,CAAC;AACnE,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAC,WAAW,EAAC,MAAM,2BAA2B,CAAC;AAEtD,YAAY,EAAC,YAAY,EAAC,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAC,oCAAoC,EAAC,MAAM,+BAA+B,CAAC"}

package/dist/lib/utils/s2/index.js

@@ -0,0 +1,23 @@
+"use strict";
+// math.gl MIT license
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getS2OrientedBoundingBoxCornerPoints = exports.getS2Region = exports.getS2LngLatFromS2Cell = exports.getS2CellIdFromQuadkey = exports.getS2CellFromQuadKey = exports.getS2QuadkeyFromCellId = exports.getS2QuadKey = exports.getS2Cell = exports.getS2LngLat = exports.getS2BoundaryFlat = exports.getS2ChildCellId = exports.getS2TokenFromCellId = exports.getS2CellIdFromToken = void 0;
+var s2_token_functions_1 = require("./s2-token-functions");
+Object.defineProperty(exports, "getS2CellIdFromToken", { enumerable: true, get: function () { return s2_token_functions_1.getS2CellIdFromToken; } });
+Object.defineProperty(exports, "getS2TokenFromCellId", { enumerable: true, get: function () { return s2_token_functions_1.getS2TokenFromCellId; } });
+Object.defineProperty(exports, "getS2ChildCellId", { enumerable: true, get: function () { return s2_token_functions_1.getS2ChildCellId; } });
+var s2_geometry_functions_1 = require("./s2-geometry-functions");
+Object.defineProperty(exports, "getS2BoundaryFlat", { enumerable: true, get: function () { return s2_geometry_functions_1.getS2BoundaryFlat; } });
+Object.defineProperty(exports, "getS2LngLat", { enumerable: true, get: function () { return s2_geometry_functions_1.getS2LngLat; } });
+var s2_cell_utils_1 = require("./s2geometry/s2-cell-utils");
+Object.defineProperty(exports, "getS2Cell", { enumerable: true, get: function () { return s2_cell_utils_1.getS2Cell; } });
+Object.defineProperty(exports, "getS2QuadKey", { enumerable: true, get: function () { return s2_cell_utils_1.getS2QuadKey; } });
+var s2_geometry_1 = require("./s2geometry/s2-geometry");
+Object.defineProperty(exports, "getS2QuadkeyFromCellId", { enumerable: true, get: function () { return s2_geometry_1.getS2QuadkeyFromCellId; } });
+Object.defineProperty(exports, "getS2CellFromQuadKey", { enumerable: true, get: function () { return s2_geometry_1.getS2CellFromQuadKey; } });
+Object.defineProperty(exports, "getS2CellIdFromQuadkey", { enumerable: true, get: function () { return s2_geometry_1.getS2CellIdFromQuadkey; } });
+Object.defineProperty(exports, "getS2LngLatFromS2Cell", { enumerable: true, get: function () { return s2_geometry_1.getS2LngLatFromS2Cell; } });
+var s2_to_region_1 = require("./converters/s2-to-region");
+Object.defineProperty(exports, "getS2Region", { enumerable: true, get: function () { return s2_to_region_1.getS2Region; } });
+var s2_to_obb_points_1 = require("./converters/s2-to-obb-points");
+Object.defineProperty(exports, "getS2OrientedBoundingBoxCornerPoints", { enumerable: true, get: function () { return s2_to_obb_points_1.getS2OrientedBoundingBoxCornerPoints; } });

package/dist/lib/utils/s2/s2-geometry-functions.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Retrieve S2 geometry center
+ * @param s2Token {string} A string that is the cell's hex token
+ * @returns {[number, number]} Longitude and Latitude coordinates of the S2 cell's center
+ */
+export declare function getS2LngLat(s2Token: string): [number, number];
+/**
+ * Get a polygon with corner coordinates for an s2 cell
+ * @param tokenOrKey {string} A string that is the cell's hex token or the Hilbert quad key (containing /)
+ * @return {Float64Array} - a simple polygon in flat array format: [lng0, lat0, lng1, lat1, ...]
+ *   - the polygon is closed, i.e. last coordinate is a copy of the first coordinate
+ */
+export declare function getS2BoundaryFlat(tokenOrKey: string): Float64Array;
+//# sourceMappingURL=s2-geometry-functions.d.ts.map

package/dist/lib/utils/s2/s2-geometry-functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s2-geometry-functions.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/s2/s2-geometry-functions.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAG7D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CAGlE"}

package/dist/lib/utils/s2/s2-geometry-functions.js

@@ -0,0 +1,29 @@
+"use strict";
+// math.gl, MIT license
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getS2BoundaryFlat = exports.getS2LngLat = void 0;
+const s2_to_boundary_1 = require("./converters/s2-to-boundary");
+const s2_geometry_1 = require("./s2geometry/s2-geometry");
+const s2_cell_utils_1 = require("./s2geometry/s2-cell-utils");
+// GEOMETRY
+/**
+ * Retrieve S2 geometry center
+ * @param s2Token {string} A string that is the cell's hex token
+ * @returns {[number, number]} Longitude and Latitude coordinates of the S2 cell's center
+ */
+function getS2LngLat(s2Token) {
+    const s2cell = (0, s2_cell_utils_1.getS2Cell)(s2Token);
+    return (0, s2_geometry_1.getS2LngLatFromS2Cell)(s2cell);
+}
+exports.getS2LngLat = getS2LngLat;
+/**
+ * Get a polygon with corner coordinates for an s2 cell
+ * @param tokenOrKey {string} A string that is the cell's hex token or the Hilbert quad key (containing /)
+ * @return {Float64Array} - a simple polygon in flat array format: [lng0, lat0, lng1, lat1, ...]
+ *   - the polygon is closed, i.e. last coordinate is a copy of the first coordinate
+ */
+function getS2BoundaryFlat(tokenOrKey) {
+    const s2cell = (0, s2_cell_utils_1.getS2Cell)(tokenOrKey);
+    return (0, s2_to_boundary_1.getS2BoundaryFlatFromS2Cell)(s2cell);
+}
+exports.getS2BoundaryFlat = getS2BoundaryFlat;

package/dist/lib/utils/s2/s2-token-functions.d.ts

@@ -0,0 +1,23 @@
+import Long from 'long';
+/**
+ * Convert the S2 token to the S2 cell ID
+ * @param token {string} A string that is the cell's hex token. Zero cell ID is represented as 'X'.
+ * @returns {Long} Cell id that is a 64-bit encoding of a face and a Hilbert curve parameter on that face.
+ * See {@link https://github.com/google/s2-geometry-library-java/blob/c04b68bf3197a9c34082327eeb3aec7ab7c85da1/src/com/google/common/geometry/S2CellId.java#L439} for more information
+ */
+export declare function getS2CellIdFromToken(token: string): Long;
+/**
+ * Convert the S2 cell ID to the S2 token
+ * @param cellId {Long} A 64-bit encoding of a face and a Hilbert curve parameter on that face.
+ * @returns {string} A string that is the cell's hex token. Zero cell ID is represented as 'X'.
+ */
+export declare function getS2TokenFromCellId(cellId: Long): string;
+/**
+ * Get one of four S2 cell's children.
+ * @param cellId {Long} A 64-bit encoding of a face and a Hilbert curve parameter on that face.
+ * The cell must NOT be a leaf one. So, the cell's level is in the range [0-29].
+ * @param index {number} Child index defines one of four S2 cell's children. Must be in the range [0-3].
+ * @returns The ID of the cell's child.
+ */
+export declare function getS2ChildCellId(cellId: Long, index: number): Long;
+//# sourceMappingURL=s2-token-functions.d.ts.map

package/dist/lib/utils/s2/s2-token-functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s2-token-functions.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/s2/s2-token-functions.ts"],"names":[],"mappings":"AAEA,OAAO,IAAI,MAAM,MAAM,CAAC;AAIxB;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAOxD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,IAAI,GAAG,MAAM,CAezD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAMlE"}

package/dist/lib/utils/s2/s2-token-functions.js

@@ -0,0 +1,68 @@
+"use strict";
+// loaders.gl, MIT license
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getS2ChildCellId = exports.getS2TokenFromCellId = exports.getS2CellIdFromToken = void 0;
+const long_1 = __importDefault(require("long"));
+const MAXIMUM_TOKEN_LENGTH = 16;
+/**
+ * Convert the S2 token to the S2 cell ID
+ * @param token {string} A string that is the cell's hex token. Zero cell ID is represented as 'X'.
+ * @returns {Long} Cell id that is a 64-bit encoding of a face and a Hilbert curve parameter on that face.
+ * See {@link https://github.com/google/s2-geometry-library-java/blob/c04b68bf3197a9c34082327eeb3aec7ab7c85da1/src/com/google/common/geometry/S2CellId.java#L439} for more information
+ */
+function getS2CellIdFromToken(token) {
+    if (token === 'X') {
+        token = '';
+    }
+    // pad token with zeros to make the length 16 that is defined in MAXIMUM_TOKEN_LENGTH
+    const paddedToken = token.padEnd(MAXIMUM_TOKEN_LENGTH, '0');
+    return long_1.default.fromString(paddedToken, true, 16); // Hex base
+}
+exports.getS2CellIdFromToken = getS2CellIdFromToken;
+/**
+ * Convert the S2 cell ID to the S2 token
+ * @param cellId {Long} A 64-bit encoding of a face and a Hilbert curve parameter on that face.
+ * @returns {string} A string that is the cell's hex token. Zero cell ID is represented as 'X'.
+ */
+function getS2TokenFromCellId(cellId) {
+    if (cellId.isZero()) {
+        return 'X';
+    }
+    let numZeroDigits = cellId.countTrailingZeros();
+    const remainder = numZeroDigits % 4;
+    numZeroDigits = (numZeroDigits - remainder) / 4;
+    const trailingZeroHexChars = numZeroDigits;
+    numZeroDigits *= 4;
+    const x = cellId.shiftRightUnsigned(numZeroDigits);
+    const hexString = x.toString(16).replace(/0+$/, '');
+    const zeroString = Array(17 - trailingZeroHexChars - hexString.length).join('0');
+    return zeroString + hexString;
+}
+exports.getS2TokenFromCellId = getS2TokenFromCellId;
+/**
+ * Get one of four S2 cell's children.
+ * @param cellId {Long} A 64-bit encoding of a face and a Hilbert curve parameter on that face.
+ * The cell must NOT be a leaf one. So, the cell's level is in the range [0-29].
+ * @param index {number} Child index defines one of four S2 cell's children. Must be in the range [0-3].
+ * @returns The ID of the cell's child.
+ */
+function getS2ChildCellId(cellId, index) {
+    // Shift sentinel bit 2 positions to the right.
+    const newLsb = lsb(cellId).shiftRightUnsigned(2);
+    // Insert child index before the sentinel bit.
+    const childCellId = cellId.add(long_1.default.fromNumber(2 * index + 1 - 4).multiply(newLsb));
+    return childCellId;
+}
+exports.getS2ChildCellId = getS2ChildCellId;
+/**
+ * Return the lowest-numbered bit that is on for this cell id.
+ * @private
+ * @param cellId {Long} Cell id.
+ * @returns {Long} The lowest-numbered bit that is on for this cell id.
+ */
+function lsb(cellId) {
+    return cellId.and(cellId.not().add(1)); // eslint-disable-line
+}

package/dist/lib/utils/s2/s2geometry/s2-cell-utils.d.ts

@@ -0,0 +1,14 @@
+import type { S2Cell } from './s2-geometry';
+/**
+ * Return the S2Cell from the cell's hex token or the Hilbert quad key
+ * @param tokenOrKey {string} A string that is the cell's hex token or the Hilbert quad key (containing /)
+ * @returns {@link S2Cell}
+ */
+export declare function getS2Cell(tokenOrKey: string): S2Cell;
+/**
+ * Get the underlying Hilbert quad key
+ * @param tokenOrKey {string} A string that is the cell's hex token or the Hilbert quad key (containing /)
+ * @returns Hilbert quad key
+ */
+export declare function getS2QuadKey(tokenOrKey: string): string;
+//# sourceMappingURL=s2-cell-utils.d.ts.map

package/dist/lib/utils/s2/s2geometry/s2-cell-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s2-cell-utils.d.ts","sourceRoot":"","sources":["../../../../../src/lib/utils/s2/s2geometry/s2-cell-utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,eAAe,CAAC;AAM1C;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAQvD"}

package/dist/lib/utils/s2/s2geometry/s2-cell-utils.js

@@ -0,0 +1,32 @@
+"use strict";
+// math.gl, MIT license
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getS2QuadKey = exports.getS2Cell = void 0;
+const s2_geometry_1 = require("./s2-geometry");
+const s2_token_functions_1 = require("../s2-token-functions");
+/**
+ * Return the S2Cell from the cell's hex token or the Hilbert quad key
+ * @param tokenOrKey {string} A string that is the cell's hex token or the Hilbert quad key (containing /)
+ * @returns {@link S2Cell}
+ */
+function getS2Cell(tokenOrKey) {
+    const key = getS2QuadKey(tokenOrKey);
+    const s2cell = (0, s2_geometry_1.getS2CellFromQuadKey)(key);
+    return s2cell;
+}
+exports.getS2Cell = getS2Cell;
+/**
+ * Get the underlying Hilbert quad key
+ * @param tokenOrKey {string} A string that is the cell's hex token or the Hilbert quad key (containing /)
+ * @returns Hilbert quad key
+ */
+function getS2QuadKey(tokenOrKey) {
+    if (tokenOrKey.indexOf('/') > 0) {
+        // is Hilbert quad key
+        return tokenOrKey;
+    }
+    // is S2 cell's hex token
+    const id = (0, s2_token_functions_1.getS2CellIdFromToken)(tokenOrKey);
+    return (0, s2_geometry_1.getS2QuadkeyFromCellId)(id);
+}
+exports.getS2QuadKey = getS2QuadKey;

package/dist/lib/utils/s2/s2geometry/s2-geometry.d.ts

@@ -0,0 +1,52 @@
+import Long from 'long';
+/**
+ * An object describing the S2 cell
+ * @param face {number} Selects one of the six cube faces. The value is in the range [0..5]
+ * @param ij {[number, number]} “i” and “j” are integers in the range [0..2**30-1] that identify the cell.
+ * @param level {number} The number of times the cell has been subdivided (starting with a face cell). The value is in the range [0..30]
+ */
+export type S2Cell = {
+    face: number;
+    ij: [number, number];
+    level: number;
+};
+/**
+ * Return the S2Cell
+ * @param hilbertQuadkey {string} A string that is the Hilbert quad key (containing /)
+ * @returns {@link S2Cell}
+ */
+export declare function getS2CellFromQuadKey(hilbertQuadkey: string): S2Cell;
+/**
+ * Convets S2 cell ID to the Hilbert quad key
+ * @param cellId {Long} Cell id that is a 64-bit encoding of a face and a Hilbert curve parameter on that face
+ * @returns {string} the Hilbert quad key (containing /) as a string in the format 'face/pos', where
+ *  - face is a 10-base representation of the face number
+ *  - pos is a 4-base representation of the position along the Hilbert curve. For example,
+ *    pos == '13' means the following:
+ *       The face is divided two times. After the first time the child cell with position 1 will be selected.
+ *       Then, this cell will be divided the second time, and the child cell with position 3 will be selected.
+ */
+export declare function getS2QuadkeyFromCellId(cellId: Long): string;
+/**
+ * Convets S2 the Hilbert quad key to cell ID.
+ * @param quadkey {string} The Hilbert quad key (containing /) as a string in the format 'face/pos'
+ * @returns {Long} Cell id that is a 64-bit encoding of a face and a Hilbert curve parameter on that face
+ */
+export declare function getS2CellIdFromQuadkey(hilbertQuadkey: string): Long;
+export declare function IJToST(ij: [number, number], level: number, offsets: [number, number]): [number, number];
+export declare function STToUV(st: [number, number]): [number, number];
+export declare function FaceUVToXYZ(face: number, [u, v]: [number, number]): [number, number, number];
+export declare function XYZToLngLat([x, y, z]: [number, number, number]): [number, number];
+/**
+ * Retrieve S2 geometry center
+ * @param s2cell {S2Cell} S2 cell
+ * @returns {[number, number]} Longitude and Latitude coordinates of the S2 cell's center
+ */
+export declare function getS2LngLatFromS2Cell(s2Cell: S2Cell): [number, number];
+/**
+ * Return longitude and latitude of four corners of the cell.
+ * @param s2Cell {S2Cell} S2 cell
+ * @returns {Array<[number, number]>} Array of longitude and latitude pairs (in degrees) for four corners of the cell.
+ */
+export declare function getCornerLngLats(s2Cell: S2Cell): Array<[number, number]>;
+//# sourceMappingURL=s2-geometry.d.ts.map

package/dist/lib/utils/s2/s2geometry/s2-geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s2-geometry.d.ts","sourceRoot":"","sources":["../../../../../src/lib/utils/s2/s2geometry/s2-geometry.ts"],"names":[],"mappings":"AASA,OAAO,IAAI,MAAM,MAAM,CAAC;AAUxB;;;;;GAKG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;GAIG;AAEH,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAwCnE;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,IAAI,GAAG,MAAM,CAyC3D;AAED;;;;GAIG;AAEH,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CA4DnE;AAED,wBAAgB,MAAM,CACpB,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EACpB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GACxB,CAAC,MAAM,EAAE,MAAM,CAAC,CAIlB;AASD,wBAAgB,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAE7D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAiB5F;AAED,wBAAgB,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAKjF;AAeD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAMtE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAiBxE"}