@loaders.gl/tile-converter 3.3.0-alpha.8 → 3.4.0-alpha.1

package/dist/es5/i3s-converter/helpers/geometry-converter.js

@@ -1,6 +1,7 @@
 "use strict";
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _typeof = require("@babel/runtime/helpers/typeof");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
@@ -16,11 +17,14 @@ var _draco = require("@loaders.gl/draco");
 var _core2 = require("@loaders.gl/core");
 var _loaderUtils = require("@loaders.gl/loader-utils");
 var _md = _interopRequireDefault(require("md5"));
+var _uuid = require("uuid");
 var _geometryAttributes = require("./geometry-attributes");
 var _coordinateConverter = require("./coordinate-converter");
 var _gltfAttributes = require("./gltf-attributes");
 var _batchIdsExtensions = require("./batch-ids-extensions");
 var _featureAttributes = require("./feature-attributes");
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
 function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
 function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { (0, _defineProperty2.default)(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
 function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
@@ -40,66 +44,62 @@ var EXT_FEATURE_METADATA = 'EXT_feature_metadata';
 var EXT_MESH_FEATURES = 'EXT_mesh_features';
 var scratchVector = new _core.Vector3();
 
-function convertB3dmToI3sGeometry(_x, _x2, _x3, _x4, _x5, _x6, _x7, _x8, _x9) {
+function convertB3dmToI3sGeometry(_x, _x2, _x3, _x4, _x5, _x6, _x7, _x8, _x9, _x10) {
   return _convertB3dmToI3sGeometry.apply(this, arguments);
 }
 function _convertB3dmToI3sGeometry() {
-  _convertB3dmToI3sGeometry = (0, _asyncToGenerator2.default)(_regenerator.default.mark(function _callee(tileContent, addNodeToNodePage, propertyTable, featuresHashArray, attributeStorageInfo, draco, generateBoundingVolumes, geoidHeightModel, workerSource) {
+  _convertB3dmToI3sGeometry = (0, _asyncToGenerator2.default)(_regenerator.default.mark(function _callee(tileContent, addNodeToNodePage, propertyTable, featuresHashArray, attributeStorageInfo, draco, generateBoundingVolumes, shouldMergeMaterials, geoidHeightModel, workerSource) {
     var _tileContent$gltf4;
-    var useCartesianPositions, materialAndTextureList, dataForAttributesConversion, convertedAttributesMap, result, _ref3, _ref3$materials, materials, i, sourceMaterial, convertedAttributes, _materialAndTextureLi, material, texture, nodeId;
+    var useCartesianPositions, materialAndTextureList, dataForAttributesConversion, convertedAttributesMap, result, _iterator6, _step6, materialAndTexture, originarMaterialId, convertedAttributes, material, texture, nodeId;
     return _regenerator.default.wrap(function _callee$(_context) {
       while (1) {
         switch (_context.prev = _context.next) {
           case 0:
             useCartesianPositions = generateBoundingVolumes;
-            materialAndTextureList = convertMaterials((_tileContent$gltf4 = tileContent.gltf) === null || _tileContent$gltf4 === void 0 ? void 0 : _tileContent$gltf4.materials);
+            _context.next = 3;
+            return convertMaterials((_tileContent$gltf4 = tileContent.gltf) === null || _tileContent$gltf4 === void 0 ? void 0 : _tileContent$gltf4.materials, shouldMergeMaterials);
+          case 3:
+            materialAndTextureList = _context.sent;
             dataForAttributesConversion = (0, _gltfAttributes.prepareDataForAttributesConversion)(tileContent);
-            _context.next = 5;
-            return convertAttributes(dataForAttributesConversion, useCartesianPositions);
-          case 5:
+            _context.next = 7;
+            return convertAttributes(dataForAttributesConversion, materialAndTextureList, useCartesianPositions);
+          case 7:
             convertedAttributesMap = _context.sent;
 
             if (generateBoundingVolumes) {
               _generateBoundingVolumesFromGeometry(convertedAttributesMap, geoidHeightModel);
             }
-            if (convertedAttributesMap.has('default')) {
-              materialAndTextureList.push({
-                material: getDefaultMaterial()
-              });
-            }
             result = [];
-            _ref3 = tileContent.gltf || {
-              materials: []
-            }, _ref3$materials = _ref3.materials, materials = _ref3$materials === void 0 ? [] : _ref3$materials;
-            if (!(materials !== null && materials !== void 0 && materials.length)) {
-              materials.push({
-                id: 'default'
-              });
-            }
-            i = 0;
-          case 12:
-            if (!(i < materials.length)) {
-              _context.next = 29;
+            _iterator6 = _createForOfIteratorHelper(materialAndTextureList);
+            _context.prev = 11;
+            _iterator6.s();
+          case 13:
+            if ((_step6 = _iterator6.n()).done) {
+              _context.next = 32;
               break;
             }
-            sourceMaterial = materials[i];
-            if (convertedAttributesMap.has(sourceMaterial.id)) {
-              _context.next = 16;
+            materialAndTexture = _step6.value;
+            originarMaterialId = materialAndTexture.mergedMaterials[0].originalMaterialId;
+            if (convertedAttributesMap.has(originarMaterialId)) {
+              _context.next = 18;
               break;
             }
-            return _context.abrupt("continue", 26);
-          case 16:
-            convertedAttributes = convertedAttributesMap.get(sourceMaterial.id);
+            return _context.abrupt("continue", 30);
+          case 18:
+            convertedAttributes = convertedAttributesMap.get(originarMaterialId);
             if (convertedAttributes) {
-              _context.next = 19;
+              _context.next = 21;
               break;
             }
-            return _context.abrupt("continue", 26);
-          case 19:
-            _materialAndTextureLi = materialAndTextureList[i], material = _materialAndTextureLi.material, texture = _materialAndTextureLi.texture;
-            nodeId = addNodeToNodePage();
-            _context.t0 = result;
+            return _context.abrupt("continue", 30);
+          case 21:
+            material = materialAndTexture.material, texture = materialAndTexture.texture;
             _context.next = 24;
+            return addNodeToNodePage();
+          case 24:
+            nodeId = _context.sent;
+            _context.t0 = result;
+            _context.next = 28;
             return _makeNodeResources({
               convertedAttributes: convertedAttributes,
               material: material,
@@ -112,27 +112,37 @@ function _convertB3dmToI3sGeometry() {
               draco: draco,
               workerSource: workerSource
             });
-          case 24:
+          case 28:
             _context.t1 = _context.sent;
             _context.t0.push.call(_context.t0, _context.t1);
-          case 26:
-            i++;
-            _context.next = 12;
+          case 30:
+            _context.next = 13;
+            break;
+          case 32:
+            _context.next = 37;
             break;
-          case 29:
+          case 34:
+            _context.prev = 34;
+            _context.t2 = _context["catch"](11);
+            _iterator6.e(_context.t2);
+          case 37:
+            _context.prev = 37;
+            _iterator6.f();
+            return _context.finish(37);
+          case 40:
             if (result.length) {
-              _context.next = 31;
+              _context.next = 42;
               break;
             }
             return _context.abrupt("return", null);
-          case 31:
+          case 42:
             return _context.abrupt("return", result);
-          case 32:
+          case 43:
           case "end":
             return _context.stop();
         }
       }
-    }, _callee);
+    }, _callee, null, [[11, 34, 37, 40]]);
   }));
   return _convertB3dmToI3sGeometry.apply(this, arguments);
 }
@@ -160,13 +170,13 @@ function _generateBoundingVolumesFromGeometry(convertedAttributesMap, geoidHeigh
   }
 }
 
-function _makeNodeResources(_x10) {
+function _makeNodeResources(_x11) {
   return _makeNodeResources2.apply(this, arguments);
 }
 function _makeNodeResources2() {
   _makeNodeResources2 = (0, _asyncToGenerator2.default)(_regenerator.default.mark(function _callee2(_ref) {
     var _tileContent$gltf5;
-    var convertedAttributes, material, texture, tileContent, nodeId, featuresHashArray, propertyTable, attributeStorageInfo, draco, workerSource, boundingVolumes, vertexCount, _generateAttributes, faceRange, featureIds, positions, normals, colors, texCoords, featureCount, header, typedFeatureIds, fileBuffer, compressedGeometry, attributes;
+    var convertedAttributes, material, texture, tileContent, nodeId, featuresHashArray, propertyTable, attributeStorageInfo, draco, workerSource, boundingVolumes, vertexCount, _generateAttributes, faceRange, featureIds, positions, normals, colors, uvRegions, texCoords, featureCount, header, typedFeatureIds, fileBuffer, compressedGeometry, attributes;
     return _regenerator.default.wrap(function _callee2$(_context2) {
       while (1) {
         switch (_context2.prev = _context2.next) {
@@ -174,19 +184,20 @@ function _makeNodeResources2() {
             convertedAttributes = _ref.convertedAttributes, material = _ref.material, texture = _ref.texture, tileContent = _ref.tileContent, nodeId = _ref.nodeId, featuresHashArray = _ref.featuresHashArray, propertyTable = _ref.propertyTable, attributeStorageInfo = _ref.attributeStorageInfo, draco = _ref.draco, workerSource = _ref.workerSource;
             boundingVolumes = convertedAttributes.boundingVolumes;
             vertexCount = convertedAttributes.positions.length / VALUES_PER_VERTEX;
-            _generateAttributes = (0, _geometryAttributes.generateAttributes)(convertedAttributes), faceRange = _generateAttributes.faceRange, featureIds = _generateAttributes.featureIds, positions = _generateAttributes.positions, normals = _generateAttributes.normals, colors = _generateAttributes.colors, texCoords = _generateAttributes.texCoords, featureCount = _generateAttributes.featureCount;
+            _generateAttributes = (0, _geometryAttributes.generateAttributes)(convertedAttributes), faceRange = _generateAttributes.faceRange, featureIds = _generateAttributes.featureIds, positions = _generateAttributes.positions, normals = _generateAttributes.normals, colors = _generateAttributes.colors, uvRegions = _generateAttributes.uvRegions, texCoords = _generateAttributes.texCoords, featureCount = _generateAttributes.featureCount;
             if (tileContent.batchTableJson) {
               makeFeatureIdsUnique(featureIds, convertedAttributes.featureIndices, featuresHashArray, tileContent.batchTableJson);
             }
             header = new Uint32Array(2);
             typedFeatureIds = generateBigUint64Array(featureIds);
             header.set([vertexCount, featureCount], 0);
-            fileBuffer = new Uint8Array((0, _loaderUtils.concatenateArrayBuffers)(header.buffer, positions.buffer, normals.buffer, texture ? texCoords.buffer : new ArrayBuffer(0), colors.buffer, typedFeatureIds.buffer, faceRange.buffer));
+            fileBuffer = new Uint8Array((0, _loaderUtils.concatenateArrayBuffers)(header.buffer, positions.buffer, normals.buffer, texture ? texCoords.buffer : new ArrayBuffer(0), colors.buffer, uvRegions, typedFeatureIds.buffer, faceRange.buffer));
             compressedGeometry = draco ? generateCompressedGeometry(vertexCount, convertedAttributes, {
               positions: positions,
               normals: normals,
               texCoords: texture ? texCoords : new Float32Array(0),
               colors: colors,
+              uvRegions: uvRegions,
               featureIds: featureIds,
               faceRange: faceRange
             }, workerSource.draco) : null;
@@ -199,6 +210,7 @@ function _makeNodeResources2() {
               geometry: fileBuffer,
               compressedGeometry: compressedGeometry,
               texture: texture,
+              hasUvRegions: Boolean(uvRegions.length),
               sharedResources: getSharedResources(((_tileContent$gltf5 = tileContent.gltf) === null || _tileContent$gltf5 === void 0 ? void 0 : _tileContent$gltf5.materials) || [], nodeId),
               meshMaterial: material,
               vertexCount: vertexCount,
@@ -215,33 +227,44 @@ function _makeNodeResources2() {
   }));
   return _makeNodeResources2.apply(this, arguments);
 }
-function convertAttributes(_x11, _x12) {
+function convertAttributes(_x12, _x13, _x14) {
   return _convertAttributes.apply(this, arguments);
 }
 function _convertAttributes() {
-  _convertAttributes = (0, _asyncToGenerator2.default)(_regenerator.default.mark(function _callee3(attributesData, useCartesianPositions) {
-    var gltfMaterials, nodes, images, cartographicOrigin, cartesianModelMatrix, attributesMap, _iterator7, _step7, material, _iterator8, _step8, attrKey, attributes;
+  _convertAttributes = (0, _asyncToGenerator2.default)(_regenerator.default.mark(function _callee3(attributesData, materialAndTextureList, useCartesianPositions) {
+    var nodes, images, cartographicOrigin, cartesianModelMatrix, attributesMap, _iterator7, _step7, materialAndTexture, attributes, _iterator9, _step9, mergedMaterial, _iterator8, _step8, attrKey, _attributes;
     return _regenerator.default.wrap(function _callee3$(_context3) {
       while (1) {
         switch (_context3.prev = _context3.next) {
           case 0:
-            gltfMaterials = attributesData.gltfMaterials, nodes = attributesData.nodes, images = attributesData.images, cartographicOrigin = attributesData.cartographicOrigin, cartesianModelMatrix = attributesData.cartesianModelMatrix;
+            nodes = attributesData.nodes, images = attributesData.images, cartographicOrigin = attributesData.cartographicOrigin, cartesianModelMatrix = attributesData.cartesianModelMatrix;
             attributesMap = new Map();
-            _iterator7 = _createForOfIteratorHelper(gltfMaterials || [{
-              id: 'default'
-            }]);
+            _iterator7 = _createForOfIteratorHelper(materialAndTextureList);
             try {
               for (_iterator7.s(); !(_step7 = _iterator7.n()).done;) {
-                material = _step7.value;
-                attributesMap.set(material.id, {
+                materialAndTexture = _step7.value;
+                attributes = {
                   positions: new Float32Array(0),
                   normals: new Float32Array(0),
                   texCoords: new Float32Array(0),
                   colors: new Uint8Array(0),
+                  uvRegions: new Uint16Array(0),
                   featureIndicesGroups: [],
                   featureIndices: [],
-                  boundingVolumes: null
-                });
+                  boundingVolumes: null,
+                  mergedMaterials: materialAndTexture.mergedMaterials
+                };
+                _iterator9 = _createForOfIteratorHelper(materialAndTexture.mergedMaterials);
+                try {
+                  for (_iterator9.s(); !(_step9 = _iterator9.n()).done;) {
+                    mergedMaterial = _step9.value;
+                    attributesMap.set(mergedMaterial.originalMaterialId, attributes);
+                  }
+                } catch (err) {
+                  _iterator9.e(err);
+                } finally {
+                  _iterator9.f();
+                }
               }
             } catch (err) {
               _iterator7.e(err);
@@ -258,25 +281,25 @@ function _convertAttributes() {
               break;
             }
             attrKey = _step8.value;
-            attributes = attributesMap.get(attrKey);
-            if (attributes) {
+            _attributes = attributesMap.get(attrKey);
+            if (_attributes) {
               _context3.next = 13;
               break;
             }
             return _context3.abrupt("continue", 17);
           case 13:
-            if (!(attributes.positions.length === 0)) {
+            if (!(_attributes.positions.length === 0)) {
               _context3.next = 16;
               break;
             }
             attributesMap.delete(attrKey);
             return _context3.abrupt("continue", 17);
           case 16:
-            if (attributes.featureIndicesGroups) {
-              attributes.featureIndices = attributes.featureIndicesGroups.reduce(function (acc, value) {
+            if (_attributes.featureIndicesGroups) {
+              _attributes.featureIndices = _attributes.featureIndicesGroups.reduce(function (acc, value) {
                 return acc.concat(value);
               });
-              delete attributes.featureIndicesGroups;
+              delete _attributes.featureIndicesGroups;
             }
           case 17:
             _context3.next = 8;
@@ -358,19 +381,26 @@ function convertMesh(mesh, images, cartographicOrigin, cartesianModelMatrix, att
   var _iterator3 = _createForOfIteratorHelper(mesh.primitives),
     _step3;
   try {
-    for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
-      var _primitive$indices, _primitive$indices2, _primitive$indices3, _primitive$indices4, _primitive$indices5;
+    var _loop = function _loop() {
+      var _primitive$indices, _primitive$indices2, _primitive$indices3, _primitive$indices4, _primitive$indices6;
       var primitive = _step3.value;
       var outputAttributes = null;
+      var materialUvRegion = void 0;
       if (primitive.material) {
-        outputAttributes = attributesMap.get(primitive.material.id);
+        var _outputAttributes, _outputAttributes$mer;
+        outputAttributes = attributesMap.get(primitive.material.uniqueId);
+        materialUvRegion = (_outputAttributes = outputAttributes) === null || _outputAttributes === void 0 ? void 0 : (_outputAttributes$mer = _outputAttributes.mergedMaterials.find(function (_ref2) {
+          var _primitive$material;
+          var originalMaterialId = _ref2.originalMaterialId;
+          return originalMaterialId === ((_primitive$material = primitive.material) === null || _primitive$material === void 0 ? void 0 : _primitive$material.uniqueId);
+        })) === null || _outputAttributes$mer === void 0 ? void 0 : _outputAttributes$mer.uvRegion;
       } else if (attributesMap.has('default')) {
         outputAttributes = attributesMap.get('default');
       }
       (0, _core2.assert)(outputAttributes !== null, 'Primitive - material mapping failed');
       var attributes = primitive.attributes;
       if (!outputAttributes) {
-        continue;
+        return "continue";
       }
       outputAttributes.positions = (0, _loaderUtils.concatenateTypedArrays)(outputAttributes.positions, transformVertexArray({
         vertices: attributes.POSITION.value,
@@ -392,8 +422,16 @@ function convertMesh(mesh, images, cartographicOrigin, cartesianModelMatrix, att
       }));
       outputAttributes.texCoords = (0, _loaderUtils.concatenateTypedArrays)(outputAttributes.texCoords, flattenTexCoords(attributes.TEXCOORD_0 && attributes.TEXCOORD_0.value, (_primitive$indices3 = primitive.indices) === null || _primitive$indices3 === void 0 ? void 0 : _primitive$indices3.value));
       outputAttributes.colors = (0, _loaderUtils.concatenateTypedArrays)(outputAttributes.colors, flattenColors(attributes.COLOR_0, (_primitive$indices4 = primitive.indices) === null || _primitive$indices4 === void 0 ? void 0 : _primitive$indices4.value));
+      if (materialUvRegion) {
+        var _primitive$indices5;
+        outputAttributes.uvRegions = (0, _loaderUtils.concatenateTypedArrays)(outputAttributes.uvRegions, createUvRegion(materialUvRegion, (_primitive$indices5 = primitive.indices) === null || _primitive$indices5 === void 0 ? void 0 : _primitive$indices5.value));
+      }
       outputAttributes.featureIndicesGroups = outputAttributes.featureIndicesGroups || [];
-      outputAttributes.featureIndicesGroups.push(flattenBatchIds(getBatchIds(attributes, primitive, images), (_primitive$indices5 = primitive.indices) === null || _primitive$indices5 === void 0 ? void 0 : _primitive$indices5.value));
+      outputAttributes.featureIndicesGroups.push(flattenBatchIds(getBatchIds(attributes, primitive, images), (_primitive$indices6 = primitive.indices) === null || _primitive$indices6 === void 0 ? void 0 : _primitive$indices6.value));
+    };
+    for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+      var _ret = _loop();
+      if (_ret === "continue") continue;
     }
   } catch (err) {
     _iterator3.e(err);
@@ -484,6 +522,14 @@ function flattenColors(colorsAttribute, indices) {
   return newColors;
 }
 
+function createUvRegion(materialUvRegion, indices) {
+  var result = new Uint16Array(indices.length * 4);
+  for (var i = 0; i < result.length; i += 4) {
+    result.set(materialUvRegion, i);
+  }
+  return result;
+}
+
 function flattenBatchIds(batchedIds, indices) {
   if (!batchedIds.length || !indices.length) {
     return [];
@@ -511,23 +557,210 @@ function getBatchIds(attributes, primitive, images) {
 }
 
 function convertMaterials() {
-  var sourceMaterials = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
-  var result = [];
-  var _iterator4 = _createForOfIteratorHelper(sourceMaterials),
-    _step4;
-  try {
-    for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
-      var sourceMaterial = _step4.value;
-      result.push(convertMaterial(sourceMaterial));
-    }
-  } catch (err) {
-    _iterator4.e(err);
-  } finally {
-    _iterator4.f();
-  }
-  return result;
+  return _convertMaterials.apply(this, arguments);
+}
+function _convertMaterials() {
+  _convertMaterials = (0, _asyncToGenerator2.default)(_regenerator.default.mark(function _callee4() {
+    var sourceMaterials,
+      shouldMergeMaterials,
+      materials,
+      _iterator10,
+      _step10,
+      sourceMaterial,
+      _args4 = arguments;
+    return _regenerator.default.wrap(function _callee4$(_context4) {
+      while (1) {
+        switch (_context4.prev = _context4.next) {
+          case 0:
+            sourceMaterials = _args4.length > 0 && _args4[0] !== undefined ? _args4[0] : [];
+            shouldMergeMaterials = _args4.length > 1 ? _args4[1] : undefined;
+            materials = [];
+            _iterator10 = _createForOfIteratorHelper(sourceMaterials);
+            try {
+              for (_iterator10.s(); !(_step10 = _iterator10.n()).done;) {
+                sourceMaterial = _step10.value;
+                materials.push(convertMaterial(sourceMaterial));
+              }
+            } catch (err) {
+              _iterator10.e(err);
+            } finally {
+              _iterator10.f();
+            }
+            if (!shouldMergeMaterials) {
+              _context4.next = 9;
+              break;
+            }
+            _context4.next = 8;
+            return mergeAllMaterials(materials);
+          case 8:
+            materials = _context4.sent;
+          case 9:
+            return _context4.abrupt("return", materials);
+          case 10:
+          case "end":
+            return _context4.stop();
+        }
+      }
+    }, _callee4);
+  }));
+  return _convertMaterials.apply(this, arguments);
+}
+function mergeAllMaterials(_x15) {
+  return _mergeAllMaterials.apply(this, arguments);
+}
+function _mergeAllMaterials() {
+  _mergeAllMaterials = (0, _asyncToGenerator2.default)(_regenerator.default.mark(function _callee5(materials) {
+    var result, newMaterial, mergedIndices, i, material, _newMaterial$mergedMa, _newMaterial$mergedMa2, newWidth, newHeight, currentX, _iterator11, _step11, aTextureMetadata, newX, _iterator12, _step12, index;
+    return _regenerator.default.wrap(function _callee5$(_context5) {
+      while (1) {
+        switch (_context5.prev = _context5.next) {
+          case 0:
+            result = [];
+          case 1:
+            if (!(materials.length > 0)) {
+              _context5.next = 21;
+              break;
+            }
+            newMaterial = materials.splice(0, 1)[0];
+            mergedIndices = [];
+            i = 0;
+          case 5:
+            if (!(i < materials.length)) {
+              _context5.next = 15;
+              break;
+            }
+            material = materials[i];
+            if (!(newMaterial.texture && material.texture || !newMaterial.texture && !material.texture)) {
+              _context5.next = 12;
+              break;
+            }
+            _context5.next = 10;
+            return mergeMaterials(newMaterial, material);
+          case 10:
+            newMaterial = _context5.sent;
+            mergedIndices.push(i);
+          case 12:
+            i++;
+            _context5.next = 5;
+            break;
+          case 15:
+            if (newMaterial.texture && mergedIndices.length) {
+              newWidth = (_newMaterial$mergedMa = newMaterial.mergedMaterials) === null || _newMaterial$mergedMa === void 0 ? void 0 : _newMaterial$mergedMa.reduce(function (accum, _ref4) {
+                var textureSize = _ref4.textureSize;
+                return accum + ((textureSize === null || textureSize === void 0 ? void 0 : textureSize.width) || 0);
+              }, 0);
+              newHeight = (_newMaterial$mergedMa2 = newMaterial.mergedMaterials) === null || _newMaterial$mergedMa2 === void 0 ? void 0 : _newMaterial$mergedMa2.reduce(function (accum, _ref5) {
+                var textureSize = _ref5.textureSize;
+                return Math.max(accum, (textureSize === null || textureSize === void 0 ? void 0 : textureSize.height) || 0);
+              }, 0);
+              currentX = -1;
+              _iterator11 = _createForOfIteratorHelper(newMaterial.mergedMaterials);
+              try {
+                for (_iterator11.s(); !(_step11 = _iterator11.n()).done;) {
+                  aTextureMetadata = _step11.value;
+                  if (aTextureMetadata.textureSize) {
+                    newX = currentX + 1 + aTextureMetadata.textureSize.width / newWidth * Math.pow(2, Uint16Array.BYTES_PER_ELEMENT * 8) - 1;
+                    aTextureMetadata.uvRegion = new Uint16Array([currentX + 1, 0, newX, aTextureMetadata.textureSize.height / newHeight * Math.pow(2, Uint16Array.BYTES_PER_ELEMENT * 8) - 1]);
+                    currentX = newX;
+                  }
+                }
+              } catch (err) {
+                _iterator11.e(err);
+              } finally {
+                _iterator11.f();
+              }
+              newMaterial.texture.image.width = newWidth;
+              newMaterial.texture.image.height = newHeight;
+            }
+            _iterator12 = _createForOfIteratorHelper(mergedIndices.reverse());
+            try {
+              for (_iterator12.s(); !(_step12 = _iterator12.n()).done;) {
+                index = _step12.value;
+                materials.splice(index, 1);
+              }
+            } catch (err) {
+              _iterator12.e(err);
+            } finally {
+              _iterator12.f();
+            }
+            result.push(newMaterial);
+            _context5.next = 1;
+            break;
+          case 21:
+            if (!result.length) {
+              result.push({
+                material: getDefaultMaterial(),
+                mergedMaterials: [{
+                  originalMaterialId: 'default'
+                }]
+              });
+            }
+            return _context5.abrupt("return", result);
+          case 23:
+          case "end":
+            return _context5.stop();
+        }
+      }
+    }, _callee5);
+  }));
+  return _mergeAllMaterials.apply(this, arguments);
+}
+function mergeMaterials(_x16, _x17) {
+  return _mergeMaterials.apply(this, arguments);
+}
+function _mergeMaterials() {
+  _mergeMaterials = (0, _asyncToGenerator2.default)(_regenerator.default.mark(function _callee6(material1, material2) {
+    var _material1$texture, _material2$texture;
+    var buffer1, buffer2, _yield$import, joinImages, sharpData;
+    return _regenerator.default.wrap(function _callee6$(_context6) {
+      while (1) {
+        switch (_context6.prev = _context6.next) {
+          case 0:
+            if (!((_material1$texture = material1.texture) !== null && _material1$texture !== void 0 && _material1$texture.bufferView && (_material2$texture = material2.texture) !== null && _material2$texture !== void 0 && _material2$texture.bufferView && material1.mergedMaterials && material2.mergedMaterials)) {
+              _context6.next = 21;
+              break;
+            }
+            buffer1 = Buffer.from(material1.texture.bufferView.data);
+            buffer2 = Buffer.from(material2.texture.bufferView.data);
+            _context6.prev = 3;
+            _context6.next = 6;
+            return Promise.resolve().then(function () {
+              return _interopRequireWildcard(require('join-images'));
+            });
+          case 6:
+            _yield$import = _context6.sent;
+            joinImages = _yield$import.joinImages;
+            _context6.next = 10;
+            return joinImages([buffer1, buffer2], {
+              direction: 'horizontal'
+            });
+          case 10:
+            sharpData = _context6.sent;
+            _context6.next = 13;
+            return sharpData.toFormat(material1.texture.mimeType === 'image/png' ? 'png' : 'jpeg').toBuffer();
+          case 13:
+            material1.texture.bufferView.data = _context6.sent;
+            _context6.next = 20;
+            break;
+          case 16:
+            _context6.prev = 16;
+            _context6.t0 = _context6["catch"](3);
+            console.log('Join images into a texture atlas has failed. Consider usage `--split-nodes` option. (See documentation https://loaders.gl/modules/tile-converter/docs/cli-reference/tile-converter)');
+            throw _context6.t0;
+          case 20:
+            material1.material.pbrMetallicRoughness.baseColorTexture.textureSetDefinitionId = 1;
+          case 21:
+            material1.mergedMaterials = material1.mergedMaterials.concat(material2.mergedMaterials);
+            return _context6.abrupt("return", material1);
+          case 23:
+          case "end":
+            return _context6.stop();
+        }
+      }
+    }, _callee6, null, [[3, 16]]);
+  }));
+  return _mergeMaterials.apply(this, arguments);
 }
-
 function convertMaterial(sourceMaterial) {
   var _sourceMaterial$emiss, _sourceMaterial$pbrMe, _sourceMaterial$pbrMe2, _sourceMaterial$pbrMe3;
   var material = {
@@ -553,16 +786,27 @@ function convertMaterial(sourceMaterial) {
       textureSetDefinitionId: 0
     };
   }
+  var uniqueId = (0, _uuid.v4)();
+  sourceMaterial.uniqueId = uniqueId;
+  var mergedMaterials = [{
+    originalMaterialId: uniqueId
+  }];
   if (!texture) {
     var _sourceMaterial$pbrMe4;
     var baseColorFactor = sourceMaterial === null || sourceMaterial === void 0 ? void 0 : (_sourceMaterial$pbrMe4 = sourceMaterial.pbrMetallicRoughness) === null || _sourceMaterial$pbrMe4 === void 0 ? void 0 : _sourceMaterial$pbrMe4.baseColorFactor;
     material.pbrMetallicRoughness.baseColorFactor = baseColorFactor && baseColorFactor.map(function (c) {
       return Math.round(c * 255);
     }) || undefined;
+  } else {
+    mergedMaterials[0].textureSize = {
+      width: texture.image.width,
+      height: texture.image.height
+    };
   }
   return {
     material: material,
-    texture: texture
+    texture: texture,
+    mergedMaterials: mergedMaterials
   };
 }
 
@@ -595,11 +839,11 @@ function getSharedResources(gltfMaterials, nodeId) {
     return i3sResources;
   }
   i3sResources.materialDefinitionInfos = [];
-  var _iterator5 = _createForOfIteratorHelper(gltfMaterials),
-    _step5;
+  var _iterator4 = _createForOfIteratorHelper(gltfMaterials),
+    _step4;
   try {
-    for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
-      var gltfMaterial = _step5.value;
+    for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
+      var gltfMaterial = _step4.value;
       var _convertGLTFMaterialT = convertGLTFMaterialToI3sSharedResources(gltfMaterial, nodeId),
         materialDefinitionInfo = _convertGLTFMaterialT.materialDefinitionInfo,
         textureDefinitionInfo = _convertGLTFMaterialT.textureDefinitionInfo;
@@ -610,9 +854,9 @@ function getSharedResources(gltfMaterials, nodeId) {
       }
     }
   } catch (err) {
-    _iterator5.e(err);
+    _iterator4.e(err);
   } finally {
-    _iterator5.f();
+    _iterator4.f();
   }
   return i3sResources;
 }
@@ -624,9 +868,9 @@ function convertGLTFMaterialToI3sSharedResources(gltfMaterial, nodeId) {
   if (texture) {
     textureDefinitionInfo = extractSharedResourcesTextureInfo(texture.texture, nodeId);
   }
-  var _ref2 = (gltfMaterial === null || gltfMaterial === void 0 ? void 0 : gltfMaterial.pbrMetallicRoughness) || {},
-    baseColorFactor = _ref2.baseColorFactor,
-    metallicFactor = _ref2.metallicFactor;
+  var _ref3 = (gltfMaterial === null || gltfMaterial === void 0 ? void 0 : gltfMaterial.pbrMetallicRoughness) || {},
+    baseColorFactor = _ref3.baseColorFactor,
+    metallicFactor = _ref3.metallicFactor;
   var colorFactor = baseColorFactor;
   if ((!baseColorFactor || baseColorFactor[3] === 0) && gltfMaterial.emissiveFactor) {
     colorFactor = gltfMaterial.emissiveFactor;
@@ -808,17 +1052,17 @@ function generateBigUint64Array(featureIds) {
   return typedFeatureIds;
 }
 
-function generateCompressedGeometry(_x13, _x14, _x15, _x16) {
+function generateCompressedGeometry(_x18, _x19, _x20, _x21) {
   return _generateCompressedGeometry.apply(this, arguments);
 }
 function _generateCompressedGeometry() {
-  _generateCompressedGeometry = (0, _asyncToGenerator2.default)(_regenerator.default.mark(function _callee4(vertexCount, convertedAttributes, attributes, dracoWorkerSoure) {
-    var positions, normals, texCoords, colors, featureIds, faceRange, indices, index, featureIndices, featureIndex, compressedAttributes, attributesMetadata;
-    return _regenerator.default.wrap(function _callee4$(_context4) {
+  _generateCompressedGeometry = (0, _asyncToGenerator2.default)(_regenerator.default.mark(function _callee7(vertexCount, convertedAttributes, attributes, dracoWorkerSoure) {
+    var positions, normals, texCoords, colors, uvRegions, featureIds, faceRange, indices, index, featureIndices, featureIndex, compressedAttributes, attributesMetadata;
+    return _regenerator.default.wrap(function _callee7$(_context7) {
       while (1) {
-        switch (_context4.prev = _context4.next) {
+        switch (_context7.prev = _context7.next) {
           case 0:
-            positions = attributes.positions, normals = attributes.normals, texCoords = attributes.texCoords, colors = attributes.colors, featureIds = attributes.featureIds, faceRange = attributes.faceRange;
+            positions = attributes.positions, normals = attributes.normals, texCoords = attributes.texCoords, colors = attributes.colors, uvRegions = attributes.uvRegions, featureIds = attributes.featureIds, faceRange = attributes.faceRange;
             indices = new Uint32Array(vertexCount);
             for (index = 0; index < indices.length; index++) {
               indices.set([index], index);
@@ -840,7 +1084,13 @@ function _generateCompressedGeometry() {
                 'i3s-feature-ids': new Int32Array(featureIds)
               }
             };
-            return _context4.abrupt("return", (0, _core2.encode)({
+            if (uvRegions.length) {
+              compressedAttributes['uv-region'] = uvRegions;
+              attributesMetadata['uv-region'] = {
+                'i3s-attribute-type': 'uv-region'
+              };
+            }
+            return _context7.abrupt("return", (0, _core2.encode)({
               attributes: compressedAttributes,
               indices: indices
             }, _draco.DracoWriterWorker, _objectSpread(_objectSpread({}, _draco.DracoWriterWorker.options), {}, {
@@ -852,12 +1102,12 @@ function _generateCompressedGeometry() {
                 attributesMetadata: attributesMetadata
               }
             })));
-          case 9:
+          case 10:
           case "end":
-            return _context4.stop();
+            return _context7.stop();
         }
       }
-    }, _callee4);
+    }, _callee7);
   }));
   return _generateCompressedGeometry.apply(this, arguments);
 }
@@ -908,20 +1158,20 @@ function getPropertyTableExtension(tileContent) {
     };
   }
   var extensionName = '';
-  var _iterator6 = _createForOfIteratorHelper((tileContent === null || tileContent === void 0 ? void 0 : (_tileContent$gltf3 = tileContent.gltf) === null || _tileContent$gltf3 === void 0 ? void 0 : _tileContent$gltf3.extensionsUsed) || []),
-    _step6;
+  var _iterator5 = _createForOfIteratorHelper((tileContent === null || tileContent === void 0 ? void 0 : (_tileContent$gltf3 = tileContent.gltf) === null || _tileContent$gltf3 === void 0 ? void 0 : _tileContent$gltf3.extensionsUsed) || []),
+    _step5;
   try {
-    for (_iterator6.s(); !(_step6 = _iterator6.n()).done;) {
-      var extensionItem = _step6.value;
+    for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
+      var extensionItem = _step5.value;
       if (extensionsWithPropertyTables.includes(extensionItem)) {
         extensionName = extensionItem;
         break;
       }
     }
   } catch (err) {
-    _iterator6.e(err);
+    _iterator5.e(err);
   } finally {
-    _iterator6.f();
+    _iterator5.f();
   }
   var extension = tileContent === null || tileContent === void 0 ? void 0 : (_tileContent$gltf2 = tileContent.gltf) === null || _tileContent$gltf2 === void 0 ? void 0 : (_tileContent$gltf2$ex = _tileContent$gltf2.extensions) === null || _tileContent$gltf2$ex === void 0 ? void 0 : _tileContent$gltf2$ex[extensionName];
   return {