@loaders.gl/draco 4.0.0-beta.3 → 4.0.0-beta.4

package/dist/dist.dev.js

@@ -62,7 +62,6 @@ var __exports__ = (() => {
   var DEFAULT_DRACO_OPTIONS = {
     draco: {
       decoderType: typeof WebAssembly === "object" ? "wasm" : "js",
-      // 'js' for IE11
       libraryPath: "libs/",
       extraAttributes: {},
       attributeNameEntry: void 0
@@ -72,7 +71,6 @@ var __exports__ = (() => {
     name: "Draco",
     id: "draco",
     module: "draco",
-    // shapes: ['mesh'],
     version: VERSION,
     worker: true,
     extensions: ["drc"],
@@ -222,24 +220,15 @@ var __exports__ = (() => {
   };
   var INDEX_ITEM_SIZE = 4;
   var DracoParser = class {
-    // draco - the draco decoder, either import `draco3d` or load dynamically
     constructor(draco) {
       this.draco = draco;
       this.decoder = new this.draco.Decoder();
       this.metadataQuerier = new this.draco.MetadataQuerier();
     }
-    /**
-     * Destroy draco resources
-     */
     destroy() {
       this.draco.destroy(this.decoder);
       this.draco.destroy(this.metadataQuerier);
     }
-    /**
-     * NOTE: caller must call `destroyGeometry` on the return value after using it
-     * @param arrayBuffer
-     * @param options
-     */
     parseSync(arrayBuffer, options = {}) {
       const buffer = new this.draco.DecoderBuffer();
       buffer.Init(new Int8Array(arrayBuffer), arrayBuffer.byteLength);
@@ -284,14 +273,6 @@ var __exports__ = (() => {
         }
       }
     }
-    // Draco specific "loader data"
-    /**
-     * Extract
-     * @param dracoGeometry
-     * @param geometry_type
-     * @param options
-     * @returns
-     */
     _getDracoLoaderData(dracoGeometry, geometry_type, options) {
       const metadata = this._getTopLevelMetadata(dracoGeometry);
       const attributes = this._getDracoAttributes(dracoGeometry, options);
@@ -304,12 +285,6 @@ var __exports__ = (() => {
         attributes
       };
     }
-    /**
-     * Extract all draco provided information and metadata for each attribute
-     * @param dracoGeometry
-     * @param options
-     * @returns
-     */
     _getDracoAttributes(dracoGeometry, options) {
       const dracoAttributes = {};
       for (let attributeId = 0; attributeId < dracoGeometry.num_attributes(); attributeId++) {
@@ -337,12 +312,6 @@ var __exports__ = (() => {
       }
       return dracoAttributes;
     }
-    /**
-     * Get standard loaders.gl mesh category data
-     * Extracts the geometry from draco
-     * @param dracoGeometry
-     * @param options
-     */
     _getMeshData(dracoGeometry, loaderData, options) {
       const attributes = this._getMeshAttributes(loaderData, dracoGeometry, options);
       const positionAttribute = attributes.POSITION;
@@ -355,7 +324,6 @@ var __exports__ = (() => {
             return {
               topology: "triangle-strip",
               mode: 4,
-              // GL.TRIANGLES
               attributes,
               indices: {
                 value: this._getTriangleStripIndices(dracoGeometry),
@@ -367,7 +335,6 @@ var __exports__ = (() => {
             return {
               topology: "triangle-list",
               mode: 5,
-              // GL.TRIANGLE_STRIP
               attributes,
               indices: {
                 value: this._getTriangleListIndices(dracoGeometry),
@@ -379,7 +346,6 @@ var __exports__ = (() => {
       return {
         topology: "point-list",
         mode: 0,
-        // GL.POINTS
         attributes
       };
     }
@@ -402,11 +368,6 @@ var __exports__ = (() => {
       }
       return attributes;
     }
-    // MESH INDICES EXTRACTION
-    /**
-     * For meshes, we need indices to define the faces.
-     * @param dracoGeometry
-     */
     _getTriangleListIndices(dracoGeometry) {
       const numFaces = dracoGeometry.num_faces();
       const numIndices = numFaces * 3;
@@ -419,10 +380,6 @@ var __exports__ = (() => {
         this.draco._free(ptr);
       }
     }
-    /**
-     * For meshes, we need indices to define the faces.
-     * @param dracoGeometry
-     */
     _getTriangleStripIndices(dracoGeometry) {
       const dracoArray = new this.draco.DracoInt32Array();
       try {
@@ -432,12 +389,6 @@ var __exports__ = (() => {
         this.draco.destroy(dracoArray);
       }
     }
-    /**
-     *
-     * @param dracoGeometry
-     * @param dracoAttribute
-     * @param attributeName
-     */
     _getAttributeValues(dracoGeometry, attribute) {
       const TypedArrayCtor = DRACO_DATA_TYPE_TO_TYPED_ARRAY_MAP[attribute.data_type];
       const numComponents = attribute.num_components;
@@ -459,30 +410,6 @@ var __exports__ = (() => {
         size: numComponents
       };
     }
-    // Attribute names
-    /** 
-     * DRACO does not store attribute names - We need to deduce an attribute name
-     * for each attribute
-    _getAttributeNames(
-      dracoGeometry: Mesh | PointCloud,
-      options: DracoParseOptions
-    ): {[unique_id: number]: string} {
-      const attributeNames: {[unique_id: number]: string} = {};
-      for (let attributeId = 0; attributeId < dracoGeometry.num_attributes(); attributeId++) {
-        const dracoAttribute = this.decoder.GetAttribute(dracoGeometry, attributeId);
-        const attributeName = this._deduceAttributeName(dracoAttribute, options);
-        attributeNames[attributeName] = attributeName;
-      }
-      return attributeNames;
-    }
-     */
-    /**
-     * Deduce an attribute name.
-     * @note DRACO does not save attribute names, just general type (POSITION, COLOR)
-     * to help optimize compression. We generate GLTF compatible names for the Draco-recognized
-     * types
-     * @param attributeData
-     */
     _deduceAttributeName(attribute, options) {
       const uniqueId = attribute.unique_id;
       for (const [attributeName, attributeUniqueId] of Object.entries(options.extraAttributes || {})) {
@@ -503,22 +430,14 @@ var __exports__ = (() => {
       }
       return `CUSTOM_ATTRIBUTE_${uniqueId}`;
     }
-    // METADATA EXTRACTION
-    /** Get top level metadata */
     _getTopLevelMetadata(dracoGeometry) {
       const dracoMetadata = this.decoder.GetMetadata(dracoGeometry);
       return this._getDracoMetadata(dracoMetadata);
     }
-    /** Get per attribute metadata */
     _getAttributeMetadata(dracoGeometry, attributeId) {
       const dracoMetadata = this.decoder.GetAttributeMetadata(dracoGeometry, attributeId);
       return this._getDracoMetadata(dracoMetadata);
     }
-    /**
-     * Extract metadata field values
-     * @param dracoMetadata
-     * @returns
-     */
     _getDracoMetadata(dracoMetadata) {
       if (!dracoMetadata || !dracoMetadata.ptr) {
         return {};
@@ -531,11 +450,6 @@ var __exports__ = (() => {
       }
       return result;
     }
-    /**
-     * Extracts possible values for one metadata entry by name
-     * @param dracoMetadata
-     * @param entryName
-     */
     _getDracoMetadataField(dracoMetadata, entryName) {
       const dracoArray = new this.draco.DracoInt32Array();
       try {
@@ -551,8 +465,6 @@ var __exports__ = (() => {
         this.draco.destroy(dracoArray);
       }
     }
-    // QUANTIZED ATTRIBUTE SUPPORT (NO DECOMPRESSION)
-    /** Skip transforms for specific attribute types */
     _disableAttributeTransforms(options) {
       const {
         quantizedAttributes = [],
@@ -563,10 +475,6 @@ var __exports__ = (() => {
         this.decoder.SkipAttributeTransform(this.draco[dracoAttributeName]);
       }
     }
-    /**
-     * Extract (and apply?) Position Transform
-     * @todo not used
-     */
     _getQuantizationTransform(dracoAttribute, options) {
       const {
         quantizedAttributes = []
@@ -609,7 +517,6 @@ var __exports__ = (() => {
       }
       return null;
     }
-    // HELPERS
   };
   function getDracoDataType(draco, attributeType) {
     switch (attributeType) {
@@ -682,10 +589,7 @@ var __exports__ = (() => {
   var window_ = globals.window || globals.self || globals.global || {};
   var global_ = globals.global || globals.self || globals.window || {};
   var document_ = globals.document || {};
-  var isBrowser = (
-    // @ts-ignore process.browser
-    typeof process !== "object" || String(process) !== "[object process]" || process.browser
-  );
+  var isBrowser = typeof process !== "object" || String(process) !== "[object process]" || process.browser;
   var isWorker = typeof importScripts === "function";
   var isMobile = typeof window !== "undefined" && typeof window.orientation !== "undefined";
   var matches = typeof process !== "undefined" && process.version && /v([0-9]*)/.exec(process.version);
@@ -698,8 +602,7 @@ var __exports__ = (() => {
     if (moduleName) {
       libraryUrl = getLibraryUrl(libraryUrl, moduleName, options, libraryName);
     }
-    loadLibraryPromises[libraryUrl] = // eslint-disable-next-line @typescript-eslint/no-misused-promises
-    loadLibraryPromises[libraryUrl] || loadLibraryFromFile(libraryUrl);
+    loadLibraryPromises[libraryUrl] = loadLibraryPromises[libraryUrl] || loadLibraryFromFile(libraryUrl);
     return await loadLibraryPromises[libraryUrl];
   }
   function getLibraryUrl(library, moduleName, options = {}, libraryName = null) {
@@ -746,7 +649,7 @@ var __exports__ = (() => {
       return void 0 && (void 0)(scriptSource, id);
     }
     if (isWorker) {
-      eval.call(global_, scriptSource);
+      eval.call(globalThis, scriptSource);
       return null;
     }
     const script = document.createElement("script");
@@ -779,13 +682,9 @@ var __exports__ = (() => {
   var DRACO_ENCODER_VERSION = "1.4.1";
   var STATIC_DECODER_URL = `https://www.gstatic.com/draco/versioned/decoders/${DRACO_DECODER_VERSION}`;
   var DRACO_EXTERNAL_LIBRARIES = {
-    /** The primary Draco3D encoder, javascript wrapper part */
     DECODER: "draco_wasm_wrapper.js",
-    /** The primary draco decoder, compiled web assembly part */
     DECODER_WASM: "draco_decoder.wasm",
-    /** Fallback decoder for non-webassebly environments. Very big bundle, lower performance */
     FALLBACK_DECODER: "draco_decoder.js",
-    /** Draco encoder */
     ENCODER: "draco_encoder.js"
   };
   var DRACO_EXTERNAL_LIBRARY_URLS = {
@@ -847,7 +746,6 @@ var __exports__ = (() => {
         onModuleLoaded: (draco) => resolve({
           draco
         })
-        // Module is Promise-like. Wrap in object to avoid loop.
       });
     });
   }
@@ -859,7 +757,6 @@ var __exports__ = (() => {
         onModuleLoaded: (draco) => resolve({
           draco
         })
-        // Module is Promise-like. Wrap in object to avoid loop.
       });
     });
   }
@@ -874,7 +771,6 @@ var __exports__ = (() => {
   var noop = () => {
   };
   var DracoBuilder = class {
-    // draco - the draco decoder, either import `draco3d` or load dynamically
     constructor(draco) {
       this.draco = draco;
       this.dracoEncoder = new this.draco.Encoder();
@@ -889,23 +785,16 @@ var __exports__ = (() => {
       this.dracoEncoder = null;
       this.draco = null;
     }
-    // TBD - when does this need to be called?
     destroyEncodedObject(object) {
       if (object) {
         this.draco.destroy(object);
       }
     }
-    /**
-     * Encode mesh or point cloud
-     * @param mesh =({})
-     * @param options
-     */
     encodeSync(mesh, options = {}) {
       this.log = noop;
       this._setOptions(options);
       return options.pointcloud ? this._encodePointCloud(mesh, options) : this._encodeMesh(mesh, options);
     }
-    // PRIVATE
     _getAttributesFromMesh(mesh) {
       const attributes = {
         ...mesh,
@@ -958,10 +847,6 @@ var __exports__ = (() => {
         this.destroyEncodedObject(dracoMesh);
       }
     }
-    /**
-     * Set encoding options.
-     * @param {{speed?: any; method?: any; quantization?: any;}} options
-     */
     _setOptions(options) {
       if ("speed" in options) {
         this.dracoEncoder.SetSpeedOptions(...options.speed);
@@ -978,11 +863,6 @@ var __exports__ = (() => {
         }
       }
     }
-    /**
-     * @param {Mesh} dracoMesh
-     * @param {object} attributes
-     * @returns {Mesh}
-     */
     _createDracoMesh(dracoMesh, attributes, options) {
       const optionalMetadata = options.attributesMetadata || {};
       try {
@@ -1008,10 +888,6 @@ var __exports__ = (() => {
       }
       return dracoMesh;
     }
-    /**
-     * @param {} dracoPointCloud
-     * @param {object} attributes
-     */
     _createDracoPointCloud(dracoPointCloud, attributes, options) {
       const optionalMetadata = options.attributesMetadata || {};
       try {
@@ -1037,12 +913,6 @@ var __exports__ = (() => {
       }
       return dracoPointCloud;
     }
-    /**
-     * @param mesh
-     * @param attributeName
-     * @param attribute
-     * @param vertexCount
-     */
     _addAttributeToMesh(mesh, attributeName, attribute, vertexCount) {
       if (!ArrayBuffer.isView(attribute)) {
         return -1;
@@ -1079,11 +949,6 @@ var __exports__ = (() => {
           return builder.AddFloatAttribute(mesh, type, vertexCount, size, new Float32Array(buffer));
       }
     }
-    /**
-     * DRACO can compress attributes of know type better
-     * TODO - expose an attribute type map?
-     * @param attributeName
-     */
     _getDracoAttributeType(attributeName) {
       switch (attributeName.toLowerCase()) {
         case "indices":
@@ -1115,32 +980,16 @@ var __exports__ = (() => {
       }
       return null;
     }
-    /**
-     * Add metadata for the geometry.
-     * @param dracoGeometry - WASM Draco Object
-     * @param metadata
-     */
     _addGeometryMetadata(dracoGeometry, metadata) {
       const dracoMetadata = new this.draco.Metadata();
       this._populateDracoMetadata(dracoMetadata, metadata);
       this.dracoMeshBuilder.AddMetadata(dracoGeometry, dracoMetadata);
     }
-    /**
-     * Add metadata for an attribute to geometry.
-     * @param dracoGeometry - WASM Draco Object
-     * @param uniqueAttributeId
-     * @param metadata
-     */
     _addAttributeMetadata(dracoGeometry, uniqueAttributeId, metadata) {
       const dracoAttributeMetadata = new this.draco.Metadata();
       this._populateDracoMetadata(dracoAttributeMetadata, metadata);
       this.dracoMeshBuilder.SetMetadataForAttribute(dracoGeometry, uniqueAttributeId, dracoAttributeMetadata);
     }
-    /**
-     * Add contents of object or map to a WASM Draco Metadata Object
-     * @param dracoMetadata - WASM Draco Object
-     * @param metadata
-     */
     _populateDracoMetadata(dracoMetadata, metadata) {
       for (const [key, value] of getEntries(metadata)) {
         switch (typeof value) {
@@ -1180,14 +1029,7 @@ var __exports__ = (() => {
   // src/draco-writer.ts
   var DEFAULT_DRACO_WRITER_OPTIONS = {
     pointcloud: false,
-    // Set to true if pointcloud (mode: 0, no indices)
     attributeNameEntry: "name"
-    // Draco Compression Parameters
-    // method: 'MESH_EDGEBREAKER_ENCODING', // Use draco defaults
-    // speed: [5, 5], // Use draco defaults
-    // quantization: { // Use draco defaults
-    //   POSITION: 10
-    // }
   };
   var DracoWriter = {
     name: "DRACO",