Loads a set of sequences from a MIDI file.
Err MFLoadCollection( MIDIFileParser *mfpptr, char *filename, Collection *ColPtr )
This function loads a set of sequences from a Format 1 MIDI file and turns them into a Juggler collection for playback using the Juggler. To use this function, you must first create a Juggler collection using CreateObject()
. The function then creates an appropriate number of Juggler sequences to contain the sequences found in the MIDI file.
The function translates the MIDI messages in each file sequence into MIDI events in appropriate Juggler sequences within the collection. To work, the function must have a MIDIFileParser data structure to keep track of the MIDI sequence's original settings.
Note that this function also accept Format 0 MIDI files, treating them as a one-track Format 1 MIDI file.
This function returns 0 if successful or an error code (a negative value) if an error occurs.
Library call implemented in music.lib V20.
score.h, music.lib
CreateObject
(), MFLoadSequence(), MFUnloadCollection()