darktable

Le binaire darktable démarre darktable avec son interface graphique et ses fonctionnalités complètes. C’est la manière standard d’utiliser darktable. La commande permettant d’exécuter le fichier binaire dépend de votre système d’exploitation.

Les paramètres de ligne de commande suivants sont disponibles :

darktable [-d {all,act_on,ai,cache,camctl,camsupport,common,control,
               dev,expose,fswatch,imageio,input,ioporder,lighttable,lua,
               masks,memory,nan,opencl,params,perf,pipe,print,pwstorage,
               signal,sql,tiling,undo,verbose}]
          [--d-signal <signal>]
          [--d-signal-act <all,raise,connect,disconnect,print-trace>]
          [--disable-pipecache]
          [<input file>|<image folder>]
          [--version]
          [--disable-opencl]
          [--configdir <user config directory>]
          [--library <library file>]
          [--datadir <data directory>]
          [--moduledir <module directory>]
          [--tmpdir <tmp directory>]
          [--cachedir <user cache directory>]
          [--localedir <locale directory>]
          [--print-paths]
          [--print-paths-as-flags]
          [--luacmd <lua command>]
          [--noiseprofiles <noiseprofiles json file>]
          [--conf <key>=<value>]
          [-t <num openmp threads>]

Tous les paramètres sont optionnels. Dans la plupart des cas, les utilisateurs lanceront darktable sans paramètres supplémentaires. Dans ce cas, darktable utilise les valeurs par défaut adaptées.

-d {all,act_on,ai,cache,camctl,camsupport,common,control,dev,expose,fswatch,imageio,input,ioporder,lighttable,lua,masks,memory,nan,opencl,params,perf,pipe,print,pwstorage,signal,sql,tiling,undo,verbose}.
Active la sortie de débogage vers le terminal. Il existe plusieurs sous-systèmes de darktable et chacun d’entre eux peut être débogué séparément. Vous pouvez utiliser cette option plusieurs fois si vous voulez déboguer plus d’un sous-système (par exemple darktable -d opencl -d camctl) ou les déboguer tous en même temps (avec -d all). Le commutateur -d common est fourni pour donner des informations sur les sous-systèmes les plus pertinents lors du débogage de darktable ou si vous voulez fournir un journal pour rapporter un problème de darktable. Certaines options de débogage (comme -d opencl) peuvent également fournir une sortie plus verbeuse, qui peut être invoquée avec l’option supplémentaire -d verbose. L’option verbose doit être explicitement fournie, même en utilisant -d all.
--d-signal <signal>
Si -d signal ou-d all est spécifié, spécifiez le signal à déboguer en utilisant cette option. Spécifiez ALL pour déboguer tous les signaux ou spécifiez le signal en utilisant son nom complet. Peut être utilisé plusieurs fois.
--d-signal-act <all,raise,connect,disconnect,print-trace>
Si -d signal ou-d all est spécifié, spécifiez le signal à déboguer en utilisant cette option.

--disable-pipecache  : Désactive le cache du pixelpipe. Cette option n’autorise que deux lignes de cache par tube, et ne doit être utilisée qu’à des fins de débogage.

<input file>|<image folder>
Optionnellement vous pouvez indiquer le nom de fichier d’une image ou le nom d’un dossier contenant des fichiers d’images. Si un nom de fichier est donné darktable démarre en mode Chambre noire avec ce fichier ouvert. Si un nom de dossier est donné darktable démarre en mode Table lumineuse avec le contenu de ce dossier comme collection courante.
--version
Avec cette option darktable affiche son numéro de version, un avis de droits d’auteur, quelques autres informations utiles et ensuite s’arrête.
--disable-opencl
Cette option empêche darktable d’initialiser le sous-système OpenCL. Utilisez cette option dans le cas de plantage de darktable au démarrage en raison d’une implémentation défectueuse d’OpenCL.
--configdir <config directory>
Cette option définit le répertoire où darktable enregistre la configuration propre à l’utilisateur. Les chemins d’accès par défaut sont répertoriés sur la page Répertoires de configuration.
--library <library file>
darktable stocke les informations relatives aux images dans une base de données SQLite afin d’en faciliter l’accès. Par défaut, ce fichier de base de données, nommé library.db, se trouve dans le répertoire spécifié par l’option --configdir ou dans le répertoire de configuration par défaut. Utilisez cette option pour indiquer un autre emplacement (par exemple, si vous souhaitez effectuer des essais sans modifier votre fichier library.db d’origine). Si le fichier de base de données n’existe pas, darktable le crée pour vous. Vous pouvez également indiquer :memory: comme emplacement du fichier de bibliothèque ; dans ce cas, la base de données est conservée en mémoire système — toutes les modifications sont perdues à la fermeture de darktable.

Chaque fois que darktable démarre, il verrouille la bibliothèque à l’utilisateur actuel. Il le fait en écrivant l’identifiant de processus actuel (PID) dans un fichier de verrouillage <fichier de bibliothèque>.lock à côté de la bibliothèque spécifiée. Si darktable trouve un fichier de verrouillage existant pour la bibliothèque, il se terminera immédiatement.

--datadir <data directory>
Cette option définit le répertoire où darktable recherche ses données d’exécution. L’emplacement par défaut dépend de votre installation. Des emplacements typiques sont/opt/darktable/share/darktable/ et /usr/share/darktable/.
--moduledir <module directory>
darktable a une structure modulaire et organise ses modules sous forme de bibliothèques partagées à charger lors de l’exécution. Avec cette option, vous indiquez à darktable où il doit les rechercher. L’emplacement par défaut dépend de votre installation. Des emplacements typiques sont /opt/darktable/lib64/darktable/ et /usr/lib64/darktable/.
--tmpdir <tmp directory>
Emplacement où darktable enregistre ses fichiers temporaires. Si cette option n’est pas fournie, darktable utilise la valeur par défaut du système.
--cachedir <répertoire de cache>
darktable conserve un cache de vignettes d’images pour un aperçu rapide des images, ainsi que des binaires OpenCL précompilés pour un démarrage rapide. Plusieurs caches de vignettes peuvent coexister — un pour chaque bibliothèque. Le chemin par défaut du cache est indiqué sur la page répertoire de configuration.
--localedir <répertoire de localisation>
Définit l’emplacement où darktable peut trouver ses chaînes de texte spécifiques à la langue. Le chemin par défaut vers le répertoire de localisation est indiqué sur la page répertoire de configuration.

--print-paths  : Imprime les chemins correspondants à configdir, cachedir, tmpdir, datadir, moduledir, localedir et library pour cette installation, en respectant les remplacements éventuels, puis quitte.

--print-paths-as-flags
Comme --print-paths, mais imprimé comme une seule ligne de paires de valeurs –flag prêtes à être insérées dans la ligne de commande d’une autre invocation.
--luacmd <lua command>
Une chaîne contenant les commandes Lua à exécuter après l’initialisation de Lua. Ces commandes seront exécutées après votre fichier luarc.
Si Lua n’est pas compilé, cette option sera acceptée mais sera sans effet.
--noiseprofiles <noiseprofiles json file>
Le fichier json qui contient les profils de bruit spécifiques aux boîtiers. L’emplacement par défaut dépend de votre installation. Les emplacements typiques sont /opt/darktable/share/darktable/noiseprofile.json et /usr/share/darktable/noiseprofile.json.

--conf <key>=<value>  : darktable prend en charge un ensemble complet de paramètres de configuration définis par l’utilisateur dans le fichier darktablerc, situé dans le répertoire spécifié par l’option --configdir ou dans le répertoire de configuration par défaut. Cette option vous permet de remplacer temporairement certains paramètres depuis la ligne de commande ; ces paramètres ne seront pas enregistrés dans le fichier darktablerc à la fermeture du programme.

-t <num openmp threads>  : nombre maximum de fils openmp à utiliser dans les sections parallèles openmp.

--dump-pfm MODULE_A,MODULE_B, --dump-pipe MODULE_A,MODULE_B, --dumpdir DIR  : Ces options sont fournies pour déboguer le pipeline de traitement interne de darktable. Par exemple, si on l’appelle avec --dump-pfm demosaic darktable videra l’entrée et la sortie du module demosaic sous forme de fichiers pfm. Par défaut, l’emplacement de ces fichiers est défini par le système d’exploitation – un dossier temporaire signalé dans le journal de sortie – mais vous pouvez aussi le définir explicitement via l’option --dumpdir.

translations