Documentation 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

As funcionalidades no Ansel são separadas em 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.

desfazer/refazer

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

A maioria das alterações feitas na mesa de luz são registradas e podem ser revertidas para um estado anterior. Isto inclui modificações nas etiquetas de cor, classificações, geolocalização, metadados, orientação, copiar/colar de histórico, duplicata da imagem ou aplicação de um estilo. Observe que o recurso de desfazer/refazer ações é ilimitado no número de passos enquanto estiver no modo da mesa de luz, mas é descartado a cada vez que você alterna para uma vista diferente.

gerenciamento de ativos digitais

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

arquivos auxiliares

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.

importar arquivos auxiliares de outras aplicações

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.

cópias locais

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

Muitos usuários possuem coleções de imagens imensas armazenadas em discos rígidos adicionais em seu computador pessoal ou em mídias de armazenamento externo (NAS RAID, discos rígidos 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.

miniaturas

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.

criação de miniaturas

Uma miniatura é criada quando uma imagem é importada no Ansel pela primeira vez, após uma imagem ter sido modificada na sala escura ou ao acessar novamente uma imagem cuja miniatura não está mais disponível.

classificações com estrelas & etiquetas de cor

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

As classificações com estrelas e etiquetas de cor lhe auxiliam o ordenar e ranquear imagens de acordo com seu próprio critério. Uma classificação de estrelas e etiqueta de cor de uma imagem pode ser exibida sobre as miniaturas na vista de mesa de luz e no módulo de rolo de filme.

classificações de estrelas

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

agrupamento de imagens

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

O agrupamento de imagens auxilia a melhorar a estrutura e clareza da sua coleção de imagens quando exibida no modo da 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.

Imagens duplicadas são automaticamente agrupadas. De maneira semelhante, se você importar várias imagens da mesma pasta, possuindo o mesmo nome base mas extensões diferentes (por exemplo IMG_1234.CR2 eIMG_1234.JPG), essas imagens formam automaticamente um grupo.

metadados e etiquetas

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

O Ansel permite que você armazene informações adicionais sobre suas imagens de modo a permitir que elas sejam mais facilmente pesquisadas e agrupadas. Estas informações são armazenadas na base de dados do Ansel e nos arquivos auxiliares XMP e podem também ser incluídas nas imagens exportadas.

metadados

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.

Sala escura

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

A vista da sala escura é onde você processa suas imagens. A área central contém a imagem que está sendo atualmente editada.

zoom

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

Alternativamente, você pode alterar a ampliação entre 1:1 e “ajustar à tela” movimentando a roda do mouse. Girar a roda mantendo a tecla Ctrl pressionada estende o intervalo de ampliação entre 2:1 e 1:10.

disposição da sala escura

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

painel esquerdo

De cima para baixo:

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.

painel direito

De cima para baixo:

o pixelpipe

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

a anatomia de um módulo de processamento

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.

o pixelpipe e a ordem dos módulos

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

A ordem do pixelpipe é representada graficamente pela ordem em que os módulos são apresentados na interface com o usuário: o pixelpipe inicia com uma imagem RAW na parte inferior da lista de módulos e aplica os módulos de processamento, um por um, acumulando camadas de processamento de baixo para cima, até atingir o topo da lista, onde gera a imagem completamente processada.

o histórico

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

O histórico armazena todo o histórico de edições (ações) de uma determinada imagem, na ordem em que se aplicaram essas edições. Ele é salvo na base de dados da biblioteca do Ansel e no arquivo auxiliar XMP, sendo persistente entre as sessões de edição.

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

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

desfazer e refazer

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

Enquanto você edita sua imagem, o Ansel registra todas as modificações realizadas nesta imagem. Isto significa que é possível desfazer e refazer mudanças para recuperar um estado de edição anterior. Note que a função de desfazer/refazer é ilimitada no número de passos ao editar uma imagem, mas isso é reiniciado a cada vez que a sala escura abre uma nova imagem.

Pressione Ctrl+Z para desfazer a última modificação e Ctrl+Y para refazer a última modificação desfeita (se houver alguma).

máscaras & mesclagem

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.

Os dados de saída de um módulo podem ser reprocessados (combinados) opcionalmente com seus dados de entrada antes de serem passados ao próximo módulo. Este passo do processamento é chamado de mesclagem – os dados de entrada e saída são processados usando algoritmos chamados de operadores de mesclagem ou modos de mesclagem.

modos de mesclagem

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.

Os modos de mesclagem clássicos, desenvolvidos para RGB relativo à exibição (restringido a 0-100%), definem implicitamente um ponto de apoio (fulcrum) a 50% (cinza) ou a 100% (branco) em seus algoritmos, dependendo do modo. Uma vez que os modos relativos à cena não estão sujeitos a estas restrições, este ponto de apoio deve ser definido explicitamente pelo usuário ao realizar operações de mesclagem no espaço de cor “RGB (cena)”. O parâmetro pivô (fulcrum) de mesclagem adicional será apresentado ao usuário quando usar um destes modos de mesclagem neste espaço de cor. O efeito depende do operador usado. Por exemplo, valores acima do ponto de apoio podem iluminar-se e os valores abaixo obscurecer-se, ou vice versa.

máscaras

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.

Uma máscara pode ser vista como uma imagem em tons de cinza onde cada pixel tem um valor entre 0 e 1 (ou entre 0% e 100%). Este valor é a opacidade, e é usado para determinar quanto um módulo afeta cada pixel.

As seções a seguir mostram como construir máscaras no Ansel.

máscaras desenhadas

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

Com a ferramenta de máscara desenhada você pode construir uma máscara desenhando formas diretamente na tela. As formas podem ser usadas isoladas ou em conjunto. Uma vez que uma forma tenha sido desenhada em uma imagem, ela pode ser ajustada, removida ou reutilizada em outros 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.

máscaras paramétricas

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

A ferramenta de máscara paramétrica oferece controle fino seletivo sobre como cada pixel individual é mascarado. Isso é feito através da geração automática de uma máscara intermediária de mesclagem a partir dos parâmetros definidos pelo usuário. Estes parâmetros são coordenadas de cor ao invés das coordenadas geométricas usadas em máscaras desenhadas.

Para cada canal de dados de um módulo (por exemplo, Lab, RGB) e vários canais virtuais de dados (por exemplo, matiz, saturação) você pode construir uma função de opacidade por canal. Dependendo do valor do pixel para um canal de dados, esta função calcula um fator de mesclagem entre 0 e 1 (100%) para aquele pixel.

combinando máscaras desenhadas e paramétricas

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

Máscaras desenhadas e paramétricas podem ser usadas em combinação para formar uma única máscara que pode ser aplicada a um módulo.

Há dois elementos principais que controlam como máscaras individuais são combinadas: a polaridade de cada máscara individual (definida pelos botões de mais e menos) e a configuração na caixa combinada “combinar máscaras”.

A caixa “combinar máscaras” contém as seguintes opções, definindo como as máscaras desenhada e paramétrica serão combinadas:

refinamento da máscara e controles adicionais

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

Quando uma máscara paramétrica está ativa, vários controles deslizantes adicionais são mostrados, permitindo que a máscara seja refinada.

limiar de detalhes: Este controle permite alterar a opacidade da máscara baseando-se na quantidade de detalhes na imagem. Use este controle deslizante para selecionar áreas com muito detalhes (valores positivos) ou áreas que são “planas” e com poucos detalhes (valores negativos). O padrão (zero) evita o refinamento de detalhes. Isto é principalmente útil para aplicar efeitos de melhoria de nitidez e de suavização ignorando as partes desfocadas da imagem, ou para deixar nítidas somente as partes desfocadas, prevenindo nitidez excessiva nas regiões em foco.

Nota: Os dados usados para o refinamento de detalhes em máscaras são obtidos do estágio de interpolação cromática no pipeline, e não da entrada do módulo (que é usada para outros critérios da máscara paramétrica). Nenhum dos módulos de processamento depois da interpolação cromática tem efeito na máscara de detalhes e ela não está atualmente disponível para imagens não-RAW.

máscaras rasterizadas

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

Como descrito nas sessões anteriores, a saída final da máscara de um módulo (o efeito combinado de máscaras desenhadas e paramétricas) é uma matriz de pixels em tons de cinza representando quanto o efeito do módulo deve ser aplicado em cada pixel. Esta imagem rasterizada é guardada internamente por módulos ativos e pode ser reusada posteriormente por outros módulos no pixelpipe.

Assim como com qualquer máscara, se a opacidade do valor de um pixel na máscara rasterizada é zero, a entrada é passada pelo módulo sem modificações. Se a opacidade é 1, o módulo tem efeito completo. Para cada valor entre 0 e 1 o efeito do módulo é aplicado proporcionalmente naquele local.

módulos de processamento

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

final resampling

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

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

Action

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

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

aberrações cromáticas

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

Corrige aberrações cromáticas.

Diferente do módulo de aberrações cromáticas em raw, este módulo não precisa de dados em RAW como entrada.

fluxo de trabalho

Para obter melhores resultados, é recomendável que siga os seguintes passos:

Atenue as aberrações cromáticas o máximo possível no módulo correção da lente usando os controles deslizantes ACT.
Aumente o controle deslizante de força neste módulo para melhor observar seu efeito.
Aumente o raio até que as aberrações cromáticas desapareçam. Se isto não for suficiente, tente ativar a configuração “aberração cromática muito grande”.
Selecione a guia que fornece o melhor resultado em termos de nitidez e artefatos.
Reduza a força para evitar lavar muito as cores.

Para casos mais complicados, você também pode tentar o seguinte:

aberrações cromáticas em raw

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

Corrige as aberrações cromáticas das imagens em 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.

analista de negativos

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

Process scanned film negatives.

Você pode obter uma imagem de um negativo usando um digitalizador, fotografando-o contra uma luz branca (por exemplo, uma mesa de luz ou o monitor do computador) ou com o flash instalado fora da câmera.

preparação

Se a imagem do negativo foi obtida usando uma câmera digital, então para obter cores precisas na imagem final você precisará levar os seguintes pontos em consideração:

balanço de branco

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

Ajusta o balanço de branco da imagem, modificando a temperatura e a tonalidade, definindo um coeficiente para cada canal RGB ou selecionando a partir de uma lista de ajustes de balanço de branco predefinidos.

As configurações padrão para este módulo dependem do balanço de branco da câmera armazenado nos dados Exif da imagem.

O balanço de branco não pretende ser um módulo “criativo” – seu objetivo principal é corrigir tecnicamente o balanço de branco da imagem assegurando que os objetos de cores neutras na cena sejam renderizados com cores neutras na imagem. Para operações criativas com cor, normalmente é melhor usar outros módulos como calibração de cor ou balanço de cor rgb.

balanço de cor rgb

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

Um módulo avançado que traz ferramentas de gradação de cor da cinematografia à pipeline fotográfica relativa à cena.

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.

introdução

A gradação de cor é uma parte importante da edição de imagens. Ela pode ajudar a eliminar os matizes de cor não desejados e também pode oferecer um toque de cor criativo que agregará atmosfera a suas imagens. Nos tempo da fotografia em película, a maior parte do ambiente de cor era obtida com a emulsão da película e os produtos químicos de revelação, com parte da matização de cor sendo realizada sob a ampliadora com cabeças coloridas. Isto consumia recursos custosos e era reservado principalmente para a indústria do cinema, onde o trabalho era realizado por um colorista.

calibração de cor

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

Uma correção de espaço de cor com todas as funções, módulo de ajuste de balanço de branco e misturador de canais.

Este módulo simples porém poderoso pode ser usado das seguintes maneiras:

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.

censurar

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

Degrada partes da imagem de uma maneira esteticamente agradável, para anonimizar pessoas/objetos e ocultar partes do corpo.

O módulo trabalha no espaço de cor linear RGB para aplicar um desfoque e um ruído de luminância gaussianos fisicamente precisos.

Além da anonimização, este módulo pode também ser usado para uma variedade de propósitos criativos, como por exemplo:

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: Os métodos de anonimização proporcionados por este módulo não são seguros do ponto de vista forense para favorecer a estética. É possível que algumas técnicas forenses possam ainda ser capazes de reconstruir o conteúdo censurado baseado em sua estrutura, especialmente para formas e textos simples (por exemplo, placas de veículo, números de ruas).

contraste local

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

Melhora o contraste local da imagem.

Isto é atingindo usando um filtro laplaciano local (o padrão) ou um filtro bilateral não normalizado (grade bilateral). Ambos os modos trabalham exclusivamente no canal L de Lab. O filtro laplaciano local foi desenhado para ser robusto contra efeitos de halo indesejados e inversões de gradiente ao longo das bordas.

controles do módulo

modo: Seleciona entre o filtro laplaciano local ou grade bilateral. As seções a seguir definem os controles disponíveis para cada um destes modos.

grade bilateral

granularidade: Ajusta o nível de granularidade dos detalhes que será ajustado.
contraste: Controla o quão fortemente o algoritmo distingue os níveis de brilho. Aumente este parâmetro para uma aparência mais contrastada.
detalhe: Adiciona ou remove detalhes. Os valores mais altos aumentam o contraste local.

laplaciano local

Para compreender os parâmetros do filtro laplaciano local, pense em aplicar uma curva à imagem, semelhante ao gráfico a seguir:

correção da lente

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

Corrige automaticamente (e simula) a distorção da lente, aberrações cromáticas transversais (ACT) e vinhetas.

Este módulo identifica a combinação de câmera/lente a partir dos dados Exif da imagem e usa a biblioteca externa lensfun para fornecer parâmetros de correção.

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.

correção de perfil de entrada

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

Adiciona uma curva de correção aos dados da imagem. Isto é necessário se tiver sido selecionado determinados perfis de entrada no módulo perfil de cor 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.

cortar

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.

Sempre que este módulo estiver em foco, será mostrada uma imagem completa sem corte, sobreposta com os controles de corte e linhas guia opcionais.

curva rgb

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

Uma ferramenta clássica de fotografia digital para alterar os tons de uma imagem usando curvas.

Ative o seletor de cor à esquerda para mostrar os valores selecionados no gráfico (Ctrl+clique ou clique-direito para usar o seletor em modo de área). Os valores numéricos (Lab) de entrada e saída (ver abaixo) no ponto ou área são exibidos no canto superior esquerdo do gráfico.

Um segundo seletor de cor à direita pode ser usado para criar automaticamente novos nós baseados na área amostrada. Ctrl+clique+arraste o nó criado para ter uma curva positiva para a área selecionada. Shift+clique+arraste para criar uma curva negativa.

densidade graduada

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

Simula um filtro de densidade graduada de modo a corrigir a exposição e cor de forma progressiva.

Uma linha é exibida na tela permitindo que a posição e rotação do gradiente seja modificada com o mouse.

Este módulo é conhecido por provocar artefatos de banda sob certas condições. Considere ativar o módulo matização para minimizar estes problemas.

controles do módulo

densidade: Estabelece a densidade do filtro (EV). Um valor baixo subexpõe ligeiramente enquanto um valor alto cria um filtro forte.
dureza: A progressividade do gradiente. Um valor baixo cria uma transição suave, enquanto um valor alto torna a transição mais abrupta.
rotação: A rotação do filtro. Valores negativos rotacionam no sentido horário. A rotação pode também ser definida arrastando a ponta da linha do gradiente com o mouse.
matiz: Selecione um matiz para adicionar um matiz de cor ao gradiente.
saturação: A saturação do matiz de cor a adicionar ao gradiente (padrão para uma tonalidade de cor neutra de 0%).

desfoque de superfície

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.

desfoques

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

Simule desfocagens fisicamente precisas no espaço RGB relativo à cena.

tipos de desfoque

Três tipos de desfoque são fornecidos:

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

Um diagrama na parte superior do módulo mostra a forma do operador de desfoque (conhecido como função de dispersão de ponto ). O módulo transformará cada ponto luminoso da cena em um borrão com a forma do operador de desfoque exibido, com o tamanho do borrão definido pelo raio do desfoque.

difusão ou nitidez

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

A difusão é uma família de processos físicos pelos quais as partículas se movem e se espalham gradualmente com o tempo, a partir de uma fonte que as gera. No processamento de imagens, a difusão ocorre principalmente em dois lugares:

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

Em ambos os casos, a difusão torna a imagem menos nítida por “vazamento” de partículas e suavização de variações locais.

distorcer

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

Move os pixels ao redor, aplicando distorções em estilo livre em partes da imagem usando pontos, linhas e curvas.

nós

Cada uma das ferramentas do distorcer é baseada em nós. Um ponto consiste em um único nó e uma linha ou curva consiste em uma sequência de nós vinculados que definem um caminho.

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.

equalizador de contraste

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

Ajusta a luminância e o contraste cromático no domínio de wavelets.

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.

Várias predefinições são fornecidas, o que deve ajudá-lo a compreender as capacidades do módulo.

equalizador de tons

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

Clareia (“dodge” – desvia) e escurece (“burn” – queima) conservando o 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.

O diagrama a seguir descreve como o equalizador de tons funciona:

exposição

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

Aumenta ou diminui o brilho geral de uma imagem.

Este módulo tem dois modos de operação:

manual: Define a exposição, nível de preto e limiar de corte manualmente.
automático (somente imagens em RAW): Faz uma análise do histograma da imagem para estabelecer automaticamente a exposição. O Ansel seleciona automaticamente a compensação de exposição necessária para alterar o percentil selecionado ao nível alvo selecionado (consulte as definições abaixo). Este modo é particularmente útil para alterar automaticamente uma grande quantidade de imagens para que tenham a mesma exposição. Um caso de uso típico do modo automático é no processamento de fotografias de time-lapse (para evitar o efeito de cintilação).

controles do módulo

modo: Seleciona o modo de operação (automático/manual).
compensar exposição da câmera (modo manual): Remove automaticamente o viés de exposição da câmera (obtido dos dados Exif da imagem).
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.
limiar de corte (modo manual): Define que porcentagem dos valores de brilho serão recortados no cálculo da exposição e correção do nível de preto. Use o seletor de cor para obter uma amostra de uma porção da imagem a ser usada para este cálculo.
percentil (modo automático): Define uma localização no histograma que será utilizada para correção automática da exposição. Um percentil de 50% denota uma posição no histograma onde 50% dos valores de pixels estão acima e 50% dos valores de pixels estão abaixo desta exposição.
nível alvo (modo automático): Define o nível alvo para a correção de exposição (EV) automática em relação ao ponto de branco da câmera.
correção do nível de preto (modos manual e automático): Ajusta o ponto do nível de preto para eliminar 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.

grão

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

Simula a granulação de um filme analógico. O grão é processado no canal L do espaço de cor Lab.

controles do módulo

granularidade: O tamanho do grão, escalonado para simular um número ISO.
força: A força do efeito.

interpolação cromática

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

Controla como são interpolados cromaticamente os arquivos RAW.

filtros bayer

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.

lut 3D

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

Transforma os valores RGB com um arquivo LUT 3D.

Uma LUT 3D é uma tabela tridimensional que é usada para transformar um valor RGB fornecido em outro valor RGB. Normalmente é usada para simulação de películas e gradação de cor.

Este módulo aceita arquivos .cube,.3dl, .png (haldclut) e.gmz. Os dados LUT 3D sem compressão não são salvos na base de dados ou arquivo XMP, sendo somente salvo o caminho do arquivo LUT 3D dentro da pasta raiz do LUT 3D. Portanto, é importante fazer uma cópia de segurança de sua pasta LUT 3D corretamente – compartilhar uma imagem com seu XMP não tem sentido se o destinatário não possuir o mesmo arquivo LUT 3D em sua própria pasta LUT 3D.

marca d'água

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

Renderiza uma sobreposição baseada em vetores em sua imagem. As marcas d’água são documentos SVG e podem ser desenhadas usando o Inkscape .

Você pode também usar imagens de mapa de bits (PNG).

O processador SVG no Ansel pode também substituir cadeias de texto dentro de um documento SVG, o que permite incluir informações que dependem da imagem na marca d’água.

As marcas d’água desenhadas pelo usuário devem ser colocadas na pasta $HOME/.config/Ansel/watermarks. Uma vez no seu lugar, usar o botão de recarregar atualiza a lista de marcas d’água disponíveis.

matização

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

Este módulo elimina alguns dos artefatos de banda que podem ocorrer quando os dados internos de ponto flutuante de 32 bits do Ansel são transferidos para um formato de saída discreto de 8 ou 16 bits para visualização ou exportação.

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.

melhorar nitidez

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 o contraste ao redor da bordas e, portanto, melhorando a sensação de nitidez de uma imagem. Este módulo é aplicado ao canal L do espaço de cor Lab.

Nota: O algoritmo USM usado neste módulo realiza o desfoque no espaço de cor Lab, o que pode produzir efeitos indesejáveis e não é mais recomendado. Use as predefinições oferecidas pelo módulo equalizador de contraste para eliminar o desfoque ou o módulo contraste local para uma nitidez general.

moldura

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

Generate a frame around the image.

A moldura consiste de uma borda (com uma cor definida pelo usuário) e uma linha de moldura dentro desta borda (com uma segunda cor definida pelo usuário). Várias opções estão disponíveis para controlar a geometria e cor da moldura.

controles do módulo

tamanho da borda: O tamanho da borda da moldura como uma percentagem da imagem completa processada.
proporção: A proporção final da saída do módulo (isto é, a imagem processada mais a borda).
orientação: A orientação da moldura (retrato/paisagem). Selecione ‘auto’ para que o Ansel selecione a orientação mais razoável baseado na imagem processada.
posição horizontal/vertical: Seleciona a partir de um conjunto de proporções predefinidas para controlar onde se posicionará a imagem processada no eixo horizontal/vertical. Você também pode fazer um clique-direito para inserir sua própria proporção no formato “x/y”.
tamanho da linha da moldura: A porcentagem do tamanho da linha da moldura, em relação ao tamanho da borda em sua parte menor.
deslocamento da linha da moldura: A posição da linha da moldura, em relação à imagem processada. Selecione 0% para uma linha de moldura que toca a imagem. Selecione 100% para uma linha de moldura que toca a borda exterior da moldura.
cor da borda/cor da linha da moldura: Um par de seletores de cor que permitem definir as cores da linha da moldura e da borda. Ao clicar no campo de cor, uma janela de seleção de cor será aberta oferecendo uma seleção de cores de uso comum ou a opção de definir uma cor no espaço de cor RGB. Você também pode usar o seletor de cor para obter uma amostra de cor a partir da imagem.
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.

mudar escala de pixels

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

Algumas câmeras (como a Nikon D1X) possuem sensores retangulares ao invés dos quadrados habituais. Sem correção, isto geraria imagens distorcidas. Este módulo aplica a mudança de escala necessária.

O Ansel detecta imagens que precisam de correção usando seus dados Exif e ativa automaticamente este módulo quando necessário. Para outras imagens, o módulo sempre permanece desativado.

O módulo não possui controles.

níveis rgb

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

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

A ferramenta de níveis rgb mostra um histograma da imagem e mostra três barras com controles. Arraste os manipuladores para modificar os pontos de preto, cinza médio e branco em luminosidade (no modo “RGB, canais ligados”) ou de forma independente para cada um dos canais R, G e B (no modo “RGB, canais independentes”).

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.

orientação

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

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

Este módulo está habilitado por padrão e a orientação (rotação) é definida automaticamente em função dos dados Exif da imagem.

controles do módulo

transformar: Clique-duplo no rótulo para redefinir para as transformações padrão.
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.

perfil de cor de entrada

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

Define how Ansel will interpret the colors of the image.

Este módulo obtém o espaço de cor usado pela imagem fonte (por exemplo, câmera ou digitalizador) e converte a codificação dos pixels em um espaço de cor de trabalho padronizado. Isto significa que os módulos subsequentes no pipeline não precisam se preocupar com detalhes do dispositivo de entrada, e podem trabalhar com a conversão de/para um espaço de cor de trabalho comum.

perfil de cor de saída

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

Gerencia o perfil de saída para exportação e a intenção de renderização a ser usada ao mapear entre espaços de cor.

O Ansel vem com perfis predefinidos para o sRGB, Adobe RGB, XYZ e RGB linear. Você pode fornecer perfis adicionais e colocá-los em $Ansel/share/Ansel/color/out e $HOME/.config/Ansel/color/out (onde $Ansel é a pasta de instalação do Ansel e $HOME sua pasta pessoal).

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

pixels quentes

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

Automatically detect and eliminate hot pixels.

Pixels quentes são pixels que falharam ao registrar o nível de luz corretamente. Pixels quentes detectados são substituídos pela média de seus vizinhos.

controles do módulo

limite: Quão forte o valor de um pixel precisa desviar dos valores de seus vizinhos para ser considerado um pixel quente.
força: A força da mesclagem dos pixels quentes com seus vizinhos.
detectar por 3 vizinhos: Estende a detecção de pixels quentes – considerar um pixel como quente se um mínimo de apenas três (e não quatro) vizinhos desviarem mais que o valor do limite.
marcar pixels corrigidos: Visualmente marcar os pixels corrigidos na imagem e mostrar uma contagem de pixels quentes que foram corrigidos.

ponto de preto/branco em raw

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

Define camera-specific black and white points.

Este módulo é ativado automaticamente para todas as imagens em raw. As configurações padrão são aplicadas para todas as câmeras suportadas. Normalmente não são necessárias mudanças dos valores padrão.

controles do módulo

nível de preto 0-3: O nível de preto específico da câmera de quatro pixels no padrão RGGB Bayer. Pixels com valores inferiores a este nível não são considerados como contendo dados válidos.
ponto de branco: O nível de branco específico da câmera. É provável que todos os pixels acima disto serão recortados e em consequência tratados no módulo reconstrução de realce.
correção de não-uniformidade: Use a correção de não-uniformidade para compensar o sombreamento da lente. Este campo só aparece para arquivos RAW aplicáveis e usará automaticamente qualquer GainMap incorporado ao RAW. Você pode optar por desabilitar essa correção, se desejar.

reconstrução de cor

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

Recupera informações de cor nos realces (altas luzes) superexpostos.

Devido a natureza dos sensores digitais, os realces superexpostos carecem de informações de cor válidas. Com maior frequência, aparecem em branco neutro ou exibem algum matiz de cor, dependendo de que outros passos de processamento de imagem estão envolvidos. Este módulo pode ser usado para “curar” os realces superexpostos substituindo suas cores por outras que se ajustem melhor. O módulo atua sobre os pixels cuja luminância excede o limite definido pelo usuário. As cores de substituição são obtidas dos pixels vizinhos. Tanto a distância espacial como a distância de luminância (intervalo) são levados em conta para a seleção da cor.

reconstrução de realce

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

Tenta reconstruir as informações de cor para pixels que foram cortados em um ou mais canais RGB.

Se estes pixels foram parcialmente cortados, pode resultar em cores pouco realistas na imagem. Por exemplo, pixels com os canais verde e azul cortados parecerão vermelhos sem nenhuma reconstrução de cor.

Três métodos de reconstrução estão disponíveis:

recortar realces: Fixa todos os pixels para o nível branco (isto é, recorta os canais de cor restantes). Este método é mais útil nos casos em que se produzem reflexos recortados em objetos naturalmente dessaturados (por exemplo, nuvens).
reconstruir em LCh: Analisa cada pixel com pelo menos um canal recortado e tenta corrigir o pixel recortado (no espaço de cor LCh) usando os valores dos outros pixels (3 para Bayer e 8 para X-Trans) do bloco de sensor afetado. Os realces reconstruídos seguirão sendo monocromáticos, mas mais brilhantes e com mais detalhes do que os “realces recortados”. Este método funciona muito bem com uma curva base de alto contraste, o que faz com que os realces fiquem dessaturados. Semelhante ao recortar realces, este método é uma boa opção para objetos naturalmente dessaturados.
reconstruir cor: Usa um algoritmo que transfere informações de cor da vizinhança não recortada para os realces recortados. Este método funciona muito bem em áreas com cores homogêneas e é especialmente útil em tons de pele com reflexos que se desvanecem suavemente. Note que este método pode produzir artefatos em forma de labirinto nos realces por trás das bordas de alto contraste, por exemplo, estruturas finas bem expostas em frente a um fundo superexposto.
laplaciano guiado: Usa um algoritmo (derivado do módulo difusão ou nitidez) para replicar detalhes de canais válidos em canais recortados e propagar gradientes de cores de regiões vizinhas válidas em regiões recortadas. Este é um método lento e computacionalmente intensivo projetado para máxima suavidade e mistura perfeita das regiões reconstruídas em sua vizinhança, e é projetado principalmente para reconstruir holofotes e reflexões especulares. Este modo está disponível apenas para sensores Bayer.

Nota: Quando usar a reconstrução de realce incluída no módulo rgb fílmico, pode ser útil evitar usar este módulo no modo corte de realces (para que o rgb fílmico tenha mais informações para trabalhar).

redução de ruído (perfilado)

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

Um módulo de redução de ruído altamente eficiente e fácil de usar, adaptado aos perfis de ruído individuais de uma ampla gama de sensores de câmeras.

Um problema com muitos dos algoritmos de eliminação de ruído é que assumem que a variância do ruído é independente da luminosidade do sinal. Ao perfilar as características de ruído do sensor de uma câmera em diferentes configurações de ISO, pode-se avaliar a variação em diferentes luminosidades e pode-se ajustar o algoritmo de redução de ruído para suavizar o ruído de maneira mais uniforme.

redução de ruído em astrofotografia

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 a eliminação de ruído é um processo que consome muitos recursos, ela retarda significativamente o processamento do pixelpipe. Considere ativar este módulo mais tarde no fluxo de trabalho.

redução de ruído raw

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

Perform denoising on raw image data before it is demosaiced.

Este módulo foi portado do dcraw .

controles do módulo

limiar de ruído: O limiar para a detecção de ruído. Valores altos conduzem a uma maior eliminação de ruído e maior perda dos detalhes da imagem.
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.

remoção de névoa

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

Reduz automaticamente o efeito de poeira e névoa na atmosfera. Este módulo pode também ser empregado mais genericamente para dar às imagens um reforço de cor especificamente em regiões da imagem com baixo contraste.

A neblina absorve a luz dos objetos da cena, mas também é um fonte de luz de fundo difusa. O módulo de remoção de névoa primeiro estima, para cada região da imagem, a quantidade de neblina na cena. Em seguida, elimina a luz de fundo difusa segundo sua intensidade local e recupera a luz original do objeto.

retocar

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

Remove elementos indesejados de sua imagem clonando, reparando, desfocando e preenchendo com formas desenhadas.

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 fílmico

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

Remapeia o alcance tonal de uma imagem reproduzindo a tonalidade e a resposta de cor de um filme clássico.

Este módulo pode ser usado para expandir ou comprimir o alcance dinâmico da cena para que se adapte ao alcance dinâmico da tela. Ele protege as cores e o contraste dos meios-tons, recupera as sombras e comprime os realces (altas luzes) a as sombras escuras. Os realces precisarão de um tratamento adicional quando for necessário preservar os detalhes (por exemplo, nuvens).

rotação e perspectiva

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

Corrige automaticamente as linhas convergentes, uma forma de distorção da perspectiva. O processo usado é inspirado no programa ShiftN de Markus Hebel. Este módulo também permite ajustar a rotação da imagem.

As distorções de perspectiva são um efeito natural quando se projeta uma cena tridimensional em um plano bidimensional e faz com que os objetos próximos ao observador pareçam maiores do que os mais distantes. As linhas convergentes são um caso especial de distorção de perspectiva que se vê com frequência em fotografias de arquitetura – as linhas paralelas, quando fotografadas em ângulo, se transformam em linhas convergentes que se encontram em algum ponto final fora do quadro da imagem.

rotacionar pixels

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

Os sensores de algumas câmeras (como Fujifilm FinePix S2Pro, F700 e E550) possuem um padrão Bayer orientado diagonalmente ao invés do desenho ortogonal habitual.

Sem a correção, isto resultaria em uma imagem inclinada com os cantos pretos. Este módulo aplica a rotação necessária.

O Ansel detecta imagens que precisam de correção usando seus dados Exif e ativa automaticamente este módulo quando necessário. Para outras imagens, o módulo sempre permanece desativado.

tabela de cores

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

controles do módulo

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).; Clique em um patch para selecioná-lo, ou use a caixa combinada ou o seletor de cor. O patch atualmente selecionado é marcado com um quadro branco e seu número é exibido na caixa combinada abaixo.

vinheta

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

Apply a vignetting effect to the image.

A vinheta é uma modificação do brilho e saturação nas bordas da imagem em uma forma específica. Muitos dos parâmetros listados abaixo podem também ser modificados com o gráfico de controle que se sobrepõe à imagem quando o módulo possui o foco, mostrando a forma e a extensão do efeito.

Nota: É sabido que este módulo provoca artefatos de banda em determinadas condições. Você deveria considerar ativar o módulo matização para aliviar isto.

zonas de cor

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

Ajusta seletivamente a luminosidade, saturação e matiz dos pixels em função da luminosidade, saturação e matiz atuais.

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.

Primeiro você deve escolher se deseja ajustar (selecionar) pixels em função de sua luminosidade, saturação e matiz. Você pode então usar três curvas, em suas respectivas abas, para ajustar a luminosidade, saturação e matiz dos intervalos de pixels selecionados com este método.

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.

Apresentação

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.

uso

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

A vista de apresentação de slides ainda está em estágio inicial de desenvolvimento, com somente um conjunto básico de recursos.

 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

Dica: Para aproveitar o máximo do tamanho de sua tela, coloque o Ansel no modo de tela cheia pressionando F11 e ocultando os controles de borda pressionando a tecla B.

Impressão

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 suporta o perfil ICC da impressora, que é de certa forma obrigatório se você quiser obter uma impressão de alta qualidade, próxima da imagem mostrada na tela.

disposição da impressão

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

A área central mostra a disposição da imagem no papel (a área branca). Bordas cinzas podem ser mostradas ao redor da imagem para representar a área de impressão (a página menos as bordas) que não tenha sido preenchida pela imagem.

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

área da imagem

Quando o mouse está sobre a caixa delimitadora da área da imagem, sua largura e altura são mostradas na parte superior e esquerda, respectivamente. As margens entre a caixa delimitadora e a borda da página são indicadas ao lado das linhas pontilhadas que se estendem de cada lado da caixa delimitadora. Todas as medidas são mostradas nas unidades escolhidas no módulo de configurações de impressão.

GUI toolboxes

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

avaliação de cores

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

Avalia as cores e o brilho de sua imagem usando as condições de visualização recomendadas pelo ISO 12646:2008.

Ao processar uma imagem, a maneira como percebemos o brilho, o contraste e a saturação é influenciada pelas condições do ambiente ao redor. Se uma imagem for exibida contra um fundo escuro, isto pode causar uma série de efeitos adversos em nossa percepção da imagem:

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)

O resultado é que a imagem final pode ficar muito escura e excessivamente processada em termos de contraste e saturação de cor. Para evitar isso, o padrão “ISO 12646:2008” faz algumas recomendações sobre as condições em que as cores de uma imagem devem ser avaliadas. O módulo de avaliação de cores na sala escura coloca um quadro ao redor da imagem para ajudar o usuário a avaliar melhor as cores na imagem, seguindo as linhas dessas recomendações.

configurações de impressão

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

Manage settings for the print view and initiate printing.

controles do módulo

impressora

impressora: Seleciona uma das impressoras instaladas.
mídia: O tipo de mídia carregada na impressora (papel comum, papel fotográfico brilhante, etc.).
perfil: O perfil ICC para o papel carregado. Este é o perfil específico para a impressora e papel. Este perfil é a última transformação de espaço de cor aplicada à imagem, cujo objetivo é criar uma impressão de alta qualidade.
intent: The print rendering intent (“perceptual”, “relative colorimetric”, “saturation” or “absolute colorimetric”). See rendering intent for more details.
compensação de ponto preto: Se deve ser feito ajuste do ponto preto do perfil de saída, que é usualmente mais claro do que o do perfil de entrada. Isto deve estar “ligado” quando a intenção é definida como “colorimétrica relativa”.

página

tamanho do papel: O tamanho do papel para impressão.
orientation: Portrait or landscape (note that darktable chooses the best fit by default).
unidades: A unidade a usar ao configurar as margens: “mm”, “cm” ou “polegadas”.
margens: Define cada margem separadamente ou todas juntas clicando no botão central de “bloquear”.
grade de exibição: Selecione o tamanho da grade usando o campo de entrada (expresso na unidade atualmente selecionada). Marque a opção de visualizar a grade na tela.
alinhar à grade: Ajuda a definir a área da imagem ajustando-a à grade para o alinhamento adequado.
modo sem bordas necessário: Indica se o modo sem borda da impressora deve ser ativado. Este item é ativado quando as margens do usuário são menores do que as margens do hardware da impressora. Observe que é apenas um indicador, pois não ativa o modo sem bordas automaticamente.

disposição da imagem

largura/altura da imagem: Este campo de informação mostra a largura e altura real da imagem (dadas as unidades selecionadas) no papel.
fator de escala: Este campo de informação exibe o valor da escala da imagem para caber no papel. Se este valor for inferior a 1, a imagem será reduzida, caso contrário, será aumentada. Este é um fator importante a ser observado – um valor de fator de escala muito alto pode resultar em uma impressão de baixa qualidade. A resolução em dpi (pontos por polegada) correspondente também é exibida.
alinhamento: Selecione o alinhamento da imagem em sua área.
botão nova área de imagem: Cria uma nova área de imagem. Arraste e solte na tela para posicioná-la. Se a opção alinhar à grade estiver ativada, a área pode ser facilmente alinhada às linhas da grade. Uma imagem pode ser colocada nesta área arrastando-a do rolo de filme e soltando-a na nova área.
botão excluir área de imagem: Remove a área de imagem atualmente selecionada na composição.
botão limpar disposição: Remove todas as áreas de imagem deixando a tela vazia.

Os quatro campos a seguir representam a posição da área atualmente selecionada na página – o canto superior/esquerdo na primeira linha e a largura/altura da área na segunda linha.

configurações do mapa

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

Seleciona as preferências de exibição dos mapas de vários fornecedores. Alguns fornecerão camadas adicionais (visualização de satélite, etc.) que você pode alternar.

controles do módulo

origem do mapa

Seleciona o provedor de origem das informações do mapa.

máximo de pontos de polígono

O módulo encontrar localização não exibe polígonos com mais pontos do que isso por motivos de desempenho. Normalmente, um polígono de país tem entre 50.000 e 150.000 pontos.

mostrar controles na tela

Escolha se deseja exibir os controles no canto superior esquerdo da vista central.

imagens filtradas

Marque esta caixa para exibir apenas as imagens da coleção atual (aquelas mostradas no rolo de filme) na vista central. Desmarque a caixa para exibir todas as imagens na biblioteca atual que possuem dados GPS associados. Você também pode alternar essa opção pressionando Ctrl+S.

máximo de imagens

O número máximo de miniaturas a serem exibidas no mapa.

fator de tamanho do grupo

Aumenta ou diminui o tamanho da área que faz com que as imagens sejam agrupadas.

mínimo de imagens por grupo

O número mínimo de imagens que precisam ser colocadas na mesma posição para criar automaticamente um grupo de imagens para elas.

mostrar nas miniaturas

Defina quais informações mostrar na exibição do mapa

miniatura: Exibe miniaturas de imagens junto com um contador.

contagem: Exibe apenas o número de imagens (para liberar espaço no mapa). Passe o mouse sobre o número de imagens para mostrar as miniaturas correspondentes. Um marcador de contagem se comporta da mesma maneira que uma miniatura de imagem normal, em termos de codificação de cores, rolar, arrastar e soltar, etc.

nenhum: Não exibe nada.

Você também pode percorrer essas opções pressionando Shift+S.

Display metadata

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

Exibe informações embutidas nos dados Exif de uma imagem, bem como vários campos de dados adicionais definidos pelo Ansel.

Ao passar o mouse sobre as miniaturas das imagens, os dados exibidos são atualizados automaticamente para mostrar as informações sobre a imagem atualmente sob o cursor do mouse.

Quando várias imagens são selecionadas e o foco não está em uma única imagem, o módulo exibe apenas as informações que são iguais para todas as imagens. Se algum campo for diferente entre as imagens, o texto “<vários valores>” será exibido.

editor de metadados

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

Edita os metadados das imagens selecionadas.

Metadados são textos em formato livre (título, descrição, criador, editor, direitos, etc.) que descrevem suas imagens.

Quando várias imagens são selecionadas com valores diferentes para um determinado campo de metadados, o módulo exibe <deixar inalterado> para esse campo – se você optar por aplicar alterações, esses campos não serão alterados. Se você clicar com o botão direito do mouse no campo, os diferentes valores serão listados no final do menu de contexto. Selecione um dos valores no menu para aplicar esse valor a todas as imagens selecionadas – a alteração será salva assim que você pressionar o botão “aplicar” ou a tecla Enter/Tab.

encontrar localização

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

Procura um local no mapa. Você deve estar conectado à Internet para usar este recurso.

Para usar este módulo, digite um nome de local ou endereço, pressione Enter e uma lista de resultados será exibida. Clique em um item da lista e o mapa será ampliado para esse local. Um contorno delimitando esse local ou um pino apontando para o local será exibido.

Um contorno (polígono) pode ser usado para criar uma localização do usuário. Verifique o parâmetro máximo de pontos de polígono no módulo configurações do mapa para garantir que pontos suficientes estejam disponíveis para que um polígono seja exibido.

estilos

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.

Uma lista de todos os estilos disponíveis é exibida no módulo. Um campo de pesquisa acima da lista permite localizar um estilo por nome ou descrição. Este módulo também permite que estilos sejam editados e excluídos.

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.

etiquetas

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

Gerencia as etiquetas anexadas às imagens.

As etiquetas fornecem um meio de adicionar informações às imagens usando um dicionário de palavras-chave. Você também pode gerenciar as etiquetas como uma árvore hierárquica, o que pode ser útil quando a quantidade de etiquetas aumenta muito.

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

definições

As definições a seguir consideram que você configurou uma única etiqueta chamada “locais|Brasil|Pernambuco|Recife”.

exportar

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

Exporta as imagens selecionadas.

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

controles do módulo

opções de armazenamento

armazenar em

O tipo de local para armazenar as imagens selecionadas. Várias formatos diferentes são implementados, incluindo arquivo no disco, modelo de livro LaTeX e várias galerias na web. Dependendo do destino selecionado, serão solicitadas informações adicionais, como nomes de arquivos ou nome de conta e senha.

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.

seletor de pasta de saída

O botão ao lado da entrada do modelo de nome de arquivo abre uma caixa de diálogo para selecionar a pasta pai para exportação.

em caso de conflito

Seleciona o que fazer se o nome do arquivo gerado entrar em conflito com um arquivo existente na exportação:

criar nome de arquivo único: Seleciona automaticamente um novo nome de arquivo exclusivo anexando um número inteiro ao nome do arquivo conflitante.

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.

pular: Não exporta imagens quando o nome do arquivo de destino já existe.

opções de formato

formato do arquivo: Seleciona o formato de arquivo para a imagem exportada. Opções adicionais aparecerão (abaixo) dependendo do formato selecionado.
qualidade: Define a qualidade do arquivo exportado. Valores mais altos levam a tamanhos de arquivo maiores. A qualidade padrão (95) é uma boa configuração para exportações de qualidade muito alta (por exemplo, para fins de arquivamento ou impressão). Se você precisa de uma boa relação entre tamanho e qualidade (por exemplo, para exibição ou envios de imagens online), deve considerar um valor de “90”.
profundidade de bits: O número de bits usados para cada canal de cor. Mais bits significa menos posterização/bandas de cor.
compressão: O tipo de compactação a ser usado.
nível de compressão: Para formatos de exportação onde compressão pode ser especificada, o nível de compressão especifica quanta compressão aplicar. Quanto mais alto o nível, mais os dados serão compactados, ao custo de mais ciclos de CPU.
imagem preto & branco: Para o formato de exportação TIFF, é possível salvar uma imagem monocromática. Esta configuração controla se o arquivo resultante codifica os tons de cinza como canais RGB separados ou como um único canal em tons de cinza. A última opção resultará em arquivos menores.

opções globais

definir tamanho

Seleciona como medir o tamanho máximo de sua imagem exportada

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

em cm (para impressão): Insira a largura e altura máximas em cm e defina o dpi da imagem. O tamanho equivalente em pixels será calculado automaticamente.

em polegadas (para impressão): Insira a largura e altura máximas em polegadas e defina o dpi da imagem. O tamanho equivalente em pixels será calculado automaticamente.

por escala (para arquivo): Insira um multiplicador para especificar em quanto a imagem exportada deve ser redimensionada em comparação com a imagem de entrada. Por exemplo, inserir um valor de 0,5 resultará em uma imagem de saída com metade da largura e altura (em pixels) da imagem original.

dpi

Se unidades de cm ou polegadas forem escolhidas, define o dpi da imagem de saída. O dpi também será armazenado nos dados Exif da imagem exportada. Será definido automaticamente para 300 se “em pixels” ou “por escala” for escolhido.

tamanho máximo

Define a largura e altura máximas das imagens exportadas em pixels, cm ou polegadas (dependendo da unidade selecionada) – zero significa que nenhuma restrição será definida nessa dimensão. As imagens exportadas serão restringidas de modo a não exceder nenhum desses valores, mantendo a proporção correta. Defina ambos como zero para exportar com as dimensões originais (após o corte). Se os valores inseridos excederem as dimensões originais, o Ansel exportará com as dimensões originais ou aumentará a imagem, dependendo do parâmetro “permitir aumento da escala”.

permitir aumento da escala

Defina como “sim” para executar uma etapa de aumento de escala se a largura e altura máximas definidas pelo usuário excederem as dimensões originais da imagem. Se definido como “não” as dimensões da imagem exportada não excederão as dimensões da imagem original (após o corte).

reamostragem de alta qualidade

Defina como ‘sim’ para realizar uma reamostragem de alta qualidade na imagem. A imagem será processada em resolução total e reduzida apenas no final. Isso às vezes pode resultar em melhor qualidade, mas sempre será mais lento.

armazenar máscaras

Armazena máscaras como camadas na imagem exportada. Só funciona para alguns formatos de imagem (atualmente TIFF e 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: Imagens que estão selecionadas, mas atualmente ocultas (porque são membros de um grupo recolhido) não serão exportadas.

foco máximo

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.

geoetiquetas

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

Importa e aplica dados de rastreamento GPX a uma seleção de imagens.

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.

visão geral do fluxo de trabalho

Um receptor GPS calcula sua posição com base nas informações que recebe dos satélites e as registra em um arquivo GPX junto com a data e a hora atuais. Os dados Exif das imagens também contêm um carimbo de hora definido pelas configurações da câmera. O módulo geoetiquetas obtém o carimbo de data/hora da imagem, procura a posição no arquivo GPX naquele momento e armazena as coordenadas apropriadas (latitude/longitude/elevação) em sua base de dados e no arquivo auxiliar XMP da imagem.

gerenciador de duplicatas

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.

gerenciador de máscaras

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.

histograma

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

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

Mova o mouse sobre o painel para mostrar os botões que permitem o ajuste do mostrador. O botão mais à esquerda alterna o modo entre histograma, forma de onda, parada RGB e vetorscópio. Os botões remanescentes controlam como o gráfico para o escopo atual é desenhado.

indicador de recorte

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

Realça as áreas da imagem que podem apresentar recorte de luminância ou de gama.

Quando uma imagem é enviada para um dispositivo de exibição, cada pixel é normalmente representado como um conjunto de 3 números, representando a intensidade das cores primárias vermelho, verde e azul no espaço de cor de saída. Como o espaço de cor de saída geralmente está intimamente relacionado à limitações físicas do hardware, há um valor máximo permitido para os canais [R,G,B], representando a intensidade máxima disponível para esse espaço de cor. Da mesma forma, há também um valor mínimo abaixo do qual os valores de pixel serão mapeados para zero. Quando tentamos converter de um espaço de cor maior para o espaço de cor de saída final, quaisquer valores que excedam esse máximo serão fixados no valor máximo e quaisquer valores abaixo do mínimo serão fixados em zero. Esse processo é chamado de “recorte” e levará à perda de detalhes ou cores “incorretas” para quaisquer pixels com canais recortados.

indicador de superexposição raw

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.

instalador de scripts lua

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.

instantânea

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

Armazena capturas instantâneas de imagens processadas e compara com a edição atual.

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

Library

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

Filtra as imagens mostradas na vista da mesa de luz e no painel do rolo de filme usando atributos de imagem. Este conjunto de imagens filtradas é conhecido como coleção.

Ao importar imagens, o Ansel armazena informações sobre elas (nome do arquivo, caminho, dados Exif, dados dos arquivos auxiliares XMP etc) na base de dados da sua biblioteca. Uma coleção pode ser definida aplicando regras de filtragem a esses atributos, criando assim um subconjunto de imagens para exibir na visualização da mesa de luz e no módulo do rolo de filme.

linhas guia & sobreposições

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

Várias linhas guia de composição comumente usadas podem ser sobrepostas em sua imagem durante a edição. Elas podem ser habilitadas globalmente (o tempo todo) ou localmente (quando certos módulos estão ativos).

Outros módulos da sala escura, além deste, também desenham linhas de sobreposição coloridas na imagem (por exemplo, máscaras desenhadas). Este módulo fornece uma opção para alterar a cor dessas sobreposições (veja abaixo).

linhas guia globais

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.

localizações

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

Create areas or locations and organize them as hierarchical tags.

Uma localização é exibida como uma forma no mapa quando selecionada. Inicialmente, cada localização é representada por um quadrado ou círculo e pode ser alterada para um retângulo ou elipse ajustando a largura ou altura da forma.

Uma localização também pode ser criada a partir do polígono de uma região (cidade/país) no OpenStreetMap. Para fazer isto, primeiro certifique-se de que o parâmetro máximo de pontos de polígono é grande o suficiente (alguns polígonos de país usam mais do que 150.000 pontos). Então, selecione a localização desejada no módulo encontrar localização. Quando a região correspondente for mostrada, um símbolo de polígono estará disponível no controle “forma” (veja abaixo). Selecione-o para criar a nova localização.

navegação

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

Controla a ampliação e permite o deslocamento da imagem atual.

No lado superior esquerdo da sala escura, o painel de navegação exibe uma visualização completa da imagem atual com um retângulo mostrando a área que está atualmente visível no painel central. Arraste o retângulo para movimentar a visualização ampliada. A escala de ampliação atual é exibida à direita da imagem de visualização. Clique nessa figura para um acesso rápido a alguns níveis de ampliação comuns.

ordem dos módulos

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

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

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

pilha de histórico

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

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

Este módulo lista todas as mudanças de estado (ativar/desativar/mover/alterar parâmetros) para todos os módulos de processamento que foram modificados para a imagem atual. Selecione um ponto na pilha para retornar a esse ponto no histórico de processamento da imagem. Shift+clique em um item na pilha de histórico para expandir esse módulo no painel do módulos à direita sem alterar a edição atual.

prova digital

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

Visualiza sua imagem renderizada usando um perfil de cor selecionado.

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.

rolo de filme

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

O rolo de filme pode ser usado para alternar rapidamente entre as imagens. As imagens mostradas são iguais às exibidas na vista da mesa de luz e são definidas pela coleção atualmente selecionada.

seletor de cores global

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.

O seletor de cores é ativado pressionando o ícone do seletor de cores. Os parâmetros do módulo permanecerão em vigor até você sair do modo sala escura.

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.

verificação de gama

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

Destaca as áreas da imagem que podem apresentar recorte de gama.

Click the

are mutually exclusive modes.

Clique com o botão direito do mouse no ícone para abrir uma caixa de diálogo com os parâmetros de configuração – são os mesmos da opção prova digital.

Você também pode considerar o uso do indicador de recorte, que também fornece avisos de sub e superexposição, bem como uma verificação de gama semelhante à oferecida por este módulo.

variáveis

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

O Ansel suporta a substituição de variáveis em diversos módulos e configurações de preferências. Por exemplo:

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

Preferências e Configurações

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.

Qualquer configuração modificada (isto é, todas que difiram do seu estado padrão) são destacadas com uma marca circular ao lado. Se você alterar uma configuração que precisa uma reinicialização para surtir efeito, uma mensagem será exibida como um lembrete após você sair da janela de preferências.

geral

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

Controla o aspecto geral e o comportamento do Ansel.

idioma da interface: Define o idioma da interface do usuário. O padrão do sistema é marcado com um *. (precisa reiniciar)
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 o tamanho de fonte do sistema: Selecione esta opção para usar o tamanho de fonte definido pelo seu sistema. Se desativado, você pode inserir um tamanho de fonte personalizado na caixa abaixo (ativado por padrão).
tamanho da fonte em pontos: Se a opção “usar o tamanho de fonte do sistema” estiver desligada, insira um tamanho de fonte (em pontos) para o Ansel usar. O tamanho da fonte mudará imediatamente.
controles da interface gráfica e resolução (DPI) do texto: Ajusta a resolução global da interface gráfica para reescalonar controles, botões, rótulos etc. Aumente para uma interface ampliada, diminua para o conteúdo caber melhor na janela. Defina para -1 para usar a resolução global definida pelo sistema. O padrão é 96 DPI na maioria dos sistemas. (precisa reiniciar)

modificações do tema com CSS

Além de selecionar os temas oferecidos por padrão, você pode também aplicar customizações adicionais em CSS para modificar a aparência do Ansel.

mesa de luz

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

Control functionality in the lighttable view and modules.

geral

ocultar predefinições nativas para módulos utilitários: Se ativado, somente predefinições definidas pelo usuário serão exibidas no menu de predefinições para módulos utilitários – predefinições nativas serão ocultas (desligado por padrão).
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.

miniaturas

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

sala escura

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

Control functionality in the darkroom view and associated modules.

geral

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 tela de carregamento entre imagens: Mostra uma tela de carregamento cinza ao navegar entre imagens na sala escura. Desligue esta opção para mostrar uma simples mensagem flutuante e deixar a imagem anterior no local até que a próxima imagem seja carregada. Notar que desligar esta opção pode ser muito útil para comparar rapidamente duas imagens duplicadas. No entanto, pode haver problemas com tempos longos de carregamento (levando você a pensar que a próxima imagem já tenha sido carregada) e você pode observar artefatos visuais enquanto a próxima imagem estiver carregando (ligado por padrão).

módulos

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 predefinições nativas para módulos de processamento

Se ativo, somente predefinições do usuário serão exibidas no menu de predefinições para os módulos de processamento – predefinições ativas serão ocultas (desligado por padrão).

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.

processamento

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

Controla como as imagens são processadas.

processamento da imagem

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.; Se o ICC fornecido é baseado em LUT ou contiver tanto LUT como uma matriz, o Ansel usará o LittleCMS 2 para renderizar as cores independentemente do valor deste parâmetro (que é desativado por padrão).

segurança

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

Controle se mensagens de alerta são exibidas antes de realizar determinadas atividades.

geral

perguntar antes de remover imagens da biblioteca: Sempre pergunta antes de remover informações da imagem da base de dados da biblioteca do Ansel, onde o arquivo xmp é mantido (ativado por padrão).
perguntar antes de apagar imagens do disco: Sempre pergunta antes de apagar um arquivo de imagem (ativado por padrão).
perguntar antes de descartar pilha de histórico: Sempre pergunta antes de descartar a pilha de histórico de uma imagem (ativado por padrão).
tentar enviar arquivos para a lixeira quando apagar arquivos de imagem: Ao invés de apagar fisicamente as imagens do disco, tenta colocá-los na lixeira do sistema (ativado por padrão).
perguntar antes de mover imagens da pasta de rolo de filme: Sempre pergunta antes de mover um arquivo de imagem (ativado por padrão).
perguntar antes de copiar imagens para uma nova pasta de rolo de filme: Sempre pergunta antes de copiar um arquivo de imagem para uma nova localização (ativado por padrão).
perguntar antes de remover pastas vazias: Sempre pergunta antes de remover uma pasta vazia. Isto pode ocorrer após mover ou apagar imagens (desativado por padrão).
perguntar antes de excluir uma etiqueta: Sempre pergunta antes de excluir uma etiqueta de uma imagem (ativado por padrão).
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.

outro

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

os bastidores

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

O processamento de imagens em alta resolução é uma tarefa exigente que requer um computador moderno. Em termos de memória e potência de CPU, obter o melhor de uma imagem típica de 15, 20 ou 25 megapixels pode levar rapidamente o seu computador ao limite.

Os requisitos do Ansel não são exceção. Todos os cálculos são realizados com números de ponto flutuante de 4 x 32 bits. Isso é mais lento do que a álgebra de números inteiros “normal” de 8 ou 16 bits, mas elimina todos os problemas de quebras tonais ou de perda de informação.

como funciona o opencl

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

Como você pode imaginar, a arquitetura de hardware das GPUs pode variar significativamente. Existem diferentes fabricantes e até mesmo diferentes gerações de GPUs do mesmo fabricante que podem não ser comparáveis. Ao mesmo tempo, os fabricantes de GPU normalmente não divulgam todos os detalhes de hardware de seus produtos ao público. Uma das consequências disso é a necessidade de usar drivers proprietários no GNU/Linux, se você quiser tirar o máximo proveito de sua placa de vídeo.

ativar o opencl no Ansel

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

O uso do OpenCL no Ansel requer que seu PC esteja equipado com uma placa gráfica adequada e que tenha as bibliotecas necessárias instaladas. A maioria das placas gráficas modernas da NVIDIA e AMD vem com suporte total para OpenCL. O compilador OpenCL normalmente é distribuído como parte do controlador gráfico proprietário e é usado como uma biblioteca dinâmica chamada libOpenCL.so. Esta biblioteca deve estar em uma pasta onde possa ser encontrada pelo vinculador dinâmico do seu sistema.

configurar o opencl

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

A enorme diversidade de sistemas e as diferenças marcantes entre os fornecedores do OpenCL e as versões do controlador tornam impossível dar uma visão geral abrangente de como configurar o OpenCL. Podemos dar apenas um exemplo, neste caso, para a versão 331.89 do driver NVIDIA no Ubuntu 14.04. Esperamos que isso sirva como uma introdução básica e ajude você a resolver quaisquer problemas específicos de sua configuração.

O princípio do fluxo da função OpenCL se dá dessa forma:

possíveis problemas e soluções

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

O Ansel detectará erros de tempo de execução OpenCL automaticamente. Ao detectar um erro, ele irá reprocessar tudo na CPU. Embora isso retarde o processamento, não deve afetar o resultado final.

Podem haver vários motivos para o OpenCL falhar durante a fase de inicialização. O OpenCL depende dos requisitos de hardware e da presença de certos controladores e bibliotecas. Além disso, todos eles devem se ajustar em termos de fabricante, modelo e número de revisão. Se algo não estiver correto (por exemplo, seu controlador gráfico – carregado como um módulo do kernel – não corresponde à versão de seu libOpenCL.so), o suporte a OpenCL provavelmente não estará disponível.

perfil de agendamento de tarefas

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).
GPU muito rápida: Com este perfil de agendamento, o Ansel processa a visualização da imagem central e a janela de visualização na GPU sequencialmente. Esta é a configuração preferida para sistemas com uma GPU que supera com folga o desempenho da CPU.
múltiplas GPUs: Essa configuração aborda sistemas com várias GPUs cujos desempenhos relativos não diferem significativamente. Sempre que um trabalho de processamento é iniciado, o Ansel usa qualquer GPU ociosa, mas não a CPU. Os usuários de sistemas com uma variedade de GPUs precisarão de melhor controle sobre sua prioridade relativa. Será melhor selecionar o perfil padrão e ajustar seu sistema com o parâmetro de configuração opencl_device_priority (veja múltiplos 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.

múltiplos dispositivos

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

O agendamento de dispositivos OpenCL pode ser otimizado na maioria dos sistemas usando as configurações de “perfil de agendamento do OpenCL”. No entanto, se o seu sistema estiver equipado com mais de uma GPU, você pode querer definir a prioridade relativa do dispositivo manualmente. Para fazer isso, você precisa selecionar o perfil de agendamento “padrão” e alterar as configurações no parâmetro de configuração “opencl_device_priority”.

É importante entender como o Ansel usa dispositivos OpenCL. Cada sequência de processamento de uma imagem – para converter uma entrada em saída final usando uma pilha de histórico – é executada em um pixelpipe. Existem quatro tipos diferentes de pixelpipe no Ansel. Um tipo é responsável por processar a visualização da imagem central (ou visualização completa) no modo de sala escura, outro pixelpipe processa a imagem de visualização (janela de navegação). Pode haver um de cada um desses dois pixelpipes em execução a qualquer momento, com os pixelpipes completos e de visualização executados em paralelo. Além disso, pode haver vários pixelpipes paralelos realizando exportações de arquivos, bem como vários pixelpipes paralelos gerando miniaturas. Se um dispositivo OpenCL estiver disponível, o Ansel dinamicamente o aloca para um pixelpipe específico para uma execução e o libera depois.

opencl ainda não funciona para mim

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

Muitos dos problemas só aparecerão com combinações muito específicas desses fatores. Como os desenvolvedores do Ansel só têm acesso a uma pequena fração dessas variações, entenda que talvez não possamos resolver seu problema específico. Não há muito o que possamos fazer se não formos capazes de reproduzir o seu problema.

ajuste de memória e desempenho

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

requisitos de memória

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.

armazenamento

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

base de dados

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”).
limite de fragmentação da base de dados: Razão de fragmentação (em percentual) acima da qual a manutenção da base de dados deve ser realizada (sujeito à seleção feita na opção acima) (25 por padrão).
criar cópia instantânea da base de dados: Especifica com qual a frequência o Ansel deve criar cópias instantâneas da base de dados. As opções são “nunca”, “uma vez por mês”, “uma vez por semana”, “uma vez por dia” e “ao fechar” (“uma vez por semana” por padrão).
quantas cópias de segurança manter: Número de cópias instantâneas a serem mantidas após criar uma nova cópia, sem contar as cópias de segurança realizadas ao atualizar a versão do Ansel. Insira “-1” para armazenar um número ilimitado de cópias (10 por padrão).

xmp

salvar arquivo auxiliar para cada imagem

Os arquivos XMP fornecem um método redundante de salvar as alterações feitas em uma imagem, além das alterações salvas na base de dados do Ansel. Esta opção permite que você escolha quando salvar esses arquivos. Escolha entre:

nunca: Não salva arquivos XMP. Isso pode ser útil se você estiver executando várias versões do Ansel para fins de desenvolvimento/teste, mas normalmente não é recomendado

ao importar: Um arquivo XMP será salvo assim que você adicionar uma imagem à biblioteca do Ansel e será posteriormente atualizado cada vez que você editá-la

após edição: Um arquivo XMP será salvo na primeira vez que você realizar uma edição em uma imagem e será atualizado a cada edição subsequente. A importação não irá gerar um arquivo XMP por padrão.

É altamente recomendável que você escolha “ao importar” ou “após edição”. Os arquivos XMP fornecem uma proteção contra falhas útil para que você não perca dados se a base de dados for corrompida. Fazer cópia de segurança de seu arquivo RAW mais o arquivo XMP que o acompanha permitirá que você restaure totalmente seu trabalho em uma data posterior, reimportando seu histórico de edição de volta para o Ansel (“ao importar” por padrão).

miscelânea

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

interface

carregar atalhos padrão ao iniciar: Ao iniciar o aplicativo, o Ansel carrega os atalhos padrão primeiro e, em seguida, carrega os atalhos definidos pelo usuário por cima. Isso permite que os atalhos padrão sejam substituídos por uma nova ação, mas impede que sejam excluídos (já que o atalho excluído será recarregado automaticamente na próxima reinicialização). Desative esta preferência para parar de carregar os atalhos padrão na inicialização carregando apenas os definidos pelo usuário (incluindo quaisquer padrões que você não tenha excluído ou substituído). Isso facilita a exclusão, mas também significa que você não se beneficiará de novos atalhos adicionados em versões futuras sem primeiro reativar essa preferência (padrão ativado).
escalonar passo do controle deslizante com mín/máx: Quando ativado, o tamanho do passo padrão, ao alterar os controles deslizantes, dependerá dos valores mín/máx atuais para o referido controle (ativado por padrão).
ordenar predefinições nativas primeiro: Seleciona como o menu de predefinições é ordenado. Se esta opção estiver ativa, as predefinições nativas serão exibidas primeiro. Se estiver desativada, as predefinições do usuário são exibidas primeiro (ativado por padrão).
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.

etiquetas

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

atalhos de teclado com múltiplas instâncias

É possível criar múltiplas instâncias de muitos módulos de processamento. Neste cenário, nem sempre é óbvio qual instância deve ser controlada pelas operações de atalho de teclado. As opções a seguir controlam as regras que são aplicadas (em ordem) para decidir em qual instância de módulo os atalhos de teclado devem ser aplicados.

atalhos

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

predefinições

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.

Os ajustes predefinidos internos (aqueles que são incluídos por padrão com o Ansel) são exibidos com um símbolo de cadeado. Suas propriedades não podem ser modificadas.

As predefinições feitas pelo usuário podem ser importadas a partir de arquivos .dtpreset usando o botão “importar” na base da tela. Você pode exportar todas as predefinições feitas pelo usuário para uma única pasta usando o botão “exportar”.

opções do lua

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

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

gerenciamento de cor

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.

perfil do monitor

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.

método de renderização

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

O Ansel pode renderizar cores com seus próprios algoritmos internos ou usando a biblioteca externa LittleCMS 2. O método interno do Ansel é significativamente mais rápido que o externo. A opção externa lhe permite selecionar a intenção de renderização e pode oferecer uma precisão ligeiramente maior em alguns casos.

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

Nota: Se o ICC fornecido estiver baseado em LUT ou possuir tanto o LUT como uma matriz, o Ansel usará o LittleCMS2 para representar as cores independentemente do valor do parâmetro de configuração.

intenção de renderização

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.

espaços de cor do Ansel

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

As imagens de entrada são arquivos RGB (como JPEGs ou TIFFs) ou RAW da câmera. Ambos armazenam informações visuais como uma combinação de cores primárias (por exemplo vermelho, verde e azul) que juntas descrevem uma emissão de luz a ser recriada na tela.

A imagem a seguir ilustra este conceito.

cores ilimitadas

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

As telas e a maioria dos formatos de arquivo de imagem só podem codificar intensidades RGB confinadas em um determinado intervalo. Por exemplo, imagens codificadas em 8 bits podem conter apenas valores de 0 a 255, imagens em 10 bits, de 0 a 1023, e assim por diante… Padrões gráficos postulam que o máximo desse intervalo, não importa seu valor real, sempre representará o máximo brilho que o meio de exibição é capaz de renderizar, geralmente entre 100 e 160 Cd/m² (ou nits), dependendo do padrão real. Geralmente chamamos esse máximo de “100% relativo à exibição”. O mínimo da faixa, codificado 0, não importa a profundidade de bits usada, torna-se então “0% relativo à exibição”. 100% codifica branco puro e 0% codifica preto puro.

possíveis artefatos de cor

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.

Foi descoberto que fontes de luz azul altamente saturadas no quadro da imagem são provavelmente candidatas para pixels com valores de ‘L’ negativos. Se você se dedica à fotografia de estúdio, deve prestar atenção a este tipo de luz que apareça em sua imagem.

dimensões da cor no Ansel

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

Esta seção define as propriedades perceptuais da cor, tanto conceitualmente como quantitativamente, a fim de caracterizar e quantificar os ajustes criativos e corretivos da cor realizados no Ansel.

definições

As propriedades como “saturação”, “brilho” ou “luminosidade” passaram a ser de uso comum mas são largamente usadas de forma incorreta e frequentemente para significar coisas diferentes. Na ciência da cor, cada um destes termos possui um significado preciso.

Command Line Interface

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

Ansel

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

O binário Ansel inicia o Ansel com sua interface gráfica e todas as funcionalidades. Esta é a forma padrão de usar o Ansel.

O Ansel pode ser invocado com os seguintes parâmetros de linha 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 [<arquivo de entrada>|<pasta de imagens>]
 6 [--version]
 7 [--disable-opencl]
 8 [--library <arquivo da biblioteca>]
 9 [--datadir <pasta de dados>]
10 [--moduledir <pasta de módulos>]
11 [--tmpdir <pasta temporária>]
12 [--configdir <pasta de configuração do usuário>]
13 [--cachedir <pasta de cache do usuário>]
14 [--localedir <pasta locale>]
15 [--luacmd <comandos lua>]
16 [--noiseprofiles <arquivo de perfis de ruído json>]
17 [--d-signal <sinal>]
18 [--d-signal-act <all,raise,connect,disconnect,print-trace>]
19 [--conf <chave>=<valor>]
20 [-t <num subprocessos openmp >]

Todos os parâmetros são opcionais. Na maioria dos caso, o Ansel deve ser iniciado sem nenhum parâmetro adicional, o que fará com que sejam usados os valores padrão adequados.

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 não exibe nenhuma janela – ela funciona em modo de console puro sem iniciar uma interface gráfica. Este modo é particularmente útil para servidores rodando trabalhos em 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>]

O usuário deve fornecer um nome de arquivo de entrada e um nome de arquivo de saída. Todos os outros parâmetros são opcionais.

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

O binário Ansel-cltest verifica se há um ambiente OpenCL em seu sistema que o Ansel possa usar. Ele emite alguma saída para depuração que é equivalente a chamar Ansel -d opencl e então termina.

O Ansel-cltest é chamado sem parâmetros de linha de comando.

Ansel-cmstest

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

O binário Ansel-cmstest (somente para Linux) verifica se o subsistema de gerenciamento de cores do seu computador está configurado corretamente e exibe informações úteis sobre os perfis de monitor instalados.

O Ansel-cmstest é chamado sem parâmetros de linha de comando.

purge_non_existing_images.sh

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

Encontra e remove entradas da base de dados da biblioteca que referenciam imagens que não existem mais no sistema de arquivos. Você deve fechar o Ansel antes de executar este script.

O script pode ser chamado com os seguintes parâmetros de linha de comando:

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

Execute o script sem opções para realizar um “rodada de teste” que gera um relatório dos arquivos faltantes sem realizar nenhuma modificação na base de dados.

Scripting com Lua

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

O Ansel vem com uma linguagem de “scripting” versátil para aprimoramento de funcionalidade.

Os scripts de Lua podem ser usados para definir ações para o Ansel executar quando um evento é disparado. Um exemplo pode ser chamar um aplicativo externo durante a exportação de um arquivo para aplicar passos adicionais de processamento fora do Ansel.

O Lua é um projeto independente fundado em 1993, que proporciona uma linguagem de scripting potente, rápida, leve e integrável. O Lua é amplamente usado por muitos aplicativos de código aberto, programas comerciais e para a programação de jogos.

princípios básicos: arquivos luarc

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

Na inicialização, o Ansel executará automaticamente os scripts Lua $Ansel/luarc e $HOME/.config/Ansel/luarc (onde $Ansel é a pasta de instalação do Ansel, tipicamente /usr/share/Ansel/, e$HOME sua pasta pessoal).

Esta é a única vez que o Ansel rodará scripts Lua por si mesmo. Estes scripts podem registrar devoluções de chamada para realizar ações em vários eventos do Ansel. Este mecanismo de devolução de chamada é o método principal para desencadear ações de lua.

um exemplo simples em lua

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

Vamos começar com um exemplo simples que imprima algo no terminal. Crie um arquivo chamado luarc na pasta de configuração (usualmente $HOME/.config/Ansel/) e adicione a seguinte linha:

1print(“Olá Mundo!”)

Execute o Ansel e você verá a frase “Olá Mundo!” impressa no terminal. Nada impressionante, mas é um começo.

Neste ponto, não há nada específico do Ansel no script. Simplesmente usamos a função de impressão padrão do Lua para imprimir um texto. É legal, mas podemos fazer melhor que isso. Para acessar a API do Ansel você primeiro necessita require (requerer) e guardar o objeto em uma variável. Um vez feito isto, você pode acessar a API do Ansel como subcampos do objeto retornado. Tudo isto está documentado no manual de referência da API do Lua do Ansel.

imprimir imagens com etiqueta

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

O primeiro exemplo nos mostrou os conceitos básicos de Lua e permitiu que nos certificássemos de que tudo está funcionando corretamente. Agora vamos fazer algo um pouco mais complexo. Vamos tentar imprimir uma lista de imagens que possuam a etiqueta “vermelho” adicionada. Mas primeiramente o que é uma imagem?

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

Executar o código acima produzirá uma grande quantidade de resultados. Vamos dar uma olhada nesses resultados daqui a pouco, mas primeiro vejamos o código em si.

adicionar um atalho simples

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

Até agora, nossos scripts são executados durante a inicialização do Ansel. Isto é um uso limitado e não nos permite reagir a ações reais do usuário. Para tarefas mais avançadas, nós precisamos registrar uma função que será chamada em um determinado evento. O evento mais comum é reagir a um atalho de teclado.

1Ansel = require “Ansel”
2
3local function hello_shortcut(event, shortcut)
4Ansel.print(“Olá, eu acabei de receber '”..event..
5 “' com o parâmetro '”..shortcut..“'”)
6end
7
8Ansel.register_event(“shortcut”,hello_shortcut,
9 “Um atalho que imprime seus parâmetros”)

Agora inicie o Ansel, vá para “preferências > atalhos > lua > Um atalho que imprime seus parâmetros”, atribua um atalho e experimente. Você deve ver uma mensagem legal impressa em sua tela.

exportar imagens com lua

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

Até agora, aprendemos a usar o lua para adaptar o Ansel ao nosso fluxo de trabalho em particular. Vejamos agora como usar o lua para exportar facilmente as imagens para um serviço online. Se você puder carregar uma imagem para um serviço via linha de comando, então você pode usar o lua para integrar isto à interface do usuário do Ansel.

No próximo exemplo, usaremos o lua para exportar via scp. Aparecerá um novo tipo de armazenamento na interface do usuário do Ansel que exportará as imagens para um alvo remoto por meio do mecanismo de cópia em ssh.

construir elementos de interface do usuário

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

Nosso exemplo anterior foi um pouco limitado. Em particular, o uso de uma preferência para o caminho de exportação não é muito legal. Nós podemos fazer melhor adicionando elementos à interface do usuário na janela de exportação.

Os elementos de interface do usuário são criados por meio da função Ansel_new_widget. Esta função toma um tipo de widget como parâmetro e devolve um novo objeto correspondente a esse widget. Em seguida, você pode configurar vários campos neste widget para definir seus parâmetros. Você então usará este objeto como um parâmetro para várias funções que adicionarão elementos na interface do Ansel. O exemplo simples a seguir adiciona uma biblioteca na vista da mesa de luz com uma etiqueta simples:

compartilhar scripts

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

Até agora, todo nosso código lua esteve no luarc. Esta é uma boa maneira de desenvolver seu script mas não é muito prático para distribuição. Nós precisamos tornar isto um módulo lua adequado. Para fazer isso, nós devemos salvar o código em um arquivo separado (scp-storage.lua neste 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})

O Ansel buscará scripts (seguindo as regras normais do lua) nas pastas padrão mais a $CONFIGDIR/lua/*.lua. Assim, nosso script pode ser chamado simplesmente adicionando require “scp-storage” no arquivo luarc. Algumas notas adicionais…

chamar lua a partir do dbus

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

É possível enviar um comando lua ao Ansel via sua interface DBus. O método org.Ansel.service.Remote.Lua toma um parâmetro de cadeia de texto único que é interpretado como comando lua. O comando será executado no contexto lua atual e deveria devolver nulo ou uma cadeia de texto. O resultado será passado de volta como resultado do 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.

usar o Ansel a partir de um script lua

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

Advertência: esta função é muito experimental. É sabido que diversos elementos não funcionam ainda no modo biblioteca. Cautela ao testar é altamente recomendável.

A interface do lua permite que você use o Ansel a partir de qualquer script do lua. Isto carregará o Ansel como uma biblioteca e lhe proporcionará a maior parte da API lua (o Ansel está configurado sem cabeçalho, assim as funções relacionadas à interface do usuário não estão disponíveis).

API do lua

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

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