Skripten mit Lua on darktable 5.6 user manual

Markierte Bilder drucken

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

Das erste Beispiel zeigte uns die Grundlagen von Lua und erlaubte uns zu überprüfen, ob alles richtig funktioniert. Lass uns nun etwas Komplizierteres machen. Versuchen wir, eine Liste der Bilder auszudrucken, die mit einem roten Etikett versehen sind. Aber zunächst einmal, was ist ein Bild?

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

Das Ausführen des obigen Codes erzeugt eine Menge Output. Wir werden es uns gleich anschauen, aber zuerst schauen wir uns den Code selbst an.

Bilder mit Lua exportieren

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

Bis jetzt haben wir gelernt Lua dazu zu nutzen, um darktable an unseren Arbeitsablauf anzupassen. Nun möchten wir schauen, wie wir Lua dazu nutzen, um Bilder einfach an einen Online Service zu exportieren. Wenn du Bilder via die Kommandozeile an einen Bilder-Service hochladen kannst, dann kannst Lua dazu nutzen, um das in die Schnittstelle von darktable zu integrieren.

In diesem nächsten Beispiel verwenden wir Lua, um über scp zu exportieren. Ein neuer Speicher erscheint in der Benutzeroberfläche von darktable, welcher Bilder über den Kopiermechanismus von ssh an ein entferntes Ziel exportiert.

Aufruf von Lua vom dbus

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

Es ist möglich einen Lua Befehl an darktable via dessen DBus-Schnittstelle zu senden. Die Methode org.darktable.service.Remote.Lua nimmt einen einzigen String Parameter der als Lua Befehl interpretiert wird. Dieser Befehl wird ausgeführt im gegenwärtigen Lua Kontext und sollte entweder null oder einen String zurückgeben. Das Resultat wird zurückgegeben als Resultat der DBus Methode.

Wenn der Lua Aufruf in einen Fehler resultiert die DBus Methode wird einen Fehler org.darktable.Error.LuaError mit der Lua Fehlermeldung als die Meldung an den DBus Fehler gebunden.

Arbeiten mit darktable von einem Lua Skript

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

Warnung: Diese Möglichkeit ist sehr experimentell. Es ist bekannt, dass mehrere Elemente bis jetzt im Library Modus nicht funktionieren. Ein vorsichtiges Testen ist sehr empfohlen.

Die Lua Schnittstelle erlaubt es dir, darktable von jedem Lua Skript aus zu nutzen. Dadurch wird darktable als Library geladen und das Meiste der Lua API angeboten (darktable ist ohne Titelzeile, so dass die Funktionen, die sich auf die Beutzerschnittstelle beziehen, nicht vorhanden sind)

Als Beispiel, das folgende Programm wird eine Liste aller Bilder in deiner Bibliothek ausdrucken:

Lua API

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

Das Lua API von darktable ist in einem eigenen Handbuch mit einer detaillierten Beschreibung aller Dateistrukturen und Funktionen. Du kannst das API Handbuch herunterladen von hier.