Palettes¶
User Palettes are objects that store reusable parameter values for all fixtures associated with the palette.
Palette fields¶
| Field | Type | Meaning | Notes |
|---|---|---|---|
section |
Integer | Parameter category to which the palette belongs. | Observed categories distinguish intensity and colour; the complete mapping is not yet documented. |
user_palette_id |
Integer | Identifier for this palette within the show. | Referenced by palette_id in its orders |
name |
String | Name shown in the palette interface. | |
icon |
String | Icon or icon reference displayed for the palette. | |
orders |
Array of maps | Fixture-parameter values recorded in the palette. | Refer to the Palette order fields section below. |
Palette order fields¶
An order associates one patched fixture and function type with a stored value for one palette.
| Field | Type | Meaning | Notes |
|---|---|---|---|
palette_id |
Integer | Associates the order with its parent palette. | Expected to match user_palette_id. |
universe |
Integer | Universe that the fixture presides in | |
section |
Integer | Parameter category for this order. | Used alongside the palette-level section. |
receptor_type |
Integer | Identifies the kind of target or receptor for the value. | Known values include 0 and 1, but their full meanings are unknown. |
patch_id |
Integer | Fixture receiving the value, referenced by ID | |
ftype |
Integer | Fixture function/parameter affected by the value. | |
value |
Integer | Stored parameter level. | |
channel |
Integer | Channel used by the affected parameter |
Example
A palette affecting 10 RGBA fixtures can contain 40 orders: one order for each red, green, blue, and amber function on every fixture.