Steuerungen für das Scripter MIDI-Plug-in in MainStage erstellen

In den folgenden Abschnitten wird erläutert, wie du den Script Editor verwenden kannst, um Standardsteuerungen für Bedienoberflächen wie Regler und Menüs deiner Scripter-Plug-ins zu erstellen. Die einzige zwingend zu definierende Eigenschaft für einen neuen Parameter ist „name“. Der standardmäßig einem einfachen Regler zugewiesen wird. Du kannst weitere Eigenschaften verwenden, über die du den Typ und das Verhalten der Steuerungen ändern kannst.

Lade die entsprechende Tutorial-Einstellung, um das Skript im Skripteditor anzuzeigen. Dies erleichtert das Verständnis der Syntaxstruktur und des Layouts von Code und Kommentaren. Weitere Informationen findest du unter Script Editor verwenden.

Optionale Eigenschaften

type: Gib einen der folgenden Strings als Wert ein:
- „lin“: Erstellt einen linearen Regler.
- „log“: Erstellt einen logarithmischen Regler.
- „momentary“: Erstelle eine momentane Taste.
- „menu“: Erstellt ein Menü.
  Der Menütyp erfordert eine zusätzliche valueStrings-Eigenschaft, d. h. eine Anordnung verschiedener Strings, die im Menü angezeigt werden. Siehe Tutorial-Skript 13:
defaultValue: Gib eine Ganzzahl oder eine Gleitkommazahl ein, um den Standardwert zu definieren. Wenn du keinen Wert eingibst, wird standardmäßig der Wert 0,0 verwendet.
minValue: Gib eine Ganzzahl oder eine Gleitkommazahl ein, um den Mindestwert zu definieren. Wenn du keinen Wert eingibst, wird standardmäßig der Wert 0,0 verwendet.
maxValue: Gib eine Ganzzahl oder eine Gleitkommazahl ein, um den Höchstwert zu definieren. Wenn du keinen Wert eingibst, wird standardmäßig der Wert 1,0 verwendet.
numberOfSteps: Gib eine Ganzzahl ein, um die Anzahl der Schritte festzulegen.
unit: Gib einen String ein, der eine Einheitenbeschreibung in den Plug-in-Steuerungen darstellt. Wird kein Wert eingegeben, wird standardmäßig keine Einheit angezeigt.
text: Gib text ein, um einen Trenner oder Header der Plug-in-Oberfläche zu erstellen.

Tutorial-Skript 12: Slider Creation

In MainStage – gib Folgendes in das Fenster des Skripteditors ein, um einen Schieberegler namens „Parameter x“ mit einem standardmäßigen Bereich von 0 bis 1 zu erzeugen. Als Standardwert wurde der Mittelwert 0,5 definiert.

var PluginParameters = [{name:"Parameter x", defaultValue:0.5}];

Tutorial-Skript 13: Slider Ranges

In MainStage kannst du Folgendes in das Fenster des Skripteditors eingeben, um einen linearen Regler-Typ mit fünf möglichen Positionen (Schritte) und einem Bereich von 0 bis 5 zu erstellen.

var PluginParameters = [{name:"Octaves", defaultValue:3, minValue:0, maxValue:5, numberOfSteps:5, unit:"octaves", type:"lin"}];

Tutorial-Skript 14: Menu Creation

In MainStage – gib Folgendes in das Fenster des Skripteditors ein, um ein Menü namens „Range“ mit den Optionen „Low“, „Mid“ und „High“ zu erzeugen.

var PluginParameters = [{name:"Range", type:"menu", valueStrings:["Low", "Mid", "High"]}];

Dynamische Ein- und Ausblenden der MIDI-Plug-in-Steuerungen

In komplexen MainStage -Skripts kann es nützlich sein, die Parametersteuerungen dynamisch ein- oder auszublenden, etwa für ein Menüobjekt, mit dem du eine Gruppe von Steuerungen ein- oder ausblenden kannst. Gib den folgenden Text im Fenster des Skripteditors ein, um diese Controller-Typen zu erstellen:

var PluginParameters = [{name:'uno'}, {name:'dos', hidden:true}];
Rufe UpdatePluginParameters() auf, um dies dynamisch zu ändern.

Parameterwerte von Plug-ins zurücksetzen

Rufe GetParameter() auf und gib einen Parameternamen in der Klammer ein, um einen Wert durch den aktuellen Wert dieses Parameters zu ersetzen. GetParameter() wird normalerweise innerhalb der Funktion „HandleMIDI“ oder Funktion „ProcessMIDI“ verwendet.

In MainStage wandelt dieses Code-Beispiel Modulations-Events in Noten-Events um und erstellt einen Regler zum Bestimmen der Notenlängen.

Text nach „/*“ zeigt Kommentare an, die den JavaScript-Code erklären.
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 */ }}

Hilfreich?

MainStage– Benutzerhandbuch