variabelen

darktable ondersteunt variabele vervanging in een aantal modules en voorkeursinstellingen. Bijvoorbeeld:

🔗beschikbare variabelen

De volgende variabelen zijn beschikbaar, hoewel ze mogelijk niet allemaal in elke context van toepassing zijn:

$(ROLL.NAME)               film roll of the input image
$(FILE.FOLDER)             folder containing the input image
$(FILE.NAME)               basename of the input image
$(FILE.EXTENSION)          extension of the input image
$(ID)                      the image id
$(VERSION)                 the duplicate version number
$(VERSION.IF_MULTI)        same as $(VERSION) but null string if only one version exists
$(VERSION.NAME)            version name from metadata
$(DARKTABLE.VERSION)       the version of the running darktable instance
$(DARKTABLE.NAME)          name of darktable
$(SEQUENCE[n,m])           a sequence number within an export job with n digits and starting with m
                           parameters are optional, default is [4,1]
$(WIDTH.SENSOR)            width of RAW data in pixels before RAW crop
$(HEIGHT.SENSOR)           height of RAW data in pixels before RAW crop
$(WIDTH.RAW)               width of RAW data in pixels after RAW crop
$(HEIGHT.RAW)              height of RAW data in pixels after RAW crop
$(WIDTH.CROP)              image width in pixels at the end of the pixelpipe, but before export resize
$(HEIGHT.CROP)             image height in pixels at the end of the pixelpipe, but before export resize
$(WIDTH.EXPORT)            image width in pixels at the end of the pixelpipe and after export resize
$(HEIGHT.EXPORT)           image height in pixels at the end of the pixelpipe and after export resize
$(WIDTH.MAX)               maximum width entered in export module
$(HEIGHT.MAX)              maximum height entered in export module
$(YEAR)                    year at date of import/export
$(YEAR.SHORT)              two-digit year at date of import/export
$(MONTH)                   numeric (1-12) month at date of import/export
$(MONTH.LONG)              full month name at date of import/export
$(MONTH.SHORT)             abbreviated month name at date of import/export
$(DAY)                     day at date of import/export
$(HOUR)                    hour at time of import/export
$(MINUTE)                  minute at time of import/export
$(SECOND)                  second at time of import/export
$(MSEC)                    millisecond at time of import/export
$(EXIF.YEAR)               Exif year
$(EXIF.YEAR.SHORT)         Exif year, two-digit version
$(EXIF.MONTH)              Exif month, numeric
$(EXIF.MONTH.LONG)         Exif month, full name
$(EXIF.MONTH.SHORT)        Exif month, abbreviated name
$(EXIF.DAY)                Exif day
$(EXIF.HOUR)               Exif hour
$(EXIF.MINUTE)             Exif minute
$(EXIF.SECOND)             Exif second
$(EXIF.MSEC)               Exif millisecond
$(EXIF.DATE.REGIONAL)      Exif date using user's preferred regional date format
$(EXIF.TIME.REGIONAL)      Exif time using user's preferred regional date format
$(EXIF.ISO)                Exif ISO value
$(EXIF.EXPOSURE)           Exif exposure
$(EXIF.EXPOSURE.BIAS)      Exif exposure bias
$(EXIF.APERTURE)           Exif aperture
$(EXIF.CROP_FACTOR)        Exif crop factor
$(EXIF.FOCAL.LENGTH)       Exif focal length
$(EXIF.FOCAL.LENGTH.EQUIV) Exif 35 mm equivalent focal length
$(EXIF.FOCUS.DISTANCE)     Exif focus distance
$(IMAGE.EXIF)              basic exposure information from Exif data (aperture, exposure, ISO)
$(LONGITUDE)               longitude
$(LATITUDE)                latitude
$(ELEVATION)               elevation
$(GPS.LOCATION)            latitude, longitude, and elevation (omitting any values which are not set)
$(STARS)                   star rating (text only)
$(RATING.ICONS)            star rating (using star characters)
$(LABELS)                  colorlabels (color labels as text)
$(LABELS.ICONS)            colorlabels (color labels as icons)
$(MAKER)                   camera maker
$(MODEL)                   camera model
$(LENS)                    lens
$(TITLE)                   title from metadata
$(DESCRIPTION)             description from metadata
$(CREATOR)                 creator from metadata
$(PUBLISHER)               publisher from metadata
$(RIGHTS)                  rights from metadata
$(TAGS)                    tags list (Xmp.dc.Subject)
$(CATEGORY[n,category])    tag name of level n [0,9] of selected category (or tag)
$(SIDECAR_TXT)             content of the text sidecar file (if any)
$(FOLDER.PICTURES)         pictures folder
$(FOLDER.HOME)             home folder
$(FOLDER.DESKTOP)          desktop folder
$(OPENCL.ACTIVATED)        whether OpenCL is activated
$(USERNAME)                user name defined by OS
$(NL)                      newline character
$(JOBCODE)                 internal jobcode of current job

🔗tekenreeksvervanging

Alle variabelen ondersteunen basistekenreeksvervanging geïnspireerd door bash, hoewel sommige details verschillen.

Alle patronen worden behandeld als eenvoudige tekenreeksvergelijkingen. Er is geen regex-ondersteuning.

De volgende tekenreeksvervangingsfuncties zijn beschikbaar, waarbij var een van de hierboven genoemde variabelen is:

$(var-default)                   Als var leeg is, retourneer dan de "default"
                                 Het is mogelijk om een andere variabele te gebruiken als "default", bijv.
                                 $(WIDTH.CROP)-$(WIDTH.RAW)

$(var+alt_waarde)                 Als var is ingesteld, retourneer "alt_waarde" anders retourneer lege tekenreeks

$(var:vanaf)                    Retourneer het deel van var vanaf de opgegeven positie
                                 Als vanaf negatief is, wordt de positie geteld vanaf het einde van var

$(var:vanaf:lengte)             Beginnend met vanaf, retourneer maximaal lengte tekens van var
                                 Als offset negatief is, wordt de lengte geteld vanaf het einde van var
                                 Als de lengte negatief is, geeft dit het einde van het resultaat aan,
                                  geteld vanaf het einde van var, en niet de werkelijke lengte

$(var#patroon)                   Verwijder "patroon" vanaf het begin van var

$(var%patroon)                   Verwijder "patroon" aan het einde van var

$(var/patroon/vervang)       Vervang het eerste voorkomen van "patroon" in var door "vervang"
                                 Als "vervang" leeg is, wordt "patroon" verwijderd

$(var//patroon/vervang)      Vervang alle exemplaren van "patroon" in var door "vervang"
                                 Als "vervang" leeg is, wordt "patroon" verwijderd

$(var/#patroon/vervang)      Als var begint met "patroon", wordt "patroon" vervangen door "vervang"

$(var/%patroon/vervang)      Als var eindigt met "patroon" dan wordt "patroon" vervangen door "vervang"

$(var^)                          Maak een hoofdletter van het eerste teken van var

$(var^^)                         Zet alle tekens van var in hoofdletters

$(var,)                          Maak een kleine letter van het eerste teken van var

$(var,,)                         Zet alle tekens van var in kleine letters

🔗formatteren

De beeldinformatiepatronen ondersteunen [markup] (https://docs.gtk.org/Pango/pango_markup.html). Als je bijvoorbeeld het volgende toevoegt, krijg je een duidelijke waarschuwing (grote, rode, vetgedrukte tekst) als OpenCL er niet in geslaagd is om te initialiseren:

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

translations