Record Cue

Syntax

Command	Description	Return Value
`Record [options] Cue <cue number>`	Records cue cue number	The cue number recorded

<cue number>
- Any whole number from 0 to 99999
- May optionally contain decimal numbers from .00 to .99

[options]
- Selection:
  - All causes all DMX channels to be recorded; this is the default
  - Empty causes no DMX channels to be recorded into the cue
  - Selected causes only the currently selected DMX channels to be recorded into the cue
  - Active causes only active DMX channels to be recorded into the cue
- Source:
  - Input causes the DMX Input to be recorded
  - Playback n causes only the channels from Playback n to be recorded
  - Live causes only the channels from the Live playback to be recorded
- Metadata:
  - Fade t sets the Fade Time to t
  - Follow t sets the Follow Time to t
  - Link n sets the Link Cue number to n
  - Name s sets the Name to s
- Other:
  - Stack s record into Stack s
  - Merge record channels without modifying other existing channels in the cue

Abbreviation

R [ ALL, EMPTY, SEL, ACTIVE, IN, P n, STACK s ] Q

Description

Recording Cues

The Record Cue command records (or re-records) a normal cue.

By default, all channels being output from the CueServer are captured into the new cue. Use the command options to change which channels and what source the channels are recorded from.

If no cue with the cue number exists, a new cue will be created. If a cue with the cue number already exists, it will be deleted first and replaced with an entirely new cue. To re-record just the DMX channels without affecting the other cue parameters, use the Update Cue command instead.

Record Cue Options

Several options are available to change how a cue is recorded. More than one option may be used, and they can be listed in any order.

All
If this option is used, then the new cue will be created containing all DMX channels. When this cue is played back, it will affect every DMX channel.

Empty
If this option is used, then the new cue will be created containing no DMX channels. When this cue is played back, it will have no affect on any DMX channels, but it will still behave like a normal cue with follow timing and rules.

Selected
If this option is used, then the new cue will be created containing only the currently selected DMX channels. Using this option, cues can be created that only affect specific channels when being played back.

Active
If this option is used, then the new cue will be created containing only the currently active DMX channels. Using this option, cues can be created that only affect specific channels when being played back. When recording the DMX output or input, active channels are any channels that have a non-zero value. When recording from one of the Playbacks, active channels are any channels active in the playback (including zero value channels).

Input
If this option is used, then the new cue will be recorded by using only values from the DMX Input. The playback faders and DMX output will not be recorded.

Playback n
If this option is used, then the new cue will be recorded by using only values from the specified playback fader. The DMX input and output will not be recorded.

Live
If this option is used, then the new cue will be recorded by using only values from the special Live playback fader. The DMX input and output will not be recorded.

Fade t
If this option is used, then the new cue will be recorded with a Fade Time of t.

Follow t
If this option is used, then the new cue will be recorded with a Follow Time of t.

Link n
If this option is used, then the new cue will be recorded with a Link Cue of n.

Name s
If this option is used, then the new cue will be recorded with a Name of s.

Stack s
If this option is used, then the new cue will be recorded into Stack s. This option overrides the stack chosen in the current playback fader.

Merge
If this option is used, the recorded channels are stored in the cue without disturbing other existing channels in the cue that are not part of the current selection. For instance, if a cue previously had values for channels 1>10 and only channel 1 is recorded with the merge option, then channel 1 is updated to the new value without changing the values for channels 2>10.

Examples

Record Cue 1
Records the current output from the CueServer as Cue 1.

Record Fade 3 Name "Hello" Cue 1
Records the current output from the CueServer as Cue 1 with a Fade Time of 3 seconds and the name “Hello”.

Record Empty Cue 2
Records Cue 2 with no DMX channels.

Record Selected Cue 3
Records the currently selected DMX channels as Cue 3.

Record Active Input Cue 5.1
Records only the active channels from the DMX Input as Cue 5.1.

Record Selected Playback 7 Cue 1.23
Records the currently selected channels from Playback 7 as Cue 1.23.

Record Active Playback 1 Stack "Test" Cue 101.5
Records only the active channels from Playback 1 into Cue 101.5 in the cue stack named “Test”.

Channel 1>10
Record Selected Cue 4
Records Channels 1 through 10 as the only channels in Cue 4.