SYNInitSynth

C Specification

#include <revolution.h>
#include <revolution/syn.h>

void SYNInitSynth(
		 SYNSYNTH *synth,
                 u8       *wavetable,
                 u8       *samples,
                 u8       *zerobuffer,
                 u32      priorityVoiceAlloc,
                 u32      priorityNoteOn,
                 u32      priorityNoteRelease
                 );

Arguments

synth Pointer to user-allocated SYNSYNTH data structure.
wavetable Pointer to contents of WT file in memory.
samples Pointer to contents of PCM file in memory.
zerobuffer Pointer to zero buffer in memory (Not used. Specify NULL.)
priorityVoiceAlloc Priority for allocating AX voices to handle MIDI notes with events.
maximum: 31
minimum: 1
priorityNoteOn Priority at which to set voices after successful allocation.
maximum: 31
minimum: 1
priorityNoteRelease Priority at which to set voices after MIDI keyoff event.
maximum: 31
minimum: 1

Return Values

None.

Description

This function initializes a user-allocated instance of the synthesizer. Any number of synthesizer instances may be used. All running synthesizers will contend for the same pool of AX voices at runtime. SYNInitSynth must be called prior to any other API calls for the specific instance of the synthesizer.

See Also

SYNInit

Revision History

2006/11/21 Added an explanation to the arguments about the zero buffer no longer being necessary.
2006/03/01 Initial version.

CONFIDENTIAL