If a large painted wall or other deliberately colored surface dominates the frame, darktable’s whole-image picker can infer a misleading illuminant: it treats the selected area’s average color as the scene illuminant, relying on the gray-world assumption that a natural scene averages to neutral. The manual explicitly says this method does not work for artificial scenes such as those with painted surfaces. Use a credible neutral patch when one is present; otherwise consider the camera-recorded setting or a deliberately chosen lighting setting instead of averaging the composition.
Decide what the picker should represent
In the Color Calibration module’s CAT tab, the picker can select a neutral color from the image. The manual also describes selecting the entire image when a neutral is unavailable; that choice invokes the average-color, gray-world method. It is not a general-purpose way to discover the true light in any photograph.
Use this decision sequence:
- Look for a neutral reference or other patch with a credible basis for neutrality; apparent whiteness alone does not establish that an unknown paint is neutral.
- Check that the patch shares the relevant illumination with the subject. If it does, sample that patch rather than the whole frame.
- If no credible, similarly lit neutral patch exists, do not treat a whole-frame average as evidence of the illuminant when large colored surfaces or a designed color scheme dominate. Compare as shot in camera (the manual says this restores the camera defaults and rereads RAW Exif), or choose an illuminant only when you have independent grounds, such as knowing the light source. A color cast alone does not identify a lamp type.
Record a useful comparison
The following is an author-proposed worksheet for comparing alternatives; the entries are hypothetical observations, not darktable measurements or guaranteed outcomes. Keep the framing and other edits unchanged while comparing so the illuminant choice is the main variable.
| Hypothetical scene and candidate | Sampling basis to record | Decision to record |
|---|---|---|
| Large teal painted wall; whole image | Average includes a deliberately colored surface | Do not use the result as evidence of the illuminant |
| Subject lit by both window light and warm room light; local patch on one side | Patch represents only that region’s illumination | Record the target region; a single global choice may not describe both lights |
For each comparison, note the frame’s large colored surfaces, the selected area, and the lighting basis. This makes a surprising shift traceable to the sampling choice rather than an assumed defect in the photograph.
Limits and next steps
If the candidate patch is colored or lit differently from the target subject, it cannot establish that subject’s illuminant. For regions under different lights, the manual says Color Calibration can use masks to correct different parts selectively: its documented example uses one module instance with a mask, then a second instance reusing the inverted raster mask. This is a regional workflow, not a guarantee that one global sample will neutralize mixed lighting.
Common questions
Does selecting the whole image mean darktable found a neutral object?
No. It uses the average color of the chosen area as the illuminant under a gray-world assumption; it does not identify a neutral object.
Can masks handle two different light sources?
The manual describes using separate Color Calibration instances with masks to correct different regions selectively; it does not imply that one global sample can describe both lights.
What if the illuminant’s CCT is marked invalid?
The manual says this means the color is not well represented by a daylight or black-body temperature; use the custom illuminant controls rather than treating the displayed temperature as meaningful.
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.