Priority 2: Scene Intelligence
shachi-submit (Serialized Submission)
What: Enforce Kamui’s serialization rules for TA
submission. Why: DIV-008. KOS allows dangerous mixed
SQ/DMA submission. Scope: ~150 lines C. Wrapper around
pvr_prim/pvr_dr_commit that ensures: - Single
submission method per display list - EOL between list types - SQ flush
verification before DMA begins - Per-list statistics (vertex count,
header count)
shachi-fog (Vertex Fog + Enhanced Table Fog)
What: Vertex fog support (KOS assertion fails) +
per-frame animated fog tables. Why: GAP-11 in KOS.
KATANAStudy Fog2 proves animated fog works on hardware.
Scope: ~100 lines C. Vertex fog via per-vertex color
channel. Animated table fog via direct PVR_FOG_TABLE_BASE
writes.
shachi-bump (Bump Mapping Pipeline)
What: Complete bump mapping pipeline for 3D meshes. Why: Q-004/Q-005 answered — format is known, but no sample code exists anywhere. KOS has the flag but no light direction API. Scope: ~200 lines C. Per-strip light direction calculation → encode in oargb → multi-pass (base + bump overlay).