    Function

    nuAuInit
    nuAuInitEx

Syntax

    s32 nuAuInit(void)
    s32 nuAuInitEx(void)

Arguments
None

Return Values
Heap size consumed

Explanation
This initializes the audio manager and starts two sequence players and one sound player. It also registers the default function which is called when a PRENMI event has occurred.

The least significant portion of the frame buffer is set to 320 Kbytes as the audio heap. For two sequence players, 32 Kbytes each are assigned from this heap.

If you wish to change the audio heap size or to change the sequence data storage buffer size, rather than using nuAuInit, refer to the nuAuInit source and initialize the audio yourself.

The nuAuInit function calls the nuAuMgrInit function and starts the audio manager. This audio manager plays back audio using retrace events. This is the method which has been used in the past.

The nuAuInitEx function calls the nuAuMgrInitEx function. This audio manager plays back audio using retrace events and AI events. This is a new audio manager. Since AI-DMA control can be reliably and efficiently accomplished when this audio manager is used, the AI buffer is empty and noise is unlikely to occur. In addition, two audio data buffers are sufficient.

The difference between these two audio managers is the timing with which audio tasks are executed. In the case of the conventional audio manager, audio tasks are executed immediately after a retrace event. However, when AI events are used, audio tasks are executed when the AI-DMA register becomes empty.

In addition, due to restrictions on the smallest processing unit in the audio microcode, audio data cannot be created accurately in one-frame pieces. Consequently, since the audio task execution timing changes for each frame, care is required as this may affect graphics tasks.

See Also
nuAuMgrInit
nuAuMgrInitEx
nuAuSeqPlayerInit
nuAuSndPlayerInit
nuAuPreNMIFuncSet

Revision History
2/1/1999 Added text regarding nuAuInitEx function.