Set the luminance boundaries before choosing a color shift. In darktable’s Color Balance RGB, shadow and highlight masks are controlled through the Masks tab’s luminance ranges and fall-off controls; the mid-tone mask is derived from the other two. Preview each mask over the image, then place the grade in the control for the range where it should appear. The masks use luminance at the module’s input, so a brightness change made inside this module does not redefine the mask.
Set the ranges against the image
Work on the image as it enters Color Balance RGB. The mask graph plots opacity against pixel luminance: shadows are the darkest curve, highlights the brightest, and mid-tones the remaining curve. The middle-gray fulcrum sets the luminance where all three masks have 50% opacity. The shadow and highlight fall-offs control how soft or hard their transitions are. Treat these as boundaries to tune for the image, not as automatic subject selectors.
- Open Color Balance RGB’s Masks tab and inspect the luminance-ranges graph. Identify the input-luminance zones containing the intended shadow subject, middle-tone background, and highlights.
- Set the mask middle-gray fulcrum where you want the shadow/highlight separation to pivot. If the face’s shadow and the background occupy similar luminance, expect some overlap; a luminance mask cannot separate them by subject identity.
- Adjust shadow and highlight fall-off to include or exclude the transition tones you care about. A wider, softer transition can include more neighboring luminance values; a harder transition makes the boundary sharper. Judge the result from the displayed masks, not from the slider position alone.
- Click each mask preview button. The visible image area is the area affected by that range’s controls; the checkerboard covers the masked-out area. Check the intended face shadow, background, and highlights separately.
- Apply a restrained trial color shift in the relevant range control, then preview again. The preview shows module output, including color changes, so verify both the selected region and any spill into neighboring tones.
For example, use shadows lift for a shadow-range shift and highlights gain for a highlight-range shift. These are not interchangeable global controls: each is applied through its corresponding mask. Use mid-tones controls when the intended region belongs to the derived mid-tone mask.
Hypothetical three-zone acceptance worksheet
The following observations are hypothetical, not a darktable test or guaranteed result. Values are illustrative luminance readings from a creator’s own notes; they do not imply a particular internal sampling method. Use the actual mask previews to decide whether the ranges are acceptable.
| Intended zone | Hypothetical input-luminance note | Preview observation | Decision and grade placement |
|---|---|---|---|
| Face shadow | About 0.12 | Shadow preview leaves most of the cheek visible; a small brighter edge is checkerboard-covered | Keep a restrained warm shift in shadows lift; check that the brighter edge does not take on the same cast |
| Background mid-tones | About 0.32 | Mid-tone preview leaves the central background visible, with partial transition near the subject | Put the background’s subtle cool shift in a mid-tones control; reduce it if the face transition is visibly affected |
| Forehead highlight | About 0.68 | Highlight preview leaves the forehead visible, but also includes a bright background patch | Use highlights gain only if that patch can share the grade; otherwise narrow or reposition the highlight transition and inspect again |
Record what remains visible in each preview and where the color shift is visible in the image. The worksheet is a decision aid, not a claim that those luminance notes map to exact slider values.
Limits and what to try next
A luminance mask groups pixels by input brightness, not by object, skin, or location. If the face shadow and background have similar luminance, changing the fulcrum or fall-off may trade one spill for another rather than isolate the face. Recheck the preview after each adjustment. If the desired regions cannot be separated by luminance, do not keep forcing the boundary; consider whether another documented local-selection workflow is appropriate for your edit.
Internal luminance changes do not move the mask boundary. This is useful when a grade changes brightness, but it also means a pixel that becomes brighter inside the module remains assigned according to its input luminance. If the preview shows an unexpected region, revisit the input-image exposure or the mask ranges rather than assuming the grade will recalculate the mask.
Common questions
Why does a mid-tone area receive some shadow grade?
The masks transition rather than acting as rigid bins. Check the shadow preview and fall-off to see whether that area is included at the boundary.
Should the fulcrum always be middle gray?
No. It defines the shared 50% point for all three masks. Choose it according to the image’s intended separation, then verify the resulting previews.
Does a brighter highlight after grading move into the highlight mask?
No. The module documentation says luminance masks are computed at module input and are insensitive to luminance changes made inside the module.
Sources and next step
This guide interprets public documentation and uses explicitly hypothetical acceptance examples, not application tests. Controls and availability can change; verify the cited manual against your installed version.
For work created in Imagild, carry the input requirements and acceptance checklist into the photo editor. The external software controls discussed above belong to their respective products.