@loaders.gl/scene 5.0.0-beta.1 → 5.0.0-beta.10

package/dist/draco/lib/draco-parser.d.ts

@@ -0,0 +1,143 @@
+import type { TypedArray, MeshAttribute, MeshGeometry } from '@loaders.gl/core/schema';
+import type { Draco3D, Decoder, Mesh, PointCloud, PointAttribute, Metadata, MetadataQuerier } from "../draco3d/draco3d-types.js";
+import type { DracoMesh, DracoLoaderData, DracoAttribute, DracoMetadataEntry, DracoQuantizationTransform, DracoOctahedronTransform } from "./draco-types.js";
+/** Options to control draco parsing */
+export type DracoParseOptions = {
+    /** How triangle indices should be generated (mesh only) */
+    topology?: 'triangle-list' | 'triangle-strip';
+    /** Specify which attribute metadata entry stores the attribute name */
+    attributeNameEntry?: string;
+    /** Names and ids of extra attributes to include in the output */
+    extraAttributes?: {
+        [uniqueId: string]: number;
+    };
+    /** Skip transforms specific quantized attributes */
+    quantizedAttributes?: ('POSITION' | 'NORMAL' | 'COLOR' | 'TEX_COORD' | 'GENERIC')[];
+    /** Skip transforms specific octahedron encoded  attributes */
+    octahedronAttributes?: ('POSITION' | 'NORMAL' | 'COLOR' | 'TEX_COORD' | 'GENERIC')[];
+    /** Application attribute names to extract in addition to the required position attribute. */
+    includeAttributes?: string[];
+    /** Application attribute names to omit. The position attribute cannot be omitted. */
+    excludeAttributes?: string[];
+};
+export default class DracoParser {
+    private readonly logger;
+    draco: Draco3D;
+    decoder: Decoder;
+    metadataQuerier: MetadataQuerier;
+    constructor(draco: Draco3D, logger?: import("probe.gl/log").Logger);
+    /**
+     * Destroy draco resources
+     */
+    destroy(): void;
+    /**
+     * NOTE: caller must call `destroyGeometry` on the return value after using it
+     * @param arrayBuffer
+     * @param options
+     */
+    parseSync(arrayBuffer: ArrayBuffer | ArrayBufferView, options?: DracoParseOptions): DracoMesh;
+    /**
+     * Extract
+     * @param dracoGeometry
+     * @param geometry_type
+     * @param options
+     * @returns
+     */
+    _getDracoLoaderData(dracoGeometry: Mesh | PointCloud, geometry_type: any, options: DracoParseOptions): DracoLoaderData;
+    /**
+     * Extract all draco provided information and metadata for each attribute
+     * @param dracoGeometry
+     * @param options
+     * @returns
+     */
+    _getDracoAttributes(dracoGeometry: Mesh | PointCloud, options: DracoParseOptions): {
+        [unique_id: number]: DracoAttribute;
+    };
+    /**
+     * Get standard loaders.gl mesh category data
+     * Extracts the geometry from draco
+     * @param dracoGeometry
+     * @param options
+     */
+    _getMeshData(dracoGeometry: Mesh | PointCloud, loaderData: DracoLoaderData, options: DracoParseOptions): MeshGeometry;
+    _getMeshAttributes(loaderData: DracoLoaderData, dracoGeometry: Mesh | PointCloud, options: DracoParseOptions): {
+        [attributeName: string]: MeshAttribute;
+    };
+    /** Returns true when an attribute should be copied from WASM into the requested output. */
+    _shouldExtractAttribute(attributeName: string, attribute: DracoAttribute, options: DracoParseOptions): boolean;
+    /**
+     * For meshes, we need indices to define the faces.
+     * @param dracoGeometry
+     */
+    _getTriangleListIndices(dracoGeometry: Mesh): Uint16Array | Uint32Array;
+    /**
+     * For meshes, we need indices to define the faces.
+     * @param dracoGeometry
+     */
+    _getTriangleStripIndices(dracoGeometry: Mesh): Uint32Array<ArrayBufferLike>;
+    /**
+     *
+     * @param dracoGeometry
+     * @param dracoAttribute
+     * @param attributeName
+     */
+    _getAttributeValues(dracoGeometry: Mesh | PointCloud, attribute: DracoAttribute): {
+        value: TypedArray;
+        size: number;
+    } | null;
+    /**
+     * 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: DracoAttribute, options: DracoParseOptions): string;
+    /** Get top level metadata */
+    _getTopLevelMetadata(dracoGeometry: Mesh | PointCloud): {
+        [entry: string]: DracoMetadataEntry;
+    };
+    /** Get per attribute metadata */
+    _getAttributeMetadata(dracoGeometry: Mesh | PointCloud, attributeId: number): {
+        [entry: string]: DracoMetadataEntry;
+    };
+    /**
+     * Extract metadata field values
+     * @param dracoMetadata
+     * @returns
+     */
+    _getDracoMetadata(dracoMetadata: Metadata): {
+        [entry: string]: DracoMetadataEntry;
+    };
+    /**
+     * Extracts possible values for one metadata entry by name
+     * @param dracoMetadata
+     * @param entryName
+     */
+    _getDracoMetadataField(dracoMetadata: Metadata, entryName: string): DracoMetadataEntry;
+    /** Skip transforms for specific attribute types */
+    _disableAttributeTransforms(options: DracoParseOptions): void;
+    /**
+     * Extract (and apply?) Position Transform
+     * @todo not used
+     */
+    _getQuantizationTransform(dracoAttribute: PointAttribute, options: DracoParseOptions): DracoQuantizationTransform | null;
+    _getOctahedronTransform(dracoAttribute: PointAttribute, options: DracoParseOptions): DracoOctahedronTransform | null;
+}
+//# sourceMappingURL=draco-parser.d.ts.map

package/dist/draco/lib/draco-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draco-parser.d.ts","sourceRoot":"","sources":["../../../src/draco/lib/draco-parser.ts"],"names":[],"mappings":"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"}