Stół podświetlany 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

Funkcjonalność Ansel jest podzielona na sześć różnych widoków:

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

Stół podświetlany

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.

cofnij/ponów

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

Większość zmian, wykonanych na stole podświetlanym, jest nagrywana i może zostać cofnięta do wcześniejszego stanu. Dotyczy to modyfikacji kolorowych etykiet, ocen, geolokalizacji, etykiet, metadanych, orientacji, kopiowania/wklejania historii, duplikowania zdjęć i stosowania stylu. Zauważ, że akcje cofnij/ponów nie mają licznika kroków w widoku stołu podświetlanego, ale są resetowane za każdym razem, kiedy przełączysz się na inny widok.

Naciśnij Ctrl-Z, żeby anulować ostatnią modyfikację, lub Ctrl-Y, żeby powtórzyć ostatnią anulowaną modyfikację (jeśli taka istnieje).

zarządzanie zasobami cyfrowymi

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

pliki poboczne

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.

import plików pobocznych z innych aplikacji

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.

kopie lokalne

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

Wielu użytkowników posiada ogromne kolekcje obrazów, przechowywane na dodatkowych dyskach twardych w swoich komputerach stacjonarnych lub na zewnętrznym nośniku pamięci (RAID NAS, zewnętrzne dyski twarde itp.).

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.

miniaturki

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.

tworzenie miniatur

Miniatura jest generowana po raz pierwszy przy imporcie zdjęcia do Ansel, a potem po modyfikacji zdjęcia w ciemni lub podczas odwołania się do zdjęcia, którego miniatura nie jest już dostępna.

gwiazdki i kolorowe etykiety

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

Oceny gwiazdkowe i kolorowe etykiety pomagają sortować i oceniać obrazy według twoich własnych kryteriów. Gwiazdki i kolorowe etykiety mogą być wyświetlane na miniaturach w widoku stołu podświetlanego i module rolki filmowej.

oceny gwiazdkowe

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

grupowanie zdjęć

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

Grupowanie zdjęć pomaga usprawnić ich strukturę i przejrzystość prezentacji podczas wyświetlania w widoku stołu podświetlanego.

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

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

metadane i znaczniki

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

Ansel pozwala na dołączanie dodatkowych informacji o zdjęciach dla umożliwienia ich łatwiejszego wyszukiwania i grupowania. Informacja przechowywana jest w bazie Ansel oraz plikach pobocznych XMP, a także może zostać dołączona do eksportowanych zdjęć.

metadane

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.

nadawanie etykiet

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

Ciemnia

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

Widok ciemni jest miejscem, gdzie wywołujesz zdjęcia. Środkowy panel zawiera aktualnie edytowany obraz.

powiększenie

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

Pomiędzy 1:1 a “dopasowaniem do ekranu” możesz przełączać się również rolką myszy. Wciśnięty przy przewijaniu Ctrl da możliwość rozszerzenia zakresu powiększenia od 2:1 do 1:10.

układ widoku ciemni

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

lewy panel

Od góry do dołu:

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.

prawy panel

Od góry do dołu:

kolejka przetwarzania

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

anatomia modułu

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.

kolejka przetwarzania i kolejność modułów

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

Kolejność w kolejce przetwarzania reprezentowana jest graficznie kolejnością prezentacji modułów w interfejsie użytkownika – kolejka zaczyna się plikiem RAW na dole listy modułów, stosuje kolejno moduły przetwarzające, układające się w kolejce przetwarzania od dołu do góry aż do osiągnięcia szczytu listy, gdzie tworzony jest w pełni przetworzone zdjęcie.

Uwaga: Kolejność działania modułów jest identyczna do tej, którą widzisz w panelu historii. Zmiana kolejności modułów w interfejsie użytkownika zmienia również sposób obróbki zdjęcia.

historia

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

Panel historii pokazuje całą historię edycji danego zdjęcia według kolejności przeprowadzenia poszczególnych operacji. Jest ona zapisywana w bazie biblioteki Ansel i w pliku pobocznym XMP, jest także przechowywana pomiędzy poszczególnymi sesjami edycyjnymi.

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.

cofnij i ponów

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

Podczas edycji zdjęcia Ansel rejestruje wszystkie dokonywane modyfikacje. Oznacza to, że możliwe jest cofanie i ponawianie zmian w celu powrotu do poprzednio zarejestrowanego stanu. Nie ma limitu ilości rejestrowanych zmian, ale rejestr zmian resetowany jest za każdym razem, kiedy rozpoczynasz pracę nad nowym zdjęciem w ciemni.

Naciśnij Ctrl-Z, żeby anulować ostatnią modyfikację, lub Ctrl-Y, żeby powtórzyć ostatnią anulowaną modyfikację (jeśli taka istnieje).

maski i mieszanie

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.

Dane wyjściowe modułu mogą zostać opcjonalnie przetworzone (połączone) z jego danymi wejściowymi przed przekazaniem danych do kolejnego modułu. Ten dodatkowy etap nosi nazwę mieszania – dane wejściowe i wyjściowe są przetwarzane przy użyciu algorytmów, zwanych operatorami mieszania bądź trybami mieszania.

tryby mieszania

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.

Klasyczne tryby mieszania, zaprojektowane dla ekranocentrycznego RGB (i ograniczone pomiędzy 0 i 100%), definiują w swoich algorytmach punkt podparcia jako 50% (szarość) i 100% (biel), w zależności od trybów mieszania. Ponieważ scenocentryczne RGB nie jest przedmiotem tych ograniczeń, punkty te muszą być wyraźnie określone przez użytkownika podczas jego operacji mieszania w scenocentrycznej przestrzeni barwnej RGB. Dodatkowy parametr punkt podparcia mieszania pojawia się, kiedy używasz jednego z tych trybów w tej przestrzeni barwnej. Efekt zależy od użytego operatora. Przykładowo wartości powyżej progu podparcia mogą zostać rozjaśnione, a wartości poniżej – zaciemnione (i na odwrót).

maski

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.

Maska może być traktowana jako obraz w skali szarości, gdzie każdy piksel posiada wartość pomiędzy 0 a 1.0 (lub pomiędzy 0% a 100%). Jest to wartość krycia, jest ona używana do określenia wpływu modułu na każdy piksel.

Poniżej wyjaśniamy, jak konstruować maski w Ansel.

maski wektorowe

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

Przy użyciu maski wektorowej możesz tworzyć maskę, rysując kształty bezpośrednio na obszarze roboczym. Kształty mogą być używane samodzielnie bądź w grupach. Po narysowaniu kształtu na zdjęciu może on być modyfikowany, usuwany bądź użyty ponownie w innych modułach.

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.

maski parametryczne

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

Opcja maski parametrycznej oferuje dokładną, selektywną kontrolę nad maskowaniem poszczególnych pikseli. Jest to możliwe dzięki automatycznemu stworzeniu pośredniej maski mieszania na podstawie parametrów podanych przez użytkownika. Są to charakterystyki kolorów – w odróżnieniu od współrzędnych geometrycznych, użytych w maskach wektorowych.

Dla każdego kanału danych modułu (np. Lab czy RGB) i kilku wirtualnych kanałów danych (np. odcienia czy nasycenia) można stworzyć funkcję krycia. W zależności od wartości zadanego kanału danych dla określonego piksela funkcja ta przelicza na każdy piksel współczynnik mieszania pomiędzy 0 a 1 (100%).

łączenie masek wektorowych i parametrycznych

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

Maski wektorowe i parametryczne mogą być łączone w celu stworzenia pojedynczej maski, którą można zastosować do modułu.

Sposób połączenia poszczególnych masek kontrolujemy poprzez dwa elementy: ustawienie polaryzacji każdej z masek (określane przyciskiem plusa lub minusa) oraz ustawienie wartości pola wyboru „łącz maski".

Rozwijalna lista „łącz maski" udostępnia następujące wartości, określające sposób połączenia masek:

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

uszczegóławianie maski i dodatkowe kontrolki

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

Kiedy maska parametryczna bądź wektorowa jest aktywna, dostępne jest kilka suwaków, pomagających w jej uszczegółowieniu.

próg szczegółowości: Kontrolka pozwala na zmianę krycia maski w oparciu o ilość szczegółów obrazu. Skorzystaj z tego suwaka w celu zaznaczenia obszarów z dużą ilością detali (wartość dodatnia) bądź obszarów jednolitych i pozbawionych szczegółów (wartość ujemna). Wartość domyślna (zero) pomija zawężanie do szczegółów. Kontrolka najczęściej jest wykorzystywana do zastosowania wyostrzenia bądź rozmycia, ignorującego obszary poza ostrością (bokeh) lub do wyostrzenia tylko części rozmytych, zapobiegając nadmiernemu wyostrzeniu obszarów już ostrych.

Uwaga: dane użyte dla uszczegółowienia maski brane są z etapu demozaikowania w kolejce przetwarzania, a nie z wejścia modułu (z którego korzystają inne kryteria maski parametrycznej). Żaden inny moduł po demozaikowaniu nie ma wpływu na szczegółowość maski i nie jest dostępny dla plików nie-RAW.

maski rastrowe

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

Jak opisano wcześniej, końcowym efektem maski modułu (połączonego działania masek parametrycznych i wektorowych) jest rastrowy obraz w skali szarości, reprezentujący zakres, w jakim efekt działania modułu ma zostać zastosowany do poszczególnych pikseli. Obraz ten jest przechowywany wewnętrznie na potrzeby aktywnych modułów i może być później wykorzystany przez inne moduły w kolejce przetwarzania.

Jak przy każdej masce, jeśli wartość krycia dla piksela maski rastrowej wynosi zero, wejście modułu po przejściu przez niego pozostaje niezmienione. Jeśli wartość krycia wynosi 1.0, moduł działa z pełną mocą. Dla każdej wartości pośredniej pomiędzy 0 a 1, efekt modułu stosowany jest w tym miejscu proporcjonalnie.

moduły produkcyjne (przetwarzające)

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.

aberracja chromatyczna

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

Koryguje aberracje chromatyczne.

W przeciwieństwie do modułu aberracji chromatycznej raw, ten moduł nie wymaga na wejściu surowych danych.

organizacja pracy

Dla najlepszego efektu radzimy po kolei:

Jak najbardziej zmniejszyć aberracje chromatyczne w module korekcji obiektywu przy użyciu suwaków TCA.
Zwiększyć wartość suwaka siły w tym module dla lepszego sprawdzenia efektu.
Zwiększać promień do momentu wyeliminowania aberracji. Jeśli okaże się to niewystarczające, aktywować ustawienie “bardzo duża aberracja chromatyczna'.
Wybrać prowadnicę, dającą najlepsze efekty, jeśli chodzi o ostrość i artefakty.
Zredukować siłę dla uniknięcia efektu zbytniego wyblaknięcia kolorów.

Dla bardziej skomplikowanych przypadków możesz wypróbować również poniższe rozwiązania: – użycie kilku instancji z różnymi trybami korekcji – na przykład pierwszej instancji w trybie “rozjaśniania”, a drugiej w trybie “przyciemniania”, – użycie kilku instancji z niskim natężeniem dla niewielkiej korekty aberracji chromatycznej na raz, bez zbytniej degradacji kolorów, – użycie modułu z maską parametryczną bądź wektorową, – użycie trybów mieszania kanałów RGB (czerwonego, zielonego i niebieskiego) w celu ograniczenia efektu do wskazanego kanału.

aberracja chromatyczna raw

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

Koryguje aberracje chromatyczne zdjęć 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.

balans bieli

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

Dostosowuje balans bieli zdjęcia, zmieniając temperaturę i odcień, definiując współczynnik dla każdego kanału RGB lub wybierając z listy predefiniowanych ustawień balansu bieli.

Domyślne ustawienia tego modułu pochodzą z balansu bieli aparatu, zapisanego w danych Exif obrazu.

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

balans kolorów rgb

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

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

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

wstęp

Korekcja barwna jest ważną częścią edycji obrazu. Może pomóc w usuwaniu niechcianych przebarwień, a także może zapewnić twórczą zmianę odcieni kolorów, które dodadzą atmosfery twoim zdjęciom. W czasach fotografii filmowej większość atmosfery barwnej uzyskiwano za pomocą emulsji filmowej i wywoływaczy, przy czym pewne synchronizowanie kolorów odbywało się pod powiększalnikiem z kolorowymi głowicami. Pochłaniało to kosztowne zasoby i było zarezerwowane głównie dla przemysłu kinowego, gdzie pracę wykonywał kolorysta.

cenzor

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

Zamazuje partie obrazu w ładny sposób w celu anonimizacji ludzi / obiektów lub dla ukrycia części ciała.

Moduł działa w liniowej przestrzeni RGB i stosuje fizycznie dokładne rozmycie gaussowskie oraz gaussowski szum luminancji.

Poza anonimizacją moduł ten można wykorzystać również do wielu kreatywnych zadań, takich jak na przykład:

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.

Uwaga: Metody anonimizujące, używane przez ten moduł służą estetyce, nie informatyce śledczej. Techniki tej ostatniej prawdopodobnie i tak będą w stanie odczytać cenzorowane części obrazka w oparciu o ich strukturę, dotyczy to szczególnie prostych kształtów i tekstu (np. tablic rejestracyjnych czy numerów ulic).

demozaikowanie

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

Kontroluje sposób demozaikowania plików raw.

filtry bayerowskie

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.

dithering

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

Moduł ten eliminuje niektóre artefakty pasm, które mogą wystąpić, gdy wewnętrzne 32-bitowe dane zmiennoprzecinkowe Ansel są przesyłane do dyskretnego 8-bitowego lub 16-bitowego całkowitego formatu wyjściowego w celu wyświetlenia lub eksportu.

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.

doktor negatywów

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

Process scanned film negatives.

Obraz negatywu możesz otrzymać przy użyciu skanera klisz, fotografując go pod białe światło (stół podświetlany lub monitor komputerowy) bądź przy użyciu samodzielnej lampy błyskowej.

przygotowanie

Jeżeli obraz negatywu został uzyskany za pomocą aparatu cyfrowego, to aby uzyskać wierne kolory w finalnym obrazie, należy wziąć pod uwagę następujące punkty:

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

dyfuzja lub wyostrzenie

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

Dyfuzja to rodzina procesów fizycznych, dzięki którym cząstki poruszają się i rozprzestrzeniają stopniowo w czasie ze źródła, które je generuje. W przetwarzaniu obrazu dyfuzja występuje najczęściej w dwóch miejscach:

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

W obu przypadkach dyfuzja sprawia, że obraz jest mniej ostry poprzez „wyciekanie” cząstek i wygładzanie lokalnych zmian.

Moduł dyfuzja lub wyostrzenie wykorzystuje uogólniony model fizyczny do opisania kilku rodzajów dyfuzji i może być używany przez twórców obrazów do symulacji lub odwrócenia procesów dyfuzji.

ekspozycja

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

Increase or decrease the overall brightness of an image.

Moduł posiada dwa tryby pracy:

ręczny: Ustawia ręcznie ekspozycję, korektę poziomu czerni oraz próg odcinania.
automatic (RAW images only): Use an analysis of the image’s histogram to automatically set the exposure. Ansel automatically selects the exposure compensation that is required to shift the selected percentile to the selected target level (see definitions below). This mode is particularly useful for automatically altering a large number of images to have the same exposure. A typical use case of automatic mode is deflickering of time-lapse photographs.

kontrolki modułu

tryb: Wybierz tryb operacji (automatyczny/ręczny).
skompensuj ekspozycję aparatu (tryb ręczny): Automatycznie usuwa korektę ekspozycji z aparatu (braną z danych Exif obrazu).
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.
próg odcinania (tryb ręczny): Określa procent jasnych wartości do odcięcia podczas obliczania ekspozycji i korekty poziomu czerni. Użyj próbnika do pobrania fragmentu zdjęcia, użytecznego do obliczeń.
percentyl (tryb automatyczny): Określa lokalizację na histogramie dla użycia do automatycznej korekty ekspozycji. Wartość percentyla 50% określa pozycję na histogramie, dla której 50% wartości pikseli znajduje się powyżej i 50% poniżej tej wartości ekspozycji.
docelowy poziom (tryb automatyczny): Określa docelowy poziom automatycznej korekty ekspozycji (EV) względem punktu bieli aparatu.
black level correction (manual and automatic modes): Adjust the black level point to unclip negative RGB values.

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

filtr połówkowy

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

Symuluje działanie filtru połówkowego w celu umożliwienia narastającej korekcji naświetlenia i koloru.

Na ekranie wyświetla się linia, umożliwiająca przy pomocy myszki zmianę pozycji i pochylenia gradientu.

Moduł w określonych okolicznościach generuje często artefakty bandingu. Rozważ aktywację modułu ditheringu dla uniknięcia tego efektu.

kontrolki modułu

przyciemnienie: Ustawia gęstość filtra (EV). Niska wartość powoduje lekkie niedoświetlenie, a wysoka – tworzy mocny filtr.
twardość: Twardość gradientu. Niska wartość tworzy gładkie przejście, wysoka wartość czyni je bardziej nagłym.
obrót: Obrót filtra. Wartości ujemne obracają go zgodnie z ruchem wskazówek zegara. Obrót można również kontrolować, przeciągając końce linii gradientu przy pomocy myszki.
odcień: Wybierz odcień w celu dodania zafarbu do gradientu.
nasycenie: Nasycenie zafarbu, dodanego do gradientu (domyślnie 0 dla koloru neutralnego)

gorące piksele

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

Automatically detect and eliminate hot pixels.

Gorące piksele to piksele, które błędnie rozpoznały prawidłowy poziom światła. Wykryte gorące piksele są zastępowane średnią wartością sąsiadujących pikseli.

kontrolki modułu

próg: Jak bardzo wartość piksela musi odbiegać od sąsiadujących, żeby został uznany za gorący piksel.
siła: Siła mieszania gorącego piksela z jego otoczeniem.
wykrywanie przez 3 sąsiadów: Rozszerza wykrycie gorących pikseli – uznaje piksel za gorący, jeśli tylko trzy sąsiadujące piksele (zamiast czterech) różnią się od niego ponad wartość progową.
zaznacz naprawione piksele: Wizualnie oznacza naprawione piksele na zdjęciu i wyświetla licznik gorących pikseli, które zostały naprawione.

kalibracja koloru

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

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

Ten prosty, ale potężny moduł może być użyty na kilka poniższych sposobów:

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.

kontrast miejscowy

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

Wzmacnia kontrast lokalny zdjęcia.

Efekt osiągany jest przez użycie lokalnego laplasjana (domyślnie) lub nienormalizowanego filtra bilateralnego. Obydwa tryby pracują wyłącznie na kanale L w przestrzeni Lab. Filtr lokalnego laplasjana został zaprojektowany do efektywnej pracy z niechcianymi efektami halo oraz odwróceniami gradientu wzdłuż krawędzi.

kontrolki modułu

tryb: Wybierz lokalne filtrowanie laplasjanem lub siatkę bilateralną. Opisy poniżej przedstawiają kontrolki, dostępne w obu tych trybach.

siatka bilateralna

szorstkość: Pomaga dostosować szorstkość szczegółów.
kontrast: Określa siłę rozróżniania poziomów jasności przez algorytm. Zwiększ ten parametr dla uzyskania bardziej kontrastowego obrazu.
szczegół: Dodaje lub usuwa szczegóły. Wyższe wartości zwiększają lokalny kontrast.

lokalne filtrowanie laplasjanem

Dla zrozumienia parametru filtrowania lokalnym laplasjanem można wyobrazić sobie go jako zastosowanie do zdjęcia krzywej, podobnej do poniższego rysunku:

korekcja kontrastu

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

Dostosowuje luminancję i kontrast chrominancji w domenie falkowej.

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.

Dostępnych jest kilka presetów, które powinny pomóc w zrozumieniu możliwości modułu.

korekcja obiektywu

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

Automatycznie koryguje (i symuluje) zniekształcenia obiektywu, poprzeczne aberracje chromatyczne (TCA) i winietowanie.

Moduł identyfikuje kombinację aparat/obiektyw na podstawie danych Exif i dostarcza parametrów korekcyjnych w oparciu o zewnętrzną bibliotekę lensfun .

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

korektor tonów

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

Technika “dodge and burn” z zachowaniem miejscowego kontrastu.

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.

Poniższy diagram obrazuje sposób działania korektora tonów:

krzywa filmowa rgb

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

Wykonuje przemapowanie zakresu tonalnego zdjęcia poprzez odwzorowanie odpowiedzi kolorystycznej klasycznej kliszy.

Ten moduł może być używany do rozszerzania lub zmniejszania zakresu dynamicznego sceny, aby dopasować się do zakresu dynamicznego wyświetlacza. Chroni kolory i kontrast w średnich tonach, odzyskuje cienie i kompresuje jasne światła i ciemne cienie. Najciekawsze elementy będą wymagały dodatkowej uwagi, gdy trzeba zachować szczegóły (np. chmury).

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

krzywa rgb

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

Klasyczne narzędzie fotografii cyfrowej do zmiany tonów obrazu przy użyciu krzywych.

Aktywuj próbnik po lewej stronie, aby wyświetlić wybrane wartości na wykresie (Ctrl+klik lub PPM, aby użyć selektora w trybie obszaru). Wartości liczbowe (Lab) wejścia i wyjścia (patrz poniżej) w wybranym miejscu lub obszarze są wyświetlane w lewym górnym rogu widżetu.

Drugiego selektora kolorów po prawej stronie można użyć do automatycznego tworzenia nowych węzłów na podstawie próbkowanego obszaru. Ctrl+klik+przeciągnij, aby zmienić utworzone węzły tak, aby miały dodatnią krzywą dla zaznaczonego obszaru; Shift+klik+przeciągnij, aby utworzyć krzywą ujemną.

liquify

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

Przesuwa piksele, stosując dowolne zniekształcenia do części obrazu za pomocą punktów, linii i krzywych.

węzły

Każde z narzędzi liquify opiera się na węzłach. Punkt składa się z pojedynczego węzła, a linia lub krzywa składa się z sekwencji połączonych węzłów, definiujących ścieżkę.

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.

lut 3D

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

Przekształca wartości RGB za pomocą pliku 3D LUT.

3D LUT to trójwymiarowa tablica, używana do konwersji zadanej wartości RGB do innej. Używana jest do symulowania kliszy filmowej oraz korekcji koloru.

Moduł ten akceptuje pliki .cube, .3dl, .png (haldclut) oraz .gmz. Nieskompresowane dane 3D LUT nie są zapisywane w bazie danych ani w pliku XMP, ale zamiast tego są zapisywane w ścieżce pliku 3D LUT w folderze głównym 3D LUT. Dlatego ważne jest, aby prawidłowo wykonać kopię zapasową folderu 3D LUT — udostępnianie obrazu za pomocą XMP jest bezcelowe, jeśli odbiorca nie ma również tego samego pliku 3D LUT we własnym folderze 3D LUT.

naprawa profilu wejściowego

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

Dodaje krzywą korekcji do danych zdjęcia. Wymagana, jeśli zaznaczono odpowiednie profile wejściowe w module wejściowego profilu koloru.

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.

obracanie pikseli

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

Sensory niektórych aparatów (takich jak Fujifilm FinePix S2Pro, F700 czy E550) posiadają ukośny wzór matrycy Bayera, zamiast zwyczajowego prostokątnego.

Bez stosowania korekcji prowadzi to do kafelkowanego zdjęcia z czarnymi narożnikami. Moduł przeprowadza wymaganą korekcję.

Ansel wykrywa zdjęcia, wymagające korekcji, korzystając z danych Exif, i w razie potrzeby automatycznie aktywuje moduł. Dla innych zdjęć moduł ten zawsze pozostaje nieaktywny.

Moduł nie posiada elementów sterujących.

obramowanie

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

Generate a frame around the image.

Obramowanie składa się z ramki (w kolorze zdefiniowanym przez użytkownika) oraz linii ramki, stanowiącej jej granicę wewnętrzną (w drugim zdefiniowanym kolorze). Do kontroli geometrii i koloru ramki można użyć wielu opcji.

kontrolki modułu

rozmiar linii ramki: Rozmiar ramki jako procent pełnego obrazu.
proporcja boków: Proporcje końcowego modułu wyjściowego (tj. obraz pod spodem plus ramka)
orientacja: Orientacja ramki (portret/krajobraz). Wybierz „auto” dla Ansel, aby wybrać najbardziej rozsądną orientację w oparciu o zdjęcie, znajdujące się pod spodem.
pozycja w pionie/poziomie: Wybierz z zestawu predefiniowanych proporcji, aby kontrolować położenie obrazu pod spodem na osi poziomej/pionowej. Możesz także kliknąć prawym przyciskiem myszy i wprowadzić własny współczynnik jako „x/y”.
rozmiar linii ramki: Procent rozmiaru linii ramki w stosunku do rozmiaru obramowania w jego najmniejszej części.
przesunięcie linii ramki: Pozycja linii ramki w stosunku do obrazu pod spodem. Wybierz 0% dla linii ramki, która dotyka obrazu. Wybierz 100% dla linii ramki, która dotyka zewnętrznej granicy.
kolor obramowania / kolor linii ramki: Para selektorów kolorów, które umożliwiają zdefiniowanie kolorów linii obramowania i ramki. Kliknięcie na kolorowe pole otworzy okno dialogowe wyboru koloru, które oferuje wybór najczęściej używanych kolorów lub pozwala zdefiniować kolor w przestrzeni kolorów RGB. Możesz także aktywować próbnik kolorów, aby pobrać próbnik kolorów z obrazu.
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.

obrót i perspektywa

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

Automatycznie koryguje zbieżne linie, forma zniekształcenia perspektywy. Podstawowy mechanizm zainspirowany został programem Markusa Hebla ShiftN . Moduł ten pozwala również na regulację obrotu obrazu.

Zniekształcenia perspektywy są naturalnym efektem rzutowania trójwymiarowej sceny na dwuwymiarową płaszczyznę i powodują, że obiekty znajdujące się blisko widza wydają się większe, niż obiekty leżące dalej. Zbiegające się linie są szczególnym przypadkiem zniekształceń perspektywy często obserwowanych na fotografiach architektonicznych — równoległe linie sfotografowane pod kątem są przekształcane w zbieżne linie, które spotykają się w pewnym punkcie obserwacyjnym w obrębie lub poza ramką zdjęcia.

odszumianie (profilowane)

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

Prosty w obsłudze i wysoce wydajny moduł odszumiania, dostosowany do indywidualnych profili szumów szerokiej gamy sensorów aparatów.

Jednym z problemów z wieloma algorytmami odszumiania jest to, że zakładają one, że wariancja szumu jest niezależna od jasności sygnału. Profilując charakterystykę szumu matrycy aparatu przy różnych ustawieniach ISO, można ocenić wariancję przy różnych jasnościach, a algorytm odszumiania można dostosować w celu bardziej równomiernego wygładzenia szumu.

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

odszumianie (raw)

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

Perform denoising on raw image data before it is demosaiced.

Moduł został przeportowany z dcraw .

kontrolki modułu

próg szumu: Próg wykrycia szumu. Wyższe wartości oznaczają silniejszą redukcję szumu i większą utratę szczegółów zdjęcia.
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.

odszumianie astrofotograficzne

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.

Ponieważ odszumianie jest zasobożernym procesem, znacząco spowalnia ono kolejkę przetwarzania. Rozważ aktywację tego modułu dopiero pod koniec pracy nad zdjęciem.

orientacja

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

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

Moduł domyślnie jest włączony, a orientacja (obrót) strony ustawiana jest w oparciu o dane Exif zdjęcia.

kontrolki modułu

przekształć: Kliknij dwukrotnie belkę nazwy modułu, aby przywrócić domyślne transformacje.
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.

poziomy rgb

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

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

Narzędzie poziomów rgb pokazuje histogram obrazu i wyświetla trzy paski z uchwytami. Przeciągnij uchwyty, aby zmienić jasność, średni szary i biały punkt (w trybie „RGB, połączone kanały”) lub niezależnie dla każdego z kanałów R, G i B (w trybie „RGB, niezależne kanały”).

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.

przycięcie

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.

Ilekroć ten moduł posiada fokus, zostanie wyświetlony cały nieprzycięty obraz, nałożony na uchwyty przycinania i opcjonalne prowadnice.

punkt czerni/bieli RAW

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

Define camera-specific black and white points.

Moduł aktywuje się automatycznie dla wszystkich plików raw. Domyślne ustawienia stosowane są dla wszystkich wspieranych aparatów. Na ogół nie ma potrzeby zmiany ustawień domyślnych.

kontrolki modułu

poziom czerni 0-3: Określony dla aparatu poziom czerni czterech pikseli matrycy RGGB Bayera. Piksele o wartości niższej od progowej uważane są za niezawierające istotnych danych.
punkt bieli: Określony dla aparatu poziom bieli. Wszystkie piksele z wyższymi wartościami będą podlegać działaniu modułu ratowania prześwietleń.
flat field correction: Use flat field correction to compensate for lens shading. This field only appears for applicable Raw files and will automatically use any GainMap embedded in the Raw. You can choose to disable this correction if desired.

ratowanie prześwietleń

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

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

Jeśli piksele zostały odcięte od lewej strony, może to generować nierealistyczne kolory na zdjęciu. Przykładowo, piksele z obciętymi zieleniami i niebieskimi, na zdjęciu bez ratowania prześwietleń pojawią się jako czerwone.

Dostępne są trzy metody odzyskiwania:

przycinanie świateł: Wyrównuje piksele do poziomu bieli (czyli obcina pozostałe kanały kolorów). Metoda jest najbardziej użyteczna w przypadkach, kiedy obcięte światła pojawiają się w bezbarwnych obszarach, jak na przykład chmury na niebie.
rekonstrukcja w LCh: Analizuje każdy piksel z obciętym co najmniej jednym kanałem i próbuje naprawić obcięty piksel (w przestrzeni LCh) przy użyciu wartości pozostałych pikseli (3 dla matrycy Bayera lub 8 dla X-Trans) w przetwarzanym bloku sensorów. Odzyskane światła będą wciąż monochromatyczne, ale jaśniejsze i bardziej szczegółowe, niż przy wykorzystaniu przycięcia świateł. Metoda działa dobrze z krzywą bazową o wysokim kontraście, która odwzorowuje światła z niskim nasyceniem. Podobnie, jak przycinanie świateł, to dobra opcja na obiekty z naturalnym niewielkim nasyceniem.
rekonstrukcja koloru: Korzysta z algorytmu, przenoszącego informację o kolorze z zachowanego sąsiedztwa do obciętych świateł. Metoda działa dobrze w obszarach homogenicznych kolorów, a szczególnie na odcieniach skóry z gładko zacienionymi światłami. Zauważ, że może ona generować artefakty schodkowe w światłach za wysoko kontrastowymi krawędziami, takimi jak dobrze wyeksponowane struktury przed prześwietlonym tłem.
guided laplacians: Use an algorithm (derived from the diffuse or sharpen module) to replicate details from valid channels into clipped channels and to propagate color gradients from valid surrounding regions into clipped regions. This is a slow and computationally-intensive method designed for maximum smoothness and seamless blending of the reconstructed regions into their neighborhood, and is designed primarily to reconstruct spotlights and specular reflections. This mode is available for Bayer sensors only.

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

rekonstrukcja koloru

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

Odzyskuje informacje o kolorze w prześwietleniach.

Z racji natury cyfrowych sensorów, prześwietleniom brakuje ważnych informacji o kolorze. Najczęściej są one czysto białe lub noszą jakiś kolorowy zafarb w zależności od tego, czy miał miejsce jakiś etap przetwarzania obrazu. Ten moduł może zostać użyty do “uzdrowienia” prześwietleń poprzez zamianę ich kolorów na lepiej pasujące. Moduł działa na pikselach, których luminancja przekracza zdefiniowany wcześniej próg. Kolory zamienników brane są z sąsiadujących pikseli. Do wyboru koloru można określić zasięg przestrzenny oraz zasięg luminancji.

retusz

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

Usuwa niechciane elementy z obrazu, klonując, naprawiając, zamazując i wypełniając za pomocą narysowanych kształtów.

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.

rozmycie

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

Symuluje fizycznie dokładne rozmycia w scenocentrycznej przestrzeni RGB.

rodzaj rozmycia

Obsługiwane są trzy rodzaje rozmycia:

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

Diagram u góry modułu pokazuje kształt operatora rozmycia (znanego jako funkcji rozmycia punktowego ). Moduł zamieni każdy punkt świetlny ze sceny w plamę w kształcie wyświetlanego operatora rozmycia, o rozmiarze plamki zdefiniowanym przez promień rozmycia.

rozmywanie powierzchni

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.

skalowanie pikseli

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

Komórki sensorów niektórych aparatów (jak np. Nikona D1X) mają kształt prostokątny, a nie kwadratowy. Bez korekcji powoduje to zniekształcenia zdjęć. Moduł przeprowadza wymaganą korekcję.

Ansel wykrywa zdjęcia, wymagające korekcji, korzystając z danych Exif, i w razie potrzeby automatycznie aktywuje moduł. Dla innych zdjęć moduł ten zawsze pozostaje nieaktywny.

Moduł nie posiada elementów sterujących.

strefy kolorów

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

Selektywnie dostosowuje jasność, nasycenie i odcień pikseli w oparciu o ich aktualną jasność, nasycenie i odcień.

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.

Najpierw musisz wybrać, czy chcesz dopasować (wybrać) piksele na podstawie ich jasności, nasycenia czy odcienia. Następnie możesz użyć trzech krzywych na odpowiednich zakładkach, aby dostosować jasność, nasycenie i odcień zakresów pikseli wybranych tą metodą.

tablica kolorów

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

kontrolki modułu

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).; Aby zaznaczyć próbkę, możesz ją kliknąć, wybrać z listy lub skorzystać z próbnika. Aktualnie wybrana próbka zaznaczona jest białą obwódką, a jej numer wyświetlany jest w rozwijalnej liście poniżej.

usuwanie zamglenia

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

Automatycznie redukuje efekt kurzu i mgły w atmosferze. Moduł może być również wykorzystany bardziej ogólnie do nadania zdjęciom intensywniejszego koloru, szczególnie w obszarach o niskim kontraście.

Zamglenie pochłania światło z obiektów w kadrze, ale samo jest również źródłem rozproszonego światła w tle. Moduł usuwania zamglenia najpierw ocenia, dla każdego fragmentu zdjęcia, stopień zamglenia, a następnie usuwa światło tła, zgodnie z jego miejscową siłą, odzyskując oryginalne oświetlenie obiektu.

Ustawienie obu kontrolek na pełną wartość maksymalizuje ilość usuniętego zamglenia, ale jednocześnie często tworzy artefakty. Całkowite usunięcie światła atmosferycznego może spłaszczyć obraz i zaowocować nienaturalnym jego wyglądem. Optymalne wartości często znajdują się poniżej maksimum i rzadko zależą od samego zdjęcia, a w dużej części – od osobistego gustu.

wejściowy profil koloru

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

Define how Ansel will interpret the colors of the image.

Moduł pobiera przestrzeń barwną, używaną przez źródło zdjęcia (np. aparat lub skaner) i konwertuje kodowanie pikseli do standaryzowanej roboczej przestrzeni barwnej. Oznacza to, że późniejsze moduły w kolejce przetwarzania nie muszą być rozpatrywane w kontekście określonego urządzenia wejściowego i mogą pracować i przeprowadzać konwersje do/z roboczej przestrzeni barwnej.

Kiedy obraz zostanie zapisany w surowym pliku, moduł wejściowego profilu koloru zastosuje standardową lub rozszerzoną macierz kolorów, dedykowaną dla tego modelu aparatu, która zostanie użyta do zmapowania kolorów na przestrzeń barwną profilu roboczego. Jeśli informacja o przestrzeni barwnej osadzona jest w pliku zdjęcia, moduł wejściowego profilu koloru użyje tej informacji podczas mapowania kolorów na przestrzeń barwną profilu roboczego. Użytkownik może również wyraźnie określić przestrzeń barwną dla obrazu wejściowego, a nawet dostarczyć profil ICC, dedykowany specjalnie dla określonego urządzenia wejściowego.

winietowanie

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

Apply a vignetting effect to the image.

Winietowanie to modyfikacja jasności i nasycenia na granicach obrazu w określonym kształcie. Wiele z wymienionych poniżej parametrów można również modyfikować za pomocą graficznej kontrolki, która nakłada obraz, gdy moduł jest wybrany, pokazując kształt i zakres efektu.

Uwaga: wiadomo, że ten moduł w określonych warunkach wywołuje artefakty pasowania (ang. banding). Rozważ aktywację modułu ditheringu, aby temu zapobiec.

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

wyjściowy profil koloru

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

Ustawia profil wyjścia dla eksportu oraz sposób odwzorowania barw dla mapowania przejścia pomiędzy przestrzeniami barwnymi.

Ansel posiada predefiniowane profile sRGB, Adobe RGB, XYZ oraz liniowego RGB. Dodatkowe profile możesz dostarczyć i zapisać w $Ansel/share/Ansel/color/out i $HOME/.config/Ansel/color/out ($Ansel oznacza katalog instalacyjny Ansel, a $HOME – twój katalog domowy).

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

kontrolki modułu

output intent: The rendering intent for output/export. Rendering intent can only be selected when using LittleCMS2 to apply the output color profile (this can be changed in preferences > processing). If Ansel’s internal rendering routines are used, this option is hidden. For more details see rendering intent.
profil eksportu: Profil, który ma zostać użyty do renderowania dla wyjścia/eksportu. Dane profilu zostaną osadzone w pliku wyjściowym (jeśli wspiera to format tego pliku), umożliwiając innym aplikacjom poprawną interpretację kolorów. Ponieważ nie wszystkie programy rozpoznają profile barwne, zalecamy pozostanie przy sRGB, chyba że jesteś świadomy wszystkich konsekwencji zmiany tego parametru.

wyostrzenie

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

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

Moduł ten działa poprzez zwiększenie kontrastu wokół krawędzi, a tym samym zwiększenie wrażenia ostrości obrazu. Ten moduł jest stosowany do kanału L w przestrzeni kolorów Lab.

Uwaga: algorytm USM używany w tym module wykonuje rozmycia w przestrzeni barwnej Lab, co może powodować niepożądane efekty i nie jest już zalecane. Zamiast tego użyj ustawień wstępnych oferowanych przez moduł korektora kontrastu do usuwania rozmycia lub moduł kontrastu lokalnego do ostrości ogólnej.

ziarno

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

Symuluje ziarno kliszy filmowej. Ziarno przetwarzane jest w kanale L przestrzeni Lab.

kontrolki modułu

szorstkość: Rozmiar ziarna, zmienny dla zasymulowania wartości ISO.
siła: Siła efektu.

znak wodny

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

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

Możesz również korzystać z plików graficznych map bitowych (PNG).

Procesor SVG w Ansel może również zastępować ciągi w dokumencie SVG, umożliwiając umieszczenie w znaku wodnym informacji zależnych od konkretnego zdjęcia.

Zaprojektowane przez użytkownika znaki wodne należy umieścić w katalogu $HOME/.config/Ansel/watermarks. Po umieszczeniu na miejscu użyj przycisku przeładowania, aby zaktualizować listę dostępnych znaków wodnych.

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.

Pokaz slajdów

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.

użycie

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

Widok pokazu slajdów jest wciąż na wczesnym etapie rozwoju i zawiera tylko podstawowy zestaw funkcji.

 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

Wskazówka: aby w pełni wykorzystać rozmiar ekranu, przełącz Ansel w tryb pełnoekranowy, naciskając F11 i ukryj elementy sterujące obramowaniem, naciskając klawisz B.

Wydruk

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.

Moduł ten obsługuje profil ICC drukarki, co jest poniekąd obowiązkowe, jeśli chcesz uzyskać wydruk wysokiej jakości, zbliżony do obrazu wyświetlanego na ekranie.

układ widoku wydruku

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

Środkowy obszar przedstawia układ zdjęcia na papierze (biel). Pojawiające się niekiedy szare obwódki dokoła zdjęcia symbolizują obszar wydruku (stronę bez brzegów), nie wypełniony obrazem.

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

overlays

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

GUI toolboxes

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

analiza obrazu

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

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

Najedź myszą na panel, aby wyświetlić przyciski umożliwiające dostosowanie wyświetlania. Skrajny lewy przycisk przełącza tryb między histogramem, zakresem przebiegu, zakresem parady RGB i wektoroskopem. Pozostałe przyciski sterują sposobem rysowania wykresu dla bieżącego zakresu.

Display metadata

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

Wyświetla informacje osadzone w danych Exif obrazu, a także szereg dodatkowych pól danych zdefiniowanych przez Ansel.

Po najechaniu kursorem myszy na miniatury obrazów, wyświetlane dane są automatycznie aktualizowane, aby pokazać informacje o aktualnym zdjęciu pod kursorem myszy.

Gdy wybranych jest kilka obrazów, a fokus nie jest ustawiony na pojedynczym obrazie, moduł wyświetla tylko informacje, które są takie same dla wszystkich obrazów. Jeśli jakiekolwiek pola różnią się między obrazami, zamiast tego wyświetlany jest tekst „<różne wartości>”.

edytor metadanych

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

Edit the metadata of selected images.

Metadane to dowolny tekst (tytuł, opis, twórca, wydawca, prawa itp.), który opisuje twoje obrazy.

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

eksport

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

Eksport zaznaczonych zdjęć.

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

kontrolki modułu

opcje lokalizacji

miejsce docelowe

Typ lokalizacji do przechowywania wybranych obrazów. Zaimplementowano obsługę wiele różnych miejsc, w tym pliki na dysku, szablon książki LaTeX i różne albumy internetowe. W zależności od wybranego celu możesz zostać poproszony o podanie dodatkowych informacji, takich jak nazwy plików lub nazwa konta i hasło.

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.

katalog docelowy

Przycisk obok wpisu szablonu nazwy pliku otwiera okno dialogowe wyboru katalogu nadrzędnego do eksportu.

w przypadku konfliktu

Wybierz, co zrobić, jeśli wygenerowana nazwa pliku koliduje z istniejącym plikiem podczas eksportu:

twórz unikalną nazwę: Automatycznie wybiera unikalną nową nazwę pliku przez dodanie liczby całkowitej do nazwy pliku powodującego konflikt.

overwrite: Automatically overwrite existing files. This option will present you with a confirmation dialog in order to protect you from accidental data loss – you can disable this in preferences > security > ask before exporting in overwrite mode. Note: This dialog is not presented per-file but as a one-off confirmation before the export job starts.

pomiń: Nie eksportuje zdjęć, dla których nazwa pliku docelowego już istnieje.

opcje formatu

format pliku: Określa format pliku dla eksportowanego zdjęcia. W zależności od wybranego formatu poniżej pojawią się dodatkowe opcje.
jakość: Jakość eksportowanego pliku. Wyższe wartości prowadzą do większych rozmiarów plików. Jakość domyślna (95) to dobre ustawienie w przypadku eksportu o bardzo wysokiej jakości (np. do celów archiwizacji lub drukowania). Jeśli potrzebujesz dobrego kompromisu między rozmiarem a jakością (np. do wyświetlania obrazów online lub przesyłania), powinieneś zamiast tego rozważyć wartość „90”.
głębia bitowa: Liczba bitów używanych dla każdego kanału koloru. Więcej bitów oznacza mniej posteryzacji/kolorowych pasm.
kompresja: Typ użytej kompresji.
poziom kompresji: W przypadku formatów eksportu, w których można określić kompresję, poziom kompresji określa stopień kompresji do zastosowania. Im wyższy poziom, tym bardziej dane zostaną skompresowane, kosztem większej liczby cykli procesora.
obraz czarno-biały: W przypadku formatu eksportu TIFF możliwe jest zapisanie obrazu monochromatycznego. To ustawienie określa, czy wynikowy plik koduje odcienie szarości jako oddzielne kanały RGB, czy jako pojedynczy kanał w skali szarości. Ta druga opcja spowoduje zmniejszenie plików.

ustawienia globalne

ustaw rozmiar

Określa sposób pomiaru maksymalnego rozmiaru eksportowanego zdjęcia

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

w cm (do wydruku): Wprowadź maksymalną szerokość i wysokość w cm oraz zdefiniuj dpi obrazu. Odpowiednik rozmiaru w pikselach zostanie obliczony automatycznie.

w calach (do wydruku): Wprowadź maksymalną szerokość i wysokość w calach oraz zdefiniuj dpi obrazu. Odpowiednik rozmiaru w pikselach zostanie obliczony automatycznie.

według skali (dla plików): Wprowadź mnożnik, aby określić, o ile eksportowany obraz powinien być przeskalowany w porównaniu z obrazem wejściowym. Na przykład wprowadzenie wartości 0,5 spowoduje, że obraz wyjściowy będzie miał połowę szerokości i wysokości (w pikselach) oryginalnego zdjęcia.

dpi

Jeśli wybrano jednostki cm lub cale, ustawia dpi obrazu wyjściowego. Dpi będzie również przechowywane w danych Exif eksportowanego obrazu. Zostanie automatycznie ustawiony na 300, jeśli wybrano „w pikselach” lub „według skali”.

największy rozmiar

Ustawia maksymalną szerokość i wysokość eksportowanego obrazu w pikselach, cm lub calach (w zależności od wybranej jednostki) – zero oznacza, że dla danego wymiaru nie obowiązuje żadne ograniczenie. Wyeksportowane obrazy zostaną ograniczone tak, aby nie przekroczyć żadnej z tych wartości, przy zachowaniu prawidłowych proporcji. Ustaw oba na zero, aby wyeksportować z oryginalnymi wymiarami (po przycięciu). Jeśli wprowadzone wartości przekraczają oryginalne wymiary, Ansel albo wyeksportuje z oryginalnymi wymiarami, albo przeskaluje obraz w górę, w zależności od parametru „zezwalaj na skalowanie”.

zezwól na powiększanie

Ustawienie na „tak” pozwoli przeskalować zdjęcie, jeśli maksymalna szerokość i wysokość zdefiniowana przez użytkownika przekracza oryginalne wymiary obrazu. Jeśli ustawisz opcję na „nie”, wymiary eksportowanego obrazu nie przekroczą wymiarów oryginalnego obrazu (po przycięciu).

skalowanie wysokiej jakości

Ustawienie opcji na „tak”, wykona wysokiej jakości ponowne próbkowanie obrazu. Obraz zostanie przetworzony w pełnej rozdzielczości i dopiero na samym końcu przeskalowany w dół. Czasami może to skutkować lepszą jakością, ale zawsze będzie wolniejsze.

store masks

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

profile

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

intent

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

style

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

mode

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

export

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

Uwaga: zdjęcia wybrane, ale obecnie ukryte (ponieważ należą do zwiniętej grupy) nie zostaną wyeksportowane.

geotagging

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

Importuje i stosuje dane śladu GPX do wybranych zdjęć.

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.

organizacja pracy z danymi

Odbiornik GPS oblicza swoją aktualną pozycję na podstawie informacji otrzymywanych z satelitów i zapisuje je w pliku GPX wraz z aktualną datą i godziną. Dane Exif zdjęć zawierają również znacznik czasu, zdefiniowany przez ustawienia aparatu. Moduł geotagging pobiera znacznik czasu obrazu, wyszukuje pozycję w pliku GPX w tym czasie i przechowuje odpowiednie współrzędne (szerokość/długość geograficzna/wysokość npm) w swojej bazie danych oraz pliku obrazu pobocznego XMP.

globalny próbnik koloru

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.

Próbnik kolorów jest aktywowany przez naciśnięcie ikony próbnika kolorów. Parametry modułu będą obowiązywać do momentu wyjścia z trybu ciemni.

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.

historia operacji

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

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

Ten moduł wyświetla każdą zmianę stanu (aktywację/deaktywację/przeniesienie/zmianę parametrów) dla wszystkich modułów przetwarzania, które zostały zmodyfikowane dla bieżącego obrazu. Wybierz punkt na stosie, aby powrócić do tego punktu w historii rozwoju obrazu. Shift+kliknij element na stosie historii, aby rozwinąć ten moduł w prawym panelu modułu bez zmiany bieżącej edycji.

Uwaga: jeśli wybierzesz moduł ze stosu historii, a następnie wprowadzisz dalsze modyfikacje obrazu, wszystkie zmiany powyżej aktualnie wybranego kroku zostaną odrzucone. W ten sposób łatwo stracić efekty swojej pracy! Zwykle możesz użyć Ctrl+Z, aby cofnąć takie zmiany.

instalator skryptów 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.

kolejność modułów

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.

kontrola gamutu

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

Wyróżnia obszary zdjęcia, które mogą wykazywać przycinanie gamutu.

Click the

are mutually exclusive modes.

Kliknij PPM ikonę, aby otworzyć okno dialogowe z parametrami konfiguracyjnymi – są one takie same, jak w przypadku opcji korekty ekranowej.

Możesz również rozważyć użycie ostrzeżenia o przycięciu, które zapewnia również ostrzeżenia o niedoświetleniu i prześwietleniu, a także kontrolę gamutu, podobną do oferowanej przez ten moduł.

korekta ekranowa

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

Podgląd zdjęcia przy użyciu wybranego profilu barwnego.

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.

Library

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

Filtruje zdjęcia, wyświetlane w widoku podświetlanym i rolki filmowej za pomocą atrybutów obrazu. Ten zestaw przefiltrowanych obrazów jest znany jako kolekcja.

Zdjęcia importowane do Ansel zachowują informacje o nich (nazwę pliku, ścieżkę, dane Exif, dane z plików pomocniczych XMP itp.) w bazie danych biblioteki Ansel. Kolekcję można zdefiniować, stosując reguły filtrowania do tych atrybutów, tworząc w ten sposób podzbiór obrazów do wyświetlenia w widoku podświetlanym i module rolki filmu.

Domyślna kolekcja jest oparta na atrybucie rolki filmu i wyświetla wszystkie zdjęcia z ostatniej zaimportowanej lub wybranej rolki filmu.

manager masek

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.

menedżer duplikatów

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.

nadawanie etykiet

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

Zarządzanie etykietami, dołączonymi do zdjęć.

Etykiety umożliwiają dodawanie informacji do obrazów za pomocą słownika słów kluczowych. Możesz także zarządzać etykietami jako drzewem hierarchicznym, co może być przydatne, gdy ich liczba staje się duża.

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

definicje

Kolejne przykłady zakładają, że ustawiłeś pojedynczą etykietę o nazwie “miejsca|Francja|Nord|Lille”.

etykieta: Etykieta to opisowy łańcuch znaków, który może być dołączony do zdjęcia. Etykietą może być pojedynczy wyraz lub sekwencja połączonych wyrazów, tworzących ścieżkę i oddzielonych symbolem potoku |. Przykładowo “miejsca|Francja|Nord|Lille” to pojedyncza etykieta, gdzie każdy element ścieżki tworzy mniejszy podzbiór elementów przed nim. Do zdjęcia możesz dołączyć dowolną ilość etykiet.; Do etykiety możesz dołączyć właściwości (nazwę, określenie prywatności, kategorię, synonimy i kolejność na zdjęciu).

nawigacja

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

Możliwości powiększania i poruszania się po bieżącym obrazie.

W lewym górnym rogu ciemni panel nawigacyjny wyświetla pełny podgląd bieżącego zdjęcia z prostokątem pokazującym obszar, który jest aktualnie widoczny w panelu środkowym. Przeciąganie tego prostokąta przesunie także powiększony widok. Bieżąca skala powiększenia jest wyświetlana po prawej stronie obrazu podglądu. Kliknij tę liczbę, aby uzyskać szybki dostęp do niektórych typowych poziomów powiększenia.

Panel nawigacyjny można włączać/wyłączać za pomocą skrótu klawiaturowego (domyślnie Ctrl+Shift+N).

ocena koloru

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

Ocenia kolory i jasność obrazu, stosując zalecane warunki wyświetlania ISO 12646:2008.

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

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

W efekcie końcowy obraz może być zbyt ciemny i nadmiernie przetworzony pod względem kontrastu i nasycenia kolorów. Aby tego uniknąć, norma „ISO 12646:2008” zawiera pewne zalecenia dotyczące warunków, w jakich należy oceniać kolory obrazu. Moduł oceny koloru w ciemni umieszcza ramkę wokół obrazu, aby pomóc użytkownikowi lepiej ocenić kolory obrazu, zgodnie z tymi zaleceniami.

ostrzeżenie przed prześwietleniami 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.

położenia

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

Create areas or locations and organize them as hierarchical tags.

Po wybraniu lokalizacja jest wyświetlana jako kształt na mapie. Początkowo każda lokalizacja jest reprezentowana jako kwadrat lub okrąg i można ją zmienić w prostokąt lub elipsę, dostosowując szerokość i/lub wysokość kształtu.

Lokalizację można również utworzyć z wielokąta regionu OpenStreetMap (miasto/kraj). W tym celu najpierw upewnij się, że parametr max polygon points jest wystarczająco duży (niektóre wielokąty krajów używają więcej niż 150 000 punktów). Następnie wybierz żądaną lokalizację w module wyszukaj położenie. Kiedy odpowiedni kształt regionu jest wyświetlany, symbol wielokąta staje się dostępny w kontrolce „kształt” (patrz poniżej). Wybierz go, aby utworzyć nową lokalizację.

prowadnice i nakładki

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

Podczas edycji na obraz można nałożyć wiele często używanych linii pomocniczych do kompozycji. Można je włączyć globalnie (cały czas) lub lokalnie (gdy niektóre moduły są aktywne).

Inne funkcje ciemni również rysują kolorowe linie nakładki na obrazie (na przykład maski wektorowe). Dostępna jest również opcja zmiany koloru tych nakładek (p. poniżej).

prowadnice globalne

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.

rolka filmu

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

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

sprawdzanie gamutu

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

Wyróżnia obszary obrazu, które mogą wykazywać przycięcie luminancji lub gamy.

Gdy obraz jest wysyłany na monitor, każdy piksel jest zwykle reprezentowany jako zestaw 3 liczb, reprezentujących intensywność kolorów podstawowych czerwonego, zielonego i niebieskiego w wyjściowej przestrzeni kolorów. Ponieważ wyjściowa przestrzeń kolorów jest zwykle ściśle związana ze sprzętem z fizycznymi ograniczeniami, istnieje maksymalna dozwolona wartość dla kanałów [R,G,B], reprezentująca maksymalną dostępną intensywność dla tej przestrzeni kolorów. Podobnie istnieje również minimalna wartość, poniżej której wartości pikseli zostaną zmapowane na zero. Kiedy próbujemy przekonwertować z większej przestrzeni kolorów na końcową przestrzeń kolorów wyjściowych, wszelkie wartości przekraczające to maksimum zostaną ograniczone do wartości maksymalnej, a wszelkie wartości poniżej minimum zostaną ograniczone do zera. Ten proces nazywa się „przycinaniem” i prowadzi do utraty szczegółów lub „nieprawidłowych” kolorów dla wszystkich pikseli z przyciętymi kanałami.

style

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.

Moduł wyświetla listę wszystkich dostępnych stylów. Pole wyszukiwania nad listą pozwala znaleźć styl przez nazwę lub opis. Moduł pozwala również na edycję i usuwanie stylów.

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.

ustawienia mapy

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

Wybierz preferowane dane map od różnych dostawców. Niektóre udostępniają dodatkowe warstwy (widok satelitarny itp.), które można przełączać.

kontrolki modułu

źródło mapy

Pozwala wybrać dostawcę map.

liczba punktów wielokąta

Moduł wyszukaj położenie nie wyświetla wielokątów z większą liczbą punktów ze względu na wydajność. Zwykle wielokąt kraju ma od 50 000 do 150 000 punktów.

wyświetl nakładkę

Określa, czy wyświetlać kontrolki nakładki graficznej w lewym górnym rogu środkowego widoku.

przefiltrowane obrazy

Zaznacz to pole, aby wyświetlić tylko obrazy z bieżącej kolekcji (te pokazane na rolce filmu) w widoku centralnym. Usuń zaznaczenie tego pola, aby wyświetlić wszystkie obrazy w bieżącej bibliotece, gdzie te obrazy mają powiązane dane GPS. Możesz także przełączyć tę opcję, naciskając Ctrl+S.

maksymalne obrazy

Maksymalna liczba miniatur, wyświetlanych na mapie.

współczynnik rozmiaru grupy

Zwiększa lub zmniejsza rozmiar obszaru, który powoduje grupowanie obrazów.

minimalna liczba obrazów w grupie

Minimalna liczba obrazów, które należy umieścić w tej samej pozycji, aby automatycznie utworzyć dla nich grupę obrazów.

wyświetlanie miniatur

Określa, jakie informacje mają być wyświetlane na mapie

miniaturka: Wyświetla miniatury obrazów wraz z licznikiem.

licznik zdjęć: Wyświetla tylko liczbę zdjęć (aby zwolnić miejsce na mapie). Najedź kursorem na liczbę zdjęć, aby wyświetlić odpowiednią miniaturę. Znacznik tylko zliczający zachowuje się tak samo, jak normalna miniatura obrazu, jeśli chodzi o kodowanie kolorów, przewijanie, przeciąganie i upuszczanie itp.

brak: Nie pokazuj niczego.

Możesz także przełączać się między tymi opcjami, naciskając klawisze Shift+S.

ustawienia wydruku

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

Manage settings for the print view and initiate printing.

kontrolki modułu

drukarka

drukarka: Wybierz jedną z zainstalowanych drukarek.
materiały: Rodzaj nośnika, załadowanego do drukarki (papier zwykły, papier fotograficzny z połyskiem itp.).
profil: Profil ICC drukarki dla załadowanego papieru. Jest to profil specyficzny dla drukarki i papieru. Ten profil to ostatnia transformacja przestrzeni kolorów zastosowana do obrazu, której celem jest stworzenie wysokiej jakości wydruku.
intent: The print rendering intent (“perceptual”, “relative colorimetric”, “saturation” or “absolute colorimetric”). See rendering intent for more details.
kompensacja punktu czerni: Określa, czy dostosować punkt czerni profilu wyjściowego, który często jest jaśniejszy niż profil wejściowy. Powinno to być „włączone”, gdy odwzorowanie barw jest ustawione na „względny kolorymetryczny”.

strona

rozmiar papieru: Rozmiar papieru do wydruku.
orientation: Portrait or landscape (note that darktable chooses the best fit by default).
jednostki: Jednostka używana do ustawiania marginesów: „mm”, „cm” lub „cale”.
marginesy: Ustawia każdy margines osobno lub wszystkie razem z wykorzystaniem środkowego przycisku „kłódki”.
wyświetl siatkę: Wybiera rozmiar siatki za pomocą pola tekstowego (wyrażonego w aktualnie wybranej jednostce). Zaznacz opcję wyświetlania siatki na płótnie.
wyrównaj zdjęcia do siatki: Pomaga w ustawieniu obszarów zdjęcia, przyciągając je do siatki w celu prawidłowego wyrównania.
wymagany tryb bez marginesów: Wskazuje, czy ma być włączony tryb drukarki bez marginesów. Ta pozycja jest aktywowana, gdy marginesy użytkownika są mniejsze, niż marginesy sprzętowe drukarki. Zwróć uwagę, że jest to tylko wskaźnik, ponieważ nie aktywuje automatycznie trybu bez marginesów.

układ zdjęcia

szerokość/wysokość zdjęcia: To pole informacyjne wyświetla rzeczywistą szerokość i wysokość obrazu (podaną w wybranych jednostkach) na papierze.
współczynnik skalowania: To pole informacyjne wyświetla skalowanie zdjęcia w celu dopasowania do papieru. Jeśli ta wartość jest mniejsza niż 1, obraz jest skalowany w dół, w przeciwnym razie jest skalowany w górę. Jest to ważny czynnik, który należy obserwować — zbyt duża wartość (przeskalowanie w górę) może skutkować niską jakością wydruku. Wyświetlana jest również odpowiednia rozdzielczość (punktów na cal).
rozmieszczenie: Określa wyrównanie obrazu na jego obszarze.
przycisk nowego obszaru obrazu: Tworzy nowy obszar zdjęcia. Przeciągnij i upuść na płótnie, aby go umieścić. Jeśli włączona jest opcja przyciągania do siatki, obszar można łatwo wyrównać do linii siatki. Zdjęcie można umieścić w tym obszarze, przeciągając go z rolki filmu i upuszczając w nowym obszarze.
przycisk usuwania obszaru obrazu: Usuwa aktualnie wybrany obszar obrazu z kompozycji.
przycisk „wyczyść układ”: Usuwa wszystkie obszary zdjęcia, pozostawiając puste płótno.

Kolejne cztery pola reprezentują pozycję aktualnie wybranego obszaru na stronie — górny/lewy róg w pierwszym wierszu i szerokość/wysokość obszaru w drugim wierszu.

wykrywanie ostrości

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.

wyszukaj położenie

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

Wyszukuje miejsce na mapie. Do działania tej funkcji wymagane jest połączenie z internetem.

Aby skorzystać z tego modułu, wpisz nazwę miejsca lub adres, naciśnij Enter, a zostanie wyświetlona lista wyników. Kliknij element na liście, a mapa powiększy się do tego położenia. Zostanie wyświetlony kontur obejmujący to położenie lub pinezka je wskazująca.

Kontur (wielokąt) może służyć do tworzenia położenia użytkownika. Sprawdź parametr liczba punktów wielokąta w module ustawień mapy, aby upewnić się, że dostępna jest wystarczająca liczba punktów do wyświetlenia wielokąta.

zrzuty obrazu

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

Przechowuje robocze zrzuty obrazu i umożliwia ich porównanie z bieżącą edycją.

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.

zmienne

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

Ansel wspiera podstawianie zmiennych w części modułów i ustawień. Takimi obszarami są na przykład:

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

Ustawienia Ansel

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.

Wszelkie zmienione ustawienia (tj. te, które różnią się od ich stanu domyślnego) są wyróżnione obok nich punktorem. Jeśli zmienisz ustawienie, które wymaga ponownego uruchomienia, aby odniosło skutek, po wyjściu z okna ustawień pojawi się komunikat przypominający.

ogólne

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

Kontroluje ogólne wrażenia wizualne Ansel.

język interfejsu: Ustawia język interfejsu użytkownika. Domyślny język systemu oznaczony jest jako * (wymaga restartu).
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”).
użyj systemowego rozmiaru czcionki: Określa rozmiar czcionki zdefiniowany przez system. Jeśli jest ona odznaczona, możesz wprowadzić niestandardowy rozmiar czcionki w polu poniżej (domyślnie włączone).
rozmiar czcionki w punktach: Jeśli opcja “użyj systemowego rozmiaru czcionki” jest wyłączona, określa rozmiar czcionki (w punktach) dla Ansel. Rozmiar czcionki jest natychmiast zmieniany.
DPI kontrolek GUI i tekstu: Dostosowuje globalną rozdzielczość GUI, aby przeskalować kontrolki, przyciski, etykiety itp. Zwiększ, aby powiększyć GUI, zmniejsz, aby zmieścić więcej zawartości w oknie. Ustaw na -1, aby użyć zdefiniowanej przez system rozdzielczości globalnej. W większości systemów domyślna wartość to 96 DPI. (wymaga restartu)

CSS theme modifications

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

stół podświetlany

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

Control functionality in the lighttable view and modules.

ogólne

ukryj wbudowane ustawienia dla modułów narzędziowych: Jeśli ta opcja jest włączona, tylko presety użytkownika będą wyświetlane w menu presetów dla modułów narzędziowych — wbudowane będą ukryte (domyślnie wyłączone).
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.

miniaturki

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.

ciemnia

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

Control functionality in the darkroom view and associated modules.

ogólne

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).
pokaż ekran ładowania pomiędzy zdjęciami: Pokazuje szary ekran ładowania podczas nawigowania między obrazami w ciemni. Wyłącz tę opcję, aby wyświetlić prostą wiadomość wyskakującą i pozostawić poprzednie zdjęcie na miejscu, dopóki nie zostanie załadowany następny obraz. Pamiętaj, że wyłączenie tej opcji może być bardzo przydatne do szybkiego porównywania zduplikowanych obrazów, jednak mogą wystąpić problemy z długimi czasami ładowania (co prowadzi do myślenia, że następny obraz został już załadowany)m mogą także pojawić się artefakty wizualne podczas ładowania następnego zdjęcia (domyślnie włączone).

moduły

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

ukryj wbudowane presety dla modułów produkcyjnych

Jeśli ta opcja jest włączona, w menu presetów modułów produkcyjnych będą wyświetlane tylko ustawienia zdefiniowane przez użytkownika — wbudowane presety będą ukryte (domyślnie wyłączone).

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.

przetwarzanie

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

Kontroluje przetwarzanie zdjęć.

przetwarzanie obrazu

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.; Jeśli dany profil ICC jest oparty na LUT lub zawiera zarówno LUT, jak i macierz, Ansel użyje LittleCMS 2 do renderowania kolorów niezależnie od wartości tego parametru (domyślnie wyłączone).

zabezpieczenia

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

Określa, czy pokazywać ostrzeżenia przed podjęciem wybranych działań.

ogólne

ask before removing images from the library: Always ask before removing image information from Ansel’s library database, where the xmp file is retained (default on).
pytaj przed usuwaniem zdjęć z dysku: Zawsze pytaj przed usunięciem pliku zdjęcia (domyślnie włączone).
pytaj przed porzucaniem historii edycji: Zawsze pytaj przed odrzuceniem stosu historii obrazu (domyślnie włączone).
próbuj korzystać z kosza przy usuwaniu zdjęć: Zamiast fizycznie usuwać obrazy z dysku, próbuj najpierw umieścić je w systemowym koszu (domyślnie włączone).
zapytaj przed przenoszeniem zdjęć z katalogu rolki filmu: Zawsze pytaj przed przeniesieniem pliku zdjęcia (domyślnie włączone).
pytaj przed kopiowaniem zdjęć do nowego katalogu rolki filmu: Zawsze pytaj przed skopiowaniem pliku obrazu do nowej lokalizacji (domyślnie włączone).
pytaj przed usunięciem pustych folderów: Zawsze pytaj przed usunięciem każdego pustego folderu. Może się to zdarzyć po przeniesieniu albo usunięciu zdjęć (domyślnie wył.)
pytaj przed usunięciem etykiety: Zawsze pytaj przed usunięciem etykiety ze zdjęcia (domyślnie włączone).
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.

inne

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

za kulisami

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

Przetwarzanie zdjęć w wysokiej rozdzielczości jest złożonym zadaniem, wymagającym dobrego komputera. Rozpatrując pamięć i moc obliczeniową procesora, zaawansowana obróbka 15-, 20- czy 25-megapikselowego zdjęcia może szybko doprowadzić twój komputer na skraj jego możliwości.

Wymagania Ansel nie są wyjątkiem. Wszystkie obliczenia są wykonywane na 4 x 32-bitowych liczbach zmiennoprzecinkowych. Jest to wolniejsze od „zwykłej” 8 lub 16-bitowej algebry liczb całkowitych, ale eliminuje wszystkie problemy z przerwami tonacji lub utratą informacji.

Podjęto wiele optymalizacji, aby uczynić Ansel tak szybkim, jak to możliwe. Jeśli uruchomisz aktualną wersję Ansel na nowoczesnym komputerze, możesz nie zauważyć żadnej powolności. Istnieją jednak warunki i pewne moduły, w których poczujesz (lub usłyszysz – wycie wentylatora procesora) ciężar zadań, z którymi musi się zmagać twój biedny wielordzeniowy procesor.

sposób działania opencl

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

Jak możesz sobie wyobrazić, architektura sprzętowa procesorów graficznych może się znacznie różnić. Istnieją różni producenci, a nawet różne generacje procesorów graficznych tego samego producenta mogą nie być porównywalne. Jednocześnie producenci procesorów graficznych zwykle nie ujawniają publicznie wszystkich szczegółów sprzętowych swoich produktów. Jedną z konsekwencji tego jest konieczność używania własnościowych sterowników pod Linuksem, jeśli chcesz w pełni wykorzystać swoją kartę graficzną.

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

aktywacja opencl w Ansel

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

Korzystanie z OpenCL w Ansel wymaga, aby twój komputer był wyposażony w odpowiednią kartę graficzną i wymagane biblioteki. Większość nowoczesnych kart graficznych firm NVIDIA i AMD ma pełną obsługę OpenCL. Kompilator OpenCL jest zwykle dostarczany jako część własnościowego sterownika graficznego i jest używany jako biblioteka dynamiczna o nazwie libOpenCL.so. Ta biblioteka musi znajdować się w folderze, w którym może być znaleziona przez dynamiczny linker twojego systemu.

Po uruchomieniu Ansel najpierw spróbuje znaleźć i załadować libOpenCL.so, a jeśli się powiedzie, sprawdzi, czy dostępna karta graficzna obsługuje OpenCL. Aby Ansel mógł korzystać z GPU, musi być dostępna wystarczająca ilość pamięci graficznej (1 GB+). Jeśli to sprawdzenie zakończy się pomyślnie, Ansel spróbuje skonfigurować swoje środowisko OpenCL: należy zainicjować kontekst przetwarzania, uruchomić kolejkę obliczeniową, pliki kodu źródłowego OpenCL (rozszerzenie to .cl) muszą zostać odczytane i skompilowane oraz dołączone procedury (jądra OpenCL) muszą być przygotowane na moduły Ansel. Jeśli to wszystko zakończy się pomyślnie, przygotowania są zakończone.

konfiguracja opencl

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

Ogromna różnorodność systemów i wyraźne różnice między dostawcami OpenCL a wersjami sterowników uniemożliwiają kompleksowy przegląd konfiguracji OpenCL. Możemy podać tylko przykład, w tym przypadku dla wersji sterownika NVIDIA 331.89 w systemie Ubuntu 14.04. Mamy nadzieję, że będzie to podstawowe wprowadzenie i pomoże rozwiązać wszelkie problemy, związane z konfiguracją.

Zasada działania funkcji OpenCL wygląda następująco:

Ansel > libOpenCL.so > libnvidia-opencl.so.1 > moduł(y) sterownika jądra > GPU

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

możliwe problemy i rozwiązania

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

Ansel automatycznie wykryje błędy uruchomieniowe OpenCL. Po wykryciu błędu ponownie przetworzy wszystko na procesorze. Chociaż spowolni to przetwarzanie, nie powinno to wpłynąć na wynik końcowy.

Może istnieć wiele przyczyn niepowodzenia OpenCL podczas fazy inicjalizacji. OpenCL zależy od wymagań sprzętowych oraz obecności określonych sterowników i bibliotek. Ponadto wszystkie muszą pasować pod względem producenta, modelu i numeru wersji. Jeśli coś nie pasuje (np. twój sterownik graficzny – załadowany jako moduł jądra – nie pasuje do wersji twojego libOpenCL.so), obsługa OpenCL prawdopodobnie nie będzie dostępna.

profil szeregowania

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).
bardzo szybki GPU: Z tym profilem szeregowania Ansel przetwarza sekwencyjnie widok środkowego obrazu i okno podglądu na GPU. Jest to preferowane ustawienie w przypadku systemów z procesorem graficznym, który znacznie przewyższa procesor.
wiele GPU: To ustawienie dotyczy systemów z wieloma procesorami GPU, których względna wydajność nie różni się znacząco. Za każdym razem, gdy uruchamiane jest zadanie przetwarzania, Ansel używa aktualnie nieaktywnego procesora graficznego, ale nie procesora. Użytkownicy systemów z różnymi procesorami graficznymi będą potrzebować lepszej kontroli nad ich względnym priorytetem. Lepiej byłoby, gdyby wybrali „domyślny” profil i dostroili swój system za pomocą parametru konfiguracyjnego „opencl_device_priority” (patrz wiele urządzeń).

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.

wiele urządzeń

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

Szeregowanie urządzeń OpenCL można zoptymalizować w większości systemów za pomocą ustawień „profil szeregowania OpenCL”. Jeśli jednak twój system jest wyposażony w więcej niż jeden procesor graficzny, możesz ręcznie ustawić względny priorytet urządzenia. W tym celu należy wybrać „domyślny” profil planowania i zmienić ustawienia w parametrze konfiguracyjnym „opencl_device_priority”.

Ważne jest, aby zrozumieć, w jaki sposób Ansel korzysta z urządzeń OpenCL. Każda sekwencja przetwarzania obrazu — aby przekonwertować dane wejściowe na końcowy wynik przy użyciu stosu historii — jest uruchamiana w kolejce przetwarzania. W Ansel są cztery różne kolejki. Jedna odpowiada za przetwarzanie centralnego widoku obrazu (lub pełnego widoku) w trybie ciemni, inna przetwarza obraz podglądu (okno nawigacji). W dowolnym momencie może być uruchomiony jedna z tych dwóch kolejek, przy czym kolejki pełne i podglądowe działają równolegle. Ponadto może istnieć wiele równoległych kolejek, wykonujących eksport plików, a także wiele równoległych kolejek, generujących miniatury. Jeśli urządzenie OpenCL jest dostępne, Ansel dynamicznie przypisuje je do jednej konkretnej kolejki na jeden przebieg i zwalnia go później.

opencl wciąż u mnie nie działa

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

Wiele potencjalnych problemów pojawi się tylko w przypadku bardzo konkretnych kombinacji tych czynników. Ponieważ programiści Ansel mają dostęp tylko do niewielkiej części tych odmian zrozum, że możemy nie być w stanie rozwiązać twojego konkretnego problemu. Niewiele możemy zrobić, jeśli nie będziemy w stanie odtworzyć sytuacji, w której pojawia się błąd.

memory & performance tuning

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

memory requirements

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

miejsca danych

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

baza danych

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”).
próg fragmentacji bazy danych: Współczynnik fragmentacji (w procentach), powyżej którego należy przeprowadzić konserwację bazy danych (z zastrzeżeniem wyboru dokonanego w powyższej opcji) (domyślnie 25).
utwórz zrzut bazy danych: Określa, jak często Ansel powinien tworzyć migawki bazy danych. Dostępne opcje to „nigdy”, „raz na miesiąc”, „raz na tydzień”, „raz dziennie” i „podczas zamykania” (domyślnie „raz na tydzień”)
ile kopii zapasowych przechowywać: Liczba migawek do zachowania po utworzeniu nowej migawki, nie licząc kopii zapasowych bazy danych, wykonanych podczas przenoszenia między wersjami Ansel. Wpisz „-1”, aby przechowywać nieograniczoną liczbę migawek. (domyślnie 10)

xmp

zapisuj plik poboczny dla każdego zdjęcia

Pliki XMP zapewniają nadmiarową metodę zapisywania zmian, które wprowadziłeś na zdjęciu, oprócz zmian zapisanych w bazie danych Ansel. Ta opcja pozwala wybrać, kiedy zapisać te pliki. Dostępne opcje to:

nigdy: Nie zapisuj plików XMP. Może to być przydatne, jeśli używasz wielu wersji Ansel do celów programistycznych/testowych, ale zwykle nie jest to zalecane

przy imporcie: Plik XMP zostanie zapisany zaraz po dodaniu obrazu do biblioteki Ansel i będzie aktualizowany za każdym razem, gdy go edytujesz

po edycji: Plik XMP zostanie zapisany przy pierwszej edycji obrazu i będzie aktualizowany przy każdej kolejnej edycji. Importowanie domyślnie nie wygeneruje pliku XMP.

Zalecamy zdecydowanie wybranie opcji „przy imporcie” lub „po edycji”. Pliki XMP zapewniają przydatne zabezpieczenie przed awariami, dzięki czemu nie utracisz danych w przypadku uszkodzenia bazy danych. Utworzenie kopii zapasowej surowego pliku oraz towarzyszącego mu pliku XMP umożliwi pełne przywrócenie pracy w późniejszym terminie poprzez ponowne zaimportowanie historii edycji z powrotem do Ansel (domyślnie „przy imporcie”).

różne

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

interfejs

load default shortcuts at startup: When launching the application, Ansel loads default shortcuts first, and then loads user-defined shortcuts on top. This allows default shortcuts to be overridden with a new action but prevents them from being deleted (since the deleted shortcut will be automatically reloaded on the next restart). Deactivate this preference to stop loading default shortcuts on startup – only load the user-defined ones (including any defaults that you have not subsequently deleted or overridden). This makes deletion easier but also means that you will not benefit from new shortcuts added in future versions without first re-enabling this preference (default on).
scale slider step with min/max: When activated, the default step-size, when altering sliders, will depend on the current min/max values for that slider (default on).
sortuj wbudowane presety jako pierwsze: Wybierz sposób sortowania menu presetów. Jeśli ta opcja jest włączona, wbudowane presety są wyświetlane jako pierwsze. Jeśli opcja jest wyłączona, ustawienia użytkownika są wyświetlane jako pierwsze (domyślnie włączone).
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.

etykiety

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

shortcuts with multiple instances

Możliwe jest tworzenie wielu instancji wielu modułów produkcyjnych. W tym scenariuszu nie zawsze jest oczywiste, która instancja ma być kontrolowana za pomocą skrótów klawiaturowych. Poniższe opcje sterują regułami, które są stosowane (w kolejności), aby zdecydować, do których instancji modułu mają być zastosowane skróty klawiszowe.

skróty

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

presety

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.

Presety predefiniowane (te, które są domyślnie zawarte w Ansel) są wyświetlane z symbolem blokady. Ich właściwości nie mogą być zmienione.

Presety użytkownika można importować z wyeksportowanych plików .dtpreset za pomocą przycisku „importuj” u dołu ekranu. Możesz wyeksportować wszystkie zdefiniowane przez użytkownika presety do jednego katalogu za pomocą przycisku „eksportuj”.

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

zarządzanie kolorem

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.

profil monitora

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.

metoda renderingu

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

Ansel może renderować kolory za pomocą własnych wewnętrznych algorytmów lub przy użyciu zewnętrznej biblioteki LittleCMS2. Wewnętrzna metoda Ansel jest o rząd wielkości szybsza, niż zewnętrzna. Opcja zewnętrzna daje z kolei wybór sposobu renderowania i może w niektórych przypadkach oferować nieco wyższą dokładność.

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

Uwaga: Jeśli dany ICC jest oparty na LUT lub zawiera zarówno LUT, jak i macierz, Ansel użyje LittleCMS2 do renderowania kolorów niezależnie od wartości parametru konfiguracyjnego.

sposób odwzorowania barw

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.

przestrzenie barwne Ansel

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

Obrazy wejściowe to albo pliki RGB (takie jak JPEG lub TIFF), albo pliki RAW z aparatu. Oba przechowują informacje wizualne jako kombinację podstawowych kolorów (np. czerwonego, zielonego i niebieskiego), które razem opisują emisję światła, która ma być odtworzona przez monitor.

Tę koncepcję ilustruje poniższe zdjęcie.

kolory spoza zakresu

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

Ekrany i większość formatów plików graficznych może kodować tylko intensywność RGB w określonym zakresie. Na przykład obrazy zakodowane na 8 bitach mogą zawierać tylko wartości od 0 do 255, obrazy na 10 bitach od 0 do 1023 i tak dalej… Standardy graficzne postulują, żeby maksimum tego zakresu, bez względu na jego rzeczywistą wartość, zawsze reprezentowała maksymalna jasność, jaką jest w stanie oddać nośnik wyświetlacza, zwykle od 100 do 160 Cd/m² (lub nitów), w zależności od aktualnego standardu. Na ogół nazywamy to maksimum „100% ekranocentryczny”. Minimalny zakres, zakodowany jako 0, bez względu na użytą głębię bitową, staje się wtedy „0 % ekranocentryczny”. 100% koduje czystą biel, 0% koduje czystą czerń.

możliwe artefakty koloru

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.

Stwierdzono, że wysoce nasycone źródła światła niebieskiego w ramce obrazu są prawdopodobnie kandydatami na piksele o ujemnych wartościach L. Jeśli zajmujesz się fotografią sceniczną, powinieneś zwrócić szczególną uwagę na takie światła, pojawiające się na obrazach.

wymiary kolorów Ansel

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

Ta sekcja definiuje percepcyjne właściwości koloru, zarówno koncepcyjnie, jak i ilościowo, w celu scharakteryzowania i ilościowego określenia kreatywnych i korygujących korekt koloru w Ansel.

definicje

Właściwości kolorów, takie jak „nasycenie”, „jaskrawość” (bightness) lub „jasność” (lightness), weszły do powszechnego użycia, ale są w dużej mierze niewłaściwie używane i często używane do okreslania różnych rzeczy. W nauce o kolorach każdy z tych terminów ma dokładne znaczenie.

Istnieją dwa schematy, w ramach których można analizować i opisywać właściwości kolorów:

Command Line Interface

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

Ansel

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

Komenda `Ansel’ uruchamia Ansel z graficznym interfejsem i pełną funkcjonalnością. Jest to standardowa metoda pracy z Ansel.

Ansel może być wywołane z następującymi parametrami linii poleceń:

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

Wszystkie parametry są opcjonalne. W większości przypadków Ansel powinno być uruchamiane bez dodatkowych parametrów, użyje wtedy rozsądnych wartości domyślnych.

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.

Ten wariant nie otwiera żadnego ekranu - działa w trybie czystej konsoli bez uruchamiania GUI. Ten tryb jest szczególnie przydatny w przypadku serwerów, wykonujących zadania w tle.

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

Użytkownik musi określić plik wejściowy i wyjściowy. Pozostałe parametry są opcjonalne.

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

Plik binarny Ansel-cltest sprawdza, czy w twoim systemie istnieje użyteczne środowisko OpenCL, z którego może korzystać Ansel. Emituje pewne dane debugowania, które jest równoważne wywołaniu Ansel -d opencl, a następnie kończy działanie.

Ansel-cltest jest wywoływane bez parametrów linii poleceń.

Ansel-cmstest

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

Plik binarny Ansel-cmstest (tylko Linux) sprawdza, czy podsystem zarządzania kolorami na komputerze jest poprawnie skonfigurowany i wyświetla przydatne informacje o zainstalowanych profilach monitora.

Ansel-cmstest wywoływane jest bez parametrów linii poleceń.

purge_non_existing_images.sh

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

Znajduje i usuwa wpisy z bazy danych biblioteki odnoszące się do obrazów, które już nie istnieją w systemie plików. Musisz zamknąć Ansel przed uruchomieniem tego skryptu.

Skrypt może być uruchamiany z następującymi parametrami linii poleceń:

1purge_non_existing_images.sh [-c|--configdir <ścieżka>]
2 [-l|--library <ścieżka>]
3 [-p|--purge]

Uruchom skrypt bez dodatkowych opcji, aby wykonać „próbne uruchomienie”, generujące raport o brakujących plikach bez wprowadzania jakichkolwiek zmian w bazie danych.

Skrypty Lua

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

Ansel wyposażony jest w interfejs elastycznego języka skryptowego dla rozszerzenia możliwości.

Skrypty lua mogą być użyte do określenia w Ansel akcji, wyzwalanych po wystąpieniu określonego zdarzenia. Przykładem może być wywołanie zewnętrznej aplikacji podczas eksportu plików w celu zastosowania dodatkowych procedur przetwarzania spoza Ansel.

Lua to niezależny projekt, założony w 1993 r., oferujący potężny, szybki, lekki i osadzalny język skryptowy. Lua jest szeroko używana przez wiele aplikacji otwartoźródłowych, w oprogramowaniu komercyjnym oraz przy tworzeniu gier.

podstawy: pliki luarc

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

Po starcie Ansel automatycznie załaduje skrypty Lua, $Ansel/share/Ansel/luarcoraz $HOME/.config/Ansel/luarc (gdzie $Ansel oznacza katalog instalacyjny Ansel, a $HOME – katalog domowy użytkownika).

To jedyny przypadek, kiedy Ansel samodzielnie wywołuje skrypt Lua. Skrypty mogą rejestrować wywołania zwrotne (ang. callbacks) do obsługi różnych zdarzeń w Ansel. Mechanizm ten jest podstawową metodą wyzwalania akcji lua.

prosty przykład lua

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

Zacznijmy z prostym przykładem, wypisującym cokolwiek na konsolę. Utwórz plik luarcw katalogu konfiguracyjnym Ansel (na ogół jest to $HOME/.config/Ansel/) i dodaj w nim następującą linię:

1print("Hello World!")

Uruchom Ansel, a na konsoli pojawi się zdanie “Witaj, świecie!” Na razie szału nie ma, ale spokojnie, zaraz się rozkręci…

Do tego miejsca w skrypcie nie ma nic charakterystycznego dla Ansel. Chcąc wypisać łańcuch, wykorzystaliśmy po prostu standardową funkcję print. Działa, ale stać nas na więcej. Dla dostępu do API potrzebujemy wywołać require i zapisać zwrócony obiekt do zmiennej. Po wykonaniu tego zyskujesz dostęp do API Ansel jako składowych zwróconego obiektu. Całość udokumentowana jest w podręczniku Lua API.

drukowanie oznakowanych zdjęć

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

Pierwszy przykład pokazał podstawy lua i pozwolił sprawdzić, czy wszystko działa poprawnie. Zróbmy teraz coś bardziej skomplikowanego. Spróbujmy wydrukować listę zdjęć, mających dołączoną “czerwoną” (ang. red) etykietę. Ale… co to jest zdjęcie?

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

Uruchomienie tego kodu wygeneruje wiele komunikatów. Przyjrzymy się im za chwilę, na razie przeanalizujmy sam kod:

dodanie prostego skrótu klawiszowego

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

Dotychczas nasze skrypty wykonywały jedynie akcje przy starcie programu. Nie jest to bardzo użyteczne i nie pozwala na odpowiedź wobec faktycznych czynności użytkownika. Do wykonania bardziej zaawansowanych rzeczy będziemy potrzebować rejestracji funkcji, która zostanie wywołana w reakcji na określone zdarzenie. Najczęstszym zdarzeniem jest reakcja na wciśnięcie skrótu klawiszowego.

1Ansel = require "Ansel"
2
3local function hello_shortcut(event, shortcut)
4Ansel.print("Czołem, właśnie otrzymałem zdarzenie '"..event..
5 "' z parametrem '"..shortcut.."'")
6end
7
8Ansel.register_event("shortcut",hello_shortcut,
9 "Skrót, który wypisuje swoje parametry")

Uruchom Ansel, przejdź do “ustawienia > skróty > lua > Skrót, który wypisuje swoje parametry”, przypisz skrót klawiszowy i wypróbuj go. Powinieneś zobaczyć ładną wiadomość, wypisaną na ekranie.

eksport zdjęć przy użyciu lua

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

Do tej pory nauczyliśmy się używać lua do adaptacji Ansel w naszym systemie pracy. Zobaczmy teraz, jak zaprząc lua do łatwego eksportu zdjęć do serwisu online. Jeśli jesteś w stanie przesłać plik na serwer przy użyciu linii poleceń, możesz użyć lua do automatyzacji tego z poziomu interfejsu użytkownika Ansel.

W tym przykładzie użyjemy lua do eksportu poprzez scp. W interfejsie Ansel pojawi się nowy typ miejsca docelowego, który wyeksportuje zdjęcia do zdalnej lokacji poprzez mechanizm kopiowania w ssh.

tworzenie elementów interfejsu użytkownika

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

Nasz poprzedni przykład był nieco ograniczony, na przykład sposób korzystania z ustawień dla ścieżki eksportu nie był zbyt ładny. Możemy to zrobić lepiej, dodając elementy interfejsu użytkownika w oknie eksportu.

Elementy interfejsu tworzone są funkcją `Ansel_new_widget. Jako parametr przyjmuje ona typ kontrolki i zwraca nowy obiekt klasy tej kontrolki. Możesz następnie ustawić jej różne pola w celu określenia parametrów. Sam obiekt można wykorzystać jako parametr różnych funkcji, które dodadzą go do interfejsu Ansel. Poniższy prosty przykład dodaje bibliotekę z prostą etykietą w widoku stołu podświetlanego:

udostępnianie skryptów

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

Cały nasz kod znajduje się do tej pory w luarc. To dobre miejsce na rozwój kodu, ale niekoniecznie do jego dystrybucji. Potrzebujemy umieścić go w odpowiednim module lua. W tym celu zapiszemy kod w odrębnym pliku (w tym przypadku scp-storage.lua):

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

Ansel poszuka skryptów (zgodnie z regułami lua) w standardowych katalogach plus $CONFIGDIR/lua/*.lua. Nasz skrypt może więc być wywoływany poprzez proste dodanie require "scp-storage" w pliku luarc. Jeszcze tylko kilka uwag…

wywołanie lua z dbus

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

Możliwe jest wysłanie komendy lua do Ansel poprzez interfejs DBus. Metoda org.Ansel.service.Remote.Luapobiera parametr w postaci pojedynczego łańcucha znaków, interpretowany jako komenda lua. Komenda zostanie wykonana w aktualnym kontekście lua i powinna zwrócić łańcuch znakowy lub wartość nil. Wynik zostanie zwrócony jako rezultat metody 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.

użycie Ansel ze skryptu lua

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

Uwaga: Ta opcja jest mocno eksperymentalna. Wiemy o kilku elementach, które wciąż nie działają dobrze w trybie biblioteki. Zalecamy ostrożne testy.

Interfejs lua pozwala na korzystanie z Ansel z dowolnego skryptu lua. Spowoduje to załadowanie Ansel jako biblioteki i udostępnienie większości API lua (Ansel jest skonfigurowane bez plików nagłówkowych, więc funkcje interfejsu użytkownika nie są dostępne).

Poniższy program zaprezentuje przykładowo wypisanie listy wszystkich zdjęć z Twojej biblioteki:

 1#!/usr/bin/env lua
 2package = require "package"
 3package.cpath=package.cpath..";./lib/Ansel/lib?.so"
 4
 5dt = require("Ansel")(
 6"--library", "./library.db",
 7"--datadir", "./share/Ansel",
 8"--moduledir", "./lib/Ansel",
 9"--configdir", "./configdir",
10"--cachedir","cachedir",
11"--g-fatal-warnings")
12
13require("Ansel.debug")
14
15for k,v in ipairs(dt.database) do
16 print(tostring(v))
17end

Zwróć uwagę na trzecią linię, wskazującą lokalizację pliku libAnsel.so.

API lua

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

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