Toolboxes on Ansel

Transitioning from darktable to Ansel

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

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

What changed in Ansel since 2023

Performance and reliability

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

Install

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

Dependencies for Source Builds

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

Understanding Ansel’s releases

Ansel channels

Ansel development and release path follows 3 channels :

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

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

Install on Linux

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

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

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

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

Import images

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

Basics

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

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

Editing images

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

Understanding non-destructive editing

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

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

Library and collections

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

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

Warning

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

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

Ansel separates its functionality into several views, each dedicated to one task:

Lighttable: Manage, sort, cull and tag your image collection. This is the default view, loaded at startup, and you can return to it from anywhere by pressing Escape.
Darkroom: Develop a single image. Open it from the lighttable by double-clicking a thumbnail, or by selecting a picture and pressing Enter.
Map: Show geo-tagged images on a map and geo-tag new images manually. Hidden by default; enable it in the preferences.
Print: Send images to a printer. Hidden by default; enable it in the preferences. Not available on Windows, as it relies on CUPS .
Studio Capture: Dedicated view for tethered shooting sessions.
Slideshow: Display images full-screen as a slideshow, processing them on the fly. Hidden by default; enable it in the preferences.

You switch views from the Ateliers menu in the top menu bar, which lists every available view and the shortcut to reach it (the current view is greyed out). The darkroom is the exception: because it needs an image to open, you enter it from a lighttable or filmstrip thumbnail, not from the menu.

Global menu

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

The global menu bar sits at the top-left of the header and is available in every view. It gathers the application-wide commands, image operations, history and style management, maintenance tasks, display settings, view switching and help. It is the central reference point of the interface: most commands that are not a per-module setting live here.

Note

Coming from Darktable: many commands that were previously buried inside side-panel modules, cryptic icon buttons or undocumented keyboard shortcuts have been collected into this menu. “Modules” that were really just grids of buttons (image actions, view toolbox, selection helpers…) became menu entries.

Using the menu

Click a menu title to open it, or press Alt to reveal the underlined mnemonic letters and press one to open the matching menu. Once a menu is open, navigate all menus with the arrow keys and trigger an entry with Enter.
Entries that have a default keyboard shortcut show it on their right. All these shortcuts are defaults that you can change from Edit → Keyboard shortcuts… (see shortcuts and keyboard interaction).
Many entries act on the active images — that is, the images currently selected in the lighttable or filmstrip. When nothing is selected, those entries are greyed out.

The menus are described below in their bar order.

Bibliotheek

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.

Undo/redo

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

Most changes made within the lighttable are recorded and can be reverted to a previous state. This includes modifications to color labels, ratings, geo-localization, tags, metadata, orientation, copy/paste of history, image duplication, or application of a style. The undo/redo facility is unlimited in the number of steps while in the lighttable, but it is reset each time you switch to a different view.

Press Ctrl+Z to undo the last modification and Ctrl+Y to redo the last undone one (if any). These are also available from the global menu, under Edit 🡒 Undo / Redo.

Copy and paste history

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

Transfer the editing recipe from one image to one or many others. The result is a merge of the source history into each destination image — not a blind overwrite — which means you have fine-grained control over how conflicts between the two histories are resolved.

Copy-paste is available from the Edit menu in any view, and the keyboard shortcuts work in both the lighttable and the darkroom.

Warning

Digital asset management

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

Beyond editing pixels, Ansel keeps track of your images and the work you do on them. This is digital asset management (DAM): organizing, describing, rating, grouping and safeguarding your collection so it stays searchable and recoverable over time.

The pages in this section cover how that information is stored and used:

Sidecar files — how edits and metadata are saved alongside your originals as XMP files, and importing sidecars from other software.
Star ratings & color labels — ranking and classifying images for culling.
Metadata and tagging — descriptive text and keywords.
Image grouping — stacking related images together.
Local copies — working off-site and re-synchronizing later.
Thumbnails — how previews are generated and cached.

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.

Importing sidecar files generated by other 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

Veel gebruikers hebben enorme beeldcollecties opgeslagen op extra harde schijven in hun desktopcomputer, of op een extern opslagmedium (RAID NAS, externe harde schijven 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.

Thumbnails

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

Er wordt een miniatuur gemaakt wanneer een afbeelding voor de eerste keer in Ansel wordt geïmporteerd, nadat een afbeelding in ontwikkelen is gewijzigd of wanneer een afbeelding opnieuw wordt bekeken waarvan de miniatuur niet langer beschikbaar is.

Star ratings & color labels

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

Met sterbeoordelingen en kleurlabels kan je afbeeldingen sorteren en rangschikken volgens jouw eigen criteria. De sterclassificatie en kleurlabels van een afbeelding kunnen worden weergegeven over miniaturen in de bibliotheekweergave en filmstripmodule.

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

Het groeperen van afbeeldingen helpt bij het verbeteren van de structuur en helderheid van jouw beeldverzameling wanneer deze wordt weergegeven in de bibliotheekweergave.

You can combine images into a group by selecting them and using the global menu Image 🡒 Group images (Ctrl+G). Likewise, remove selected images from a group with Image 🡒 Ungroup images (Ctrl+Shift+G).

Gedupliceerde afbeeldingen worden automatisch gegroepeerd. Evenzo, als u meerdere afbeeldingen uit dezelfde map importeert, met dezelfde basisnaam, maar met verschillende extensies (bijv. IMG_1234.CR2 en IMG_1234.JPG), vormen die afbeeldingen automatisch een groep.

Metadata and tagging

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

Met Ansel kan je aanvullende informatie over jouw afbeeldingen opslaan, zodat ze gemakkelijker kunnen worden doorzocht en gegroepeerd. Deze informatie wordt opgeslagen in de database van Ansel en XMP sidecar-bestanden en kan ook worden opgenomen in geëxporteerde afbeeldingen.

Metadata

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.

Tagging

Tags are usually shared between multiple images and are used to categorise and group them. You can add tags to images in the tagging module.

Ontwikkelen

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

The darkroom view is where you develop a single image. The center area shows the picture currently being edited; the left panel holds peripheral tools (navigation, scopes, snapshots, history…), and the right panel holds the image-processing modules.

Open the darkroom from the lighttable by double-clicking a thumbnail, or by selecting an image and pressing Enter. Return to the lighttable with Escape (or the home button in the header). You can switch to another image without leaving the darkroom by enabling the filmstrip (Ctrl+Shift+F) and clicking a thumbnail in it.

Darkroom view layout

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

The darkroom surrounds the center image with a left panel of peripheral tools, a right panel of image-processing modules, and a bottom toolbar of visual-assessment overlays. An optional filmstrip (Ctrl+Shift+F) can be shown along the bottom for quick navigation through the current collection.

Left panel

Shown and hidden with Ctrl+Shift+L. It holds the peripheral tools that support editing (but do not themselves process pixels):

Navigation: Navigate and zoom the center view via a thumbnail overview. Sits at the top of the panel.
Scopes: A graphical depiction of the image’s tones and colors (histogram, waveform, vectorscope…). The global color picker, used to sample colors from the image, is part of this module.
Snapshots: Take and compare snapshots against the current edit.
Duplicate manager: View and manage the duplicates (versions) of the current image.
Mask manager: View and edit the drawn shapes used by masks.
History of changes: The editing history of the current image, where you can step back to any previous state, compress or reset the history.
Image information: Display EXIF and IPTC information about the current image.
Notes: Free-text notes attached to the image.

Note

The pixelpipe

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

The pixelpipe is the ordered sequence of processing modules that turns your original RAW file into the image you see and export. Each module takes the output of the previous one as its input, applies one operation, and hands its result to the next module — exactly like a stack of adjustment layers, applied from the bottom up.

flowchart LR
RAW([RAW file]) --> M1[module 1] --> M2[module 2] --> M3[module n] --> OUT([output image])

Nothing is ever written back to your original file: the pixelpipe is re-run on demand from the RAW plus your history stack, both for the on-screen preview and for the final export.

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.

The pixelpipe & module order

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

De volgorde van de pixelpipe wordt grafisch weergegeven door de volgorde waarin modules worden gepresenteerd in de gebruikersinterface - de pixelpijp begint met een RAW-afbeelding onderaan de modulelijst en past de verwerkingsmodules één voor één toe, laag op verwerkingslaag van onder naar boven, totdat het de top van de lijst bereikt, waar het de volledig verwerkte afbeelding uitvoert.

The history stack

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

De geschiedenis slaat de volledige bewerkingsgeschiedenis voor een bepaalde afbeelding op in de volgorde waarin die bewerkingen zijn toegepast. Het wordt opgeslagen in de bibliotheek database van Ansel en het XMP sidecar-bestand van de afbeelding en blijft bestaan tussen bewerkingssessies.

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

The history stack can be queried and modified within the history stack module in the darkroom.

Undo and redo

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

Terwijl je jouw afbeelding bewerkt, registreert Ansel alle wijzigingen die je aan die afbeelding aanbrengt. Dit betekent dat het mogelijk is om wijzigingen ongedaan te maken en opnieuw uit te voeren om een eerdere bewerkingsstatus te herstellen. Houd er rekening mee dat de functie voor ongedaan maken/opnieuw uitvoeren onbeperkt is in het aantal stappen tijdens het bewerken van een afbeelding, maar wordt iedere keer gereset als ontwikkelen overschakelt naar een nieuwe afbeelding.

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.

De uitgangsgegevens van een module kunnen optioneel opnieuw worden verwerkt (gecombineerd) met de invoergegevens voordat ze aan de volgende module worden overgedragen. Deze extra verwerkingsstap heet overvloei – invoer- en uitvoergegevens worden opnieuw verwerkt met behulp van algoritmen die overvloei-operators of overvloei modus worden genoemd.

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.

Klassieke overvloei modus, ontworpen voor scherm-gerefereerde RGB (beperkt tot 0-100%), definiëren impliciet een steunpunt op 50% (grijs) of 100% (wit) in hun algoritmen, afhankelijk van de overvloei-modus. Omdat de scene-gerefereerd niet onderhevig is aan deze beperkingen, moet dit steunpunt expliciet worden gedefinieerd door de gebruiker bij het uitvoeren van overvloei-bewerkingen in de “RGB (scène)"-kleurruimte. De extra parameter overvloei-steunpunt zal aan de gebruiker worden getoond bij gebruik van een van deze overvloei-modus in deze kleurruimte. Het effect is afhankelijk van de gebruikte operator. Waarden boven het steunpunt kunnen bijvoorbeeld lichter worden gemaakt en waarden eronder donkerder, of omgekeerd.

Masks

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.

Een masker kan gezien worden als een grijstoonafbeelding waarvan elke pixel een waarde heeft tussen 0 en 1.0 (of tussen 0% en 100%). Deze waarde is de dekking en wordt gebruikt om het effect van de module op elke pixel te bepalen.

De volgende secties beschrijven hoe maskers in Ansel worden opgebouwd.

Drawn masks

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

Met de functie voor getekend masker kunt u een masker maken door vormen rechtstreeks op het afbeeldingsdoek te tekenen. Vormen kunnen alleen of in combinatie worden gebruikt. Zodra een vorm op een afbeelding is getekend, kan deze worden aangepast, verwijderd of opnieuw worden gebruikt in andere 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

De parametrische maskerfunctie biedt fijnmazige selectieve controle over hoe individuele pixels worden gemaskeerd. Het doet dit door automatisch een tussenliggend overvloeimasker te genereren op basis van door de gebruiker gedefinieerde parameters. Deze parameters zijn kleurcoördinaten in plaats van de geometrische coördinaten die in getekende maskers worden gebruikt.

Voor elk datakanaal van een module (bijv. Lab, RGB) en meerdere virtuele datakanalen (bijv. tint, verzadiging) kunt u een per kanaal opaciteitsfunctie opbouwen. Afhankelijk van de waarde van elke pixel voor een bepaald datakanaal berekent deze functie een mengfactor tussen 0 en 1 (100%) voor die pixel.

Combining drawn & parametric masks

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

Getekende- en parametrische- maskers kunnen gecombineerd worden tot één masker om in een module te gebruiken.

Er zijn twee hoofdelementen om de combinatie van individuele maskers aan te passen : de polariteit instelling van elk individueel masker (gedefinieerd door de plus- of min-knoppen) en de instelling in de “combineer maskers” in de keuzemenu.

De keuzemenu “combineer maskers” bevat de volgende keuzes, definieer hoe de getekende- en parametrische- maskers zullen worden gecombineerd:

Mask contours

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

Als een masker actief is verschijnen er verschillende schuifregelaars om de instellingen te verfijnen.

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

Note

Raster masks

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

Zoals in de vorige secties beschreven is het samengesteld masker van een modulemasker (het samengesteld effect van een elk vectormasker en parametrisch masker) een grijswaardebeeld waarvan de grijswaarde de sterkte van het module-effect op elke pixel weergeeft. Dit grijswaardebeeld wordt voor actieve modules intern opgeslagen en kan opnieuw gebruikt worden in andere modules.

Zoals met elk masker wordt de input van een module door de module niet gewijzigd als de dekking de waarde 0 heeft. Als de dekking 1.0 is zal de module haar volledig effect hebben. Voor elke waarde tussen 0 en 1.0 zal het effect voor deze pixels proportioneel zijn.

Processing modules

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

Split-toning

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

Blend two CAT16 plus RGB mixer corrections across brightness keyframes.

The split-toning module applies two independent color transforms:

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

Each keyframe combines:

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

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

Color primaries

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

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

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

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

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

Color equalizer

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

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

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

The user interface is meant to stay perceptually even:

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

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

Photographic grain

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

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

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

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

Drawing

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

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

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

The intended use cases are:

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

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

Final resampling

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

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

Action

When exporting images to save them to a file, the picture is processed at full resolution and then rescaled to the specified output size by this module.

Final resampling is never used when producing previews, for the lighttable thumbnails or in the darkroom, because in this case images are resampled earlier in the pipeline, for better rendering speed. It has no effect if the image is exported at its full (original) resolution either.

Astrophoto denoise

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

Remove image noise while preserving structure.

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

Omdat het verwijderen van ruis een proces is dat veel resources nodig heeft, vertraagt het de verwerking van pixelpijpe aanzienlijk. Overweeg deze module laat in uw workflow te activeren.

Blurs

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

Simuleer fysiek nauwkeurige vervaging in scene-gerefereerd RGB-ruimte.

Blur types

Er zijn drie soorten vervaging beschikbaar:

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

Een diagram bovenaan de module toont de vorm van de vervagingsoperator (bekend als de puntspreidingsfunctie ). De module verandert elk lichtpunt van de scène in een vlek in de vorm van de weergegeven vervagingsoperator, met de grootte van de vlek gedefinieerd door de vervagingsstraal.

Censorize

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

Degradeer delen van het beeld op een esthetisch aangename manier, om mensen/objecten te anonimiseren of lichaamsdelen te verbergen.

Censuur werkt in lineaire RGB-kleurruimte om een fysiek nauwkeurige Gaussiaanse vervaging en Gaussiaanse luminantieruis toe te passen.

Naast anonimisering kan deze module ook voor een breed scala aan creatieve doeleinden worden gebruikt, bijvoorbeeld:

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.

Opmerking: De anonimiseringsmethoden die door deze module worden geboden, zijn niet forensisch veilig om de esthetiek te bevorderen. Sommige forensische technieken kunnen de gecensureerde inhoud mogelijk nog steeds reconstrueren op basis van de structuur, vooral voor eenvoudige vormen en tekst (bijvoorbeeld kentekenplaten, huisnummers).

Chromatic aberrations

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

Corrigeer chromatische aberraties.

In tegenstelling tot de raw chromatische aberraties module, vereist deze module geen ruwe data als invoer.

Workflow

Voor het beste resultaat wordt je geadviseerd als volgt te werk te gaan:

Demp de chromatische aberraties zoveel mogelijk in de lens correctie module met behulp van de TCA-schuifregelaars.
Verhoog de krachtschuifregelaar in deze module om het effect beter te zien.
Vergroot de radius totdat de chromatische aberraties verdwijnen. Als dit onvoldoende is, probeer dan de instelling “zeer grote chromatische aberraties” in te schakelen.
Kies de hulp die het beste resultaat geeft qua scherpte en artefacten.
Verminder de sterkte om te voorkomen dat de kleuren te veel worden uitgewassen.

Voor meer gecompliceerde gevallen kan je ook het volgende proberen:

Color balance

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

Een geavanceerde module die tools voor kleurcorrectie uit de cinematografie in de pijplijn voor fotografisch scene-gerefereerd brengt.

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

Kleurcorrectie is een belangrijk onderdeel van beeldbewerking. Het kan helpen om ongewenste kleurzweem te verwijderen en kan ook een creatieve kleurdraai geven die sfeer aan uw afbeeldingen toevoegt. In de tijd van filmfotografie werd de meeste kleurambiance verkregen met de filmemulsie en de zich ontwikkelende chemicaliën, waarbij enige kleurtiming werd uitgevoerd onder de vergroter met kleurkoppen. Dit vergde dure middelen en was grotendeels voorbehouden aan de bioscoopindustrie, waar de klus werd uitgevoerd door een colorist.

Color calibration

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

Een volledig uitgeruste kleurruimtecorrectie, witbalansaanpassing en kanaalmixer module.

Deze eenvoudige maar krachtige module kan op de volgende manieren worden gebruikt:

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 look up table

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

A generic color look up table implemented in Lab space.

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

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).; klik op een patch om deze te selecteren, of gebruik de keuzelijst met invoervak of de kleurenkiezer. De momenteel geselecteerde patch is gemarkeerd met een wit vierkant en het nummer wordt weergegeven in de keuzelijst hieronder.

Color reconstruction

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

Herstel kleurinformatie in uitgewassen hooglichten

Vanwege de aard van digitale sensoren missen overbelichte hooglichten geldige kleurinformatie. Meestal lijken ze neutraal wit of vertonen ze enige kleurzweem, afhankelijk van de andere beeldverwerkingsstappen. Deze module kan worden gebruikt om overbelichte hooglichten te “genezen” door hun kleuren te vervangen door beter passende. De module werkt op pixels waarvan de luminantie een door de gebruiker gedefinieerde drempel overschrijdt. Vervangende kleuren worden overgenomen van aangrenzende pixels. Bij de kleurselectie wordt zowel rekening gehouden met de ruimtelijke afstand als met de luminantie afstand (bereik).

Color zones

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

Pas selectief de helderheid, verzadiging en tint van pixels aan op basis van hun huidige helderheid, verzadiging en tint.

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.

Je moet eerst kiezen of je pixels wilt aanpassen (selecteren) op basis van hun helderheid, verzadiging of tint. Je kan vervolgens drie curven gebruiken, op hun respectieve tabbladen, om de helderheid, verzadiging en tint aan te passen van de bereiken van pixels die via deze methode zijn geselecteerd.

Contrast equalizer

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

Pas de helderheid en het chroma-contrast aan in het wavelet-domein.

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.

Er zijn een aantal voorinstellingen die jou moeten helpen de mogelijkheden van de module te begrijpen.

Crop

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

Crop an image using on-screen guides.

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

Telkens wanneer deze module in beeld is, wordt de volledige niet-uitgesneden afbeelding weergegeven, bedekt met uitsneegrepen en optionele hulplijnen.

Curve

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

Een klassiek hulpmiddel voor digitale fotografie om de tonen van een afbeelding te wijzigen met behulp van curves.

Activeer de kleurenkiezer aan de linkerkant om de gekozen waarden in de grafiek weer te geven (Ctrl+klik of klik met de rechtermuisknop om de kiezer in de gebiedsmodus te gebruiken). Numerieke (Lab) waarden van de invoer en uitvoer (zie hieronder) op de geselecteerde plek of gebied worden linksboven in de widget weergegeven.

Demosaic

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

Bepaal hoe onbewerkte bestanden worden gedemosaïekt.

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

Een gebruiksvriendelijke en zeer efficiënte ruisonderdrukkingsmodule, aangepast aan de individuele ruisprofielen van een breed scala aan camerasensoren.

Een probleem met veel ruisonderdrukkingsalgoritmen is dat ze aannemen dat de variantie van de ruis onafhankelijk is van de helderheid van het signaal. Door de ruiskarakteristieken van de sensor van een camera bij verschillende ISO-instellingen te profileren, kan de variantie bij verschillende lichtsterkten worden beoordeeld en kan het ruisonderdrukkingsalgoritme worden aangepast om de ruis gelijkmatiger af te vlakken.

Diffuse or sharpen

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

Diffusie is een familie van fysieke processen waarbij deeltjes bewegen en zich geleidelijk met de tijd verspreiden, vanuit een bron die ze genereert. Bij beeldverwerking vindt diffusie meestal op twee plaatsen plaats:

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

In beide gevallen maakt diffusie het beeld minder scherp door deeltjes te “lekken” en lokale variaties glad te strijken.

Dithering

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

Deze module elimineert enkele van de bandvormige-artefacten die kunnen ontstaan wanneer de interne 32-bits drijvende-kommagegevens van Ansel worden overgebracht naar een discreet 8-bits of 16-bits integer-uitvoerformaat voor weergave of export.

Although not an inherent problem in any of Ansel’s modules, some operations may provoke banding if they produce a lightness gradient in the image. To mitigate possible artifacts you should consider activating dithering when using the vignetting or graduated density modules. 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.

Exposure

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

Verhoog of verlaag de algehele helderheid van een afbeelding.

Deze module heeft twee werkingsmodi:

handmatig: Stel de belichting, zwartniveau en knipdrempel handmatig in
automatisch (alleen RAW-afbeeldingen): gebruik een analyse van het histogram van de afbeelding om de belichting automatisch in te stellen. Ansel selecteert automatisch de belichtingscompensatie die nodig is om het geselecteerde percentiel naar het geselecteerde doelniveau te verschuiven (zie onderstaande definities). Deze modus is met name handig voor het automatisch wijzigen van een groot aantal afbeeldingen om dezelfde belichting te krijgen. Een typisch gebruiksvoorbeeld van de automatische modus is het flikkeren van time-lapse-foto’s.

Module controls

modus: Kies de werkingsmodus (automatisch/handmatig).
camerabelichting compenseren (handmatige modus): Automatisch de belichtingsbias van de camera verwijderen (overgenomen uit de Exif-gegevens van de afbeelding).
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.
clipping drempel (handmatige modus): Bepaal welk percentage van de heldere waarden moet worden afgekapt bij de berekening van de belichting en zwartniveau correctie. Gebruik de kleurkiezer om een deel van de afbeelding te samplen dat voor deze berekening moet worden gebruikt.
percentiel (automatische modus): Definieer een locatie in het histogram om te gebruiken voor automatische belichtingscorrectie. Een percentiel van 50% geeft een positie in het histogram aan waar 50% van de pixelwaarden boven en 50% van de pixelwaarden onder die belichting ligt.
doelniveau (automatische modus): Definieer het doelniveau voor automatische belichtingscorrectie (EV) ten opzichte van het witpunt van de camera.
zwartniveaucorrectie (handmatige en automatische modi): Pas het zwartniveaupunt aan om negatieve RGB-waarden los te maken.

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

Filmic

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

Breng het toonbereik van een afbeelding opnieuw in kaart door de toon- en kleurrespons van klassieke film te reproduceren.

Deze module kan worden gebruikt om het dynamische bereik van de scène uit te breiden of te verkleinen, zodat het past bij het dynamische bereik van het scherm. Het beschermt kleuren en contrast in de middentonen, herstelt de schaduwen en comprimeert heldere hooglichten en donkere schaduwen. Hooglichten hebben extra aandacht nodig wanneer details behouden moeten blijven (bijv. wolken).

Framing

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

Generate a frame around the image.

Het kader bestaat uit een rand (met een door de gebruiker gedefinieerde kleur) en een kaderlijn binnen die rand (met een tweede door de gebruiker gedefinieerde kleur). Er zijn verschillende opties beschikbaar om de geometrie en kleur van het kader te regelen.

Module controls

randdikte: De grootte van het kader als percentage van het onderliggende volledige beeld.
verhouding: De beeldverhouding van de uiteindelijke module-uitvoer (d.w.z. de onderliggende afbeelding plus het kader)
oriëntatie: De oriëntatie van het kader (portret/landschap). Selecteer ‘auto’ voor Ansel om de meest redelijke oriëntatie te kiezen op basis van de onderliggende afbeelding.
horizontale/verticale positie: Kies uit een reeks vooraf gedefinieerde verhoudingen om te bepalen waar de onderliggende afbeelding op de horizontale/verticale as wordt geplaatst. Je kan ook met de rechtermuisknop klikken en jouw eigen verhouding invoeren als “x/y”.
frameafmeting: Het percentage van de framelijngrootte ten opzichte van de randgrootte op het kleinste deel.
afstand van het frame: De positie van de kaderlijn ten opzichte van de onderliggende afbeelding. Kies 0% voor een kaderlijn die de afbeelding raakt. Kies 100% voor een kaderlijn die de buitenrand raakt.
randkleur / framekleur: Een paar kleurkiezers waarmee de rand- en kaderlijnkleuren kunnen worden gedefinieerd. Als je op het gekleurde veld klikt, wordt een dialoogvenster voor kleurselectie geopend met een keuze uit veelgebruikte kleuren, of kan je een kleur definiëren in de RGB-kleurruimte. Je kan ook een kleurenkiezer activeren om een kleurensonde uit de afbeelding te halen.
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.

Graduated density

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

Simuleer een filter met grijsverloop om de belichting en kleur op een progressieve manier te corrigeren.

Op het scherm wordt een lijn weergegeven waarmee de positie en rotatie van het verloop met de muis kan worden gewijzigd.

Het is bekend dat deze module onder bepaalde omstandigheden bandvormige-artefacten veroorzaakt. Overweeg om de module dithering te activeren om deze problemen te verhelpen.

Module controls

dichtheid: Stel de dichtheid van het filter (EV) in. Een lage waarde onderbelicht enigszins, terwijl een hoge waarde een sterk filter creëert.
hardheid: De progressiviteit van het verloop. Een lage waarde zorgt voor een vloeiende overgang, terwijl een hoge waarde de overgang abrupter maakt.
rotatie: De rotatie van het filter. Negatieve waarden draaien met de klok mee. De rotatie kan ook worden ingesteld door het einde van de verlooplijn met de muis te slepen.
tint: kies een tint om een kleurzweem aan het verloop toe te voegen.
verzadiging: De verzadiging van de kleurzweem die moet worden toegevoegd aan het verloop (standaard is een neutrale kleurzweem van 0)

Grain

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

Simuleer de korrel van analoge film. De korrel wordt verwerkt op het L-kanaal van de Lab-kleurruimte.

Module controls

ruwheid: De korrelgrootte, geschaald om een ISO-nummer te simuleren.
kracht: De sterkte van het effect.

Haze removal

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

Verminder automatisch het effect van stof en nevel in de atmosfeer. Deze module kan ook meer in het algemeen worden gebruikt om afbeeldingen een kleurversterking te geven, met name in contrastarme delen van het beeld.

Nevel absorbeert licht van objecten in de scène, maar is ook een bron van diffuus achtergrondlicht. De module voor het verwijderen van nevel maakt eerst voor elk beeldgebied een schatting van de hoeveelheid waas in de scène. Het verwijdert vervolgens het diffuse achtergrondlicht volgens zijn lokale sterkte en herstelt het oorspronkelijke objectlicht.

Highlight reconstruction

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

Poging om kleurinformatie te reconstrueren voor pixels die zijn bijgesneden in een of meer RGB-kanalen.

Als deze pixels gedeeltelijk worden afgekapt, kan dit ertoe leiden dat er onrealistische kleuren in de afbeelding verschijnen. Pixels met zowel groene als blauwe kanalen die zijn afgekapt, zullen bijvoorbeeld rood lijken zonder enige reconstructie van hoogtepunten.

Er zijn drie reconstructiemethoden beschikbaar:

comprimeer hooglichten: Klem alle pixels vast op het witniveau (d.w.z. knip de resterende kleurkanalen af). Deze methode is vooral handig in gevallen waarin uitgeknipte hooglichten voorkomen in natuurlijk onverzadigde objecten (bijv. wolken).
reconstrueren in LCh: Analyseer elke pixel met ten minste één geknipt kanaal en probeer de geknipte pixel (in LCh-kleurruimte) te corrigeren met behulp van de waarden van de andere (3 voor Bayer of 8 voor X-Trans) pixels in het betreffende sensorblok. De gereconstrueerde hooglichten zullen nog steeds monochroom zijn, maar helderder en met meer detail dan bij “kniphoogtepunten”. Deze methode werkt redelijk goed met een basiscurve met hoog contrast, waardoor hooglichten onverzadigd worden. Net als bij hooglichten knippen is deze methode een goede optie voor natuurlijk onverzadigde objecten.
reconstrueer kleur: Gebruik een algoritme dat kleurinformatie van niet-uitgeknipte omgevingen overdraagt naar de uitgeknipte hooglichten. Deze methode werkt erg goed op gebieden met homogene kleuren en is vooral handig op huidtinten met vloeiend vervagende highlights. Houd er rekening mee dat deze methode doolhofachtige artefacten kan produceren op hooglichten achter randen met hoog contrast, bijvoorbeeld goed belichte fijne structuren voor een overbelichte achtergrond.
begeleide laplaciërs: Gebruik een algoritme (afgeleid van de module diffuus of verscherpen) om details van geldige kanalen naar afgekapte kanalen te repliceren en om kleurovergangen van geldige omringende regio’s naar afgekapte regio’s te verspreiden. Dit is een langzame en rekenintensieve methode die is ontworpen voor maximale gladheid en naadloze vermenging van de gereconstrueerde regio’s in hun omgeving, en is voornamelijk ontworpen om lichtpunten en spiegelende reflecties te reconstrueren. Deze modus is alleen beschikbaar voor Bayer-sensoren.

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

Hot pixels

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

Automatically detect and eliminate hot pixels.

Hotpixels zijn pixels die een lichtniveau niet correct hebben geregistreerd. Gedetecteerde hot pixels worden vervangen door een gemiddelde van hun buren.

Module controls

drempel: Hoe sterk de waarde van een pixel moet afwijken van die van zijn buren om als hot pixel te worden beschouwd.
kracht: De overvloeisterkte van de hot pixels met hun omgeving.
detecteren door 3 naaste: Verleng de detectie van hot pixels – beschouw een pixel als hot als er minimaal drie (in plaats van vier) aangrenzende pixels meer afwijken dan het drempelniveau.
markeer herstelde pixels: markeer visueel de gecorrigeerde pixels op de afbeelding en geef het aantal hotpixels weer die zijn hersteld.

Input color profile

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

Define how Ansel will interpret the colors of the image.

Deze module neemt de kleurruimte die wordt gebruikt door de beeldbron (bijv. camera, scanner) en converteert de pixelcoderingen naar een gestandaardiseerde werkkleurruimte. Dit betekent dat volgende modules in de pijplijn zich niet bezig hoeven te houden met de specifieke kenmerken van het invoerapparaat, en kunnen werken met en converteren naar/van een gemeenschappelijke werkkleurruimte.

Wanneer een afbeelding is vastgelegd in een onbewerkt bestand, past de invoerkleurprofielmodule normaal gesproken een standaard of verbeterde kleurenmatrix toe die specifiek is voor dat cameramodel, die zal worden gebruikt om de kleuren in kaart te brengen in de kleurruimte van het werkprofiel. Als kleurruimte-informatie is ingesloten in de afbeelding, zal de module ingaand kleurprofiel deze informatie gebruiken bij het toewijzen van de kleuren aan de werkprofiel-kleurruimte. De gebruiker kan ook expliciet een kleurruimte specificeren voor het binnenkomende beeld en kan zelfs een aangepast ICC-kleurprofiel aanleveren dat speciaal voor het invoerapparaat is gemaakt.

Lens correction

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

Automatisch corrigeren voor (en simuleren) lensvervorming, transversale chromatische aberraties (TCA) en lichtafval.

Deze module identificeert de camera/lens-combinatie uit de Exif-gegevens van de afbeelding en gebruikt de externe lensfun-bibliotheek om correctieparameters te leveren.

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.

Levels

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

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

De tool RGB-niveaus toont een histogram van de afbeelding en toont drie balken met handvatten. Versleep de hendels om de zwarte, middel-grijs en witte punten in helderheid te wijzigen (in de modus “RGB, gekoppelde kanalen”) of afzonderlijk voor elk van de R-, G- en B-kanalen (in de modus “RGB, onafhankelijke kanalen”).

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.

Liquify

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

Verplaats pixels rond door vrije stijl-vervormingen toe te passen op delen van de afbeelding met behulp van punten, lijnen en curven.

Nodes

Elk van de tools van vervloeien is gebaseerd op knooppunten. Een punt bestaat uit een enkele knoop en een lijn of curve bestaat uit een reeks gekoppelde knopen die een pad definiëren.

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.

Local contrast

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

Verbeter het lokale contrast van de afbeelding.

Dit wordt bereikt met behulp van een lokaal laplace (standaard) of niet-genormaliseerd bilateraal filter. Beide modi werken uitsluitend op het L-kanaal van Lab. Het lokaal laplace-filter is ontworpen om robuust te zijn tegen ongewenste halo-effecten en gradiëntomkeringen langs randen.

Module controls

modus: Keuze uit lokaal laplace filter of bilateraal raster. In de volgende secties worden de bedieningselementen beschreven die beschikbaar zijn voor elk van deze modi.

Bilateral grid

grofheid: Pas de grofheid van de aan te passen details aan.
contrast: Bepaal hoe sterk het algoritme onderscheid maakt tussen helderheidsniveaus. Verhoog deze parameter voor een meer contrastrijk uiterlijk.
detail: Details toevoegen of verwijderen. Hogere waarden verhogen het lokale contrast.

Local laplacian

Om de parameters van het lokale laplaciaanse filter te begrijpen, kan men het zien als het toepassen van een curve op de afbeelding, vergelijkbaar met de volgende grafiek:

Lut 3D

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

Transformeer RGB-waarden met een 3D LUT-bestand.

Een 3D LUT is een driedimensionale tabel die wordt gebruikt om een bepaalde RGB-waarde om te zetten in een andere RGB-waarde. Het wordt normaal gesproken gebruikt voor filmsimulatie en kleurcorrectie.

Deze module accepteert .cube, .3dl, .png (haldclut) en .gmz bestanden. Niet-gecomprimeerde 3D LUT-gegevens worden niet opgeslagen in de database of het XMP-bestand, maar worden in plaats daarvan opgeslagen in het 3D LUT-bestandspad in de 3D LUT-hoofdmap. Het is daarom belangrijk om een goede back-up van uw 3D LUT-map te maken – het delen van een afbeelding met zijn XMP is zinloos als de ontvanger niet hetzelfde 3D LUT-bestand in zijn eigen 3D LUT-map heeft.

Negadoctor

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

Process scanned film negatives.

Je kan een afbeelding van een negatief verkrijgen met behulp van een filmscanner, of door deze te fotograferen tegen een wit licht (bijvoorbeeld een lichttafel of computermonitor) of een externe flitser.

Preparation

Als de afbeelding van het negatief is verkregen met een digitale camera, moet je met de volgende punten rekening houden om nauwkeurige kleuren in de uiteindelijke afbeelding te krijgen:

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.

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.

De module is standaard ingeschakeld en de oriëntatie (rotatie) wordt automatisch ingesteld op basis van de Exif-gegevens van de afbeelding.

Module controls

transformeren: Dubbelklik op het label om de standaardtransformaties terug te zetten
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.

Output color profile

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

Beheer het uitvoerprofiel voor export en de weergave-intentie die moet worden gebruikt bij het toewijzen tussen kleurruimten.

Ansel wordt geleverd met vooraf gedefinieerde profielen sRGB, Adobe RGB, XYZ en linear RGB. Je kan extra profielen opgeven door ze in $Ansel/share/Ansel/color/out en $HOME/.config/Ansel/color/out te plaatsen (waarbij $Ansel de Ansel-installatiemap is en $HOME is jouw thuismap).

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

Module controls

output intent: The rendering intent for output/export. Rendering intent can only be selected when using LittleCMS2 to apply the output color profile (this can be changed in preferences > processing). If Ansel’s internal rendering routines are used, this option is hidden. For more details see rendering intent.
Uitgangs profiel: Het profiel dat wordt gebruikt om kleuren weer te geven voor uitvoer/export. De profielgegevens worden ingebed in het uitvoerbestand (indien ondersteund door het bestandsformaat), zodat andere toepassingen de kleuren correct kunnen interpreteren. Omdat niet alle applicaties bekend zijn met kleurprofielen, is de algemene aanbeveling om je aan sRGB te houden, tenzij je weet wat je doet en een goede reden hebt om het anders te doen.

Raw black/white point

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

Define camera-specific black and white points.

Deze module wordt automatisch geactiveerd voor alle onbewerkte afbeeldingen. Standaardinstellingen worden toegepast op alle ondersteunde camera’s. Wijzigingen in de standaardinstellingen zijn normaal gesproken niet vereist.

Module controls

zwartniveau 0-3: Het cameraspecifieke zwartniveau van de vier pixels in het RGGB Bayer-patroon. Pixels met waarden lager dan dit niveau worden niet geacht geldige gegevens te bevatten.
witpunt: Het cameraspecifieke witniveau. Alle pixels met waarden daarboven worden waarschijnlijk afgekapt en worden dienovereenkomstig verwerkt in de hooglichten reconstructie module.
vlakke veldcorrectie: Gebruik vlakke veldcorrectie om lensschaduw te compenseren. Dit veld verschijnt alleen voor toepasselijke Raw-bestanden en zal automatisch elke GainMap gebruiken die in de Raw is ingesloten. Indien gewenst kunt u ervoor kiezen deze correctie uit te schakelen.

Raw chromatic aberrations

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

Corrigeer chromatische aberraties van RAW afbeeldingen.

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.

Raw denoise

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

Perform denoising on raw image data before it is demosaiced.

Deze module is overgedragen van dcraw .

Module controls

ruis drempel: De drempel voor ruisdetectie. Hogere waarden leiden tot een sterkere ruisonderdrukking en een groter verlies aan beelddetail.
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.

Retouch

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

Verwijder ongewenste elementen uit je afbeelding door te klonen, helen, vervagen en vullen met getekende vormen.

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

Automatisch corrigeren voor convergerende lijnen, een vorm van perspectiefvervorming. Het onderliggende mechanisme is geïnspireerd op het programma ShiftN van Markus Hebel. Met deze module kan ook de rotatie van het beeld worden aangepast.

Perspectiefvervormingen zijn een natuurlijk effect bij het projecteren van een driedimensionale scène op een tweedimensionaal vlak en zorgen ervoor dat objecten dichtbij de kijker groter lijken dan objecten verder weg. Convergerende lijnen zijn een speciaal geval van perspectiefvervormingen die vaak worden gezien in architectuurfoto’s - parallelle lijnen, wanneer ze onder een hoek worden gefotografeerd, worden omgezet in convergerende lijnen die elkaar op een bepaald uitkijkpunt binnen of buiten het beeldframe ontmoeten.

Rotate pixels

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

De sensoren van sommige camera’s (zoals de Fujifilm FinePix S2Pro, F700 en E550) hebben een diagonaal georiënteerd Bayer-patroon in plaats van de gebruikelijke orthogonale lay-out.

Zonder correctie zou dit leiden tot een gekanteld beeld met zwarte hoeken. Deze module past de vereiste rotatie toe.

Ansel detecteert afbeeldingen die moeten worden gecorrigeerd met behulp van hun Exif-gegevens en activeert deze module automatisch waar nodig. Voor andere afbeeldingen blijft de module altijd uitgeschakeld.

Scale pixels

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

Sommige camera’s (zoals de Nikon D1X) hebben rechthoekige in plaats van de gebruikelijke vierkante sensorcellen. Zonder correctie zou dit leiden tot vervormde beelden. Deze module past de vereiste schaling toe.

De module heeft geen instellingen.

Sharpen

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

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

Deze module werkt door het contrast rond de randen te vergroten en daardoor de indruk van de scherpte van een afbeelding te verbeteren. Deze module wordt toegepast op het L-kanaal in de Lab-kleurruimte.

Opmerking: Het USM-algoritme dat in deze module wordt gebruikt, zorgt voor vervaging in de Lab-kleurruimte, wat ongewenste effecten kan veroorzaken en wordt niet langer aanbevolen. Gebruik in plaats daarvan de voorinstellingen die worden aangeboden door de module contrast-equalizer voor onscherpte of de module lokaal contrast voor algemene scherpte.

Surface blur

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.

Tone equalizer

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

Tegenhouden en doordrukken met behoud van lokaal contrast.

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

Het volgende diagram beschrijft hoe de toon-equalizer werkt:

Unbreak input profile

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

Voeg een correctiecurve toe aan afbeeldingsgegevens. Dit is vereist als u bepaalde invoerprofielen heeft geselecteerd in de module input kleurprofiel.

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.

Vignetting

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

Apply a vignetting effect to the image.

Vignettering is een wijziging van de helderheid en verzadiging aan de randen van de afbeelding in een bepaalde vorm. Veel van de onderstaande parameters kunnen ook worden gewijzigd met een grafisch besturingselement dat de afbeelding overlapt wanneer de module focus heeft, waarbij de vorm en omvang van het effect wordt weergegeven.

Opmerking: Van deze module is bekend dat deze onder bepaalde omstandigheden bandvormende-artefacten veroorzaakt. Overweeg om de module dithering te activeren om dit te verhelpen.

Watermark

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

Render een op vectoren gebaseerde overlay op uw afbeelding. Watermerken zijn standaard SVG-documenten en kunnen worden ontworpen met Inkscape .

Je kan ook bitmapafbeeldingen (PNG) gebruiken.

De SVG-processor in Ansel kan ook tekenreeks in een SVG-document vervangen, waardoor afbeeldingsafhankelijke informatie in het watermerk kan worden opgenomen.

Door de gebruiker ontworpen watermerken moeten in de map $HOME/.config/Ansel/watermarks worden geplaatst. Eenmaal op zijn plaats, gebruik de herlaadknop om de lijst met beschikbare watermerken bij te werken.

White balance

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

Pas de witbalans van het beeld aan door de temperatuur en tint te wijzigen, een coëfficiënt voor elk RGB-kanaal te definiëren of te kiezen uit een lijst met vooraf gedefinieerde witbalansinstellingen.

De standaardinstellingen voor deze module zijn afgeleid van de witbalans van de camera die is opgeslagen in de Exif-gegevens van de afbeelding.

White balance is not intended as a “creative” module – its primary goal is to technically correct the white balance of the image ensuring that neutral colored objects in the scene are rendered with neutral colors in the image. For creative color operations, it is usually better to use other modules such as color calibration or color balance.

Toolboxes

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

A toolbox is a collapsible tool docked in one of the side panels. Unlike the darkroom processing modules, toolboxes do not modify pixels — they help you browse, organize, inspect, export and annotate images, or assess the picture being edited.

Each view shows only the toolboxes relevant to its task, so the same panel position can hold different tools depending on whether you are in the lighttable, the darkroom, the map or the print view.

Styles

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

A style is a named, saved editing recipe — a subset of a history stack that can be applied to any number of images. Styles let you reuse looks, technical corrections, or module configurations without having to redo them from scratch.

Styles are accessible from two places:

The Styles menu in the menu bar, which lists all your styles and applies them in one click.
The Styles toolbox module, available as a floating window via Styles → Manage styles…

Applying a style

Click any style name in the Styles menu to apply it to all currently active images. If Ask merge settings before apply is enabled (the default), a merge settings dialog appears first. See the copy-paste history page for a full explanation of what merge position and pipeline order mean.

Notes

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

Write per-image notes that live next to your files and render as Markdown. Such notes can be to-do lists, memos, contacts of the persons in the image, tips or instructions for collaborators, etc.

The module opens in preview by default; switch to edit to change the source text. The Markdown parsing needs Ansel to be build with CMark , which is optional. If Ansel was not built with this library, it will be rendered as plain text.

Clipping warning

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

Markeer delen van de afbeelding die luminantie of gamma clipping (afknippen) kunnen vertonen.

Wanneer een afbeelding naar een weergaveapparaat wordt gestuurd, wordt elke pixel normaal gesproken weergegeven als een set van 3 getallen, die de intensiteit van de rode, groene en blauwe primaire kleuren in de uitvoerkleurenruimte vertegenwoordigen. Omdat de uitvoerkleurruimte meestal nauw verwant is aan hardware met fysieke beperkingen, is er een maximaal toegestane waarde voor de [R,G,B]-kanalen, die de maximaal beschikbare intensiteit voor die kleurruimte vertegenwoordigt. Evenzo is er ook een minimumwaarde waaronder pixelwaarden worden toegewezen aan nul. Wanneer we proberen om van een grotere kleurruimte naar de uiteindelijke uitvoerkleurenruimte te converteren, worden alle waarden die dit maximum overschrijden, op de maximale waarde geklemd en alle waarden onder het minimum op nul. Dit proces wordt “knippen” genoemd en het zal leiden tot verloren details of “onjuiste” kleuren voor alle pixels met afgekapte kanalen.

Color assessment

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

Beoordeel kleuren en helderheid in jouw afbeelding met behulp van ISO 12646:2008 aanbevolen kijkomstandigheden.

Bij het ontwikkelen van een afbeelding wordt de manier waarop we helderheid, contrast en verzadiging waarnemen, beïnvloed door de omringende omgevingsomstandigheden. Als een afbeelding wordt weergegeven tegen een donkere achtergrond, kan dit een aantal nadelige effecten hebben op onze perceptie van die afbeelding:

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)

Het eindresultaat is dat het uiteindelijke beeld te donker kan worden en overbewerkt in termen van contrast en kleurverzadiging. Om dit te voorkomen doet de norm “ISO 12646:2008” enkele aanbevelingen over de voorwaarden waaronder de kleuren van een afbeelding moeten worden beoordeeld. De module kleur beoordeling in Ontwikkelen plaatst een kader rond de afbeelding om de gebruiker te helpen de kleuren in de afbeelding beter te beoordelen, in de lijn van die aanbevelingen.

Duplicate manager

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

View and switch between the versions (duplicates) of the current image. Every version shares the same underlying file but keeps its own independent editing history, stored in its own XMP sidecar, so each can be edited without affecting the others.

In the darkroom left panel, the duplicate manager lists each version of the current image with a preview thumbnail and a version number:

Press and hold a thumbnail to preview that version in the center view.
Double-click a thumbnail to switch to that version and edit it.

Creating versions

New versions are created from the global menu, so they also work on a lighttable selection:

EXIF and IPTC

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

Display the EXIF and IPTC information (metadata) embedded in an image, plus a number of extra fields Ansel maintains (filmroll, version, local copy, etc.). The module is available in most views, in the left panel.

As you hover thumbnails in the lighttable or filmstrip, the panel updates to show the image under the cursor. This is a read-only preview and changes nothing.

When several images are selected and no single image is highlighted, the module shows only the fields that are identical across the selection; differing fields display <various values> instead.

Export

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

Export the selected images to final files.

Open the export panel from the global menu, File → Export… (Ctrl+Shift+E). 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

doel opslag

Het type locatie om jouw geselecteerde afbeeldingen op te slaan. Er zijn een aantal verschillende back-ends geïmplementeerd, waaronder een bestand op schijf, een LaTeX-boeksjabloon en verschillende webalbums. Afhankelijk van het geselecteerde doel, wordt jou gevraagd om aanvullende informatie te verstrekken, zoals bestandsnamen of gebruikersnaam en wachtwoord.

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.

uitvoermapkiezer

De knop naast het bestandsnaamsjabloonitem opent een dialoogvenster om de bovenliggende map voor export te selecteren.

bij conflicten

Kies wat je moet doen als de gegenereerde bestandsnaam in conflict is met een bestaand bestand bij het exporteren:

creëer unieke bestandsnaam: Kies automatisch een unieke nieuwe bestandsnaam door een geheel getal toe te voegen aan de naam van het conflicterende bestand.

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.

overslaan: Exporteer geen afbeeldingen waarvan de doelbestandsnaam al bestaat.

Format options

bestandstype: kies de bestandsindeling voor de geëxporteerde afbeelding. Extra opties verschijnen (hieronder) afhankelijk van het geselecteerde formaat.
kwaliteit: De kwaliteit van het geëxporteerde bestand. Hogere waarden leiden tot grotere bestandsgroottes. De standaardkwaliteit (95) is een goede instelling voor export van zeer hoge kwaliteit (bijvoorbeeld voor archivering of afdrukken). Als je een goed compromis zoekt tussen grootte en kwaliteit (bijvoorbeeld voor online weergave van afbeeldingen of uploads), moet je in plaats daarvan een waarde van “90” overwegen.
bit diepte: Het aantal bits dat voor elk kleurkanaal wordt gebruikt. Meer bits betekent minder posterisatie/kleurbanden.
compressie: Het type compressie dat moet worden gebruikt.
compressieniveau: Voor exportformaten waarin compressie kan worden gespecificeerd, specificeert het compressieniveau hoeveel compressie moet worden toegepast. Hoe hoger het niveau, hoe meer de gegevens worden gecomprimeerd, wat ten koste gaat van meer CPU-cycli.
zwart-wit afbeelding: Voor het TIFF-exportformaat is het mogelijk om een monochrome afbeelding op te slaan. Deze instelling bepaalt of het resulterende bestand de grijstinten codeert als afzonderlijke RGB-kanalen of als een enkel grijswaardenkanaal. De laatste optie zal resulteren in kleinere bestanden.

Global options

stel formaat in

kies hoe je de maximale grootte van jouw geëxporteerde afbeelding wilt hebben

in pixels (for file): Enter the maximum width and height in pixels.

in cm (voor print): Voer de maximale breedte en hoogte in cm in en definieer de dpi van de afbeelding. De equivalente grootte in pixels wordt automatisch berekend.

in cm (voor print): Voer de maximale breedte en hoogte in cm in en definieer de dpi van de afbeelding. De equivalente grootte in pixels wordt automatisch berekend.

op schaal (for bestand): Voer een vermenigvuldiger in om aan te geven met hoeveel de geëxporteerde afbeelding moet worden geschaald in vergelijking met de invoerafbeelding. Als je bijvoorbeeld een waarde van 0,5 invoert, resulteert dit in een uitvoerafbeelding met de helft van de breedte en hoogte (in pixels) van de originele afbeelding.

dpi

Als eenheden van cm of inches zijn gekozen, stelt je de dpi van de uitvoerafbeelding in. De dpi wordt ook opgeslagen in de Exif-gegevens van de geëxporteerde afbeelding. Het wordt automatisch ingesteld op 300 als “in pixels” of “op schaal” wordt gekozen.

maximale grootte

Stel de maximale breedte en hoogte van de geëxporteerde afbeelding(en) in pixels, cm of inches in (afhankelijk van de geselecteerde eenheid) – nul betekent dat er geen beperking wordt ingesteld op die dimensie. Geëxporteerde afbeeldingen worden beperkt zodat ze geen van deze waarden overschrijden, terwijl de juiste beeldverhouding behouden blijft. Zet beide op nul om te exporteren met de originele afmetingen (na uitsnijden). Als de ingevoerde waarden de originele afmetingen overschrijden, zal Ansel ofwel exporteren met de originele afmetingen of de afbeelding opschalen, afhankelijk van de parameter “opschalen toestaan”.

opschalen toestaan

Stel in op “ja” om een opschalingsstap uit te voeren als de door de gebruiker gedefinieerde maximale breedte en hoogte de oorspronkelijke afmetingen van de afbeelding overschrijden. Indien ingesteld op “nee”, zullen de afmetingen van de geëxporteerde afbeelding niet groter zijn dan de afmetingen van de originele afbeelding (na bijsnijden).

resampling van hoge kwaliteit

Stel dit in op ‘ja’ om hersampling van hoge kwaliteit op de afbeelding uit te voeren. De afbeelding wordt in volledige resolutie verwerkt en pas aan het einde verkleind. Dit kan soms resulteren in een betere kwaliteit, maar zal altijd langzamer zijn.

maskers opslaan

Sla maskers op als lagen in geëxporteerde afbeelding. Werkt alleen voor sommige afbeeldingsformaten (momenteel TIFF en 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.

Opmerking: Afbeeldingen die zijn geselecteerd maar momenteel verborgen zijn (omdat ze lid zijn van een samengevouwen groep) worden niet geëxporteerd.

Filmstrip

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

De filmstrip kan worden gebruikt om snel te schakelen tussen afbeeldingen. De getoonde afbeeldingen zijn dezelfde als die weergegeven in de bibliotheekweergave en worden gedefinieerd door de momenteel geselecteerde collectie.

Find location

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

Zoek een locatie op de kaart. Je moet verbonden zijn met internet om deze functie te gebruiken.

Om deze module te gebruiken, typ je een plaatsnaam of adres in, druk je op Enter en je krijgt een lijst met resultaten te zien. Klik op een item in de lijst en de kaart zoomt naar die locatie. Er wordt een omtrek weergegeven die de locatie bedekt of een speld die naar de locatie wijst.

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.

Enable focus peaking from the bottom toolbar in the darkroom, or via Overlay focus peaking in the lighttable display options. The sharp parts of the image are 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.

Gamut check

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

Markeer delen van de afbeelding die mogelijk worden afgekapt.

Click the gamut-check icon in the bottom toolbar to enable it. Gamut check and soft proof are mutually exclusive modes.

Klik met de rechtermuisknop op het pictogram om een dialoogvenster met configuratieparameters te openen – deze zijn hetzelfde als voor de optie soft proof.

Je kan ook overwegen om de clipping waarschuwing te gebruiken, die ook waarschuwingen voor onder- en overbelichting biedt, evenals een gammacontrole die vergelijkbaar is met die van deze module.

Geotagging

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

Import and apply GPX track data to a selection of images, and correct image date/time.

This module — labelled Datetime and GPS in the panel — 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.

Workflow overview

Een GPS-ontvanger berekent zijn huidige positie op basis van informatie die hij ontvangt van satellieten en legt deze samen met de huidige datum en tijd vast in een GPX-bestand. De Exif-gegevens van de afbeeldingen bevatten ook een tijdstempel dat is gedefinieerd door de camera-instellingen. De geotagging-module neemt de tijdstempel van de afbeelding, zoekt de positie op dat moment op in het GPX-bestand en slaat de juiste coördinaten (breedtegraad/lengtegraad/elevatie) op in zijn database en het XMP sidecar-bestand van de afbeelding.

Global color picker

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

The global color picker samples colors from the current image, displays their values in several color spaces, and lets you store and compare samples from different locations. It is part of the scopes module (the Color picker and Live samples sections), in the darkroom left panel.

Activate it with the color-picker button. It keeps sampling until you turn it off or leave the darkroom.

Note

This global color picker is distinct from the local color pickers found inside many modules (e.g. RGB curve), which set that module’s parameters. The two do not work in the same color space: the global picker samples at the end of the preview pipeline (display space), whereas a local picker reads the input or output of the module it belongs to.

Controls

Point / area mode: Click the picker button for point mode (a small spot under the cursor). Ctrl+click or right-click for area mode (the average over a drawn rectangle).
Statistic (mean / min / max): In area mode, choose whether to display the mean, minimum or maximum channel values of the sampled region. (In point mode the three are identical.)
Color mode: Choose the color space in which the sampled values are shown. Values converted to spaces other than the native display space are approximate.
Color swatch: A patch of the sampled color is shown next to the numerical values; click it to enlarge it. Right-click the numerical values to copy them to the clipboard.

Hover any value for a tooltip with more detail, including RGB and Lab values and an approximate color name.

Guides & overlays

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

Een aantal veelgebruikte hulplijnen voor compositie kunnen tijdens het bewerken over jouw afbeelding worden gelegd. Deze kunnen globaal (altijd) of lokaal (wanneer bepaalde modules actief zijn) ingeschakeld worden.

Andere ontwikkelen-functionaliteit tekent ook gekleurde overlay-lijnen op de afbeelding (bijvoorbeeld getekende maskers). Er is ook een optie om de kleur van die overlays te wijzigen (zie hieronder).

Global guides

Left-click the guides-and-overlays icon in the bottom toolbar to globally display guide overlays. The overlays remain on until you click the button a second time to switch them off.

History stack

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

The History of changes module, in the darkroom left panel, shows and lets you navigate the history stack of the current image.

It lists every change of state — a module being enabled, disabled, moved, or having a parameter changed — for the current image, newest at the top. Each entry is one user change, so a module can appear several times.

Navigating the history

Click an entry to return the image to that point in its history.
Shift+click an entry to expand the corresponding module in the right-hand panel without changing the current edit — useful for inspecting a step.
Hover an entry for a tooltip listing exactly what changed in that step compared to the previous one, which helps track down unintended adjustments.

The selected history state is remembered: it is safe to quit, leave the darkroom or switch image after stepping back, and you will return to the same state.

Library

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

Filter de afbeeldingen die worden weergegeven in de bibliotheektafelweergave en het filmstrippaneel met behulp van afbeeldingskenmerken. Deze set gefilterde afbeeldingen staat bekend als een collectie.

Importing images into Ansel stores information about them (filename, path, Exif data, data from XMP sidecar files etc.) in Ansel’s library database. A collection is defined by applying filtering rules to these attributes, thus creating a subset of images to display in the lighttable view and the filmstrip module.

Locations

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

Create areas or locations and organize them as hierarchical tags.

Een locatie wordt weergegeven als een vorm op de kaart wanneer deze is geselecteerd. Aanvankelijk wordt elke locatie weergegeven als een vierkant of cirkel en kan worden gewijzigd in een rechthoek of ellips door de breedte en/of hoogte van de vorm aan te passen.

Een locatie kan ook worden gemaakt op basis van een OpenStreetMap-regio (stad/land) polygoon. Om dit te bereiken, moet je er eerst voor zorgen dat de parameter max polygoon punten groot genoeg is (sommige landpolygonen gebruiken meer dan 150.000 punten). Selecteer vervolgens de gewenste locatie in de zoek locatie module. Wanneer de corresponderende regiovorm wordt weergegeven, komt er een polygoonsymbool beschikbaar in de “vorm” -besturing (zie hieronder). Selecteer het om de nieuwe locatie te maken.

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.

Map settings

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

Selecteer gewenste kaartgegevens van verschillende kaartaanbieders. Sommige bieden extra lagen (satellietweergave enz.) die je kan wisselen.

Module controls

kaartaanbieders

kies de provider waar je kaartinformatie vandaan wilt halen.

max. polygoon punten

De zoek locatie module geeft om prestatieredenen geen polygonen weer met meer punten dan dit. Gewoonlijk heeft een landpolygoon tussen de 50.000 en 150.000 punten.

toon OSD

kies of je de OSD-instellingen linksboven in de middenweergave wilt weergeven.

gefilterde afbeeldingen

Vink dit vakje aan om alleen de afbeeldingen uit de huidige collectie (die in de filmstrip worden getoond) in het midden weer te geven. Schakel het selectievakje uit om alle afbeeldingen in de huidige bibliotheek weer te geven, waar die afbeeldingen bijbehorende GPS-gegevens hebben. Je kan deze optie ook omschakelen door op Ctrl+S te drukken.

max afbeeldingen

het maximum aantal miniaturen dat op de kaart kan worden weergegeven.

groepsgrootte factor

vergroot of verklein het gebied dat ervoor zorgt dat afbeeldingen worden gegroepeerd.

minimaal aantal afbeeldingen per groep

Het minimum aantal afbeeldingen dat op dezelfde positie moet worden geplaatst om er automatisch een afbeeldingsgroep voor te maken.

miniaturen weergave

bepalen welke informatie op de kaartweergave moet worden weergegeven

miniaturen: Toon miniatuurafbeeldingen samen met een teller.

tel: Geef gewoon het aantal afbeeldingen weer (om ruimte op de kaart vrij te maken). Plaats de muisaanwijzer op het aantal afbeeldingen om de bijbehorende miniaturen weer te geven. Een markering die alleen telt, gedraagt zich op dezelfde manier als een normale afbeeldingsminiatuur, wat betreft kleurcodering, scrollen, slepen en neerzetten enz.

geen: Laat niets zien.

je kan ook door deze opties bladeren door op Shift+S te drukken.

Mask manager

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

The mask manager — labelled Masking & Blending in the darkroom left panel — creates, renames, edits, groups and deletes the drawn shapes used by masks. It shares its shape system with the per-module masking & blending controls: a shape drawn here is the same object a module can use as a mask, and vice-versa.

The top row of buttons creates new shapes — the same brush, circle, ellipse, path and gradient tools as the drawn mask interface. Below them is a list of every mask and shape defined for the current image.

Metadata editor

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

Bewerk de metadata van geselecteerde afbeeldingen.

Metadata is tekst in vrije vorm (titel, beschrijving, maker, uitgever, rechten enz.) die jouw afbeeldingen beschrijft.

Wanneer meerdere geselecteerde afbeeldingen verschillende waarde bevatten voor een bepaalde metadata veld laat de module voor dat veld zien. Wanneer je kiest om de wijzigen toe te passen, worden deze velden niet gewijzigd. Als je met de rechtermuisknop klikt op het veld, worden de verschillen in waarden in een lijst weergegeven aan het einde van het contextueel menu. Selecteer een van de waarden in het menu die voor alle geselecteerde afbeeldingen gebruikt moet worden. Door op “toepassen” of op de Enter / Tab toets te drukken, worden de wijzigingen opgeslagen.

Navigation

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

Zoom and pan the current darkroom image.

At the top of the darkroom left panel, the navigation module shows a full preview of the current image with a rectangle marking the area currently visible in the center view. Drag the rectangle to pan the zoomed-in view.

The current zoom level is displayed to the right of the preview. Click it for quick access to common zoom levels.

The module can be expanded/collapsed like any toolbox — from its header, through the global action search, or via a shortcut you assign to its focusing action. Center-view zoom is also controlled directly: see zoom and pan.

Print settings

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

Manage settings for the print view and initiate printing.

Module controls

Printer

printer: Selecteer een van de geïnstalleerde printers.
media: Het type media dat in de printer is geladen (gewoon papier, glanzend fotopapier, enz.).
profiel: Het ICC-profiel van de printer voor het geladen papier. Dit is het profiel dat specifiek is voor de printer en het papier. Dit profiel is de laatste kleurruimtetransformatie die op de foto is toegepast en waarvan het doel is om een afdruk van hoge kwaliteit te maken.
intent: The print rendering intent (“perceptual”, “relative colorimetric”, “saturation” or “absolute colorimetric”). See rendering intent for more details.
zwartpuntcompensatie: Of het zwartpunt van het uitvoerprofiel moet worden aangepast, dat vaak lichter is dan het invoerprofiel. Dit moet “aan” zijn wanneer de intent is ingesteld op “relatief colorimetrisch”.

Page

papierformaat: Het formaat van het papier waarop moet worden afgedrukt.
orientation: Portrait or landscape (note that darktable chooses the best fit by default).
eenheden: De eenheid die gebruikt voor het instellen van de marges: “mm”, “cm” of “inch”.
marges: Stel elke marge afzonderlijk in, of allemaal samen door op de middelste “lock”-knop te klikken.
raster weergeven:: Selecteer de rastergrootte met behulp van het invoerveld (uitgedrukt in de momenteel geselecteerde eenheid). Vink de optie aan om het raster op het canvas weer te geven.
snap naar raster: Help bij het instellen van de afbeeldingsgebieden door ze op het raster te klikken voor een juiste uitlijning.
randloze modus vereist: Geeft aan of de randloze modus van de printer moet worden geactiveerd. Dit item wordt geactiveerd wanneer de marges van de gebruiker kleiner zijn dan de marges van de printerhardware. Merk op dat het slechts een indicator is, omdat het de randloze modus niet automatisch activeert.

Image layout

afbeelding breedte/hoogte: Dit informatieveld geeft de werkelijke afbeeldingsbreedte en -hoogte (gegeven met de geselecteerde eenheden) op het papier weer.
schaal factor: Dit informatieveld toont de schaal van de afbeelding zodat deze op het papier past. Als deze waarde kleiner is dan 1 wordt het beeld verkleind, anders wordt het opgeschaald. Dit is een belangrijke factor om op te letten – een te grote waarde (opschalen) kan resulteren in een afdruk van lage kwaliteit. De bijbehorende dpi (dots per inch) wordt ook weergegeven.
uitlijning: selecteer de uitlijning van de afbeelding op zijn gebied.
knop voor nieuw afbeeldingsgebied: Een nieuw afbeeldingsgebied maken. Slepen en neerzetten op het canvas om het te plaatsen. Als de optie uitlijnen op raster is geactiveerd, kan het gebied eenvoudig worden uitgelijnd op de rasterlijnen. Een afbeelding kan in dit gebied worden geplaatst door het van de filmstrip te slepen en op het nieuwe gebied neer te zetten.
knop afbeeldingsgebied verwijderen: Het momenteel geselecteerde afbeeldingsgebied uit de compositie verwijderen.
lay-outknop wissen: Verwijder alle afbeeldingsgebieden en laat het canvas leeg.

De volgende vier velden vertegenwoordigen de positie van het momenteel geselecteerde gebied op de pagina – de boven-/linkerhoek op de eerste regel en de breedte/hoogte van het gebied op de tweede regel.

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

Click the raw-overexposed icon in the bottom toolbar to show/hide the warning overlay. Right-click the icon to open a dialog containing the following configuration parameters.

Scopes

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

The scopes module, at the top of the darkroom left panel, provides graphical depictions of the image’s tones and chromaticity. It also hosts the global color picker.

Drag the bottom edge of the module to resize the scope vertically.

Note

For performance, the scopes are computed from the lower-resolution preview pipeline (the same image shown in the navigation module), not from the full-resolution center image. Fine detail may therefore not be represented exactly.

Choosing what to show

Use the hamburger menu in the module header to access the following sub-menu items:

Snapshots

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

Store snapshots of the center image and compare them against the current edit.

A snapshot is a frozen bitmap of the darkroom center view, taken at any point during editing and later overlaid onto the current view for a side-by-side comparison while you tune a module. It can also be combined with the history of changes to compare a snapshot against different stages of development.

Taking and comparing snapshots

Click take snapshot to capture the current center view. Each snapshot is listed above the button; its name reflects the module selected in the history and its position at the time it was taken.

Soft proof

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

Bekijk jouw afbeelding weergegeven met een geselecteerd kleurprofiel.

Click the soft-proof icon in the bottom toolbar to activate soft-proof display mode. This lets you preview your image rendered through a printer profile, to see how colors will end up on the final print. A “soft proof” message at the bottom-left of the image confirms you are in soft-proof mode.

Right-click on the icon to open a dialog with the following configuration parameters. For each of these parameters, the list of available profiles is read from $ANSEL/share/ansel/color/out and $HOME/.config/ansel/color/out (where $ANSEL represents Ansel’s installation directory and $HOME your home directory).

Tagging

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

Attach tags to images, and manage the tag dictionary.

Labels bieden een manier om informatie aan afbeeldingen toe te voegen met behulp van een trefwoordenwoordenboek. Je kan labels ook beheren als een hiërarchische boomstructuur, wat handig kan zijn wanneer hun aantal groot wordt.

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

In Ansel, attaching tags is also the way to build collections: a collection is the dynamically-queried set of all images sharing a given tag, always kept up to date. So the everyday job of this module — attaching a tag to images — is the same act as “putting images into a collection”. The tag dictionary itself (creating, renaming, deleting, importing and exporting tags) is a separate, occasional, housekeeping task and lives in its own window.

Kaart

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.

Presentatie

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.

Usage

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

De weergave van de presentatie bevindt zich nog in een vroeg ontwikkelingsstadium met slechts een basisset functies.

 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

Hint: Om optimaal gebruik te maken van jouw schermgrootte, zet je Ansel in de modus Volledig scherm door op F11 te drukken en verberg je de randcontrole door op de B-toets te drukken.

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.

Deze module ondersteunt het ICC-profiel van de printer, wat enigszins verplicht is als je een afdruk van hoge kwaliteit wilt verkrijgen die dicht bij de afbeelding op het scherm ligt.

Print view layout

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

Het centrale gebied geeft de afbeeldingslay-out op het papier weer (het witte gebied). Er kunnen enkele grijze randen rond de afbeelding worden weergegeven om het afdrukbare gebied (de pagina minus de randen) weer te geven die niet door de afbeelding wordt gevuld.

The filmstrip below the image allows you to select more images.

Overlays

Wanneer de muis boven de grensvlak is van een afbeelding wordt de breedte en hoogte respectievelijk link en rechts weergegeven. Marges tussen de grensvlak en de pagina randen worden naast de gestippelde lijnen weergegeven uitgestrekt vanaf elke zijde van het grensvlak. Alle afmetingen worden weergeven in de eenheden die zijn gekozen in de print module instellingen.

Variables

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

Ansel ondersteunt variabele vervanging in een aantal modules en voorkeursinstellingen. Bijvoorbeeld:

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 $(.

Voorkeuren en instellingen

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.

Alle gewijzigde instellingen (d.w.z. instellingen die verschillen van hun standaardstatus) worden gemarkeerd met een opsommingsteken ernaast. Als je een instelling wijzigt die opnieuw moet worden opgestart om van kracht te worden, verschijnt er een bericht als herinnering nadat je het voorkeurenvenster verlaat.

General

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

Bepaal de algehele look and feel van Ansel.

interfacetaal: Stel de taal van de gebruikersinterface in. De systeemstandaard is gemarkeerd met een * (opnieuw opstarten vereist)
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”).
gebruik systeemlettergrootte: Selecteer deze optie om de lettergrootte te gebruiken die door jouw systeem is gedefinieerd. Indien niet aangevinkt, kan je een aangepaste lettergrootte invoeren in het onderstaande vak (standaard aan).
lettergrootte in punten: Als de optie “gebruik systeemlettergrootte” is uitgeschakeld, voer je een lettergrootte (in punten) in die Ansel moet gebruiken. De lettergrootte wordt onmiddellijk gewijzigd.
GUI-instellingen en tekst DPI: Pas de globale GUI-resolutie aan om de schaal van bedieningselementen, knoppen, labels, enz. te vergroten. Verhoog voor een vergrote GUI, verlaag om meer inhoud in het venster te passen. Stel in op -1 om de door het systeem gedefinieerde globale resolutie te gebruiken. De standaard is 96 DPI op de meeste systemen. (heeft een herstart nodig)

CSS thema aanpassingen

Naast het selecteren van een vooraf gebouwd thema, kan je ook jouw eigen CSS-aanpassingen toepassen om de look-and-feel van Ansel aan te passen.

Bibliotheek

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

Control functionality in the lighttable view and modules.

General

verberg ingebouwde voorinstellingen voor hulpprogramma-modules: Indien ingeschakeld, worden alleen door de gebruiker gedefinieerde voorinstellingen weergegeven in het menu voorinstellingen voor utiliteitsmodules – ingebouwde voorinstellingen worden verborgen (standaard uit).
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.

Thumbnails

gebruik raw-bestand in plaats van ingesloten JPEG vanaf grootte: Wanneer je miniaturen genereert voor afbeeldingen die nog niet in Ontwikkelen zijn verwerkt, en als de miniatuurgrootte groter is dan deze waarde, genereer je deze door de raw afbeeldingsgegevens te verwerken. Als de miniatuur kleiner is dan deze grootte, gebruik je de JPEG-voorbeeldafbeelding die is ingesloten in het onbewerkte bestand. Zodra een afbeelding in Ontwikkelen is verwerkt, worden er altijd miniaturen gegenereerd op basis van onbewerkte gegevens (je kan terugkeren naar het JPEG-voorbeeld door de geschiedenis te verwijderen). Om miniaturen met de beste kwaliteit weer te geven, kiest je “altijd”.
hoogwaardige verwerking van grootte: Als de miniatuurgrootte groter is dan deze waarde en wordt gegenereerd op basis van onbewerkte gegevens, wordt deze verwerkt met behulp van het renderingpad van volledige kwaliteit, dat beter is maar langzamer (standaard 720p). Om miniaturen met de beste kwaliteit weer te geven, kies je “altijd”.
scheidingstekens voor maatcategorieën: Groottecategorieën worden gebruikt om verschillende miniatuuroverlays weer te geven, afhankelijk van de miniatuurgrootte. Een door vertikale streepjes gescheiden reeks waarden definieert bij welke afbeeldingsformaten de categorie verandert. De standaardwaarde van “120|400” betekent dat er 3 categorieën thumbnails zullen zijn: 0-120px, 120-400px en >400px.

Ontwikkelen

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

Control functionality in the darkroom view and associated modules.

General

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).
toon laadscherm tussen afbeeldingen: Grijs laadscherm weergeven bij navigeren tussen afbeeldingen in Ontwikkelen. Schakel deze optie uit om een eenvoudig toastbericht weer te geven en de vorige afbeelding op zijn plaats te laten totdat de volgende afbeelding is geladen. Houd er rekening mee dat het uitschakelen van deze optie erg handig kan zijn om snel dubbele afbeeldingen te vergelijken, maar er kunnen problemen zijn met lange laadtijden (waardoor je denkt dat de volgende afbeelding al is geladen) en je kan visuele artefacten waarnemen terwijl de volgende afbeelding wordt geladen (standaard aan).

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

verwijder ingebouwde voorkeuren voor verwerkingsmodules

Indien ingeschakeld, worden alleen door de gebruiker gedefinieerde voorinstellingen weergegeven in het voorinstellingenmenu voor verwerkingsmodules – ingebouwde voorinstellingen worden verborgen (standaard uit).

show the guides widget in modules UI

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

show right-side buttons in processing module headers

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

always: always show all buttons

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

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

auto: hide the buttons when the panel is narrow

fade: fade out all buttons when the panel narrows

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

smooth: fade out all buttons in one header simultaneously

glide: gradually hide individual buttons as needed

(default always)

prompt for name on addition of new instance

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

Other views

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

Enable optional views:

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

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

Processing

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

Bepaal hoe afbeeldingen worden verwerkt.

Image processing

always use LittleCMS 2 to apply output color profile: If this option is activated, Ansel will use the LittleCMS 2 system library to apply the output color profile instead of its own internal routines. This is significantly slower than the default but might give more accurate results in some cases.; Als de gegeven ICC LUT-gebaseerd is of zowel een LUT als een matrix bevat, zal Ansel LittleCMS 2 gebruiken om de kleuren weer te geven, ongeacht de waarde van deze parameter (standaard uit).

Security

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

Controleer of waarschuwingsberichten worden weergegeven voordat je bepaalde activiteiten uitvoert.

General

vraag voordat je afbeeldingen uit de bibliotheek verwijdert: Vraag altijd voordat je afbeelding informatie verwijdert uit de bibliotheekdatabase van Ansel, waar het xmp-bestand wordt bewaard (standaard aan).
vraag voordat je afbeeldingen van de schijf verwijdert: Vraag altijd voordat je een afbeeldingsbestand verwijdert (standaard aan).
vraag om bevestiging voordat de bewerkingsstappen (geschiedenis) wordt weggegooid: Vraag altijd voordat je de geschiedenis van een afbeelding weggooit (standaard aan).
probeer bestanden naar de prullenbak te verplaatsenwanneer deze verwijderd worden: In plaats van afbeeldingen fysiek van de schijf te verwijderen, kan je proberen ze in de prullenbak van het systeem te plaatsen (standaard ingeschakeld).
vraag om bevestiging voordat je afbeeldingen uit de (filmrol)map verplaatst: Vraag altijd voordat je een afbeeldingsbestand verplaatst (standaard aan).
vraag om bevestiging voordat afbeeldingen naar de nieuwe (filmrol)map worden gekopieerd: Vraag altijd voordat je een afbeeldingsbestand naar een nieuwe locatie kopieert (standaard aan).
vraag om bevestiging voordat lege mappen worden verwijderd: Vraag altijd voordat je een lege map verwijdert. Dit kan gebeuren na het verplaatsen of verwijderen van afbeeldingen (standaard uit).
vraaag om bevestiging voordat een label wordt verwijderd: Vraag altijd voordat je een label van een afbeelding verwijdert (standaard aan).
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.

Other

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

Het verwerken van afbeeldingen met een hoge resolutie is een veeleisende taak die een moderne computer vereist. In termen van zowel geheugen als CPU-kracht, kan jouw computer snel tot het uiterste gaan als je het beste uit een typische 15, 20 of 25 Megapixel afbeelding haalt.

De vereisten van Ansel zijn geen uitzondering. Alle berekeningen worden uitgevoerd op 4 x 32bit floating point getallen. Dit is langzamer dan “gewone” 8 of 16 bit integer algebra, maar elimineert alle problemen van tonale onderbrekingen of verlies van informatie.

How opencl works

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

Zoals je jou kan voorstellen, kan de hardware-architectuur van GPU’s aanzienlijk variëren. Er zijn verschillende fabrikanten en zelfs verschillende generaties GPU’s van dezelfde fabrikant zijn mogelijk niet vergelijkbaar. Tegelijkertijd onthullen GPU-fabrikanten normaal gesproken niet alle hardwaredetails van hun producten aan het publiek. Een van de gevolgen hiervan is de noodzaak om propriëtaire stuurprogramma’s onder Linux te gebruiken, als je volledig wilt profiteren van jouw grafische kaart.

Fortunately an industry consortium lead by The Khronos Group has developed an open, standardized interface called OpenCL, which allows your GPU to be used as a numerical processing device. OpenCL offers a C99-like programming language with a strong focus on parallel computing. An application that wants to use OpenCL will need OpenCL source code that it hands over to a hardware-specific compiler at run-time. This way applications can use OpenCL on different GPU architectures (even at the same time). All of the hardware “secrets” are hidden in this compiler and are normally not visible to the user (or the application). The compiled OpenCL code is loaded onto your GPU and – with certain API calls – it is ready to perform calculations for you.

Activating opencl in Ansel

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

Het gebruik van OpenCL in Ansel vereist dat jouw pc is uitgerust met een geschikte grafische kaart en dat deze over de vereiste bibliotheken beschikt. De meeste moderne grafische kaarten van NVIDIA en AMD worden geleverd met volledige OpenCL-ondersteuning. De OpenCL-compiler wordt normaal gesproken geleverd als onderdeel van het propriëtaire grafisch stuurprogramma en wordt gebruikt als een dynamische bibliotheek genaamd libOpenCL.so. Deze bibliotheek moet zich in een map bevinden waar deze kan worden gevonden door de dynamische linker van jouw systeem.

Setting up opencl

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

De enorme diversiteit aan systemen en de duidelijke verschillen tussen OpenCL-leveranciers en stuurprogrammaversies maken het onmogelijk om een uitgebreid overzicht te geven van hoe OpenCL moet worden ingesteld. We kunnen jou alleen een voorbeeld geven, in dit geval voor NVIDIA-stuurprogrammaversie 331.89 op Ubuntu 14.04. We hopen dat dit een basisintroductie zal zijn en jou zal helpen bij het oplossen van eventuele problemen die specifiek zijn voor jouw installatie.

Het principe van de OpenCL-functiestroom is als volgt:

Possible problems & solutions

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

Ansel detecteert automatisch OpenCL-runtime-fouten. Bij het detecteren van een fout, zal het vervolgens alles op de CPU opnieuw verwerken. Hoewel dit de verwerking vertraagt, mag dit het eindresultaat niet beïnvloeden.

Er kunnen verschillende redenen zijn waarom OpenCL tijdens de initialisatiefase zou kunnen mislukken. OpenCL is afhankelijk van hardwarevereisten en van de aanwezigheid van bepaalde stuurprogramma’s en bibliotheken. Bovendien moeten deze allemaal passen qua maker, model en revisienummer. Als iets niet past (bijv. jouw grafisch stuurprogramma (driver) – geladen als een kernelmodule – komt niet overeen met de versie van jouw libOpenCL.so), is OpenCL-ondersteuning waarschijnlijk niet beschikbaar.

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).
zeer snelle GPU: Met dit planningsprofiel verwerkt Ansel achtereenvolgens de centrale afbeeldingsweergave en het voorbeeldvenster op de GPU. Dit is de voorkeursinstelling voor systemen met een GPU die sterk beter presteert dan de CPU.
meerdere GPU’s: Deze instelling is van toepassing op systemen met meerdere GPU’s waarvan de relatieve prestaties niet significant verschillen. Wanneer een verwerkingstaak wordt gestart, gebruikt Ansel een momenteel niet-actieve GPU, maar niet de CPU. Gebruikers van systemen met verschillende GPU’s hebben meer controle nodig over hun relatieve prioriteit. Ze zouden beter het “standaard” profiel kunnen selecteren en hun systeem kunnen verfijnen met de “opencl_device_priority” configuratieparameter (zie meerdere apparaten).

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

De planning van OpenCL-apparaten kan op de meeste systemen worden geoptimaliseerd met behulp van de instellingen van het “OpenCL-planningsprofiel”. Als jouw systeem echter uitgerust is met meer dan één GPU, wil je misschien de relatieve apparaatprioriteit handmatig instellen. Om dit te doen, moet je het planningsprofiel “standaard” selecteren en de instellingen wijzigen in de configuratieparameter “opencl_device_priority”.

Het is belangrijk om te begrijpen hoe Ansel OpenCL-apparaten gebruikt. Elke verwerkingsreeks van een afbeelding - om een invoer om te zetten in de uiteindelijke uitvoer met behulp van een geschiedenis - wordt uitgevoerd in een pixelpijp. Er zijn vier verschillende soorten pixelpijpen in Ansel. Eén type is verantwoordelijk voor het verwerken van de centrale afbeelding (of volledige weergave) in de ontwikkelenmodus, een ander pixelpijp verwerkt de voorbeeldafbeelding (navigatievenster). Er kan op elk moment een van deze twee pixelpijpen actief zijn, waarbij de volledige en preview-pixelpijpen parallel lopen. Daarnaast kunnen er meerdere parallelle pixelpijpen zijn die bestandsexports uitvoeren, evenals meerdere parallelle pixelpijpen die miniaturen genereren. Als een OpenCL-apparaat beschikbaar is, wijst Ansel dit dynamisch toe aan één specifieke pixelpijp voor één run en geeft het deze daarna vrij.

Opencl still does not run for me

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

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

Veel van de potentiële problemen zullen zich alleen voordoen bij zeer specifieke combinaties van deze factoren. Aangezien de Ansel-ontwikkelaars slechts toegang hebben tot een klein deel van deze variaties, moet je begrijpen dat we jouw specifieke probleem mogelijk niet kunnen oplossen. We kunnen niet veel doen als we jouw probleem niet kunnen reproduceren.

Memory & performance tuning

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

Memory requirements

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

Storage

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

Database

check for database maintenance: Indicates when darktable should check for database fragmentation and perform maintenance. Options are “never”, “on startup”, “on close” and “on both”. Each of these is also available with an additional “(don’t ask)” option to perform the checks automatically without prompting (default “on close”).
Drempel database fragmentatieverhouding: Fragmentatieverhouding (in procent) waarboven database-onderhoud moet worden uitgevoerd (afhankelijk van de selectie in de bovenstaande optie) (standaard 25).
maak een momentopname van database: Specificeert hoe vaak Ansel database-momentopnames moet maken. De opties zijn “nooit”, “eenmaal per maand”, “eenmaal per week”, “eenmaal per dag” en “bij het afsluiten” (standaard “eenmaal per week”)
hoeveel momentopnamen bewaard worden: Aantal momentopnames dat moet worden bewaard na het maken van een nieuwe momentopname, de databaseback-ups die zijn gemaakt bij het wisselen tussen Ansel-versies niet meegerekend. Voer “-1” in om een onbeperkt aantal momentopnames op te slaan. (standaard 10)

Xmp

maak voor elke afbeelding een xmp-bestand

XMP-bestanden bieden een redundante methode voor het opslaan van de wijzigingen die je in een afbeelding hebt aangebracht, naast de wijzigingen die zijn opgeslagen in de database van Ansel. Met deze optie kan je kiezen wanneer je deze bestanden wilt schrijven. Kiezen uit:

nooit: schrijf geen XMP-bestanden. Dit kan handig zijn als je meerdere versies van Ansel gebruikt voor ontwikkelings-/testdoeleinden, maar wordt normaal gesproken niet aanbevolen

bij importeren: een XMP-bestand wordt geschreven zodra je een afbeelding toevoegt aan de bibliotheek van Ansel en wordt vervolgens bijgewerkt elke keer dat je het bewerkt

nee editeren: de eerste keer dat je een bewerking op een afbeelding uitvoert, wordt een XMP-bestand geschreven en bij elke volgende bewerking bijgewerkt. Bij importeren wordt standaard geen XMP-bestand gegenereerd.

Het wordt sterk aanbevolen om ofwel “bij import” of “na bewerking” te kiezen. XMP-bestanden bieden een handige fail-safe, zodat je geen gegevens verliest als jouw database beschadigd raakt. Door een back-up van jouw onbewerkte bestand plus het bijbehorende XMP-bestand te maken, kunt je jouw werk op een later tijdstip volledig herstellen door jouw bewerkingsgeschiedenis opnieuw in Ansel te importeren (standaard “bij importeren”).

Miscellaneous

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

Interface

laad standaard snelkoppelingen bij opstarten: Bij het starten van de toepassing laadt Ansel eerst de standaard snelkoppelingen en vervolgens de door de gebruiker gedefinieerde snelkoppelingen hier bovenop. Hierdoor kunnen standaard snelkoppelingen worden overschreven met een nieuwe actie, maar wordt voorkomen dat ze worden verwijderd (aangezien de verwijderde snelkoppeling automatisch opnieuw wordt geladen bij de volgende herstart). Deactiveer deze voorkeur om te stoppen met het laden van standaard snelkoppelingen bij het opstarten – laad alleen de door de gebruiker gedefinieerde snelkoppelingen (inclusief eventuele standaardinstellingen die u daarna niet hebt verwijderd of overschreven). Dit maakt het verwijderen eenvoudiger, maar betekent ook dat u niet profiteert van nieuwe snelkoppelingen die in toekomstige versies worden toegevoegd zonder deze voorkeur eerst opnieuw in te schakelen (standaard aan).
schaal schuif stappen met min/max: Wanneer geactiveerd, zal de standaard stap grootte, bij het gebruik van de schuifregelaar, afhankelijk zijn van de huidige min/max waarde voor die schuif (standaard aan).
sorteer de ingebouwde voorkeuren eerst: Kies hoe het menu met voorinstellingen wordt gesorteerd. Als deze optie is ingeschakeld, worden eerst de ingebouwde voorinstellingen weergegeven. Als de optie is uitgeschakeld, worden eerst gebruikersvoorinstellingen weergegeven (standaard aan).
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.

Shortcuts with multiple instances

Het is mogelijk om meerdere instanties van veel verwerkingsmodules te maken. In dit scenario is het niet altijd duidelijk welke instantie moet worden beheerd door snelkoppelingen. De volgende opties bepalen regels die worden toegepast (in volgorde) om te beslissen welke snelkoppelingen voor module-instanties moeten worden toegepast.

Shortcuts

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

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

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

Assigning key shortcuts

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

Deleting default shortcuts

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

Presets

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

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

Vooraf gedefinieerde voorinstellingen (die standaard zijn opgenomen in Ansel) worden weergegeven met een slotsymbool. Hun eigenschappen kunnen niet worden gewijzigd.

Door de gebruiker gedefinieerde voorinstellingen kunnen worden geïmporteerd uit geëxporteerde .dtpreset-bestanden met behulp van de knop “importeren” onder aan het scherm. Je kan alle door de gebruiker gedefinieerde voorinstellingen exporteren naar een enkele map met behulp van de knop “exporteren”.

Lua options

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

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

Color management

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

Ansel employs a fully color managed workflow:

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

Display profile

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

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

Rendering method

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

Ansel kan kleuren weergeven met zijn eigen interne algoritmen of met behulp van de externe bibliotheek LittleCMS2. De interne methode van Ansel is in een orde van grootte sneller dan de externe. De externe optie geeft jou een keuze uit de weergave-intentie en kan in sommige gevallen een iets hogere nauwkeurigheid bieden.

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

Rendering intent

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

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

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

Kleurruimten van Ansel

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

Invoerafbeeldingen zijn RGB-bestanden (zoals JPEG’s of TIFF’s) of camera-RAW’s. Beide slaan visuele informatie op als een combinatie van primaire kleuren (bijv. rood, groen en blauw) die samen een lichtemissie beschrijven die door een scherm moet worden nagebootst.

De volgende afbeelding illustreert dit concept.

Unbounded colors

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

Schermen en de meeste bestandsindelingen voor afbeeldingen kunnen alleen RGB-intensiteiten coderen die binnen een bepaald bereik liggen. Afbeeldingen die zijn gecodeerd op 8 bits kunnen bijvoorbeeld alleen waarden bevatten van 0 tot 255, afbeeldingen op 10 bits van 0 tot 1023, enzovoort… Grafische standaarden stellen dat het maximum van dat bereik, ongeacht de werkelijke waarde, altijd de maximale helderheid die het weergavemedium kan weergeven, meestal tussen 100 en 160 Cd/m² (of nits), afhankelijk van de werkelijke standaard. Over het algemeen noemen we dit maximum “100 % scherm-gerefereerd”. Het minimum van het bereik, gecodeerd met 0, ongeacht de gebruikte bitdiepte, wordt dan “0 % scherm-gerefereerd”. 100% codeert voor puur wit, 0% codeert voor puur zwart.

Possible color artifacts

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

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

Er is gevonden dat sterk verzadigde blauwe lichtbronnen in het beeldframe waarschijnlijk kandidaten zijn voor pixels met negatieve L-waarden. Als je jou bezighoudt met toneelfotografie, moet je goed letten op dergelijke lichten die in afbeeldingen verschijnen.

Kleurdimensies van Ansel

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

Deze sectie definieert de perceptuele eigenschappen van kleur, zowel conceptueel als kwantitatief, om de creatieve en corrigerende aanpassingen aan kleur in Ansel te karakteriseren en te kwantificeren.

Definitions

Kleureigenschappen zoals “verzadiging”, “luminantie” of “helderheid” zijn algemeen gebruikt, maar worden grotendeels misbruikt en vaak gebruikt om verschillende dingen te betekenen. In de kleurenwetenschap heeft elk van deze termen een precieze betekenis.

Er zijn twee kaders waarbinnen kleureigenschappen kunnen worden geanalyseerd en beschreven:

Command Line Interface

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

Ansel

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

Het binaire bestand `Ansel’ start Ansel met zijn GUI en volledige functionaliteit. Dit is de standaard manier om Ansel te gebruiken.

Ansel kan worden aangeroepen met de volgende opdrachtregelparameters:

 1Ansel [-d {all,act_on,cache,camctl,camsupport,control,demosaic,
 2 dev,fswatch,imageio,invoer,ioporder,bibliotheek,lua,
 3 maskers,geheugen,nan,opencl,params,perf,print,pwstorage,
 4 signaal,sql,tegels,ongedaan maken,uitgebreide}]
 5 [<input file>|<afbeelding map>]
 6 [--version]
 7 [--disable-opencl]
 8 [--library <bibliotheek bestand>]
 9 [--datadir <data map>]
10 [--moduledir <module map>]
11 [--tmpdir <tmp map>]
12 [--configdir <gebruiker config map>]
13 [--cachedir <gebruiker cache map>]
14 [--localedir <lokale map>]
15 [--luacmd <lua commando>]
16 [--noiseprofiles <ruisprofiel json bestand>]
17 [--d-signal <signaal>]
18 [--d-signal-act <alle, verhoog, verbind, verbreek, printtrace>]
19 [--conf <key>=<waarde>]
20 [-t <num openmp threads>]

Alle parameters zijn optioneel. In de meeste gevallen moet Ansel worden gestart zonder aanvullende parameters, in welk geval Ansel geschikte standaardinstellingen gebruikt.

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.

Deze variant opent geen enkel scherm – het werkt in pure consolemodus zonder een GUI te starten. Deze modus is met name handig voor servers die achtergrondtaken uitvoeren.

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>]

De gebruiker moet een invoerbestandsnaam en een uitvoerbestandsnaam opgeven. Alle andere parameters zijn optioneel.

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

Het binaire bestand Ansel-cltest' controleert of er een bruikbare OpenCL-omgeving op jouw systeem is die Ansel kan gebruiken. Het zendt een debug-output uit die gelijk is aan het aanroepen van Ansel -d opencl` en wordt dan beëindigd.

Ansel-cltest wordt aangeroepen zonder opdrachtregelparameters.

Ansel-cmstest

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

Het binaire bestand Ansel-cmstest (alleen Linux) onderzoekt of het subsysteem voor kleurbeheer van jouw computer correct is geconfigureerd en geeft nuttige informatie weer over de geïnstalleerde monitorprofielen.

Ansel-cmstest wordt aangeroepen zonder opdrachtregelparameters.

Purge_non_existing_images.sh

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

Zoek en verwijder items uit de bibliotheekdatabase die verwijzen naar afbeeldingen die niet langer in het bestandssysteem bestaan. Je moet Ansel sluiten voordat je dit script uitvoert.

Het script kan worden aangeroepen met de volgende opdrachtregelparameters:

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

Voer het script uit zonder opties om een “dry run” uit te voeren, die een rapport genereert van de ontbrekende bestanden zonder enige wijzigingen in de database door te voeren.