reze-engine 0.3.12 → 0.3.13

package/dist/ik.d.ts

@@ -0,0 +1,32 @@
+import { Vec3 } from "./math";
+import type { Skeleton } from "./model";
+export interface IKLink {
+    boneIndex: number;
+    hasLimit: boolean;
+    minAngle?: Vec3;
+    maxAngle?: Vec3;
+}
+export interface IKChain {
+    targetBoneIndex: number;
+    effectorBoneIndex: number;
+    iterationCount: number;
+    rotationConstraint: number;
+    links: IKLink[];
+    enabled: boolean;
+}
+export declare class IK {
+    private chains;
+    private computeWorldMatricesCallback?;
+    private lastTargetPositions;
+    private convergedChains;
+    private ikRotations;
+    constructor(chains?: IKChain[]);
+    setComputeWorldMatricesCallback(callback: () => void): void;
+    getChains(): IKChain[];
+    enableChain(targetBoneName: string, enabled: boolean): void;
+    solve(skeleton: Skeleton, localRotations: Float32Array, localTranslations: Float32Array, worldMatrices: Float32Array): void;
+    private solveCCD;
+    private applyAngleConstraints;
+    private computeWorldMatrices;
+}
+//# sourceMappingURL=ik.d.ts.map

package/dist/ik.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ik.d.ts","sourceRoot":"","sources":["../src/ik.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,IAAI,EAAQ,MAAM,QAAQ,CAAA;AACzC,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,SAAS,CAAA;AAE7C,MAAM,WAAW,MAAM;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,IAAI,CAAA;IACf,QAAQ,CAAC,EAAE,IAAI,CAAA;CAChB;AAED,MAAM,WAAW,OAAO;IACtB,eAAe,EAAE,MAAM,CAAA;IACvB,iBAAiB,EAAE,MAAM,CAAA;IACzB,cAAc,EAAE,MAAM,CAAA;IACtB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,qBAAa,EAAE;IACb,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,4BAA4B,CAAC,CAAY;IAEjD,OAAO,CAAC,mBAAmB,CAA+B;IAE1D,OAAO,CAAC,eAAe,CAAyB;IAEhD,OAAO,CAAC,WAAW,CAA+B;gBAEtC,MAAM,GAAE,OAAO,EAAO;IAMlC,+BAA+B,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAI3D,SAAS,IAAI,OAAO,EAAE;IAKtB,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAU3D,KAAK,CACH,QAAQ,EAAE,QAAQ,EAClB,cAAc,EAAE,YAAY,EAC5B,iBAAiB,EAAE,YAAY,EAC/B,aAAa,EAAE,YAAY,GAC1B,IAAI;IA2FP,OAAO,CAAC,QAAQ;IAqLhB,OAAO,CAAC,qBAAqB;IAe7B,OAAO,CAAC,oBAAoB;CAsG7B"}

package/dist/ik.js

@@ -0,0 +1,337 @@
+import { Quat, Vec3, Mat4 } from "./math";
+export class IK {
+    constructor(chains = []) {
+        // Track last target positions to detect movement
+        this.lastTargetPositions = new Map();
+        // Track convergence state for each chain (true = converged, skip solving)
+        this.convergedChains = new Set();
+        // Accumulated IK rotations for each bone (boneIndex -> quaternion)
+        this.ikRotations = new Map();
+        this.chains = chains;
+    }
+    // Set the callback to use Model's computeWorldMatrices
+    // The callback doesn't need parameters since Model uses its own runtime state
+    setComputeWorldMatricesCallback(callback) {
+        this.computeWorldMatricesCallback = callback;
+    }
+    getChains() {
+        return this.chains;
+    }
+    // Enable/disable IK chain by target bone name
+    enableChain(targetBoneName, enabled) {
+        // Chains are identified by target bone index, but we need to find by name
+        // This will be called from Model which has bone name lookup
+        for (const chain of this.chains) {
+            // We'll need to pass bone names or use indices - for now, this is a placeholder
+            // The actual implementation will be in Model class
+        }
+    }
+    // Main IK solve method - modifies bone local rotations in-place
+    solve(skeleton, localRotations, localTranslations, worldMatrices) {
+        if (this.chains.length === 0)
+            return;
+        const boneCount = skeleton.bones.length;
+        // Reset accumulated IK rotations for all chain bones (as per reference)
+        for (const chain of this.chains) {
+            for (const link of chain.links) {
+                const boneIdx = link.boneIndex;
+                if (boneIdx >= 0 && boneIdx < boneCount) {
+                    this.ikRotations.set(boneIdx, new Quat(0, 0, 0, 1));
+                }
+            }
+        }
+        // Use Model's computeWorldMatrices if available (it uses the same arrays)
+        // Otherwise fall back to simplified version
+        if (this.computeWorldMatricesCallback) {
+            this.computeWorldMatricesCallback();
+        }
+        else {
+            // Fallback to simplified version (shouldn't happen in normal usage)
+            this.computeWorldMatrices(skeleton, localRotations, localTranslations, worldMatrices);
+        }
+        // Solve each IK chain
+        for (const chain of this.chains) {
+            if (!chain.enabled)
+                continue;
+            const targetBoneIdx = chain.targetBoneIndex;
+            const effectorBoneIdx = chain.effectorBoneIndex;
+            if (targetBoneIdx < 0 || targetBoneIdx >= boneCount || effectorBoneIdx < 0 || effectorBoneIdx >= boneCount) {
+                continue;
+            }
+            // Get target position (world position of target bone)
+            // In MMD, the target bone is the bone that should reach a specific position
+            // The target bone's current world position is where we want the effector to reach
+            const targetWorldMatIdx = targetBoneIdx * 16;
+            const targetWorldMat = new Mat4(worldMatrices.subarray(targetWorldMatIdx, targetWorldMatIdx + 16));
+            const targetPos = targetWorldMat.getPosition();
+            // Check if target has moved (detect any movement, even small)
+            const lastTargetPos = this.lastTargetPositions.get(targetBoneIdx);
+            let targetMoved = false;
+            if (!lastTargetPos) {
+                // First time seeing this target, initialize position and always solve
+                this.lastTargetPositions.set(targetBoneIdx, new Vec3(targetPos.x, targetPos.y, targetPos.z));
+                targetMoved = true;
+            }
+            else {
+                const targetMoveDistance = targetPos.subtract(lastTargetPos).length();
+                targetMoved = targetMoveDistance > 0.001; // Detect any movement > 0.001 units (0.1mm)
+            }
+            // Get current effector position
+            const effectorWorldMatIdx = effectorBoneIdx * 16;
+            const effectorWorldMat = new Mat4(worldMatrices.subarray(effectorWorldMatIdx, effectorWorldMatIdx + 16));
+            const effectorPos = effectorWorldMat.getPosition();
+            // Check distance to target
+            const distanceToTarget = effectorPos.subtract(targetPos).length();
+            // If target moved, always clear convergence and solve
+            if (targetMoved) {
+                this.convergedChains.delete(targetBoneIdx);
+                this.lastTargetPositions.set(targetBoneIdx, new Vec3(targetPos.x, targetPos.y, targetPos.z));
+                // Always solve when target moves, regardless of distance
+            }
+            else if (distanceToTarget < 0.1) {
+                // Target hasn't moved and we're already close, skip solving
+                if (!this.convergedChains.has(targetBoneIdx)) {
+                    this.convergedChains.add(targetBoneIdx);
+                }
+                continue;
+            }
+            // Otherwise, solve (target hasn't moved but effector is far from target)
+            // Solve using CCD
+            // Note: In PMX, links are stored from effector toward root
+            // So links[0] is the effector, links[links.length-1] is closest to root
+            this.solveCCD(chain, skeleton, localRotations, localTranslations, worldMatrices, targetPos);
+            // Recompute world matrices after IK adjustments
+            if (this.computeWorldMatricesCallback) {
+                this.computeWorldMatricesCallback();
+            }
+            else {
+                this.computeWorldMatrices(skeleton, localRotations, localTranslations, worldMatrices);
+            }
+        }
+    }
+    // Cyclic Coordinate Descent IK solver (based on saba MMD implementation)
+    solveCCD(chain, skeleton, localRotations, localTranslations, worldMatrices, targetPos) {
+        const bones = skeleton.bones;
+        const iterationCount = chain.iterationCount;
+        const rotationConstraint = chain.rotationConstraint;
+        const links = chain.links;
+        if (links.length === 0)
+            return;
+        const effectorBoneIdx = chain.effectorBoneIndex;
+        // Get effector position
+        const effectorWorldMatIdx = effectorBoneIdx * 16;
+        const effectorWorldMat = new Mat4(worldMatrices.subarray(effectorWorldMatIdx, effectorWorldMatIdx + 16));
+        let effectorPos = effectorWorldMat.getPosition();
+        // Check initial distance - only skip if extremely close (numerical precision threshold)
+        const initialDistanceSq = effectorPos.subtract(targetPos).lengthSquared();
+        if (initialDistanceSq < 1.0e-10) {
+            this.convergedChains.add(chain.targetBoneIndex);
+            return;
+        }
+        const halfIteration = iterationCount >> 1;
+        for (let iter = 0; iter < iterationCount; iter++) {
+            const useAxis = iter < halfIteration;
+            for (let linkIdx = 0; linkIdx < links.length; linkIdx++) {
+                const link = links[linkIdx];
+                const jointBoneIdx = link.boneIndex;
+                if (jointBoneIdx < 0 || jointBoneIdx >= bones.length)
+                    continue;
+                const bone = bones[jointBoneIdx];
+                // Get joint world position
+                const jointWorldMatIdx = jointBoneIdx * 16;
+                const jointWorldMat = new Mat4(worldMatrices.subarray(jointWorldMatIdx, jointWorldMatIdx + 16));
+                const jointPos = jointWorldMat.getPosition();
+                // Vectors: from joint to target and effector (REVERSED from typical CCD!)
+                // This matches the reference implementation
+                const chainTargetVector = jointPos.subtract(targetPos).normalize();
+                const chainIkVector = jointPos.subtract(effectorPos).normalize();
+                // Rotation axis: cross product
+                const chainRotationAxis = chainTargetVector.cross(chainIkVector);
+                const axisLenSq = chainRotationAxis.lengthSquared();
+                // Skip if axis is too small (vectors are parallel)
+                if (axisLenSq < 1.0e-8)
+                    continue;
+                const chainRotationAxisNorm = chainRotationAxis.normalize();
+                // Get parent's world rotation matrix (rotation part only)
+                let parentWorldRot;
+                if (bone.parentIndex >= 0 && bone.parentIndex < bones.length) {
+                    const parentWorldMatIdx = bone.parentIndex * 16;
+                    const parentWorldMat = new Mat4(worldMatrices.subarray(parentWorldMatIdx, parentWorldMatIdx + 16));
+                    parentWorldRot = parentWorldMat.toQuat();
+                }
+                else {
+                    parentWorldRot = new Quat(0, 0, 0, 1);
+                }
+                // Transform rotation axis to parent's local space
+                // Invert parent rotation: parentWorldRot^-1
+                const parentWorldRotInv = parentWorldRot.conjugate();
+                // Transform axis: parentWorldRotInv * axis (as vector)
+                const localAxis = parentWorldRotInv.rotateVec(chainRotationAxisNorm).normalize();
+                // Calculate angle between vectors
+                const dot = Math.max(-1.0, Math.min(1.0, chainTargetVector.dot(chainIkVector)));
+                const angle = Math.min(rotationConstraint * (linkIdx + 1), Math.acos(dot));
+                // Create rotation quaternion from axis and angle
+                // q = (sin(angle/2) * axis, cos(angle/2))
+                const halfAngle = angle * 0.5;
+                const sinHalf = Math.sin(halfAngle);
+                const cosHalf = Math.cos(halfAngle);
+                const rotationFromAxis = new Quat(localAxis.x * sinHalf, localAxis.y * sinHalf, localAxis.z * sinHalf, cosHalf).normalize();
+                // Get accumulated ikRotation for this bone (or identity if first time)
+                let accumulatedIkRot = this.ikRotations.get(jointBoneIdx) || new Quat(0, 0, 0, 1);
+                // Accumulate rotation: ikRotation = rotationFromAxis * ikRotation
+                // Reference: ikRotation.multiplyToRef(chainBone.ikChainInfo!.ikRotation, chainBone.ikChainInfo!.ikRotation)
+                // This means: ikRotation = rotationFromAxis * accumulatedIkRot
+                accumulatedIkRot = rotationFromAxis.multiply(accumulatedIkRot);
+                this.ikRotations.set(jointBoneIdx, accumulatedIkRot);
+                // Get current local rotation
+                const qi = jointBoneIdx * 4;
+                const currentLocalRot = new Quat(localRotations[qi], localRotations[qi + 1], localRotations[qi + 2], localRotations[qi + 3]);
+                // Reference: ikRotation.multiplyToRef(chainBone.ikChainInfo!.localRotation, ikRotation)
+                // This means: tempRot = accumulatedIkRot * currentLocalRot
+                let tempRot = accumulatedIkRot.multiply(currentLocalRot);
+                // Apply angle constraints if specified (on the combined rotation)
+                if (link.hasLimit && link.minAngle && link.maxAngle) {
+                    tempRot = this.applyAngleConstraints(tempRot, link.minAngle, link.maxAngle);
+                }
+                // Reference: ikRotation.multiplyToRef(invertedLocalRotation, ikRotation)
+                // This means: accumulatedIkRot = tempRot * currentLocalRot^-1
+                // But we need the new local rotation, not the accumulated IK rotation
+                // The new local rotation should be: newLocalRot such that accumulatedIkRot * newLocalRot = tempRot
+                // So: newLocalRot = accumulatedIkRot^-1 * tempRot
+                // But wait, the reference updates ikRotation, not localRotation directly...
+                // Actually, looking at the reference, it seems like ikRotation is used to compute the final rotation
+                // Let me try a different approach: the reference applies constraints to (ikRotation * localRotation)
+                // then extracts the new ikRotation, but we need the new localRotation
+                // Actually, I think the issue is that we should apply: newLocalRot = tempRot (the constrained result)
+                // But we need to extract what the new local rotation should be
+                // If tempRot = accumulatedIkRot * currentLocalRot (after constraints)
+                // Then: newLocalRot = accumulatedIkRot^-1 * tempRot
+                const accumulatedIkRotInv = accumulatedIkRot.conjugate();
+                let newLocalRot = accumulatedIkRotInv.multiply(tempRot);
+                // Update local rotation
+                const normalized = newLocalRot.normalize();
+                localRotations[qi] = normalized.x;
+                localRotations[qi + 1] = normalized.y;
+                localRotations[qi + 2] = normalized.z;
+                localRotations[qi + 3] = normalized.w;
+                // Update accumulated IK rotation as per reference
+                const localRotInv = currentLocalRot.conjugate();
+                accumulatedIkRot = tempRot.multiply(localRotInv);
+                this.ikRotations.set(jointBoneIdx, accumulatedIkRot);
+                // Update world matrices after this link adjustment (only once per link, not per bone)
+                if (this.computeWorldMatricesCallback) {
+                    this.computeWorldMatricesCallback();
+                }
+                else {
+                    this.computeWorldMatrices(skeleton, localRotations, localTranslations, worldMatrices);
+                }
+                // Update effector position for next link
+                const updatedEffectorMat2 = new Mat4(worldMatrices.subarray(effectorWorldMatIdx, effectorWorldMatIdx + 16));
+                effectorPos = updatedEffectorMat2.getPosition();
+                // Early exit if converged (check against original target position)
+                const currentDistanceSq = effectorPos.subtract(targetPos).lengthSquared();
+                if (currentDistanceSq < 1.0e-10) {
+                    this.convergedChains.add(chain.targetBoneIndex);
+                    return;
+                }
+            }
+            // Check convergence at end of iteration
+            const finalEffectorMat = new Mat4(worldMatrices.subarray(effectorWorldMatIdx, effectorWorldMatIdx + 16));
+            const finalEffectorPos = finalEffectorMat.getPosition();
+            const finalDistanceSq = finalEffectorPos.subtract(targetPos).lengthSquared();
+            if (finalDistanceSq < 1.0e-10) {
+                this.convergedChains.add(chain.targetBoneIndex);
+                break;
+            }
+        }
+    }
+    // Apply angle constraints to local rotation (Euler angle limits)
+    applyAngleConstraints(localRot, minAngle, maxAngle) {
+        // Convert quaternion to Euler angles
+        const euler = localRot.toEuler();
+        // Clamp each Euler angle component
+        let clampedX = Math.max(minAngle.x, Math.min(maxAngle.x, euler.x));
+        let clampedY = Math.max(minAngle.y, Math.min(maxAngle.y, euler.y));
+        let clampedZ = Math.max(minAngle.z, Math.min(maxAngle.z, euler.z));
+        // Convert back to quaternion (ZXY order, left-handed)
+        return Quat.fromEuler(clampedX, clampedY, clampedZ);
+    }
+    // Compute world matrices from local rotations and translations
+    // This matches Model.computeWorldMatrices logic (including append transforms)
+    computeWorldMatrices(skeleton, localRotations, localTranslations, worldMatrices) {
+        const bones = skeleton.bones;
+        const boneCount = bones.length;
+        const computed = new Array(boneCount).fill(false);
+        const computeWorld = (i) => {
+            if (computed[i])
+                return;
+            const bone = bones[i];
+            if (bone.parentIndex >= boneCount) {
+                console.warn(`[IK] bone ${i} parent out of range: ${bone.parentIndex}`);
+            }
+            const qi = i * 4;
+            const ti = i * 3;
+            // Get local rotation
+            let rotateM = Mat4.fromQuat(localRotations[qi], localRotations[qi + 1], localRotations[qi + 2], localRotations[qi + 3]);
+            let addLocalTx = 0, addLocalTy = 0, addLocalTz = 0;
+            // Handle append transforms (same as Model.computeWorldMatrices)
+            const appendParentIdx = bone.appendParentIndex;
+            const hasAppend = bone.appendRotate && appendParentIdx !== undefined && appendParentIdx >= 0 && appendParentIdx < boneCount;
+            if (hasAppend) {
+                const ratio = bone.appendRatio === undefined ? 1 : Math.max(-1, Math.min(1, bone.appendRatio));
+                const hasRatio = Math.abs(ratio) > 1e-6;
+                if (hasRatio) {
+                    const apQi = appendParentIdx * 4;
+                    const apTi = appendParentIdx * 3;
+                    if (bone.appendRotate) {
+                        let ax = localRotations[apQi];
+                        let ay = localRotations[apQi + 1];
+                        let az = localRotations[apQi + 2];
+                        const aw = localRotations[apQi + 3];
+                        const absRatio = ratio < 0 ? -ratio : ratio;
+                        if (ratio < 0) {
+                            ax = -ax;
+                            ay = -ay;
+                            az = -az;
+                        }
+                        const identityQuat = new Quat(0, 0, 0, 1);
+                        const appendQuat = new Quat(ax, ay, az, aw);
+                        const result = Quat.slerp(identityQuat, appendQuat, absRatio);
+                        rotateM = Mat4.fromQuat(result.x, result.y, result.z, result.w).multiply(rotateM);
+                    }
+                    if (bone.appendMove) {
+                        const appendRatio = bone.appendRatio ?? 1;
+                        addLocalTx = localTranslations[apTi] * appendRatio;
+                        addLocalTy = localTranslations[apTi + 1] * appendRatio;
+                        addLocalTz = localTranslations[apTi + 2] * appendRatio;
+                    }
+                }
+            }
+            // Get bone's own translation
+            const boneTx = localTranslations[ti];
+            const boneTy = localTranslations[ti + 1];
+            const boneTz = localTranslations[ti + 2];
+            // Build local matrix: bindTranslation + rotation + (bone translation + append translation)
+            const localM = Mat4.identity().translateInPlace(bone.bindTranslation[0], bone.bindTranslation[1], bone.bindTranslation[2]);
+            const transM = Mat4.identity().translateInPlace(boneTx + addLocalTx, boneTy + addLocalTy, boneTz + addLocalTz);
+            const localMatrix = localM.multiply(rotateM).multiply(transM);
+            const worldOffset = i * 16;
+            if (bone.parentIndex >= 0) {
+                const p = bone.parentIndex;
+                if (!computed[p])
+                    computeWorld(p);
+                const parentOffset = p * 16;
+                const parentWorldMat = new Mat4(worldMatrices.subarray(parentOffset, parentOffset + 16));
+                const worldMat = parentWorldMat.multiply(localMatrix);
+                worldMatrices.set(worldMat.values, worldOffset);
+            }
+            else {
+                worldMatrices.set(localMatrix.values, worldOffset);
+            }
+            computed[i] = true;
+        };
+        // Process all bones
+        for (let i = 0; i < boneCount; i++)
+            computeWorld(i);
+    }
+}

package/dist/player.d.ts

@@ -0,0 +1,64 @@
+import { Quat, Vec3 } from "./math";
+export interface AnimationPose {
+    boneRotations: Map<string, Quat>;
+    boneTranslations: Map<string, Vec3>;
+    morphWeights: Map<string, number>;
+}
+export interface AnimationProgress {
+    current: number;
+    duration: number;
+    percentage: number;
+}
+export declare class Player {
+    private frames;
+    private boneTracks;
+    private morphTracks;
+    private _duration;
+    private isPlaying;
+    private isPaused;
+    private _currentTime;
+    private startTime;
+    /**
+     * Load VMD animation file
+     */
+    loadVmd(vmdUrl: string): Promise<void>;
+    /**
+     * Process frames into tracks
+     */
+    private processFrames;
+    /**
+     * Start or resume playback
+     * Note: For iOS, this should be called synchronously from a user interaction event
+     */
+    play(): void;
+    /**
+     * Pause playback
+     */
+    pause(): void;
+    /**
+     * Stop playback and reset to beginning
+     */
+    stop(): void;
+    /**
+     * Seek to specific time
+     */
+    seek(time: number): void;
+    /**
+     * Update playback and return current pose
+     * Returns null if not playing, but returns current pose if paused
+     */
+    update(currentRealTime: number): AnimationPose | null;
+    /**
+     * Get pose at specific time (pure function)
+     */
+    getPoseAtTime(time: number): AnimationPose;
+    /**
+     * Get current playback progress
+     */
+    getProgress(): AnimationProgress;
+    get currentTime(): number;
+    get duration(): number;
+    get isPlayingState(): boolean;
+    get isPausedState(): boolean;
+}
+//# sourceMappingURL=player.d.ts.map

package/dist/player.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"player.d.ts","sourceRoot":"","sources":["../src/player.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAqB,MAAM,QAAQ,CAAA;AAGtD,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAChC,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IACnC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,qBAAa,MAAM;IAEjB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,UAAU,CAAwE;IAC1F,OAAO,CAAC,WAAW,CAA0E;IAC7F,OAAO,CAAC,SAAS,CAAY;IAG7B,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,YAAY,CAAY;IAGhC,OAAO,CAAC,SAAS,CAAY;IAE7B;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5C;;OAEG;IACH,OAAO,CAAC,aAAa;IAsDrB;;;OAGG;IACH,IAAI,IAAI,IAAI;IASZ;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,IAAI,IAAI,IAAI;IAOZ;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IASxB;;;OAGG;IACH,MAAM,CAAC,eAAe,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAwBrD;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;IA6F1C;;OAEG;IACH,WAAW,IAAI,iBAAiB;IAQhC,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,IAAI,aAAa,IAAI,OAAO,CAE3B;CACF"}

package/dist/player.js

@@ -0,0 +1,220 @@
+import { Quat, Vec3, bezierInterpolate } from "./math";
+import { VMDLoader } from "./vmd-loader";
+export class Player {
+    constructor() {
+        // Animation data
+        this.frames = [];
+        this.boneTracks = new Map();
+        this.morphTracks = new Map();
+        this._duration = 0;
+        // Playback state
+        this.isPlaying = false;
+        this.isPaused = false;
+        this._currentTime = 0;
+        // Timing
+        this.startTime = 0; // Real-time when playback started
+    }
+    /**
+     * Load VMD animation file
+     */
+    async loadVmd(vmdUrl) {
+        // Load animation
+        this.frames = await VMDLoader.load(vmdUrl);
+        this.processFrames();
+    }
+    /**
+     * Process frames into tracks
+     */
+    processFrames() {
+        // Helper to group frames by name and sort by time
+        const groupFrames = (items) => {
+            const tracks = new Map();
+            for (const { item, name, time } of items) {
+                if (!tracks.has(name))
+                    tracks.set(name, []);
+                tracks.get(name).push({ item, time });
+            }
+            for (const keyFrames of tracks.values()) {
+                keyFrames.sort((a, b) => a.time - b.time);
+            }
+            return tracks;
+        };
+        // Collect all bone and morph frames
+        const boneItems = [];
+        const morphItems = [];
+        for (const keyFrame of this.frames) {
+            for (const boneFrame of keyFrame.boneFrames) {
+                boneItems.push({ item: boneFrame, name: boneFrame.boneName, time: keyFrame.time });
+            }
+            for (const morphFrame of keyFrame.morphFrames) {
+                morphItems.push({ item: morphFrame, name: morphFrame.morphName, time: keyFrame.time });
+            }
+        }
+        // Transform to expected format
+        this.boneTracks = new Map();
+        for (const [name, frames] of groupFrames(boneItems).entries()) {
+            this.boneTracks.set(name, frames.map((f) => ({ boneFrame: f.item, time: f.time })));
+        }
+        this.morphTracks = new Map();
+        for (const [name, frames] of groupFrames(morphItems).entries()) {
+            this.morphTracks.set(name, frames.map((f) => ({ morphFrame: f.item, time: f.time })));
+        }
+        // Calculate duration from all tracks
+        const allTracks = [...this.boneTracks.values(), ...this.morphTracks.values()];
+        this._duration = allTracks.reduce((max, keyFrames) => {
+            const lastTime = keyFrames[keyFrames.length - 1]?.time ?? 0;
+            return Math.max(max, lastTime);
+        }, 0);
+    }
+    /**
+     * Start or resume playback
+     * Note: For iOS, this should be called synchronously from a user interaction event
+     */
+    play() {
+        if (this.frames.length === 0)
+            return;
+        this.isPaused = false;
+        this.startTime = performance.now() - this._currentTime * 1000;
+        this.isPlaying = true;
+    }
+    /**
+     * Pause playback
+     */
+    pause() {
+        if (!this.isPlaying || this.isPaused)
+            return;
+        this.isPaused = true;
+    }
+    /**
+     * Stop playback and reset to beginning
+     */
+    stop() {
+        this.isPlaying = false;
+        this.isPaused = false;
+        this._currentTime = 0;
+        this.startTime = 0;
+    }
+    /**
+     * Seek to specific time
+     */
+    seek(time) {
+        const clampedTime = Math.max(0, Math.min(time, this._duration));
+        this._currentTime = clampedTime;
+        if (this.isPlaying && !this.isPaused) {
+            this.startTime = performance.now() - clampedTime * 1000;
+        }
+    }
+    /**
+     * Update playback and return current pose
+     * Returns null if not playing, but returns current pose if paused
+     */
+    update(currentRealTime) {
+        if (!this.isPlaying || this.frames.length === 0) {
+            return null;
+        }
+        // If paused, return current pose at paused time (no time update)
+        if (this.isPaused) {
+            return this.getPoseAtTime(this._currentTime);
+        }
+        // Calculate current animation time
+        const elapsedSeconds = (currentRealTime - this.startTime) / 1000;
+        this._currentTime = elapsedSeconds;
+        // Check if animation ended
+        if (this._currentTime >= this._duration) {
+            this._currentTime = this._duration;
+            this.pause(); // Auto-pause at end
+            return this.getPoseAtTime(this._currentTime);
+        }
+        return this.getPoseAtTime(this._currentTime);
+    }
+    /**
+     * Get pose at specific time (pure function)
+     */
+    getPoseAtTime(time) {
+        const pose = {
+            boneRotations: new Map(),
+            boneTranslations: new Map(),
+            morphWeights: new Map(),
+        };
+        // Generic binary search for upper bound
+        const upperBound = (time, keyFrames) => {
+            let left = 0, right = keyFrames.length;
+            while (left < right) {
+                const mid = Math.floor((left + right) / 2);
+                if (keyFrames[mid].time <= time)
+                    left = mid + 1;
+                else
+                    right = mid;
+            }
+            return left;
+        };
+        // Process bone tracks
+        for (const [boneName, keyFrames] of this.boneTracks.entries()) {
+            if (keyFrames.length === 0)
+                continue;
+            const clampedTime = Math.max(keyFrames[0].time, Math.min(keyFrames[keyFrames.length - 1].time, time));
+            const idx = upperBound(clampedTime, keyFrames) - 1;
+            if (idx < 0)
+                continue;
+            const frameA = keyFrames[idx].boneFrame;
+            const frameB = keyFrames[idx + 1]?.boneFrame;
+            if (!frameB) {
+                pose.boneRotations.set(boneName, frameA.rotation);
+                pose.boneTranslations.set(boneName, frameA.translation);
+            }
+            else {
+                const timeA = keyFrames[idx].time;
+                const timeB = keyFrames[idx + 1].time;
+                const gradient = (clampedTime - timeA) / (timeB - timeA);
+                const interp = frameB.interpolation;
+                pose.boneRotations.set(boneName, Quat.slerp(frameA.rotation, frameB.rotation, bezierInterpolate(interp[0] / 127, interp[1] / 127, interp[2] / 127, interp[3] / 127, gradient)));
+                const lerp = (a, b, w) => a + (b - a) * w;
+                const getWeight = (offset) => bezierInterpolate(interp[offset] / 127, interp[offset + 8] / 127, interp[offset + 4] / 127, interp[offset + 12] / 127, gradient);
+                pose.boneTranslations.set(boneName, new Vec3(lerp(frameA.translation.x, frameB.translation.x, getWeight(0)), lerp(frameA.translation.y, frameB.translation.y, getWeight(16)), lerp(frameA.translation.z, frameB.translation.z, getWeight(32))));
+            }
+        }
+        // Process morph tracks
+        for (const [morphName, keyFrames] of this.morphTracks.entries()) {
+            if (keyFrames.length === 0)
+                continue;
+            const clampedTime = Math.max(keyFrames[0].time, Math.min(keyFrames[keyFrames.length - 1].time, time));
+            const idx = upperBound(clampedTime, keyFrames) - 1;
+            if (idx < 0)
+                continue;
+            const frameA = keyFrames[idx].morphFrame;
+            const frameB = keyFrames[idx + 1]?.morphFrame;
+            if (!frameB) {
+                pose.morphWeights.set(morphName, frameA.weight);
+            }
+            else {
+                const timeA = keyFrames[idx].time;
+                const timeB = keyFrames[idx + 1].time;
+                const gradient = (clampedTime - timeA) / (timeB - timeA);
+                pose.morphWeights.set(morphName, frameA.weight + (frameB.weight - frameA.weight) * gradient);
+            }
+        }
+        return pose;
+    }
+    /**
+     * Get current playback progress
+     */
+    getProgress() {
+        return {
+            current: this._currentTime,
+            duration: this._duration,
+            percentage: this._duration > 0 ? (this._currentTime / this._duration) * 100 : 0,
+        };
+    }
+    get currentTime() {
+        return this._currentTime;
+    }
+    get duration() {
+        return this._duration;
+    }
+    get isPlayingState() {
+        return this.isPlaying && !this.isPaused;
+    }
+    get isPausedState() {
+        return this.isPaused;
+    }
+}