From 6155e40e9dbf7e524f814ad264b9781d143531d7 Mon Sep 17 00:00:00 2001 From: David Smith Date: Fri, 18 Apr 2025 14:27:12 +0100 Subject: [PATCH 1/2] Update doc for default tone-mapper workflow --- content/preferences-settings/processing.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/preferences-settings/processing.md b/content/preferences-settings/processing.md index f17e60ed92..7d88be449e 100644 --- a/content/preferences-settings/processing.md +++ b/content/preferences-settings/processing.md @@ -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. From 937284c40762d5616669f51d10336335195360ae Mon Sep 17 00:00:00 2001 From: David Smith Date: Sat, 26 Apr 2025 15:30:55 +0100 Subject: [PATCH 2/2] Try updating other filmic references for the newer sigmoid default. --- .../darkroom/pixelpipe/the-pixelpipe-and-module-order.md | 6 +++--- content/overview/workflow/process.md | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/content/darkroom/pixelpipe/the-pixelpipe-and-module-order.md b/content/darkroom/pixelpipe/the-pixelpipe-and-module-order.md index 5917b9bbc8..cd862468b6 100644 --- a/content/darkroom/pixelpipe/the-pixelpipe-and-module-order.md +++ b/content/darkroom/pixelpipe/the-pixelpipe-and-module-order.md @@ -45,7 +45,7 @@ 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. @@ -53,9 +53,9 @@ Pixel data within the _display-referred_ space is non-linear and is not a physic ## 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 diff --git a/content/overview/workflow/process.md b/content/overview/workflow/process.md index b1e5de8012..0e4d8cc0b0 100644 --- a/content/overview/workflow/process.md +++ b/content/overview/workflow/process.md @@ -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