The ordered sequence of processing modules operating on an input file to generate an output image is known as the “pixelpipe”.

A ordem do pixelpipe é representada graficamente pela ordem em que os módulos são apresentados na interface com o usuário: o pixelpipe inicia com uma imagem RAW na parte inferior da lista de módulos e aplica os módulos de processamento, um por um, acumulando camadas de processamento de baixo para cima, até atingir o topo da lista, onde gera a imagem completamente processada.

Nota: A ordem em que os módulos de processamento são executados coincide exatamente com a ordem em que os módulos aparecem na interface do usuário do Ansel. Mudar a ordem dos módulos na interface do usuário muda a forma como sua imagem é processada.

Module order and workflows

A ordem em que se executam os módulos dentro do pixelpipe foi cuidadosamente selecionada para fornecer a melhor qualidade de saída. Em versões anteriores do Ansel, não era possível alterar a ordem dos módulos. No entanto, existem alguns casos de uso muito específicos onde alterar a ordem de alguns módulos dentro do pixelpipe é recomendável.

O fluxo de trabalho relativo à cena tenta realizar tantas operações quanto possível no espaço de cor linear RGB, somente comprimindo os tons para corresponder à mídia de saída (com um mapeamento de tons não linear) no final do pixelpipe. Isto tem a vantagem de ser um espaço mais realístico fisicamente para realizar transformações do que o fluxo de trabalho tradicional relativo à exibição, que tenta realizar as operações em um espaço de cor perceptual não linear. Honrar o realismo físico (ao invés do realismo perceptual) torna muito mais fácil produzir algoritmos de processamento previsíveis com um mínimo de artefatos.

O diagrama a seguir deve auxiliá-lo a entender a diferença entre estes fluxos de trabalho:

![scene-referred and display-referred modules]../../../the-pixelpipe-and-module-ord../../../scene-display-workflows.png)

  1. Scene-referred modules process linear data that is proportional to the amount of light collected by the camera at the scene. The dynamic range of an image in the scene-referred section of the pixelpipe is often larger than that of the display medium.

  2. At some point in the pixelpipe, these pixel values are compressed by a non-linear tone mapping operation into a smaller dynamic range more suitable for display on a monitor or a print.

  3. The remaining modules operate in the non-linear display-referred section of the pixelpipe to produce the final output image.

Changing module order

Continua sendo altamente recomendável que usuários não alterem a ordem dentro do pixelpipe por diversas razões:

  • The sequence of modules has been selected with great care in order to give highest output quality. Changes to the sequence often worsen the result rather than improving it.
  • Some processing modules simply don’t make sense if they are shifted in the pixelpipe. For example, highlight reconstruction needs to be performed on raw data before demosaic, which itself needs to be performed before any input color profile can be applied. For this reason it is still not possible to move some of the modules that are placed early in the pixelpipe.
  • Most processing modules are designed to work within a specific color space (see the color management section for more details). Full flexibility would require modules to support different parallel algorithms depending on the color space they are working in, which would drastically increase complexity.

Despite the general recommendation to leave the pixelpipe order alone, it is possible to move modules within the pixelpipe from the darkroom module-order graph. Open it from the node-graph button in the darkroom toolbar, then drag and drop modules directly in the graph to a new location. This should only be done by experienced users who understand the impact this will have on the image.

The graph popup provides a scrollable left-to-right view of the pipeline, from the base image to the screen output. It shows:

  • The current execution order of visible modules,
  • The active color-space lifecycle across the pipeline,
  • The input/output runtime descriptors for each module,
  • Raster-mask dependencies between producer and consumer modules,
  • The module-order presets toolbar, used to add presets, reset the order, or apply an existing preset.

Modules that cannot cross ordering fences are constrained by the same rules as the processing pipeline itself, so impossible moves are prevented in the graph.

The module order can be manually changed back to either the v3.0 or legacy versions using the module order popup, which can also be used to define your own custom module order presets.