code wiki / nxa
topic: nxa
110 modules sharing the nxa name family (derived from the tree's prefix discipline).
The 'nxa' topic family in the Nishi sovereign ecosystem is dedicated to processing and validating animated character data, ensuring fidelity across the pipeline. Modules like nx_nxa_anim extract and bake FBX animations, nx_nxa_check validates the NXA format beyond basic checksums, and nx_nxa_garment generates fitted garments, supporting advanced physics and realism. These modules work together to maintain structural integrity and performance in the ecosystem's modular architecture.
auto-narrated by the local model from this topic's module headers; links verified against the wiki index.
narrated overview -- maintained by the narration lane, module links verified against this wiki.
| module | description | lines | funcs |
|---|---|---|---|
| nx_nxa.nx | Provides shared identity and integrity primitives for the NXA (Nishi Animated 3D) format version 1. | 91 | 6 |
| nx_nxa_affine_asset_t35.nx | Private AFM1 additive animation section; existing NXA container/skin ownership. | 54 | 3 |
| nx_nxa_affine_bake_gate_t35.nx | Real Knight AFM1 bake + decoded consumer qualification, private artifact. | 59 | 1 |
| nx_nxa_affine_decode_gate_t36.nx | 17 | 1 | |
| nx_nxa_affine_palette_gate_t34.nx | 40 | 1 | |
| nx_nxa_affine_palette_t34.nx | Private existing-animation consumer contract: W(t)*inverse(authored BindPose). | 36 | 4 |
| nx_nxa_affine_transport_gate_t35.nx | Private transport fixture using the existing base64 and immutable output owners. | 12 | 1 |
| nx_nxa_anim.nx | ANIMATION IMPORTER v2: extracts the FBX's authored animation and BAKES it | 1519 | 15 |
| nx_nxa_anim_bounds_gate.nx | GATE for the one NXA clip evaluator (nx_nxa_anim_lib), driven IN-PROCESS on PLANTED | 129 | 3 |
| nx_nxa_anim_gait_candidate_t139.nx | THE ONE NXA CLIP EVALUATOR: channel-2 packed world-delta keys, sampled at a | 427 | 20 |
| nx_nxa_anim_gate.nx | GATE for the one NXA clip evaluator (nx_nxa_anim_lib), driven IN-PROCESS on PLANTED | 126 | 3 |
| nx_nxa_anim_legacy_gate_t33.nx | GATE for the one NXA clip evaluator (nx_nxa_anim_lib), driven IN-PROCESS on PLANTED | 126 | 3 |
| nx_nxa_anim_lib.nx | THE ONE NXA CLIP EVALUATOR: channel-2 packed world-delta keys, sampled at a | 427 | 20 |
| nx_nxa_anim_lookup_gate.nx | GATE for the one NXA clip evaluator (nx_nxa_anim_lib), driven IN-PROCESS on PLANTED | 234 | 5 |
| nx_nxa_anim_selection_gate_t30.nx | Original Knight stack-selection gate. No NXA artifact or live page writes. | 37 | 1 |
| nx_nxa_anim_selection_gate_t33.nx | Original Knight stack-selection gate. No NXA artifact or live page writes. | 37 | 1 |
| nx_nxa_anim_t30.nx | ANIMATION IMPORTER v2: extracts the FBX's authored animation and BAKES it | 1519 | 15 |
| nx_nxa_bind.nx | Rebind an existing NXA geometry stream from its matching binary FBX BindPose. | 389 | 15 |
| nx_nxa_bind_gate_t29.nx | Isolated real-asset bind qualification. Fixed source and output fixture; no serving writes. | 69 | 4 |
| nx_nxa_bind_second_gate_t29.nx | Second retained corpus asset; output stays in memory. No publication. | 27 | 1 |
| nx_nxa_bind_t29.nx | Rebind an existing NXA geometry stream from its matching binary FBX BindPose. | 389 | 15 |
| nx_nxa_bounds_gate.nx | NXA v1 section boundaries: malformed inputs must fail before payload access. | 118 | 3 |
| nx_nxa_check.nx | the NXA format's fsck. Validates an .nxa BEYOND the checksums nxa_find | 255 | 4 |
| nx_nxa_corner_checkpoint_candidate_t280.nx | 39 | 1 | |
| nx_nxa_corner_checkpoint_gate_t280.nx | 26 | 1 | |
| nx_nxa_corner_prepare_candidate_t280.nx | Prepares candidate data for corner processing by extracting vertex and triangle information from an NXA file. | 114 | 5 |
| nx_nxa_corner_prepare_gate_t280.nx | 50 | 1 | |
| nx_nxa_corner_prepare_t280.nx | 26 | 1 | |
| nx_nxa_dyna.nx | WRITE THE DYNA SECTION: per-bone soft-tissue physics DECLARED IN THE ASSET, | 473 | 11 |
| nx_nxa_fk.nx | SHARED integer quaternion + FK primitives for the NXA import pipeline. | 102 | 7 |
| nx_nxa_fullskin_affine_gate_t37.nx | 24 | 1 | |
| nx_nxa_garment.nx | FITTED GARMENT GENERATOR (SOTA garment rung): builds a dress mesh | 252 | 4 |
| nx_nxa_garment_bind_candidate_t132.nx | Deterministic garment-to-body binding, shared by asset preparation and worker conversion. | 210 | 12 |
| nx_nxa_garment_bind_gate.nx | 78 | 3 | |
| nx_nxa_garment_bind_lib.nx | Deterministic garment-to-body binding, shared by asset preparation and worker conversion. | 210 | 12 |
| nx_nxa_garment_pack_gate_t132.nx | Validates garment binding policies and checks coordinate-based query responses in a shared memory environment. | 84 | 3 |
| nx_nxa_gpu_gate.nx | Qualify native GPU geometry packing with IEEE-754 witnesses and real NXA assets. | 243 | 6 |
| nx_nxa_gpu_lib.nx | Native NXA geometry conversion for GPU upload; no platform API or allocator dependency. | 318 | 16 |
| nx_nxa_gpu_wasm_gate.nx | Cross-backend regression: compiler data semantics plus the real NXA conversion workload. | 13 | 9 |
| nx_nxa_groom.nx | GENERATE THE GROOM: full-scalp procedural hair strands written into the | 619 | 11 |
| nx_nxa_groom_gate.nx | THE GROOM GATE v3: anatomical invariants on a generated groom asset. | 369 | 6 |
| nx_nxa_hair.nx | HAIR MESH INGEST (SOTA rung 3): extracts the character's REAL groomed | 435 | 10 |
| nx_nxa_hierarchy_correction_candidate_t332.nx | World-space rigid correction of an existing inverse-bind skin palette. | 145 | 8 |
| nx_nxa_hierarchy_correction_gate_t332.nx | Validates affine hierarchy corrections with error checks and refusal conditions. | 73 | 4 |
| nx_nxa_hierarchy_dq_fixture_t332.nx | Exact retained idle and transitional source captures; source DQ scale preserved. | 3468 | 1 |
| nx_nxa_hierarchy_dq_gate_t332.nx | 66 | 3 | |
| nx_nxa_hierarchy_dq_target_t332.nx | Sets target values based on an index, using fixed constants and arithmetic expressions. | 1672 | 1 |
| nx_nxa_hierarchy_fixture_t332.nx | Actual pinned resident capture actor0 tick19037; matricesQ30, model coordinates /1024. | 8 | 1 |
| nx_nxa_joints.nx | SOVEREIGN STRUCTURAL JOINT IDENTIFICATION over an NXA SKEL. | 260 | 4 |
| nx_nxa_morf.nx | WRITE THE FACE AND MORF SECTIONS: the addressable face region and the | 782 | 15 |
| nx_nxa_morf_admit.nx | ORIGINAL. Allocation-free extraction of mf_eval's FACE/MORF admission. | 202 | 7 |
| nx_nxa_morf_draw_admit.nx | ORIGINAL. Compose the canonical MORF ingress with existing geometric normals. | 78 | 1 |
| nx_nxa_morf_draw_ingress_gate.nx | ORIGINAL. Read-only real NXA witness. Usage: gate.elf <banked-asset.nxa> | 265 | 4 |
| nx_nxa_morf_gate.nx | FACE AND MORF ARE GEOMETRY, NOT TAGS. | 414 | 13 |
| nx_nxa_morf_ingress_gate.nx | ORIGINAL. Read-only real NXA witness. Usage: gate.elf <banked-asset.nxa> | 194 | 4 |
| nx_nxa_morf_malformed_gate.nx | drive the promoted evaluator with checksum-valid | 264 | 12 |
| nx_nxa_morph.nx | FIGURE CANON morph at BAKE level (SOTA rung 2): applies the operator's | 244 | 4 |
| nx_nxa_pect.nx | GIVE THE SOFT TISSUE ITS BONES: append the lateral pectoral pair to an NXA | 546 | 10 |
| nx_nxa_play.nx | THE NXA POSE PLAYER: apply a POSE-library entry to a rigged NXA and evaluate | 403 | 7 |
| nx_nxa_play_gate.nx | THE POSE PLAYER GATE: skinning is JOINT-DRIVEN, deterministic, bounded at | 147 | 5 |
| nx_nxa_pose.nx | POSE section compiler: freezes ANIM channel-2 keyframes into the NXA | 296 | 7 |
| nx_nxa_posewrite_lib.nx | THE ONE POSE-SECTION WRITER for the NXA format (spec: knowledge/nxa_format_spec.md POSE). | 170 | 4 |
| nx_nxa_retarget.nx | DONOR RETARGET: drive a rigged NXA that carries NO authored clips from a | 1091 | 21 |
| nx_nxa_retarget_gate.nx | THE DONOR RETARGET GATE: handedness is DERIVED, limb length is | 252 | 4 |
| nx_nxa_rig_emit.nx | SKINNED-CHARACTER viewer emitter v5: fetches an NXA (VERT/TRIS/SKEL/ | 74 | 4 |
| nx_nxa_rig_motion_20260909.nx | Caller-owned native rig composition extracted from nx_nxa_retarget, 2026-09-09. | 67 | 2 |
| nx_nxa_rig_motion_context.nx | Caller-owned staging boundary for the existing native rig-motion frame evaluator. | 171 | 7 |
| nx_nxa_rig_motion_context_t140.nx | Caller-owned staging boundary for the existing native rig-motion frame evaluator. | 171 | 7 |
| nx_nxa_rig_motion_stream.nx | Computes motion transformations for animated entities using basis matrices and affine composition. | 127 | 5 |
| nx_nxa_rig_motion_stream_t140.nx | Caller-owned native rig composition extracted from nx_nxa_retarget, 2026-09-09. | 192 | 7 |
| nx_nxa_secdump.nx | THE MISSING NXA INSPECTOR: print the section directory of an NXA asset, | 305 | 7 |
| nx_nxa_secdump_gate.nx | THE GATE FOR THE NXA SECTION INSPECTOR. | 294 | 9 |
| nx_nxa_skin.nx | RIG IMPORTER: fills the NXA's SKEL + SKIN sections from a binary FBX. | 1057 | 8 |
| nx_nxa_skin_affine_compose_gate_t36.nx | 15 | 1 | |
| nx_nxa_skin_authored_gate_t36.nx | 14 | 1 | |
| nx_nxa_skin_authored_t36.nx | RIG IMPORTER: fills the NXA's SKEL + SKIN sections from a binary FBX. | 1048 | 8 |
| nx_nxa_skin_authored_t37.nx | RIG IMPORTER: fills the NXA's SKEL + SKIN sections from a binary FBX. | 1083 | 9 |
| nx_nxa_skin_authored_witness_t140.nx | RIG IMPORTER: fills the NXA's SKEL + SKIN sections from a binary FBX. | 1083 | 9 |
| nx_nxa_skin_gate.nx | THE REFEREE nx_nxa_skin NEVER HAD (2026-09-04). | 197 | 4 |
| nx_nxa_skin_scalar_negative_t36.nx | 5 | 1 | |
| nx_nxa_skin_variable_t37.nx | Additive SKV1 full-influence section; legacy SKIN stays available with its declared top-four loss. | 20 | 1 |
| nx_nxa_strands.nx | USC-HairSalon STRAND GROOM INGEST (dev oracle, license-clean for | 247 | 5 |
| nx_nxa_stream_emit.nx | SOVEREIGN STREAMING NXA viewer emitter. The embedded-base64 viewer | 65 | 4 |
| nx_nxa_surface_anchor_boundary_candidate_t207.nx | 118 | 10 | |
| nx_nxa_surface_anchor_t140.nx | Private candidate: generic surface query composed from canonical NXA attachment validation. | 94 | 9 |
| nx_nxa_surface_support_candidate_t207.nx | Computes surface intersection parameters for garment attachment validation using exact rational arithmetic. | 144 | 15 |
| nx_nxa_texbake.nx | CLI for the texture ladder (debt 1786546859): | 63 | 2 |
| nx_nxa_texbake_decode_t279.nx | ★TEXTURE LADDER rungs 2b+3+4 (debt 1786546859, successor of the TEXC format rung): | 562 | 20 |
| nx_nxa_texbake_gate.nx | GATE for texture-ladder rungs 2b+3+4 (debt 1786546859). Fixture ASSEMBLED AT | 369 | 5 |
| nx_nxa_texbake_lib.nx | ★TEXTURE LADDER rungs 2b+3+4 (debt 1786546859, successor of the TEXC format rung): | 540 | 19 |
| nx_nxa_texbake_region.nx | CLI for the PER-REGION skin atlas + periodic micro-relief tile (TEXR): | 134 | 4 |
| nx_nxa_texbake_region_capacity_t278.nx | PER-REGION SKIN ATLAS + PERIODIC MICRO-RELIEF TILE, written INTO the | 1629 | 40 |
| nx_nxa_texbake_region_edge_t278.nx | PER-REGION SKIN ATLAS + PERIODIC MICRO-RELIEF TILE, written INTO the | 1638 | 41 |
| nx_nxa_texbake_region_gate.nx | GATE for the per-region skin atlas + periodic micro-relief tile (TEXR), | 359 | 9 |
| nx_nxa_texbake_region_job_t278.nx | CLI for the PER-REGION skin atlas + periodic micro-relief tile (TEXR): | 127 | 5 |
| nx_nxa_texbake_region_lib.nx | PER-REGION SKIN ATLAS + PERIODIC MICRO-RELIEF TILE, written INTO the | 1638 | 41 |
| nx_nxa_texc.nx | CLI: write the TEXC (UV atlas) section into an NXA asset. | 19 | 1 |
| nx_nxa_texc_gate.nx | GATE for the TEXC format rung (debt 1785794796 rung 1). Fixtures are ASSEMBLED AT | 244 | 3 |
| nx_nxa_texc_lib.nx | ★TEXC: UV TEXTURE COORDINATES AS A FORMAT CAPABILITY (debt 1785794796 rung 1). | 404 | 12 |
| nx_nxa_texm.nx | WRITE THE TEXM SECTION: the baked PBR map set carried INSIDE the asset. | 496 | 8 |
| nx_nxa_texm_gate.nx | THE GATE FOR THE TEXM WRITER. | 342 | 9 |
| nx_nxa_tier.nx | THE INGEST TIER LADDER FOR NXA ASSETS (/compare/modding MD5 ingest_tier_emit, 2026-09-05). | 588 | 17 |
| nx_nxa_tier_gate.nx | THE GATE FOR THE INGEST TIER LADDER (nx_nxa_tier, /compare/modding MD5). | 493 | 19 |
| nx_nxa_tier_gate_pre_region_t143.nx | THE GATE FOR THE INGEST TIER LADDER (nx_nxa_tier, /compare/modding MD5). | 417 | 14 |
| nx_nxa_tier_pre_region_t143.nx | THE INGEST TIER LADDER FOR NXA ASSETS (/compare/modding MD5 ingest_tier_emit, 2026-09-05). | 557 | 16 |
| nx_nxa_tier_region_candidate_t143.nx | THE INGEST TIER LADDER FOR NXA ASSETS (/compare/modding MD5 ingest_tier_emit, 2026-09-05). | 588 | 17 |
| nx_nxa_tier_region_gate_t143.nx | THE GATE FOR THE INGEST TIER LADDER (nx_nxa_tier, /compare/modding MD5). | 493 | 19 |
| nx_nxa_view_emit.nx | SOVEREIGN NXA browser-viewer emitter: reads a .nxa (our animated 3D | 73 | 5 |
| nx_nxa_write_append_t37.nx | Additive section append for the existing NXA writer; caller validates section semantics. | 17 | 1 |
| nx_nxa_write_lib.nx | THE NXANIM01 CONTAINER WRITER AS A LIBRARY (/compare/modding MD2, 2026-09-06). The estate held three | 228 | 9 |