Виклик програми on darktable 5.6 user manual

Виклик для кожної ОС

Mon, 01 Jan 0001 00:00:00 +0000

darktable та інші виконувані файли (наприклад, darktable-cltest) можна запустити з консолі наступним чином:

Linux

Встановлено як пакет або snap: darktable
Flatpak: flatpak run org.darktable.Darktable
- Щоб запустити, наприклад, darktable-cltest: flatpak run --command=darktable-cltest org.darktable.Darktable --arguments-go-here.
AppImage: Перейдіть до папки, яка містить файл AppImage, потім ./darktable.Appimage (або як ви назвали цей файл)
- Щоб запустити, наприклад, darktable-cltest: ./darktable.Appimage darktable-cltest
- Додаткова опція для запуску різних бінарних файлів, що входять до Darktable (наприклад, darktable-cltest або darktable-cli), – це символічне посилання:
  - Створіть символічне посилання на ваш AppImage та назвіть його, наприклад, darktable-cli.
  - Потім, під час виклику AppImage через символічне посилання ./darktable-cli, код всередині пакета перевіряє, чи є всередині AppImage бінарний файл з назвою, що відповідає назві символічного посилання. Якщо так, він буде запущений замість файлу за замовчуванням.

Windows

Darktable

Mon, 01 Jan 0001 00:00:00 +0000

Бінарний файл 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 використовує значення за замовчуванням.

darktable-cli

Mon, 01 Jan 0001 00:00:00 +0000

Виконуваний файл darktable-cli запускає варіант Darktable з інтерфейсом командного рядка, який дозволяє експортувати зображення.

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

darktable-cli можна викликати з такими параметрами командного рядка:

darktable-cli [<вхідний файл чи папка>]
              [<файл XMP>]
              <вихідний файл чи папка>
              [--width <макс. ширина>]
              [--height <макс. висота>]
              [--hq <0|1|true|false>]
              [--upscale <0|1|true|false>]
              [--style <ім'я стилю>]
              [--style-overwrite]
              [--apply-custom-presets <0|1|false|true>]
              [--out-ext <розширення>]
              [--import <файл чи папка>]
              [--library <шлях>]
              [--icc-type <тип>]
              [--icc-file <файл>]
              [--icc-intent <метод>]
              [--verbose]
              [--help [опція]]
              [--core <опції Darktable>]

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

darktable-generate-cache

Mon, 01 Jan 0001 00:00:00 +0000

Двійковий файл darktable-generate-cache оновлює кеш мініатюр Darktable. Запустіть цю програму, щоб генерувати всі відсутні мініатюри у фоновому режимі, коли комп’ютер не працює.

darktable-generate-cache можна викликати з такими параметрами командного рядка:

darktable-generate-cache
              [-h, --help]
              [--version]
              [--min-mip <0-8>] [-m, --max-mip <0-8>]
              [--min-imgid <N>] [--max-imgid <N>]
              [--core <опції Darktable>]

Усі параметри необов’язкові. Якщо запустити без параметрів, darktable-generate-cache використовує розумні значення за замовчуванням.

-h, --help: Відобразити інформацію про використання та завершитись.
--version: Відобразити інформацію про авторські права та версію та завершитись.
--min-mip <0-8>, -m, --max-mip <0-8>: Darktable може зберігати мініатюри до восьми різних кроків роздільної здатності для кожного зображення. Ці параметри визначають максимальну роздільну здатність, яку потрібно генерувати (за замовчуванням діапазон 0-2). Як правило, тут не потрібно генерувати всі можливі роздільні здатності – Darktable автоматично генерує їх в той момент, коли вони потрібні, але відсутні. На запит згенерувати кілька роздільних здатностей одночасно зображення нижчої роздільної здатності швидко генеруються шляхом зменшення роздільної здатності зображення з найвищою роздільною здатністю.
--min-imgid <N>, --max-imgid <N>: Визначає діапазон внутрішніх ідентифікаторів зображень із бази даних, над якими слід працювати. Якщо діапазон не вказаний, darktable-generate-cache обробляє всі зображення.
--core <опції Darktable>: Усі параметри командного рядка після --core передаються ядру Darktable і обробляються як стандартні параметри. Детальний опис див. у розділі бінарний файл darktable.

darktable-chart

Mon, 01 Jan 0001 00:00:00 +0000

Бінарний файл darktable-chart – це спеціальна утиліта для створення стилів з пар зображень, таких як RAW+JPEG з обробкою в камері. Детально про його використання можна дізнатись у розділі використання darktable-chart.

darktable-chart може або запускати графічний інтерфейс або використовуватись як програма командного рядка.

darktable-chart
              [--help]
              [<вхідний файл Lab pfm>]
              [<файл cht>]
              [<контрольний файл cgats/it8 або Lab pfm>]

Усі параметри необов’язкові, однак, якщо ви хочете вказати друге ім’я файлу, вам також потрібно вказати перше. Запуск darktable-chart в такий спосіб відкриває спеціальний графічний інтерфейс (подробиці можна знайти в розділі використання darktable-chart).

darktable-cltest

Mon, 01 Jan 0001 00:00:00 +0000

Бінарний файл darktable-cltest перевіряє, чи є у вашій системі придатне середовище OpenCL, яке Darktable може використовувати. Він видає деякі результати налагодження, еквівалентні виклику darktable -d opencl, а потім завершує роботу.

darktable-cltest викликається без параметрів командного рядка.

darktable-cmstest

Mon, 01 Jan 0001 00:00:00 +0000

Бінарний файл darktable-cmstest (лише для Linux) досліджує, чи правильно налаштована підсистема керування кольором вашого комп’ютера, та відображає деяку корисну інформацію про встановлені профілі монітора.

darktable-cmstest викликається без параметрів командного рядка.

purge_non_existing_images.sh

Mon, 01 Jan 0001 00:00:00 +0000

Знаходить і видаляє записи з бази даних бібліотеки, що посилаються на зображення, яких більше немає у файловій системі. Перед запуском потрібно закрити Darktable.

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

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

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

Доступні такі опції:

-c|--configdir <шлях>: Вказує шлях до каталогу конфігурації Darktable, який буде використовуватися сценарієм. Якщо ця опція не надається, буде використано розташування каталогу конфігурації за замовчуванням.
-l|--library <шлях>: Вказує шлях до файлу бази даних library.db для аналізу. Якщо цю опцію не вказано, буде використовуватися розташування файлу library.db за замовчуванням.
-p|--purge: Фактично видаляє будь-які записи в базі даних, які посилаються на неіснуючі файли. Якщо ця опція не надана, звіт буде надруковано без внесення змін до бази даних.

Примітки:

Інтеграція GIMP

Mon, 01 Jan 0001 00:00:00 +0000

GIMP може використовувати Darktable для відкриття файлу raw, якщо виконуваний файл Darktable знаходиться в PATH. Якщо користувач GIMP відкриває файл raw, то GIMP викликає Darktable з деякими спеціальними параметрами командного рядка, щоб отримати тимчасовий файл для роботи GIMP, наступним чином:

darktable --gimp [version]
                 [file <path>]
                 [thumb <path> <dim>]

У всіх випадках Darktable повідомлятиме про свій результат до GIMP, обгорнувши його тегами на кшталт цього (де <результат> залежить від заданої команди):

<<<gimp
<результат>
gimp>>>

У командному рядку повинна бути присутня лише одна з команд.