alBnkfNew (function)

Initializes a bank file for use on Nintendo 64

Syntax

#include <libaudio.h>     /* libaudio.h */
void alBnkfNew(ALBankFile *ctl, u8 *tbl);

Arguments

bank
Pointer to the control (.ctl) data

tbl
Pointer to the wavetable (.tbl) data

Description

The instrument compiler ic creates two files, the control (.ctl) file and the wavetable (.tbl) file. The control file contains instrument performance information and the wavetable file contains the actual wavetable data.

The control file format specifies that references to bank data be stored as offsets from the beginning of the control file. To improve runtime performance, the offsets are converted to virtual addresses by alBnkfNew.

Typically, the control file is loaded into DRAM before the wavetable file. The wavetable file is usually large. To save DRAM space, the wavetable is stored in ROM and samples are DMA'd to DRAM, as necessary. If your wavetable file is small, you can optionally load it into DRAM, which will minimize the number of DMA requests processed during sequence playback.

See Also

ic, alSeqpSetBank

Revision History

1999/04/30 Changed Format