December 10, 2025
Scene-Referred Workflow is the heart of modern Darktable and distinguishes it massively from programs like Lightroom or older Darktable versions.
1. The Basic Problem: Display-Referred (The Old Way)
In the past (and in many other programs), the image was forced into the screen’s color space (usually sRGB or AdobeRGB) very early in the processing chain.
- The Problem: Camera sensors have a huge dynamic range (very bright to very dark). Screens have a small one.
- If you “compress” the image to the screen range too early (tone mapping), you lose the physical relationship to light. Bright highlights (sun, lamps) are simply cut off at “White” (value 1.0 or 255) (clipping).
- Operations like “increase exposure” or “blur” then often look artificial because the real light information is missing.
2. The Solution: Scene-Referred (The New Way)
In the scene-referred workflow, Darktable treats pixel values as physical light values for as long as possible.
- Unlimited Space: There is no upper limit at “White”. A pixel can have the value 1.0 (white), but also 10.0 or 100.0 (much brighter than white, e.g., the sun).
- Physics: Modules like Exposure, Color Calibration, or Filmic RGB / Sigmoid work linearly. This means if you double the exposure, the numerical value simply doubles. This corresponds exactly to what happens when you make the light brighter in reality.
- Late Tone Mapping: Only at the very end of the “pixel pipe” (processing chain) is the image “translated” for your monitor. This is done by modules like Filmic RGB or Sigmoid. They take this huge dynamic range and elegantly squeeze it into the range your monitor can display.
Why is this important for you?
- HDR Handling: You can rescue highlights that would have simply burned out in the old workflow because the information “brighter than white” is preserved until AgX (Filmic or Sigmoid) makes it visible again.
- More Natural Colors: Since colors are mixed physically correctly, there are fewer strange color shifts (e.g., a blue sky doesn’t suddenly turn gray or purple when darkened).
- Module Order: In Darktable, the order is fixed (from bottom to top).
- Bottom (Raw): Physical corrections (Exposure, White Balance).
- Middle: Creative adjustments.
- Top: Transformation to the screen AgX (Filmic/Sigmoid).
Quick Guide for the Workflow
When you open a RAW, Darktable automatically does the following in modern mode:
- Exposure: Raises the brightness so that the midtones (the main subject) are correctly exposed. Highlights are allowed to burn out (have values over 1.0).
- Color Calibration: Takes care of white balance (CAT).
- AgX (Filmic RGB or Sigmoid): This is the “compressor”. It brings back the blown-out highlights (values > 1.0) and ensures that the black is crisp.
Your Job:
You only adjust the brightness of your main subject in the Exposure module. Ignore if the sky burns out. You fix that afterwards in the AgX (Filmic RGB or Sigmoid) module (adjust “White Point” or “Recovery” there).
In summary: Scene-Referred simulates real light until the very last moment, while Display-Referred pretends the image is already a finished photo on paper.
