processing modules

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.

Correct chromatic aberrations.

Contrairement au module aberrations chromatiques raw, ce module ne nécessite pas de données RAW en entrée.

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.

Generate a frame around the image.

Le cadre se compose d’une bordure (d’une couleur définie par l’utilisateur) et d’une ligne de cadre à l’intérieur de cette bordure (d’une deuxième couleur définie par l’utilisateur). Différentes options sont disponibles pour contrôler la géométrie et la couleur du cadre.

Dégrade des parties de l’image d’une façon esthétique, pour anonymiser des gens, des objets et des parties du corps.

Censurer opère dans un espace RVB linéaire pour appliquer un flou gaussien et un bruit gaussien physiquement réalistes.

À part l’anonymisation, ce module peut aussi être utilisé pour une large gamme d’effets créatifs, par exemple :

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

Note : La méthode d’anonymisation fournie par ce module n’est pas résistante aux techniques d’analyse scientifique mais favorise l’esthétique. Certaines techniques d’analyse scientifique peuvent être capable de reconstruire le contenu anonymisé, en particulier pour des formes simples et du texte (ex : plaques d’immatriculation, numéros de rue).

Un module avancé qui apporte les outils de gradation des couleurs de la cinématographie dans le pipeline graphique relatif à la scène.

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.

Un module complet de correction de l’espace de couleur, de réglage de la balance des blancs, ainsi qu’un mixeur de canaux.

Ce module simple mais puissant peut être utilisé des manières suivantes :

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

Ajuste sélectivement la clarté, la saturation et la teinte des pixels en fonction de leur clarté, saturation et teinte actuelles.

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.

Vous devez d’abord choisir si vous souhaitez ajuster (sélectionner) les pixels en fonction de leur clarté, de leur saturation ou de leur teinte. Vous pouvez ensuite utiliser trois courbes, sur leurs onglets respectifs, pour ajuster la clarté, la saturation et la teinte des plages de pixels sélectionnées via cette méthode.

Améliore le contraste local de l’image.

Ceci est réalisé à l’aide d’un filtre laplacien local (par défaut) ou grille bilatérale. Les deux modes fonctionnent exclusivement sur le canal L de Lab. Le filtre local laplacien a été conçu pour être robuste contre les effets de halo indésirables et les inversions de gradient le long des bords.

Ajoute une courbe de correction aux données de l’image. Ceci est nécessaire si vous avez sélectionné certains profils d’entrée dans le module profil de couleur d’entrée.

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.

A classic digital photography tool to alter an image’s tones using curves.

Activez la pipette de couleur à gauche pour afficher les valeurs sélectionnées dans le graphique (Ctrl+clic ou clic droit pour utiliser le sélecteur en mode zone). Les valeurs numériques (Lab) de l’entrée et de la sortie (voir ci-dessous) à l’endroit ou à dans la zone sélectionnée sont affichées en haut à gauche du widget.

Une seconde pipette de couleur à droite de la précédente peut être utilisée pour créer automatiquement de nouveaux nœuds en fonction de la zone échantillonnée. Ctrl+clic+glisser pour modifier les nœuds créés afin d’avoir une courbe positive pour la zone sélectionnée ; Maj+clic+glisser pour créer une courbe négative.

Contrôler comment sont dématricés les fichiers RAW

Un module de débruitage facile à utiliser et très efficace, adapté aux profils de bruit individuels d’une large gamme de capteurs de boîtier.

Un problème avec beaucoup d’algorithmes de débruitage est qu’ils supposent que la variance du bruit est indépendante de la luminosité du signal. En profilant les caractéristiques de bruit du capteur d’un boîtier à différents réglages ISO, la variance à différentes luminosités peut être évaluée et l’algorithme de débruitage peut être ajusté pour lisser plus uniformément le bruit.

La diffusion est une famille de processus physiques par lesquels des particules se déplacent et se propagent progressivement avec le temps, depuis une source qui les génère. En traitement d’image, la diffusion se produit principalement à deux endroits :

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

Dans les deux cas, la diffusion rend l’image moins nette en laissant “fuir” des particules et en lissant les variations locales.

Ajuste le contraste de luminance et de chroma dans le domaine des ondelettes.

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.

Un certain nombre de préréglages sont fournis, ce qui devrait vous aider à comprendre les capacités du module.

Increase or decrease the overall brightness of an image.

Ce module a deux modes d’opération :

Manuel

Règle l’exposition manuellement, le niveau de noir et le seuil d’écrêtage

automatique (images RAW uniquement)

Analyse l’histogramme de l’image pour régler automatiquement l’exposition. Ansel sélectionne automatiquement la compensation d’exposition requise pour déplacer le percentile sélectionné vers le niveau cible sélectionné (voir les définitions ci-dessous). Ce mode est particulièrement utile pour modifier automatiquement un grand nombre d’images afin d’avoir la même exposition. Un cas d’utilisation typique du mode automatique est le scintillement des photographies en accéléré.

Remappe la gamme tonale d’une image en reproduisant la réponse tonale et colorée d’un film classique.

Ce module peut être utilisé soit pour élargir soit pour contracter la plage dynamique d’une scène pour rentrer dans la plage dynamique de l’affichage. Il protège les couleurs et le contraste dans les tons moyens, récupère les ombres et comprime les hautes lumières très brillantes et les ombres très sombres. Les hautes lumières auront besoin d’une attention particulière quand des détails doivent être préservés (comme des nuages).

Simule un filtre de densité gradué afin de corriger l’exposition et la couleur de manière progressive.

Une ligne apparaît à l’écran permettant de modifier à la souris la position et l’orientation du dégradé.

Ce module est connu pour provoquer des artefacts de bandes dans certaines conditions. Vous devriez envisager d’activer le module homogénéisation pour résoudre ces problèmes.

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.

Simulate physically-accurate blurs in scene-referred RGB space.

Simule le grain du film argentique. Le grain est traité sur le canal L de l’espace de couleur Lab.

Attempt to reconstruct color information for pixels that are clipped in one or more RGB channel.

Si des pixels restent partiellement écrêtés, des couleurs irréalistes peuvent apparaître dans l’image. Par exemple, les pixels avec les canaux vert et bleu écrêtés apparaissent rouges et les hautes lumières ne sont pas reconstruites.

Trois méthodes de reconstruction sont disponibles :

tronquer les hautes lumières

Limite tous les pixels au niveau de blanc (c’est-à-dire tronque les canaux de couleur restants). Cette méthode est particulièrement utile quand les hautes lumières écrêtées se produisent dans des objets naturellement désaturés (des nuages par exemple).

reconstruire dans LCh

Analyse chaque pixel ayant au moins un canal écrêté et essaye de le corriger (dans l’espace colorimétrique LCh) en utilisant les valeurs des autres pixels (3 pour Bayer ou 8 pour X-Trans) du bloc concerné du capteur. Les hautes lumières reconstruites sont toujours monochromes, mais plus lumineuses et avec plus de détails qu’avec tronquer les hautes lumières. Cette méthode fonctionne assez bien avec une courbe de base à contraste élevé qui désature les hautes lumières. Comme avec tronquer les hautes lumières cette méthode est une bonne option pour les objets naturellement désaturés.

reconstruire les couleurs

utilise un algorithme qui transfère les informations de couleur d’un environnement non écrêté dans les hautes lumières écrêtées. Cette méthode fonctionne très bien sur les zones aux couleurs homogènes et est particulièrement utile sur les tons chair avec des hautes lumières qui s’estompent en douceur. Veuillez noter que cette méthode peut produire des artefacts de type labyrinthe sur les hautes lumières derrière des bords à fort contraste, par exemple des structures fines bien exposées sur un arrière-plan surexposé.

guided laplacians

Use an algorithm (derived from the diffuse or sharpen module) to replicate details from valid channels into clipped channels and to propagate color gradients from valid surrounding regions into clipped regions. This is a slow and computationally-intensive method designed for maximum smoothness and seamless blending of the reconstructed regions into their neighborhood, and is designed primarily to reconstruct spotlights and specular reflections. This mode is available for Bayer sensors only.

Note: When using the highlight reconstruction included with the filmic rgb module it may be useful to avoid using this module in clip highlights mode (so that filmic rgb has more information to work with).

Ce module élimine une partie des artefacts typiques d’effet de bandes qui peuvent se produire lorsque les données internes en arithmétique flottante 32 bits sont transférées, pour l’affichage ou pour l’exportation, vers un format de sortie discret en entier 8 ou 16 bits .

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.

Corrige automatiquement (et simule) la distorsion de l’objectif, les aberrations chromatiques transversales (TCA) et le vignettage.

Ce module identifie la combinaison boîtier/objectif à partir des données Exif de l’image et utilise la bibliothèque externe lensfun  pour fournir des paramètres de correction.

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.

Déplace les pixels en appliquant des distorsions de style libre à des parties de l’image à l’aide de points, de lignes et de courbes.

Transforme les valeurs RVB grâce à un fichier 3D LUT.

Une LUT 3D est une table tridimensionnelle utilisée pour transformer une valeur RVB donnée en une autre valeur RVB. C’est normalement utilisé pour la simulation de film et la gradation de couleurs.

Ce module accepte les fichiers .cube, .3dl, .png (haldclut) et .gmz. Les données 3D LUT non compressées ne sont pas enregistrées dans la base de données ni dans le fichier XMP mais restent stockées dans les fichiers d’origine organisés sous le dossier racine 3D LUT (voir preferences > traitement > répertoire 3D lut racine). Il est donc important de sauvegarder correctement votre dossier LUT 3D – partager une image avec son XMP est inutile si le destinataire n’a pas également le même fichier LUT 3D dans son propre dossier LUT 3D.

Process scanned film negatives.

Vous pouvez obtenir l’image d’un négatif à l’aide d’un scanner de film, ou en le photographiant contre une lumière blanche (par exemple une table lumineuse ou un écran d’ordinateur) ou un flash externe.

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

L’outil niveau rvb présente un histogramme de l’image et affiche trois barres. Déplacez ces barres pour modifier les points noir, gris moyen et blanc en clarté avec le mode « RVB canaux liés » ou alors, indépendamment pour chacun des canaux R, V et B avec le mode « RVB, canaux indépendants ».

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.

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

Le module est actif par défaut et l’orientation (rotation) est fixée automatiquement d’après les données Exif de l’image.

The orientation can also be set using the selected images module in the lighttable view.

Automatically detect and eliminate hot pixels.

Les pixels chauds sont des pixels pour lesquels un enregistrement correct d’un niveau de lumière a échoué. Les pixels chauds détectés sont remplacés par une valeur moyenne de leurs voisins.

Define how Ansel will interpret the colors of the image.

Ce module prend l’espace colorimétrique utilisé par la source d’image (par exemple, appareil photo, scanner) et convertit l’encodage des pixels en un espace colorimétrique de travail standardisé. Cela signifie que les modules suivants dans le pipeline n’ont pas besoin de se préoccuper des spécificités du périphérique d’entrée et peuvent fonctionner avec et convertir vers/depuis un espace colorimétrique de travail commun.

Gère le profil de sortie pour l’exportation et l’intention de rendu à utiliser lors du mappage entre les espaces colorimétriques.

Ansel est livré avec des profils prédéfinis sRGB, Adobe RVB, XYZ et RVB linéaire. Vous pouvez fournir des profils supplémentaires en les plaçant dans $Ansel/share/Ansel/color/out et $HOME/.config/Ansel/color/out (où $Ansel est le répertoire d’installation de Ansel et $HOME est votre répertoire personnel).

Le profil de couleur de sortie peut également être défini dans le module exporter.

Define camera-specific black and white points.

Ce module est automatiquement activé sur toutes les images RAW. Les paramètres par défaut sont appliqués pour tous les appareils supportés. Il n’est normalement pas nécessaire de changer ces valeurs par défaut.

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.

Chaque fois que ce module est actif, l’image complète non recadrée est affichée, avec en surimpression des poignées de recadrage et des lignes de guidage facultatives.

Recover color information in blown-out highlights.

En raison de la nature des capteurs numériques, les hautes lumières surexposées manquent d’informations de couleur valides. Le plus souvent, ils apparaissent en blanc neutre ou présentent une certaine dominante de couleur, selon les autres étapes de traitement d’image impliquées. Ce module peut être utilisé pour « récupérer » les hautes lumières surexposées en remplaçant leurs couleurs par des couleurs mieux adaptées. Le module agit sur les pixels dont la luminance dépasse un seuil défini par l’utilisateur. Les couleurs de remplacement sont extraites des pixels voisins. La distance spatiale et la distance de luminance (plage) sont prises en compte pour la sélection des couleurs.

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.

Comme la réduction de bruit est un processus consommateur de ressources, il ralentit de manière significative le traitement du pipeline graphique. Il est donc préférable d’activer tardivement ce module dans votre flux de travail.

Perform denoising on raw image data before it is demosaiced.

Ce module a été porté à partir de dcraw .

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

Ce module fonctionne en augmentant le contraste autour des bords et en améliorant ainsi l’impression de netteté d’une image. Ce module modifie le canal L dans l’espace colorimétrique Lab.

Remarque: L’algorithme USM (UnSharp Mask) utilisé dans ce module opère dans l’espace colorimétrique Lab. Il peut produire des effets indésirables et n’est plus recommandé. Utilisez à la place les préréglages fournis par le module égaliseur de contraste pour atténuer le flou, ou par le module contraste local pour une netteté générale.

Supprime les éléments indésirables de votre image en copiant, corrigeant, floutant et remplissant à l’aide de formes dessinées.

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.

Corrige automatiquement les lignes convergentes, une forme de distorsion de perspective. Le mécanisme sous-jacent est inspiré du programme ShiftN  de Markus Hebel. Ce module permet également de régler la rotation de l’image.

Les distorsions de perspective sont un effet naturel lors de la projection d’une scène en trois dimensions sur un plan en deux dimensions et font apparaître les objets proches du spectateur plus grands que les objets éloignés. Les lignes convergentes sont un cas particulier de distorsions de perspective fréquemment observées dans les photographies d’architecture – les lignes parallèles, lorsque photographiées sous un certain angle, sont transformées en lignes convergentes qui se rencontrent en un point à l’intérieur ou à l’extérieur du cadre de l’image.

Les capteurs de certains appareils photographiques, comme Fujifilm FinePix S2Pro, F700, et E550, ont un modèle Bayer orienté diagonalement au lieu de la disposition orthogonale habituelle.

Sans correction cela conduirait à une image basculée, avec des coins noirs. Ce module applique la rotation nécessaire.

Ansel détecte les images nécessitant cette correction grâce à leurs données EXIF et active automatiquement ce module. Pour les autres images le module reste toujours désactivé.

Quelques boîtiers (comme le Nikon D1X) ont des cellules de capteur rectangulaires au lieu des cellules carrées habituelles. L’absence d’une correction conduirait à des images déformées. Ce module applique la mise à l’échelle requise.

Ansel détecte les images nécessitant cette correction grâce à leurs données EXIF et active automatiquement ce module. Pour les autres images le module reste toujours désactivé.

The module has no controls.

Automatiquement réduit l’effet de la poussière et de la brume dans l’air. Ce module peut aussi être employé pour renforcer la couleur spécifiquement dans les régions de faible contraste de l’image.

La brume absorbe la lumière des objets de la scène, mais c’est aussi une source de lumière de fond diffuse. Le module de suppression de brume estime d’abord pour chaque région de l’image la quantité de brume. Il supprime ensuite la lumière diffuse de fond en fonction de son niveau force local et restaure la lumière d’origine de l’objet.

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

Assombrir/éclaircir en préservant le 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.

Le schéma suivant décrit le fonctionnement de l’égaliseur de tons :

Apply a vignetting effect to the image.

Le vignetage est une modification de la luminosité et de la saturation aux bords de l’image dans une forme spécifiée. Plusieurs des paramètres répertoriés ci-dessous peuvent également être modifiés à l’aide du contrôle graphique qui se superpose l’image lorsque le module a le focus, montrant la forme et l’étendue de l’effet.

Remarque : Ce module est connu pour provoquer des artefacts de bandes dans certaines conditions. Vous pouvez utiliser le module homogénéisation pour résoudre ce problème.

Render a vector-based overlay onto your image. Watermarks are standard SVG documents and can be designed using Inkscape .

Vous pouvez également utiliser des images bitmap (PNG).

Le processeur SVG de Ansel peut également substituer des chaînes de caractères dans un document SVG, permettant d’inclure des informations associées à l’image dans le filigrane.

Les filigranes conçus par l’utilisateur doivent être placés dans le répertoire $HOME/.config/Ansel/watermarks. Une fois en place, utilisez le bouton de rechargement pour mettre à jour la liste des filigranes disponibles.

Ajuster la balance des blancs de l’image en modifiant la température et la teinte, en définissant un coefficient pour chaque canal RVB ou en choisissant dans la liste des paramètres de balance des blancs prédéfinis.

Les paramètres par défaut de ce module sont dérivés de la balance des blancs du boîtier stockée dans les données Exif de l’image.

La balance des blancs n’est pas conçue comme un module «créatif» – son objectif principal est de corriger techniquement la balance des blancs de l’image en s’assurant que les objets de couleur neutre de la scène sont rendus avec des couleurs neutres dans l’image. Pour les opérations créatives concernant la couleur, il est généralement préférable d’utiliser d’autres modules tels que le module calibration des couleurs ou le module balance couleur rvb.