@babylonjs/core 7.43.0 → 7.44.1

package/Meshes/Compression/dracoEncoder.js

@@ -0,0 +1,245 @@
+import { _IsConfigurationAvailable, DracoCodec } from "./dracoCodec.js";
+import { EncodeMesh, EncoderWorkerFunction } from "./dracoCompressionWorker.js";
+import { Tools } from "../../Misc/tools.js";
+import { VertexBuffer } from "../buffer.js";
+import { Mesh } from "../mesh.js";
+import { Logger } from "../../Misc/logger.js";
+import { deepMerge } from "../../Misc/deepMerger.js";
+import { AreIndices32Bits } from "../../Buffers/bufferUtils.js";
+/**
+ * Map the Babylon.js attribute kind to the Draco attribute kind, defined by the `GeometryAttributeType` enum.
+ * @internal
+ */
+function GetDracoAttributeName(kind) {
+    if (kind === VertexBuffer.PositionKind) {
+        return "POSITION";
+    }
+    else if (kind === VertexBuffer.NormalKind) {
+        return "NORMAL";
+    }
+    else if (kind === VertexBuffer.ColorKind) {
+        return "COLOR";
+    }
+    else if (kind.startsWith(VertexBuffer.UVKind)) {
+        return "TEX_COORD";
+    }
+    return "GENERIC";
+}
+/**
+ * Get the indices for the geometry, if present. Eventually used as
+ * `AddFacesToMesh(mesh: Mesh, numFaces: number, faces: Uint16Array | Uint32Array)`;
+ * where `numFaces = indices.length / 3` and `faces = indices`.
+ * @internal
+ */
+function PrepareIndicesForDraco(input) {
+    let indices = input.getIndices();
+    // Convert number[] and Int32Array types, if needed
+    if (indices && !(indices instanceof Uint32Array) && !(indices instanceof Uint16Array)) {
+        indices = (AreIndices32Bits(indices, indices.length) ? Uint32Array : Uint16Array).from(indices);
+    }
+    return indices;
+}
+/**
+ * Get relevant information about the geometry's vertex attributes for Draco encoding. Eventually used for each attribute as
+ * `AddFloatAttribute(mesh: Mesh, attribute: number, count: number, itemSize: number, array: TypedArray)`
+ * where `attribute = EncoderModule[<dracoAttribute>]`, `itemSize = <size>`, `array = <data>`, and count is the number of position vertices.
+ * @internal
+ */
+function PrepareAttributesForDraco(input, excludedAttributes) {
+    const attributes = [];
+    for (const kind of input.getVerticesDataKinds()) {
+        if (excludedAttributes?.includes(kind)) {
+            if (kind === VertexBuffer.PositionKind) {
+                throw new Error("Cannot exclude position attribute from Draco encoding.");
+            }
+            continue;
+        }
+        // Convert number[] to typed array, if needed
+        let data = input.getVerticesData(kind);
+        if (!(data instanceof Float32Array)) {
+            data = Float32Array.from(data);
+        }
+        attributes.push({ kind: kind, dracoName: GetDracoAttributeName(kind), size: input.getVertexBuffer(kind).getSize(), data: data });
+    }
+    return attributes;
+}
+const DefaultEncoderOptions = {
+    decodeSpeed: 5,
+    encodeSpeed: 5,
+    method: "MESH_EDGEBREAKER_ENCODING",
+    quantizationBits: {
+        POSITION: 14,
+        NORMAL: 10,
+        COLOR: 8,
+        TEX_COORD: 12,
+        GENERIC: 12,
+    },
+};
+/**
+ * @experimental This class is subject to change.
+ *
+ * Draco Encoder (https://google.github.io/draco/)
+ *
+ * This class wraps the Draco encoder module.
+ *
+ * By default, the configuration points to a copy of the Draco encoder files from the Babylon.js cdn https://cdn.babylonjs.com/draco_encoder_wasm_wrapper.js.
+ *
+ * To update the configuration, use the following code:
+ * ```javascript
+ *     DracoEncoder.DefaultConfiguration = {
+ *          wasmUrl: "<url to the WebAssembly library>",
+ *          wasmBinaryUrl: "<url to the WebAssembly binary>",
+ *          fallbackUrl: "<url to the fallback JavaScript library>",
+ *     };
+ * ```
+ *
+ * Draco has two versions, one for WebAssembly and one for JavaScript. The encoder configuration can be set to only support WebAssembly or only support the JavaScript version.
+ * Decoding will automatically fallback to the JavaScript version if WebAssembly version is not configured or if WebAssembly is not supported by the browser.
+ * Use `DracoEncoder.DefaultAvailable` to determine if the encoder configuration is available for the current context.
+ *
+ * To encode Draco compressed data, get the default DracoEncoder object and call encodeMeshAsync:
+ * ```javascript
+ *     var dracoData = await DracoEncoder.Default.encodeMeshAsync(mesh);
+ * ```
+ *
+ * Currently, DracoEncoder only encodes to meshes. Encoding to point clouds is not yet supported.
+ *
+ * Only position, normal, color, and UV attributes are supported natively by the encoder. All other attributes are treated as generic. This means that,
+ * when decoding these generic attributes later, additional information about their original Babylon types will be needed to interpret the data correctly.
+ * You can use the return value of `encodeMeshAsync` to source this information, specifically the `attributes` field. E.g.,
+ * ```javascript
+ *    var dracoData = await DracoEncoder.Default.encodeMeshAsync(mesh);
+ *    var meshData = await DracoDecoder.Default.decodeMeshToMeshDataAsync(dracoData.data, dracoData.attributes);
+ * ```
+ *
+ * By default, DracoEncoder will encode all available attributes of the mesh. To exclude specific attributes, use the following code:
+ * ```javascript
+ *    var options = { excludedAttributes: [VertexBuffer.MatricesIndicesKind, VertexBuffer.MatricesWeightsKind] };
+ *    var dracoData = await DracoDecoder.Default.encodeMeshAsync(mesh, options);
+ * ```
+ */
+export class DracoEncoder extends DracoCodec {
+    /**
+     * Returns true if the encoder's `DefaultConfiguration` is available.
+     */
+    static get DefaultAvailable() {
+        return _IsConfigurationAvailable(DracoEncoder.DefaultConfiguration);
+    }
+    /**
+     * Default instance for the DracoEncoder.
+     */
+    static get Default() {
+        DracoEncoder._Default ?? (DracoEncoder._Default = new DracoEncoder());
+        return DracoEncoder._Default;
+    }
+    /**
+     * Reset the default DracoEncoder object to null and disposing the removed default instance.
+     * Note that if the workerPool is a member of the static DefaultConfiguration object it is recommended not to run dispose,
+     * unless the static worker pool is no longer needed.
+     * @param skipDispose set to true to not dispose the removed default instance
+     */
+    static ResetDefault(skipDispose) {
+        if (DracoEncoder._Default) {
+            if (!skipDispose) {
+                DracoEncoder._Default.dispose();
+            }
+            DracoEncoder._Default = null;
+        }
+    }
+    _isModuleAvailable() {
+        return typeof DracoEncoderModule !== "undefined";
+    }
+    async _createModuleAsync(wasmBinary, jsModule /** DracoEncoderModule */) {
+        const module = await (jsModule || DracoEncoderModule)({ wasmBinary });
+        return { module };
+    }
+    _getWorkerContent() {
+        return `${EncodeMesh}(${EncoderWorkerFunction})()`;
+    }
+    /**
+     * Creates a new Draco encoder.
+     * @param configuration Optional override of the configuration for the DracoEncoder. If not provided, defaults to {@link DracoEncoder.DefaultConfiguration}.
+     */
+    constructor(configuration = DracoEncoder.DefaultConfiguration) {
+        super(configuration);
+    }
+    /**
+     * @internal
+     */
+    async _encodeAsync(attributes, indices, options) {
+        const mergedOptions = options ? deepMerge(DefaultEncoderOptions, options) : DefaultEncoderOptions;
+        if (this._workerPoolPromise) {
+            const workerPool = await this._workerPoolPromise;
+            return new Promise((resolve, reject) => {
+                workerPool.push((worker, onComplete) => {
+                    const onError = (error) => {
+                        worker.removeEventListener("error", onError);
+                        worker.removeEventListener("message", onMessage);
+                        reject(error);
+                        onComplete();
+                    };
+                    const onMessage = (message) => {
+                        if (message.data.id === "encodeMeshDone") {
+                            worker.removeEventListener("error", onError);
+                            worker.removeEventListener("message", onMessage);
+                            resolve(message.data.encodedMeshData);
+                            onComplete();
+                        }
+                    };
+                    worker.addEventListener("error", onError);
+                    worker.addEventListener("message", onMessage);
+                    // Manually create copies of our attribute data and add them to the transfer list to ensure we only copy the ArrayBuffer data we need.
+                    const transferList = [];
+                    attributes.forEach((attribute) => {
+                        attribute.data = attribute.data.slice();
+                        transferList.push(attribute.data.buffer);
+                    });
+                    if (indices) {
+                        indices = indices.slice();
+                        transferList.push(indices.buffer);
+                    }
+                    worker.postMessage({ id: "encodeMesh", attributes: attributes, indices: indices, options: mergedOptions }, transferList);
+                });
+            });
+        }
+        if (this._modulePromise) {
+            const encoder = await this._modulePromise;
+            return EncodeMesh(encoder.module, attributes, indices, mergedOptions);
+        }
+        throw new Error("Draco encoder module is not available");
+    }
+    /**
+     * Encodes a mesh or geometry into a Draco-encoded mesh data.
+     * @param input the mesh or geometry to encode
+     * @param options options for the encoding
+     * @returns a promise that resolves to the newly-encoded data
+     */
+    async encodeMeshAsync(input, options) {
+        const verticesCount = input.getTotalVertices();
+        if (verticesCount == 0) {
+            throw new Error("Cannot compress geometry with Draco. There are no vertices.");
+        }
+        // Prepare parameters for encoding
+        if (input instanceof Mesh && input.morphTargetManager && options?.method === "MESH_EDGEBREAKER_ENCODING") {
+            Logger.Warn("Cannot use Draco EDGEBREAKER method with morph targets. Falling back to SEQUENTIAL method.");
+            options.method = "MESH_SEQUENTIAL_ENCODING";
+        }
+        const indices = PrepareIndicesForDraco(input);
+        const attributes = PrepareAttributesForDraco(input, options?.excludedAttributes);
+        return this._encodeAsync(attributes, indices, options);
+    }
+}
+/**
+ * Default configuration for the DracoEncoder. Defaults to the following:
+ * - numWorkers: 50% of the available logical processors, capped to 4. If no logical processors are available, defaults to 1.
+ * - wasmUrl: `"https://cdn.babylonjs.com/draco_encoder_wasm_wrapper.js"`
+ * - wasmBinaryUrl: `"https://cdn.babylonjs.com/draco_encoder.wasm"`
+ * - fallbackUrl: `"https://cdn.babylonjs.com/draco_encoder.js"`
+ */
+DracoEncoder.DefaultConfiguration = {
+    wasmUrl: `${Tools._DefaultCdnUrl}/draco_encoder_wasm_wrapper.js`,
+    wasmBinaryUrl: `${Tools._DefaultCdnUrl}/draco_encoder.wasm`,
+    fallbackUrl: `${Tools._DefaultCdnUrl}/draco_encoder.js`,
+};
+DracoEncoder._Default = null;
+//# sourceMappingURL=dracoEncoder.js.map

package/Meshes/Compression/dracoEncoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dracoEncoder.js","sourceRoot":"","sources":["../../../../../dev/core/src/Meshes/Compression/dracoEncoder.ts"],"names":[],"mappings":"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","sourcesContent":["import { _IsConfigurationAvailable, DracoCodec, type IDracoCodecConfiguration } from \"./dracoCodec\";\r\nimport type { EncoderMessage, IDracoAttributeData, IDracoEncodedMeshData, IDracoEncoderOptions, DracoAttributeName } from \"./dracoEncoder.types\";\r\nimport { EncodeMesh, EncoderWorkerFunction } from \"./dracoCompressionWorker\";\r\nimport { Tools } from \"../../Misc/tools\";\r\nimport { VertexBuffer } from \"../buffer\";\r\nimport type { Nullable } from \"../../types\";\r\nimport { Mesh } from \"../mesh\";\r\nimport type { Geometry } from \"../geometry\";\r\nimport { Logger } from \"../../Misc/logger\";\r\nimport { deepMerge } from \"../../Misc/deepMerger\";\r\nimport type { EncoderModule } from \"draco3d\";\r\nimport { AreIndices32Bits } from \"core/Buffers/bufferUtils\";\r\n\r\n// Missing type from types/draco3d. Do not use in public scope; UMD tests will fail because of EncoderModule.\r\ntype DracoEncoderModule = (props: { wasmBinary?: ArrayBuffer }) => Promise<EncoderModule>;\r\n\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\ndeclare let DracoEncoderModule: DracoEncoderModule;\r\n\r\n/**\r\n * Map the Babylon.js attribute kind to the Draco attribute kind, defined by the `GeometryAttributeType` enum.\r\n * @internal\r\n */\r\nfunction GetDracoAttributeName(kind: string): DracoAttributeName {\r\n    if (kind === VertexBuffer.PositionKind) {\r\n        return \"POSITION\";\r\n    } else if (kind === VertexBuffer.NormalKind) {\r\n        return \"NORMAL\";\r\n    } else if (kind === VertexBuffer.ColorKind) {\r\n        return \"COLOR\";\r\n    } else if (kind.startsWith(VertexBuffer.UVKind)) {\r\n        return \"TEX_COORD\";\r\n    }\r\n    return \"GENERIC\";\r\n}\r\n\r\n/**\r\n * Get the indices for the geometry, if present. Eventually used as\r\n * `AddFacesToMesh(mesh: Mesh, numFaces: number, faces: Uint16Array | Uint32Array)`;\r\n * where `numFaces = indices.length / 3` and `faces = indices`.\r\n * @internal\r\n */\r\nfunction PrepareIndicesForDraco(input: Mesh | Geometry): Nullable<Uint32Array | Uint16Array> {\r\n    let indices = input.getIndices();\r\n\r\n    // Convert number[] and Int32Array types, if needed\r\n    if (indices && !(indices instanceof Uint32Array) && !(indices instanceof Uint16Array)) {\r\n        indices = (AreIndices32Bits(indices, indices.length) ? Uint32Array : Uint16Array).from(indices);\r\n    }\r\n\r\n    return indices;\r\n}\r\n\r\n/**\r\n * Get relevant information about the geometry's vertex attributes for Draco encoding. Eventually used for each attribute as\r\n * `AddFloatAttribute(mesh: Mesh, attribute: number, count: number, itemSize: number, array: TypedArray)`\r\n * where `attribute = EncoderModule[<dracoAttribute>]`, `itemSize = <size>`, `array = <data>`, and count is the number of position vertices.\r\n * @internal\r\n */\r\nfunction PrepareAttributesForDraco(input: Mesh | Geometry, excludedAttributes?: string[]): Array<IDracoAttributeData> {\r\n    const attributes: Array<IDracoAttributeData> = [];\r\n\r\n    for (const kind of input.getVerticesDataKinds()) {\r\n        if (excludedAttributes?.includes(kind)) {\r\n            if (kind === VertexBuffer.PositionKind) {\r\n                throw new Error(\"Cannot exclude position attribute from Draco encoding.\");\r\n            }\r\n            continue;\r\n        }\r\n\r\n        // Convert number[] to typed array, if needed\r\n        let data = input.getVerticesData(kind)!;\r\n        if (!(data instanceof Float32Array)) {\r\n            data = Float32Array.from(data!);\r\n        }\r\n        attributes.push({ kind: kind, dracoName: GetDracoAttributeName(kind), size: input.getVertexBuffer(kind)!.getSize(), data: data });\r\n    }\r\n\r\n    return attributes;\r\n}\r\n\r\nconst DefaultEncoderOptions: IDracoEncoderOptions = {\r\n    decodeSpeed: 5,\r\n    encodeSpeed: 5,\r\n    method: \"MESH_EDGEBREAKER_ENCODING\",\r\n    quantizationBits: {\r\n        POSITION: 14,\r\n        NORMAL: 10,\r\n        COLOR: 8,\r\n        TEX_COORD: 12,\r\n        GENERIC: 12,\r\n    },\r\n};\r\n\r\n/**\r\n * @experimental This class is subject to change.\r\n *\r\n * Draco Encoder (https://google.github.io/draco/)\r\n *\r\n * This class wraps the Draco encoder module.\r\n *\r\n * By default, the configuration points to a copy of the Draco encoder files from the Babylon.js cdn https://cdn.babylonjs.com/draco_encoder_wasm_wrapper.js.\r\n *\r\n * To update the configuration, use the following code:\r\n * ```javascript\r\n *     DracoEncoder.DefaultConfiguration = {\r\n *          wasmUrl: \"<url to the WebAssembly library>\",\r\n *          wasmBinaryUrl: \"<url to the WebAssembly binary>\",\r\n *          fallbackUrl: \"<url to the fallback JavaScript library>\",\r\n *     };\r\n * ```\r\n *\r\n * Draco has two versions, one for WebAssembly and one for JavaScript. The encoder configuration can be set to only support WebAssembly or only support the JavaScript version.\r\n * Decoding will automatically fallback to the JavaScript version if WebAssembly version is not configured or if WebAssembly is not supported by the browser.\r\n * Use `DracoEncoder.DefaultAvailable` to determine if the encoder configuration is available for the current context.\r\n *\r\n * To encode Draco compressed data, get the default DracoEncoder object and call encodeMeshAsync:\r\n * ```javascript\r\n *     var dracoData = await DracoEncoder.Default.encodeMeshAsync(mesh);\r\n * ```\r\n *\r\n * Currently, DracoEncoder only encodes to meshes. Encoding to point clouds is not yet supported.\r\n *\r\n * Only position, normal, color, and UV attributes are supported natively by the encoder. All other attributes are treated as generic. This means that,\r\n * when decoding these generic attributes later, additional information about their original Babylon types will be needed to interpret the data correctly.\r\n * You can use the return value of `encodeMeshAsync` to source this information, specifically the `attributes` field. E.g.,\r\n * ```javascript\r\n *    var dracoData = await DracoEncoder.Default.encodeMeshAsync(mesh);\r\n *    var meshData = await DracoDecoder.Default.decodeMeshToMeshDataAsync(dracoData.data, dracoData.attributes);\r\n * ```\r\n *\r\n * By default, DracoEncoder will encode all available attributes of the mesh. To exclude specific attributes, use the following code:\r\n * ```javascript\r\n *    var options = { excludedAttributes: [VertexBuffer.MatricesIndicesKind, VertexBuffer.MatricesWeightsKind] };\r\n *    var dracoData = await DracoDecoder.Default.encodeMeshAsync(mesh, options);\r\n * ```\r\n */\r\nexport class DracoEncoder extends DracoCodec {\r\n    /**\r\n     * Default configuration for the DracoEncoder. Defaults to the following:\r\n     * - numWorkers: 50% of the available logical processors, capped to 4. If no logical processors are available, defaults to 1.\r\n     * - wasmUrl: `\"https://cdn.babylonjs.com/draco_encoder_wasm_wrapper.js\"`\r\n     * - wasmBinaryUrl: `\"https://cdn.babylonjs.com/draco_encoder.wasm\"`\r\n     * - fallbackUrl: `\"https://cdn.babylonjs.com/draco_encoder.js\"`\r\n     */\r\n    public static DefaultConfiguration: IDracoCodecConfiguration = {\r\n        wasmUrl: `${Tools._DefaultCdnUrl}/draco_encoder_wasm_wrapper.js`,\r\n        wasmBinaryUrl: `${Tools._DefaultCdnUrl}/draco_encoder.wasm`,\r\n        fallbackUrl: `${Tools._DefaultCdnUrl}/draco_encoder.js`,\r\n    };\r\n\r\n    /**\r\n     * Returns true if the encoder's `DefaultConfiguration` is available.\r\n     */\r\n    public static get DefaultAvailable(): boolean {\r\n        return _IsConfigurationAvailable(DracoEncoder.DefaultConfiguration);\r\n    }\r\n\r\n    protected static _Default: Nullable<DracoEncoder> = null;\r\n    /**\r\n     * Default instance for the DracoEncoder.\r\n     */\r\n    public static get Default(): DracoEncoder {\r\n        DracoEncoder._Default ??= new DracoEncoder();\r\n        return DracoEncoder._Default;\r\n    }\r\n\r\n    /**\r\n     * Reset the default DracoEncoder object to null and disposing the removed default instance.\r\n     * Note that if the workerPool is a member of the static DefaultConfiguration object it is recommended not to run dispose,\r\n     * unless the static worker pool is no longer needed.\r\n     * @param skipDispose set to true to not dispose the removed default instance\r\n     */\r\n    public static ResetDefault(skipDispose?: boolean): void {\r\n        if (DracoEncoder._Default) {\r\n            if (!skipDispose) {\r\n                DracoEncoder._Default.dispose();\r\n            }\r\n            DracoEncoder._Default = null;\r\n        }\r\n    }\r\n\r\n    protected override _isModuleAvailable(): boolean {\r\n        return typeof DracoEncoderModule !== \"undefined\";\r\n    }\r\n\r\n    protected override async _createModuleAsync(wasmBinary?: ArrayBuffer, jsModule?: unknown /** DracoEncoderModule */): Promise<{ module: unknown /** EncoderModule */ }> {\r\n        const module = await ((jsModule as DracoEncoderModule) || DracoEncoderModule)({ wasmBinary });\r\n        return { module };\r\n    }\r\n\r\n    protected override _getWorkerContent(): string {\r\n        return `${EncodeMesh}(${EncoderWorkerFunction})()`;\r\n    }\r\n\r\n    /**\r\n     * Creates a new Draco encoder.\r\n     * @param configuration Optional override of the configuration for the DracoEncoder. If not provided, defaults to {@link DracoEncoder.DefaultConfiguration}.\r\n     */\r\n    constructor(configuration: IDracoCodecConfiguration = DracoEncoder.DefaultConfiguration) {\r\n        super(configuration);\r\n    }\r\n\r\n    /**\r\n     * @internal\r\n     */\r\n    public async _encodeAsync(\r\n        attributes: Array<IDracoAttributeData>,\r\n        indices: Nullable<Uint16Array | Uint32Array>,\r\n        options?: IDracoEncoderOptions\r\n    ): Promise<Nullable<IDracoEncodedMeshData>> {\r\n        const mergedOptions = options ? deepMerge(DefaultEncoderOptions, options) : DefaultEncoderOptions;\r\n\r\n        if (this._workerPoolPromise) {\r\n            const workerPool = await this._workerPoolPromise;\r\n            return new Promise<Nullable<IDracoEncodedMeshData>>((resolve, reject) => {\r\n                workerPool.push((worker, onComplete) => {\r\n                    const onError = (error: ErrorEvent) => {\r\n                        worker.removeEventListener(\"error\", onError);\r\n                        worker.removeEventListener(\"message\", onMessage);\r\n                        reject(error);\r\n                        onComplete();\r\n                    };\r\n\r\n                    const onMessage = (message: MessageEvent<EncoderMessage>) => {\r\n                        if (message.data.id === \"encodeMeshDone\") {\r\n                            worker.removeEventListener(\"error\", onError);\r\n                            worker.removeEventListener(\"message\", onMessage);\r\n                            resolve(message.data.encodedMeshData);\r\n                            onComplete();\r\n                        }\r\n                    };\r\n\r\n                    worker.addEventListener(\"error\", onError);\r\n                    worker.addEventListener(\"message\", onMessage);\r\n\r\n                    // Manually create copies of our attribute data and add them to the transfer list to ensure we only copy the ArrayBuffer data we need.\r\n                    const transferList = [];\r\n                    attributes.forEach((attribute) => {\r\n                        attribute.data = attribute.data.slice();\r\n                        transferList.push(attribute.data.buffer);\r\n                    });\r\n                    if (indices) {\r\n                        indices = indices.slice();\r\n                        transferList.push(indices.buffer);\r\n                    }\r\n\r\n                    worker.postMessage({ id: \"encodeMesh\", attributes: attributes, indices: indices, options: mergedOptions }, transferList);\r\n                });\r\n            });\r\n        }\r\n\r\n        if (this._modulePromise) {\r\n            const encoder = await this._modulePromise;\r\n            return EncodeMesh(encoder.module, attributes, indices, mergedOptions);\r\n        }\r\n\r\n        throw new Error(\"Draco encoder module is not available\");\r\n    }\r\n\r\n    /**\r\n     * Encodes a mesh or geometry into a Draco-encoded mesh data.\r\n     * @param input the mesh or geometry to encode\r\n     * @param options options for the encoding\r\n     * @returns a promise that resolves to the newly-encoded data\r\n     */\r\n    public async encodeMeshAsync(input: Mesh | Geometry, options?: IDracoEncoderOptions): Promise<Nullable<IDracoEncodedMeshData>> {\r\n        const verticesCount = input.getTotalVertices();\r\n        if (verticesCount == 0) {\r\n            throw new Error(\"Cannot compress geometry with Draco. There are no vertices.\");\r\n        }\r\n\r\n        // Prepare parameters for encoding\r\n        if (input instanceof Mesh && input.morphTargetManager && options?.method === \"MESH_EDGEBREAKER_ENCODING\") {\r\n            Logger.Warn(\"Cannot use Draco EDGEBREAKER method with morph targets. Falling back to SEQUENTIAL method.\");\r\n            options.method = \"MESH_SEQUENTIAL_ENCODING\";\r\n        }\r\n\r\n        const indices = PrepareIndicesForDraco(input);\r\n        const attributes = PrepareAttributesForDraco(input, options?.excludedAttributes);\r\n\r\n        return this._encodeAsync(attributes, indices, options);\r\n    }\r\n}\r\n"]}

package/Meshes/Compression/dracoEncoder.types.d.ts

@@ -0,0 +1,82 @@
+import type { Nullable } from "../../types.js";
+/**
+ * The available Draco attribute names.
+ */
+export type DracoAttributeName = "POSITION" | "NORMAL" | "COLOR" | "TEX_COORD" | "GENERIC";
+/**
+ * Draco encoding method (from EncoderMethod enum in `draco_encoder.ts`).
+ */
+export type DracoEncoderMethod = "MESH_SEQUENTIAL_ENCODING" | "MESH_EDGEBREAKER_ENCODING";
+/**
+ * Options for a particular encoding.
+ */
+export interface IDracoEncoderOptions {
+    /**
+     * Tune how fast decoding should be (0 = fastest but least compressed, 10 = slowest but most compressed).
+     */
+    decodeSpeed?: number;
+    /**
+     * Tune how fast encoding should be (0 = fastest but least compressed, 10 = slowest but most compressed).
+     */
+    encodeSpeed?: number;
+    /**
+     * The method to use for encoding the data (EDGEBREAKER or SEQUENTIAL). Defaults to EDGEBREAKER, if possible.
+     */
+    method?: DracoEncoderMethod;
+    /**
+     * The number of bits to use for each DRACO attribute kind.
+     */
+    quantizationBits?: Record<DracoAttributeName, number>;
+    /**
+     * The list of BABYLON attribute kinds to skip exporting, if present. Defaults to none.
+     */
+    excludedAttributes?: string[];
+}
+/**
+ * Encoder parameter carrying Babylon attribute data.
+ * @internal
+ */
+export interface IDracoAttributeData {
+    /**
+     * The kind of the attribute.
+     */
+    kind: string;
+    /**
+     * The Draco name for the kind of the attribute.
+     */
+    dracoName: DracoAttributeName;
+    /**
+     * The size of the attribute.
+     */
+    size: number;
+    /**
+     * The buffer view of the attribute.
+     */
+    data: Float32Array;
+}
+/**
+ * Encoded Draco mesh data.
+ * @internal
+ */
+export interface IDracoEncodedMeshData {
+    /**
+     * The encoded data.
+     */
+    data: Int8Array;
+    /**
+     * A map of Babylon vertex attributes to their Draco unique ids in the encoded data.
+     */
+    attributeIDs: Record<string, number>;
+}
+/**
+ * @internal
+ */
+interface EncodeDoneMessage {
+    id: "encodeMeshDone";
+    encodedMeshData: Nullable<IDracoEncodedMeshData>;
+}
+/**
+ * @internal
+ */
+export type EncoderMessage = EncodeDoneMessage;
+export {};

package/Meshes/Compression/dracoEncoder.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dracoEncoder.types.js.map

package/Meshes/Compression/dracoEncoder.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dracoEncoder.types.js","sourceRoot":"","sources":["../../../../../dev/core/src/Meshes/Compression/dracoEncoder.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Nullable } from \"core/types\";\n\n/**\n * The available Draco attribute names.\n */\nexport type DracoAttributeName = \"POSITION\" | \"NORMAL\" | \"COLOR\" | \"TEX_COORD\" | \"GENERIC\";\n\n/**\n * Draco encoding method (from EncoderMethod enum in `draco_encoder.ts`).\n */\nexport type DracoEncoderMethod = \"MESH_SEQUENTIAL_ENCODING\" | \"MESH_EDGEBREAKER_ENCODING\";\n\n/**\n * Options for a particular encoding.\n */\nexport interface IDracoEncoderOptions {\n    /**\n     * Tune how fast decoding should be (0 = fastest but least compressed, 10 = slowest but most compressed).\n     */\n    decodeSpeed?: number;\n    /**\n     * Tune how fast encoding should be (0 = fastest but least compressed, 10 = slowest but most compressed).\n     */\n    encodeSpeed?: number;\n    /**\n     * The method to use for encoding the data (EDGEBREAKER or SEQUENTIAL). Defaults to EDGEBREAKER, if possible.\n     */\n    method?: DracoEncoderMethod;\n    /**\n     * The number of bits to use for each DRACO attribute kind.\n     */\n    quantizationBits?: Record<DracoAttributeName, number>;\n    /**\n     * The list of BABYLON attribute kinds to skip exporting, if present. Defaults to none.\n     */\n    excludedAttributes?: string[];\n}\n\n/**\n * Encoder parameter carrying Babylon attribute data.\n * @internal\n */\nexport interface IDracoAttributeData {\n    /**\n     * The kind of the attribute.\n     */\n    kind: string;\n    /**\n     * The Draco name for the kind of the attribute.\n     */\n    dracoName: DracoAttributeName;\n    /**\n     * The size of the attribute.\n     */\n    size: number;\n    /**\n     * The buffer view of the attribute.\n     */\n    data: Float32Array;\n}\n\n/**\n * Encoded Draco mesh data.\n * @internal\n */\nexport interface IDracoEncodedMeshData {\n    /**\n     * The encoded data.\n     */\n    data: Int8Array;\n    /**\n     * A map of Babylon vertex attributes to their Draco unique ids in the encoded data.\n     */\n    attributeIDs: Record<string, number>;\n}\n\n/**\n * @internal\n */\ninterface EncodeDoneMessage {\n    id: \"encodeMeshDone\";\n    encodedMeshData: Nullable<IDracoEncodedMeshData>;\n}\n\n/**\n * @internal\n */\nexport type EncoderMessage = EncodeDoneMessage;\n"]}

package/Meshes/Compression/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./dracoCompression";
 export * from "./meshoptCompression";
 export * from "./dracoDecoder";
+export * from "./dracoEncoder";

package/Meshes/Compression/index.js

@@ -1,4 +1,5 @@
 export * from "./dracoCompression.js";
 export * from "./meshoptCompression.js";
 export * from "./dracoDecoder.js";
+export * from "./dracoEncoder.js";
 //# sourceMappingURL=index.js.map

package/Meshes/Compression/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../dev/core/src/Meshes/Compression/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC","sourcesContent":["export * from \"./dracoCompression\";\r\nexport * from \"./meshoptCompression\";\r\nexport * from \"./dracoDecoder\";\r\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../dev/core/src/Meshes/Compression/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC","sourcesContent":["export * from \"./dracoCompression\";\r\nexport * from \"./meshoptCompression\";\r\nexport * from \"./dracoDecoder\";\r\nexport * from \"./dracoEncoder\";\r\n"]}

package/Meshes/Compression/meshoptCompression.js

@@ -1,4 +1,8 @@
 import { Tools } from "../../Misc/tools.js";
+// eslint-disable-next-line @typescript-eslint/naming-convention
+let NumberOfWorkers = 0;
+// eslint-disable-next-line @typescript-eslint/naming-convention
+let WorkerTimeout = null;
 /**
  * Meshopt compression (https://github.com/zeux/meshoptimizer)
  *
@@ -59,9 +63,20 @@ export class MeshoptCompression {
      */
     decodeGltfBufferAsync(source, count, stride, mode, filter) {
         return this._decoderModulePromise.then(async () => {
-            MeshoptDecoder.useWorkers(1);
+            if (NumberOfWorkers === 0) {
+                MeshoptDecoder.useWorkers(1);
+                NumberOfWorkers = 1;
+            }
             const result = await MeshoptDecoder.decodeGltfBufferAsync(count, stride, source, mode, filter);
-            MeshoptDecoder.useWorkers(0);
+            // a simple debounce to avoid switching back and forth between workers and no workers while decoding
+            if (WorkerTimeout !== null) {
+                clearTimeout(WorkerTimeout);
+            }
+            WorkerTimeout = setTimeout(() => {
+                MeshoptDecoder.useWorkers(0);
+                NumberOfWorkers = 0;
+                WorkerTimeout = null;
+            }, 1000);
             return result;
         });
     }

package/Meshes/Compression/meshoptCompression.js.map

@@ -1 +1 @@
-{"version":3,"file":"meshoptCompression.js","sourceRoot":"","sources":["../../../../../dev/core/src/Meshes/Compression/meshoptCompression.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAsBzC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,kBAAkB;IAmB3B;;OAEG;IACI,MAAM,KAAK,OAAO;QACrB,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,CAAC;YAC/B,kBAAkB,CAAC,QAAQ,GAAG,IAAI,kBAAkB,EAAE,CAAC;QAC3D,CAAC;QAED,OAAO,kBAAkB,CAAC,QAAQ,CAAC;IACvC,CAAC;IAED;;OAEG;IACH;QACI,MAAM,OAAO,GAAG,kBAAkB,CAAC,aAAa,CAAC,OAAO,CAAC;QAEzD,IAAI,CAAC,qBAAqB,GAAG,KAAK,CAAC,sBAAsB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;YAC7E,4DAA4D;YAC5D,OAAO,cAAc,CAAC,KAAK,CAAC;QAChC,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACI,OAAO;QACV,OAAO,IAAI,CAAC,qBAAqB,CAAC;IACtC,CAAC;IAED;;;;;;;;;OASG;IACI,qBAAqB,CAAC,MAAkB,EAAE,KAAa,EAAE,MAAc,EAAE,IAA4C,EAAE,MAAe;QACzI,OAAO,IAAI,CAAC,qBAAsB,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YAC/C,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC7B,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YAC/F,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC7B,OAAO,MAAM,CAAC;QAClB,CAAC,CAAC,CAAC;IACP,CAAC;;AA/DD;;;;;;;GAOG;AACW,gCAAa,GAAqC;IAC5D,OAAO,EAAE;QACL,GAAG,EAAE,GAAG,KAAK,CAAC,cAAc,qBAAqB;KACpD;CACJ,CAAC;AAEa,2BAAQ,GAAiC,IAAI,CAAC","sourcesContent":["import { Tools } from \"../../Misc/tools\";\r\nimport type { IDisposable } from \"../../scene\";\r\nimport type { Nullable } from \"../../types\";\r\n\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\ndeclare let MeshoptDecoder: any;\r\n\r\n/**\r\n * Configuration for meshoptimizer compression\r\n */\r\nexport interface IMeshoptCompressionConfiguration {\r\n    /**\r\n     * Configuration for the decoder.\r\n     */\r\n    decoder: {\r\n        /**\r\n         * The url to the meshopt decoder library.\r\n         */\r\n        url: string;\r\n    };\r\n}\r\n\r\n/**\r\n * Meshopt compression (https://github.com/zeux/meshoptimizer)\r\n *\r\n * This class wraps the meshopt library from https://github.com/zeux/meshoptimizer/tree/master/js.\r\n *\r\n * **Encoder**\r\n *\r\n * The encoder is not currently implemented.\r\n *\r\n * **Decoder**\r\n *\r\n * By default, the configuration points to a copy of the meshopt files on the Babylon.js preview CDN (e.g. https://preview.babylonjs.com/meshopt_decoder.js).\r\n *\r\n * To update the configuration, use the following code:\r\n * ```javascript\r\n *     MeshoptCompression.Configuration = {\r\n *         decoder: {\r\n *             url: \"<url to the meshopt decoder library>\"\r\n *         }\r\n *     };\r\n * ```\r\n */\r\nexport class MeshoptCompression implements IDisposable {\r\n    private _decoderModulePromise?: Promise<any>;\r\n\r\n    /**\r\n     * The configuration. Defaults to the following:\r\n     * ```javascript\r\n     * decoder: {\r\n     *   url: \"https://cdn.babylonjs.com/meshopt_decoder.js\"\r\n     * }\r\n     * ```\r\n     */\r\n    public static Configuration: IMeshoptCompressionConfiguration = {\r\n        decoder: {\r\n            url: `${Tools._DefaultCdnUrl}/meshopt_decoder.js`,\r\n        },\r\n    };\r\n\r\n    private static _Default: Nullable<MeshoptCompression> = null;\r\n\r\n    /**\r\n     * Default instance for the meshoptimizer object.\r\n     */\r\n    public static get Default(): MeshoptCompression {\r\n        if (!MeshoptCompression._Default) {\r\n            MeshoptCompression._Default = new MeshoptCompression();\r\n        }\r\n\r\n        return MeshoptCompression._Default;\r\n    }\r\n\r\n    /**\r\n     * Constructor\r\n     */\r\n    constructor() {\r\n        const decoder = MeshoptCompression.Configuration.decoder;\r\n\r\n        this._decoderModulePromise = Tools.LoadBabylonScriptAsync(decoder.url).then(() => {\r\n            // Wait for WebAssembly compilation before resolving promise\r\n            return MeshoptDecoder.ready;\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Stop all async operations and release resources.\r\n     */\r\n    public dispose(): void {\r\n        delete this._decoderModulePromise;\r\n    }\r\n\r\n    /**\r\n     * Decode meshopt data.\r\n     * @see https://github.com/zeux/meshoptimizer/tree/master/js#decoder\r\n     * @param source The input data.\r\n     * @param count The number of elements.\r\n     * @param stride The stride in bytes.\r\n     * @param mode The compression mode.\r\n     * @param filter The compression filter.\r\n     * @returns a Promise<Uint8Array> that resolves to the decoded data\r\n     */\r\n    public decodeGltfBufferAsync(source: Uint8Array, count: number, stride: number, mode: \"ATTRIBUTES\" | \"TRIANGLES\" | \"INDICES\", filter?: string): Promise<Uint8Array> {\r\n        return this._decoderModulePromise!.then(async () => {\r\n            MeshoptDecoder.useWorkers(1);\r\n            const result = await MeshoptDecoder.decodeGltfBufferAsync(count, stride, source, mode, filter);\r\n            MeshoptDecoder.useWorkers(0);\r\n            return result;\r\n        });\r\n    }\r\n}\r\n"]}
+{"version":3,"file":"meshoptCompression.js","sourceRoot":"","sources":["../../../../../dev/core/src/Meshes/Compression/meshoptCompression.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAOzC,gEAAgE;AAChE,IAAI,eAAe,GAAG,CAAC,CAAC;AACxB,gEAAgE;AAChE,IAAI,aAAa,GAA4C,IAAI,CAAC;AAiBlE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,kBAAkB;IAmB3B;;OAEG;IACI,MAAM,KAAK,OAAO;QACrB,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,CAAC;YAC/B,kBAAkB,CAAC,QAAQ,GAAG,IAAI,kBAAkB,EAAE,CAAC;QAC3D,CAAC;QAED,OAAO,kBAAkB,CAAC,QAAQ,CAAC;IACvC,CAAC;IAED;;OAEG;IACH;QACI,MAAM,OAAO,GAAG,kBAAkB,CAAC,aAAa,CAAC,OAAO,CAAC;QAEzD,IAAI,CAAC,qBAAqB,GAAG,KAAK,CAAC,sBAAsB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;YAC7E,4DAA4D;YAC5D,OAAO,cAAc,CAAC,KAAK,CAAC;QAChC,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACI,OAAO;QACV,OAAO,IAAI,CAAC,qBAAqB,CAAC;IACtC,CAAC;IAED;;;;;;;;;OASG;IACI,qBAAqB,CAAC,MAAkB,EAAE,KAAa,EAAE,MAAc,EAAE,IAA4C,EAAE,MAAe;QACzI,OAAO,IAAI,CAAC,qBAAsB,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YAC/C,IAAI,eAAe,KAAK,CAAC,EAAE,CAAC;gBACxB,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;gBAC7B,eAAe,GAAG,CAAC,CAAC;YACxB,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YAC/F,oGAAoG;YACpG,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;gBACzB,YAAY,CAAC,aAAa,CAAC,CAAC;YAChC,CAAC;YACD,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;gBAC7B,eAAe,GAAG,CAAC,CAAC;gBACpB,aAAa,GAAG,IAAI,CAAC;YACzB,CAAC,EAAE,IAAI,CAAC,CAAC;YACT,OAAO,MAAM,CAAC;QAClB,CAAC,CAAC,CAAC;IACP,CAAC;;AA1ED;;;;;;;GAOG;AACW,gCAAa,GAAqC;IAC5D,OAAO,EAAE;QACL,GAAG,EAAE,GAAG,KAAK,CAAC,cAAc,qBAAqB;KACpD;CACJ,CAAC;AAEa,2BAAQ,GAAiC,IAAI,CAAC","sourcesContent":["import { Tools } from \"../../Misc/tools\";\r\nimport type { IDisposable } from \"../../scene\";\r\nimport type { Nullable } from \"../../types\";\r\n\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\ndeclare let MeshoptDecoder: any;\r\n\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nlet NumberOfWorkers = 0;\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nlet WorkerTimeout: Nullable<ReturnType<typeof setTimeout>> = null;\r\n\r\n/**\r\n * Configuration for meshoptimizer compression\r\n */\r\nexport interface IMeshoptCompressionConfiguration {\r\n    /**\r\n     * Configuration for the decoder.\r\n     */\r\n    decoder: {\r\n        /**\r\n         * The url to the meshopt decoder library.\r\n         */\r\n        url: string;\r\n    };\r\n}\r\n\r\n/**\r\n * Meshopt compression (https://github.com/zeux/meshoptimizer)\r\n *\r\n * This class wraps the meshopt library from https://github.com/zeux/meshoptimizer/tree/master/js.\r\n *\r\n * **Encoder**\r\n *\r\n * The encoder is not currently implemented.\r\n *\r\n * **Decoder**\r\n *\r\n * By default, the configuration points to a copy of the meshopt files on the Babylon.js preview CDN (e.g. https://preview.babylonjs.com/meshopt_decoder.js).\r\n *\r\n * To update the configuration, use the following code:\r\n * ```javascript\r\n *     MeshoptCompression.Configuration = {\r\n *         decoder: {\r\n *             url: \"<url to the meshopt decoder library>\"\r\n *         }\r\n *     };\r\n * ```\r\n */\r\nexport class MeshoptCompression implements IDisposable {\r\n    private _decoderModulePromise?: Promise<any>;\r\n\r\n    /**\r\n     * The configuration. Defaults to the following:\r\n     * ```javascript\r\n     * decoder: {\r\n     *   url: \"https://cdn.babylonjs.com/meshopt_decoder.js\"\r\n     * }\r\n     * ```\r\n     */\r\n    public static Configuration: IMeshoptCompressionConfiguration = {\r\n        decoder: {\r\n            url: `${Tools._DefaultCdnUrl}/meshopt_decoder.js`,\r\n        },\r\n    };\r\n\r\n    private static _Default: Nullable<MeshoptCompression> = null;\r\n\r\n    /**\r\n     * Default instance for the meshoptimizer object.\r\n     */\r\n    public static get Default(): MeshoptCompression {\r\n        if (!MeshoptCompression._Default) {\r\n            MeshoptCompression._Default = new MeshoptCompression();\r\n        }\r\n\r\n        return MeshoptCompression._Default;\r\n    }\r\n\r\n    /**\r\n     * Constructor\r\n     */\r\n    constructor() {\r\n        const decoder = MeshoptCompression.Configuration.decoder;\r\n\r\n        this._decoderModulePromise = Tools.LoadBabylonScriptAsync(decoder.url).then(() => {\r\n            // Wait for WebAssembly compilation before resolving promise\r\n            return MeshoptDecoder.ready;\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Stop all async operations and release resources.\r\n     */\r\n    public dispose(): void {\r\n        delete this._decoderModulePromise;\r\n    }\r\n\r\n    /**\r\n     * Decode meshopt data.\r\n     * @see https://github.com/zeux/meshoptimizer/tree/master/js#decoder\r\n     * @param source The input data.\r\n     * @param count The number of elements.\r\n     * @param stride The stride in bytes.\r\n     * @param mode The compression mode.\r\n     * @param filter The compression filter.\r\n     * @returns a Promise<Uint8Array> that resolves to the decoded data\r\n     */\r\n    public decodeGltfBufferAsync(source: Uint8Array, count: number, stride: number, mode: \"ATTRIBUTES\" | \"TRIANGLES\" | \"INDICES\", filter?: string): Promise<Uint8Array> {\r\n        return this._decoderModulePromise!.then(async () => {\r\n            if (NumberOfWorkers === 0) {\r\n                MeshoptDecoder.useWorkers(1);\r\n                NumberOfWorkers = 1;\r\n            }\r\n            const result = await MeshoptDecoder.decodeGltfBufferAsync(count, stride, source, mode, filter);\r\n            // a simple debounce to avoid switching back and forth between workers and no workers while decoding\r\n            if (WorkerTimeout !== null) {\r\n                clearTimeout(WorkerTimeout);\r\n            }\r\n            WorkerTimeout = setTimeout(() => {\r\n                MeshoptDecoder.useWorkers(0);\r\n                NumberOfWorkers = 0;\r\n                WorkerTimeout = null;\r\n            }, 1000);\r\n            return result;\r\n        });\r\n    }\r\n}\r\n"]}

package/Meshes/Compression/test/integration/draco.test.d.ts

@@ -0,0 +1 @@
+export {};

package/Meshes/Compression/test/integration/draco.test.js

@@ -0,0 +1,30 @@
+import { DracoDecoder } from "../../dracoDecoder.js";
+import { DracoCompression } from "../../dracoCompression.js";
+describe("Draco Mesh Compression tests", () => {
+    describe("DracoDecoder's configuration is affected by updates to DracoCompression's", () => {
+        const originalConfig = { ...DracoDecoder.DefaultConfiguration };
+        const testUrl = "testUrl";
+        afterEach(() => {
+            expect(DracoDecoder.DefaultConfiguration.fallbackUrl).toBe(testUrl);
+            expect(DracoDecoder.DefaultConfiguration.fallbackUrl).toBe(DracoCompression.Configuration.decoder.fallbackUrl);
+            expect(DracoDecoder.DefaultConfiguration).toBe(DracoCompression.Configuration.decoder);
+            DracoDecoder.DefaultConfiguration = originalConfig;
+        });
+        it("updates via DracoCompression.Configuration.decoder.fallbackUrl", () => {
+            DracoCompression.Configuration.decoder.fallbackUrl = testUrl;
+        });
+        it("updates via DracoCompression.Configuration.decoder", () => {
+            DracoCompression.Configuration.decoder = {
+                fallbackUrl: testUrl,
+            };
+        });
+        it("updates via DracoCompression.Configuration", () => {
+            DracoCompression.Configuration = {
+                decoder: {
+                    fallbackUrl: testUrl,
+                },
+            };
+        });
+    });
+});
+//# sourceMappingURL=draco.test.js.map

package/Meshes/Compression/test/integration/draco.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"draco.test.js","sourceRoot":"","sources":["../../../../../../../dev/core/src/Meshes/Compression/test/integration/draco.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC1C,QAAQ,CAAC,2EAA2E,EAAE,GAAG,EAAE;QACvF,MAAM,cAAc,GAA6B,EAAE,GAAG,YAAY,CAAC,oBAAoB,EAAE,CAAC;QAC1F,MAAM,OAAO,GAAG,SAAS,CAAC;QAE1B,SAAS,CAAC,GAAG,EAAE;YACX,MAAM,CAAC,YAAY,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpE,MAAM,CAAC,YAAY,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YAC/G,MAAM,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YACvF,YAAY,CAAC,oBAAoB,GAAG,cAAc,CAAC;QACvD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;YACtE,gBAAgB,CAAC,aAAa,CAAC,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC;QACjE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;YAC1D,gBAAgB,CAAC,aAAa,CAAC,OAAO,GAAG;gBACrC,WAAW,EAAE,OAAO;aACvB,CAAC;QACN,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;YAClD,gBAAgB,CAAC,aAAa,GAAG;gBAC7B,OAAO,EAAE;oBACL,WAAW,EAAE,OAAO;iBACvB;aACJ,CAAC;QACN,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC","sourcesContent":["import { DracoDecoder } from \"../../dracoDecoder\";\nimport type { IDracoCodecConfiguration } from \"../../dracoCodec\";\nimport { DracoCompression } from \"../../dracoCompression\";\n\ndescribe(\"Draco Mesh Compression tests\", () => {\n    describe(\"DracoDecoder's configuration is affected by updates to DracoCompression's\", () => {\n        const originalConfig: IDracoCodecConfiguration = { ...DracoDecoder.DefaultConfiguration };\n        const testUrl = \"testUrl\";\n\n        afterEach(() => {\n            expect(DracoDecoder.DefaultConfiguration.fallbackUrl).toBe(testUrl);\n            expect(DracoDecoder.DefaultConfiguration.fallbackUrl).toBe(DracoCompression.Configuration.decoder.fallbackUrl);\n            expect(DracoDecoder.DefaultConfiguration).toBe(DracoCompression.Configuration.decoder);\n            DracoDecoder.DefaultConfiguration = originalConfig;\n        });\n\n        it(\"updates via DracoCompression.Configuration.decoder.fallbackUrl\", () => {\n            DracoCompression.Configuration.decoder.fallbackUrl = testUrl;\n        });\n\n        it(\"updates via DracoCompression.Configuration.decoder\", () => {\n            DracoCompression.Configuration.decoder = {\n                fallbackUrl: testUrl,\n            };\n        });\n\n        it(\"updates via DracoCompression.Configuration\", () => {\n            DracoCompression.Configuration = {\n                decoder: {\n                    fallbackUrl: testUrl,\n                },\n            };\n        });\n    });\n});\n"]}

package/Meshes/GaussianSplatting/gaussianSplattingMesh.d.ts

@@ -55,7 +55,58 @@ declare enum PLYValue {
     ROT_1 = 31,
     ROT_2 = 32,
     ROT_3 = 33,
-    UNDEFINED = 34
+    MIN_COLOR_R = 34,
+    MIN_COLOR_G = 35,
+    MIN_COLOR_B = 36,
+    MAX_COLOR_R = 37,
+    MAX_COLOR_G = 38,
+    MAX_COLOR_B = 39,
+    SH_0 = 40,
+    SH_1 = 41,
+    SH_2 = 42,
+    SH_3 = 43,
+    SH_4 = 44,
+    SH_5 = 45,
+    SH_6 = 46,
+    SH_7 = 47,
+    SH_8 = 48,
+    SH_9 = 49,
+    SH_10 = 50,
+    SH_11 = 51,
+    SH_12 = 52,
+    SH_13 = 53,
+    SH_14 = 54,
+    SH_15 = 55,
+    SH_16 = 56,
+    SH_17 = 57,
+    SH_18 = 58,
+    SH_19 = 59,
+    SH_20 = 60,
+    SH_21 = 61,
+    SH_22 = 62,
+    SH_23 = 63,
+    SH_24 = 64,
+    SH_25 = 65,
+    SH_26 = 66,
+    SH_27 = 67,
+    SH_28 = 68,
+    SH_29 = 69,
+    SH_30 = 70,
+    SH_31 = 71,
+    SH_32 = 72,
+    SH_33 = 73,
+    SH_34 = 74,
+    SH_35 = 75,
+    SH_36 = 76,
+    SH_37 = 77,
+    SH_38 = 78,
+    SH_39 = 79,
+    SH_40 = 80,
+    SH_41 = 81,
+    SH_42 = 82,
+    SH_43 = 83,
+    SH_44 = 84,
+    UNDEFINED = 85
 }
 /**
  * Property field found in PLY header
@@ -110,6 +161,18 @@ export interface PLYHeader {
      * buffer for the data view
      */
     buffer: ArrayBuffer;
+    /**
+     * degree of SH coefficients
+     */
+    shDegree: number;
+    /**
+     * number of coefficient per splat
+     */
+    shCoefficientCount: number;
+    /**
+     * buffer for SH coefficients
+     */
+    shBuffer: ArrayBuffer | null;
 }
 /**
  * Class used to render a gaussian splatting mesh
@@ -228,12 +291,26 @@ export declare class GaussianSplattingMesh extends Mesh {
     static ParseHeader(data: ArrayBuffer): PLYHeader | null;
     private static _GetCompressedChunks;
     private static _GetSplat;
+    /**
+     * Converts a .ply data with SH coefficients splat
+     * if data array buffer is not ply, returns the original buffer
+     * @param data the .ply data to load
+     * @param useCoroutine use coroutine and yield
+     * @returns the loaded splat buffer and optional array of sh coefficients
+     */
+    static ConvertPLYWithSHToSplat(data: ArrayBuffer, useCoroutine?: boolean): Generator<undefined, {
+        buffer: ArrayBuffer;
+        sh?: undefined;
+    } | {
+        buffer: ArrayBuffer;
+        sh: Uint8Array<ArrayBuffer>[] | null;
+    }, unknown>;
     /**
      * Converts a .ply data array buffer to splat
      * if data array buffer is not ply, returns the original buffer
      * @param data the .ply data to load
      * @param useCoroutine use coroutine and yield
-     * @returns the loaded splat buffer
+     * @returns the loaded splat buffer without SH coefficient, whether ply contains or not SH.
      */
     static ConvertPLYToSplat(data: ArrayBuffer, useCoroutine?: boolean): Generator<undefined, ArrayBuffer, unknown>;
     /**
@@ -243,6 +320,19 @@ export declare class GaussianSplattingMesh extends Mesh {
      * @returns the loaded splat buffer
      */
     static ConvertPLYToSplatAsync(data: ArrayBuffer): Promise<ArrayBuffer>;
+    /**
+     * Converts a .ply with SH data array buffer to splat
+     * if data array buffer is not ply, returns the original buffer
+     * @param data the .ply data to load
+     * @returns the loaded splat buffer with SH
+     */
+    static ConvertPLYWithSHToSplatAsync(data: ArrayBuffer): Promise<{
+        buffer: ArrayBuffer;
+        sh?: undefined;
+    } | {
+        buffer: ArrayBuffer;
+        sh: Uint8Array<ArrayBuffer>[] | null;
+    }>;
     /**
      * Loads a .splat Gaussian Splatting array buffer asynchronously
      * @param data arraybuffer containing splat file