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

Tavolo luminoso

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.

annulla/rifai

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

Quasi tutte le modifiche effettuate all’interno del Tavolo Luminoso vengono registrate e possono essere ripristinate ad uno stato precedente. Questo include la modifica alle etichette colore, alla valutazione, alla georeferenziazione, alle etichette, ai metadati, orientamento, copia/incolla della coda di sviluppo, duplicazione immagine, o l’applicazione di uno stile. Nota che la possibilità di fare annulla/ripeti è illimitata all’interno del Tavolo Luminoso per quanto riguarda i numeri di passi, ma viene azzerata ogni volta che passi ad un’altra vista.

gestione delle risorse digitali

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.

anteprime

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.

creazione delle miniature

Si crea una miniatura quando un’immagine viene importata in Ansel la prima volta, dopo che un’immagine viene modificata in Camera Oscura, oppure quando si rivisita un’immagine la cui miniatura non è più disponibile.

local copies

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

Many users have huge image collections stored on extra hard drives in their desktop computer, or on an external storage medium (RAID NAS, external hard drives etc.).

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

valutazione stelle & etichette colore

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

La valutazione con le stelle e le etichette colore ti aiutano a mettere ordine e classificare le immagini a seconda dei tuoi criteri. La valutazione e le etichette colore di un’immagine possono essere mostrate sulle miniature nel Tavolo Luminoso e nel modulo anteprime.

valutazione stelle

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

raggruppamento immagini

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

Raggruppare le immagini aiuta a migliorare la struttura e rende più chiara la tua raccolta di immagini quando visualizzata nel Tavolo Luminoso.

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.

Duplicated images are automatically grouped together. Similarly, if you import multiple images from the same directory, having the same base name, but different extensions (eg. IMG_1234.CR2 and IMG_1234.JPG), those images automatically form a group.

metadati e etichettatura

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

Ansel ti permette di archiviare informazioni aggiuntive sulla tua immagine per renderle più facili da ricercare e raggruppare. Queste informazioni sono salvata nel database di Ansel e nel file sidecar XMP, inoltre possono essere incluse nell’immagine esportata.

metadati

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.

etichettatura

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.

Camera Oscura

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

La Camera Oscura è dove sviluppi le tue immagini. Il pannello centrale contiene l’immagine attualmente in elaborazione.

ingrandimento

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

Alternativamente puoi fare zoom tra 1:1 e “adatta allo schermo” utilizzando la rotella del mouse. Tieni premuto Ctrl mentre usi la rotella per estendere la portata dello zoom tra 2:1 e 1:10.

disposizione della Camera Oscura

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

Pannello di sinistra

Dall’alto al basso:

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.

Pannello di destra

Dall’alto al basso:

il pixelpipe

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

anatomia di un modulo di elaborazione

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.

la pixelpipe & l'ordine dei moduli

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

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

L’ordine della pixelpipe è rappresentato graficamente dall’ordine in cui i moduli vengono mostrati nell’interfaccia utente – la pixelpipe inizia con l’immagine RAW in fondo alla lista dei moduli, e applica uno ad uno i moduli di elaborazione, impilando elaborazioni livello dopo livello dal basso verso l’alto, finché non raggiunge la somma della lista, dove restituisce l’immagine elaborata completamente.

la coda di sviluppo

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

La coda di sviluppo registra l’intera storia delle modifiche per una data immagine, nell’ordine in cui queste modifiche sono state applicate. Viene salvata nel database di Ansel e nel file “sidecar” XMP ed è persistente tra le sessioni di modifica.

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.

annulla e ripeti

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

Mentre stai modificando la tua immagine, Ansel registra tutte le modifiche che fai all’immagine. Questo significa che è possibile annullare a ripetere i cambiamenti per recuperare uno stato delle modifiche precedente. Nota che lo strumento annulla/ripeti è illimitato nel numero di passi mentre si modifica un’immagine, ma viene resettato ogni volta che la camera oscura passa ad una nuova immagine.

Premi Ctrl+Z per annullare l’ultima modifica e Ctrl+Y per ripetere l’ultima modifica annullata (se presente).

maschere & fusione

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.

L’output di un modulo può essere opzionalmente processato nuovamente (combinato) con i suoi dati di input prima di essere passato al modulo successivo. Questo processo aggiuntivo è chiamato fusione – i dati di input e output vengono riprocessati utilizzando algoritmi chiamati operatori di fusione o modalità di fusione.

modalità di fusione

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.

Le modalità di fusione classiche, progettate per RGB riferito allo schermo (limitate tra 0-100%), definiscono implicitamente nei loro algoritmi il fulcro al 50% (grigio) o al 100% (bianco), a seconda della modalità di fusione. Siccome lo spazio colore riferito alla scena non è soggetto a queste limitazioni, il fulcro necessita di essere stabilito dall’utente durante l’operazione di fusione nello spazio colore RGB (riferito alla scena). Il parametro aggiuntivo fulcro fusione verrà mostrato all’utente quando si usa uno di queste modalità di fusione in questo spazio colore. L’effetto dipende dall’operatore utilizzato. Per esempio, valori al di sopra del fulcro potrebbero venire illuminati di più e valori al di sotto illuminati di meno, o viceversa.

maschere

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.

Una maschera può essere considerata come un’immagine in scala di grigi dove ogni pixel ha un valore compreso tra 0 e 1.0 (o tra 0% e 100%). Questo valore è l’opacità ed è utilizzata per determinare quanto il modulo coinvolge ogni pixel.

Le sezioni seguenti spiegano come costruire maschere in Ansel.

maschere disegnate

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

Con le maschere disegnate puoi costruire una maschera disegnando forme direttamente sopra l’immagine. Le forme possono essere usate da sole o in combinazione. Dopo che una forma è stata disegnata su un’immagine può essere regolata, rimossa, o riutilizzata in altri moduli.

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.

maschere parametriche

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

La maschera parametrica offre un minuzioso controllo della selezione di come i pixel individuali vengono mascherati. Questa viene creata creando automaticamente una maschera di fusione intermedia sulla base di parametri stabiliti dall’utente. Questi parametri sono le coordinate colore invece che le coordinate geometriche utilizzate nelle maschere disegnate.

Per ciascuno dei canali dati di un modulo (es. Lab, RGB) e molti altri canali virtuali (es. tonalità, saturazione) puoi definire una funzione di opacità per canale. A seconda del valore di ciascun pixel per un dato canale dati, questa funzione calcolerà un fattore di fusione tra 0 e 1 (100%) per il dato pixel.

combinare maschere disegnate & parametriche

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

Maschere parametriche e disegnate possono essere usate in combinazione per creare un’unica maschera che può essere applicata ad un modulo.

Ci sono due elementi principali che controllano come le maschere vanno combinate individualmente: l’impostazione di polarità di ciascuna delle maschere (definita dal pulsante più o meno) e la selezione dell’opzione “Combina le maschere”.

La casella combinata “combina le maschere” contiene le seguenti opzioni, che stabiliscono come le maschere disegnate e parametriche verranno combinate assieme.

rifinitura maschere & controlli aggiuntivi

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

Quando una maschera parametrica o disegnata è attiva, vengono mostrati ulteriori cursori che permettono di rifinire ulteriormente la maschera.

soglia dei dettagli: Quest’opzione ti permette di modificare l’opacità della maschera in base alla quantità di dettaglio dell’immagine. Usa questo selettore scorrevole per selezionare tanto le aree con molti dettagli (valori positivi) quanto le aree “piatte” o che scarseggiano in dettaglio (valori negativi). Il valore predefinito (zero) in sostanza ignora la rifinitura dettaglio. Questo è perlopiù utile per applicare effetti di nitidezza e sfocature ignorando le aree fuori fuoco (bokeh) oppure per mettere a fuoco soltanto le zone sfocate, evitando di eccedere in nitidezza sulle regioni in fuoco.

Nota: I dati usati per la rifinitura maschera dettaglio vengono presi dalla fase di demosaic durante il processo della coda, and non dall’input del modulo (come succede per le altre opzioni delle maschere parametriche). Nessuno dei moduli dopo il demosaic avranno effetto sul dettaglio maschera, e non è attualmente disponibile per qualsiasi immagini non-RAW.

maschere raster

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

Come descritto nelle sezioni precedenti, il risultato finale di una maschera per un modulo (l’effetto combinato di qualsiasi maschera disegnata e parametrica) è un’immagine raster in toni di grigio che rappresenta l’intensità con la quale il modulo debba essere applicato su ogni pixel. L’immagine raster è conservata internamente per i moduli attivi e può essere utilizzata in seguito per gli altri moduli nella pixelpipe.

Come per qualsiasi altra maschera, se il valore di opacità per un pixel nella maschera raster è zero, l’input del modulo ne risulta inalterato. Se l’opacità è 1.0 il modulo ha pieno effetto sul pixel. Per ogni valore tra 0 e 1.0 l’effetto del modulo viene applicato proporzionalmente alla posizione.

moduli di elaborazione

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

final resampling

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

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

Action

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

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

aberrazioni cromatiche

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

Corregge le aberrazioni cromatiche.

Al contrario del modulo aberrazioni cromatiche del raw, questo modulo non richiede dati raw in ingresso.

flusso di lavoro

Per ottenere i migliori risultati, ti consigliamo di procedere come segue:

Attenuare le aberrazioni cromatiche quanto più possibile nel modulo correzione obiettivo usando il selettore scorrevole per il TCA.
Aumentare l’intensità in quel modulo per vedere meglio il suo effetto.
Incrementare il raggio finché le aberrazioni cromatiche scompaiono. Se questo non è abbastanza, prova ad abilitare l’impostazione “Aberrazione cromatica molto ampia”.
Scegliere la guida con cui si ottiene il massimo risultato in termini di nitidezza e artefatti.
Ridurre l’intensità per evitare di sbiadire troppo i colori.

Per i casi più complicati puoi anche provare come segue:

aberrazioni cromatiche del raw

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

Corregge le aberrazioni cromatiche delle immagine 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.

bilanciamento colore rgb

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

An advanced module which brings color-grading tools from cinematography into the photographic scene-referred pipeline.

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.

introduzione

Il color-grading è una parte importante dell’elaborazione immagini. Può aiutare a rimuovere dominanti di colore non desiderate e può anche consegnare un guizzo creativo di colore che aggiunge atmosfera alla tua immagine. Nei giorni della fotografia su pellicola, la maggior parte dell’atmosfera cromatica veniva ottenuta con le emulsioni della pellicola e gli elementi chimici di sviluppo, con alcune tempistiche per il colore eseguite sotto l’ingranditore con un filtro colorato. Questo consumata risorse costose ed era il larga parte riservato all’industria del cinema, dove il lavoro veniva eseguito da un colorista.

bilanciamento del bianco

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

Adjust the white balance of the image by altering the temperature and tint, defining a coefficient for each RGB channel, or choosing from list of predefined white balance settings.

The default settings for this module are derived from the camera white balance stored in the image’s Exif data.

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

censura

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

Degrada parte dell’immagine in maniera gradevole a vedersi, al fin di anonimizzare persone/oggetti o nascondere parti del corpo.

Il modulo censura lavora nello spazio colore RGB lineare per applicare una sfocatura gaussiana e un rumore di luminosità gaussiano che sia fisicamente accurato.

Oltre all’anonimizzazione, questo modulo può essere usato per vari scopi creativi, ad esempio:

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.

Nota: Il metodo di anonimizzazione fornito da questo modulo, per favorire l’estetica, non è sicuro dal punto di vista forense. Alcune tecniche forensi potrebbero essere in grado di ricostruire il contenuto censurato nella sua struttura, soprattutto per forme semplici e testi (es: targhe, numeri delle vie).

color calibration

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

A fully-featured color-space correction, white balance adjustment and channel mixer module.

This simple yet powerful module can be used in the following ways:

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.

contrasto locale

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

Enhance the image’s local contrast.

This is achieved using either a local laplacian (default) or unnormalized bilateral filter. Both modes work exclusively on the L channel from Lab. The local laplacian filter has been designed to be robust against unwanted halo effects and gradient reversals along edges.

Controlli modulo

mode: Choice of local laplacian filter or bilateral grid. The following sections define the controls available for each of these modes.

Griglia bilaterale

coarseness: Adjust the coarseness of the details to be adjusted.
contrast: Control how strongly the algorithm distinguishes between brightness levels. Increase this parameter for a more contrasty look.
detail: Add or remove detail. Higher values increase local contrast.

local laplacian

To understand the parameters of the local laplacian filter, one can think of it as applying a curve to the image, similar to the following graph:

cornice

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

Generate a frame around the image.

The frame consists of a border (with a user-defined color) and a frame line within that border (with a second user-defined color). Various options are available to control the geometry and color of the frame.

Controlli modulo

border size: The size of the frame as a percentage of the underlying full image.
aspect: The aspect ratio of the final module output (i.e. the underlying image plus the frame)
orientation: The orientation of the frame (portrait/landscape). Select ‘auto’ for Ansel to choose the most reasonable orientation based on the underlying image.
horizontal/vertical position: Select from a set of pre-defined ratios to control where the underlying image will be positioned on the horizontal/vertical axis. You can also right click and enter your own ratio as “x/y”.
frame line size: The percentage of the frame line size, relative to the border size at its smallest part.
frame line offset: The position of the frame line, relative to the underlying image. Choose 0% for a frame line that touches the image. Choose 100% for a frame line that touches the outer border.
border color / frame line color: A pair of color selectors which allow the border and frame line colors to be defined. Clicking on the colored field will open a color selector dialog which offers a choice of commonly-used colors, or allows you to define a color in RGB color space. You can also activate a color picker to take a color probe from the image.
show guides: Tick the box to show guide overlays whenever the module is activated. Click the icon on the right to control the properties of the guides. See guides & overlays for details.

correzione obiettivo

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

Automatically correct for (and simulate) lens distortion, transversal chromatic aberrations (TCA) and vignetting.

This module identifies the camera/lens combination from the image’s Exif data and uses the external lensfun library to provide correction parameters.

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.

correzione profilo di ingresso

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

Crea una curva di correzione ai dati immagine. Richiesto nel caso in cui abbiate selezionato un particolare profilo di ingresso nel modulo profilo colore di ingresso module.

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.

curva rgb

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

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

Activate the color picker on the left to show the picked values in the graph (Ctrl+click or right-click to use the picker in area mode). Numerical (Lab) values of the input and output (see below) at the selected spot or area are shown at the top left of the widget.

A second color picker to the right can be used to automtaically create new nodes based on the sampled area. Ctrl+click+drag to alter the created nodes to have a positive curve for the selected area; Shift+click+drag to create a negative curve.

demosaicizza

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

Control how raw files are demosaiced.

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.

diffusione o nitidezza

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

La diffusione è una famiglia di processi fisici per il quale le particelle si muovono e si disperdono gradualmente nel tempo, da una sorgente che le genera. Nell’elaborazione delle immagini, la diffusione avviene principalmente in due posti:

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

In entrambi i casi la diffusione rende l’immagine meno nitida, “perdendo” particelle e ammorbidendo le variazioni locali.

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.

equalizzatore contrasto

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

Adjust luminance and chroma contrast in the wavelet domain.

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.

A number of presets are provided, which should help you to understand the capabilities of the module.

equalizzatore toni

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

Scherma e brucia preservando il contrasto locale.

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.

Il seguente diagramma descrive come funziona l’equalizzatore toni:

esposizione

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

Increase or decrease the overall brightness of an image.

Questo modulo può operare in due modalità:

manuale: Imposta l’esposizione, il livello del nero e la soglia di tosaggio manualmente.
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.

Controlli modulo

modo: Sceglie il modo operativo (automatico/manuale).
compensa l’esposizione delle fotocamera (modo manuale): Rimuove automaticamente la correzione esposizione della fotocamera (presa dai dati Exif dell’immagine).
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.
soglia di tosaggio (modo manuale): Stabilisce quale percentuale di valori luminosi debba essere tagliata nel calcolo dell’esposizione e del livello del nero. Usa il selettore colore per campionare una porzione dell’immagine per essere usata in questo calcolo.
percentile (modo automatico): Stabilisce la posizione di riferimento sull’istogramma per la correzione automatica dell’esposizione. Un percentile del 50% indica una posizione nell’istogramma dove il 50% dei pixel è al di sopra di quella esposizione e il restante 50% ne è al di sotto.
livello target (modo automatico): Indica il livello desiderato per la correzione dell’esposizione (in EV) relativo al punto di bianco della fotocamera.
black level correction (manual and automatic modes): Adjust the black level point to unclip negative RGB values.

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.

filigrana

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

Render a vector-based overlay onto your image. Watermarks are standard SVG documents and can be designed using Inkscape .

You can also use bitmap (PNG) images.

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.

filmic rgb

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

Rimappa la gamma tonale di un’immagine riproducendo la risposta di tono e colore della pellicola classica.

Questo modulo può essere usato sia per espandere che per contrarre la gamma dinamica della scena per adattarla alla gamma dinamica dello schermo. Protegge i colori e il contrasto nei mezzi toni, recupera le ombre, comprime le alteluci luminose e le ombre scure. Le alteluci hanno bisogno di maggior cura quando si devono preservare i dettagli (es: nuvole).

filtro graduato

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

Simula un filtro a densità neutra graduata, in modo tale di correggere l’esposizione e i colori in maniera progressiva.

Sullo schermo viene visualizzata una linea che permette di modificare col mouse la posizione e la rotazione del gradiente.

Per questo modulo è risaputo che provochi artefatti di “banding” in alcune condizioni. Dovresti considerare l’attivazione del modulo dithering per alleviare il problema.

Controlli modulo

densità: Imposta la densità del filtro (in EV). Un valore basso sottoespone leggermente mentre un valore alto crea un filtro più intenso.
intensità (durezza): La progressività del gradiente. Un valore basso crea una transizione dolce, mentre un valore alto rende la transizione più improvvisa.
rotazione: la rotazione del filtro. Valori negativi ruotano in senso orario. La rotazione può essere impostata anche trascinando con il mouse la fine della linea di gradiente.
tonalità: Sceglie una tonalità per dare una dominante colorata al gradiente.
saturazione: La saturazione della dominante colorata da aggiungere al gradiente (predefinita ad un colore dominante neutrale di 0)

grana

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

Simula la grana della pellicola analogica. La grana viene elaborata sul canale L dello spazio colore Lab.

Controlli modulo

ruvidezza: La dimensione della grana, rapportata per simulare un valore ISO.
intensità: L’intensità dell’effetto.

liquefa

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

Move pixels around by applying freestyle distortions to parts of the image using points, lines and curves.

nodi

Each of liquify’s tools is based on nodes. A point consists of a single node and a line or curve consists of a sequence of linked nodes defining a path.

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.

livelli rgb

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

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

The rgb levels tool shows a histogram of the image, and displays three bars with handles. Drag the handles to modify the black, middle-gray and white points in lightness (in “RGB, linked channels” mode) or independently for each of the R, G and B channels (in “RGB, independent channels” mode).

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.

lut 3d

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

Transform RGB values with a 3D LUT file.

A 3D LUT is a tridimensional table that is used to transform a given RGB value into another RGB value. It is normally used for film simulation and color grading.

This module accepts .cube, .3dl, .png (haldclut) and .gmz files. Uncompressed 3D LUT data is not saved in the database or the XMP file, but is instead saved to the 3D LUT file path inside the 3D LUT root folder. It is therefore important to back up your 3D LUT folder properly – sharing an image with its XMP is pointless if the recipient doesn’t also have the same 3D LUT file in their own 3D LUT folder.

negadoctor

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

Process scanned film negatives.

You can obtain an image of a negative using a film scanner, or by photographing it against a white light (e.g. a light table or computer monitor) or off-camera flash.

preparazione

If the image of the negative was obtained using a digital camera, then in order to obtain accurate colors in the final image, you will need to take the following points into consideration:

nitidezza

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

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

This module works by increasing the contrast around edges and thereby enhancing the impression of sharpness of an image. This module is applied to the L channel in Lab color space.

Note: The USM algorithm used in this module performs blurs in Lab color space, which can produce undesirable effects, and is no longer recommended. Instead use the presets offered by the contrast equalizer module for deblurring or the local contrast module for general sharpness.

orientamento

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

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

The module is enabled by default and the orientation (rotation) is automatically set based on the image’s Exif data.

Controlli modulo

transform: Double click the label to reset to the default transformations
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.

pixel bruciati

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

Automatically detect and eliminate hot pixels.

I pixel bruciati sono pixel che hanno fallito a registrare la quantità di luce correttamente. I pixel bruciati individuati vengono sostituiti dalla media dei pixel confinanti.

Controlli modulo

soglia: Quanto il valore di un pixel deve deviare da quelli adiacenti per essere considerato come un pixel bruciato.
intensità: L’intensità con cui i pixel bruciati devono essere fusi con i pixel circostanti.
determina da 3 vicini: Estende l’identificazione dei pixel bruciati – considera un pixel come bruciato se almeno tre (invece che quattro) pixel adiacenti deviano oltre il livello di soglia.
marca i pixel corretti: contrassegna visualmente sull’immagine i pixel corretti e visualizza il numero dei pixel bruciati che sono stati riparati.

profilo colore di ingresso

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

Define how Ansel will interpret the colors of the image.

This module takes the color space used by the image source (e.g. camera, scanner) and converts the pixel encodings to a standardized working color space. This means that subsequent modules in the pipeline don’t need to be concerned with the specifics of the input device, and can work with and convert to/from a common working color space.

Where an image has been captured in a raw file, the input color profile module will normally apply either a standard or enhanced color matrix specific for that camera model, which will be used to map the colors into the working profile color space. If color space information is embedded in the image, the input color profile module will use this information when mapping the colors to the working profile color space. The user can also explicitly specify a color space for the incoming image, and can even supply a custom ICC color profile specifically made for the input device.

profilo colore di uscita

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

Manage the output profile for export and the rendering intent to be used when mapping between color spaces.

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.

Controlli modulo

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.
output profile: The profile used to render colors for output/export. The profile data will be embedded into the output file (if supported by the file format) allowing other applications to correctly interpret its colors. As not all applications are aware of color profiles, the general recommendation is to stick to sRGB unless you know what you are doing and have a good reason to do otherwise.

punto nero/bianco raw

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

Define camera-specific black and white points.

Questo modulo si attiva automaticamente per tutte le immagini raw. Vengono applicate impostazioni predefinite per le fotocamere supportate. Solitamente non sono richieste modifiche al default.

Controlli modulo

livelli di nero 0-3: I livelli di nero specifici per la fotocamera dei quattro pixel nello schema Bayer RGGB. Pixel con valori inferiori a questo livello vengono considerati come non contenenti dati validi.
punto di bianco: Il livello di bianco specifico per la fotocamera. Tutti i pixel con valori oltre questo è probabile che vengano tagliati e verranno gestiti in base al modulo recupero alteluci.
flat field correction: Use flat field correction to compensate for lens shading. This field only appears for applicable Raw files and will automatically use any GainMap embedded in the Raw. You can choose to disable this correction if desired.

recupero alteluci

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

Attempt to reconstruct color information for pixels that are clipped in one or more RGB channel.

Se questi pixel sono rimasti parzialmente tagliati in uno o due canali, possono risultare in colori non realistici nell’immagine. Per esempio, pixel con i canali verde e blu entrambi tagliati, appariranno rossi senza alcun recupero delle alteluci.

Sono disponibili tre metodi di recupero:

taglio alteluci: blocca tutti i pixel al livello del bianco (es: tagliando i canali colore rimanenti). Questo metodo è il più utile quando il ritaglio (“clipping”) delle alteluci avviene su oggetti desaturati di natura (es: le nuvole).
ricostruisci in LCh: Analizza ciascun pixel con almeno un canale tagliato e tenta la correzione del pixel ritagliato (nello spazio colore LCh) usando i valori degli altri pixel nel blocco interessato nel sensore (3 altri pixel per sensori Bayer o 8 per sensori X-Trans). Le alteluci recuperate rimarranno monocromatiche, ma più luminose e con maggiori dettagli che usando “taglio alteluci”. Questo metodo funziona correttamente con una curva base ad alto contrasto, la quale produce alteluci desaturate. Come “taglio alteluci” questo metodo è una buona opzione per oggetti desaturati di natura.
ricostruisci colore: Usa un algoritmo che trasferisce le informazioni colore dai pixel non ritagliati nelle vicinanze alle alteluci tagliate. Questo metodo funziona molto meglio nelle aree con colori omogenei ed è particolarmente utile sui toni della pelle con alteluci che sfumano dolcemente. Notare che questo metodo può produrre artefatti “a labirinto” sulle alteluci dietro a bordi con alto contrasto, per esempio in caso di strutture correttamente esposte davanti ad uno sfondo sovraesposto.
guided laplacians: Use an algorithm (derived from the diffuse or sharpen module) to replicate details from valid channels into clipped channels and to propagate color gradients from valid surrounding regions into clipped regions. This is a slow and computationally-intensive method designed for maximum smoothness and seamless blending of the reconstructed regions into their neighborhood, and is designed primarily to reconstruct spotlights and specular reflections. This mode is available for Bayer sensors only.

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

ricostruzione colore

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

Recuperare informazioni sui colori nelle alte luci tagliate.

A causa della natura dei sensori digitali, le alte luci sovraesposte mancano di informazioni valide sui colori. Molto spesso appaiono in bianco neutrale o mostrano una dominante colorata, a seconda di quali altri passi di elaborazione dell’immagine sono coinvolti. Questo modulo può essere usato per “guarire” le alte luci sovraesposte rimpiazzando il loro colore con uno più appropriato. Il modulo agisce sui pixel la cui luminanza eccede una soglia definita dall’utente. I colori da usare come rimpiazzo vengono presi dai pixel vicini. Per la selezione del colore vengono prese in considerazione sia la distanzia spaziale che di luminanza.

ridimensiona pixel

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

Alcune fotocamere (come la Nikon D1X) hanno le celle dei sensori rettangolari invece che quadrati. Senza correzione questo porterebbe a immagini distorte. Questo modulo applica il ridimensionamento necessario.

Ansel identifica le immagini che hanno bisogno di correzione usando i dati Exif e attiva automaticamente questo modulo quando necessario. Per altre immagini il modulo rimane sempre disabilitato.

Il modulo non ha controlli.

riduci rumore foto astronomiche

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.

Siccome la riduzione del rumore è un processo che consuma molte risorse rallenta l’elaborazione della pixelpipe in maniera significante. Considera di ritardare l’attivazione di questo modulo verso la fine del tuo flusso di lavoro.

riduzione rumore (profilato)

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

Un modulo di riduzione del rumore, facile da usare e altamente efficiente, adattato ai profili rumore individuali di un’ampia gamma di sensori.

Uno dei problemi di molti algoritmi per la riduzione del rumore è che danno per assunto che la varianza del rumore sia indipendente dalla luminosità del segnale. Profilando le caratteristiche del rumore del sensore della fotocamera a differenti ISO, si può stimare la varianza a luminosità differenti, e l’algoritmo di riduzione del rumore può essere regolato per addolcire il rumore più uniformemente.

riduzione rumore raw

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

Perform denoising on raw image data before it is demosaiced.

Questo modulo è stato convertito da dcraw .

Controlli modulo

soglia rumore: La soglia per l’individuazione del rumore. Valori più alti portano a una riduzione del rumore più aggressiva e una maggiore perdita di dettaglio nell’immagine.
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.

rimozione foschia

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

Riduce automaticamente l’effetto di polvere e foschia nell’atmosfera. Questo modulo può anche essere usato più in generale per dare alle immagini un accento di colore in più soprattutto nelle aree dell’immagine con basso contrasto.

La foschia assorbe luci dagli oggetti nella scena ma è anche una sorgente di luce diffusa di sfondo. Il modulo di rimozione foschia stima inizialmente, per ciascuna area dell’immagine, l’ammontare di foschia nella scena. Quindi rimuove la luce diffusa di sfondo in base all’intensità locale e recupera la luce originale degli oggetti.

Ritaglia

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.

Whenever this module is in focus, the full uncropped image will be shown, overlaid with crop handles and optional guiding lines.

ritocco

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

RImuove elementi indesiderati dalla tua immagine: clona, guarisci, sfuma e riempi, usando forme disegnate.

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.

rotazione e prospettiva

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

Corregge automaticamente le linee convergenti, una forma di distorsione della prospettiva. Il meccanismo alla base è ispirato dal programma ShiftN di Markus Hebel. Questo modulo permette anche di regolare la rotazione dell’immagine.

La distorsione della prospettiva è un effetto naturale che avviene quando si proietta una scena tridimensionale su un piano bidimensionale, e comporta che gli oggetti più vicini sembrino più grandi degli oggetti più lontani. Le linee convergenti è un caso speciale di distorsione della prospettiva, vista molto di frequent nelle fotografie architettoniche – le linee parallele, quando fotografate da un angolo, si trasformano in linee convergenti che si incontrano in un punto di osservazione all’interno o all’esterno della cornice dell’immagine.

ruota pixel

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

I sensori di alcune fotocamere (come le Fujifilm FinePix S2Pro, F700, e E550) hanno un pattern Bayer orientato diagonalmente, al posto della solita disposizione ortogonale.

Senza correzione questo porterebbe a un’immagine inclinata con gli angoli neri. Questo modulo applica la rotazione richiesta.

Ansel identifica le immagini che hanno bisogno di correzione usando i dati Exif e attiva automaticamente questo modulo quando necessario. Per altre immagini il modulo rimane sempre disabilitato.

Sfoca superficie

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.

sfocature

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

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

blur types

Three types of blur are provided:

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

A diagram at the top of the module shows the shape of the blurring operator (known as the point spread function ). The module will turn each luminous point from the scene into a blot shaped like the displayed blurring operator, with the size of the blot defined by the blur radius.

tabella ricerca colore

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

Controlli modulo

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).; Fai click su una casella per selezionarla, o usa il menù a tendina o il selettore colore. La casella selezionata al momento è evidenziata con un quadrato bianco, e il suo numero viene mostrato nel menù a tendina più in basso.

vignettatura

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

Apply a vignetting effect to the image.

Vignetting is a modification of the brightness and saturation at the borders of the image in a specified shape. Many of the parameters listed below can also be modified with a graphical control that overlays the image when the module has focus, showing the shape and extent of the effect.

Note: This module is known to provoke banding artifacts under certain conditions. You should consider activating the dithering module to alleviate this.

zone colore

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

Selectively adjust the lightness, saturation and hue of pixels based on their current lightness, saturation and hue.

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.

You first need to choose whether you wish to adjust (select) pixels based on their lightness, saturation or hue. You can then use three curves, on their respective tabs, to adjust the lightness, saturation and hue of ranges of pixels selected via this method.

Mappa

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.

Presentazione

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.

utilizzo

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

The slideshow view is still in an early stage of development with only a basic set of features.

 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.

Stampa

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.

Questo modulo supporta il profilo ICC della stampante, un passaggio praticamente obbligatorio se vuoi ottenere una stampa di qualità vicina a ciò che vedi sullo schermo.

Disposizione visualizzazione Stampa

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

L’area centrale visualizza la disposizione dell’immagine sulla carta (la zona bianca). Potresti vedere dei bordi grigi intorno all’immagine a rappresentare l’effettiva area di stampa (la pagina ad esclusione dei bordi).

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

overlays

When the mouse is over the bounding box of an image, its width and height are shown along its top and left, respectively. Margins between the bounding box and the page edge are notated next to the dotted lines extending out from each side of the bounding box. All measurements are shown in the units as chosen in the print settings module.

GUI toolboxes

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

Ambiti

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

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

Muovi il mouse sopra il pannello per mostrare i pulsanti che ti permettomp di cambiare la visualizzazione. Il pulsante all’estrema sinistra varia le modalità istogramma tra “normale”, a forma d’onda, gamma RGB e vectorscope. I pulsanti adiacenti controllano come i dati per la modalità corrente vengono visualizzati.

anteprima

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

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

clipping warning

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

Highlight areas of the image that may exhibit luminance or gamut clipping.

When an image is sent to a display device, each pixel is normally represented as a set of 3 numbers, representing the intensity of the red, green and blue primary colors in the output color space. Because the output color space is usually closely related to hardware with physical limations, there is a maximum permitted value for the [R,G,B] channels, representing the maximum available intensity for that color space. Similarly, there is also a minimum value below which pixel values will be mapped to zero. When we try to convert from a larger color space to the final output color space, any values exceeding this maximum will be clamped to the maximum value, and any values below the minimum will be clamped to zero. This process is called “clipping” and it will lead to lost detail, or “incorrect” colors for any pixels with clipped channels.

Coda di sviluppo

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

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

This module lists every change of state (activate/de-activate/move/change parameters) for all processing modules that have been modified for the current image. Select a point in the stack to return to that point in the development history of the image. Shift+click an item in the history stack to expand that module in the right-hand module panel without changing the current edit.

Controllo gamma

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

Highlight areas of the image that may exhibit gamut clipping.

Click the

are mutually exclusive modes.

Right-click on the icon to open a dialog with configuration parameters – these are the same as for the soft proof option.

You might also like to consider using the clipping warning, which also provides under- and over-exposure warnings as well as a gamut check similar to that offered by this module.

Display metadata

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

Mostra le informazioni incluse nei dati Exif dell’immagine assieme ad altri campi aggiuntivi definiti da Ansel.

Quando si passa il mouse sulla miniatura di un’immagine, i dati mostrati vengono automaticamente aggiornati per mostrare le informazioni dell’immagine attualmente sotto il cursore del mouse.

Quando è selezionata più di un’immagine e il fuoco è su nessuna delle immagini, il modulo mostra soltanto le informazioni che sono le stesse per tutte le immagini. Se uno dei campi differisce tra le immagini, viene visualizzato il testo alternativo “<various values>”.

editor metadati

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

Edit the metadata of selected images.

I metadati sono del testo in formato libero (titolo, descrizione, autore, editore, diritti etc…) che descrive le tue immagini.

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

esporta

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

Esporta le immagini selezionate.

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

Controlli modulo

opzioni di salvataggio

destinazione

E’ il tipo di destinazione per l’esportazione delle immagini selezionate. Sono implementati un certo numero di tipologie, incluse file su disco, modello libro LaTeX e vari web album. A seconda della destinazione selezionate, verrà richiesto di fornire ulteriori informazioni, quali il nome del file or nome e password di un account.

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.

selezione cartella

Il pulsante affianco il template nome file apre la finestra di dialogo per selezionare la cartella per l’esportazione.

sul conflitto

Seleziona cosa fare quando il nome file generato è in conflitto con un file esistente sulla cartella di destinazione:

crea nome file unico: Sceglie automaticamente un nuovo nome file univoco aggiungendo un numero intero al nome del file in conflitto.

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.

salta: Non esporta l’immagine quando il nome file già esiste nella destinazione.

opzioni formato

formato file: Seleziona il formato file per l’immagine esportata. Ulteriori opzioni appariranno in basso a seconda del formato selezionato.
qualità: La qualità del file esportato. Valori più alti risultano in file più grandi. La qualità di default (95) è un buon valore per esportazioni di altà qualità (per archiviazione o stampa). Se hai esigenza di un buon compromesso tra dimensione e qualità (ad esempio per mostrare su internet le immagini) puoi considerare un valore di “90”.
profondità di bit: Il numero di bit per ciascun canale colore. Più bit significano meno separazione dei toni (posterization)/bande di colore (color banding).
compressione: Il tipo di compressione da utilizzare.
livello di compressione: Per i formati di esportazione dove la compressione può essere specificata, il livello di compressione indica quanta compressione applicare. Più alto è il valore e più i dati verranno compressi, al costo di maggior impegno della CPU.
immagine BN: Per il formato di esportazione TIFF è possibile salvare immagini monocromatiche. Questa preferenza controlla se il file risultante deve codificare i toni di grigio come canali RGB separati o come un singolo canale a scala di grigio. Con la seconda opzione si ottengono file più piccoli.

impostazioni esportazione

imposta dimensione

Scegli come misurare la massima dimensione dell’immagine esportata

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

in cm (per stampe): Inserisce la massima larghezza e altezza in cm e stabilisci i DPI dell’immagine. La dimensione equivalente in pixel verrà calcolata automaticamente.

in pollici (per stampe): Inserisce la massima larghezza e altezza in pollici e stabilisci i DPI dell’immagine. La dimensione equivalente in pixel verrà calcolata automaticamente.

in scala (per file): Inserisci un moltiplicatore per specificare di quanto l’immagine esportata deve essere ridimensionata rispetto all’immagine di input. Per esempio, inserendo un valore di 0.5, si otterrà un’immagine di output con metà dell’altezza e della larghezza (in pixel) dell’immagine originale.

dpi

Se l’unità di misura selezionata è cm o pollici, imposta i dpi dell’immagine di output. Il valore verrà anche archiviato nei dati Exif dell’immagine esporata. Verrà impostato automaticamente a 300 se viene selezionato “in pixel” o “in scala”.

dimensioni massime

Imposta la massima larghezza e altezza (in pixel, cm o pollici a seconda dell’unità di misura selezionata) delle immagini esportate – zero significa che non vi saranno vincoli impostati per la specifica dimensione. Le immagini esportate verranno ridimensionate per non superare i valori impostati, ma verranno mantenute le proporzioni corrette. Imposta entrambe a zero per esportare con le dimensioni originali (dopo il ritaglio). Se i valori inseriti sono maggiori delle dimensioni originali, Ansel può esportare sia con le dimensioni originali che allargare (upscaling) l’immagine, a seconda dell’opzione “Permetti upscaling”.

permetti upscaling

Impostare su “Si” per permttere l’allargamento (upscaling) dell’immagine quando la massima larghezza e altezza definita dall’utente ecceede le dimensioni originali dell’immagine. Se impostato su “no” le dimensioni dell’immagine esportata non eccederanno le dimensioni dell’immagine originale (dopo il ritaglio).

ricampionamento ad alta qualità

Impostare quest’opzione su “si” per eseguire un ricampionamento ad alta qualità sull’immagine. L’immagine verrà processata a risoluzione massima e ridimensionata soltanto alla fine del rpocesso. In alcuni casi questo potrà risultare in maggiore qualità, ma il processo sarà sempre più lento.

store masks

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

profile

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

intent

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

style

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

mode

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

export

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

Note: Images that are selected but currently hidden (because they are members of a collapsed group) will not be exported.

etichettatura

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

Gestisce le etichette allegate alle immagini.

Le etichette forniscono un modo di aggiungere informazioni alle immagini usando un dizionario di parole chiavi. Puoi anche gestire le etichette in gerarchia, il ché può essere utile quando diventano molte.

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

definizioni

Le seguenti definizioni presuppongono che tu abbia impostato una singola etichetta “luoghi|Italia|Toscana|Rio Marina”.

etichettatura geografica

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

Importa usa i dati di tracciamento nel GPX alle immagini selezionate.

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.

panoramica del processo

Il ricevitore GPS calcola la posizione corrente basandosi sulle informazioni che riceve dai satelliti e la registra in un file GPX assieme alla data/ora corrente. I dati Exif delle immagini contegono anche loro un timestamp (data e ora) a seconda delle impostazioni della fotocamera. Il modulo geotagging legge il timestamp dell’immagine, ricerca la posizione nel file GPX a quella determinata data/ora, e registra le coordinate relative (latitudine/longitudine/altitudine) nel suo database e nel file XMP relativo all’immagine.

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.

Gestore duplicati

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.

Gestore maschere

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

Manage all masks and shapes for the current image.

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

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

global color picker

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

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

The color picker is activated by pressing the color picker icon. The module’s parameters will remain in effect until you leave the darkroom mode.

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

A number of commonly-used compositional guides can be overlaid on your image while you are editing. These can be enabled either globally (all the time) or locally (when certain modules are active).

Other darkroom functionality also draws colored overlay lines on the image (for example, drawn masks). An option is also provided to change the color of those overlays (see below).

Guide globali

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.

Impostazioni mappa

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

Select preferred map data from various providers. Some will provide additional layers (satellite view etc.) which you can toggle.

Controlli modulo

map source

Choose the provider to source map information from.

max polygon points

The find location module doesn’t display polygons with more points than this for performance reasons. Usually a country polygon has between 50,000 and 150,000 points.

show OSD

Choose whether to display the OSD controls at the top-left of the center view.

filtered images

Check this box to display only the images from the current collection (those shown in the filmstrip) in the center view. Un-check the box to display all images in the current library, where those images have associated GPS data. You can also toggle this option by pressing Ctrl+S.

max images

The maximum number of thumbnails to display on the map.

group size factor

Increase or decrease the size of area that causes images to be grouped.

min images per group

The minimum number of images that need to be placed in the same position in order to automatically create an image group for them.

thumbnail display

Define what information to show on the map display

thumbnails: Display image thumbnails along with a counter.

count: Just display the number of images (to free space on the map). Hover over the number of images to show the corresponding thumbnail(s). A count-only marker behaves the same way as a normal image thumbnail, in terms of color coding, scrolling, drag and drop etc.

none: Show nothing.

You can also cycle through these options by pressing Shift+S.

istantanee

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

Store development snapshots and compare with the current edit.

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.

Library

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

Filtra le immagini mostrate nel tavolo luminoso e nel pannello dei provini utilizzando le proprietà delle immagini. L’insieme delle immagini filtrate è chiamato una raccolta.

Tutte le immagini importate in dartable vengono salvate nel database di Ansel assieme a tutte le proprietà che descrivono ciascuna immagine (nome del file, percorso, dati Exif, dati XMP del file sidecar, ecc.). Si costruisce così una raccolta applicando delle regole di filtro su questi attributi, creando quindi un sottoinsieme di immagini da mostrare nel Tavolo Luminoso e nei provini.

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.

luoghi

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

Create areas or locations and organize them as hierarchical tags.

A location is shown as a shape on the map when selected. Initially each location is represented as a square or circle and can be changed to a rectangle or ellipse by adjusting the shape’s width and/or height.

A location can also be created from an OpenStreetMap region (city/country) polygon. To achieve this, first make sure the max polygon points parameter is large enough (some country polygons use more than 150,000 points). Then select the desired location in the find location module. When the corresponding region shape is displayed, a polygon symbol becomes available in the “shape” control (see below). Select it to create the new location.

navigazione

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

Zoom and pan the current image.

On the top left hand side of the darkroom, the navigation panel displays a full preview of the current image with a rectangle showing the area that is currently visible in the central panel. Drag the rectangle around to pan the zoomed-in view. The current zoom scale is displayed to the right of the preview image. Click on that figure for a quick access to some common zoom levels.

Opzioni di stampa

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

Manage settings for the print view and initiate printing.

Controlli modulo

Stampante

Stampante: Seleziona una stampante tra quelle installate.
Media: Il tipo di supporto caricato sulla stampante (Carta normale, Carta fotografica, ecc.)
Profilo: Il profilo ICC della stampante per la carta utilizzata. Questo è il profilo specifico per la stampante e la carta. Questo profilo è responsabile dell’ultima trasformazione dello spazio colore applicata all’immagine con l’obiettivo di ottenerre una stampa di alta qualità.
intent: The print rendering intent (“perceptual”, “relative colorimetric”, “saturation” or “absolute colorimetric”). See rendering intent for more details.
Compensazione del punto di nero: permette di modificare il punto di nero del profilo di output, che solitamente è più luminoso del profilo di input. Questo parametro dovrebbe essere “attivo” quando l’intento è impostato a “Colorimetrico relativo”.

Pagina

Dimensioni carta: Le dimensioni della carta su cui stampare
orientation: Portrait or landscape (note that darktable chooses the best fit by default).
Unità di misura: L’unità di misura da usare per impostare i margini: “mm”, “cm”, o “pollici”.
Margini: Imposta separatamente ogni margine, oppure tutti insieme cliccando sul pulsante “Acquisisci”.
display grid: Select the grid size using the entry field (expressed in the currently selected unit). Tick the option to display the grid on the canvas.
snap to grid: Help setting the image areas by snapping them to the grid for proper alignment.
borderless mode required: Indicates whether the printer borderless mode is to be activated. This item is activated when the user’s margins are smaller than the printer hardware margins. Note that it is only an indicator as it does not activate the borderless mode automatically.

Disposizione dell’immagine

Larghezza/altezza immagine: Questo campo informativo visualizza le dimensioni reali dell’immagine sulla carta, usando le unità di misura selezionate.
Fattore di scala: Questo campo di informazione mostra il fattore di scala dell’immagine per adattarsi alla carta. Se il suo valore è minore di 1 l’immagino è ridotta, altrimenti è ingrandita. È un fattore importante di cui tener conto dato che un valore troppo grande (ingrandimento) potrebbe portare ad una stampa di bassa qualità. Viene inoltre mostrato il valore corrispondente di dpi (dots per inch - punti per pollice).
Allineamento: Seleziona l’allineamento dell’immagine sulliarea.
new image area button: Create a new image area. Drag and drop on the canvas to place it. If the option snap to grid is activated the area can be easily aligned to the grid lines. An image can be placed into this area by dragging it from the filmstrip and dropping it on the new area.
delete image area button: Remove the currently selected image area from the composition.
clear layout button: Remove all the image areas leaving the canvas empty.

The following four fields represent the position of currently selected area on the page – the top/left corner on the first line and the width/height of the area on the second line.

Ordine dei moduli

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

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

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

Prova colore a monitor

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

View your image rendered using a selected color profile.

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.

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.

stili

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.

A list of all available styles is displayed in the module. A search field above the list allows you to locate a style by name or description. This module also allows styles to be edited and deleted.

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.

Trova località

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

Search for a location on the map. You must be connected to the internet to use this feature.

To use this module, type in a place name or address, press Enter and a list of results will be shown. Click on an item in the list and the map will zoom to that location. An outline covering that location or a pin pointing at the location will be displayed.

An outline (polygon) can be used to create a user location. Check the max polygon points parameter in the map settings module to ensure that sufficient points are available for a polygon to be displayed.

Valitazione colori

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

Assess colors and brightness in your image using ISO 12646:2008 recommended viewing conditions.

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

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

The end result is that the final image can end up being too dark and overly-processed in terms of contrast and color saturation. To avoid this, the “ISO 12646:2008” standard makes some recommendations about the conditions under which the colors of an image should be assessed. The color assessment module in the darkroom places a frame around the image to help the user better assess the colors in the image, along the lines of those recommendations.

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

Preferences & Settings

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.

Any altered settings (i.e. those that differ from their default state) are highlighted with a bullet beside them. If you change a setting that needs a restart to take effect, a message will appear as a reminder after you exit the preferences dialog.

generale

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

Control the overall look and feel of Ansel.

interface language: Set the language of the user interface. The system default is marked with an * (needs a restart)
theme: Set the theme for the user interface. Aside from any aesthetic considerations, the recommended interface color for color evaluation is middle gray. Visual perception is affected by ambient brightness, and a low user interface brightness causes all kinds of illusions. Using a dark interface to retouch photos can therefore lead to excessive retouching (abuse of contrast and saturation) and to a photo that is too dark when printed. It is therefore highly recommended that you use one of the “grey” themes for retouching work as these are designed so that the user interface approximates middle gray (default “Ansel”).
use system font size: Select this option to use the font size defined by your system. If unchecked, you may enter a custom font size in the box below (default on).
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.
GUI controls and text DPI: Adjust the global GUI resolution to rescale controls, buttons, labels, etc. Increase for a magnified GUI, decrease to fit more content in the window. Set to -1 to use the system-defined global resolution. The default is 96 DPI on most systems. (needs a restart)

CSS theme modifications

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

Tavolo Luminoso

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

Control functionality in the lighttable view and modules.

generale

hide built-in presets for utility modules: If enabled, only user-defined presets will be shown in presets menu for utility modules – built-in presets will be hidden (default off).
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.

anteprime

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

Camera Oscura

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

Control functionality in the darkroom view and associated modules.

generale

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

moduli

display of individual color channels

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

hide built-in presets for processing modules

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

show the guides widget in modules UI

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

show right-side buttons in processing module headers

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

always: always show all buttons

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

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

auto: hide the buttons when the panel is narrow

fade: fade out all buttons when the panel narrows

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

smooth: fade out all buttons in one header simultaneously

glide: gradually hide individual buttons as needed

(default always)

prompt for name on addition of new instance

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

Other views

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

Enable optional views:

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

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

elaborazione

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

Control how images are processed.

Elaborazione d’immagine

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

sicurezza

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

Control whether warning messages are shown before undertaking certain activities.

generale

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

altro

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

Processing high resolution images is a demanding task requiring a modern computer. In terms of both memory and CPU power, getting the best out of a typical 15, 20 or 25 Megapixel image can quickly take your computer to its limits.

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

As you can imagine, the hardware architecture of GPUs can vary significantly. There are different manufacturers, and even different generations of GPUs from the same manufacturer may not be comparable. At the same time GPU manufacturers don’t normally disclose all the hardware details of their products to the public. One of the consequences of this is the need to use proprietary drivers under Linux, if you want to take full advantage of your graphics card.

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

The huge diversity of systems and the marked differences between OpenCL vendors and driver versions makes it impossible to give an comprehensive overview of how to setup OpenCL. We only can give you an example, in this case for NVIDIA driver version 331.89 on Ubuntu 14.04. We hope that this will serve as a basic introduction and will help you to solve any problems specific to your setup.

The principle OpenCL function flow is like this:

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.

There can be various reasons why OpenCL might fail during the initialization phase. OpenCL depends on hardware requirements and on the presence of certain drivers and libraries. In addition all these have to fit in terms of maker, model and revision number. If anything does not fit (e.g. your graphics driver – loaded as a kernel module – does not match the version of your libOpenCL.so) OpenCL support will likely not be available.

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

The scheduling of OpenCL devices can be optimized on most systems using the “OpenCL scheduling profile” settings. However, if your system is equipped with more than one GPU, you might want to set the relative device priority manually. To do this you need to select the “default” scheduling profile and change the settings in the “opencl_device_priority” configuration parameter.

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.

archivio

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

base dati

check for database maintenance: Indicates when darktable should check for database fragmentation and perform maintenance. Options are “never”, “on startup”, “on close” and “on both”. Each of these is also available with an additional “(don’t ask)” option to perform the checks automatically without prompting (default “on close”).
database fragmentation ratio threshold: Fragmentation ratio (in per cent) above which database maintenance should be performed (subject to the selection made in the option above) (default 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”).

altro

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

interfaccia

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

etichette

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

shortcuts with multiple instances

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

scorciatoie

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

preset

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.

User-defined presets can be imported from exported .dtpreset files using the “import” button at the bottom of the screen. You can export all user-defined presets to a single directory using the “export” button.

Opzioni lua

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

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

gestione del colore

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.

Profilo dello schermo

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.

metodi di rendering

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

Ansel può renderizzare i colori sia con l’algoritmo interno sia usando la libreria esterna LittleCMS2. Il metodo interno di Ansel è più veloce di quello esterno di un ordine di magnitudine. L’opzione esterna fornisce una scelta dell’intento di rendering e può offrire, in alcuni casi, un’accuratezza leggermente più alta.

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

Nota: se il profilo ICC è basato su LUT (Look Up Table) o contiene entrambi, LUT e matrice, Ansel userà LittleCMS2 per renderizzare i colori a prescindere dal valore del parametro di configurazione.

Intento di rendering

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.

spazi colore di Ansel

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

Le immagini di input sono sia file RGB (come i JPEG o i TIFF) or file RAW della fotocamera. Entrambi conservano le informazioni visive come combinazione di colori primari (rosso, verde e blu) i quali assieme descrivono l’emissione di luce da ricreare su un monitor.

La seguente immagine illustra questo concetto.

colori senza confini

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

Gli schermi e la maggior parte dei formati file immagine possono codificare solo intensità RGB che sono confinate all’interno di un certo intervallo. Per esempio, le immagini codificate con 8 bit possono contenere solo valori tra 0 e 255, immagini a 10 bit da 0 a 1023, e così via… Gli standard grafici assumono che il valore massimo di questo intervallo, a prescindere dal suo reale valore, rappresenterà sempre la luminosità massima che il dispositivo di visualizzazione è in grado di renderizzare, di solito tra 100 e 160 Cd/m² (Candela per metro quadrato, nit) a seconda dello standard reale. In generale chiamiamo questo valore il “100% riferito allo schermo”. Il valore minimo dell’intervallo, codificato con 0 a prescindere dal numero di bit utilizzati, diventa quindi lo “0% riferito allo schermo”. Il 100% codifica bianco assoluto, lo 0% codifica il nero assoluto.

possibili artefatti nei colori

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.

E’ stato riscontrato che sorgenti di luce blu altamente saturate nell’immagine sono giuste candidate per pixel con valori negativi di L. Se sei coinvolto in fotografia da palcoscenico dovresti portare grande attenzione a queste luci nell’immagine.

dimensione dei colori di Ansel

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

Questa sezione definisce le proprietà percettive del colore, sia concettualmente che quantitativamente, in modo tale da caratterizzare e quantificare in Ansel gli aggiustamenti creativi e correttivi al colore.

definizioni

Le proprietà del colore come “saturazione”, “luminosità” (brightness) o “tono” (lightness) sono arrivati all’uso comune ma sono in larga parte abusati e spesso usati per intendere cose diverse. Nella scienza dei colori, ciascuno di questi termini ha un significato preciso.

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.

This variant does not open any display – it works in pure console mode without launching a GUI. This mode is particularly useful for servers running background jobs.

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

The user must supply an input filename and an output filename. All other parameters are optional.

ansel-generate-cache

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

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

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

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

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

Ansel-cltest

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

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.

The script can be called with the following command line parameters:

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

Run the script with no options to perform a “dry run”, which generates a report of the missing files without committing any changes to the database.

Script con Luca

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

Ansel è fornito di un versatile linguaggio di scripting come interfaccia per potenziare le funzionalità.

Gli script luca possono essere usati per definire azioni da far eseguire a Ansel quando si scatena un evento. Un esempio potrebbe essere quello di chiamare un’applicazione esterna durante l’esportazione del file, in modo tale di aggiungere ulteriori passaggi di elaborazione al di fuori di Ansel.

Lua è un progetto indipendente fondato nel 1993, e fornisce un linguaggio di scripting potente, veloce, leggero e incorporabile. Lua è largamente usato da molte applicazioni open source, in programmi commerciali e per la programmazione di giochi.

principi base: file luarc

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

All’avvio, Ansel esegue automaticamente lo script Lua $Ansel/share/Ansel/luarc e $HOME/.config/Ansel/luarc (dove $Ansel rappresenta la directory di installazione di Ansel e $HOME rappresenta la tua home directory).

Questo è l’unico momento in cui Ansel eseguirà script Lua per conto suo. Questi script possono registrare dei callback per eseguire azioni sulla base di molti eventi di Ansel. Questi meccanismi di callback sono il metodo principale per attivare le azioni Lua.

un semplice esempio di lua

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

Cominciamo con un semplice esempio che permette di stampare a un po’ di codice. Crea un file chiamato luarc nella cartella di configurazione di Ansel (di solito $HOME/.config/Ansel/) e aggiungi le seguenti linee:

1print("Ciao mondo !")

Avvia Ansel e vedrai la frase “Ciao mondo!” stampata sulla console. Nulla di entusiasmante ma è un inizio.

A questo punto non c’è niente di specifico a Ansel nello script. Abbiamo semplicemente usato il print standard di Lua per stampare una stringa. E’ figo ma possiamo fare di meglio. Per accedere alle API di Ansel hai bisogno di includerle con require e salvarle l’oggetto in una variabile. Dopodiché puoi accedere alle API di Ansel come sotto-campi dell’oggetto restituito. Tutto ciò è documentato nel manuale di riferimento delle API Lua di Ansel.

stampare immagini etichettate

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

Il primo esempio ci ha mostrato i rudimenti di lua e ci ha permesso di verificare che tutto funzionasse. Facciamo adesso qualcosa di leggermente più complesso. Proviamo a stampare una lista di immagini che hanno allegata un’etichetta “rossa”. Ma, innanzitutto, cos’è un’immagine?

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

Lanciare il codice qui sopra produrrà un sacco di output. Ci guarderemo fra un attimo, ma prima guardiamo al codice stesso.

aggiungere una semplice scorciatoia

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

Fino ad ora, tutti i nostri script hanno effettuato operazioni durante la fase di avvio. Questo è di utilità limitata e non ci permette di reagire alle azioni dell’utente. Per fare operazioni più avanzate abbiamo bisogno di registrare una funzione che verrà chiamata da un dato evento. L’evento più comune a cui reagire è una scorciatoia da tastiera.

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

Adesso avvia Ansel, vai a “preferenze > scorciatoie > lua > Una scorciatoia che stampa i suoi parametri”, assegnagli una scorciatoia e provalo. Dovresti vedere un simpatico messaggio stampato a schermo.

esportare immagini con lua

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

Fino ad ora abbiamo imparato come usare lua per adattare Ansel al nostro particolare flusso di lavoro. Guardiamo ora a come usare lua per esportare facilmente le immagini verso un servizio online. Se sei in grado di caricare un’immagine verso un servizio utilizzando la linea di comando, allora puoi usare lua per integrarlo nell’interfaccia utente di Ansel.

Nel prossimo esempio useremo lua per esportare via scp. Una nuova destinazione apparire nella UI di Ansel per esportare immagini verso un obiettivo remoto usando il meccanismo di copia in ssh.

creare elementi di interfaccia grafica

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

Il nostro esempio precedente era un po’ limitato. In particolare, l’uso della preferenza per il percorso di esportazione non era molto carino. Possiamo fare di meglio aggiungendo un’elemento all’interfaccia utente nella finestra di dialogo dell’esportazione.

Gli elementi UI vengono create attraverso la funzione Ansel_new_widget. Questa riceve il tipo di widget come parametro e restituisce un nuovo oggetto corrispondente a quel widget. Puoi quindi impostare i vari campi in quel widget con i loro parametri. Potrai usare quell’oggetto come parametro per varie funzioni che verranno aggiunge alla UI di Ansel. Il seguente esempio aggiunge una libreria nel Tavolo Luminoso con una semplice etichetta:

condividere gli script

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

Fino a questo punto, tutto il nostro codice lua è in luarc. Questo è un buon modo per sviluppare il tuo script ma non è molto pratico per la distribuzione. Abbiamo bisogno di renderlo un modulo lua vero e proprio. Per fare ciò, salviamo il codice in un file separato (scp-storage.lua in questo caso):

 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 cercherà per gli script (seguendo le normali regole di lua) nella directory standard più $CONFIGDIR/lua/*.lua. Quindi il nostro script può essere richiamato semplicemente aggiungendo require "scp-storage" nel nostro file luarc. Un paio di note aggiuntive…

chiamare luca dal dbus

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

E’ possibile inoltrare un comando lua a Ansel usando l’interfaccia DBus. Il metodo org.Ansel.service.Remote.Lua chiede una stringa singola come parametro che viene eseguita come comando lua. Il comando verrà eseguito nel contesto lua corrente e dovrebbe restituire o nil o una stringa. Il risultato verrà ritornato come risultato del metodo DBus.

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

usare Ansel da uno script lua

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

Attenzione: questa feature è molto sperimentale. E’ appurato che molti elementi non funzionano ancora nella modalità library. Un testing accurato è altamente raccomandato.

L’interfaccia lua ti permette di usare Ansel da qualsiasi script lua. Questo caricherà Ansel come una libreria e ti fornirà la maggiorparte delle API lua (Ansel è in configurazione headless, quindi le funzioni relative all’interfaccia utente non sono disponibili).

Come esempio, il seguente programma stamperà la lista di tutte le immagini nella tua libreria:

API lua

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

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