@loaders.gl/tile-converter 4.0.0-alpha.19 → 4.0.0-alpha.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loaders.gl/tile-converter",
-  "version": "4.0.0-alpha.19",
+  "version": "4.0.0-alpha.20",
   "description": "Converter",
   "license": "MIT",
   "publishConfig": {
@@ -45,18 +45,18 @@
     "build-i3s-server-bundle": "esbuild src/i3s-server/bin/www.ts --outfile=dist/esm/i3s-server/bin/i3s-server.min.js --platform=node --target=esnext,node14 --external:join-images --minify --bundle --define:__VERSION__=\\\"$npm_package_version\\\""
   },
   "dependencies": {
-    "@loaders.gl/3d-tiles": "4.0.0-alpha.19",
-    "@loaders.gl/crypto": "4.0.0-alpha.19",
-    "@loaders.gl/draco": "4.0.0-alpha.19",
-    "@loaders.gl/gltf": "4.0.0-alpha.19",
-    "@loaders.gl/i3s": "4.0.0-alpha.19",
-    "@loaders.gl/images": "4.0.0-alpha.19",
-    "@loaders.gl/loader-utils": "4.0.0-alpha.19",
-    "@loaders.gl/polyfills": "4.0.0-alpha.19",
-    "@loaders.gl/textures": "4.0.0-alpha.19",
-    "@loaders.gl/tiles": "4.0.0-alpha.19",
-    "@loaders.gl/worker-utils": "4.0.0-alpha.19",
-    "@loaders.gl/zip": "4.0.0-alpha.19",
+    "@loaders.gl/3d-tiles": "4.0.0-alpha.20",
+    "@loaders.gl/crypto": "4.0.0-alpha.20",
+    "@loaders.gl/draco": "4.0.0-alpha.20",
+    "@loaders.gl/gltf": "4.0.0-alpha.20",
+    "@loaders.gl/i3s": "4.0.0-alpha.20",
+    "@loaders.gl/images": "4.0.0-alpha.20",
+    "@loaders.gl/loader-utils": "4.0.0-alpha.20",
+    "@loaders.gl/polyfills": "4.0.0-alpha.20",
+    "@loaders.gl/textures": "4.0.0-alpha.20",
+    "@loaders.gl/tiles": "4.0.0-alpha.20",
+    "@loaders.gl/worker-utils": "4.0.0-alpha.20",
+    "@loaders.gl/zip": "4.0.0-alpha.20",
     "@math.gl/core": "^3.5.1",
     "@math.gl/culling": "^3.5.1",
     "@math.gl/geoid": "^3.5.1",
@@ -66,6 +66,7 @@
     "crypt": "^0.0.2",
     "debug": "~4.3.4",
     "express": "~4.18.2",
+    "inquirer": "^8.0.0",
     "json-map-transform": "^1.2.6",
     "jszip": "^3.5.0",
     "md5": "^2.3.0",
@@ -79,7 +80,7 @@
     "join-images": "^1.1.3",
     "sharp": "^0.31.3"
   },
-  "gitHead": "2ca50ec4e1d312c124eb7c93c60ab6fd17ee833e",
+  "gitHead": "ac122e83102657c38207d59c631a5ce4e7aa46bd",
   "devDependencies": {
     "@types/express": "^4.17.17",
     "@types/node": "^20.4.2"

package/src/constants.ts

@@ -1,2 +1,5 @@
 export const BROWSER_ERROR_MESSAGE =
   'Tile converter does not work in browser, only in node js environment';
+
+export const EXT_MESH_FEATURES = 'EXT_mesh_features';
+export const EXT_FEATURE_METADATA = 'EXT_feature_metadata';

package/src/converter-cli.ts

@@ -1,6 +1,7 @@
 /* eslint-disable no-console */
 import '@loaders.gl/polyfills';
 import {join} from 'path';
+import inquirer from 'inquirer';
 import {I3SConverter, Tiles3DConverter} from '@loaders.gl/tile-converter';
 import {DepsInstaller} from './deps-installer/deps-installer';
 import {
@@ -49,6 +50,8 @@ type TileConversionOptions = {
   maxDepth?: number;
   /** 3DTiles->I3S only. Whether the converter generates *.slpk (Scene Layer Package) I3S output file */
   slpk: boolean;
+  /** Feature metadata class from EXT_FEATURE_METADATA or EXT_STRUCTURAL_METADATA extensions  */
+  metadataClass?: string;
 };
 
 /* During validation we check that particular options are defined so they can't be undefined */
@@ -132,8 +135,9 @@ function printHelp(): void {
   console.log(
     '--generate-textures [Enable KTX2 textures generation if only one of (JPG, PNG) texture is provided or generate JPG texture if only KTX2 is provided]'
   );
+  console.log('--generate-bounding-volumes [Generate obb and mbs bounding volumes from geometry]');
   console.log(
-    '--generate-bounding-volumes [Will generate obb and mbs bounding volumes from geometry]'
+    '--metadata-class [One of the list of feature metadata classes, detected by converter on "analyze" stage, default: not set]'
   );
   console.log('--validate [Enable validation]');
   process.exit(0); // eslint-disable-line
@@ -175,7 +179,8 @@ async function convert(options: ValidatedTileConversionOptions) {
         generateTextures: options.generateTextures,
         generateBoundingVolumes: options.generateBoundingVolumes,
         validate: options.validate,
-        instantNodeWriting: options.instantNodeWriting
+        instantNodeWriting: options.instantNodeWriting,
+        inquirer
       });
       break;
     default:
@@ -292,6 +297,8 @@ function parseOptions(args: string[]): TileConversionOptions {
         case '--generate-bounding-volumes':
           opts.generateBoundingVolumes = getBooleanValue(index, args);
           break;
+        case '--metadata-class':
+          opts.metadataClass = getStringValue(index, args);
         case '--help':
           printHelp();
           break;

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

@@ -2,26 +2,54 @@ import {GLTFAccessorPostprocessed, GLTFMeshPrimitivePostprocessed} from '@loader
 import type {NumericArray} from '@loaders.gl/loader-utils';
 import type {
   GLTF_EXT_feature_metadata_FeatureIdTexture,
+  GLTF_EXT_feature_metadata_GLTF,
   GLTF_EXT_feature_metadata_Primitive
 } from '@loaders.gl/gltf';
 import {TypedArray} from '@math.gl/core';
 import {TextureImageProperties} from '../types';
+import {EXT_FEATURE_METADATA, EXT_MESH_FEATURES} from '../../constants';
+import {Tiles3DTileContent} from '@loaders.gl/3d-tiles';
 
-const EXT_MESH_FEATURES = 'EXT_mesh_features';
-const EXT_FEATURE_METADATA = 'EXT_feature_metadata';
+/**
+ * Get featureTexture by metadataClass
+ * @param tileContent - 3d tile content
+ * @param metadataClass - user selected feature metadata class name
+ * @returns featureTexture key
+ */
+export function getTextureByMetadataClass(
+  tileContent: Tiles3DTileContent,
+  metadataClass?: string
+): string | null {
+  const extFeatureMetadata = tileContent.gltf?.extensions?.[
+    EXT_FEATURE_METADATA
+  ] as GLTF_EXT_feature_metadata_GLTF;
+  if (!extFeatureMetadata?.featureTextures) {
+    return null;
+  }
+  for (const textureKey in extFeatureMetadata.featureTextures) {
+    const texture = extFeatureMetadata.featureTextures[textureKey];
+    if (texture.class === metadataClass) {
+      return textureKey;
+    }
+  }
+  return null;
+}
 
 /**
  * Getting batchIds from 3DTilesNext extensions.
  * @param attributes - gltf accessors
  * @param primitive - gltf primitive data
  * @param images - gltf texture images
+ * @param featureTexture - feature texture key
+ * @return array of batch IDs
  */
 export function handleBatchIdsExtensions(
   attributes: {
     [key: string]: GLTFAccessorPostprocessed;
   },
   primitive: GLTFMeshPrimitivePostprocessed,
-  images: (TextureImageProperties | null)[]
+  images: (TextureImageProperties | null)[],
+  featureTexture: string | null
 ): NumericArray {
   const extensions = primitive?.extensions;
 
@@ -35,7 +63,8 @@ export function handleBatchIdsExtensions(
         return handleExtFeatureMetadataExtension(
           attributes,
           extensionData as GLTF_EXT_feature_metadata_Primitive,
-          images
+          images,
+          featureTexture
         );
       case EXT_MESH_FEATURES:
         console.warn('EXT_mesh_features extension is not supported yet');
@@ -51,16 +80,18 @@ export function handleBatchIdsExtensions(
 /**
  * Get batchIds from EXT_feature_metadata extension.
  * Docs - https://github.com/CesiumGS/glTF/tree/3d-tiles-next/extensions/2.0/Vendor/EXT_feature_metadata
- * @param attributes
- * @param extFeatureMetadata
- * @param textures
+ * @param attributes - glTF attributes
+ * @param extFeatureMetadata - primitive-level EXT_FEATURE_METADATA extension data
+ * @param textures - texture images
+ * @param featureTexture - feature texture key
  */
 function handleExtFeatureMetadataExtension(
   attributes: {
     [key: string]: GLTFAccessorPostprocessed;
   },
   extFeatureMetadata: GLTF_EXT_feature_metadata_Primitive,
-  images: (TextureImageProperties | null)[]
+  images: (TextureImageProperties | null)[],
+  featureTexture: string | null
 ): NumericArray {
   // Take only first extension object to get batchIds attribute name.
   const featureIdAttribute = extFeatureMetadata?.featureIdAttributes?.[0];
@@ -93,10 +124,6 @@ function handleExtFeatureMetadataExtension(
     return generateBatchIdsFromTexture(featureIdTexture, textureCoordinates, images);
   }
 
-  // Take only first extension texture to get batchIds from the root EXT_feature_metadata object.
-  const featureTexture =
-    extFeatureMetadata?.featureTextures && extFeatureMetadata?.featureTextures[0];
-
   if (featureTexture) {
     const batchIdsAttribute = attributes[featureTexture];
     return batchIdsAttribute.value;

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

@@ -199,19 +199,26 @@ function unifyObjectsByFeatureId(
 
   for (let index = 0; index < sortedData.length; index++) {
     const currentObject = sortedData[index];
-    const existedObject = uniqueObjects.find((obj) => obj.featureId === currentObject.featureId);
+    const existingObject = uniqueObjects.find((obj) => obj.featureId === currentObject.featureId);
 
-    if (existedObject) {
-      existedObject.positions = concatenateTypedArrays(
-        existedObject.positions,
+    if (existingObject) {
+      existingObject.positions = concatenateTypedArrays(
+        existingObject.positions,
         currentObject.positions
       );
-      existedObject.normals = concatenateTypedArrays(existedObject.normals, currentObject.normals);
-      existedObject.colors = concatenateTypedArrays(existedObject.colors, currentObject.colors);
-      existedObject.texCoords = concatenateTypedArrays(
-        existedObject.texCoords,
+      existingObject.normals = concatenateTypedArrays(
+        existingObject.normals,
+        currentObject.normals
+      );
+      existingObject.colors = concatenateTypedArrays(existingObject.colors, currentObject.colors);
+      existingObject.texCoords = concatenateTypedArrays(
+        existingObject.texCoords,
         currentObject.texCoords
       );
+      existingObject.uvRegions = concatenateTypedArrays(
+        existingObject.uvRegions,
+        currentObject.uvRegions
+      );
     } else {
       uniqueObjects.push(currentObject);
     }

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

@@ -35,7 +35,7 @@ import {
 import {NumberArray, TypedArray} from '@loaders.gl/loader-utils';
 import {Geoid} from '@math.gl/geoid';
 import {prepareDataForAttributesConversion} from './gltf-attributes';
-import {handleBatchIdsExtensions} from './batch-ids-extensions';
+import {getTextureByMetadataClass, handleBatchIdsExtensions} from './batch-ids-extensions';
 import {checkPropertiesLength, flattenPropertyTableByFeatureIds} from './feature-attributes';
 import {GL} from '@loaders.gl/math';
 
@@ -47,6 +47,7 @@ import {GL} from '@loaders.gl/math';
 import type {GLTFAttributesData, TextureImageProperties, TypedArrayConstructor} from '../types';
 import {generateSyntheticIndices} from '../../lib/utils/geometry-utils';
 import {BoundingSphere, OrientedBoundingBox} from '@math.gl/culling';
+import {EXT_FEATURE_METADATA, EXT_MESH_FEATURES} from '../../constants';
 
 // Spec - https://github.com/Esri/i3s-spec/blob/master/docs/1.7/pbrMetallicRoughness.cmn.md
 const DEFAULT_ROUGHNESS_FACTOR = 1;
@@ -67,9 +68,6 @@ const OBJECT_ID_TYPE = 'Oid32';
  */
 const BATCHED_ID_POSSIBLE_ATTRIBUTE_NAMES = ['CUSTOM_ATTRIBUTE_2', '_BATCHID', 'BATCHID'];
 
-const EXT_FEATURE_METADATA = 'EXT_feature_metadata';
-const EXT_MESH_FEATURES = 'EXT_mesh_features';
-
 let scratchVector = new Vector3();
 
 /**
@@ -88,6 +86,7 @@ let scratchVector = new Vector3();
  * @param shouldMergeMaterials - Try to merge similar materials to be able to merge meshes into one node
  * @param geoidHeightModel - model to convert elevation from elipsoidal to geoid
  * @param libraries - dynamicaly loaded 3rd-party libraries
+ * @param metadataClass `- user selected feature metadata class name`
  * @returns Array of node resources to create one or more i3s nodes
  */
 export default async function convertB3dmToI3sGeometry(
@@ -102,7 +101,8 @@ export default async function convertB3dmToI3sGeometry(
   generateBoundingVolumes: boolean,
   shouldMergeMaterials: boolean,
   geoidHeightModel: Geoid,
-  libraries: Record<string, string>
+  libraries: Record<string, string>,
+  metadataClass?: string
 ): Promise<I3SConvertedResources[] | null> {
   const useCartesianPositions = generateBoundingVolumes;
   const materialAndTextureList: I3SMaterialWithTexture[] = await convertMaterials(
@@ -115,10 +115,12 @@ export default async function convertB3dmToI3sGeometry(
     tileTransform,
     tileBoundingVolume
   );
+  const featureTexture = getTextureByMetadataClass(tileContent, metadataClass);
   const convertedAttributesMap: Map<string, ConvertedAttributes> = await convertAttributes(
     dataForAttributesConversion,
     materialAndTextureList,
-    useCartesianPositions
+    useCartesianPositions,
+    featureTexture
   );
   /** Usage of worker here brings more overhead than advantage */
   // const convertedAttributesMap: Map<string, ConvertedAttributes> =
@@ -312,12 +314,14 @@ async function _makeNodeResources({
  * @param materialAndTextureList - array of data about materials and textures of the content
  * @param useCartesianPositions - convert positions to absolute cartesian coordinates instead of cartographic offsets.
  * Cartesian coordinates will be required for creating bounding voulmest from geometry positions
+ * @param featureTexture - feature texture key
  * @returns map of converted geometry attributes
  */
 export async function convertAttributes(
   attributesData: GLTFAttributesData,
   materialAndTextureList: I3SMaterialWithTexture[],
-  useCartesianPositions: boolean
+  useCartesianPositions: boolean,
+  featureTexture: string | null
 ): Promise<Map<string, ConvertedAttributes>> {
   const {nodes, images, cartographicOrigin, cartesianModelMatrix} = attributesData;
   const attributesMap = new Map<string, ConvertedAttributes>();
@@ -345,7 +349,9 @@ export async function convertAttributes(
     cartographicOrigin,
     cartesianModelMatrix,
     attributesMap,
-    useCartesianPositions
+    useCartesianPositions,
+    undefined,
+    featureTexture
   );
 
   for (const attrKey of attributesMap.keys()) {
@@ -379,6 +385,7 @@ export async function convertAttributes(
  * @param useCartesianPositions - convert positions to absolute cartesian coordinates instead of cartographic offsets.
  * Cartesian coordinates will be required for creating bounding voulmest from geometry positions
  * @param matrix - transformation matrix - cumulative transformation matrix formed from all parent node matrices
+ * @param featureTexture - feature texture key
  * @returns {void}
  */
 function convertNodes(
@@ -388,7 +395,8 @@ function convertNodes(
   cartesianModelMatrix: Matrix4,
   attributesMap: Map<string, ConvertedAttributes>,
   useCartesianPositions: boolean,
-  matrix: Matrix4 = new Matrix4([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1])
+  matrix: Matrix4 = new Matrix4([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]),
+  featureTexture: string | null
 ) {
   if (nodes) {
     for (const node of nodes) {
@@ -399,7 +407,8 @@ function convertNodes(
         cartesianModelMatrix,
         attributesMap,
         useCartesianPositions,
-        matrix
+        matrix,
+        featureTexture
       );
     }
   }
@@ -441,11 +450,12 @@ function getCompositeTransformationMatrix(node: GLTFNodePostprocessed, matrix: M
  * @param images - gltf images array
  * @param cartographicOrigin - cartographic origin of bounding volume
  * @param cartesianModelMatrix - cartesian model matrix to convert coordinates to cartographic
- * @param {Map} attributesMap Map<{positions: Float32Array, normals: Float32Array, texCoords: Float32Array, colors: Uint8Array, featureIndices: Array}> - for recursive concatenation of
+ * @param attributesMap Map<{positions: Float32Array, normals: Float32Array, texCoords: Float32Array, colors: Uint8Array, featureIndices: Array}> - for recursive concatenation of
  *   attributes
  * @param useCartesianPositions - convert positions to absolute cartesian coordinates instead of cartographic offsets.
  * Cartesian coordinates will be required for creating bounding voulmest from geometry positions
- * @param {Matrix4} matrix - transformation matrix - cumulative transformation matrix formed from all parent node matrices
+ * @param matrix - transformation matrix - cumulative transformation matrix formed from all parent node matrices
+ * @param featureTexture - feature texture key
  */
 function convertNode(
   node: GLTFNodePostprocessed,
@@ -454,7 +464,8 @@ function convertNode(
   cartesianModelMatrix: Matrix4,
   attributesMap: Map<string, ConvertedAttributes>,
   useCartesianPositions,
-  matrix = new Matrix4([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1])
+  matrix = new Matrix4([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]),
+  featureTexture: string | null
 ) {
   const transformationMatrix = getCompositeTransformationMatrix(node, matrix);
 
@@ -468,7 +479,8 @@ function convertNode(
       cartesianModelMatrix,
       attributesMap,
       useCartesianPositions,
-      transformationMatrix
+      transformationMatrix,
+      featureTexture
     );
   }
 
@@ -479,7 +491,8 @@ function convertNode(
     cartesianModelMatrix,
     attributesMap,
     useCartesianPositions,
-    transformationMatrix
+    transformationMatrix,
+    featureTexture
   );
 }
 
@@ -491,12 +504,12 @@ function convertNode(
  * @param cartesianModelMatrix - cartesian model matrix to convert coordinates to cartographic
  * @param attributesMap Map<{positions: Float32Array, normals: Float32Array, texCoords: Float32Array, colors: Uint8Array, featureIndices: Array}> - for recursive concatenation of
  *   attributes
- * @param useCartesianPositions - convert positions to absolute cartesian coordinates instead of cartographic offsets. 
+ * @param useCartesianPositions - convert positions to absolute cartesian coordinates instead of cartographic offsets.
  * Cartesian coordinates will be required for creating bounding voulmest from geometry positions
  * @param attributesMap Map<{positions: Float32Array, normals: Float32Array, texCoords: Float32Array, colors: Uint8Array, featureIndices: Array}> - for recursive concatenation of
  *   attributes
- 
- * @param {Matrix4} matrix - transformation matrix - cumulative transformation matrix formed from all parent node matrices
+ * @param matrix - transformation matrix - cumulative transformation matrix formed from all parent node matrices
+ * @param featureTexture - feature texture key
  */
 function convertMesh(
   mesh: GLTFMeshPostprocessed,
@@ -505,7 +518,8 @@ function convertMesh(
   cartesianModelMatrix: Matrix4,
   attributesMap: Map<string, ConvertedAttributes>,
   useCartesianPositions = false,
-  matrix = new Matrix4([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1])
+  matrix = new Matrix4([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]),
+  featureTexture: string | null
 ) {
   for (const primitive of mesh.primitives) {
     let outputAttributes: ConvertedAttributes | null | undefined = null;
@@ -576,7 +590,7 @@ function convertMesh(
 
     outputAttributes.featureIndicesGroups = outputAttributes.featureIndicesGroups || [];
     outputAttributes.featureIndicesGroups.push(
-      flattenBatchIds(getBatchIds(attributes, primitive, images), indices)
+      flattenBatchIds(getBatchIds(attributes, primitive, images, featureTexture), indices)
     );
   }
 }
@@ -803,15 +817,23 @@ function flattenBatchIds(batchedIds: NumberArray, indices: TypedArray): number[]
  * @param attributes - gltf accessors
  * @param primitive - gltf primitive data
  * @param images - gltf texture images
+ * @param featureTexture - feature texture key
+ * @return batch IDs
  */
 function getBatchIds(
   attributes: {
     [key: string]: GLTFAccessorPostprocessed;
   },
   primitive: GLTFMeshPrimitivePostprocessed,
-  images: (TextureImageProperties | null)[]
+  images: (TextureImageProperties | null)[],
+  featureTexture: string | null
 ): NumberArray {
-  const batchIds: NumberArray = handleBatchIdsExtensions(attributes, primitive, images);
+  const batchIds: NumberArray = handleBatchIdsExtensions(
+    attributes,
+    primitive,
+    images,
+    featureTexture
+  );
 
   if (batchIds.length) {
     return batchIds;
@@ -1555,9 +1577,13 @@ function generateFeatureIndexAttribute(
  * Find property table in tile
  * For example it can be batchTable for b3dm files or property table in gLTF extension.
  * @param tileContent - 3DTiles tile content
+ * @param metadataClass - - user selected feature metadata class name
  * @return batch table from b3dm / feature properties from EXT_FEATURE_METADATA
  */
-export function getPropertyTable(tileContent: Tiles3DTileContent | null): FeatureTableJson | null {
+export function getPropertyTable(
+  tileContent: Tiles3DTileContent | null,
+  metadataClass?: string
+): FeatureTableJson | null {
   if (!tileContent) {
     return null;
   }
@@ -1576,7 +1602,10 @@ export function getPropertyTable(tileContent: Tiles3DTileContent | null): Featur
       return null;
     }
     case EXT_FEATURE_METADATA: {
-      return getPropertyTableFromExtFeatureMetadata(extension as GLTF_EXT_feature_metadata_GLTF);
+      return getPropertyTableFromExtFeatureMetadata(
+        extension as GLTF_EXT_feature_metadata_GLTF,
+        metadataClass
+      );
     }
     default:
       return null;
@@ -1619,10 +1648,11 @@ function getPropertyTableExtension(tileContent: Tiles3DTileContent): {
 
 /**
  * Handle EXT_feature_metadata to get property table
- * @param extension
+ * @param extension - global level of EXT_FEATURE_METADATA extension
  */
 function getPropertyTableFromExtFeatureMetadata(
-  extension: GLTF_EXT_feature_metadata_GLTF
+  extension: GLTF_EXT_feature_metadata_GLTF,
+  metadataClass?: string
 ): FeatureTableJson | null {
   if (extension?.featureTables) {
     /**
@@ -1646,15 +1676,16 @@ function getPropertyTableFromExtFeatureMetadata(
   }
 
   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];
+    let featureTexture: string | undefined;
+    for (const textureKey in extension.featureTextures) {
+      const texture = extension.featureTextures[textureKey];
+      if (texture.class === metadataClass) {
+        featureTexture = textureKey;
+      }
+    }
+
+    if (typeof featureTexture === 'string') {
+      const featureTable = extension?.featureTextures[featureTexture];
       const propertyTable = {};
 
       for (const propertyName in featureTable.properties) {

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

@@ -1,20 +1,21 @@
 import {Tiles3DTileContent} from '@loaders.gl/3d-tiles';
-import {GltfPrimitiveModeString, PreprocessData} from '../types';
-import {GLTF, GLTFLoader} from '@loaders.gl/gltf';
+import {GLTFPrimitiveModeString, PreprocessData} from '../types';
+import {GLTF, GLTFLoader, GLTF_EXT_feature_metadata_GLTF} from '@loaders.gl/gltf';
 import {parse} from '@loaders.gl/core';
+import {EXT_FEATURE_METADATA} from '../../constants';
 
 /**
  * glTF primitive modes
  * @see https://registry.khronos.org/glTF/specs/2.0/glTF-2.0.html#_mesh_primitive_mode
  */
 export const GLTF_PRIMITIVE_MODES = [
-  GltfPrimitiveModeString.POINTS, // 0
-  GltfPrimitiveModeString.LINES, // 1
-  GltfPrimitiveModeString.LINE_LOOP, // 2
-  GltfPrimitiveModeString.LINE_STRIP, // 3
-  GltfPrimitiveModeString.TRIANGLES, // 4
-  GltfPrimitiveModeString.TRIANGLE_STRIP, // 5
-  GltfPrimitiveModeString.TRIANGLE_FAN // 6
+  GLTFPrimitiveModeString.POINTS, // 0
+  GLTFPrimitiveModeString.LINES, // 1
+  GLTFPrimitiveModeString.LINE_LOOP, // 2
+  GLTFPrimitiveModeString.LINE_STRIP, // 3
+  GLTFPrimitiveModeString.TRIANGLES, // 4
+  GLTFPrimitiveModeString.TRIANGLE_STRIP, // 5
+  GLTFPrimitiveModeString.TRIANGLE_FAN // 6
 ];
 
 /**
@@ -26,11 +27,12 @@ export const GLTF_PRIMITIVE_MODES = [
 export const analyzeTileContent = async (
   tileContent: Tiles3DTileContent | null
 ): Promise<PreprocessData> => {
-  const result: PreprocessData = {
-    meshTopologyTypes: new Set()
+  const defaultResult = {
+    meshTopologyTypes: new Set<GLTFPrimitiveModeString>(),
+    metadataClasses: new Set<string>()
   };
   if (!tileContent?.gltfArrayBuffer) {
-    return result;
+    return defaultResult;
   }
 
   const gltfData = await parse(tileContent.gltfArrayBuffer, GLTFLoader, {
@@ -39,11 +41,14 @@ export const analyzeTileContent = async (
   const gltf = gltfData.json;
 
   if (!gltf) {
-    return result;
+    return defaultResult;
   }
-  const meshTypes = getMeshTypesFromGltf(gltf);
-  result.meshTopologyTypes = meshTypes;
-  return result;
+  const meshTopologyTypes = getMeshTypesFromGltf(gltf);
+  const metadataClasses = getMetadataClassesFromGltf(gltf);
+  return {
+    meshTopologyTypes,
+    metadataClasses
+  };
 };
 
 /**
@@ -51,8 +56,8 @@ export const analyzeTileContent = async (
  * @param gltfJson - JSON part of GLB content
  * @returns array of mesh types found
  */
-const getMeshTypesFromGltf = (gltfJson: GLTF): Set<GltfPrimitiveModeString> => {
-  const result: Set<GltfPrimitiveModeString> = new Set();
+const getMeshTypesFromGltf = (gltfJson: GLTF): Set<GLTFPrimitiveModeString> => {
+  const result: Set<GLTFPrimitiveModeString> = new Set();
   for (const mesh of gltfJson.meshes || []) {
     for (const primitive of mesh.primitives) {
       let {mode} = primitive;
@@ -65,6 +70,26 @@ const getMeshTypesFromGltf = (gltfJson: GLTF): Set<GltfPrimitiveModeString> => {
   return result;
 };
 
+/**
+ * Get feature metadata classes from glTF
+ * @param gltfJson - JSON part of GLB content
+ * @returns array of classes
+ */
+const getMetadataClassesFromGltf = (gltfJson: GLTF): Set<string> => {
+  const result: Set<string> = new Set();
+
+  const classes = (gltfJson.extensions?.[EXT_FEATURE_METADATA] as GLTF_EXT_feature_metadata_GLTF)
+    ?.schema?.classes;
+
+  if (classes) {
+    for (const classKey of Object.keys(classes)) {
+      result.add(classKey);
+    }
+  }
+
+  return result;
+};
+
 /**
  * Merge object2 into object1
  * @param object1
@@ -76,4 +101,9 @@ export const mergePreprocessData = (object1: PreprocessData, object2: Preprocess
   for (const type of object2.meshTopologyTypes) {
     object1.meshTopologyTypes.add(type);
   }
+
+  // Merge feature metadata classes
+  for (const metadataClass of object2.metadataClasses) {
+    object1.metadataClasses.add(metadataClass);
+  }
 };