Differences

This shows you the differences between two versions of the page.

--- photography:darktable:variables [2024/11/14 13:24] – created srohr_admin
+++ photography:darktable:variables [2024/11/14 13:30] (current) – srohr_admin
@@ Line 1: / Line 1: @@
-variables
+====== Variables ======
-darktable supports variable substitution in a number of modules and preference settings. For example:
+[[https://docs.darktable.org/usermanual/4.8/en/special-topics/variables/]]
+Darktable supports variable substitution in a number of modules and preference settings. For example:
 Defining file names in the export module
@@ Line 6: / Line 8: @@
 Displaying image information in the lighttable’s overlays and tooltips (see preferences > lighttable)
 Placing text on an image in the watermark processing module
-🔗available variables
+===== Available Variables =====
 The following variables are available, though they may not all be applicable in every context:
+<code>
 $(ROLL.NAME)               film roll of the input image
 $(FILE.FOLDER)             folder containing the input image
@@ Line 19: / Line 24: @@
 $(DARKTABLE.VERSION)       the version of the running darktable instance
 $(DARKTABLE.NAME)          name of darktable
-$(SEQUENCE)                a sequence number within an export job
+$(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
@@ Line 78: / Line 84: @@
 $(RIGHTS)                  rights from metadata
 $(TAGS)                    tags list (Xmp.dc.Subject)
-$(CATEGORYn(category))     tag name of level n [0,9] of selected category (or tag)
+$(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
@@ Line 87: / Line 93: @@
 $(NL)                      newline character
 $(JOBCODE)                 internal jobcode of current job
-🔗string substitution
+</code>
+===== string substitution =====
 All of the variables support basic string substitution inspired by bash though some of the details differ.
@@ Line 94: / Line 103: @@
 The following string replacement functions are provided, where var is one of the variables listed above:
+<code>
 $(var-default)                   If var is empty, return "default"
                                  It is possible to use another variable as "default", e.g.
@@ Line 129: / Line 139: @@
 $(var,,)                         Make all characters of var lowercase
-🔗
+</code>