@babylonjs/loaders 9.26.0 → 9.26.2

package/FBX/index.d.ts

@@ -1,3 +1,6 @@
 export { FBXFileLoader } from "./fbxFileLoader.js";
-export type { FBXFileLoaderOptions, FBXNormalMapCoordinateSystem } from "./fbxFileLoader.js";
+export type { FBXFileLoaderOptions, FBXNormalMapCoordinateSystem, FBXLoaderWarning } from "./fbxFileLoader.js";
 export { FBXFileLoaderMetadata } from "./fbxFileLoader.metadata.js";
+export { FBXConstraintBehavior, FBXConstraintSolver } from "./fbxConstraintBehavior.js";
+export type { FBXConstraintBehaviorOptions, FBXConstraintBehaviorTarget } from "./fbxConstraintBehavior.js";
+export type { FBXConstraintData, FBXConstraintTarget, FBXConstraintType } from "./interpreter/constraints.js";

package/FBX/index.js

@@ -1,3 +1,4 @@
 export { FBXFileLoader } from "./fbxFileLoader.js";
 export { FBXFileLoaderMetadata } from "./fbxFileLoader.metadata.js";
+export { FBXConstraintBehavior, FBXConstraintSolver } from "./fbxConstraintBehavior.js";
 //# sourceMappingURL=index.js.map

package/FBX/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../dev/loaders/src/FBX/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC","sourcesContent":["export { FBXFileLoader } from \"./fbxFileLoader\";\r\nexport type { FBXFileLoaderOptions, FBXNormalMapCoordinateSystem } from \"./fbxFileLoader\";\r\nexport { FBXFileLoaderMetadata } from \"./fbxFileLoader.metadata\";\r\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../dev/loaders/src/FBX/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC","sourcesContent":["export { FBXFileLoader } from \"./fbxFileLoader\";\nexport type { FBXFileLoaderOptions, FBXNormalMapCoordinateSystem, FBXLoaderWarning } from \"./fbxFileLoader\";\nexport { FBXFileLoaderMetadata } from \"./fbxFileLoader.metadata\";\nexport { FBXConstraintBehavior, FBXConstraintSolver } from \"./fbxConstraintBehavior\";\nexport type { FBXConstraintBehaviorOptions, FBXConstraintBehaviorTarget } from \"./fbxConstraintBehavior\";\nexport type { FBXConstraintData, FBXConstraintTarget, FBXConstraintType } from \"./interpreter/constraints\";\n"]}

package/FBX/interpreter/animation.d.ts

@@ -1,29 +1,9 @@
+import { type FBXDocument } from "../types/fbxTypes.js";
 import { type FBXObjectMap } from "./connections.js";
-export type FBXInterpolationType = "constant" | "linear" | "cubic";
-/** A single keyframe */
-export interface FBXKeyframe {
-    /** Time in seconds */
-    time: number;
-    /** Value at this keyframe */
-    value: number;
-    /** Interpolation used from this key to the next key */
-    interpolation: FBXInterpolationType;
-    /** Constant interpolation variant */
-    constantMode?: "standard" | "next";
-    /** Cubic outgoing slope in value units per second */
-    rightSlope?: number;
-    /** Cubic incoming slope for the next key, in value units per second */
-    nextLeftSlope?: number;
-}
-/** An animation curve (one axis of one property) */
-export interface FBXCurveData {
-    /** Channel: "d|X", "d|Y", "d|Z" */
-    channel: string;
-    /** Keyframes */
-    keys: FBXKeyframe[];
-    /** True for baked sample curves that should be connected as linear samples */
-    isSampled?: boolean;
-}
+import { type FBXCurveData, type FBXLayerBlend } from "./animationCurve.js";
+export { FBX_TIME_UNIT } from "./animationCurve.js";
+export type { FBXCurveData, FBXExtrapolation, FBXExtrapolationMode, FBXInterpolationType, FBXKeyframe, FBXLayerBlend } from "./animationCurve.js";
+export { combineLayerValue, evaluateCurve, eulerToQuat, quatToEuler } from "./animationCurve.js";
 /** An animation curve node (T/R/S for one bone) */
 export interface FBXCurveNodeData {
     /** Property type: "T" (translation), "R" (rotation), "S" (scale) */
@@ -32,13 +12,19 @@ export interface FBXCurveNodeData {
     targetModelId: number;
     /** Curves for each axis */
     curves: FBXCurveData[];
+    /** Index of the owning layer within the stack's layer list */
+    layerIndex: number;
+    /** Default channel values (`d|X`, `d|Y`, `d|Z`) used for channels without a curve */
+    defaultValues?: [number, number, number];
 }
-/** Unsupported animation curve node preserved for diagnostics and future support. */
+/** Non-transform animation curve node (property animation), evaluated by the loader when a Babylon mapping exists. */
 export interface FBXUnsupportedCurveNodeData {
     /** Raw AnimationCurveNode property type/name */
     type: string;
     /** CurveNode object ID */
     id: number;
+    /** Index of the owning layer within the stack's layer list */
+    layerIndex: number;
     /** Target object ID if the curve node is connected to an object/property */
     targetId: number | null;
     /** OP connection property name on the target, e.g. Visibility */
@@ -77,6 +63,10 @@ export interface FBXAnimationLayerData {
     normalizedWeight: number;
     /** Blend mode: 0=Additive, 1=Override, 2=OverridePassthrough */
     blendMode: number;
+    /** Resolved blend semantics used by the evaluator */
+    blend: FBXLayerBlend;
+    /** Animated layer weight (0-100), when the Weight property carries a curve */
+    weightCurve?: FBXCurveData;
     /** Curve nodes in this layer */
     curveNodes: FBXCurveNodeData[];
     /** Unsupported/non-TRS curve nodes preserved for diagnostics */
@@ -84,6 +74,14 @@ export interface FBXAnimationLayerData {
     /** Recoverable layer diagnostics */
     diagnostics: FBXAnimationDiagnostic[];
 }
+/** Options for animation extraction. */
+export interface FBXAnimationExtractOptions {
+    /**
+     * Shift each clip so its first key sits at time 0 (default true). False keeps the times authored in the file, so
+     * clips of one file stay aligned with each other and with the declared stack range.
+     */
+    rebaseKeyframes?: boolean;
+}
 /** One animation clip (AnimationStack) */
 export interface FBXAnimationStackData {
     /** Animation name */
@@ -106,13 +104,7 @@ export interface FBXAnimationStackData {
 /**
  * Extract all animation stacks from the FBX scene.
  */
-export declare function extractAnimations(objectMap: FBXObjectMap): FBXAnimationStackData[];
-/**
- * Determines whether a key sequence appears to be a uniformly frame-baked sampled curve.
- * @param keys - Keyframes to inspect
- * @returns true if the keys look like sampled frame data rather than authored interpolation
- */
-export declare function isFrameBakedSampledCurve(keys: readonly FBXKeyframe[]): boolean;
+export declare function extractAnimations(objectMap: FBXObjectMap, doc?: FBXDocument, options?: FBXAnimationExtractOptions): FBXAnimationStackData[];
 /**
  * Samples an FBX animation curve at a specific time.
  * @param curveData - Curve data to sample
@@ -120,3 +112,51 @@ export declare function isFrameBakedSampledCurve(keys: readonly FBXKeyframe[]):
  * @returns The sampled value, or null when the curve has no keys
  */
 export declare function sampleFBXCurveAtTime(curveData: FBXCurveData | undefined, time: number): number | null;
+/**
+ * Pre-7000 files store animation in a top-level `Takes` block instead of AnimationStack/Layer/CurveNode objects:
+ *
+ *   Takes: { Take: "name" { LocalTime: start, stop
+ *     Model: "Model::joint1" { Channel: "Transform" { Channel: "T" { Channel: "X" { Default, KeyVer, KeyCount, Key } } } } } }
+ *
+ * Each take becomes one animation stack with a single layer. Models are matched through the same legacy string ids
+ * that the connection resolver synthesizes for 6.x objects.
+ */
+export declare function extractLegacyTakes(doc: FBXDocument, objectMap: FBXObjectMap, rebaseKeyframes?: boolean): FBXAnimationStackData[];
+/**
+ * Evaluates one transform channel (T, R or S) of a target at `time`, blending every animation layer of the stack the
+ * way the FBX SDK does: the first layer animating the channel replaces the static value, later layers are combined
+ * according to their blend mode, weight and accumulation modes.
+ * @param curveNodes - Curve nodes targeting this model (any layers, any types)
+ * @param layers - Stack layers, in order
+ * @param type - Channel to evaluate
+ * @param staticValue - Value when nothing animates the channel
+ * @param rotationOrder - Rotation order of the target (for rotation composition)
+ * @param time - Time in seconds
+ */
+export declare function evaluateLayeredChannel(curveNodes: readonly FBXCurveNodeData[], layers: readonly FBXAnimationLayerData[], type: "T" | "R" | "S", staticValue: readonly [number, number, number], rotationOrder: number, time: number): [number, number, number];
+/** Curves of one animated property (or blend shape weight) contributed by one animation layer. */
+export interface FBXLayeredPropertySource {
+    /** Index of the owning layer within the stack's layer list */
+    layerIndex: number;
+    /** Curves of the property, keyed by channel name (`d|X`, `d|DeformPercent`, ...) */
+    curves: readonly FBXCurveData[];
+    /** Default channel values stored on the curve node */
+    defaultValues?: Record<string, number>;
+}
+/**
+ * Evaluates an animated property through the animation layers: the base layer replaces the static value, every
+ * further layer blends onto the running result according to its blend mode and (possibly animated) weight, like
+ * `evaluateLayeredChannel` does for transforms.
+ * @param sources - Per-layer curves of the property
+ * @param layers - Stack layers, in order
+ * @param channels - Channel names to evaluate, in output order
+ * @param staticValue - Value per channel when nothing animates it
+ * @param time - Time in seconds
+ * @returns One value per channel
+ */
+export declare function evaluateLayeredProperty(sources: readonly FBXLayeredPropertySource[], layers: readonly FBXAnimationLayerData[], channels: readonly string[], staticValue: readonly number[], time: number): number[];
+/**
+ * True when every curve of the given channel is inside a constant (stepped) segment at `time`, so a baked key at
+ * that time should hold its value instead of interpolating towards the next sample.
+ */
+export declare function isChannelSteppedAt(curveNodes: readonly FBXCurveNodeData[], type: "T" | "R" | "S", time: number): boolean;