File Systems

Kirby 64 uses a couple different addressing systems to point to resources in ROM.

A “bank-index” is a 32-bit value containing a bank number and an index to refer to a block of data. The upper 16 bits contain the bank number and the lower 16 bits contain the index. The bank number selects the bank base address from an array, and the index number selects an offset from another array, and adds it to the base address. Confusingly, there are (at least?) two distinct sets of banks that use this type of addressing.

This bank set contains miscellaneous data including level settings and particle textures.

This bank set contains contains mesh textures.

The functions at 0x800A9AA8 and 0x800A8BAC are used to load data from Bank Set 1 and Bank Set 2, respectively. These functions return a pointer to the data after it's loaded into memory. The engine keeps track of what has been loaded; if the block of data corresponding to the provided bank-index is already in memory, these function will simply return a pointer to that block without loading more data.

void *func_800A9AA8(u32 bankIndex); // bank set 1 loader/address resolver
void *func_800A8BAC(u32 bankIndex); // bank set 2 loader/address resolver

A “list-index” is a 32-bit value containing a bank number and an index to refer to a block of data. The upper 16 bits contain the list number and the lower 16 bits contain the index. The list number selects a list from an array, and the index number selects a ROM start and end address pair from the list. It seems this form of addressing is specifically used to refer to Geometry Blocks.

The function at 0x800A9864 is used to load data and return a pointer to it, given a list-index.

void func_800A9864(u32 listIndex, u32 arg1, u32 arg2);