nx_xps_lib.nx

nx_xps_lib.nx -- XPS / XNALara MODEL READER, both dialects (/compare/modding MD2, 2026-09-06). The reference readers were mirrored and READ before a line of this was written (knowledge/fetched/cmp_modding_xnalara_read_ascii_xps.py pin ac92fd7f, read_bin_xps.py pin 0e1dca05, bin_ops.py, xps_const.py). What they say, and this lib follows: ascii (.mesh.ascii): bone count; per bone a name line, a parent line, an xyz line; mesh count; per mesh a name line, a uv-layer count, a texture count with a name line and a uv-layer line per texture, a vertex count with position, normal, RGBA colour (four integers), one uv line per layer and -- when the model has bones -- a four-index line and a four-weight line (short lines are zero-filled), then a triangle count and three indices per face. Numeric lines may carry a trailing comment after a hash. binary (.xps): u32 magic 323232, u16 major, u16 minor, a length-prefixed string (one byte; a second byte when the first is at least 128, length = b1 % 128 + b2 * 128), u32 settings length in 32-bit words, three more strings (machine, user, files), then the settings block of exactly that many words (old format raw, new format typed items -- skipped whole, it carries render flags, never geometry); bones: u32 count, string, i16 parent, three float32; meshes: u32 count, string, u32 uv layers, u32 textures (string + u32 layer each), u32 vertices (three float32 position, three float32 normal, four colour bytes, per layer two float32 uv plus four float32 tangent when TANGENT versions apply), bone weights as i16 count on VARIABLE-WEIGHT versions else four, i16 indices then float32 weights; u32 triangles of three u32. TANGENT versions: minor <= 12 and major <= 2. VARIABLE weights: major >= 3. (bin_ops.py, read verbatim.) OUTPUT is the estate's own arrays for nx_nxa_write_lib: VERT in 0.01 mm model units at a DECLARED scale (units_per_xps, data never a guess), every mesh merged into one vertex table with per-mesh index offsets, SKEL from the bone table with the identity bind rotation the estate's rig convention declares, SKIN as four q12 weights per vertex summing to exactly 4096 (a float sum that rounds away from 4096 has the residual moved to its largest lane and the vertex COUNTED as fixed). Normals, colours, uvs and tangents are READ and COUNTED but not carried (TEXC is the texture rung, nx_nxa_texc). Every refusal is named; a truncated binary is refused at the byte it ran out on, never read as a smaller model. license_tier: ORIGINAL No hw writes (Rule 26).