Revision 309cf2674ee7a0749978cf8265ab91a60aea0f7d authored by Pascal Obry on 30 December 2016, 10:00:57 UTC, committed by Pascal Obry on 16 January 2017, 21:54:23 UTC
Masks are now supported by the undo/redo circuitry as done for the
development data.
1 parent 5e3703d
Raw File
darktableconfig.xml.in
<?xml version="1.0"?>
<!DOCTYPE dtconfiglist SYSTEM "darktableconfig.dtd">
<dtconfiglist>
  <dtconfig>
    <name>bauhaus/scale</name>
    <type>float</type>
    <default>1.4</default>
    <shortdescription>widget scale</shortdescription>
    <longdescription>scaling factor for bauhaus widgets, will affect font size</longdescription>
  </dtconfig>
  <dtconfig>
    <name>database</name>
    <type>string</type>
    <default>library.db</default>
    <shortdescription>database location</shortdescription>
    <longdescription>filename relative to ~/.config/darktable or starting with a slash (needs a restart).</longdescription>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>panel_width</name>
    <type>int</type>
    <default>350</default>
    <shortdescription>width of the side panels in pixels</shortdescription>
    <longdescription>(needs a restart)</longdescription>
  </dtconfig>
  <dtconfig prefs="core">
    <name>cache_memory</name>
    <type factor="(1.0 / (1024.0 * 1024.0))" min="(1024 * 1024 * 100)">int64</type>
    <default>(1024 * 1024 * 256)</default>
    <shortdescription>memory in megabytes to use for thumbnail cache</shortdescription>
    <longdescription>this controls how much memory is going to be used for thumbnails and other buffers (needs a restart).</longdescription>
  </dtconfig>
  <dtconfig prefs="core">
    <name>cache_disk_backend</name>
    <type>bool</type>
    <default>true</default>
    <shortdescription>enable disk backend for thumbnail cache</shortdescription>
    <longdescription>if enabled, write thumbnails to disk (.cache/darktable/) when evicted from the memory cache. note that this can take a lot of memory (several gigabytes for 20k images) and will never delete cached thumbnails again. it's safe though to delete these manually, if you want. light table performance will be increased greatly when browsing a lot. to generate all thumbnails of your entire collection offline, run 'darktable-generate-cache'.</longdescription>
  </dtconfig>
  <dtconfig prefs="core">
    <name>cache_color_managed</name>
    <type>bool</type>
    <default>true</default>
    <shortdescription>color manage cached thumbnails</shortdescription>
    <longdescription>if enabled, cached thumbnails will be color managed so that lighttable and filmstrip can show correct colors. otherwise the results may look wrong once the display profile gets changed.</longdescription>
  </dtconfig>
  <dtconfig prefs="core">
    <name>worker_threads</name>
    <type>int</type>
    <default>2</default>
    <shortdescription>number of background threads</shortdescription>
    <longdescription>this controls for example how many threads are used to create thumbnails during import. the cache will grow to a maximum of twice this number of full resolution image buffers (needs a restart).</longdescription>
  </dtconfig>
  <dtconfig prefs="core">
    <name>host_memory_limit</name>
    <type>int</type>
    <default>1500</default>
    <shortdescription>host memory limit (in MB) for tiling</shortdescription>
    <longdescription>this variable controls the maximum amount of memory (in MB) a module may use during image processing. lower values will force memory hungry modules to process image with increasing number of tiles. setting this to 0 will omit any limit. values below 500 will be treated as 500 (needs a restart).</longdescription>
  </dtconfig>
  <dtconfig prefs="core">
    <name>singlebuffer_limit</name>
    <type min="2" max="64">int</type>
    <default>16</default>
    <shortdescription>minimum amount of memory (in MB) for a single buffer in tiling</shortdescription>
    <longdescription>if set to a positive, non-zero value this variable defines the minimum amount of memory (in MB) that tiling should take for a single image buffer. has precedence over heuristics based on host_memory_limit (needs a restart).</longdescription>
  </dtconfig>
  <dtconfig>
    <name>opencl_memory_headroom</name>
    <type>int</type>
    <default>300</default>
    <shortdescription>amount of OpenCL memory (in MB) which we assume as being reserved for the driver</shortdescription>
    <longdescription>this amount of memory (in MB) will be substracted from total GPU memory in order to calculate the available OpenCL memory. too low values will lead to out-of-memory situations in OpenCL processing. too high values will lead to unnecessary tiling (needs a restart).</longdescription>
  </dtconfig>
  <dtconfig>
    <name>opencl_avoid_atomics</name>
    <type>bool</type>
    <default>false</default>
    <shortdescription>do not run OpenCL kernels which require atomic operations</shortdescription>
    <longdescription>if set to TRUE darktable will not use OpenCL kernels which contain atomic operations (example bilateral). pixelpipe processing will be done on CPU for the affected modules. useful if your OpenCL implementation freezes/crashes on atomics or if they are processed with a bad performance.</longdescription>
  </dtconfig>
  <dtconfig>
    <name>opencl_number_event_handles</name>
    <type>int</type>
    <default>25</default>
    <shortdescription>the number of OpenCL event handles darktable can use</shortdescription>
    <longdescription>a positive non-zero integer defines the number of event handles that darktable may have opened on a device. a value of -1 does not pose any restrictions, bearing the risk of hitting the device's resource limits. a value of zero completely prevents the use of event handles.</longdescription>
  </dtconfig>
  <dtconfig>
    <name>opencl_async_pixelpipe</name>
    <type>bool</type>
    <default>false</default>
    <shortdescription>run OpenCL pixelpipe asynchronously</shortdescription>
    <longdescription>if set to TRUE OpenCL pixelpipe will not be synchronized on a per-module basis. this can improve pixelpipe latency. however, potential OpenCL errors would be detected late; in such a case the complete pixelpipe needs to be reprocessed instead of only a single module. export pixelpipe will always be run synchronously.</longdescription>
  </dtconfig>
  <dtconfig>
    <name>opencl_synch_cache</name>
    <type>bool</type>
    <default>false</default>
    <shortdescription>copy back OpenCL buffers into pixelpipe cache after each module</shortdescription>
    <longdescription>this brings pixelpipe cache and OpenCL buffers in synch after each module. on slow GPUs this might improve speed as it avoids reprocessing the whole pixelpipe on every parameter change. on fast GPUs the additional memory transfer overhead will slow down OpenCL considerably.</longdescription>
  </dtconfig>
  <dtconfig>
    <name>opencl_micro_nap</name>
    <type>int</type>
    <default>1000</default>
    <shortdescription>pause OpenCL processing for this number of microseconds from time to time</shortdescription>
    <longdescription>for slow GPUs this gives your graphics driver some time to breathe to do needed screen updates. can be left at zero for fast devices.</longdescription>
  </dtconfig>
  <dtconfig>
    <name>opencl_device_priority</name>
    <type>string</type>
    <default>*/!0,*/*/*</default>
    <shortdescription>priority of OpenCL devices for each pixelpipe type</shortdescription>
    <longdescription>defines priorities on how (multiple) OpenCL devices are allocated to the different types of pixelpipe (full, preview, export, thumbnail). for more details visit our usermanual (needs a restart).</longdescription>
  </dtconfig>
  <dtconfig>
    <name>opencl_use_pinned_memory</name>
    <type>bool</type>
    <default>false</default>
    <shortdescription>whether to use pinned memory transfer during tiling</shortdescription>
    <longdescription>during tiling huge amounts of memory need to be transfered between host and device. for some OpenCL implementations direct memory transfers give a drastic performance penalty. this can often be avoided by using indirect transfers via pinned memory. other devices have more efficient direct memory transfer implementations. AMD seems to belong to the first group, nvidia to the second.</longdescription>
  </dtconfig>
  <dtconfig>
    <name>opencl_use_cpu_devices</name>
    <type>bool</type>
    <default>false</default>
    <shortdescription>whether to make use of CPU OpenCL devices</shortdescription>
    <longdescription>typically darktable's hand-optimized CPU code is much faster than any OpenCL-on-CPU code; therefore CPUs are excluded from being used as OpenCL devices by default. can be changed by setting this configuration option to TRUE (needs a restart).</longdescription>
  </dtconfig>
  <dtconfig>
    <name>opencl_disable_drivers_blacklist</name>
    <type>bool</type>
    <default>false</default>
    <shortdescription>whether to allow some partial opencl implementations to be used or not</shortdescription>
    <longdescription>not all opencl implementations are fully-functional, there are at least two, which are not production-quality yet: pocl and beignet; therefore at this point in time, it is better to explicitly blacklist them by default. can be changed by setting this configuration option to TRUE (needs a restart).</longdescription>
  </dtconfig>
  <dtconfig>
    <name>opencl_checksum</name>
    <type>string</type>
    <default></default>
    <shortdescription>checksum representing the setup of opencl devices on this computer</shortdescription>
    <longdescription>darktable re-checks the performance benchmarks of your system in case your setup has changed, which is indicated by a change versus the stored checksum in this config variable; darktable de-activates opencl if the GPU benchmark lies below the one of the CPU.</longdescription>
  </dtconfig>
  <dtconfig>
    <name>opencl_enable_markesteijn</name>
    <type>bool</type>
    <default>true</default>
    <shortdescription>whether to process markesteijn demosaicing in the OpenCL codepath</shortdescription>
    <longdescription>markesteijn is a very demanding demosaicing method for x-trans sensors. the OpenCL codepath will only give advantage on very performant GPUs - else a slowdown is to be expected. users should benchmark their system and then decide if they switch this on or off.</longdescription>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>never_use_embedded_thumb</name>
    <type>bool</type>
    <default>false</default>
    <shortdescription>don't use embedded preview JPEG but half-size raw</shortdescription>
    <longdescription>check this option to not use the embedded JPEG from the raw file but process the raw data. this is slower but gives you color managed thumbnails.</longdescription>
  </dtconfig>
  <dtconfig prefs="core">
    <name>write_sidecar_files</name>
    <type>bool</type>
    <default>true</default>
    <shortdescription>write sidecar file for each image</shortdescription>
    <longdescription>these redundant files can later be re-imported into a different database, preserving your changes to the image.</longdescription>
  </dtconfig>
  <dtconfig prefs="core">
    <name>compress_xmp_tags</name>
    <type>
      <enum>
        <option>never</option>
        <option>always</option>
        <option>only large entries</option>
      </enum>
    </type>
    <default>only large entries</default>
    <shortdescription>store xmp tags in compressed format</shortdescription>
    <longdescription>entries in xmp tags can get rather large and may exceed the available space to store the history stack in output files. this option allows xmp tags to be compressed and save space.</longdescription>
  </dtconfig>
  <dtconfig prefs="core" capability="opencl">
    <name>opencl</name>
    <type>bool</type>
    <default>${DEFCONFIG_OPENCL}</default>
    <shortdescription>activate OpenCL support</shortdescription>
    <longdescription>if found, use OpenCL runtime on your system for improved processing speed. can be switched on and off at any time.</longdescription>
  </dtconfig>
  <dtconfig>
    <name>opencl_library</name>
    <type>string</type>
    <default/>
    <shortdescription>system library with OpenCL runtime</shortdescription>
    <longdescription>OpenCL runtime library is normally detected automatically by darktable. if your OpenCL runtime is at an unusual place and cannot be detected, enter the full pathname here. leave empty for default behavior.</longdescription>
  </dtconfig>
  <dtconfig>
    <name>opencl_memory_requirement</name>
    <type>int</type>
    <default>768</default>
    <shortdescription>minmum amount of GPU memory (MB) required to activate OpenCL</shortdescription>
    <longdescription>OpenCL will only be activated if your graphics card has at least this amount of memory. reducing the value will allow cards with less GPU memory to be used - but at the risk of lower system stability and occasional crashes. values below 200 will be treated as 200.</longdescription>
  </dtconfig>
  <dtconfig>
    <name>opencl_size_roundup</name>
    <type>int</type>
    <default>16</default>
    <shortdescription>round OpenCL work group sizes to a multiple of</shortdescription>
    <longdescription>in OpenCL processing round width/height of global work groups to a multiple of this value. reasonable values are powers of 2. this parameter can have high impact on OpenCL performance.</longdescription>
  </dtconfig>
  <dtconfig>
    <name>maximum_number_tiles</name>
    <type>int</type>
    <default>10000</default>
    <shortdescription>assumed maximum sane number of tiles</shortdescription>
    <longdescription>if during tiling this number is exceeded darktable assumes that tiling is not possible and falls back to untiled processing - with all system memory limits taking full effect. in case you want to process huge images you may want to increase this number.</longdescription>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>ask_before_remove</name>
    <type>bool</type>
    <default>true</default>
    <shortdescription>ask before removing images from database</shortdescription>
    <longdescription>always ask the user before any image is removed from DB.</longdescription>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>ask_before_delete</name>
    <type>bool</type>
    <default>true</default>
    <shortdescription>ask before erasing images from disk / discarding history stack</shortdescription>
    <longdescription>always ask the user before any image file is deleted / history stack is discarded.</longdescription>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>send_to_trash</name>
    <type>bool</type>
    <default>true</default>
    <shortdescription>send files to trash when erasing images</shortdescription>
    <longdescription>send files to trash instead of permanently deleting files on system that supports it</longdescription>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>ask_before_move</name>
    <type>bool</type>
    <default>true</default>
    <shortdescription>ask before moving images from film roll folder</shortdescription>
    <longdescription>always ask the user before any image file is moved.</longdescription>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>ask_before_copy</name>
    <type>bool</type>
    <default>true</default>
    <shortdescription>ask before copying images to new film roll folder</shortdescription>
    <longdescription>always ask the user before any image file is copied.</longdescription>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>show_folder_levels</name>
    <type>int</type>
    <default>1</default>
    <shortdescription>number of folder levels to show in lists</shortdescription>
    <longdescription>the number of folder levels to show in film roll names, starting from the right</longdescription>
  </dtconfig>
  <dtconfig>
    <name>plugins/collection/film_id</name>
    <type>int</type>
    <default>1</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/collection/rating</name>
    <type>int</type>
    <default>1</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/collection/rating_comparator</name>
    <type>int</type>
    <default>3</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/collection/query_flags</name>
    <type>int</type>
    <default>3</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/collection/filter_flags</name>
    <type>int</type>
    <default>3</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/collection/descending</name>
    <type>bool</type>
    <default>false</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/collection/sort</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/capture/jobcode</name>
    <type>string</type>
    <default>capture job</default>
    <shortdescription>name of capture job</shortdescription>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/capture/storage/basedirectory</name>
    <type>string</type>
    <default>$(PICTURES_FOLDER)/darktable</default>
    <shortdescription>path of storage for captured images</shortdescription>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/capture/storage/subpath</name>
    <type>string</type>
    <default>$(YEAR)$(MONTH)$(DAY)_$(JOBCODE)</default>
    <shortdescription>subpath pattern in storage for captured images</shortdescription>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/capture/storage/namepattern</name>
    <type>string</type>
    <default>$(YEAR)$(MONTH)$(DAY)_$(SEQUENCE).$(FILE_EXTENSION)</default>
    <shortdescription>rename pattern for captured images</shortdescription>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/capture/camera/import/jobcode</name>
    <type>string</type>
    <default>noname</default>
    <shortdescription>jobcode of import job</shortdescription>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>ui_last/colorpicker_mean</name>
    <type>int</type>
    <default>0</default>
    <shortdescription>0: mean, 1: min, 2: max</shortdescription>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>ui_last/fullscreen</name>
    <type>bool</type>
    <default>false</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>ui_last/maximized</name>
    <type>bool</type>
    <default>true</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>ui_last/grouping</name>
    <type>bool</type>
    <default>false</default>
    <shortdescription>grouping of images</shortdescription>
    <longdescription>only show a single image for each set of grouped images in lighttable and filmstrip</longdescription>
  </dtconfig>
  <dtconfig>
    <name>ui_last/view</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>ui_last/window_x</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>ui_last/window_y</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>ui_last/window_w</name>
    <type>int</type>
    <default>900</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>ui_last/window_h</name>
    <type>int</type>
    <default>500</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>ui_last/panel_left</name>
    <type>int</type>
    <default>-1</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>ui_last/panel_right</name>
    <type>int</type>
    <default>-1</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>ui_last/panel_top</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>ui_last/panel_bottom</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>ui_last/expander_import</name>
    <type>int</type>
    <default>2</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>ui_last/import_ignore_jpegs</name>
    <type>bool</type>
    <default>false</default>
    <shortdescription>ignore JPEG images when importing film rolls</shortdescription>
    <longdescription>when having raw+JPEG images together in one directory it makes no sense to import both. with this flag one can ignore all JPEGs found.</longdescription>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>ui_last/import_recursive</name>
    <type>bool</type>
    <default>false</default>
    <shortdescription>recursive directory traversal when importing filmrolls</shortdescription>
    <longdescription/>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>ui_last/import_last_creator</name>
    <type>string</type>
    <default/>
    <shortdescription>creator to be applied when importing</shortdescription>
    <longdescription/>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>ui_last/import_last_publisher</name>
    <type>string</type>
    <default/>
    <shortdescription>publisher to be applied when importing</shortdescription>
    <longdescription/>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>ui_last/import_last_rights</name>
    <type>string</type>
    <default/>
    <shortdescription>rights to be applied when importing</shortdescription>
    <longdescription/>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>ui_last/import_last_tags</name>
    <type>string</type>
    <default/>
    <shortdescription>comma separated tags to be applied when importing</shortdescription>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>ui_last/import_last_directory</name>
    <type>string</type>
    <default/>
    <shortdescription>last opened directory.</shortdescription>
    <longdescription/>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>ui_last/import_initial_rating</name>
    <type min="0" max="5">int</type>
    <default>1</default>
    <shortdescription>initial import rating</shortdescription>
    <longdescription>initial star rating for all images when importing a filmroll</longdescription>
  </dtconfig>
  <dtconfig>
    <name>plugins/capture/mode</name>
    <type>int</type>
    <default>0</default>
    <shortdescription>capture view mode</shortdescription>
    <longdescription/>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>plugins/lighttable/filmstrip/visible</name>
    <type>bool</type>
    <default>true</default>
    <shortdescription>enable filmstrip</shortdescription>
    <longdescription>enable the filmstrip in darkroom, tethering and map modes.</longdescription>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/filmstrip/height</name>
    <type>int</type>
    <default>120</default>
    <shortdescription>height of filmstrip</shortdescription>
    <longdescription>height of the filmstrip in pixels</longdescription>
  </dtconfig>
  <dtconfig> <!-- this option is not exposed in the gui because there might be crashy synchronisation issues when it's updated on the fly -->
    <name>plugins/lighttable/low_quality_thumbnails</name>
    <type>bool</type>
    <default>false</default>
    <shortdescription>low quality thumbnails</shortdescription>
    <longdescription>if set to true, thumbnails will be processed by first downscaling rather than demosaicing the full image. this can result in much faster processing times and blurrier images, especially when you cropped a lot.</longdescription>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>plugins/lighttable/thumbnail_hq_min_level</name>
    <type>
      <enum>
        <option>always</option>
        <option>small</option>
        <option>VGA</option>
        <option>720p</option>
        <option>1080p</option>
        <option>WQXGA</option>
        <option>4K</option>
        <option>5K</option>
        <option>never</option>
      </enum>
    </type>
    <default>720p</default>
    <shortdescription>high quality thumb processing from size</shortdescription>
    <longdescription>if the thumbnail size is greater than this value, it will be processed using the full quality rendering path (better but slower).</longdescription>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>pressure_sensitivity</name>
    <type>
      <enum>
        <option>off</option>
        <option>hardness (relative)</option>
        <option>hardness (absolute)</option>
        <option>opacity (relative)</option>
        <option>opacity (absolute)</option>
        <option>brush size (relative)</option>
      </enum>
    </type>
    <default>off</default>
    <shortdescription>pen pressure control for brush masks</shortdescription>
    <longdescription>off - pressure reading ignored, hardness/opacity/brush size - pressure reading controls specified attribute, absolute/relative - pressure reading is taken directly as attribute value or multiplied with pre-defined setting.</longdescription>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>brush_smoothing</name>
    <type>
      <enum>
        <option>low</option>
        <option>medium</option>
        <option>high</option>
      </enum>
    </type>
    <default>medium</default>
    <shortdescription>smoothing of brush strokes</shortdescription>
    <longdescription>sets level for smoothing of brush strokes. stronger smoothing leads to less nodes and easier editing but with lower control of accuracy.</longdescription>
  </dtconfig>
  <dtconfig>
    <name>database_cache_quality</name>
    <type>int</type>
    <default>89</default>
    <shortdescription>JPEG quality of on-disk thumbnails</shortdescription>
    <longdescription>affects only the thumbnail cache used for quick startup.</longdescription>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/draw_group_borders</name>
    <type>bool</type>
    <default>true</default>
    <shortdescription>draw borders around grouped images</shortdescription>
    <longdescription>draw borders around grouped images when grouping is turned off and the mouse hovers over one of the images of the group</longdescription>
  </dtconfig>

  <dtconfig prefs="session">
    <name>session/base_directory_pattern</name>
    <type>string</type>
    <default>$(PICTURES_FOLDER)/Darktable</default>
    <shortdescription>base directory naming pattern</shortdescription>
    <longdescription>part of full import path for an import session</longdescription>
  </dtconfig>

  <dtconfig prefs="session">
    <name>session/sub_directory_pattern</name>
    <type>string</type>
    <default>$(YEAR)$(MONTH)$(DAY)_$(JOBCODE)</default>
    <shortdescription>sub directory naming pattern</shortdescription>
    <longdescription>part of full import path for an import session</longdescription>
  </dtconfig>

  <dtconfig prefs="session">
    <name>session/filename_pattern</name>
    <type>string</type>
    <default>$(YEAR)$(MONTH)$(DAY)_$(SEQUENCE).$(FILE_EXTENSION)</default>
    <shortdescription>file naming pattern</shortdescription>
    <longdescription>file naming pattern used for a import session</longdescription>
  </dtconfig>

  <dtconfig>
    <name>plugins/lighttable/layout</name>
    <type>int</type>
    <default>1</default>
    <shortdescription>lighttable layout mode</shortdescription>
    <longdescription>select a layout for the lighttable: 0 - zoomable lighttable or 1 - file manager.</longdescription>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/images_in_row</name>
    <type>int</type>
    <default>5</default>
    <shortdescription>images per row</shortdescription>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/recentcollect/num_items</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/recentcollect/line0</name>
    <type>string</type>
    <default/>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/recentcollect/line1</name>
    <type>string</type>
    <default/>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/recentcollect/line2</name>
    <type>string</type>
    <default/>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/recentcollect/line3</name>
    <type>string</type>
    <default/>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/recentcollect/line4</name>
    <type>string</type>
    <default/>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/recentcollect/line5</name>
    <type>string</type>
    <default/>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/recentcollect/line6</name>
    <type>string</type>
    <default/>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/recentcollect/line7</name>
    <type>string</type>
    <default/>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/recentcollect/line8</name>
    <type>string</type>
    <default/>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/recentcollect/line9</name>
    <type>string</type>
    <default/>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/copy_history/pastemode</name>
    <type>int</type>
    <default>0</default>
    <shortdescription>append or replace history stack if pasted</shortdescription>
    <longdescription>0 -- append on top of stack, 1 -- replace it.</longdescription>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/num_rules</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/item0</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/string0</name>
    <type>string</type>
    <default/>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/item1</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/string1</name>
    <type>string</type>
    <default/>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/item2</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/string2</name>
    <type>string</type>
    <default/>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/item3</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/string3</name>
    <type>string</type>
    <default/>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/item4</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/string4</name>
    <type>string</type>
    <default/>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/item5</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/string5</name>
    <type>string</type>
    <default/>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/item6</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/string6</name>
    <type>string</type>
    <default/>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/item7</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/string7</name>
    <type>string</type>
    <default/>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/item8</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/string8</name>
    <type>string</type>
    <default/>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/item9</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/string9</name>
    <type>string</type>
    <default/>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/mode0</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/mode1</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/mode2</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/mode3</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/mode4</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/mode5</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/mode6</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/mode7</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/mode8</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/collect/mode9</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/tagging/visible</name>
    <type>bool</type>
    <default>true</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>plugins/lighttable/tagging/ask_before_delete_tag</name>
    <type>bool</type>
    <default>true</default>
    <shortdescription>ask before deleting a tag</shortdescription>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/map/show_map_osd</name>
    <type>bool</type>
    <default>true</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/map/show_outline</name>
    <type>bool</type>
    <default>true</default>
    <shortdescription>Whether to highlight the search result on the map</shortdescription>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/map/max_outline_nodes</name>
    <type>int</type>
    <default>10000</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>plugins/map/filter_images_drawn</name>
    <type>bool</type>
    <default>FALSE</default>
    <shortdescription>only draw images on map that are currently collected and filtered</shortdescription>
    <longdescription>use the current filter settings to select the geotagged images drawn on the map, i.e. limit the images drawn to the current filmstrip. this limits the number of images drawn and thus reduces the time needed to draw the images.</longdescription>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>plugins/map/max_images_drawn</name>
    <type>int</type>
    <default>100</default>
    <shortdescription>maximum number of images drawn on map</shortdescription>
    <longdescription>the maximum number of geotagged images drawn on the map. increasing this number can slow drawing of the map down.</longdescription>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>plugins/lighttable/metadata_view/pretty_location</name>
    <type>bool</type>
    <default>true</default>
    <shortdescription>pretty print the image location</shortdescription>
    <longdescription>show a more readable representation of the location in the image information module</longdescription>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>plugins/lighttable/draw_custom_metadata</name>
    <type>bool</type>
    <default>false</default>
    <shortdescription>overlay txt sidecar over zoomed images</shortdescription>
    <longdescription>when there is a txt file next to an image it can be shown as an overlay over zoomed images on the lighttable. the txt file either has to be there at import time or the crawler has to be enabled</longdescription>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>lighttable/ui/single_module</name>
    <type>bool</type>
    <default>false</default>
    <shortdescription>expand a single lighttable module at a time</shortdescription>
    <longdescription>this option toggles the behavior of shift clicking in lighttable mode</longdescription>
  </dtconfig>
  <dtconfig>
    <name>lighttable/ui/expose_statuses</name>
    <type>bool</type>
    <default>false</default>
    <shortdescription>always show thumbnail overlays</shortdescription>
    <longdescription>show overlays (rating stars, "edited" mark, etc) for all thumbnails in file manager, not only hovered one</longdescription>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>darkroom/ui/single_module</name>
    <type>bool</type>
    <default>true</default>
    <shortdescription>expand a single darkroom module at a time</shortdescription>
    <longdescription>this option toggles the behavior of shift clicking in darkroom mode</longdescription>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>lighttable/ui/scroll_to_module</name>
    <type>bool</type>
    <default>false</default>
    <shortdescription>scroll to lighttable modules when expanded/collapsed</shortdescription>
    <longdescription>when this option is enabled then darktable will try to scroll the module to the top of the visible list</longdescription>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>darkroom/ui/scroll_to_module</name>
    <type>bool</type>
    <default>true</default>
    <shortdescription>scroll to darkroom modules when expanded/collapsed</shortdescription>
    <longdescription>when this option is enabled then darktable will try to scroll the module to the top of the visible list</longdescription>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>plugins/darkroom/ui/border_size</name>
    <type>int</type>
    <default>20</default>
    <shortdescription>border around image in darkroom mode</shortdescription>
    <longdescription>process the image in darkroom mode with a small border. set to 0 if you don't want any border.</longdescription>
  </dtconfig>
  <dtconfig>
    <name>ui_last/expander_metadata</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>ui_last/expander_navigation</name>
    <type>int</type>
    <default>-1</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>ui_last/expander_histogram</name>
    <type>int</type>
    <default>-1</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>ui_last/expander_snapshots</name>
    <type>int</type>
    <default>-1</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>ui_last/expander_history</name>
    <type>int</type>
    <default>-1</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig prefs="core">
    <name>plugins/lighttable/export/force_lcms2</name>
    <type>bool</type>
    <default>false</default>
    <shortdescription>always use LittleCMS 2 to apply output color profile</shortdescription>
    <longdescription>this is slower than the default.</longdescription>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>plugins/slideshow/high_quality</name>
    <type>bool</type>
    <default>true</default>
    <shortdescription>do high quality processing for slideshow</shortdescription>
    <longdescription>same option as for export, but applies to slideshow.</longdescription>
  </dtconfig>
  <dtconfig prefs="core">
    <name>plugins/lighttable/export/high_quality_processing</name>
    <type>bool</type>
    <default>false</default>
    <shortdescription>do high quality resampling during export</shortdescription>
    <longdescription>the image will first be processed in full resolution, and downscaled at the very end. this can result in better quality sometimes, but will always be slower.</longdescription>
  </dtconfig>
 <dtconfig prefs="gui">
    <name>rating_one_double_tap</name>
    <type>bool</type>
    <default>false</default>
    <shortdescription>rating an image one star twice will not zero out the rating</shortdescription>
    <longdescription>do not have the rating of one star behave as documented in the manual--an image rated one star twice will result in a zero star rating.</longdescription>
  </dtconfig>
  <dtconfig>
    <name>darkroom/ui/rawoverexposed/mode</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>darkroom/ui/rawoverexposed/colorscheme</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>darkroom/ui/rawoverexposed/threshold</name>
    <type>float</type>
    <default>1.0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>darkroom/ui/overexposed/colorscheme</name>
    <type>int</type>
    <default>1</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>darkroom/ui/overexposed/lower</name>
    <type>float</type>
    <default>2.0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>darkroom/ui/overexposed/upper</name>
    <type>float</type>
    <default>98.0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig prefs="core">
    <name>plugins/darkroom/demosaic/quality</name>
    <type>
      <enum>
        <option>always bilinear (fast)</option>
        <option>at most PPG (reasonable)</option>
        <option>full (possibly slow)</option>
      </enum>
    </type>
    <default>at most PPG (reasonable)</default>
    <shortdescription>demosaicing for zoomed out darkroom mode</shortdescription>
    <longdescription>interpolation when not viewing 1:1 in darkroom mode: bilinear is fastest, but not as sharp. middle ground is using PPG + interpolation modes specified below, full will use exactly the settings for full-size export. X-Trans sensors use VNG rather than PPG as middle ground.</longdescription>
  </dtconfig>
  <dtconfig prefs="core">
    <name>plugins/lighttable/export/pixel_interpolator</name>
    <type>
      <enum>
        <option>bilinear</option>
        <option>bicubic</option>
        <option>lanczos2</option>
        <option>lanczos3</option>
      </enum>
    </type>
    <default>lanczos3</default>
    <shortdescription>pixel interpolator</shortdescription>
    <longdescription>pixel interpolator used in rotation and lens correction (bilinear, bicubic, lanczos2, lanczos3).</longdescription>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/export/width</name>
    <type>int</type>
    <default>0</default>
    <shortdescription>width of the exported image</shortdescription>
    <longdescription>width of the exported image, or 0 if no scaling should be done.</longdescription>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/export/height</name>
    <type>int</type>
    <default>0</default>
    <shortdescription>height of the exported image</shortdescription>
    <longdescription>height of the exported image, or 0 if no scaling should be done.</longdescription>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/export/storage_name</name>
    <type>string</type>
    <default>disk</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/export/format_name</name>
    <type>string</type>
    <default>jpeg</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/export/style</name>
    <type>string</type>
    <default/>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/imageio/storage/disk/file_directory</name>
    <type>string</type>
    <default>$(FILE_FOLDER)/darktable_exported/$(FILE_NAME)</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/imageio/storage/gallery/file_directory</name>
    <type>string</type>
    <default>$(HOME)/darktable_gallery/img_$(SEQUENCE)</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/imageio/storage/gallery/title</name>
    <type>string</type>
    <default>darktable gallery</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/imageio/storage/email/client</name>
    <type>string</type>
    <default/>
    <shortdescription>client to use, this overrides detection of default client.</shortdescription>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/imageio/format/pdf/size</name>
    <type>string</type>
    <default>a4</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/imageio/format/pdf/border</name>
    <type>string</type>
    <default>0 mm</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/imageio/format/pdf/dpi</name>
    <type>float</type>
    <default>300</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/imageio/format/pdf/compression</name>
    <type>int</type>
    <default>1</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/imageio/format/jpeg/quality</name>
    <type>int</type>
    <default>95</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/imageio/format/tiff/bpp</name>
    <type>int</type>
    <default>8</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/imageio/format/tiff/compress</name>
    <type>int</type>
    <default>2</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/imageio/format/png/bpp</name>
    <type>int</type>
    <default>8</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig prefs="core">
    <name>plugins/pwstorage/pwstorage_backend</name>
    <type>
      <enum>
        <option>auto</option>
        <option>none</option>
        <option capability="libsecret">libsecret</option>
        <option capability="kwallet">kwallet</option>
      </enum>
    </type>
    <default>auto</default>
    <shortdescription>password storage backend to use</shortdescription>
    <longdescription>the storage backend for password storage: auto, none, libsecret, kwallet</longdescription>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/export/icctype</name>
    <type>int</type>
    <default>-1</default>
    <shortdescription>ICC profile type to use for export</shortdescription>
    <longdescription>this overrides the per-image settings, if not set to -1.</longdescription>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/export/iccprofile</name>
    <type>string</type>
    <default></default>
    <shortdescription>ICC profile filename to use for export</shortdescription>
    <longdescription>this overrides the per-image settings, if icctype not set to -1.</longdescription>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/export/iccintent</name>
    <type>int</type>
    <default>-1</default>
    <shortdescription>ICC rendering intent</shortdescription>
    <longdescription>if non-negative, this overrides the per-image output color profile rendering intent on export.</longdescription>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/groups</name>
    <type>int</type>
    <default>2</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/active</name>
    <type>string</type>
    <default/>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/spots/circle_size</name>
    <type>float</type>
    <default>0.02</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/spots/circle_border</name>
    <type>float</type>
    <default>0.02</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/spots/ellipse_radius_a</name>
    <type>float</type>
    <default>0.02</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/spots/ellipse_radius_b</name>
    <type>float</type>
    <default>0.01414</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/spots/ellipse_border</name>
    <type>float</type>
    <default>0.02</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/spots/ellipse_rotation</name>
    <type>float</type>
    <default>90.0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/spots/ellipse_flags</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/spots/path_border</name>
    <type>float</type>
    <default>0.05</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/spots/brush_border</name>
    <type>float</type>
    <default>0.05</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/spots/brush_density</name>
    <type>float</type>
    <default>1.0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/spots/brush_hardness</name>
    <type>float</type>
    <default>0.66</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/clipping/ratio_d</name>
    <type>int</type>
    <default>0</default>
    <shortdescription>last chosen aspect ratio denominator</shortdescription>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/clipping/ratio_n</name>
    <type>int</type>
    <default>0</default>
    <shortdescription>last chosen aspect ratio numerator</shortdescription>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/clipping/guide</name>
    <type>int</type>
    <default>0</default>
    <shortdescription>last chosen guide style</shortdescription>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/histogram/mode</name>
    <type>
      <enum>
        <option>linear</option>
        <option>logarithmic</option>
        <option>waveform</option>
      </enum>
    </type>
    <default>logarithmic</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/histogram/show_red</name>
    <type>bool</type>
    <default>true</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/histogram/show_green</name>
    <type>bool</type>
    <default>true</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/histogram/show_blue</name>
    <type>bool</type>
    <default>true</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/masks/circle/size</name>
    <type>float</type>
    <default>0.05</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/masks/circle/border</name>
    <type>float</type>
    <default>0.05</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/masks/ellipse/radius_a</name>
    <type>float</type>
    <default>0.05</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/masks/ellipse/radius_b</name>
    <type>float</type>
    <default>0.03535</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/masks/ellipse/border</name>
    <type>float</type>
    <default>0.05</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/masks/ellipse/rotation</name>
    <type>float</type>
    <default>90.0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/masks/ellipse/flags</name>
    <type>int</type>
    <default>0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/masks/path/border</name>
    <type>float</type>
    <default>0.05</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/masks/gradient/rotation</name>
    <type>float</type>
    <default>0.0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/masks/gradient/compression</name>
    <type>float</type>
    <default>0.5</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/masks/gradient/steepness</name>
    <type>float</type>
    <default>0.0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/masks/brush/border</name>
    <type>float</type>
    <default>0.05</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/masks/brush/density</name>
    <type>float</type>
    <default>1.0</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/masks/brush/hardness</name>
    <type>float</type>
    <default>0.66</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig>
    <name>plugins/print/print/black_point_compensation</name>
    <type>bool</type>
    <default>true</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig prefs="gui">
    <name>ui_last/display_profile_source</name>
    <type>
      <enum>
        <option>all</option>
        <option>xatom</option>
        <option>colord</option>
      </enum>
    </type>
    <default>all</default>
    <shortdescription>method to use for getting the display profile</shortdescription>
    <longdescription>this option allows to force a specific means of getting the current display profile. this is useful when one alternative gives wrong results</longdescription>
  </dtconfig>
  <dtconfig>
    <name>metadata/resolution</name>
    <type>int</type>
    <default>300</default>
    <shortdescription/>
    <longdescription/>
  </dtconfig>
  <dtconfig prefs="core">
    <name>run_crawler_on_start</name>
    <type>bool</type>
    <default>false</default>
    <shortdescription>look for updated xmp files on startup</shortdescription>
    <longdescription>check file modification times of all xmp files on startup to check if any got updated in the meantime</longdescription>
  </dtconfig>
  <dtconfig prefs="core">
    <name>plugins/lighttable/audio_player</name>
    <type>string</type>
    <default>${DEFCONFIG_AUDIOPLAYER}</default>
    <shortdescription>executable for playing audio files</shortdescription>
    <longdescription>this external program is used to play audio files some cameras record to keep notes for images</longdescription>
  </dtconfig>
  <dtconfig prefs="core">
    <name>plugins/darkroom/basecurve/auto_apply_percamera_presets</name>
    <type>bool</type>
    <default>false</default>
    <shortdescription>auto-apply per camera basecurve presets</shortdescription>
    <longdescription>use the per-camera basecurve by default instead of the generic manufacturer one if there is one available (needs a restart)</longdescription>
  </dtconfig>
  <dtconfig>
    <name>screen_dpi_overwrite</name>
    <type>float</type>
    <default>-1.0</default>
    <shortdescription>overwrite the screen's dpi setting</shortdescription>
    <longdescription>if this value is > 0.0 then it is used as the screen's dpi setting which is used to scale the gui</longdescription>
  </dtconfig>
  <dtconfig>
    <name>screen_ppd_overwrite</name>
    <type>float</type>
    <default>-1.0</default>
    <shortdescription>overwrite the screen's ppd setting</shortdescription>
    <longdescription>if this value is > 0.0 then it is used as the screen's ppd setting which is used for HiDPI support</longdescription>
  </dtconfig>
  <dtconfig>
    <name>plugins/lighttable/preview/full_size_preload_count</name>
    <type>int</type>
    <default>1</default>
    <shortdescription>preload images for full-size preview</shortdescription>
    <longdescription>number of images to load in advance in the background when showing full-size preview</longdescription>
  </dtconfig>
  <dtconfig>
    <name>please_let_me_suffer_by_using_32bit_darktable</name>
    <type>bool</type>
    <default>false</default>
    <shortdescription>if using a 32-bit build, hide the message recommending a 64-bit build</shortdescription>
    <longdescription>the 32-bit build of darktable is known to exhibit sporadic issues and crashes. we show a warning message hinting at this issue. with this option, you can suppress the warning.</longdescription>
  </dtconfig>
  <dtconfig>
    <name>codepaths/sse2</name>
    <type>bool</type>
    <default>true</default>
    <shortdescription>enable usage of SSE2-optimized codepaths</shortdescription>
    <longdescription></longdescription>
  </dtconfig>
  <dtconfig>
    <name>codepaths/openmp_simd</name>
    <type>bool</type>
    <default>false</default>
    <shortdescription>enable usage of OpenMP SIMD codepaths. if enabled, and such codepath exists, it will have the highest priority</shortdescription>
    <longdescription></longdescription>
  </dtconfig>
  <dtconfig>
    <name>allow_lab_output</name>
    <type>bool</type>
    <default>false</default>
    <shortdescription>allow XYZ and Lab color spaces as output</shortdescription>
    <longdescription>this is mainly useful for debugging and to create colorchecker lut styles externally.</longdescription>
  </dtconfig>
  <dtconfig>
    <name>plugins/darkroom/rawprepare/allow_editing_crop</name>
    <type>bool</type>
    <default>false</default>
    <shortdescription>allow editing raw cropping boundaries</shortdescription>
    <longdescription>this is mainly useful for debugging and to add new camera support.</longdescription>
  </dtconfig>

  @DARKTABLECONFIG_IOP_ENTRIES@

  <dtconfig>
    <name>darkroom/ui/scale_step_multiplier</name>
    <type>float</type>
    <default>1.0</default>
    <shortdescription>the multiplier that is applied to any slider value change</shortdescription>
    <longdescription>any slider value change will be multiplied by this number, when changing slider while NOT holding SHIFT or CTRL modifiers</longdescription>
  </dtconfig>
  <dtconfig>
    <name>darkroom/ui/scale_rough_step_multiplier</name>
    <type>float</type>
    <default>10.0</default>
    <shortdescription>the multiplier that is applied to any slider rough value change</shortdescription>
    <longdescription>any slider value change will be multiplied by this number, when changing slider while holding SHIFT modifier</longdescription>
  </dtconfig>
  <dtconfig>
    <name>darkroom/ui/scale_precise_step_multiplier</name>
    <type>float</type>
    <default>0.1</default>
    <shortdescription>the multiplier that is applied to any slider precise value change</shortdescription>
    <longdescription>any slider value change will be multiplied by this number, when changing slider while holding CTRL modifier</longdescription>
  </dtconfig>
</dtconfiglist>
back to top