darktable user manual

Un exemple Lua simple

Commençons par un exemple simple qui affichera du code sur la console. Créez un fichier appelé luarc dans le Répertoire de configuration de Darktable et ajoutez-y la ligne suivante :

print("Hello World !")

Lancez Darktable dans un terminal et vous verrez la phrase “Hello World !” s’afficher dans le terminal. Rien d’extraordinaire, mais c’est un début.

À ce stade, il n’y a rien de spécifique à Darktable dans le script. Nous utilisons simplement la fonction d’affichage standard de Lua, permettant d’afficher une chaîne de caractères. C’est bien beau, mais nous pouvons faire mieux. Ainsi pour accéder à l’API Darktable, vous devez d’abord la demander require et enregistrer le résultat dans une variable. Depuis cette variable, vous pouvez accéder à toute l’API Darktable en appelant des sous-champs. Tout est documenté dans le manuel de l’API Lua

local darktable = require "darktable"
darktable.print_error("Hello World !")

Exécutez le script et… rien de ne s’affiche ! La fonction darktable.print_error est comme le print classique mais affiche le message uniquement si vous avez activé les traces Lua en lançant Darktable avec la commande darktable -d lua. C’est la méthode recommandée pour afficher des traces dans un script Lua de Darktable.

Translations