module controls

This section describes how to interact with processing module controls.

🔗sliders

Sliders offer five different methods of interaction, depending on the level of control you require.

left-click (set)

Click anywhere in the slider area to set the value. You can also click and drag to change it. You don’t have to aim for the triangle or even the line – you can click anywhere in the entire height of the slider, including the label.

mouse wheel (adjust)

Hover over the slider with your mouse, then use your mouse wheel to adjust the value. You can alter the default speed at which the mouse scroll adjusts a slider by scrolling over that slider while in visual shortcut mapping mode.

keyboard arrow keys (adjust)

When the slider has focus you can hover over the slider with your mouse, then use your keyboard’s arrow keys (←/↓ and →/↑) to adjust the value. In order to give focus to the widget without changing the current value you can right-click, then right-click again.

right-click (pop-up edit)

When your mouse is over a slider right-clicking enables a multi-functional pop-up below the slider for fine control with your mouse or numerical entry using the keyboard.

A bent line extending from the triangular marker moves with your mouse. The closer your mouse pointer is to the triangular marker the coarser the control you have over the value; the further away from the triangular marker the finer your control. Left-click with your mouse to accept the new value and hide the pop-up.

Alternatively you can type in a new value using your keyboard and commit by hitting the Enter key. You may even supply the new value in the form of an arithmetic expression which darktable will calculate for you – the previous value is referenced as “x”.

For most sliders, the minimum and maximum values displayed are known as “soft limits” – they do not represent the minimum/maximum values that you may enter, merely a suggested range of “normal” values that most users will not need to exceed. As well as these soft limits, each slider also has “hard limits” which may not be exceeded.

You may right-click and type any value up to the hard limits for a given slider. For example, in the rotate and perspective module, the soft limits for angle are -10 to +10 degrees while the hard limits are -180 to +180 degrees; In the exposure module, the soft limits for the exposure slider are -3 to +4 EV while the hard limits are -18 to +18 EV. If you try to enter a value beyond the hard limit, it will be automatically be adjusted to the minimum/maximum allowable value.

double-click (reset)

Double-click on a slider or its label to reset back to the default value. Ctrl+double-click to reset its value back to any auto-applied preset (if one applies for the current image). If controls are grouped together within a tabbed interface, you can double-click on the tab’s header label to reset all settings in that tab.

In addition, the speed of mouse-wheel, arrow-key and click+drag adjustments can be altered:

• hold down the Shift key while adjusting to increase the step size by a factor of 10.
• hold down the Ctrl key while adjusting to decrease the step size by a factor of 10.

Both of these multipliers can be amended in preferences > shortcuts by altering the speed of the fallbacks/value actions.

🔗comboboxes

Click on a combobox to show a list of available options which you can click to select. Occasionally the selection list will open close to the bottom or top of the screen meaning that only some of the items are visible – simply scroll with your mouse wheel to bring up the full list. Alternatively, you can also use the mouse wheel and keyboard arrow keys to select an option, or start typing to filter the combobox entries.

As with sliders, you can double-click the combobox or its label to reset back to the default value, or Ctrl+double-click to reset back to any auto-applied preset.

🔗color pickers

A number of modules allow parameters to be set using color pickers (identified by the icon). These use a standard interface and most can operate in either point or area mode. Point mode can be activated by clicking on the color picker icon. Area mode is activated with Ctrl+click or right-click.

🔗keyboard shortcuts

Module parameters can also be adjusted using keyboard shortcuts. See preferences > shortcuts for more information.