Show Cue Expressions

Each Cue you add to a show track can have its own set of expressions which apply to that cue, allowing you to take actions when some player moves into or out of that cue, if the cue starts playing on its first beat or from some point later within the cue, or if it stops playing.

The cue expressions can be accessed from the cue’s context menu. Cues have access to the same globals and locals atoms, and show and track values that track expressions in the cue’s track do. They also can use a cue value that contains everything Beat Link Trigger knows about the cue, and individual kinds of expressions will automatically have other values available to them which make sense in the context in which the expression is used.

The help text below the expression editor will list and explain the values that are automatically available for use in that kind of expression.

Entered Expression

Called when the cue’s track is enabled, and the first player moves inside the cue (in other words, the playback position of at least one player that has the cue’s track loaded is within the beat range that defines the cue).

If you want this expression to run, make sure the cue’s Entered Message menu is set to Custom.

There can be multiple players inside the cue at any given moment, but this expression will be called only when the first one enters it.

If the track is disabled, no players will be considered to be inside any of its cues.

Started On-Beat Expression

Called when the first player that is playing the track moves into the cue, as long as it does so right at the beginning of the cue, and hits the start of the first beat that defines the cue.

If you want this expression to run, make sure the cue’s On-Beat Message menu is set to Custom.

There can be multiple players playing the cue at any given moment, but this expression will be called only when the first one enters it.

If the track is disabled, no players will be considered to be playing any of its cues.

Started Late Expression

Called when the first player that is playing the track moves into the cue, but misses the beginning of the cue, either because the DJ jumped into the middle of the cue, or because the player was paused somewhere in the middle of cue and then started playing, or because the Track was disabled when the cue was entered from the beginning and became enabled somewhere in the middle of the cue.

If you want this expression to run, make sure the cue’s Late Message menu is set to Custom.

There can be multiple players playing the cue at any given moment, but this expression will be called only when the first one enters it.

If the track is disabled, no players will be considered to be playing any of its cues.

Beat Expression

Called whenever a beat packet is received from a player that is playing inside this cue, as long as the track is enabled. (This is not called for the first beat of the cue; when that is played, the Started on-Beat expression is called instead.)

Tracked Update Expression

Called whenever a status update packet is received from a player whose playback position is inside this cue (as long as the track is enabled), after the Entered or Started expression, if appropriate.

Ended Expression

Called when the last player that was playing the cue either leaves it or stops playing. There can be multiple players playing the cue at any given moment, and this expression will be called as soon as there are none left.

For this expression to run for cues that started on time, the On-Beat Message menu needs to be set to Custom. Similarly, if you want it to run for cues that started late, the Late Message menu must be set to Custom. If you are using custom messages for both situations and you need to be able to tell them apart, have the Started On-Beat and Started Late expressions each set a different value in an expression local to let you know which ran.

If the track becomes disabled while it was playing this cue, this expression will be called at that point as well.

Exited Expression

Called when the last player that was inside the cue leaves it. There can be multiple players positioned in the cue at any given moment, and this expression will be called as soon as there are none left.

If you want this expression to run, make sure the cue’s Entered Message menu is set to Custom.

If the track becomes disabled while there were players positioned inside this cue, this expression will be called at that point as well.