darktable.configuration
table
This table includes values that describe details of the configuration of darktable.
🔗darktable.configuration.version
string
The version number of darktable.
🔗darktable.configuration.has_gui
boolean
True if darktable has a GUI (launched through the main darktable command, not darktable-cli).
🔗darktable.configuration.verbose
boolean
True if the Lua logdomain is enabled.
🔗darktable.configuration.tmp_dir
string
The name of the directory where darktable will store temporary files.
🔗darktable.configuration.config_dir
string
The name of the directory where darktable will find its global configuration objects (modules).
🔗darktable.configuration.cache_dir
string
The name of the directory where darktable will store its mipmaps.
🔗darktable.configuration.api_version_major
number
The major version number of the lua API.
🔗darktable.configuration.api_version_minor
number
The minor version number of the lua API.
🔗darktable.configuration.api_version_patch
number
The patch version number of the lua API.
🔗darktable.configuration.api_version_suffix
string
The version suffix of the lua API.
🔗darktable.configuration.api_version_string
string
The version description of the lua API. This is a string compatible with the semantic versioning convention
🔗darktable.configuration.running_os
string
The name of the Operating system darktable is currently running on
🔗darktable.configuration.check_version
function(
module_name : string,
... : table...
)
Check that a module is compatible with the running version of darktable
Add the following line at the top of your module :
darktable.configuration.check(...,{M,m,p},{M2,m2,p2})
To document that your module has been tested with API version M.m.p and M2.m2.p2.
This will raise an error if the user is running a released version of DT and a warning if he
is running a development version
(the … here will automatically expand to your module name if used at the top of your script).
- module_name - string - The name of the module to report on error
- … - table - Tables of API versions that are known to work with the script