assign_appearance
Assigns a color appearance (frame/background) to grandMA2 pool objects or cues using RGB, HSB, hex, or by copying from another object, or resets to default.
Instructions
Assign an appearance (frame/background color) to a grandMA2 pool object or cue.
Colors can be specified via RGB (0-100), HSB (hue 0-360, sat/bright 0-100),
hex color string, or by copying from a source object. Use reset to clear.
Args:
object_type: Object type (e.g., "group", "cue", "preset", "macro")
object_id: Object number or compound ID (e.g., 1 or "0.1")
end: (Optional) End ID for applying to a range of objects
source_type: (Optional) Source object type to copy appearance from
source_id: (Optional) Source object ID to copy appearance from
reset: Reset appearance to default
color: Hex color code (e.g., "FF0000") or gel name
red: Red component (0-100)
green: Green component (0-100)
blue: Blue component (0-100)
hue: Hue (0-360)
saturation: Saturation (0-100)
brightness: Brightness (0-100)
Returns:
str: Operation result message
Examples:
- Set group 1 to red: object_type="group", object_id=1, red=100, green=0, blue=0
- Set preset 0.1 to hex color: object_type="preset", object_id="0.1", color="FF0000"
- Copy appearance from macro 13 to macro 2: object_type="macro", object_id=2, source_type="macro", source_id=13
- Reset group 1 appearance: object_type="group", object_id=1, reset=True
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| object_type | Yes | ||
| object_id | Yes | ||
| end | No | ||
| source_type | No | ||
| source_id | No | ||
| reset | No | ||
| color | No | ||
| red | No | ||
| green | No | ||
| blue | No | ||
| hue | No | ||
| saturation | No | ||
| brightness | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |