Налаштування 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

The functionality in Ansel is separated into six different views:

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

Світлий стіл

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

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

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

Lighttable content

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

Undo/redo

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

Більшість змін, внесених на світлому столі, реєструються і можуть бути повернуті до попереднього стану. Сюди входять зміни кольорових позначок, рейтинги, геолокалізація, теги, метадані, орієнтація, копіювання/вставлення історії змін, створення дублікатів зображень або застосування стилю. Зверніть увагу, що можливість скасування/повторення дій необмежена за кількістю кроків в режимі світлого стола, але вона скидається кожного разу, коли ви перемикаєтесь в інший режим.

Натисніть Ctrl+Z, щоб скасувати останню модифікацію і Ctrl+Y, щоб відновити останню скасовану модифікацію (якщо така є).

Digital asset management

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

Sidecar files

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

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

Importing sidecar files generated by other applications

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

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

Local copies

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

Багато користувачів мають величезні колекції зображень, що зберігаються на додаткових жорстких дисках у настільному комп’ютері або на зовнішньому носії інформації (RAID NAS, зовнішні жорсткі диски тощо).

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

Thumbnails

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

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

Thumbnail creation

A thumbnail is created when an image is imported into Ansel for the first time, after an image has been modified in the darkroom, or when revisiting an image whose thumbnail is no longer available.

Star ratings & color labels

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

Оцінки зірками та кольорові позначки допомагають сортувати та класифікувати зображення відповідно до ваших власних критеріїв. Рейтинг зображення та кольорові позначки можуть відображатися на мініатюрах у режимі світлого стола та в модулі стрічки знімків.

Star ratings

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

Image grouping

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

Групування зображень допомагає поліпшити структуру та ясність вашої колекції зображень, коли вони відображаються в режимі світлого стола.

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.

Дубльовані зображення автоматично групуються разом. Подібним чином, якщо ви імпортуєте кілька зображень з одного каталогу, що мають одне й те саме базове ім’я, але різні розширення (наприклад, IMG_1234.CR2 та IMG_1234.JPG), ці зображення автоматично формують групу.

Metadata and tagging

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

Ansel allows you to store additional information about your images to allow them to be more easily searched and grouped. This information is stored in Ansel’s database and XMP sidecar files and can also be included within exported images.

Metadata

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

Tagging

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

Темна кімната

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

Режим темної кімнати – це місце, де ви обробляєте свої зображення. Центральна панель містить зображення, яке наразі редагується.

Zoom

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

Крім того, ви можете масштабувати між 1:1 та “умістити на екрані”, прокручуючи мишу. Прокручуйте, утримуючи клавішу Ctrl, щоб збільшити діапазон масштабування від 2:1 до 1:10.

Darkroom view layout

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

Left panel

Зверху вниз:

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

Right panel

Зверху вниз:

scopes: A graphical depiction of the image’s light levels and colors. This module can be moved to the left-hand panel if desired (see preferences > miscellaneous > position of the scopes module).
processing modules: The modules used to process an image.

The module-order graph is no longer shown as a side-panel module. Use the node-graph button from the darkroom toolbar to open the module order popup and inspect or rearrange the pixelpipe.

The pixelpipe

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

The anatomy of a processing module

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

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

The pixelpipe & module order

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

The ordered sequence of processing modules operating on an input file to generate an output image is known as the “pixelpipe”.

Порядок конвеєра обробки графічно представлений порядком, в якому модулі представлені в інтерфейсі користувача – конвеєр починається з raw-зображення внизу списку модулів і застосовує модулі обробки один за одним, накладаючи шар на шар обробки знизу вгору, поки він не досягне верху списку, де виводить повністю оброблене зображення.

Note: The order in which processing modules are executed exactly matches the order in which the modules appear in Ansel’s user interface. Changing the order of the modules in the user interface changes how your image is processed.

The history stack

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

The history stack stores the entire editing history for a given image, in the order in which those edits were applied. It is saved to Ansel’s library database and the image’s XMP sidecar file and persists between editing sessions.

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

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

Undo and redo

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

While you are editing your image, Ansel records all of the modifications you make to that image. This means that it is possible to undo and redo changes to recover a previous editing state. Note that the undo/redo facility is unlimited in the number of steps while editing an image, but is reset each time the darkroom is switched to a new image.

Masking & blending

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

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

Вихідні дані модуля за бажанням можуть бути оброблені (скомбіновані) з його вхідними даними перед передачею наступному модулю. Цей додатковий етап обробки називається змішування – вхідні та вихідні дані обробляються за допомогою алгоритмів, що називаються операторами змішування або режимами змішування.

Blend modes

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

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

Класичні режими змішування, розроблені для RGB на основі відображення (обмеження 0-100%), неявно визначають точку опори на рівні 50% (сірий) або 100% (білий) в своїх алгоритмах, залежно від режиму змішування. Оскільки обробка на основі сцен не підпадає під ці обмеження, ця точка опори повинна бути чітко визначена користувачем під час виконання операцій змішування в кольоровому просторі “RGB (сцена)”. Додатковий параметр опорна точка змішування буде представлений користувачеві при використанні одного з цих режимів змішування в цьому колірному просторі. Ефект залежить від використовуваного оператора. Наприклад, значення вище точки опори можуть бути освітлені, а значення нижче затемнені, або навпаки.

Masks

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

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

Маску можна розглядати як зображення у градаціях сірого, де кожен піксель має значення від 0 до 1.0 (або від 0% до 100%). Це значення є значенням непрозорості і використовується для визначення того, наскільки модуль впливає на кожен піксель.

The following sections explain how to construct masks in Ansel.

Drawn masks

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

За допомогою функції намальованої маски ви можете створити маску, намалювавши фігури безпосередньо на полотні зображення. Фігури можна використовувати окремо або в поєднанні. Після того, як фігура намальована на зображенні, її можна коригувати, видаляти або використовувати повторно в інших модулях.

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

Parametric masks

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

Функція параметричної маски пропонує чітко вибірковий контроль за тим, як маскуються окремі пікселі. Це робиться шляхом автоматичного генерування проміжної маски змішування з визначених користувачем параметрів. Ці параметри являють собою кольорові координати, а не геометричні координати, що використовуються у намальованих масках.

Для кожного каналу даних модуля (наприклад, Lab, RGB) та кількох віртуальних каналів даних (наприклад, відтінок, насиченість) ви можете побудувати поканальну функцію непрозорості. Залежно від значення кожного пікселя для заданого каналу даних, ця функція обчислює коефіцієнт змішування від 0 до 1 (100%) для цього пікселя.

Combining drawn & parametric masks

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

Намальовані та параметричні маски можуть використовуватися в поєднанні для формування єдиної маски, яка може бути застосована до модуля.

Є два основні елементи, які контролюють, як поєднуються окремі маски: параметр полярність кожної окремої маски (визначається кнопками плюс або мінус) та параметр у списковому полі “поєднувати маски”.

Поле “поєднувати маски” містить наступні опції, що визначають спосіб поєднання намальованих та параметричних масок:

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.

Mask refinement & additional controls

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

Коли параметрична або намальована маска активна, показано кілька додаткових повзунків, які дозволяють масці бути далі уточненою.

поріг деталей: Цей елемент керування дозволяє змінити прозорість маски залежно від кількості деталей на зображенні. Використовуйте цей повзунок, щоб вибрати або ділянки з великою кількістю деталей (позитивні значення), або гладкі ділянки, в яких немає деталей (негативні значення). За замовчуванням (нуль) по суті пропускає уточнення деталей. Це переважно корисно для застосування ефектів різкості та розмиття, які ігнорують нефокусовані (боке) регіони, або для збільшення різкості лише розмитих частин, запобігаючи надмірному підвищення різкості регіонів у фокусі.

Примітка: Дані, що використовуються для уточнення маски деталей, беруться з етапу демозаїкізації в конвеєрі обробки, а не з входу модуля (який використовується для інших критеріїв параметричної маски). Жоден з модулів обробки після демозаїки не вплине на маску деталей, і наразі вона недоступна для зображень, що не є raw.

Raster masks

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

Як було описано в попередніх розділах, кінцевим результатом маски модуля (комбінований ефект будь-яких намальованих та параметричних масок) є растрове зображення у градаціях сірого, що представляє ступінь, до якого ефект модуля повинен застосовуватися до кожного пікселя. Це растрове зображення зберігається внутрішньо для активних модулів і може бути згодом повторно використано іншими модулями в конвеєрі обробки.

Як і у випадку з будь-якою маскою, якщо значення непрозорості для пікселя в растровій масці дорівнює нулю, вхід модуля проходить через модуль без змін. Якщо непрозорість 1.0, модуль має повний ефект. Для кожного значення від 0 до 1.0 ефект модуля застосовується пропорційно в цьому місці.

Processing modules

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

Color equalizer

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

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

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

The user interface is meant to stay perceptually even:

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

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

Photographic grain

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

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

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

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

Drawing

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

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

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

The intended use cases are:

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

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

Final resampling

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

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

Action

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

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

Astrophoto denoise

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

Remove image noise while preserving structure.

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

Оскільки знешумлення є ресурсомістким процесом, це значно уповільнює конвеєр обробки. Подумайте про те, щоб активувати цей модуль якомога пізніше у вашому робочому процесі.

Blurs

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

Симулює фізично точні розмиття в RGB-просторі на основі сцен.

Blur types

Надаються три типи розмиття:

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

Діаграма у верхній частині модуля показує форму оператора розмиття (відомого як функція розсіювання точки ). Модуль перетворить кожну світну точку зі сцени на пляму у формі відображеного оператора розмиття, з розміром плями, визначеним радіусом розмиття.

Censorize

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

Погіршує частини зображення естетично приємно, щоб анонімізувати людей/предмети або приховати частини тіла.

Цензурування працює в лінійному колірному просторі RGB, щоб застосувати фізично точну розмитість за Гаусом і шум яскравості за Гаусом.

Окрім анонімізації, цей модуль також може використовуватися для широкого кола творчих цілей, наприклад:

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.

Примітка: Методи анонімізації, передбачені цим модулем, не є криміналістично безпечними з метою сприяння естетиці. Деякі криміналістичні методи все ще можуть реконструювати цензурований вміст на основі його структури, особливо для простих форм та тексту (наприклад, номерні знаки, нумерація будинків).

Chromatic aberrations

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

Виправляє хроматичні аберації.

На відміну від модуля raw хроматичні аберації, цей модуль не вимагає raw даних як вхідних даних.

Workflow

Для отримання найкращого результату вам рекомендується діяти наступним чином:

Максимально пом’якште хроматичні аберації в модулі корекція оптики за допомогою повзунків поперечних ХА.
Збільште повзунок інтенсивності в цьому модулі, щоб краще побачити його ефект.
Збільшуйте радіус до зникнення хроматичних аберацій. Якщо цього недостатньо, спробуйте включити параметр “дуже велика хроматична аберація”.
Оберіть направляючий канал, який дає найкращий результат з точки зору різкості та артефактів.
Зменште інтенсивність, щоб уникнути надмірного вимивання кольорів.

Для більш складних випадків ви також можете спробувати наступне:

Color balance rgb

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

Просунутий модуль, який вводить інструменти грейдингу кольорів з кінематографії в фотографічний конвеєр робочого процесу на основі сцен.

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

Introduction

Грейдинг кольорів є важливою частиною редагування зображень. Він може допомогти усунути небажані обарвлення, а також може надати креативну кольорову гаму, яка додасть атмосфери вашим зображенням. За часів плівкової фотографії більша частина колірної атмосфери отримувалась за допомогою плівкової емульсії та хімічних проявників, причому деякий час проводився під збільшувачем з кольоровими головками. Це споживало дорогі ресурси і було здебільшого зарезервовано для кіноіндустрії, де роботу виконував колорист.

Color calibration

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

Модуль повнофункціональної корекції колірного простору, регулювання балансу білого та змішування каналів.

Цей простий, але потужний модуль можна використовувати наступними способами:

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

Color look up table

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

A generic color look up table implemented in Lab space.

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

Module controls

color board: The color board grid shows a list of colored patches. The colors of the patches are the source points. The target color of the selected patch is shown as offsets which are controlled by sliders beneath the color board. An outline is drawn around patches that have been altered (where the source and target colors differ).; Клікніть на зразку, щоб вибрати його, або скористайтеся списком або піпеткою кольорів. Вибраний на даний момент зразок позначений білим квадратом, а його номер відображається у полі зі списком нижче.

Color reconstruction

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

Відновлює інформацію про колір у переекспонованих ділянках.

Через природу цифрових сенсорів у надмірно освітлених ділянках відсутня достовірна інформація про колір. Найчастіше вони виглядають нейтрально білими або демонструють певне обарвлення, залежно від того, які інші етапи обробки зображень задіяні. Цей модуль можна використовувати для “лікування” переекспонованих ділянок, замінивши їх кольори на більш підходящі. Модуль діє на пікселі, яскравість яких перевищує визначений користувачем поріг. Кольори заміни беруться із сусідніх пікселів. При виборі кольору враховуються як просторова відстань, так і відстань освітленості (діапазон).

Color zones

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

Вибірково регулює світлість, насиченість та відтінок пікселів на основі їхньої поточної світлості, насиченості та відтінку.

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.

Спочатку потрібно вибрати, чи потрібно регулювати (вибирати) пікселі, виходячи з їх світлості, насиченості або відтінку. Потім ви можете використовувати три криві на відповідних вкладках для регулювання світлості, насиченості та відтінку діапазонів пікселів, вибраних цим методом.

Contrast equalizer

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

Відрегулювати контраст яскравості та кольоровості в області вейвлетів.

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.

Надається ряд пресетів, які мають допомогти вам зрозуміти можливості модуля.

Crop

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

Crop an image using on-screen guides.

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

Щоразу, коли цей модуль знаходиться у фокусі, буде показано повне необрізане зображення з накладеними на нього ручками обрізки та факультативними напрямними лініями.

Demosaic

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

Контролює, як декодуються мозаїчні фільтри raw файлів.

Bayer filters

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

Denoise (profiled)

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

Простий у використанні та високоефективний модуль знешумлення, адаптованого до індивідуальних профілів шуму широкого спектру сенсорів камер.

Одна проблема з багатьма алгоритмами знешумлення полягає в тому, що вони припускають, що дисперсія шуму не залежить від світності сигналу. Профілювавши шумові характеристики сенсора камери за різних значень ISO, можна оцінити дисперсію при різній освітленості, а алгоритм знешумлення можна відкоригувати для більш рівномірного згладжування шуму.

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.

Diffuse or sharpen

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

Дифузія – це сімейство фізичних процесів, за допомогою яких частинки рухаються й поширюються поступово з часом від джерела, що їх породжує. При обробці зображень дифузія переважно відбувається в двох місцях:

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

В обох випадках дифузія робить зображення менш різким за рахунок “витікання” частинок і згладжування локальних відмінностей.

Модуль дифузія / різкість використовує узагальнену фізичну модель для опису кількох видів дифузії і може використовуватися про роботі зі зображеннями для моделювання або обернення процесів дифузії.

Dithering

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

This module eliminates some of the banding artifacts that can result when Ansel’s internal 32-bit floating point data is transferred into discrete 8-bit or 16-bit integer output format for display or export.

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

Exposure

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

Збільшує або зменшує загальну яскравість зображення.

Цей модуль має два режими роботи:

вручну: Встановити експозицію, рівень чорного та поріг кліппінгу вручну
automatic (RAW images only): Use an analysis of the image’s histogram to automatically set the exposure. Ansel automatically selects the exposure compensation that is required to shift the selected percentile to the selected target level (see definitions below). This mode is particularly useful for automatically altering a large number of images to have the same exposure. A typical use case of automatic mode is deflickering of time-lapse photographs.

Module controls

режим: Вибирає режим роботи (автоматичний/вручну).
компенсувати експозицію камери (ручний режим): Автоматичне видалення зміщення експозиції камери (взятого з даних Exif зображення).
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.
поріг кліппінгу (ручний режим): Визначає, який процент яскравих значень слід відсікати при обчисленні експозиції та корекції рівня чорного. Використовуйте піпетку кольорів для вибірки частини зображення, яка буде використана для цього обчислення.
процентиль (автоматичний режим): Визначає місце в гістограмі, яке використовуватиметься для автоматичної корекції експозиції. 50% процентиля позначає позицію в гістограмі, де 50% значень пікселів вище, а 50% значень пікселів нижче цієї експозиції.
цільовий рівень (автоматичний режим): Визначає цільовий рівень для автоматичної корекції експозиції (EV) щодо точки білого камери.
корекція рівня чорного (ручний та автоматичний режими): Регулює точку рівня чорного, щоб зняти негативні значення RGB.

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

Filmic rgb

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

Відображення тонального діапазону зображення відтворенням тонової і кольорової реакції класичної плівки.

Цей модуль можна використовувати або для розширення, або для стискання динамічного діапазону сцени відповідно до динамічного діапазону дисплея. Він захищає кольори та контраст у середніх тонах, відновлює тіні та стискає найсвітліші тони та темні тіні. Найсвітліші тони потребуватимуть особливої обережності, коли потрібно зберегти деталі (наприклад, хмари).

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 .

Framing

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

Generate a frame around the image.

Рамка складається з облямівки (визначеного користувачем кольору) та лінії рамки всередині цієї облямівки (другого визначеного користувачем кольору). Для управління геометрією та кольором рамки доступні різні опції.

Module controls

розмір облямівки: Розмір облямівки в процентах від повного зображення.
співвідношення сторін: Співвідношення сторін остаточного виходу модуля (тобто основного зображення плюс обрамлення)
orientation: The orientation of the frame (portrait/landscape). Select ‘auto’ for Ansel to choose the most reasonable orientation based on the underlying image.
горизонтальне/вертикальне положення: Виберіть із набору заздалегідь визначених співвідношень, щоб контролювати, де основне зображення буде розташоване на горизонтальній/вертикальній осі. Ви також можете клікнути правою кнопкою миші на повзунку та ввести власне співвідношення як “х/у”.
розмір лінії рамки: Процент розміру лінії рамки відносно розміру облямівки на її найменшій частині.
зміщення лінії рамки: Положення лінії рамки відносно основного зображення. Виберіть 0% для лінії рамки, що торкається зображення. Виберіть 100% для лінії рамки, що торкається зовнішньої межі.
колір облямівки / колір лінії рамки: Пара кольорових селекторів, що дозволяють визначати кольори облямівки та лінії рамки. Натискання на кольорове поле відкриє діалогове вікно вибору кольорів, яке пропонує вибір часто використовуваних кольорів або дозволяє визначити колір у колірному просторі RGB. Ви також можете активувати піпетку кольору, щоб взяти колір із зображення.
show guides: Tick the box to show guide overlays whenever the module is activated. Click the icon on the right to control the properties of the guides. See guides & overlays for details.

Graduated density

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

Імітує фільтр із градуйованою щільністю, щоб поступово коригувати експозицію та колір.

На екрані відображається лінія, що дозволяє змінювати положення та обертання градієнта за допомогою миші.

Відомо, що цей модуль провокує появу артефактів бандингу за певних умов. Вам слід розглянути можливість активації модуля дизеринг для усунення цих проблем.

Module controls

щільність: Встановлює щільність фільтра (EV). Низьке значення недоекспонує слабко, тоді як велике створює сильний фільтр.
жорсткість: Прогресивність градієнта. Низьке значення створює плавний перехід, тоді як високе значення робить перехід більш різким.
обертання: Обертання фільтра. Негативні значення обертають за годинниковою стрілкою. Обертання також можна встановити, перетягуючи кінець градієнтної лінії за допомогою миші.
відтінок: Виберіть відтінок, щоб додати обарвлення до градієнта.
насиченість: Насиченість обарвлення, яке додається до градієнта (за замовчуванням нейтральне обарвлення, тобто 0)

Grain

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

Імітує зерно аналогової фотоплівки. Зерно обробляється на L-каналі кольорового простору Lab.

Module controls

зернистість: Розмір зерна, масштабований для імітації числа ISO.
інтенсивність: Інтенсивність ефекту.

Haze removal

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

Автоматично зменшує вплив пилу та серпанку в атмосфері. Цей модуль також може використовуватися в більш загальному плані, для посилення кольору, особливо в низькоконтрастних областях зображення.

Серпанок поглинає світло від об’єктів сцени, але він також є джерелом розсіяного фонового світла. Модуль видалення серпанку спочатку оцінює для кожної області зображення кількість серпанку на сцені. Потім він видаляє дифузне фонове світло відповідно до його локальної сили і відновлює оригінальне світло об’єкта.

Встановлення обох елементів управління модулем на максимальні значення максимізує кількість видалення серпанку, але також, імовірно, призведе до деяких артефактів. Видалення атмосферного світла повністю може зробити зображення плоским і призвести до неприродного вигляду. Оптимальні значення, як правило, нижче одиниці і, скоріше, залежать від зображення, але це також питання особистих естетичних уподобань.

Highlight reconstruction

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

Спроба відновити кольорову інформацію для пікселів, які відсікаються в одному або декількох каналах RGB.

Якщо ці пікселі залишити частково обрізаними, це може призвести до появи нереалістичних кольорів на зображенні. Наприклад, пікселі з обрізаними зеленим та синім каналами будуть виглядати червоними.

Доступні три способи реконструкції:

обрізати переекспоноване: Затискає всі пікселі до рівня білого (тобто відсікає інші кольорові канали). Цей метод є найбільш корисним у випадках, коли відсічені тони трапляються в природно ненасичених об’єктах (наприклад, хмарах).
відновлення в LCh: Аналізує кожен піксель щонайменше з одним обрізаним каналом і пробує виправити відсічений піксель (у кольоровому просторі LCh), використовуючи значення інших (3 для Баєра або 8 для X-Trans) сусідніх пікселів. Реконструйовані світлі тони все одно будуть монохромними, але яскравішими та з більшою деталізацією, ніж із “обрізати переекспоноване”. Цей метод працює досить добре з висококонтрастною базовою кривою, яка робить світлі тони ненасиченими. Як і у випадку з обрізати переекспоноване, цей метод є хорошим варіантом для природно ненасичених об’єктів.
відновлення кольору: Використовує алгоритм, який передає інформацію про колір із невідсіченого оточення у відсічені світлі місця. Цей метод дуже добре працює на ділянках з однорідними кольорами і особливо корисний на тонах шкіри з плавно затухаючими відблисками. Зверніть увагу, що цей метод може створювати лабіринтоподібні артефакти на яскравих ділянках за висококонтрастними контурами, наприклад тонкими структурами перед переекспонованим тлом.
керовані лапласіани: Використовує алгоритм (узятий з модуля дифузія / різкість) для реплікації деталей із дійсних каналів у обрізані канали та для поширення колірних градієнтів із дійсних навколишніх областей у обрізані області. Це повільний і обчислювально-інтенсивний метод, розроблений для максимальної плавності та “безшовного” змішування реконструйованих областей з сусідніми, і призначений в першу чергу для реконструкції інтенсивно освітлених ділянок і дзеркальних відблисків. Цей режим доступний лише для сенсорів Bayer.

** Примітка:** При використанні реконструкції, що входить до модуля filmic rgb, може бути корисним уникати використання цього модуля в режимі обрізати переекспоноване (щоб filmic rgb мав більше інформації для роботи).

Hot pixels

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

Automatically detect and eliminate hot pixels.

Дефектні пікселі - це пікселі, які не змогли правильно записати рівень освітленості. Виявлені дефектні пікселі замінюються середнім показником їх сусідів.

Module controls

поріг: Наскільки сильно значення пікселя має відхилятися від значення сусідів, щоб розглядати його як дефектний піксель.
інтенсивність: Інтенсивність змішування дефектних пікселів з оточуючими.
виявляти за 3 сусідніми: Розширює розпізнавання дефектних пікселів - розглядає піксель як дефектний, якщо мінімально лише три (замість чотирьох) сусідніх пікселів відхиляються більше ніж пороговий рівень.
позначити виправлені пікселі: Візуально позначає виправлені пікселі на зображенні та показує кількість дефектних пікселів, які були виправлені.

Input color profile

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

Define how Ansel will interpret the colors of the image.

Цей модуль бере колірний простір, що використовується джерелом зображення (наприклад, камерою, сканером), і перетворює кодування пікселів у стандартизований робочий колірний простір. Це означає, що наступні модулі в конвеєрі не повинні турбуватися про особливості пристрою введення, а можуть працювати з загальним робочим колірним простором та перетворювати в/із нього.

Якщо зображення було захоплено в raw файл, модуль вхідного кольорового профілю, як правило, застосовує стандартну або покращену кольорову матрицю, специфічну для цієї моделі камери, яка буде використана для відображення кольорів в колірний простір робочого профілю. Якщо інформація про кольоровий простір вбудована у зображення, модуль вхідний ICC профіль використовуватиме цю інформацію при відображенні кольорів на кольоровий простір робочого профілю. Користувач також може явно вказати колірний простір для вхідного зображення і навіть може надати власний колірний профіль ICC, спеціально створений для пристрою введення.

Lens correction

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

Автоматично коригує (та імітує) дисторсію оптики, поперечні хроматичні аберації (ХА) та віньєтування.

Цей модуль ідентифікує комбінацію камера/об’єктив за даними Exif зображення та використовує зовнішню бібліотеку lensfun для отримання параметрів корекції.

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

Liquify

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

Переміщує пікселі, застосовуючи довільні спотворення до частин зображення, використовуючи точки, лінії та криві.

Nodes

Кожен інструмент модуля “пластика” базується на вузлах. Точка складається з одного вузла, а лінія або крива складається з послідовності пов’язаних вузлів, що визначають контур.

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

Local contrast

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

Посилити локальний контраст зображення.

Це досягається за допомогою або локального фільтра Лапласа (за замовчуванням), або ненормалізованого білатерального фільтра. Обидва режими працюють виключно на каналі L простору Lab. Локальний фільтр Лапласа розроблений таким чином, щоб бути надійним проти небажаних ефектів ореолу та градієнтних розворотів на контурах.

Module controls

режим: Вибір між локальним фільтром Лапласа та білатеральною сіткою. Наступні розділи визначають засоби керування, доступні для кожного з цих режимів.

Bilateral grid

зернистість: Визначення грубості деталей, що підлягають регулюванню.
контраст: Контролює, наскільки сильно алгоритм розрізняє рівні яскравості. Збільште цей параметр для більш контрастного вигляду.
деталізація: Додавання або видалення деталізації. Більш високі значення збільшують локальний контраст.

Local laplacian

Щоб зрозуміти параметри локального фільтра Лапласа, можна думати про це як про застосування кривої до зображення, подібної до наступного графіка:

Lut 3D

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

Трансформує значення RGB за допомогою файлу 3D LUT.

3D LUT - це тривимірна таблиця, що використовується для перетворення заданого значення RGB в інше значення RGB. Зазвичай використовується для імітації плівки та грейдингу кольорів.

Цей модуль приймає файли .cube, .3dl, .png (haldclut) і .gmz. Нестиснуті дані 3D LUT не зберігаються в базі даних або файлі XMP, а натомість зберігається шлях до файлу 3D LUT усередині кореневої папки 3D LUT. Тому важливо правильно створити резервну копію папки 3D LUT – немає сенсу ділитися зображенням спільно з файлом XMP, якщо одержувач не має того самого файлу 3D LUT у власній папці 3D LUT.

Negadoctor

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

Process scanned film negatives.

Ви можете отримати негативне зображення за допомогою плівкового сканера, або сфотографувавши його на тлі білого світла (наприклад, світлого стола чи монітора комп’ютера) або позакамерного спалаху.

Preparation

Якщо негативне зображення було отримано за допомогою цифрової камери, то для отримання точних кольорів на кінцевому зображенні потрібно врахувати наступні моменти:

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

Orientation

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

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

Модуль увімкнено за замовчуванням, і орієнтація (обертання) автоматично встановлюється на основі даних Exif зображення.

Module controls

трансформації: Двічі клікніть на мітці, щоб скинути до стану за замовчуванням
rotate counter-clockwise: Rotate the image 90 degrees counter-clockwise
rotate clockwise: Rotate the image 90 degrees clockwise
flip horizontally: Flip the image (mirror) horizontally
flip vertically: Flip the image (mirror) vertically
show guides: Tick the box to show guide overlays whenever the module is activated. Click the icon on the right to control the properties of the guides. See guides & overlays for details.

Output color profile

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

Керує вихідним профілем для експорту та методу візуалізації, який використовуватиметься при відображенні між кольоровими просторами.

Ansel comes with pre-defined profiles sRGB, Adobe RGB, XYZ and linear RGB. You can provide additional profiles by placing them in $Ansel/share/Ansel/color/out and $HOME/.config/Ansel/color/out (where $Ansel is the Ansel installation directory and $HOME is your home directory).

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

Module controls

output intent: The rendering intent for output/export. Rendering intent can only be selected when using LittleCMS2 to apply the output color profile (this can be changed in preferences > processing). If Ansel’s internal rendering routines are used, this option is hidden. For more details see rendering intent.
профіль експорту: Профіль, що використовується для візуалізації кольорів для виводу/експорту. Дані профілю будуть вбудовані у вихідний файл (якщо підтримується форматом файлу), що дозволяє іншим програмам правильно інтерпретувати його кольори. Оскільки не всі програми знають про кольорові профілі, загальною рекомендацією є дотримуватися sRGB, хіба що ви знаєте, що робите, і маєте вагому причину робити інакше.

Raw black/white point

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

Define camera-specific black and white points.

Цей модуль активується автоматично для всіх raw зображень. Налаштування за замовчуванням застосовуються до всіх підтримуваних камер. Зміни до цих налаштувань зазвичай не потрібні.

Module controls

рівень чорного 0-3: Рівень чорного конкретної камери, чотири пікселі у шаблоні RGGB Баєра. Пікселі, значення яких нижчі за цей рівень, не вважаються такими, що містять дійсні дані.
точка білого: Рівень білого конкретної камери. Усі пікселі зі значеннями вище цього, швидше за все, будуть відсічені, і вони будуть оброблятися відповідно в модулі відновлення переекспонованих ділянок.
корекція плоского поля: Використовуйте корекцію плоского поля, щоб компенсувати затінення об’єктива. Це поле відображається лише для файлів raw з підтримкою такої корекції й автоматично використовуватиме будь-яку карту GainMap, вбудовану в raw. Ви можете вимкнути цю корекцію, якщо хочете.

Raw chromatic aberrations

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

Виправляє хроматичні аберації raw зображень.

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

Raw denoise

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

Perform denoising on raw image data before it is demosaiced.

Цей модуль перенесено з dcraw .

Module controls

поріг шуму: Поріг виявлення шуму. Більш високі значення призводять до сильнішого видалення шуму та більшої втрати деталізації зображення.
coarse/fine curves: The noise of an image is usually a combination of fine-grained and coarse-grained noise. These curves allow the image to be denoised more or less depending on the coarseness of the visible noise. The left of the curve will act on very coarse grain noise, while the right of the curve will act on very fine grain noise.; Raising the curve will result in more smoothing, while lowering it will result in less smoothing. As an example, you can preserve very fine-grained noise by pulling down the rightmost point of the curve to the minimum value.

Retouch

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

Видаляє небажані елементи зображення шляхом клонування, лікування, розмиття та заповнення за допомогою намальованих фігур.

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 curve

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

Класичний інструмент цифрової фотографії для зміни тонів зображення за допомогою кривих.

Активуйте піпетку кольорів ліворуч, щоб відобразити вибрані значення на графіку (Ctrl+клік або клік правою кнопкою, щоб використовувати піпетку в режимі області). Числові (Lab) значення входу та виходу (див. нижче) у вибраній точці або області відображаються у верхньому лівому куті віджета.

Друга піпетка кольору праворуч може бути використана для автоматичного створення нових вузлів на основі області вибірки. Ctrl+клік +перетягування – змінити створені вузли, щоб мати позитивну криву для вибраної області; Shift+клік+перетягування –створити негативну криву.

Rgb levels

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

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

Інструмент рівнів rgb показує гістограму зображення та три смуги. Перетягніть смуги, щоб змінити точки чорного, середньо-сірого та білого за світлістю (у режимі “RGB, пов’язані канали”) або незалежно для кожного з каналів R, G та B (у режимі “RGB, незалежні канали”).

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

Rotate and perspective

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

Автоматична корекція для збіжних ліній, форми спотворення перспективи. Основний механізм натхненний програмою ShiftN Маркуса Гебеля. Цей модуль також дозволяє регулювати обертання зображення.

Перспективні спотворення є природним ефектом при проектуванні тривимірної сцени на двовимірну площину і призводять до того, що об’єкти, що перебувають поблизу глядача, здаються більшими, ніж об’єкти, розташовані далі. Збіжні лінії є особливим випадком спотворення перспективи, який часто можна побачити на архітектурних фотографіях – паралельні лінії, сфотографовані під кутом, перетворюються на збіжні лінії, які сходяться в певній точці всередині або поза рамкою зображення.

Rotate pixels

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

Сенсори деяких камер (наприклад, Fujifilm FinePix S2Pro, F700 та E550) мають діагонально орієнтований шаблон Баєра замість звичного ортогонального розташування.

Без корекції це призведе до нахиленого зображення з чорними кутами. Цей модуль застосовує необхідне обертання.

Ansel detects images that need correction using their Exif data and automatically activates this module where required. For other images the module always remains disabled.

Модуль не має елементів керування.

Scale pixels

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

Деякі камери (наприклад, Nikon D1X) мають прямокутні замість звичайних квадратних сенсорних комірок. Без корекції це призведе до спотворення зображень. Цей модуль застосовує необхідне масштабування.

Ansel detects images that need correction using their Exif data and automatically activates this module where required. For other images the module always remains disabled.

Модуль не має елементів керування.

Sharpen

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

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

Цей модуль працює, збільшуючи контрастність навколо контурів і тим самим посилюючи враження різкості зображення. Цей модуль застосовується до L-каналу в кольоровому просторі Lab.

Примітка: Алгоритм USM, який використовується в цьому модулі, виконує розмиття в кольоровому просторі Lab, що може викликати небажані ефекти і більше не рекомендується. Натомість використовуйте пресети, запропоновані модулем еквалайзер контрасту для усунення розмиття або модулем локальний контраст для загальної різкості.

Surface blur

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

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

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

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

Tone equalizer

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

Освітлення (“dodging”) та випалювання (“burning”) зі збереженням локального контрасту.

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.

На наступній схемі описано, як працює еквалайзер тонів:

Unbreak input profile

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

Додає корекційну криву до даних зображення. Це потрібно, якщо ви вибрали певні вхідні профілі в модулі вхідний ICC профіль.

If you decide to use an ICC profile from the camera manufacturer in the input color profile module, a correction curve frequently needs to be pre-applied to image data to prevent the final output from looking too dark. This extra processing is not required if you use Ansel’s standard or enhanced color matrices.

Vignetting

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

Apply a vignetting effect to the image.

Віньєтування – це модифікація яскравості та насиченості на краях зображення у визначеній формі. Багато з перелічених нижче параметрів також можна змінити за допомогою графічного елемента керування, який накладається на зображення, коли модуль має фокус, показуючи форму та ступінь ефекту.

Примітка: Відомо, що цей модуль провокує появу артефактів бандингу за певних умов. Вам слід розглянути можливість активації модуля дизеринг, щоб зменшити ці артефакти.

Watermark

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

Візуалізує векторне накладання на ваше зображення. Водяні знаки є стандартними документами SVG і можуть бути розроблені за допомогою Inkscape .

Ви також можете використовувати растрові зображення (PNG).

The SVG processor in Ansel can also substitute strings within an SVG document, allowing image-dependent information to be included in the watermark.

User-designed watermarks should be placed into the directory $HOME/.config/Ansel/watermarks. Once in place, use the reload button update the list of available watermarks.

White balance

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

Налаштуйте баланс білого на зображенні, змінюючи температуру та відтінок, визначивши коефіцієнт для кожного RGB каналу або вибравши зі списку заздалегідь визначених налаштувань балансу білого.

Налаштування за замовчуванням для цього модуля походять від балансу білого в камері, що зберігається в даних Exif зображення.

Баланс білого не призначений бути “креативним” модулем – його основна мета полягає в технічній корекції балансу білого зображення, забезпечуючи, щоб нейтральні кольорові об’єкти на сцені відображалися нейтральними кольорами на зображенні. Для креативних кольорових операцій, як правило, краще використовувати інші модулі, такі як калібрування кольору або колірний баланс rgb.

Мапа

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.

Слайд-шоу

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

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

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

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

Usage

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

Режим слайд-шоу все ще перебуває на початковій стадії розробки з лише базовим набором функцій.

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

Hint: To take full advantage of your screen size, put Ansel into fullscreen mode by pressing F11 and hide the border-controls by pressing the B key.

Друк

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.

Цей модуль підтримує профіль ICC принтера, який є швидше обов’язковим, якщо ви хочете отримати високоякісний друк, близький до зображення, що відображається на екрані.

Print view layout

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

У центральній області відображається макет зображення на папері (біла область). Деякі сірі межі можуть відображатися навколо зображення, щоб представляти область для друку (сторінка мінус межі), не заповнену зображенням.

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

Overlays

Коли курсор миші наведено на обмежувальну рамку зображення, його ширина та висота відображаються зверху та зліва відповідно. Поля між обмежувальною рамкою та краєм сторінки позначаються поруч із пунктирними лініями, що виходять з кожного боку обмежувальної рамки. Усі вимірювання відображаються в одиницях, вибраних у модулі налаштувань друку.

GUI toolboxes

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

Notes

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

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

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

Clipping warning

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

Виділення ділянок зображення, які можуть мати відсікання по яскравості або охопленню кольорів.

Коли зображення надсилається на пристрій відображення, кожен піксель зазвичай представляється у вигляді набору з 3 чисел, що представляють інтенсивність червоного, зеленого та синього основних кольорів у вихідному колірному просторі. Оскільки вихідний колірний простір, як правило, тісно пов’язаний з апаратним забезпеченням, яке має фізичні обмеження, існує максимально допустиме значення для каналів [R, G, B], що представляє максимальну доступну інтенсивність для цього колірного простору. Так само існує мінімальне значення, нижче якого значення пікселів будуть відображені в нуль. Коли ми намагаємося виконати перетворення з більшого кольорового простору на кінцевий вихідний колірний простір, будь-які значення, що перевищують цей максимум, будуть зафіксовані на максимальному значенні, а будь-які значення нижче мінімального – на нулі. Цей процес називається “відсіканням” (або кліппінгом) і це призведе до втрати деталей або до “неправильних” кольорів для будь-яких пікселів із відсіченими каналами.

Color assessment

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

Оцініть кольори та яскравість зображення, використовуючи рекомендовані умови перегляду ISO 12646:2008.

При обробці зображення на сприйняття яскравості, контрасту та насиченості впливають умови навколишнього середовища. Якщо зображення відображається на темному тлі, це може мати ряд негативних впливів на наше сприйняття цього зображення:

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)

Кінцевим результатом є те, що фінальне зображення може виявитися занадто темним і надмірно обробленим з точки зору контрасту та насиченості кольорів. Щоб уникнути цього, стандарт “ISO 12646:2008” містить деякі рекомендації щодо умов, за яких слід оцінювати кольори зображення. Модуль оцінка кольорів у темній кімнаті розміщує рамку навколо зображення, щоб допомогти користувачеві краще оцінити кольори на зображенні відповідно до цих рекомендацій.

Display metadata

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

Display information embedded within an image’s Exif data as well as a number of additional data fields defined by Ansel.

Під час наведення курсора миші на мініатюри зображень відображувані дані автоматично оновлюються, щоб відображати інформацію про зображення, яке в даний час знаходиться під курсором миші.

Якщо вибрано кілька зображень, і фокус не на одному зображенні, модуль відображає лише інформацію, однакову для всіх зображень. Якщо будь-які поля відрізняються між зображеннями, натомість відображається текст “<різні значення>”.

Duplicate manager

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

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

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

Export

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

Експортувати вибрані зображення.

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

Module controls

Storage options

ціль

Тип місця для зберігання вибраних зображень. Реалізовано низку різних бек-ендів, включаючи файл на диску, шаблон книги LaTeX та різні веб-альбоми. Залежно від обраної цілі, вас попросять надати додаткову інформацію, таку як імена файлів або ім’я облікового запису та пароль.

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.

селектор вихідних каталогів

Кнопка біля поля шаблону імені файлу відкриває діалогове вікно для вибору батьківського каталогу для експорту.

при конфлікті

Виберіть, що робити, якщо створене ім’я файлу конфліктує з існуючим файлом при експортуванні:

створити унікальне ім’я файлу: Автоматично вибирати унікальне нове ім’я файлу, додаючи ціле число до імені конфліктного файлу.

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.

пропустити: Не експортувати зображення там, де файл призначення з таким іменем вже існує.

Format options

формат: Виберіть формат файлу для експортованого зображення. Додаткові опції з’являться (нижче) залежно від обраного формату.
якість: Якість експортованого файлу. Більші значення призводять до збільшення розміру файлу. Якість за замовчуванням (95) є хорошим налаштуванням для експорту дуже високої якості (наприклад, для архівування або друку). Якщо вам потрібен гарний компроміс між розміром та якістю (наприклад, для відображення або завантаження зображень в Інтернеті), натомість слід розглянути значення “90”.
бітова глибина: Кількість бітів, що використовується для кожного кольорового каналу. Більше бітів означає менше постеризації / кольорового бандингу.
стиснення: Тип стиснення, який слід використовувати.
рівень стиснення: Для форматів експорту, де можна вказати стиснення, рівень стиснення визначає, скільки стиснення застосовувати. Чим вищий рівень, тим більше даних буде стиснуто за рахунок більшої кількості циклів процесора.
ч/б зображення: Для формату експорту TIFF можна зберегти монохромне зображення. Цей параметр визначає, чи кодує отриманий файл відтінки сірого як окремі канали RGB, чи як один канал у градаціях сірого. Останній варіант призведе до менших файлів.

Global options

установити розмір

Виберіть спосіб вимірювання максимального розміру експортованого зображення

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

в сантиметрах (для друку): Введіть максимальну ширину та висоту в сантиметрах і визначте dpi зображення. Еквівалентний розмір у пікселях буде автоматично розрахований.

в дюймах (для друку): Введіть максимальну ширину та висоту в дюймах та визначте dpi зображення. Еквівалентний розмір у пікселях буде автоматично розрахований.

за масштабом (для файлу): Введіть множник, щоб вказати, на скільки експортоване зображення має масштабуватися порівняно із вхідним зображенням. Наприклад, введення значення 0.5 призведе до вихідного зображення із половиною ширини та висоти (у пікселях) вихідного зображення.

dpi

Якщо вибрано одиниці сантиметри або дюйми, встановіть dpi вихідного зображення. Це значення dpi також зберігатиметься в даних Exif експортованого зображення. Буде автоматично встановлено на 300, якщо вибрано розмір “в пікселях” або “за масштабом”.

max size

Set the maximum width and height of the exported image(s) in pixels, cm or inches (depending on the selected unit) – zero means that no constraint will be set on that dimension. Exported images will be constrained so as not to exceed either of these values, while retaining the correct aspect ratio. Set both to zero to export with the original dimensions (after cropping). If the entered values exceed the original dimensions Ansel will either export with the original dimensions or upscale the image, depending on the “allow upscaling” parameter.

дозволити збільшення

Встановіть значення “так”, щоб виконати крок збільшення, якщо визначені користувачем максимальна ширина та висота перевищують початкові розміри зображення. Якщо встановлено значення “ні”, розміри експортованого зображення не перевищуватимуть розміри початкового зображення (після обрізки).

високоякісна передискретизація

Встановіть для цього значення “так”, щоб виконати високоякісну передискретизацію зображення. Зображення буде оброблено з повною роздільною здатністю і зменшено лише в самому кінці. Це іноді може призвести до покращення якості, але завжди буде повільнішим.

зберігати маски

Зберігати маски як шари в експортованому зображенні. Працює лише для деяких форматів зображень (наразі TIFF і 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.

Примітка: Зображення, які вибрані, але наразі приховані (оскільки вони є членами згорнутої групи), не експортуватимуться.

Filmstrip

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

Стрічку знімків можна використовувати для швидкого перемикання між зображеннями. Показані зображення ті ж, що відображаються у режимі світлого стола, і визначаються вибраною на даний момент колекцією.

Find location

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

Пошук місця на мапі. Щоб користуватися цією функцією, ви повинні бути під’єднані до Інтернету.

Щоб скористатися цим модулем, введіть назву місця або адресу, натисніть Enter і з’явиться список результатів. Клікніть на елемент у списку, і мапа збільшиться до цього місця. Відобразиться контур, що охоплює це місце, або шпилька, що вказує на це місце.

Контур (багатокутник) можна використовувати для створення користувацького місця. Перевірте параметр макс. точок полігонів у модулі налаштування мапи, щоб забезпечити достатню кількість точок для відображення багатокутника.

Focus peaking

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

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

Activate the module by clicking on the

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

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

Gamut check

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

Виділити ділянки зображення, на яких може бути відсікання охоплення.

Click the

are mutually exclusive modes.

Клікніть правою кнопкою миші на значку, щоб відкрити діалогове вікно з параметрами конфігурації – вони ті ж самі, що й для опції екранна кольоропроба.

Ви також можете розглянути можливість використання попередження про кліппінг, яке також надає попередження про недостатню та надмірну експозицію, а також перевірку охоплення, подібну до тієї, яку пропонує цей модуль.

Geotagging

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

Імпорт та застосування даних треків GPX до вибраних зображень.

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.

Workflow overview

Приймач GPS обчислює своє поточне положення на основі інформації, яку він отримує від супутників, і записує його у файл GPX разом із поточною датою та часом. Дані Exif зображень також містять позначку часу, визначену налаштуваннями камери. Модуль геотегування бере часову позначку зображення, шукає позицію у файлі GPX на той момент і зберігає відповідні координати (широта/довгота/висота) у своїй базі даних та файлі XMP зображення.

Global color picker

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

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

Піпетка кольору активується натисканням на значок піпетки кольору. Параметри модуля залишатимуться чинними, поки ви не вийдете з режиму темної кімнати.

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

Guides & overlays

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

Під час редагування на зображення можна накласти ряд часто використовуваних композиційних напрямних. Їх можна ввімкнути як глобально (завжди), так і локально (коли певні модулі активні).

Інші функції темної кімнати також малюють кольорові лінії накладень на зображенні (наприклад, намальовані маски). Також є можливість змінити колір цих накладень (див. нижче).

Global guides

Left-click the

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

History stack

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

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

Цей модуль перелічує кожну зміну стану (активація/деактивація/переміщення/зміна параметрів) для всіх модулів обробки, які були змінені для поточного зображення. Виберіть точку в стеку, щоб повернутися до цієї точки в історії обробки зображення. Утримуючи Shift, клікніть елемент у стеку історії, щоб розгорнути цей модуль на правій панелі модулів, не змінюючи поточне редагування.

Увага: Якщо ви виберете модуль у стеку історії, а потім внесете подальші зміни в зображення, усі редагування над поточно вибраним кроком будуть відкинуті. Таким чином легко втратити роботу над зображенням! Зазвичай ви можете використовувати Ctrl+Z, щоб скасувати такі зміни.

Library

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

Фільтрує зображення, що відображаються в режимі перегляду на світлому столі та на стрічці знімків, використовуючи атрибути зображення. Цей набір відфільтрованих зображень відомий як колекція.

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

Locations

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

Create areas or locations and organize them as hierarchical tags.

Вибране місце відображається на мапі як фігура. Спочатку кожне місце представляється у вигляді квадрата або кола і може бути змінено на прямокутник або еліпс регулюванням ширини та/або висоти фігури.

Місце також можна створити з багатокутника регіону (міста/країни) OpenStreetMap. Для цього спочатку переконайтеся, що параметр макс. точок полігонів є достатньо великим (деякі багатокутники країн використовують більше 150 000 точок). Потім виберіть потрібне місце в модулі пошук на мапі. Коли відображається відповідний полігон регіону, символ керування “полігон” стає доступним в елементі керування форми (див. нижче). Виберіть його, щоб створити нове місце.

Lua scripts installer

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

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

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

Map settings

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

Виберіть бажані картографічні дані від різних постачальників. Деякі з них забезпечать додаткові шари (супутниковий вигляд тощо), які ви можете перемикати.

Module controls

джерело мапи

Виберіть постачальника, який надаватиме інформацію мапи.

макс. точок полігонів

Модуль пошук на мапі не відображає багатокутників із більшою кількістю точок з міркувань продуктивності. Зазвичай багатокутник країни має від 50 000 до 150 000 точок.

OSD

Виберіть, чи відображати елементи керування OSD у верхньому лівому куті центральної панелі.

фільтрувати

Встановіть цей прапорець, щоб відображати лише зображення з поточної колекції (ті, що показані в стрічці знімків) у центральній панелі. Зніміть прапорець, щоб відображати всі зображення в поточній бібліотеці, де ці зображення мають пов’язані дані GPS. Ви також можете перемкнути цю опцію, натиснувши Ctrl+S.

максимально

Максимальна кількість мініатюр для відображення на карті.

розмір групи

Збільшення або зменшення розміру області, в якій зображення групуються.

мінімально в групі

Мінімальна кількість зображень, які потрібно розмістити в одному положенні для автоматичного створення групи зображень для них.

показ мініатюр

Визначте, яку інформацію відображати на мапі

мініатюри: Відображати мініатюри зображень разом із лічильником.

кількість зображень: Просто показувати кількість зображень (щоб звільнити місце на карті). Наведіть курсор на кількість зображень, щоб відобразити відповідні мініатюри. Маркер лише з лічильником поводиться так само, як звичайна мініатюра зображення, з точки зору кольорового кодування, прокрутки, перетягування тощо.

немає: Нічого не показувати.

Ви також можете перебирати ці опції, натискаючи Shift+S.

Mask manager

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.

Metadata editor

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

Редагує метадані вибраних зображень.

Метадані – це текст у вільному форматі (заголовок, опис, автор, видавець, права тощо), що описує ваші зображення.

Якщо вибрано кілька зображень із різними значеннями для певного поля метаданих, модуль відображає <залишити незмінним> для цього поля – якщо ви вирішите застосувати зміни, ці поля не будуть змінені. Якщо клікнути правою кнопкою миші на полі, ці різні значення будуть перераховані в кінці контекстного меню. Виберіть одне зі значень у меню, щоб застосувати це значення до всіх вибраних зображень – зміна буде збережена після натискання кнопки “застосувати” або клавіші Enter/Tab.

Navigation

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

Масштабування та панорамування поточного зображення.

У верхній лівій частині темної кімнати навігаційна панель відображає повний попередній перегляд поточного зображення із прямокутником, що показує область, яку в даний час видно на центральній панелі. Перетягуйте цей прямокутник, щоб панорамувати збільшений вигляд. Поточний масштаб відображається праворуч від зображення попереднього перегляду. Клікніть на це значення для швидкого доступу до деяких загальних рівнів масштабування.

Навігаційну панель можна вмикати/вимикати за допомогою комбінації клавіш (за замовчуванням Ctrl+Shift+N).

Print settings

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

Manage settings for the print view and initiate printing.

Module controls

Printer

принтер: Виберіть один із встановлених принтерів.
носій: Тип носія, завантаженого в принтер (звичайний папір, глянцевий фотопапір тощо).
профіль: ICC-профіль принтера для завантаженого паперу. Це профіль, специфічний для принтера та паперу. Цей профіль – остання трансформація колірного простору, застосована до зображення, метою якої є створення високоякісного друку.
intent: The print rendering intent (“perceptual”, “relative colorimetric”, “saturation” or “absolute colorimetric”). See rendering intent for more details.
компенсація точки чорного: Чи потрібно регулювати точку чорного вихідного профілю, яка часто світліша за вхідний. Це має бути “увімкнено”, коли для метод встановлено значення “відносний колориметричний”.

Image layout

ширина/висота зображення: Це інформаційне поле відображає фактичну ширину та висоту зображення (вказані з вибраними одиницями) на папері.
масштабний коефіцієнт: У цьому інформаційному полі відображається коефіцієнт масштабу, необхідний, щоб умістити зображення на папері. Якщо це значення менше 1, зображення зменшується, інакше воно збільшується. Це важливий фактор для перевірки – занадто велике значення (збільшення) може призвести до низької якості друку. Також відображається відповідна щільність dpi (крапок на дюйм).
вирівнювання: Виберіть вирівнювання зображення на його області.
кнопка нової області зображення: Створює нову область зображення. Перетягніть на полотно, щоб розмістити її. Якщо активовано опцію прив’язки до сітки, область можна легко вирівняти за лініями сітки. Зображення можна помістити в цю область, перетягнувши його зі стрічки знімків та опустивши на нову область.
кнопка видалення області зображення: Видаляє поточну виділену область зображення з композиції.
кнопка очищення розкладки: Видаляє всі області зображення, залишивши полотно порожнім.

Наступні чотири поля представляють положення поточної вибраної області на сторінці – верхній/лівий кут на першому рядку та ширину/висоту області на другому рядку.

Raw overexposed warning

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

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

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

Click on the

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

Scopes

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

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

Наведіть курсор миші на панель, щоб показати кнопки, які дозволяють регулювати відображення. Крайня ліва кнопка перемикає режим між класичною гістограмою, гістограмою “форми сигналу”, гістограмою RGB-параду та вектороскопом. Решта кнопок керують тим, як малюється графік для поточної гістограми.

Snapshots

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

Зберігає миттєві знімки стану обробки зображення та надає можливість порівнювати з поточним редагуванням.

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.

Soft proof

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

Перегляд зображення, відтвореного за допомогою вибраного кольорового профілю.

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.

Styles

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

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

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

У модулі відображається список усіх доступних стилів. Поле пошуку над списком дозволяє знайти стиль за іменем або описом. Цей модуль також дозволяє редагувати та видаляти стилі.

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.

Tagging

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

Керує тегами, прикріпленими до зображень.

Теги забезпечують спосіб додавання інформації до зображень за допомогою словника ключових слів. Ви також можете керувати тегами як ієрархічним деревом, що може бути корисним, коли їх кількість стає великою.

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

Definitions

В наступних визначеннях припускається, що ви встановили єдиний тег з назвою “places|France|Nord|Lille”.

Variables

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

Ansel supports variable substitution in a number of modules and preference settings. For example:

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

Налаштування

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.

Будь-які змінені налаштування (тобто ті, що відрізняються від стану за замовчуванням) виділяються маркером біля них. Якщо ви зміните налаштування, яке потребує перезапуску для набуття чинності, після виходу з діалогового вікна налаштувань з’явиться повідомлення з нагадуванням про це.

General

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

Control the overall look and feel of Ansel.

мова інтерфейсу: Встановити мову інтерфейсу користувача. Мова операційної системи позначена зірочкою * (потребує перезапуску)
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”).
використовувати системний розмір шрифту: Виберіть цю опцію, щоб використовувати розмір шрифту, визначений вашою системою. Якщо не встановити прапорець, ви можете ввести власний розмір шрифту у полі нижче (за замовчуванням увімкнено).
font size in points: If the “use system font size” option is switched off, enter a font size (in points) for Ansel to use. The font size will be changed immediately.
DPI елементів інтерфейсу: Налаштуйте глобальну роздільну здатність графічного інтерфейсу для масштабування елементів керування, кнопок, міток тощо. Збільште для збільшеного графічного інтерфейсу, зменште, щоб вмістити більше вмісту у вікні. Встановіть значення -1, щоб використовувати визначену системою глобальну роздільну здатність. За замовчуванням у більшості систем 96 DPI. (потрібен перезапуск)

Модифікації теми за допомогою CSS

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

Світлий стіл

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

Control functionality in the lighttable view and modules.

General

приховати вбудовані пресети сервісних модулів: Якщо увімкнено, в меню пресетів для сервісних модулів відображатимуться лише задані користувачем пресети – вбудовані пресети будуть приховані (за замовчуванням вимкнено).
show image time with milliseconds: Choose whether to include milliseconds when displaying time values (default off). If set, milliseconds are shown in the image information module and can also be used in the geotagging module.

Thumbnails

розмір мініатюри, від якого використовується raw файл замість вбудованого JPEG: Під час створення мініатюр для зображень, які ще не були оброблені в темній кімнаті, якщо розмір мініатюри перевищує це значення, генерувати її, обробляючи raw дані зображення. Якщо мініатюра менше цього розміру, використовувати зображення попереднього перегляду JPEG, вбудоване в raw файл. Після обробки зображення в темній кімнаті мініатюри завжди будуть генеруватися з raw даних (ви можете повернутися до JPEG попереднього перегляду, відкинувши історію). Щоб відображати мініатюри найкращої якості, виберіть “завжди”.
мінімальний розмір для високоякісної обробки мініатюр: Якщо розмір мініатюри перевищує це значення і вона генерується з raw даних, її буде оброблено з використанням повноякісного шляху візуалізації, що краще, але повільніше (за замовчуванням 720p). Щоб зробити мініатюри найкращої якості, виберіть “завжди”.
роздільники для категорій розміру: Категорії розміру використовуються, щоб дозволити відображати різні інформаційні накладання залежно від розміру мініатюри. Набір значень, розділених символом |, визначає, при яких розмірах зображення змінюється категорія. Значення за замовчуванням “120|400” означає, що буде 3 категорії мініатюр: 0-120px, 120-400px та > 400px.

Темна кімната

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

Control functionality in the darkroom view and associated modules.

General

pen pressure control for brush masks: Controls how the pressure reading of a graphics tablet impacts newly generated drawn mask brush strokes. You can control the brush width, hardness and opacity. “Absolute” control means that the pressure reading directly defines the attribute with a value between 0% and 100%. “Relative” means that the pressure reading adjusts the attribute between zero and the pre-defined default value (default off).
smoothing of brush strokes: Sets the level for smoothing of drawn mask brush strokes. Stronger smoothing leads to fewer nodes and easier editing at the expense of lower accuracy.
scroll down to increase mask parameters: By default, scrolling your mouse up increases the value of the relevant shape parameters in drawn masks. Set this preference to reverse the behavior (default off).
pattern for the image information line: Set the information to be displayed in the image information line, at the right of the top-most toolbar. You can use any variables in the variables section as well as $(NL) for a new line. You can also include formatting (bold, italic, colors etc).
border around image in darkroom mode: Display the center image in darkroom mode with an outside border of the given number of pixels (default 20).
показувати екран завантаження між зображеннями: Показувати сірий екран завантаження під час навігації між зображеннями в темній кімнаті. Вимкніть цю опцію, щоб просто показувати просте тимчасове повідомлення та залишити попереднє зображення на місці, доки не завантажиться наступне. Зверніть увагу, що вимкнення цієї опції може бути дуже корисним для швидкого порівняння дублікатів зображень, однак, можуть виникнути проблеми з тривалим часом завантаження (що змушує думати, що наступне зображення вже завантажено) і ви можете спостерігати візуальні артефакти під час завантаження наступного зображення (за замовчуванням увімкнено).

Modules

display of individual color channels

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

приховати вбудовані пресети модулів обробки

Якщо увімкнено, в меню пресетів для модулів обробки відображатимуться лише задані користувачем пресети – вбудовані пресети будуть приховані (за замовчуванням вимкнено).

show the guides widget in modules UI

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

show right-side buttons in processing module headers

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

always: always show all buttons

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

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

auto: hide the buttons when the panel is narrow

fade: fade out all buttons when the panel narrows

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

smooth: fade out all buttons in one header simultaneously

glide: gradually hide individual buttons as needed

(default always)

prompt for name on addition of new instance

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

Other views

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

Enable optional views:

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

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

Processing

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

Налаштування параметрів обробки зображення.

Image processing

always use LittleCMS 2 to apply output color profile: If this option is activated, Ansel will use the LittleCMS 2 system library to apply the output color profile instead of its own internal routines. This is significantly slower than the default but might give more accurate results in some cases.; If the given ICC is LUT-based or contains both a LUT and a matrix, Ansel will use LittleCMS 2 to render the colors regardless of this parameter’s value (default off).

Security

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

Керує тим, чи відображатимуться попереджувальні повідомлення перед виконанням певних дій.

General

ask before removing images from the library: Always ask before removing image information from Ansel’s library database, where the xmp file is retained (default on).
запитувати перед видаленням зображень з диска: Завжди запитувати перед видаленням файлу зображення (за замовчуванням увімкнено).
запитувати перед видаленням історії змін: Завжди запитувати перед тим, як відкинути стек історії змін зображення (за замовчуванням увімкнено).
намагатись використовувати сміттєвий кошик при видаленні зображень: Замість фізичного видалення зображень з диска, спробувати помістити їх у сміттєвий кошик системи (за замовчуванням увімкнено).
запитувати перед переміщенням зображень з каталогу плівки: Завжди запитувати перед переміщенням файлу зображення (увімкнено за замовчуванням).
запитувати перед копіюванням зображень до нового каталогу плівки: Завжди запитувати перед копіюванням файлу зображення в нове місце (за замовчуванням увімкнено).
запитувати перед видаленням порожніх каталогів: Завжди запитувати, перш ніж видаляти порожню папку. Це може статися після переміщення або видалення зображень (за замовчуванням вимкнено).
запитувати перед видаленням тегу: Завжди запитувати перед видаленням тегу із зображення (за замовчуванням увімкнено).
ask before deleting a style: Always ask before deleting a style (default on).
ask before deleting a preset: Always ask before deleting a preset (default on).
ask before exporting in overwrite mode: Always ask before exporting images in overwrite mode.

Other

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

Performance

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

Opencl

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

The background

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

Обробка зображень із високою роздільною здатністю – це складне завдання, яке вимагає сучасного комп’ютера. Що стосується як пам’яті, так і потужності центрального процесора, отримання найкращих результатів із типового 15, 20 або 25-мегапіксельного зображення може швидко довести ваш комп’ютер до межі можливостей.

Ansel’s requirements are no exception. All calculations are performed on 4 x 32bit floating point numbers. This is slower than “ordinary” 8 or 16 bit integer algebra, but eliminates all problems of tonal breaks or loss of information.

How opencl works

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

Як ви можете собі уявити, апаратна архітектура графічних процесорів може суттєво відрізнятися. Існують різні виробники, і навіть різні покоління графічних процесорів від одного виробника можуть бути не порівнянними. У той же час виробники графічних процесорів зазвичай не розголошують всіх подробиць про апаратну частину своєї продукції для громадськості. Одним із наслідків цього є необхідність використовувати пропрієтарні драйвери під Linux, якщо ви хочете повною мірою скористатися своєю графічною картою.

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

Activating opencl in Ansel

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

Using OpenCL in Ansel requires that your PC is equipped with a suitable graphics card and that it has the required libraries in place. Most modern graphics cards from NVIDIA and AMD come with full OpenCL support. The OpenCL compiler is normally shipped as part of the proprietary graphics driver and is used as a dynamic library called libOpenCL.so. This library must be in a folder where it can be found by your system’s dynamic linker.

Setting up opencl

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

Величезна різноманітність систем та помітні відмінності між постачальниками OpenCL та версіями драйверів унеможливлює повний огляд того, як налаштувати OpenCL. Ми можемо навести лише приклад, у цьому випадку для драйвера NVIDIA версії 331.89 на Ubuntu 14.04. Ми сподіваємось, що це послужить базовим введенням і допоможе вам вирішити будь-які проблеми, що стосуються вашого налаштування.

Принцип потоку функцій OpenCL такий:

Ansel > libOpenCL.so > libnvidia-opencl.so.1 > kernel driver module(s) > GPU

Ansel dynamically loads libOpenCL.so – a system library that must be accessible to the system’s dynamic loader (ld.so).

Possible problems & solutions

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

Ansel will detect OpenCL run-time errors automatically. On detecting an error, it will then reprocess everything on the CPU. While this will slow down processing it should not affect the end result.

Можуть бути різні причини того, чому OpenCL може зазнати невдачі на етапі ініціалізації. OpenCL залежить від вимог до обладнання та від наявності певних драйверів та бібліотек. На додаток, все це повинно відповідати виробнику, моделі та номеру редакції. Якщо щось не підходить (наприклад, ваш графічний драйвер – завантажений як модуль ядра – не відповідає версії вашого libOpenCL.so), підтримка OpenCL, швидше за все, буде недоступна.

Scheduling profile

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

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

default: If an OpenCL-capable GPU is found Ansel uses it for processing the center image view while the navigation preview window is processed on the CPU in parallel. This is the preferred setting for systems with a reasonably fast CPU and a moderately fast GPU. The exact allocation of devices to the various pixelpipe types can be finetuned with the “opencl_device_priority” configuration parameter (see multiple devices).
very fast GPU: With this scheduling profile Ansel processes the center image view and the preview window on the GPU sequentially. This is the preferred setting for systems with a GPU that strongly outperforms the CPU.
multiple GPUs: This setting addresses systems with multiple GPUs whose relative performance does not differ significantly. Whenever a processing job is started Ansel uses any currently idle GPU but not the CPU. Users of systems with a variety of GPUs will need better control on their relative priority. They would be better off selecting the “default” profile and fine-tuning their system with the “opencl_device_priority” configuration parameter (see multiple devices).

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

Multiple devices

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

Планування роботи пристроїв OpenCL можна оптимізувати в більшості систем, використовуючи налаштування “профіль планування OpenCL”. Однак, якщо ваша система оснащена декількома графічними процесорами, можливо, ви захочете встановити відносний пріоритет пристроїв вручну. Для цього вам потрібно вибрати профіль планування “за замовчуванням” та змінити вподобання в параметрі конфігурації “opencl_device_priority”.

It is important to understand how Ansel uses OpenCL devices. Each processing sequence of an image – to convert an input to the final output using a history stack – is run in a pixelpipe. There are four different types of pixelpipe in Ansel. One type is responsible for processing the center image view (or full view) in darkroom mode, another pixelpipe processes the preview image (navigation window). There can be one of each of these two pixelpipes running at any time, with the full and preview pixelpipes running in parallel. In addition there can be multiple parallel pixelpipes performing file exports as well as multiple parallel pixelpipes generating thumbnails. If an OpenCL device is available, Ansel dynamically allocates it to one specific pixelpipe for one run and releases it afterwards.

Opencl still does not run for me

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

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

Many of the potential problems will only appear with very specific combinations of these factors. As the Ansel developers only have access to a small fraction of these variations, please understand that we might not be able to fix your specific problem. There is not much we can do if we are unable to reproduce your issue.

Memory & performance tuning

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

Memory requirements

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

Storage

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

Database

перевірка на необхідність обслуговування бази даних: Вказує, коли darktable має перевіряти фрагментацію бази даних та виконувати технічне обслуговування. Варіанти: “ніколи”, “при запуску”, “при закритті” та “в обох випадках”. Кожен із них також доступний з додатковою опцією “(не запитувати)” для автоматичного виконання перевірок без запиту (за замовчуванням “при закритті”).
поріг коефіцієнта фрагментації бази даних: Коефіцієнт фрагментації (в процентах), вище якого слід проводити обслуговування бази даних (за умови вибору, зробленого у варіанті вище) (за замовчуванням 25).
create database snapshot: Specifies how often Ansel should create database snapshots. Options are “never”, “once a month”, “once a week”, “once a day” and “on close” (default “once a week”)
how many snapshots to keep: Number of snapshots to keep after creating a new snapshot, not counting database backups taken when moving between Ansel versions. Enter “-1” to store an unlimited number of snapshots. (default 10)

Xmp

write sidecar file for each image

XMP files provide a redundant method of saving the changes that you have made to an image, in addition to the changes saved to Ansel’s database. This option allows you to choose when to write these files. Choose from:

never: Don’t write XMP files. This can be useful if you are running multiple version of Ansel for development/testing purposes but is not normally recommended

on import: An XMP file will be written as soon as you add an image to Ansel’s library and will be subsequently updated each time you edit it

after edit: An XMP file will be written the first time you perform an edit on an image and will be updated on each subsequent edit. Importing will not generate an XMP file by default.

It’s strongly recommended that you choose either “on import” or “after edit”. XMP files provide a useful fail-safe so that you don’t lose data if your database becomes corrupted. Backing up your raw file plus the accompanying XMP file will allow you to fully restore your work at a later date by re-importing your edit history back into Ansel (default “on import”).

Miscellaneous

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

Interface

load default shortcuts at startup: When launching the application, Ansel loads default shortcuts first, and then loads user-defined shortcuts on top. This allows default shortcuts to be overridden with a new action but prevents them from being deleted (since the deleted shortcut will be automatically reloaded on the next restart). Deactivate this preference to stop loading default shortcuts on startup – only load the user-defined ones (including any defaults that you have not subsequently deleted or overridden). This makes deletion easier but also means that you will not benefit from new shortcuts added in future versions without first re-enabling this preference (default on).
масштабувати крок повзунка відповідно до мін/макс: Коли активовано, розмір кроку за замовчуванням під час зміни повзунків залежатиме від поточних мінімальних/максимальних значень для цього повзунка (за замовчуванням увімкнено).
показувати вбудовані пресети на початку: Виберіть спосіб сортування меню пресетів. Якщо цю опцію ввімкнено, спочатку відображаються вбудовані пресети. Якщо опцію вимкнено, спочатку відображаються пресети користувача (за замовчуванням увімкнено).
always show panels’ scrollbars: Defines whether the panel scrollbars should be always visible or activated only depending on the panel content (default on). (needs a restart)
position of the scopes module: Choose whether to show the scopes module in the left or right panel (default right). (needs a restart)
method to use for getting the display profile: This option allows the user to force Ansel to use a specific method to obtain the current display profile for color management. In the default setting “all”, Ansel will choose to query the X display server’s xatom or the colord system service. You can set this option to “xatom” or “colord” to enforce a specific method if the two methods give different results. You can run the Ansel-cmstest binary to examine your color management subsystem.

Shortcuts with multiple instances

Можна створити кілька екземплярів багатьох модулів обробки. У цьому випадку не завжди очевидно, яким екземпляром слід керувати за допомогою клавіатурних прискорювачів. Наступні опції керують правилами, які застосовуються (по порядку) для того, щоб вирішити, до яких екземплярів модуля слід застосовувати клавіатурні прискорювачі.

Shortcuts

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

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

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

Assigning key shortcuts

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

Deleting default shortcuts

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

Presets

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

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

Pre-defined presets (those that are included by default within Ansel) are shown with a lock symbol. Their properties cannot be changed.

Визначені користувачем пресети можна імпортувати з експортованих файлів .dtpreset, використовуючи кнопку" імпортувати" внизу екрана. Ви можете експортувати всі визначені користувачем пресети в один каталог за допомогою кнопки “експортувати”.

Lua options

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

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

Color management

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

Ansel employs a fully color managed workflow:

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

Display profile

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

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

Rendering method

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

Ansel can render colors either with its own internal algorithms or by using the external library LittleCMS2. Ansel’s internal method is, by an order of magnitude, faster than the external one. The external option gives you a choice of the rendering intent and might offer a slightly higher accuracy in some cases.

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

Rendering intent

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

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

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

Ansel's color spaces

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

Вхідні зображення – це файли RGB (наприклад, JPEG або TIFF) або raw дані з камери. Обидва типи зберігають візуальну інформацію як комбінацію основних кольорів (наприклад, червоного, зеленого та синього), які разом описують випромінювання світла, яке слід відтворити дисплеєм.

Наступне зображення ілюструє цю концепцію.

Unbounded colors

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

Екрани та більшість форматів файлів зображень можуть кодувати лише інтенсивність RGB, обмежену певним діапазоном. Наприклад, зображення, закодовані у 8 бітів, можуть містити лише значення від 0 до 255, зображення на 10 бітів від 0 до 1023 і так далі… Графічні стандарти постулюють, що максимум цього діапазону, незалежно від його фактичного значення, завжди буде представляти максимальну яскравість, яку здатний надати дисплей, як правило, від 100 до 160 кд/м² (або ніт) залежно від фактичного стандарту. Ми зазвичай називаємо цей максимум “100% на основі відображення”. Мінімум діапазону, кодований 0, незалежно від використовуваної бітової глибини, стає тоді “0% на основі відображення”. 100% кодує чисто білий, 0% кодує чисто чорний.

Possible color artifacts

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

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

Було виявлено, що високонасичені джерела синього світла в кадрі зображення, ймовірно, є кандидатами на пікселі з від’ємними значеннями L. Якщо ви займаєтеся сценічною фотографією, вам слід звернути пильну увагу на такі джерела світла, що з’являються на зображеннях.

Ansel's color dimensions

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

This section defines the perceptual properties of color, both conceptually and quantitatively, in order to characterize and quantify the creative and corrective adjustments made to color in Ansel.

Definitions

Такі властивості кольору, як “насиченість”, “яскравість” або “світлість”, стали загальновживаними, але в основному використовуються неправильно і часто використовуються для позначення різних речей. У кольорознавстві кожен із цих термінів має точне значення.

Є дві схеми, в яких властивості кольору можна аналізувати та описувати:

Command Line Interface

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

Ansel

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

The Ansel binary starts Ansel with its GUI and full functionality. This is the standard way to use Ansel.

Ansel can called with the following command line parameters:

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

All parameters are optional. In most cases Ansel should be started without any additional parameters, in which case Ansel uses suitable defaults.

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.

Цей варіант не відкриває жодного вікна – він працює в чисто консольному режимі без запуску графічного інтерфейсу. Цей режим особливо корисний для серверів, що виконують фонові завдання.

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

Користувач повинен вказати ім’я вхідного файлу та ім’я вихідного файлу. Усі інші параметри необов’язкові.

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

The Ansel-cltest binary checks if there is a usable OpenCL environment on your system that Ansel can use. It emits some debug output that is equivalent to calling Ansel -d opencl and then terminates.

Ansel-cltest is called without command line parameters.

Ansel-cmstest

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

The Ansel-cmstest binary (Linux only) investigates whether the color management subsystem of your computer is correctly configured and displays some useful information about the installed monitor profile(s).

Ansel-cmstest is called without command line parameters.

Purge_non_existing_images.sh

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

Find and remove entries from the library database referencing images that no longer exist in the filesystem. You must close Ansel before running this script.

Цей сценарій можна викликати з такими параметрами командного рядка:

1purge_non_existing_images.sh [-c|--configdir <шлях>]
2 [-l|--library <шлях>]
3 [-p|--purge]

Запустіть сценарій без опцій для виконання “сухого запуску”, який формує звіт про відсутні файли без внесення жодних змін до бази даних.

Сценарії за допомогою Lua

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

Ansel comes with a versatile scripting interface language for functionality enhancement.

Lua scripts can be used to define actions for Ansel to perform when an event is triggered. One example might be calling an external application during file export in order to apply additional processing steps outside of Ansel.

Lua – це незалежний проект, заснований у 1993 році, що забезпечує потужну, швидку, легку та вбудовувану мову сценаріїв. Lua широко використовується багатьма програмами з відкритим кодом, у комерційних програмах та для програмування ігор.

основні принципи: файли luarc

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

At startup, Ansel will automatically run the Lua scripts $Ansel/share/Ansel/luarc and $HOME/.config/Ansel/luarc (where $Ansel represents the Ansel installation directory and $HOME represents your home directory).

This is the only time Ansel will run Lua scripts by itself. These scripts can register callbacks to perform actions on various Ansel events. This callback mechanism is the primary method of triggering lua actions.

A simple Lua example

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

Let’s start with a simple example that will print some code on the console. Create a file called luarc in Ansel’s configuration directory (usually $HOME/.config/Ansel/) and add the following line to it:

1print("Hello World !")

Start Ansel and you will see the sentence “Hello World !” printed on the console. Nothing fancy but it’s a start.

At this point, there is nothing Ansel-specific in the script. We simply use Lua’s standard print function to print a string. That’s nice and all, but we can do better than that. To access the Ansel API you first need to require it and save the returned object in a variable. Once this is done you can access the Ansel API as subfields of the returned object. All of this is documented in Ansel’s Lua API reference manual.

Printing labeled images

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

Перший приклад показав нам самі основи lua і дозволив перевірити, чи все працює належним чином. А тепер давайте зробимо щось дещо складніше. Спробуємо надрукувати список зображень, до яких прикріплена “червона” позначка. Але перш за все, що таке зображення?

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

Запуск наведеного вище коду дасть багато результату на виході. Ми розглянемо це за мить, але спочатку розглянемо сам код.

Adding a simple shortcut

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

Поки що всі наші сценарії робили щось під час запуску. Це має обмежену користь і не дозволяє нам реагувати на реальні дії користувача. Щоб зробити більш просунуті речі, нам потрібно зареєструвати функцію, яка буде викликана при настанні певної події. Найпоширеніша подія, на яку слід реагувати, – це клавіатурний прискорювач.

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

Now start Ansel, go to “preferences > shortcuts > lua > A shortcut that prints its parameters”, assign a shortcut and try it. You should see a nice message printed on the screen.

Exporting images with Lua

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

So far we have learned to use lua to adapt Ansel to our particular workflow. Let’s look now at how to use lua to easily export images to an online service. If you are able to upload an image to a service via the command line then you can use lua to integrate this into Ansel’s user interface.

In this next example we will use lua to export via scp. A new storage type will appear in Ansel’s UI that will export images to a remote target via the copy mechanism in ssh.

Building user interface elements

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

Наш попередній приклад був трохи обмеженим. Зокрема, використання налаштувань для шляху експорту було не дуже гарним рішенням. Ми можемо зробити це краще, додавши елементи до інтерфейсу користувача у діалоговому вікні експорту.

UI elements are created via the Ansel_new_widget function. This function takes a type of widget as a parameter and returns a new object corresponding to that widget. You can then set various fields in that widget to set its parameters. You will then use that object as a parameter to various functions that will add it to the Ansel UI. The following simple example adds a lib in the lighttable view with a simple label:

Sharing scripts

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

Наразі весь наш код lua був у luarc. Це хороший спосіб розробити свій сценарій, але не дуже практичний для розповсюдження. Нам потрібно зробити це належним модулем lua. Для цього ми зберігаємо код в окремому файлі (в даному випадку scp-storage.lua):

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

Ansel will look for scripts (following the normal lua rules) in the standard directories plus $CONFIGDIR/lua/*.lua. So our script can be called by simply adding require "scp-storage" in the luarc file. A couple of extra notes…

Calling Lua from D-Bus

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

It is possible to send a lua command to Ansel via its DBus interface. The method org.Ansel.service.Remote.Lua takes a single string parameter which is interpreted as a lua command. The command will be executed in the current lua context and should return either nil or a string. The result will be passed back as the result of the DBus method.

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.

Using Ansel from a Lua script

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

Попередження: ця функція дуже експериментальна. Відомо, що кілька елементів ще не працюють у бібліотечному режимі. Настійно рекомендується ретельне тестування.

The lua interface allows you to use Ansel from any lua script. This will load Ansel as a library and provide you with most of the lua API (Ansel is configured headless, so the functions relating to the user interface are not available).

Наприклад, наступна програма надрукує список усіх зображень у вашій бібліотеці:

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 .