nx_skeleton.nx

nx_skeleton.nx -- SKELETON + LINEAR-BLEND SKINNING (the character-foundation rung everything Elara needs hangs off: morphs, IK, jiggle-region binding, posing -- VAMX ladder R3, rides nx_mesh3 + nx_itrig per the reuse law). BONES ARE DATA: a rig is rows {parent, local offset, yaw, pitch} a mod can ship. World pose = parent-composed integer 3x3 rotations (fx256) + offsets (fx256). Skinned vertex = sum of per-bone weighted transforms of the vertex's BONE-LOCAL position (LBS, weights fx256 summing 256). ALL INTEGER => deterministic, VM-vettable, wasm-ready (base-relative). license_tier: ORIGINAL --- 2026-08-23 CAPACITY IS NOW DERIVED FROM THE ASSET, NOT A COMPILE-TIME CEILING --------------- MEASURED DEFECT: this lib carried SK_MAXB=32 bones and SK_MAXV=2048 verts as hard constants while the estate's real rigged corpus is 104-370 joints and 14,164-423,919 vertices -- an 11.6x bone and 207x vertex overflow. The only in-engine skinning evaluator was therefore DIMENSIONALLY INCAPABLE of posing a single real character, which is the mechanical reason the served worlds render the visiting cast in static bind pose: there was nothing callable to pose them with. A cap that is smaller than its subject does not truncate loudly, it makes the whole capability unreachable. FIX (the banked law: a buffer cap is not a number to tune -- REMOVE it): there is no ceiling any more. The caller declares capacity from the ASSET'S OWN header counts via sk_init_cap, the arena size comes from sk_bytes_for, and every offset is computed from the stored capacity at runtime. SK_DEF_* below are NOT caps: they are the legacy constructor's defaults, kept so that every existing caller of sk_init/sk_bytes gets byte-identical behaviour (see the stride note). INFLUENCES ARE ALSO DERIVED: v1 hard-wired 2 bones per vertex; real SKIN sections carry their own per-vertex influence count, so the vertex record is now (2*ninf pairs + 3 position) slots. The stride is (2*ninf+4)*8 bytes -- one spare slot -- which at the legacy ninf=2 is EXACTLY the old 64-byte stride, so the legacy arena layout is reproduced bit-for-bit and prior gates are unaffected.