@babylonjs/loaders 8.5.0 → 8.6.0

package/BVH/bvhFileLoader.d.ts

@@ -0,0 +1,66 @@
+import type { ISceneLoaderPluginAsync, ISceneLoaderPluginFactory, ISceneLoaderAsyncResult, SceneLoaderPluginOptions } from "@babylonjs/core/Loading/sceneLoader.js";
+import { AssetContainer } from "@babylonjs/core/assetContainer.js";
+import type { Scene } from "@babylonjs/core/scene.js";
+import type { BVHLoadingOptions } from "./bvhLoadingOptions.js";
+import { BVHFileLoaderMetadata } from "./bvhFileLoader.metadata.js";
+declare module "@babylonjs/core/Loading/sceneLoader.js" {
+    interface SceneLoaderPluginOptions {
+        /**
+         * Defines options for the bvh loader.
+         */
+        [BVHFileLoaderMetadata.name]: Partial<BVHLoadingOptions>;
+    }
+}
+/**
+ * @experimental
+ * BVH file type loader.
+ * This is a babylon scene loader plugin.
+ */
+export declare class BVHFileLoader implements ISceneLoaderPluginAsync, ISceneLoaderPluginFactory {
+    /**
+     * Name of the loader ("bvh")
+     */
+    readonly name: "bvh";
+    /** @internal */
+    readonly extensions: {
+        readonly ".bvh": {
+            readonly isBinary: false;
+        };
+    };
+    private readonly _loadingOptions;
+    /**
+     * Creates loader for bvh motion files
+     * @param loadingOptions - Options for the bvh loader
+     */
+    constructor(loadingOptions?: Partial<Readonly<BVHLoadingOptions>>);
+    private static get _DefaultLoadingOptions();
+    /** @internal */
+    createPlugin(options: SceneLoaderPluginOptions): ISceneLoaderPluginAsync;
+    /**
+     * If the data string can be loaded directly.
+     * @returns if the data can be loaded directly
+     */
+    canDirectLoad(): boolean;
+    /**
+     * Imports  from the loaded gaussian splatting data and adds them to the scene
+     * @param _meshesNames a string or array of strings of the mesh names that should be loaded from the file
+     * @param scene the scene the meshes should be added to
+     * @param data the bvh data to load
+     * @returns a promise containing the loaded skeletons and animations
+     */
+    importMeshAsync(_meshesNames: string | readonly string[] | null | undefined, scene: Scene, data: unknown): Promise<ISceneLoaderAsyncResult>;
+    /**
+     * Imports all objects from the loaded bvh data and adds them to the scene
+     * @param scene the scene the objects should be added to
+     * @param data the bvh data to load
+     * @returns a promise which completes when objects have been loaded to the scene
+     */
+    loadAsync(scene: Scene, data: unknown): Promise<void>;
+    /**
+     * Load into an asset container.
+     * @param scene The scene to load into
+     * @param data The data to import
+     * @returns The loaded asset container
+     */
+    loadAssetContainerAsync(scene: Scene, data: unknown): Promise<AssetContainer>;
+}

package/BVH/bvhFileLoader.js

@@ -0,0 +1,105 @@
+import { RegisterSceneLoaderPlugin } from "@babylonjs/core/Loading/sceneLoader.js";
+import { AssetContainer } from "@babylonjs/core/assetContainer.js";
+import { Animation } from "@babylonjs/core/Animations/animation.js";
+import { BVHFileLoaderMetadata } from "./bvhFileLoader.metadata.js";
+import { ReadBvh } from "./bvhLoader.js";
+/**
+ * @experimental
+ * BVH file type loader.
+ * This is a babylon scene loader plugin.
+ */
+export class BVHFileLoader {
+    /**
+     * Creates loader for bvh motion files
+     * @param loadingOptions - Options for the bvh loader
+     */
+    constructor(loadingOptions) {
+        /**
+         * Name of the loader ("bvh")
+         */
+        this.name = BVHFileLoaderMetadata.name;
+        /** @internal */
+        this.extensions = BVHFileLoaderMetadata.extensions;
+        this._loadingOptions = { ...BVHFileLoader._DefaultLoadingOptions, ...(loadingOptions ?? {}) };
+    }
+    static get _DefaultLoadingOptions() {
+        return {
+            loopMode: Animation.ANIMATIONLOOPMODE_CYCLE,
+        };
+    }
+    /** @internal */
+    createPlugin(options) {
+        return new BVHFileLoader(options[BVHFileLoaderMetadata.name]);
+    }
+    /**
+     * If the data string can be loaded directly.
+     * @returns if the data can be loaded directly
+     */
+    canDirectLoad() {
+        return true;
+    }
+    /**
+     * Imports  from the loaded gaussian splatting data and adds them to the scene
+     * @param _meshesNames a string or array of strings of the mesh names that should be loaded from the file
+     * @param scene the scene the meshes should be added to
+     * @param data the bvh data to load
+     * @returns a promise containing the loaded skeletons and animations
+     */
+    importMeshAsync(_meshesNames, scene, data) {
+        if (typeof data !== "string") {
+            return Promise.reject("BVH loader expects string data.");
+        }
+        try {
+            const skeleton = ReadBvh(data, scene, this._loadingOptions);
+            return Promise.resolve({
+                meshes: [],
+                particleSystems: [],
+                skeletons: [skeleton],
+                animationGroups: [],
+                transformNodes: [],
+                geometries: [],
+                lights: [],
+                spriteManagers: [],
+            });
+        }
+        catch (e) {
+            return Promise.reject(e);
+        }
+    }
+    /**
+     * Imports all objects from the loaded bvh data and adds them to the scene
+     * @param scene the scene the objects should be added to
+     * @param data the bvh data to load
+     * @returns a promise which completes when objects have been loaded to the scene
+     */
+    loadAsync(scene, data) {
+        if (typeof data !== "string") {
+            return Promise.reject("BVH loader expects string data.");
+        }
+        return this.importMeshAsync(null, scene, data).then(() => {
+            // return void
+        });
+    }
+    /**
+     * Load into an asset container.
+     * @param scene The scene to load into
+     * @param data The data to import
+     * @returns The loaded asset container
+     */
+    loadAssetContainerAsync(scene, data) {
+        if (typeof data !== "string") {
+            return Promise.reject("BVH loader expects string data.");
+        }
+        const assetContainer = new AssetContainer(scene);
+        try {
+            const skeleton = ReadBvh(data, scene, this._loadingOptions);
+            assetContainer.skeletons.push(skeleton);
+            return Promise.resolve(assetContainer);
+        }
+        catch (e) {
+            return Promise.reject(e);
+        }
+    }
+}
+RegisterSceneLoaderPlugin(new BVHFileLoader());
+//# sourceMappingURL=bvhFileLoader.js.map

package/BVH/bvhFileLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bvhFileLoader.js","sourceRoot":"","sources":["../../../../dev/loaders/src/BVH/bvhFileLoader.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ISceneLoaderPluginAsync, ISceneLoaderPluginFactory, ISceneLoaderAsyncResult, SceneLoaderPluginOptions } from \"core/Loading/sceneLoader\";\nimport { RegisterSceneLoaderPlugin } from \"core/Loading/sceneLoader\";\nimport { AssetContainer } from \"core/assetContainer\";\nimport { Animation } from \"core/Animations/animation\";\nimport type { Scene } from \"core/scene\";\nimport type { BVHLoadingOptions } from \"./bvhLoadingOptions\";\nimport { BVHFileLoaderMetadata } from \"./bvhFileLoader.metadata\";\nimport { ReadBvh } from \"./bvhLoader\";\n\ndeclare module \"core/Loading/sceneLoader\" {\n    // eslint-disable-next-line jsdoc/require-jsdoc, @typescript-eslint/naming-convention\n    export interface SceneLoaderPluginOptions {\n        /**\n         * Defines options for the bvh loader.\n         */\n        [BVHFileLoaderMetadata.name]: Partial<BVHLoadingOptions>;\n    }\n}\n\n/**\n * @experimental\n * BVH file type loader.\n * This is a babylon scene loader plugin.\n */\nexport class BVHFileLoader implements ISceneLoaderPluginAsync, ISceneLoaderPluginFactory {\n    /**\n     * Name of the loader (\"bvh\")\n     */\n    public readonly name = BVHFileLoaderMetadata.name;\n\n    /** @internal */\n    public readonly extensions = BVHFileLoaderMetadata.extensions;\n\n    private readonly _loadingOptions: BVHLoadingOptions;\n\n    /**\n     * Creates loader for bvh motion files\n     * @param loadingOptions - Options for the bvh loader\n     */\n    constructor(loadingOptions?: Partial<Readonly<BVHLoadingOptions>>) {\n        this._loadingOptions = { ...BVHFileLoader._DefaultLoadingOptions, ...(loadingOptions ?? {}) };\n    }\n\n    private static get _DefaultLoadingOptions(): BVHLoadingOptions {\n        return {\n            loopMode: Animation.ANIMATIONLOOPMODE_CYCLE,\n        };\n    }\n\n    /** @internal */\n    public createPlugin(options: SceneLoaderPluginOptions): ISceneLoaderPluginAsync {\n        return new BVHFileLoader(options[BVHFileLoaderMetadata.name]);\n    }\n\n    /**\n     * If the data string can be loaded directly.\n     * @returns if the data can be loaded directly\n     */\n    public canDirectLoad(): boolean {\n        return true;\n    }\n\n    /**\n     * Imports  from the loaded gaussian splatting data and adds them to the scene\n     * @param _meshesNames a string or array of strings of the mesh names that should be loaded from the file\n     * @param scene the scene the meshes should be added to\n     * @param data the bvh data to load\n     * @returns a promise containing the loaded skeletons and animations\n     */\n    public importMeshAsync(_meshesNames: string | readonly string[] | null | undefined, scene: Scene, data: unknown): Promise<ISceneLoaderAsyncResult> {\n        if (typeof data !== \"string\") {\n            return Promise.reject(\"BVH loader expects string data.\");\n        }\n        try {\n            const skeleton = ReadBvh(data, scene, this._loadingOptions);\n            return Promise.resolve({\n                meshes: [],\n                particleSystems: [],\n                skeletons: [skeleton],\n                animationGroups: [],\n                transformNodes: [],\n                geometries: [],\n                lights: [],\n                spriteManagers: [],\n            });\n        } catch (e) {\n            return Promise.reject(e);\n        }\n    }\n\n    /**\n     * Imports all objects from the loaded bvh data and adds them to the scene\n     * @param scene the scene the objects should be added to\n     * @param data the bvh data to load\n     * @returns a promise which completes when objects have been loaded to the scene\n     */\n    public loadAsync(scene: Scene, data: unknown): Promise<void> {\n        if (typeof data !== \"string\") {\n            return Promise.reject(\"BVH loader expects string data.\");\n        }\n\n        return this.importMeshAsync(null, scene, data).then(() => {\n            // return void\n        });\n    }\n\n    /**\n     * Load into an asset container.\n     * @param scene The scene to load into\n     * @param data The data to import\n     * @returns The loaded asset container\n     */\n    public loadAssetContainerAsync(scene: Scene, data: unknown): Promise<AssetContainer> {\n        if (typeof data !== \"string\") {\n            return Promise.reject(\"BVH loader expects string data.\");\n        }\n        const assetContainer = new AssetContainer(scene);\n        try {\n            const skeleton = ReadBvh(data, scene, this._loadingOptions);\n            assetContainer.skeletons.push(skeleton);\n            return Promise.resolve(assetContainer);\n        } catch (e) {\n            return Promise.reject(e);\n        }\n    }\n}\n\nRegisterSceneLoaderPlugin(new BVHFileLoader());\n"]}

package/BVH/bvhFileLoader.metadata.d.ts

@@ -0,0 +1,8 @@
+export declare const BVHFileLoaderMetadata: {
+    readonly name: "bvh";
+    readonly extensions: {
+        readonly ".bvh": {
+            readonly isBinary: false;
+        };
+    };
+};

package/BVH/bvhFileLoader.metadata.js

@@ -0,0 +1,8 @@
+export const BVHFileLoaderMetadata = {
+    name: "bvh",
+    extensions: {
+        // eslint-disable-next-line @typescript-eslint/naming-convention
+        ".bvh": { isBinary: false },
+    },
+};
+//# sourceMappingURL=bvhFileLoader.metadata.js.map

package/BVH/bvhFileLoader.metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bvhFileLoader.metadata.js","sourceRoot":"","sources":["../../../../dev/loaders/src/BVH/bvhFileLoader.metadata.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACjC,IAAI,EAAE,KAAK;IACX,UAAU,EAAE;QACR,gEAAgE;QAChE,MAAM,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE;KACkB;CACN,CAAC","sourcesContent":["// eslint-disable-next-line import/no-internal-modules\r\nimport type { ISceneLoaderPluginExtensions, ISceneLoaderPluginMetadata } from \"core/index\";\r\n\r\nexport const BVHFileLoaderMetadata = {\r\n    name: \"bvh\",\r\n    extensions: {\r\n        // eslint-disable-next-line @typescript-eslint/naming-convention\r\n        \".bvh\": { isBinary: false },\r\n    } as const satisfies ISceneLoaderPluginExtensions,\r\n} as const satisfies ISceneLoaderPluginMetadata;\r\n"]}

package/BVH/bvhLoader.d.ts

@@ -0,0 +1,11 @@
+import { Skeleton } from "@babylonjs/core/Bones/skeleton.js";
+import type { Scene } from "@babylonjs/core/scene.js";
+import type { BVHLoadingOptions } from "./bvhLoadingOptions.js";
+/**
+ * Reads a BVH file, returns a skeleton
+ * @param text - The BVH file content
+ * @param scene - The scene to add the skeleton to
+ * @param loadingOptions - The loading options
+ * @returns The skeleton
+ */
+export declare function ReadBvh(text: string, scene: Scene, loadingOptions: BVHLoadingOptions): Skeleton;

package/BVH/bvhLoader.js

@@ -0,0 +1,329 @@
+import { Animation } from "@babylonjs/core/Animations/animation.js";
+import { Bone } from "@babylonjs/core/Bones/bone.js";
+import { Skeleton } from "@babylonjs/core/Bones/skeleton.js";
+import { Axis } from "@babylonjs/core/Maths/math.axis.js";
+import { Matrix, Quaternion, Vector3 } from "@babylonjs/core/Maths/math.vector.js";
+import { Tools } from "@babylonjs/core/Misc/tools.js";
+const _XPosition = "Xposition";
+const _YPosition = "Yposition";
+const _ZPosition = "Zposition";
+const _XRotation = "Xrotation";
+const _YRotation = "Yrotation";
+const _ZRotation = "Zrotation";
+const _HierarchyNode = "HIERARCHY";
+const _MotionNode = "MOTION";
+class LoaderContext {
+    constructor(skeleton) {
+        this.loopMode = Animation.ANIMATIONLOOPMODE_CYCLE;
+        this.list = [];
+        this.root = CreateBVHNode();
+        this.numFrames = 0;
+        this.frameRate = 0;
+        this.skeleton = skeleton;
+    }
+}
+function CreateBVHNode() {
+    return {
+        name: "",
+        type: "",
+        offset: new Vector3(),
+        channels: [],
+        children: [],
+        frames: [],
+        parent: null,
+    };
+}
+function CreateBVHKeyFrame() {
+    return {
+        time: 0,
+        position: new Vector3(),
+        rotation: new Quaternion(),
+    };
+}
+/**
+ * Converts the BVH node's offset to a Babylon matrix
+ * @param node - The BVH node to convert
+ * @returns The converted matrix
+ */
+function BoneOffset(node) {
+    const x = node.offset.x;
+    const y = node.offset.y;
+    // Flip Z axis to convert handedness.
+    const z = -node.offset.z;
+    return Matrix.Translation(x, y, z);
+}
+/**
+ * Creates animations for the BVH node
+ * @param node - The BVH node to create animations for
+ * @param context - The loader context
+ * @returns The created animations
+ */
+function CreateAnimations(node, context) {
+    if (node.frames.length === 0) {
+        return null;
+    }
+    const keyFrames = [];
+    // Create position animation if there are position channels
+    const hasPosition = node.channels.some((c) => c === _XPosition || c === _YPosition || c === _ZPosition);
+    // Create rotation animation if there are rotation channels
+    const hasRotation = node.channels.some((c) => c === _XRotation || c === _YRotation || c === _ZRotation);
+    for (let i = 0; i < node.frames.length; i++) {
+        const frame = node.frames[i];
+        const time = i * context.frameRate * 1000; // Convert to milliseconds
+        if (hasPosition || hasRotation) {
+            let matrix = Matrix.Identity();
+            if (hasRotation) {
+                const rotationMatrix = new Matrix();
+                frame.rotation.toRotationMatrix(rotationMatrix);
+                matrix = rotationMatrix;
+            }
+            if (hasPosition) {
+                const position = frame.position;
+                matrix.setTranslation(new Vector3(position.x, position.y, position.z));
+            }
+            keyFrames.push({
+                frame: time,
+                value: matrix,
+            });
+        }
+    }
+    if (keyFrames.length === 0) {
+        return null;
+    }
+    const fps = 60 / context.frameRate;
+    const animation = new Animation(node.name + "_anim", "_matrix", fps, Animation.ANIMATIONTYPE_MATRIX, context.loopMode);
+    animation.setKeys(keyFrames);
+    return animation;
+}
+/**
+ * Converts a BVH node to a Babylon bone
+ * @param node - The BVH node to convert
+ * @param parent - The parent bone
+ * @param context - The loader context
+ */
+function ConvertNode(node, parent, context) {
+    const matrix = BoneOffset(node);
+    const bone = new Bone(node.name, context.skeleton, parent, matrix);
+    // Create animation for this bone
+    const animation = CreateAnimations(node, context);
+    if (animation) {
+        // Apply rotation correction to the root bone's animation keys
+        if (!parent) {
+            // Check if it's the root node
+            const correctionMatrix = Matrix.RotationAxis(Axis.X, Math.PI / 2); // -90 degrees on X-axis
+            const correctedKeys = animation.getKeys().map((key) => {
+                const originalMatrix = key.value;
+                // Apply correction: We want to rotate the final orientation, so post-multiply
+                const correctedMatrix = originalMatrix.multiply(correctionMatrix);
+                return { frame: key.frame, value: correctedMatrix };
+            });
+            animation.setKeys(correctedKeys);
+        }
+        bone.animations.push(animation);
+    }
+    for (const child of node.children) {
+        ConvertNode(child, bone, context);
+    }
+}
+/**
+ * Recursively reads data from a single frame into the bone hierarchy.
+ * The bone hierarchy has to be structured in the same order as the BVH file.
+ * keyframe data is stored in bone.frames.
+ * @param data - splitted string array (frame values), values are shift()ed
+ * @param frameTime - playback time for this keyframe
+ * @param bone - the bone to read frame data from
+ */
+function ReadFrameData(data, frameTime, bone) {
+    if (bone.type === "ENDSITE") {
+        // end sites have no motion data
+        return;
+    }
+    // add keyframe
+    const keyframe = CreateBVHKeyFrame();
+    keyframe.time = frameTime;
+    keyframe.position = new Vector3();
+    keyframe.rotation = new Quaternion();
+    bone.frames.push(keyframe);
+    let pitch = 0, yaw = 0, roll = 0;
+    // parse values for each channel in node
+    for (let i = 0; i < bone.channels.length; ++i) {
+        const value = data.shift();
+        if (!value) {
+            continue;
+        }
+        switch (bone.channels[i]) {
+            case _XPosition:
+                keyframe.position.x = parseFloat(value.trim());
+                break;
+            case _YPosition:
+                keyframe.position.y = parseFloat(value.trim());
+                break;
+            case _ZPosition:
+                keyframe.position.z = -parseFloat(value.trim()); // Flip Z axis to convert handedness.
+                break;
+            case _XRotation:
+                pitch = Tools.ToRadians(+value);
+                break;
+            case _YRotation:
+                yaw = Tools.ToRadians(+value);
+                break;
+            case _ZRotation:
+                roll = Tools.ToRadians(+value);
+                break;
+            default:
+                throw new Error("invalid channel type");
+        }
+    }
+    if (yaw !== 0 || pitch !== 0 || roll !== 0) {
+        // Create rotation matrix in proper order
+        const rotationMatrix = Matrix.Identity();
+        Matrix.RotationYawPitchRollToRef(yaw, pitch, roll, rotationMatrix);
+        keyframe.rotation.fromRotationMatrix(rotationMatrix);
+    }
+    // parse child nodes
+    for (let i = 0; i < bone.children.length; ++i) {
+        ReadFrameData(data, frameTime, bone.children[i]);
+    }
+}
+/**
+ * Recursively parses the HIERARCHY section of the BVH file
+ * @param lines - all lines of the file. lines are consumed as we go along
+ * @param firstLine - line containing the node type and name e.g. "JOINT hip"
+ * @param parent - the parent node for hierarchy
+ * @param context - the loader context containing the list of nodes and other data
+ * @returns a BVH node including children
+ */
+function ReadNode(lines, firstLine, parent, context) {
+    const node = CreateBVHNode();
+    node.parent = parent;
+    context.list.push(node);
+    // parse node type and name.
+    let tokens = firstLine.trim().split(/\s+/);
+    if (tokens[0].toUpperCase() === "END" && tokens[1].toUpperCase() === "SITE") {
+        node.type = "ENDSITE";
+        node.name = "ENDSITE"; // bvh end sites have no name
+    }
+    else {
+        node.name = tokens[1];
+        node.type = tokens[0].toUpperCase();
+    }
+    // opening bracket
+    if (lines.shift()?.trim() != "{") {
+        throw new Error("Expected opening { after type & name");
+    }
+    // parse OFFSET
+    const tokensSplit = lines.shift()?.trim().split(/\s+/);
+    if (!tokensSplit) {
+        throw new Error("Unexpected end of file: missing OFFSET");
+    }
+    tokens = tokensSplit;
+    // check for OFFSET
+    if (tokens[0].toUpperCase() != "OFFSET") {
+        throw new Error("Expected OFFSET, but got: " + tokens[0]);
+    }
+    if (tokens.length != 4) {
+        throw new Error("OFFSET: Invalid number of values");
+    }
+    const offset = new Vector3(parseFloat(tokens[1]), parseFloat(tokens[2]), parseFloat(tokens[3]));
+    if (isNaN(offset.x) || isNaN(offset.y) || isNaN(offset.z)) {
+        throw new Error("OFFSET: Invalid values");
+    }
+    node.offset = offset;
+    // parse CHANNELS definitions
+    if (node.type != "ENDSITE") {
+        tokens = lines.shift()?.trim().split(/\s+/);
+        if (!tokens) {
+            throw new Error("Unexpected end of file: missing CHANNELS");
+        }
+        if (tokens[0].toUpperCase() != "CHANNELS") {
+            throw new Error("Expected CHANNELS definition");
+        }
+        const numChannels = parseInt(tokens[1]);
+        // Skip CHANNELS and the number of channels
+        node.channels = tokens.splice(2, numChannels);
+        node.children = [];
+    }
+    // read children
+    while (lines.length > 0) {
+        const line = lines.shift()?.trim();
+        if (line === "}") {
+            // Finish reading the node
+            return node;
+        }
+        else if (line) {
+            node.children.push(ReadNode(lines, line, node, context));
+        }
+    }
+    throw new Error("Unexpected end of file: missing closing brace");
+}
+/**
+ * Reads a BVH file, returns a skeleton
+ * @param text - The BVH file content
+ * @param scene - The scene to add the skeleton to
+ * @param loadingOptions - The loading options
+ * @returns The skeleton
+ */
+export function ReadBvh(text, scene, loadingOptions) {
+    const lines = text.split("\n");
+    const { loopMode } = loadingOptions;
+    const skeleton = new Skeleton("", "", scene);
+    const context = new LoaderContext(skeleton);
+    context.loopMode = loopMode;
+    // read model structure
+    const firstLine = lines.shift();
+    if (!firstLine || firstLine.trim().toUpperCase() !== _HierarchyNode) {
+        throw new Error("HIERARCHY expected");
+    }
+    const nodeLine = lines.shift();
+    if (!nodeLine) {
+        throw new Error("Unexpected end of file after HIERARCHY");
+    }
+    const root = ReadNode(lines, nodeLine.trim(), null, context);
+    // read motion data
+    const motionLine = lines.shift();
+    if (!motionLine || motionLine.trim().toUpperCase() !== _MotionNode) {
+        throw new Error("MOTION expected");
+    }
+    const framesLine = lines.shift();
+    if (!framesLine) {
+        throw new Error("Unexpected end of file before frame count");
+    }
+    const framesTokens = framesLine.trim().split(/[\s]+/);
+    if (framesTokens.length < 2) {
+        throw new Error("Invalid frame count line");
+    }
+    // number of frames
+    const numFrames = parseInt(framesTokens[1]);
+    if (isNaN(numFrames)) {
+        throw new Error("Failed to read number of frames.");
+    }
+    context.numFrames = numFrames;
+    // frame time
+    const frameTimeLine = lines.shift();
+    if (!frameTimeLine) {
+        throw new Error("Unexpected end of file before frame time");
+    }
+    const frameTimeTokens = frameTimeLine.trim().split(/[\s]+/);
+    if (frameTimeTokens.length < 3) {
+        throw new Error("Invalid frame time line");
+    }
+    const frameTime = parseFloat(frameTimeTokens[2]);
+    if (isNaN(frameTime)) {
+        throw new Error("Failed to read frame time.");
+    }
+    context.frameRate = frameTime;
+    // read frame data line by line
+    for (let i = 0; i < numFrames; ++i) {
+        const frameLine = lines.shift();
+        if (!frameLine) {
+            continue;
+        }
+        const tokens = frameLine.trim().split(/[\s]+/);
+        ReadFrameData(tokens, i * frameTime, root);
+    }
+    context.root = root;
+    ConvertNode(context.root, null, context);
+    context.skeleton.returnToRest();
+    return context.skeleton;
+}
+//# sourceMappingURL=bvhLoader.js.map

package/BVH/bvhLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bvhLoader.js","sourceRoot":"","sources":["../../../../dev/loaders/src/BVH/bvhLoader.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,gDAAkC;AACtD,OAAO,EAAE,IAAI,EAAE,sCAAwB;AACvC,OAAO,EAAE,QAAQ,EAAE,0CAA4B;AAC/C,OAAO,EAAE,IAAI,EAAE,2CAA6B;AAC5C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,6CAA+B;AAIrE,OAAO,EAAE,KAAK,EAAE,sCAAwB;AAExC,MAAM,UAAU,GAAG,WAAW,CAAC;AAC/B,MAAM,UAAU,GAAG,WAAW,CAAC;AAC/B,MAAM,UAAU,GAAG,WAAW,CAAC;AAC/B,MAAM,UAAU,GAAG,WAAW,CAAC;AAC/B,MAAM,UAAU,GAAG,WAAW,CAAC;AAC/B,MAAM,UAAU,GAAG,WAAW,CAAC;AAE/B,MAAM,cAAc,GAAG,WAAW,CAAC;AACnC,MAAM,WAAW,GAAG,QAAQ,CAAC;AAE7B,MAAM,aAAa;IAQf,YAAY,QAAkB;QAP9B,aAAQ,GAAW,SAAS,CAAC,uBAAuB,CAAC;QACrD,SAAI,GAAe,EAAE,CAAC;QACtB,SAAI,GAAa,aAAa,EAAE,CAAC;QACjC,cAAS,GAAW,CAAC,CAAC;QACtB,cAAS,GAAW,CAAC,CAAC;QAIlB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;CACJ;AAkBD,SAAS,aAAa;IAClB,OAAO;QACH,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,EAAE;QACR,MAAM,EAAE,IAAI,OAAO,EAAE;QACrB,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,IAAI;KACf,CAAC;AACN,CAAC;AAED,SAAS,iBAAiB;IACtB,OAAO;QACH,IAAI,EAAE,CAAC;QACP,QAAQ,EAAE,IAAI,OAAO,EAAE;QACvB,QAAQ,EAAE,IAAI,UAAU,EAAE;KAC7B,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,SAAS,UAAU,CAAC,IAAc;IAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACxB,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACxB,qCAAqC;IACrC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACzB,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,IAAc,EAAE,OAAsB;IAC5D,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,SAAS,GAAoB,EAAE,CAAC;IAEtC,2DAA2D;IAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,UAAU,CAAC,CAAC;IAExG,2DAA2D;IAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,UAAU,CAAC,CAAC;IAExG,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,IAAI,GAAG,CAAC,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,0BAA0B;QAErE,IAAI,WAAW,IAAI,WAAW,EAAE,CAAC;YAC7B,IAAI,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;YAE/B,IAAI,WAAW,EAAE,CAAC;gBACd,MAAM,cAAc,GAAG,IAAI,MAAM,EAAE,CAAC;gBACpC,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC;gBAChD,MAAM,GAAG,cAAc,CAAC;YAC5B,CAAC;YAED,IAAI,WAAW,EAAE,CAAC;gBACd,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;gBAChC,MAAM,CAAC,cAAc,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3E,CAAC;YAED,SAAS,CAAC,IAAI,CAAC;gBACX,KAAK,EAAE,IAAI;gBACX,KAAK,EAAE,MAAM;aAChB,CAAC,CAAC;QACP,CAAC;IACL,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IACnC,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,CAAC,oBAAoB,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvH,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAE7B,OAAO,SAAS,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACH,SAAS,WAAW,CAAC,IAAc,EAAE,MAAsB,EAAE,OAAsB;IAC/E,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAEnE,iCAAiC;IACjC,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAClD,IAAI,SAAS,EAAE,CAAC;QACZ,8DAA8D;QAC9D,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,8BAA8B;YAC9B,MAAM,gBAAgB,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,wBAAwB;YAC3F,MAAM,aAAa,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,GAAkB,EAAE,EAAE;gBACjE,MAAM,cAAc,GAAG,GAAG,CAAC,KAAe,CAAC;gBAC3C,8EAA8E;gBAC9E,MAAM,eAAe,GAAG,cAAc,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;gBAClE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;YACxD,CAAC,CAAC,CAAC;YACH,SAAS,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QACrC,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChC,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,aAAa,CAAC,IAAc,EAAE,SAAiB,EAAE,IAAc;IACpE,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC1B,gCAAgC;QAChC,OAAO;IACX,CAAC;IAED,eAAe;IACf,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;IACrC,QAAQ,CAAC,IAAI,GAAG,SAAS,CAAC;IAC1B,QAAQ,CAAC,QAAQ,GAAG,IAAI,OAAO,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,GAAG,IAAI,UAAU,EAAE,CAAC;IAErC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE3B,IAAI,KAAK,GAAG,CAAC,EACT,GAAG,GAAG,CAAC,EACP,IAAI,GAAG,CAAC,CAAC;IAEb,wCAAwC;IACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,SAAS;QACb,CAAC;QAED,QAAQ,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YACvB,KAAK,UAAU;gBACX,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC/C,MAAM;YACV,KAAK,UAAU;gBACX,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC/C,MAAM;YACV,KAAK,UAAU;gBACX,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,qCAAqC;gBACtF,MAAM;YACV,KAAK,UAAU;gBACX,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC;gBAChC,MAAM;YACV,KAAK,UAAU;gBACX,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC;gBAC9B,MAAM;YACV,KAAK,UAAU;gBACX,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC;gBAC/B,MAAM;YACV;gBACI,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAChD,CAAC;IACL,CAAC;IAED,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QACzC,yCAAyC;QACzC,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QACzC,MAAM,CAAC,yBAAyB,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QACnE,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC;IACzD,CAAC;IAED,oBAAoB;IACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;QAC5C,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,QAAQ,CAAC,KAAe,EAAE,SAAiB,EAAE,MAA0B,EAAE,OAAsB;IACpG,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;IAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAExB,4BAA4B;IAC5B,IAAI,MAAM,GAAyB,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEjE,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;QAC1E,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC,6BAA6B;IACxD,CAAC;SAAM,CAAC;QACJ,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACxC,CAAC;IAED,kBAAkB;IAClB,IAAI,KAAK,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC5D,CAAC;IAED,eAAe;IACf,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACvD,IAAI,CAAC,WAAW,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC9D,CAAC;IACD,MAAM,GAAG,WAAW,CAAC;IACrB,mBAAmB;IAEnB,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEhG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IAErB,6BAA6B;IAC7B,IAAI,IAAI,CAAC,IAAI,IAAI,SAAS,EAAE,CAAC;QACzB,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,UAAU,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACpD,CAAC;QAED,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACxC,2CAA2C;QAC3C,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACvB,CAAC;IAED,gBAAgB;IAChB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC;QAEnC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACf,0BAA0B;YAC1B,OAAO,IAAI,CAAC;QAChB,CAAC;aAAM,IAAI,IAAI,EAAE,CAAC;YACd,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7D,CAAC;IACL,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;AACrE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,KAAY,EAAE,cAAiC;IACjF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE/B,MAAM,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAC;IAEpC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;IAE7C,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC5C,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAE5B,uBAAuB;IACvB,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;IAChC,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,cAAc,EAAE,CAAC;QAClE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;IAC/B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC9D,CAAC;IACD,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAE7D,mBAAmB;IACnB,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;IACjC,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,WAAW,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;IACjC,IAAI,CAAC,UAAU,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtD,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAChD,CAAC;IAED,mBAAmB;IACnB,MAAM,SAAS,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,IAAI,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAE9B,aAAa;IACb,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;IACpC,IAAI,CAAC,aAAa,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAChE,CAAC;IACD,MAAM,eAAe,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5D,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC/C,CAAC;IACD,MAAM,SAAS,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,IAAI,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAE9B,+BAA+B;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,SAAS;QACb,CAAC;QACD,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/C,aAAa,CAAC,MAAM,EAAE,CAAC,GAAG,SAAS,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAEpB,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAEzC,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;IAChC,OAAO,OAAO,CAAC,QAAQ,CAAC;AAC5B,CAAC","sourcesContent":["import type { IAnimationKey } from \"core/Animations\";\nimport { Animation } from \"core/Animations/animation\";\nimport { Bone } from \"core/Bones/bone\";\nimport { Skeleton } from \"core/Bones/skeleton\";\nimport { Axis } from \"core/Maths/math.axis\";\nimport { Matrix, Quaternion, Vector3 } from \"core/Maths/math.vector\";\nimport type { Scene } from \"core/scene\";\nimport type { Nullable } from \"core/types\";\nimport type { BVHLoadingOptions } from \"./bvhLoadingOptions\";\nimport { Tools } from \"core/Misc/tools\";\n\nconst _XPosition = \"Xposition\";\nconst _YPosition = \"Yposition\";\nconst _ZPosition = \"Zposition\";\nconst _XRotation = \"Xrotation\";\nconst _YRotation = \"Yrotation\";\nconst _ZRotation = \"Zrotation\";\n\nconst _HierarchyNode = \"HIERARCHY\";\nconst _MotionNode = \"MOTION\";\n\nclass LoaderContext {\n    loopMode: number = Animation.ANIMATIONLOOPMODE_CYCLE;\n    list: IBVHNode[] = [];\n    root: IBVHNode = CreateBVHNode();\n    numFrames: number = 0;\n    frameRate: number = 0;\n    skeleton: Skeleton;\n\n    constructor(skeleton: Skeleton) {\n        this.skeleton = skeleton;\n    }\n}\n\ninterface IBVHNode {\n    name: string;\n    type: string;\n    offset: Vector3;\n    channels: string[];\n    children: IBVHNode[];\n    frames: IBVHKeyFrame[];\n    parent: Nullable<IBVHNode>;\n}\n\ninterface IBVHKeyFrame {\n    time: number;\n    position: Vector3;\n    rotation: Quaternion;\n}\n\nfunction CreateBVHNode(): IBVHNode {\n    return {\n        name: \"\",\n        type: \"\",\n        offset: new Vector3(),\n        channels: [],\n        children: [],\n        frames: [],\n        parent: null,\n    };\n}\n\nfunction CreateBVHKeyFrame(): IBVHKeyFrame {\n    return {\n        time: 0,\n        position: new Vector3(),\n        rotation: new Quaternion(),\n    };\n}\n\n/**\n * Converts the BVH node's offset to a Babylon matrix\n * @param node - The BVH node to convert\n * @returns The converted matrix\n */\nfunction BoneOffset(node: IBVHNode): Matrix {\n    const x = node.offset.x;\n    const y = node.offset.y;\n    // Flip Z axis to convert handedness.\n    const z = -node.offset.z;\n    return Matrix.Translation(x, y, z);\n}\n\n/**\n * Creates animations for the BVH node\n * @param node - The BVH node to create animations for\n * @param context - The loader context\n * @returns The created animations\n */\nfunction CreateAnimations(node: IBVHNode, context: LoaderContext): Animation | null {\n    if (node.frames.length === 0) {\n        return null;\n    }\n\n    const keyFrames: IAnimationKey[] = [];\n\n    // Create position animation if there are position channels\n    const hasPosition = node.channels.some((c) => c === _XPosition || c === _YPosition || c === _ZPosition);\n\n    // Create rotation animation if there are rotation channels\n    const hasRotation = node.channels.some((c) => c === _XRotation || c === _YRotation || c === _ZRotation);\n\n    for (let i = 0; i < node.frames.length; i++) {\n        const frame = node.frames[i];\n        const time = i * context.frameRate * 1000; // Convert to milliseconds\n\n        if (hasPosition || hasRotation) {\n            let matrix = Matrix.Identity();\n\n            if (hasRotation) {\n                const rotationMatrix = new Matrix();\n                frame.rotation.toRotationMatrix(rotationMatrix);\n                matrix = rotationMatrix;\n            }\n\n            if (hasPosition) {\n                const position = frame.position;\n                matrix.setTranslation(new Vector3(position.x, position.y, position.z));\n            }\n\n            keyFrames.push({\n                frame: time,\n                value: matrix,\n            });\n        }\n    }\n\n    if (keyFrames.length === 0) {\n        return null;\n    }\n\n    const fps = 60 / context.frameRate;\n    const animation = new Animation(node.name + \"_anim\", \"_matrix\", fps, Animation.ANIMATIONTYPE_MATRIX, context.loopMode);\n    animation.setKeys(keyFrames);\n\n    return animation;\n}\n\n/**\n * Converts a BVH node to a Babylon bone\n * @param node - The BVH node to convert\n * @param parent - The parent bone\n * @param context - The loader context\n */\nfunction ConvertNode(node: IBVHNode, parent: Nullable<Bone>, context: LoaderContext) {\n    const matrix = BoneOffset(node);\n    const bone = new Bone(node.name, context.skeleton, parent, matrix);\n\n    // Create animation for this bone\n    const animation = CreateAnimations(node, context);\n    if (animation) {\n        // Apply rotation correction to the root bone's animation keys\n        if (!parent) {\n            // Check if it's the root node\n            const correctionMatrix = Matrix.RotationAxis(Axis.X, Math.PI / 2); // -90 degrees on X-axis\n            const correctedKeys = animation.getKeys().map((key: IAnimationKey) => {\n                const originalMatrix = key.value as Matrix;\n                // Apply correction: We want to rotate the final orientation, so post-multiply\n                const correctedMatrix = originalMatrix.multiply(correctionMatrix);\n                return { frame: key.frame, value: correctedMatrix };\n            });\n            animation.setKeys(correctedKeys);\n        }\n        bone.animations.push(animation);\n    }\n\n    for (const child of node.children) {\n        ConvertNode(child, bone, context);\n    }\n}\n\n/**\n * Recursively reads data from a single frame into the bone hierarchy.\n * The bone hierarchy has to be structured in the same order as the BVH file.\n * keyframe data is stored in bone.frames.\n * @param data - splitted string array (frame values), values are shift()ed\n * @param frameTime - playback time for this keyframe\n * @param bone - the bone to read frame data from\n */\nfunction ReadFrameData(data: string[], frameTime: number, bone: IBVHNode) {\n    if (bone.type === \"ENDSITE\") {\n        // end sites have no motion data\n        return;\n    }\n\n    // add keyframe\n    const keyframe = CreateBVHKeyFrame();\n    keyframe.time = frameTime;\n    keyframe.position = new Vector3();\n    keyframe.rotation = new Quaternion();\n\n    bone.frames.push(keyframe);\n\n    let pitch = 0,\n        yaw = 0,\n        roll = 0;\n\n    // parse values for each channel in node\n    for (let i = 0; i < bone.channels.length; ++i) {\n        const value = data.shift();\n        if (!value) {\n            continue;\n        }\n\n        switch (bone.channels[i]) {\n            case _XPosition:\n                keyframe.position.x = parseFloat(value.trim());\n                break;\n            case _YPosition:\n                keyframe.position.y = parseFloat(value.trim());\n                break;\n            case _ZPosition:\n                keyframe.position.z = -parseFloat(value.trim()); // Flip Z axis to convert handedness.\n                break;\n            case _XRotation:\n                pitch = Tools.ToRadians(+value);\n                break;\n            case _YRotation:\n                yaw = Tools.ToRadians(+value);\n                break;\n            case _ZRotation:\n                roll = Tools.ToRadians(+value);\n                break;\n            default:\n                throw new Error(\"invalid channel type\");\n        }\n    }\n\n    if (yaw !== 0 || pitch !== 0 || roll !== 0) {\n        // Create rotation matrix in proper order\n        const rotationMatrix = Matrix.Identity();\n        Matrix.RotationYawPitchRollToRef(yaw, pitch, roll, rotationMatrix);\n        keyframe.rotation.fromRotationMatrix(rotationMatrix);\n    }\n\n    // parse child nodes\n    for (let i = 0; i < bone.children.length; ++i) {\n        ReadFrameData(data, frameTime, bone.children[i]);\n    }\n}\n\n/**\n * Recursively parses the HIERARCHY section of the BVH file\n * @param lines - all lines of the file. lines are consumed as we go along\n * @param firstLine - line containing the node type and name e.g. \"JOINT hip\"\n * @param parent - the parent node for hierarchy\n * @param context - the loader context containing the list of nodes and other data\n * @returns a BVH node including children\n */\nfunction ReadNode(lines: string[], firstLine: string, parent: Nullable<IBVHNode>, context: LoaderContext): IBVHNode {\n    const node = CreateBVHNode();\n    node.parent = parent;\n    context.list.push(node);\n\n    // parse node type and name.\n    let tokens: string[] | undefined = firstLine.trim().split(/\\s+/);\n\n    if (tokens[0].toUpperCase() === \"END\" && tokens[1].toUpperCase() === \"SITE\") {\n        node.type = \"ENDSITE\";\n        node.name = \"ENDSITE\"; // bvh end sites have no name\n    } else {\n        node.name = tokens[1];\n        node.type = tokens[0].toUpperCase();\n    }\n\n    // opening bracket\n    if (lines.shift()?.trim() != \"{\") {\n        throw new Error(\"Expected opening { after type & name\");\n    }\n\n    // parse OFFSET\n    const tokensSplit = lines.shift()?.trim().split(/\\s+/);\n    if (!tokensSplit) {\n        throw new Error(\"Unexpected end of file: missing OFFSET\");\n    }\n    tokens = tokensSplit;\n    // check for OFFSET\n\n    if (tokens[0].toUpperCase() != \"OFFSET\") {\n        throw new Error(\"Expected OFFSET, but got: \" + tokens[0]);\n    }\n    if (tokens.length != 4) {\n        throw new Error(\"OFFSET: Invalid number of values\");\n    }\n\n    const offset = new Vector3(parseFloat(tokens[1]), parseFloat(tokens[2]), parseFloat(tokens[3]));\n\n    if (isNaN(offset.x) || isNaN(offset.y) || isNaN(offset.z)) {\n        throw new Error(\"OFFSET: Invalid values\");\n    }\n\n    node.offset = offset;\n\n    // parse CHANNELS definitions\n    if (node.type != \"ENDSITE\") {\n        tokens = lines.shift()?.trim().split(/\\s+/);\n        if (!tokens) {\n            throw new Error(\"Unexpected end of file: missing CHANNELS\");\n        }\n\n        if (tokens[0].toUpperCase() != \"CHANNELS\") {\n            throw new Error(\"Expected CHANNELS definition\");\n        }\n\n        const numChannels = parseInt(tokens[1]);\n        // Skip CHANNELS and the number of channels\n        node.channels = tokens.splice(2, numChannels);\n        node.children = [];\n    }\n\n    // read children\n    while (lines.length > 0) {\n        const line = lines.shift()?.trim();\n\n        if (line === \"}\") {\n            // Finish reading the node\n            return node;\n        } else if (line) {\n            node.children.push(ReadNode(lines, line, node, context));\n        }\n    }\n\n    throw new Error(\"Unexpected end of file: missing closing brace\");\n}\n\n/**\n * Reads a BVH file, returns a skeleton\n * @param text - The BVH file content\n * @param scene - The scene to add the skeleton to\n * @param loadingOptions - The loading options\n * @returns The skeleton\n */\nexport function ReadBvh(text: string, scene: Scene, loadingOptions: BVHLoadingOptions): Skeleton {\n    const lines = text.split(\"\\n\");\n\n    const { loopMode } = loadingOptions;\n\n    const skeleton = new Skeleton(\"\", \"\", scene);\n\n    const context = new LoaderContext(skeleton);\n    context.loopMode = loopMode;\n\n    // read model structure\n    const firstLine = lines.shift();\n    if (!firstLine || firstLine.trim().toUpperCase() !== _HierarchyNode) {\n        throw new Error(\"HIERARCHY expected\");\n    }\n\n    const nodeLine = lines.shift();\n    if (!nodeLine) {\n        throw new Error(\"Unexpected end of file after HIERARCHY\");\n    }\n    const root = ReadNode(lines, nodeLine.trim(), null, context);\n\n    // read motion data\n    const motionLine = lines.shift();\n    if (!motionLine || motionLine.trim().toUpperCase() !== _MotionNode) {\n        throw new Error(\"MOTION expected\");\n    }\n\n    const framesLine = lines.shift();\n    if (!framesLine) {\n        throw new Error(\"Unexpected end of file before frame count\");\n    }\n    const framesTokens = framesLine.trim().split(/[\\s]+/);\n    if (framesTokens.length < 2) {\n        throw new Error(\"Invalid frame count line\");\n    }\n\n    // number of frames\n    const numFrames = parseInt(framesTokens[1]);\n    if (isNaN(numFrames)) {\n        throw new Error(\"Failed to read number of frames.\");\n    }\n    context.numFrames = numFrames;\n\n    // frame time\n    const frameTimeLine = lines.shift();\n    if (!frameTimeLine) {\n        throw new Error(\"Unexpected end of file before frame time\");\n    }\n    const frameTimeTokens = frameTimeLine.trim().split(/[\\s]+/);\n    if (frameTimeTokens.length < 3) {\n        throw new Error(\"Invalid frame time line\");\n    }\n    const frameTime = parseFloat(frameTimeTokens[2]);\n    if (isNaN(frameTime)) {\n        throw new Error(\"Failed to read frame time.\");\n    }\n\n    context.frameRate = frameTime;\n\n    // read frame data line by line\n    for (let i = 0; i < numFrames; ++i) {\n        const frameLine = lines.shift();\n        if (!frameLine) {\n            continue;\n        }\n        const tokens = frameLine.trim().split(/[\\s]+/);\n        ReadFrameData(tokens, i * frameTime, root);\n    }\n\n    context.root = root;\n\n    ConvertNode(context.root, null, context);\n\n    context.skeleton.returnToRest();\n    return context.skeleton;\n}\n"]}

package/BVH/bvhLoadingOptions.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Options for loading BVH files
+ */
+export type BVHLoadingOptions = {
+    /**
+     * Defines the loop mode of the animation to load.
+     */
+    loopMode: number;
+};

package/BVH/bvhLoadingOptions.js

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

package/BVH/bvhLoadingOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bvhLoadingOptions.js","sourceRoot":"","sources":["../../../../dev/loaders/src/BVH/bvhLoadingOptions.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Options for loading BVH files\n */\nexport type BVHLoadingOptions = {\n    /**\n     * Defines the loop mode of the animation to load.\n     */\n    loopMode: number;\n};\n"]}

package/BVH/index.d.ts

@@ -0,0 +1 @@
+export * from "./bvhLoader.js";

package/BVH/index.js

@@ -0,0 +1,3 @@
+/* eslint-disable import/no-internal-modules */
+export * from "./bvhLoader.js";
+//# sourceMappingURL=index.js.map

package/BVH/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../dev/loaders/src/BVH/index.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,cAAc,aAAa,CAAC","sourcesContent":["/* eslint-disable import/no-internal-modules */\nexport * from \"./bvhLoader\";\n"]}