X

Chapter 9 MIDI plug-ins 193
Create Scripter controls
The Scripter Script Editor lets you use a simple shorthand to add standard controllers such as
sliders and menus for automated or real-time control of your plug-ins. The only mandatory
property to dene a new parameter is a name, which defaults to a basic slider. In addition, you
can add the following properties to change the type and behavior of controls.
Optional properties
•
type: Type one of the following strings as the value:
•
“lin”: Creates a linear fader.
•
“log”: Creates a logarithmic fader.
•
“menu”: Creates a menu.
•
“valueStrings”: The menu type requires an additional property that is an array of strings to
show in the menu.
•
defaultValue: Type an integer or oating point number to set a default value. If no value is
typed, the default is 0.0.
•
minValue: Type an integer or oating point number to set a minimum value. If no value is
typed, the default is 0.0.
•
maxValue: Type an integer or oating point number to set a maximum value. If no value is
typed, the default is 1.0.
Dene MIDI plug-in controls
Type the following in the Script Editor window to create these controller types:
m Slider 1: var PluginParameters = [{name:"Parameter x", defaultValue:0.5}];
The code example results in a slider named “Parameter x” with a default range of 0 to 1. It is set to
the mid-point of 0.5.
m Slider 2: var PluginParameters = [{name:"Octaves", defaultValue:3, minValue:0,
maxValue:5, numberOfSteps:5, unit:"octaves", type:"lin"}];
This code example results in a linear slider type, with ve possible positions (steps), and a range
from 0 to 5.
m Menu: var PluginParameters = [{name:"Range", type:"menu", valueStrings:["Low",
"Mid", "High"]}];
This code example creates a menu named "Range" with the options "Low", "Mid", and "High".