@babylonjs/core 7.42.0 → 7.44.0

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 Babylon kind of the attribute.
+     */
+    babylonAttribute: string;
+    /**
+     * The Draco kind to use for the attribute.
+     */
+    dracoAttribute: 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 Babylon kind of the attribute.\n     */\n    babylonAttribute: string;\n    /**\n     * The Draco kind to use for the attribute.\n     */\n    dracoAttribute: 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/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