<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
  <channel>
    <title>Automatisation avec Lua on darktable 5.8 user manual</title>
    <link>https://docs.darktable.org/usermanual/5.8/fr/lua/</link>
    <description>Recent content in Automatisation avec Lua on darktable 5.8 user manual</description>
    <generator>Hugo</generator>
    <language>fr</language>
    <atom:link href="https://docs.darktable.org/usermanual/5.8/fr/lua/index.xml" rel="self" type="application/rss+xml" />
    <item>
      <title>Présentation</title>
      <link>https://docs.darktable.org/usermanual/5.8/fr/lua/overview/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      <guid>https://docs.darktable.org/usermanual/5.8/fr/lua/overview/</guid>
      <description>&lt;p&gt;Les scripts Lua peuvent être utilisés pour définir les actions à exécuter par Darktable lorsqu&amp;rsquo;un événement est déclenché. Un exemple pourrait être d&amp;rsquo;appeler une application externe lors de l&amp;rsquo;exportation de fichiers afin d&amp;rsquo;appliquer des étapes de traitement supplémentaires en dehors de Darktable.&lt;/p&gt;&#xA;&lt;p&gt;&lt;a href=&#34;http://www.lua.org/&#34; target=&#34;_blank&#34;&gt;Lua&lt;/a&gt; est un projet indépendant fondé en 1993, fournissant un langage de script puissant, rapide, léger et intégrable. Lua est largement utilisé par de nombreuses applications open source, dans des programmes commerciaux et pour la programmation de jeux. Darktable utilise Lua version 5.4. Décrire les principes et la syntaxe de Lua dépasse le cadre de ce manuel. Pour une introduction détaillée, voir le &lt;a href=&#34;http://www.lua.org/manual/5.4/manual.html&#34; target=&#34;_blank&#34;&gt;manuel de référence Lua&lt;/a&gt;.&lt;/p&gt;</description>
    </item>
    <item>
      <title>Scripts de Darktable</title>
      <link>https://docs.darktable.org/usermanual/5.8/fr/lua/darktables-scripts/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      <guid>https://docs.darktable.org/usermanual/5.8/fr/lua/darktables-scripts/</guid>
      <description>&lt;h2 id=&#34;à-partir-de-56&#34;&gt;&lt;a class=&#34;dt-anchor&#34; href=&#34;#%c3%a0-partir-de-56&#34; aria-label=&#34;Link to this section&#34;&gt;#&lt;/a&gt;À partir de 5.6&lt;/h2&gt;&#xA;&lt;p&gt;Darktable inclut un recueil de scripts. Ils peuvent être désactivés dans &lt;a href=&#34;https://docs.darktable.org/usermanual/5.8/fr/preferences-settings/lua-options/&#34;&gt;Préférences &amp;gt; Options Lua&lt;/a&gt;.&lt;/p&gt;&#xA;&lt;p&gt;À partir de Darktable 5.6, les scripts Lua sont inclus avec la version, ils n&amp;rsquo;ont donc plus besoin d&amp;rsquo;être installés séparément.&lt;/p&gt;&#xA;&lt;p&gt;Voir &lt;a href=&#34;https://docs.darktable.org/usermanual/5.8/fr/lua/basic-principles/&#34;&gt;principes de base&lt;/a&gt; pour une explication de la façon dont Darktable charge les scripts Lua.&lt;/p&gt;&#xA;&lt;p&gt;La documentation pour les scripts de Darktable est disponible dans la &lt;a href=&#34;https://docs.darktable.org/lua/stable/lua.scripts.manual/scripts/&#34; target=&#34;_blank&#34;&gt;Documentation Lua&lt;/a&gt;.&lt;/p&gt;</description>
    </item>
    <item>
      <title>Principes de base</title>
      <link>https://docs.darktable.org/usermanual/5.8/fr/lua/basic-principles/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      <guid>https://docs.darktable.org/usermanual/5.8/fr/lua/basic-principles/</guid>
      <description>&lt;p&gt;Les scripts peuvent enregistrer des callbacks pour effectuer des actions sur divers événements de Darktable. Ce mécanisme de callback est la principale méthode de déclenchement des actions Lua.&lt;/p&gt;&#xA;&lt;p&gt;L&amp;rsquo;orchestrateur central des scripts Lua est le &lt;em&gt;gestionnaire de scripts&lt;/em&gt;, qui génère le module utilitaire &lt;strong&gt;scripts&lt;/strong&gt; dans la table lumineuse et charge les scripts groupés de Darktable.&lt;/p&gt;&#xA;&lt;p&gt;Les scripts Lua peuvent être désactivés dans &lt;a href=&#34;https://docs.darktable.org/usermanual/5.8/fr/preferences-settings/lua-options/&#34;&gt;Préférences/Options Lua&lt;/a&gt;.&lt;/p&gt;&#xA;&lt;h3 id=&#34;comment-darktable-charge-les-scripts-et-le-gestionnaire-de-scripts&#34;&gt;&lt;a class=&#34;dt-anchor&#34; href=&#34;#comment-darktable-charge-les-scripts-et-le-gestionnaire-de-scripts&#34; aria-label=&#34;Link to this section&#34;&gt;#&lt;/a&gt;Comment Darktable charge les scripts (et le gestionnaire de scripts)&lt;/h3&gt;&#xA;&lt;p&gt;Darktable traite différemment deux types d&amp;rsquo;emplacements : les fichiers qui sont &lt;em&gt;exécutés&lt;/em&gt; en tant que code Lua et les répertoires qui sont &lt;em&gt;scannés&lt;/em&gt; pour des scripts :&lt;/p&gt;</description>
    </item>
    <item>
      <title>Un exemple Lua simple</title>
      <link>https://docs.darktable.org/usermanual/5.8/fr/lua/a-simple-example/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      <guid>https://docs.darktable.org/usermanual/5.8/fr/lua/a-simple-example/</guid>
      <description>&lt;p&gt;Commençons par un exemple simple qui affichera du code sur la console. Créez un fichier appelé &lt;code&gt;luarc&lt;/code&gt; dans le &lt;a href=&#34;https://docs.darktable.org/usermanual/5.8/fr/preferences-settings/config-directory/&#34;&gt;Répertoire de configuration&lt;/a&gt; de Darktable et ajoutez-y la ligne suivante :&lt;/p&gt;&#xA;&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;print(&amp;#34;Hello World !&amp;#34;)&#xA;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;Lancez Darktable dans un terminal et vous verrez la phrase &amp;ldquo;&lt;code&gt;Hello World !&lt;/code&gt;&amp;rdquo; s&amp;rsquo;afficher dans le terminal. Rien d&amp;rsquo;extraordinaire, mais c&amp;rsquo;est un début.&lt;/p&gt;&#xA;&lt;p&gt;À ce stade, il n&amp;rsquo;y a rien de spécifique à Darktable dans le script. Nous utilisons simplement la fonction d&amp;rsquo;affichage standard de Lua, permettant d&amp;rsquo;afficher une chaîne de caractères. C&amp;rsquo;est bien beau, mais nous pouvons faire mieux. Ainsi pour accéder à l&amp;rsquo;API Darktable, vous devez d&amp;rsquo;abord la demander &lt;code&gt;require&lt;/code&gt; et enregistrer le résultat dans une variable. Depuis cette variable, vous pouvez accéder à toute l&amp;rsquo;API Darktable en appelant des sous-champs. Tout est documenté dans le manuel de l&amp;rsquo;&lt;a href=&#34;https://docs.darktable.org/usermanual/5.8/fr/lua/api/&#34;&gt;API Lua&lt;/a&gt;&lt;/p&gt;</description>
    </item>
    <item>
      <title>Impression d&#39;images étiquetées</title>
      <link>https://docs.darktable.org/usermanual/5.8/fr/lua/printing-labeled-images/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      <guid>https://docs.darktable.org/usermanual/5.8/fr/lua/printing-labeled-images/</guid>
      <description>&lt;p&gt;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&amp;rsquo;un peu plus complexe. Essayons d&amp;rsquo;imprimer la liste des images auxquelles est attachée l&amp;rsquo;étiquette &amp;ldquo;rouge&amp;rdquo;. Mais avant tout, qu&amp;rsquo;est-ce qu&amp;rsquo;une image ?&lt;/p&gt;&#xA;&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;local darktable = require &amp;#34;darktable&amp;#34;&#xA;local debug = require &amp;#34;darktable.debug&amp;#34;&#xA;print(darktable.debug.dump(darktable.database[1]))&#xA;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;L&amp;rsquo;exécution du code ci-dessus produit beaucoup de données. Nous l&amp;rsquo;examinerons dans un instant, mais regardons d&amp;rsquo;abord le code lui-même.&lt;/p&gt;</description>
    </item>
    <item>
      <title>Ajouter un raccourci simple</title>
      <link>https://docs.darktable.org/usermanual/5.8/fr/lua/simple-shortcut/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      <guid>https://docs.darktable.org/usermanual/5.8/fr/lua/simple-shortcut/</guid>
      <description>&lt;p&gt;Jusqu&amp;rsquo;à présent, tous nos scripts ont fait des choses au démarrage. Ceci est d&amp;rsquo;une utilité limitée et ne nous permet pas d&amp;rsquo;interagir avec l&amp;rsquo;utilisateur. Pour faire des choses plus avancées, nous devons enregistrer une fonction qui est appelée sur un événement donné. L&amp;rsquo;événement le plus courant auquel réagir est un raccourci clavier.&lt;/p&gt;&#xA;&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;darktable = require &amp;#34;darktable&amp;#34;&#xA;&#xA;local function hello_shortcut(event, shortcut)&#xA;darktable.print(&amp;#34;Hello, I just received &amp;#39;&amp;#34;..event..&#xA;       &amp;#34;&amp;#39; with parameter &amp;#39;&amp;#34;..shortcut..&amp;#34;&amp;#39;&amp;#34;)&#xA;end&#xA;&#xA;darktable.register_event(&amp;#34;hello shortcut&amp;#34;,&#xA;       &amp;#34;shortcut&amp;#34;,hello_shortcut,&#xA;       &amp;#34;A shortcut that prints its parameters&amp;#34;)&#xA;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;Maintenant, démarrez Darktable, allez dans Préférences &amp;gt; Raccourcis &amp;gt; Scripts Lua &amp;gt; A shortcut that prints its parameters » (Un raccourci qui imprime ses paramètres), attribuez un raccourci et essayez-le. Vous devriez voir un joli message imprimé à l&amp;rsquo;écran.&lt;/p&gt;</description>
    </item>
    <item>
      <title>Exporter des images avec Lua</title>
      <link>https://docs.darktable.org/usermanual/5.8/fr/lua/exporting-images/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      <guid>https://docs.darktable.org/usermanual/5.8/fr/lua/exporting-images/</guid>
      <description>&lt;p&gt;Jusqu&amp;rsquo;à 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&amp;rsquo;interface utilisateur de Darktable.&lt;/p&gt;&#xA;&lt;p&gt;Dans l&amp;rsquo;exemple suivant, nous utilisons Lua pour exporter via &lt;code&gt;scp&lt;/code&gt;. Un nouveau type de stockage apparaît dans l&amp;rsquo;interface utilisateur de Darktable qui exporte les images vers une cible distante via le mécanisme de copie de &lt;code&gt;ssh&lt;/code&gt;.&lt;/p&gt;</description>
    </item>
    <item>
      <title>Constructions d&#39;éléments de l&#39;interface utilisateur</title>
      <link>https://docs.darktable.org/usermanual/5.8/fr/lua/building-ui-elements/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      <guid>https://docs.darktable.org/usermanual/5.8/fr/lua/building-ui-elements/</guid>
      <description>&lt;p&gt;Notre exemple précédent était un peu limité. En particulier, l&amp;rsquo;utilisation d&amp;rsquo;une préférence pour le chemin d&amp;rsquo;exportation n&amp;rsquo;est pas très élégante. Nous pouvons faire mieux en ajoutant des éléments à l&amp;rsquo;interface utilisateur dans la boîte de dialogue d&amp;rsquo;exportation.&lt;/p&gt;&#xA;&lt;p&gt;Les éléments de l&amp;rsquo;interface utilisateur sont créés via la fonction &lt;code&gt;darktable.new_widget&lt;/code&gt;. Cette fonction prend un paramètre type de widget et renvoie un nouvel objet pour ce widget. Vous pouvez ensuite définir divers champs dans ce widget pour définir ses paramètres. Vous utilisez ensuite cet objet comme paramètre de fonctions qui l&amp;rsquo;ajoutent à l&amp;rsquo;interface utilisateur de Darktable. L&amp;rsquo;exemple simple suivant ajoute un module dans la vue Table lumineuse avec une étiquette simple :&lt;/p&gt;</description>
    </item>
    <item>
      <title>Partage de scripts</title>
      <link>https://docs.darktable.org/usermanual/5.8/fr/lua/sharing-scripts/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      <guid>https://docs.darktable.org/usermanual/5.8/fr/lua/sharing-scripts/</guid>
      <description>&lt;p&gt;Jusqu&amp;rsquo;à présent, tout notre code Lua était dans &lt;em&gt;luarc&lt;/em&gt;. C&amp;rsquo;est un bon moyen de développer votre script mais pas très pratique pour la distribution. Nous devons en faire un module Lua dédié. Pour ce faire, nous sauvegardons le code dans un fichier séparé (ici &lt;code&gt;scp-storage.lua&lt;/code&gt;) :&lt;/p&gt;&#xA;&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;--[[&#xA;SCP STORAGE&#xA;un stockage simple pour exporter des images via scp&#xA;&#xA;AUTHOR&#xA;Jérémy Rosen (jeremy.rosen@enst-bretagne.fr)&#xA;&#xA;INSTALLATION&#xA;* copier ce fichier dans $CONFIGDIR/lua/&#xA;* ajouter la ligne suivante dans $CONFIGDIR/luarc&#xA;  require &amp;#34;scp-storage&amp;#34;&#xA;&#xA;USAGE&#xA;* sélectionner &amp;#34;Export via SCP&amp;#34; dans le menu de sélection du stockage&#xA;* choisir le répertoire cible &#xA;* exporter vos images&#xA;&#xA;LICENSE&#xA;GPLv2&#xA;&#xA;]]&#xA;&#xA;darktable = require &amp;#34;darktable&amp;#34;&#xA;dtutils = require &amp;#34;lib/dtutils&amp;#34;&#xA;&#xA;dtutils.check_min_api_version(&amp;#34;7.0.0&amp;#34;, ...)&#xA;&#xA;local scp_path = darktable.new_widget(&amp;#34;entry&amp;#34;){&#xA;  tooltip = &amp;#34;Chemin complet vers lequel copier. Peut inclure l&amp;#39;utilisateur et le nom d&amp;#39;hôte&amp;#34;,&#xA;  text = &amp;#34;&amp;#34;,&#xA;  reset_callback = function(self) self.text = &amp;#34;&amp;#34; end&#xA;}&#xA;&#xA;darktable.register_storage(&amp;#34;scp_export&amp;#34;,&amp;#34;Export via scp&amp;#34;,&#xA;  function( storage, image, format, filename,&#xA;     number, total, high_quality, extra_data)&#xA;    if not darktable.control.execute(&amp;#34;scp &amp;#34;..filename..&amp;#34; &amp;#34;..&#xA;      scp_path.text&#xA;    ) then&#xA;      darktable.print_error(&amp;#34;scp a échoué à cause de &amp;#34;..tostring(image))&#xA;    end&#xA;  end,&#xA;  nil, --finalize&#xA;  nil, --supported&#xA;  nil, --initialize&#xA;  darktable.new_widget(&amp;#34;box&amp;#34;) {&#xA;    orientation = &amp;#34;horizontal&amp;#34;,&#xA;    darktable.new_widget(&amp;#34;label&amp;#34;){ label = &amp;#34;target SCP PATH &amp;#34; },&#xA;    scp_path,&#xA;})&#xA;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;Darktable recherche les scripts *.lua (en suivant les règles Lua normales) dans le répertoire &lt;code&gt;$CONFIGDIR/lua/*.lua&lt;/code&gt;. Ainsi, notre script peut être appelé en ajoutant simplement &lt;code&gt;require &amp;quot;scp-storage&amp;quot;&lt;/code&gt; dans le fichier &lt;em&gt;luarc&lt;/em&gt;. Quelques notes supplémentaires&amp;hellip;&lt;/p&gt;</description>
    </item>
    <item>
      <title>Appeler Lua de dbus</title>
      <link>https://docs.darktable.org/usermanual/5.8/fr/lua/calling-from-dbus/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      <guid>https://docs.darktable.org/usermanual/5.8/fr/lua/calling-from-dbus/</guid>
      <description>&lt;p&gt;Il est possible d&amp;rsquo;envoyer une commande Lua à Darktable via son interface DBus. La méthode &lt;code&gt;org.darktable.service.Remote.Lua&lt;/code&gt; prend une seule chaîne de paramètres 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.&lt;/p&gt;&#xA;&lt;p&gt;Si l&amp;rsquo;appel Lua aboutit à une erreur, l&amp;rsquo;appel de la méthode DBus renvoie une erreur &lt;code&gt;org.darktable.Error.LuaError&lt;/code&gt; avec le message d&amp;rsquo;erreur Lua attaché à l&amp;rsquo;erreur DBus.&lt;/p&gt;</description>
    </item>
    <item>
      <title>Utiliser Darktable depuis un script Lua</title>
      <link>https://docs.darktable.org/usermanual/5.8/fr/lua/darktable-from-lua/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      <guid>https://docs.darktable.org/usermanual/5.8/fr/lua/darktable-from-lua/</guid>
      <description>&lt;p&gt;&lt;em&gt;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.&lt;/em&gt;&lt;/p&gt;&#xA;&lt;p&gt;L&amp;rsquo;interface Lua vous permet d&amp;rsquo;utiliser Darktable à partir de n&amp;rsquo;importe quel script Lua. Cela charge Darktable en tant que bibliothèque et vous fournit une grande part de l&amp;rsquo;API Lua (comme Darktable est configuré sans interface utilisateur les fonctions correspondantes ne sont pas disponibles).&lt;/p&gt;&#xA;&lt;p&gt;Par exemple, le programme suivant écrit la liste de toutes les images dans votre bibliothèque.&lt;/p&gt;</description>
    </item>
    <item>
      <title>API Lua</title>
      <link>https://docs.darktable.org/usermanual/5.8/fr/lua/api/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      <guid>https://docs.darktable.org/usermanual/5.8/fr/lua/api/</guid>
      <description>&lt;p&gt;L&amp;rsquo;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&amp;rsquo;API &lt;a href=&#34;https://www.darktable.org/resources/&#34; target=&#34;_blank&#34;&gt;ici&lt;/a&gt;.&lt;/p&gt;</description>
    </item>
  </channel>
</rss>
