Playbacks¶
A playback assigns a cuelist to a fader or executor and records how that control behaves when loaded, moved, flashed, or when its page becomes active. It also contains chase timing and XCT-related assignments.
Playback fields¶
| Field | Type | Meaning | Notes |
|---|---|---|---|
fader_value |
Integer | Stored position or level of the playback fader. | Observed range is compatible with 0–255. |
on_load_play |
Boolean | Starts the playback when the show or playback is loaded. | |
fader_mode |
Integer | Selects the operating mode of the fader. | Enum values are not yet mapped. |
chase |
Boolean | Enables chase behavior for this playback. | |
index |
Integer | Playback position on the UI. | Note: Each page stores up to 30 playbacks. |
ms_chase_time |
Integer | Chase interval in milliseconds. | |
fader_up_play |
Boolean | Starts playback when the fader is raised. | |
priority |
Integer | Playback priority used when output values compete. | Mapping undocumented. |
bpm_chase |
Integer | Chase speed in LightShark's scaled BPM representation. | |
on_page_stop |
Boolean | Stops the playback when its page becomes inactive. | |
trigger_level |
Integer | Unknown | |
is_executor |
Boolean | Marks this playback as an executor rather than a normal fader playback. Can then be played in the Executors page on the software. |
|
pcrossfade |
Integer | Crossfade percentage | Up to 0.001% precision allowed |
ms_fadeout |
Integer | Playback-level fade-out time in milliseconds. | Not sure how it links with cue and cuelist timings. |
fader_down_stop |
Boolean | Stops playback when the fader reaches its lower position. | |
ignore_swap |
Boolean | Exempts the playback from a swap operation. | |
swap_always |
Boolean | Makes the playback participate in swap behavior persistently. | Interaction with ignore_swap requires verification. |
ignore_grand_master |
Boolean, optional | Exempts the playback from the grand master. | This field is not present in every playback record. |
ms_fadein |
Integer | Playback-level fade-in time in milliseconds. | |
ms_crossfade |
Integer | Playback-level crossfade time in milliseconds. | |
on_page_play |
Boolean | Starts the playback when its page becomes active. | |
xct_color |
Array | Colour or state information for XCT controls. | Empty or six-element forms have been observed; XCT semantics are unresolved. |
cuelist |
Integer | Cuelist assigned to this playback. | xFF seems to represent an empty playback(?) |
xct_push_mode |
Array of booleans | Push-mode flags for XCT controls. | Six-element forms likely correspond positionally to the other XCT arrays. |
docked |
Boolean | Indicates that XCT controls are docked or configured. | Correlates with populated XCT data. |
used_in_alarm |
Boolean | Indicates that the playback participates in an alarm or schedule action. | Exact integration remains to be documented. |
xct_cuelist |
Array of integers | Cuelist assignments for XCT controls. | 255 appears to represent an unassigned XCT slot. |
page |
Integer | Playback page index. | Appears to be 0-indexed. |