Змінні

Darktable підтримує заміщення змінних у ряді модулів та налаштуваннях. Наприклад:

🔗Доступні змінні

Доступні такі змінні, хоча не всі вони можуть бути застосовні в кожному контексті:

$(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

🔗Підстановка рядків

Всі змінні підтримують базову заміну рядків, натхненну bash (командним процесором Unix-подібних систем), хоча деякі деталі відрізняються.

Усі шаблони розглядаються як прості порівняння рядків. Підтримка регулярних виразів відсутня.

Надаються такі функції заміни рядків, де var є однією із перелічених вище змінних:

$(var-default)                   Якщо var порожня, поверніть "default"
                                 Можна використовувати іншу змінну як "default", напр.
                                 $(WIDTH.CROP-$(WIDTH.RAW))

$(var+alt_value)                 Якщо var встановлено, повернути "alt_value", інакше повернути порожній рядок

$(var:offset)                    Повернути var, починаючи зі зміщення offset
                                 Якщо зміщення від'ємне, відлік йде від кінця рядка

$(var:offset:length)             Починаючи зі зміщення offset, повернути як максимум length символів var
                                 Якщо зміщення від’ємне, довжина відлічується від кінця змінної var
                                 Якщо довжина від’ємна, це означає кінець результату,
                                 відлічується від кінця var, а не фактичної довжини

$(var#pattern)                   Видалити "pattern" з початку var

$(var%pattern)                   Видалити "pattern" з кінця var

$(var/pattern/replacement)       Замінити перше входження "pattern" у var на "replacement"
                                 Якщо "replacement" є порожнім, тоді "pattern" буде видалено

$(var//pattern/replacement)      Замінити всі входження "pattern" у var на "replacement"
                                 Якщо "replacement" є порожнім, тоді "pattern" буде видалено

$(var/#pattern/replacement)      Якщо var починається з "pattern", тоді "pattern" замінюється на "replacement"

$(var/%pattern/replacement)      Якщо var закінчується на "pattern", тоді "pattern" замінюється на "replacement"

$(var^)                          Перевести перший символ var у верхній регістр

$(var^^)                         Перевести всі символи var у верхній регістр

$(var,)                          Перевести перший символ var у нижній регістр

$(var,,)                         Перевести всі символи var у нижній регістр

🔗Форматування

Шаблони інформації про зображення підтримують розмітку. Наприклад, додавання наступного надасть чітке попередження (великий, червоний, жирний текст), коли OpenCL не вдалося ініціалізувати:

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

translations