@needle-tools/gltf-progressive 3.6.1 → 3.6.2

package/lib/loaders.js

@@ -40,7 +40,8 @@ fetch(_remoteDracoDecoderUrl, {
     }
 })
     .finally(() => {
-    prepareLoaders();
+    if (preloadLoaders)
+        prepareLoaders();
 });
 // #region Loader Configuration
 /**
@@ -89,15 +90,25 @@ export function setKTX2TranscoderLocation(location) {
  * @returns The loaders/decoders.
  */
 export function createLoaders(renderer) {
-    prepareLoaders();
+    preloadLoaders = true;
+    const loaders = prepareLoaders();
     if (renderer) {
-        ktx2Loader.detectSupport(renderer);
+        loaders.ktx2Loader.detectSupport(renderer);
     }
     else if (renderer !== null)
         console.warn("No renderer provided to detect ktx2 support - loading KTX2 textures might fail");
-    return { dracoLoader, ktx2Loader, meshoptDecoder };
+    return loaders;
+}
+/** Release the shared Draco and KTX2 workers when no engine context uses them. */
+export function disposeLoaders() {
+    preloadLoaders = false;
+    dracoLoader?.dispose();
+    ktx2Loader?.dispose();
+    dracoLoader = undefined;
+    ktx2Loader = undefined;
 }
 export function addDracoAndKTX2Loaders(loader) {
+    const { dracoLoader, ktx2Loader, meshoptDecoder } = prepareLoaders();
     if (!loader.dracoLoader)
         loader.setDRACOLoader(dracoLoader);
     if (!loader.ktx2Loader)
@@ -107,6 +118,7 @@ export function addDracoAndKTX2Loaders(loader) {
 }
 // #region internal
 const $dracoDecoderPath = Symbol("dracoDecoderPath");
+let preloadLoaders = true;
 let dracoLoader;
 let meshoptDecoder;
 let ktx2Loader;
@@ -127,6 +139,7 @@ function prepareLoaders() {
     if (!meshoptDecoder) {
         meshoptDecoder = MeshoptDecoder;
     }
+    return { dracoLoader, ktx2Loader, meshoptDecoder };
 }
 const gltfLoaderConfigurations = new WeakMap();
 export function configureLoader(loader, opts) {

package/lib/version.js

@@ -1,4 +1,4 @@
 // replaced at build time
-export const version = "3.6.1";
+export const version = "3.6.2";
 globalThis["GLTF_PROGRESSIVE_VERSION"] = version;
 console.debug(`[gltf-progressive] version ${version || "-"}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@needle-tools/gltf-progressive",
-  "version": "3.6.1",
+  "version": "3.6.2",
   "description": "three.js support for loading glTF or GLB files that contain progressive loading data",
   "homepage": "https://needle.tools",
   "author": {