@yali-engine/animation 0.0.0-stage → 0.4.0

package/dist/animation.d.ts

@@ -0,0 +1,100 @@
+import { type Entity, type World } from '@yali-engine/core';
+import type { BuiltGraph } from './graph.ts';
+import { Morphs } from './morph.ts';
+/** One animated property of one joint (`Animation.addClip`). */
+export interface ClipTrack {
+    readonly joint: number;
+    readonly path: 'translation' | 'rotation' | 'scale';
+    /** LINEAR (rotations by normalized lerp) or STEP. */
+    readonly interpolation: 'LINEAR' | 'STEP';
+    /** Key times in seconds, increasing. */
+    readonly times: Float32Array;
+    /** 3 floats per key, or 4 (x, y, z, w) for a rotation. */
+    readonly values: Float32Array;
+}
+/** A joint's rest transform: translation, rotation (x, y, z, w), scale (per axis). */
+export interface JointRest {
+    readonly t: readonly number[];
+    readonly r: readonly number[];
+    readonly s: readonly number[];
+}
+/** This frame's palette (the renderer's `PaletteView`): views into the core's memory. */
+export interface PaletteFrame {
+    readonly f32: Float32Array<ArrayBufferLike>;
+    /** First float. */
+    readonly at: number;
+    /** Rows (joints), 12 floats each. */
+    readonly rows: number;
+}
+/** What `Animation.stats` reports. */
+export interface AnimationStats {
+    readonly skeletons: number;
+    readonly clips: number;
+    readonly skins: number;
+    readonly graphs: number;
+    /** Palette rows (joints) skinned last frame. */
+    readonly paletteRows: number;
+}
+/**
+ * An app's animation assets (the `animation` resource, ADR-0083): skeletons, clips and skins
+ * live in the core (its `anim` variant); this adds them and reads the frame's palette. Which
+ * entity plays what is ECS data (`anim.Animator`, `anim.Skin`, `anim.Socket`).
+ *
+ * @example
+ * const anim = app.resource<Animation>('animation');
+ * const skeleton = anim.addSkeleton([-1, 0], [{ t: [0, 0, 0], r: [0, 0, 0, 1], s: [1, 1, 1] }, { t: [0, 1, 0], r: [0, 0, 0, 1], s: [1, 1, 1] }]);
+ * const clip = anim.addClip(skeleton, [{ joint: 1, path: 'rotation', interpolation: 'LINEAR', times, values }]);
+ */
+export declare class Animation {
+    #private;
+    readonly world: World;
+    /** Morph targets bound to animators (blended on the CPU when their weights change). */
+    readonly morphs: Morphs;
+    constructor(world: World);
+    /**
+     * Adds a skeleton: `parents[i]` is -1 for a root, else an earlier joint (parents first);
+     * `rest` is each joint's local rest transform. Returns its id (for `anim.Animator.skeleton`).
+     */
+    addSkeleton(parents: readonly number[], rest: readonly JointRest[]): number;
+    /** Adds a clip over `skeleton`'s joints. Returns its id (for `anim.Animator.clip`). */
+    addClip(skeleton: number, tracks: readonly ClipTrack[]): number;
+    /**
+     * Adds a skin over `skeleton`: the joint each slot follows and each slot's inverse bind
+     * matrix (16 floats, column-major). Returns its id (for `anim.Skin.skin`) and how far its rest
+     * palette is from the identity (`restError`: about 0 for a consistent file).
+     */
+    addSkin(skeleton: number, joints: readonly number[], inverseBind: Float32Array): {
+        id: number;
+        restError: number;
+    };
+    /**
+     * Adds a graph (ADR-0089) built with `graph()` for `skeleton`; returns its id (for
+     * `anim.Graph.graph`). Every clip it plays must animate that skeleton.
+     */
+    addGraph(skeleton: number, g: BuiltGraph): number;
+    /** Adds a per-joint weight mask (0–1 per skeleton joint) for masked blends; returns its id. */
+    addMask(skeleton: number, weights: Float32Array): number;
+    /**
+     * Joint `joint`'s model matrix of animator `entity` (16 floats, column-major, in the animator's
+     * root frame) as of the last update, or null before its first.
+     */
+    jointModel(entity: Entity, joint: number): Float32Array | null;
+    /** A clip's length in seconds (negative for an unknown id). */
+    clipDuration(clip: number): number;
+    /** One frame (the plugin's Update system calls it): animators advance by `dt`, palettes and sockets follow. */
+    update(dt: number): void;
+    /** This frame's palette, as views into the core's memory (valid until the next `update`). Allocation-free. */
+    palette(): PaletteFrame;
+    /**
+     * Sets parameter `name` of `entity`'s graph (its `anim.Graph`, built as `g`): a trigger fires
+     * with 1, and the graph clears it when a transition takes it.
+     */
+    setParam(entity: Entity, g: BuiltGraph, name: string, value: number): void;
+    /** `entity`'s graph state: its root state machine's state name ('' without one) and seconds in it. */
+    state(entity: Entity, g: BuiltGraph): {
+        state: string;
+        time: number;
+    };
+    /** Asset counts and the last frame's palette size. */
+    stats(): AnimationStats;
+}

package/dist/animation.js

@@ -0,0 +1,183 @@
+import { requireFeature, YaliError } from '@yali-engine/core';
+import { registerAnimation } from "./components.js";
+import { Morphs } from "./morph.js";
+const PATHS = { translation: 0, rotation: 1, scale: 2 };
+/**
+ * An app's animation assets (the `animation` resource, ADR-0083): skeletons, clips and skins
+ * live in the core (its `anim` variant); this adds them and reads the frame's palette. Which
+ * entity plays what is ECS data (`anim.Animator`, `anim.Skin`, `anim.Socket`).
+ *
+ * @example
+ * const anim = app.resource<Animation>('animation');
+ * const skeleton = anim.addSkeleton([-1, 0], [{ t: [0, 0, 0], r: [0, 0, 0, 1], s: [1, 1, 1] }, { t: [0, 1, 0], r: [0, 0, 0, 1], s: [1, 1, 1] }]);
+ * const clip = anim.addClip(skeleton, [{ joint: 1, path: 'rotation', interpolation: 'LINEAR', times, values }]);
+ */
+export class Animation {
+    world;
+    /** Morph targets bound to animators (blended on the CPU when their weights change). */
+    morphs;
+    #x;
+    #skeletons = [];
+    #clips = 0;
+    #skins = 0;
+    #graphs = 0;
+    #frame = { f32: new Float32Array(0), at: 0, rows: 0 };
+    constructor(world) {
+        requireFeature(world.core, 'anim');
+        this.world = world;
+        this.#x = world.core.exports;
+        this.morphs = new Morphs(world);
+    }
+    /**
+     * Adds a skeleton: `parents[i]` is -1 for a root, else an earlier joint (parents first);
+     * `rest` is each joint's local rest transform. Returns its id (for `anim.Animator.skeleton`).
+     */
+    addSkeleton(parents, rest) {
+        const n = parents.length;
+        if (rest.length !== n)
+            throw new YaliError('ANIM_INVALID', `${n} parents but ${rest.length} rest transforms.`, 'Give one rest transform per joint.');
+        const ptr = this.world.scratch(n * 4 + n * 40);
+        const heap = this.world.core.heap;
+        heap.i32.set(parents, ptr >>> 2);
+        const f = heap.f32;
+        const at = (ptr + n * 4) >>> 2;
+        for (let j = 0; j < n; j++) {
+            const r = rest[j];
+            f.set([r.t[0], r.t[1], r.t[2], r.r[0], r.r[1], r.r[2], r.r[3], r.s[0], r.s[1], r.s[2]], at + j * 10);
+        }
+        const id = this.world.check(this.#x.yali_anim_add_skeleton(this.world.handle, ptr, n, ptr + n * 4));
+        this.#skeletons[id] = n;
+        return id;
+    }
+    /** Adds a clip over `skeleton`'s joints. Returns its id (for `anim.Animator.clip`). */
+    addClip(skeleton, tracks) {
+        let words = 1;
+        for (const t of tracks) {
+            const width = t.path === 'rotation' ? 4 : 3;
+            if (t.values.length !== t.times.length * width) {
+                throw new YaliError('ANIM_INVALID', `A ${t.path} track of ${t.times.length} keys has ${t.values.length} values.`, `Give ${width} values per key.`);
+            }
+            words += 4 + t.times.length * (1 + width);
+        }
+        const ptr = this.world.scratch(words * 4);
+        const heap = this.world.core.heap;
+        const u = heap.u32;
+        const f = heap.f32;
+        let o = ptr >>> 2;
+        u[o++] = tracks.length;
+        for (const t of tracks) {
+            u[o++] = t.joint;
+            u[o++] = PATHS[t.path];
+            u[o++] = t.interpolation === 'STEP' ? 1 : 0;
+            u[o++] = t.times.length;
+            f.set(t.times, o);
+            o += t.times.length;
+            f.set(t.values, o);
+            o += t.values.length;
+        }
+        const id = this.world.check(this.#x.yali_anim_add_clip(this.world.handle, skeleton, ptr, words));
+        this.#clips++;
+        return id;
+    }
+    /**
+     * Adds a skin over `skeleton`: the joint each slot follows and each slot's inverse bind
+     * matrix (16 floats, column-major). Returns its id (for `anim.Skin.skin`) and how far its rest
+     * palette is from the identity (`restError`: about 0 for a consistent file).
+     */
+    addSkin(skeleton, joints, inverseBind) {
+        const n = joints.length;
+        if (inverseBind.length !== n * 16)
+            throw new YaliError('ANIM_INVALID', `${n} joints but ${inverseBind.length / 16} inverse bind matrices.`, 'Give 16 floats per joint.');
+        const ptr = this.world.scratch(n * 4 + n * 64 + 4);
+        const heap = this.world.core.heap;
+        heap.u32.set(joints, ptr >>> 2);
+        heap.f32.set(inverseBind, (ptr + n * 4) >>> 2);
+        const errAt = ptr + n * 68;
+        const id = this.world.check(this.#x.yali_anim_add_skin(this.world.handle, skeleton, n, ptr, ptr + n * 4, errAt));
+        this.#skins++;
+        return { id, restError: this.world.core.heap.f32[errAt >>> 2] };
+    }
+    /**
+     * Adds a graph (ADR-0089) built with `graph()` for `skeleton`; returns its id (for
+     * `anim.Graph.graph`). Every clip it plays must animate that skeleton.
+     */
+    addGraph(skeleton, g) {
+        const ptr = this.world.scratch(g.words.byteLength);
+        this.world.core.heap.u32.set(g.words, ptr >>> 2);
+        const id = this.world.check(this.#x.yali_anim_add_graph(this.world.handle, skeleton, ptr, g.words.length));
+        this.#graphs++;
+        return id;
+    }
+    /** Adds a per-joint weight mask (0–1 per skeleton joint) for masked blends; returns its id. */
+    addMask(skeleton, weights) {
+        const ptr = this.world.scratch(weights.byteLength);
+        this.world.core.heap.f32.set(weights, ptr >>> 2);
+        return this.world.check(this.#x.yali_anim_add_mask(this.world.handle, skeleton, ptr, weights.length));
+    }
+    /**
+     * Joint `joint`'s model matrix of animator `entity` (16 floats, column-major, in the animator's
+     * root frame) as of the last update, or null before its first.
+     */
+    jointModel(entity, joint) {
+        const ptr = this.world.scratch(64);
+        const found = this.world.check(this.#x.yali_anim_joint_model(this.world.handle, entity, joint, ptr));
+        return found ? this.world.core.heap.f32.slice(ptr >>> 2, (ptr >>> 2) + 16) : null;
+    }
+    /** A clip's length in seconds (negative for an unknown id). */
+    clipDuration(clip) {
+        return this.#x.yali_anim_clip_duration(this.world.handle, clip);
+    }
+    /** One frame (the plugin's Update system calls it): animators advance by `dt`, palettes and sockets follow. */
+    update(dt) {
+        this.world.check(this.#x.yali_anim_update(this.world.handle, dt));
+    }
+    /** This frame's palette, as views into the core's memory (valid until the next `update`). Allocation-free. */
+    palette() {
+        const ptr = this.world.scratch(8);
+        this.world.check(this.#x.yali_anim_palette(this.world.handle, ptr));
+        const heap = this.world.core.heap;
+        const p = this.#frame;
+        p.f32 = heap.f32;
+        p.at = heap.u32[ptr >>> 2] >>> 2;
+        p.rows = heap.u32[(ptr >>> 2) + 1];
+        return p;
+    }
+    #graphQuery = null;
+    /**
+     * Sets parameter `name` of `entity`'s graph (its `anim.Graph`, built as `g`): a trigger fires
+     * with 1, and the graph clears it when a transition takes it.
+     */
+    setParam(entity, g, name, value) {
+        const i = g.params.indexOf(name);
+        if (i < 0)
+            throw Object.assign(new YaliError('ANIM_GRAPH', `No parameter named ${JSON.stringify(name)}.`, `Parameters: ${g.params.join(', ')}.`), { path: 'name' });
+        this.#graphRow(entity, (params) => (params[i] = value));
+    }
+    /** `entity`'s graph state: its root state machine's state name ('' without one) and seconds in it. */
+    state(entity, g) {
+        let out = { state: '', time: 0 };
+        this.#graphRow(entity, (_, state, time) => (out = { state: state > 0 ? (g.states[state - 1] ?? '') : '', time }));
+        return out;
+    }
+    #graphRow(entity, fn) {
+        const { Graph } = registerAnimation(this.world);
+        this.#graphQuery ??= this.world.query({ with: [Graph], columns: [[Graph, 'params', 'write'], [Graph, 'state'], [Graph, 'stateTime']] });
+        const q = this.#graphQuery;
+        const chunks = q.run();
+        for (let c = 0; c < chunks; c++) {
+            const k = q.chunk(c);
+            for (let r = 0; r < k.length; r++) {
+                if (k.entity(r) !== entity)
+                    continue;
+                fn(k.f32(0).subarray(r * 16, r * 16 + 16), k.u32(1)[r], k.f32(2)[r]);
+                return;
+            }
+        }
+        throw Object.assign(new YaliError('MISSING_COMPONENT', `Entity ${entity} has no anim.Graph.`, 'Insert anim.Graph { graph, params } beside its anim.Animator.'), { path: 'entity' });
+    }
+    /** Asset counts and the last frame's palette size. */
+    stats() {
+        return { skeletons: this.#skeletons.filter((n) => n !== undefined).length, clips: this.#clips, skins: this.#skins, graphs: this.#graphs, paletteRows: this.#frame.rows };
+    }
+}
+//# sourceMappingURL=animation.js.map

package/dist/animation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation.js","sourceRoot":"","sources":["../src/animation.ts"],"names":[],"mappings":"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"}

package/dist/components.d.ts

@@ -0,0 +1,33 @@
+import type { Component, World } from '@yali-engine/core';
+/** `anim.Animator.flags`: the clip loops (else it holds its last frame). */
+export declare const ANIM_LOOP = 1;
+/** `anim.Animator.flags`: time does not advance. */
+export declare const ANIM_PAUSED = 2;
+/** The animation components, declared as the core declares them (one schema: the same ids). */
+export interface AnimationComponents {
+    /** Plays a clip on a skeleton: `skeleton`, `clip` (ids from `Animation`), `time`, `speed`, `flags`. */
+    readonly Animator: Component;
+    /** On a skinned mesh's entity: `skin` (an `Animation.addSkin` id), `animator` (its entity), `palette` (out). */
+    readonly Skin: Component;
+    /** Its `Transform` follows a joint of `animator` (its parent's animator), in that entity's space. */
+    readonly Socket: Component;
+    /**
+     * Beside `anim.Animator`: a graph drives the pose instead of the animator's clip (ADR-0089).
+     * `graph` (an `Animation.addGraph` id), `params` (16 slots, named by the graph), `state` (out:
+     * the root state machine's state + 1), `stateTime` (out: seconds in it).
+     */
+    readonly Graph: Component;
+    /**
+     * On a root-level entity tied to joint `joint` of `animator` at `offsetT` / `offsetR` in the
+     * joint's frame (model units): `mode` 0 puts its Transform at the joint (a kinematic ragdoll
+     * body follows the animation), 1 puts the joint at its Transform (a simulated body drives the
+     * pose; the joints below follow). ADR-0091.
+     */
+    readonly Bone: Component;
+}
+/** `anim.Bone.mode`: the entity follows its joint. */
+export declare const BONE_FOLLOW = 0;
+/** `anim.Bone.mode`: the joint follows the entity. */
+export declare const BONE_DRIVE = 1;
+/** Registers `anim.Animator`, `anim.Skin` and `anim.Socket` on `world` (idempotent). */
+export declare function registerAnimation(world: World): AnimationComponents;

package/dist/components.js

@@ -0,0 +1,19 @@
+/** `anim.Animator.flags`: the clip loops (else it holds its last frame). */
+export const ANIM_LOOP = 1;
+/** `anim.Animator.flags`: time does not advance. */
+export const ANIM_PAUSED = 2;
+/** `anim.Bone.mode`: the entity follows its joint. */
+export const BONE_FOLLOW = 0;
+/** `anim.Bone.mode`: the joint follows the entity. */
+export const BONE_DRIVE = 1;
+/** Registers `anim.Animator`, `anim.Skin` and `anim.Socket` on `world` (idempotent). */
+export function registerAnimation(world) {
+    return {
+        Animator: world.registerComponent({ name: 'anim.Animator', fields: { skeleton: 'u32', clip: 'u32', time: 'f32', speed: 'f32', flags: 'u8' } }),
+        Skin: world.registerComponent({ name: 'anim.Skin', fields: { skin: 'u32', animator: 'entity', palette: 'u32' } }),
+        Socket: world.registerComponent({ name: 'anim.Socket', fields: { animator: 'entity', joint: 'u32' } }),
+        Graph: world.registerComponent({ name: 'anim.Graph', fields: { graph: 'u32', params: { scalar: 'f32', lanes: 16 }, state: 'u32', stateTime: 'f32' } }),
+        Bone: world.registerComponent({ name: 'anim.Bone', fields: { animator: 'entity', joint: 'u32', mode: 'u8', offsetT: 'vec3<f32>', offsetR: 'quat' } }),
+    };
+}
+//# sourceMappingURL=components.js.map

package/dist/components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.js","sourceRoot":"","sources":["../src/components.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC;AAC3B,oDAAoD;AACpD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAyB7B,sDAAsD;AACtD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAC7B,sDAAsD;AACtD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC;AAE5B,wFAAwF;AACxF,MAAM,UAAU,iBAAiB,CAAC,KAAY;IAC5C,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC;QAC9I,IAAI,EAAE,KAAK,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC;QACjH,MAAM,EAAE,KAAK,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC;QACtG,KAAK,EAAE,KAAK,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC;QACtJ,IAAI,EAAE,KAAK,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;KACtJ,CAAC;AACJ,CAAC"}

package/dist/gltf.d.ts

@@ -0,0 +1,68 @@
+import { type Component, type Entity, type World } from '@yali-engine/core';
+import type { GltfAsset } from '@yali-engine/gltf';
+import type { Animation } from './animation.ts';
+/** A glTF's animation assets in the core (`addGltfAnimation`). */
+export interface GltfAnimationAssets {
+    /** The skeleton: every node of the default scene, depth first (`joints[node]` is its joint). */
+    readonly skeleton: number;
+    /** `joints[node]` = that node's joint, or -1 when it is not in the default scene. */
+    readonly joints: readonly number[];
+    /** One clip per glTF animation, in file order: its name, id and length (seconds). */
+    readonly clips: readonly {
+        readonly name: string;
+        readonly id: number;
+        readonly duration: number;
+    }[];
+    /** One skin id per glTF skin (0 when it could not be made). */
+    readonly skins: readonly number[];
+    /** Per skin, how far its rest palette is from the identity (about 0 for a consistent file). */
+    readonly restErrors: readonly number[];
+    /** Each joint's parent joint (-1 for a root). */
+    readonly parents: readonly number[];
+    /** Per skin, the joint of each of its slots. */
+    readonly skinJoints: readonly (readonly number[])[];
+}
+/**
+ * Adds a loaded glTF's skeleton, clips and skins to `animation` (ADR-0088). The skeleton is the
+ * whole node tree of the default scene, so a clip may move any node: a skinned mesh's joints, or
+ * a rigid mesh's node (which `spawnAnimatedGltf` makes a socket). Morph-weight channels are
+ * played by `Animation.morphs`, which `spawnAnimatedGltf` binds.
+ */
+export declare function addGltfAnimation(animation: Animation, asset: GltfAsset, warnings?: string[]): GltfAnimationAssets;
+/** `spawnAnimatedGltf`'s options. */
+export interface SpawnAnimatedOptions {
+    readonly at?: {
+        t?: readonly number[];
+        r?: readonly number[];
+        s?: number;
+    };
+    /** The clip to play: an index into the file's animations or its name (default the first; -1 none). */
+    readonly clip?: number | string;
+    /** Default 1. */
+    readonly speed?: number;
+    /** Default true. */
+    readonly loop?: boolean;
+    readonly warnings?: string[];
+}
+/** What `spawnAnimatedGltf` made. */
+export interface AnimatedGltf {
+    /** The root entity: it carries `anim.Animator`; every mesh entity is its child. */
+    readonly root: Entity;
+    readonly assets: GltfAnimationAssets;
+    /** The skinned meshes' entities (`anim.Skin`). */
+    readonly skinned: readonly Entity[];
+    /** The rigid meshes' entities (`anim.Socket` on their node's joint). */
+    readonly sockets: readonly Entity[];
+}
+/**
+ * Spawns a loaded glTF as one animated model (ADR-0088): a root entity at `at` with an
+ * `anim.Animator` playing `clip` over the whole node tree; each skinned primitive as a child at
+ * the root's origin with `anim.Skin` (the glTF rule: a skinned mesh's own node transform is
+ * ignored); each rigid primitive as a child with `anim.Socket` on its node's joint, so animated
+ * nodes move their meshes. Pass `assets` to share one set of skeleton, clips and skins between
+ * instances of the same file.
+ *
+ * Mesh entities carry `Transform` and `GlobalTransform` but no `PreviousTransform`: animation runs
+ * at the render rate, so they are not interpolated between fixed steps.
+ */
+export declare function spawnAnimatedGltf(world: World, animation: Animation, asset: GltfAsset, Mesh: Component, options?: SpawnAnimatedOptions, assets?: GltfAnimationAssets): AnimatedGltf;

package/dist/gltf.js

@@ -0,0 +1,134 @@
+import { registerTransforms } from '@yali-engine/core';
+import { ANIM_LOOP, registerAnimation } from "./components.js";
+/**
+ * Adds a loaded glTF's skeleton, clips and skins to `animation` (ADR-0088). The skeleton is the
+ * whole node tree of the default scene, so a clip may move any node: a skinned mesh's joints, or
+ * a rigid mesh's node (which `spawnAnimatedGltf` makes a socket). Morph-weight channels are
+ * played by `Animation.morphs`, which `spawnAnimatedGltf` binds.
+ */
+export function addGltfAnimation(animation, asset, warnings) {
+    const s = asset.scene;
+    const joints = new Array(s.nodes.length).fill(-1);
+    const parents = [];
+    const rest = [];
+    const visit = (node, parent) => {
+        if (joints[node] >= 0)
+            return; // a node reached twice (an invalid file): first wins
+        const j = parents.length;
+        joints[node] = j;
+        parents.push(parent);
+        const n = s.nodes[node];
+        rest.push({ t: [...n.t], r: [...n.r], s: [...n.s] });
+        for (const c of n.children)
+            visit(c, j);
+    };
+    for (const r of s.roots)
+        visit(r, -1);
+    const skeleton = animation.addSkeleton(parents, rest);
+    const clips = s.animations.map((a) => {
+        const tracks = [];
+        for (const c of a.channels) {
+            if (c.path === 'weights')
+                continue; // morph weights: `Morphs`, bound by spawnAnimatedGltf
+            const joint = joints[c.node] ?? -1;
+            if (joint < 0)
+                continue;
+            tracks.push({ joint, path: c.path, interpolation: c.interpolation, times: c.times, values: c.values });
+        }
+        const id = animation.addClip(skeleton, tracks);
+        return { name: a.name, id, duration: animation.clipDuration(id) };
+    });
+    const restErrors = [];
+    const skinJoints = [];
+    const skins = s.skins.map((k) => {
+        const slots = k.joints.map((n) => joints[n] ?? -1);
+        skinJoints.push(slots.filter((j) => j >= 0));
+        if (slots.some((j) => j < 0)) {
+            warnings?.push(`skin ${k.name}: a joint is not in the default scene; its meshes draw at their bind pose`);
+            restErrors.push(Number.NaN);
+            return 0;
+        }
+        const r = animation.addSkin(skeleton, slots, k.inverseBindMatrices);
+        restErrors.push(r.restError);
+        return r.id;
+    });
+    return { skeleton, joints, clips, skins, restErrors, parents, skinJoints };
+}
+/**
+ * Spawns a loaded glTF as one animated model (ADR-0088): a root entity at `at` with an
+ * `anim.Animator` playing `clip` over the whole node tree; each skinned primitive as a child at
+ * the root's origin with `anim.Skin` (the glTF rule: a skinned mesh's own node transform is
+ * ignored); each rigid primitive as a child with `anim.Socket` on its node's joint, so animated
+ * nodes move their meshes. Pass `assets` to share one set of skeleton, clips and skins between
+ * instances of the same file.
+ *
+ * Mesh entities carry `Transform` and `GlobalTransform` but no `PreviousTransform`: animation runs
+ * at the render rate, so they are not interpolated between fixed steps.
+ */
+export function spawnAnimatedGltf(world, animation, asset, Mesh, options = {}, assets) {
+    const { Transform, GlobalTransform, bundle } = registerTransforms(world);
+    const { Animator, Skin, Socket } = registerAnimation(world);
+    const a = assets ?? addGltfAnimation(animation, asset, options.warnings);
+    const s = asset.scene;
+    const pick = options.clip ?? 0;
+    const index = typeof pick === 'string' ? a.clips.findIndex((c) => c.name === pick) : pick;
+    if (typeof pick === 'string' && index < 0)
+        options.warnings?.push(`no animation named ${pick}; none plays`);
+    const clip = index >= 0 && index < a.clips.length ? a.clips[index].id : 0;
+    const root = world.spawn([...bundle, Animator]);
+    world.insert(root, Transform, { t: options.at?.t ?? [0, 0, 0], r: options.at?.r ?? [0, 0, 0, 1], s: options.at?.s ?? 1 });
+    world.insert(root, Animator, { skeleton: a.skeleton, clip, time: 0, speed: options.speed ?? 1, flags: options.loop === false ? 0 : ANIM_LOOP });
+    const skinned = [];
+    const sockets = [];
+    const IDENTITY = { t: [0, 0, 0], r: [0, 0, 0, 1], s: 1 };
+    for (let node = 0; node < s.nodes.length; node++) {
+        const n = s.nodes[node];
+        const joint = a.joints[node];
+        if (n.mesh < 0 || joint < 0)
+            continue;
+        const ids = asset.meshes[n.mesh];
+        for (let p = 0; p < ids.length; p++) {
+            const m = asset.materialOf[n.mesh][p];
+            const material = m >= 0 && asset.materialIds.length > 0 ? asset.materialIds[m] : 0;
+            const color = material > 0 ? WHITE : m >= 0 ? rgba8(s.materials[m].baseColor) : DEFAULT_COLOR;
+            const skin = n.skin >= 0 && asset.skinned[n.mesh][p] ? a.skins[n.skin] : 0;
+            // Morph targets: one weight state per mesh, driven by the first instance spawned.
+            const morph = asset.morphs[n.mesh]?.[p];
+            if (morph && !animation.morphs.has(ids[p])) {
+                const tracks = new Map();
+                s.animations.forEach((an, ai) => {
+                    const ch = an.channels.find((c) => c.node === node && c.path === 'weights');
+                    if (ch && a.clips[ai])
+                        tracks.set(a.clips[ai].id, { times: ch.times, values: ch.values, interpolation: ch.interpolation });
+                });
+                animation.morphs.add({ animator: root, mesh: ids[p], base: morph.base, targets: morph.targets, defaults: s.meshes[n.mesh].weights, tracks });
+            }
+            if (skin > 0) {
+                const e = world.spawn([Transform, GlobalTransform, Mesh, Skin]);
+                world.insert(e, Transform, IDENTITY);
+                world.setParent(e, root);
+                world.insert(e, Mesh, { mesh: ids[p], material, color });
+                world.insert(e, Skin, { skin, animator: root, palette: 0 });
+                skinned.push(e);
+            }
+            else {
+                // Placed by its socket from the first animation update on.
+                const e = world.spawn([Transform, GlobalTransform, Mesh, Socket]);
+                world.insert(e, Transform, IDENTITY);
+                world.setParent(e, root);
+                world.insert(e, Mesh, { mesh: ids[p], material, color });
+                world.insert(e, Socket, { animator: root, joint });
+                sockets.push(e);
+            }
+        }
+    }
+    return { root, assets: a, skinned, sockets };
+}
+/** RGBA8 of a linear colour (as `@yali-engine/render`'s `rgba8`, which this package does not import). */
+function rgba8(c) {
+    const b = (x) => Math.round(Math.min(1, Math.max(0, x)) * 255);
+    return (b(c[0]) | (b(c[1]) << 8) | (b(c[2]) << 16) | (b(c[3] ?? 1) << 24)) >>> 0;
+}
+const DEFAULT_COLOR = rgba8([0.8, 0.8, 0.8, 1]);
+const WHITE = rgba8([1, 1, 1, 1]);
+//# sourceMappingURL=gltf.js.map

package/dist/gltf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gltf.js","sourceRoot":"","sources":["../src/gltf.ts"],"names":[],"mappings":"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"}