Command Line Interface

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

Ansel can called with the following command line parameters:

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

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

The ansel-cli binary starts the command line interface variant of Ansel which allows images to be exported.

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

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

 1ansel-cli [<input file or folder>]
 2              [<xmp file>]
 3              <output file or folder>
 4              [--width <max width>]
 5              [--height <max height>]
 6              [--hq <0|1|true|false>]
 7              [--upscale <0|1|true|false>]
 8              [--style <style name>]
 9              [--style-overwrite]
10              [--apply-custom-presets <0|1|false|true>]
11              [--out-ext <extension>]
12              [--import <file or dir>]
13              [--icc-type <type>]
14              [--icc-file <file>]
15              [--icc-intent <intent>]
16              [--verbose]
17              [--help [option]]
18              [--core <Ansel options>]

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

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.

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

Ansel-cltest is called without command line parameters.

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

Ansel-cmstest is called without command line parameters.

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

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

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

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