Update Cue

Syntax

Command	Description	Return Value
`Update [options] Cue <cue number>`	Updates the DMX channels in cue cue number	The cue number updated

<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 updated
  - Empty causes all DMX channels to be removed from the cue
  - Selected causes the currently selected DMX channels to become the DMX channels in the cue
  - Active causes only active DMX channels to become the DMX channels in 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:
  - Merge causes the selected or active channels to be merged with the cue’s current content (not applicable with All or Empty modes)
  - Stack s record into Stack s

Abbreviation

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

Description

Updating Cues

The Update Cue command updates the DMX channels of a normal cue. Use this command to change the DMX channels stored in a cue without changing any of the other properties recorded in the cue (such as the fade and follow time, link, and rules).

By default, any channels currently recorded in the cue are updated.

If no cue with the cue number exists, a new cue will be created. If a cue with the cue number already exists, only the cue’s DMX channels will be updated by using this command. All other cue parameters will not be affected.

Update Cue Options

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

Empty
If this option is used, then the updated cue will contain 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 updated cue will contain 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 updated cue will contain 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 updated 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 updated 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 updated 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 updated cue will be recorded with a Fade Time of t.

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

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

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

Merge
If this option is used, then the channels being updated will be merged into the cue without disturbing other channels already existing in the cue.

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

Examples

Update Cue 1
Stores (updates) the current output from the CueServer into Cue 1.

Update Fade 3 Name "Hello" Cue 1
Stores (updates) the current output from the CueServer into Cue 1 while changing the Fade Time to 3 seconds and the name “Hello”.

Update Empty Cue 2
Removes the DMX channels from Cue 2.

Update Selected Cue 3
Stores (updates) the currently selected DMX channels into Cue 3.

Update Active Input Cue 5.1
Stores (updates) only the active channels from the DMX Input as Cue 5.1.

Update Selected Playback 7 Cue 1.23
Stores (updates) the currently selected channels from Playback 7 as Cue 1.23.

Update Active Playback 1 Stack "Test" Cue 101.5
Stores (updates) only the active channels from Playback 1 into Cue 101.5 in the cue stack named “Test”.

Channel 1>10
Update Selected Cue 4
Stores (updates) Channels 1 through 10 as the only channels into Cue 4.

Channel 11>20
Update Selected Merge Cue 5
Stores (updates) Channels 11 through 20 into Cue 5 without disturbing any other previously recorded channels in the cue.