nx_pmx.nx

nx_pmx.nx -- PMX (MikuMikuDance 2.x) MODEL READER: header, section census, and the BONE TABLE. WHY: measured 2026-08-07 from vrstormlab.com/dancexr/preparecontent -- PMX is DanceXR's primary model format. It is also where the MMD standard BONE NAMES live, and bone names are what a retarget binds to. nx_bvhfk gives us third-party motion in world space; PMX gives us the named skeleton that motion is authored against. *YOU CANNOT REACH THE BONES WITHOUT WALKING EVERYTHING, WHICH IS WHY THE WALK PROVES ITSELF. PMX vertex records are VARIABLE LENGTH -- the size depends on a per-vertex weight-deform byte (BDEF1/BDEF2/BDEF4/SDEF/QDEF) and on index widths declared in the header globals. Miscount one vertex by one byte and the bone section is garbage. There is no way to "just skip to bones". FAIL-CLOSED: every read is bounds-checked against the ACTUAL file length before it happens. A count in a header is a CLAIM, never an authority -- the same discipline as nx_vmd, and here it matters more because a lying vertex count would drive a variable-stride walk off the buffer. TEXT: PMX globals[0] declares UTF-16LE (0) or UTF-8 (1). Names are emitted as UTF-8 either way; UTF-16LE is transcoded (BMP). We do NOT guess an encoding -- the file states it. usage: nx_pmx info <file.pmx> version, encoding, index widths, per-section counts nx_pmx bones <file.pmx> bone table: index, parent, position, name nx_pmx --kat selftest: 6 teeth, 3 of them anti-vacuity exit 0 ok | 2 unreadable | 3 usage | 4 REFUSED | 1 KAT RED license_tier: ORIGINAL No hw writes (Rule 26). expect_exit: 0