You can add markers at various points in a track in the Streaming Audio File Player to cause one or more actions to be triggered automatically as the playhead passes those markers. Double-clicking a marker symbol on the timeline or clicking on the Actions button opens the Action Management window:
This window allows you to manage actions for each marker. Actions allow you, for example, to switch rackspaces, switch songs, set widget values and captions, start or stop the Metronome, go to a specific position in your lyrics file, send MIDI events, or simply display a message in the main Gig Performer window.
Note: the Song Part Properties window also allows you to trigger actions when that song part is activated.
There are 21 action types supported, and they can be combined. All actions include the Comment field, where you can optionally include a hint for the desired action. This hint is shown in the 'Jump to action' combo box (indicated with the red rectangle).
All these action types will be described below.
1. Delay
The Delay action allows you to add a delay of up to 1000 milliseconds.
The intent of this action is to interact with external synthesizers that can't handle receiving multiple MIDI messages (such as bank select followed by program change or a program change followed by a CC message to adjust the volume) that arrive too quickly.
Note: this action is synchronous; all subsequent actions processing will be delayed as well.
2. Display Message
The Display Message action simply flashes the specified message in the main Gig Performer's window:
If there are multiple messages on a single marker, then only the last message will be displayed.
3. Go to ChordPro Marker
This action assumes that you have the marker directive defined in your ChordPro file, e.g. {marker: "verse2"}, as indicated with the red rectangle in the screenshot below:
In the Go to ChordPro Marker action you need to enter the marker name without quotes. When the playhead reaches this marker, it will move the ChordPro file to the specified position (in this example, to show Verse 2).
4. Metronome Click
This action allows you send a single metronome click.
Tick the Accent checkbox if you need to trigger an accented beat.
5. Metronome On/Off
This action starts the Gig Performer Metronome feature when the check box is ticked, or stops the Metronome when the checkbox is not ticked:
6. Playhead On/Off
When the check box is ticked, this action starts the Gig Performer Global playhead. When the checkbox is not ticked, the Global playhead stops playing:
7. Previous or Next
While the Panels view is displayed, this action allows you to go to the previous or next rackspace or variation.
If the Setlist view is displayed, this action allows you to go to the previous or next song or song part. Note that the check boxes are mutually exclusive, i.e. you cannot go to the next and previous rackspace simultaneously, and you cannot go to the next rackspace and the next variation simultaneously.
Note: this action is not available as a song part action.
8. SAFP - Go to Marker
This action allows you to jump to the desired marker that is specified in a Streaming Audio File Player block.
Note: this action is only available as a song part action.
9. SAFP - Select Track
This action allows you to select the desired track in the desired Streaming Audio File Player block.
10. SAFP - Track Operations
Supported track operations in this actions are Play, Stop, and Pause.
After you enter the SAFP handle, simply check the desired operation.
11. Send External Program Change
This action allows you to send a program change message with optional bank select messages to external hardware.
Type in the desired program change number and optionally select bank values (MSB and LSB). Afterward, specify the desired MIDI channel and a MIDI target. Supported targets are: Physical MIDI Out devices, Local GP Port, MIDI Out blocks with handles, MIDI In blocks with handles, Global MIDI Out blocks with handles and Global MIDI In blocks with handles.
If your plugin block is in the Global rackspace, be sure to check the Global Rackspace checkbox.
Note: this action is only available as a song part action.
12. Send MIDI Message
This action allows you to send a MIDI message to a specific block in a rackspace:
Supported MIDI messages are: Note On, Note Off, Control Change, Program Change, Aftertouch, Pitch wheel, Polytouch, SysEx, Song Position, Song select, Tune request, RT Timing clock, Start, Continue, Stop, and Reset.
Supported blocks are: Physical MIDI Out devices, Local GP Port, MIDI Out blocks with handles, MIDI In blocks with handles, Global MIDI Out blocks with handles and Global MIDI In blocks with handles.
Check the Use blocks in the Global Rackspace check box if your MIDI block is located in the Global rackspace.
13. Send OSC message
This action allows you to send the desired OSC message to the desired target (defined with the IP address and the port).
For example, if you add a label widget and give it the OSC name Text1, then you can easily change its caption to Hello Gig Performer users! using the OSC message in the screenshot above (provided that OSC is enabled in the OSC Options and that Gig Performer listens at the port 5000) when the playhead reaches the marker that contains this action.
An OSC message can contain an arbitrary number of integer, float or string arguments. You can trigger arbitrary GPScript functions from the timeline by sending OSC messages into Gig Performer scripts. That's why the Actions Management window can easily accommodate the most complex automation use cases.
14. Send Program Change
This action allows you to send a program change message to Gig Performer itself or an external device.
Simply type in the desired program change number and optionally select bank values (MSB and LSB); if you want to send a program change message to an external device, check the External check box and then specify the desired MIDI channel and a target. Supported targets are: Physical MIDI Out devices, Local GP Port, MIDI Out blocks with handles, MIDI In blocks with handles, Global MIDI Out blocks with handles and Global MIDI In blocks with handles.
Further, if you want to send a PC message to a block located in the Global rackspace, check the Global rackspace check box.
Note: this action is not available as a song part action.
15. Set Global BPM
This action allows you to set the desired Global BPM value:
You can select a value between 20 and 640.
16. Set Global Transpose
This action allows you to set the desired Global BPM value:
You can select a value between -48 and +48.
17. Set Plugin Parameter Value
This action allows you to set a plugin's parameter value directly, i.e. without using widgets.
Enter the plugin's handle, select the desired parameter from the list, and then specify the desired value for that parameter.
If you want to bypass the selected plugin, check the Bypass check box.
18. Set Widget Caption
This action allows you to set the caption of any widget:
To set a widget caption, you must first define a widget handle, i.e. the OSC/GPScript name in the Advanced tab from the Widget Properties Inspector. If the widget is located in the Global rackspace, make sure to click on the Global check box.
19. Set Widget Value
This action allows you to set the desired widget value:
To set a widget value, you must first define a widget handle, i.e. the OSC/GPScript name in the Advanced tab from the Widget Properties Inspector.
If the widget is located in the Global rackspace, click on the Global check box. Tick the Reset if momentary check box if your widget is set to be 'Momentary' in the Widget Properties inspector and you want to reset its value.
20. Switch to Rackspace
This action allows you to switch to the desired rackspace:
Simply select the desired rackspace and variation from the combo boxes. The selected rackspace and variation will be displayed in yellow color.
Note: this action is not available as a song part action.
21. Switch to Song
This action allows you to switch to the desired song:
Select the desired song and song part from the combo boxes (the first song part is selected by default).
By default, songs from the current setlist will be displayed. If you want to display all songs (from the All Songs setlist), check the All songs checkbox. The selected song and song part will be displayed in yellow color.
Note: this action is not available as a song part action.
Every action has these common controls:
These controls allow you to remove an action, duplicate an action (in case you want to add similar actions, such as sending multiple MIDI messages), move an action up, move an action down, and enable an action. If you want to disable an action, untick the check box.
Note: you can also define action in the Song Part Properties window. Refer to this chapter to learn more.
