@xeokit/xeokit-sdk 2.6.100 → 2.6.101

package/dist/xeokit-sdk.cjs.js

@@ -1,11 +1,11 @@
 /**
- * xeokit-sdk v2.6.100
- *  Commit: 7a4d724a55a508d0bb365f751ff9e10dddfe9af8
- *  Built: 2025-12-12T19:59:05.622Z
+ * xeokit-sdk v2.6.101
+ *  Commit: cc32112384a95de94907d31b3001855a94b23fd3
+ *  Built: 2025-12-22T10:25:15.233Z
  */
 
 if (typeof window !== 'undefined') {
-    window.__XEOKIT__ = { version: '2.6.100', commit: '7a4d724a55a508d0bb365f751ff9e10dddfe9af8', built: '2025-12-12T19:59:05.622Z' };
+    window.__XEOKIT__ = { version: '2.6.101', commit: 'cc32112384a95de94907d31b3001855a94b23fd3', built: '2025-12-22T10:25:15.233Z' };
 }
 
 'use strict';
@@ -2513,6 +2513,25 @@ const math = {
         return dest;
     },
 
+    /**
+     * Multiplies one three-element vector by another.
+     * @method mulVec3
+     * @static
+     * @param {Array(Number)} u First vector
+     * @param {Array(Number)} v Second vector
+     * @param  {Array(Number)} [dest] Destination vector
+     * @return {Array(Number)} dest if specified, u otherwise
+     */
+    mulVec3(u, v, dest) {
+        if (!dest) {
+            dest = u;
+        }
+        dest[0] = u[0] * v[0];
+        dest[1] = u[1] * v[1];
+        dest[2] = u[2] * v[2];
+        return dest;
+    },
+
     /**
      * Multiplies one four-element vector by another.
      * @method mulVec4
@@ -12768,9 +12787,9 @@ const createPositionsDecodeMatrix$1 = (function () {
         const xmin = aabb[0];
         const ymin = aabb[1];
         const zmin = aabb[2];
-        const xwid = aabb[3] - xmin;
-        const ywid = aabb[4] - ymin;
-        const zwid = aabb[5] - zmin;
+        const xwid = (aabb[3] - xmin) || 1;
+        const ywid = (aabb[4] - ymin) || 1;
+        const zwid = (aabb[5] - zmin) || 1;
         const maxInt = 65535;
         math.identityMat4(translate);
         math.translationMat4v(aabb, translate);
@@ -33022,7 +33041,9 @@ class DTXLayer extends Layer {
                             }
                         }
                     };
-                }
+                },
+
+                _clearToOptimizeGC: () => { indicesBuffer.length = edgeIndicesBuffer.length = 0; }
             };
         };
 
@@ -33323,7 +33344,14 @@ class DTXLayer extends Layer {
         const draw16 = buffer.geometry16Bits.createDrawers(createTextureForSingleItems, gl.UNSIGNED_SHORT);
         const draw32 = buffer.geometry32Bits.createDrawers(createTextureForSingleItems, gl.UNSIGNED_INT);
 
-        // Free up memory
+        // Optimization to free up memory (XCD-408 and XCD-424).
+        // The following lines were added to assist GC in cleaning up some of the data. See also the `texArray = null`.
+        // A Chrome test with Lyon[1-9].xkt models loaded simultaneously showed a decrease of 596MB to 158MB.
+        this._bucketGeometries = null;
+        this._buffer.geometry8Bits._clearToOptimizeGC();
+        this._buffer.geometry16Bits._clearToOptimizeGC();
+        this._buffer.geometry32Bits._clearToOptimizeGC();
+        Object.keys(this._buffer).forEach(k => this._buffer[k] = null);
         this._buffer = null;
 
         let deferredSetFlagsActive = false;
@@ -33534,7 +33562,7 @@ const createBindableDataTexture = function(gl, entitiesCnt, entitySize, type, en
     if (textureHeight === 0) {
         throw "texture height===0";
     }
-    const texArray = new arrayType(textureWidth * textureHeight * pixelWidth);
+    let texArray = new arrayType(textureWidth * textureHeight * pixelWidth);
     dataTextureRamStats[statsProp] += texArray.byteLength;
     dataTextureRamStats.numberOfTextures++;
 
@@ -33550,6 +33578,10 @@ const createBindableDataTexture = function(gl, entitiesCnt, entitySize, type, en
     gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);
     gl.bindTexture(gl.TEXTURE_2D, null);
 
+    if (! exposeData) {
+        texArray = null; // See the comment related to XCD-408 and XCD-424 above.
+    }
+
     return {
         // called by createSampler::bindTexture
         bind(unit) {
@@ -34053,7 +34085,8 @@ class VBOLayer extends Layer {
                     });
 
                     return buf;
-                }
+                },
+                _clearToOptimizeGC: () => { portions.length = 0; }
             };
         };
 
@@ -34380,12 +34413,13 @@ class VBOLayer extends Layer {
                               : (quantizePositions(buffer.positions.compileBuffer(Float64Array), modelAABB, positionsDecodeMatrix = math.mat4()))));
         const positionsBuf = positions && maybeCreateBuffer(positions, 3, gl.STATIC_DRAW);
         if (! instancing) {
-            portions.forEach(portion => {
-                if (portion.retainedGeometry) {
+            for (let i = 0; i < portions.length; ++i) { // WARNING: Replacing this for-loop by forEach increases memory consumption
+                const portion = portions[i];            // by not GCing `positions` arr, even if portion.retainedGeometry is false.
+                if (portion.retainedGeometry) {         // See the comment related to XCD-408 and XCD-424 below.
                     const start = 3 * portion.portionBase;
                     portion.retainedGeometry.quantizedPositions = positions.subarray(start, start + 3 * portion.portionSize);
                 }
-            });
+            }
         }
 
         const modelMatrixColBufs = instancing && buffer.modelMatrixCol.map(b => maybeCreateBuffer(b.compileBuffer(Float32Array), 4, gl.STATIC_DRAW, true));
@@ -34424,6 +34458,10 @@ class VBOLayer extends Layer {
                          })());
 
         // Free up memory
+        // Optimization to free up memory (XCD-408 and XCD-424)
+        // The following line was added to assist GC in cleaning up some of the data. See also the `portions` loop above.
+        // A Chrome test with Lyon[1-9].xkt models loaded simultaneously showed a decrease of 538MB to 143MB.
+        Object.values(this._buffer).forEach(a => a._clearToOptimizeGC ? a._clearToOptimizeGC() : a.forEach(a => a._clearToOptimizeGC()));
         this._buffer = null;
 
         scratchMemory.acquire();

package/dist/xeokit-sdk.es.js

@@ -1,11 +1,11 @@
 /**
- * xeokit-sdk v2.6.100
- *  Commit: 7a4d724a55a508d0bb365f751ff9e10dddfe9af8
- *  Built: 2025-12-12T19:59:05.622Z
+ * xeokit-sdk v2.6.101
+ *  Commit: cc32112384a95de94907d31b3001855a94b23fd3
+ *  Built: 2025-12-22T10:25:15.233Z
  */
 
 if (typeof window !== 'undefined') {
-    window.__XEOKIT__ = { version: '2.6.100', commit: '7a4d724a55a508d0bb365f751ff9e10dddfe9af8', built: '2025-12-12T19:59:05.622Z' };
+    window.__XEOKIT__ = { version: '2.6.101', commit: 'cc32112384a95de94907d31b3001855a94b23fd3', built: '2025-12-22T10:25:15.233Z' };
 }
 
 /** @private */
@@ -2509,6 +2509,25 @@ const math = {
         return dest;
     },
 
+    /**
+     * Multiplies one three-element vector by another.
+     * @method mulVec3
+     * @static
+     * @param {Array(Number)} u First vector
+     * @param {Array(Number)} v Second vector
+     * @param  {Array(Number)} [dest] Destination vector
+     * @return {Array(Number)} dest if specified, u otherwise
+     */
+    mulVec3(u, v, dest) {
+        if (!dest) {
+            dest = u;
+        }
+        dest[0] = u[0] * v[0];
+        dest[1] = u[1] * v[1];
+        dest[2] = u[2] * v[2];
+        return dest;
+    },
+
     /**
      * Multiplies one four-element vector by another.
      * @method mulVec4
@@ -12764,9 +12783,9 @@ const createPositionsDecodeMatrix$1 = (function () {
         const xmin = aabb[0];
         const ymin = aabb[1];
         const zmin = aabb[2];
-        const xwid = aabb[3] - xmin;
-        const ywid = aabb[4] - ymin;
-        const zwid = aabb[5] - zmin;
+        const xwid = (aabb[3] - xmin) || 1;
+        const ywid = (aabb[4] - ymin) || 1;
+        const zwid = (aabb[5] - zmin) || 1;
         const maxInt = 65535;
         math.identityMat4(translate);
         math.translationMat4v(aabb, translate);
@@ -33018,7 +33037,9 @@ class DTXLayer extends Layer {
                             }
                         }
                     };
-                }
+                },
+
+                _clearToOptimizeGC: () => { indicesBuffer.length = edgeIndicesBuffer.length = 0; }
             };
         };
 
@@ -33319,7 +33340,14 @@ class DTXLayer extends Layer {
         const draw16 = buffer.geometry16Bits.createDrawers(createTextureForSingleItems, gl.UNSIGNED_SHORT);
         const draw32 = buffer.geometry32Bits.createDrawers(createTextureForSingleItems, gl.UNSIGNED_INT);
 
-        // Free up memory
+        // Optimization to free up memory (XCD-408 and XCD-424).
+        // The following lines were added to assist GC in cleaning up some of the data. See also the `texArray = null`.
+        // A Chrome test with Lyon[1-9].xkt models loaded simultaneously showed a decrease of 596MB to 158MB.
+        this._bucketGeometries = null;
+        this._buffer.geometry8Bits._clearToOptimizeGC();
+        this._buffer.geometry16Bits._clearToOptimizeGC();
+        this._buffer.geometry32Bits._clearToOptimizeGC();
+        Object.keys(this._buffer).forEach(k => this._buffer[k] = null);
         this._buffer = null;
 
         let deferredSetFlagsActive = false;
@@ -33530,7 +33558,7 @@ const createBindableDataTexture = function(gl, entitiesCnt, entitySize, type, en
     if (textureHeight === 0) {
         throw "texture height===0";
     }
-    const texArray = new arrayType(textureWidth * textureHeight * pixelWidth);
+    let texArray = new arrayType(textureWidth * textureHeight * pixelWidth);
     dataTextureRamStats[statsProp] += texArray.byteLength;
     dataTextureRamStats.numberOfTextures++;
 
@@ -33546,6 +33574,10 @@ const createBindableDataTexture = function(gl, entitiesCnt, entitySize, type, en
     gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);
     gl.bindTexture(gl.TEXTURE_2D, null);
 
+    if (! exposeData) {
+        texArray = null; // See the comment related to XCD-408 and XCD-424 above.
+    }
+
     return {
         // called by createSampler::bindTexture
         bind(unit) {
@@ -34049,7 +34081,8 @@ class VBOLayer extends Layer {
                     });
 
                     return buf;
-                }
+                },
+                _clearToOptimizeGC: () => { portions.length = 0; }
             };
         };
 
@@ -34376,12 +34409,13 @@ class VBOLayer extends Layer {
                               : (quantizePositions(buffer.positions.compileBuffer(Float64Array), modelAABB, positionsDecodeMatrix = math.mat4()))));
         const positionsBuf = positions && maybeCreateBuffer(positions, 3, gl.STATIC_DRAW);
         if (! instancing) {
-            portions.forEach(portion => {
-                if (portion.retainedGeometry) {
+            for (let i = 0; i < portions.length; ++i) { // WARNING: Replacing this for-loop by forEach increases memory consumption
+                const portion = portions[i];            // by not GCing `positions` arr, even if portion.retainedGeometry is false.
+                if (portion.retainedGeometry) {         // See the comment related to XCD-408 and XCD-424 below.
                     const start = 3 * portion.portionBase;
                     portion.retainedGeometry.quantizedPositions = positions.subarray(start, start + 3 * portion.portionSize);
                 }
-            });
+            }
         }
 
         const modelMatrixColBufs = instancing && buffer.modelMatrixCol.map(b => maybeCreateBuffer(b.compileBuffer(Float32Array), 4, gl.STATIC_DRAW, true));
@@ -34420,6 +34454,10 @@ class VBOLayer extends Layer {
                          })());
 
         // Free up memory
+        // Optimization to free up memory (XCD-408 and XCD-424)
+        // The following line was added to assist GC in cleaning up some of the data. See also the `portions` loop above.
+        // A Chrome test with Lyon[1-9].xkt models loaded simultaneously showed a decrease of 538MB to 143MB.
+        Object.values(this._buffer).forEach(a => a._clearToOptimizeGC ? a._clearToOptimizeGC() : a.forEach(a => a._clearToOptimizeGC()));
         this._buffer = null;
 
         scratchMemory.acquire();