Processing modules

Blend two CAT16 plus RGB mixer corrections across brightness keyframes.

The split-toning RGB module applies two independent color transforms:

• one keyed on the dark tones,
• one keyed on the bright tones.

Each keyframe combines:

• a chromatic adaptation defined by a correlated color temperature in CAT16,
• a 3×3 RGB channel mixer working in the pipeline working RGB space.

The two transforms are then interpolated according to the scene luminance of each pixel. This makes the module suitable both for creative split toning and for technical correction of mixed illuminants, for example cool bounce light in the shadows combined with a warmer direct illuminant in the highlights.

Edit RGB/CYM primary control nodes in dt UCS and remap colors through a procedural 3D LUT.

The color primaries module is a secondary color-grading tool built around the six additive and subtractive primaries:

• red,
• yellow,
• green,
• cyan,
• blue,
• magenta.

Each of these control nodes is sampled inside the internal RGB gamut and converted to dt UCS HSB. The module lets you change the hue, saturation and brightness of those six reference colors, then interpolates the resulting RGB shifts through a cylindrical local field to build a dense 3D LUT.

Remap colors through a procedural 3D LUT driven by perceptual hue-ring controls.

The color equalizer module is a secondary color-grading tool. It lets you define color shifts on three hue rings expressed in dt UCS HSB space, then converts those shifts into a dense RGB 3D LUT that is applied to the image.

The user interface is meant to stay perceptually even:

• The editable graphs work in hue, saturation and brightness dimensions of dt UCS HSB,
• The underlying LUT is built in RGB code values and applied as a 3D cube transform,
• The interpolation between user nodes is smooth and periodic over hue.

Because the final effect is applied through a 3D LUT, hue, saturation and brightness edits can interact in a more global way than in curve-only modules. This makes the module well suited to creative color remapping and palette design, but more robust across dramatic changes.

Simulate photographic grain from a stochastic stack of silver-halide crystal layers.

This module implements a production version of the model presented in Stochastic photographic grain synthesis from crystallographic structure simulation . The goal is not to add generic noise, but to discretize the scene-referred image into finite crystal footprints that capture and deplete light through an emulsion stack.

Unlike simple additive noise, the module works with crystal-shaped grains, a per-layer filling ratio, and a remaining-light model. Each crystal captures a flat tone averaged over its own footprint, so image detail finer than the grain size is not preserved inside the grain.

Paint premultiplied RGBA layers directly in darkroom and save them as pages inside a TIFF sidecar.

This module is a true painting layer system. It is not a local-adjustment mask editor and it is not a clone/heal tool like retouch. Instead, it creates and edits independent raster layers that are composited over the current image in the pixelpipe.

The intended use cases are:

• Hand painting,
• Dodging and burning with a brush,
• Color glazing,
• Painterly overlays,
• Matte painting on top of a photograph,
• Texture painting,
• Soft masking or erasing with a pressure-sensitive tablet.

The TIFF sidecar is saved as 16 bits floating point, compressed losslessly, in scene-linear working RGB space (the colorspace ICC profile is included in the file), with premultiplied alpha. It can be modified in any software that supports this.

This module has always been in the pixel pipeline but was hidden in darktable GUI. Ansel 0.0 exposes it to allow users to fix a mistake in the default pipeline order of darktable.

Remove image noise while preserving structure.

This is accomplished by averaging each pixel with some surrounding pixels in the image. The weight of such a pixel in the averaging process depends on the similarity of its neighborhood with the neighborhood of the pixel being denoised. A patch with a defined size is used to measure that similarity.

Como a eliminação de ruído é um processo que consome muitos recursos, ela retarda significativamente o processamento do pixelpipe. Considere ativar este módulo mais tarde no fluxo de trabalho.

Simule desfocagens fisicamente precisas no espaço RGB relativo à cena.

Degrada partes da imagem de uma maneira esteticamente agradável, para anonimizar pessoas/objetos e ocultar partes do corpo.

O módulo trabalha no espaço de cor linear RGB para aplicar um desfoque e um ruído de luminância gaussianos fisicamente precisos.

Além da anonimização, este módulo pode também ser usado para uma variedade de propósitos criativos, como por exemplo:

• Combine a simple blur with a multiply blend mode to create a realistic bloom (Orton effect).
• Combine a simple blur with a subtract blending mode and low opacity to create an unsharp mask , similar to the sharpen module but in an RGB scene-referred space.
• Add noise to create artificial grain.

Nota: Os métodos de anonimização proporcionados por este módulo não são seguros do ponto de vista forense para favorecer a estética. É possível que algumas técnicas forenses possam ainda ser capazes de reconstruir o conteúdo censurado baseado em sua estrutura, especialmente para formas e textos simples (por exemplo, placas de veículo, números de ruas).

Corrige aberrações cromáticas.

Diferente do módulo de aberrações cromáticas em raw, este módulo não precisa de dados em RAW como entrada.

Um módulo avançado que traz ferramentas de gradação de cor da cinematografia à pipeline fotográfica relativa à cena.

This module is not suitable for beginners with no prior knowledge of color theory, who might want to stick to the global chroma and global vibrance settings until they have a good understanding of the dimensions of color.

Uma correção de espaço de cor com todas as funções, módulo de ajuste de balanço de branco e misturador de canais.

Este módulo simples porém poderoso pode ser usado das seguintes maneiras:

• To adjust the white balance (chromatic adaptation), working in tandem with the white balance module. Here, the white balance module makes some initial adjustments (required for the demosaic module to work effectively), and the color calibration module then calculates a more perceptually-accurate white balance after the input color profile has been applied.

A generic color look up table implemented in Lab space.

The input to this module is a list of source and target points and the complete mapping is interpolated using splines. The resulting look up tables (LUTs) are editable by hand and can be created using the darktable-chart utility to match given input (such as hald-cluts and RAW/JPEG with in-camera processing pairs).

Recupera informações de cor nos realces (altas luzes) superexpostos.

Devido a natureza dos sensores digitais, os realces superexpostos carecem de informações de cor válidas. Com maior frequência, aparecem em branco neutro ou exibem algum matiz de cor, dependendo de que outros passos de processamento de imagem estão envolvidos. Este módulo pode ser usado para “curar” os realces superexpostos substituindo suas cores por outras que se ajustem melhor. O módulo atua sobre os pixels cuja luminância excede o limite definido pelo usuário. As cores de substituição são obtidas dos pixels vizinhos. Tanto a distância espacial como a distância de luminância (intervalo) são levados em conta para a seleção da cor.

Ajusta seletivamente a luminosidade, saturação e matiz dos pixels em função da luminosidade, saturação e matiz atuais.

This module works in CIE LCh color space, which separates pixels into lightness, chroma (saturation) and hue components. It allows you to manipulate the lightness, saturation and hue of targeted groups of pixels through the use of curves.

Primeiro você deve escolher se deseja ajustar (selecionar) pixels em função de sua luminosidade, saturação e matiz. Você pode então usar três curvas, em suas respectivas abas, para ajustar a luminosidade, saturação e matiz dos intervalos de pixels selecionados com este método.

Ajusta a luminância e o contraste cromático no domínio de wavelets.

This versatile module can be used to achieve a variety of effects, including bloom, denoise, clarity, and local contrast enhancement.

It works in the wavelets domain and its parameters can be tuned independently for each wavelet detail scale. The module operates in CIE LCh color space and so is able to treat luminosity and chromaticity independently.

Várias predefinições são fornecidas, o que deve ajudá-lo a compreender as capacidades do módulo.

Crop an image using on-screen guides.

This module appears late in the pipeline, meaning that the full image can remain available for source spots in the retouch module. For best results, you are advised to use the rotate and perspective module to perform rotation and perspective correction (if required), and then perform final creative cropping with this module.

Sempre que este módulo estiver em foco, será mostrada uma imagem completa sem corte, sobreposta com os controles de corte e linhas guia opcionais.

Controla como são interpolados cromaticamente os arquivos RAW.

Um módulo de redução de ruído altamente eficiente e fácil de usar, adaptado aos perfis de ruído individuais de uma ampla gama de sensores de câmeras.

Um problema com muitos dos algoritmos de eliminação de ruído é que assumem que a variância do ruído é independente da luminosidade do sinal. Ao perfilar as características de ruído do sensor de uma câmera em diferentes configurações de ISO, pode-se avaliar a variação em diferentes luminosidades e pode-se ajustar o algoritmo de redução de ruído para suavizar o ruído de maneira mais uniforme.

A difusão é uma família de processos físicos pelos quais as partículas se movem e se espalham gradualmente com o tempo, a partir de uma fonte que as gera. No processamento de imagens, a difusão ocorre principalmente em dois lugares:

• Diffusion of photons through lens glass (blur) or humid air (hazing),
• Diffusion of pigments in wet inks or watercolors.

Em ambos os casos, a difusão torna a imagem menos nítida por “vazamento” de partículas e suavização de variações locais.

Este módulo elimina alguns dos artefatos de banda que podem ocorrer quando os dados internos de ponto flutuante de 32 bits do Ansel são transferidos para um formato de saída discreto de 8 ou 16 bits para visualização ou exportação.

Although not an inherent problem in any of Ansel’s modules, some operations may provoke banding if they produce a lightness gradient in the image. To mitigate possible artifacts you should consider activating dithering when using the vignetting or graduated density modules. This is especially relevant for images with extended homogeneous areas such as cloudless sky. Also watch out for banding artifacts when using a gradient drawn mask.

Aumenta ou diminui o brilho geral de uma imagem.

Este módulo tem dois modos de operação:

manual

Define a exposição, nível de preto e limiar de corte manualmente.

automático (somente imagens em RAW)

Faz uma análise do histograma da imagem para estabelecer automaticamente a exposição. O Ansel seleciona automaticamente a compensação de exposição necessária para alterar o percentil selecionado ao nível alvo selecionado (consulte as definições abaixo). Este modo é particularmente útil para alterar automaticamente uma grande quantidade de imagens para que tenham a mesma exposição. Um caso de uso típico do modo automático é no processamento de fotografias de time-lapse (para evitar o efeito de cintilação).

Remapeia o alcance tonal de uma imagem reproduzindo a tonalidade e a resposta de cor de um filme clássico.

Este módulo pode ser usado para expandir ou comprimir o alcance dinâmico da cena para que se adapte ao alcance dinâmico da tela. Ele protege as cores e o contraste dos meios-tons, recupera as sombras e comprime os realces (altas luzes) a as sombras escuras. Os realces precisarão de um tratamento adicional quando for necessário preservar os detalhes (por exemplo, nuvens).

Generate a frame around the image.

A moldura consiste de uma borda (com uma cor definida pelo usuário) e uma linha de moldura dentro desta borda (com uma segunda cor definida pelo usuário). Várias opções estão disponíveis para controlar a geometria e cor da moldura.

Simula um filtro de densidade graduada de modo a corrigir a exposição e cor de forma progressiva.

Uma linha é exibida na tela permitindo que a posição e rotação do gradiente seja modificada com o mouse.

Este módulo é conhecido por provocar artefatos de banda sob certas condições. Considere ativar o módulo matização para minimizar estes problemas.

Simula a granulação de um filme analógico. O grão é processado no canal L do espaço de cor Lab.

Reduz automaticamente o efeito de poeira e névoa na atmosfera. Este módulo pode também ser empregado mais genericamente para dar às imagens um reforço de cor especificamente em regiões da imagem com baixo contraste.

A neblina absorve a luz dos objetos da cena, mas também é um fonte de luz de fundo difusa. O módulo de remoção de névoa primeiro estima, para cada região da imagem, a quantidade de neblina na cena. Em seguida, elimina a luz de fundo difusa segundo sua intensidade local e recupera a luz original do objeto.

Tenta reconstruir as informações de cor para pixels que foram cortados em um ou mais canais RGB.

Se estes pixels foram parcialmente cortados, pode resultar em cores pouco realistas na imagem. Por exemplo, pixels com os canais verde e azul cortados parecerão vermelhos sem nenhuma reconstrução de cor.

Três métodos de reconstrução estão disponíveis:

recortar realces

Fixa todos os pixels para o nível branco (isto é, recorta os canais de cor restantes). Este método é mais útil nos casos em que se produzem reflexos recortados em objetos naturalmente dessaturados (por exemplo, nuvens).

reconstruir em LCh

Analisa cada pixel com pelo menos um canal recortado e tenta corrigir o pixel recortado (no espaço de cor LCh) usando os valores dos outros pixels (3 para Bayer e 8 para X-Trans) do bloco de sensor afetado. Os realces reconstruídos seguirão sendo monocromáticos, mas mais brilhantes e com mais detalhes do que os “realces recortados”. Este método funciona muito bem com uma curva base de alto contraste, o que faz com que os realces fiquem dessaturados. Semelhante ao recortar realces, este método é uma boa opção para objetos naturalmente dessaturados.

reconstruir cor

Usa um algoritmo que transfere informações de cor da vizinhança não recortada para os realces recortados. Este método funciona muito bem em áreas com cores homogêneas e é especialmente útil em tons de pele com reflexos que se desvanecem suavemente. Note que este método pode produzir artefatos em forma de labirinto nos realces por trás das bordas de alto contraste, por exemplo, estruturas finas bem expostas em frente a um fundo superexposto.

laplaciano guiado

Usa um algoritmo (derivado do módulo difusão ou nitidez) para replicar detalhes de canais válidos em canais recortados e propagar gradientes de cores de regiões vizinhas válidas em regiões recortadas. Este é um método lento e computacionalmente intensivo projetado para máxima suavidade e mistura perfeita das regiões reconstruídas em sua vizinhança, e é projetado principalmente para reconstruir holofotes e reflexões especulares. Este modo está disponível apenas para sensores Bayer.

Nota: Quando usar a reconstrução de realce incluída no módulo rgb fílmico, pode ser útil evitar usar este módulo no modo corte de realces (para que o rgb fílmico tenha mais informações para trabalhar).

Automatically detect and eliminate hot pixels.

Pixels quentes são pixels que falharam ao registrar o nível de luz corretamente. Pixels quentes detectados são substituídos pela média de seus vizinhos.

Define how Ansel will interpret the colors of the image.

Este módulo obtém o espaço de cor usado pela imagem fonte (por exemplo, câmera ou digitalizador) e converte a codificação dos pixels em um espaço de cor de trabalho padronizado. Isto significa que os módulos subsequentes no pipeline não precisam se preocupar com detalhes do dispositivo de entrada, e podem trabalhar com a conversão de/para um espaço de cor de trabalho comum.

Corrige automaticamente (e simula) a distorção da lente, aberrações cromáticas transversais (ACT) e vinhetas.

Este módulo identifica a combinação de câmera/lente a partir dos dados Exif da imagem e usa a biblioteca externa lensfun  para fornecer parâmetros de correção.

If your system’s lensfun library has no correction profile for the automatically identified camera/lens combination, the controls for the three photometric parameters (below) are replaced with a warning message. You may try to find the right profile yourself by searching for it in the menu.

Move os pixels ao redor, aplicando distorções em estilo livre em partes da imagem usando pontos, linhas e curvas.

Melhora o contraste local da imagem.

Isto é atingindo usando um filtro laplaciano local (o padrão) ou um filtro bilateral não normalizado (grade bilateral). Ambos os modos trabalham exclusivamente no canal L de Lab. O filtro laplaciano local foi desenhado para ser robusto contra efeitos de halo indesejados e inversões de gradiente ao longo das bordas.

Transforma os valores RGB com um arquivo LUT 3D.

Uma LUT 3D é uma tabela tridimensional que é usada para transformar um valor RGB fornecido em outro valor RGB. Normalmente é usada para simulação de películas e gradação de cor.

Este módulo aceita arquivos .cube,.3dl, .png (haldclut) e.gmz. Os dados LUT 3D sem compressão não são salvos na base de dados ou arquivo XMP, sendo somente salvo o caminho do arquivo LUT 3D dentro da pasta raiz do LUT 3D. Portanto, é importante fazer uma cópia de segurança de sua pasta LUT 3D corretamente – compartilhar uma imagem com seu XMP não tem sentido se o destinatário não possuir o mesmo arquivo LUT 3D em sua própria pasta LUT 3D.

Process scanned film negatives.

Você pode obter uma imagem de um negativo usando um digitalizador, fotografando-o contra uma luz branca (por exemplo, uma mesa de luz ou o monitor do computador) ou com o flash instalado fora da câmera.

Rotate the image 90 degrees at a time or flip the image horizontally and/or vertically.

Este módulo está habilitado por padrão e a orientação (rotação) é definida automaticamente em função dos dados Exif da imagem.

Gerencia o perfil de saída para exportação e a intenção de renderização a ser usada ao mapear entre espaços de cor.

O Ansel vem com perfis predefinidos para o sRGB, Adobe RGB, XYZ e RGB linear. Você pode fornecer perfis adicionais e colocá-los em $Ansel/share/Ansel/color/out e $HOME/.config/Ansel/color/out (onde $Ansel é a pasta de instalação do Ansel e $HOME sua pasta pessoal).

The output color profile may also be defined within the export module.

Define camera-specific black and white points.

Este módulo é ativado automaticamente para todas as imagens em raw. As configurações padrão são aplicadas para todas as câmeras suportadas. Normalmente não são necessárias mudanças dos valores padrão.

Corrige as aberrações cromáticas das imagens em RAW.

As this module operates on non-demosaiced raw data, the underlying model assumes an uncropped photographic image as input. It is therefore likely to fail when you zoom in, as it is only able to operate on the visible portion of the image. The module will therefore be bypassed at high zoom levels, and a “bypassed” message will appear at the top of the module. This limitation only applies to interactive work and not to the final export.

Perform denoising on raw image data before it is demosaiced.

Este módulo foi portado do dcraw .

Remove elementos indesejados de sua imagem clonando, reparando, desfocando e preenchendo com formas desenhadas.

This module includes a “heal” tool (based on the heal tool from GIMP), as well as “fill” and “blur” modes. It can also take advantage of wavelet decomposition, allowing the image to be separated into layers of varying detail (from coarse to fine) which can be selectively retouched before being recombined to produce the output image.

Uma ferramenta clássica de fotografia digital para alterar os tons de uma imagem usando curvas.

Ative o seletor de cor à esquerda para mostrar os valores selecionados no gráfico (Ctrl+clique ou clique-direito para usar o seletor em modo de área). Os valores numéricos (Lab) de entrada e saída (ver abaixo) no ponto ou área são exibidos no canto superior esquerdo do gráfico.

Um segundo seletor de cor à direita pode ser usado para criar automaticamente novos nós baseados na área amostrada. Ctrl+clique+arraste o nó criado para ter uma curva positiva para a área selecionada. Shift+clique+arraste para criar uma curva negativa.

Adjust black, white and mid-gray points in RGB color space.

A ferramenta de níveis rgb mostra um histograma da imagem e mostra três barras com controles. Arraste os manipuladores para modificar os pontos de preto, cinza médio e branco em luminosidade (no modo “RGB, canais ligados”) ou de forma independente para cada um dos canais R, G e B (no modo “RGB, canais independentes”).

Moving the black and white bars to match the left and right borders of the histogram will make the output image span the full available tonal range. This will increase the image’s contrast.

Corrige automaticamente as linhas convergentes, uma forma de distorção da perspectiva. O processo usado é inspirado no programa ShiftN  de Markus Hebel. Este módulo também permite ajustar a rotação da imagem.

As distorções de perspectiva são um efeito natural quando se projeta uma cena tridimensional em um plano bidimensional e faz com que os objetos próximos ao observador pareçam maiores do que os mais distantes. As linhas convergentes são um caso especial de distorção de perspectiva que se vê com frequência em fotografias de arquitetura – as linhas paralelas, quando fotografadas em ângulo, se transformam em linhas convergentes que se encontram em algum ponto final fora do quadro da imagem.

Os sensores de algumas câmeras (como Fujifilm FinePix S2Pro, F700 e E550) possuem um padrão Bayer orientado diagonalmente ao invés do desenho ortogonal habitual.

Sem a correção, isto resultaria em uma imagem inclinada com os cantos pretos. Este módulo aplica a rotação necessária.

O Ansel detecta imagens que precisam de correção usando seus dados Exif e ativa automaticamente este módulo quando necessário. Para outras imagens, o módulo sempre permanece desativado.

Algumas câmeras (como a Nikon D1X) possuem sensores retangulares ao invés dos quadrados habituais. Sem correção, isto geraria imagens distorcidas. Este módulo aplica a mudança de escala necessária.

O Ansel detecta imagens que precisam de correção usando seus dados Exif e ativa automaticamente este módulo quando necessário. Para outras imagens, o módulo sempre permanece desativado.

O módulo não possui controles.

Sharpen the details in the image using a standard UnSharp Mask (USM).

Este módulo funciona aumentando o contraste ao redor da bordas e, portanto, melhorando a sensação de nitidez de uma imagem. Este módulo é aplicado ao canal L do espaço de cor Lab.

Nota: O algoritmo USM usado neste módulo realiza o desfoque no espaço de cor Lab, o que pode produzir efeitos indesejáveis e não é mais recomendado. Use as predefinições oferecidas pelo módulo equalizador de contraste para eliminar o desfoque ou o módulo contraste local para uma nitidez general.

Smooth image surfaces while preserving sharp edges using a bilateral filter.

This module can be used to denoise images, however you should be aware that bilateral filters are susceptible to overshoots and Ansel offers much better alternatives. For example, the astrophoto denoise module uses a non-local means denoising algorithm, and the denoise (profiled) module provides a choice between non-local means and wavelet denoising algorithms.

The surface blur module blurs noise within the surfaces of an image by averaging pixels with their neighbors, taking into account not only their geometric distance but also their distance on the range scale (i.e. differences in their RGB values). It can be particularly useful if one RGB channel is more noisy/needs more smoothing than the others. In such a case, use the color calibration module to examine the channels one by one, in order to set the blur intensities accordingly.

Clareia (“dodge” – desvia) e escurece (“burn” – queima) conservando o contraste local.

It works in linear RGB space and utilizes a user-defined mask to guide the dodging and burning adjustments, helping to preserve local contrast within the image.

O diagrama a seguir descreve como o equalizador de tons funciona:

Adiciona uma curva de correção aos dados da imagem. Isto é necessário se tiver sido selecionado determinados perfis de entrada no módulo perfil de cor de entrada.

If you decide to use an ICC profile from the camera manufacturer in the input color profile module, a correction curve frequently needs to be pre-applied to image data to prevent the final output from looking too dark. This extra processing is not required if you use Ansel’s standard or enhanced color matrices.

Apply a vignetting effect to the image.

A vinheta é uma modificação do brilho e saturação nas bordas da imagem em uma forma específica. Muitos dos parâmetros listados abaixo podem também ser modificados com o gráfico de controle que se sobrepõe à imagem quando o módulo possui o foco, mostrando a forma e a extensão do efeito.

Nota: É sabido que este módulo provoca artefatos de banda em determinadas condições. Você deveria considerar ativar o módulo matização para aliviar isto.

Renderiza uma sobreposição baseada em vetores em sua imagem. As marcas d’água são documentos SVG e podem ser desenhadas usando o Inkscape .

Você pode também usar imagens de mapa de bits (PNG).

O processador SVG no Ansel pode também substituir cadeias de texto dentro de um documento SVG, o que permite incluir informações que dependem da imagem na marca d’água.

As marcas d’água desenhadas pelo usuário devem ser colocadas na pasta $HOME/.config/Ansel/watermarks. Uma vez no seu lugar, usar o botão de recarregar atualiza a lista de marcas d’água disponíveis.

Ajusta o balanço de branco da imagem, modificando a temperatura e a tonalidade, definindo um coeficiente para cada canal RGB ou selecionando a partir de uma lista de ajustes de balanço de branco predefinidos.

As configurações padrão para este módulo dependem do balanço de branco da câmera armazenado nos dados Exif da imagem.

O balanço de branco não pretende ser um módulo “criativo” – seu objetivo principal é corrigir tecnicamente o balanço de branco da imagem assegurando que os objetos de cores neutras na cena sejam renderizados com cores neutras na imagem. Para operações criativas com cor, normalmente é melhor usar outros módulos como calibração de cor ou balanço de cor rgb.