gizlang/motion
motion files as takes that move onto a character (gizlang/retarget), one way for every kind of file: a rigged GLB's animations, a BVH take, and a packed motion (a NumPy archive of SOMA's or SMPL-H's joints, as Kimodo and HY-Motion write them). A take is whole unless its reading asks for its loop.
import * as Motion from "gizlang/motion";Types
Take
type Take = { name: string; frames: Frames; way: Way; }A motion that becomes a clip NAME of a character, moved as WAY says.
name:stringframes:gizlang_retarget.Framesway:gizlang_retarget.Way
Reading
type Reading = { clips: Vec<string>; reference: string; fps: f64; loop: bool; }How to read a motion file: of a GLB, the animations taken (all when none is named) and the one whose mean pose
every take is moved about ("": each its own; rest: the file's rest pose); the frames a second it is sampled at;
and whether each take is cut to its best loop and played in place (a walk) rather than whole.
clips:Vec<string>reference:stringfps:f64loop:bool
Functions
takesOf
function takesOf(name: string, file: bytes, how: Reading): Vec<Take> throws stringThe takes of motion file FILE called NAME (its extension says its kind: .glb, .bvh or .npz), read as HOW says. A BVH or packed file is one take of that name; a GLB's takes are named as its animations.
Effects: fail, read, write, console, io, alloc.
packed
function packed(file: bytes): Frames throws stringThe motion of a packed clip FILE (a NumPy archive) of SOMA's 77 joints (Kimodo's) or SMPL-H's 22 body joints
(HY-Motion's), by how many it has: quats, each frame's joints' world turns away from the skeleton's rest pose
(w, x, y, z); joints0, the joints' places in the first frame; hips, the hips' place a frame; fps. At rest the
skeleton stands in that pose: a joint's offset is its place from its parent's in the first frame, turned back by its
parent's turn there.
Effects: fail, read, write, console, io, alloc.
clipsOf
function clipsOf(takes: Vec<Take>, target: Rest, fps: f64 = 30.0): Vec<Clip> throws stringTAKES moved onto skeleton TARGET (gizlang/retarget), as clips of FPS frames a second.
Effects: fail, read, write, console, io, alloc.
withClips
function withClips(model: bytes, target: Rest, clips: Vec<Clip>): bytes throws stringThe rigged humanoid GLB MODEL with CLIPS added, its humanoid joints named as VRM names them.
Effects: fail, read, write, console, io, alloc.
moved
function moved(model: bytes, takes: Vec<Take>): bytes throws stringThe rigged humanoid GLB MODEL moving as TAKES do.
Effects: fail, read, write, console, io, alloc.