Gfx GX Fn GXGetVtxDescv - wowjinxy/libPorpoise GitHub Wiki

GXGetVtxDescv

  • Category: Geometry and Vertex
  • Matrix Status: Implemented
  • Matrix Notes: Returns active descriptor list and terminates with GX_VA_NULL.
  • Matrix Link: Gfx-GX-API-Matrix

Official SDK (Reference)

  • Manual root: reference/rvlsdk/man/en_US/gx
  • Primary SDK source area: demos/PikminDemo/src/gx (GC-style Dolphin GX source)
  • Notes:
    • Confirm official signature/prototype
    • Confirm documented side effects (register/state updates)
    • Confirm special behavior and edge cases from manual

libPorpoise Implementation

  • Runtime implementation area: src/gx
  • Public API surface: include/dolphin/gx
  • Notes:
    • Confirm API signature matches SDK
    • Confirm state writes match SDK semantics
    • Confirm backend behavior in PC renderer path

SDK vs Porpoise Diff

  • Signature parity:
    • SDK:
    • Porpoise:
  • Behavioral parity:
    • SDK:
    • Porpoise:
  • Known divergence:

Validation Checklist

  • GX demo coverage checked
  • Pikmin usage path checked
  • Matrix status updated if needed
  • Notes updated with concrete file/function references

Working Notes

  • Docs checked against reference/man/gfx/gx/Geometry/GXGetVtxDescv.html and SDK source in reference/gx/GXAttr.c.
  • Parity detail from SDK source:
    • Emits a full descriptor snapshot in fixed order GX_VA_PNMTXIDX .. GX_VA_TEX7.
    • Appends GX_VA_NBT.
    • Terminates with GX_VA_NULL.
  • Runtime updated in src/gx/pc_gx.c to match this order and include all attributes (not only non-GX_NONE entries), then append GX_VA_NULL.