Appel du programme on darktable 5.6 user manual

invocation per OS

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

darktable et les autres binaires (par exemple darktable-cltest) peuvent être exécutés depuis la console comme suit :

Linux

Installé sous forme de package ou de snap : darktable
Flatpak : flatpak run org.darktable.Darktable
- Pour exécuter par exemple darktable-cltest : flatpak run --command=darktable-cltest org.darktable.Darktable --arguments-ici.
AppImage : accédez au dossier contenant, puis à ./darktable.Appimage (ou quel que soit le nom que vous avez donné au fichier)
- Pour exécuter par exemple darktable-cltest: ./darktable.Appimage darktable-cltest
- Une option supplémentaire pour exécuter les différents binaires inclus dans darktable (par exemple darktable-cltest ou darktable-cli) se fait via un lien symbolique :
  - Créez un lien symbolique vers votre AppImage et appelez-le par exemple darktable-cli.
  - Ensuite, lors de l’appel de l’AppImage via le lien symbolique avec ./darktable-cli, le code à l’intérieur du package vérifie s’il existe un fichier binaire à l’intérieur de l’AppImage avec un nom qui correspond au nom du lien symbolique. Si tel est le cas, il sera exécuté à la place de celui par défaut.

Windows

darktable-cli

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

L’exécutable darktable-cli lance la variante en ligne de commande de l’interface de darktable qui permet l’exportation d’images.

Cette variante n’ouvre aucun affichage – elle travaille en mode console pur sans lancer d’interface graphique. Ce mode est particulièrement utile pour les serveurs exécutant des tâches en arrière-plan.

darktable-cli peut être appelé avec les paramètres suivants de la ligne de commande :

darktable-cli [<input file or folder>]
              [<xmp file>]
              <output file or folder>
              [--width <max width>]
              [--height <max height>]
              [--hq <0|1|true|false>]
              [--upscale <0|1|true|false>]
              [--style <style name>]
              [--style-overwrite]
              [--apply-custom-presets <0|1|false|true>]
              [--out-ext <extension>]
              [--import <file or dir>]
              [--library <path>]
              [--icc-type <type>]
              [--icc-file <file>]
              [--icc-intent <intent>]
              [--verbose]
              [--help [option]]
              [--core <darktable options>]

L’utilisateur doit fournir un nom de fichier d’entrée et un nom de fichier de sortie. Tous les autres paramètres sont optionnels.

darktable-generate-cache

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

L’exécutable darktable-generate-cache met à jour le cache des miniatures. Vous pouvez lancer ce programme, en arrière-plan quand votre ordinateur est inactif, pour générer toutes les miniatures manquantes .

darktable-generate-cache est appelé avec les paramètres suivants de la ligne de commande :

darktable-generate-cache
              [-h, --help]
              [--version]
              [--min-mip <0-8>] [-m, --max-mip <0-8>]
              [--min-imgid <N>] [--max-imgid <N>]
              [--core <darktable options>]

Tous les paramètres sont optionnels. S’il est démarré sans paramètre darktable-generate-cache utilise des valeurs par défaut raisonnables.

darktable-chart

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

Cet exécutable est un utilitaire dédié à la création de styles à partir de paires d’images telles que RAW+JPEG fournies par le boîtier. Des détails de son utilisation peuvent être trouvés dans la section Utiliser darktable-chart

darktable-chart soit démarre une interface graphique soit est utilisé comme programme en ligne de commande.

darktable-chart
              [--help]
              [<input Lab pfm file>]
              [<cht file>]
              [<reference cgats/it8 or Lab pfm file>]

Tous les paramètres sont optionnels, cependant, si vous voulez fournir le deuxième nom de fichier vous devez aussi fournir le premier. Démarrer darktable-chart de cette manière ouvre une interface graphique spéciale (des détails peuvent être trouvés dans la section Utiliser darktable-chart).

darktable-cltest

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

L’exécutable darktable-cltest vérifie s’il y a sur votre système un environnement OpenCL utilisable par darktable. Il émet une sortie de débogage équivalente à celle qu’on obtient par l’appel darktable -d opencl et puis s’arrête.

darktable-cltest est appelé sans paramètre sur la ligne de commande.

darktable-cmstest

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

L’exécutable darktable-cmstest (sous Linux uniquement) détermine si le sous-système de votre ordinateur gérant la couleur est correctement configuré et affiche des informations utiles sur le(s) profil(s)-moniteur installé(s) .

darktable-cmstest est appelé sans paramètre sur la ligne de commande.

purge_non_existing_images.sh

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

Recherche et supprime des entrées de la base de données de la bibliothèque référençant des images qui n’existent plus dans le système de fichiers. Vous devez fermer darktable avant d’exécuter ce script.

Le script peut être appelé avec les paramètres suivants de la ligne de commande :

purge_non_existing_images.sh [-c|--configdir <path>]
                             [-l|--library <path>]
                             [-p|--purge]

Exécutez le script sans aucune option pour effectuer un galop d’essai, qui génère un rapport des fichiers manquants sans engager de modifications dans la base de données.