Build-time Tools (Shuriken+)

sh-texconv — Mac-native CLI:

sh-texconv input.png --format rgb565 --twiddle --mipmap -o output.pvr
sh-texconv input.png --format vq --quality 8 -o output.pvr
sh-texconv input.png --format pal8 --palette output.pal -o output.pvr

sh-meshconv — Mac-native CLI:

sh-meshconv model.obj --strip --sort-lists -o output.shm
sh-meshconv model.obj --strip --sort-lists --pretransform 640x480 -o output.shm

Notes

• .pvr file format is our own (not Sega’s). Header is minimal, data is hardware-ready.
• .shm mesh format pre-sorts vertices by PVR2 list type. Submission = iterate submeshes, set polygon header, DMA the vertex block.
• VQ textures include codebook (2048 bytes) followed by index data. Loaded to VRAM as a unit.
• KMG support is for interop with existing KOS homebrew assets.

Spec 4: Material System (shachi/material.h)