Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions content/darkroom/pixelpipe/the-pixelpipe-and-module-order.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,17 +45,17 @@ The following diagram should help you to understand the difference between these

## display-referred workflow

Prior to version 3.0 darktable's workflow was _display-referred_ (auto-apply pixel workflow defaults = "display-referred") and this option is still provided as a legacy mode. In this workflow, the [_base curve_](../../../module-reference/processing-modules/base-curve.md) or [_filmic rgb_](../../../module-reference/processing-modules/filmic-rgb.md) module performs tone mapping early in the pixelpipe and most other darktable modules operate on image data in the compressed _display-referred_ space.
Prior to version 3.0 darktable's workflow was _display-referred_ (auto-apply pixel workflow defaults = "display-referred") and this option is still provided as a legacy mode. In this workflow, the [_base curve_](../../../module-reference/processing-modules/base-curve.md) module performs tone mapping early in the pixelpipe and most other darktable modules operate on image data in the compressed _display-referred_ space.

Selecting the display-referred workflow enables the legacy (pre-darktable-3.0) module order and automatically switches on the [_base curve_](../../../module-reference/processing-modules/base-curve.md) module for new images.

Pixel data within the _display-referred_ space is non-linear and is not a physically realistic representation of the original scene. This can lead to various artifacts with some modules, hence the creation of the (now default) _scene-referred_ workflow.

## scene-referred workflow

_Scene-referred_ workflow (auto-apply pixel workflow defaults = "scene-referred") was introduced as part of darktable 3.0. The module order was entirely rearranged to place the [_filmic rgb_](../../../module-reference/processing-modules/filmic-rgb.md) and [_base curve_](../../../module-reference/processing-modules/base-curve.md) tone mapping modules much later in the pixelpipe. This means that most modules now operate in _linear rgb_ space with only a few modules remaining within the non-linear _display-referred_ space. Within this workflow it is now recommended that the majority of image processing takes place using the modules up to and including [_filmic rgb_](../../../module-reference/processing-modules/filmic-rgb.md). Operations in this section of the pixelpipe, being truly linear, are much more physically realistic and produce fewer artifacts.
_Scene-referred_ workflow was introduced as part of darktable 3.0, and is used when the "auto-apply pixel workflow defaults" preference is set to one of "scene-referred(filmic)" or, by default, "scene-referred(sigmoid)". The module order was entirely rearranged to place the tone mapping modules much later in the pixelpipe. This means that most modules now operate in _linear rgb_ space with only a few modules remaining within the non-linear _display-referred_ space. Within this workflow it is now recommended that the majority of image processing takes place using the modules up to and including [_sigmoid_](../../../module-reference/processing-modules/sigmoid.md) or [_filmic rgb_](../../../module-reference/processing-modules/filmic-rgb.md). Operations in this section of the pixelpipe, being truly linear, are much more physically realistic and produce fewer artifacts.

Selecting the scene-referred workflow enables the _v5.0_ module order and automatically enables the [_exposure_](../../../module-reference/processing-modules/exposure.md) and [_filmic rgb_](../../../module-reference/processing-modules/filmic-rgb.md) modules with some presets designed to act as a reasonable starting point for scene-referred editing.
Selecting the scene-referred workflow enables the _v5.0_ module order and automatically enables the [_exposure_](../../../module-reference/processing-modules/exposure.md) and either [_sigmoid_](../../../module-reference/processing-modules/sigmoid.md) or [_filmic rgb_](../../../module-reference/processing-modules/filmic-rgb.md) modules with some presets designed to act as a reasonable starting point for scene-referred editing.

# changing module order

Expand Down
2 changes: 1 addition & 1 deletion content/overview/workflow/process.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ In the real world, "pure black" does not really exist (there is always _some_ li

In a scene-referred workflow many common tools (tone curves and levels, for example) are no longer useful ways to manipulate the image, since they rely on now-invalid definitions of black, white and gray. Experienced users may need to learn new techniques and discard old ones, but will be rewarded with much more robust and predictable outputs.

The scene-referred workflow in darktable enables the [filmic rgb](../../module-reference/processing-modules/filmic-rgb.md) and [exposure](../../module-reference/processing-modules/exposure.md) modules by default when you open new images in the darkroom view.
The scene-referred workflow in darktable enables the [exposure](../../module-reference/processing-modules/exposure.md) and either [sigmoid](../../module-reference/processing-modules/sigmoid.md) or [filmic rgb](../../module-reference/processing-modules/filmic-rgb.md) modules by default when you open new images in the darkroom view.

### white balance and color calibration

Expand Down
8 changes: 4 additions & 4 deletions content/preferences-settings/processing.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,13 +33,13 @@ Raster mask files root folder
auto-apply pixel workflow defaults
: Choose which modules and module order are applied to new RAW image edits by default:

- _scene-referred (filmic)_ (default) assumes that most processing will be performed in a linear RGB color space. Selecting this option automatically enables the [_filmic rgb_](../module-reference/processing-modules/filmic-rgb.md), [_exposure_](../module-reference/processing-modules/exposure.md) and [_color calibration_](../module-reference/processing-modules/color-calibration.md) modules for new edits and sets the module order to _v3.0 RAW_.
- _scene-referred (sigmoid)_ (default) assumes that most processing will be performed in a linear RGB color space. Selecting this option automatically enables the [_sigmoid_](../module-reference/processing-modules/sigmoid.md), [_exposure_](../module-reference/processing-modules/exposure.md) and [_color calibration_](../module-reference/processing-modules/color-calibration.md) modules for new edits and sets the module order to _v3.0 RAW_.

The _exposure_ module includes an automatic exposure adjustment of +0.7 EV (to provide a midtone brightening comparable to the +0.5 to +1.2 EV typically added by in-camera tone curves), and automatically enables the "compensate camera exposure" option for the filmic workflow. Both of these settings are intended to provide a reasonable starting-point for RAWs produced by a broad range of SLR and mirrorless cameras, but they can be overridden with an automatically-applied preset if the defaults produce consistently dark images for your camera.
The _exposure_ module includes an automatic exposure adjustment of +0.7 EV (to provide a midtone brightening comparable to the +0.5 to +1.2 EV typically added by in-camera tone curves), and automatically enables the "compensate camera exposure" option for the sigmoid workflow. Both of these settings are intended to provide a reasonable starting-point for RAWs produced by a broad range of SLR and mirrorless cameras, but they can be overridden with an automatically-applied preset if the defaults produce consistently dark images for your camera.

In the scene-referred workflows, the [_color calibration_](../module-reference/processing-modules/color-calibration.md) module acts in conjunction with the [_white balance_](../module-reference/processing-modules/white-balance.md) module as the modern way to handle white balance and chromatic adaptation with improved color science. Note that when using the color calibration module, the white balance module needs to be active and set to "Camera Reference" mode (this will be done automatically and warnings will appear if the two modules have inconsistent settings). When using both modules as prescribed, it is still possible to auto-detect white-balance from a specific area of the image by selecting the CCT picker tool in the CAT tab of color calibration.
In the scene-referred workflows, the [_color calibration_](../module-reference/processing-modules/color-calibration.md) module acts in conjunction with the [_white balance_](../module-reference/processing-modules/white-balance.md) module as the modern way to handle white balance and chromatic adaptation with improved color science. Note that when using the color calibration module, the white balance module needs to be active and set to "as shot to reference" or "camera reference" mode (this will be done automatically and warnings will appear if the two modules have inconsistent settings). When using both modules as prescribed, it is still possible to auto-detect white-balance from a specific area of the image by selecting the CCT picker tool in the CAT tab of color calibration.

- _scene-referred (sigmoid)_ follows the same assumptions and overall flow as _scene-referred (filmic)_, with the exception that it auto-enables the [_sigmoid_](../module-reference/processing-modules/sigmoid.md) module for tone mapping in place of _filmic rgb_.
- _scene-referred (filmic)_ follows the same assumptions and overall flow as _scene-referred (sigmoid)_, with the exception that it auto-enables the [_filmic rgb_](../module-reference/processing-modules/filmic-rgb.md) module for tone mapping in place of _sigmoid_.

- _display-referred (legacy)_ is the legacy mode (used by default in darktable 2.6 and earlier) and assumes that most processing will be performed in the Lab color space. Selecting this option automatically enables the [_base curve_](../module-reference/processing-modules/base-curve.md) module for tone mapping and sets the module order to _legacy_. This workflow uses only the _white balance_ module for chromatic adaptation.

Expand Down