CueServer 2 User's Manual

Update Group

Syntax

Command Description Return Value
Update [options] Group <group number> Updates group group number The group number updated
  • <group number>
    • Any whole number from 0 to 99999
  • [options]
    • Selection:
      • All adds all channels to the group
      • Empty removes all channels from the group
      • Selected changes the group to contain only the currently selected channels; this is the default
      • Active changes the group to contain only the currently active channels
    • Source:
      • Input causes active channels in the DMX Input to be used as the template for the group
      • Playback n causes active channels in Playback n to be used as the template for the group
      • Live causes active channels in the special Live playback fader to be used as the template for the group
    • Metadata:
      • Name s sets the Name to s
    • Other:
      • Merge add channels without modifying other existing channels in the group

Abbreviation

UP U or UP GR

Description

The Update Group command updates the channels in a group to the currently selected channels.

If no group with the group number exists, a new group will be created. Use this command to change the DMX channels stored in a group without loosing any of the other properties recorded in the group (such as the name).

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

Record Group Options

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

All
If this option is used, then the updated group will be created containing every DMX channel. When this group is recalled, it will select all DMX channels.

Empty
If this option is used, then the updated group will be created containing no DMX channels. When this group is recalled, it will deselect all DMX channels.

Selected
If this option is used, then the updated group will be created containing the currently selected DMX channels. This is the default option, so specifying it is redundant.

Active
If this option is used, then the updated group will be created containing only the currently active DMX channels. When updating from the DMX output or input, active channels are any channels that have a non-zero value. When updating 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 group will be recorded by using only non-zero values from the DMX Input.

Playback n
If this option is used, then the updated group will be recorded by using only active values from the specified playback fader.

Live
If this option is used, then the updated group will be recorded by using only active values from the special Live playback fader.

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

Merge
If this option is used, the updated channels are added to the group without disturbing other existing channels in the group that are not part of the current selection. For instance, if a group previously contained channels 1>10 and only channel 20 is updated with the merge option, then channel 20 is added to the group without removing channels 1>10.

Examples

Update Group 1
Stores (updates) the currently selected channels into Group 1.

Record Name "Hello" Group 2
Stores (updates) the currently selected channels into Group 2 while changing the name to “Hello”.

Channel 1>10
Update Group 2
Stores (updates) Channels 1 through 10 into Group 2.

See Also