Skip to content

Commit

Permalink
module order - this adds 5.0 into the module order mix.
Browse files Browse the repository at this point in the history
  • Loading branch information
wpferguson authored and elstoc committed Dec 19, 2024
1 parent 13bb8d1 commit 1618c5b
Show file tree
Hide file tree
Showing 2 changed files with 13 additions and 4 deletions.
4 changes: 2 additions & 2 deletions content/darkroom/pixelpipe/the-pixelpipe-and-module-order.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ Pixel data within the _display-referred_ space is non-linear and is not a physic

_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.

Selecting the scene-referred workflow enables the _v3.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 [_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 All @@ -67,4 +67,4 @@ It remains highly recommended that users not change the order within the pixelpi

Despite the general recommendation to leave the pixelpipe order alone, it is possible to move modules within the pixelpipe by holding Ctrl+Shift and dragging and dropping the desired module to a new location. This should only be done by experienced users who understand the impact this will have on the image.

The module order can be manually changed back to either the _v3.0_ or _legacy_ versions using the [module order](../../../module-reference/utility-modules/darkroom/module-order.md) module, which can also be used to define your own custom module order presets.
The module order can be manually changed back to either the _v5.0_, _v3.0_ or _legacy_ versions using the [module order](../../../module-reference/utility-modules/darkroom/module-order.md) module, which can also be used to define your own custom module order presets.
13 changes: 11 additions & 2 deletions content/module-reference/utility-modules/darkroom/module-order.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,15 +10,24 @@ Change the order of the [processing modules](../../processing-modules/_index.md)

When processing an image, the active modules are applied in a specific order, which is shown in the right-hand panel of the darkroom view. This module provides information about the current ordering of the processing modules in the [pixelpipe](../../../darkroom/pixelpipe/the-pixelpipe-and-module-order.md). The name of the currently-selected preset is shown in the module header (or "custom" if the user has manually modified the order). The following presets are available for selection.

v5.0 RAW
: This is the default module order for [scene-referred](../../../darkroom/pixelpipe/the-pixelpipe-and-module-order.md/#scene-referred-workflow) RAW development workflow in darktable 5.0.

v5.0 JPEG
: This is the default module order for JPEG development in darktable 5.0.

v3.0 RAW
: This is the default module order for [scene-referred](../../../darkroom/pixelpipe/the-pixelpipe-and-module-order.md/#scene-referred-workflow) RAW development workflow.
: This is the default module order for [scene-referred](../../../darkroom/pixelpipe/the-pixelpipe-and-module-order.md/#scene-referred-workflow) RAW development workflow prior to darktable 5.0.

v3.0 JPEG
: This is the default module order for JPEG development.
: This is the default module order for JPEG development prior to darktable 5.0.

legacy
: This module order is used for the legacy [display-referred](../../../darkroom/pixelpipe/the-pixelpipe-and-module-order.md/#display-referred-workflow) workflow. You will also see this order displayed for any images you previously edited in darktable prior to version 3.0.

custom
: The user has manually modified the module order.

---

**Note:** changing the order of modules in the pixelpipe is not a cosmetic change to the presentation of the GUI -- it has real consequences to how the image will be processed. Please do not change the order of the modules unless you have a specific technical reason and understand why this is required from an image processing perspective.
Expand Down

0 comments on commit 1618c5b

Please sign in to comment.