The **Device Control Widget** (`device-control`) provides dedicated tactile mixing and parameter adjustments for physical lighting fixtures.

![Beams Device Control](https://unilighter.cc/info/docs/dashboard/widget-device-control/widget_device_control_beams_fed8332f.png)

---

## 🏷️ Control Modes: Tags vs Individual Devices

The widget operates in two primary modes:
- **[Tag Mode](https://unilighter.cc/info/for-ai/docs/tags.md)** (e.g. `#Beams`, `#Washes`, `#Pars`): Commands sent through the widget are broadcast to all fixtures sharing the tag simultaneously.
- **Device Mode**: Dedicated individual control over a specific fixture head.

![Washes Device Control](https://unilighter.cc/info/docs/dashboard/widget-device-control/widget_device_control_washes_7a0fd114.png)

---

## 🎛️ Core Control Modules

The Device Control widget integrates specialized interactive [UI Controls](https://unilighter.cc/info/for-ai/docs/controls.md):

1. **Intensity ([Fader](https://unilighter.cc/info/for-ai/docs/controls/fader.md))**: Smooth vertical fader for master dimmer adjustment.
2. **Strobe ([Fader with Presets](https://unilighter.cc/info/for-ai/docs/controls/fader.md))**: Strobe shutter speed fader with quick-jump percentage buttons (`100%`, `90%`, `75%`, `50%`, `25%`, `0%`).
3. **2D Position ([XY Pad](https://unilighter.cc/info/for-ai/docs/controls/xy-pad.md))**: Crosshair touch surface for Pan/Tilt targeting with saved position presets (*Center Focus*, *Fan Out*, *Skyward*, *Cross Beams*).
4. **Color Mixing ([Color Picker](https://unilighter.cc/info/for-ai/docs/controls/color-picker.md))**: Full-spectrum RGB/HSL color wheel with white balance calibration and saved palette swatches.
5. **Motorized Gels ([Color Wheel](https://unilighter.cc/info/for-ai/docs/controls/color-wheel.md))**: 28-gel color swatch grid for fixtures with physical color wheels.

---

## 🚨 Border Indicators & Priority Feedback

The widget provides real-time visual feedback reflecting the console's **[Priority System](https://unilighter.cc/info/for-ai/docs/priorities.md)**:

### 🔴 Red Border: Active Manual Control (`has-control`)
![Red Border Active Control](https://unilighter.cc/info/docs/dashboard/widget-device-control/state_has_control_red_c65b547c.png)
- Indicates that the operator currently holds manual control over this parameter at priority `100`.
- Click the **Release** (`X`) button to release priority and return control to background scenes or node graphs.

### 🟡 Yellow Border: Inconsistent Tagged State (`inconsistent-value`)
![Yellow Border Inconsistent State](https://unilighter.cc/info/docs/dashboard/widget-device-control/state_inconsistent_yellow_e9d4987c.png)
- Appears when fixtures belonging to this tag have differing values (e.g., individual lights were adjusted separately).
- Displays a badge indicating how many devices match the current control position (e.g. `1/4`). Moving the control synchronizes all fixtures.