@loaders.gl/tile-converter 4.0.0-alpha.7 → 4.0.0-alpha.9

package/dist/lib/utils/lod-conversion-utils.d.ts

@@ -1,3 +1,4 @@
+import { Tiles3DTileJSONPostprocessed } from '@loaders.gl/3d-tiles';
 import { BoundingVolumes } from '@loaders.gl/i3s';
 import { Tile3D } from '@loaders.gl/tiles';
 /**
@@ -13,7 +14,7 @@ import { Tile3D } from '@loaders.gl/tiles';
  * To avoid infinity values when we do calculations of maxError we shold replace 0 with value which allows us
  * to make child maxError bigger than his parent maxError.
  *
- * @param tile - 3d-tiles tile Object
+ * @param tile - 3d-tiles tile JSON
  * @param coordinates - node converted coordinates
  * @returns An array of LOD metrics in format compatible with i3s 3DNodeIndexDocument.lodSelection
  * @example
@@ -28,7 +29,7 @@ import { Tile3D } from '@loaders.gl/tiles';
         }
     ]
  */
-export declare function convertGeometricErrorToScreenThreshold(tile: Tile3D, coordinates: BoundingVolumes): {
+export declare function convertGeometricErrorToScreenThreshold(tile: Tiles3DTileJSONPostprocessed, coordinates: BoundingVolumes): {
     metricType: string;
     maxError: number;
 }[];

package/dist/lib/utils/lod-conversion-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lod-conversion-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/lod-conversion-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAC,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAC,MAAM,EAAC,MAAM,mBAAmB,CAAC;AAIzC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,sCAAsC,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe;gBAC9D,MAAM;cAAY,MAAM;IAqB1D;AAED;;;;GAIG;AACH,wBAAgB,sCAAsC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAe3E"}
+{"version":3,"file":"lod-conversion-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/lod-conversion-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,4BAA4B,EAAC,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAC,eAAe,EAAC,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAC,MAAM,EAAC,MAAM,mBAAmB,CAAC;AAIzC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,sCAAsC,CACpD,IAAI,EAAE,4BAA4B,EAClC,WAAW,EAAE,eAAe;gBAEK,MAAM;cAAY,MAAM;IAqB1D;AAED;;;;GAIG;AACH,wBAAgB,sCAAsC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAe3E"}

package/dist/lib/utils/lod-conversion-utils.js

@@ -16,7 +16,7 @@ const DEFAULT_MAXIMUM_SCREEN_SPACE_ERROR = 16;
  * To avoid infinity values when we do calculations of maxError we shold replace 0 with value which allows us
  * to make child maxError bigger than his parent maxError.
  *
- * @param tile - 3d-tiles tile Object
+ * @param tile - 3d-tiles tile JSON
  * @param coordinates - node converted coordinates
  * @returns An array of LOD metrics in format compatible with i3s 3DNodeIndexDocument.lodSelection
  * @example

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loaders.gl/tile-converter",
-  "version": "4.0.0-alpha.7",
+  "version": "4.0.0-alpha.9",
   "description": "Converter",
   "license": "MIT",
   "publishConfig": {
@@ -44,18 +44,18 @@
     "build-3d-tiles-attributes-worker": "esbuild src/workers/3d-tiles-attributes-worker.ts --outfile=dist/3d-tiles-attributes-worker.js --platform=node --target=esnext,node14 --external:join-images --minify --bundle --sourcemap --define:__VERSION__=\\\"$npm_package_version\\\""
   },
   "dependencies": {
-    "@loaders.gl/3d-tiles": "4.0.0-alpha.7",
-    "@loaders.gl/crypto": "4.0.0-alpha.7",
-    "@loaders.gl/draco": "4.0.0-alpha.7",
-    "@loaders.gl/gltf": "4.0.0-alpha.7",
-    "@loaders.gl/i3s": "4.0.0-alpha.7",
-    "@loaders.gl/images": "4.0.0-alpha.7",
-    "@loaders.gl/loader-utils": "4.0.0-alpha.7",
-    "@loaders.gl/polyfills": "4.0.0-alpha.7",
-    "@loaders.gl/textures": "4.0.0-alpha.7",
-    "@loaders.gl/tiles": "4.0.0-alpha.7",
-    "@loaders.gl/worker-utils": "4.0.0-alpha.7",
-    "@loaders.gl/zip": "4.0.0-alpha.7",
+    "@loaders.gl/3d-tiles": "4.0.0-alpha.9",
+    "@loaders.gl/crypto": "4.0.0-alpha.9",
+    "@loaders.gl/draco": "4.0.0-alpha.9",
+    "@loaders.gl/gltf": "4.0.0-alpha.9",
+    "@loaders.gl/i3s": "4.0.0-alpha.9",
+    "@loaders.gl/images": "4.0.0-alpha.9",
+    "@loaders.gl/loader-utils": "4.0.0-alpha.9",
+    "@loaders.gl/polyfills": "4.0.0-alpha.9",
+    "@loaders.gl/textures": "4.0.0-alpha.9",
+    "@loaders.gl/tiles": "4.0.0-alpha.9",
+    "@loaders.gl/worker-utils": "4.0.0-alpha.9",
+    "@loaders.gl/zip": "4.0.0-alpha.9",
     "@math.gl/core": "^3.5.1",
     "@math.gl/culling": "^3.5.1",
     "@math.gl/geoid": "^3.5.1",
@@ -72,11 +72,11 @@
     "uuid": "^8.1.0"
   },
   "peerDependencies": {
-    "@loaders.gl/core": "4.0.0-alpha.6"
+    "@loaders.gl/core": "^4.0.0-alpha.8"
   },
   "quarantinedDependencies": {
     "join-images": "^1.1.3",
     "sharp": "^0.31.3"
   },
-  "gitHead": "afb59c4d8e5d8ebb9c28f111cb0c96c5527d0ffd"
+  "gitHead": "03ff81ab468f20f3bddeec787aa88d477a7e1c72"
 }

package/src/3d-tiles-converter/3d-tiles-converter.ts

@@ -1,5 +1,5 @@
 import type {AttributeStorageInfo, FeatureAttribute, NodeReference} from '@loaders.gl/i3s';
-import type {Node3D} from '@loaders.gl/3d-tiles';
+import type {Tiles3DTileJSON} from '@loaders.gl/3d-tiles';
 
 import {join} from 'path';
 import process from 'process';
@@ -109,7 +109,7 @@ export default class Tiles3DConverter {
       // do nothing
     }
 
-    const rootTile: Node3D = {
+    const rootTile: Tiles3DTileJSON = {
       boundingVolume: {
         box: i3sObbTo3dTilesObb(rootNode.header.obb, this.geoidHeightModel)
       },
@@ -138,7 +138,7 @@ export default class Tiles3DConverter {
    */
   private async convertChildNode(
     parentSourceNode: Tile3D,
-    parentNode: Node3D,
+    parentNode: Tiles3DTileJSON,
     level: number,
     childNodeInfo: NodeReference
   ): Promise<void> {
@@ -160,7 +160,7 @@ export default class Tiles3DConverter {
       const boundingVolume = {
         box: i3sObbTo3dTilesObb(sourceChild.header.obb, this.geoidHeightModel)
       };
-      const child: Node3D = {
+      const child: Tiles3DTileJSON = {
         boundingVolume,
         geometricError: convertScreenThresholdToGeometricError(sourceChild),
         children: []
@@ -198,7 +198,7 @@ export default class Tiles3DConverter {
    */
   private async _addChildren(
     parentSourceNode: Tile3D,
-    parentNode: Node3D,
+    parentNode: Tiles3DTileJSON,
     level: number
   ): Promise<void> {
     if (this.options.maxDepth && level > this.options.maxDepth) {

package/src/deps-installer/deps-installer.ts

@@ -50,8 +50,9 @@ export class DepsInstaller {
       // `npm install sharp join-images` works unstable. It fails because installed `sharp` version
       // may be different from the version required by `join-images`. Pointing to specific versions
       // resolve this issue
-      arguments: ['install', 'sharp@^0.30.4', 'join-images@^1.1.3'],
-      wait: 0
+      arguments: ['install', 'sharp@0.30.4', 'join-images@1.1.3'],
+      wait: 0,
+      ignoreStderr: true
     });
 
     console.log('All dependencies were installed succesfully.'); // eslint-disable-line no-console

package/src/i3s-converter/helpers/batch-ids-extensions.ts

@@ -97,12 +97,9 @@ function handleExtFeatureMetadataExtension(
   const featureTexture =
     extFeatureMetadata?.featureTextures && extFeatureMetadata?.featureTextures[0];
 
-  /**
-   * TODO need to get batchIds from root extension
-   */
   if (featureTexture) {
-    console.warn("EXT_feature_metadata doesn't yet support featureTextures in primitive");
-    return [];
+    const batchIdsAttribute = attributes[featureTexture];
+    return batchIdsAttribute.value;
   }
 
   return [];

package/src/i3s-converter/helpers/coordinate-converter.ts

@@ -8,34 +8,35 @@ import {
   makeBoundingSphereFromPoints,
   BoundingSphere
 } from '@math.gl/culling';
-import {Tile3D} from '@loaders.gl/tiles';
 import {Geoid} from '@math.gl/geoid';
 
 /**
  * Create bounding volumes object from tile and geoid height model.
- * @param tile
- * @param geoidHeightModel
+ * @param sourceBoundingVolume - initialized bounding volume of the source tile
+ * @param geoidHeightModel - instance of Geoid class that converts elevation from geoidal to ellipsoidal and back
  * @returns - Bounding volumes object
  */
-export function createBoundingVolumes(tile: Tile3D, geoidHeightModel: Geoid): BoundingVolumes {
+export function createBoundingVolumes(
+  sourceBoundingVolume: OrientedBoundingBox | BoundingSphere,
+  geoidHeightModel: Geoid
+): BoundingVolumes {
   let radius;
   let halfSize;
   let quaternion;
 
-  const boundingVolume = tile.boundingVolume;
   const cartographicCenter = Ellipsoid.WGS84.cartesianToCartographic(
-    boundingVolume.center,
+    sourceBoundingVolume.center,
     new Vector3()
   );
   cartographicCenter[2] =
     cartographicCenter[2] -
     geoidHeightModel.getHeight(cartographicCenter[1], cartographicCenter[0]);
-  if (boundingVolume instanceof OrientedBoundingBox) {
-    halfSize = boundingVolume.halfSize;
+  if (sourceBoundingVolume instanceof OrientedBoundingBox) {
+    halfSize = sourceBoundingVolume.halfSize;
     radius = new Vector3(halfSize[0], halfSize[1], halfSize[2]).len();
-    quaternion = boundingVolume.quaternion;
+    quaternion = sourceBoundingVolume.quaternion;
   } else {
-    radius = tile.boundingVolume.radius;
+    radius = sourceBoundingVolume.radius;
     halfSize = [radius, radius, radius];
     quaternion = new Quaternion()
       .fromMatrix3(new Matrix3([halfSize[0], 0, 0, 0, halfSize[1], 0, 0, 0, halfSize[2]]))

package/src/i3s-converter/helpers/geometry-converter.ts

@@ -1,4 +1,4 @@
-import type {B3DMContent, FeatureTableJson} from '@loaders.gl/3d-tiles';
+import type {FeatureTableJson, Tiles3DTileContent} from '@loaders.gl/3d-tiles';
 import type {
   GLTF_EXT_feature_metadata,
   GLTF_EXT_mesh_features,
@@ -52,6 +52,7 @@ import {GL} from '@loaders.gl/math';
 */
 import type {TypedArrayConstructor} from '../types';
 import {generateSyntheticIndices} from '../../lib/utils/geometry-utils';
+import {BoundingSphere, OrientedBoundingBox} from '@math.gl/culling';
 
 // Spec - https://github.com/Esri/i3s-spec/blob/master/docs/1.7/pbrMetallicRoughness.cmn.md
 const DEFAULT_ROUGHNESS_FACTOR = 1;
@@ -81,6 +82,9 @@ let scratchVector = new Vector3();
  * Convert binary data from b3dm file to i3s resources
  *
  * @param tileContent - 3d tile content
+ * @param tileTransform - transformation matrix of the tile, calculated recursively multiplying
+ *                        transform of all parent tiles and transform of the current tile
+ * @param tileBoundingVolume - initialized bounding volume of the source tile
  * @param addNodeToNodePage - function to add new node to node pages
  * @param propertyTable - batch table (corresponding to feature attributes data)
  * @param featuresHashArray - hash array of features that is needed to not to mix up same features in parent and child nodes
@@ -93,7 +97,9 @@ let scratchVector = new Vector3();
  * @returns Array of node resources to create one or more i3s nodes
  */
 export default async function convertB3dmToI3sGeometry(
-  tileContent: B3DMContent,
+  tileContent: Tiles3DTileContent,
+  tileTransform: Matrix4,
+  tileBoundingVolume: OrientedBoundingBox | BoundingSphere,
   addNodeToNodePage: () => Promise<number>,
   propertyTable: FeatureTableJson | null,
   featuresHashArray: string[],
@@ -110,7 +116,11 @@ export default async function convertB3dmToI3sGeometry(
     shouldMergeMaterials
   );
 
-  const dataForAttributesConversion = prepareDataForAttributesConversion(tileContent);
+  const dataForAttributesConversion = prepareDataForAttributesConversion(
+    tileContent,
+    tileTransform,
+    tileBoundingVolume
+  );
   const convertedAttributesMap: Map<string, ConvertedAttributes> = await convertAttributes(
     dataForAttributesConversion,
     materialAndTextureList,
@@ -198,7 +208,7 @@ function _generateBoundingVolumesFromGeometry(
  * @param params.convertedAttributes - Converted geometry attributes
  * @param params.material - I3S PBR-like material definition
  * @param params.texture - texture content
- * @param params.tileContent - B3DM decoded content
+ * @param params.tileContent - 3DTiles decoded content
  * @param params.nodeId - new node ID
  * @param params.featuresHashArray - hash array of features that is needed to not to mix up same features in parent and child nodes
  * @param params.propertyTable - batch table (corresponding to feature attributes data)
@@ -222,7 +232,7 @@ async function _makeNodeResources({
   convertedAttributes: ConvertedAttributes;
   material: I3SMaterialDefinition;
   texture?: {};
-  tileContent: B3DMContent;
+  tileContent: Tiles3DTileContent;
   nodeId: number;
   featuresHashArray: string[];
   propertyTable: FeatureTableJson | null;
@@ -515,8 +525,12 @@ function convertMesh(
       outputAttributes = attributesMap.get('default');
     }
     assert(outputAttributes !== null, 'Primitive - material mapping failed');
+    // Per the spec https://registry.khronos.org/glTF/specs/2.0/glTF-2.0.html#_mesh_primitive_mode
+    // GL.TRIANGLES is default. So in case `mode` is `undefined`, it is 'TRIANGLES'
     assert(
-      primitive.mode === GL.TRIANGLES || primitive.mode === GL.TRIANGLE_STRIP,
+      primitive.mode === undefined ||
+        primitive.mode === GL.TRIANGLES ||
+        primitive.mode === GL.TRIANGLE_STRIP,
       `Primitive - unsupported mode ${primitive.mode}`
     );
     const attributes = primitive.attributes;
@@ -1541,10 +1555,14 @@ function generateFeatureIndexAttribute(
 /**
  * Find property table in tile
  * For example it can be batchTable for b3dm files or property table in gLTF extension.
- * @param sourceTile
+ * @param tileContent - 3DTiles tile content
  * @return batch table from b3dm / feature properties from EXT_FEATURE_METADATA
  */
-export function getPropertyTable(tileContent: B3DMContent): FeatureTableJson | null {
+export function getPropertyTable(tileContent: Tiles3DTileContent | null): FeatureTableJson | null {
+  if (!tileContent) {
+    return null;
+  }
+
   const batchTableJson = tileContent?.batchTableJson;
 
   if (batchTableJson) {
@@ -1568,10 +1586,10 @@ export function getPropertyTable(tileContent: B3DMContent): FeatureTableJson | n
 
 /**
  * Check extensions which can be with property table inside.
- * @param sourceTile
+ * @param tileContent - 3DTiles tile content
  */
 function getPropertyTableExtension(
-  tileContent: B3DMContent
+  tileContent: Tiles3DTileContent
 ): GLTF_EXT_feature_metadata | GLTF_EXT_mesh_features {
   const extensionsWithPropertyTables = [EXT_FEATURE_METADATA, EXT_MESH_FEATURES];
   const extensionsUsed = tileContent?.gltf?.extensionsUsed;
@@ -1597,18 +1615,10 @@ function getPropertyTableExtension(
 /**
  * Handle EXT_feature_metadata to get property table
  * @param extension
- * TODO add EXT_feature_metadata feature textures support.
  */
 function getPropertyTableFromExtFeatureMetadata(
   extension: GLTF_EXT_feature_metadata
 ): FeatureTableJson | null {
-  if (extension?.featureTextures) {
-    console.warn(
-      'The I3S converter does not yet support the EXT_feature_metadata feature textures'
-    );
-    return null;
-  }
-
   if (extension?.featureTables) {
     /**
      * Take only first feature table to generate attributes storage info object.
@@ -1630,6 +1640,28 @@ function getPropertyTableFromExtFeatureMetadata(
     }
   }
 
-  console.warn("The I3S converter couldn't handle EXT_feature_metadata extension");
+  if (extension?.featureTextures) {
+    /**
+     * Take only first feature texture to generate attributes storage info object.
+     * TODO: Think about getting data from all feature textures?
+     * It can be tricky just because 3dTiles is able to have multiple featureTextures.
+     * In I3S we should decide which featureTextures will be passed to geometry data.
+     */
+    const firstTextureName = Object.keys(extension.featureTextures)?.[0];
+    if (firstTextureName) {
+      const featureTable = extension?.featureTextures[firstTextureName];
+      const propertyTable = {};
+
+      for (const propertyName in featureTable.properties) {
+        propertyTable[propertyName] = featureTable.properties[propertyName].data;
+      }
+
+      return propertyTable;
+    }
+  }
+
+  console.warn(
+    "The I3S converter couldn't handle EXT_feature_metadata extension: There is neither featureTables, no featureTextures in the extension."
+  );
   return null;
 }

package/src/i3s-converter/helpers/gltf-attributes.ts

@@ -1,33 +1,27 @@
-import type {B3DMContent} from '@loaders.gl/3d-tiles';
+import type {Tiles3DTileContent} from '@loaders.gl/3d-tiles';
 import type {GLTFAccessorPostprocessed, GLTFNodePostprocessed} from '@loaders.gl/gltf';
 import type {B3DMAttributesData} from '../../i3s-attributes-worker';
+import {Matrix4, Vector3} from '@math.gl/core';
+import {BoundingSphere, OrientedBoundingBox} from '@math.gl/culling';
+import {Ellipsoid} from '@math.gl/geospatial';
 
 type AttributesObject = {
   [k: string]: GLTFAccessorPostprocessed;
 };
 
-/**
- * Keep only values for B3DM attributes to pass data to worker thread.
- * @param attributes
- */
-function getB3DMAttributesWithoutBufferView(attributes: AttributesObject): AttributesObject {
-  const attributesWithoutBufferView = {};
-
-  for (const attributeName in attributes) {
-    attributesWithoutBufferView[attributeName] = {
-      value: attributes[attributeName].value
-    };
-  }
-
-  return attributesWithoutBufferView;
-}
-
 /**
  * Prepare attributes for conversion to avoid binary data breaking in worker thread.
- * @param tileContent
+ * @param tileContent - 3DTiles tile content
+ * @param tileTransform - transformation matrix of the tile, calculated recursively multiplying
+ *                        transform of all parent tiles and transform of the current tile
+ * @param boundingVolume - initialized bounding volume of the source tile
  * @returns
  */
-export function prepareDataForAttributesConversion(tileContent: B3DMContent): B3DMAttributesData {
+export function prepareDataForAttributesConversion(
+  tileContent: Tiles3DTileContent,
+  tileTransform: Matrix4,
+  boundingVolume: OrientedBoundingBox | BoundingSphere
+): B3DMAttributesData {
   let nodes =
     tileContent.gltf?.scene?.nodes ||
     tileContent.gltf?.scenes?.[0]?.nodes ||
@@ -56,8 +50,11 @@ export function prepareDataForAttributesConversion(tileContent: B3DMContent): B3
 
   prepareNodes(nodes);
 
-  const cartographicOrigin = tileContent.cartographicOrigin;
-  const cartesianModelMatrix = tileContent.cartesianModelMatrix;
+  const {cartographicOrigin, modelMatrix: cartesianModelMatrix} = calculateTransformProps(
+    tileContent,
+    tileTransform,
+    boundingVolume
+  );
 
   return {
     nodes,
@@ -67,6 +64,72 @@ export function prepareDataForAttributesConversion(tileContent: B3DMContent): B3
   };
 }
 
+/**
+ * Keep only values for glTF attributes to pass data to worker thread.
+ * @param attributes - geometry attributes
+ */
+function getB3DMAttributesWithoutBufferView(attributes: AttributesObject): AttributesObject {
+  const attributesWithoutBufferView = {};
+
+  for (const attributeName in attributes) {
+    attributesWithoutBufferView[attributeName] = {
+      value: attributes[attributeName].value
+    };
+  }
+
+  return attributesWithoutBufferView;
+}
+
+/**
+ * Calculate transformation properties to transform vertex attributes (POSITION, NORMAL, etc.)
+ * from METER_OFFSET coorditantes to LNGLAT_OFFSET coordinates
+ * @param tileContent - 3DTiles tile content
+ * @param tileTransform - transformation matrix of the tile, calculated recursively multiplying
+ *                        transform of all parent tiles and transform of the current tile
+ * @param boundingVolume - initialized bounding volume of the source tile
+ * @returns modelMatrix - transformation matrix to transform coordinates to cartographic coordinates
+ *          cartographicOrigin - tile origin coordinates to calculate offsets
+ */
+export function calculateTransformProps(
+  tileContent: Tiles3DTileContent,
+  tileTransform: Matrix4,
+  boundingVolume: OrientedBoundingBox | BoundingSphere
+): {modelMatrix: Matrix4; cartographicOrigin: Vector3} {
+  const {rtcCenter, gltfUpAxis} = tileContent;
+  const {center} = boundingVolume;
+
+  let modelMatrix = new Matrix4(tileTransform);
+
+  // Translate if appropriate
+  if (rtcCenter) {
+    modelMatrix.translate(rtcCenter);
+  }
+
+  // glTF models need to be rotated from Y to Z up
+  // https://github.com/AnalyticalGraphicsInc/3d-tiles/tree/master/specification#y-up-to-z-up
+  switch (gltfUpAxis) {
+    case 'Z':
+      break;
+    case 'Y':
+      const rotationY = new Matrix4().rotateX(Math.PI / 2);
+      modelMatrix = modelMatrix.multiplyRight(rotationY);
+      break;
+    case 'X':
+      const rotationX = new Matrix4().rotateY(-Math.PI / 2);
+      modelMatrix = modelMatrix.multiplyRight(rotationX);
+      break;
+    default:
+      break;
+  }
+
+  const cartesianOrigin = new Vector3(center);
+  const cartographicOrigin = Ellipsoid.WGS84.cartesianToCartographic(
+    cartesianOrigin,
+    new Vector3()
+  );
+  return {modelMatrix, cartographicOrigin};
+}
+
 /**
  * Traverse all nodes to replace all sensible data with copy to avoid data corruption in worker.
  * @param nodes

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

@@ -0,0 +1,68 @@
+import type {
+  Tiles3DLoaderOptions,
+  Tiles3DTileContent,
+  Tiles3DTileJSONPostprocessed,
+  Tiles3DTilesetJSONPostprocessed
+} from '@loaders.gl/3d-tiles';
+import {load} from '@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
+ */
+export const loadNestedTileset = async (
+  sourceTileset: Tiles3DTilesetJSONPostprocessed | null,
+  sourceTile: Tiles3DTileJSONPostprocessed,
+  tilesetLoadOptions: Tiles3DLoaderOptions
+): Promise<void> => {
+  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 load(sourceTile.contentUrl, sourceTileset.loader, loadOptions);
+
+  if (tileContent.root) {
+    sourceTile.children = [tileContent.root];
+  }
+};
+
+/**
+ * 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 const loadTile3DContent = async (
+  sourceTileset: Tiles3DTilesetJSONPostprocessed | null,
+  sourceTile: Tiles3DTileJSONPostprocessed,
+  tilesetLoadOptions: Tiles3DLoaderOptions
+): Promise<Tiles3DTileContent | null> => {
+  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 load(sourceTile.contentUrl, sourceTileset.loader, loadOptions);
+
+  return tileContent;
+};

package/src/i3s-converter/helpers/node-index-document.ts

@@ -31,6 +31,15 @@ export class NodeIndexDocument {
   /** converter instance */
   private converter: I3SConverter;
 
+  /**
+   * Finalized property. It means that all child nodes are saved and their data
+   * is unloaded
+   */
+  private _finalized: boolean = false;
+  get finalized(): boolean {
+    return this._finalized;
+  }
+
   /**
    * Constructor
    * @param id - id of the node in node pages
@@ -90,6 +99,9 @@ export class NodeIndexDocument {
    * Add neighbors to child nodes of this node
    */
   public async addNeighbors(): Promise<void> {
+    if (this.finalized) {
+      return;
+    }
     const nodeData = await this.load();
     for (const childNode of this.children) {
       const childNodeData = await childNode.load();
@@ -116,9 +128,9 @@ export 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 */
@@ -128,6 +140,14 @@ export class NodeIndexDocument {
     }
   }
 
+  /** Finalize the node */
+  private finalize(): void {
+    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