automatic mouse and keyboard unexpand actions

element An element is the part of a UI widget that is affected by your shortcut. For example the darktable application window is a widget, containing side panel widgets, each of which contains module widgets, each of which contains button, slider and dropdown list widgets etc… When assigning a shortcut to an action, you must first decide which widget it is to be applied to. Such point-and-click type actions are normally defined as the application of an effect to an element of a widget, where these terms are defined as follows: widget Each visible part of the user interface is known as a widget. Shortcuts are used to initiate actions within darktable.Īn action is usually (but not always) an operation that you might undertake using darktable’s point-and-click user interface. Note: You may need to switch off the “disable touchpad while typing” setting if you want to use extended shortcuts with a laptop touchpad. Long button and key presses cannot be extended, as the length of the click/press is timed using the release of the final button/key – such shortcuts must be terminated with the raising of the final button/key. To extend a simple shortcut, you must hold the final key/button of the simple shortcut while performing the extending mouse/device movement.įor external devices you do not need to start with a simple shortcut – you can directly assign a control knob or joystick to an action – though this will significantly reduce the flexibility of such devices. Movement of a knob/joystick on an external device.Horizontal, vertical or diagonal movement of the mouse cursor.The following can be used to extend a simple shortcut: For example you might hold Ctrl+X while scrolling with your mouse to change the value of a slider. 🔗extending simple shortcuts with movementįor certain actions you can choose to extend a simple shortcut using mouse/device movement. However, these will merely function as extra Ctrl, Alt or Shift keys – you cannot create “new” modifiers. You can define additional keys (or device buttons) as modifiers by assigning keys/buttons to the “global/modifier” action. The only valid modifiers are the Shift, Ctrl and Alt keys on the keyboard. Various combinations of keyboard, mouse, and device buttons can be used to create simple shortcuts.

Similarly, up to three device-button presses or mouse-button clicks, the last of which may be long.Up to three key presses, the last one of which may be a long-press (defined as a key-press longer than your system’s double-click duration).

One or more modifier keys (Shift, Ctrl, Alt), held down while executing the remainder of the shortcut.

🔗simple shortcutsĪ shortcut that only includes button and/or key presses (and not mouse/device movements) is referred to as a simple shortcut.Ī simple shortcut must be initiated as above, but can include: You cannot initiate a shortcut by moving your mouse or pressing one of its buttons, as these actions are used to interact with darktable’s UI.

pressing a button or moving a knob/joystick on an external device.

You can, however, set up a single shortcut that does one thing in the lighttable view, say, and another in the darkroom view. 🔗defining shortcutsĪ shortcut is a combination of key or button presses and/or mouse or device movements that performs an action in darktable.Ī single action may have multiple shortcuts but a single shortcut can only be linked to one action in a given darktable view – you can’t chain actions together except by applying a preset or style. These are referred to as external devices or just devices in this guide. You can also use various other input devices, including MIDI devices and game controllers – see the midi device support section for details. You can perform almost any action in darktable with a keyboard/mouse shortcut.

Automatic mouse and keyboard unexpand actions