Gfx GX Fn GXGetTexObjWrapS - wowjinxy/libPorpoise GitHub Wiki

GXGetTexObjWrapS

  • Category: Texture
  • Matrix Status: Implemented
  • Matrix Notes: Getter returns S wrap mode.
  • Matrix Link: Gfx-GX-API-Matrix

Official SDK (Reference)

  • Manual page: reference/man/gfx/gx/Texture/GXGetTexObjWrapS.html
  • SDK source: reference/ACGC-PC-Port/src/static/dolphin/gx/GXTexture.c (GXGetTexObjWrapS)
  • SDK behavior:
    • Returns GXTexWrapMode for the S axis from texture object state.
    • No state mutation; pure accessor.
    • SDK debug path asserts non-null texture object pointer.

libPorpoise Implementation

  • Public API declaration: include/dolphin/gx/GXGet.h
  • Runtime implementation: src/gx/pc_gx_texture.c (GXGetTexObjWrapS)
  • Behavior:
    • Returns wrap mode from TEXOBJ_WRAP_S in PC texture object storage.
    • No side effects.

SDK vs Porpoise Diff

  • Signature parity:
    • Manual documents GXTexObj*; SDK source uses const GXTexObj*.
    • Porpoise uses GXTexObj*; call-site semantics are equivalent for reads.
  • Behavioral parity:
    • SDK: returns S wrap mode from object.
    • Porpoise: returns S wrap mode from object.
  • Known divergence:
    • SDK has explicit debug assert on null pointer; Porpoise follows existing low-level getter convention (no assert in this accessor path).

Validation Checklist

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

Working Notes

  • No runtime code change required in this pass.