masques on Ansel

Transitioning from darktable to Ansel

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

What was removed from mainstream darktable

Features

The tethering view: It relies on the lib GPhoto2 which is super brittle and buggy. The tethering view is merely a GUI over Gphoto2, much like Entangle . The problem is GPhoto2 is known to break something different at each new release, so it’s simply not worth the trouble to maintain a GUI over a Schrödinger cat. Use Entangle if you need to.
The easter egg video game: Not funny if you happen to be with a client on April 1st and your working app opens on a silly game that can’t even be closed with Ctrl+Q. (Yes, it happened to me).
The histogram overlay control for exposure and black level: It’s too easy to inadvertently mess up exposure when cycling through scopes (especially with a Wacom tablet) and it adds unnecessary GUI motion events and redraws. In cases of multiple instances of exposure module, it is automatically linked to the controls of the last instance, which is generally wrong because it is typically masked.
The new filtering option: A beautiful shit made of 6300 lines of bloat and still counting, that needs a screen-reader to understand WTF those icons mean, supposed to fix a problem nobody had with something that adds bugs and trouble. That thing is the poster case of everything that’s wrong in Geektable 4.0. It should be called a regression. The same feature is achieved in Ansel with about 580 lines of code. And to say that the new filtering started as a refactoring project… Never let the darktable idiots refactor anything, it’s too dangerous.
The stars rating toolbar in lighttable: It’s redundant with overlays and requires to travel too far with the cursor to set it. Use overlays with cursor or key shortcuts to set stars.
The timeline: terrible code and a huge loss of CPU cycles for a niche feature that essentially serves no purpose. This was responsible for way too many SQL requests and removing it is responsible for most of the GUI responsiveness improvement.
The main window borders with collapsing arrows / silly cycling through headers: The borders marked with arrows allow to collapse or expand the GUI panels. But they waste space, are typically too narrow for many displays, and tend to reappear when you don’t want them because their state is defined per view. For now, collapsing side-bars can be achieved with Ctrl + Shift + L(eft), Ctrl + Shift + R(ight), top bar with Ctrl + Shift + T(op) and bottom bar with Ctrl + Shift + B(ottom). In the future, a global menu (you know, like in any app since 1990) will take care of that with a view menu.; The silly cycling through all the possible combinations of headers and bottoms that happened when hitting Ctrl + Shift + T(op) or Ctrl + Shift + B(ottom) has been completly removed. Ctrl + Shift + T(op) toggles the top toolbar only and leaves the main header unchanged (use Ctrl + H(eader) to toggle it). Ctrl + Shift + B(ottom) toggles the bottom toolbar only and leaves the filmstrip unchanged (use Ctrl + F(ilmstrip) to toggle it).; Removing the borders allowed to increase the width of the sidebars scrolling sliders for better interaction.
The second darkroom window: darktable is slow enough with 2 pipelines (thumbnail & preview), a third one is not realistic. This should have been the main preview redirected to another window but the code has been hastily hacked by copy-pasting, it’s terrible. Also there is no traceability on which display profile will be used, good luck with that.
The block and timeout overlay mode in lighttable: terrible code for another niche feature that nobody tests until bug appear on the issue tracker that will be answered with “it works on my computer”.
The extended overlays mode for thumbnails: each of the EXIF metadata display triggered its own SQL request per-thumbnail, because no cache was used, because the guy who coded that doesn’t learn or doesn’t care, but such a loss of CPU cycles is inacceptable.
The non-dynamic culling mode and the zoomable lighttable view: They are not really used and need a lot of spaghetti code to be handled.
The dark and icon themes: dark themes trigger all sorts of unwanted visual illusions that make color assessment impossible. Their use is discouraged everywhere on darktable’s doc but they are still there.
The ability to assign keyboard shortcuts to Gtk notebook tabs, as well as switching tabs by mouse scroll.: Just because you can doesn’t mean you should, and capturing mouse scroll on inner tabs messes up with sidebar scrolling (you know, the regular scolling over content that doesn’t fit in the viewport).
The VIM-style shortcuts: I bet you never knew, but if you start typing : in darktable, followed by a command, you can trigger stuff. This feature has never documented and the available features are really limited, but that still listens to all keystrokes to check if it should capture them.
The histogram profile: That thing is coded by copy-pasting the display code, instead of writing reusable functions. It wouldn’t be that bad if it wasn’t completely misleading and actually broke the over-exposure alert (because, yes, it’s used there too). Because the histogram is captured at the far end of the pipeline, in display color space, it might be already clipped to display gamut. Say you use Rec2020 space as the histogram profile, because it’s the working space, what you see is RGB clipped to display space then rescaled to Rec2020, which means your clipping peak will not be at the far end of the graph, where you expect it. The result is highly misleading and voids the whole principle of a scope. That’s just a whole pile of crap coded by people who have no idea of what a graphic pipeline is and hack small bits here and there because the concept of “modules” fooled them. They might be modular, but they still apply in sequence in the pipeline, so better check your inputs.
Warning messages in modules: I’m responsible for that stupidity. The warning messages were supposed to tell users they are doing things not really intended by the designer (for example, using 2 different steps of white balance correction) and to ask them to double-check if that’s really what they wanted. That backfired badly because users don’t get the difference between an error and an alert, so even when instructed to use 2 white balances (for example, a custom-corrected raw WB), they would get afraid by the “error” and annoy me with questions. Given that this feature is clearly not helping anybody, and did not trigger the expected behaviour (that is, RTFM), there is no point in keeping it. The option to hide them is removed as well.
Favourite presets button: There was this favourite presets button at the left of the bottom panel in darkroom, and I found nobody who ever used it. In fact, most people who I asked did not ever know it even existed. So it’s gone.
Importing from camera: darktable has a way to mount the camera file system (SD or CF memory cards) through USB, using the library GPhoto2. But the desktop environment is also be able to mount the camera as a local hard drive using PTP and/or MTP protocol, possibly also through Gphoto2. In that case, darktable and the OS may compete for access to the USB media, so you need to unmount it first from the OS to be able to open it from darktable. On Windows, you even need to install custom USB drivers to make it work with GPhoto2, but these drivers will prevent the camera to work with the OS until you completly remove and reset them. So this feature is completely removed, and Ansel loads memory cards as USB media through the OS mounts. To enable this, you may have to install Linux packages such as libmtp, linuxptp, libptp, libgphoto2 and possibly gphoto2. For your desktop environnment, you may install kio-mtp and kio-extras on KDE or gvfs-mtp and gvfs-gphoto2 on Gnome. In any case, you are advised to simply use an SD of CF card reader, it’s cheap and prevents most issues that can arise from udev and cameras connected through USB.

Overall, 5 to 6 SQL requests per thumbnail per “mouse over” event are now spared, due to the features removed (which still lets 3 requests…, aka 2 more than what should be).

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

Prerequisites

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

Prerequisites

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

Prerequisites

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 exiv2, 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.

Importing usual darktable configuration files

Note

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

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

Ansel will then perform database extractions based on arbitrary user criteria : those are called collections. They are built in lighttable from the library toolbox and from the include toolbar. Ansel has no concept of gallery or virtual folder that you create first, then to which you add arbitrary images. Instead, in Ansel, you attach tags to images, then collect all images having a certain tag (or any kind of metadata, base folder, etc.), possibly mixing filters and search criteria to narrow-down the search : this is what makes a collection.

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.

Views

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

Les fonctionnalités de Ansel sont réparties en six vues différentes :

Lighttable: Manage images and collections. It is the main view and can be accessed from anywhere in the software by hitting the Escape key.
Darkroom: Develop a single image. It can be accessed from the lighttable by double-click on a thumbnail or by hitting the Enter key when a picture is selected.
Map: Show geo-tagged images on a map and manually geo-tag new images. It is an optional view hidden by default, it can be enabled in the preferences.
Print: Send images to a printer for self-made prints. It is an optional view hidden by default, it can be enabled in the preferences. This view is not available on Windows since it relies on CUPS .
Slideshow: Display images as a slideshow, processing them on-the-fly. It is an optional view hidden by default, it can be enabled in the preferences.

You can switch between views by clicking the view name at the top of the right-hand panel (the currently active view is highlighted).

Table lumineuse

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

The lighttable view is the default view loaded when Ansel is started, and allows you to view and manage your image collection. It will noticeably allow you to:

cull your images, assign then ratings and ultimately decide which images are worth keeping and editing,
filter your images based on ratings, base folder, or any metadata supported by the software (EXIF/IPTC/XMP),
apply metadata, like title, description, tags, GPS coordinates, or correct EXIF date/time,
copy-paste editing histories between images or apply styles, individually or in batches,
export images editing histories to final files.

Lighttable content

All the images known to Ansel are stored in a database, the library. The lighttable shows thumbnails of a subset of this library, called a collection. A collection is created by filtering the images from the library using criteria, first from the library toolbox, then from filtering/include toolbar.

annuler/refaire

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

La plupart des modifications de la table lumineuse sont enregistrées et peuvent être annulées. 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. Notez que cette fonction annuler/refaire accepte un nombre illimité d’enregistrements d’états tant qu’on reste dans la table lumineuse, mais elle est réinitialisée à chaque fois que vous passez à une autre vue.

gestion des données numériques

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

sidecar files

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

Ansel is a non-destructive image editor and opens all images in read-only mode. Any data created within Ansel (metadata, tags, and image processing steps) is stored in separate .XMP sidecar files. These files are stored alongside the original Raw files and allow Ansel to store information about the images as well as the full editing history without touching the original raw files. When you import an image into Ansel for the first time, an XMP file is automatically generated. The generation of XMP files can be disabled in preferences > storage > xmp but this is not recommended in normal use.

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

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

When importing an image, Ansel automatically checks if it is accompanied by a sidecar file. As well as looking for files named <basename>.<extension>.xmp and <basename>_nn.<extension>.xmp (Ansel’s XMP file naming formats) Ansel also checks for the presence of a file in the form <basename>.xmp (the naming format for Lightroom’s XMP sidecar files). Files with the latter naming format will be read by Ansel but will not be written to. Once the image has been imported, Ansel will generate an additional XMP file using its own naming convention.

local copies

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

It is a common requirement to develop a number of images while travelling using a laptop and then later synchronize them back to the original storage medium. However, copying images manually from the main storage to the laptop and back is cumbersome and prone to errors. The “local copies” feature of Ansel has been designed to directly support these use cases.

miniatures

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

Each image in the current collection is represented by a thumbnail in the lighttable view and filmstrip module. A cache of the most recently used thumbnails is stored in a file on disk and loaded into memory at startup. The size of this cache can be adjusted in Preferences > Processing > CPU, GPU, Memory.

thumbnail creation

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.

star ratings

You can give an image a rating from zero to five stars. Whenever you import images, each image receives a default rating which you can define in the import module. You can also mark an image as “rejected”.

image grouping

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.

You can combine images into a group by selecting them and using the global menu Image 🡒 Group images, or by pressing Ctrl+G. Likewise, you can remove selected images from a group by clicking the “ungroup” button, or pressing Ctrl+Shift+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

Metadata (e.g. title, description) is free-format text that usually differs for each image. You can add metadata to images in the metadata editor module.

Chambre noire

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

La vue chambre noire est l’endroit où vous développez vos images. Le panneau central contient l’image en cours de développement.

zoom

Middle-click on the center panel cycle between “fit to screen”, 1:1 and 2:1 zoom.

Vous pouvez aussi zoomer entre 1:1 et « adapter à l’écran » en faisant défiler avec votre souris. Faites défiler tout en maintenant la touche Ctrl enfoncée pour étendre la plage de zoom entre 2:1 et 1:10.

disposition de la vue chambre noire

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

left panel

From top to bottom:

navigation: Navigate and zoom the center view.
snapshots: Take and view snapshots for comparison with the current edit.
duplicate manager: View and manage duplicates.
global color picker: Select and display color information taken from parts of the image.
image information: Display information about the current image.
mask manager: View and edit drawn shapes.

right panel

From top to bottom:

le pipeline graphique

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

the anatomy of a processing module

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

The basic element of image processing in Ansel is the processing module. In order to process a raw image a number of such modules act on the input image in sequence, each performing a different operation on the image data. For those familiar with Adobe Photoshop, the concept of a processing module in Ansel is analogous to that of an adjustment layer in that both make an incremental adjustment to the image, building on top of the adjustments that came before.

le pipeline graphique & l'ordre des modules

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

The ordered sequence of processing modules operating on an input file to generate an output image is known as the “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.

the history stack

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.

Each time a processing module is enabled, disabled, moved or amended a new entry is added to the top of the history stack.

undo and redo

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

masking & blending

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

Each processing module takes its input from the preceding module in the pixelpipe, performs its operation on the image data, and then hands the output to the next module in the pixelpipe.

Les données de sortie d’un module peuvent être optionnellement retraitées (combinées) avec ses données d’entrée avant d’être transmises au module suivant. Cette étape supplémentaire dans le traitement est appelée fusion – entrée et sortie peuvent être traitées avec différents algorithmes, appelés opérateurs de fusion ou modes de fusion.

blend modes

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

Blend modes define how the input and output of a module are combined (blended) together before the module’s final output is passed to the next module in the pixelpipe.

Les modes de fusion classiques, conçus pour RVB relatif à l’affichage (contraint à 0-100 %), définissent implicitement dans leurs algorithmes un pivot à 50 % (gris) ou à 100 % (blanc), selon le mode de fusion. Étant donné que le mode relatif à la scène n’est pas soumis à ces restrictions, ce pivot doit être explicitement défini par l’utilisateur lors de l’exécution d’opérations de fusion dans l’espace colorimétrique « RVB (scène) ». Le paramètre supplémentaire pivot de fusion sera présenté à l’utilisateur lors de l’utilisation de l’un des modes de fusion dans cet espace colorimétrique. L’effet dépend de l’opérateur utilisé. Par exemple, les valeurs au-dessus du pivot peuvent être éclaircies et les valeurs inférieures obscurcies, ou vice versa.

masques

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

Masks allow you to limit the effect of a module so that it only applies to certain parts of the image.

Un masque peut être considéré comme une image en niveaux de gris où chaque pixel a une valeur comprise entre 0,0 et 1,0 (ou entre 0 % et 100 %). Cette valeur est l’opacité et est utilisée pour déterminer dans quelle mesure un module affecte chaque pixel.

Les sections suivantes expliquent comment construire des masques dans Ansel.

drawn masks

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

Avec la fonctionnalité masque dessiné, vous pouvez construire un masque en dessinant des formes directement sur l’image. Les formes peuvent être utilisées seules ou combinées. Une fois qu’une forme a été dessinée sur une image, elle peut être ajustée, supprimée ou réutilisée dans d’autres modules.

Shapes are stored internally as vectors and are rendered with the required resolution during pixelpipe processing. Shapes are expressed in the coordinate system of the original image and are transformed along with the rest of the image by any active distorting modules in the pipe ( lens correction, rotate and perspective for example). This means that a shape will always work on the same image area regardless of any modifications that may be subsequently applied.

parametric masks

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

La fonction masque paramétrique offre un contrôle sélectif précis sur la façon dont les pixels individuels sont masqués. Pour ce faire, il génère automatiquement un masque de fusion intermédiaire à partir de paramètres définis par l’utilisateur. Ces paramètres sont des coordonnées de couleur plutôt que des coordonnées géométriques utilisées dans les masques dessinés.

Pour chaque canal de données d’un module (par exemple, Lab, RVB) et pour certains canaux de données virtuels (par exemple, teinte, saturation), vous pouvez construire une fonction d’opacité. En fonction de la valeur de chaque pixel pour un canal donné, cette fonction calcule un facteur de fusion compris entre 0 et 1 (100 %) pour ce pixel.

combining drawn & parametric masks

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 :

raffinement du masque et contrôles supplémentaires

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.

seuil de détails: Cette commande vous permet de modifier l’opacité du masque en fonction de la quantité de détails dans l’image. Utilisez ce curseur pour sélectionner soit des zones avec beaucoup de détails (valeurs positives) soit des zones plates et manquant de détails (valeurs négatives). La valeur par défaut (zéro) contourne efficacement le raffinement des détails. Ceci est surtout utile pour appliquer des effets de netteté et de flou qui ignorent les zones hors focus (bokeh) ou pour accentuer uniquement les parties floues, empêchant ainsi une netteté excessive des zones de focus.

Remarque : Les données utilisées pour le raffinement du masque de détails proviennent de l’étape de dématriçage dans le pipeline de traitement, et non de l’entrée du module (qui est utilisée pour les autres critères de masque paramétrique). Aucun des modules de traitement après le dématriçage n’aura d’effet sur le masque de détails et il n’est actuellement pas disponible pour les images non RAW.

raster masks

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

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

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.

flux de travail

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 :

aberrations chromatiques raw

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

Correct chromatic aberrations of raw images.

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

cadre décoratif

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.

module controls

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.
show guides: Tick the box to show guide overlays whenever the module is activated. Click the icon on the right to control the properties of the guides. See guides & overlays for details.

censurer

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

color balance rgb

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.

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

introduction

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.

color calibration

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 :

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

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.

module controls

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.

local laplacian

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 du profil d'entrée

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.

courbe rvb

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

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

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

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

dématriçage

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

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

bayer filters

The sensor cells of a digital camera are not color-sensitive – they are only able to record different levels of lightness. In order to obtain a color image, each cell is covered by a color filter (red, green or blue) that primarily passes light of that color. This means that each pixel of the raw image only contains information about a single color channel.

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.

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

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

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

exposition

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

module controls

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 rgb

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

filtre dégradé

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.

module controls

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)

flou de surface

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

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

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

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

flous

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

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

blur types

Trois types de flous sont fournis :

lens blur: Simulates a lens diaphragm with a configurable number of blades and blade curvature to create synthetic bokeh.
motion blur: Simulates the effect of camera motion with a configurable path.
gaussian blur: This is not really an optical blur but can be used for denoising or for creative effects using blend modes

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.

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.

module controls

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

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

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 .

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

lens correction

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

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

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

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

liquify

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.

Each instance of the liquify module is limited to a maximum of 100 nodes – for more nodes, use additional instances. However, please note that the liquify module consumes a lot of system resources.

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.

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

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 rvb

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

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

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

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

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.

module controls

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
show guides: Tick the box to show guide overlays whenever the module is activated. Click the icon on the right to control the properties of the guides. See guides & overlays for details.

pixels chauds

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.

module controls

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.

profil de couleur d'entrée

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

Define how Ansel will interpret the colors of the image.

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

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.

module controls

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.

recadrer

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.

reconstruction des couleurs

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.

réduction du bruit photo astro

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.

réduction du bruit RAW

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 .

module controls

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.

renforcer la netteté

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.

retouch

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.

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

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.

suppression de la brume

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.

table correspondance couleurs

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

module controls

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.

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 :

vignetting

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

Apply a vignetting effect to the image.

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

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

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.

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

Carte

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

The Map view is optional and needs to be activated in Preferences > Other views. It allows you to see where your geo-tagged images were taken, and to add location information to non-geo-tagged images.

The Map view shows a world map with the images in the current collection pinned to their geo-tagged location (if available). This requires that images are tagged with location information. Some newer cameras, including smartphones, are already equipped with GPS receivers. Other cameras may need additional GPS hardware to do this.

Slideshow

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

The Slideshow view is optional and needs to be activated in Preferences > Other views. It allows you to watch a slideshow of your current collection with the associated filtering rules and sort order applied.

To learn more about how to define the collection and filtering rules, see the section on collections.

The next section provides more details on the usage of the Slideshow view.

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
 2spacebar start and stop auto-advance mode which automatically switches
 3 to the next images every five seconds by default.
 4
 5ESC leave slideshow mode and return to lighttable view.
 6
 7
 8+ or increase delay between each image.
 9up arrow
10
11- or decrease delay between each image.
12down arrow
13
14left-click or
15right arrow or switch to the next image of the collection.
16right shift-key
17
18right-click or
19left arrow or switch to the previous image of the collection.
20left shift-key

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.

Print

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

The Print view is optional and needs to be activated in Preferences > Other views. This view allows you to print your images. Because printing is not easy, there are many technical aspects to be taken into account.

After selecting an image in the Lighttable view you can enter the Print settings module to adjust printer settings and initiate printing.

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.

The filmstrip below the image allows you to select more 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.

GUI toolboxes

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

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 permet de stocker les informations les concernant (nom de fichier, chemin d’accès, données Exif, données des fichiers XMP sidecar, etc) dans la base de données de la bibliothèque. Une collection peut être 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.

clipping warning

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.

Display metadata

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

Affiche les informations contenues dans les données EXIF d’une image ainsi qu’un certain nombre de champs spécifiques à Ansel.

Lorsque vous passez la souris sur les miniatures des images, les données affichées sont automatiquement mises à jour avec les informations de l’image actuellement sous le curseur de la souris.

Lorsque plusieurs images sont sélectionnées et que le focus n’est pas sur une seule image, le module n’affiche que des informations qui sont les mêmes pour toutes les images. Si des champs diffèrent entre les images, le texte “<valeurs diverses>” s’affiche à la place.

duplicate manager

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

View and create multiple versions of the current image. Each version can be edited independently without affecting other versions – all versions use the same underlying image file, but the editing history of each version is stored in its own independent XMP sidecar file.

The duplicate manager lists each version of the current darkroom image along with its preview thumbnail. Hold down the left mouse button on a thumbnail to temporarily show that version in the center view. Double-click to switch to that version and edit it.

éditeur de métadonnées

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

Edit the metadata of selected images.

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

When several images are selected having different values for a given metadata field, the module displays for that field – if you choose to apply changes, these fields will not be changed. If you right-click on the field the different values are listed at the end of the contextual menu. Select one of the values in the menu to apply that value to all of the selected images – the change will be saved once you press the “apply” button or the Enter/Tab key.

emplacements

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

Create areas or locations and organize them as hierarchical tags.

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.

épreuvage écran

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

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

Click the

icon to activate the soft proof display mode on your image. This allows you to preview your image rendered using a printer profile to see how colors will end up on the final print. You can also activate soft proof with the keyboard shortcut Ctrl+S. A message “soft proof" on the bottom left of your image tells you that you are in soft proof display mode.

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

When developing an image, the way we perceive brightness, contrast and saturation is influenced by the surrounding ambient conditions. If an image is displayed against a dark background, this can have a number of adverse effects on our perception of that image:

Exaggeration of the perceived exposure makes the image seems brighter than it really is. This is nicely illustrated by the Adelson checkerboard shadow effect .
A decrease in the perceived saturation in the image makes the colors seem less rich than they really are (the Hunt effect).
A decrease in the perceived contrast in the image makes the tones seem flatter than they really are (Bartleson-Breneman effect 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.

exporter

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

Export selected images.

Files can be exported to a file on disk, email, various online storage locations, a web album, or a book template.

module controls

storage options

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.

filename template

Define the folder and file to which the image will be exported. This can be automatically generated using several pre-defined variables. See the variables section for details.

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.

overwrite: Automatically overwrite existing files. This option will present you with a confirmation dialog in order to protect you from accidental data loss – you can disable this in preferences > security > ask before exporting in overwrite mode. Note: This dialog is not presented per-file but as a one-off confirmation before the export job starts.

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.

in pixels (for file): Enter the maximum width and height in 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.

store masks

Store masks as layers in exported image. Only works for some image formats (currently TIFF and XCF).

profile

The output color profile. Select “image settings” if you want the settings in the output color profile module of the individual images to be respected.

intent

This option lets you define the intent – the way in which Ansel will handle out-of-gamut colors. See rendering intent for a more detailed description of the available options.

style

Choose a style which Ansel will combine with the existing history stack to generate the output image. These history items are only added temporarily – the original history stack is not overwritten. You can use this feature to add processing steps and parameters that you want to be applied specifically to images before export. For example you may define a style that adds a stronger level of sharpening when you produce scaled-down JPEG files for the internet or add a certain level of exposure compensation to all of your output images.

mode

When applying a style during export this option defines whether the history stack items of that style replace the original history stack of the image or are appended to it. Technically speaking, in append mode history stack items of the style will constitute separate instances of the respective modules on top of any existing ones. As a consequence the original history stack will remain in effect with the new items being applied in addition. This way you can apply an overall adjustment (e.g. exposure) to a number of exported images while respecting the settings of each individual image.

export

Press this button to start a background job to export all selected images. A bar at the bottom of the left hand panel displays the progress of the export job. Furthermore a notification message pops up reporting the completion of each individual export. You may click on the pop-up to make it disappear. You may abort the export job by clicking on the “x” icon located close to the progress bar.

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

Identify which parts of the image contain high-contrast details, like edges and textures, which usually indicates that those areas are in focus.

Activate the module by clicking on the

icon. The sharp parts of the image will be highlighted with a yellow, green and blue overlay:

Focus peaking works by filtering out most of the image noise, measuring the intensity gradients in the image and calculating average and standard deviation statistics. When the gradient of an edge differs significantly from the mean, the associated pixels are marked with a “heat map” indicating how sharp the edge is.

géolocalisation

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

Importe et applique les données de traces GPX à une sélection d’images.

This module is common to the lighttable and map views. The map view provides an enhanced mode that allows you to preview the position of the images along the GPS tracks while adjusting the images’ date/time offset and time zone.

présentation des flux de travail

Un récepteur GPS calcule sa position courante à partir des informations qu’il reçoit des satellites et les enregistre, avec la date et l’heure courante, dans un fichier GPX. Les données EXIF des images contiennent aussi une estampille temporelle définie par les paramètres de l’appareil photo. Le module de géolocalisation prend l’estampille temporelle de l’image, cherche la position dans le fichier GPX correspondant à cette heure, et stocke les coordonnées (latitude/longitude/altitude) dans sa base de données et dans le fichier XMP associé à l’image.

gestion des masques

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

Manage all masks and shapes for the current image.

This module can be used to create, rename, edit and delete shapes. You can add shapes to and remove shapes from a mask, group shapes together, and combine them using set operators.

The top line of the mask manager panel contains buttons that can be used to create new shapes. These are the same as in the drawn mask interface of in processing modules.

global color picker

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

Take color samples from the current darkroom image, display their values in multiple ways and compare colors from different locations.

La pipette de couleur est activée en cliquant son icône. Les paramètres du module resteront en vigueur jusqu’à ce que vous quittiez le mode chambre noire.

Besides the global color picker described here, many Ansel modules (e.g. RGB curve) also contain local color pickers which are used to set individual module parameters. You should be aware that these two forms of color picker do not always work in the same color space. The global color picker works in the histogram color space and takes its samples after the complete pixelpipe has been processed. Local color pickers run in the color space of the module in which they are activated and reflect the input or output data of that module within the pixelpipe.

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

global guides

Left-click the

icon in the bottom bar to globally display guide overlays. The overlays will remain switched on until you click the button a second time to switch them off.

historique

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

View and modify the history stack of the current darkroom image.

Ce module liste chaque changement d’état (activer/désactiver/déplacer/changer les paramètres) pour tous les modules de traitement qui ont été modifiés pour l’image courante. Sélectionnez un point dans l’historique pour revenir à l’étape correspondante de développement de l’image. Maj+clic sur un élément de l’historique pour déplier le module correspondant dans le panneau des modules, à droite, sans modifier le développement actuel.

lua scripts installer

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.

It can be disabled with an option in preferences > lua options.

navigation

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

Faire un zoom et un panoramique de l’image actuellement en développement.

En haut à gauche de la chambre noire, le panneau navigation affiche un aperçu complet de l’image actuelle. Un rectangle indique la zone actuellement visible dans le panneau central. Faites glisser le rectangle pour effectuer un panoramique de la vue agrandie. L’échelle de zoom actuelle est affichée à droite de l’image d’aperçu. Cliquez sur cette figure pour accéder rapidement à certains niveaux de zoom courants.

ordre des modules

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

Change the order of the processing modules in the darkroom using presets.

When processing an image, the active modules are applied in a specific order, which is shown in the right-hand panel of the darkroom view. This module provides information about the current ordering of the processing modules in the pixelpipe. The name of the currently-selected preset is shown in the module header (or “custom” if the user has manually modified the order). The following presets are available for selection.

paramètres d'impression

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

Manage settings for the print view and initiate printing.

module controls

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é.
intent: The print rendering intent (“perceptual”, “relative colorimetric”, “saturation” or “absolute colorimetric”). See rendering intent for more details.
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 or landscape (note that darktable chooses the best fit by default).
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.
delete image area button: Remove the currently selected image area from the 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 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…).

module controls

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

The maximum number of thumbnails to display on the map.

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

The filmstrip can be used to quickly switch between images. The images shown are the same as those displayed in the lighttable view and are defined by the currently-selected collection.

raw overexposed warning

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

Highlight areas of the image where color channels of the raw input file are clipped.

Clipped color channels imply an overexposed image with loss of information in the affected areas. Some of this information may be recoverable using the highlight reconstruction, color reconstruction or filmic rgb modules.

Click on the

icon to show/hide the warning overlay. Right-click on the icon to open a dialog containing the following configuration parameters.

scopes

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

This module provides various graphical depictions of the developed image’s light levels or chromaticity.

Déplacez la souris sur le panneau pour afficher les boutons qui vous permettent de régler l’affichage. Le bouton le plus à gauche permet de passer d’un mode à l’autre : histogramme, forme d’onde, parade RVB et vectorscope. Les autres boutons contrôlent la façon dont le graphique de l’oscilloscope actuel est dessiné.

snapshots

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

Stocke les instantanés de développement et les compare avec la modification actuelle.

A snapshot is a stored bitmap of the center image in the darkroom view. Snapshots can be taken at any point in the development process and later overlaid onto the current center view. This allows you to undertake a side by side comparison (by default left=snapshot, right=active edit) while you are tuning parameters of a module. This can also be combined with the history stack module to compare a snapshot against different stages of development.

styles

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

Create named styles from selected images’ history stacks and apply styles to selected images.

Styles can either be created within this panel or in the history stack module in the darkroom.

Une liste de tous les styles disponibles s’affiche dans le module. Un champ de recherche au-dessus de la liste vous permet de localiser un style par son nom ou sa description. Ce module permet également d’éditer et de supprimer des styles.

tagging

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

Manage tags attached to images.

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.

Tags are physically stored in XMP sidecar files as well as in Ansel’s library database and can be included in exported images.

definitions

Les définitions suivantes supposent que vous avez configuré un seul mot-clé nommé “places|France|Nord|Lille”.

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.

Click the

are mutually exclusive modes.

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.

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

use raw file instead of embedded JPEG from size: When generating thumbnails for images that have not yet been processed in the darkroom, if the thumbnail size is greater than this value, generate it by processing the raw image data. If the thumbnail is below this size, use the JPEG preview image embedded in the raw file. Once an image has been processed in the darkroom, thumbnails will always be generated from raw data (you can revert back to the JPEG preview by discarding history). To render thumbnails with the best quality choose “always”.
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).
afficher l’écran de chargement entre les images: Afficher l’écran de chargement gris lors de la navigation entre les images dans la chambre noire. Désactivez cette option pour afficher un simple message et laissez l’image précédente jusqu’à ce que l’image suivante soit chargée. Notez que la désactivation de cette option peut être très utile pour comparer rapidement les images en double, cependant, il peut y avoir des problèmes si le temps de chargement est long (vous laissant penser que l’image suivante a déjà été chargée) et vous pouvez observer des artefacts visuels pendant le chargement de l’image suivante (activé par défaut).

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

cacher les préréglages internes des modules de développement

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 pour le traitement des modules – les préréglages intégrés seront masqués (désactivée par défaut).

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.

traitement

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

Contrôler le traitement des images.

traitement de l’image

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

sécurité

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).
demander avant de supprimer des images sur le disque: Toujours demander à l’utilisateur avant de supprimer une image ou tout fichier image (activé par défaut).
demander avant de supprimer l’historique: Toujours demander à l’utilisateur avant de supprimer l’historique d’une image (activé par défaut).
essayer d’utiliser la poubelle lors de l’effacement des images: Au lieu de supprimer physiquement les images du disque, essayer de les placer dans la corbeille du système (activé par défaut).
ask before moving images from film roll folder: Always ask before moving an image file (default on).
demander avant de copier des images vers un nouveau dossier: Toujours demander à l’utilisateur avant de copier un fichier image (activé par défaut).
ask before removing empty folders: Always ask before removing any empty folder. This can happen after moving or deleting images (default off).
demander avant de supprimer un mot-clé: Toujours demander à l’utilisateur avant de supprimer un mot-clé d’une image (activé par défaut).
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.

activer OpenCL dans 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.

configurer 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 :

problèmes possibles et 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 ne fonctionne toujours pas pour moi

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.

stockage

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

base de données

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

divers

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).
trier les préréglages internes en premier: Choisir comment le menu des préréglages est trié. Si cette option est activée, les préréglages internes sont montrés en premier. Si cette option est désactivée, les préréglages de l’utilisateur sont montrés en premier (activée par défaut).
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.

mots clés

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.

raccourcis avec instances multiples

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.

raccourcis

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

préréglages

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

options lua

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

intention de rendu

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.

possibles artefacts de couleur

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.

definitions

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.

Automatisation avec Lua

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

Ansel est livré avec un langage d’interface de script polyvalent pour améliorer ses fonctionnalités.

Les scripts Lua peuvent être utilisés pour définir les actions à exécuter par Ansel lorsqu’un événement est déclenché. Un exemple pourrait être d’appeler une application externe lors de l’exportation de fichiers afin d’appliquer des étapes de traitement supplémentaires en dehors de Ansel.

Lua est un projet indépendant fondé en 1993, fournissant un langage de script puissant, rapide, léger et intégrable. Lua est largement utilisé par de nombreuses applications open source, dans des programmes commerciaux et pour la programmation de jeux.

Principes de base : fichiers luarc

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

Au démarrage, Ansel lance automatiquement le scripts Lua $Ansel/share/Ansel/luarcet $HOME/.config/Ansel/luarc (où $Anselreprésente le dossier d’installation de Ansel et $HOME votre dossier utilisateur).

C’est la seule fois que Ansel lance des scripts Lua de lui même. Ces scripts peuvent enregistrer des rappels pour réaliser des actions sur divers évènements de Ansel. Ce mécanisme de rappel est la principale méthode de déclenchement d’actions Lua.

Un exemple Lua simple

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

Commençons par un exemple simple qui affiche un message sur la console. Créez un fichier appelé luarc dans le répertoire de configuration de Ansel (généralement $HOME/.config/Ansel/) et ajoutez-y la ligne suivante :

1print("Hello World !")

Lancez Ansel et vous verrez la phrase « Hello World ! » s’afficher sur la console. Rien d’extraordinaire, mais c’est un début.

À ce stade, il n’y a rien de spécifique à Ansel dans le script. Nous utilisons simplement la fonction d’affichage standard de Lua, permettant d’afficher une chaîne de caractère. C’est bien beau, mais nous pouvons faire mieux. Ainsi pour accéder à l’API Ansel, vous devez d’abord la demander (require) et enregistrer le résultat dans une variable. Depuis cette variable, vous pouvez accéder à toute l’API Ansel en appelant des sous-champs. Tout est documenté dans le manuel de l’ API Lua

printing labeled images

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

Le premier exemple nous a montré les bases mêmes de Lua et nous a permis de vérifier que tout fonctionnait correctement. Faisons maintenant quelque chose d’un peu plus complexe. Essayons d’imprimer la liste des images auxquelles est attachée l’étiquette « rouge ». Mais avant tout, qu’est-ce qu’une image ?

1local Ansel = require "Ansel"
2local debug = require "Ansel.debug"
3print(Ansel.debug.dump(Ansel.database[1]))

L’exécution du code ci-dessus produit beaucoup de données. Nous l’examinerons dans un instant, mais regardons d’abord le code lui-même.

ajouter un raccourci simple

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

Jusqu’à présent, tous nos scripts ont fait des choses au démarrage. Ceci est d’une utilité limitée et ne nous permet pas d’interagir avec l’utilisateur. Pour faire des choses plus avancées, nous devons enregistrer une fonction qui est appelée sur un événement donné. L’événement le plus courant auquel réagir est un raccourci clavier.

1Ansel = require "Ansel"
2
3local function hello_shortcut(event, shortcut)
4Ansel.print("Hello, I just received '"..event..
5 "' with parameter '"..shortcut.."'")
6end
7
8Ansel.register_event("shortcut",hello_shortcut,
9 "A shortcut that prints its parameters")

Maintenant, démarrez Ansel, allez dans « préférences > raccourcis > Lua > A shortcut that prints its parameters » (Un raccourci qui imprime ses paramètres), attribuez un raccourci et essayez-le. Vous devriez voir un joli message imprimé à l’écran.

exporting images with lua

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

Jusqu’à présent, nous avons appris à utiliser Lua pour adapter Ansel à notre flux de travail particulier. Voyons maintenant comment utiliser Lua pour exporter facilement des images vers un service en ligne. Si vous êtes capable de télécharger une image vers un service via la ligne de commande, vous pouvez utiliser Lua pour intégrer cela dans l’interface utilisateur de Ansel.

Dans l’exemple suivant, nous utilisons Lua pour exporter via scp. Un nouveau type de stockage apparaît dans l’interface utilisateur de Ansel qui exporte les images vers une cible distante via le mécanisme de copie de ssh.

Constructions d'éléments de l'interface utilisateur

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

Notre exemple précédent était un peu limité. En particulier, l’utilisation d’une préférence pour le chemin d’exportation n’est pas très élégante. Nous pouvons faire mieux en ajoutant des éléments à l’interface utilisateur dans la boîte de dialogue d’exportation.

Les éléments de l’interface utilisateur sont créés via la fonction Ansel_new_widget. Cette fonction prend un paramètre type de widget et renvoie un nouvel objet pour ce widget. Vous pouvez ensuite définir divers champs dans ce widget pour définir ses paramètres. Vous utilisez ensuite cet objet comme paramètre de fonctions qui l’ajoutent à l’interface utilisateur de Ansel. L’exemple simple suivant ajoute un module dans la vue table lumineuse avec une étiquette simple :

sharing scripts

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

Jusqu’à présent, tout notre code Lua était dans luarc. C’est un bon moyen de développer votre script mais pas très pratique pour la distribution. Nous devons en faire un module Lua dédié. Pour ce faire, nous sauvegardons le code dans un fichier séparé (ici scp-storage.lua) :

 1--[[
 2SCP STORAGE
 3a simple storage to export images via scp
 4
 5AUTHOR
 6Jérémy Rosen (jeremy.rosen@enst-bretagne.fr)
 7
 8INSTALLATION
 9* copy this file in $CONFIGDIR/lua/ where CONFIGDIR
10is your Ansel configuration directory
11* add the following line in the file $CONFIGDIR/luarc
12 require "scp-storage"
13
14USAGE
15* select "Export via SCP" in the storage selection menu
16* set the target directory
17* export your images
18
19LICENSE
20GPLv2
21
22]]
23Ansel = require "Ansel"
24Ansel.configuration.check_version(...,{2,0,0})
25
26local scp_path = Ansel.new_widget("entry"){
27 tooltip ="Complete path to copy to. Can include user and hostname",
28 text = "",
29 reset_callback = function(self) self.text = "" end
30}
31
32Ansel.register_storage("scp_export","Export via scp",
33 function( storage, image, format, filename,
34 number, total, high_quality, extra_data)
35 if coroutine.yield("RUN_COMMAND","scp "..filename.." "..
36 scp_path.text
37 ) then
38 Ansel.print_error("scp failed for "..tostring(image))
39 end
40 end,
41 nil, --finalize
42 nil, --supported
43 nil, --initialize
44 Ansel.new_widget("box") {
45 orientation ="horizontal",
46 Ansel.new_widget("label"){label = "target SCP PATH "},
47 scp_path,
48})

Ansel recherche les scripts *.lua (en suivant les règles Lua normales) dans le répertoire $CONFIGDIR/lua. Ainsi, notre script peut être appelé en ajoutant simplement require « scp-storage » dans le fichier luarc. Quelques notes supplémentaires…

appeler Lua de dbus

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

Il est possible d’envoyer une commande Lua à Ansel via son interface DBus. La méthode org.Ansel.service.Remote.Lua prend une seule chaîne de paramètre qui est interprétée comme une commande Lua. La commande est exécutée dans le contexte Lua en cours et doit retourner un nul ou une chaîne de caractères. Le résultat est retourné comme résultat de la méthode DBus.

If the Lua call results in an error, the DBus method call will return an error org.Ansel.Error.LuaError with the lua error message as the message attached to the DBus error.

utiliser Ansel depuis un script Lua

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

Attention : Cette fonctionnalité est très expérimentale. Il est connu que plusieurs éléments ne fonctionnent pas encore en mode bibliothèque. Des tests prudents sont hautement recommandés.

L’interface Lua vous permet d’utiliser Ansel à partir de n’importe quel script Lua. Cela charge Ansel en tant que bibliothèque et vous fournit une grande part de l’API Lua (comme Ansel est configuré sans interface utilisateur les fonctions correspondantes ne sont pas disponibles).

Par exemple, le programme suivant écrit la liste de toutes les images dans votre bibliothèque.

API Lua

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

Ansel’s Lua API is documented in its own manual with a detailed description of all data structures and functions. You can download the API manual from here .