Insert, change, move or remove one macro line (never runs it)
gma3_edit_macro_lineEdit grandMA3 macro lines by inserting, setting, moving, or removing commands in order, with batch edits, read-back verification, and refusal of locked or running macros.
Instructions
action insert (line 1..count+1, needs command), set (any of command, wait, enabled, add_to_cmdline, execute, name, note), move (line -> to; sent as upward moves only, because a downward Move lands one place short), remove. References in a written command are checked unless raw: true. Refuses a locked or running macro. Every line is read back and compared with the expected order and content; accept_console_form as in gma3_store_macro. Never runs the macro. Batch form (edits): the edits run in order, each against the macro as the earlier edits left it (line numbers shift after an insert, move or remove); once an edit on a macro does not succeed, the later edits on that macro are not attempted. Batch form: give the list instead of the single object's fields; the other arguments are defaults for every item (an item's own fields win). Each item gets the single form's checks and read-back, and its own outcome; items run in order, nothing is retried, an unknown outcome stops the rest, and the result has one line per item (detail: true for every step).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | ||
| raw | No | ||
| line | No | Required unless edits is given. | |
| name | No | ||
| note | No | ||
| wait | No | ||
| edits | No | Batch form: several edits in order, each {macro, action, line, ...}; macro may be given once for all. | |
| macro | No | Macro number. Required unless edits is given (it may then be a default for every edit). | |
| action | No | Required unless edits is given. | |
| detail | No | Return every item's full result with its steps (default false: one line per item). | |
| verify | No | ||
| command | No | ||
| enabled | No | ||
| execute | No | ||
| preview | No | ||
| data_pool | No | Data pool number (DataPool n). Default: the current data pool, as without this parameter. | |
| add_to_cmdline | No | ||
| 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). | |
| accept_console_form | No | ||
| allow_unresolved_dependents | No | Edit even when a later line uses an object this edit stops an earlier line from storing (default false: refuse). |