Performance on Ansel

Transitioning from darktable to Ansel

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

What was removed from mainstream darktable

Features

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

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

Install

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

Dependencies for Source Builds

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

Understanding Ansel’s releases

Ansel channels

Ansel development and release path follows 3 channels :

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

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

Install on Linux

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

Prerequisites

Install your GPU OpenCL drivers if you have a GPU :

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

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

Install on Windows

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

Prerequisites

Install your OpenCL GPU drivers if you have a GPU.

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

See the caveats section below for more details.

EXE package (recommended)

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

Install on Mac OS

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

Build from source (Homebrew, recommended)

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

Prerequisites

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

Steps

Clone the repository and submodules:

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

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

Running the build

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

From the app bundle (after step 4):

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

Notes and limitations

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

MacPorts method (legacy, Intel-only)

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

Install OpenCL drivers

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

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

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

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

Configuration files

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

The configuration files of Ansel are located in :

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

Default configuration files

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

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

Import configuration from darktable

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

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

Warning

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

Importing usual darktable configuration files

Note

Debugging

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

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

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

Getting started

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

Import images

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

Basics

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

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

Editing images

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

Understanding non-destructive editing

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

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

Library and collections

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

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

Warning

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

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

Image selection

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

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

Selections are particular objects in Ansel, because :

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

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

Shortcuts and keyboard interaction

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

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

Shortcuts and available actions

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

Views

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

Die Funktionalität in Ansel ist in sechs unterschiedliche Ansichten unterteilt:

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

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

Leuchttisch

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.

Rückgängig machen/wieder zurückholen

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

Die meisten Änderungen mit dem Leuchttisch werden aufgezeichnet und können wieder rückgängig gemacht werden. Das beinhaltet Änderungen der Farbmarkierungen, Sterne-Bewertungen, Geolokationen, Schlagworte, Metadaten, Orientierung, Kopieren/Anwenden eines Bearbeitungsverlaufs, Bildduplikate oder die Anwendung eines Stils. Solange man sich im Leuchttisch befindet, ist das Rücksetzen/Wiederherstellen in der Anzahl der Schritte unbegrenzt, doch wenn die Ansicht gewechselt wird, sind die letzten Änderungen verloren.

Strg+Z um die letzte Aktion rückgängig zu machen und Strg+Y, um die letzten gelöschten Modifikationen wieder zurückzuholen (falls es sie gibt).

Digital Asset Management

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

XMP Dateien

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.

Importiere XMP Dateien, die durch andere Anwendungen erstellt wurden

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.

Lokale Kopien

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

Viele Benutzer haben riesige Fotosammlungen, die sie auf Festplatten ihres Computers oder auf einem externen Speichermedium (RAID NAS, externe Harddisk 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.

Vorschaubilder

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.

Erstellung der Vorschaubilder

Ein Vorschaubild wird erstellt, wenn ein Bild zum ersten Mal in Ansel geladen wird, nachdem das Bildes in der Dunkelkammer geändert wurde, oder wenn ein Bild erneut betrachtet wird, dessen Vorschaubild nicht mehr verfügbar ist.

Bewertungen mit Sternen und Farbmarkierungen

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

Mit Bewertungen und Farbmarkierungen können Bilder nach eigenen Kriterien sortiert und geordnet werden. Die Bewertung sowie die farbige Markierung eines Bildes werden innerhalb des Vorschaubildes und im Filmstreifen angezeigt.

Sterne Bewertung

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

Bildgruppierung

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

Das Gruppieren von Bildern ermöglicht eine Strukturierung der Bilder und verbessert die Übersichtlichkeit Ihrer Bildsammlung in der Ansicht Leuchttisch.

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

Duplizierte Bilder kommen automatisch in die gleiche Gruppe. Importierte Bilder mit gleichem Dateinamen und unterschiedlicher Erweiterung (z. B. IMG_1234.CR2 und IMG_1234.JPG) bilden automatisch eine Gruppe.

Metadaten und Verschlagworten

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

Ansel erlaubt es zusätzliche Informationen über deine Bilder zu speichern, sie können so einfacher gruppiert und gesucht werden. Diese Informationen werden in der Datenbank von Ansel und in XMP-Dateien gespeichert. Zusätzlich können sie auch Bestandteil exportierter Dateien werden.

Metadaten

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.

Verschlagwortung

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.

Dunkelkammer

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

Die Ansicht “Dunkelkammer” dient der Entwicklung von Bildern. Der mittlere Bereich zeigt das aktuell bearbeitete Bild.

Zoom

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

Alternativ kann zwischen “100%” und “einpassen” durch Drehen mit dem Mausrad vergrößert bzw. verkleinert werden. Wenn beim Drehen Strg gedrückt wird, vergrößert sich der Bereich bis zu 1600%.

Gestaltung der Dunkelkammer-Ansicht

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

Linkes Bedienfeld

Von oben nach unten:

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

Rechtes Bedienfeld

Von oben nach unten:

Die Pixelpipe

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

Anatomie der Dunkelkammer-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.

Die Pixelpipe & Modulreihenfolge

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

Die Reihenfolge in der Pixelpipe wird grafisch durch die Reihenfolge dargestellt, in der die Module auf der Benutzeroberfläche angezeigt werden: Die Pixelpipe beginnt mit einem RAW-Bild unten in der Modulliste und wendet die Dunkelkammer-Module schrittweise an, Ebene für Ebene von unten nach oben, bis oben in der Liste das vollständig bearbeitete Bild ausgegeben wird.

Der Verlaufsstapel

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

Der Verlaufsstapel speichert den gesamten Bearbeitungsverlauf für ein Bild in der Reihenfolge, in der die Bearbeitungen stattfanden. Er wird in der Bibliotheksdatenbank von Ansel und der XMP-Datei gespeichert und bleibt somit zwischen Bearbeitungssitzungen erhalten.

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.

Rückgängig machen und erneut machen

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

Während du Bilder bearbeitest, wird Ansel alle Änderungen, die du an diesem Bild aufzeichnen. Das bedeutet, es ist möglich alle Änderungen zu widerrufen und wiederherzustellen, um einen früheren Bearbeitungs-Status wiederzuhaben. Beachte, dass die Möglichkeit des Widerrufen/Wiederherstellen eine unbegrenzte Anzahl Male während der Bearbeitung gemacht werden kann, sie wird aber jedes Mal zurückgesetzt, wenn in der Dunkelkammer zu einem neuen Bild geschaltet wird.

Strg+Z um die letzte Aktion rückgängig zu machen und Strg+Y, um die letzten gelöschten Modifikationen wieder zurückzuholen (falls es sie gibt).

Maskieren und Mischen

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.

Die Ausgabedaten eines Moduls können optional mit den Eingabedaten nochmals verarbeitet (kombiniert) werden bevor diese an das nächste Modul übergeben werden. Diesen zusätzlichen Bearbeitungsschritt nennt man Überblendung: Eingabe- und Ausgabedaten werden mit Algorithmen, sogenannten Überblendoperatoren bzw. Überblendmodi, erneut verarbeitet.

Überblendmodi

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.

Klassische Überblendmodi für anzeigebezogene RGB-Farbräume (beschränkt auf 0 - 100%) definieren implizit einen Stützpunkt bei 50% (grau) oder 100% (weiß) in deren Algorithmen, abhängig vom Modus. Da szenenbezogen diese Einschränkung nicht hat, muss für Überblendungsoperation im Farbraum “RGB (Szene)” dieser Stützpunkt explizit durch den Nutzer definiert werden. Der zusätzliche Überblendstützpunkt-Parameter wird dem Nutzer angezeigt, wenn einer dieser Modi in diesem Farbraum verwendet wird. Die Wirkung hängt vom gewählten Operator ab. Zum Beispiel können Werte oberhalb des Stützpunkts aufgehellt und solche unterhalb abgedunkelt werden, oder umgekehrt.

Masken

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.

Eine Maske kann als Graustufenbild angesehen werden, bei dem alle Pixel einen Wert zwischen 0 und 1.0 (oder 0 % und 100 %) haben. Dieser Wert ist die Deckkraft , die bestimmt, wie stark ein Modul jedes einzelne Pixel beeinflusst

Die folgenden Abschnitte erklären, wie Masken in Ansel konstruiert werden.

Gezeichnete Masken

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

Mit der Möglichkeit der gezeichneten Maske kannst du eine Maske direkt auf die Bildoberfläche konstruieren. Formen können alleine oder in Kombination gebraucht werden. Wenn eine Form einmal auf ein Bild gezeichnet ist, kann diese angepasst, entfernt oder in anderen Modulen wieder gebraucht werden.

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.

Parametrische Masken

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

Die parametrische Maskenfunktion bietet eine feinkörnige, selektive Kontrolle darüber, wie einzelne Pixel gemischt werden. Dies geschieht durch die automatische Generierung einer Zwischenmaske aus benutzerdefinierten Parametern. Diese Parameter sind Farbkoordinaten und nicht die geometrischen Koordinaten, die in gezeichneten Masken verwendet werden.

Für jeden Datenkanal eines Moduls (z.B. Lab, RGB) und für mehrere virtuelle Datenkanäle (z. B. Farbton, Sättigung) wird eine Funktion für die Deckkraft pro Kanal bestimmt. Abhängig vom Wert für ein Pixel in einem bestimmten Datenkanal berechnet diese Funktion einen Überblendwert zwischen 0 und 1 (100 %) für dieses Pixel.

Kombinieren von gezeichneten und parametrischen Masken

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

Gezeichnete und parametrische Masken können kombiniert werden und als eine Einzelmaske auf Bilder angewendet werden.

Es gibt zwei Hauptelemente zur Festlegung, wie die Kombination einzelner Masken erfolgen soll: die Polarität jeder einzelnen Maske, definiert durch die Plus- oder Minus-Auswahl, und die Einstellung in der Auswahl „kombinieren“.

Die Auswahl “kombinieren” ermöglicht folgende Einstellungen, um gezeichnete und parametrische Masken zu kombinieren:

exclusive: A straightforward method of combining masks, exclusive mode multiplies together the individual pixel values from each of the component masks.; For a given pixel, the final mask will have value of 0 if any of the individual masks are 0 at that location and it will only have a value of 1.0 if all masks have a value of 1.0 at that location.

Maskenanpassungen & zusätzliche Steuerelemente

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

Wenn eine parametrische oder gezeichnete Maske eingeschaltet ist, werden mehrere weitere Regler zur Präzisierung der Maske angezeigt.

Detail-Schwellwert: Dieser Regler erlaubt die Änderung der Deckkraft einer Maske basierend auf dem Grad an Details im Bild. Der Regler wählt entweder Flächen mit vielen Details (positive Werte) oder flache, wenig detailreiche Flächen (negative Werte) aus. Die Voreinstellung (Null) wirkt sich nicht auf die Detailverfeinerung aus. Der Regler ist nützlich zum Schärfen und Weichzeichnen, das nicht-fokussierte Bereiche (Bokeh) ausschließt, oder zum Schärfen nur dieser unscharfen Bereiche, um ein Überschärfen der fokussierten Bereiche zu vermeiden.

Hinweis: Daten für die Maskenverfeinerung werden aus dem Entrastern-Modul in der Bearbeitungs-Pipeline genommen und nicht aus der Moduleingabe, die für andere Kriterien von parametrischen Masken verwendet wird. Keines der Bearbeitungsmodule nach dem Entrastern hat eine Auswirkung auf die verfeinerte Maske und sie ist im Moment nur für RAW-Bilder verfügbar.

Raster-Masken

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

Wie in vorherigen Abschnitten beschrieben, ist die kombinierte Maske eines Moduls (die Kombination jeder gezeichneten und parametrischen Maske) ein Graustufen-Rasterbild. Dieses beschreibt die Wirkung des Moduls auf jedes einzelne Pixel. Die Maske wird für aktive Module gespeichert und kann anschließend in anderen Modulen der Pixelpipe wiederverwendet werden.

Wie mit jeder Maske, wenn der Deckkraft-Wert für ein Pixel in einer Rastermaske null ist, wird die Eingabe in dieses Modul an die Ausgabe ohne Änderung weitergegeben. Wenn der Wert der Deckkraft 1. 0 ist, dann hat es den vollen Effekt. Für alle Werte dazwischen ist der Effekt an dieser Stelle proportional.

Dunkelkammer-Module

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

final resampling

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

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

Action

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

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

3D LUT

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

Transformiere RGB Werte mit einer 3D LUT Datei.

Eine 3D LUT ist eine dreidimensionale Tabelle, die es ermöglicht, jeden RGB-Wert in einen anderen RGB-Wert zu transformieren. Dieser wird normalerweise für die Filmsimulation und Farbkorrektur verwendet wird.

Das Modul akzeptiert .cube, .3dl, .png (haldclut) und .gmzDateien. Unkomprimierte 3D LUT-Daten werden weder in der Datenbank noch in der XMP-Datei gespeichert, sondern nur der Pfad der 3D LUT-Datei im Wurzel-Ordner. Das bedeutet, dass es wichtig ist, den 3D LUT Ordner zuverlässig zu sichern – ein Bild mit seinen XMP’s zu teilen bringt nichts, solange der Empfänger nicht auch die gleichen 3D LUT Dateien in seinem 3D LUT Ordner hat.

Astrofoto Entrauschen

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.

Entrauschen ist ein ressourcenintensiver Prozess und verlangsamt die Pixelpipe-Verarbeitung beträchtlich. Es sollte also im Arbeitsablauf erst spät eingeschaltet werden.

Ausgabe Farbprofil

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

Verwaltung des Ausgabeprofils für den Export und des Rendering Intent zur Abbildung zwischen Farbräumen.

Ansel kommt mit vordefinierten Profilen sRGB, Adobe RGB,_ XYZ_ und lineares RGB, aber Sie können zusätzliche Profile erstellen, indem Sie diese in $Ansel/share/Ansel/color/out und $HOME/.config/Ansel/color/out kopieren. $Ansel wird hier verwendet, um das von Ihnen gewählte Ansel-Installationsverzeichnis und $HOME Ihr Home-Verzeichnis darzustellen.

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

Belichtung

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

Erhöhe oder verringere die allgemeine Helligkeit des Bildes.

Dieses Modul hat zwei Arten der Bedienung:

Manuell: Setze die Belichtung, Schwarzpunkt und Abschneidewert manuell.
Automatisch (nur RAW): Nutzt eine Analyse des Histogramms, um die Belichtung automatisch zu korrigieren. Ansel wählt automatisch die nötige Belichtungskompensation, um das gewählte Perzentil auf den Zielwert zu verschieben (siehe die Definitionen unten). Dieser Modus eignet sich insbesondere, um eine grosse Anzahl Bilder auf die gleiche Belichtung anzupassen. Eine typische Anwendung ist das Deflickering (Entflimmern) von Zeitrafferbildern.

Moduleinstellungen

Modus: Wähle den Modus automatisch/manuell.
Belichtungskorrektur kompensieren (manueller Modus): Entfernt automatisch die Blichtungskorrektur der Kamera (aus den Exif-Daten entnommen).
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.
Abschneide-Schwellwert (manueller Modus): Definiert den Prozentsatz von hellen Werten, die in die Berechnung der Belichtung und der Schwarzwertanpassung eingehen. Der für die Berechnung verwendete Bildbereich wird mit der Pipette ausgewählt.
Perzentil (automatischer Modus): Definiert eine Stelle im Histogramm, die für eine automatische Belichtungskorrektur genutzt wird. Ein Perzentil von 50 % bezeichnet die Stelle im Histogramm, an der 50 % der Pixelwerte überhalb dieser Belichtung liegen und 50 % unterhalb.
Zielwert (automatischer Modus): Definiert den Zielwert für eine automatische Belichtungskorrektur (EV) relativ zum Weißpunkt der Kamera.
Schwarzwert-Anpassung (manueller und automatischer Modus): Anpassung des Schwarzwertes zur Erhaltung negativer RGB-Werte.

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.

Beschnitt

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.

Wenn dieses Moduls im Fokus ist, wird das unbeschnittene Bild angezeigt und Griffpunkte und Hilfslinien zum Beschneiden werden eingeblendet.

Chromatische Aberrationen

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

Mit diesem Modul können Sie chromatische Aberration korrigieren.

Im Kontrast zum Modul RAW chromatische Aberrationen, verlangt dieses Modul keine RAW Daten als Eingabe.

Arbeitsablauf

Für optimale Ergebnisse wird folgendes Vorgehen empfohlen:

Chromatische Aberrationen im Modul Objektivkorrektur mit den TCA-Reglern bestmöglich reduzieren.
Regler “Stärke” in diesem Modul erhöhen, um die Wirkung besser zu sehen.
“Radius” vergrößern bis die chromatischen Aberrationen verschwinden. Falls nicht ausreichend, die Option “sehr starke Chromatische Aberration” einschalten.
Den Referenzkanal auswählen, der die besten Resultate hinsichtlich Schärfe und Artefakte liefert.
Stärke wieder reduzieren, um starke Farbauswaschungen zu vermeiden.

Für kompliziertere Fälle kannst du folgendes ausprobieren:

Diffusion / Schärfen

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

Diffusion bezeichnet physikalische Prozesse, die, ausgehend von einer erzeugenden Quelle, Teilchen bewegt und mit der Zeit allmählich verteilt. Bei der Bildverarbeitung tritt Diffusion hauptsächlich an zwei Stellen auf:

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

In beiden Fällen macht die Diffusion das Bild weniger scharf durch “entweichende” Partikel und durch Glätten lokaler Variationen.

Das Modul Diffussion / Schärfen nutzt zur Beschreibung unterschiedlicher Diffusionsarten ein verallgemeinertes physikalisches Model. Fotographen können es entweder zur Simulierung oder Umkehrung von Diffusionsprozessen nutzen.

Dithering

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

Dieses Modul eliminiert einige verbindende Artefakte, die aus der internen 32-bit Gleitkomma resultieren und verschiebt sie ins diskrete 8-bit oder 16-bit Anzeigeformat, um sie am Bildschirm anzuzeigen.

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.

Drehen und Perspektive

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

Dieses Modul korrigiert automatisch konvergierende Linien, eine Form von perspektivischer Verzerrung, die häufig in Architekturfotografien zu sehen ist. Der zugrundeliegende Mechanismus ist inspiriert vom Programm von Markus Hebels ShiftN . Dieses Modul erlaubt auch die Korrektur der Rotation des Bildes.

Perspektivische Verzerrungen sind ein natürlicher Effekt bei der Projektion einer dreidimensionalen Szene auf eine zweidimensionale Ebene und bewirken, dass Objekte in der Nähe des Betrachters größer erscheinen als Objekte in größerer Entfernung. Konvergierende Linien sind ein Sonderfall von perspektivischen Verzerrungen, wie sie in Architekturfotografien häufig vorkommen: Parallele Linien, wenn sie schräg fotografiert werden, verwandeln sich in konvergierende Linien, die sich an einem Fluchtpunkt innerhalb oder außerhalb des Bildausschnitts treffen.

Drehung

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

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

Das Modul ist standardmäßig eingeschaltet und die Orientierung (Rotation) wird automatisch anhand der Exif-Daten gewählt.

Moduleinstellungen

Transformieren: Mit Doppelklick auf das Label wird die Transformation des Bildes zurückgesetzt.
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.

Dunstentfernung

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

Das Dunstentfernungsmodul ist so konzipiert, dass es automatisch die Wirkung von Staub und Dunst in der Luft reduziert. Dieses Modul kann auch eingesetzt werden, um Bilder speziell in kontrastarmen Bildbereichen farbintensiver zu gestalten.

Der Dunst absorbiert das Licht, welches sich von den Objekten in Richtung Kamera nähert, ist aber auch eine Quelle für diffuses Hintergrundlicht. Das Modul zur Dunstentfernung schätzt für jeden Bildbereich die Dunstmenge der Szene ab und entfernt anschließend das diffuse Hintergrundlicht entsprechend seiner lokalen Stärke und stellt das ursprüngliche Objektlicht wieder her.

Eingabefarbprofil

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

Define how Ansel will interpret the colors of the image.

Das Modul nimmt den Farbraum der Bildquelle (z.B. Kamera oder Scanner) und konvertiert die Pixelkodierung in einen standardisierten Arbeits-Farbraum. Das bedeutet, dass nachfolgende Module in der Pipeline sich nicht um Spezifika der Eingabe kümmern müssen und mit einem normalen Farbraum arbeiten oder zu/von diesem konvertieren können.

Wenn ein Bild als RAW aufgenommen wurde, wird das Modul Eingabefarbprofil normalerweise entweder eine Standard- oder verbesserte Farbmatrix für das spezifische Kameramodell anwenden, um die Farben in den Farbraum des Arbeitsprofils abzubilden. Wenn Information zum Farbraum im Bild einbettet ist, wird das Modul Eingabefarbprofil diese Information bei der Abbildung der Farben in den Farbraum des Arbeitsprofils verwenden. Der Nutzer kann auch explizit einen Farbraum für das Bild angeben, und sogar ein speziell für das Eingabegerät angepasstes ICC-Farbprofil bereitstellen.

Entrastern

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

Mit diesem Modul können Sie die Verarbeitung des Entrastern steuern.

Bayer Filter

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.

Entrauschen (Profil)

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

Dieses Modul wird verwendet, um hochauflösende ISO-Bilder zu entrauschen, angelehnt an individuelle Rausch-Profile einer großen Anzahl Kameras.

Ein Resultat einer großen Reihe von Entrauschungs-Algorithmen ist es, dass die Abweichung des Rauschens unabhängig der Helligkeit des Signals ist. Beim Erstellen der Rauschcharakteristiken einer Kamera bei unterschiedlichen ISO Werten, kann die Abweichung verschiedener Helligkeiten beurteilt werden und der Entrauschungs-Algorithmus kann so eingestellt werden, dass das Rauschen gleichmäßiger geglättet werden kann.

Currently, Ansel has sensor noise profiles for over 300 popular camera models from all the major manufacturers. If you generate your own noise profile for a camera that is not yet supported by Ansel, be sure to share it with the Ansel development team so they can include it in the next release! Please see Ansel’s camera support page for more information.

Farb Rekonstruktion

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

Das Farbrekonstruktionsmodul ist in der Lage, Farbe in ausgebrannten Spitzlichtern zurückzubringen.

Aufgrund der Beschaffenheit digitaler Sensoren fehlt es bei überbelichteten Lichtern an validen Farbinformationen. Meistens erscheinen sie neutralweiß oder weisen einen Farbstich auf, je nachdem, welche weiteren Bildverarbeitungsschritte erforderlich sind. Dieses Modul kann benutzt werden, um überbelichtete Lichter zu „heilen“, indem es ihre Farben durch besser passende ersetzt. Das Modul wirkt auf Spitzlicht-Pixel, deren Luminanzwerte einen benutzerdefinierten Schwellenwert überschreiten. Die Ersatzfarben stammen aus der Nachbarschaft. Sowohl der räumliche Abstand als auch der Leuchtdichteabstand (Bereich) werden bei der Farbauswahl berücksichtigt.

Farb-Lookup-Tabelle

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

Moduleinstellungen

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).; Wähle einen Patch aus, indem du mit der linken Maustaste darauf klickst, das Kombinationsfeld oder die Farbauswahl verwendest. Das ausgewählte Farbmuster wird mit einem weißen Rand markiert und die Nummer wird unten im Kombinationsfeld angezeigt.

Farbbalance RGB

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

Ein Modul für Fortgeschrittene, das Farbkorrekturwerkzeuge (Color Grading) aus der Kinematografie in die fotografische, in die szenenbezogene Pipeline bringt.

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.

Einführung

Die Farbanpassung ist ein wichtiger Bestandteil der Bildbearbeitung. Sie kann dazu beitragen, unerwünschte Farbstiche zu entfernen oder auch eine kreative Farbänderung bewirken, die den Bildern Atmosphäre verleiht. In den Zeiten der Filmfotografie wurde der größte Teil der Farbwirkung durch die Filmemulsion und die Entwicklungschemikalien erzielt, wobei ein gewisses Farbtuning am Vergrößerungsgerät mit Farbköpfen vorgenommen wurde. Dies benötigte erhebliche Ressourcen und war meist der Filmindustrie vorbehalten, wo diese Aufgabe von einem Koloristen übernommen wurde.

Farbbereiche

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

Dieses Modul modifiziert selektiv die Helligkeit, Sättigung und Farbton von Pixeln, basierend auf deren Helligkeit, Sättigung und Farbton.

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.

Du musst zuerst wählen, ob du die Pixel auf der Basis ihrer Helligkeit, Sättigung oder Farbton anpassen (bearbeiten) willst. Du kannst drei Kurven in deren entsprechendem Register nutzen, um die Helligkeits-, Sättigungs- oder Farbtonbereiche mit dieser Methode anzupassen.

Farbkalibrierung

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

Eine umfassende Farbraumkorrektur, Weißabgleichanpassung und Kanalmixer-Modul.

Dieses einfache, doch mächtige Modul kann auf folgende Arten genutzt werden:

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.

Filmic RGB

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

Erneuere den Tonwertumfang eines HDR Bildes durch Reproduktion der Ton- und Farbe-Ansprechbarkeit von klassischen Filmen.

Dieses Modul kann verwendet werden, um den Dynamikumfang entweder zu erhöhen oder erniedrigen, um dem Dynamikumfang der Darstellung zu genügen. Es schützt die Farben und Kontraste den Mitteltönen, stellt die Schatten wieder her und komprimiert helle Lichter. Spitzlichter müssen extra behandelt werden, um Details (z.B. Wolken) zu erhalten.

The module is derived from another module of the same name in Blender 3D modeller by T. J. Sobotka. While it is primarily intended to recover high-dynamic-range images from raw sensor data it can be used with any image. The following video (by the developer of this module) provides a useful introduction: filmic rgb: remap any dynamic range in darktable 3 .

Flächenweichzeichner

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.

Input Profil brechen

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

Füge eine Korrekturkurve den Bilddaten hinzu. Das ist notwendig, wenn du bestimmte Input-Profile im Modul Eingabe Farbprofil ausgewählt hast.

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.

Kontrast-Equalizer

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

Anpassung von Luminanz- und Chrominanzkontrast in der Wavelet-Domäne.

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.

Mehrere angebotene Voreinstellungen können dabei helfen, ein Verständnis von den Möglichkeiten des Moduls zu bekommen.

Körnung

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

Simuliere die Körnung analoger Filme. Das Korn wird im L Kanal des Lab Farbraumes bearbeitet.

Moduleinstellungen

Korngröße: Setzt die Korngröße; abgestuft, um eine ISO Zahl zu simulieren.
Stärke: Die Stärke des Effektes.

Lokaler Kontrast

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

Erhöhe den lokalen Kontrast des Bildes.

Dies wird erreicht mit der Nutzung entweder mit der Nutzung eines lokalen Laplace (Standard) oder nicht normalisierten bilateralen Filter. Beide arbeiten ausschließlich auf dem L-Kanal vom Lab-Farbraum. Der lokalen Laplace-Filter wurde erstellt, weil er robust gegen ungewollte Halo-Effekte und Gradienten-Umkehr entlang der Kanten ist.

Moduleinstellungen

Modus: Wahlweise lokaler Laplace-Filter oder bilaterales Gitter. Die folgenden Abschnitte zeigen die Einstellmöglichkeiten für diese Modi.

Bilaterales Gitter

Korngröße: Größe der Details, die Sie feiner oder gröber einstellen möchten.
Kontrast: Kontrolliere, wie stark der Algorithmus zwischen Helligkeitsstufen unterscheidet. Erhöhe diesen Parameter für ein kontrastreicheres Erscheinungsbild.
Detail: Hinzufügen oder Entfernen von Details. Höhere Werte erhöhen den lokalen Kontrast.

Lokaler Laplace-Filter

Um die Parameter des lokalen Laplace-Filter zu verstehen, stellt man sich vor, dass dieser eine Kurve auf das Bild anwendet. Diese Kurve entspricht in etwa diesem Bild:

Negadoctor

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

Process scanned film negatives.

Negadoctor is a module designed to help you process a scanned film negative. Whether the negative was scanned on a film scanner, held up to a white light source like a computer screen, or back lit with off-camera flash is irrelevant.

Vorbereitung

Falls das Negativ durch eine digitale Kamera gemacht wurde, dann musst du folgendes berücksichtigen, um im Bild korrekte Farben zu erhalten:

Objektiv-Korrektur

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

Korrigiert (und simuliert) automatisch für Objektiv-Verzerrungen, chromatische Abweichungen (TCA) und Vignettierung.

Die Kameramarke und das Modell werden durch Exif-Daten bestimmt. Sie nutzen die externe lensfun library , um die Korrekturparameter vorzusehen.

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.

Pixel Drehung

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

Die Sensoren einiger Kameras wie der Fujifilm FinePix S2Pro, F700 und E550 haben ein diagonal orientiertes Bayer-Muster anstelle des üblichen orthogonalen Layouts.

Ohne Korrektur würde dies zu einem gekippten Bild mit schwarzen Ecken führen. Dieses Modul wendet die erforderliche Rotation an.

Ansel erkennt korrekturbedürftige Bilder anhand ihrer Exif-Daten und aktiviert dieses Modul automatisch. Bei anderen Bildern bleibt das Modul immer deaktiviert.

Das Modul hat keine Parameter.

Pixelskalierung

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

Einige Kameras (wie die Nikon D1X) haben rechteckige statt der üblichen quadratischen Sensorzellen. Ohne Korrektur würde dies zu verzerrten Bildern führen. Dieses Modul wendet die erforderliche Skalierung an.

Ansel erkennt korrekturbedürftige Bilder anhand ihrer Exif-Daten und aktiviert dieses Modul automatisch. Bei anderen Bildern bleibt das Modul immer deaktiviert.

Das Modul hat keine Parameter.

Rahmen

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

Generate a frame around the image.

Der Rahmen besteht aus einem Rahmen mit einer benutzerdefinierten Farbe und einer Rahmenlinie innerhalb dieses Rahmens, die eine andere benutzerdefinierte Farbe hat. Es gibt verschiedene Möglichkeiten, wie du die Geometrie und Farbe deines Rahmens steuern kannst.

Moduleinstellungen

Rahmengröße: Dieser Schieberegler steuert die Größe des Rahmens in Prozent des zugrunde liegenden Vollbildes.
Abbildung: Das Bildformat für die endgültige Ausgabe dieses Moduls wählen (z.B. darunter liegendes Bild plus Rahmen).
Drehung: Wenn Sie ein nicht-quadratisches Seitenverhältnis wählen, legt diese Auswahlbox die Ausrichtung fest – Hochformat oder Querformat. Setzen Sie auf „auto“, wenn Sie möchten, dass Ansel die sinnvollste Orientierung basierend auf dem zugrunde liegenden Bild wählt.
Horizontale/vertikale Position: Wählen Sie aus einer Reihe von vordefinierten Verhältnissen, um zu kontrollieren, wo das zugrunde liegende Bild auf der horizontalen Achse positioniert werden soll. Sie können auch mit der rechten Maustaste klicken und Ihre eigene Quote als „x/y“ eingeben.
Dicke der Rahmenlinie: Der prozentuale Anteil der Rahmenliniengröße relativ zur Rahmengröße bei ihrer kleinsten Abmessung.
Versatz der Rahmenlinie: Die Position der Rahmenlinie relativ zum darunterliegenden Bild. Wählen Sie einen Wert von 0 % für eine Rahmenlinie, die das Bild berührt, und von 100 % für eine Rahmenlinie, welche die äußeren Begrenzungslinien berührt.
Farbe des Rahmens/Farbe der Linie: Ein Paar von Farbauswahlschaltern, die es erlauben, die Farben für den Rahmen und die Linie zu definieren. Wenn du auf das Farbfeld klickst, öffnet sich ein Farbauswahldialog, der dir eine Auswahl der am häufigsten verwendeten Farben bietet, oder du kannst eine Farbe im RGB-Farbraum definieren. Du kannst auch eine Farbpipette aktivieren und eine Farbprobe aus dem Bild nehmen.
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.

RAW chromatische Aberrationen

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

Korrigiere chromatische Aberrationen von RAW Bildern.

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 Entrauschen

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

Perform denoising on raw image data before it is demosaiced.

Dieses Modul wurde von dcraw portiert.

Moduleinstellungen

Rausch-Schwellwert: Stellen Sie den Schwellwert für die Rauscherkennung ein. Höhere Werte führen zu einer stärkeren Rauschunterdrückung und einem höheren Verlust an Bilddetails.
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.

RAW Schwarz-/Weißpunkt

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

Define camera-specific black and white points.

Dieses Modul wird automatisch für alle RAW-Bilder aktiviert. Es gibt Standard-Einstellungen für alle unterstützten Kameras. Veränderungen der Voreinstellungen sind normalerweise nicht notwendig.

Moduleinstellungen

Schwarzwert 0 - 3: Die Kamera-spezifischen Schwarzwerte der vier Pixel im RGGB Bayer-Muster. Pixel mit geringerem als diesem Wert werden nicht so angesehen, als dass sie gültige Daten enthalten.
Weißpunkt: Der Kamera-spezifische Weißpunkt. Alle Pixel mit höheren Werten als die definierten werden wahrscheinlich beschnitten und sollten also im Modul highlight Spitzlicht-Rekonstruction entsprechend behandelt werden.
Flacher Bereich Korrektur: Nutze die Flache Bereich Korrektur, um Schattierungen des Objektives zu kompensieren. Dieses Feld erscheint nur für zutreffende RAW Dateien und wird automatisch jegliche Gainmap nutzen, der im RAW eingebettet ist. Du kannst diese Korrektur ausschalten.

Retusche

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

Retusche ermöglicht es, bestimmte Bereiche des Bildes zu heilen, zu klonen, zu füllen und zu verwischen.

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.

RGB Kurve

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

This module is a classic digital photography tool. Ansel’s RGB curve works on RGB color space.

Aktiviere die Pipette links, um die in der Grafik auswählten Farbwerte anzuzeigen (Strg+Klick oder Rechtsklick aktiviert den Flächenmodus). Die numerischen (Lab-)Werte der Ein- und Ausgabe (siehe unten) des gewählten Punkts oder der Fläche werden oben links im Modul angezeigt.

Ein zweiter Farbprober rechts kann verwendet werden um automatisch neue Knoten basierend auf der gewählten Fläche. Mit Strg+Klick+ziehen können die erzeugten Knoten für die gewählte Fläche ins Positive geändert werden; mit Umschalt+Klick+ziehen ins Negative.

RGB Stufen

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

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

Das Werkzeug RGB Stufen zeigt ein Histogramm des Bildes und zeigt drei senkrecht weiße Striche mit Anfassern an. Ziehe an den Anfassern, um den Schwarz-, Mittelgrau- und Weißpunkt anzupassen (im “RGB verbundene Kanäle” Modus) oder unabhängig für jeden Kanal R, G und B (Im Modus “RGB unabhängige Kanäle”).

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.

Schärfen

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

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

Das Modul vergrößert den Kontrast bei den Kanten und bewirkt so eine Zunahme des Eindruckes von Schärfe eines Bildes. Das Modul wird an den L Kanal im Lab Farbraum angewendet.

_Hinweis:: Der USM-Algorithmus in diesem Modul erzeugt Unschärfe im Lab-Farbraum, was unerwünschte Effekte erzeugt. Empfohlen wird stattdessen im Modul Kontrast-Equalizer die Voreinstellungen zum Schärfen zu nutzen, oder das Modul Lokaler Kontrast für allgemeine Schärfe.

Spitzlicht Rekonstruktion

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

Dieses Modul versucht, Farbinformationen in Pixeln zu rekonstruieren, bei denen Daten in einem oder mehreren RGB Kanälen abgeschnitten wurden.

Wenn Sie nichts tun, werden Ihre beschnittenen Bereiche oft auf den nicht beschnittenen Kanal getont. Wenn zum Beispiel Ihre grünen und blauen Kanäle beschnitten sind, erscheint Ihr Bild in den betroffenen Bereichen rot.

Die drei Methoden der Rekonstruktion sind:

Spitzlichter abschneiden: Setzt einfach alle Pixel auf den Weißwert. Damit werden alle abgeschnittenen Lichter effektiv in neutrale Grautöne umgewandelt. Diese Methode ist vor allem dann nützlich, wenn abgeschnittene Lichter in nicht gefärbten Bereichen wie Wolken liegen.
In LCh rekonstruieren: Analysiert jedes Pixel mit mindestens einem abgeschnittenen Kanal und transformiert die Informationen in den LCh-Farbraum, um das abgeschnittene Pixel mit den Werten der anderen (3 für Bayer oder 8 für X-Trans) Pixel im betroffenen Sensorblock zu korrigieren. Diese Methode ist in der Regel besser als „Spitzlichter abschneiden“, da einige Details in den abgeschnittenen Bereichen erhalten bleiben. Wie mit Spitzlichter abschneiden ist diese Methode eine gute Option für natürlich entsättigte Objekte.
Farben rekonstruieren: Verwende einen Algorithmus, der Farbinformationen aus der unbeschnittenen Umgebung in die beschnittenen Spitzlichter überträgt. Diese Methode funktioniert sehr gut auf Flächen mit homogenen Farben und ist besonders nützlich bei Hauttönen mit sanft verblassenden Spitzlichtern. Sie scheitert in bestimmten Fällen, wenn sie verwirrende Artefakte an Glanzlichtern hinter kontrastreichen Kanten erzeugt, wie z. B. feine, gut belichtete Strukturen vor überbelichteten Hintergründen (z. B. Schiffsmasten oder Flaggen vor einem ausgefressenen Himmel).
geführtes Laplace: Nutze den Algorithmus (stammend vom Modul Diffusion / Schärfe), um die Details von genauen Kanälen zu beschnittenen Kanälen zu vervielfältigen und die Farbgradienten von genauen Umgebungen in beschnittene Teile zu verbreiten. Dies ist eine langsame und rechenintensive Methode, um ein Maximum an Ebenmässigkeit und ein nahtloses Mischen der rekonstruierten Nachbarbereiche, und es wurde hauptsächlich für die Rekonstruktion von Spitzlichtern und spektakulären Reflexionen geschaffen. dieser Modus kann nur für Bayer Sensoren angewendet werden.

Hinweis: Wenn das Modul Spitzlicht-Rekonstruktion zusammen mit dem Modul Filmic RGB gebraucht wird, mag es nötig sein, dieses Modul im Modus beschneide Spitzlichter zu vermeiden, damit Filmic RGB mehr Informationen zum Bearbeiten hat.

Tonwert-Equalizer

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

Abwedeln und dabei den lokalen Kontrast bewahren.

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.

Das folgende Diagramm beschreibt, wie der Ton-Equalizer arbeitet:

Tote Pixel

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

Automatically detect and eliminate hot pixels.

Tote Pixel sind Pixel, bei denen es nicht gelungen ist, die Helligkeit korrekt zu erfassen. Erkannte tote Pixel werden durch einen Durchschnittswert ihrer Nachbarn ersetzt.

Moduleinstellungen

Schwellenwert: Wie stark muss der Wert eines Pixels von seinen Nachbarn abweichen, um als totes Pixel betrachtet zu werden.
Stärke: Die Stärke der Verschmelzung von toten Pixeln mit ihrer Umgebung.
Durch drei Nachbarpixel erkennen: Erweitert die Erkennung von toten Pixeln – sieht ein Pixel als tot an, wenn mindestens drei (statt vier) Nachbarpixel um mehr als den Schwellenwert abweichen.
Korrigierte Pixel Markieren: Diese Option markiert die korrigierten Pixel visuell. Es zeigt auch die Anzahl der erkannten und fixierten Pixel an.

Verflüssigen

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

Das Modul Verflüssigen bietet eine vielseitige Möglichkeit, Pixel zu bewegen, indem es freie Stilverzerrungen auf Teile des Bildes anwendet. Dafür gibt es drei Werkzeuge: Punkte, Linien und Kurven.

Knoten

Jedes Werkzeug zum Verflüssigen basiert auf Knotenpunkten. Ein Punkt besteht aus einem einzelnen Knoten, eine Linie oder eine Kurve, die aus einer Sequenz von verbundenen Knoten besteht, die einen Pfad definieren.

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.

Verlaufsfilter

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

Simuliert einen Verlaufsfilter, um Belichtung und Farben abgestuft zu korrigieren.

Eine Linie wird am Bildschirm angezeigt, mit welcher die Position und die Drehung des Verlaufes mit der Maus eingestellt werden kann.

Dieses Modul kann unter bestimmten Bedingungen Banding-Artefakte erzeugen, die wiederum mit dem Modul Dithering abgeschwächt werden können.

Moduleinstellungen

Dichte: Stellt die Stärke des Filters in EV ein. Ein kleiner Wert unterbelichtet geringfügig, während ein großer Wert einen starken Filter erzeugt.
Härte: Progressivität des Gradienten: Ein kleiner Wert erzeugt einen weichen Übergang, während ein großer Wert einen harten Übergang erzeugt.
Drehung: Die Drehung des Filters. Negative Werte drehen im Uhrzeigersinn. Die Drehung kann auch durch Ziehen am Ende der Verlaufslinie mit der Maus eingestellt werden.
Farbton: Stellt den Farbton für einen Farbverlauf ein.
Sättigung: Die Sättigung des Farbverlaufs; voreingestellt ist neutral (grau) mit Wert 0.

Verpixelung

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

Degradiert Teile des Bildes in einer ästhetischen gefälligen Art, um Leute/Objekte zu anonymisieren, oder um Körperteile zu verstecken.

Verpixelung arbeitet im linearen RGB-Farbraum zur Anwendung eines physikalisch-korrekten Gaußschen Weichzeichners und Gaußschen Luminanzrauschens.

Neben der Anonymisierung kann dieses Modul für eine breite Palette kreativer Zwecke verwendet werden, z.B.:

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.

Hinweis: Die in diesem Modul angewendeten Anonymisierungsmethoden sind nicht forensisch sicher und bevorzugen die Ästhetik. Einige forensische Techniken können immer noch den verpixelten Inhalt anhand seiner Struktur rekonstruieren, speziell einfache Formen und Text, wie KFZ-Kennzeichen und Hausnummern.

Vignettierung

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

Apply a vignetting effect to the image.

Die Vignettierung ist eine Modifizierung der Helligkeit und Sättigung an den Rändern eines Bildes in einer spezifizierten Form. Das Modul verfügt über einen umfangreichen Satz von Parametern, mit denen die Wirkung präzise eingestellt werden kann.

Hinweis: Dieses Modul ist dafür bekannt, dass es unter bestimmten Bedingungen Banding-Artefakte hervorruft; Sie sollten in Betracht ziehen, das Modul Dithering zu aktivieren, um das abzuschwächen.

Also note: This module can produce unnatural-looking results and should be used with care. Instead, use the exposure module with an elliptical mask with a large transition area and, if necessary, use the color balance rgb module with the same mask to reduce saturation at the edges.

Wasserzeichen

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

Mit dem Wasserzeichenmodul wird ein vektorbasiertes Überlagerungsbild auf Ihr Bild gerendert. Wasserzeichen sind übliche SVG-Dokumente und können z. B. mithilfe von Inkscape erstellt werden.

Sie können auch ein Bitmap-Bild (PNG) verwenden.

Der SVG-Prozessor in Ansel ersetzt auch Zeichenketten innerhalb eines SVG-Dokuments. Dies ermöglicht, bildabhängige Informationen (wie Blende, Belichtungszeit und andere Metadaten) in das Wasserzeichen einzubetten.

Benutzerdefinierte Wasserzeichen werden in das Verzeichnis $HOME/.config/Ansel/watermarks gestellt. Wenn Sie die Liste der verfügbaren Wasserzeichen aktualisiert haben, klicken Sie auf die Schaltfläche “Reload” rechts neben dem Dateinamen des Wasserzeichens.

Weichzeichnung

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

Simuliert eine physikalisch-korrekte Weichzeichnung in szenenbezogenem RGB-Farbraum.

Typen der Weichzeichnung

Drei Typen an Weichzeichnung werden angeboten:

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

Ein Diagramm oben im Modul zeigt die Form des Weichzeichners, bekannt als Punktspreizfunktion , an. Das Modul verrauscht jeden Lichtpunkt im Bild in einen “Flecken” in der Form des Weichzeichners, wobei die Größe des Flecks durch den Weichzeichnungsradius eingestellt wird.

Weißabgleich

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

Stelle den Weißabgleich des Bildes durch Verändern von Temperatur und Farbton, und so einen Koeffizienten für jeden RGB-Kanal definieren, oder von einer Liste mit vordefinierten Weißabgleichs auszuwählen,

Der Standardwert für dieses Modul wird aus den Exifdaten der Kamera gelesen.

Der Weissabgleich ist nicht wirklich als “kreatives” Modul gedacht – das primäre Ziel ist es, den Weißabgleich des Bildes technisch so zu korrigieren, dass neutrale Objekte im Bild mit neutralen Farben dargestellt werden. Für kreative Farb-Operationen, ist es normalerweise besser, andere Module, wie Farbkalibrierung oder Farbbalance RGB zu nutzen.

Karte

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.

Diaschau

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.

Nutzung

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

Die Diashow ist immer noch in einem frühen Stadium der Entwicklung mit nur einfachen Möglichkeiten.

 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

Hinweis: Um Bilder in voller Größe auf den Bildschirm anzuzeigen, mit F11 in den Vollbildschirm-Modus einschalten und mit der “B”-Taste die seitlichen Steuerelemente ausblenden.

Drucken

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.

Dieses Modul unterstützt das ICC-Profil des Druckers, was eigentlich zwingend ist, wenn du einen hochqualitativen Druck nahe dem Monitorbild erreichen willst.

Gestaltung des Druckfensters

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

Die zentrale Fläche zeigt das Bild auf dem Druckpapier (weiße Fläche). Es können graue Ränder um das Bild angezeigt werden, um die mögliche bedruckbare Fläche anzuzeigen (die Seite ohne die Ränder), die nicht durch das Bild abgedeckt werden.

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

Überlagerungen

Wenn die Maus über dem Begrenzungsrahmen eines Bildes ist, werden dessen Breite und Höhe oben und links angezeigt. Ränder zwischen den Begrenzungslinien und dem Seitenrand des Blattes sind bei den gestrichelten Linien auf allen Seiten des Begrenzungsrahmens. Alle Angaben werden in den Einheiten gezeigt, die im Modul der Druckeinstellungen gewählt wurden.

GUI toolboxes

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

Anzeige der Über-/Unterbelichtungen der RAW Werte

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

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

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

Click on the

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

Bereiche

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

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

Mausbewegungen im Anzeigebereich lassen Schaltflächen erscheinen, mit denen die Anzeige angepasst werden kann. Die Schaltfläche ganz links wechselt die Darstellungen zwischen Histogramm, Wellenform-Histogramm, getrennten RGB-Kanälen und Vektorscope. Die weiteren Schaltflächen kontrollieren, wie die Grafik in der ausgewählten Darstellung angezeigt wird.

Display metadata

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

Zeigt Informationen an, die in den Exifdaten des Bildes eingebettet sind plus zusätzlich einige zusätzliche Datenfelder von Ansel vorgesehen.

Wenn mit der Maus über die Miniaturbilder gefahren wird, werden die gezeigten Informationen des eben überfahrenen Bildes automatisch aufdatiert.

Wenn mehrere Bilder angewählt sind und der Fokus nicht auf einem einzelnen Bild ist, zeigt das Modul nur jene Informationen, die für alle Bilder gleich ist. Falls irgendwelche Felder zwischen den angewählten Bildern differieren, wird stattdessen der Text “<verschiedene Werte>” eingeblendet.

Druckeinstellungen

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

Manage settings for the print view and initiate printing.

Moduleinstellungen

Drucker

Drucker: Wähle einen der installierten Drucker aus.
Medium: Typ des Papiers im Drucker (Normalpapier, Hochglanz-Fotopapier, usw.)
Profil: Das ICC Profil des Druckers für das gewählte Papier. Das ist das spezifische Profil für den Drucker und das Papier. Dieses Profil gibt die letzte Farbraum-Information für das Bild mit dem Ziel eine hohe Druckqualität zu erzeugen.
intent: The print rendering intent (“perceptual”, “relative colorimetric”, “saturation” or “absolute colorimetric”). See rendering intent for more details.
Tiefenkompensation: Schwarzpunkt des Ausgabeprofils anpassen, was oft einfacher ist als das Eingabeprofil. Das Häkchen setzen, wenn Vorsatz auf “relativ farbmetrisch” eingestellt ist.

Seite

Papierformat: Die Größe des Papiers wählen auf dem gedruckt werden soll.
orientation: Portrait or landscape (note that darktable chooses the best fit by default).
Einheiten: Die Einheit zum Wählen der Ränder: “mm”,“cm”, oder “inch”.
Ränder: Wähle jede Randbreite einzeln, oder alle einheitlich durch Klicken auf die mittlere “Sperren” Schaltfläche.
Zeige das Gitter an: Wähle im Eingabefeld die Größe des Gitters an (ausgedrückt in den gegenwärtig angewählten Einheiten). Kreuze die Option, um das Gitter auf der Bildfläche anzuzeigen.
Fange das Gitter: Hilft die Bildbereiche auszurichten, indem es diese ans Gitter fängt, für eine gute Ausrichtung.
Ohne Rand Modus verlangt: Zeigt an, ob im Drucker der Modus “ohne Rand” angewählt werden soll. Diese Möglichkeit wird angezeigt, wenn die Ränder des Nutzers kleiner sind als die möglichen Ränder der Hardware. Beachte, das ist nur eine Anzeige, es aktiviert den Modus “ohne Rand” nicht automatisch.

Bild-Layout

Bildbreite/-höhe: Hier wird die Größe des gewählten Bildes auf dem Papier mit Breite und Höhe angezeigt (in der gewählten Einheit).
Skalierungsfaktor: Anzeige der Skalierung des Bildes, so dass dieses auf das Papier passt. Ist dieser Wert kleiner als 1, wird das Bild verkleinert, sonst wird es vergrößert. Dieser Wert sollte beachtet werden: Ein zu großer Wert (Vergrößerung) kann zu einem Druck mit niedriger Qualität führen. Die zugehörige Auflösung in DPI (dots per inch) wird auch angezeigt.
Position: Wähle hier die Platzierung des Bildes auf seiner Fläche.
Schaltfläche neuer Bildbereich: Kreiere einen neuen Bildbereich. Ziehe und setze ihn ein zum Platzieren. Falls die Option Fange das Gitter aktiviert ist, dann kann der Bereich leicht an die Gitterlinien ausgerichtet werden. Ein Bild kann mit Ziehen vom Filmstreifen gezogen und in diesen neuen Bereich platziert werden.
Schaltfläche Bild löschen: Entferne das aktuell angewählte Bild von der Komposition.
Schaltfläche Lösche das Layout: Entfernt alle Bildbereiche und lässt die Fläche leer.

Die folgenden vier Felder repräsentieren die Position der gegenwärtig angewählten Bereiche auf der Seite – die Ecke oben/links auf der ersten Linie und die Breite/Höhe des Bereiches auf der zweiten Linie.

Duplikat-Manager

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

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

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

Exportieren

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

Ausgewählte Bilder exportieren.

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

Moduleinstellungen

Speicherziel Optionen

Speicherziel

der Typ des Ortes, wo die gewählten Bilder gespeichert werden sollen. Eine Reihe unterschiedlicher Speicherorte sind vorgesehen, wie Verzeichnis auf Speicherplatten, LaTeX Fotobuch-Vorlage und verschiedene Webseitengalerien. Je nach gewähltem Speicherziel wirst du aufgefordert zusätzliche Informationen anzugeben, wie Dateinamen oder Name des Kontos und Passwort.

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.

Verzeichnis wählen

Die Schaltfläche neben dem Dateinamen öffnet einen Dialog, um das Hauptverzeichnis für den Export auszuwählen.

Bei Konflikten

Wähle, was zu tun ist, wenn der generierte Name mit einem bestehenden File in Konflikt steht.

wähle einen eindeutigen Dateinamen: Wählt automatisch einen eindeutigen neuen Dateinamen durch Hinzufügen einer Ganzzahl zum Dateinamen mit Konflikt.

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.

Überspringen: Exportiere Dateien nicht, falls der Dateiname im gewählten Ort schon existiert.

Dateiformat Optionen

Dateiformat: Wähle das Dateiformat für das zu exportierende Bild. Zusätzliche Optionen werden eingeblendet, abhängig vom gewählten Format.
Qualität: Die Qualität die zu exportierende Datei. Größere Werte haben größere Dateigrößen zur Folge. Die Normalqualität (95) ist ein guter Wert für hochqualitative Exporte z.B. zur Archivierung oder für den Druck. Falls du einen guten Kompromiss zwischen Dateigröße und Qualität, z.B. für Online Bilder oder zum Hochladen, dann solltest du eher den Wert “90” wählen.
Bit-Tiefe: Die Anzahl nötige Bits für jeden Farbkanal. Mehr Bits bedeutet weniger Tontrennung und Color-Banding.
Kompression: Die Art der Kompression, die angewendet werden soll.
Kompressions-Stufe: Für Exportformate, bei welchen die Kompression angegeben werden kann, gibt die Kompressions-Stufe an, wie viel Kompression anzuwenden ist. Je höher die Stufe, umso mehr Daten werden komprimiert, auf Kosten von mehr CPU Verarbeitungsschritten.
SW Bilder: Für das TIFF Exportformat kann ein monochromes Bild gespeichert werden. Diese Wahl gibt an, ob die resultierende Datei die Graustufen als separate RGB Kanäle kodiert oder als einen Grauskala-Kanal. Die zweite Option ergibt kleinere Dateien.

Globale Optionen

Setze die Größe

Wähle die Einheiten für die maximale Größe des zu exportierenden Bildes.

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

in cm (für Druck): Wähle die maximale Breite und Höhe in cm vor und definiere die dpi für das Bild. Der zugehörige wert in Pixeln wird automatisch berechnet.

in Zoll (für Druck): Wähle die maximale Breite und Höhe in Zoll vor und definiere die dpi für das Bild. Der zugehörige wert in Pixeln wird automatisch berechnet.

Skalierung (für Datei): Wähle einen Multiplikator, um festzulegen, um wie viel das exportierte Bild im Vergleich zum Eingabebild skaliert werden soll. Zum Beispiel wird die Eingabe eines Wertes von 0,5 wird ein Ausgabebild in der Hälfte der Breite und Höhe (in Pixeln) des Eingabebildes ergeben.

Pixel

Wenn cm als Einheit gesetzt ist, wähle die Pixeldichte für das Ausgabebild. Diese wird auch in den Exifdaten des zu exportierenden Bildes gespeichert. Es wird automatisch auf einen Wert von 300 gesetzt, wenn “Pixel” oder “Skaliert” gesetzt war.

Maximale Größe

Setze die maximale Breite und Höhe des zu exportierenden Bildes in Pixeln, cm oder Zoll (je nach gewählter Einheit) – Null bedeutet keine Restriktionen bei dieser Dimension. Die exportierten Bilder werden so beschränkt, dass keiner dieser Werte überschritten wird, aber das Verhältnis Breite/Höhe wird beibehalten. Setze beide auf null um das Bild in den Ursprungsdimensionen (nach Beschneiden) zu exportieren. Falls die eingegebenen Werte die Originalgröße überschreiten wird Ansel entweder das Bild in den Originaldimensionen exportieren oder das Bild vergrößern, falls der Parameter “Vergrößern zulassen” angewählt ist.

Vergrößern erlauben

Setze auf “ja”, um eine Vergrößerung zu erlauben, falls die definierten Werte der maximalen Breite und Höhe die Werte des Originalbildes überschreiten. Falls auf “nein” gesetzt werden die Werte der Größe des exportierten Bildes die Dimensionen des Originalbildes (nach Beschneiden) nicht übersteigen.

Hochqualitatives Resampling

Setze auf “ja”, um hochqualitatives Resampling des Bildes zu erreichen. Das Bild wird mit der vollen Auflösung bearbeitet und erst zuletzt herunterskaliert. Dadurch können bessere Resultate erreicht werden, aber es wird den Prozess verlangsamen.

Raster-Maske speichern

Speicht Masken als Ebenen in exportierten Bildern. Dies wird nur für bestimmte Ausgabeformate unterstützt (aktuell TIFF and XCF).

profile

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

intent

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

style

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

mode

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

export

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

Hinweis: Bilder, die zwar angewählt, aber gegenwärtig versteckt sind (weil sie Teil einer eingeklappten Gruppe sind) werden nicht exportiert.

Farbbeurteilung nach ISO 12646

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

Beurteile die Farben und Helligkeit in deinem Bild nach ISO 12646:2008 vorgeschlagene Bedingungen für die Betrachtung.

Während des Entwickelns eines Bildes wird die Art, wie wir Helligkeit, Kontrast und Sättigung durch die Umgebungsverhältnisse beeinflusst. Falls ein Bild mit einem dunkeln Hintergrund gezeigt wird, kann dies eine Anzahl nachteilige Effekte auf die Wahrnehmung dieses Bildes haben:

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)

Das Endresultat wird dann sein, dass das endgültige Bild zu dunkel und überbearbeitet erscheint in Bezug auf Kontrast und Farbsättigung. Um das zu verhindern, macht die Norm “ISO 12646:2008” Empfehlungen über die Bedingungen unter welchen die Farben eines Bildes beurteilt werden soll. Das Modul _Farbbeurteilung _ in der Dunkelkammer schafft einen Rahmen um das Bild, um dem Nutzer zu helfen, die Farben des Bildes mit diesen Empfehlungen zu beurteilen.

Filmstreifen

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

Der Filmstreifen kann genutzt werden, um schnell zwischen Bildern wechseln. Die gezeigten Bilder sind die gleichen, wie jene, die im Leuchttisch angezeigt werden aus der gerade angewählten Sammlung.

Fokus-Peaking

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

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

Activate the module by clicking on the

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

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

Gamutüberprüfung

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

Hervorgehobene Teile des Bildes können auf Gamut-Beschnitt hinweisen.

Click the

are mutually exclusive modes.

Mit Rechtsklick auf das Icon öffnet einen Dialog mit Konfigurations-Parametern – es sind dies die gleichen wie für die Option Softproof.

Du kannst auch in Betracht ziehen das clipping warning zu nutzen, die auch auf Warnungen von Unter- und Überbelichtungen, sowie auch einen Gamut-Check durchführt, ähnlich dem, den das Modul bereithält.

Geotagging

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

Importieren und eintragen der GPX Track Daten von Bildern.

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

Arbeitsablauf Übersicht

Ein GPS-Empfänger berechnet seine jeweilige Position anhand von Sateliteninformationen und zeichnet diese zusammen mit Datum und Uhrzeit in einer GPX-Datei auf. Die Exif-Daten von Bildern enthalten auch einen Zeitstempel, der durch Kameraeinstellungen definiert ist. Das Modul Geotagging nimmt den Zeitstempel eines Bildes und ermittelt die Position in der GPX-Datei zu diesem Zeitpunkt. Die zugehörigen Koordinaten (Längengrad/Breitengrad/Höhe) werden in der Datenbank und der XMP-Begleitdatei des Bildes abgespeichert.

Hilfslinien & Überlagerungen

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

Eine Anzahl von Kompositions-Gestaltungslinien des normalen Gebrauchs können während der Bearbeitung über dein Bild gelagert werden. Diese können allgemein (ständig da) oder lokal (nur bei gewissen Modulen aktiv) angewählt werden.

Andere Dunkelkammer-Funktionen zeichnen auch farbige überlagerte Linien auf das Bild (zum Beispiel gezeichnete Masken). Es gibt auch eine Option, die Farbe dieser Überlagerungen zu ändern (siehe unten).

Globale Hilfslinien

Left-click the

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

Karteneinstellungen

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

Wähle die bevorzugte Karte von diversen Anbietern. Einige werden unterschiedliche Ebenen (Satellitenansicht usw.) zeigen, zwischen denen du wählen kannst

Moduleinstellungen

Quelle der Karte

Wähle hier den Anbieter der Quelle der Karte.

Maximale Anzahl Polygon-Punkte

Das Modul Finde den Ort zeigt keine Polygone an mit mehr Polygon-Punkten, aus Gründen der Performance. Normalerweise hat ein Landes-Polygon zwischen 50'000 und 150'000 Punkte.

OSD anzeigen

Wähle, ob die OSD Kontrollen oben links im Fenster angezeigt werden sollen.

Ausgewählte Bilder

Kreuze diese Box an, um nur die Bilder der gegenwärtig geöffneten Sammlung (jene vom Filmstreifen) in der Hauptansicht. Entferne das Kreuz, um alle Bilder in der gegenwärtigen Bibliothek anzuzeigen, wo diese Bilder mit GPS Daten assoziiert sind. Du kannst mit dieser Option um schalten mit Strg+S.

Max Bilder

Die maximale Anzahl Bilder, die als Miniaturansichten auf der Karte angezeigt werden.

Faktor Gruppengröße

Vergrößert oder verkleinert den Bereich, der die Gruppierung von Bildern auslöst.

Minimale Anzahl Bilder in der Gruppe

Die kleinste Anzahl muss hier platziert werden, um automatisch eine Bildergruppe dafür zu kreieren.

Miniaturbilder-Anzeige

Definiere, welche Informationen auf der Karte angezeigt werden.

Vorschaubilder: Zeige Vorschaubilder an mit einem Zähler.

Anzahl: Zeige die Anzahl der Bilder an (um auf der Karte Platz zu schaffen). Beim Überfahren über die Anzahl der Bilder werden die entsprechenden Miniaturbilder angezeigt. Ein Nur-Anzahl Merker verhält sich gleich wie ein normales Miniaturbild, z.B. für Farbmarkierung, scrollen oder Drag-and-drop usw.

keine: Zeige nichts.

Du kannst durch diese Optionen wechseln mit Shift+S.

Library

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

Wähle die Bilder in der Ansicht Leuchttisch und im Filmstreifen aus, mit Verwenden von Bilder-Merkmalen. So ausgewählte Bilder werden als eine Sammlung bezeichnet.

Importieren von Bilder in Ansel speichert Informationen von diesen (Dateinamen, Pfad, Exif-Daten, Daten aus den XMP Seitenwagendateien etc.) in der Datenbank der Library von Ansel. Eine Sammlung kann definiert werden durch die Anwendung von Auslesekriterien zu diesen Merkmalen, so wird eine Unterkategorie geschaffen, die in der Ansicht Leuchttisch und Filmstreifen angezeigt werden kann.

Lokation finden

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

Suche eine Position auf der Karte, dafür musst du mit dem Internet verbunden sein.

Um dieses Modul zu brauchen, schreibe den Namen einer Ortschaft oder Adresse, dann drücke Enter und eine Liste mit Ergebnissen wird angezeigt. Klicke auf eines der angezeigten Resultate, dann wird die Karte dahin zoomen. Ein Umriss dieses Ortes oder ein Pin, der auf den Ort zeigt, wird angezeigt.

Ein Umriss (Polygon) kann dazu benutzt werden einen Nutzer-Ort zu kreieren. Prüfe die Parameter max polygon points im Modul Einstellungen Karte, um sicher zu sein, dass genügend Punkte vorhanden sind, um ein Polygon anzuzeigen.

Lua Skript Installation

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.

Maskenverwaltung

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

Manage all masks and shapes for the current image.

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

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

Metadaten-Editor

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

Bearbeite Metadaten von ausgewählten Bildern.

Metadaten sind Freiform-Text (Titel, Beschreibung, Urheber, Herausgeber, Rechte usw.), die deine Bilder beschreiben.

Falls mehrere Bilder ausgewählt sind, die für ein bestimmtes Metadatenfeld unterschiedliche Werte haben, dann zeigt das Modul <belasse das unverändert> für dieses Feld – falls du trotzdem versuchst zu ändern, dann werden die Änderungen für dieses Feld nicht angewendet. Wenn du das Feld mit unterschiedlichen Werten mit Rechtsklick anwählst, werden die Werte dargestellt am Ende des Kontextmenüs. Wähle dann einen dieser Werte an, um diesen Wert an alle ausgewählten Bilder angewendet, wenn du die Schaltfläche “anwenden” oder die Enter/Tab Taste drückst.

Modul Reihenfolge

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

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

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

Navigation

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

Zoome und schwenke das geöffnete Bild.

Oben links zeigt die Navigation eine vollständige Vorschau des aktuellen Bildes mit einem Rechteck, das den aktuell sichtbaren Bereich im Hauptfenster anzeigt. Ein Ziehen des Rechtecks im Vorschaubild verschiebt die vergrößerte Ansicht. Der aktuelle Vergrößerungsfaktor wird rechts neben dem Vorschaubild angezeigt. Ein Klick darauf ermöglicht einen schnellen Zugriff auf einige vordefinierte Vergrößerungsstufen.

Die Navigation kann mit einem Kurzbefehl ein- und ausgeblendet werden (standardmäßig Strg+Umschalt+N).

Orte

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

Create areas or locations and organize them as hierarchical tags.

Ein Ort wird, sobald er ausgewählt ist, als Form auf der Karte angezeigt. Anfänglich wird jeder Ort als Quadrat oder Kreis angezeigt was jedoch mittels Anpassung der Höhe und/oder Breite der Form in ein Rechteck oder Ellipse geändert werden kann.

Ein Ort kann auch von einem OpenStreetMap Region Polygon kreiert werden (Stadt/Land). Um das zu erreichen, stelle zuerst sicher, dass der Parameter maximale Anzahl Polygon-Punkte ausreichend groß ist (gewisse Länder-Polygone brauchen mehr als 150'000 Punkte). Dann wähle den gewünschten Ort im Modul Finde den Ort. Wenn die entsprechende Region-Form angezeigt wird, dann wird ein Polygon-Symbol im Schaltfeld “Form” sichtbar. Wähle dieses an, um den neuen Ort zu kreieren.

Pipette

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

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

Die Pipette wird aktiviert mit Anklicken des Pipetten-Symbols. Die Parameter des Moduls bleiben angeschaltet, solange du im Dunkelkammer-Modus bleibst.

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

Snapshots

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

Sichere Bearbeitungs-Snapshots und vergleiche diese mit der gegenwärtigen Bearbeitung.

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

Softproof

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

Betrachte dein Bild mit einem ausgewählten Farbprofil gerendert.

Click the

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

Stile

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

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

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

Eine Liste aller vorhandenen Stile wird im Modul angezeigt. Ein Suchfeld über der Liste dient für die Suche mit Namen oder Beschreibung. Das Modul erlaubt es auch Stile zu bearbeiten oder zu löschen.

Double-click on a style name to apply that style to all selected images. A style may also be applied to all selected images by pressing a shortcut key assigned to it (see preferences > shortcuts) while in the lighttable or darkroom view.

Verlauf

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

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

Dieses Modul zeigt jede Änderung des Status (aktivieren/deaktivieren/ändern von Parametern) aller Dunkelkammer-Module, die für das aktuelle Bild geändert wurden. Wähle einen Punkt im Verlauf an, um zu diesem Punkt der Bearbeitung des Bildes zurückkehren. Umschalt+Klick auf ein Element im Verlauf öffnet dieses Modul im rechten Bedienfeld, ohne die aktuelle Bearbeitung zu verändern.

Vorsicht: Wenn ein Modul im Verlaufsstapel ausgewählt ist und weitere Änderungen am Bild erfolgen, werden alle Bearbeitungen oberhalb der Auswahl verworfen. So kann leicht Entwicklungsarbeit verloren gehen! Mit Strg+Z können solche Änderungen rückgängig gemacht werden.

Verschlagwortung

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

Verwalte Schlagworte (Tags) zu Bildern.

Tags sind eine Art, einem Bild Informationen hinzuzufügen mittels eines Schlagwortverzeichnisses. Du kannst Tags als hierarchischen Baum organisieren, was sich als vorteilhaft erweist, wenn die Anzahl groß wird.

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

Definitionen

Die folgenden Definitionen setzen voraus, dass du einen einzelnen Tag mit Namen “places|France|Nord|Lille” aufgesetzt hast.

Warnung Beschneidung

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

Hervorgehobene Teile des Bildes können Leuchtstärke oder Gamut-Beschnitt anzeigen.

Wenn ein Bild an einem Bildschirm dargestellt wird, dann wird normalerweise jedes Pixel als Summe von drei Zahlen dargestellt, die eine Aussage machen über die Intensität der Primärfarben rot, grün und blau im Darstellungs-Farbraum. Weil dieser normalerweise eng verknüpft ist mit der Hardware mit deren physikalischen Grenzen, so gibt es einen Maximalwert für die [R,G,B] Kanäle, der die maximale Intensität für diesen Farbraum repräsentiert. Ähnlich gibt es auch einen Minimalwert, unter dem die Pixel auf null gesetzt werden. Wenn wir versuchen von einem größeren Farbraum zum Farbraum des Bildschirmes zu konvertieren, dann werden Werte, welche dieses Maximum übersteigen, auf das Maximum zurück beschnitten und Werte unter dem Minimum werden auf null gesetzt. Diesen Prozess nennt man “beschneiden” und er wird zu Informationsverlust führen, oder “falschen” Farben von beschnittenen Pixeln.

Variablen

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

Ansel unterstützt Variablen Substitution in einer Anzahl von Modulen und Voreinstellungen. Zum Beispiel:

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

Benutzereinstellungen und Einstellungen

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.

Jede geänderte Einstellung (z.B. jene die vom Standard abweichen) werden mit einem Aufzählungszeichen angezeigt. Falls du eine Einstellung änderst, die einen Neustart erfordert, wird eine Notiz als Erinnerung eingeblendet, nachdem du den Dialog Ansel-Voreinstellungen verlässt.

Allgemeines

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

Kontrolliere den Gesamtlook und Gesamt-Feeling von Ansel.

Sprache der Oberfläche: Bestimme die Sprache der Benutzeroberfläche. Der Systemstandard ist mit einem * bezeichnet (erfordert einen Neustart)
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”).
System-Schriftgröße der Anzeige: Wähle diese Möglichkeit an, um die Schriftgröße des Systems anders zu definieren. Wenn es nicht angekreuzt ist, kannst du eine Schriftgröße in das Feld darunter eintragen (Standard ein)
Schriftgröße in Punkten: Wenn “brauche System Schriftgröße"nicht angekreuzt ist, kannst du eine Schriftgröße (in Punkten) in das Feld darunter eintragen für Ansel. Die Schriftgröße ändert sich sofort.
GUI Einstellungen und Text DPI: Stelle hier die Auflösung des GUI (Grafische Benutzerschnittstelle), um Kontrollkästchen, Knöpfe Labels etc. anders zu skalieren, verkleinern, um mehr Platz zu schaffen. Setze es auf -1, um die systemdefinierte globale Auflösung zu nutzen. Der Standard ist bei den meisten Systemen 96 DPI (benötigt einen Neustart).

CSS Themes Änderungen

Zusätzlich zur möglichen Auswahl eines voreingestellten Themes, kannst du zusätzlich CSS Anpassungen einbringen, um den Look und das Feeling von Ansel.

Leuchttisch

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

Control functionality in the lighttable view and modules.

Allgemeines

Voreinstellung für Leuchttisch-Module ausblenden: Bei Aktivierung werden nur nutzerdefinierte Voreinstellungen in den Hilfsmodulen angezeigt, d.h. System-Voreinstellungen werden ausgeblendet (standardmaßig ausgeschaltet).
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.

Vorschaubilder

use raw file instead of embedded JPEG from size: When generating thumbnails for images that have not yet been processed in the darkroom, if the thumbnail size is greater than this value, generate it by processing the raw image data. If the thumbnail is below this size, use the JPEG preview image embedded in the raw file. Once an image has been processed in the darkroom, thumbnails will always be generated from raw data (you can revert back to the JPEG preview by discarding history). To render thumbnails with the best quality choose “always”.
high quality processing from size: If the thumbnail size is greater than this value and is being generated from raw data, it will be processed using the full quality rendering path, which is better but slower (default 720p). To render thumbnails with the best quality, choose “always”.
delimiters for size categories: Size categories are used to allow different thumbnail overlays to be shown depending on the thumbnail size. A pipe delimited set of values defines at what image sizes the category changes. The default value of “120|400” means that there will be 3 categories of thumbnail: 0-120px, 120-400px and >400px.

Dunkelkammer

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

Control functionality in the darkroom view and associated modules.

Allgemeines

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).
Zeige den Lade-Bildschirm zwischen den Bildern: Zeige den Lade-Bildschirm beim Navigieren zwischen den Bildern in der Dunkelkammer. Schalte diese Option aus, um nur eine einfache Desktop-Anzeige und belasse das vorherige Bild am Platz, bis das nächste Bild geladen ist. Wisse, dass ein Ausschalten sehr nützlich sein kann, um duplizierte Bilder zu vergleichen, aber, es kann Fälle geben mit langen Ladezeiten (dass du denkst, das nächste Bild sei schon geladen) und du wirst visuelle Artefakte beobachten, während das nächste Bild lädt (Standard ein).

Module

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

Voreinstellung für Dunkelkammer-Module ausblenden

Falls eingeschaltet, werden nur benutzerdefinierte Voreinstellungen in den Voreinstellungsmenüs der Bearbeitungsmodule angezeigt, d.h. System-Voreinstellungen werden unterdrückt (standardmäßig ausgeschaltet).

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.

Bearbeitung

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

Kontrolliere wie Bilder bearbeitet werden.

Bildverarbeitung

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.; Falls das gegebene ICC-Profil LUT-basiert ist oder eine LUT und eine Matrix enthält, dann wird Ansel LittleCMS 2 nutzen, um die Farben zu rendern, unabhängig von den Werten dieses Parameters (Standard ausgeschaltet).

Sicherheit

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

Kontrolliere, ob Warnungs-Hinweise angezeigt werden, bevor gewisse Aktivitäten angegangen werden.

Allgemeines

fragen, bevor Bilder aus der Bibliothek entfernt werden: Immer Nachfragen vor der Entfernung eines Bilds aus der Bibliotheksdatenbank von Ansel, wobei die Bild- und XMP-Dateien immer erhalten bleiben (Standard: eingeschaltet).
Vor dem Löschen von Bildern von der Festplatte: Immer fragen vor ein Bild entfernt wird (Standard ein).
fragen, bevor Verlaufsstapel von Bildern gelöscht werden: Immer fragen, bevor der Verlaufsstapel eines Bildes gelöscht wird (standardmäßig eingeschaltet).
Versuche beim Löschen von Bildern, diese in den Papierkorb verschieben: Anstatt Bilder physisch von der Festplatte zu löschen, diese in den Papierkorb des Systems verschieben (standardmäßig aktiviert).
Fragen bevor Bilder aus dem Filmrollenordner verschoben werden: Immer fragen bevor ein Bild verschoben wird (Standard an).
Fragen bevor ein Bild in eine neue Filmrolle kopiert wird: Immer fragen bevor ein Bild an einen neuen Ort kopiert wird (Standard an).
Fragen vor dem Löschen von leeren Verzeichnissen: immer fragen vor dem Löschen eines leeren Verzeichnisses. Dies kann nach dem Verschieben oder Löschen von Bildern geschehen (Standard aus).
Vor dem Löschen eines Tags fragen: Immer fragen vor ein Tag aus einem Bild entfernt wird (Standard ein).
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.

Andere

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

Der Hintergrund

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

Die Verarbeitung von hochauflösenden Bildern ist eine herausfordernde Aufgabe, die moderne Rechner erfordert. Hinsichtlich Speicherbedarf und Prozessorleistung kann bereits die optimale Bearbeitung eines typischen 15, 20 oder 25 Megapixel Bilds einen Rechner schnell an seine Grenzen bringen.

Die Anforderungen von Ansel sind da keine Ausnahme. Alle Berechnungen werden in 4 x 32-Bit Gleitkommazahlen ausgeführt. Das ist langsamer als die “gewöhnliche” 8- oder 16-Bit Integer-Algebra, aber alle Probleme mit Tonwertabbrüchen oder Informationsverlust werden beseitigt.

Wie OpenCl funktioniert

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

Wie du dir vorstellen kannst, kann die Architektur von Grafikprozessoren deutlich variieren. Es gibt unterschiedliche Hersteller und sogar unterschiedliche Generationen von GPUs des gleichen Herstellers können nicht vergleichbar sein. Gleichzeitig legen die Grafikprozessorhersteller normalerweise nicht alle Hardwaredetails gegenüber der Öffentlichkeit offen. Eine dieser Konsequenzen ist, die Notwendigkeit proprietäre Treiber unter Linux zu benutzen, wenn du deine Grafikkarte voll ausnutzen willst.

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.

Aktivierung von OpenCL in Ansel

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

Das Brauchen von OpenCL in Ansel erfordert es, dass dein Computer mit einer geeigneten Grafikkarte mit den erforderlichen Libraries ausgerüstet ist. Die meisten modernen Grafikkarten von NIVIDIA und AMD kommen mit vollem Support für OpenCL. Der Compiler für OpenCL wird normalerweise als Teil des proprietären Grafik-Treibers und wird als dynamische Library mit Namen libOpenCL.so gebraucht. Diese Library muss in einem Ordner sein, wo diese vom System-Linker deines Systems gefunden werden kann.

OpenCL konfigurieren

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

Die riesige Vielfalt der Systeme und deutliche Unterschiede zwischen OpenCL-Anbietern und Treiberversionen macht es unmöglich einen umfassenden Überblick darüber zu geben, wie man OpenCL konfiguriert. Wir können dir nur ein Beispiel geben, in diesem Fall für den NVIDIA-Treiber 331.89 für Ubuntu 14.04. Wir hoffen, dass dies als eine grundlegende Anleitung dienen kann und dir helfen wird, spezifische Probleme für dein Setup zu lösen.

Der prinzipielle OpenCL-Funktionsablauf sieht so aus:

Ansel > libOpenCL.so > libnvidia-opencl.so.1 > kernel-Treibermodul(e)> GPU

Mögliche Probleme und Lösungen

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

Ansel entdeckt OpenCL-Laufzeitfehler automatisch. Nach einem Fehler wird alles erneut über die CPU berechnet. Das verringert zwar die Verarbeitungsgeschwindigkeit, sollte aber nicht das Endergebnis ändern.

Es gibt unterschiedliche Gründe, warum OpenCL während der Initialisierung fehlschlägt. OpenCL hängt von den Hardware-Anforderungen ab und von gewissen Treibern und Bibliotheken. Zusätzlich müssen alle diese hinsichtlich Hersteller, Modell und Revisionsnummer zusammenpassen. Falls etwas nicht stimmt (z.B. der Grafiktreiber, als Kernel Modul geladen, passt nicht zur Version der libOpenCL.so), wird eine OpenCL-Unterstützung wohl nicht verfügbar sein.

Scheduling-Profil

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).
Sehr schnelle GPU: Mit diesem Scheduling-Profil verarbeitet Ansel das Hauptbildfenster und Vorschaufenster auf dem Grafikprozessor sequentiell. Dies ist die bevorzugte Einstellung für Systeme, bei denen die GPU die CPU leistungsmäßig deutlich übertrifft.
Mehrere GPUs: Diese Einstellung betrifft Systeme mit mehreren Grafikprozessoren, deren Performance sich nicht deutlich voneinander unterscheidet. Immer wenn ein Verarbeitungsjob gestartet wird, benutzt Ansel eine zum jeweiligen Zeitpunkt gerade unbeschäftigte GPU, aber nicht die CPU. Benutzer mit verschiedenen GPUs brauchen eine bessere Kontrolle hinsichtlich der relativen Priorität der GPUs. Sie werden besser mit der Auswahl “Standard” Profil zurechtkommen und dann über den “opencl_device_priority” Konfigurationsparameter (siehe mehrere GPUs) ihr System feineinstellen.

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.

Mehrere Einheiten

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

Die Disposition von OpenCL-Einheiten kann auf den meisten Systemen mit den Einstellungen von “OpenCL scheduling profile” optimiert werden. Wenn aber dein System mit mehr als einer GPU ausgestattet ist, solltest du die entsprechenden Prioritäten der Einheiten manuell setzen. Um das zu tun, musst du das “Standard” Disposition-Profil setzen und die Einstellungen in den Konfigurations-Parametern der “opencl_device_priority” ändern.

Es ist wichtig zu verstehen, wie Ansel die OpenCL-Geräte nutzt. Jede Bearbeitungsfolge für ein Bildes, d.h. die Umwandlung einer Eingabe mit einem Verlaufsstapel in die abschließende Ausgabe, wird in einer Pixelpipe durchgeführt. Es gibt vier verschiedenen Arten von Pixelpipes in Ansel. Ein Typ ist verantwortlich für die Erzeugung der zentralen Großansicht des Bildes, ein weiterer erzeugt das Vorschaubild (in der Navigation). Eine dieser Pixelpipes kann jederzeit laufen, und die Pixelpipes für die Großansicht und das Vorschaubild gleichzeitig. Zusätzlich können gleichzeitig mehrere Pixelpipes Dateiexporte oder Vorschaubilder erzeugen. Falls ein OpenCL-Gerät vorhanden ist, wird Ansel dieses dynamisch einer spezifische Pixelpipe für eine Berechnungn zuweisen und nachher wieder freigeben.

OpenCL funktioniert bei mir immer noch nicht

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

Viele der möglichen Probleme treten nur bei bestimmten Kombinationen dieser Faktoren auf. Wir bitten um Verständnis, dass Ansel-Entwickler nur ein kleiner Teil dieser Varianten zur Verfügung steht und daher möglicherweise ein spezifisches Problem nicht gelöst werden kann. Es ist uns nicht möglich ein Problem zu beheben, das wir nicht reproduzieren können.

Memory und Leistungs-Optimierung

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

Memory Anforderungen

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.

Sichern

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

Datenbank

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”).
Datenbankfragmentierung Schwellwert-Verhältnis: Das Schwellwert-Verhältnis (in Prozent), über der die Datenbank_Unterhalt eingeleitet werden soll (Standard 25), ist aber abhängig von den vorangegangenen Einstellungen.
Datenbankabzug erstellen: Definiert, wie oft Ansel einen Abzug der Datenbank anfertigen soll. Die Optionen sind “nie”, “monatlich”, “wöchentlich”, “täglich” und “beim Beenden” (standardmäßig “wöchentlich”).
Anzahl der aufbewahrten Datenbankabzüge: Legt die Anzahl der aufbewahrten Datenbankabzüge fest. Datenbanksicherungen beim Wechsel von Ansel-Versionen werden nicht mitgezählt. Bei “-1” wird die Anzahl nicht eingeschränkt (Voreinstellung: 10).

XMP

für jedes Bild Begleitdatei schreiben: Die XMP-Dateien stellen, zusätzlich zu den gespeicherten Änderungen in der Datenbank von Ansel, eine redundante Methode dar, Änderungen an einem Bild zu sichern. Diese Option erlaubt wie folgt auszuwählen, wann diese Dateien geschrieben werden:; nie: Schreibe keine XMP-Dateien. Das mag nützliche sein, wenn du mehrere Versionen von Ansel betreibst für Entwicklungs/Test-Zwecke, aber diese wird normalerweise nicht empfohlen

Allgemeines

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

Schnittstellen

Lade die Standard-Kurzbefehle beim Aufstarten: Wenn die Applikation aufgestartet wird, ladet Ansel die Standard-Kurzbefehle, und dann zusätzliche die Benutzer-definierten. Das erlaubt es, die Standard-Kurzbefehle mit einer neuen Aktion zu übersteuern, aber es bewahrt diese vor dem Löschen (der abgewählte Kurzbefehl wird beim nächsten Aufstarten wieder neu geladen). Deaktivieren dieser Einstellung wird ein neues Aufstarten der Standard-Kurzbefehle verhindern – und starte nur die Benutzer-definierten (plus solche, die nicht nachträglich gelöscht oder überschrieben wurden). Das macht das Löschen leichter, es heisst aber auch, dass du nicht von Kurzbefehlen profitierst, die eventuell in zukünftigen Versionen dazu kommen, ohne dass du vorher die Einstellung wieder anschaltest (Standard ein).
Skalenschieber Schrittlänge min/max: Wenn das aktiviert ist, wird die Standard-Schrittlänge beim Ändern der von den minimalen und maximalen Werten für diesesn Schieber abhängen (Standard ein)
Zeige die eingebauten Voreinstellungen als erste: Wähle hier, wie das Menü mit den Voreinstellungen sortiert wird. Wenn diese Option angewählt ist, dann werden eingebaute Voreinstellungen als erste angezeigt (standard ein).
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.

Kurzbefehle mit mehreren Instanzen

Von vielen Bearbeitungsmodulen können mehrere Instanzen erzeugt werden. In einem solchen Szenario ist es nicht immer offensichtlich, auf welche Instanz sich Kurzbefehle auswirken sollen. Die folgenden Optionen bestimmen Regeln, die – der Reihe nach angewandt – entscheiden, auf welche Modulinstanz Kurzbefehle angewendet werden sollen.

Kurzbefehle

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

Voreinstellungen

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.

Vordefinierte, standardmäßig in Ansel enthaltene Einstellungen sind mit einem Schlosssymbol versehen. Deren Eigenschaften können nicht verändert werden.

Benutzerdefinierte Voreinstellungen können aus exportierten .dtpreset-Dateien über die Schaltfläche “Import” am unteren Bildschirmrand geladen werden. Mit der Schaltfläche “Export” können alle benutzerdefinierten Voreinstellungen in einem Verzeichnis gespeichert werden.

Um eine benutzerdefinierte Voreinstellung zu löschen, diese auswählen und die Entf-Taste drücken.

Lua-Optionen

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.

Farbverwaltung

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.

Bildschirm Profil

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 Methode

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

Ansel kann entweder mit seinen eigenen internen Algorithmen oder mit der externen Library LittleCMS2 Farben rendern. Die interne Methode von Ansel ist im Hinblick auf das Ausmaß, schneller als die externe. Die esxterne Option gibt dir die Möglichkeit den Rendering-Vorsatz zu wählen und es mag sein, dass diese in einigen Fällen bessere Resultate ergibt.

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

Rendering Vorsatz

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.

Die Farbräume von Ansel

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

Eingabe-Bilder sind entweder RGB-Dateien (wie JPEGs oder TIFFs) oder Kamera-RAWs. Beide speichern visuelle Informationen als Kombinationen der Primärfarben (z.B. rot, grün und blau) welche zusammen eine Licht-Emission beschreiben, die vom Bildschirm wiedergegeben werden.

Das folgende Bild illustriert dieses Konzept.

Grenzenlose Farben

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

Bildschirme und die meisten Dateiformate können nur RGB-Intensitäten in einem bestimmten Bereich kodieren. Zum Beispiel können 8-Bit-kodierte Bilder nur Werte zwischen 0 und 255 enthalten, Bilder mit 10-Bit zwischen 0 und 1023, und so weiter. Grafikstandards setzen voraus, dass das Maximum dieses Bereiches, unabhängig vom aktuellen Wert, immer die maximale Helligkeit darstellt, die das Anzeigemedium imstande ist zu rendern, abhängig vom aktuellen Standard normalerweise zwischen 100 und 160 Cd/m² (oder nits). Wir nennen das generell “100 % anzeigebezogen”. Der minimale Bereich kodiert als 0, unabhängig von der Bit-Tiefe, wird dann “0 % anzeigebezogen”. 100 % bedeutet reines Weiß, 0 % reines Schwarz.

Mögliche Farbartefakte

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.

Es ist bekannt, dass hochgesättigte blaue Lichtquellen im Bildausschnitt potenzielle Kandidaten für Pixel mit negativen L-Werte sind. Beispielsweise bei Bühnenaufnahmen sollten solche Lichter in Bildern vermieden werden.

Farbdimensionen von Ansel

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

Dieser Abschnitt definiert konzeptionell wie auch quantitativ die wahrnehmbare Eigenschaften von Farben, um kreative und korrigierende Anpassungen an Farben in Ansel zu beschreiben und zu quantifizieren.

Definitionen

Farbeigenschaften, wie “Sättigung”, “Leuchtkraft” oder Helligkeit, sind in den normalen Gebrauch übernommen worden, sie werden aber Großteils falsch verwendet und häufig genutzt, um andere Dinge auszudrücken. In der Farblehre hat jeder dieser Ausdrücke eine genaue Bedeutung.

Es gibt zwei Bezugssysteme, innerhalb derer Farbeigenschaften analysiert und beschrieben werden können:

Command Line Interface

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

Ansel

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

Das Ansel Programm startet Ansel mit dessen GUI und der vollen Funktionalität. Das ist die Standard-Weg Ansel zu nutzen.

Ansel kann mit folgenden Kommando-Linien Parametern gestartet werden:

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

Alle Parameter sind optional. In den meisten Fällen sollte Ansel ohne weitere Parameter gestartet werden, in diesen Fällen nutzt Ansel passende Standards.

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.

Diese Variante öffnet keine Anzeige – sie arbeitet im reinen Konsolen-Modus, ohne ein GUI zu lancieren. Dieser Modus ist speziell geeignet für Server, die Hintergrund-Jobs abarbeiten.

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

Der Nutzer muss einen Eingabe-Dateinamen und einen Ausgabe-Dateinamen eingeben. Alle anderen Parameter sind optional.

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

Das Ansel-cltest Programm überprüft, ob es eine nutzbare OpenCL-Umgebung auf deinem System gibt, die Ansel nutzen kann. Es sendet einige Überprüfungs-Outputs, die äquivalent zum Aufruf von Ansel-d opencl sind und schließt dann.

Ansel-cltest wird ohne Kommandolinien-Parameter aufgerufen.

Ansel-cmstest

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

Das Ansel-cmstest Programm (nur für Linux) überprüft, ob das Farbmamagement deines Computers korrekt konfiguriert wurde und vernünftige Informationen über die installierten Monitor-Profile vorsieht.

Ansel-cmstest wird ohne Kommandolinien Parameter aufgerufen.

Säubere _nicht_existierende_Bilder.sh

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

Finde und entferne Einträge aus der Library Datenbank, die auf Bilder zeigen, die nicht länger im Dateisystem existieren. Du musst Ansel schließen vor du dieses Skript anwendest.

Das Skript kann mit den folgenden Kommando-Zeilen-Parametern aufgerufen werden:

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

Lasse das Skript ohne Optionen laufen, um einen “dry run”, der einen Report der fehlenden Dateien generiert, ohne irgendwelche Änderungen an der Datenbank hinzuzufügen.

Skripten mit Lua

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

Ansel hat eine vielseitige Skript-Sprache, um Funktionalitäten zu fördern.

Lua Skripte können auch Aktionen für Ansel definieren, die im Falle eines Vorkommnisses ausgelöst werden. Ein Beispiel dafür könnte sein ein externes Programm aufzurufen, um zusätzliche Bearbeitungsschritte außerhalb von Ansel anzuwenden.

Lua ist ein unabhängiges Projekt, das 1993 gegründet wurde, und ist eine mächtige, schnelle und leichtgewichtige, einsetzbare Skript-Sprache. Lua wird in vielen Open Source Anwendungen, in kommerziellen Programmen und auch für Spiele-Programmierung gebraucht

Grundsätzliche Prinzipien: luarc Dateien

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

Beim Starten wird Ansel automatisch die Lua Skripte $Ansel/share/Ansel/luarc und $HOME/.config/Ansel/luarc ausführen (in welchen $Ansel das Ansel Installations-Verzeichnis repräsentiert und $HOME dein User-Verzeichnis).

Das ist die einzige Zeit, in denen in Ansel ein Lua Skript von selbst abläuft. Diese Skripte können Aufrufe sein, die Aktionen ausführen in diversen Ansel Fällen. Dieser Aufruf-Mechanismus ist die Hauptmethode um Lua Aktionen auszulösen.

Ein einfaches lua Beispiel

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

Starten wir mit einem einfachen Beispiel, das einen gewissen Code auf deinem Gerät druckt. Kreiere eine Datei mit Namen luarc in den Konfigurations-Ordner von Ansel (normalerweise $HOME/.config/Ansel/) und füge die folgende Linie hinzu:

1print("Hello World !")

Starte Ansel und du wirst den Satz “Hello World !” auf deinem Gerät. Nichts Wahnsinniges, aber es ist ein Start.

An dieser Stelle gibt es im Skript nichts Spezifisches zu Ansel. Wir verwenden einfach die Standardfunktion print, um einen String auszugeben. Das ist schön und gut, aber wir können es noch besser machen. Um auf die Ansel-API zuzugreifen, müssen Sie zuerst require und das zurückgegebene Objekt in einer Variablen speichern. Sobald dies geschehen ist, können Sie auf die Ansel-API als Unterfelder des zurückgegebenen Objekts zugreifen. All dies ist im Lua API Referenzhandbuch von Ansel dokumentiert Lua API.

Markierte Bilder drucken

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

Das erste Beispiel zeigte uns die Grundlagen von Lua und erlaubte uns zu überprüfen, ob alles richtig funktioniert. Lass uns nun etwas Komplizierteres machen. Versuchen wir, eine Liste der Bilder auszudrucken, die mit einem roten Etikett versehen sind. Aber zunächst einmal, was ist ein Bild?

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

Das Ausführen des obigen Codes erzeugt eine Menge Output. Wir werden es uns gleich anschauen, aber zuerst schauen wir uns den Code selbst an.

Einfachen Kurzbefehl hinzufügen

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

Bisher haben alle Skripte irgendwelche Dinge beim Start ausgeführt. Das ist von begrenztem Nutzen und erlaubt es nicht, auf Nutzeraktionen zu reagieren. Um anspruchsvollere Sachen zu tun, benötigen wir Funktionen, die auf ein bestimmtes Ereignis reagieren. Und das üblichste Ereignis ist ein Kurzbefehl.

1Ansel = require "Ansel"
2
3local function hello_shortcut(event, shortcut)
4Ansel.print("Hallo, habe '"..event..
5 "' empfangen mit Parameter '"..shortcut.."'")
6end
7
8Ansel.register_event("shortcut",hello_shortcut,
9 "Kurzbefehl, der seine Parameter druckt")

Nun starte Ansel, gehe zu “Ansel-Voreinstellungen > Kurzbefehle > lua > Kurzbefehl, der seine Parameter druckt”, weise einen Kurzbefehl zu und probiere ihn aus. Eine schöne Meldung sollte auf dem Bildschirm erscheinen.

Bilder mit Lua exportieren

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

Bis jetzt haben wir gelernt Lua dazu zu nutzen, um Ansel an unseren Arbeitsablauf anzupassen. Nun möchten wir schauen, wie wir Lua dazu nutzen, um Bilder einfach an einen Online Service zu exportieren. Wenn du Bilder via die Kommandozeile an einen Bilder-Service hochladen kannst, dann kannst Lua dazu nutzen, um das in die Schnittstelle von Ansel zu integrieren.

In diesem nächsten Beispiel verwenden wir Lua, um über scp zu exportieren. Ein neuer Speicher erscheint in der Benutzeroberfläche von Ansel, welcher Bilder über den Kopiermechanismus von ssh an ein entferntes Ziel exportiert.

Der Bau von Schnittstellen Elementen

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

Unser voriges Beispiel war etwas limitiert. Insbesondere der Gebrauch einer Präferenz für den Export-Pfad war nicht wirklich sehr gut. Das können wir besser mit dem Hinzufügen von Schnittstellenelementen im Export-Dialog.

UI Elemente werden mit der Ansel_new_widget Funktion kreiert. Diese Funktion nimmt einen Typ von Grafikobjekt als Parameter und gibt ein neues Objekt zurück, das mit diesem Grafikobjekt korrespondiert. Du kannst dann verschiedene Felder in dieses Grafikobjekt setzen, um dessen Parameter zu setzen. Dann wirst du dieses Objekt als Parameter zu verschiedenen Funktionen zuweisen und es dem Ansel UI zuteilen. Das folgende einfache Beispiel fügt einen lib der Ansicht Leuchttisch hinzu mit einem einfachen Label:

Skripte teilen

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

Bis jetzt waren alle Lua Codes in luarc. Das war ein guter Weg, um dir ein Skript zu entwickeln, aber weniger praktikabel für eine Weitergabe. Das müssen in einem eigens dafür bestimmten Lua Modul. Um das zu machen, sichern wir den Code in eine separate Datei (scp-storage.lua für diesen Fall):

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

Ansel wird Skripte suchen (den normalen Lua Regeln folgend) in den Standardverzeichnissen plus $CONFIGDIR/lua/*.lua. So kann unser Skript aufgerufen werden, indem man einfach an die Datei anfügt require "scp-storage" in the luarc file. Einige extra Bemerkungen…

Aufruf von Lua vom dbus

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

Es ist möglich einen Lua Befehl an Ansel via dessen DBus-Schnittstelle zu senden. Die Methode org.Ansel.service.Remote.Lua nimmt einen einzigen String Parameter der als Lua Befehl interpretiert wird. Dieser Befehl wird ausgeführt im gegenwärtigen Lua Kontext und sollte entweder null oder einen String zurückgeben. Das Resultat wird zurückgegeben als Resultat der DBus Methode.

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

Arbeiten mit Ansel von einem Lua Skript

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

Warnung: Diese Möglichkeit ist sehr experimentell. Es ist bekannt, dass mehrere Elemente bis jetzt im Library Modus nicht funktionieren. Ein vorsichtiges Testen ist sehr empfohlen.

Die Lua Schnittstelle erlaubt es dir, Ansel von jedem Lua Skript aus zu nutzen. Dadurch wird Ansel als Library geladen und das Meiste der Lua API angeboten (Ansel ist ohne Titelzeile, so dass die Funktionen, die sich auf die Beutzerschnittstelle beziehen, nicht vorhanden sind)

Als Beispiel, das folgende Programm wird eine Liste aller Bilder in deiner Bibliothek ausdrucken:

Lua API

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

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