DK64 Lib Documentation#

Python tooling for Donkey Kong 64 ROM data

Extract DK64 text, geometry, display lists, textures, and raw assets.

dk64_lib reads big-endian DK64 ROMs, walks the pointer tables, parses the asset types that are currently understood, and exports useful files for analysis and tooling.

Start Getting Started Install the package, open a ROM, and run the common export workflows. Data Asset Types Understand text tables, geometry, textures, cutscenes, and raw table exports. Output Export Reference See which files are produced by each exporter and how they are named. Pipeline Textured Geometry Follow OBJ, glTF/GLB, DAE export, UV mapping, vertex colors, texture decoding, and DK64 mipmaps. API Python Reference Jump into autodoc pages for Rom, data objects, display lists, and utilities.

What dk64_lib Handles#

dk64_lib focuses on the asset tables exposed by the DK64 ROM pointer table. The current library surface covers:

  • ROM metadata and pointer table traversal through dk64_lib.rom.Rom.

  • Text parsing into immutable text line and fragment records.

  • Geometry parsing into display lists, vertices, and triangles.

  • Textured OBJ, glTF/GLB, and DAE export with material data and PNG textures.

  • Raw exports for known texture, cutscene, text, geometry, and asset tables.

The documentation is intentionally structured around ROM concepts first and API details second. Start with Getting Started, then use Asset Types as the data model map while extending the library.