Write the recipe lines of many cues
gma3_store_recipe_cuesWrite standard recipe lines for up to 100 cue parts in one call, using replace or append mode, with batch results and optional cooking of the written parts.
Instructions
Write the standard recipe lines of up to 100 cue parts of one sequence in one call (at most 200 lines per part, 500 per call; a larger build is several calls). cues: [{cue, part? (default 0), name?, note?, lines: [{selection: group, values: "N.M" preset, matricks?, name?, enabled?, selection_mode?, x?/y?/z?: {wings, blocks, groups, width, shift, shuffle, select, fade/delay/phase/speed: {from, to}}}]}]. mode is required: replace deletes every line of the part first (refused while the part holds phaser lines), append adds after the existing ones. The cues must exist (gma3_store_cues creates them); name is the cue's name (Part 0), note its Note. Once for the whole call, before anything is sent: every cue part is read and every group, preset and MAtricks a line names must be in the show. Each line is written as gma3_edit_recipe adds one (Assign Group, Preset and MAtricks At the line, set for the other fields and the per-line MAtricks columns), and every reply is checked. Batch form: each cue part is an item: its steps stop at its first failure, the parts already written stay (nothing is undone or retried), an unknown outcome stops the rest, and its read-back is compact: the line count, then only mismatches (every field written, earlier lines unchanged on append, name, note). The console cooks each written line by itself (merge low priority). cook: a gma3_cook_recipes mode cooks every part afterwards, only when every part was written and matched (replace_uncooked and verify_cook as in gma3_cook_recipes). preview: true checks and returns the plan (detail: true every request). Phaser recipe lines are not written. Needs bridge 0.24.0.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cook | No | Cook every written part with this gma3_cook_recipes mode afterwards. | |
| cues | Yes | Cue parts and their lines, in order. | |
| mode | Yes | ||
| detail | No | Return every item's full result with its steps (default false: one line per item). | |
| preview | No | ||
| sequence | Yes | ||
| verify_cook | No | With cook: read every cooked part back (default true). | |
| stop_on_failure | No | Batch form: stop at the first item that does not succeed (default false: independent items go on; an item on an object an earlier item failed on is skipped either way). | |
| replace_uncooked | No | With cook merge/overwrite: allow replacing or deleting uncooked values (default false: that part's cook is refused). |