Offset

Syntax

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

Abbreviation

None

Description

Setting a Streaming Cue’s Offset Time

Use the Offset command to set the offset time for playing back a streaming cue. This time is used to adjust the starting point of a streaming cue before it begins playing back. For instance, if a stream is recorded one second too early, an offset time of one second can be given to have the stream start playing at the proper place in the cue. The Offset command must be issued after the cue is selected but before the corresponding Go command is issued. For example, Cue 1 Offset 1.3 Go.

Offset times may be either positive or negative. Positive offset times move the playback pointer into the streaming cue data, starting the stream already somewhat into the recorded data. Negative offset times move the playback pointer to a time before the beginning of the streaming cue data, causing a delay before the recorded data plays back.

Offset times are normally expressed in seconds. By using a pound-sign (#) before the value allows the offset 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 Offset Time

Use the Offset command with the question mark (?) to return the current offset time. An offset time such as 5 or 1.025 will be returned.

Examples

Offset 1
Sets the current streaming cue’s offset time to 1 second.

Cue 4 Offset 0.075 Go
Loads cue 4, then sets its offset time to 0.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