nx_boneheat_lib.nx

nx_boneheat_lib.nx -- SOVEREIGN AUTO-WEIGHTS: geodesic bone-heat skin weights over the VOXELISED VOLUME of a mesh. WHY (2026-09-05). modding MD4 and dcc DC16 both price auto-rigging, and MD4's pre-declared accept rule says the learned rig must beat a nearest-joint heat-weight CONTROL -- an organ the estate did not have (nx_catalog: nx_boneheat ABSENT; nx_capsearch: no voxel flood-fill and no geodesic-weight ruler anywhere in 7,414 sources). nx_nxa_skin's autoskin is nearest-segment inverse-distance, which bleeds across air: a hand resting on a hip takes hip weight. That is the failure Blender's Automatic Weights (bone heat, Baran and Popovic 2007) avoids and the one Maya's geodesic voxel bind (Dionne and de Lasa 2013) avoids more robustly, because it never needs a manifold mesh -- it needs a volume. This lib is that class, integer and deterministic, first byte up: 1. VOXELISE: rasterise every triangle into a grid sized from knowledge/boneheat.conf, flood the EXTERIOR from the padded border through non-surface cells, and call the rest INTERIOR. The partition is printed and SUMS. A mesh that is not sealed simply has interior=0 and the solve runs over its shell: no refusal, announced. 2. SEED: each joint owns the segment from itself to the mean of its children (a leaf owns a point); the segment's cells are distance 0. A joint whose segment lies outside the volume is PROJECTED to the nearest domain cell and COUNTED, never silently dropped. 3. SOLVE: per joint, Dijkstra over the 26-connected domain with chamfer weights 10/14/17 (Dial buckets, an exact push bound of 26 per settled cell). Air is not domain, so distance cannot cross it -- that is the whole difference from nearest-joint, and the gate proves it on two shells. 4. WEIGH: per vertex keep the four nearest joints at 2^40/(d+half)^2, normalise to the NXA sum of 4096 with the residual folded into the largest influence (the estate's own zero-volume-loss rule). Vertices no joint can reach fall back to the nearest segment and are COUNTED. The NEAREST mode is the control MD4 names: one joint, weight 4096, the nearest segment by Euclidean distance. It shares every reader and the writer, so the two modes cannot disagree about the asset. UNITS: VERT and SKEL are 0.01 mm model units (NXA v1); the grid cell is derived from the bounding box. license_tier: ORIGINAL