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.
Action When exporting images to save them to a file, the picture is processed at full resolution and then rescaled to the specified output size by this module.
Final resampling is never used when producing previews, for the lighttable thumbnails or in the darkroom, because in this case images are resampled earlier in the pipeline, for better rendering speed.
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.
As denoising is a resource-intensive process, it slows down pixelpipe processing significantly. Consider activating this module late in your workflow.
Simulate physically-accurate blurs in scene-referred RGB space.
blur types Three types of blur are provided:
lens blur: Simulates a lens diaphragm with a configurable number of blades and blade curvature to create synthetic bokeh. motion blur: Simulates the effect of camera motion with a configurable path. gaussian blur: This is not really an optical blur but can be used for denoising or for creative effects using blend modes A diagram at the top of the module shows the shape of the blurring operator (known as the point spread function ).
Degrade parts of the image in an aesthetically pleasing way, in order to anonymize people/objects or hide body parts.
Censorize works in linear RGB color space to apply a physically-accurate gaussian blur and gaussian luminance noise.
Aside from anonymization, this module can also be used for a wide range of creative purposes, for example:
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.
Correct chromatic aberrations.
In contrast to the raw chromatic aberrations module, this module does not require raw data as input.
workflow To obtain the best result, you are advised to proceed as follows:
Attenuate the chromatic aberrations as much as possible in the lens correction module using the TCA sliders. Increase the strength slider in this module to better see its effect. Increase the radius until the chromatic aberrations disappear. If this is insufficient, try enabling the “very large chromatic aberrations” setting.
An advanced module which brings color-grading tools from cinematography into the photographic scene-referred pipeline.
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.
introduction Color-grading is an important part of image editing. It can help to remove unwanted color casts and can also deliver a creative color twist that will add atmosphere to your images.
A fully-featured color-space correction, white balance adjustment and channel mixer module.
This simple yet powerful module can be used in the following ways:
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).
module controls color board The color board grid shows a list of colored patches.
Recover color information in blown-out highlights.
Due to the nature of digital sensors, overexposed highlights lack valid color information. Most frequently they appear neutral white or exhibit some color cast, depending on what other image processing steps are involved. This module can be used to “heal” overexposed highlights by replacing their colors with better fitting ones. The module acts on pixels whose luminance exceeds a user-defined threshold. Replacement colors are taken from neighboring pixels.
Selectively adjust the lightness, saturation and hue of pixels based on their current lightness, saturation and hue.
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.
You first need to choose whether you wish to adjust (select) pixels based on their lightness, saturation or hue.
Adjust luminance and chroma contrast in the wavelet domain.
This versatile module can be used to achieve a variety of effects, including bloom, denoise, clarity, and local contrast enhancement.
It works in the wavelet 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.
A number of presets are provided, which should help you to understand the capabilities of the module.
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.
Whenever this module is in focus, the full uncropped image will be shown, overlaid with crop handles and optional guiding lines.
Control how raw files are demosaiced.
bayer filters The sensor cells of a digital camera are not color-sensitive – they are only able to record different levels of lightness. In order to obtain a color image, each cell is covered by a color filter (red, green or blue) that primarily passes light of that color. This means that each pixel of the raw image only contains information about a single color channel.
An easy to use and highly efficient denoise module, adapted to the individual noise profiles of a wide range of camera sensors.
One issue with a lot of denoising algorithms is that they assume that the variance of the noise is independent of the luminosity of the signal. By profiling the noise characteristics of a camera’s sensor at different ISO settings, the variance at different luminosities can be assessed, and the denoising algorithm can be adjusted to more evenly smooth out the noise.
Diffusion is a family of physical processes by which particles move and spread gradually with time, from a source that generates them. In image processing, diffusion mostly occurs in two places:
diffusion of photons through lens glass (blur) or humid air (hazing), diffusion of pigments in wet inks or watercolors. In both cases, diffusion makes the image less sharp by “leaking” particles and smoothing local variations.
The diffuse or sharpen module uses a generalized physical model to describe several kinds of diffusion, and can be used by image makers to either simulate or revert diffusion processes.
This module eliminates some of the banding artifacts that can result when Ansel’s internal 32-bit floating point data is transferred into discrete 8-bit or 16-bit integer output format for display or export.
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.
Increase or decrease the overall brightness of an image.
This module has two modes of operation:
manual Set the exposure, black level and clipping threshold manually automatic (RAW images only) Use an analysis of the image’s histogram to automatically set the exposure. Ansel automatically selects the exposure compensation that is required to shift the selected percentile to the selected target level (see definitions below). This mode is particularly useful for automatically altering a large number of images to have the same exposure.
Remap the tonal range of an image by reproducing the tone and color response of classic film.
This module can be used either to expand or to contract the dynamic range of the scene to fit the dynamic range of the display. It protects colors and contrast in the mid-tones, recovers the shadows, and compresses bright highlights and dark shadows. Highlights will need extra care when details need to be preserved (e.
Generate a frame around the image.
The frame consists of a border (with a user-defined color) and a frame line within that border (with a second user-defined color). Various options are available to control the geometry and color of the frame.
module controls border size The size of the frame as a percentage of the underlying full image. aspect The aspect ratio of the final module output (i.e. the underlying image plus the frame) orientation The orientation of the frame (portrait/landscape).
Simulate a graduated density filter in order to correct exposure and color in a progressive manner.
A line is shown on screen allowing the position and rotation of the gradient to be modified with the mouse.
This module is known to provoke banding artifacts under certain conditions. You should consider activating the dithering module to alleviate these issues.
module controls density Set the density of the filter (EV). A low value underexposes slightly whereas a high value creates a strong filter.
Simulate the grain of analog film. The grain is processed on the L channel of Lab color space.
module controls coarseness The grain size, scaled to simulate an ISO number. strength The strength of the effect.
Automatically reduce the effect of dust and haze in the atmosphere. This module may also be employed more generally to give pictures a color boost specifically in low-contrast regions of the image.
Haze absorbs light from objects in the scene but it is also a source of diffuse background light. The haze removal module first estimates, for each image region, the amount of haze in the scene. It then removes the diffuse background light according to its local strength and recovers the original object light.
Attempt to reconstruct color information for pixels that are clipped in one or more RGB channel.
If these pixels are left partially clipped it can result in unrealistic colors appearing in the image. For example pixels with both green and blue channels clipped will appear to be red without any highlight reconstruction.
Three methods of reconstruction are available:
clip highlights Clamp all pixels to the white level (i.e. clip the remaining color channels).
Automatically detect and eliminate hot pixels.
Hot pixels are pixels which have failed to record a light level correctly. Detected hot pixels are replaced by an average of their neighbors.
module controls threshold How strong a pixel’s value needs to deviate from that of its neighbors to be regarded as a hot pixel. strength The blending strength of the hot pixels with their surrounding. detect by 3 neighbours Extend the detection of hot pixels – regard a pixel as hot if a minimum of only three (instead of four) neighbor pixels deviate by more than the threshold level.
Define how Ansel will interpret the colors of the image.
This module takes the color space used by the image source (e.g. camera, scanner) and converts the pixel encodings to a standardized working color space. This means that subsequent modules in the pipeline don’t need to be concerned with the specifics of the input device, and can work with and convert to/from a common working color space.
Where an image has been captured in a raw file, the input color profile module will normally apply either a standard or enhanced color matrix specific for that camera model, which will be used to map the colors into the working profile color space.
Automatically correct for (and simulate) lens distortion, transversal chromatic aberrations (TCA) and vignetting.
This module identifies the camera/lens combination from the image’s Exif data and uses the external lensfun library to provide correction parameters.
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 pixels around by applying freestyle distortions to parts of the image using points, lines and curves.
nodes Each of liquify’s tools is based on nodes. A point consists of a single node and a line or curve consists of a sequence of linked nodes defining a path.
Each instance of the liquify module is limited to a maximum of 100 nodes – for more nodes, use additional instances. However, please note that the liquify module consumes a lot of system resources.
Enhance the image’s local contrast.
This is achieved using either a local laplacian (default) or unnormalized bilateral filter. Both modes work exclusively on the L channel from Lab. The local laplacian filter has been designed to be robust against unwanted halo effects and gradient reversals along edges.
module controls mode Choice of local laplacian filter or bilateral grid. The following sections define the controls available for each of these modes. bilateral grid coarseness Adjust the coarseness of the details to be adjusted.
Transform RGB values with a 3D LUT file.
A 3D LUT is a tridimensional table that is used to transform a given RGB value into another RGB value. It is normally used for film simulation and color grading.
This module accepts .cube, .3dl, .png (haldclut) and .gmz files. Uncompressed 3D LUT data is not saved in the database or the XMP file, but is instead saved to the 3D LUT file path inside the 3D LUT root folder.
Process scanned film negatives.
You can obtain an image of a negative using a film scanner, or by photographing it against a white light (e.g. a light table or computer monitor) or off-camera flash.
preparation If the image of the negative was obtained using a digital camera, then in order to obtain accurate colors in the final image, you will need to take the following points into consideration:
When taking the photograph, adjust the exposure to fully utilise the entire dynamic range of your camera sensor – i.
Rotate the image 90 degrees at a time or flip the image horizontally and/or vertically.
The module is enabled by default and the orientation (rotation) is automatically set based on the image’s Exif data.
The orientation can also be set using the selected images module in the lighttable view.
module controls transform Double click the label to reset to the default transformations rotate counter-clockwise Rotate the image 90 degrees counter-clockwise rotate clockwise Rotate the image 90 degrees clockwise flip horizontally Flip the image (mirror) horizontally flip vertically Flip the image (mirror) vertically show guides Tick the box to show guide overlays whenever the module is activated.
Manage the output profile for export and the rendering intent to be used when mapping between color spaces.
Ansel comes with pre-defined profiles sRGB, Adobe RGB, XYZ and linear RGB. You can provide additional profiles by placing them in $Ansel/share/Ansel/color/out and $HOME/.config/Ansel/color/out (where $Ansel is the Ansel installation directory and $HOME is your home directory).
The output color profile may also be defined within the export module.
module controls output intent The rendering intent for output/export.
Define camera-specific black and white points.
This module is activated automatically for all raw images. Default settings are applied for all supported cameras. Changes to the defaults are not normally required.
module controls black level 0-3 The camera-specific black level of the four pixels in the RGGB Bayer pattern. Pixels with values lower than this level are not considered to contain valid data. white point The camera-specific white level. All pixels with values above this are likely to be clipped and will be handled accordingly in the highlight reconstruction module.
Correct chromatic aberrations of raw images.
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.
This module has been ported from dcraw .
module controls noise threshold The threshold for noise detection. Higher values lead to stronger noise removal and greater loss of image detail. coarse/fine curves The noise of an image is usually a combination of fine-grained and coarse-grained noise. These curves allow the image to be denoised more or less depending on the coarseness of the visible noise.
Remove unwanted elements from your image by cloning, healing, blurring and filling using drawn shapes.
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.
A classic digital photography tool to alter an image’s tones using curves.
Activate the color picker on the left to show the picked values in the graph (Ctrl+click or right-click to use the picker in area mode). Numerical (Lab) values of the input and output (see below) at the selected spot or area are shown at the top left of the widget.
A second color picker to the right can be used to automtaically create new nodes based on the sampled area.
Adjust black, white and mid-gray points in RGB color space.
The rgb levels tool shows a histogram of the image, and displays three bars with handles. Drag the handles to modify the black, middle-gray and white points in lightness (in “RGB, linked channels” mode) or independently for each of the R, G and B channels (in “RGB, independent channels” mode).
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.
Automatically correct for converging lines, a form of perspective distortion. The underlying mechanism is inspired by Markus Hebel’s ShiftN program. This module also allows for the rotation of the image to be adjusted.
Perspective distortions are a natural effect when projecting a three dimensional scene onto a two dimensional plane and cause objects close to the viewer to appear larger than objects further away. Converging lines are a special case of perspective distortions frequently seen in architectural photographs – parallel lines, when photographed at an angle, are transformed into converging lines that meet at some vantage point within or outside of the image frame.
The sensors of some cameras (such as the Fujifilm FinePix S2Pro, F700, and E550) have a diagonally oriented Bayer pattern instead of the usual orthogonal layout.
Without correction this would lead to a tilted image with black corners. This module applies the required rotation.
Ansel detects images that need correction using their Exif data and automatically activates this module where required. For other images the module always remains disabled.
The module has no controls.
Some cameras (such as the Nikon D1X) have rectangular instead of the usual square sensor cells. Without correction this would lead to distorted images. This module applies the required scaling.
Ansel detects images that need correction using their Exif data and automatically activates this module where required. For other images the module always remains disabled.
The module has no controls.
Sharpen the details in the image using a standard UnSharp Mask (USM).
This module works by increasing the contrast around edges and thereby enhancing the impression of sharpness of an image. This module is applied to the L channel in Lab color space.
Note: The USM algorithm used in this module performs blurs in Lab color space, which can produce undesirable effects, and is no longer recommended. Instead use the presets offered by the contrast equalizer module for deblurring or the local contrast module for general sharpness.
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.
Dodge and burn while preserving local contrast.
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.
The following diagram describes how the tone equalizer works:
Create a monochrome guided mask that divides the input image into regions of similar luminosity. The resulting mask should blur the fine details within the image so that pixels within each region are all treated similarly, preserving local contrast.
Add a correction curve to image data. This is required if you have selected certain input profiles in the input color profile module.
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.
Vignetting is a modification of the brightness and saturation at the borders of the image in a specified shape. Many of the parameters listed below can also be modified with a graphical control that overlays the image when the module has focus, showing the shape and extent of the effect.
Note: This module is known to provoke banding artifacts under certain conditions. You should consider activating the dithering module to alleviate this.
Render a vector-based overlay onto your image. Watermarks are standard SVG documents and can be designed using Inkscape .
You can also use bitmap (PNG) images.
The SVG processor in Ansel can also substitute strings within an SVG document, allowing image-dependent information to be included in the watermark.
User-designed watermarks should be placed into the directory $HOME/.config/Ansel/watermarks. Once in place, use the reload button update the list of available watermarks.
The following is a list of variable strings that are supported for substitution within an SVG document.
Adjust the white balance of the image by altering the temperature and tint, defining a coefficient for each RGB channel, or choosing from list of predefined white balance settings.
The default settings for this module are derived from the camera white balance stored in the image’s Exif data.
White balance is not intended as a “creative” module – its primary goal is to technically correct the white balance of the image ensuring that neutral colored objects in the scene are rendered with neutral colors in the image.