build_preset_palette
Build a preset palette for color, beam, or focus by combining per-fixture-type attribute values into multiple targets within each preset.
Instructions
Build a preset palette of any type from per-fixture-type value sets.
Generalizes color/beam/focus palette building: each preset carries one or
more targets (fixture selections), each with its own attribute values. The
first target uses ``scope``; subsequent targets of the same preset merge
(per-fixture-type accumulation into one preset).
Args:
preset_type: "color", "beam", "focus", "dimmer", "position", ...
presets: list of {id, name?, by_target: [{target, attrs}]} where target
is a selection command (e.g. "Fixture 101 Thru 128") and attrs is a
list of [attribute, value] pairs.
scope: "global" (default), "selective", or "universal".
merge: if True the first target also merges (extend an existing preset).
label: apply each preset's name as its label.
Returns:
str: Operation result message
Examples:
- Beam strobe across types: preset_type="beam", presets=[{"id":3,"name":"Strobe","by_target":[{"target":"Fixture 401 Thru 428","attrs":[["SHUTTER",50]]},{"target":"Fixture 201 Thru 215","attrs":[["MASTERSHUTTERSTROBE",21]]}]}]
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| preset_type | Yes | ||
| presets | Yes | ||
| scope | No | global | |
| merge | No | ||
| label | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |