Variables

darktable prend en charge la substitution de variables dans un certain nombre de modules et dans les préférences. Par exemple :

🔗Variables disponibles

Les variables suivantes sont disponibles, bien qu’elles ne soient pas toutes applicables dans tous les contextes :

$(ROLL.NAME)               pellicule de l'image en entrée
$(FILE.FOLDER)             répertoire contenant l'image en entrée
$(FILE.NAME)               nom de base de l'image en entrée
$(FILE.EXTENSION)          extension du fichier de l'image en entrée
$(ID)                      id de l'image
$(VERSION)                 numéro de version de l'image clonée
$(VERSION.IF_MULTI)       identique à $(VERSION) mais chaîne vide si une seule version existe
$(VERSION.NAME)            nom de version des métadonnées
$(DARKTABLE.VERSION)       version de l'instance de darktable en cours d'exécution
$(DARKTABLE.NAME)          nom de darktable
$(SEQUENCE)                nombre séquentiel dans la tâche d’exportation
$(WIDTH.SENSOR)            largeur en pixels des données RAW avant le recadrage RAW 
$(HEIGHT.SENSOR)           hauteur en pixels des données RAW avant le recadrage RAW
$(WIDTH.RAW)               largeur en pixels des données RAW après le recadrage RAW
$(HEIGHT.RAW)              hauteur en pixels des données RAW après le recadrage RAW
$(WIDTH.CROP)              largeur en pixels de l'image à la fin du pipeline graphique, mais avant le redimensionnement de l'exportation
$(HEIGHT.CROP)             hauteur en pixels de l'image à la fin du pipeline graphique, mais avant le redimensionnement de l'exportation
$(WIDTH.EXPORT)            largeur en pixels de l'image à la fin du pipeline graphique et après le redimensionnement de l'exportation
$(HEIGHT.EXPORT)           hauteur en pixels de l'image à la fin du pipeline graphique et après le redimensionnement de l'exportation
$(WIDTH.MAX)               largeur maximale entrée dans le module exportation
$(HEIGHT.MAX)              hauteur maximale entrée dans le module exportation
$(YEAR) année de la date de d'importation/exportation
$YEAR.SHORT) année à deux chiffres à la date de l'importation/exportation
$(MONTH) mois numérique (1-12) à la date d'importation/exportation
$(MONTH.LONG) nom complet du mois à la date d'importation/exportation
$(MONTH.SHORT) nom abrégé du mois à la date d'importation/exportation
$(DAY) jour de la date d'importation/exportation
$(HOUR) heure de la date d'importation/exportation
$(MINUTE) minutes de l'heure d'importation/exportation
$(SECOND) secondes de l'heure d'importation/exportation
$(MSEC)       millisecondes de l'heure d'importation/exportation
$((EXIF.YEAR)    Année Exif
$(EXIF.MONTH)    Exif monthYEAR.SHORT) Exif année, version à deux chiffres
$(EXIF.MONTH)    Mois de l'Exif, numérique
$(EXIF.MONTH.LONG)     Exif mois, nom complet
$(EXIF.MONTH.SHORT)    Mois de l'EXIF, nom abrégé
$(EXIF.MONTH)   mois Exif
$(EXIF.DAY) jour Exif
$(EXIF.HOUR) heure Exif
$(EXIF.MINUTE) minute Exif
$(EXIF.SECOND) seconde Exif
$(EXIF.MSEC)               milliseconde Exif
$(EXIF.DATE.REGIONAL)      date Exif utilisant les paramètres régionaux
$(EXIF.TIME.REGIONAL)      date/heure Exif utilisant les paramètres régionaux
$(EXIF.ISO)                valeur ISO Exif
$(EXIF.EXPOSURE)           exposition Exif
$(EXIF.EXPOSURE.BIAS)      biais d'exposition Exif
$(EXIF.APERTURE)           ouverture Exif
$(EXIF.CROP_FACTOR)        Facteur de conversion Exif
$(EXIF.FOCAL.LENGTH)       longueur focale Exif
$(EXIF.FOCAL.LENGTH.EQUIV)      Longueur focale équivalente à 35 mm (Exif)
$(EXIF.FOCUS.DISTANCE)      Distance de mise au point Exif
$(IMAGE.EXIF)       informations de base sur l'exposition à partir des données Exif (ouverture, exposition, ISO)
$(LONGITUDE)               longitude
$(LATITUDE)                latitude
$(ELEVATION)               élévation
$(GPS.LOCATION)        latitude, longitude et altitude (en omettant toute valeur non définie)
$(STARS)                   évaluation par étoiles (texte seulement)
$(RATING.ICONS)            évaluation par étoiles (utilisant des caractères étoile)
$(LABELS)                  étiquettes de couleur (texte seulement)
$(LABELS.ICONS)            étiquettes de couleur (utilisant des icônes colorées)
$(MAKER)                   fabricant du boîtier
$(MODEL)                   modèle du boîtier
$(LENS)                    objectif
$(TITLE)                   titre d'après les métadonnées
$(DESCRIPTION)             description d'après les métadonnées
$(CREATOR)                 créateur d'après les métadonnées
$(PUBLISHER)               éditeur d'après les métadonnées
$(RIGHTS)                  droits d'après les métadonnées
$(TAGS)                    liste de mots-clés (Xmp.dc.Subject)
$(CATEGORYn(category))     nom du mot-clé de niveau n [0,9] de la catégorie sélectionnée (ou du mot-clé)
$(SIDECAR_TXT)             contenu texte du fichier lié s'il existe
$(FOLDER.PICTURES)         répertoire des images
$(FOLDER.HOME)             répertoire de l'utilisateur
$(FOLDER.DESKTOP)          répertoire du bureau
$(OPENCL.ACTIVATED)        si OpenCL est activé
$(USERNAME)                nom de l'utilisateur défini par le système
$(NL)                      caractère nouvelle ligne
$(JOBCODE)                 code interne de la tâche courante

🔗Substitution de variable

Toutes les variables supportent la substitution de chaîne de base inspirée de l’interpréteur en ligne de commande Bash, bien que certains détails diffèrent.

Tous les modèles sont traités comme de simples comparaisons de chaînes de caractères. Il n’y a pas de support des expressions régulières.

Les fonctions suivantes de remplacement de chaînes sont fournies, où var est l’une des variables répertoriées ci-dessus :

$(var-default)
                   Si var est vide, renvoie default
                   Il est possible de renvoyer une autre variable
                   par exemple $(WIDTH.CROP-$(WIDTH.RAW))

$(var+alt_value)
                   Si var est défini, renvoie alt_value 
                   sinon renvoie une chaîne vide

$(var:offset)
                   Renvoie la partie de var commençant à offset 
                   Si offset est négatif on compte à partir de la fin de la chaîne

$(var:offset:length)
                   À partir de offset, renvoie au plus length caractères de var
                   Si offset est négatif length est compté à partir de la fin de var
                   Si length est négatif, il indique la fin du résultat, 
                   compté à partir de la fin de var et non une longueur réelle

$(var#pattern)
                   Supprime pattern au début de var 

$(var%pattern)
                    Supprime pattern à la fin de var 

$(var/pattern/replacement)
                    Remplace par replacement, la première occurrence de pattern dans var
                    Si replacement est vide alors pattern sera supprimé. 

$(var//pattern/replacement)
                   Remplace par replacement, toutes les occurrences de pattern dans var
                   Si replacement est vide alors pattern sera supprimé

$(var/#pattern/replacement)
                    Si var commence par pattern alors pattern est remplacé par replacement

$(var/%pattern/replacement)
                   Si var se termine par pattern alors pattern est remplacé par replacement

$(var^)
                   Met en majuscule le premier caractère de var

$(var^^)
                   Met en majuscule tous les caractères de var

$(var,)
                  Met en minuscule le premier caractère de var

$(var,,)
                  Met en minuscule tous les caractères de var

🔗Formatage

Les motifs d’information de l’image prennent en charge Pango markup. Par exemple, l’ajout de ce qui suit fournira un avertissement clair (texte grand, rouge et gras) lorsque OpenCL n’a pas réussi à s’initialiser :

<span alpha='1%'>$(OPENCL_ACTIVATED/no/<span foreground='red' weight='heavy' size='xx-large' alpha='100%'>ACTIVATION OPENCL ÉCHOUÉE</span>$(NL))</span>

translations