@loaders.gl/tile-converter 4.0.0-alpha.6 → 4.0.0-alpha.8

package/dist/i3s-converter/helpers/load-3d-tiles.d.ts

@@ -0,0 +1,18 @@
+import type { Tiles3DLoaderOptions, Tiles3DTileContent, Tiles3DTileJSONPostprocessed, Tiles3DTilesetJSONPostprocessed } from '@loaders.gl/3d-tiles';
+/**
+ * Load nested 3DTiles tileset. If the sourceTile is not nested tileset - do nothing
+ * @param sourceTileset - source root tileset JSON
+ * @param sourceTile - source tile JSON that is supposed to has link to nested tileset
+ * @param tilesetLoadOptions - load options for Tiles3DLoader
+ * @returns nothing
+ */
+export declare const loadNestedTileset: (sourceTileset: Tiles3DTilesetJSONPostprocessed | null, sourceTile: Tiles3DTileJSONPostprocessed, tilesetLoadOptions: Tiles3DLoaderOptions) => Promise<void>;
+/**
+ * Load 3DTiles tile content, that includes glTF object
+ * @param sourceTileset - source root tileset JSON
+ * @param sourceTile - source tile JSON that has link to content data
+ * @param tilesetLoadOptions - load options for Tiles3DLoader
+ * @returns - 3DTiles tile content or null
+ */
+export declare const loadTile3DContent: (sourceTileset: Tiles3DTilesetJSONPostprocessed | null, sourceTile: Tiles3DTileJSONPostprocessed, tilesetLoadOptions: Tiles3DLoaderOptions) => Promise<Tiles3DTileContent | null>;
+//# sourceMappingURL=load-3d-tiles.d.ts.map

package/dist/i3s-converter/helpers/load-3d-tiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-3d-tiles.d.ts","sourceRoot":"","sources":["../../../src/i3s-converter/helpers/load-3d-tiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,4BAA4B,EAC5B,+BAA+B,EAChC,MAAM,sBAAsB,CAAC;AAG9B;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,kBACb,+BAA+B,GAAG,IAAI,cACzC,4BAA4B,sBACpB,oBAAoB,KACvC,QAAQ,IAAI,CAkBd,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,kBACb,+BAA+B,GAAG,IAAI,cACzC,4BAA4B,sBACpB,oBAAoB,KACvC,QAAQ,kBAAkB,GAAG,IAAI,CAiBnC,CAAC"}

package/dist/i3s-converter/helpers/load-3d-tiles.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadTile3DContent = exports.loadNestedTileset = void 0;
+const core_1 = require("@loaders.gl/core");
+/**
+ * Load nested 3DTiles tileset. If the sourceTile is not nested tileset - do nothing
+ * @param sourceTileset - source root tileset JSON
+ * @param sourceTile - source tile JSON that is supposed to has link to nested tileset
+ * @param tilesetLoadOptions - load options for Tiles3DLoader
+ * @returns nothing
+ */
+const loadNestedTileset = async (sourceTileset, sourceTile, tilesetLoadOptions) => {
+    const isTileset = sourceTile.type === 'json';
+    if (!sourceTileset || !sourceTile.contentUrl || !isTileset) {
+        return;
+    }
+    const loadOptions = {
+        ...tilesetLoadOptions,
+        [sourceTileset.loader.id]: {
+            isTileset,
+            assetGltfUpAxis: (sourceTileset.asset && sourceTileset.asset.gltfUpAxis) || 'Y'
+        }
+    };
+    const tileContent = await (0, core_1.load)(sourceTile.contentUrl, sourceTileset.loader, loadOptions);
+    if (tileContent.root) {
+        sourceTile.children = [tileContent.root];
+    }
+};
+exports.loadNestedTileset = loadNestedTileset;
+/**
+ * Load 3DTiles tile content, that includes glTF object
+ * @param sourceTileset - source root tileset JSON
+ * @param sourceTile - source tile JSON that has link to content data
+ * @param tilesetLoadOptions - load options for Tiles3DLoader
+ * @returns - 3DTiles tile content or null
+ */
+const loadTile3DContent = async (sourceTileset, sourceTile, tilesetLoadOptions) => {
+    const isTileset = sourceTile.type === 'json';
+    if (!sourceTileset || !sourceTile.contentUrl || isTileset) {
+        return null;
+    }
+    const loadOptions = {
+        ...tilesetLoadOptions,
+        [sourceTileset.loader.id]: {
+            ...(tilesetLoadOptions[sourceTileset.loader.id] || {}),
+            isTileset,
+            assetGltfUpAxis: (sourceTileset.asset && sourceTileset.asset.gltfUpAxis) || 'Y'
+        }
+    };
+    const tileContent = await (0, core_1.load)(sourceTile.contentUrl, sourceTileset.loader, loadOptions);
+    return tileContent;
+};
+exports.loadTile3DContent = loadTile3DContent;

package/dist/i3s-converter/helpers/node-index-document.d.ts

@@ -18,6 +18,12 @@ export declare class NodeIndexDocument {
     children: NodeIndexDocument[];
     /** converter instance */
     private converter;
+    /**
+     * Finalized property. It means that all child nodes are saved and their data
+     * is unloaded
+     */
+    private _finalized;
+    get finalized(): boolean;
     /**
      * Constructor
      * @param id - id of the node in node pages
@@ -41,6 +47,8 @@ export declare class NodeIndexDocument {
     addNeighbors(): Promise<void>;
     /** Save 3DNodeIndexDocument in file on disk */
     save(): Promise<void>;
+    /** Finalize the node */
+    private finalize;
     /**
      * Write 3DNodeIndexDocument https://github.com/Esri/i3s-spec/blob/master/docs/1.7/3DNodeIndexDocument.cmn.md
      * @param node - Node3DIndexDocument object

package/dist/i3s-converter/helpers/node-index-document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-index-document.d.ts","sourceRoot":"","sources":["../../../src/i3s-converter/helpers/node-index-document.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,UAAU,EAEX,MAAM,iBAAiB,CAAC;AAIzB,OAAO,YAAY,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAC,qBAAqB,EAAC,MAAM,UAAU,CAAC;AAE/C;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,cAAc;IACP,EAAE,EAAE,MAAM,CAAC;IAClB,uBAAuB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACxB,+BAA+B;IACxB,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAAQ;IAC/C,eAAe;IACR,QAAQ,EAAE,iBAAiB,EAAE,CAAM;IAC1C,yBAAyB;IACzB,OAAO,CAAC,SAAS,CAAe;IAEhC;;;;OAIG;gBACS,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY;IAM/C;;;;OAIG;IACU,OAAO,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAS3E;;;OAGG;IACU,WAAW,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BxE;;OAEG;IACU,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC1C,+CAA+C;IAClC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMlC;;;OAGG;YACW,KAAK;IAyBnB;;;OAGG;YACW,IAAI;IAalB;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;;;;OAKG;WACU,cAAc,CACzB,eAAe,EAAE,eAAe,EAChC,SAAS,EAAE,YAAY,GACtB,OAAO,CAAC,iBAAiB,CAAC;IAM7B;;;;;;;;;OASG;WACU,UAAU,CACrB,UAAU,EAAE,iBAAiB,EAC7B,eAAe,EAAE,eAAe,EAChC,YAAY,EAAE,YAAY,EAAE,EAC5B,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,qBAAqB,EAChC,SAAS,EAAE,YAAY,GACtB,OAAO,CAAC,iBAAiB,CAAC;IAY7B;;;;OAIG;IACH,MAAM,CAAC,2BAA2B,CAAC,eAAe,EAAE,eAAe,GAAG,mBAAmB;IAqBzF;;;;;;;;;;OAUG;WACU,uBAAuB,CAClC,UAAU,EAAE,iBAAiB,EAC7B,eAAe,EAAE,eAAe,EAChC,YAAY,EAAE,YAAY,EAAE,EAC5B,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,qBAAqB,GAC/B,OAAO,CAAC,mBAAmB,CAAC;CA4ChC"}
+{"version":3,"file":"node-index-document.d.ts","sourceRoot":"","sources":["../../../src/i3s-converter/helpers/node-index-document.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,UAAU,EAEX,MAAM,iBAAiB,CAAC;AAIzB,OAAO,YAAY,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAC,qBAAqB,EAAC,MAAM,UAAU,CAAC;AAE/C;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,cAAc;IACP,EAAE,EAAE,MAAM,CAAC;IAClB,uBAAuB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACxB,+BAA+B;IACxB,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAAQ;IAC/C,eAAe;IACR,QAAQ,EAAE,iBAAiB,EAAE,CAAM;IAC1C,yBAAyB;IACzB,OAAO,CAAC,SAAS,CAAe;IAEhC;;;OAGG;IACH,OAAO,CAAC,UAAU,CAAkB;IACpC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;;;OAIG;gBACS,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY;IAM/C;;;;OAIG;IACU,OAAO,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAS3E;;;OAGG;IACU,WAAW,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BxE;;OAEG;IACU,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAmC1C,+CAA+C;IAClC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMlC,wBAAwB;IACxB,OAAO,CAAC,QAAQ;IAOhB;;;OAGG;YACW,KAAK;IAyBnB;;;OAGG;YACW,IAAI;IAalB;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;;;;OAKG;WACU,cAAc,CACzB,eAAe,EAAE,eAAe,EAChC,SAAS,EAAE,YAAY,GACtB,OAAO,CAAC,iBAAiB,CAAC;IAM7B;;;;;;;;;OASG;WACU,UAAU,CACrB,UAAU,EAAE,iBAAiB,EAC7B,eAAe,EAAE,eAAe,EAChC,YAAY,EAAE,YAAY,EAAE,EAC5B,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,qBAAqB,EAChC,SAAS,EAAE,YAAY,GACtB,OAAO,CAAC,iBAAiB,CAAC;IAY7B;;;;OAIG;IACH,MAAM,CAAC,2BAA2B,CAAC,eAAe,EAAE,eAAe,GAAG,mBAAmB;IAqBzF;;;;;;;;;;OAUG;WACU,uBAAuB,CAClC,UAAU,EAAE,iBAAiB,EAC7B,eAAe,EAAE,eAAe,EAChC,YAAY,EAAE,YAAY,EAAE,EAC5B,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,qBAAqB,GAC/B,OAAO,CAAC,mBAAmB,CAAC;CA4ChC"}

package/dist/i3s-converter/helpers/node-index-document.js

@@ -16,6 +16,9 @@ const node_1 = require("../json-templates/node");
  * on disk: the data is written on disk in a file. The file can be rewritten when new childrend or neighbors have to be added
  */
 class NodeIndexDocument {
+    get finalized() {
+        return this._finalized;
+    }
     /**
      * Constructor
      * @param id - id of the node in node pages
@@ -26,6 +29,11 @@ class NodeIndexDocument {
         this.data = null;
         /** children */
         this.children = [];
+        /**
+         * Finalized property. It means that all child nodes are saved and their data
+         * is unloaded
+         */
+        this._finalized = false;
         this.inPageId = id;
         this.id = id === 0 ? 'root' : id.toString();
         this.converter = converter;
@@ -76,6 +84,9 @@ class NodeIndexDocument {
      * Add neighbors to child nodes of this node
      */
     async addNeighbors() {
+        if (this.finalized) {
+            return;
+        }
         const nodeData = await this.load();
         for (const childNode of this.children) {
             const childNodeData = await childNode.load();
@@ -98,9 +109,9 @@ class NodeIndexDocument {
                 await childNode.write(childNodeData);
             }
             await childNode.save();
-            // The save after adding neighbors is the last one. Flush the the node
-            childNode.flush();
         }
+        // The save after adding neighbors is the last one. Finalize the the node
+        this.finalize();
     }
     /** Save 3DNodeIndexDocument in file on disk */
     async save() {
@@ -108,6 +119,13 @@ class NodeIndexDocument {
             await this.write(this.data);
         }
     }
+    /** Finalize the node */
+    finalize() {
+        this._finalized = true;
+        for (const child of this.children) {
+            child.flush();
+        }
+    }
     /**
      * Write 3DNodeIndexDocument https://github.com/Esri/i3s-spec/blob/master/docs/1.7/3DNodeIndexDocument.cmn.md
      * @param node - Node3DIndexDocument object

package/dist/i3s-converter/helpers/node-pages.js

@@ -11,7 +11,7 @@ const file_utils_1 = require("../../lib/utils/file-utils");
  * class NodePages - wrapper of nodePages array
  *
  * @example
- * import {writeFile} from './helpers/write-file.js';
+ * import {writeFile} from './helpers/write-file';
  *
  * // create an instance of the class
  * const nodePages = new NodePages(writeFile, HARDCODED_NODES_PER_PAGE);

package/dist/i3s-converter/helpers/preprocess-3d-tiles.d.ts

@@ -0,0 +1,23 @@
+import { Tiles3DTileContent, Tiles3DTileJSONPostprocessed } from '@loaders.gl/3d-tiles';
+import { GltfPrimitiveModeString, PreprocessData } from '../types';
+/**
+ * glTF primitive modes
+ * @see https://registry.khronos.org/glTF/specs/2.0/glTF-2.0.html#_mesh_primitive_mode
+ */
+export declare const GLTF_PRIMITIVE_MODES: GltfPrimitiveModeString[];
+/**
+ * Analyze tile content. This function is used during preprocess stage of
+ * conversion
+ * @param tile - 3DTiles tile JSON metadata
+ * @param tileContent - 3DTiles tile content ArrayBuffer
+ * @returns
+ */
+export declare const analyzeTileContent: (tile: Tiles3DTileJSONPostprocessed, tileContent: Tiles3DTileContent | null) => Promise<PreprocessData>;
+/**
+ * Merge object2 into object1
+ * @param object1
+ * @param object2
+ * @returns nothing
+ */
+export declare const mergePreprocessData: (object1: PreprocessData, object2: PreprocessData) => void;
+//# sourceMappingURL=preprocess-3d-tiles.d.ts.map

package/dist/i3s-converter/helpers/preprocess-3d-tiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preprocess-3d-tiles.d.ts","sourceRoot":"","sources":["../../../src/i3s-converter/helpers/preprocess-3d-tiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAE,4BAA4B,EAAC,MAAM,sBAAsB,CAAC;AACtF,OAAO,EAAC,uBAAuB,EAAE,cAAc,EAAC,MAAM,UAAU,CAAC;AAIjE;;;GAGG;AACH,eAAO,MAAM,oBAAoB,2BAQhC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,SACvB,4BAA4B,eACrB,kBAAkB,GAAG,IAAI,KACrC,QAAQ,cAAc,CAmBxB,CAAC;AAqBF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,YAAa,cAAc,WAAW,cAAc,KAAG,IAKtF,CAAC"}

package/dist/i3s-converter/helpers/preprocess-3d-tiles.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergePreprocessData = exports.analyzeTileContent = exports.GLTF_PRIMITIVE_MODES = void 0;
+const types_1 = require("../types");
+const gltf_1 = require("@loaders.gl/gltf");
+const core_1 = require("@loaders.gl/core");
+/**
+ * glTF primitive modes
+ * @see https://registry.khronos.org/glTF/specs/2.0/glTF-2.0.html#_mesh_primitive_mode
+ */
+exports.GLTF_PRIMITIVE_MODES = [
+    types_1.GltfPrimitiveModeString.POINTS,
+    types_1.GltfPrimitiveModeString.LINES,
+    types_1.GltfPrimitiveModeString.LINE_LOOP,
+    types_1.GltfPrimitiveModeString.LINE_STRIP,
+    types_1.GltfPrimitiveModeString.TRIANGLES,
+    types_1.GltfPrimitiveModeString.TRIANGLE_STRIP,
+    types_1.GltfPrimitiveModeString.TRIANGLE_FAN // 6
+];
+/**
+ * Analyze tile content. This function is used during preprocess stage of
+ * conversion
+ * @param tile - 3DTiles tile JSON metadata
+ * @param tileContent - 3DTiles tile content ArrayBuffer
+ * @returns
+ */
+const analyzeTileContent = async (tile, tileContent) => {
+    const result = {
+        meshTopologyTypes: new Set()
+    };
+    if (!tileContent?.gltfArrayBuffer) {
+        return result;
+    }
+    const gltfData = await (0, core_1.parse)(tileContent.gltfArrayBuffer, gltf_1.GLTFLoader, {
+        gltf: { normalize: false, loadBuffers: false, loadImages: false, decompressMeshes: false }
+    });
+    const gltf = gltfData.json;
+    if (!gltf) {
+        return result;
+    }
+    const meshTypes = getMeshTypesFromGltf(gltf);
+    result.meshTopologyTypes = meshTypes;
+    return result;
+};
+exports.analyzeTileContent = analyzeTileContent;
+/**
+ * Get mesh topology types that the glb content has
+ * @param gltfJson - JSON part of GLB content
+ * @returns array of mesh types found
+ */
+const getMeshTypesFromGltf = (gltfJson) => {
+    const result = new Set();
+    for (const mesh of gltfJson.meshes || []) {
+        for (const primitive of mesh.primitives) {
+            let { mode } = primitive;
+            if (typeof mode !== 'number') {
+                mode = 4; // Default is 4 - TRIANGLES
+            }
+            result.add(exports.GLTF_PRIMITIVE_MODES[mode]);
+        }
+    }
+    return result;
+};
+/**
+ * Merge object2 into object1
+ * @param object1
+ * @param object2
+ * @returns nothing
+ */
+const mergePreprocessData = (object1, object2) => {
+    // Merge topology mesh types info
+    for (const type of object2.meshTopologyTypes) {
+        object1.meshTopologyTypes.add(type);
+    }
+};
+exports.mergePreprocessData = mergePreprocessData;

package/dist/i3s-converter/helpers/tileset-traversal.d.ts

@@ -0,0 +1,25 @@
+import { Tiles3DTileJSONPostprocessed } from '@loaders.gl/3d-tiles';
+import { NodeIndexDocument } from './node-index-document';
+import { Matrix4 } from '@math.gl/core';
+/** Traversal props for the conversion stage */
+export type TraversalConversionProps = {
+    /** Transformation matrix for the specific tile */
+    transform: Matrix4;
+    /** Parent nodes of the converted tile. Multiple nodes can be if one tile is converted to multiple nodes*/
+    parentNodes: NodeIndexDocument[];
+};
+/**
+ * Travesal of 3DTile tiles tree with making specific actions with each tile
+ * @param tile - 3DTiles tile JSON metadata
+ * @param traversalProps - traversal props used to pass data through recursive calls
+ * @param processTile - callback to make some actions with the current tile
+ * @param postprocessTile - callback to make some action after processing of the current tile and all the subtree
+ * @param maxDepth - max recursive calls number the travesal function will do. If not set, the traversal function will
+ *                   go through all the tree.
+ *                   This value is used to limit the convertion with only partial number of levels of the tileset
+ * @param level - counter to keep recursive calls number of the tiles tree. This value used to be able to break
+ *                traversal at the some level of the tree
+ * @returns void
+ */
+export declare const traverseDatasetWith: <TProps>(tile: Tiles3DTileJSONPostprocessed, traversalProps: TProps, processTile: (tile: Tiles3DTileJSONPostprocessed, traversalProps: TProps) => Promise<TProps>, postprocessTile?: ((processResults: TProps[], currentTraversalProps: TProps) => Promise<void>) | undefined, maxDepth?: number, level?: number) => Promise<void>;
+//# sourceMappingURL=tileset-traversal.d.ts.map

package/dist/i3s-converter/helpers/tileset-traversal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tileset-traversal.d.ts","sourceRoot":"","sources":["../../../src/i3s-converter/helpers/tileset-traversal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,4BAA4B,EAAC,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAC,iBAAiB,EAAC,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAC,OAAO,EAAC,MAAM,eAAe,CAAC;AAEtC,+CAA+C;AAC/C,MAAM,MAAM,wBAAwB,GAAG;IACrC,kDAAkD;IAClD,SAAS,EAAE,OAAO,CAAC;IACnB,0GAA0G;IAC1G,WAAW,EAAE,iBAAiB,EAAE,CAAC;CAClC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB,iBACxB,4BAA4B,8CAEd,4BAA4B,8HAC+B,QAAQ,IAAI,CAAC,0BACjF,MAAM,qBAEhB,QAAQ,IAAI,CAkBd,CAAC"}

package/dist/i3s-converter/helpers/tileset-traversal.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.traverseDatasetWith = void 0;
+/**
+ * Travesal of 3DTile tiles tree with making specific actions with each tile
+ * @param tile - 3DTiles tile JSON metadata
+ * @param traversalProps - traversal props used to pass data through recursive calls
+ * @param processTile - callback to make some actions with the current tile
+ * @param postprocessTile - callback to make some action after processing of the current tile and all the subtree
+ * @param maxDepth - max recursive calls number the travesal function will do. If not set, the traversal function will
+ *                   go through all the tree.
+ *                   This value is used to limit the convertion with only partial number of levels of the tileset
+ * @param level - counter to keep recursive calls number of the tiles tree. This value used to be able to break
+ *                traversal at the some level of the tree
+ * @returns void
+ */
+const traverseDatasetWith = async (tile, traversalProps, processTile, postprocessTile, maxDepth, level = 0) => {
+    if (maxDepth && level > maxDepth) {
+        return;
+    }
+    const processResults = [];
+    const newTraversalProps = await processTile(tile, traversalProps);
+    processResults.push(newTraversalProps);
+    for (const childTile of tile.children) {
+        await (0, exports.traverseDatasetWith)(childTile, newTraversalProps, processTile, postprocessTile, maxDepth, level + 1);
+    }
+    postprocessTile && (await postprocessTile(processResults, traversalProps));
+};
+exports.traverseDatasetWith = traverseDatasetWith;

package/dist/i3s-converter/i3s-converter.d.ts

@@ -1,10 +1,11 @@
+import type { Tiles3DLoaderOptions, Tiles3DTilesetJSONPostprocessed } from '@loaders.gl/3d-tiles';
 import type { WriteQueueItem } from '../lib/utils/write-queue';
 import type { SceneLayer3D } from '@loaders.gl/i3s';
-import { Tileset3D } from '@loaders.gl/tiles';
 import { Geoid } from '@math.gl/geoid';
 import NodePages from './helpers/node-pages';
 import { LoaderWithParser } from '@loaders.gl/loader-utils';
-import { I3SMaterialDefinition } from '@loaders.gl/i3s/src/types';
+import { I3SMaterialDefinition } from '@loaders.gl/i3s';
+import { PreprocessData } from './types';
 import WriteQueue from '../lib/utils/write-queue';
 /**
  * Converter from 3d-tiles tileset to i3s layer
@@ -31,7 +32,8 @@ export default class I3SConverter {
     boundingVolumeWarnings?: string[];
     conversionStartTime: [number, number];
     refreshTokenTime: [number, number];
-    sourceTileset: Tileset3D | null;
+    sourceTileset: Tiles3DTilesetJSONPostprocessed | null;
+    loadOptions: Tiles3DLoaderOptions;
     geoidHeightModel: Geoid | null;
     Loader: LoaderWithParser;
     generateTextures: boolean;
@@ -42,6 +44,7 @@ export default class I3SConverter {
     };
     writeQueue: WriteQueue<WriteQueueItem>;
     compressList: string[] | null;
+    preprocessData: PreprocessData;
     constructor();
     /**
      * Convert a 3d tileset
@@ -75,7 +78,20 @@ export default class I3SConverter {
         generateTextures?: boolean;
         generateBoundingVolumes?: boolean;
         instantNodeWriting?: boolean;
-    }): Promise<any>;
+    }): Promise<string>;
+    /**
+     * Preprocess stage of the tile converter. Traverse all the tiles tree and
+     * check a tile content to be sure that the data is supported
+     * @returns true - the conversion is possible, false - the tileset's content is not supported
+     */
+    private preprocessConversion;
+    /**
+     * Analyze a tile content. The callback for preprocess stage.
+     * @param sourceTile - 3DTiles tile JSON metadata
+     * @param traversalProps - mandatory argument but it is not used for the preprocess stage
+     * @returns - nothing
+     */
+    private analyzeTile;
     /**
      * Convert and save the layer and embedded tiles
      * @param outputPath - path to save output data
@@ -84,15 +100,11 @@ export default class I3SConverter {
     private _createAndSaveTileset;
     /**
      * Form object of 3DSceneLayer https://github.com/Esri/i3s-spec/blob/master/docs/1.7/3DSceneLayer.cmn.md
-     * @param  tilesetName - Name of layer
+     * @param tilesetName - Name of layer
+     * @param sourceBoundingVolume - initialized bounding volume of the source root tile
+     * @param boundingVolumeRegion - region bounding volume of the source root tile
      */
     private _formLayers0;
-    /**
-     * Form object of 3DSceneLayer https://github.com/Esri/i3s-spec/blob/master/docs/1.7/3DSceneLayer.cmn.md
-     * @param rootNode - 3DNodeIndexDocument of root node https://github.com/Esri/i3s-spec/blob/master/docs/1.7/3DNodeIndexDocument.cmn.md
-     * @param sourceRootTile - Source (3DTile) tile data
-     */
-    private _convertNodesTree;
     /**
      * Write 3DSceneLayer https://github.com/Esri/i3s-spec/blob/master/docs/1.7/3DSceneLayer.cmn.md in file
      */
@@ -103,47 +115,35 @@ export default class I3SConverter {
      */
     private _createSlpk;
     /**
-     * Add child nodes recursively and write them to files
-     * @param data - arguments
-     * @param data.parentNode - 3DNodeIndexDocument of parent node
-     * @param data.sourceTiles - array of source child nodes
-     * @param data.level - level of node (distanse to root node in the tree)
-     */
-    private _addChildrenWithNeighborsAndWriteFile;
-    /**
-     * Convert nested subtree of 3DTiles dataset
-     * @param param0
-     * @param data.parentNode - 3DNodeIndexDocument of parent node
-     * @param param0.sourceTile - source 3DTile data
-     * @param param0.level - tree level
-     */
-    private convertNestedTileset;
-    /**
-     * Convert 3DTiles tile to I3S node
-     * @param param0
-     * @param param0.parentNode - 3DNodeIndexDocument of parent node
-     * @param param0.sourceTile - source 3DTile data
-     * @param param0.level - tree level
+     * Convert the specific 3DTiles tile to I3S nodes.
+     * This is callback function for the traversal generic function
+     * @param sourceTile - current 3DTiles tile JSON metadata
+     * @param traversalProps - traversal properties calculated recursively
+     * @returns - traversal properties for the child tiles
      */
-    private convertNode;
+    private convertTile;
     /**
-     * Add child nodes recursively and write them to files
-     * @param param0 - arguments
-     * @param param0.parentNode - 3DNodeIndexDocument of parent node
-     * @param param0.sourceTile - source 3DTile data
-     * @param param0.level - tree level
+     * Do final action with nodes after the current node and all child nodes been converted.
+     * @param conversionResults - array of conversion results of the current node
+     * @param currentTraversalProps - traversal properties of the current node
      */
-    private _addChildren;
+    private finalizeTile;
     /**
      * Convert tile to one or more I3S nodes
      * @param parentNode - 3DNodeIndexDocument of parent node
      * @param sourceTile - source 3DTile data
+     * @param transformationMatrix - transformation matrix of the current tile, calculated recursively multiplying
+     *                               transform of all parent tiles and transform of the current tile
      * @param level - tree level
      */
     private _createNode;
     /**
      * Convert tile to one or more I3S nodes
      * @param sourceTile - source tile (3DTile)
+     * @param transformationMatrix - transformation matrix of the current tile, calculated recursively multiplying
+     *                               transform of all parent tiles and transform of the current tile
+     * @param boundingVolume - initialized bounding volume of the source tile
+     * @param tileContent - content of the source tile
      * @param parentId - id of parent node in node pages
      * @param propertyTable - batch table from b3dm / feature properties from EXT_FEATURE_METADATA
      * @returns - converted node resources
@@ -258,7 +258,7 @@ export default class I3SConverter {
     private _checkAddRefinementTypeForTile;
     /**
      * Check if the tile's content format is supported by the converter
-     * @param sourceRootTile
+     * @param sourceTile
      * @returns
      */
     private isContentSupported;

package/dist/i3s-converter/i3s-converter.d.ts.map

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