Color management on Ansel

Transitioning from darktable to Ansel

Wed, 18 Jan 2023 00:00:00 +0000

This page was first written in January 2023, right after the fork, and listed what had already diverged from darktable 3.8/4.0. A lot has happened on both sides since. The sections below summarize the major changes; the gory technical details live in the news section of the website.

What changed in Ansel since 2023

Performance and reliability

The pixel pipeline has been completely overhauled: modules run about 1.8× faster on CPU and 1.6× faster on GPU than darktable, and — more importantly — the pipeline cache was rewritten so that disabling a module, using a color picker or re-exporting an already-exported image does not recompute the whole thing. That makes Ansel 4 to 100× faster than darktable to refresh the image. Memory management was rewritten too: Ansel knows exactly how much RAM it uses and stays within the budget you set, instead of darktable’s hand-wavy “performance profiles” that have no predictability.

Install

Sun, 11 Dec 2022 00:00:00 +0000

Dependencies for Source Builds

If you plan to build from source, the Ansel repository ships per-platform dependency installer scripts in packaging/. Use the script matching your OS (for example ./packaging/install-deps-ubuntu.sh, ./packaging/install-deps-macos.sh, or ./packaging/install-deps-windows-msys2.sh).

Understanding Ansel’s releases

Ansel channels

Ansel development and release path follows 3 channels :

A production channel :
1. Linked to the Git master branch ,
2. Contains tested code supposed to work reliably for daily use,
3. Contains features found under the Done column, in the project management board .
A pre-release channel :
1. Backward-compatible with the production channel (so you can switch from one to another without breaking your image edits),
2. Linked to the Git candidate branch ,
3. Contains code to test before integration in production channel but still relatively safe to use,
4. Contains features found under the Testing column, in the project management board .
An experimental channel :
1. non-backward-compatible with either the production or pre-release channels,
2. Linked to the Git dev branch ,
3. Contains features found under the In progress column, in the project management board ,
4. This channel needs to be used aside of the production install since it contains prototypes of new modules, new versions of old modules, and other features that will upgrade the version of the Ansel database, making it incompatible with previous versions. It can also contain prototypes that will never make it in production.

At all time, the project management Kanban board will show what changes are being currently worked on in the non-production channels, with links to their pull request and issue, to help traceability of changes and bug reports.

Install on Linux

Sun, 11 Dec 2022 00:00:00 +0000

Prérequis

Install your GPU OpenCL drivers if you have a GPU :

For Nvidia GPUs, OpenCL support is part of the CUDA proprietary driver and is not available with the open-source Nouveau driver:
- add Nvidia’s repository to your package manager ,
- install the CUDA packages ,
- Reboot.
- It is highly discouraged to manually install drivers through runfiles (.run) as it is riddled with problems you will need to manually fix everytime the Linux kernel is updated.
For AMD GPUs, the AMDGPU-Pro driver is recommended:
- download the relevant driver ,
- extract the archive ,
- Run the installation script:
  - If you want only the OpenCL driver, without video drivers and OpenGL (assuming your system already has some of those working): ./amdgpu-pro-install -y --opencl=pal,legacy --headless,
  - If you want the complete GPU stack (OpenCL/OpenGL, Vulkan, video drivers): ./amdgpu-pro-install -y --opencl=pal,legacyè
- Reboot.
For Intel embedded GPUs, the Neo driver provides support for OpenCL 3.0 on relatevly recent
- official driver releases contain the Ubuntu .deb packages, you need to install intel-opencl-icd_xxxx.deb,
- The safest way is to locate the intel-opencl-icd package in your distribution’s repository, and install it. It can be part of optional or third-party repositories for distributions leaning a bit too hard toward open-sourcery (Debian/Fedora).

If you don’t have a GPU, a manual build is recommended to get the best performance possible (see below).

Install on Windows

Sun, 11 Dec 2022 00:00:00 +0000

Prérequis

Install your OpenCL GPU drivers if you have a GPU.

On Windows 11, it seems that the system OpenCL drivers for Intel embedded GPU cause issues (black images), especially with newer generation CPU. You may want to remove Windows drivers and install Intel ones .

See the caveats section below for more details.

EXE package (recommended)

The Ansel project provides an official .exe package, built for the stable, pre-release and experimental channels. This is the recommended way of installing Ansel, since it is fresh from the repository, always up-to-date and ships updated lens databases for Lensfun.

Install on Mac OS

Sun, 11 Dec 2022 00:00:00 +0000

Build from source (Homebrew, recommended)

This method is derived from the repository scripts in packaging/macosx/.

Prérequis

Install Xcode Command Line Tools:
```
1xcode-select --install
```
Install Homebrew from https://brew.sh/ (use the default prefix: /opt/homebrew on Apple Silicon, /usr/local on Intel).

Steps

Clone the repository and submodules:

1git clone --depth 1 https://github.com/aurelienpierreeng/ansel.git
2cd ansel
3git submodule init
4git submodule update

Install build dependencies:
```
1./packaging/macosx/1_install_hb_dependencies.sh
```
This is the canonical dependency list used by CI and packaging.
Build and install into the local install/ directory:
```
1./packaging/macosx/2_build_hb_ansel_custom.sh
```
Edit packaging/macosx/2_build_hb_ansel_custom.sh if you need custom CMake options.
(Optional) Create a macOS application bundle (can be signed if you have a Developer ID):
```
1export CODECERT="your.developer@apple.id" # optional
2./packaging/macosx/3_make_hb_ansel_package.sh
```
The bundle is generated at install/package/Ansel.app.
(Optional) Generate a DMG image from the bundle:
```
1./packaging/macosx/4_make_hb_ansel_dmg.sh
```
The output is Ansel-<version>-<arch>.dmg in the install/ directory.

Running the build

Development install (after step 3):
```
1./install/bin/ansel
```

From the app bundle (after step 4):

1./install/package/Ansel.app/Contents/MacOS/ansel --configdir ~/.config/ansel --cachedir ~/.cache/ansel/

Notes and limitations

The DMG is not notarized. If Gatekeeper blocks it, remove the quarantine attribute:
```
1xattr -d com.apple.quarantine Ansel-*.dmg
```
The DMG is only guaranteed to run on the same macOS version it was built on.
Homebrew package versions define the library versions bundled into the app.

MacPorts method (legacy, Intel-only)

A legacy Intel-only method using MacPorts exists in packaging/macosx/BUILD.txt. It includes custom patches for gnutls and gtk-osx-application, and uses gtk-mac-bundler to produce a DMG. Use this only if you specifically need a MacPorts-based build.

Install OpenCL drivers

Tue, 27 Dec 2022 00:00:00 +0000

OpenCL is a vendor-agnostic and cross-platform way of offloading computations to the GPU. GPUs are designed specifically to handle pixel operations, with an optimized memory layout and a massively multi-core architecture¹ allowing for fast and energy-efficient image processing.

But OpenCL can only be used for background computational (offline rendering) tasks and cannot be used to render the GUI in real-time, which is the realm of OpenGL.

The architecture of Ansel and darktable pixel pipeline is flawed in that regard, because the output of (fast) OpenCL computations has to be sent back to the (slow) Gtk 3 thread, which paints the processed image within the GUI (along with the rest of GUI controls) using only a single CPU core. This is the biggest performance bottleneck in darktable and Ansel, and the reason why it is a rather slow application.

Configuration files

Wed, 18 Jan 2023 00:00:00 +0000

The configuration files of Ansel are located in :

$HOME/.config/ansel for Mac OS and Linux
C:\%LOCALAPPDATA%\ansel on Windows.

Default configuration files

anselrc: contains all user preferences except presets and styles. This may be opened in any text editor for manual edit if any preference makes the software crash at startup.
keyboardrc: contains all user-defined keyboard shortcuts.
data.db: contains user presets for modules, styles, tags and locations. This is an SQLite database. It is backed-up before updating to a new release and automatic snapshots can be configured (see below).
library.db: contains all images known to Ansel, along with their directories (dubbed film rolls). Like the previous, it is an SQLite database backed-up before updating to new releases and with optional snapshots.

The frequency of snapshots can be defined in the software global Preferences -> tab Storage -> section Database -> entry Create database snapshots and how many snapshot to keep. By default, Ansel saves one snapshot every week when closing the software.

Import configuration from darktable

Thu, 05 Jan 2023 00:00:00 +0000

Ansel is based on darktable 4.0 and configuration files of darktable 4.0.1 and prior can be seemlessly imported by Ansel, such that you recover your tags, styles, presets, and library of images.

Warning

Importing darktable 4.2 database into Ansel will make you lose the settings of filmic RGB, sigmoid and highlights reconstruction modules for all edits using them. Sigmoid is not and will never be supported into Ansel, and the nonsensical changes made to filmic RGB in darktable 4.2 will never be ported to Ansel. All other modules should still work.

Debugging

Sun, 22 Jan 2023 00:00:00 +0000

Ansel is written in the C language. While C pretends to be portable (runs the same on all operating systems), many little things need to be contextually adapted to each OS using slightly different code. Also, depending on hardware and on the version of the dependencies, even on Linux, some discrepancies can occur between distributions.

That is to say that bugs are almost impossible to anticipate when programming, and the default state of a computer program is buggy. Reporting bugs properly is the only way to help cleaning up the unforseen pathological cases.

Getting started

Thu, 15 May 2025 00:00:00 +0000

Ansel is a non-destructive RAW photo editor. It never modifies your original files: every change is stored as a recipe (an editing history) in a library database, and only written out to a real image file when you export. This means your originals stay safe, edits are reversible forever, and the same recipe can be applied to many images at once.

This section is a quick bootstrap. Each step links to a more detailed page and to the relevant view.

Import images

Mon, 24 Jun 2024 00:00:00 +0000

Basics

Ansel backbone is a library of images, saved as an SQLite database into ~/.config/ansel/library.db. Since Ansel is a non-destructive photo editor, editings are saved as histories of settings, along with image metadata, as text¹ into the library database. The application of editing histories over raw images, as to produce output raster images, is the export step.

The library is also used to keep track of image collections (by tags, folders, EXIF, editing time, etc.). Because of this, we need to make the library aware of new images : it is the import step. This will initialize a new database entry with metadata and a virgin history for each imported picture.

Editing images

Thu, 15 May 2025 00:00:00 +0000

Understanding non-destructive editing

Before diving deeper into how to use the software, we should stop here to explain its general paradigm : non-destructive editing.

Once you imported images to Ansel, what you really did is only to create an entry for them into the library database. The modifications you make on these images are never written to the original images, which are actually never changed. This is a strong design requirement aiming at protecting your input RAW images from any kind of corruption.¹ Ansel will not even let users change the EXIF date and time in the original files.

Library and collections

Thu, 15 May 2025 00:00:00 +0000

Ansel keeps a database of all images it knows, that is all images that were imported, until you actively remove them from the library (global menu : File 🡒 Remove from library). The library stores the filesystem path of the images, their metadata and their editing history.

Warning

Ansel does not listen to the content of filesystem folders, meaning it will not be notified if imported images are (re)moved on the filesystem. You will need to manually update the pathes if that is the case, or you can move those files directly with Ansel (under the global menu File).

Image selection

Thu, 15 May 2025 00:00:00 +0000

Ansel allows batch-applying editing histories (through copy-pasting, or through styles) or metadata. The target images for those batch-operations are selected images. But even single-image operations (like opening in darkroom to edit, or editing metadata, copy/pasting, etc.) use selections.

Selections are particular objects in Ansel, because :

They are remembered between reboots and across ateliers (views) changes,
They are global in the sofware and used to pass on lists of images between lighttable and other ateliers,
They are disabled and inactive within an atelier (except for the lighttable), which use active images instead (contextual selection),
They are necessarily a subset of the current filtered collection (as displayed in the lighttable),
They can be set only from the lighttable view (no selection can be performed or used from the filmstrip),
They can be turned into a temporary collection themselves, by using the Restrict to selection button in the include/filter toolbar of the lighttable.

Selected images will appear highlighted in the lighttable. Because selections are used to perform (possibly harmful) write operations, Ansel forces “hard” interactions (pressing on an hardware button) on thumbnails to define them. These allowed interactions are :

Shortcuts and keyboard interaction

Sat, 10 May 2025 00:00:00 +0000

Ansel interface is designed to support two mutually-exclusive modes of interaction and navigation: through pointing devices (mouse or graphic tablet) and through the keyboard. Compared to Darktable, many interactions that required combinations of both have been removed, which makes the workflows more efficient.

Shortcuts and available actions

Ansel exposes app-wise actions and GUI controls to keyboard bindings through pathes like Darkroom/Modules/Exposure/Black point, where the left-most member of the path is the view and the right-most member is the actual control being bound. A such path defines an human-readable unique identifier that also says where the control is located in the application GUI.

Vues

Sun, 04 Dec 2022 02:19:02 +0100

Ansel répartit ses fonctionnalités en plusieurs vues, chacune dédiée à une tâche :

Table lumineuse: Gérez, triez, sélectionnez et étiquetez votre collection d’images. C’est la vue par défaut, chargée au démarrage, et vous pouvez y revenir depuis n’importe où en appuyant sur Échap.
Chambre noire: Développez une seule image. Ouvrez-la depuis la table lumineuse en double-cliquant sur une miniature, ou en sélectionnant une image et en appuyant sur Entrée.
Carte: Affichez les images géolocalisées sur une carte et géolocalisez manuellement de nouvelles images. Masquée par défaut ; activez-la dans les préférences.
Impression: Envoyez des images à une imprimante. Masquée par défaut ; activez-la dans les préférences. Non disponible sous Windows, car elle s’appuie sur CUPS .
Studio Capture: Dedicated view for tethered shooting sessions.
Diaporama: Affichez les images en plein écran sous forme de diaporama, en les traitant à la volée. Masquée par défaut ; activez-la dans les préférences.

Vous changez de vue depuis le menu Ateliers dans la barre de menus supérieure, qui liste toutes les vues disponibles et le raccourci pour les atteindre (la vue actuelle est grisée). La chambre noire est l’exception : comme elle a besoin d’une image pour s’ouvrir, vous y entrez depuis une miniature de la table lumineuse ou de la pellicule, et non depuis le menu.

Menu global

Tue, 16 Jun 2026 00:00:00 +0000

La barre de menus globale se trouve en haut à gauche de l’en-tête et est disponible dans toutes les vues. Elle rassemble les commandes valables pour toute l’application, les opérations sur les images, la gestion de l’historique et des styles, les tâches de maintenance, les paramètres d’affichage, le changement de vue et l’aide. C’est le point de référence central de l’interface : la plupart des commandes qui ne sont pas un réglage propre à un module se trouvent ici.

Table lumineuse

Sun, 04 Dec 2022 02:19:02 +0100

La vue table lumineuse est la vue chargée par défaut au démarrage d’Ansel, et vous permet de visualiser et de gérer votre collection d’images. Elle vous permet notamment de :

Trier vos images, leur attribuer des évaluations et finalement décider quelles images valent la peine d’être conservées et éditées,
Filtrer vos images selon les évaluations, le dossier de base ou toute métadonnée prise en charge par le logiciel (EXIF/IPTC/XMP),
Appliquer des métadonnées, comme le titre, la description, les mots-clés, les coordonnées GPS, ou corriger la date/heure EXIF,
Copier-coller les historiques d’édition entre images ou appliquer des styles, individuellement ou par lots,
Exporter les historiques d’édition des images vers des fichiers finaux.

Contenu de la table lumineuse

Toutes les images connues d’Ansel sont stockées dans une base de données, la bibliothèque. La table lumineuse affiche les miniatures d’un sous-ensemble de cette bibliothèque, appelé collection. Une collection est créée en filtrant les images de la bibliothèque selon des critères, d’abord depuis la boîte à outils bibliothèque, puis depuis la barre d’outils de filtrage/inclusion.

Annuler/refaire

Sun, 04 Dec 2022 02:19:02 +0100

La plupart des modifications effectuées dans la table lumineuse sont enregistrées et peuvent être ramenées à un état antérieur. Cela inclut les modifications apportées aux labels de couleur, aux évaluations, à la géolocalisation, aux mots-clés, aux métadonnées, à l’orientation, au copier/coller de l’historique, au clonage de l’image ou à l’application d’un style. La fonction annuler/refaire accepte un nombre illimité d’étapes tant que vous restez dans la table lumineuse, mais elle est réinitialisée à chaque fois que vous passez à une autre vue.

Copier et coller l'historique

Tue, 16 Jun 2026 00:00:00 +0000

Transférer la recette d’édition d’une image vers une ou plusieurs autres. Le résultat est une fusion de l’historique source dans chaque image de destination — et non un écrasement aveugle — ce qui signifie que vous disposez d’un contrôle fin sur la manière dont les conflits entre les deux historiques sont résolus.

Le copier-coller est disponible depuis le menu Édition dans n’importe quelle vue, et les raccourcis clavier fonctionnent à la fois dans la table lumineuse et dans la chambre noire.

Gestion des actifs numériques

Sun, 04 Dec 2022 02:19:02 +0100

Au-delà de l’édition des pixels, Ansel garde une trace de vos images et du travail que vous effectuez dessus. C’est la gestion des actifs numériques (DAM) : organiser, décrire, évaluer, grouper et protéger votre collection afin qu’elle reste consultable et récupérable au fil du temps.

Les pages de cette section décrivent comment ces informations sont stockées et utilisées :

Fichiers liés — comment les modifications et les métadonnées sont enregistrées à côté de vos originaux sous forme de fichiers XMP, et l’importation de fichiers liés depuis d’autres logiciels.
Évaluation par étoiles et labels de couleur — classer et catégoriser les images pour le tri.
Métadonnées et mots-clés — texte descriptif et mots-clés.
Groupement d’images — empiler ensemble des images apparentées.
Copies locales — travailler hors site et resynchroniser plus tard.
Miniatures — comment les aperçus sont générés et mis en cache.

Fichiers liés

Sun, 04 Dec 2022 02:19:02 +0100

Ansel est un éditeur d’images non destructif et ouvre toutes les images en lecture seule. Toutes les données créées dans Ansel (métadonnées, mots-clés et étapes de traitement de l’image) sont stockées dans des fichiers .XMP séparés appelés fichiers liés. Ces fichiers sont stockés à côté des fichiers RAW d’origine et permettent à Ansel de stocker des informations concernant les images ainsi que l’historique complet d’édition sans toucher aux fichiers RAW originaux. Lorsque vous importez une image dans Ansel pour la première fois, un fichier XMP est automatiquement généré. La génération des fichiers XMP peut être désactivée dans préférences > stockage > xmp mais ceci n’est pas recommandé dans un usage normal.

Importer des fichiers liés générés par d'autres applications

Sun, 04 Dec 2022 02:19:02 +0100

Lors de l’importation d’une image, Ansel vérifie automatiquement si elle est accompagnée d’un fichier lié. En plus de rechercher les fichiers nommés <basename>.<extension>.xmp et <basename>_nn.<extension>.xmp (les formats de nommage des fichiers XMP d’Ansel), Ansel vérifie également la présence d’un fichier sous la forme <basename>.xmp (le format de nommage des fichiers liés XMP de Lightroom). Les fichiers ayant ce dernier format de nommage seront lus par Ansel mais ne seront pas écrits. Une fois l’image importée, Ansel générera un fichier XMP supplémentaire en utilisant sa propre convention de nommage.

Copies locales

Sun, 04 Dec 2022 02:19:02 +0100

De nombreux utilisateurs ont d’énormes collections d’images stockées sur des disques durs supplémentaires dans leur ordinateur de bureau ou sur un support de stockage externe (NAS RAID, disques durs externes, etc.).

Il est fréquent de vouloir développer un certain nombre d’images en déplacement à l’aide d’un ordinateur portable, puis de les resynchroniser ultérieurement vers le support de stockage d’origine. Cependant, copier manuellement les images du stockage principal vers l’ordinateur portable et inversement est fastidieux et source d’erreurs. La fonctionnalité de « copies locales » d’Ansel a été conçue pour prendre directement en charge ces cas d’utilisation.

Miniatures

Sun, 04 Dec 2022 02:19:02 +0100

Chaque image de la collection actuelle est représentée par une miniature dans la vue table lumineuse et le module pellicule. Un cache des miniatures les plus récemment utilisées est stocké dans un fichier sur le disque et chargé en mémoire au démarrage. La taille de ce cache peut être ajustée dans Préférences > Traitement > CPU, GPU, Mémoire.

Création des miniatures

Une miniature est créée quand Ansel importe une image pour la première fois, quand une image a été modifiée dans la chambre noire, ou quand on revisite une image dont la miniature n’est plus disponible.

Évaluation par étoiles et labels de couleur

Sun, 04 Dec 2022 02:19:02 +0100

Les évaluations par étoiles et les labels de couleur vous aident à sélectionner et à classer les images selon vos propres critères. Évaluations par étoiles et labels de couleur peuvent être affichés sur les miniatures de la vue table lumineuse et de la pellicule.

Évaluation par étoiles

Vous pouvez attribuer à une image une évaluation de zéro à cinq étoiles. Lors de chaque importation, chaque image reçoit une évaluation par défaut que vous pouvez définir dans le module importer. Vous pouvez également marquer une image comme « rejetée ».

Groupement d'images

Sun, 04 Dec 2022 02:19:02 +0100

Grouper des images aide à améliorer la structure et la clarté de votre collection d’images lorsqu’elle est affichée dans la vue table lumineuse.

Vous pouvez combiner des images en un groupe en les sélectionnant et en utilisant le menu global Image 🡒 Grouper les images (Ctrl+G). De même, retirez les images sélectionnées d’un groupe avec Image 🡒 Dégrouper les images (Ctrl+Maj+G).

Les images clonées sont automatiquement placées dans un groupe. De même, si vous importez plusieurs images d’un même répertoire, ayant le même nom de base, mais des extensions différentes (par exemple IMG_1234.CR2 et IMG_1234.JPG), ces images forment automatiquement un groupe.

Métadonnées et mots-clés

Sun, 04 Dec 2022 02:19:02 +0100

Ansel vous permet de stocker des informations supplémentaires concernant vos images pour leur permettre d’être plus facilement recherchées et groupées. Ces informations sont stockées dans la base de données de Ansel et dans des fichiers liés XMP. Elles peuvent également être incluses dans les images exportées.

Métadonnées

Les métadonnées (par exemple le titre, la description) sont des textes de format libre, généralement différents pour chaque image. Vous pouvez ajouter des métadonnées aux images dans le module éditeur de métadonnées.

Chambre noire

Sun, 04 Dec 2022 02:19:02 +0100

La vue chambre noire est l’endroit où vous développez une seule image. La zone centrale affiche l’image en cours d’édition ; le panneau gauche contient les outils périphériques (navigation, scopes, instantanés, historique…), et le panneau droit contient les modules de traitement d’image.

Ouvrez la chambre noire depuis la table lumineuse en double-cliquant sur une miniature, ou en sélectionnant une image et en appuyant sur Entrée. Revenez à la table lumineuse avec Échap (ou le bouton maison dans l’en-tête). Vous pouvez basculer vers une autre image sans quitter la chambre noire en activant la pellicule (Ctrl+Maj+F) et en cliquant sur une miniature.

Disposition de la vue chambre noire

Sun, 04 Dec 2022 02:19:02 +0100

La chambre noire entoure l’image centrale d’un panneau gauche d’outils périphériques, d’un panneau droit de modules de traitement d’image, et d’une barre d’outils inférieure de superpositions d’évaluation visuelle. Une pellicule optionnelle (Ctrl+Maj+F) peut être affichée en bas pour une navigation rapide dans la collection actuelle.

Panneau gauche

Affiché et masqué avec Ctrl+Maj+L. Il contient les outils périphériques qui assistent l’édition (mais ne traitent pas eux-mêmes les pixels) :

Le pixelpipe

Sun, 04 Dec 2022 02:19:02 +0100

Le pixelpipe est la séquence ordonnée de modules de traitement qui transforme votre fichier RAW original en l’image que vous voyez et exportez. Chaque module prend la sortie du précédent comme entrée, applique une opération, et transmet son résultat au module suivant — exactement comme une pile de calques d’ajustement, appliqués de bas en haut.

flowchart LR
RAW([fichier RAW]) --> M1[module 1] --> M2[module 2] --> M3[module n] --> OUT([image de sortie])

Rien n’est jamais réécrit dans votre fichier original : le pixelpipe est ré-exécuté à la demande à partir du RAW et de votre historique, à la fois pour l’aperçu à l’écran et pour l’exportation finale.

L'anatomie d'un module de traitement

Sun, 04 Dec 2022 02:19:02 +0100

L’élément de base du traitement d’image dans Ansel est le module de traitement. Afin de traiter une image raw, un certain nombre de ces modules agissent en séquence sur l’image d’entrée, chacun effectuant une opération différente sur les données de l’image. Pour ceux qui sont familiers avec Adobe Photoshop, le concept de module de traitement dans Ansel est analogue à celui de calque d’ajustement, car tous deux effectuent un ajustement incrémental de l’image, en s’appuyant sur les ajustements précédents.

Le pixelpipe et l'ordre des modules

Sun, 04 Dec 2022 02:19:02 +0100

La séquence ordonnée de modules de traitement opérant sur un fichier d’entrée pour générer une image de sortie est connue sous le nom de « pixelpipe ».

L’ordre des modules du pipeline graphique est représenté graphiquement par l’ordre dans lequel les modules sont présentés dans l’interface utilisateur – le pipeline graphique commence par une image RAW en bas de la liste des modules, et applique les modules de traitement un par un, en empilant une à une les couches de traitement de bas en haut, jusqu’à ce qu’il atteigne le haut de la liste, où il produit l’image entièrement traitée.

L'historique

Sun, 04 Dec 2022 02:19:02 +0100

L’historique stocke l’intégralité de l’historique de développement pour une image donnée, dans l’ordre dans lequel les modifications ont été appliquées. Il est enregistré dans la base de données de la bibliothèque de Ansel et dans le fichier lié XMP de l’image et persiste entre les sessions d’édition.

Chaque fois qu’un module de traitement est activé, désactivé, déplacé ou modifié, une nouvelle entrée est ajoutée en haut de l’historique.

L’historique peut être consulté et modifié dans le module historique de la chambre noire.

Annuler et refaire

Sun, 04 Dec 2022 02:19:02 +0100

Pendant que vous développez votre image, Ansel enregistre toutes les modifications que vous apportez à cette image. Cela signifie qu’il est possible d’annuler et de refaire les modifications pour récupérer un état d’édition précédent. Notez que la fonction annuler/refaire est illimitée en nombre d’étapes lors du développement d’une image, mais elle est réinitialisée chaque fois que la chambre noire passe à une nouvelle image.

Tapez Ctrl+Z pour annuler la dernière modification et Ctrl+Y pour refaire la dernière modification annulée (s’il y en a une).

Masquage et fusion

Sun, 04 Dec 2022 02:19:02 +0100

Masking and blending decide how much of a processing module’s effect actually reaches the image, and where – from applying it uniformly across the whole frame down to targeting a handful of pixels.

Each module takes its input from the preceding module in the pixelpipe, performs its operation, and hands the output to the next module. Blending is the optional step in between: a module’s output data can be reprocessed (combined) with its input data using algorithms called blending operators, or blend modes, before being handed onward.

Modes de fusion

Sun, 04 Dec 2022 02:19:02 +0100

Les modes de fusion définissent la manière dont l’entrée et la sortie d’un module sont combinées (fusionnées) avant que la sortie finale du module ne soit transmise au module suivant dans le pixelpipe.

Classic blending modes, designed for display-referred RGB (constrained to 0-100%), implicitly define a fulcrum at 50% (gray) or 100% (white) in their algorithms, depending on the blend mode. Because scene-referred is not subject to these restrictions, this fulcrum needs to be explicitly defined by the user when performing blending operations in the “RGB (scene)” color space. The additional blend fulcrum parameter will be presented to the user when using one of these blend modes in this color space. The effect depends on the operator used. For example, values above the fulcrum might be brightened and values below darkened, or vice versa.

Masques

Sun, 04 Dec 2022 02:19:02 +0100

Masks limit a module’s effect to certain parts of the image, so that a correction lands where you want it and leaves the rest of the picture untouched.

A mask is best pictured as a grayscale image laid over the picture: each pixel holds a value between 0 and 1.0 (0% to 100%), and that value is the opacity handed to blending. An opacity of 0 leaves a pixel exactly as the module received it, 1.0 gives it the module’s full effect, and values in between apply it proportionally.

Masques dessinés

Sun, 04 Dec 2022 02:19:02 +0100

Un masque dessiné construit l’opacité pixel par pixel transmise à la fusion à partir de formes que vous dessinez directement sur l’image : l’effet d’un module s’applique donc exactement là où vous les placez.

Les formes sont stockées en interne sous forme de vecteurs, rendues à la résolution dont le pipeline graphique a besoin, et exprimées dans le système de coordonnées de l’image d’origine. Une forme couvre donc toujours la même partie de l’image, quoi que vous changiez par ailleurs dans le développement – avec un effet visuel secondaire qu’il vaut mieux connaître, voir distorsions des formes plus bas. Une fois dessinée, une forme peut être ajustée, supprimée ou réutilisée par n’importe quel autre module.

Masques paramétriques

Sun, 04 Dec 2022 02:19:02 +0100

The parametric mask feature offers fine-grained selective control over how individual pixels are masked. It does this by automatically generating an intermediate blend mask from user-defined parameters. These parameters are color coordinates rather than the geometrical coordinates used in drawn masks.

For each data channel of a module (e.g. Lab, RGB) and several virtual data channels (e.g. hue, saturation) you can construct a per-channel opacity function. Depending on each pixel’s value for a given data channel this function calculates a blending factor between 0 and 1 (100%) for that pixel.

Combiner les masques dessinés et paramétriques

Sun, 04 Dec 2022 02:19:02 +0100

Masques dessinés et paramétriques peuvent être utilisés conjointement pour former un masque unique pouvant être appliqué à un module.

Deux éléments principaux contrôlent la façon dont les masques individuels sont combinés : le réglage de la polarité de chaque masque individuel (défini par les boutons plus ou moins) et le réglage dans le menu déroulant « combinaison des masques ».

Le menu déroulant « combinaison des masques » contient les options suivantes, définissant comment les masques dessinés et paramétriques seront combinés :

Contours du masque

Sun, 04 Dec 2022 02:19:02 +0100

Lorsqu’un masque paramétrique ou dessiné est actif, plusieurs curseurs supplémentaires s’affichent pour permettre d’affiner le masque.

details threshold (deprecated): This control allows you to alter the opacity of the mask based on the amount of detail in the image. Use this slider to select either areas with lots of detail (positive values) or areas that are flat and lacking in detail (negative values). The default (zero) effectively bypasses details refinement. This is mostly useful to apply sharpening and blurring effects that ignore out-of-focus (bokeh) regions or to sharpen only blurry parts, preventing over-sharpening of in-focus regions.

Note

Masques raster

Sun, 04 Dec 2022 02:19:02 +0100

Comme décrit dans les sections précédentes, la sortie finale du masque d’un module (l’effet combiné de tous les masques dessinés et paramétriques) est une image raster en niveaux de gris Indiquant dans quelle mesure l’effet du module doit être appliqué à chaque pixel. Cette image raster est stockée en interne pour les modules actifs et peut être réutilisée par la suite par d’autres modules dans le pipeline graphique.

Comme avec tout masque, si la valeur d’opacité d’un pixel dans un masque raster est égale à zéro, le module n’a aucun effet sur ce pixel. Si l’opacité d’un pixel est égale à 1, le module a son plein effet sur ce pixel. Si l’opacité d’un pixel est comprise entre 0 et 1, l’effet du module sur ce pixel est appliqué proportionnellement à cette opacité.

Processing modules

Sun, 04 Dec 2022 02:19:02 +0100

Virage partiel

Fri, 03 Apr 2026 00:00:00 +0200

Fusionne deux corrections CAT16 plus mélangeur RVB à travers des images-clés de luminosité.

Le module virage partiel applique deux transformations de couleur indépendantes :

une calée sur les tons sombres,
une calée sur les tons clairs.

Chaque image-clé combine :

une adaptation chromatique définie par une température de couleur corrélée en CAT16,
un mélangeur de canaux RVB 3×3 travaillant dans l’espace de travail RVB du pipeline.

Les deux transformations sont ensuite interpolées en fonction de la luminance de la scène de chaque pixel. Cela rend le module adapté à la fois au virage partiel créatif et à la correction technique d’illuminants mixtes, par exemple une lumière de rebond froide dans les ombres combinée à un illuminant direct plus chaud dans les hautes lumières.

Color primaries

Wed, 01 Apr 2026 00:00:00 +0200

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.

Color equalizer

Mon, 30 Mar 2026 00:00:00 +0200

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.

Photographic grain

Mon, 23 Mar 2026 00:00:00 +0100

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.

Drawing

Sun, 08 Mar 2026 00:00:00 +0100

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.

Final resampling

Sat, 21 Jan 2023 00:00:00 +0000

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. It has no effect if the image is exported at its full (original) resolution either.

Aberrations chromatiques raw

Sun, 04 Dec 2022 02:19:02 +0100

Corrige les aberrations chromatiques des images raw.

Comme ce module opère sur des données raw non dématriçées, le modèle sous-jacent suppose une image photographique non recadrée en entrée. Il est donc susceptible d’échouer lorsque vous zoomez, car il ne peut opérer que sur la partie visible de l’image. Le module sera donc contourné aux niveaux de zoom élevés, et un message « contourné » apparaîtra en haut du module. Cette limitation ne s’applique qu’au travail interactif et non à l’exportation finale.

Astrophoto denoise

Sun, 04 Dec 2022 02:19:02 +0100

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.

Balance des couleurs

Sun, 04 Dec 2022 02:19:02 +0100

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

Ce module ne convient pas aux débutants n’ayant aucune connaissance préalable de la théorie des couleurs, qui pourraient préférer s’en tenir aux réglages chroma globale et vibrance globale jusqu’à ce qu’ils aient une bonne compréhension des dimensions de la couleur.

Introduction

La gradation de couleurs est une partie importante de l’édition d’images. Elle peut aider à éliminer les dominantes indésirables et peut également apporter une touche de couleur créative qui ajoutera une atmosphère à vos images. À l’époque de la photographie argentique, la majeure partie de l’ambiance des couleurs était due au film et aux produits chimiques de développement, avec un étalonnage basique effectué sous l’agrandisseur avec des têtes couleur. Cela consommait des ressources coûteuses et était principalement réservé à l’industrie du cinéma, où le travail était effectué par un coloriste.

Calibration des couleurs

Sun, 04 Dec 2022 02:19:02 +0100

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 :

Pour régler la balance des blancs (adaptation chromatique), en travaillant en tandem avec le module balance des blancs. Ici, le module balance des blancs effectue quelques réglages initiaux (requis pour que le module dématriçage fonctionne efficacement), puis le module calibration des couleurs calcule ensuite une balance des blancs perceptuellement plus précise une fois que le profil de couleur d’entrée a été appliqué.

Censorize

Sun, 04 Dec 2022 02:19:02 +0100

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

Chromatic aberrations

Sun, 04 Dec 2022 02:19:02 +0100

Correct chromatic aberrations.

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

Workflow

Pour obtenir le meilleur résultat, il est conseillé de procéder comme suit :

Atténuer au maximum les aberrations chromatiques dans le module correction des objectifs à l’aide des curseurs AC.
Augmenter la force dans ce module pour mieux voir son effet.
Augmenter le rayon jusqu’à ce que les aberrations chromatiques disparaissent. Si cela est insuffisant, essayez d’activer le paramètre “« berrations chromatiques très larges ».
Choisir le guide qui donne le meilleur résultat en terme de netteté et d’artefacts.
Réduire la force pour éviter de trop « lessiver » les couleurs.

Pour les cas plus compliqués, vous pouvez également essayer ce qui suit :

Color look up table

Sun, 04 Dec 2022 02:19:02 +0100

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

Contrôles du module

color board: The color board grid shows a list of colored patches. The colors of the patches are the source points. The target color of the selected patch is shown as offsets which are controlled by sliders beneath the color board. An outline is drawn around patches that have been altered (where the source and target colors differ).; Cliquez sur une pastille pour la sélectionner, ou alors utilisez la zone de liste déroulante pastille ou la pipette de couleur. La pastille actuellement sélectionnée est marquée d’un carré blanc et son numéro est affiché dans la zone de liste déroulante.

Color reconstruction

Sun, 04 Dec 2022 02:19:02 +0100

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.

Color zones

Sun, 04 Dec 2022 02:19:02 +0100

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.

Contraste local

Sun, 04 Dec 2022 02:19:02 +0100

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.

Contrôles du module

mode: Choix du filtre laplacien local ou de la grille bilatérale. Les sections suivantes définissent les commandes disponibles pour chacun de ces modes.

Grille bilatérale

granularité: Rend plus fins ou plus grossiers les détails que vous désirez ajuster.
contraste: Contrôle la force avec laquelle l’algorithme distingue les niveaux de luminosité. Augmentez ce paramètre pour un aspect plus contrasté.
détail: Ajoute ou supprime des détails. Des valeurs plus élevées augmentent le contraste local.

Laplacien local

Pour comprendre les paramètres du filtre laplacien local, on peut le considérer comme l’application à l’image d’une courbe semblable à celle de ce dessin :

Correction des objectifs

Sun, 04 Dec 2022 02:19:02 +0100

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, then corrects each flaw from one of two places: a community profile from the calibration database that ships with Ansel, or a vendor profile your own camera wrote into the raw file. See where corrections come from below.

The database is built from the calibrations published by the lensfun project , whose community measures and maintains them. Ansel does not use the lensfun library itself to correct your pictures — it reads the calibrations and does the arithmetic on its own, which is what lets the correction run on the GPU — but the profiles are lensfun’s, and everything below about finding, adding or creating a profile applies unchanged.

Courbe

Sun, 04 Dec 2022 02:19:02 +0100

Un outil classique de photographie numérique pour modifier les tons d’une image à l’aide de courbes.

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.

Crop

Sun, 04 Dec 2022 02:19:02 +0100

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.

Dématriçage

Sun, 04 Dec 2022 02:19:02 +0100

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

Filtres de Bayer

Les cellules du capteur d’un appareil photo numérique ne sont pas sensibles à la couleur – elles ne peuvent enregistrer que différents niveaux de clarté. Afin d’obtenir une image en couleur, chaque cellule est recouverte d’un filtre coloré (rouge, vert ou bleu) qui laisse passer principalement la lumière de cette couleur. Cela signifie que chaque pixel de l’image raw ne contient que des informations sur un seul canal de couleur.

Denoise (profiled)

Sun, 04 Dec 2022 02:19:02 +0100

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.

Diffuse or sharpen

Sun, 04 Dec 2022 02:19:02 +0100

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.

Égaliseur de contraste

Sun, 04 Dec 2022 02:19:02 +0100

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

Ce module polyvalent peut être utilisé pour obtenir une variété d’effets, notamment le halo lumineux (bloom), la réduction du bruit, la clarté et l’amélioration du contraste local.

Il fonctionne dans le domaine des ondelettes et ses paramètres peuvent être ajustés indépendamment pour chaque échelle de détail d’ondelettes. Le module opère dans l’espace colorimétrique CIE LCh et est donc capable de traiter indépendamment la luminosité et la chromaticité.

Exposure

Sun, 04 Dec 2022 02:19:02 +0100

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

Contrôles du module

mode: Sélectionne le mode de fonctionnement (automatique/manuel).
compense l’exposition de l’appareil photo (mode manuel): Compense automatiquement le biais d’exposition de l’appareil photo (fourni par les données Exif de l’image).
exposure (manual mode): Increase (move to the right) or decrease (move to the left) the exposure value (EV). To adjust by more than the default limits shown on the slider, right click and enter the desired value up to +/-18 EV.; The color picker tool on the right sets the exposure such that the average of the selected region matches the target lightness defined in spot exposure mapping options.
seuil d’écrêtage (mode manuel): Définit le pourcentage de valeurs lumineuses à écrêter dans le calcul de l’exposition et de la correction du niveau du noir. Utilisez la pipette de couleur pour échantillonner la partie de l’image à utiliser pour ce calcul.
centile (mode automatique): Définit l’emplacement dans l’histogramme à utiliser pour la correction automatique de l’exposition. Un centile de 50 % indique une position dans l’histogramme où 50 % des valeurs de pixels sont au-dessus et 50 % des valeurs de pixels sont en dessous de cette exposition.
niveau cible (mode automatique): Définit le niveau cible de la correction d’exposition automatique (IL) par rapport au point blanc de l’appareil photo.
correction du niveau du noir (modes manuel et automatique): Ajuste le point de niveau de noir pour éliminer les valeurs RVB négatives.

Note: Do not use the black level correction to add more density in blacks as this can clip near-black colors out of gamut by generating negative RGB values. This can cause problems with some modules later in the pixelpipe. Instead, use a tone mapping curve to add density to the blacks. For example, you can use the relative black exposure slider on the scene tab of the filmic rgb module.

Filmic

Sun, 04 Dec 2022 02:19:02 +0100

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

Flou de surface

Sun, 04 Dec 2022 02:19:02 +0100

Lisse les surfaces de l’image tout en préservant les bords nets à l’aide d’un filtre bilatéral.

Ce module peut être utilisé pour réduire le bruit des images, cependant vous devez savoir que les filtres bilatéraux sont sensibles aux dépassements et qu’Ansel offre de bien meilleures alternatives. Par exemple, le module réduction du bruit astrophoto utilise un algorithme de réduction du bruit par moyennes non locales, et le module réduction du bruit (par profil) offre le choix entre les algorithmes de réduction du bruit par moyennes non locales et par ondelettes.

Flous

Sun, 04 Dec 2022 02:19:02 +0100

Simule des flous physiquement réalistes dans l’espace RVB relatif à la scène.

Types de flou

Trois types de flous sont fournis :

flou d’objectif : Simule un diaphragme d’objectif avec un nombre de lamelles et une courbure de lamelle configurables pour créer un bokeh synthétique.
flou de mouvement : Simule l’effet d’un mouvement de l’appareil avec un tracé configurable.
flou gaussien : Ce n’est pas vraiment un flou optique mais peut être utilisé pour la réduction du bruit ou pour des effets créatifs à l’aide des modes de fusion

Un graphe en haut du module montre la forme de l’opérateur de flou (connu sous le nom de fonction d’étalement du point ). Le module va transformer chaque point lumineux de la scène en une tache de la même forme que l’opérateur de flou, de la taille définie par le rayon du flou.

Framing

Sun, 04 Dec 2022 02:19:02 +0100

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.

Contrôles du module

border size: The size of the frame as a percentage of the underlying full image.
aspect: Le rapport hauteur/largeur de la sortie finale du module (c’est-à-dire de l’image sous-jacente plus le cadre)
orientation: L’orientation du cadre (portrait/paysage). Sélectionnez ‘auto’ pour que Ansel choisisse l’orientation la plus raisonnable en fonction de l’image sous-jacente.
position horizontale/verticale: Faites votre choix parmi un ensemble de rapports prédéfinis définissant où vous voulez que votre image sous-jacente soit positionnée sur l’axe horizontal/vertical. Vous pouvez également cliquer avec le bouton droit de la souris et saisir votre propre ratio sous la forme “x/y”.
taille du cadre interne: La taille en pourcentage de la ligne au milieu du cadre par rapport à la largeur totale du cadre dans sa plus petite partie.
décalage du cadre interne: La position de la ligne au milieu du cadre, par rapport à l’image sous-jacente. Choisissez 0% pour que la ligne touche l’image. Choisissez 100% pour que la ligne touche la bordure extérieure.
couleur de la bordure/couleur du cadre interne: Paire de sélecteurs de couleur qui permettent de définir les couleurs de la bordure et du cadre. Cliquer sur le champ coloré ouvrira une boîte de dialogue de sélection de couleur qui offre un choix des couleurs couramment utilisées, ou vous permet de définir une couleur dans l’espace colorimétrique RVB. Vous pouvez aussi activer une pipette de couleur pour sélectionner une couleur dans l’image.
montrer les guides: Cochez la case pour afficher les superpositions de guides chaque fois que le module est activé. Cliquez sur l’icône à droite pour contrôler les propriétés des guides. Voir guides et superpositions pour plus de détails.

Graduated density

Sun, 04 Dec 2022 02:19:02 +0100

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.

Contrôles du module

densité: Règle la densité du filtre (IL). Une valeur faible sous-expose légèrement alors qu’une valeur élevée crée un filtre puissant.
dureté: La progressivité du gradient. Une valeur faible crée une transition douce, tandis qu’une valeur élevée rend la transition plus abrupte.
rotation: L’orientation du filtre. Les valeurs négatives tournent dans le sens des aiguilles d’une montre. La rotation peut également être effectuée en faisant glisser l’extrémité de la ligne de dégradé avec la souris.
teinte: Choisir une teinte pour ajouter une dominante de couleur au dégradé.
saturation: La saturation de la dominante de couleur à ajouter au dégradé (par défaut pas de dominante de couleur)

Grain

Sun, 04 Dec 2022 02:19:02 +0100

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

Contrôles du module

rugosité: La taille du grain, dimensionné pour simuler une valeur ISO.
Force: La force de l’effet.

Haze removal

Sun, 04 Dec 2022 02:19:02 +0100

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.

Highlight reconstruction

Sun, 04 Dec 2022 02:19:02 +0100

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 module it may be useful to avoid using this module in clip highlights mode (so that filmic has more information to work with).

Homogénéisation

Sun, 04 Dec 2022 02:19:02 +0100

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 .

Bien que ce ne soit pas un problème inhérent à l’un des modules d’Ansel, certaines opérations peuvent provoquer un effet de bandes si elles produisent un dégradé de clarté dans l’image. Pour atténuer les artefacts possibles, vous devriez envisager d’activer l’homogénéisation lors de l’utilisation des modules vignettage ou filtre dégradé. Ceci est particulièrement pertinent pour les images comportant de vastes zones homogènes comme un ciel sans nuage. Méfiez-vous également des artefacts d’effet de bandes lors de l’utilisation d’un masque dessiné en dégradé.

Hot pixels

Sun, 04 Dec 2022 02:19:02 +0100

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.

Contrôles du module

seuil: Seuil de déviation, c.-à-d. de combien la valeur d’un pixel doit-elle dévier de celles de ses voisins pour qu’il soit considéré comme un pixel chaud.
force: La force de la fusion appliquée aux pixels chauds pour les fondre dans leur environnement .
détection par 3 voisins: Étend la détection des pixels chaud en considérant le pixel comme chaud lorsque 3 pixels voisins (au lieu de 4) dévient au delà du seuil fixé.
montrer: Marque visuellement sur l’image les pixels corrigés et affiche leur nombre.

Liquéfier

Sun, 04 Dec 2022 02:19:02 +0100

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.

Nœuds

Chacun des outils de liquéfier est basé sur des nœuds. Un point se compose d’un seul nœud et une ligne ou une courbe se compose d’une séquence de nœuds liés définissant un chemin.

Chaque instance du module liquéfier est limitée à un maximum de 100 nœuds – pour plus de nœuds, utilisez des instances supplémentaires. Notez cependant que le module liquéfier consomme beaucoup de ressources système.

LUT 3D

Sun, 04 Dec 2022 02:19:02 +0100

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.

This module accepts .cube, .3dl and .png (haldclut) 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. It is therefore important to back up your 3D LUT folder properly – sharing an image with its XMP is pointless if the recipient doesn’t also have the same 3D LUT file in their own 3D LUT folder.

Negadoctor

Sun, 04 Dec 2022 02:19:02 +0100

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.

Preparation

Si l’image du négatif a été obtenue à l’aide d’un appareil photo numérique, afin d’obtenir des couleurs précises dans l’image finale, vous devait alors considérer les points suivants :

When taking the photograph, adjust the exposure to fully utilise the entire dynamic range of your camera sensor – i.e. “expose-to-the-right”, so that the histogram in your camera touches the right hand side without clipping the image.

Niveaux

Sun, 04 Dec 2022 02:19:02 +0100

Ajuste les points noir, blanc et gris moyen dans l’espace colorimétrique RVB.

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

Déplacer les barres noire et blanche pour qu’elles correspondent aux bords gauche et droit de l’histogramme fera s’étendre l’image de sortie sur toute la plage tonale disponible. Cela augmentera le contraste de l’image.

Orientation

Sun, 04 Dec 2022 02:19:02 +0100

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.

Contrôles du module

transformer: Double-cliquez sur l’étiquette pour réinitialiser les transformations par défaut.
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
montrer les guides: Cochez la case pour afficher les superpositions de guides chaque fois que le module est activé. Cliquez sur l’icône à droite pour contrôler les propriétés des guides. Voir guides et superpositions pour plus de détails.

Profil de couleur d'entrée

Sun, 04 Dec 2022 02:19:02 +0100

Définit comment Ansel interprétera les couleurs de l’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.

Lorsqu’une image a été capturée dans un fichier brut, le module profil de couleur d’entrée applique normalement une matrice de couleurs standard ou améliorée spécifique à ce modèle de caméra pour mapper les couleurs vers l’espace colorimétrique du profil de travail. Si des informations sur l’espace colorimétrique sont intégrées à l’image, le module profil de couleur d’entrée utilise ces informations lors du mappage des couleurs vers l’espace colorimétrique du profil de travail. L’utilisateur peut également spécifier un espace colorimétrique pour l’image entrante et peut même fournir un profil de couleur ICC personnalisé spécialement conçu pour le périphérique d’entrée.

Profil de couleur de sortie

Sun, 04 Dec 2022 02:19:02 +0100

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

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

Raw black/white point

Sun, 04 Dec 2022 02:19:02 +0100

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.

Contrôles du module

niveau du noir 0-3: Le niveau de noir spécifique à l’appareil pour les quatre pixels dans le motif Bayer RGGB. Les pixels avec des valeurs inférieures à ce niveau ne sont pas considérées contenir des données valide.
point blanc: Le niveau de blanc spécifique à l’appareil photo. Tous les pixels avec une valeur supérieur à celle ci seront coupés et par conséquent manipulés par le module reconstruire hautes lumières
flat field correction: Use flat field correction to compensate for lens shading. This field only appears for applicable Raw files and will automatically use any GainMap embedded in the Raw. You can choose to disable this correction if desired.

Raw denoise

Sun, 04 Dec 2022 02:19:02 +0100

Perform denoising on raw image data before it is demosaiced.

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

Contrôles du module

seuil de bruit: Le seuil de détection du bruit. Des valeurs plus élevées entraînent une suppression du bruit plus importante et une plus grande perte de détails dans l’image.
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. The left of the curve will act on very coarse grain noise, while the right of the curve will act on very fine grain noise.; Raising the curve will result in more smoothing, while lowering it will result in less smoothing. As an example, you can preserve very fine-grained noise by pulling down the rightmost point of the curve to the minimum value.

Retouche

Sun, 04 Dec 2022 02:19:02 +0100

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

Ce module inclut un outil « correcteur » (basé sur l’outil correcteur de GIMP), ainsi que les modes « remplir » et « flou ». Il peut également tirer parti de la décomposition en ondelettes, permettant de séparer l’image en couches de détails variés (du grossier au fin) qui peuvent être retouchées sélectivement avant d’être recombinées pour produire l’image de sortie.

Rotate and perspective

Sun, 04 Dec 2022 02:19:02 +0100

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.

Rotate pixels

Sun, 04 Dec 2022 02:19:02 +0100

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

Scale pixels

Sun, 04 Dec 2022 02:19:02 +0100

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.

Sharpen

Sun, 04 Dec 2022 02:19:02 +0100

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.

Tone equalizer

Sun, 04 Dec 2022 02:19:02 +0100

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 :

Unbreak input profile

Sun, 04 Dec 2022 02:19:02 +0100

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.

Vignetage

Sun, 04 Dec 2022 02:19:02 +0100

Applique un effet de vignetage à l’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.

Watermark

Sun, 04 Dec 2022 02:19:02 +0100

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.

White balance

Sun, 04 Dec 2022 02:19:02 +0100

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.

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. For creative color operations, it is usually better to use other modules such as color calibration or color balance.

Boîtes à outils

Sun, 04 Dec 2022 02:19:02 +0100

Une boîte à outils est un outil repliable ancré dans l’un des panneaux latéraux. Contrairement aux modules de traitement de la chambre noire, les boîtes à outils ne modifient pas les pixels — elles vous aident à parcourir, organiser, inspecter, exporter et annoter les images, ou à évaluer l’image en cours d’édition.

Chaque vue n’affiche que les boîtes à outils pertinentes pour sa tâche, de sorte que la même position de panneau peut contenir différents outils selon que vous êtes dans la table lumineuse, la chambre noire, la carte ou la vue impression.

Styles

Tue, 16 Jun 2026 00:00:00 +0000

Un style est une recette d’édition nommée et enregistrée — un sous-ensemble d’un historique qui peut être appliqué à un nombre quelconque d’images. Les styles vous permettent de réutiliser des rendus, des corrections techniques ou des configurations de modules sans avoir à les refaire à partir de zéro.

Les styles sont accessibles depuis deux endroits :

Le menu Styles dans la barre de menus, qui liste tous vos styles et les applique en un clic.
Le module styles de la boîte à outils, disponible sous forme de fenêtre flottante via Styles → Gérer les styles…

Appliquer un style

Cliquez sur le nom d’un style dans le menu Styles pour l’appliquer à toutes les images actuellement actives. Si l’option Demander les paramètres de fusion avant d’appliquer est activée (par défaut), une boîte de dialogue des paramètres de fusion apparaît d’abord. Voir la page copier-coller de l’historique pour une explication complète de ce que signifient la position de fusion et l’ordre du pipeline.

Notes

Mon, 16 Feb 2026 00:00:00 +0000

Écrivez des notes par image qui se trouvent à côté de vos fichiers et s’affichent en Markdown. De telles notes peuvent être des listes de tâches, des mémos, les contacts des personnes présentes sur l’image, des astuces ou des instructions pour des collaborateurs, etc.

Le module s’ouvre en aperçu par défaut ; passez en édition pour modifier le texte source. L’analyse Markdown nécessite qu’Ansel soit compilé avec CMark , ce qui est optionnel. Si Ansel n’a pas été compilé avec cette bibliothèque, le texte sera affiché en texte brut.

Avertissement d'écrêtage

Sun, 04 Dec 2022 02:19:02 +0100

Il met en évidence les zones de l’image qui peuvent présenter un écrêtage de la luminance ou du gamut.

Lorsqu’une image est envoyée à un périphérique d’affichage, chaque pixel est normalement représenté par un ensemble de trois nombres, représentant l’intensité des couleurs primaires rouge, vert et bleu dans l’espace colorimétrique de sortie. Étant donné que l’espace colorimétrique de sortie est généralement étroitement lié au matériel avec des limitations physiques, il existe une valeur maximale autorisée pour les canaux [R, V, B], représentant l’intensité maximale disponible pour cet espace colorimétrique. De même, il existe également une valeur minimale en dessous de laquelle les valeurs de pixel seront mises à zéro. Lorsque nous essayons de convertir d’un espace colorimétrique plus grand à l’espace colorimétrique de sortie final, toute valeur dépassant ce maximum sera limitée à la valeur maximale et toute valeur inférieure au minimum sera limitée à zéro. Ce processus est appelé “écrêtage” et il entraînera une perte de détails ou des couleurs “incorrectes” pour tous les pixels avec des canaux tronqués.

Avertissement de surexposition raw

Sun, 04 Dec 2022 02:19:02 +0100

Met en évidence les zones de l’image où les canaux de couleur du fichier d’entrée raw sont écrêtés.

Des canaux de couleur écrêtés impliquent une image surexposée avec une perte d’informations dans les zones affectées. Une partie de ces informations peut être récupérée à l’aide des modules reconstruction des hautes lumières, reconstruction des couleurs ou filmique.

Cliquez sur l’icône de surexposition raw dans la barre d’outils inférieure pour afficher/masquer la superposition d’avertissement. Faites un clic droit sur l’icône pour ouvrir une boîte de dialogue contenant les paramètres de configuration suivants.

Bibliothèque

Sun, 04 Dec 2022 02:19:02 +0100

Filtrer les images affichées dans la table lumineuse et le bandeau pellicule en utilisant les attributs des images. Cet ensemble d’images filtrées est appelé collection.

L’importation d’images dans Ansel stocke des informations les concernant (nom de fichier, chemin, données Exif, données des fichiers liés XMP, etc.) dans la base de données de bibliothèque d’Ansel. Une collection est définie en appliquant des règles de filtrage à ces attributs, créant ainsi un sous-ensemble d’images à afficher dans la vue table lumineuse et le module pellicule.

Éditeur de métadonnées

Sun, 04 Dec 2022 02:19:02 +0100

Modifier les métadonnées des images sélectionnées.

Les métadonnées sont du texte au format libre (titre, description, créateur, éditeur, droits, etc.) décrivant vos images.

Lorsque plusieurs images ayant des valeurs différentes pour un champ de métadonnées donné sont sélectionnées, le module affiche <laisser inchangé> pour ce champ – si vous choisissez d’appliquer les modifications, ces champs ne seront pas changés. Si vous faites un clic droit sur le champ, les différentes valeurs sont listées à la fin du menu contextuel. Sélectionnez l’une des valeurs dans le menu pour l’appliquer à toutes les images sélectionnées – la modification sera enregistrée une fois que vous aurez appuyé sur le bouton « appliquer » ou sur la touche Entrée/Tab.

Épreuvage écran

Sun, 04 Dec 2022 02:19:02 +0100

Affichez votre image rendue à l’aide d’un profil de couleur sélectionné.

Cliquez sur l’icône d’épreuvage écran dans la barre d’outils inférieure pour activer le mode d’affichage épreuvage écran. Cela vous permet de prévisualiser votre image rendue à travers un profil d’imprimante, pour voir comment les couleurs apparaîtront sur le tirage final. Un message « épreuvage » en bas à gauche de l’image confirme que vous êtes en mode épreuvage écran.

Évaluation des couleurs

Sun, 04 Dec 2022 02:19:02 +0100

Évaluez les couleurs et la luminosité de votre image à l’aide des conditions d’affichage recommandées par ISO 12646:2008.

Lors du développement d’une image, la façon dont nous percevons la luminosité, le contraste et la saturation est influencée par les conditions ambiantes environnantes. Si une image est affichée sur un fond sombre, cela peut avoir un certain nombre d’effets négatifs sur notre perception de cette image :

L’exagération de l’exposition perçue fait paraître l’image plus lumineuse qu’elle ne l’est réellement. Ceci est joliment illustré par l’effet d’ombre du damier d’Adelson .
Une diminution de la saturation perçue dans l’image fait paraître les couleurs moins riches qu’elles ne le sont réellement (l’effet Hunt).
Une diminution du contraste perçu dans l’image fait paraître les tons plus plats qu’ils ne le sont réellement (effet Bartleson-Breneman 3)

Il en résulte que l’image finale peut être trop sombre et mal développée en termes de contraste et de saturation des couleurs. Pour éviter cela, la norme “ISO 12646:2008” fait quelques recommandations sur les conditions dans lesquelles les couleurs d’une image doivent être évaluées. Le module évaluation des couleurs de la chambre noire place un cadre autour de l’image pour aider l’utilisateur à mieux évaluer les couleurs de l’image dans le sens de ces recommandations.

EXIF et IPTC

Sun, 04 Dec 2022 02:19:02 +0100

Affiche les informations EXIF et IPTC (métadonnées) intégrées à une image, ainsi qu’un certain nombre de champs supplémentaires gérés par Ansel (pellicule, version, copie locale, etc.). Le module est disponible dans la plupart des vues, dans le panneau gauche.

Lorsque vous survolez des miniatures dans la table lumineuse ou la pellicule, le panneau se met à jour pour afficher l’image sous le curseur. Il s’agit d’un aperçu en lecture seule qui ne change rien.

Exporter

Sun, 04 Dec 2022 02:19:02 +0100

Exporter les images sélectionnées vers des fichiers finaux.

Ouvrez le panneau d’exportation depuis le menu global, Fichier → Exporter… (Ctrl+Maj+E). Les fichiers peuvent être exportés vers un fichier sur le disque, un e-mail, divers emplacements de stockage en ligne, un album web ou un modèle de livre.

Contrôles du module

Options de stockage

stockage cible

Le type d’emplacement pour stocker vos images sélectionnées. Différents types de stockage sont mis en œuvre, notamment le fichier sur disque, le modèle de livre LaTeX et divers albums Web. En fonction de la cible sélectionnée, il vous sera demandé de fournir des informations supplémentaires, telles que les noms de fichiers ou le nom de compte et le mot de passe.

modèle de nom de fichier

Définissez le dossier et le fichier vers lesquels l’image sera exportée. Ceci peut être généré automatiquement en utilisant plusieurs variables prédéfinies. Voir la section variables pour plus de détails.

sélecteur de répertoire de sortie

Le bouton situé à côté de l’entrée du modèle de nom de fichier ouvre une boîte de dialogue permettant de sélectionner le répertoire parent pour l’exportation.

sur conflit

Choisir ce qu’il faut faire si le nom de fichier généré entre en conflit avec un fichier existant lors de l’exportation.

créer fichier unique : crée automatiquement un nouveau nom unique de fichier en ajoutant un entier au nom du fichier en conflit.

écraser : écrase automatiquement les fichiers existants. Cette option présente une boîte de dialogue de confirmation afin de vous protéger contre la perte accidentelle de données – vous pouvez la désactiver dans préférences > sécurité > demander avant d’exporter en mode écraser. Remarque : cette boîte de dialogue n’est pas présentée pour chaque fichier mais comme une confirmation unique avant le démarrage de la tâche d’exportation.

sauter : n’exporte pas les images dont le nom de destination existe déjà.

Options de format

format de fichier: Choisit le format de fichier pour l’image exportée. Des options supplémentaires apparaissent (ci-dessous) en fonction du format sélectionné.
qualité: La qualité du fichier exporté. Des valeurs plus élevées entraînent des tailles de fichier plus importantes. La qualité par défaut (95) est un bon paramètre pour les exportations de très haute qualité (par exemple, pour l’archivage ou l’impression). Si vous avez besoin d’un bon compromis entre la taille et la qualité (par exemple, pour l’affichage ou le téléchargement d’images en ligne), vous devriez plutôt envisager une valeur de “90”.
bits: Le nombre de bits utilisés pour chaque canal de couleur. Plus il est élevé, moins il y aura de postérisation/bandes de couleur.
compression ou type de compression: Le type de compression à utiliser (WebP ou OpenEXR).
compression: Pour les formats où la compression peut être spécifiée, la réglette compression permet de fixer sa force. Plus le niveau est élevé, plus les données seront compressées, au prix d’un plus grand temps de traitement.
image n&b: Pour le format TIFF, il est possible d’enregistrer une image monochrome. Ce paramètre contrôle si le fichier résultant code les nuances de gris en tant que canaux RVB distincts ou en tant que canal de niveaux de gris unique.

Options globales

taille

Choisissez comment est calculé la taille maximale de l’image exportée.

en pixels (pour le fichier) : entrez la largeur et la hauteur maximales en pixels.

en cm (pour impression) : entrez la largeur et hauteur maximales en cm, ainsi que la résolution en points par pouce (dpi). La définition équivalente en pixels sera automatiquement calculée.

en pouce (pour impression) : entrez la largeur et hauteur maximales en pouce, ainsi que la résolution en points par pouce (dpi). La définition équivalente en pixels sera automatiquement calculée.

par facteur (pour fichier) : entrez un multiplicateur pour spécifier de combien l’image exportée doit être mise à l’échelle par rapport à l’image d’entrée. Par exemple, entrez une valeur de 0.5 pour réduire l’image de sortie de moitié en largeur et hauteur (en pixels).

dpi

Dans le cas des options pour l’impression (en cm ou en pouces), ceci enregistre la résolution de l’image de sortie. Cette résolution est enregistrée dans les données EXIF de l’image exportée. Elle est automatiquement réglée à 300 si les options en pixels ou par facteur sont sélectionnées.

taille maximale

Entrez la taille maximale de la largeur et de la hauteur de l’image exportée, en pixels, en cm ou en pouces (dépend de l’option choisie). Une valeur de zéro ne met aucune contrainte sur cette dimension. Les images exportées seront contraintes de manière à ne dépasser aucune de ces valeurs, tout en conservant le rapport hauteur/largeur. Mettez les deux à zéro pour exporter avec les dimensions d’origine (après recadrage). Si les valeurs saisies dépassent les dimensions d’origine, Ansel exportera avec les dimensions d’origine ou augmentera l’échelle de l’image, en fonction du paramètre « autorise l’agrandissement ».

autorise l’agrandissement

Mettez sur « oui » pour effectuer une étape de mise à l’échelle si la largeur et la hauteur maximales définies par l’utilisateur dépassent les dimensions d’origine de l’image. En mettant « non », les dimensions de l’image exportée ne dépasseront pas les dimensions de l’image d’origine (après recadrage).

échantillonnage de haute qualité

Mettez sur « oui » pour effectuer un ré-échantillonnage de haute qualité sur l’image. L’image sera traitée en pleine résolution et uniquement réduite à la toute fin. Cela donne parfois une meilleure qualité, mais le traitement sera toujours plus lent.

enregistrer les masques

Enregistrer les masques sous forme de calques dans l’image exportée. Ne fonctionne que pour certains formats d’image (actuellement TIFF et XCF).

profil

Le profil de couleur de sortie. Sélectionnez « paramètres d’image » si vous souhaitez que les réglages du module profil de couleur de sortie de chaque image soient respectés.

intention

Cette option vous permet de définir l’intention – la manière dont Ansel gérera les couleurs hors gamut. Voir intention de rendu pour une description plus détaillée des options disponibles.

style

Choisissez un style qu’Ansel combinera avec l’historique existant pour générer l’image de sortie. Ces éléments d’historique ne sont ajoutés que temporairement – l’historique d’origine n’est pas écrasé. Vous pouvez utiliser cette fonctionnalité pour ajouter des étapes de traitement et des paramètres que vous souhaitez appliquer spécifiquement aux images avant l’exportation. Par exemple, vous pouvez définir un style qui ajoute un niveau d’accentuation plus fort lorsque vous produisez des fichiers JPEG réduits pour Internet, ou ajouter un certain niveau de compensation d’exposition à toutes vos images de sortie.

mode

Lors de l’application d’un style pendant l’exportation, cette option définit si les éléments d’historique de ce style remplacent l’historique d’origine de l’image ou y sont ajoutés. Techniquement parlant, en mode ajout, les éléments d’historique du style constitueront des instances distinctes des modules respectifs au-dessus de celles déjà existantes. Par conséquent, l’historique d’origine restera en vigueur, les nouveaux éléments étant appliqués en plus. De cette façon, vous pouvez appliquer un ajustement global (par exemple l’exposition) à un certain nombre d’images exportées tout en respectant les réglages de chaque image individuelle.

exporter

Appuyez sur ce bouton pour lancer une tâche d’arrière-plan qui exporte toutes les images sélectionnées. Une barre en bas du panneau de gauche affiche la progression de la tâche d’exportation. De plus, un message de notification apparaît pour signaler l’achèvement de chaque exportation individuelle. Vous pouvez cliquer sur la notification pour la faire disparaître. Vous pouvez interrompre la tâche d’exportation en cliquant sur l’icône « x » située à proximité de la barre de progression.

Remarque : les images sélectionnées mais actuellement masquées (parce qu’elles sont membres d’un groupe réduit) ne seront pas exportées.

Focus peaking

Sun, 04 Dec 2022 02:19:02 +0100

Identifie les parties de l’image contenant des détails à fort contraste, comme les bords et les textures, ce qui indique généralement que ces zones sont nettes.

Activez le focus peaking depuis la barre d’outils inférieure dans la chambre noire, ou via Superposer le focus peaking dans les options d’affichage de la table lumineuse. Les parties nettes de l’image sont mises en évidence par une superposition jaune, verte et bleue :

Le focus peaking fonctionne en filtrant la majeure partie du bruit de l’image, en mesurant les gradients d’intensité de l’image et en calculant des statistiques de moyenne et d’écart-type. Lorsque le gradient d’un bord diffère significativement de la moyenne, les pixels associés sont marqués d’une « carte thermique » indiquant la netteté du bord.

Géolocalisation

Sun, 04 Dec 2022 02:19:02 +0100

Importe et applique des données de traces GPX à une sélection d’images, et corrige la date/heure des images.

Ce module — intitulé Date/heure et GPS dans le panneau — est commun aux vues table lumineuse et carte. La vue carte fournit un mode amélioré qui vous permet de prévisualiser la position des images le long des traces GPS tout en ajustant le décalage de date/heure et le fuseau horaire des images.

Gestionnaire de clones

Sun, 04 Dec 2022 02:19:02 +0100

Visualisez les versions (clones) de l’image actuelle et basculez de l’une à l’autre. Chaque version partage le même fichier sous-jacent mais conserve son propre historique d’édition indépendant, stocké dans son propre fichier lié XMP, de sorte que chacune peut être éditée sans affecter les autres.

Dans le panneau gauche de la chambre noire, le gestionnaire de clones liste chaque version de l’image actuelle avec une miniature d’aperçu et un numéro de version :

Gestionnaire de formes

Sun, 04 Dec 2022 02:19:02 +0100

Le gestionnaire de formes est une fenêtre flottante, indépendante de la fenêtre principale, où vous dessinez, nommez, groupez et supprimez les formes avec lesquelles une image est masquée, et où vous décidez des modules auxquels chacune d’elles s’applique. Ouvrez-le ou fermez-le depuis son bouton dans la barre d’outils inférieure de la chambre noire.

Il travaille sur les mêmes formes que les contrôles de masquage et fusion propres à chaque module, dans l’onglet Dessiné du panneau gauche : une forme dessinée ici est le même objet que celui à partir duquel se construit le masque dessiné d’un module, et réciproquement. Ce que cette fenêtre apporte, c’est la vue d’ensemble sur tous les modules — toutes les formes que porte l’image d’un côté, tous les groupes avec lesquels un module dessine de l’autre. C’est de là qu’une forme se réutilise, ou se confie à un second module, sans passer par chaque module l’un après l’autre.

Guides et superpositions

Sun, 04 Dec 2022 02:19:02 +0100

Un certain nombre de guides de composition couramment utilisés peuvent être superposés à votre image pendant que vous l’éditez. Ceux-ci peuvent être activés soit globalement (tout le temps) soit localement (lorsque certains modules sont actifs).

D’autres fonctionnalités de la chambre noire dessinent également des lignes de superposition colorées sur l’image (par exemple, les masques dessinés). Une option est également fournie pour changer la couleur de ces superpositions (voir ci-dessous).

Guides globaux

Cliquez gauche sur l’icône guides-et-superpositions dans la barre d’outils inférieure pour afficher globalement les superpositions de guides. Les superpositions restent activées jusqu’à ce que vous cliquiez une deuxième fois sur le bouton pour les désactiver.

Historique

Sun, 04 Dec 2022 02:19:02 +0100

Le module Historique des modifications, dans le panneau gauche de la chambre noire, affiche et vous permet de naviguer dans l’historique de l’image actuelle.

Il liste chaque changement d’état — un module activé, désactivé, déplacé, ou dont un paramètre a changé — pour l’image actuelle, le plus récent en haut. Chaque entrée correspond à une modification de l’utilisateur, de sorte qu’un module peut apparaître plusieurs fois.

Naviguer dans l’historique

Cliquez sur une entrée pour ramener l’image à ce point de son historique.
Maj+clic sur une entrée pour développer le module correspondant dans le panneau de droite sans modifier l’édition actuelle — utile pour inspecter une étape.
Survolez une entrée pour afficher une infobulle listant exactement ce qui a changé à cette étape par rapport à la précédente, ce qui aide à repérer les ajustements involontaires.

L’état d’historique sélectionné est mémorisé : vous pouvez quitter, sortir de la chambre noire ou changer d’image après être revenu en arrière, et vous reviendrez au même état.

Installateur de scripts Lua

Sun, 04 Dec 2022 02:19:02 +0100

This module provides an interface for installing darktable lua scripts. The first time it is run, instructions are displayed in the module.

Il peut être désactivé par une option dans préférences > options lua.

Instantanés

Sun, 04 Dec 2022 02:19:02 +0100

Stockez des instantanés de l’image centrale et comparez-les avec l’édition actuelle.

Un instantané est une image bitmap figée de la vue centrale de la chambre noire, prise à n’importe quel moment de l’édition et superposée ensuite à la vue actuelle pour une comparaison côte à côte pendant que vous réglez un module. Il peut également être combiné avec l’historique des modifications pour comparer un instantané avec différentes étapes du développement.

Lieux

Sun, 04 Dec 2022 02:19:02 +0100

Créez des zones ou des lieux et organisez-les sous forme de mots-clés hiérarchiques.

Un emplacement est affiché sur la carte quand il est sélectionné. Initialement chaque emplacement est représenté par un carré ou un cercle, qui peut être changé en rectangle ou en ellipse en ajustant sa largeur et/ou sa hauteur.

Un emplacement peut aussi être créé à partir d’un polygone représentant une région OpenStreetMap (ville/pays). Pour ce faire, assurez-vous que le paramètre max points polygone est suffisamment grand (certains polygones de pays comptent plus de 150.000 points). Ensuite sélectionnez le lieu désiré dans le module trouver un lieu.

Mots-clés

Sun, 04 Dec 2022 02:19:02 +0100

Attachez des mots-clés aux images et gérez le dictionnaire de mots-clés.

Les mots-clés permettent d’ajouter des informations aux images à l’aide d’un dictionnaire de mots-clés. Vous pouvez gérer les mots-clés sous forme d’arborescence hiérarchique, ce qui peut être utile lorsque leur nombre devient important.

Les mots-clés sont physiquement stockés dans les fichiers liés XMP ainsi que dans la base de données de bibliothèque d’Ansel, et peuvent être inclus dans les images exportées.

Navigation

Sun, 04 Dec 2022 02:19:02 +0100

Zoomer et déplacer l’image actuelle de la chambre noire.

En haut du panneau gauche de la chambre noire, le module navigation affiche un aperçu complet de l’image actuelle avec un rectangle marquant la zone actuellement visible dans la vue centrale. Faites glisser le rectangle pour déplacer la vue zoomée.

Le niveau de zoom actuel est affiché à droite de l’aperçu. Cliquez dessus pour accéder rapidement aux niveaux de zoom courants.

Paramètres d'impression

Sun, 04 Dec 2022 02:19:02 +0100

Gérer les paramètres de la vue impression et lancer l’impression.

Contrôles du module

Imprimante

imprimante: Sélectionner l’une des imprimantes installées.
type de papier: Le type de papier de l’imprimante (papier ordinaire, papier photo lustré, etc.).
profil: Le profil ICC de l’imprimante pour le papier chargé. C’est le profil spécifique à l’imprimante et au papier de l’imprimante. L’application de ce profil est la dernière transformation d’espace colorimétrique faite à l’image. Son but est de créer une impression de haute qualité.
intention: L’intention de rendu pour l’impression (« perceptuel », « colorimétrie relative », « saturation » ou « colorimétrie absolue »). Voir intention de rendu pour plus de détails.
compensation du point noir: Le point noir du profil de sortie, qui est souvent plus clair que celui du profil d’entrée, sera ajusté quand la case est cochée . Elle devrait l’être si le paramètre rendu ci-dessus est fixé à “colorimétrie relative”.

Page

taille papier: La taille du papier pour l’impression.
orientation: Portrait ou paysage (notez qu’Ansel choisit par défaut la meilleure adaptation).
unités: L’unité à utiliser pour régler les marges : mm, cm, et pouce sont les options disponibles.
marges: Il est possible de régler séparément chaque marge ou de toutes les régler simultanément en cliquant le bouton « sync » central.
afficher la grille: Sélectionnez la taille de la grille à l’aide du champ de saisie (exprimée dans l’unité actuellement sélectionnée). Cochez pour afficher la grille sur le canevas.
aligner sur la grille: aide à définir les zones de l’image en les accrochant à la grille pour un alignement correct.
mode sans bordure requis: Lorsque les marges de l’utilisateur sont inférieures aux marges matérielles de l’imprimante, cet élément est activé (il n’est plus grisé). Il indique alors que le mode sans bordure de l’imprimante doit être activé. Notez qu’il ne s’agit que d’un indicateur car il n’active pas automatiquement le mode sans bordure.

Disposition des images

largeur/hauteur image: Ce champ d’informations affiche les largeur et hauteur réelle de l’image sur le papier (données avec les unités sélectionnées).
facteur d’agrandissement: Ce champ d’informations affiche le facteur d’agrandissement de l’image nécessaire à son ajustement à la taille du papier. Si cette valeur est inférieure à 1 l’image est réduite sinon elle est agrandie. C’est un important facteur à surveiller – une trop grande valeur (agrandissement) peut produire une impression de qualité médiocre. Le dpi (nombre de points par pouce ; dots per inch en anglais) est aussi affiché.
alignement: Sélectionnez l’alignement de l’image sur sa zone.
nouvelle zone image: Créer une nouvelle zone image. Glissez-déposez sur le canevas pour la placer. Si l’option aligner sur la grille est activée, la zone peut être facilement alignée sur les lignes de la grille. Une image peut être placée dans cette zone en la faisant glisser depuis la pellicule et en la déposant sur la nouvelle zone.
bouton supprimer la zone d’image: Retire la zone d’image actuellement sélectionnée de la composition.
effacer composition: Supprime toutes les zones image en laissant le canevas vide.

Les quatre champs suivants représentent la position de la zone actuellement sélectionnée sur la page – le coin supérieur/gauche sur la première ligne et la largeur/hauteur de la zone sur la deuxième ligne.

Paramètres de la carte

Sun, 04 Dec 2022 02:19:02 +0100

Permet de sélectionner les données cartographiques préférées parmi divers fournisseurs. Certains fournissent des couches supplémentaires (vue satellite, etc…).

Contrôles du module

source cartographique

Choisir le fournisseur d’informations cartographiques.

max points polygone

Le module trouver un lieu n’affiche pas les polygones avec plus de points que cette limite pour des raisons de performance. Habituellement un polygone de pays compte entre 50.000 et 150.000 points.

afficher contrôles

Permet d’afficher les contrôles en haut à gauche de la vue centrale.

images filtrées

Lorsque cette option est sélectionnée, seules les images de la pellicule (collection courante) s’affichent dans la vue centrale. Si elle n’est pas sélectionnée, toutes les images de la bibliothèque actuelle sont affichées si les images correspondantes sont associées à des données GPS. Vous pouvez aussi changer cette option en pressant Ctrl+S.

max images

Le nombre maximum de miniatures à afficher sur la carte.

facteur de taille d’un groupe

Augmente ou diminue la zone d’influence du regroupement d’images.

nombre minimum d’images par groupe

Le nombre minimum d’images pour créer un groupe d’images.

affichage miniatures

Définit quelle information est affichée sur la carte

aperçu : Affiche la miniature des images ainsi qu’un compteur.

nombre : Affiche seulement le nombre d’images (pour libérer de l’espace sur la carte). Survoler le nombre d’images pour faire apparaître la (les) miniature(s) correspondante(s). Ce compteur se comporte de la même façon qu’un aperçu en termes de codage couleur, défilement, glisser déplacer, etc…

aucun : N’affiche rien.

Vous pouvez également changer en boucle ces options en appuyant sur Maj+S.

Pellicule

Sun, 04 Dec 2022 02:19:02 +0100

La pellicule peut être utilisée pour basculer rapidement entre les images. Les images affichées sont les mêmes que celles affichées dans la vue table lumineuse et sont définies par la collection actuellement sélectionnée.

Pipette à couleur globale

Sun, 04 Dec 2022 02:19:02 +0100

La pipette à couleur globale échantillonne les couleurs de l’image actuelle, affiche leurs valeurs dans plusieurs espaces colorimétriques, et vous permet de stocker et de comparer des échantillons provenant de différents emplacements. Elle fait partie du module scopes (les sections Pipette à couleur et Échantillons en temps réel), dans le panneau gauche de la chambre noire.

Activez-la avec le bouton de pipette à couleur. Elle continue d’échantillonner jusqu’à ce que vous la désactiviez ou quittiez la chambre noire.

Scopes

Sun, 04 Dec 2022 02:19:02 +0100

Le module scopes, en haut du panneau gauche de la chambre noire, fournit des représentations graphiques des tons et de la chromaticité de l’image. Il héberge également la pipette à couleur globale.

Faites glisser le bord inférieur du module pour redimensionner le scope verticalement.

Note

Pour des raisons de performance, les scopes sont calculés à partir du pipeline d’aperçu de plus faible résolution (la même image affichée dans le module navigation), et non à partir de l’image centrale en pleine résolution. Les détails fins peuvent donc ne pas être représentés exactement.

Trouver un lieu

Sun, 04 Dec 2022 02:19:02 +0100

Trouver un lieu sur la carte. Vous devez être connecté à Internet pour utiliser cette fonction.

Pour utiliser ce module, tapez un nom de lieu ou une adresse, appuyez sur Entrée et une liste de résultats s’affichera. Cliquez sur un élément de la liste et la carte s’agrandira jusqu’à ce lieu. Un contour couvrant ce lieu ou une épingle pointant vers ce lieu s’affiche.

Un contour (polygone) peut être utilisé pour créer un emplacement utilisateur. Vérifiez le paramètre max points polygone dans le module paramètres de carte pour vous assurer que suffisamment de points sont disponibles pour qu’un polygone soit affiché.

Vérification du gamut

Sun, 04 Dec 2022 02:19:02 +0100

Il met en évidence les zones de l’image qui peuvent présenter un écrêtage du gamut.

Cliquez sur l’icône de vérification du gamut dans la barre d’outils inférieure pour l’activer. La vérification du gamut et l’épreuvage écran sont des modes mutuellement exclusifs.

Cliquez-droit sur l’icône pour ouvrir une boîte de dialogue avec les paramètres de configuration – ce sont les mêmes que ceux de l’option épreuvage écran.

Vous pouvez également envisager d’utiliser l’avertissement d’écrêtage, qui fournit aussi des avertissements de sous-exposition et de sur-exposition ainsi qu’une vérification du gamut similaire à celle offerte par ce module.

Carte

Sun, 04 Dec 2022 02:19:02 +0100

La vue Carte est optionnelle et doit être activée dans Préférences > Autres vues. Elle vous permet de voir où vos images géolocalisées ont été prises, et d’ajouter des informations de localisation aux images non géolocalisées.

La vue Carte affiche une carte du monde avec les images de la collection actuelle épinglées à leur position géolocalisée (si disponible). Cela nécessite que les images soient étiquetées avec des informations de localisation. Certains appareils photo récents, y compris les smartphones, sont déjà équipés de récepteurs GPS. D’autres appareils peuvent nécessiter du matériel GPS supplémentaire pour cela.

Diaporama

Sun, 04 Dec 2022 02:19:02 +0100

La vue Diaporama est optionnelle et doit être activée dans Préférences > Autres vues. Elle vous permet de regarder un diaporama de votre collection actuelle avec les règles de filtrage associées et l’ordre de tri appliqués.

Pour en savoir plus sur la définition de la collection et des règles de filtrage, consultez la section sur les collections.

La section suivante fournit plus de détails sur l’utilisation de la vue Diaporama.

Utilisation

Sun, 04 Dec 2022 02:19:02 +0100

La vue diaporama est encore à un stade précoce de développement avec seulement un ensemble de fonctionnalités de base.

 1
 2barre d'espace démarre et arrête le mode avance automatique qui passe automatiquement
 3 à l'image suivante toutes les cinq secondes par défaut.
 4
 5Échap quitte le mode diaporama et retourne à la vue table lumineuse.
 6
 7
 8+ ou augmente le délai entre chaque image.
 9flèche haut
10
11- ou diminue le délai entre chaque image.
12flèche bas
13
14clic gauche ou
15flèche droite ou passe à l'image suivante de la collection.
16Maj droite
17
18clic droit ou
19flèche gauche ou passe à l'image précédente de la collection.
20Maj gauche

Astuce : Pour tirer pleinement parti de la taille de votre écran, mettez Ansel en mode plein écran en appuyant sur F11 et masquez les contrôles de bordure en appuyant sur la touche B.

Impression

Sun, 04 Dec 2022 02:19:02 +0100

La vue Impression est optionnelle et doit être activée dans Préférences > Autres vues. Cette vue vous permet d’imprimer vos images. Comme l’impression n’est pas chose facile, de nombreux aspects techniques doivent être pris en compte.

Après avoir sélectionné une image dans la vue table lumineuse, vous pouvez entrer dans le module paramètres d’impression pour ajuster les paramètres d’imprimante et lancer l’impression.

Ce module prend en charge le profil ICC de l’imprimante, ce qui est quelque peu obligatoire si vous souhaitez obtenir une impression de haute qualité proche de l’image affichée à l’écran.

Disposition de la vue impression

Sun, 04 Dec 2022 02:19:02 +0100

La zone centrale affiche la disposition de l’image sur le papier (la zone blanche). Des bordures grises peuvent être affichées autour de l’image pour représenter la zone imprimable (la page moins les bordures) non remplie par l’image.

La pellicule sous l’image vous permet de sélectionner plus d’images.

Superpositions

Lorsque la souris survole la boîte englobante d’une image, sa largeur et sa hauteur sont respectivement affichées en haut et à gauche. Les marges entre la boîte englobante et le bord de la page sont notées à côté des lignes pointillées s’étendant de chaque côté de la boîte englobante. Toutes les mesures sont affichées dans les unités choisies dans le module des réglages d’impression.

Variables

Sun, 04 Dec 2022 02:19:02 +0100

Ansel prend en charge la substitution de variables dans un certain nombre de modules et dans les préférences. Par exemple :

Defining file names in the export module and import tool,
Displaying image information in the darkroom’s image information line,
Displaying image information in the lighttable’s overlays and tooltips (see preferences > lighttable)
Placing text on an image in the watermark processing module.

Most, if not all text entries that use variables implement auto-completion as soon as you start typing $(.

Préférences et réglages

Sun, 04 Dec 2022 02:19:02 +0100

Ansel comes with a number of user-configurable preferences. These can be adjusted in the preferences dialog, which can be reached via Edit > Preferences in the global menu. Preferences are separated into tabs, each of which is described in more detail in the following sections.

Tous les paramètres modifiés (c’est-à-dire ceux qui diffèrent de leur état par défaut) sont mis en évidence par une puce à côté de leur label. Si vous modifiez un paramètre qui nécessite un redémarrage pour prendre effet, un message apparaîtra comme rappel quand vous quitterez la boîte de dialogue des préférences.

Général

Sun, 04 Dec 2022 02:19:02 +0100

Contrôler l’aspect général de Ansel.

interface language: Set the language of the user interface. The system default is marked with an * (needs a restart)
theme: Set the theme for the user interface. Aside from any aesthetic considerations, the recommended interface color for color evaluation is middle gray. Visual perception is affected by ambient brightness, and a low user interface brightness causes all kinds of illusions. Using a dark interface to retouch photos can therefore lead to excessive retouching (abuse of contrast and saturation) and to a photo that is too dark when printed. It is therefore highly recommended that you use one of the “grey” themes for retouching work as these are designed so that the user interface approximates middle gray (default “Ansel”).
utiliser la taille de la police système: Sélectionnez cette option pour utiliser la taille de police définie par votre système. Si elle n’est pas cochée, vous pouvez saisir une taille de police personnalisée dans la case ci-dessous (activée par défaut).
taille de la police en points: Si l’option «utiliser la taille de la police système» est désactivée, entrez une taille de police (en points) que Ansel doit utiliser. La taille de la police sera modifiée immédiatement.
GUI controls and text DPI: Adjust the global GUI resolution to rescale controls, buttons, labels, etc. Increase for a magnified GUI, decrease to fit more content in the window. Set to -1 to use the system-defined global resolution. The default is 96 DPI on most systems. (needs a restart)

CSS theme modifications

In addition to selecting a pre-built theme you can also apply additional CSS customisations of your own to tweak the look-and-feel of Ansel.

Table lumineuse

Sun, 04 Dec 2022 02:19:02 +0100

Control functionality in the lighttable view and modules.

Général

cacher les préréglages internes des modules utilitaires: Si cette option est activée, seuls les préréglages définis par l’utilisateur seront affichés dans le menu des préréglages des modules utilitaires – les préréglages intégrés seront masqués (par défaut désactivé).
show image time with milliseconds: Choose whether to include milliseconds when displaying time values (default off). If set, milliseconds are shown in the image information module and can also be used in the geotagging module.

Miniatures

utiliser le raw au lieu de JPEG intégré à partir de la taille: Lors de la génération de vignettes pour des images qui n’ont pas encore été traitées en chambre noire, si la taille de la vignette est supérieure à cette valeur, la génère en développant l’image RAW. Si la miniature est inférieure à cette taille, utilise l’image d’aperçu JPEG intégrée dans le fichier RAW. Une fois qu’une image a été traitée dans la chambre noire, les vignettes sont toujours générées à partir des données RAW (vous pouvez revenir à l’aperçu JPEG en supprimant l’historique). Pour avoir les vignettes avec la meilleure qualité, choisissez “toujours”.
high quality processing from size: If the thumbnail size is greater than this value and is being generated from raw data, it will be processed using the full quality rendering path, which is better but slower (default 720p). To render thumbnails with the best quality, choose “always”.
delimiters for size categories: Size categories are used to allow different thumbnail overlays to be shown depending on the thumbnail size. A pipe delimited set of values defines at what image sizes the category changes. The default value of “120|400” means that there will be 3 categories of thumbnail: 0-120px, 120-400px and >400px.

Chambre noire

Sun, 04 Dec 2022 02:19:02 +0100

Control functionality in the darkroom view and associated modules.

Général

pen pressure control for brush masks: Controls how the pressure reading of a graphics tablet impacts newly generated drawn mask brush strokes. You can control the brush width, hardness and opacity. “Absolute” control means that the pressure reading directly defines the attribute with a value between 0% and 100%. “Relative” means that the pressure reading adjusts the attribute between zero and the pre-defined default value (default off).
smoothing of brush strokes: Sets the level for smoothing of drawn mask brush strokes. Stronger smoothing leads to fewer nodes and easier editing at the expense of lower accuracy.
scroll down to increase mask parameters: By default, scrolling your mouse up increases the value of the relevant shape parameters in drawn masks. Set this preference to reverse the behavior (default off).
pattern for the image information line: Set the information to be displayed in the image information line, at the right of the top-most toolbar. You can use any variables in the variables section as well as $(NL) for a new line. You can also include formatting (bold, italic, colors etc).
border around image in darkroom mode: Display the center image in darkroom mode with an outside border of the given number of pixels (default 20).
show loading screen between images: Show gray loading screen when navigating between images in the darkroom. Switch this option off to just show a simple toast message and leave the previous image in place until the next image is loaded. Note that switching this option off can be very useful to quickly compare duplicate images, however, there might be issues with long loading times (leading you to think the next image has already loaded) and you may observe visual artifacts while the next image is loading (default on).

Modules

display of individual color channels

Control how individual color channels are displayed when activated in the parametric masks feature. You can choose between “false color” and “gray scale” (default “false color”).

hide built-in presets for processing modules

If enabled, only user-defined presets will be shown in the presets menu for processing modules – built-in presets will be hidden (default off).

show the guides widget in modules UI

Enable this to show the local guides & overlays interface directly within the UI of the modules that support it (default on).

show right-side buttons in processing module headers

Choose whether to show the four buttons (mask indicator, multi-instance menu, reset, presets menu) on the right-hand-side of the module header for processing modules. These buttons will always appear when the mouse is over the module. At other times they will be shown or hidden according to this preference selection:

always: always show all buttons

active: only show the buttons when the mouse is over the module

dim: buttons are dimmed when mouse is not over the module

auto: hide the buttons when the panel is narrow

fade: fade out all buttons when the panel narrows

fit: hide all the buttons if the module name doesn’t fit

smooth: fade out all buttons in one header simultaneously

glide: gradually hide individual buttons as needed

(default always)

prompt for name on addition of new instance

If enabled, when creating a new instance of a processing module, a prompt will be immediately displayed allowing you to set a name for the new instance (default on).

Other views

Sat, 21 Jan 2023 00:00:00 +0000

Enable optional views:

Once you restart Ansel the enabled view(s) will be available in the Ateliers menu.

These views are all hidden by default to spare some computing resources.

Processing

Sun, 04 Dec 2022 02:19:02 +0100

Contrôler le traitement des images.

Image processing

always use LittleCMS 2 to apply output color profile: If this option is activated, Ansel will use the LittleCMS 2 system library to apply the output color profile instead of its own internal routines. This is significantly slower than the default but might give more accurate results in some cases.

Remarque : Si l’ICC donné est basé sur une LUT ou contient à la fois une LUT et une matrice, Ansel utilisera LittleCMS2 pour rendre les couleurs quelle que soit la valeur de ce paramètre (par défaut désactivé).

Security

Sun, 04 Dec 2022 02:19:02 +0100

Contrôler quels messages d’avertissements sont affichés avant d’entreprendre certaines actions.

Général

ask before removing images from the library: Always ask before removing image information from Ansel’s library database, where the xmp file is retained (default on).
ask before deleting images from disk: Always ask before deleting an image file (default on).
ask before discarding history stack: Always ask before discarding the history stack of an image (default on).
try to use trash when deleting images: Instead of physically deleting images from disk, attempt to put them into the system’s trash bin (default on).
ask before moving images from film roll folder: Always ask before moving an image file (default on).
ask before copying images to new film roll folder: Always ask before copying an image file to a new location (default on).
ask before removing empty folders: Always ask before removing any empty folder. This can happen after moving or deleting images (default off).
ask before deleting a tag: Always ask before deleting a tag from an image (default on).
ask before deleting a style: Always ask before deleting a style (default on).
ask before deleting a preset: Always ask before deleting a preset (default on).
ask before exporting in overwrite mode: Always ask before exporting images in overwrite mode.

Autre

password storage backend to use: The backend to use for password storage. Options: “auto” (default), “none”, “libsecret”, “kwallet”.
executable for playing audio files: Define an external program which is used in the lighttable view to play audio files that some cameras record to keep notes for images (default “aplay”).

Performance

Sun, 04 Dec 2022 02:19:02 +0100

Opencl

Sun, 04 Dec 2022 02:19:02 +0100

The background

Sun, 04 Dec 2022 02:19:02 +0100

Le traitement d’images en haute résolution est une tâche exigeante qui nécessite un ordinateur moderne. Que ce soit en termes de ressources mémoire et en termes de puissance du processeur CPU, tirer le meilleur partie d’une image typique de 15, 20 ou 25 mégapixels peut rapidement pousser votre ordinateur à ses limites.

Les exigences de Ansel ne font pas exception. Tous les calculs se font en virgule flottante 4x32 bits. Ceci est plus lent que l’algèbre «ordinaire» en entiers 8 ou 16 bits mais élimine tous les problèmes de ruptures de ton ou de pertes d’informations.

How opencl works

Sun, 04 Dec 2022 02:19:02 +0100

Comme vous pouvez l’imaginer, les architectures matérielles des GPU peuvent être très différentes. Il y a différents fabricants, et même, pour le même fabricant, différentes générations de GPU peuvent être différentes. Dans le même temps, les fabricants de GPU ne rendent pas public tous les détails matériels de leurs produits. Une des conséquences connues est la nécessité d’utiliser sous Linux des pilotes propriétaires si vous désirez tirer le maximum de votre carte graphique.

Activating opencl in Ansel

Sun, 04 Dec 2022 02:19:02 +0100

L’utilisation d’OpenCL dans Ansel nécessite que votre PC soit équipé d’une carte graphique adaptée et que les bibliothèques requises soient installées. Les cartes graphiques modernes de NVIDIA et d’ATI prennent en charge complètement OpenCL. Le compilateur OpenCL fait normalement partie du pilote graphique propriétaire ; il est utilisé sous la forme d’une bibliothèque dynamique appelée libOpenCL.so. Cette bibliothèque doit se trouver dans un répertoire qui puisse être trouvé par l’éditeur dynamique de liens de votre système.

Setting up opencl

Sun, 04 Dec 2022 02:19:02 +0100

La grande diversité des systèmes, les différences marquées entre les vendeurs OpenCL et les versions de pilotes, ne permettent pas de donner une vue d’ensemble de la manière de configurer OpenCL. Nous ne pouvons que vous donner un exemple pour la version du pilote NVIDIA 331.89 sur Ubuntu 14.04. Nous espérons que cela servira d’introduction de base et vous aidera à résoudre tous les problèmes spécifiques à votre configuration.

Le principe de fonctionnement d’OpenCL ressemble à ceci :

Possible problems & solutions

Sun, 04 Dec 2022 02:19:02 +0100

Ansel détecte automatiquement les problèmes d’OpenCL en cours de fonctionnement. Il effectuera alors le traitement sur le CPU ; seule la vitesse est affectée et le résutat final ne sera pas impacté.

Il peut y avoir plusieurs raisons pour lesquelles OpenCL peut échouer pendant la phase d’initialisation. OpenCL dépend des exigences matérielles et de la présence de certains pilotes et bibliothèques. De plus, tous ces éléments doivent correspondre en termes de fabricant, de modèle et de numéro de révision. Si quelque chose ne convient pas (par exemple, votre pilote graphique - chargé en tant que module de noyau - ne correspond pas à la version de votre libOpenCL.so), le support OpenCL ne sera probablement pas disponible.

Scheduling profile

Sun, 04 Dec 2022 02:19:02 +0100

Ansel can use the CPU and one or several OpenCL capable GPUs. Depending on the relative performance of these devices, users can choose among certain scheduling profiles to optimize performance. This is achieved by setting the configuration parameter Preferences > Processing > CPU, GPU, Memory > OpenCL scheduling profile, which offers the following choices:

default: If an OpenCL-capable GPU is found Ansel uses it for processing the center image view while the navigation preview window is processed on the CPU in parallel. This is the preferred setting for systems with a reasonably fast CPU and a moderately fast GPU. The exact allocation of devices to the various pixelpipe types can be finetuned with the “opencl_device_priority” configuration parameter (see multiple devices).
GPU très rapide: Avec ce profil de planification Ansel traite séquentiellement sur le GPU le panneau central contenant l’image et la fenêtre de prévisualisation. Ceci est le réglage préférable pour les systèmes qui ont un GPU surpassant fortement le CPU.
GPUs multiples: Ce réglage est destiné aux systèmes ayant plusieurs GPUs dont les performances relatives ne diffèrent pas de manière significative. Chaque fois qu’un travail de traitement est démarré, Ansel utilise tout GPU actuellement inactif mais pas le CPU. Les utilisateurs de systèmes avec une variété de GPUs auront besoin d’un meilleur contrôle sur la priorité relative de ceux-ci. Il serait préférable qu’ils choisissent le profil par “défaut” et affinent leur système avec le paramètre de configuration “opencl_device_priority” (voir multiples périphériques).

On first start-up or after any detected change in the GPU configuration of your system Ansel tries to identify the best suited profile for you. You can change it at any time in Preferences > Processing > CPU, GPU, Memory.

Multiple devices

Sun, 04 Dec 2022 02:19:02 +0100

Sur la plupart des systèmes, la planification des périphériques OpenCL peut être optimisée en utilisant le réglage du «profil de planification OpenCL». Cependant, si votre système est équipé de plus d’un GPU, vous pourriez souhaiter fixer manuellement la priorité relative des périphériques. Pour ce faire, vous devez sélectionner le profil de planification «par défaut» et définir vos paramètres dans le paramètre de configuration «opencl_device_priority».

Il est important de comprendre comment Ansel utilise les périphériques OpenCL. Chaque séquence de traitement d’une image – pour convertir une entrée en une sortie finale en utilisant un certain historique – est exécutée dans ce qu’on appelle un pipeline graphique. Il y a quatre types de pipelines graphiques différents dans Ansel. Un type est responsable du traitement de l’image du panneau central (ou vue complète) dans le mode chambre noire, un autre pipeline graphique traite l’image de prévisualisation de la fenêtre de navigation. Il peut y avoir une instance de chacun de ces deux pipelines graphiques en cours d’exécution à un instant donné, avec le pipeline graphique de prévisualisation et celui de l’image complète tournant en parallèle. De plus, il peut y avoir plusieurs pipelines graphiques tournant en parallèle pour effectuer l’exportation et il peut y avoir plusieurs pipelines graphiques qui génèrent les miniatures. Si un dispositif OpenCL est disponible, Ansel va l’allouer dynamiquement à un pipeline graphique spécifique pour une exécution et le libérer ensuite.

Opencl still does not run for me

Sun, 04 Dec 2022 02:19:02 +0100

As has been mentioned, OpenCL systems come with a huge variety of setups: different GPU manufacturers and models, varying amounts of GPU memory, different drivers, different distributions etc..

Beaucoup des problèmes potentiels n’apparaîtront qu’avec une combinaison spécifique de ces facteurs. Comme les développeurs de Ansel ont seulement accès à un nombre limité de ces variantes, comprenez que nous pouvons ne pas être à même de résoudre votre problème spécifique. Nous ne pouvons pas y faire grand chose s’il n’y a aucun moyen pour nous de le reproduire.

Memory & performance tuning

Sun, 04 Dec 2022 02:19:02 +0100

Memory requirements

Processing a raw image in Ansel requires a great deal of system memory. A simple calculation makes this clear: For a 20 megapixel image, Ansel requires a 4x32-bit floating point cell to store each pixel, meaning that each full image of this size will require approximately 300MB of memory just to store the image data. In order to actually process this image through a given module, Ansel needs at least two buffers (input and output) of this size, with more complex modules potentially requiring several additional buffers for intermediate data. Without further optimization, anything between 600MB and 3GB of memory might be required to store and process image data as the pixelpipe executes. On top of this is Ansel’s code segment, the code and data of any dynamically-linked system libraries, as well as further buffers that Ansel uses to store intermediate states (cache) for quick access during interactive work.

Storage

Sun, 04 Dec 2022 02:19:02 +0100

Database

check for database maintenance: Indicates when darktable should check for database fragmentation and perform maintenance. Options are “never”, “on startup”, “on close” and “on both”. Each of these is also available with an additional “(don’t ask)” option to perform the checks automatically without prompting (default “on close”).
seuil de fragmentation de la base de données: Taux de fragmentation (en pourcentage) au-dessus duquel la maintenance de la base de données doit être effectuée (sous réserve de la sélection effectuée dans l’option ci-dessus) (par défaut 25).
faire une sauvegarde de la base de données: Spécifie la fréquence des sauvegardes de la base de données. Les options sont «jamais», «une fois par mois», «une fois par semaine», «une fois par jour» et «à la fermeture» (par défaut «une fois par semaine»)
nombre de sauvegarde à conserver: Nombre de sauvegardes à conserver après la création d’une nouvelle sauvegarde, sans compter les sauvegardes de base de données effectuées lors du passage d’une version de Ansel à une autre. Entrez “-1” pour stocker un nombre illimité de sauvegardes. (par défaut 10)

Xmp

écrire un fichier redondant pour chaque image

Les fichiers XMP fournissent une méthode redondante pour enregistrer les modifications que vous avez apportées à une image, en plus de celles enregistrées dans la base de données de Ansel. Cette option vous permet de choisir quand écrire ces fichiers. Choisissez parmi:

jamais : N’écrit pas de fichiers XMP. Cela peut être utile si vous exécutez plusieurs versions de Ansel à des fins de développement/test, mais n’est normalement pas recommandé

après édition: Un fichier XMP est écrit la première fois que vous éditez une image et est mis à jour à chaque modification ultérieure. L’importation ne génère pas de fichier XMP par défaut

à l’importation : un fichier XMP est écrit dès que vous ajoutez une image à la bibliothèque de Ansel et est ensuite mis à jour à chaque fois que vous l’éditez.

Il est fortement recommandé de choisir soit “après édition” soit “à l’importation”. Les fichiers XMP fournissent une sécurité utile pour ne pas perdre de données si votre base de données était corrompue. La sauvegarde de votre fichier brut et du fichier XMP qui l’accompagne vous permet de restaurer complètement votre travail à une date ultérieure en ré-important votre historique de développement dans Ansel (par défaut “à l’importation”).

Miscellaneous

Sun, 04 Dec 2022 02:19:02 +0100

Interface

load default shortcuts at startup: When launching the application, Ansel loads default shortcuts first, and then loads user-defined shortcuts on top. This allows default shortcuts to be overridden with a new action but prevents them from being deleted (since the deleted shortcut will be automatically reloaded on the next restart). Deactivate this preference to stop loading default shortcuts on startup – only load the user-defined ones (including any defaults that you have not subsequently deleted or overridden). This makes deletion easier but also means that you will not benefit from new shortcuts added in future versions without first re-enabling this preference (default on).
scale slider step with min/max: When activated, the default step-size, when altering sliders, will depend on the current min/max values for that slider (default on).
sort built-in presets first: Choose how the presets menu is sorted. If this option is enabled, built-in presets are shown first. If the option is disabled, user presets are shown first (default on).
always show panels’ scrollbars: Defines whether the panel scrollbars should be always visible or activated only depending on the panel content (default on). (needs a restart)
position of the scopes module: Choose whether to show the scopes module in the left or right panel (default right). (needs a restart)
method to use for getting the display profile: This option allows the user to force Ansel to use a specific method to obtain the current display profile for color management. In the default setting “all”, Ansel will choose to query the X display server’s xatom or the colord system service. You can set this option to “xatom” or “colord” to enforce a specific method if the two methods give different results. You can run the Ansel-cmstest binary to examine your color management subsystem.

Étiquettes

omit hierarchy in simple tag lists: When exporting images any hierarchical tags are also added as a simple list of non-hierarchical tags to make them visible to some other programs. When this option is checked Ansel will only include the last part of the hierarchy and ignore the rest. So foo|bar|baz will only add baz.

Shortcuts with multiple instances

It is possible to create multiple instances of many processing modules. In this scenario it is not always obvious which instance should be controlled by keyboard shortcut operations. The following options control rules that are applied (in order) to decide which module instance keyboard shortcuts should be applied to.

Shortcuts

Sun, 04 Dec 2022 02:19:02 +0100

Some actions in Ansel can be performed with a keyboard shortcut. A table of key shortcuts is available in Help > Table of key shortcuts.

Note: The table shows different key shortcuts for different Views.

Assigning key shortcuts

For the time being shortcuts can only be defined or changed by editing your $HOME/.config/Ansel/shortcutsrc file. There is no support for MIDI-devices in Ansel.

Deleting default shortcuts

When launching the application, Ansel loads default shortcuts first, and then loads user-defined shortcuts on top. This allows default shortcuts to be overridden with a new action but prevents them from being deleted (since the deleted shortcut will be automatically reloaded on the next restart).

Presets

Sun, 04 Dec 2022 02:19:02 +0100

This menu provides an overview of the presets that are defined for Ansel’s modules, and allows you to modify some of their properties.

Les préréglages de base (ceux qui sont inclus par défaut dans Ansel) sont affichés avec un symbole de cadenas. Leurs propriétés ne peuvent pas être modifiées.

Les préréglages utilisateur peuvent être importés à partir de fichiers .dtpreset exportés à l’aide du bouton “importer” en bas de l’écran. Vous pouvez exporter tous les préréglages définis par l’utilisateur vers un seul répertoire à l’aide du bouton “exporter”.

Lua options

Sun, 04 Dec 2022 02:19:02 +0100

lua scripts installer don’t show again: Check this box to hide the lua scripts installer in the lighttable if no lua scripts are installed.

Color management

Sun, 04 Dec 2022 02:19:02 +0100

Ansel employs a fully color managed workflow:

Input color specifications are taken from embedded or user-supplied ICC profiles or (in the case of raw files) from a library of camera-specific color matrices.
Ansel automatically reads the display profile of your monitor (if properly configured) for accurate on-screen color rendition. Multiple-screen setups are fully supported as long as a system service like colord is in place and properly configured to inform Ansel of the correct monitor profile.

Display profile

Sun, 04 Dec 2022 02:19:02 +0100

For darktable to faithfully render colors on screen it needs to find the correct display profile for your monitor. In general this requires your monitor to be properly calibrated and profiled, and it needs the profile to be correctly installed on your system. darktable queries your X display server’s xatom as well as the system service colord (if available) for the right profile. If required you can enforce a specific method in preferences > miscellaneous.

Rendering method

Sun, 04 Dec 2022 02:19:02 +0100

Ansel peut rendre les couleurs soit avec ses propres algorithmes internes, soit en utilisant la bibliothèque externe LittleCMS2. La méthode interne de Ansel est plus rapide, d’un ordre de grandeur, que la méthode externe. L’option externe vous donne le choix de l’intention de rendu et peut offrir une précision légèrement supérieure dans certains cas.

You can change the default method in preferences > processing > always use LittleCMS 2 to apply output color profile

Rendering intent

Sun, 04 Dec 2022 02:19:02 +0100

If rendering with LittleCMS2 is activated (see rendering method) you can define how to handle out-of-gamut colors when converting between color spaces. A selection box in the export, output color profile, and soft proof modules gives you a choice of the following rendering intents:

perceptual: Best suited to photographs as it maintains the relative position of colors. This is usually the best choice.
relative colorimetric: Out-of-gamut colors are converted to colors having the same lightness, but different saturation. Other colors remain unmodified.
saturation: Saturation is retained but lightness is slightly changed.
absolute colorimetric: Keep the white point.

Ansel's color spaces

Sun, 04 Dec 2022 02:19:02 +0100

Les images d’entrée sont soit des fichiers RVB (comme des JPEG ou des TIFF) soit des RAW de l’appareil photo. Les deux stockent des informations visuelles sous la forme d’une combinaison de couleurs primaires (par exemple, rouge, vert et bleu) qui, ensemble, décrivent une émission lumineuse à recréer par un écran.

L’image suivante illustre ce concept.

Unbounded colors

Sun, 04 Dec 2022 02:19:02 +0100

Les écrans et la plupart des formats de fichiers image ne peuvent encoder que des intensités RVB confinées dans une certaine plage. Par exemple, les images encodées sur 8 bits ne peuvent contenir que des valeurs de 0 à 255, des images sur 10 bits de 0 à 1023, etc. Les standards graphiques postulent que le maximum de cette plage, quelle que soit sa valeur réelle, représentera toujours la luminosité maximale que le support d’affichage est capable de rendre, généralement entre 100 et 160 Cd /m² (ou nits). Nous appelons généralement ce maximum “100 % relatif à l’affichage”. Le minimum de la plage, codé 0 quelle que soit la profondeur de bits utilisée, devient alors “0 % relatif à l’affichage”. 100 % code le blanc pur, 0 % code le noir pur.

Possible color artifacts

Sun, 04 Dec 2022 02:19:02 +0100

There are some infrequent situations that still can lead to problematic results unless the user takes some action. Some modules in Lab color space rely on the fact that the L channels carries all lightness information, with the a and b channels purely representing chroma and hue. Unbounded colors with negative L values are especially problematic to these modules and can lead to black pixel artifacts.

On a constaté que des sources de lumière bleue hautement saturées dans l’image sont des candidats probables pour des pixels ayant des valeurs de L négatives. Si vous êtes engagé dans la photographie de spectacle, vous devez prêter une attention particulière à ces lumières apparaissant dans les images.

Dimensions de la couleur dans Ansel

Sun, 04 Dec 2022 02:19:02 +0100

Cette section définit les propriétés perceptuelles de la couleur, à la fois conceptuellement et quantitativement, afin de caractériser et de quantifier les ajustements créatifs et correctifs apportés à la couleur dans Ansel.

Définitions

Les propriétés de la couleur comme la “saturation”, la “luminosité” (brightness) ou la “clarté " (lightness) sont passées dans l’usage courant mais sont largement utilisées à mauvais escient et souvent utilisées pour signifier différentes choses. En science des couleurs, chacun de ces termes a une signification précise.

Command Line Interface

Sun, 04 Dec 2022 02:19:02 +0100

Ansel

Sun, 04 Dec 2022 02:19:02 +0100

Le binaire Ansel démarre Ansel avec son interface graphique et ses fonctionnalités complètes. C’est la manière standard d’utiliser Ansel.

Ansel peut être appelé avec les paramètres de ligne de commande suivants :

 1Ansel [-d {all,act_on,cache,camctl,camsupport,control,demosaic,
 2 dev,fswatch,imageio,input,ioporder,lighttable,lua,
 3 masks,memory,nan,opencl,params,perf,print,pwstorage,
 4 signal,sql,tiling,undo,verbose}]
 5 [<input file>|<image folder>]
 6 [--version]
 7 [--disable-opencl]
 8 [--library <library file>]
 9 [--datadir <data directory>]
10 [--moduledir <module directory>]
11 [--tmpdir <tmp directory>]
12 [--configdir <user config directory>]
13 [--cachedir <user cache directory>]
14 [--localedir <locale directory>]
15 [--luacmd <lua command>]
16 [--noiseprofiles <noiseprofiles json file>]
17 [--d-signal <signal>]
18 [--d-signal-act <all,raise,connect,disconnect,print-trace>]
19 [--conf <key>=<value>]
20 [-t <num openmp threads>]

Tous les paramètres sont optionnels. Dans la plupart des cas, les utilisateurs lanceront Ansel sans paramètres supplémentaires. Dans ce cas, Ansel utilise les valeurs par défaut adaptées.

Ansel-cli

Sun, 04 Dec 2022 02:19:02 +0100

The ansel-cli binary starts the command line interface variant of Ansel which allows images to be exported.

Cette variante n’ouvre aucun affichage – elle travaille en mode console pur sans lancer d’interface graphique. Ce mode est particulièrement utile pour les serveurs exécutant des tâches en arrière-plan.

ansel-cli can be called with the following command line parameters:

 1ansel-cli [<input file or folder>]
 2 [<xmp file>]
 3 <output file or folder>
 4 [--width <max width>]
 5 [--height <max height>]
 6 [--hq <0|1|true|false>]
 7 [--upscale <0|1|true|false>]
 8 [--style <style name>]
 9 [--style-overwrite]
10 [--apply-custom-presets <0|1|false|true>]
11 [--out-ext <extension>]
12 [--import <file or dir>]
13 [--icc-type <type>]
14 [--icc-file <file>]
15 [--icc-intent <intent>]
16 [--verbose]
17 [--help [option]]
18 [--core <Ansel options>]

L’utilisateur doit fournir un nom de fichier d’entrée et un nom de fichier de sortie. Tous les autres paramètres sont optionnels.

Ansel-generate-cache

Sun, 04 Dec 2022 02:19:02 +0100

The ansel-generate-cache binary updates Ansel’s thumbnail cache. Invoke this program to generate all missing thumbnails in the background when your computer is idle.

ansel-generate-cache can be called with the following command line parameters:

1ansel-generate-cache
2 [-h, --help]
3 [--version]
4 [--min-mip <0-8>] [-m, --max-mip <0-8>]
5 [--min-imgid <N>] [--max-imgid <N>]
6 [--core <Ansel options>]

All parameters are optional. If started without parameters ansel-generate-cache uses reasonable defaults.

Ansel-cltest

Sun, 04 Dec 2022 02:19:02 +0100

L’exécutable Ansel-cltest vérifie s’il y a sur votre système un environnement OpenCL utilisable par Ansel. Il émet une sortie de débogage équivalente à celle qu’on obtient par l’appel Ansel -d opencl et puis s’arrête.

Ansel-cltest est appelé sans paramètre sur la ligne de commande.

Ansel-cmstest

Sun, 04 Dec 2022 02:19:02 +0100

L’exécutable Ansel-cmstest (sous Linux uniquement) détermine si le sous-système de votre ordinateur gérant la couleur est correctement configuré et affiche des informations utiles sur le(s) profil(s)-moniteur installé(s) .

Ansel-cmstest est appelé sans paramètre sur la ligne de commande.

Purge_non_existing_images.sh

Sun, 04 Dec 2022 02:19:02 +0100

Recherche et supprime des entrées de la base de données de la bibliothèque référençant des images qui n’existent plus dans le système de fichiers. Vous devez fermer Ansel avant d’exécuter ce script.

Le script peut être appelé avec les paramètres suivants de la ligne de commande :

1purge_non_existing_images.sh [-c|--configdir <path>]
2 [-l|--library <path>]
3 [-p|--purge]

Exécutez le script sans aucune option pour effectuer un « galop d’essai », qui génère un rapport des fichiers manquants sans engager de modifications dans la base de données.