darktable user manual

Основні принципи

Table of Contents

Сценарії можуть реєструвати зворотні виклики для виконання дій при настанні різних подій. Цей механізм зворотного виклику є основним методом активації дій Lua.

Центральним оркестратором для Lua-сценаріїв є менеджер сценаріїв, який запускає сервісний модуль Сценарії у режимі Світлового столу та завантажує сценарії, що входять до комплекту Darktable.

Сценарії Lua можна вимкнути в Налаштування > Опції Lua.

#Як Darktable завантажує сценарії (і менеджер сценаріїв)

Darktable по-різному обробляє два типи розташувань: файли, які виконуються як код Lua, та каталоги, які скануються на наявність сценаріїв:

  • Файли luarc, що виконуються під час запуску:

    • $DARKTABLE/share/darktable/luarc: запускається самим Darktable. Це точка входу, яка запускає менеджер сценаріїв. Вона служить лише для внутрішніх цілей і не повинна редагуватися. $DARKTABLE тут — це каталог встановлення програми.

    • [каталог-конфігурації]/luarc: якщо присутній – це один із способів виклику власних сценаріїв (див. нижче).

  • Скануються на наявність сценаріїв .lua (які потім відображаються в модулі сценаріїв):

    • $DARKTABLE/share/darktable/lua-scripts/: сценарії, що входять до комплекту Darktable.

    • [каталог-конфігурації]/lua/[папка]: ваші власні сценарії (див. нижче).

Каталог конфігурації залежить від вашої ОС.

Таким чином, ви можете додати власні сценарії в наступний спосіб:

  • Доручіть модулю сценаріїв їх завантажувати (рекомендовано):
    • Розмістіть ваш сценарій, наприклад, у [каталог-конфігурації]/lua/user/myscript.lua
    • Активуйте його в модулі сценаріїв, вибравши відповідну папку (у цьому прикладі “user”) та натиснувши кнопку ввімкнення/вимкнення поруч із відповідним сценарієм.
    • Примітка: Щоб модуль сценаріїв завантажував сценарії, вони повинні бути в підпапці [каталог-конфігурації]/lua.
  • Використовуйте luarc (автоматично запускається під час запуску)
    • Або напишіть код безпосередньо в [каталог-конфігурації]/luarc. Це працює, але непрактично для чогось, що перевищує кілька рядків.
    • Або збережіть код в окремому файлі та використовуйте require через luarc: Наприклад, сценарій, що міститься в [каталог-конфігурації]/lua/userscript.lua, можна завантажити, додавши require "userscript" (зверніть увагу, що .lua тут пропущено).

#Примітка щодо встановлень Lua-сценаріїв з попередніх версій Darktable

To remain compatible with scripts installed before darktable 5.6, require looks for a script manager in your configuration directory before loading the bundled one: if [configuration-directory]/lua/tools/script_manager.lua is present (for example from a manual pre-5.6 installation), that script manager is run instead of the bundled one.

Translations