Preloads presets from a soundfont.
BOOL BASS_MIDI_FontLoad( HSOUNDFONT handle, int preset, int bank );
|handle||The soundfont handle.|
|preset||Preset number to load... -1 = all presets.|
|bank||Bank number to load... -1 = all banks.|
|BASS_ERROR_HANDLE||handle is not valid.|
|BASS_ERROR_CODEC||The appropriate add-on to decode the samples is not loaded.|
|BASS_ERROR_NOTAVAIL||The soundfont does not contain the requested preset.|
When preloading samples to render a particular MIDI stream, it is more efficient to use BASS_MIDI_StreamLoadSamples to preload the specific samples that the MIDI stream will use, rather than preloading the entire soundfont.
Samples that are preloaded by this function are not affected by automatic compacting via the BASS_CONFIG_MIDI_COMPACT option, but can be compacted/unloaded manually with BASS_MIDI_FontCompact and BASS_MIDI_FontUnload.
A soundfont should not be preloaded while it is being used to render any MIDI streams, as that could delay the rendering.