Create Scripter MIDI plug-in controls in MainStage

In MainStage, type the following in the Script Editor window to create a slider named “Parameter x” with a default range of 0 to 1. It is set to the mid-point value of 0.5.

In MainStage, type the following in the Script Editor window to create a linear slider type, with five possible positions (steps), and a range from 0 to 5.

In MainStage, type the following in the Script Editor window to create a menu named “Range” with the options “Low”, “Mid”, and “High”.

In complex MainStage scripts, it may be helpful to hide or show parameter controls dynamically, such as for a menu item that lets you choose a group of controls to display. Type the following in the Script Editor window to create these controller types.

• var PluginParameters = [{name:'uno'}, {name:'dos', hidden:true}];

  Call UpdatePluginParameters() to change this dynamically.

Call GetParameter() with the parameter name to return a value (number object) with the current value of the parameter. GetParameter() is typically used inside the HandleMIDI function or ProcessMIDI function.

In MainStage, this code example converts modulation events into note events and provides a slider to determine note lengths.

• Text following /* shows comments that explain the JavaScript code.

  var PluginParameters = [{name:"Note Length", minValue:0, maxValue: 100, unit:"%"}]; /* create a slider (default range 0 - 100) */function HandleMIDI(event) {if(event instanceof ControlChange && event.number == 1) { /* if event is MIDI cc1 (modwheel) */var note = new NoteOn; /* create a NoteOn object */if(event.value == 0)/* because modwheel range is 0-127 and pitch range is 1-127, convert a modwheel value of 0 to 1 */event.value = 1;note.pitch = event.value; /* use cc value as note pitch */note.velocity = 100; /* use velocity 100 */note.send(); /* send note on */ var off = new NoteOff(note); /* create a NoteOff object that inherits the NoteOn pitch and velocity values */ var delayInBeats = GetParameter("Note Length")/100 + 0.1; /* retrieve the parameter value of the slider you created (add 0.1 to guarantee note on and off are not simultaneous) */ off.sendAfterBeats(delayInBeats); /* send note off after the length in beats is set via the slider */ }}