10.6

206Logic Pro Effects
Logic Pro Scripter MIDI plug-in HandleMIDI function
The HandleMIDI() function lets you process MIDI events that the plug-in receives.
HandleMIDI is called each time a MIDI event is received by the plug-in and is required in
order to process incoming MIDI events. If you don’t implement the HandleMIDI function,
events pass through the plug-in unaffected.
HandleMIDI is called with one argument, which is a JavaScript object that represents
the incoming MIDI event. HandleMIDI and JavaScript Event object use is shown in
the examples.
Load the corresponding Tutorial setting to view the script in the Script Editor. This will help
you to understand the syntax structure and layout of code and comments. See Use the
Logic Pro Scripter MIDI plug-in Script Editor.
Tutorial script 1: Simple Pass Through
Pass MIDI events through the plug-in.
function HandleMIDI(event) {
event.send();
}
Tutorial script 2: Trace Events
Log events to the plug-in console and don’t send them anywhere.
function HandleMIDI(event) {
event.trace();
}
Tutorial script 3: Transpose and Delay
Repeat notes up one octave with 100ms delay and pass all other events through.
Text following /* shows comments that explain the JavaScript code.
function HandleMIDI(event) {
event.send(); /* send original event */
if (event instanceof Note) { /* if it is a note */
event.pitch += 12; /* transpose up one octave */
event.sendAfterMilliseconds(100); /* send after delay */
}
}