Skip to content

decomp-assets 0.5.0: textures in a UV filesystem of FORM files - #4

Merged
RetroGameDeveloper merged 1 commit into
mainfrom
feat/uv-filesystem-textures
Nov 14, 2026
Merged

RetroGameDeveloper merged 1 commit into
mainfrom
feat/uv-filesystem-textures

Conversation

@RetroGameDeveloper

@RetroGameDeveloper RetroGameDeveloper commented Nov 14, 2026 •

Copy link
Copy Markdown
Contributor

What

New N64 recogniser n64/uv_textures.py: UVTX texture files in an IFF-style FORM filesystem (raw COMM chunks, or MIO0 inside GZIP chunks), used by two N64 games from one flight-simulation studio.

  • Each file's own display list gives the tile's format and size; the texels are the file's first texture image.
  • Tiles are sized from their TMEM row stride and the bytes loaded (one game draws tiles half a texel in, which the shared display-list walker rejects); the height comes from the file's trailer.
  • Block loads with no row step (dxt 0) store odd rows with their 32-bit words swapped; the preview swaps them back.
  • Colour-indexed tiles whose palette is another file are left out.

Results (read-only, on the user's own ROMs)

  • A flight game: 453 of 463 UVTX files.
  • A racing game: 1,175 of 1,437 UVTX files.

Contact sheets checked by eye: signs, logos, terrain and HUD art, with no noise.

Tests

tests/test_uv_textures.py (homemade files: raw and MIO0, both header sizes, swapped rows, rejections); 155 tests pass, ruff clean.

🤖 Generated with Claude Code

Two N64 games from one studio keep their textures as UVTX files in an IFF-style
filesystem, most packed with MIO0 inside a GZIP chunk. Each file carries the
display list the game draws it with, so the tile's format and size are read from
it exactly. Tiles are sized from their TMEM row and what the load filled (one
game draws them half a texel in), the height from the file's own trailer, and
odd rows stored swapped for a block load with no row step are swapped back.
On the two games: 453 of 463 and 1,175 of 1,437 files show.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@RetroGameDeveloper
RetroGameDeveloper merged commit 611b64f into main Nov 14, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant