three-stdlib 2.16.0 → 2.16.2

package/loaders/KTX2Loader.js

@@ -1,143 +1,195 @@
-"use strict";
-Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
-const THREE = require("three");
-const WorkerPool = require("../utils/WorkerPool.js");
-const ktxParse = require("ktx-parse");
-const zstddec = require("zstddec");
-const _taskCache = /* @__PURE__ */ new WeakMap();
+import { Loader, FileLoader, CompressedTexture, UnsignedByteType, LinearFilter, LinearMipmapLinearFilter, sRGBEncoding, LinearEncoding, RGBAFormat, RGBA_ASTC_4x4_Format, RGBA_BPTC_Format, RGBA_ETC2_EAC_Format, RGBA_PVRTC_4BPPV1_Format, RGBA_S3TC_DXT5_Format, RGB_ETC1_Format, RGB_ETC2_Format, RGB_PVRTC_4BPPV1_Format, RGB_S3TC_DXT1_Format, FloatType, HalfFloatType, DataTexture, Data3DTexture, RGFormat, RedFormat } from 'three';
+import { WorkerPool } from '../utils/WorkerPool.js';
+import { KHR_DF_TRANSFER_SRGB, KHR_DF_FLAG_ALPHA_PREMULTIPLIED, read, VK_FORMAT_UNDEFINED, KHR_SUPERCOMPRESSION_NONE, KHR_SUPERCOMPRESSION_ZSTD, VK_FORMAT_R32G32B32A32_SFLOAT, VK_FORMAT_R16G16B16A16_SFLOAT, VK_FORMAT_R8G8B8A8_UNORM, VK_FORMAT_R8G8B8A8_SRGB, VK_FORMAT_R32G32_SFLOAT, VK_FORMAT_R16G16_SFLOAT, VK_FORMAT_R8G8_UNORM, VK_FORMAT_R8G8_SRGB, VK_FORMAT_R32_SFLOAT, VK_FORMAT_R16_SFLOAT, VK_FORMAT_R8_SRGB, VK_FORMAT_R8_UNORM } from 'ktx-parse';
+import { ZSTDDecoder } from 'zstddec';
+
+/**
+ * Loader for KTX 2.0 GPU Texture containers.
+ *
+ * KTX 2.0 is a container format for various GPU texture formats. The loader
+ * supports Basis Universal GPU textures, which can be quickly transcoded to
+ * a wide variety of GPU texture compression formats, as well as some
+ * uncompressed DataTexture and Data3DTexture formats.
+ *
+ * References:
+ * - KTX: http://github.khronos.org/KTX-Specification/
+ * - DFD: https://www.khronos.org/registry/DataFormat/specs/1.3/dataformat.1.3.html#basicdescriptor
+ */
+
+const _taskCache = new WeakMap();
+
 let _activeLoaders = 0;
+
 let _zstd;
-class KTX2Loader extends THREE.Loader {
+
+class KTX2Loader extends Loader {
   constructor(manager) {
     super(manager);
-    this.transcoderPath = "";
+    this.transcoderPath = '';
     this.transcoderBinary = null;
     this.transcoderPending = null;
-    this.workerPool = new WorkerPool.WorkerPool();
-    this.workerSourceURL = "";
+    this.workerPool = new WorkerPool();
+    this.workerSourceURL = '';
     this.workerConfig = null;
-    if (typeof MSC_TRANSCODER !== "undefined") {
-      console.warn(
-        'THREE.KTX2Loader: Please update to latest "basis_transcoder". "msc_basis_transcoder" is no longer supported in three.js r125+.'
-      );
+
+    if (typeof MSC_TRANSCODER !== 'undefined') {
+      console.warn('THREE.KTX2Loader: Please update to latest "basis_transcoder".' + ' "msc_basis_transcoder" is no longer supported in three.js r125+.');
     }
   }
+
   setTranscoderPath(path) {
     this.transcoderPath = path;
     return this;
   }
+
   setWorkerLimit(num) {
     this.workerPool.setWorkerLimit(num);
     return this;
   }
+
   detectSupport(renderer) {
     this.workerConfig = {
-      astcSupported: renderer.extensions.has("WEBGL_compressed_texture_astc"),
-      etc1Supported: renderer.extensions.has("WEBGL_compressed_texture_etc1"),
-      etc2Supported: renderer.extensions.has("WEBGL_compressed_texture_etc"),
-      dxtSupported: renderer.extensions.has("WEBGL_compressed_texture_s3tc"),
-      bptcSupported: renderer.extensions.has("EXT_texture_compression_bptc"),
-      pvrtcSupported: renderer.extensions.has("WEBGL_compressed_texture_pvrtc") || renderer.extensions.has("WEBKIT_WEBGL_compressed_texture_pvrtc")
+      astcSupported: renderer.extensions.has('WEBGL_compressed_texture_astc'),
+      etc1Supported: renderer.extensions.has('WEBGL_compressed_texture_etc1'),
+      etc2Supported: renderer.extensions.has('WEBGL_compressed_texture_etc'),
+      dxtSupported: renderer.extensions.has('WEBGL_compressed_texture_s3tc'),
+      bptcSupported: renderer.extensions.has('EXT_texture_compression_bptc'),
+      pvrtcSupported: renderer.extensions.has('WEBGL_compressed_texture_pvrtc') || renderer.extensions.has('WEBKIT_WEBGL_compressed_texture_pvrtc')
     };
+
     if (renderer.capabilities.isWebGL2) {
+      // https://github.com/mrdoob/three.js/pull/22928
       this.workerConfig.etc1Supported = false;
     }
+
     return this;
   }
+
   init() {
     if (!this.transcoderPending) {
-      const jsLoader = new THREE.FileLoader(this.manager);
+      // Load transcoder wrapper.
+      const jsLoader = new FileLoader(this.manager);
       jsLoader.setPath(this.transcoderPath);
       jsLoader.setWithCredentials(this.withCredentials);
-      const jsContent = jsLoader.loadAsync("basis_transcoder.js");
-      const binaryLoader = new THREE.FileLoader(this.manager);
+      const jsContent = jsLoader.loadAsync('basis_transcoder.js'); // Load transcoder WASM binary.
+
+      const binaryLoader = new FileLoader(this.manager);
       binaryLoader.setPath(this.transcoderPath);
-      binaryLoader.setResponseType("arraybuffer");
+      binaryLoader.setResponseType('arraybuffer');
       binaryLoader.setWithCredentials(this.withCredentials);
-      const binaryContent = binaryLoader.loadAsync("basis_transcoder.wasm");
-      this.transcoderPending = Promise.all([jsContent, binaryContent]).then(([jsContent2, binaryContent2]) => {
+      const binaryContent = binaryLoader.loadAsync('basis_transcoder.wasm');
+      this.transcoderPending = Promise.all([jsContent, binaryContent]).then(([jsContent, binaryContent]) => {
         const fn = KTX2Loader.BasisWorker.toString();
-        const body = [
-          "/* constants */",
-          "let _EngineFormat = " + JSON.stringify(KTX2Loader.EngineFormat),
-          "let _TranscoderFormat = " + JSON.stringify(KTX2Loader.TranscoderFormat),
-          "let _BasisFormat = " + JSON.stringify(KTX2Loader.BasisFormat),
-          "/* basis_transcoder.js */",
-          jsContent2,
-          "/* worker */",
-          fn.substring(fn.indexOf("{") + 1, fn.lastIndexOf("}"))
-        ].join("\n");
+        const body = ['/* constants */', 'let _EngineFormat = ' + JSON.stringify(KTX2Loader.EngineFormat), 'let _TranscoderFormat = ' + JSON.stringify(KTX2Loader.TranscoderFormat), 'let _BasisFormat = ' + JSON.stringify(KTX2Loader.BasisFormat), '/* basis_transcoder.js */', jsContent, '/* worker */', fn.substring(fn.indexOf('{') + 1, fn.lastIndexOf('}'))].join('\n');
         this.workerSourceURL = URL.createObjectURL(new Blob([body]));
-        this.transcoderBinary = binaryContent2;
+        this.transcoderBinary = binaryContent;
         this.workerPool.setWorkerCreator(() => {
           const worker = new Worker(this.workerSourceURL);
           const transcoderBinary = this.transcoderBinary.slice(0);
-          worker.postMessage({ type: "init", config: this.workerConfig, transcoderBinary }, [transcoderBinary]);
+          worker.postMessage({
+            type: 'init',
+            config: this.workerConfig,
+            transcoderBinary
+          }, [transcoderBinary]);
           return worker;
         });
       });
+
       if (_activeLoaders > 0) {
-        console.warn(
-          "THREE.KTX2Loader: Multiple active KTX2 loaders may cause performance issues. Use a single KTX2Loader instance, or call .dispose() on old instances."
-        );
+        // Each instance loads a transcoder and allocates workers, increasing network and memory cost.
+        console.warn('THREE.KTX2Loader: Multiple active KTX2 loaders may cause performance issues.' + ' Use a single KTX2Loader instance, or call .dispose() on old instances.');
       }
+
       _activeLoaders++;
     }
+
     return this.transcoderPending;
   }
+
   load(url, onLoad, onProgress, onError) {
     if (this.workerConfig === null) {
-      throw new Error("THREE.KTX2Loader: Missing initialization with `.detectSupport( renderer )`.");
+      throw new Error('THREE.KTX2Loader: Missing initialization with `.detectSupport( renderer )`.');
     }
-    const loader = new THREE.FileLoader(this.manager);
-    loader.setResponseType("arraybuffer");
+
+    const loader = new FileLoader(this.manager);
+    loader.setResponseType('arraybuffer');
     loader.setWithCredentials(this.withCredentials);
-    loader.load(
-      url,
-      (buffer) => {
-        if (_taskCache.has(buffer)) {
-          const cachedTask = _taskCache.get(buffer);
-          return cachedTask.promise.then(onLoad).catch(onError);
-        }
-        this._createTexture(buffer).then((texture) => onLoad ? onLoad(texture) : null).catch(onError);
-      },
-      onProgress,
-      onError
-    );
+    loader.load(url, buffer => {
+      // Check for an existing task using this buffer. A transferred buffer cannot be transferred
+      // again from this thread.
+      if (_taskCache.has(buffer)) {
+        const cachedTask = _taskCache.get(buffer);
+
+        return cachedTask.promise.then(onLoad).catch(onError);
+      }
+
+      this._createTexture(buffer).then(texture => onLoad ? onLoad(texture) : null).catch(onError);
+    }, onProgress, onError);
   }
+
   _createTextureFrom(transcodeResult) {
-    const { mipmaps, width, height, format, type, error, dfdTransferFn, dfdFlags } = transcodeResult;
-    if (type === "error")
-      return Promise.reject(error);
-    const texture = new THREE.CompressedTexture(mipmaps, width, height, format, THREE.UnsignedByteType);
-    texture.minFilter = mipmaps.length === 1 ? THREE.LinearFilter : THREE.LinearMipmapLinearFilter;
-    texture.magFilter = THREE.LinearFilter;
+    const {
+      mipmaps,
+      width,
+      height,
+      format,
+      type,
+      error,
+      dfdTransferFn,
+      dfdFlags
+    } = transcodeResult;
+    if (type === 'error') return Promise.reject(error);
+    const texture = new CompressedTexture(mipmaps, width, height, format, UnsignedByteType);
+    texture.minFilter = mipmaps.length === 1 ? LinearFilter : LinearMipmapLinearFilter;
+    texture.magFilter = LinearFilter;
     texture.generateMipmaps = false;
     texture.needsUpdate = true;
-    texture.encoding = dfdTransferFn === ktxParse.KHR_DF_TRANSFER_SRGB ? THREE.sRGBEncoding : THREE.LinearEncoding;
-    texture.premultiplyAlpha = !!(dfdFlags & ktxParse.KHR_DF_FLAG_ALPHA_PREMULTIPLIED);
+    texture.encoding = dfdTransferFn === KHR_DF_TRANSFER_SRGB ? sRGBEncoding : LinearEncoding;
+    texture.premultiplyAlpha = !!(dfdFlags & KHR_DF_FLAG_ALPHA_PREMULTIPLIED);
     return texture;
   }
+  /**
+   * @param {ArrayBuffer} buffer
+   * @param {object?} config
+   * @return {Promise<CompressedTexture|DataTexture|Data3DTexture>}
+   */
+
+
   _createTexture(buffer, config = {}) {
-    const container = ktxParse.read(new Uint8Array(buffer));
-    if (container.vkFormat !== ktxParse.VK_FORMAT_UNDEFINED) {
+    const container = read(new Uint8Array(buffer));
+
+    if (container.vkFormat !== VK_FORMAT_UNDEFINED) {
       return createDataTexture(container);
-    }
+    } //
+
+
     const taskConfig = config;
     const texturePending = this.init().then(() => {
-      return this.workerPool.postMessage({ type: "transcode", buffer, taskConfig }, [buffer]);
-    }).then((e) => this._createTextureFrom(e.data));
-    _taskCache.set(buffer, { promise: texturePending });
+      return this.workerPool.postMessage({
+        type: 'transcode',
+        buffer,
+        taskConfig: taskConfig
+      }, [buffer]);
+    }).then(e => this._createTextureFrom(e.data)); // Cache the task result.
+
+    _taskCache.set(buffer, {
+      promise: texturePending
+    });
+
     return texturePending;
   }
+
   dispose() {
     this.workerPool.dispose();
-    if (this.workerSourceURL)
-      URL.revokeObjectURL(this.workerSourceURL);
+    if (this.workerSourceURL) URL.revokeObjectURL(this.workerSourceURL);
     _activeLoaders--;
     return this;
   }
+
 }
+/* CONSTANTS */
+
+
 KTX2Loader.BasisFormat = {
   ETC1S: 0,
   UASTC_4x4: 1
@@ -162,72 +214,109 @@ KTX2Loader.TranscoderFormat = {
   RGBA4444: 16
 };
 KTX2Loader.EngineFormat = {
-  RGBAFormat: THREE.RGBAFormat,
-  RGBA_ASTC_4x4_Format: THREE.RGBA_ASTC_4x4_Format,
-  RGBA_BPTC_Format: THREE.RGBA_BPTC_Format,
-  RGBA_ETC2_EAC_Format: THREE.RGBA_ETC2_EAC_Format,
-  RGBA_PVRTC_4BPPV1_Format: THREE.RGBA_PVRTC_4BPPV1_Format,
-  RGBA_S3TC_DXT5_Format: THREE.RGBA_S3TC_DXT5_Format,
-  RGB_ETC1_Format: THREE.RGB_ETC1_Format,
-  RGB_ETC2_Format: THREE.RGB_ETC2_Format,
-  RGB_PVRTC_4BPPV1_Format: THREE.RGB_PVRTC_4BPPV1_Format,
-  RGB_S3TC_DXT1_Format: THREE.RGB_S3TC_DXT1_Format
+  RGBAFormat: RGBAFormat,
+  RGBA_ASTC_4x4_Format: RGBA_ASTC_4x4_Format,
+  RGBA_BPTC_Format: RGBA_BPTC_Format,
+  RGBA_ETC2_EAC_Format: RGBA_ETC2_EAC_Format,
+  RGBA_PVRTC_4BPPV1_Format: RGBA_PVRTC_4BPPV1_Format,
+  RGBA_S3TC_DXT5_Format: RGBA_S3TC_DXT5_Format,
+  RGB_ETC1_Format: RGB_ETC1_Format,
+  RGB_ETC2_Format: RGB_ETC2_Format,
+  RGB_PVRTC_4BPPV1_Format: RGB_PVRTC_4BPPV1_Format,
+  RGB_S3TC_DXT1_Format: RGB_S3TC_DXT1_Format
 };
-KTX2Loader.BasisWorker = function() {
+/* WEB WORKER */
+
+KTX2Loader.BasisWorker = function () {
   let config;
   let transcoderPending;
   let BasisModule;
-  const EngineFormat = _EngineFormat;
-  const TranscoderFormat = _TranscoderFormat;
-  const BasisFormat = _BasisFormat;
-  self.addEventListener("message", function(e) {
+  const EngineFormat = _EngineFormat; // eslint-disable-line no-undef
+
+  const TranscoderFormat = _TranscoderFormat; // eslint-disable-line no-undef
+
+  const BasisFormat = _BasisFormat; // eslint-disable-line no-undef
+
+  self.addEventListener('message', function (e) {
     const message = e.data;
+
     switch (message.type) {
-      case "init":
+      case 'init':
         config = message.config;
         init(message.transcoderBinary);
         break;
-      case "transcode":
+
+      case 'transcode':
         transcoderPending.then(() => {
           try {
-            const { width, height, hasAlpha, mipmaps, format, dfdTransferFn, dfdFlags } = transcode(message.buffer);
+            const {
+              width,
+              height,
+              hasAlpha,
+              mipmaps,
+              format,
+              dfdTransferFn,
+              dfdFlags
+            } = transcode(message.buffer);
             const buffers = [];
+
             for (let i = 0; i < mipmaps.length; ++i) {
               buffers.push(mipmaps[i].data.buffer);
             }
-            self.postMessage(
-              { type: "transcode", id: message.id, width, height, hasAlpha, mipmaps, format, dfdTransferFn, dfdFlags },
-              buffers
-            );
+
+            self.postMessage({
+              type: 'transcode',
+              id: message.id,
+              width,
+              height,
+              hasAlpha,
+              mipmaps,
+              format,
+              dfdTransferFn,
+              dfdFlags
+            }, buffers);
           } catch (error) {
             console.error(error);
-            self.postMessage({ type: "error", id: message.id, error: error.message });
+            self.postMessage({
+              type: 'error',
+              id: message.id,
+              error: error.message
+            });
           }
         });
         break;
     }
   });
+
   function init(wasmBinary) {
-    transcoderPending = new Promise((resolve) => {
-      BasisModule = { wasmBinary, onRuntimeInitialized: resolve };
-      BASIS(BasisModule);
+    transcoderPending = new Promise(resolve => {
+      BasisModule = {
+        wasmBinary,
+        onRuntimeInitialized: resolve
+      };
+      BASIS(BasisModule); // eslint-disable-line no-undef
     }).then(() => {
       BasisModule.initializeBasis();
-      if (BasisModule.KTX2File === void 0) {
-        console.warn("THREE.KTX2Loader: Please update Basis Universal transcoder.");
+
+      if (BasisModule.KTX2File === undefined) {
+        console.warn('THREE.KTX2Loader: Please update Basis Universal transcoder.');
       }
     });
   }
+
   function transcode(buffer) {
     const ktx2File = new BasisModule.KTX2File(new Uint8Array(buffer));
+
     function cleanup() {
       ktx2File.close();
       ktx2File.delete();
     }
+
     if (!ktx2File.isValid()) {
       cleanup();
-      throw new Error("THREE.KTX2Loader:	Invalid or unsupported .ktx2 file");
+      throw new Error('THREE.KTX2Loader:	Invalid or unsupported .ktx2 file');
     }
+
     const basisFormat = ktx2File.isUASTC() ? BasisFormat.UASTC_4x4 : BasisFormat.ETC1S;
     const width = ktx2File.getWidth();
     const height = ktx2File.getHeight();
@@ -235,193 +324,237 @@ KTX2Loader.BasisWorker = function() {
     const hasAlpha = ktx2File.getHasAlpha();
     const dfdTransferFn = ktx2File.getDFDTransferFunc();
     const dfdFlags = ktx2File.getDFDFlags();
-    const { transcoderFormat, engineFormat } = getTranscoderFormat(basisFormat, width, height, hasAlpha);
+    const {
+      transcoderFormat,
+      engineFormat
+    } = getTranscoderFormat(basisFormat, width, height, hasAlpha);
+
     if (!width || !height || !levels) {
       cleanup();
-      throw new Error("THREE.KTX2Loader:	Invalid texture");
+      throw new Error('THREE.KTX2Loader:	Invalid texture');
     }
+
     if (!ktx2File.startTranscoding()) {
       cleanup();
-      throw new Error("THREE.KTX2Loader: .startTranscoding failed");
+      throw new Error('THREE.KTX2Loader: .startTranscoding failed');
     }
+
     const mipmaps = [];
+
     for (let mip = 0; mip < levels; mip++) {
       const levelInfo = ktx2File.getImageLevelInfo(mip, 0, 0);
       const mipWidth = levelInfo.origWidth;
       const mipHeight = levelInfo.origHeight;
       const dst = new Uint8Array(ktx2File.getImageTranscodedSizeInBytes(mip, 0, 0, transcoderFormat));
       const status = ktx2File.transcodeImage(dst, mip, 0, 0, transcoderFormat, 0, -1, -1);
+
       if (!status) {
         cleanup();
-        throw new Error("THREE.KTX2Loader: .transcodeImage failed.");
+        throw new Error('THREE.KTX2Loader: .transcodeImage failed.');
       }
-      mipmaps.push({ data: dst, width: mipWidth, height: mipHeight });
+
+      mipmaps.push({
+        data: dst,
+        width: mipWidth,
+        height: mipHeight
+      });
     }
+
     cleanup();
-    return { width, height, hasAlpha, mipmaps, format: engineFormat, dfdTransferFn, dfdFlags };
-  }
-  const FORMAT_OPTIONS = [
-    {
-      if: "astcSupported",
-      basisFormat: [BasisFormat.UASTC_4x4],
-      transcoderFormat: [TranscoderFormat.ASTC_4x4, TranscoderFormat.ASTC_4x4],
-      engineFormat: [EngineFormat.RGBA_ASTC_4x4_Format, EngineFormat.RGBA_ASTC_4x4_Format],
-      priorityETC1S: Infinity,
-      priorityUASTC: 1,
-      needsPowerOfTwo: false
-    },
-    {
-      if: "bptcSupported",
-      basisFormat: [BasisFormat.ETC1S, BasisFormat.UASTC_4x4],
-      transcoderFormat: [TranscoderFormat.BC7_M5, TranscoderFormat.BC7_M5],
-      engineFormat: [EngineFormat.RGBA_BPTC_Format, EngineFormat.RGBA_BPTC_Format],
-      priorityETC1S: 3,
-      priorityUASTC: 2,
-      needsPowerOfTwo: false
-    },
-    {
-      if: "dxtSupported",
-      basisFormat: [BasisFormat.ETC1S, BasisFormat.UASTC_4x4],
-      transcoderFormat: [TranscoderFormat.BC1, TranscoderFormat.BC3],
-      engineFormat: [EngineFormat.RGB_S3TC_DXT1_Format, EngineFormat.RGBA_S3TC_DXT5_Format],
-      priorityETC1S: 4,
-      priorityUASTC: 5,
-      needsPowerOfTwo: false
-    },
-    {
-      if: "etc2Supported",
-      basisFormat: [BasisFormat.ETC1S, BasisFormat.UASTC_4x4],
-      transcoderFormat: [TranscoderFormat.ETC1, TranscoderFormat.ETC2],
-      engineFormat: [EngineFormat.RGB_ETC2_Format, EngineFormat.RGBA_ETC2_EAC_Format],
-      priorityETC1S: 1,
-      priorityUASTC: 3,
-      needsPowerOfTwo: false
-    },
-    {
-      if: "etc1Supported",
-      basisFormat: [BasisFormat.ETC1S, BasisFormat.UASTC_4x4],
-      transcoderFormat: [TranscoderFormat.ETC1],
-      engineFormat: [EngineFormat.RGB_ETC1_Format],
-      priorityETC1S: 2,
-      priorityUASTC: 4,
-      needsPowerOfTwo: false
-    },
-    {
-      if: "pvrtcSupported",
-      basisFormat: [BasisFormat.ETC1S, BasisFormat.UASTC_4x4],
-      transcoderFormat: [TranscoderFormat.PVRTC1_4_RGB, TranscoderFormat.PVRTC1_4_RGBA],
-      engineFormat: [EngineFormat.RGB_PVRTC_4BPPV1_Format, EngineFormat.RGBA_PVRTC_4BPPV1_Format],
-      priorityETC1S: 5,
-      priorityUASTC: 6,
-      needsPowerOfTwo: true
-    }
-  ];
-  const ETC1S_OPTIONS = FORMAT_OPTIONS.sort(function(a, b) {
+    return {
+      width,
+      height,
+      hasAlpha,
+      mipmaps,
+      format: engineFormat,
+      dfdTransferFn,
+      dfdFlags
+    };
+  } //
+  // Optimal choice of a transcoder target format depends on the Basis format (ETC1S or UASTC),
+  // device capabilities, and texture dimensions. The list below ranks the formats separately
+  // for ETC1S and UASTC.
+  //
+  // In some cases, transcoding UASTC to RGBA32 might be preferred for higher quality (at
+  // significant memory cost) compared to ETC1/2, BC1/3, and PVRTC. The transcoder currently
+  // chooses RGBA32 only as a last resort and does not expose that option to the caller.
+
+
+  const FORMAT_OPTIONS = [{
+    if: 'astcSupported',
+    basisFormat: [BasisFormat.UASTC_4x4],
+    transcoderFormat: [TranscoderFormat.ASTC_4x4, TranscoderFormat.ASTC_4x4],
+    engineFormat: [EngineFormat.RGBA_ASTC_4x4_Format, EngineFormat.RGBA_ASTC_4x4_Format],
+    priorityETC1S: Infinity,
+    priorityUASTC: 1,
+    needsPowerOfTwo: false
+  }, {
+    if: 'bptcSupported',
+    basisFormat: [BasisFormat.ETC1S, BasisFormat.UASTC_4x4],
+    transcoderFormat: [TranscoderFormat.BC7_M5, TranscoderFormat.BC7_M5],
+    engineFormat: [EngineFormat.RGBA_BPTC_Format, EngineFormat.RGBA_BPTC_Format],
+    priorityETC1S: 3,
+    priorityUASTC: 2,
+    needsPowerOfTwo: false
+  }, {
+    if: 'dxtSupported',
+    basisFormat: [BasisFormat.ETC1S, BasisFormat.UASTC_4x4],
+    transcoderFormat: [TranscoderFormat.BC1, TranscoderFormat.BC3],
+    engineFormat: [EngineFormat.RGB_S3TC_DXT1_Format, EngineFormat.RGBA_S3TC_DXT5_Format],
+    priorityETC1S: 4,
+    priorityUASTC: 5,
+    needsPowerOfTwo: false
+  }, {
+    if: 'etc2Supported',
+    basisFormat: [BasisFormat.ETC1S, BasisFormat.UASTC_4x4],
+    transcoderFormat: [TranscoderFormat.ETC1, TranscoderFormat.ETC2],
+    engineFormat: [EngineFormat.RGB_ETC2_Format, EngineFormat.RGBA_ETC2_EAC_Format],
+    priorityETC1S: 1,
+    priorityUASTC: 3,
+    needsPowerOfTwo: false
+  }, {
+    if: 'etc1Supported',
+    basisFormat: [BasisFormat.ETC1S, BasisFormat.UASTC_4x4],
+    transcoderFormat: [TranscoderFormat.ETC1],
+    engineFormat: [EngineFormat.RGB_ETC1_Format],
+    priorityETC1S: 2,
+    priorityUASTC: 4,
+    needsPowerOfTwo: false
+  }, {
+    if: 'pvrtcSupported',
+    basisFormat: [BasisFormat.ETC1S, BasisFormat.UASTC_4x4],
+    transcoderFormat: [TranscoderFormat.PVRTC1_4_RGB, TranscoderFormat.PVRTC1_4_RGBA],
+    engineFormat: [EngineFormat.RGB_PVRTC_4BPPV1_Format, EngineFormat.RGBA_PVRTC_4BPPV1_Format],
+    priorityETC1S: 5,
+    priorityUASTC: 6,
+    needsPowerOfTwo: true
+  }];
+  const ETC1S_OPTIONS = FORMAT_OPTIONS.sort(function (a, b) {
     return a.priorityETC1S - b.priorityETC1S;
   });
-  const UASTC_OPTIONS = FORMAT_OPTIONS.sort(function(a, b) {
+  const UASTC_OPTIONS = FORMAT_OPTIONS.sort(function (a, b) {
     return a.priorityUASTC - b.priorityUASTC;
   });
+
   function getTranscoderFormat(basisFormat, width, height, hasAlpha) {
     let transcoderFormat;
     let engineFormat;
     const options = basisFormat === BasisFormat.ETC1S ? ETC1S_OPTIONS : UASTC_OPTIONS;
+
     for (let i = 0; i < options.length; i++) {
       const opt = options[i];
-      if (!config[opt.if])
-        continue;
-      if (!opt.basisFormat.includes(basisFormat))
-        continue;
-      if (hasAlpha && opt.transcoderFormat.length < 2)
-        continue;
-      if (opt.needsPowerOfTwo && !(isPowerOfTwo(width) && isPowerOfTwo(height)))
-        continue;
+      if (!config[opt.if]) continue;
+      if (!opt.basisFormat.includes(basisFormat)) continue;
+      if (hasAlpha && opt.transcoderFormat.length < 2) continue;
+      if (opt.needsPowerOfTwo && !(isPowerOfTwo(width) && isPowerOfTwo(height))) continue;
       transcoderFormat = opt.transcoderFormat[hasAlpha ? 1 : 0];
       engineFormat = opt.engineFormat[hasAlpha ? 1 : 0];
-      return { transcoderFormat, engineFormat };
+      return {
+        transcoderFormat,
+        engineFormat
+      };
     }
-    console.warn("THREE.KTX2Loader: No suitable compressed texture format found. Decoding to RGBA32.");
+
+    console.warn('THREE.KTX2Loader: No suitable compressed texture format found. Decoding to RGBA32.');
     transcoderFormat = TranscoderFormat.RGBA32;
     engineFormat = EngineFormat.RGBAFormat;
-    return { transcoderFormat, engineFormat };
+    return {
+      transcoderFormat,
+      engineFormat
+    };
   }
+
   function isPowerOfTwo(value) {
-    if (value <= 2)
-      return true;
+    if (value <= 2) return true;
     return (value & value - 1) === 0 && value !== 0;
   }
-};
+}; //
+// DataTexture and Data3DTexture parsing.
+
+
 const FORMAT_MAP = {
-  [ktxParse.VK_FORMAT_R32G32B32A32_SFLOAT]: THREE.RGBAFormat,
-  [ktxParse.VK_FORMAT_R16G16B16A16_SFLOAT]: THREE.RGBAFormat,
-  [ktxParse.VK_FORMAT_R8G8B8A8_UNORM]: THREE.RGBAFormat,
-  [ktxParse.VK_FORMAT_R8G8B8A8_SRGB]: THREE.RGBAFormat,
-  [ktxParse.VK_FORMAT_R32G32_SFLOAT]: THREE.RGFormat,
-  [ktxParse.VK_FORMAT_R16G16_SFLOAT]: THREE.RGFormat,
-  [ktxParse.VK_FORMAT_R8G8_UNORM]: THREE.RGFormat,
-  [ktxParse.VK_FORMAT_R8G8_SRGB]: THREE.RGFormat,
-  [ktxParse.VK_FORMAT_R32_SFLOAT]: THREE.RedFormat,
-  [ktxParse.VK_FORMAT_R16_SFLOAT]: THREE.RedFormat,
-  [ktxParse.VK_FORMAT_R8_SRGB]: THREE.RedFormat,
-  [ktxParse.VK_FORMAT_R8_UNORM]: THREE.RedFormat
+  [VK_FORMAT_R32G32B32A32_SFLOAT]: RGBAFormat,
+  [VK_FORMAT_R16G16B16A16_SFLOAT]: RGBAFormat,
+  [VK_FORMAT_R8G8B8A8_UNORM]: RGBAFormat,
+  [VK_FORMAT_R8G8B8A8_SRGB]: RGBAFormat,
+  [VK_FORMAT_R32G32_SFLOAT]: RGFormat,
+  [VK_FORMAT_R16G16_SFLOAT]: RGFormat,
+  [VK_FORMAT_R8G8_UNORM]: RGFormat,
+  [VK_FORMAT_R8G8_SRGB]: RGFormat,
+  [VK_FORMAT_R32_SFLOAT]: RedFormat,
+  [VK_FORMAT_R16_SFLOAT]: RedFormat,
+  [VK_FORMAT_R8_SRGB]: RedFormat,
+  [VK_FORMAT_R8_UNORM]: RedFormat
 };
 const TYPE_MAP = {
-  [ktxParse.VK_FORMAT_R32G32B32A32_SFLOAT]: THREE.FloatType,
-  [ktxParse.VK_FORMAT_R16G16B16A16_SFLOAT]: THREE.HalfFloatType,
-  [ktxParse.VK_FORMAT_R8G8B8A8_UNORM]: THREE.UnsignedByteType,
-  [ktxParse.VK_FORMAT_R8G8B8A8_SRGB]: THREE.UnsignedByteType,
-  [ktxParse.VK_FORMAT_R32G32_SFLOAT]: THREE.FloatType,
-  [ktxParse.VK_FORMAT_R16G16_SFLOAT]: THREE.HalfFloatType,
-  [ktxParse.VK_FORMAT_R8G8_UNORM]: THREE.UnsignedByteType,
-  [ktxParse.VK_FORMAT_R8G8_SRGB]: THREE.UnsignedByteType,
-  [ktxParse.VK_FORMAT_R32_SFLOAT]: THREE.FloatType,
-  [ktxParse.VK_FORMAT_R16_SFLOAT]: THREE.HalfFloatType,
-  [ktxParse.VK_FORMAT_R8_SRGB]: THREE.UnsignedByteType,
-  [ktxParse.VK_FORMAT_R8_UNORM]: THREE.UnsignedByteType
+  [VK_FORMAT_R32G32B32A32_SFLOAT]: FloatType,
+  [VK_FORMAT_R16G16B16A16_SFLOAT]: HalfFloatType,
+  [VK_FORMAT_R8G8B8A8_UNORM]: UnsignedByteType,
+  [VK_FORMAT_R8G8B8A8_SRGB]: UnsignedByteType,
+  [VK_FORMAT_R32G32_SFLOAT]: FloatType,
+  [VK_FORMAT_R16G16_SFLOAT]: HalfFloatType,
+  [VK_FORMAT_R8G8_UNORM]: UnsignedByteType,
+  [VK_FORMAT_R8G8_SRGB]: UnsignedByteType,
+  [VK_FORMAT_R32_SFLOAT]: FloatType,
+  [VK_FORMAT_R16_SFLOAT]: HalfFloatType,
+  [VK_FORMAT_R8_SRGB]: UnsignedByteType,
+  [VK_FORMAT_R8_UNORM]: UnsignedByteType
 };
 const ENCODING_MAP = {
-  [ktxParse.VK_FORMAT_R8G8B8A8_SRGB]: THREE.sRGBEncoding,
-  [ktxParse.VK_FORMAT_R8G8_SRGB]: THREE.sRGBEncoding,
-  [ktxParse.VK_FORMAT_R8_SRGB]: THREE.sRGBEncoding
+  [VK_FORMAT_R8G8B8A8_SRGB]: sRGBEncoding,
+  [VK_FORMAT_R8G8_SRGB]: sRGBEncoding,
+  [VK_FORMAT_R8_SRGB]: sRGBEncoding
 };
+
 async function createDataTexture(container) {
-  const { vkFormat, pixelWidth, pixelHeight, pixelDepth } = container;
-  if (FORMAT_MAP[vkFormat] === void 0) {
-    throw new Error("THREE.KTX2Loader: Unsupported vkFormat.");
-  }
+  const {
+    vkFormat,
+    pixelWidth,
+    pixelHeight,
+    pixelDepth
+  } = container;
+
+  if (FORMAT_MAP[vkFormat] === undefined) {
+    throw new Error('THREE.KTX2Loader: Unsupported vkFormat.');
+  } //
+
+
   const level = container.levels[0];
   let levelData;
   let view;
-  if (container.supercompressionScheme === ktxParse.KHR_SUPERCOMPRESSION_NONE) {
+
+  if (container.supercompressionScheme === KHR_SUPERCOMPRESSION_NONE) {
     levelData = level.levelData;
-  } else if (container.supercompressionScheme === ktxParse.KHR_SUPERCOMPRESSION_ZSTD) {
+  } else if (container.supercompressionScheme === KHR_SUPERCOMPRESSION_ZSTD) {
     if (!_zstd) {
-      _zstd = new Promise(async (resolve) => {
-        const zstd = new zstddec.ZSTDDecoder();
+      _zstd = new Promise(async resolve => {
+        const zstd = new ZSTDDecoder();
         await zstd.init();
         resolve(zstd);
       });
     }
+
     levelData = (await _zstd).decode(level.levelData, level.uncompressedByteLength);
   } else {
-    throw new Error("THREE.KTX2Loader: Unsupported supercompressionScheme.");
+    throw new Error('THREE.KTX2Loader: Unsupported supercompressionScheme.');
   }
-  if (TYPE_MAP[vkFormat] === THREE.FloatType) {
-    view = new Float32Array(
-      levelData.buffer,
-      levelData.byteOffset,
-      levelData.byteLength / Float32Array.BYTES_PER_ELEMENT
-    );
-  } else if (TYPE_MAP[vkFormat] === THREE.HalfFloatType) {
+
+  if (TYPE_MAP[vkFormat] === FloatType) {
+    view = new Float32Array(levelData.buffer, levelData.byteOffset, levelData.byteLength / Float32Array.BYTES_PER_ELEMENT);
+  } else if (TYPE_MAP[vkFormat] === HalfFloatType) {
     view = new Uint16Array(levelData.buffer, levelData.byteOffset, levelData.byteLength / Uint16Array.BYTES_PER_ELEMENT);
   } else {
     view = levelData;
-  }
-  const texture = pixelDepth === 0 ? new THREE.DataTexture(view, pixelWidth, pixelHeight) : new THREE.Data3DTexture(view, pixelWidth, pixelHeight, pixelDepth);
+  } //
+
+
+  const texture = pixelDepth === 0 ? new DataTexture(view, pixelWidth, pixelHeight) : new Data3DTexture(view, pixelWidth, pixelHeight, pixelDepth);
   texture.type = TYPE_MAP[vkFormat];
   texture.format = FORMAT_MAP[vkFormat];
-  texture.encoding = ENCODING_MAP[vkFormat] || THREE.LinearEncoding;
-  texture.needsUpdate = true;
+  texture.encoding = ENCODING_MAP[vkFormat] || LinearEncoding;
+  texture.needsUpdate = true; //
+
   return Promise.resolve(texture);
 }
-exports.KTX2Loader = KTX2Loader;
+
+export { KTX2Loader };