Adding or selecting a widget in Edit mode opens the Widget Properties inspector which is divided into two sections: Widget Properties and Mapping.
Widget properties
The Widget properties section is further divided into four tabs - General, MIDI, Value and Advanced.
General tab:
Customize caption - enable this toggle button to have the widget display a custom caption and then type in a new name. If this toggle button is disabled, the default caption is defined by the selected parameter name (refer to the Mapping section below for more information).
Note: if you add the "[value]" tag (without quotation marks) to your caption, then the parameter value will also be included in the caption:
If you add the "[variation]" or "[rackspace]" tag (without quotation marks) to your caption, then the name of the corresponding variation or rackspace respectively will be included in the caption.
Display range - this option is enabled by default; when disabled, the widget doesn't show the ring around the outside of the knob or slider:
When this toggle button is enabled, you can notice two colors: the total range (dimmed) and the scaled widget value (brighter color).
Show value in caption - this option is disabled by default; when enabled it overrides the defined caption and displays only the parameter value.
Show back plate - this option is enabled by default; when disabled, the "back plate" information such as numbers, Min/Max or an "on/off" legend is not displayed:
Note: this option is displayed only when you are editing a knob, a toggle switch or a LED button.
Hide temporary value - when this toggle button is turned on, the parameter value is never displayed when a widget changes.
Group - each widget can only be associated with a single plugin parameter. However, the 26 Widget Groups provided by Gig Performer enable you to control multiple parameters from any or all of the widgets assigned to that group. Click on the dropdown list (right to the "Group:") and select a letter ranging from A to Z to assign a widget to that group (e.g. "X"). All widgets with the same letter are grouped together so that moving one widget will cause all the other widgets in that group to move as well, adjusting various plugin parameters simultaneously:
Note: each of these widgets can have its own scale curve so that the actual values sent to the individual plugin parameters do not have to match. Check the How to add a widget to a widget group chapter for more information on widget groups.
Tip: Pressing a character (A-Z) while holding the Alt key (or Option on Mac) down will assign all selected widgets to that character's widget group.
Hide - clicking this toggle button will hide the widget when Edit mode is not active. Note: hidden widgets are semi-transparent in edit mode for easier identification.
Some widgets include the additional properties in the General tab; these are:
1. Shape widget - this widget includes additional properties: Fill Color, Outline Color, Roundness and Thickness (of the border):
Simply click on the corresponding buttons and then pick fill and outline colors (as well as their transparency).
2.Label widgets - these widgets (Text Label and Tape Label Horizontal/Vertical) include additional properties: Font Size (choose between 4 and 128), Text Position (allows 9 positions: Centered, Centered Left, Centered Right, Centered Top, Centered Bottom, Top Left, Top Right, Bottom Left, and Bottom Right alignment), and Text Color.
3.Sustain pedal, Buttons and Switches - includes the additional property Momentary touch to control the momentary behavior on mouse clicks or touch. Disabling this property will keep e.g. the sustain pedal up or down until you click on it again. Enabling this property will keep the pedal pressed until you release the mouse click.
MIDI tab:
Learn button - click on this button to have Gig Performer learn the physical control you want to associate with the selected widget. When actively in Learn Mode, the button is lit red; to exit Learn Mode, click on it again and it will return to its normal gray color. Refer to the How to connect a widget to a MIDI device chapter to learn more.
Note: the only CC messages that cannot be learned by Gig Performer are CC 0 and CC 32 as these two messages are reserved for bank selection.
Drop-down menu - clicking on this drop-down button (indicated with the red rectangle) opens a menu that allows you to select a MIDI control alias. Check the How to use aliases chapter for more information.
Edit button - click on this button to manually associate a MIDI device, MIDI message type and other parameters (depending on the message type, e.g. Note, Channel, CC number) with the selected widget.
Clear button - click on this button to clear the current controller assignment.
Invert button - when turned on, the behavior of the widget is reversed; for example, a switch or a button will cause a parameter to go to minimum when in the ON (lit) position, and vice versa.
Sync button - pressing this button engages bidirectional communication between Gig Performer and the controller mapped to the control. This lets physical controls on control surfaces reflect changes executed in Gig Performer, as well as Gig Performer widgets showing changes made on the physical control to which it is linked.
Momentary to latching - this toggle button is displayed only when editing switches, buttons, LEDs or a sustain pedal. When checked, the widget remains in its ON position until you click on it (or touch the associated physical controller) a second time. This is useful when you want to have a widget carry out an operation until stopped, i.e. staying at a fast Leslie speed until you are ready to return to a slow Leslie speed.
Behavior - this drop-down menu allows you to choose between Jump and Catch modes. When a widget is in Jump mode, moving the associated physical controller will cause the widget to immediately jump to the position of the controller. When a widget is in Catch mode, the widget will not respond to the associated physical controller until the controller's value matches the current value of the widget, at which point the widget will follow the controller. Note: if the Follow Hardware toggle button is turned on, this menu will change to Initial Behavior.
Follow Hardware - to enable this toggle button you must learn or manually assign a MIDI device and a CC message. This feature allows you set a widget to the last seen value of the hardware (pedal, slider, knob, etc.) when you switch to the rackspace that contains this widget.
Control mode - allows you to set the either absolute (default) or relative control mode for a widget. There are 4 different relative modes: Relative Offset, Signed 1 Bit, Signed 2 Bit, and Two's Complement.
Note: If you previously selected a MIDI control alias (using the drop-down button indicated with the red rectangle), the Control mode is managed in the Rig Manager. Refer to the Rig Manager chapter to learn more about the Rig Manager and various control modes.
Thru - by default, this toggle button is turned off, so a MIDI message learned by a widget will not be forwarded to plugins. Turn on this toggle button to send out the learned MIDI message to plugins. For example, you can both play a note and have that note turn on your Leslie effect as well.
Note: the Thru toggle button is new in Gig Performer 4.5. If you happen to use an older version of Gig Performer, a MIDI message that is learned by a widget will not be forwarded to plugins (all other unlearned messages will be available to plugins). However, learned MIDI messages can be forwarded using GPScript for these use cases. We recommend that you update to the latest version of Gig Performer.
Value tab:
Widget value - each widget has a range of 0 to 100. Note that this is a percentage, not an absolute value. For example, if the plugin parameter it is controlling has an absolute range from 0.0 to 1.0, then when the widget is at its "100" setting it is actually changing that parameter to 1.0 (i.e. 100% of 1.0). Value of widgets from the Buttons category (buttons, switches, and LEDs) can only be 0 or 100 - there is nothing in between and the only values that a button can emit are the values at those positions. Anything in between will be ignored. You can also directly enter values using MIDI numbers, by adding the letter "m" at the end of the value. For example, if you type in "64m", Gig Performer will interpret it as an exact value of 50.39 (roughly 50% of the maximum MIDI value of 127).
Default value - continuous widgets allow changing the default value, on others this value cannot be set. When you double-click on the widget (when not in Edit mode), the widget value is reset to the specified default value.
Scaled Value - this value is the actual value that is sent to the plugin parameter. The default scaling for a newly inserted widget is the same as the actual widget value, as shown by the triangle shape of the curve. Scaling is based on the defined curve; find out more about curves in the How to control the widget value scaling chapter.
Reverse button - inverts the current curve horizontally. For example, if your curve has a default linear shape where widget value 20 results in scaled value 20, click on the Reverse button will scale the widget value 20 to be sent out as the value 80.
Ignore variations - this option is disabled by default; when enabled, the selected widget will be excluded from variation changes and will instead remain at its current value. This is useful if you have, for example, several different variations that change the widget settings controlling effects such as phasing or flanging, but you want the widget controlling overall volume to remain constant.
Initial value on gig load (variation_name) (not available in the Global rackspace) - Gig Performer by default restores all widgets to their last positions in variations when a gig file is saved (the Last saved toggle button will be enabled in this case).
You can, however, click on the This value toggle button to take a snapshot of the current position of the selected widget so that it is that position that gets recalled and loaded instead. This can be useful if you are playing, for example, a song where the volume of your piano always starts softly but gets quite loud by the end. When you come back to that song again, you don't want the piano to still be loud - you want it to always start soft. The concept is that, even if you play around with widgets during the course of your live performance, when you next reload a gig file, your originally stored values will return.
Click on the Copy Current button (it is enabled only when the "This value" toggle button is enabled) to take another snapshot of the current widget position.
Additionally, clicking on the Also reset on rackspace activation toggle box resets the widget value to "This value" on the rackspace activation.
Note: Widget values are always automatically saved and reloaded in your gig file, per variation. By using the explicit load value, the current widget will be reset to a specific value when your gig loads, even if you later change it and save the gig file.
Advanced tab:
OSC/GPScript Name - allows you to set a name for use in GP Script and/or OSC.
Enable OSC - click on this toggle button to make the OSC/GPScript Name field also be available to OSC. For more information on OSC, click here.
Invert OSC value button - clicking on this button inverts the OSC value. Click again to revert.
Direct Addressable OSC (this section is only visible when the Enable Widget Direct OSC option is enabled in OSC Options and is intended for advanced control of remote devices):
•OSC Address - type in a valid OSC address of the remote device.
•Target - type in a valid target IP of the remote device and afterwards type in the listening port of the remote device. Clicking the Select... button allows you to easily select an OSC target from the list that must be previously set in OSC Options.
•Type - allows you to set the type of the argument for an OSC message (Default, Float, Integer, and String).
•Enable Widget Direct OSC - clicking on this toggle button allows you to send out widget values as OSC messages for external processing. Note: OSC Address and Target must be defined to allow this toggle button to be enabled.
Note: global widgets (widgets in the Global rackspace) have one additional setting - Global Parameter Assignment:
Refer to this chapter to learn how to use this setting.
Mapping section
The mapping section is used to connect widgets to plugin parameters:
Plugin - click on this drop-down to view the list of plugins in the current rackspace and then select the plugin you want the widget to control.
Open plugin button - click on this button to open the editor for the selected plugin.
Parameter - parameters are displayed only when a plugin is selected; select the one from the list of available controllable parameters that you want to have the widget control. Alternatively, you can search the parameter name by typing a partial parameter name or, even easier, use the Learn Parameter button.
Learn Parameter button - click on this button to have Gig Performer learn the plugin parameter you want to associate with the widget. This button is displayed only when a plugin is selected. When in Learn Mode, the button is lit red; to exit Learn mode, click on it again and it will return to its normal gray color.
Note: widget assignments to physical controllers in the Widget Properties area override assignments made in the Global MIDI Options.
Refer to the How to connect a widget to a plugin parameter chapter for more information on widget mapping and parameter learning.
