Skip to content

Patches

The Patching segment contains the fixtures added to a show. Each patch links a fixture instance to a model, gives it a show-local identity and display position, and records its addressing and operator settings.

Patch fields

Field Type Meaning Notes
model_id Integer Selects the fixture' definition 'based on model_id
inverse_tilt Boolean Reverses the fixture's tilt control.
name String Fixture name.
channels_ftype Array of integers Function-type (ftype) identifier for each channel exposed by the patch. Values correspond to the model's parameter ftype values.
index Integer Index of the patch within the patch collection (0-indexed)
frozen Collection Per-fixture or per-channel freeze state. Freezing prevents normal playback changes from affecting the selected fixture. Only empty collections have been observed, so populated contents remain unknown.
universe Integer Output universe assigned to the fixture.
description String Description of the fixture.
inverse_pan Boolean Reverses the fixture's pan control.
visual_id Integer Position of patch in the Patches tab on the Lightshark software UI
parked Boolean Indicates whether the fixture is parked. Parking holds a fixture or individual channel at a chosen programmer value. Typically false
color_mark Unknown scalar Unknown Unknown
dimmer Number Stored dimmer-related value. Observed as the floating-point value 0.0; its operational purpose is unresolved.
swap_pan_tilt Boolean Exchanges the fixture's pan and tilt controls.
virtual_dimmer Array of integers Channel indexes controlled by the synthesized dimmer. Empty for fixtures that do not use a virtual dimmer.
id Integer Patch identifier referenced by groups, palettes, cues, and FX data.
size Integer Number of DMX channels used by the patch.