GUI toolboxes 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

La funcionalidad en Ansel se divide en seis vistas diferentes:

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

Mesa de Luz

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

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

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

Lighttable content

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

Undo/redo

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

La mayoría de los cambios realizados dentro de la mesa de luz se registran y se pueden revertir a un estado anterior. Esto incluye modificaciones a las etiquetas de color, calificaciones, geolocalización, etiquetas, metadatos, orientación, copiar/pegar del historial, duplicación de imágenes o aplicación de un estilo. Tenga en cuenta que la posibilidad de deshacer/rehacer acciones es ilimitada en el número de pasos en la vista de mesa de luz, pero se restablece cada vez que cambia a una vista diferente.

Digital asset management

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

Sidecar files

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

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

Importing sidecar files generated by other applications

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

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

Local copies

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

Muchos usuarios tienen enormes colecciones de imágenes almacenadas en discos duros adicionales en su computadora de escritorio o en un medio de almacenamiento externo (RAID NAS, discos duros externos, etc.).

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

Thumbnails

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

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

Thumbnail creation

Una miniatura se crea cuando se importa una imagen a Ansel por primera vez, después de que se ha modificado una imagen en el cuarto oscuro o cuando se vuelve a visitar una imagen cuya miniatura ya no está disponible.

Star ratings & color labels

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

Las clasificaciones de estrellas y las etiquetas de color le ayudan a ordenar y clasificar las imágenes de acuerdo con sus propios criterios. La clasificación de estrellas y las etiquetas de color de una imagen se pueden mostrar sobre miniaturas en la vista de la mesa de luz y el módulo de tira de película.

Star ratings

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

Image grouping

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

La agrupación de imágenes ayuda a mejorar la estructura y la claridad de su colección de imágenes cuando se muestran en la vista de la mesa de luz.

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.

Las imágenes duplicadas se agrupan automáticamente. De manera similar, si importa varias imágenes desde el mismo directorio, con el mismo nombre base, pero con diferentes extensiones (p. Ej., IMG_1234.CR2 eIMG_1234.JPG), esas imágenes automáticamente forman un grupo.

Metadata and tagging

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

Ansel le permite almacenar información adicional sobre sus imágenes para permitir que se puedan buscar y agrupar más fácilmente. Esta información se almacena en la base de datos de Ansel y en los archivos de sidecar XMP y también se puede incluir en las imágenes exportadas.

Metadata

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

Cuarto oscuro

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

La vista del cuarto oscuro es donde desarrolla sus imágenes. El panel central contiene la imagen que se está editando actualmente.

Zoom

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

Alternativamente, puede hacer zoom entre 1: 1 y “ajustar a la pantalla” desplazándose con el ratón. Desplácese mientras mantiene presionada la tecla Ctrl para extender el rango de zoom entre 2: 1 y 1:10.

Darkroom view layout

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

Left panel

De arriba a abajo:

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

Right panel

De arriba a abajo:

The pixelpipe

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

The anatomy of a processing module

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

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

The pixelpipe & module order

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

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

El orden del pixelpipe se representa gráficamente por el orden en el que se presentan los módulos en la interfaz de usuario: el pixelpipe comienza con una imagen RAW en la parte inferior de la lista de módulos y aplica los módulos de procesamiento uno por uno, acumulando capas sobre capa de procesamiento de abajo hacia arriba, hasta que alcanza la parte superior de la lista, donde genera la imagen completamente procesada.

The history stack

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

La pila de historial almacena todo el historial de edición de una imagen determinada, en el orden en que se aplicaron esas ediciones. Se guarda en la base de datos de la biblioteca de Ansel y en el archivo sidecar XMP de la imagen y persiste entre las sesiones de edición.

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

Undo and redo

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

Mientras edita su imagen, Ansel registra todas las modificaciones que realiza en esa imagen. Esto significa que es posible deshacer y rehacer cambios para recuperar un estado de edición anterior. Tenga en cuenta que la función de deshacer / rehacer es ilimitada en el número de pasos durante la edición de una imagen, pero se restablece cada vez que se cambia el cuarto oscuro a una nueva imagen.

Presione Ctrl + Z para deshacer la última modificación y Ctrl + Y para rehacer la última modificación deshecha (si corresponde).

Masking & blending

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

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

Los datos de salida de un módulo se pueden reprocesar (combinar) opcionalmente con sus datos de entrada antes de pasarlos al siguiente módulo. Este paso de procesamiento adicional se llama fusión– los datos de entrada y salida se reprocesan utilizando algoritmos llamados operadores de combinación o modos de combinación.

Blend modes

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

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

Los modos de fusión clásicos, diseñados para RGB referido a la pantalla (restringido a 0-100%), definen implícitamente un punto de apoyo al 50% (gris) o al 100% (blanco) en sus algoritmos, según el modo de fusión. Debido a que la referencia a la escena no está sujeta a estas restricciones, este punto de apoyo debe ser definido explícitamente por el usuario al realizar operaciones de combinación en el espacio de color “RGB (escena)”. El parámetro adicional punto de apoyo de fusión se presentará al usuario cuando utilice uno de estos modos de fusión en este espacio de color. El efecto depende del operador utilizado. Por ejemplo, los valores por encima del fulcro pueden iluminarse y los valores por debajo de oscurecerse, o viceversa.

Masks

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

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

Una máscara se puede considerar como una imagen en escala de grises en la que cada píxel tiene un valor entre 0 y 1,0 (o entre 0% y 100%). Este valor es la opacidad y se usa para determinar cuánto afecta un módulo a cada píxel.

Las siguientes secciones explican cómo construir máscaras en Ansel.

Drawn masks

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

Con la función de máscara dibujada, puede construir una máscara dibujando formas directamente en el lienzo de la imagen. Las formas se pueden utilizar solas o combinadas. Una vez que se ha dibujado una forma en una imagen, se puede ajustar, eliminar o reutilizar en otros módulos.

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

Parametric masks

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

La función de máscara paramétrica ofrece un control selectivo detallado sobre cómo se enmascaran los píxeles individuales. Lo hace generando automáticamente una máscara de mezcla intermedia a partir de parámetros definidos por el usuario. Estos parámetros son coordenadas de color en lugar de coordenadas geométricas utilizadas en las máscaras dibujadas.

Para cada canal de datos de un módulo (por ejemplo, Lab, RGB) y varios canales de datos virtuales (por ejemplo, tono, saturación) puede construir una función de opacidad por canal. Dependiendo del valor de cada píxel para un canal de datos dado, esta función calcula un factor de combinación entre 0 y 1 (100%) para ese píxel.

Combining drawn & parametric masks

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

Las máscaras dibujadas y paramétricas se pueden usar en combinación para formar una sola máscara que se puede aplicar a un módulo.

Hay dos elementos principales que controlan cómo se combinan las máscaras individuales: la configuración de polaridad de cada máscara individual (definida por los botones más o menos) y la configuración en el cuadro combinado “combinar máscaras”.

El cuadro combinado “combinar máscaras” contiene las siguientes opciones, que definen cómo se combinarán las máscaras dibujadas y paramétricas:

Mask refinement & additional controls

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

Cuando una máscara paramétrica o dibujada está activa, se muestran varios controles deslizantes adicionales que permiten refinar aún más la máscara.

umbral de detalles: Este control le permite alterar la opacidad de la máscara según la cantidad de detalle de la imagen. Utilice este control deslizante para seleccionar áreas con muchos detalles (valores positivos) o áreas planas y sin detalles (valores negativos). El valor predeterminado (cero) omite efectivamente el refinamiento de detalles. Esto es principalmente útil para aplicar efectos de nitidez y desenfoque que ignoran las regiones desenfocadas (bokeh) o para enfocar solo las partes borrosas, evitando que las regiones enfocadas se agudicen demasiado.

Nota: Los datos usados para el refinamiento de la máscara de detalle se toman de la etapa de interpolación cromática en la tubería de procesamiento, y no de la entrada del módulo (que se usa para los otros criterios de máscara paramétrica). Ninguno de los módulos de procesamiento posteriores a interpolación cromática tendrá ningún efecto en la máscara de detalle y actualmente no está disponible para imágenes no RAW.

Raster masks

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

Como se describe en las secciones anteriores, el resultado final de la máscara de un módulo (el efecto combinado de cualquier máscara dibujada y paramétrica) es una imagen de mapa de bits en escala de grises que representa la medida en que el efecto del módulo debe aplicarse a cada píxel. Esta imagen de mapa de bits se almacena internamente para los módulos activos y puede ser reutilizada posteriormente por otros módulos en el pixelpipe.

Processing modules

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

Color equalizer

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

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

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

The user interface is meant to stay perceptually even:

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

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

Photographic grain

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

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

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

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

Drawing

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

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

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

The intended use cases are:

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

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

Final resampling

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

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

Action

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

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

Astrophoto denoise

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

Remove image noise while preserving structure.

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

Como la eliminación de ruido es un proceso que consume muchos recursos, ralentiza significativamente el procesamiento de pixelpipe. Considere activar este módulo al final de su flujo de trabajo.

Blurs

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

Simular desenfoques físicamente precisos en un espacio RGB referido a escena

Blur types

Se proveen tres tipos de desenfoque:

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

Un diagrama en la parte superior del módulo muestra la forma del operador de desenfoque (conocido como función de dispersión de puntos ). El módulo convertirá cada punto luminoso de la escena en una mancha con la forma del operador de desenfoque mostrado, con el tamaño de la mancha definido por el radio de desenfoque.

Censorize

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

Degradar partes de la imagen de una manera estéticamente agradable, para anonimizar personas/objetos u ocultar partes del cuerpo.

Censorize funciona en el espacio de color RGB lineal para aplicar un desenfoque gaussiano y un ruido de luminancia gaussianos físicamente precisos.

Además del anonimato, este módulo también se puede utilizar para una amplia gama de propósitos creativos, por ejemplo:

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: Los métodos de anonimización proporcionados por este módulo no son seguros desde el punto de vista forense para favorecer así la estética. Es posible que algunas técnicas forenses aún puedan reconstruir el contenido censurado en función de su estructura, especialmente para formas y texto simples (por ejemplo, placas de matrícula, números de calles).

Chromatic aberrations

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

Corrige la aberración cromática.

A diferencia del módulo de aberración cromática raw, este módulo no necesita información en raw como entrada.

Workflow

Para obtener mejores resultados, se sugiere que siga los siguientes pasos:

Atenúe la aberración cromática lo más posible en el módulo de corrección de lente usando los deslizadores de ACT.
Incremente el deslizador de intensidad en este módulo para ver mejor su efecto.
Incremente el radio hasta que las aberraciones cromáticas desaparezcan. Si esto es insuficiente, intente activar la opción de “aberración cromática muy acentuada”.
Elija la opción de guía que dé mejores resultados en términos de enfoque y artefactos.
Reduzca la intensidad para evitar diluir mucho los colores.

Para casos más complicados, también puede probar lo siguiente:

Color balance rgb

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

Un módulo avanzado que trae herramientas de gradación de color de la cinematografía a la canalización referida a la escena fotográfica.

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

Introduction

La gradación de color es una parte importante de la edición de imágenes. Puede ayudar a eliminar los matices de color no deseados y también puede ofrecer un toque de color creativo que agregará atmósfera a sus imágenes. En los días de la fotografía de películas, la mayor parte del ambiente de color se obtenía con la emulsión de película y los productos químicos de revelado, y se realizaba cierta sincronización del color bajo la ampliadora con cabezales de color. Esto consumía recursos costosos y se reservaba principalmente para la industria del cine, donde el trabajo lo realizaba un colorista.

Color calibration

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

Una corrección de espacio de color con todas las funciones, módulo de ajuste de equilibrio de blancos y mezclador de canales.

Este módulo simple pero poderoso se puede usar de las siguientes maneras:

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

Color look up table

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

A generic color look up table implemented in Lab space.

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

Module controls

color board: The color board grid shows a list of colored patches. The colors of the patches are the source points. The target color of the selected patch is shown as offsets which are controlled by sliders beneath the color board. An outline is drawn around patches that have been altered (where the source and target colors differ).; Haga clic en un parche para seleccionarlo o utilice el cuadro combinado o el selector de color. El parche seleccionado actualmente está marcado con un cuadrado blanco y su número se muestra en el cuadro combinado de abajo.

Color reconstruction

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

Recupere la información de color en las luces altas sobreexpuestas.

Debido a la naturaleza de los sensores digitales, las luces altas sobreexpuestas carecen de información de color válida. Con mayor frecuencia, aparecen en blanco neutro o exhiben algún matiz de color, dependiendo de qué otros pasos de procesamiento de imágenes estén involucrados. Este módulo se puede utilizar para “curar” los reflejos sobreexpuestos reemplazando sus colores por otros que se ajusten mejor. El módulo actúa sobre píxeles cuya luminancia excede un umbral definido por el usuario. Los colores de reemplazo se toman de los píxeles vecinos. Tanto la distancia espacial como la distancia de luminancia (rango) se tienen en cuenta para la selección de color.

Color zones

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

Ajuste selectivamente la luminosidad, la saturación y el tono de los píxeles en función de su luminosidad, saturación y tono actuales.

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.

Primero debe elegir si desea ajustar (seleccionar) píxeles en función de su luminosidad, saturación o tono. A continuación, puede utilizar tres curvas, en sus respectivas pestañas, para ajustar la luminosidad, la saturación y el tono de los rangos de píxeles seleccionados mediante este método.

Contrast equalizer

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

Ajuste la luminancia y el contraste cromático en el dominio de ondículas.

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.

Se proporcionan varios ajustes preestablecidos, que deberían ayudarlo a comprender las capacidades del módulo.

Crop

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

Crop an image using on-screen guides.

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

Siempre que este módulo esté en el foco, se mostrará la imagen completa sin recortar, superpuesta con controles de recorte y líneas de guía opcionales.

Demosaic

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

Controla cómo son interpolados cromáticamente los ficheros RAW

Bayer filters

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

Denoise (profiled)

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

Un módulo de eliminación de ruido fácil de usar y altamente eficiente, adaptado a los perfiles de ruido individuales de una amplia gama de sensores de cámara.

Un problema con muchos algoritmos de eliminación de ruido es que asumen que la varianza del ruido es independiente de la luminosidad de la señal. Al perfilar las características de ruido del sensor de una cámara en diferentes configuraciones ISO, se puede evaluar la variación en diferentes luminosidades y se puede ajustar el algoritmo de eliminación de ruido para suavizar el ruido de manera más uniforme.

Diffuse or sharpen

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

La difusión es una familia de procesos físicos por los cuales las partículas se mueven y se esparcen gradualmente con el tiempo, desde una fuente que las genera. En el procesamiento de imágenes, la difusión ocurre principalmente en dos lugares:

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

En ambos casos, la difusión hace que la imagen sea menos nítida al “filtrar” partículas y suavizar las variaciones locales.

Dithering

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

Este módulo elimina algunos de los artefactos de bandas que pueden resultar cuando los datos internos de coma flotante de 32 bits de Ansel se transfieren a un formato de salida entero discreto de 8 o 16 bits para su visualización o exportación.

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

Exposure

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

Aumente o disminuya el brillo general de una imagen.

Este módulo tiene dos modos de funcionamiento:

manual: Configure la exposición, el nivel de negro y el umbral de recorte manualmente
automático (solo imágenes RAW): Utilice un análisis del histograma de la imagen para establecer automáticamente la exposición. Ansel selecciona automáticamente la compensación de exposición que se requiere para cambiar el percentil seleccionado al nivel objetivo seleccionado (consulte las definiciones a continuación). Este modo es particularmente útil para alterar automáticamente una gran cantidad de imágenes para que tengan la misma exposición. Un caso de uso típico del modo automático es el deslumbramiento de fotografías de time-lapse.

Module controls

modo: Elija el modo de funcionamiento (automático / manual).
compensar la exposición de la cámara (modo manual): Elimina automáticamente el sesgo de exposición de la cámara (tomado de los datos Exif de la imagen).
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.
umbral de recorte (modo manual): Defina qué porcentaje de valores de brillo se recortarán en el cálculo de la exposición y la corrección del nivel de negro. Utilice el selector de color para tomar una muestra de una parte de la imagen que se utilizará para este cálculo.
percentil (modo automático): Defina una ubicación en el histograma que se utilizará para la corrección automática de la exposición. Un percentil del 50% denota una posición en el histograma donde el 50% de los valores de píxeles están por encima y el 50% de los valores de píxeles están por debajo de esa exposición.
nivel objetivo (modo automático): Defina el nivel objetivo para la corrección de exposición automática (EV) en relación con el punto blanco de la cámara.
corrección del nivel de negro (modos manual y automático): Ajuste el punto de nivel de negro para eliminar los valores RGB negativos.

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

Filmic rgb

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

Remapea la gama tonal de una imagen reproduciendo el tono y la respuesta de color de una película clásica.

Este módulo se puede utilizar para expandir o contraer el rango dinámico de la escena para adaptarse al rango dinámico de la pantalla. Protege los colores y el contraste en los medios tonos, recupera las sombras y comprime las altas luces y las sombras oscuras. Los aspectos más destacados necesitarán un cuidado especial cuando sea necesario preservar los detalles (por ejemplo, nubes).

Framing

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

Generate a frame around the image.

El marco consta de un borde (con un color definido por el usuario) y una línea de marco dentro de ese borde (con un segundo color definido por el usuario). Hay varias opciones disponibles para controlar la geometría y el color del marco.

Module controls

tamaño del borde: El tamaño del fotograma como porcentaje de la imagen completa subyacente.
relación de aspecto: La relación de aspecto del módulo final de salida (esto es, la imagen subyacente más el marco)
orientación: La orientación del encuadre (retrato / paisaje). Seleccione ‘auto’ para Ansel para elegir la orientación más razonable según la imagen subyacente.
posición horizontal/vertical: Seleccione de un conjunto de proporciones predefinidas para controlar dónde se colocará la imagen subyacente en el eje horizontal/vertical. También puede hacer clic derecho e ingresar su propia proporción como “x/y”.
tamaño de la línea del marco: El porcentaje del tamaño de la línea del marco, en relación con el tamaño del borde en su parte más pequeña.
desplazamiento de la línea del marco: La posición de la línea del marco, en relación con la imagen subyacente. Elija 0% para una línea de marco que toque la imagen. Elija 100% para una línea de marco que toque el borde exterior.
color del borde/color de la línea del marco: Un par de selectores de color que permiten definir los colores de la línea del borde y del marco. Al hacer clic en el campo de color, se abrirá un cuadro de diálogo de selección de color que ofrece una selección de colores de uso común o le permite definir un color en el espacio de color RGB. También puede activar un selector de color para tomar una muestra de color de la imagen.
show guides: Tick the box to show guide overlays whenever the module is activated. Click the icon on the right to control the properties of the guides. See guides & overlays for details.

Graduated density

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

Simule un filtro de densidad graduado para corregir la exposición y el color de forma progresiva.

Se muestra una línea en la pantalla que permite modificar la posición y rotación del degradado con el ratón.

Se sabe que este módulo provoca artefactos de bandas en determinadas condiciones. Debería considerar activar el módulo [_suavizado _](./ dithering.md) para aliviar estos problemas.

Module controls

densidad: Establece la densidad del filtro (EV). Un valor bajo subexpone ligeramente mientras que un valor alto crea un filtro fuerte.
dureza: La progresividad del gradiente. Un valor bajo crea una transición suave, mientras que un valor alto hace que la transición sea más abrupta.
rotación: La rotación del filtro. Los valores negativos giran en el sentido de las agujas del reloj. La rotación también se puede establecer arrastrando el final de la línea de degradado con el ratón.
matiz: Elija un tono para agregar un matiz de color al degradado.
saturación: La saturación de la tonalidad de color para agregar al degradado (el valor predeterminado es una tonalidad de color neutro de 0)

Grain

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

Simula el grano de una película analógica. El grano se procesa en el canal L del espacio de color Lab.

Module controls

tosquedad: El tamaño de grano, escalado para simular un número ISO.
fuerza: La fuerza del efecto.

Haze removal

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

Reduce automáticamente el efecto del polvo y la bruma en la atmósfera. Este módulo también puede emplearse de manera más general para dar a las imágenes un refuerzo de color específicamente en las regiones de la imagen de bajo contraste.

La neblina absorbe la luz de los objetos en la escena, pero también es una fuente de luz de fondo difusa. El módulo de eliminación de neblina primero estima, para cada región de la imagen, la cantidad de neblina en la escena. A continuación, elimina la luz de fondo difusa según su intensidad local y recupera la luz original del objeto.

Highlight reconstruction

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

Intente reconstruir la información de color de los píxeles recortados en uno o más canales RGB.

Si estos píxeles se dejan parcialmente recortados, pueden aparecer colores poco realistas en la imagen. Por ejemplo, los píxeles con los canales verde y azul recortados aparecerán en rojo sin ninguna reconstrucción de resaltado.

Hay tres métodos de reconstrucción disponibles:

recorte de luces altas: Fije todos los píxeles al nivel de blanco (es decir, recorte los canales de color restantes). Este método es más útil en los casos en que se producen reflejos recortados en objetos naturalmente desaturados (por ejemplo, nubes).
reconstruir en LCh: Analice cada píxel con al menos un canal recortado e intente corregir el píxel recortado (en el espacio de color LCh) utilizando los valores de los otros píxeles (3 para Bayer u 8 para X-Trans) en el bloque de sensor afectado. Los reflejos reconstruidos seguirán siendo monocromos, pero más brillantes y con más detalles que con los “reflejos de clip”. Este método funciona bastante bien con una curva base de alto contraste, lo que hace que las altas luces se desaturen. Al igual que con recorte de luces altas, este método es una buena opción para objetos naturalmente desaturados.
reconstruir el color: Utilice un algoritmo que transfiera información de color de un entorno sin recortar a las luces recortadas. Este método funciona muy bien en áreas con colores homogéneos y es especialmente útil en tonos de piel con reflejos que se desvanecen suavemente. Tenga en cuenta que este método puede producir artefactos en forma de laberinto en las luces detrás de los bordes de alto contraste, por ejemplo, estructuras finas bien expuestas frente a un fondo sobreexpuesto.
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).

Hot pixels

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

Automatically detect and eliminate hot pixels.

Los píxeles calientes son píxeles que no han podido registrar un nivel de luz correctamente. Los píxeles calientes detectados se reemplazan por un promedio de sus vecinos.

Module controls

umbral: Cómo de fuerte debe desviarse el valor de un píxel del de sus vecinos para ser considerado un píxel caliente.
fuerza: La fuerza de fusión de los píxeles calientes con su entorno.
detectar por 3 vecinos: Amplíe la detección de píxeles calientes: considere un píxel como caliente si un mínimo de solo tres (en lugar de cuatro) píxeles vecinos se desvía más que el nivel de umbral.
marcar píxeles fijos: Marqua visualmente los píxeles corregidos en la imagen y muestre un recuento de píxeles calientes que se han corregido.

Input color profile

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

Define how Ansel will interpret the colors of the image.

Este módulo toma el espacio de color utilizado por la fuente de la imagen (por ejemplo, cámara, escáner) y convierte las codificaciones de píxeles en un espacio de color de trabajo estandarizado. Esto significa que los módulos subsiguientes en la tubería no necesitan preocuparse por los detalles del dispositivo de entrada, y pueden trabajar con y convertir a/desde un espacio de color de trabajo común.

Lens correction

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

Corrige automáticamente (y simula) la distorsión de la lente, las aberraciones cromáticas transversales (TCA) y el viñeteado.

Este módulo identifica la combinación de cámara/lente a partir de los datos Exif de la imagen y utiliza la biblioteca lensfun externa para proporcionar parámetros de corrección.

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

Liquify

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

Mueva los píxeles aplicando distorsiones de estilo libre a partes de la imagen utilizando puntos, líneas y curvas.

Nodes

Cada una de las herramientas de licuar se basa en nodos. Un punto consta de un solo nodo y una línea o curva consta de una secuencia de nodos vinculados que definen una ruta.

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

Local contrast

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

Mejora el contraste local de la imagen.

Esto se logra utilizando un filtro laplaciano local (predeterminado) o un filtro bilateral no normalizado. Ambos modos funcionan exclusivamente en el canal L de Lab. El filtro laplaciano local ha sido diseñado para ser robusto contra efectos de halo no deseados e inversiones de gradiente a lo largo de los bordes.

Module controls

modo: Elección de filtro laplaciano local o _ cuadrícula bilateral_. Las siguientes secciones definen los controles disponibles para cada uno de estos modos.

Bilateral grid

detalle: Ajusta el detalle de los detalles que se van a ajustar.
contraste: Controla la fuerza con la que el algoritmo distingue entre niveles de brillo. Aumente este parámetro para una apariencia más contrastada.
detalle: Agregue o elimine detalles. Los valores más altos aumentan el contraste local.

Local laplacian

Para comprender los parámetros del filtro laplaciano local, se puede pensar en aplicar una curva a la imagen, similar a la siguiente gráfica:

Lut 3D

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

Transforma los valores RGB con un archivo LUT 3D.

Una LUT 3D es una tabla tridimensional que se utiliza para transformar un valor RGB dado en otro valor RGB. Normalmente se utiliza para simulación de películas y gradación de color.

Este módulo acepta archivos .cube,.3dl, .png (haldclut) y.gmz. Los datos de 3D LUT sin comprimir no se guardan en la base de datos ni en el archivo XMP, sino que se guardan en la ruta del archivo 3D LUT dentro de la carpeta raíz de 3D LUT. Por lo tanto, es importante hacer una copia de seguridad de su carpeta 3D LUT correctamente; compartir una imagen con su XMP no tiene sentido si el destinatario no tiene el mismo archivo 3D LUT en su propia carpeta 3D LUT.

Negadoctor

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

Process scanned film negatives.

Puede obtener una imagen de un negativo utilizando un escáner de película, o fotografiándolo contra una luz blanca (por ejemplo, una mesa de luz o un monitor de computadora) o un flash fuera de la cámara.

Preparation

Si la imagen del negativo se obtuvo con una cámara digital, para obtener colores precisos en la imagen final, deberá tener en cuenta los siguientes puntos:

Orientation

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

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

El módulo está habilitado de forma predeterminada y la orientación (rotación)se establece automáticamente en función de los datos Exif de la imagen.

Module controls

transformar: Haga doble clic en la etiqueta para restablecer a las transformaciones por defecto de la imagen
rotate counter-clockwise: Rotate the image 90 degrees counter-clockwise
rotate clockwise: Rotate the image 90 degrees clockwise
flip horizontally: Flip the image (mirror) horizontally
flip vertically: Flip the image (mirror) vertically
show guides: Tick the box to show guide overlays whenever the module is activated. Click the icon on the right to control the properties of the guides. See guides & overlays for details.

Output color profile

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

Gestiona el perfil de salida al exportar y la representación de color usada al mapear entre espacios de color.

Ansel viene con perfiles predefinidos sRGB, Adobe RGB, XYZ y RGB lineal. Puede proveer perfiles adicionales al ubicarlos en $Ansel/share/Ansel/color/outy$HOME/.config/Ansel/color/out(donde $Anseles el directorio de instalación de Ansel y$HOME` es su directorio personal).

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

Module controls

output intent: The rendering intent for output/export. Rendering intent can only be selected when using LittleCMS2 to apply the output color profile (this can be changed in preferences > processing). If Ansel’s internal rendering routines are used, this option is hidden. For more details see rendering intent.
perfil de salida: El perfil utilizado para representar colores para salida/exportación. Los datos del perfil se incrustarán en el archivo de salida (si es compatible con el formato de archivo) permitiendo que otras aplicaciones interpreten correctamente sus colores. Como no todas las aplicaciones conocen los perfiles de color, la recomendación general es ceñirse a sRGB a menos que sepa lo que está haciendo y tenga una buena razón para hacer lo contrario.

Raw black/white point

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

Define camera-specific black and white points.

Este módulo se activa automáticamente para todas las imágenes sin procesar. La configuración predeterminada se aplica a todas las cámaras compatibles. Normalmente no se requieren cambios en los valores predeterminados.

Module controls

nivel de negro 0-3: El nivel de negro específico de la cámara de los cuatro píxeles en el patrón RGGB Bayer. No se considera que los píxeles con valores inferiores a este nivel contengan datos válidos.
punto blanco: El nivel de blanco específico de la cámara. Es probable que todos los píxeles con valores por encima de este se recorten y se manejen en consecuencia en el módulo reconstrucción de luces altas.
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.

Raw chromatic aberrations

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

Corrija las aberraciones cromáticas de las imágenes RAW.

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

Raw denoise

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

Perform denoising on raw image data before it is demosaiced.

Este módulo se ha portado desde dcraw .

Module controls

umbral de ruido: El umbral para la detección de ruido. Los valores más altos conducen a una mayor eliminación de ruido y una mayor pérdida de detalle de la imagen.
coarse/fine curves: The noise of an image is usually a combination of fine-grained and coarse-grained noise. These curves allow the image to be denoised more or less depending on the coarseness of the visible noise. The left of the curve will act on very coarse grain noise, while the right of the curve will act on very fine grain noise.; Raising the curve will result in more smoothing, while lowering it will result in less smoothing. As an example, you can preserve very fine-grained noise by pulling down the rightmost point of the curve to the minimum value.

Retouch

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

Elimine los elementos no deseados de su imagen clonando, saneando, difuminando y rellenando con formas dibujadas.

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

Rgb curve

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

Una herramienta clásica de fotografía digital para alterar los tonos de una imagen mediante curvas.

Active el selector de color de la izquierda para mostrar los valores seleccionados en el gráfico (Ctrl + clic o click derecho para usar el selector en el modo de área). Los valores numéricos (Lab) de la entrada y salida (ver más abajo) en el área o área seleccionada se muestran en la parte superior izquierda del gráfico.

Rgb levels

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

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

La herramienta de niveles rgb muestra un histograma de la imagen y muestra tres barras con controles. Arrastre las manijas para modificar los puntos negro, gris medio y blanco en luminosidad (en modo “RGB, canales vinculados”) o de forma independiente para cada uno de los canales R, G y B (en modo “RGB, canales independientes”).

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

Rotate and perspective

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

Corrige automáticamente las líneas convergentes, una forma de distorsión de la perspectiva. El mecanismo subyacente está inspirado en el programa ShiftN de Markus Hebel. Este módulo también permite ajustar la rotación de la imagen.

Las distorsiones de perspectiva son un efecto natural cuando se proyecta una escena tridimensional en un plano bidimensional y hacen que los objetos cercanos al espectador parezcan más grandes que los objetos más lejanos. Las líneas convergentes son un caso especial de distorsiones de perspectiva que se ven con frecuencia en fotografías de arquitectura. Las líneas paralelas, cuando se fotografían en ángulo, se transforman en líneas convergentes que se encuentran en algún punto final dentro o fuera del marco de la imagen.

Rotate pixels

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

Los sensores de algunas cámaras (como Fujifilm FinePix S2Pro, F700 y E550) tienen un patrón Bayer orientado diagonalmente en lugar del diseño ortogonal habitual.

Sin la corrección, esto daría lugar a una imagen inclinada con esquinas negras. Este módulo aplica la rotación requerida.

Ansel detecta imágenes que necesitan corrección utilizando sus datos Exif y activa automáticamente este módulo cuando sea necesario. Para otras imágenes, el módulo siempre permanece desactivado.

El módulo no tiene controles.

Scale pixels

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

Algunas cámaras (como la Nikon D1X) tienen celdas sensoras rectangulares en lugar de las cuadradas habituales. Sin corrección, esto daría lugar a imágenes distorsionadas. Este módulo aplica la escala requerida.

El módulo no tiene controles.

Sharpen

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

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

Este módulo funciona aumentando el contraste alrededor de los bordes y, por lo tanto, mejorando la senación de nitidez de una imagen. Este módulo se aplica al canal L en el espacio de color Lab.

Nota: El algoritmo USM utilizado en este módulo realiza desenfoques en el espacio de color Lab, lo que puede producir efectos no deseados y ya no se recomienda. En su lugar, utilice los ajustes preestablecidos que ofrece el módulo ecualizador de contraste para desenfoque o el módulo contraste local para nitidez general.

Surface blur

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

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

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

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

Tone equalizer

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

Oscurece y quema conservando el contraste local.

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

El siguiente diagrama describe cómo funciona el ecualizador de tonos:

Unbreak input profile

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

Agregue una curva de corrección a los datos de la imagen. Esto es necesario si ha seleccionado determinados perfiles de entrada en el módulo perfil de color de entrada.

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

Vignetting

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

Apply a vignetting effect to the image.

El viñeteado es una modificación del brillo y la saturación en los bordes de la imagen en una forma específica. Muchos de los parámetros que se enumeran a continuación también se pueden modificar con un control gráfico que superpone la imagen cuando el módulo tiene el foco, mostrando la forma y extensión del efecto.

Nota: Se sabe que este módulo provoca artefactos de bandas en determinadas condiciones. Debería considerar activar el módulo [tramado](./ dithering.md) para aliviar esto.

Watermark

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

Renderice una superposición basada en vectores en su imagen. Las marcas de agua son documentos SVG estándar y se pueden diseñar utilizando Inkscape .

Pueden usarse también imágenes de mapa de bits (PNG).

El procesador SVG en Ansel también puede sustituir cadenas dentro de un documento SVG, lo que permite incluir información dependiente de la imagen en la marca de agua.

Las marcas de agua diseñadas por el usuario deben colocarse en el directorio $HOME/.config/Ansel/watermarks. Una vez en su lugar, use el botón de recarga para actualizar la lista de marcas de agua disponibles.

White balance

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

Ajuste el balance de blancos de la imagen modificando la temperatura y el tinte, definiendo un coeficiente para cada canal RGB o eligiendo de la lista de ajustes de balance de blancos predefinidos.

La configuración predeterminada de este módulo se deriva del balance de blancos de la cámara almacenado en los datos Exif de la imagen.

El balance de blancos no pretende ser un módulo “creativo”; su objetivo principal es corregir técnicamente el balance de blancos de la imagen, asegurando que los objetos de colores neutros en la escena se representen con colores neutros en la imagen. Para las operaciones de color creativas, normalmente es mejor utilizar otros módulos como calibración de color o balance de color RGB.

Mapa

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.

Presentación de diapositivas

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

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

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

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

Usage

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

La vista de presentación de diapositivas aún se encuentra en una etapa temprana de desarrollo con solo un conjunto básico de características.

 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

Sugerencia: Para aprovechar al máximo el tamaño de su pantalla, ponga Ansel en modo de pantalla completa presionando F11 y oculte los controles de borde presionando la tecla B.

Imprimir

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.

Este módulo admite el perfil ICC de la impresora, que es algo obligatorio si desea obtener una impresión de alta calidad cercana a la imagen que se muestra en la pantalla.

Print view layout

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

El área central muestra el diseño de la imagen en el papel (el área blanca). Es posible que aparezcan algunos bordes grises alrededor de la imagen para representar el área imprimible (la página menos los bordes) no rellenada por la imagen.

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

Notes

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

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

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

Clipping warning

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

Resalta las áreas de la imagen que pueden presentar recorte de luminancia o gama.

Cuando se envía una imagen a un dispositivo de visualización, cada píxel se representa normalmente como un conjunto de 3 números, que representan la intensidad de los colores primarios rojo, verde y azul en el espacio de color de salida. Debido a que el espacio de color de salida suele estar estrechamente relacionado con el hardware con limitaciones físicas, existe un valor máximo permitido para los canales [R, G, B], que representa la intensidad máxima disponible para ese espacio de color. Del mismo modo, también hay un valor mínimo por debajo del cual los valores de píxeles se asignarán a cero. Cuando intentamos convertir de un espacio de color más grande al espacio de color de salida final, cualquier valor que exceda este máximo se fijará al valor máximo, y cualquier valor por debajo del mínimo se fijará a cero. Este proceso se denomina “recorte” y provocará la pérdida de detalles o colores “incorrectos” para los píxeles con canales recortados.

Color assessment

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

Evalúe los colores y el brillo de su imagen utilizando las condiciones de visualización recomendadas por ISO 12646: 2008.

Al revelar una imagen, la forma en que percibimos el brillo, el contraste y la saturación está influenciada por las condiciones ambientales circundantes. Si una imagen se muestra sobre un fondo oscuro, esto puede tener una serie de efectos adversos en nuestra percepción de esa imagen:

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)

El resultado final es que la imagen final puede terminar siendo demasiado oscura y demasiado procesada en términos de contraste y saturación de color. Para evitar esto, la norma “ISO 12646: 2008” hace algunas recomendaciones sobre las condiciones bajo las cuales se deben evaluar los colores de una imagen. El módulo de evaluación de color en el cuarto oscuro coloca un marco alrededor de la imagen para ayudar al usuario a evaluar mejor los colores de la imagen, de acuerdo con las recomendaciones.

Display metadata

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

Muestra la información incrustada dentro de los datos Exif de una imagen, así como una serie de campos de datos adicionales definidos por Ansel.

Al pasar el ratón sobre las miniaturas de imágenes, los datos presentados se actualizan automáticamente para mostrar información sobre la imagen que se encuentra actualmente debajo del cursor del ratón.

Cuando varias imágenes están seleccionadas y el foco no está en una sola imagen, el módulo solo muestra la información común para todas las imágenes. Si algún campo difieres, el texto “<valores varios>” se muestra en su lugar.

Duplicate manager

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

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

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

Export

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

Exportar imágenes seleccionadas.

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

Module controls

Storage options

almacenamiento de destino

El tipo de ubicación para almacenar las imágenes seleccionadas. Se implementan varios back-end diferentes, incluido el archivo en disco, una plantilla de libro LaTeX y varios álbumes web. Dependiendo del objetivo seleccionado, se le pedirá que proporcione información adicional, como nombres de archivo o nombre de cuenta y contraseña.

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.

Selector de directorio de salida

El botón junto al modelo de entrada del nombre de archivo abre un cuadro de diálogo para seleccionar el directorio principal para exportar.

en conflicto

Elija qué hacer si el nombre de archivo generado entra en conflicto con un archivo existente en la exportación:

crear único archivo: elige automáticamente un nuevo nombre de archivo único agregando un número entero al nombre de archivo en conflicto.

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.

omitir: no exporta imágenes donde el nombre de archivo de destino ya existe.

Format options

formato de archivo: Elija el formato de archivo para la imagen exportada. Opciones adicionales aparecerán (debajo) dependiendo del formato seleccionado.
calidad: La calidad del archivo exportado. Los valores más altos conducen a tamaños de archivo más grandes. La calidad predeterminada (95) es un buen ajuste para exportaciones de muy alta calidad, p. Ej. con fines de archivo o impresión. Si necesita un buen compromiso entre tamaño y calidad, p. Ej. para la visualización o carga de imágenes en línea, debe considerar un valor de “90” en su lugar.
profundidad de bits: El número de bits utilizados para cada canal de color. Más bits significa menos posterización / bandas de color.
compresión: Tipo de compresión utilizar.
nivel de compresión: Para formatos de exportación donde se puede especificar compresión, el nivel de compresión especifica cuánta compresión se aplicará. Cuanto mayor sea el nivel, más se comprimirán los datos, a costa de más ciclos de CPU.
imagen en blanco y negro: Para el formato de exportación TIFF, es posible guardar una imagen monocromática. Esta configuración controla si el archivo resultante codifica los tonos de gris como canales RGB separados o como un solo canal de escala de grises. La última opción se volverá a utilizar en archivos más pequeños.

Global options

establecer tamaño

Elija cómo medir el tamaño máximo de su imagen exportada

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

_in cm (para impresión) _: Ingrese el ancho y alto máximo en cm y defina el ppp de la imagen. El tamaño equivalente en píxeles se calculará automáticamente.

_in pulgada (para impresión) _: Ingrese el ancho y alto máximo en pulgadas y defina el ppp de la imagen. El tamaño equivalente en píxeles se calculará automáticamente.

por escala (para archivo): Ingrese un multiplicador para especificar cuánto se debe escalar la imagen exportada en comparación con la imagen de entrada. Por ejemplo, ingresar un valor de 0.5 dará como resultado una imagen de salida con la mitad del ancho y alto (en píxeles) de la imagen original.

ppp

Si se eligen las unidades de cm o pulgadas, configure los ppp de la imagen de salida. Los ppp también se almacenarán en los datos Exif de la imagen exportada. Se establecerán automáticamente en 300 si se elige “en píxeles” o “por escala”.

tamaño máximo

Establezca el ancho y alto máximo de las imágenes exportadas en píxeles, cm o pulgadas (según la unidad seleccionada); cero significa que no se establecerá límite en esa dimensión. Las imágenes exportadas se limitarán para no superar ninguno de estos valores, conservando la relación de aspecto correcta. Establezca ambos en cero para exportar con las dimensiones originales (después de recortar). Si los valores ingresados exceden las dimensiones originales, Ansel exportará con las dimensiones originales o ampliará la imagen, según el parámetro “permitir ampliación”.

permitir la ampliación

Establezca “sí” para realizar un paso de ampliación si el ancho y la altura máximos definidos por el usuario superan las dimensiones originales de la imagen. Si se establece en “no”, las dimensiones de la imagen exportada no superarán las dimensiones de la imagen original (después de recortar).

remuestreo de alta calidad

Establezca esto en ‘sí’ para realizar un remuestreo de alta calidad en la imagen. La imagen se procesará en resolución completa y solo se reducirá al final. A veces, esto puede resultar en una mejor calidad, pero siempre será más 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.

Nota: Las imágenes que están seleccionadas pero actualmente ocultas (porque son miembros de un grupo colapsado) no se exportarán.

Filmstrip

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

La tira de película se puede utilizar para cambiar rápidamente entre imágenes. Las imágenes que se muestran son las mismas que se muestran en la vista de la mesa de luz y están definidas por la colección seleccionada actualmente.

Find location

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

Busque una ubicación en el mapa. Debe estar conectado a Internet para utilizar esta función.

Para usar este módulo, escriba el nombre o la dirección de un lugar, presione Entrar y se mostrará una lista de resultados. Haga clic en un elemento de la lista y el mapa se acercará a esa ubicación. Se mostrará un esquema que cubre esa ubicación o un alfiler que apunta a la ubicación.

Se puede utilizar un contorno (polígono) para crear una ubicación de usuario. Verifique el parámetro puntos máximos de polígono en el módulo [configuración del mapa](./ map-settings.md) para asegurarse de que haya suficientes puntos disponibles para que se muestre un polígono.

Focus peaking

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

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

Activate the module by clicking on the

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

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

Gamut check

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

Resalta las áreas de la imagen que pueden presentar recortes de gama.

Click the

are mutually exclusive modes.

Haga clic con el botón derecho en el icono para abrir un cuadro de diálogo con los parámetros de configuración – estos son los mismos que para la opción prueba en pantalla.

También puede considerar usar la advertencia de recorte, que también proporciona advertencias de exposición insuficiente y excesiva, así como una verificación de gama similar a la que ofrece este módulo.

Geotagging

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

Importe y aplique datos de seguimiento GPX a una selección de imágenes.

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

Workflow overview

Un receptor GPS calcula su posición actual basándose en la información que recibe de los satélites y la registra en un archivo GPX, junto con la fecha y hora actuales. Los datos Exif de las imágenes también contienen una marca de tiempo definida por la configuración de la cámara. El módulo geoetiquetado toma la marca de tiempo de la imagen, busca la posición en el archivo GPX en ese momento y almacena las coordenadas apropiadas (latitud / longitud / elevación) en su base de datos y en el archivo sidecar XMP de la imagen.

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.

El selector de color se activa presionando el icono del selector de color. Los parámetros del módulo permanecerán vigentes hasta que salga del modo de cuarto oscuro.

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

Una serie de guías de composición de uso común se pueden superponer en su imagen mientras está editando. Estos se pueden habilitar globalmente (todo el tiempo) o localmente (cuando ciertos módulos están activos).

Otras funcionalidades del cuarto oscuro también dibujan líneas superpuestas de colores en la imagen (por ejemplo, máscaras dibujadas). También se proporciona una opción para cambiar el color de esas superposiciones (ver más abajo).

Global guides

Left-click the

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

History stack

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

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

Este módulo enumera cada cambio de estado (activar/desactivar/mover/cambiar parámetros) para todos los módulos de procesamiento que se han modificado para la imagen actual. Seleccione un punto en la pila para volver a ese punto en el historial de desarrollo de la imagen. Shift + clic en un elemento en la pila de historial para expandir ese módulo en el panel de módulo de la derecha sin cambiar la edición actual.

Library

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

Filtre las imágenes que se muestran en la vista de la mesa de luz y el panel de tira de película utilizando atributos de imagen. Este conjunto de imágenes filtradas se conoce como colección.

Importar imágenes en Ansel almacena información sobre ellas (nombre de archivo, carpeta, datos Exif, datos de los archivos XMP, etc.) en la base de datos de la biblioteca de Ansel. Se puede definir una colección aplicando reglas de filtrado a estos atributos, creando así un subconjunto de imágenes para mostrar en la vista de la mesa de luz y el módulo de tira de película.

Locations

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

Create areas or locations and organize them as hierarchical tags.

Una ubicación se muestra como una forma en el mapa cuando se selecciona. Inicialmente, cada ubicación se representa como un cuadrado o círculo y se puede cambiar a un rectángulo o elipse ajustando el ancho y / o alto de la forma.

También se puede crear una ubicación a partir de un polígono de región (ciudad / país) de OpenStreetMap. Para lograr esto, primero asegúrese de que el parámetro puntos máximos de polígono sea lo suficientemente grande (algunos polígonos de países usan más de 150,000 puntos). Luego, seleccione la ubicación deseada en el módulo [buscar ubicación](./ find-location.md). Cuando se muestra la forma de la región correspondiente, un símbolo de polígono está disponible en el control de “forma” (ver más abajo). Selecciónelo para crear la nueva ubicación.

Lua scripts installer

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

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

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

Map settings

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

Seleccione los datos de mapas preferidos de varios proveedores. Algunos proporcionarán capas adicionales (vista de satélite, etc.) que puede alternar.

Module controls

fuente de mapas

Escoja entre los proveedores de información de fuente de mapas

puntos máximos de polígono

El módulo encontrar ubicación no muestra polígonos con más puntos que estos por razón de velocidad. Habitualmente un polígono de país tiene entre 50.000 y 150.000 puntos.

mostrar OSD

Escoger si mostrar los controles OSD (controles en pantalla) en la esquina superior izquierda de la vista central.

imágenes filtradas

Marque esta casilla para mostrar solo las imágenes de la colección actual (las que se muestran en la tira de película) en la vista central. Desmarque la casilla para mostrar todas las imágenes en la biblioteca actual, donde esas imágenes tienen datos GPS asociados. También puede alternar esta opción presionando Ctrl+S.

máximo de imágenes

Máximo número de miniaturas a mostrar en el mapa.

tamaño del factor de agrupamiento

Aumenta o disminuye el tamaño de área que causa a las imágenes estar agrupadas.

mínimo de imágenes por grupo

El número mínimo de imágenes que deben colocarse en la misma posición para crear automáticamente un grupo de imágenes para ellas.

visualización de miniaturas

Define qué información mostrar en la pantalla del mapa

miniaturas: muestra miniaturas de imágenes junto con un contador.

contador: Simplemente muestra el número de imágenes (para liberar espacio en el mapa). Desplácese sobre el número de imágenes para mostrar las miniaturas correspondientes. Un marcador de solo recuento se comporta de la misma manera que una miniatura de imagen normal, en términos de codificación de colores, desplazamiento, arrastrar y soltar, etc.

ninguno: no muestra nada.

También puede desplazarse por estas opciones presionando Mayús+S.

Mask manager

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

Manage all masks and shapes for the current image.

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

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

Metadata editor

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

Edit the metadata of selected images.

Los metadatos son texto de formato libre (título, descripción, creador, editor, derechos, etc.) que describen sus imágenes.

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.

Navigation

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

Zoom y desplazamiento por la imagen actual.

En la parte superior izquierda del cuarto oscuro, el panel de navegación muestra una vista previa completa de la imagen actual con un rectángulo que muestra el área que es actualmente visible en el panel central. Arrastre el rectángulo para desplazar la vista ampliada. La escala de zoom actual se muestra a la derecha de la imagen de vista previa. Haga clic en esa figura para acceder rápidamente a algunos niveles de zoom comunes.

Print settings

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

Manage settings for the print view and initiate printing.

Module controls

Printer

impresora: Seleccione una de las impresoras instaladas.
medios de comunicación: El tipo de soporte cargado en la impresora (papel normal, papel fotográfico brillante, etc.).
perfil: El perfil ICC de la impresora para el papel cargado. Este es el perfil específico de la impresora y el papel. Este perfil es la última transformación del espacio de color aplicada a la imagen cuyo objetivo es crear una impresión de alta calidad.
intent: The print rendering intent (“perceptual”, “relative colorimetric”, “saturation” or “absolute colorimetric”). See rendering intent for more details.
compensación de punto negro: Si se debe ajustar el punto negro del perfil de salida, que a menudo es más claro que el perfil de entrada. Esto debe estar “activado” cuando el intent se establece en “colorimétrico relativo”.

Page

Tamaño de papel: El tamaño del papel en el que se va a imprimir.
orientation: Portrait or landscape (note that darktable chooses the best fit by default).
unidades: La unidad que se utilizará para configurar los márgenes: “mm”, “cm” o “pulgadas”.
márgenes: Configure cada margen por separado o todos juntos haciendo clic en el botón de “bloqueo” del medio.
cuadrícula de visualización: Seleccione el tamaño de la cuadrícula utilizando el campo de entrada (expresado en la unidad seleccionada actualmente). Marque la opción para mostrar la cuadrícula en el lienzo.
encajar a la cuadricula: ayuda a configurar las áreas de la imagen ajustándolas a la cuadrícula para una alineación adecuada.
modo sin bordes requerido: Indica si se debe activar el modo sin bordes de la impresora. Este elemento se activa cuando los márgenes del usuario son más pequeños que los márgenes del hardware de la impresora. Tenga en cuenta que es solo un indicador, ya que no activa el modo sin bordes automáticamente.

Image layout

ancho / alto de la imagen: Este campo de información muestra el ancho y alto real de la imagen (dados con las unidades seleccionadas) en el papel.
factor de escala: Este campo de información muestra la escala de la imagen para que quepa en el papel. Si este valor es menor que 1, se reduce la escala de la imagen; de lo contrario, se aumenta la escala. Este es un factor importante a tener en cuenta: un valor demasiado grande (escala superior) puede dar como resultado una impresión de baja calidad. También se muestra el ppp correspondiente (puntos por pulgada).
alineación: Seleccione la alineación de la imagen en su área.
botón de área de nueva imagen: crea una nueva área de imagen. Arrastre y suelte en el lienzo para colocarlo. Si la opción Ajustar a la cuadrícula está activada, el área se puede alinear fácilmente con las líneas de la cuadrícula. Se puede colocar una imagen en esta área arrastrándola desde la tira de película y soltándola en la nueva área.
botón eliminar área de imagen: elimine el área de la imagen actualmente seleccionada de la composición.
botón de limpiar diseño: Elimina todas las áreas de la imagen dejando el lienzo vacío.

Los siguientes cuatro campos representan la posición del área actualmente seleccionada en la página: la esquina superior/izquierda en la primera línea y el ancho/alto del área en la segunda línea.

Raw overexposed warning

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

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

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

Click on the

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

Scopes

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

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

Mueva el mouse sobre el panel para mostrar los botones que le permiten ajustar la pantalla. El botón más a la izquierda alterna el modo entre histograma, alcance de forma de onda, alcance de desfile RGB y vectorscopio. Los botones restantes controlan cómo se dibuja la trama para el alcance actual.

Snapshots

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

Almacene instantáneas de desarrollo y compárelas con la edición actual.

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

Soft proof

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

Vea su imagen renderizada usando un perfil de color seleccionado.

Click the

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

Styles

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

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

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

Se muestra una lista de todos los estilos disponibles en el módulo. Un campo de búsqueda encima de la lista le permite localizar un estilo por nombre o descripción. Este módulo también permite editar y eliminar estilos.

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

Tagging

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

Administre las etiquetas adjuntas a las imágenes.

Las etiquetas proporcionan un medio para agregar información a las imágenes mediante un diccionario de palabras clave. También puede administrar las etiquetas como un árbol jerárquico, lo que puede resultar útil cuando su número aumenta.

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

Definitions

Las siguientes definiciones asumen que ha configurado una sola etiqueta llamada “lugares|Francia|Norte|Lille “.

Variables

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

Ansel admite la sustitución de variables en varios módulos y configuraciones de preferencias. Por ejemplo:

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

Preferencias y Ajustes

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.

Cualquier configuración alterada (es decir, aquellas que difieren de su estado predeterminado) se resalta con una marca circular al lado. Si cambia una configuración que necesita reiniciarse para que surta efecto, aparecerá un mensaje como recordatorio después de salir del cuadro de diálogo de preferencias.

General

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

Controla el aspecto general y la sensación de Ansel.

lenguaje de interfaz: Establece el idioma de la interfaz de usuario. El predeterminado del sistema está marcado con un * (necesita reiniciarse)
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”).
usar el tamaño de fuente del sistema: Seleccione esta opción para utilizar el tamaño de fuente definido por su sistema. Si no está marcado, puede ingresar un tamaño de fuente personalizado en el cuadro a continuación (predeterminado).
tamaño de fuente en puntos tipográficos: Si la opción “usar tamaño de fuente del sistema” está desactivada, ingrese un tamaño de fuente (en puntos) para que lo use Ansel. El tamaño de la fuente se cambiará inmediatamente.
PPP de los controles y tenxo de la Interfaz Gráfica: Ajuste la resolución de la GUI global para cambiar la escala de los controles, botones, etiquetas, etc. Aumente para una GUI ampliada, disminuya para ajustar más contenido en la ventana. Establézcalo en -1 para usar la resolución global definida por el sistema. El valor predeterminado es 96 DPI en la mayoría de los sistemas. (necesita un reinicio)

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.

Mesa de Luz

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

Control functionality in the lighttable view and modules.

General

ocultar los ajustes preestablecidos incorporados para los módulos de utilidades: Si está habilitado, solo se mostrarán los ajustes preestablecidos definidos por el usuario en el menú de ajustes preestablecidos para los módulos de utilidades; los ajustes preestablecidos incorporados se ocultarán (predeterminado desactivado).
show image time with milliseconds: Choose whether to include milliseconds when displaying time values (default off). If set, milliseconds are shown in the image information module and can also be used in the geotagging module.

Thumbnails

use el archivo RAW en lugar del JPEG incrustado: Al generar miniaturas para imágenes que aún no se han procesado en el cuarto oscuro, si el tamaño de la miniatura es mayor que este valor, genérelo procesando los datos de la imagen sin procesar. Si la miniatura está por debajo de este tamaño, use la imagen de vista previa JPEG incrustada en el archivo sin procesar. Una vez que se ha procesado una imagen en el cuarto oscuro, las miniaturas siempre se generarán a partir de datos sin procesar (puede volver a la vista previa JPEG descartando el historial). Para renderizar miniaturas con la mejor calidad, elija “siempre”.
procesamiento de alta calidad desde el tamaño: Si el tamaño de la miniatura es mayor que este valor y se genera a partir de datos sin procesar, se procesará utilizando la ruta de reproducción de calidad completa, que es mejor pero más lenta (por defecto 720p). Para renderizar miniaturas con la mejor calidad, elija “siempre”.
delimitadores para categorías de tamaño: Las categorías de tamaño se utilizan para permitir que se muestren diferentes superposiciones de miniaturas según el tamaño de la miniatura. Un conjunto de valores delimitado por tuberías define en qué tamaños de imagen cambia la categoría. El valor predeterminado de “120 | 400” significa que habrá 3 categorías de miniaturas: 0-120px, 120-400px y> 400px.

Cuarto oscuro

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

Control functionality in the darkroom view and associated modules.

General

pen pressure control for brush masks: Controls how the pressure reading of a graphics tablet impacts newly generated drawn mask brush strokes. You can control the brush width, hardness and opacity. “Absolute” control means that the pressure reading directly defines the attribute with a value between 0% and 100%. “Relative” means that the pressure reading adjusts the attribute between zero and the pre-defined default value (default off).
smoothing of brush strokes: Sets the level for smoothing of drawn mask brush strokes. Stronger smoothing leads to fewer nodes and easier editing at the expense of lower accuracy.
scroll down to increase mask parameters: By default, scrolling your mouse up increases the value of the relevant shape parameters in drawn masks. Set this preference to reverse the behavior (default off).
pattern for the image information line: Set the information to be displayed in the image information line, at the right of the top-most toolbar. You can use any variables in the variables section as well as $(NL) for a new line. You can also include formatting (bold, italic, colors etc).
border around image in darkroom mode: Display the center image in darkroom mode with an outside border of the given number of pixels (default 20).
mostrar la pantalla de carga entre imágenes: Muestra la pantalla de carga gris al navegar entre imágenes en el cuarto oscuro. Desactive esta opción para mostrar un simple mensaje flotante y deje la imagen anterior en su lugar hasta que se cargue la siguiente. Tenga en cuenta que desactivar esta opción puede ser muy útil para comparar rápidamente imágenes duplicadas; sin embargo, puede haber problemas con tiempos de carga prolongados (lo que le hace pensar que la siguiente imagen ya se ha cargado) y puede observar artefactos visuales mientras se carga la siguiente imagen. (predeterminado activado).

Modules

display of individual color channels

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

ocultar los ajustes preintegrados para los módulos de revelado

Si está habilitado, solo los ajustes preestablecidos definidos por el usuario se mostrarán en el menú de ajustes preestablecidos para los módulos de procesamiento; los ajustes preestablecidos incorporados se ocultarán (predeterminado desactivado).

show the guides widget in modules UI

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

show right-side buttons in processing module headers

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

always: always show all buttons

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

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

auto: hide the buttons when the panel is narrow

fade: fade out all buttons when the panel narrows

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

smooth: fade out all buttons in one header simultaneously

glide: gradually hide individual buttons as needed

(default always)

prompt for name on addition of new instance

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

Other views

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

Enable optional views:

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

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

Processing

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

Controle cómo se procesan las imágenes.

Image processing

always use LittleCMS 2 to apply output color profile: If this option is activated, Ansel will use the LittleCMS 2 system library to apply the output color profile instead of its own internal routines. This is significantly slower than the default but might give more accurate results in some cases.; Si el ICC dado está basado en LUT o contiene tanto una LUT como una matriz, Ansel usará LittleCMS 2 para representar los colores independientemente del valor de este parámetro (por defecto desactivado).

Security

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

Controle si se muestran mensajes de advertencia antes de realizar determinadas actividades.

General

ask before removing images from the library: Always ask before removing image information from Ansel’s library database, where the xmp file is retained (default on).
preguntar antes de borrar imágenes del disco: Preguntar siempre antes de eliminar un archivo de imagen (activado por defecto).
preguntar antes de descartar el historial de acciones: Preguntar siempre antes de descartar la pila de historial de una imagen (activada por defecto).
intenta usar la papelera al eliminar imágenes: En lugar de eliminar físicamente las imágenes del disco, intente ponerlas en la papelera del sistema (activada por defecto).
Pregunte antes de mover imágenes desde la carpeta del rollo de película.: Preguntar siempre antes de mover un archivo de imagen (activado por defecto).
Pregunte antes de copiar imágenes a la nueva carpeta de carrete.: Pregunte siempre antes de copiar un archivo de imagen a una nueva ubicación (opción predeterminada).
preguntar antes de eliminar carpetas vacías: Pregunte siempre antes de eliminar cualquier carpeta vacía. Esto puede suceder después de mover o eliminar imágenes (desactivada por defecto).
preguntar antes de borrar una etiqueta: Preguntar siempre antes de eliminar una etiqueta de una imagen (activada de forma predeterminada).
ask before deleting a style: Always ask before deleting a style (default on).
ask before deleting a preset: Always ask before deleting a preset (default on).
ask before exporting in overwrite mode: Always ask before exporting images in overwrite mode.

Other

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

Performance

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

Opencl

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

The background

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

El procesamiento de imágenes de alta resolución es una tarea exigente que requiere una computadora moderna. En términos de memoria y potencia de la CPU, sacar lo mejor de una imagen típica de 15, 20 o 25 megapíxeles puede llevar rápidamente a su computadora al límite.

Los requisitos de Ansel no son una excepción. Todos los cálculos se realizan en números de coma flotante de 4 x 32 bits. Es más lento que el álgebra de enteros de 8 o 16 bits “ordinaria”, pero elimina todos los problemas de rupturas tonales o pérdida de información.

How opencl works

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

Como puede imaginar, la arquitectura de hardware de las GPU puede variar significativamente. Hay diferentes fabricantes, e incluso diferentes generaciones de GPU del mismo fabricante pueden no ser comparables. Al mismo tiempo, los fabricantes de GPU normalmente no divulgan todos los detalles del hardware de sus productos al público. Una de las consecuencias de esto es la necesidad de usar controladores propietarios bajo Linux, si desea aprovechar al máximo su tarjeta gráfica.

Activating opencl in Ansel

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

El uso de OpenCL en Ansel requiere que su PC esté equipada con una tarjeta gráfica adecuada y que tenga instaladas las bibliotecas necesarias. La mayoría de las tarjetas gráficas modernas de NVIDIA y AMD vienen con soporte completo para OpenCL. El compilador OpenCL normalmente se envía como parte del controlador de gráficos propietario y se usa como una biblioteca dinámica llamada libOpenCL.so. Esta biblioteca debe estar en una carpeta donde la pueda encontrar el enlazador dinámico de su sistema.

Setting up opencl

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

La enorme diversidad de sistemas y las marcadas diferencias entre los proveedores de OpenCL y las versiones de los controladores hace que sea imposible ofrecer una descripción general completa de cómo configurar OpenCL. Solo podemos darle un ejemplo, en este caso para la versión 331.89 del controlador NVIDIA en Ubuntu 14.04. Esperamos que esto le sirva como una introducción básica y le ayude a resolver cualquier problema específico de su configuración.

Possible problems & solutions

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

Ansel detectará automáticamente los errores en tiempo de ejecución de OpenCL. Al detectar un error, volverá a procesar todo en la CPU. Si bien esto ralentizará el procesamiento, no debería afectar el resultado final.

Puede haber varias razones por las que OpenCL puede fallar durante la fase de inicialización. OpenCL depende de los requisitos de hardware y de la presencia de ciertos controladores y bibliotecas. Además, todos estos deben ajustarse en términos de fabricante, modelo y número de revisión. Si algo no encaja (por ejemplo, su controlador de gráficos, cargado como un módulo del kernel, no coincide con la versión de su libOpenCL.so), es probable que el soporte OpenCL no esté disponible.

Scheduling profile

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

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

default: If an OpenCL-capable GPU is found Ansel uses it for processing the center image view while the navigation preview window is processed on the CPU in parallel. This is the preferred setting for systems with a reasonably fast CPU and a moderately fast GPU. The exact allocation of devices to the various pixelpipe types can be finetuned with the “opencl_device_priority” configuration parameter (see multiple devices).
very fast GPU: Con este perfil de programación, Ansel procesa secuencialmente la vista de la imagen central y la ventana de vista previa en la GPU. Esta es la configuración preferida para sistemas con una GPU que supera con creces a la CPU.
multiple GPUs: Esta configuración se dirige a sistemas con varias GPU cuyo rendimiento relativo no difiere significativamente. Siempre que se inicia un trabajo de procesamiento, Ansel utiliza cualquier GPU inactiva actualmente, pero no la CPU. Los usuarios de sistemas con una variedad de GPU necesitarán un mejor control de su prioridad relativa. Sería mejor que seleccionaran el perfil “predeterminado” y ajustaran su sistema con el parámetro de configuración “opencl_device_priority” (consulte múltiples dispositivos).

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

La programación de dispositivos OpenCL se puede optimizar en la mayoría de los sistemas mediante la configuración del “perfil de programación OpenCL”. Sin embargo, si su sistema está equipado con más de una GPU, es posible que desee establecer manualmente la prioridad relativa del dispositivo. Para hacer esto, debe seleccionar el perfil de programación “predeterminado” y cambiar la configuración en el parámetro de configuración “opencl_device_priority”.

Es importante comprender cómo usa Ansel los dispositivos OpenCL. Cada secuencia de procesamiento de una imagen, para convertir una entrada en la salida final utilizando una pila de historial, se ejecuta en un pixelpipe. Hay cuatro tipos diferentes de pixelpipe en Ansel. Un tipo es responsable de procesar la vista de la imagen central (o vista completa) en el modo de cuarto oscuro, otro pixelpipe procesa la imagen de vista previa (ventana de navegación). Puede haber uno de cada uno de estos dos pixelpipes ejecutándose en cualquier momento, con los pixelpipes completos y de vista previa ejecutándose en paralelo. Además, puede haber varios píxeles paralelos que realizan exportaciones de archivos, así como varios píxeles paralelos que generan miniaturas. Si hay un dispositivo OpenCL disponible, Ansel lo asigna dinámicamente a un pixelpipe específico para una ejecución y luego lo libera.

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

Muchos de los problemas potenciales solo aparecerán con combinaciones muy específicas de estos factores. Como los desarrolladores de Ansel solo tienen acceso a una pequeña fracción de estas variaciones, comprenda que es posible que no podamos solucionar su problema específico. No hay mucho que podamos hacer si no podemos reproducir su problema.

Memory & performance tuning

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

Memory requirements

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

Storage

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

Database

check for database maintenance: Indicates when darktable should check for database fragmentation and perform maintenance. Options are “never”, “on startup”, “on close” and “on both”. Each of these is also available with an additional “(don’t ask)” option to perform the checks automatically without prompting (default “on close”).
umbral de la tasa de fragmentación de la base de datos: Relación de fragmentación (en porcentaje) por encima del cual se debe realizar el mantenimiento de la base de datos (sujeto a la selección realizada en la opción anterior) (por defecto 25).
crear una instantánea de la base de datos: Especifica la frecuencia con la que Ansel debe crear instantáneas de base de datos. Las opciones son “nunca”, “una vez al mes”, “una vez a la semana”, “una vez al día” y “al cierre” (predeterminado “una vez a la semana”).
cuántas instantáneas guardar: Número de instantáneas que se conservarán después de crear una nueva instantánea, sin contar las copias de seguridad de la base de datos realizadas al moverse entre versiones de Ansel. Introduzca “-1” para almacenar un número ilimitado de instantáneas. (predeterminado 10)

Xmp

escribir archivo sidecar para cada imagen

Los archivos XMP proporcionan un método redundante para guardar los cambios que ha realizado en una imagen, además de los cambios guardados en la base de datos de Ansel. Esta opción le permite elegir cuándo escribir estos archivos. Escoja entre:

nunca: No escriba archivos XMP. Esto puede ser útil si está ejecutando varias versiones de Ansel con fines de desarrollo/prueba, pero normalmente no se recomienda.

al importar: se escribirá un archivo XMP tan pronto como agregue una imagen a la biblioteca de Ansel y se actualizará posteriormente cada vez que lo edite

después de editar: se escribirá un archivo XMP la primera vez que realice una edición en una imagen y se actualizará en cada edición posterior. La importación no generará un archivo XMP de forma predeterminada.

Se recomienda encarecidamente que elija “al importar” o “después de editar”. Los archivos XMP proporcionan una protección contra fallas útil para que no pierda datos si su base de datos se corrompe. Hacer una copia de seguridad de su archivo sin procesar más el archivo XMP que lo acompaña le permitirá restaurar completamente su trabajo en una fecha posterior al volver a importar su historial de edición nuevamente a Ansel (predeterminado “al importar”).

Miscellaneous

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

Interface

load default shortcuts at startup: When launching the application, Ansel loads default shortcuts first, and then loads user-defined shortcuts on top. This allows default shortcuts to be overridden with a new action but prevents them from being deleted (since the deleted shortcut will be automatically reloaded on the next restart). Deactivate this preference to stop loading default shortcuts on startup – only load the user-defined ones (including any defaults that you have not subsequently deleted or overridden). This makes deletion easier but also means that you will not benefit from new shortcuts added in future versions without first re-enabling this preference (default on).
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).
listar primero los preajustes incorporados: Elige cómo se ordena el menú de ajustes preestablecidos. Si esta opción está habilitada, los ajustes preestablecidos incorporados se muestran primero. Si la opción está deshabilitada, los ajustes preestablecidos del usuario se muestran primero (predeterminado activado).
always show panels’ scrollbars: Defines whether the panel scrollbars should be always visible or activated only depending on the panel content (default on). (needs a restart)
position of the scopes module: Choose whether to show the scopes module in the left or right panel (default right). (needs a restart)
method to use for getting the display profile: This option allows the user to force Ansel to use a specific method to obtain the current display profile for color management. In the default setting “all”, Ansel will choose to query the X display server’s xatom or the colord system service. You can set this option to “xatom” or “colord” to enforce a specific method if the two methods give different results. You can run the Ansel-cmstest binary to examine your color management subsystem.

Shortcuts with multiple instances

Es posible crear múltiples instancias de muchos módulos de procesamiento. En este escenario, no siempre es obvio qué instancia debe controlarse mediante las operaciones de método abreviado de teclado. Las siguientes opciones controlan las reglas que se aplican (en orden) para decidir a qué atajos de teclado de instancia de módulo se deben aplicar.

Shortcuts

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

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

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

Assigning key shortcuts

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

Deleting default shortcuts

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

Presets

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

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

Los ajustes preestablecidos predefinidos (los que se incluyen por defecto dentro de Ansel) se muestran con un símbolo de candado. Sus propiedades no se pueden cambiar.

Los ajustes preestablecidos definidos por el usuario se pueden importar desde archivos exportados .dtpreset usando el botón" importar “en la parte inferior de la pantalla. Puede exportar todos los ajustes preestablecidos definidos por el usuario a un solo directorio utilizando el botón “exportar”.

Lua options

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

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

Color management

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

Ansel employs a fully color managed workflow:

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

Display profile

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

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

Rendering method

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

Ansel puede renderizar colores con sus propios algoritmos internos o usando la biblioteca externa LittleCMS2. El método interno de Ansel es, en un orden de magnitud, más rápido que el externo. La opción externa le permite elegir la intención de representación y puede ofrecer una precisión ligeramente mayor en algunos casos.

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

Rendering intent

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

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

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

Espacios de color de Ansel

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

Las imágenes de entrada son archivos RGB (como JPEG o TIFF) o RAW de cámara. Ambos almacenan información visual como una combinación de colores primarios (por ejemplo, rojo, verde y azul) que juntos describen una emisión de luz para ser recreada por una pantalla.

La siguiente imagen ilustra este concepto.

Unbounded colors

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

Las pantallas y la mayoría de los formatos de archivo de imagen solo pueden codificar intensidades RGB confinadas dentro de un cierto rango. Por ejemplo, las imágenes codificadas en 8 bits solo pueden contener valores de 0 a 255, imágenes en 10 bits de 0 a 1023, y así sucesivamente … Los estándares gráficos postulan que el máximo de ese rango, sin importar su valor real, siempre representará el brillo máximo que el medio de visualización puede generar, normalmente entre 100 y 160 Cd / m² (o nits), según el estándar real. Generalmente llamamos a este máximo “100% referido a la pantalla”. El mínimo del rango, codificado en 0 sin importar la profundidad de bits utilizada, se convierte entonces en “0% referido a la pantalla”. El 100% codifica el blanco puro, el 0% codifica el negro puro.

Possible color artifacts

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

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

Se ha descubierto que las fuentes de luz azul altamente saturadas en el marco de la imagen son probablemente candidatos para píxeles con valores L negativos. Si se dedica a la fotografía escénica, debe prestar mucha atención a las luces que aparecen en las imágenes.

Dimensiones de color de Ansel

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

Esta sección define las propiedades perceptivas del color, tanto conceptual como cuantitativamente, con el fin de caracterizar y cuantificar los ajustes creativos y correctivos realizados al color en Ansel.

Definitions

Las propiedades de color como “saturación”, “brillo” o “luminosidad” han pasado a ser de uso común, pero en gran medida se utilizan incorrectamente y, a menudo, se utilizan para significar cosas diferentes. En la ciencia del color, cada uno de estos términos tiene un significado preciso.

Command Line Interface

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

Ansel

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

El binario Ansel comienza Ansel con su GUI y funcionalidad completa. Esta es la forma estándar de usar Ansel.

Se puede llamar a Ansel con los siguientes parámetros de línea de comando:

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

Todos los parámetros son opcionales. En la mayoría de los casos, Ansel debe iniciarse sin ningún parámetro adicional, en cuyo caso Ansel utiliza valores predeterminados adecuados.

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.

Esta variante no abre ninguna pantalla – funciona en modo de consola puro sin iniciar una GUI. Este modo es particularmente útil para servidores que ejecutan trabajos en segundo plano.

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

El usuario debe proporcionar un nombre de archivo de entrada y un nombre de archivo de salida. Todos los demás parámetros son opcionales.

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

El binario Ansel-cltest comprueba si hay un entorno OpenCL utilizable en su sistema que Ansel pueda usar. Emite una salida de depuración que es equivalente a llamar a Ansel -d opencl y luego termina.

Ansel-cltest se llama sin parámetros de línea de comando.

Ansel-cmstest

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

El binario Ansel-cmstest (solo Linux) investiga si el subsistema de gestión del color de su computadora está configurado correctamente y muestra información útil sobre los perfiles de monitor instalados.

Ansel-cmstest se llama sin parámetros de línea de comando.

Purge_non_existing_images.sh

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

Encontrar y remover entradas de la base de datos de la biblioteca que referencian imágenes que ya no existen en el sistema de archivos. Se debe cerrar Ansel antes de correr el script.

El script se puede llamar con los siguientes parámetros de línea de comando:

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

Correr el script sin opciones para realizar una “corrida de prueba”, que genera un reporte de los archivos faltantes sin realizar ningún cambio en la base de datos.

Scripting with Lua

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

Ansel viene con un lenguaje de interfaz de scripting versátil para mejorar la funcionalidad.

Los scripts de Lua se pueden usar para definir acciones para que Ansel realice cuando se desencadena un evento. Un ejemplo podría ser llamar a una aplicación externa durante la exportación de archivos para aplicar pasos de procesamiento adicionales fuera de Ansel.

Lua es un proyecto independiente fundado en 1993, que proporciona un lenguaje de scripting potente, rápido, ligero e integrable. Lua es ampliamente utilizado por muchas aplicaciones de código abierto, en programas comerciales y para la programación de juegos.

principios básicos: archivos luarc

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

Al inicio, Ansel ejecutará automáticamente los scripts de Lua que se encuentren en $Ansel/share/Ansel/luarc y$HOME/.config/Ansel/luarc (donde $Ansel es el directorio de instalación de Ansel y$HOME es su directorio de inicio).

Esta es la única vez que Ansel ejecutará scripts de Lua por sí mismo. Estos scripts pueden registrar devoluciones de llamada para realizar acciones en varios eventos de Ansel. Este mecanismo de devolución de llamada es el método principal para desencadenar acciones de lua.

A simple Lua example

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

Empecemos con ejemplo simple que imprima algo en la terminal. Cree un archivo llamado luarc en el directorio de configuración de Ansel (usualmente $HOME/.config/Ansel/) y añada las siguientes líneas:

1print("Hello World !")

Ejecute Ansel y verá la frase “Hello World !” impresa en la terminal. Nada estrafalario, pero es un comienzo.

En este punto, no hay nada específico de Ansel en el script. Simplemente usamos la función de impresión estándar de Lua para imprimir una cadena. Eso está bien, pero podemos hacerlo mejor. Para acceder a la API de Ansel, primero debe require (requerir) y guardar el objeto devuelto en una variable. Una vez hecho esto, puede acceder a la API Ansel como subcampos del objeto devuelto. Todo esto está documentado en el manual de referencia de la Lua API de Ansel.

Printing labeled images

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

El primer ejemplo nos mostró los conceptos básicos de lua y nos permitió comprobar que todo funcionaba correctamente. Ahora hagamos algo un poco más complejo. Intentemos imprimir una lista de imágenes que tengan una etiqueta “roja” adjunta. Pero antes que nada, ¿qué es una imagen?

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

Ejecutar el código anterior producirá una gran cantidad de resultados. Lo veremos en un momento, pero primero veamos el código en sí.

Adding a simple shortcut

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

Hasta ahora, todos nuestros script se ejecutan al inicio. La utilidad de esto es limitada y no nos permite reaccionar a las acciones de los usuarios. Para hacer cosas más avanzadas, necesitamos registrar una función que será llamada en un evento dado. Los eventos más típicos a los que reaccionar son los atajos de teclado.

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

Ahora inicie Ansel, vaya a “preferencias > atajos > lua > A shortcut that prints its parameters” (un atajo que imprime sus parámetros), asígnele un atajo y pruébelo. Debiera ver un lindo mensaje impreso en pantalla.

Exporting images with Lua

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

Hasta ahora hemos aprendido a usar lua para adaptar Ansel a nuestro flujo de trabajo particular. Veamos ahora cómo usar lua para exportar imágenes fácilmente a un servicio en línea. Si puede cargar una imagen en un servicio a través de la línea de comando, puede usar lua para integrar esto en la interfaz de usuario de Ansel.

En el siguiente ejemplo usaremos lua para exportar vía scp. Aparecerá un nuevo tipo de almacenamiento en la interfaz de usuario de Ansel que exportará imágenes a un objetivo remoto a través del mecanismo de copia en ssh.

Building user interface elements

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

Nuestro ejemplo anterior fue un poco limitado. En particular, el uso de una preferencia por la ruta de exportación no fue muy agradable. Podemos hacerlo mejor agregando elementos a la interfaz de usuario en el cuadro de diálogo de exportación.

Los elementos de la interfaz de usuario se crean mediante la función Ansel_new_widget. Esta función toma un tipo de widget como parámetro y devuelve un nuevo objeto correspondiente a ese widget. A continuación, puede establecer varios campos en ese widget para establecer sus parámetros. Luego, usará ese objeto como parámetro para varias funciones que lo agregarán a la interfaz de usuario de Ansel. El siguiente ejemplo simple agrega una biblioteca en la vista de mesa de luz con una etiqueta simple:

Sharing scripts

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

Hasta ahora, todo nuestro código lua ha estado en luarc. Esa es una buena forma de desarrollar su guión, pero no es muy práctica para la distribución. Necesitamos convertir esto en un módulo lua adecuado. Para hacer eso, guardamos el código en un archivo separado (scp-storage.lua en este 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 buscará scripts (siguiendo las reglas normales de lua) en los directorios estándar más $CONFIGDIR/lua/*.lua. Así que nuestro script puede ser llamado simplemente agregando require "scp-storage" en el archivo luarc. Un par de notas extra …

Calling Lua from D-Bus

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

Es posible enviar un comando lua a Ansel a través de su interfaz DBus. El método org.Ansel.service.Remote.Lua toma un solo parámetro de cadena que se interpreta como un comando lua. El comando se ejecutará en el contexto lua actual y debería devolver nil o una cadena. El resultado se devolverá como resultado del método 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.

Using Ansel from a Lua script

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

Advertencia: esta función es muy experimental. Se sabe que varios elementos aún no funcionan en modo biblioteca. Se recomienda realizar pruebas minuciosas.

La interfaz lua le permite usar Ansel desde cualquier script lua. Esto cargará Ansel como una biblioteca y le proporcionará la mayor parte de la API lua (Ansel está configurado sin cabeza, por lo que las funciones relacionadas con la interfaz de usuario no están disponibles).

Como ejemplo, el siguiente programa imprimirá la lista de todas las imágenes de su biblioteca:

Lua API

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

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