CueServer 2 User's Manual

Record Group

Syntax

Command Description Return Value
Record [options] Group <group number> Records group group number The group number recorded
  • <group number>
    • Any whole number from 0 to 99999
  • [options]
    • Selection:
      • All causes all DMX channels to be recorded
      • Empty causes no DMX channels to be recorded into the group
      • Selected causes only the currently selected DMX channels to be recorded into the group; this is the default
      • Active causes only active DMX channels to be recorded into the group
    • 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 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

R U or R GR

Description

The Record Group command creates a new group from the currently selected channels.

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

Record Group Options

Several options are available to change how a group 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 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 new 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 new 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 new group will be created containing only the currently active DMX channels. 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 group will be recorded by using only values from the DMX Input.

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

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

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

Merge
If this option is used, the recorded channels are stored in 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 recorded with the merge option, then channel 20 is added to the group without removing channels 1>10.

Examples

Record Group 1
Records the currently selected channels as Group 1.

Record Name "Hello" Group 2
Records the currently selected channels as Group 2 with the name “Hello”.

Channel 1>10
Record Group 2
Records Channels 1 through 10 as Group 2.

See Also