Store a cue part
gma3_store_cue_partStores programmer content into a cue part using create, merge, or overwrite mode, sets optional name and timing fields, and verifies the result by reading it back.
Instructions
Store the programmer content into a part of a cue (Store Sequence n Cue c Part p). Part 0 is the main part that every cue has, so storing to part 0 is the same as storing the cue; parts 1..999 hold values with their own timing. Sends one Store command (/NoConfirmation; /Merge or /Overwrite for those modes), then one Set() per given name/timing field on the part (part 0 for a cue): Name, CueInFade (fade), CueInDelay (delay), CueOutFade, CueOutDelay. Mode create first checks that the target does not exist and refuses (nothing sent) if it does; that check is a point-in-time read, not a transaction lock. The current fixture selection is not changed; the programmer is not cleared (no Clear is sent). Reads back existence, Name and the timing fields that were given; the store step and the read-back are reported separately. Stored fixture values (attribute data) are NOT verified; that needs gma3_cue_contents (FR-10). The mutation lock orders only this server's own mutations; it does not isolate the operation from another console operator or another client.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cue | Yes | One cue number, fractional allowed (2, 2.5, "10.001"; max three decimals). Ranges (Thru, +) are rejected. | |
| fade | No | Cue (in) fade time in seconds; 0 is a value. Part property CueInFade. | |
| mode | Yes | create: refuse if the part exists. merge: /Merge. overwrite: /Overwrite. Exactly one mode. | |
| name | No | Part name. Names must not contain any of \ " $ & * ? , . ; ^ { } | ~ (the console strips them) and are trimmed; they are set via the Name property of the part after the store. | |
| part | Yes | Part number 0..999. 0 is the cue's main part (always exists once the cue exists); mode create therefore refuses part 0 of an existing cue. | |
| delay | No | Cue (in) delay time in seconds; 0 is a value. Part property CueInDelay. | |
| verify | No | Read the result back after the mutation (default true). Verification is reported separately from the mutation steps. | |
| out_fade | No | Out fade in seconds (dimmers going down); 0 is a value. Part property CueOutFade. | |
| sequence | No | Sequence number (1..99999). Required unless use_selected_sequence is true; exactly one of the two. | |
| data_pool | No | Data pool number (DataPool n). Default: the current data pool, as without this parameter. | |
| out_delay | No | Out delay in seconds; 0 is a value. Part property CueOutDelay. | |
| use_selected_sequence | No | Act on the console's currently selected sequence. It is resolved to its sequence number first, and the command is sent with that explicit number. |