Syntax

Command Description Return Value
Length <playback time> Sets the current streaming cue’s playback length The playback length set
Length ? Returns the current streaming cue’s playback length The current playback length
  • <playback time>
    • A decimal number of seconds (optionally using decimal digits for fractions of seconds)
    • 0 means not to override the cue’s playback length (this is the default)
    • A whole number proceeded by a # specifies a number of frames instead of seconds

Abbreviation

LEN

Description

Setting a Streaming Cue’s Playback Length

Use the Length command to set the playback length for playing back a streaming cue. This time is used to adjust the duration of a streaming cue before it begins playing back. For instance, if a stream is recorded too long, a shorter playback length can be given to have the stream stop playing at the proper place in the cue. The Length command must be issued after the cue is selected but before the corresponding Go command is issued. For example, Cue 1 Length 5.5 Go.

If a playback length is specified that is shorter than the recorded length of the cue, then the cue will stop (or loop, or follow, etc.) at the specified time, which will be before the recorded data in the cue is finished playing back. If a playback length is specified that is longer than the recorded length of the cue, then there will be a delay after the end of the recorded data before the cue will stop (or loop, or follow, etc.).

Playback times are normally expressed in seconds. By using a pound-sign (#) before the value allows the playback time to be expressed in fames. A frame is 1/40th of a second and is the smallest unit of time that streaming cues are recorded in.

Determining The Current Playback Time

Use the Length command with the question mark (?) to return the current playback time. A playback time such as 5 or 1.025 will be returned.

Examples

Length 1
Sets the current streaming cue’s playback time to 1 second.

Cue 4 Length 8.075 Go
Loads cue 4, then sets its playback time to 8.075 seconds, and then begins playing the cue.

Cue 17 Offset #1 Length 3.5 Go
Loads cue 17, then sets its offset time to 1 frame (0.025 seconds) seconds, then sets the playback length to 2.5 seconds, and then begins playing the cue.

See Also