Variables

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

• Définition des noms de fichiers dans le module Exporter

• Affichage des informations de l’image dans Ligne d’information sur l’image de la Chambre noire

• Affichage des informations de l’image dans les superpositions et les info-bulles de la Table lumineuse (voir Préférences > Table lumineuse)

• Placement de texte sur une image dans le module Filigrane.

🔗Variables disponibles

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

$(ROLL.NAME[n])					pellicule de l'image en entrée où n précise le niveau du répertoire
									en comptant depuis la droite, par défaut n=1
$(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[n,m]))				nombre séquentiel dans la tâche d’exportation
									les paramètres sont optionnels, par défaut [4,1]
$(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)						Exif: année
$((EXIF.YEAR.SHORT)				Exif: année, version à deux chiffres
$(EXIF.MONTH)					Exif: mois, numérique
$(EXIF.MONTH.LONG)				Exif: mois, nom complet
$(EXIF.MONTH.SHORT)			Exif: mois, nom abrégé
$(EXIF.DAY)						Exif: jour
$(EXIF.HOUR)						Exif: heure
$(EXIF.MINUTE)					Exif: minute
$(EXIF.SECOND)					Exif: seconde
$(EXIF.MSEC)						Exif: milliseconde
$(EXIF.DATE.REGIONAL)			Exif: date utilisant les paramètres régionaux
$(EXIF.TIME.REGIONAL)			Exif: date/heure utilisant les paramètres régionaux
$(EXIF.ISO)							Exif: valeur ISO
$(EXIF.EXPOSURE)					Exif: exposition
$(EXIF.EXPOSURE.BIAS)			Exif: biais d'exposition
$(EXIF.EXPOSURE.PROGRAM)		Exif: programme d'exposition utilisé par l'appareil
$(EXIF.APERTURE					Exif: ouverture
$(EXIF.CROP_FACTOR)				Exif :facteur de conversion
$(EXIF.FLASH)						Exif: paramètres du flash 
$(EXIF.FLASH.ICON)				Exif: si le flash a fonctionné: icône de flash, vide sinon
$(EXIF.FOCAL.LENGTH)			Exif: longueur focale
$(EXIF.FOCAL.LENGTH.EQUIV)		Exif: longueur focale équivalente à 35 mm
$(EXIF.FOCUS.DISTANCE)			Exif: distance de mise au point
$(EXIF.LENS)						Exif: nom de l'objectif
$(EXIF.MAKER)						Exif: fabricant appareil
$(EXIF.METERING)					Exif: mode de mesure
$(EXIF.MODEL)						Exif: modèle de l'appareil
$(EXIF.WHITEBALANCE)			Exif: balance des blancs réglée dans l'appareil
$(IMAGE.EXIF)						Exif : informations de base sur l'exposition à partir des données (ouverture, exposition, ISO)
$(IMAGE.ID)						identifiant de l'image (sera mis à 0 lors du copier/importer)
$(IMAGE.ID[n])						identifiant de l'image (sera mis à 0 lors du copier/importer), complété par des zéros jusqu'à n chiffres
$(IMAGE.ID.NEXT)					identifiant de l'image suivante à affecter (peut être utilisé pendant le copier/importer)
$(IMAGE.ID.NEXT[n])				identifiant de l'image suivante à affecter (peut être utilisé pendant le copier/importer), complété par des zéros jusqu'à n chiffres
$(IMAGE.TAGS)						liste de tags (Xmp.dc.Subject), sans hiérarchie
$(IMAGE.TAGS.HIERARCHY)		liste de tags (Xmp.dc.Subject), avec hiérarchie
$(LONGITUDE)						longitude
$(LATITUDE)						latitude
$(ELEVATION)						altitude
$(GPS.ELEVATION)					GPS: altitude
$(GPS.LATITUDE)					GPS: latitude
$(GPS.LONGITUDE)				GPS: longitude
$(GPS.LOCATION)					GPS: latitude, longitude et altitude (en omettant toute valeur non définie)
$(GPS.LOCATION.ICON)			GPS: icône indiquant que l'information de géolocalisation est présente, sinon chaîne vide
$(STARS)							évaluation par étoiles (texte seulement)
$(RATING.ICONS)					évaluation par étoiles (utilisant des icônes étoiles)
$(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
$(Xmp.dc.title)						XMP métadonnées: titre
$(Xmp.dc.description)				XMP métadonnées: description
$(Xmp.dc.creator)					XMP métadonnées: créateur
$(Xmp.dc.publisher)				XMP métadonnées: éditeur
$(Xmp.dc.rights)					XMP métadonnées: droits
$(TAGS)							liste de tags (Xmp.dc.Subject)
$(CATEGORY[n,category])			nom du niveau n  [0,9] du tag n sélectionné
$(SIDECAR_TXT)					fichier texte associé (si existant)
$(FOLDER.PICTURES)				répertoire image
$(FOLDER.HOME)					répertoire parent
$(FOLDER.DESKTOP)				réperoire bureau
$(OPENCL.ACTIVATED)			si OpenCL est activé
$(USERNAME)						nom d'utilisateur défini par l'OS
$(NL)								caractère retour à la ligne
$(JOBCODE)						code interne de la tâche en cours

🔗Métadonnées

Les champs de éditeur de métadonnéespeuvent être utilisés pour modifier des variables en utilisant des noms de balise XMP sensibles à la casse.

🔗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

• Dutch: variabelen
• English: variables
• German: Variablen
• Lao: ຕົວປ່ຽນ (Variables)
• Polish: zmienne
• Português: variáveis
• Ukrainian: Змінні