home/ atoms/ qlc-fixture-heads

A fixture Head groups channels belonging to one light output device within a multi-output fixture

A Head represents a single light-emitting unit within a fixture. Most fixtures have one head; bar fixtures (e.g., 8-cell LED bar) have multiple. Defining heads lets QLC+ treat each output individually in Fixture Groups and RGB Matrices. Head channels should be exclusive to that head — a shared master dimmer is not included in any single head’s definition. Heads belong to a Fixture Mode because different modes may provide different per-head channel counts. Index order should follow the physical fixture’s layout.

Examples

An LED bar with 4 RGB cells: 4 heads, each assigned 3 channels (R, G, B). The global dimmer channel is excluded from all heads.

Assessment

An 8-bar has a single master dimmer (ch 1) and 8 sets of RGB channels (ch 2–25). How many heads should be defined, which channels go in each head, and which channel is excluded from all heads?

“A head represents an individual light output device in a fixture. Usually, a single fixture contains exactly one output, like the lens, the bulb, or a set of LEDs.”
corpus · qlc-user-manual-open-source-dmx-lighting-control · chunk 3