N64® Functions Menu

al - Audio Library Functions
gDP - DP GBI Macros
gdSP - General GBI Macros
gSP - SP GBI Macros
gt - Turbo Microcode RDP
gu - Graphics Utilities
Math - Math Functions
nuSys - NuSystem
os - N64 Operating System
sp - Sprite Library Functions
uh - Host to Target IO
64DD - N64 Disk Drive

Nintendo® Confidential

   

alSeqFileNew

Format
#include <libaudio.h>
void alSeqFileNew(ALSeqFile *file, u8 *base);


Arguments
  • file is the pointer to an uninitialized sequence file structure
  • base is the pointer to the base of sequence file data
What This Function Does
The Sequence Bank Compiler (sbc) creates a sequence bank file (.sbk) from one or more MIDI sequence files. The sequence bank file contains an array of sequences (8-byte aligned) with a header at the front that allows indexing into the sequence bank to gain access to individual sequences. The header information is defined by the ALSeqFile structure.

Before the game application can get to the individual sequences, it must first initialize the sequence bank header by calling the alSeqFileNew function. Typically, the game application first allocates enough memory to contain the sequence bank header information (ALSeqFile). Then it copies the header information from the Cartridge ROM into the allocated ALSeqFile structure. Finally, it calls alSeqFileNew with the pointer to the ALSeqFile structure and the base of the sequence bank data in ROM.

Note that to allocate memory for the sequence bank header, the game application may need to first look at the seqCount field to know the exact size of the header.

Warning
This routine is designed to be called once for a single sequence bank file. Calling the routine on an already initialized sequence bank file could produce unexpected results.

See Also
sbc



Nintendo® Confidential

Warning: all information in this document is confidential and covered by a non-disclosure agreement. You are responsible for keeping this information confidential and protected. Nintendo will vigorously enforce this responsibility.


Copyright © 1998
Nintendo of America Inc. All rights reserved
Nintendo and N64 are registered trademarks of Nintendo
Last Updated January 1998