darktable-cli

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>]
              [--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.

<input file or folder>
Le nom du fichier en entrée ou du répertoire (contenant des images) à exporter. Si vous souhaitez développer plusieurs images ou plusieurs répertoires utilisez plutôt l’option --import.
<xmp file>
Nom optionnel d’un fichier lié XMP qui contient les données de l’historique de développement qui sera appliqué lors de l’exportation. Si cette option n’est pas donnée, darktable recherchera un fichier XMP appartenant au(x) fichier(s) d’entrée indiqué(s).
<output file or folder>
The name of the output file or destination folder. The parameter is mandatory if you use the program on an image folder containing multiple images, and it must point to an existing folder. If the specified path does not point to an existing folder, it is interpreted as a filename. If the path is interpreted as a filename, the export file format is derived from the file extension, unless the --out-ext option is present (see below). Note that the file extension is only used to determine the export format, which then enforces the actual output extension (e.g. image.jpeg sets the format to JPEG, which results in the filename image.jpg). You can also use a number of variables in the output filename. If you specify output folder it is recommended that you also specify the file format with --out-ext.
--width <max width>
Ce paramètre permet de limiter la largeur de l’image exportée au nombre de pixels indiqué.
--height <max height>
Ce paramètre permet de limiter la hauteur de l’image exportée au nombre de pixels indiqué.
--hq <0|1|true|false>
Définit s’il faut utiliser un ré-échantillonnage de haute qualité lors de l’exportation (voir le module Exporter sélection pour plus de détails). Vrai par défaut.
--upscale <0|1|true|false>
Indicateur définissant s’il faut utiliser un ré-échantillonnage de haute qualité lors de l’exportation Faux par défaut.
--style <style name>
Spécifiez le nom d’un style à appliquer lors de l’exportation. Si un style est spécifié, le chemin d’accès au répertoire de configuration darktable doit également être spécifié (c’est-à-dire --core --configdir ~/.config/darktable). Par défaut, aucun style n’est spécifié.
--style-overwrite
Le style spécifié remplace l’historique au lieu d’y être ajouté.
--apply-custom-presets <0|1|false|true>
S’il faut charger data.db qui contient des préréglages et des styles. Désactiver cette option vous permet de lancer plusieurs instances de darktable-cli au prix de ne pas pouvoir utiliser l’option --style. La valeur par défaut est vrai.
--out-ext <extension>
Defines the export format to use (e.g. jpeg, tiff, openexr) based on the provided argument string, which can be a common extension (e.g. jpg, tif, exr) or a format (e.g. jpeg, tiff). The name --out-ext is preserved for compatibility with existing scripts, but it is actually used to determine the format, not the file extension; the extension, as always, is determined by the format. If specified, this format takes precedence over the one derived from <output file>. If the output filename already contains an extension, it is removed only if it exactly matches the string passed to --out-ext. Otherwise, it is treated as part of the filename (e.g. output.jpg with --out-ext jpeg results in output.jpg.jpg, because jpg does not match jpeg). Defaults to jpg if <output folder> is specified.
--import <file or dir>
Spécifiez le fichier ou le répertoire d’entrée, peut être utilisé plusieurs fois. Cette option ne peut pas être combinée avec <input file or folder>.
--icc-type <type>
Spécifiez le type de profil ICC, ce qui revient à spécifier le “profil de sortie” dans le module profil de couleur de sortie. La valeur par défaut est “image spécifiée”. Utilisez--help icc-type pour obtenir une liste des types pris en charge. Voir profil de couleur de sortie pour une description plus détaillée des options disponibles.
--icc-file <file>
Spécifiez le nom de fichier du profil ICC. Par défaut, un nom de fichier vide.
--icc-intent <intent>
Spécifiez l’intention de rendu. Utilisez --help icc-intent pour obtenir une liste des modes de rendu pris en charge. Voir intention de rendu pour une description plus détaillée des options disponibles.
--verbose
Activer la sortie verbeuse.
--help [option]
Donne les paramètres d’usage et quitte. Si option est spécifié, donne en plus les paramètres de l’option donnée.
--core <darktable options>
Tous les paramètres de la ligne de commande suivant --core sont passés au noyau de darktable et manipulés comme des paramètres standards. Voir la section Exécutable darktable pour une description détaillée.

🔗Options d’exportation

Les options d’exportation de darktable sont définies en tant qu’éléments de configuration, définis depuis le module Exportation. Comme décrit ci-dessous, il existe deux manières de modifier cette configuration lors de l’utilisation de darktable-cli.

🔗Utiliser le module exportation

La commande darktable-cli utilisera la dernière configuration de format utilisée dans le module exportation, lorsqu’elle est exécutée en mode interactif (gui). Vous pouvez donc définir manuellement les options de format souhaitées dans l’interface graphique de darktable, puis exécuter darktable-cli pour exporter vos fichiers.

🔗Passer des options sur la ligne de commande

Vous pouvez définir n’importe quelle option de configuration de format d’exportation à l’aide de la syntaxe suivante :

    --core --conf plugins/imageio/format/<FORMAT>/<OPTION>=<VALEUR>

où est le nom du format de sortie souhaité et est n’importe quelle option de configuration pour ce format.

Une option définie de cette manière ne sera pas stockée de manière permanente mais sera utilisée uniquement pour cette exécution de darktable-cli.

Les sections suivantes décrivent les options/valeurs de configuration disponibles pour chaque format d’exportation :

🔗JPEG

qualité
La qualité de compression (5 - 100)

🔗J2K (JPEG2000)

format
Le format de la sortie
  • 0 : j2k
  • 1 : jp2
qualité
La qualité de compression (5 - 100)
préréglage
Le mode DCP
  • 0 : Cinema2K, 24 images par seconde
  • 1 : Cinema2K, 48 images par seconde
  • 2 : Cinéma4K, 24 images par seconde

🔗EXR (OpenEXR)

bpp
La profondeur de bits (16 ou 32)
dégradé
Le type de compression
  • ‘0’  : non compressé
  • 1  : RLE
  • ‘2’  : ZIPS
  • ‘3’ : ZIP
  • 4 : PIZ
  • ‘5’ : PXR24
  • ‘6’ : B44
  • 7 : DWAA
  • 8 : DWAB

🔗PDF

titre
Le titre du PDF (n’importe quel caractère)
taille papier
La taille du PDF (a4, a3, letter, legal)
orientation de la page
L’orientation papier du PDF
  • ‘0’ : portrait
  • ‘1’ : paysage
bords
L’espace vide autour du PDF ; format : taille (un nombre) + unité ; exemples : 10 mm, 1 pouce
dpi
La résolution en points par pouce à l’intérieur du PDF (1 - 5000)
retournement des images
S’il faut faire pivoter le PDF (0 ou 1)
profil icc intégré
Si un profil icc doit être intégré (0 ou 1)
bits
La profondeur de bits (‘8’ ou ‘16’)
compression
S’il faut compresser le PDF (0 ou 1)
mode de l'image
Le mode pour mettre les images dans le PDF
  • 0 : normal : juste mettre les images dans le PDF
  • 1’ : épreuve : les images sont remplacées par des boîtes
  • 2 : débogage : montre uniquement le contour des emplacements

🔗PFM

Aucune option fournie.

🔗PNG

bits
La profondeur de bits (‘8’ ou ‘16’)
compression
Le niveau de compression (0 - 9)

🔗PPM

Aucune option fournie.

🔗TIFF

bits
La profondeur de bits (8, 16, 32)
dégradé
Son type
  • 0: non compressé
  • 1: deflate
  • 2: deflate avec prédiction
compression
Le niveau de compression (0 - 9)
image n&b
Image N&B ou couleur
  • 0 : écrire les couleurs RVB
  • 1 : écrire en niveaux de gris

🔗WEBP

type de compression
Le type de compression
  • ‘0’ : avec perte
  • 1 : sans perte
qualité
La qualité de compression (5 - 100)
hint
The preferred way to manage the compression
  • 0: default
  • 1: picture: digital picture, like portrait, inner shot
  • 2: photo: outdoor photograph, with natural lighting
  • 3: graphic: discrete tone image (graph, map-tile, etc.)

🔗Copier

Aucune option fournie.

🔗XCF

bits
La profondeur de bits (8, 16, 32)

🔗JXL

bits  : La profondeur de bits (8, 10, 12, 16, 32)

pixel_type  : Booléen indiquant si le type de pixel (16 bits) est un entier non signé ou une virgule flottante.  : - 0 : entier non signé

  • 1 : virgule flottante

qualité  : Integer (4-100) : la qualité de l’image, correspondant approximativement à la qualité JPEG (100 est sans perte)

original  : Booléen indiquant s’il faut encoder en utilisant le profil de couleur original ou le profil XYB interne  : - 0 : interne  : - 1 : original

effort  : Entier entre 1 et 9. Effort avec lequel encoder la sortie ; plus il est élevé, plus il est lent (7 par défaut).

tier  : Entier entre 0 et 4. Une valeur plus élevée favorise la vitesse de décodage par rapport à la qualité (la valeur par défaut est 0).

translations