In traditional DMX consoles, color mixing is often treated as simple raw byte transmission: sliders send values from 0 to 255 directly to physical LED diodes. But on real concert stages and theater sets, this primitive approach breaks down. Different manufacturers use different LED binning, older fixtures suffer from phosphor decay, and mixing RGB with a dedicated White LED (RGBW) can wash out rich theatrical pastels.

Unilighter incorporates an advanced, perceptual Color Engine that decouples user interaction from physical diode channels, provides five mathematical RGBW translation strategies, and offers per-fixture and per-head hardware calibration.

Unilighter Color Calibration Card - Hardware diode trimming with Red, Green, and Blue sliders (0.000 to 1.000) and Reset to Default


🎨 Decoupled Perceptual Color Model

Rather than storing raw DMX channel numbers, Unilighter's internal color engine operates in normalized float HSV space (h: 0.0–1.0, s: 0.0–1.0, v: 0.0–1.0):

  • Hue (\(H\)): Represents pure chromatic color on the 360° color wheel.
  • Saturation (\(S\)): Represents color purity from pure white (\(0.0\)) to fully saturated chromatic color (\(1.0\)).
  • Value (\(V\)): Represents the relative brightness level before master dimmer attenuation.

Because color is abstracted in HSV, you can adjust the hue of an entire stage wash without shifting its brightness, or crossfade color palettes across mismatched fixtures (e.g. 3-channel RGB pars and 4-channel RGBW moving heads) while maintaining identical visual saturation.


💡 Output Modes

Unilighter automatically adapts its output pipeline based on the fixture profile's configured mode:

  • rgb: Standard 3-channel additive mixing (\(R, G, B\)).
  • rgbw: 4-channel additive mixing with a dedicated White emitter (\(R, G, B, W\)).
  • drgb: Fixtures with a dedicated hardware master dimmer channel driving overall intensity before \(R, G, B\).
  • drgbw: Master dimmer channel driving overall intensity before \(R, G, B, W\).

🔬 The 5 RGBW Translation Strategies

When lighting designers pick a pastel tone (such as pale lavender, warm peach, or soft mint), how should a fixture with both RGB diodes and a dedicated White diode mix the light? Unilighter provides five selectable strategies:

1. ignore (Pure RGB Mode)

The dedicated White channel is forced to 0. All colors, tints, and whites are synthesized exclusively by mixing the Red, Green, and Blue diodes.

  • When to use: When matching colors with older 3-channel RGB fixtures where introducing an auxiliary white diode would look noticeably different in beam texture.

2. desaturate (Pure Hue + White Fill)

RGB diodes remain at 100% saturation for the selected hue, while the White diode is raised proportionally to \((1 - S) \times V\) to wash out the beam towards white.

  • When to use: High-output concert washes where maximum lumen output is desired, and punchy saturated highlights must cut through smoke.

3. saturation (Linear Inverse Saturation)

The White diode is driven directly by inverse saturation \((1 - S)\), while RGB diodes scale along standard HSV value lines.

4. combined (Quadratic Smooth Transition)

Applies a non-linear quadratic smoothing curve (\(f = S^2\), effective saturation \(= f + S(1 - f)\)) to transition between desaturation and inverse saturation.

  • When to use: Theatrical skin tones, soft amber washes, and delicate pastel transitions where linear curves create harsh color inflection points.

5. blend (Default & Recommended)

At \(S = 0\) (pure white), RGB diodes are completely extinguished and only the dedicated White LED fires. As saturation increases, Unilighter smoothly crossfades between the White diode and the RGB diodes.

  • When to use: Architectural lighting, theater, and corporate keynotes. Emitting pure white strictly through the dedicated White diode maximizes diode lifespan, runs cooler, and delivers high-CRI (Color Rendering Index) white light without the multicolored fringe shadows characteristic of RGB-mixed white.

🛠️ Hardware Color Calibration (correction)

Even fixtures from the same brand often produce noticeably different whites if they were manufactured in different production batches or have accumulated varying operating hours.

In the Device Detail View (/#/device/<id>), expanding the Color Calibration panel allows you to fine-tune individual diode multipliers (\(0.000–1.000\)) for each fixture and head:

  1. Aim at a Neutral Surface: Focus all fixtures onto a clean white stage wall or cyc.
  2. Set Pure White: Raise all fixtures to full intensity at \(S = 0\).
  3. Identify the Dominant Cast: If one fixture looks noticeably pinkish or cool blue compared to your reference light, locate its calibration card.
  4. Trim the Multiplier: Slightly pull down the offending slider (e.g. reduce Red from 1.0 to 0.92, or Blue from 1.0 to 0.37) until the beam color temperature visually aligns with the rest of the rig.
  5. Instant Reset: Click Reset to Default at any time to restore factory \(1.0\) uncalibrated unity.

🎡 Additive Electronic Mixing vs. Motorized Gel Wheels

For profile moving heads equipped with physical color wheels, Unilighter integrates motorized gel wheels into the same workflow via Motorized Gel Wheel Controls. Unilighter accurately displays gel swatch chips, half-color splits between adjacent slots, and continuous wheel spin speeds.

Read more in the Scenes & Color Calibration Guide and the UI Controls: Color Picker.