Automatisation avec Lua on darktable 5.6 user manual

Impression d'images étiquetées

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

Le premier exemple nous a montré les bases mêmes de Lua et nous a permis de vérifier que tout fonctionnait correctement. Faisons maintenant quelque chose d’un peu plus complexe. Essayons d’imprimer la liste des images auxquelles est attachée l’étiquette “rouge”. Mais avant tout, qu’est-ce qu’une image ?

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

L’exécution du code ci-dessus produit beaucoup de données. Nous l’examinerons dans un instant, mais regardons d’abord le code lui-même.

Exporter des images avec Lua

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

Jusqu’à présent, nous avons appris à utiliser Lua pour adapter darktable à notre flux de travail particulier. Voyons maintenant comment utiliser Lua pour exporter facilement des images vers un service en ligne. Si vous êtes capable de téléverser une image vers un service via la ligne de commande, vous pouvez utiliser Lua pour intégrer cela dans l’interface utilisateur de darktable.

Dans l’exemple suivant, nous utilisons Lua pour exporter via scp. Un nouveau type de stockage apparaît dans l’interface utilisateur de darktable qui exporte les images vers une cible distante via le mécanisme de copie de ssh.

Appeler Lua de dbus

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

Il est possible d’envoyer une commande Lua à darktable via son interface DBus. La méthode org.darktable.service.Remote.Lua prend une seule chaîne de paramètre qui est interprétée comme une commande Lua. La commande est exécutée dans le contexte Lua en cours et doit retourner un nul ou une chaîne de caractères. Le résultat est retourné comme résultat de la méthode DBus.

Si l’appel Lua aboutit à une erreur, l’appel de la méthode DBus renvoie une erreur org.darktable.Error.LuaError avec le message d’erreur Lua attaché à l’erreur DBus.

Utiliser darktable depuis un script Lua

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

Attention : Cette fonctionnalité est très expérimentale. Il est connu que plusieurs éléments ne fonctionnent pas encore en mode bibliothèque. Des tests prudents sont hautement recommandés.

L’interface Lua vous permet d’utiliser darktable à partir de n’importe quel script Lua. Cela charge darktable en tant que bibliothèque et vous fournit une grande part de l’API Lua (comme darktable est configuré sans interface utilisateur les fonctions correspondantes ne sont pas disponibles).

Par exemple, le programme suivant écrit la liste de toutes les images dans votre bibliothèque.

API Lua

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

L’API Lua de darktable est documentée avec son propre manuel comprenant une description détaillée de toutes les structures de données et fonctions. Vous pouvez télécharger le manuel de l’API ici.