formatMidiName(name)

Formats the name of a MIDI for display purposes.

Returns

preload(parameters)

Loads instrument patches for a list of MIDI input.

Please note that you can not use parameters.items.arrayBuffer and parameters.items.url concurrently.

Returns

Examples

const name1 = 'My MIDI file from URL';
const url = 'media/file.midi';
const name2 = 'My MIDI file from ArrayBuffer';
const arrayBuffer = new ArrayBuffer();

midiPlayer.preload({
  items: [
    { url, name: name1 },
    { arrayBuffer, name: name2 }
  ]
});

play(input)

Starts playback of MIDI input.

Please note that you can not use input.arrayBuffer and input.url concurrently.

Returns

Examples

const name1 = 'My MIDI file from URL';
const url = 'media/file.midi';
midiPlayer.play({ url, name: name1 });

const name2 = 'My MIDI file from ArrayBuffer';
const arrayBuffer = new ArrayBuffer();
midiPlayer.play({ arrayBuffer, name: name2 });

pause()

Pauses playback of MIDI input.

Returns

Examples

midiPlayer.pause();

resume()

Resumes playback of MIDI input.

Returns

Examples

midiPlayer.resume();

stop()

Stops playback of MIDI input.

Returns

Examples

midiPlayer.stop();

getVolume()

Gets the current volume of the playback.

Returns

Examples

const volume = midiPlayer.getVolume();

setVolume(input)

Sets the current volume of the playback.

Examples

midiPlayer.setVolume({ volume: 80 });

emitEvent(payload)

Send custom payloads to the event logger.

Examples

const event = 'MIDI_CUSTOM_EVENT';
const message = 'Something happened.';
midiPlayer.emitEvent({ event, message });

setLogger(configuration?)

Updates the configuration of the logger.

Examples

const eventLogger = (payload) => {
  console.log('Received event:', payload.event);
}
midiPlayer.setLogger({ eventLogger });

alignMemoryPage(x)

exit(status)

Exits the script.

abort(text)

Throws an error that aborts the execution of the script.

assert(condition, text)

Aborts the execution of the script if assertion fails.

call(ident, returnType, argTypes, args)

A wrapper to call functions.

Returns

setValue(ptr, value, type)

Dynamically sets a value in memory at runtime. Only does aligned writes. This is a lower-level operation.

getValue(ptr, type)

Dynamically gets a value in memory at runtime. Only does aligned reads. This is a lower-level operation.

allocate(slab, types, allocator)

This is for internal use. Optimized for multiple syntaxes to save space in generated code. You should allocate memory using _malloc(), initialize it with setValue(), and so forth.

Pointer_stringify(ptr, length?)

UTF16ToString(ptr)

stringToUTF16(str, outPtr)

Copies a JavaScript string to the emscripten HEAP. The copy is null-terminated and encoded in UTF16LE form. The copy will require at most (str.length2+1)2 bytes of space in the HEAP.

UTF32ToString(ptr)

stringToUTF32(str, outPtr)

Copies a JavaScript string to the emscripten HEAP. The copy is null-terminated and encoded in UTF32LE form. The copy will require at most (str.length+1)*4 bytes of space in the HEAP.

callRuntimeCallbacks(callbacks)

addOnPreRun(cb)

addOnInit(cb)

addOnPreMain(cb)

addOnExit(cb)

addOnPostRun(cb)

intArrayFromString(stringy, dontAddNull, length)

intArrayToString(array)

writeStringToMemory(string, buffer, dontAddNull)

writeArrayToMemory(array, buffer)

writeAsciiToMemory(str, buffer, dontAddNull)

addRunDependency(id)

removeRunDependency(id)

createPath(parent, path, throwError)

Creates a directory.

createFile(parent, name, canRead, canWrite)

Creates a file.

createDataFile(parent, name, data, canRead, canWrite, canOwn?, throwError)

Creates a data file and writes data to it.

loadPatchFromUrl(baseUrl, filename)

Creates a file in the patch directory and writes the instrument data to it.

init(throwError)

Initializes the library.

emitInit()

Emits an event that indicates that the MIDI player is initialized.

emitLoadFile(payload)

Emits an event that indicates that a MIDI file is being loaded.

emitLoadPatch(payload)

Emits an event that indicates that a MIDI instrument patch is being loaded.

emitPlay(payload)

Emits an event that indicates that the MIDI player currently playing a MIDI file.

emitPause(payload)

Emits an event that indicates that the MIDI player has paused the playback of a file.

emitResume(payload)

Emits an event that indicates that the MIDI player has resumed the playback of a file.

emitStop()

Emits an event that indicates that the MIDI player has stopped the playback of a file.

emitEnd(payload)

Emits an event that indicates that the MIDI player has reached the end of a file.

emitError(payload)

Emits an event that indicates that an error prevented the MIDI player to continue.

emitEvent(payload)

Send payloads to the event logger.

setLogger(configuration?)

Updates the configuration of the logger.