Skrypty Lua on darktable user manual

drukowanie oznakowanych zdjęć

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

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?

local darktable = require "darktable"
local debug = require "darktable.debug"
print(darktable.debug.dump(darktable.database[1]))

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

Poznaliśmy require darktable. Nadszedł czas na require darktable.debug, będące opcjonalną sekcją API, dostarczającą funkcji pomocniczych do debugowania skryptów lua.

eksport zdjęć przy użyciu lua

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

Do tej pory nauczyliśmy się używać lua do adaptacji darktable 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 darktable.

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

wywołanie lua z dbus

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

Możliwe jest wysłanie komendy lua do darktable poprzez interfejs DBus. Metoda org.darktable.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.

Jeśli wywołanie Lua zakończy się błędem, metoda DBus zwróci błąd org.darktable.Error.LuaError z komunikatem błędu lua jako wiadomością, dołączoną do błędu DBus.

użycie darktable ze skryptu lua

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

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 darktable z dowolnego skryptu lua. Spowoduje to załadowanie darktable jako biblioteki i udostępnienie większości API lua (darktable 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:

#!/usr/bin/env lua
package = require "package"
package.cpath=package.cpath..";./lib/darktable/lib?.so"

dt = require("darktable")(
"--library", "./library.db",
"--datadir", "./share/darktable",
"--moduledir", "./lib/darktable",
"--configdir", "./configdir",
"--cachedir","cachedir",
"--g-fatal-warnings")

require("darktable.debug")

for k,v in ipairs(dt.database) do
   print(tostring(v))
end

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

API lua

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

API Lua w darktable jest udokumentowane w oddzielnej instrukcji, wraz ze szczegółowym opisem wszystkich struktur danych oraz funkcji. Instrukcję do API możesz pobrać stąd.