Darktable
Бінарний файл darktable запускає Darktable з його графічним інтерфейсом та повною функціональністю. Це стандартний спосіб використання Darktable. Команда для запуску бінарного файлу залежить від вашої ОС.
Доступні такі параметри командного рядка:
darktable [-d {all,act_on,ai,cache,camctl,camsupport,common,control,
dev,expose,fswatch,imageio,input,ioporder,lighttable,lua,
masks,memory,nan,opencl,params,perf,pipe,print,pwstorage,
signal,sql,tiling,undo,verbose}]
[--d-signal <сигнал>]
[--d-signal-act <all,raise,connect,disconnect,print-trace>]
[--disable-pipecache]
[<вхідний файл>|<папка зображень>]
[--version]
[--disable-opencl]
[--configdir <каталог конфігурації користувача>]
[--library <файл бібліотеки>]
[--datadir <каталог даних>]
[--moduledir <каталог модулів>]
[--tmpdir <каталог тимчасових файлів>]
[--cachedir <каталог кешу користувача>]
[--localedir <каталог перекладів інтерфейсу програми>]
[--luacmd <команда Lua>]
[--noiseprofiles <файл JSON профілів шуму>]
[--conf <ключ>=<значення>]
[-t <кількість потоків OpenMP>]
Усі параметри необов’язкові. У більшості випадків Darktable слід запускати без будь-яких додаткових параметрів, і в цьому випадку Darktable використовує значення за замовчуванням.
-d {all,act_on,ai,cache,camctl,camsupport,common,control,dev,expose,fswatch,imageio,input,ioporder,lighttable,lua,masks,memory,nan,opencl,params,perf,print,pwstorage,signal,sql,tiling,undo,verbose}- Увімкнути вивід налагодження на термінал. Існує кілька підсистем Darktable, і кожну з них можна налагоджувати окремо. Ви можете використовувати цю опцію кілька разів, якщо хочете налагодити більше однієї підсистеми (наприклад,
darktable -d opencl -d camctl) або налагодити всі з них одночасно (за допомогою-d all). Опція-d commonнадається для збору інформації про найбільш релевантні підсистеми під час налагодження Darktable або якщо ви хочете надати журнал для звіту про проблему Darktable. Деякі опції налагодження (наприклад,-d opencl) також можуть забезпечити більш докладний вивід, який можна викликати за допомогою додаткової опції-d verbose. Ця додаткова опція має бути надана явно, навіть якщо використовується-d all. --d-signal <signal>- If
-d signalor-d allis specified, specify the signal to debug using this option. SpecifyALLto debug all signals or specify signal using its full name. Can be used multiple times. --d-signal-act <all,raise,connect,disconnect,print-trace>- Якщо вказано
-d signalабо-d all, вкажіть дію сигналу для налагодження за допомогою цієї опції. --disable-pipecache- Вимкнути кеш конвеєра обробки. Ця опція дозволяє використовувати лише дві кеш-лінії на конвеєр, і її слід використовувати лише для налагодження.
<вхідний файл> | <папка із зображеннями>- Необов’язково вкажіть ім’я файлу зображення або папки. Якщо вказано ім’я файлу, Darktable запускається в режимі темної кімнати з відкритим файлом. Якщо вказано ім’я папки, Darktable запускається в режимі світлого стола із вмістом цієї папки як поточною колекцією.
--version- Надрукувати номер версії Darktable, повідомлення про авторські права та іншу корисну інформацію, а потім завершитись.
--disable-opencl- Заборонити Darktable ініціалізувати підсистему OpenCL. Використовуйте цю опцію, якщо Darktable аварійно завершує роботу під час запуску через дефектну реалізацію OpenCL.
--configdir <config directory>- Define the directory where darktable stores user-specific configuration. The default paths are listed on the configuration directory page.
--library <library file>- darktable keeps image information in an sqlite database for fast access. The default location of that database file is file name
library.dbin the directory specified by--configdiror the default configuration directory. Use this option to provide an alternative location (e.g. if you want to do some experiments without compromising your originallibrary.db). If the database file does not exist, darktable creates it for you. You may also provide:memory:as the library file, in which case the database is kept in system memory – all changes are discarded when darktable terminates. -
При кожному запуску Darktable він блокує бібліотеку для поточного користувача. Це робиться шляхом запису поточного ідентифікатора процесу (PID) у файл блокування
<бібліотечний файл> .lockпоруч із зазначеною бібліотекою. Якщо Darktable знайде наявний файл блокування для бібліотеки, він припинить роботу. --datadir <каталог даних>- Визначити каталог, де Darktable знаходить свої дані часу виконання. Розташування за замовчуванням залежить від вашого встановлення. Типовими місцями є
/opt/darktable/share/darktable/та/usr/share/darktable/. --moduledir <каталог модулів>- Darktable має модульну структуру і організовує свої модулі як спільні бібліотеки для завантаження під час виконання. Цей параметр повідомляє Darktable, де шукати спільні бібліотеки. Розташування за замовчуванням залежить від вашого встановлення. Типовими місцями є
/opt/darktable/lib64/darktable/та/usr/lib64/darktable/. --tmpdir <каталог тимчасових файлів>- Визначає, де Darktable слід зберігати свої тимчасові файли. Якщо ця опція відсутня, Darktable використовує значення за замовчуванням операційної системи.
--cachedir <каталог кешу>- Darktable зберігає кеш мініатюр зображень для швидкого попереднього перегляду зображення та попередньо скомпільовані двійкові файли OpenCL для швидкого запуску. За замовчуванням кеш знаходиться в
$HOME/.cache/darktable/. Кілька кешів мініатюр можуть існувати паралельно – по одному для кожного файлу бібліотеки. --localedir <каталог локалей>- Визначає, де Darktable може знайти свої текстові рядки, специфічні для мови. Розташування за замовчуванням залежить від вашого встановлення. Типовими місцями є
/opt/darktable/share/locale/та/usr/share/locale/. --luacmd <команда Lua>- Рядок, що містить команди Lua для виконання після ініціалізації Lua. Ці команди будуть запущені після вашого файлу “luarc”.
- Якщо підтримку Lua не вкомпільовано, ця опція буде прийнята, але нічого не зробить.
--noiseprofiles <файл JSON профілів шуму>- Надає файл JSON, який містить специфічні для камери профілі шуму. Розташування за замовчуванням залежить від вашого встановлення. Типовими місцями є
/opt/darktable/share/darktable/noiseprofile.jsonта/usr/share/darktable/noiseprofile.json. --conf <key>=<value>- darktable supports a rich set of configuration parameters defined by the user in file
darktablerc, located in the directory specified by--configdiror the default configuration directory. You may temporarily overwrite individual settings on the command line with this option – these settings will not be stored indarktablercon exit. -t <кількість потоків OpenMP>- Обмежити кількість потоків OpenMP для використання в паралельних секціях OpenMP.
--dump-pfm MODULE_A,MODULE_B,--dump-pipe MODULE_A,MODULE_B,--dumpdir DIR- Ці опції надаються для налагодження внутрішнього конвеєра обробки Darktable. Наприклад, якщо викликати
--dump-pfm demosaic, Darktable створить дамп вхідних і вихідних даних модуля demosaic у вигляді файлів формату PFM. За замовчуванням розташування цих файлів визначається операційною системою – це якась тимчасова папка, яка повідомляється у виводі – але ви також можете явно визначити це за допомогою параметра--dumpdir.