@babylonjs/loaders 9.25.0 → 9.26.1

package/FBX/types/fbxTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"fbxTypes.js","sourceRoot":"","sources":["../../../../../dev/loaders/src/FBX/types/fbxTypes.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG;;;GAGG;AA+CH,0CAA0C;AAC1C,MAAM,UAAU,eAAe,CAAC,IAAa,EAAE,IAAY;IACvD,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,kBAAkB,CAAC,IAAa,EAAE,IAAY;IAC1D,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACxD,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,gBAAgB,CAAC,GAAgB,EAAE,IAAY;IAC3D,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAClD,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,gBAAgB,CAA6B,IAAa,EAAE,KAAa;IACrF,IAAI,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,KAAU,CAAC;IAC7C,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,CAAC,QAAQ,EAAE,qCAAqC,CAAC,CAAC;IACnG,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,SAAS,CAAC,IAAa;IACnC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,EAAE,CAAC;QAC3D,OAAO,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IACxC,0DAA0D;IAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QACf,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,yCAAyC;IACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QAChB,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC","sourcesContent":["/* eslint-disable @typescript-eslint/naming-convention, jsdoc/require-param, jsdoc/require-returns */\r\n/**\r\n * Intermediate representation for parsed FBX data.\r\n * Both binary and ASCII parsers produce this same structure.\r\n */\r\n\r\n/** Individual property value within an FBX node */\r\nexport type FBXPropertyValue = boolean | number | string | Float32Array | Float64Array | Int32Array | Uint8Array;\r\n\r\n/** Parsed FBX property type identifier. */\r\nexport type FBXPropertyType =\r\n    | \"boolean\" // 'C'\r\n    | \"int16\" // 'Y'\r\n    | \"int32\" // 'I'\r\n    | \"int64\" // 'L'\r\n    | \"float32\" // 'F'\r\n    | \"float64\" // 'D'\r\n    | \"string\" // 'S'\r\n    | \"raw\" // 'R'\r\n    | \"float32[]\" // 'f'\r\n    | \"float64[]\" // 'd'\r\n    | \"int32[]\" // 'i'\r\n    | \"int64[]\" // 'l'\r\n    | \"boolean[]\"; // 'b' (stored as Uint8Array where 0=false, 1=true)\r\n\r\n/** Individual property within an FBX node. */\r\nexport interface FBXProperty {\r\n    /** Parsed property type. */\r\n    type: FBXPropertyType;\r\n    /** Parsed property value. */\r\n    value: FBXPropertyValue;\r\n}\r\n\r\n/** A node in the FBX document tree */\r\nexport interface FBXNode {\r\n    /** Node name. */\r\n    name: string;\r\n    /** Node properties. */\r\n    properties: FBXProperty[];\r\n    /** Child nodes. */\r\n    children: FBXNode[];\r\n}\r\n\r\n/** Top-level parsed FBX document */\r\nexport interface FBXDocument {\r\n    /** FBX file version. */\r\n    version: number;\r\n    /** Top-level document nodes. */\r\n    nodes: FBXNode[];\r\n}\r\n\r\n/** Helper to find a child node by name */\r\nexport function findChildByName(node: FBXNode, name: string): FBXNode | undefined {\r\n    return node.children.find((c) => c.name === name);\r\n}\r\n\r\n/** Helper to find all children with a given name */\r\nexport function findChildrenByName(node: FBXNode, name: string): FBXNode[] {\r\n    return node.children.filter((c) => c.name === name);\r\n}\r\n\r\n/** Helper to find a top-level node in a document */\r\nexport function findDocumentNode(doc: FBXDocument, name: string): FBXNode | undefined {\r\n    return doc.nodes.find((n) => n.name === name);\r\n}\r\n\r\n/** Extract a property value by index, with type narrowing */\r\nexport function getPropertyValue<T extends FBXPropertyValue>(node: FBXNode, index: number): T | undefined {\r\n    if (index < node.properties.length) {\r\n        return node.properties[index].value as T;\r\n    }\r\n    return undefined;\r\n}\r\n\r\n/**\r\n * Converts an FBX object ID value to a safe JavaScript number.\r\n * @param value - Parsed FBX object ID value\r\n * @returns The object ID, or undefined when the value is not numeric\r\n */\r\nexport function getSafeFBXObjectId(value: unknown): number | undefined {\r\n    if (typeof value !== \"number\") {\r\n        return undefined;\r\n    }\r\n    if (!Number.isSafeInteger(value)) {\r\n        throw new Error(`Unsafe FBX object ID ${value.toString()}: object IDs must be safe integers.`);\r\n    }\r\n    return value;\r\n}\r\n\r\n/** Get the numeric ID from a node (first property is typically the int64 UID) */\r\nexport function getNodeId(node: FBXNode): number | undefined {\r\n    const prop = node.properties[0];\r\n    if (prop && (prop.type === \"int64\" || prop.type === \"int32\")) {\r\n        return getSafeFBXObjectId(prop.value);\r\n    }\r\n    return undefined;\r\n}\r\n\r\n/**\r\n * Clean FBX object names.\r\n * FBX names may contain:\r\n *   - A \"Class::\" prefix (e.g. \"Model::valkyrie_mesh\") — strip it\r\n *   - A binary null/control-character class suffix — strip it\r\n */\r\nexport function cleanFBXName(fbxName: string): string {\r\n    // Strip \\x00\\x01 suffix (binary FBX name/class separator)\r\n    const nullIdx = fbxName.indexOf(\"\\0\");\r\n    if (nullIdx >= 0) {\r\n        fbxName = fbxName.substring(0, nullIdx);\r\n    }\r\n\r\n    // Strip \"ClassName::\" prefix (ASCII FBX)\r\n    const colonIdx = fbxName.indexOf(\"::\");\r\n    if (colonIdx >= 0) {\r\n        fbxName = fbxName.substring(colonIdx + 2);\r\n    }\r\n\r\n    return fbxName;\r\n}\r\n"]}
+{"version":3,"file":"fbxTypes.js","sourceRoot":"","sources":["../../../../../dev/loaders/src/FBX/types/fbxTypes.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable @typescript-eslint/naming-convention, jsdoc/require-param, jsdoc/require-returns */\n/**\n * Intermediate representation for parsed FBX data.\n * Both binary and ASCII parsers produce this same structure.\n */\n\n/** Individual property value within an FBX node */\nexport type FBXPropertyValue = boolean | number | string | Float32Array | Float64Array | Int32Array | Uint8Array;\n\n/** Parsed FBX property type identifier. */\nexport type FBXPropertyType =\n    | \"boolean\" // 'C'\n    | \"int16\" // 'Y'\n    | \"int32\" // 'I'\n    | \"int64\" // 'L'\n    | \"float32\" // 'F'\n    | \"float64\" // 'D'\n    | \"string\" // 'S'\n    | \"raw\" // 'R'\n    | \"float32[]\" // 'f'\n    | \"float64[]\" // 'd'\n    | \"int32[]\" // 'i'\n    | \"int64[]\" // 'l'\n    | \"boolean[]\"; // 'b' (stored as Uint8Array where 0=false, 1=true)\n\n/** Individual property within an FBX node. */\nexport interface FBXProperty {\n    /** Parsed property type. */\n    type: FBXPropertyType;\n    /** Parsed property value. */\n    value: FBXPropertyValue;\n    /**\n     * Exact decimal text of an int64 whose magnitude exceeds 2^53; `value` then holds the rounded double. Object\n     * ids are the only int64 values where the last bits matter, and `resolveConnections` keys them by this text.\n     */\n    raw?: string;\n}\n\n/** A node in the FBX document tree */\nexport interface FBXNode {\n    /** Node name. */\n    name: string;\n    /** Node properties. */\n    properties: FBXProperty[];\n    /** Child nodes. */\n    children: FBXNode[];\n}\n\n/** Top-level parsed FBX document */\nexport interface FBXDocument {\n    /** FBX file version. */\n    version: number;\n    /** Top-level document nodes. */\n    nodes: FBXNode[];\n}\n\n/** Helper to find a child node by name */\nexport function findChildByName(node: FBXNode, name: string): FBXNode | undefined {\n    return node.children.find((c) => c.name === name);\n}\n\n/** Helper to find all children with a given name */\nexport function findChildrenByName(node: FBXNode, name: string): FBXNode[] {\n    return node.children.filter((c) => c.name === name);\n}\n\n/** Helper to find a top-level node in a document */\nexport function findDocumentNode(doc: FBXDocument, name: string): FBXNode | undefined {\n    return doc.nodes.find((n) => n.name === name);\n}\n\n/** Extract a property value by index, with type narrowing */\nexport function getPropertyValue<T extends FBXPropertyValue>(node: FBXNode, index: number): T | undefined {\n    if (index < node.properties.length) {\n        return node.properties[index].value as T;\n    }\n    return undefined;\n}\n\n/**\n * Validates an FBX object ID value: IDs are 64-bit integers, so anything non-numeric, non-finite or fractional is\n * rejected. IDs beyond 2^53 are carried losslessly through the property's `raw` text by `resolveConnections`.\n * @param value - Parsed FBX object ID value\n * @returns The object ID, or undefined when the value cannot be an ID\n */\nexport function getSafeFBXObjectId(value: unknown): number | undefined {\n    if (typeof value !== \"number\" || !Number.isFinite(value) || !Number.isInteger(value)) {\n        return undefined;\n    }\n    return value;\n}\n\n/** Typed array payload types produced by the parsers. */\nexport type FBXArrayValue = Float32Array | Float64Array | Int32Array | Uint8Array;\n\n/**\n * Returns the array payload of a node.\n * FBX 7.x stores arrays as a single array property. FBX 6.x (and some 7.x ASCII exporters) store them as a run of\n * scalar properties, and a one-element array degenerates to a single scalar. All of these are coalesced here.\n * @param node - Node whose properties hold the array\n * @returns The array, or null when the node has no numeric payload\n */\nexport function getNodeArray(node: FBXNode | undefined | null): FBXArrayValue | null {\n    if (!node || node.properties.length === 0) {\n        return null;\n    }\n    const first = node.properties[0].value;\n    if (node.properties.length === 1 && (first instanceof Float32Array || first instanceof Float64Array || first instanceof Int32Array || first instanceof Uint8Array)) {\n        return first;\n    }\n    const out = new Float64Array(node.properties.length);\n    for (let i = 0; i < node.properties.length; i++) {\n        const v = node.properties[i].value;\n        if (typeof v === \"number\") {\n            out[i] = v;\n        } else if (typeof v === \"boolean\") {\n            out[i] = v ? 1 : 0;\n        } else {\n            return null;\n        }\n    }\n    return out;\n}\n\n/** Get the numeric ID from a node (first property is typically the int64 UID) */\nexport function getNodeId(node: FBXNode): number | undefined {\n    const prop = node.properties[0];\n    if (prop && (prop.type === \"int64\" || prop.type === \"int32\")) {\n        return getSafeFBXObjectId(prop.value);\n    }\n    return undefined;\n}\n\n/**\n * Clean FBX object names.\n * FBX names may contain:\n *   - A \"Class::\" prefix (e.g. \"Model::valkyrie_mesh\") — strip it\n *   - A binary null/control-character class suffix — strip it\n */\nexport function cleanFBXName(fbxName: string): string {\n    // Binary FBX: \"Name\\x00\\x01Class\" — the name is everything before the separator and may itself contain \"::\".\n    const sepIdx = fbxName.indexOf(\"\\0\\x01\");\n    if (sepIdx >= 0) {\n        return fbxName.substring(0, sepIdx);\n    }\n\n    // ASCII FBX: \"Class::Name\" — strip only the leading class prefix (\"Model::Cube::Model\" -> \"Cube::Model\").\n    const colonIdx = fbxName.indexOf(\"::\");\n    if (colonIdx >= 0) {\n        return fbxName.substring(colonIdx + 2);\n    }\n\n    return fbxName;\n}\n"]}

package/SPLAT/gaussianSplattingStream.d.ts

@@ -71,6 +71,18 @@ export interface ISOGLODMetadata {
  * Selects which LOD value drives the {@link GaussianSplattingStream} debug wireframe colors.
  */
 export type GaussianSplattingStreamDebugLodSource = "optimal" | "current";
+/**
+ * Immutable metadata-resolution state for a stream's total number of finest-LOD splats.
+ * @experimental
+ */
+export type GaussianSplattingStreamLod0SplatCount = Readonly<{
+    status: "pending";
+}> | Readonly<{
+    status: "available";
+    count: number;
+}> | Readonly<{
+    status: "unavailable";
+}>;
 /**
  * Options for {@link GaussianSplattingStream}.
  */
@@ -190,6 +202,7 @@ export declare class GaussianSplattingStream extends GaussianSplattingMesh imple
     private readonly _rootUrl;
     private readonly _streamOptions;
     private readonly _leafNodes;
+    private _lod0SplatCount;
     private _lodBaseDistance;
     private _lodMultiplier;
     private _lodBehindPenalty;
@@ -354,6 +367,19 @@ export declare class GaussianSplattingStream extends GaussianSplattingMesh imple
      * @experimental
      */
     get effectiveSplatBudget(): number;
+    /**
+     * The resolved maximum number of splats kept resident in the work buffer. This combines
+     * {@link IGaussianSplattingStreamOptions.maxResidentSplats} and {@link IGaussianSplattingStreamOptions.memoryBudgetMb},
+     * taking the smaller limit when both are configured. `0` means the resident budget is disabled.
+     * @experimental
+     */
+    get residentSplatBudget(): number;
+    /**
+     * The total number of splats represented by valid level-0 leaf entries. This remains pending while source
+     * metadata is loading and is unavailable when no applicable level-0 entries exist or required metadata fails.
+     * @experimental
+     */
+    get lod0SplatCount(): GaussianSplattingStreamLod0SplatCount;
     /**
      * Resolves the raw {@link splatBudget} option to a concrete cap: `undefined` ⇒ 0 (disabled), `"auto"` ⇒ a
      * device-tiered default, a positive number ⇒ itself (floored).
@@ -523,6 +549,11 @@ export declare class GaussianSplattingStream extends GaussianSplattingMesh imple
      * @returns sorted unique file indices
      */
     private _collectAllFileIds;
+    /**
+     * Settles the level-0 diagnostic from normalized renderable leaf entries after their source metadata resolves.
+     * A file may back several leaf ranges, so its source count is deliberately not used in the total.
+     */
+    private _resolveLod0SplatCount;
     /**
      * Fetches the environment bundle and every referenced file's metadata to learn splat counts, caching
      * each file's parsed metadata for the later on-demand decode. Metadata fetches run in parallel.

package/SPLAT/gaussianSplattingStream.js

@@ -97,6 +97,7 @@ export class GaussianSplattingStream extends GaussianSplattingMesh {
         super(name, null, scene, false);
         // Flat list of leaf nodes that carry renderable LOD entries (used by the LOD heuristic and debug).
         this._leafNodes = [];
+        this._lod0SplatCount = Object.freeze({ status: "pending" });
         // LOD heuristic parameters (PlayCanvas-aligned defaults).
         this._lodBaseDistance = 5;
         this._lodMultiplier = 3;
@@ -344,6 +345,7 @@ export class GaussianSplattingStream extends GaussianSplattingMesh {
                 this._disposeAndReclaim();
             }
         }, (e) => {
+            this._lod0SplatCount = Object.freeze({ status: "unavailable" });
             Logger.Error("GaussianSplattingStream: streaming failed: " + (e?.message ?? e));
             this._rejectPartReady("GaussianSplattingStream: streaming failed: " + (e?.message ?? e));
             if (this._hostCompound && !this._disposed) {
@@ -533,6 +535,23 @@ export class GaussianSplattingStream extends GaussianSplattingMesh {
     get effectiveSplatBudget() {
         return this._effectiveSplatBudget();
     }
+    /**
+     * The resolved maximum number of splats kept resident in the work buffer. This combines
+     * {@link IGaussianSplattingStreamOptions.maxResidentSplats} and {@link IGaussianSplattingStreamOptions.memoryBudgetMb},
+     * taking the smaller limit when both are configured. `0` means the resident budget is disabled.
+     * @experimental
+     */
+    get residentSplatBudget() {
+        return this._residentBudget;
+    }
+    /**
+     * The total number of splats represented by valid level-0 leaf entries. This remains pending while source
+     * metadata is loading and is unavailable when no applicable level-0 entries exist or required metadata fails.
+     * @experimental
+     */
+    get lod0SplatCount() {
+        return this._lod0SplatCount;
+    }
     /**
      * Resolves the raw {@link splatBudget} option to a concrete cap: `undefined` ⇒ 0 (disabled), `"auto"` ⇒ a
      * device-tiered default, a positive number ⇒ itself (floored).
@@ -1113,6 +1132,7 @@ export class GaussianSplattingStream extends GaussianSplattingMesh {
         // resolves the max SH degree, so the resident-splat budget can now be sized with the SH/rotation byte cost.
         const fileIds = this._collectAllFileIds();
         const envCount = await this._gatherCountsAsync(fileIds);
+        this._resolveLod0SplatCount();
         if (this._disposed) {
             return;
         }
@@ -1335,6 +1355,35 @@ export class GaussianSplattingStream extends GaussianSplattingMesh {
         }
         return Array.from(ids).sort((a, b) => a - b);
     }
+    /**
+     * Settles the level-0 diagnostic from normalized renderable leaf entries after their source metadata resolves.
+     * A file may back several leaf ranges, so its source count is deliberately not used in the total.
+     */
+    _resolveLod0SplatCount() {
+        let total = 0;
+        let hasLod0Entry = false;
+        for (const node of this._leafNodes) {
+            if (node.availableLevels?.[0] !== 0) {
+                continue;
+            }
+            const entry = node.lods?.["0"];
+            if (!entry) {
+                this._lod0SplatCount = Object.freeze({ status: "unavailable" });
+                return;
+            }
+            hasLod0Entry = true;
+            if (!this._fileCounts.has(entry.file) || !this._fileMeta.has(entry.file)) {
+                this._lod0SplatCount = Object.freeze({ status: "unavailable" });
+                return;
+            }
+            total += entry.count;
+            if (!Number.isSafeInteger(total)) {
+                this._lod0SplatCount = Object.freeze({ status: "unavailable" });
+                return;
+            }
+        }
+        this._lod0SplatCount = hasLod0Entry ? Object.freeze({ status: "available", count: total }) : Object.freeze({ status: "unavailable" });
+    }
     /**
      * Fetches the environment bundle and every referenced file's metadata to learn splat counts, caching
      * each file's parsed metadata for the later on-demand decode. Metadata fetches run in parallel.