Some actions in Ansel can be performed with a keyboard shortcut. A table of key shortcuts is available in Help > Table of key shortcuts.

Note: The table shows different key shortcuts for different Views.

Assigning key shortcuts

For the time being shortcuts can only be defined or changed by editing your $HOME/.config/Ansel/shortcutsrc file. There is no support for MIDI-devices in Ansel.

Deleting default shortcuts

When launching the application, Ansel loads default shortcuts first, and then loads user-defined shortcuts on top. This allows default shortcuts to be overridden with a new action but prevents them from being deleted (since the deleted shortcut will be automatically reloaded on the next restart).

There are two ways to delete default shortcuts:

Prevent default shortcuts from being reloaded

Disable Preferences > Miscellaneous > Interface > Load default shortcuts at startup to prevent default shortcuts from being reloaded. While this option is disabled, Ansel will only load user-defined shortcuts and any defaults that you have not subsequently deleted or overridden.

Override default shortcut with a no-op action

You can override the action of a default shortcut by assigning an identical shortcut to the “global/no-op” action (which does nothing). You can do this by directly editing your $HOME/.config/Ansel/shortcutsrc file (you must exit Ansel first). For example, the following default shortcuts are defined in shortcutsrc for switching views in Ansel:

1Return=global/switch views/darkroom
2Escape=global/Ateliers/Lighttable

You could disable these shortcuts by changing shortcutsrc as follows:

1Return=global/no-op
2Escape=global/no-op

Actions

Note: The following two section were used to explain the deprecated shortcut mapping screen and are left here for future reference or development.

Shortcuts are used to initiate actions within Ansel.

Akcja jest zwykle (ale nie zawsze) operacją, którą możesz wykonać za pomocą interfejsu użytkownika Ansel typu „wskaż i kliknij”. Akcją może być na przykład:

  • Increase, decrease or reset sliders
  • Scroll through dropdown lists
  • Enable, expand or focus modules
  • Click buttons
  • Switch between views

Takie działania typu „wskaż i kliknij” są zwykle definiowane jako zastosowanie efektu do elementu widżetu, gdzie te terminy są zdefiniowane w następujący sposób:

Widget
Each visible part of the user interface is known as a widget. For example the Ansel 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.
Element
An element is the part of a UI widget that is affected by your shortcut. For example, for a slider that has a color picker, you can make a shortcut activate the color picker button element or change the value element of the slider. For a row of tabs (the row is a single widget) you can select which tab element to activate or use your mouse scroll wheel to scroll through the tabs.
Effect
A shortcut can sometimes have multiple possible effects on a given element. For example, a button can be activated as if it was pressed with a plain mouse-click or as if it was pressed with Ctrl+click. A slider’s value can be edited, increased/decreased or reset.

Common actions

The following is a list of some of the actions to which you can assign shortcuts, organized by widget type.

Global

Actions in the “global” section can be executed from any Ansel view. Most of these actions do not have specific elements as they are used to perform one-off operations.

Views

Akcje w sekcji „widoki” mogą być wykonywane tylko z określonego widoku Ansel. Podobnie jak w przypadku akcji globalnych, większość z nich nie ma określonych elementów, ponieważ służą one do wykonywania jednorazowych operacji.

Buttons

A button is a clickable icon in the Ansel interface. The default action, when assigning shortcut to a button, is to activate that button as if clicked with the left mouse button. You can modify this action to activate the button as if clicked while holding a modifier key.

Toggles

A toggle is a button that has a persistent on/off state. It therefore has additional effects to allow you to toggle it or explicitly set its state. As with a normal button the default action, when assigning a shortcut to a toggle, is to activate the toggle as if clicked with the left mouse button (which toggles the button on/off).

Utility modules

Wszystkie moduły narzędziowe posiadają następujące elementy:

Show
Acts as a toggle that expands and collapses the module.
Reset
Acts as a button that resets all module parameters when activated. The ctrl-activate action can be used to re-apply any automatic presets for that module.
Presets
Allows you to select actions from the Presets menu (e.g. edit, update, previous, next). The default action, when assigning a shortcut to a preset element, is to display a list of the available presets for selection.

The default action, when assigning a shortcut to a utility module, is to toggle the show element (expand/collapse the module).

Skróty klawiszowe dostępne są zarówno dla wszystkich kontrolek modułu, jak i zapisanych presetów (zob. niżej).

Processing modules

Moduły produkcyjne mają te same elementy i wartości domyślne, co moduły narzędziowe z następującymi dodatkowymi elementami:

Enable
Acts as a toggle that switches the module on and off.
Focus
Acts as a toggle that focuses or defocuses the module.
Instance
Allows you to select actions from the Multiple-instance menu (e.g. move up/down, create new instance). The default action, when assigning a shortcut to the instance element, is to display a list of the available options for selection;

If an action affects a processing module that can have multiple instances, you can choose which instance to adjust with a given shortcut. By default, all actions will affect the “preferred” instance, as defined using the settings in Preferences > Miscellaneous > Shortcuts with multiple instances.

Sliders

Suwak umożliwia zmianę w ciągłym zakresie wartości całkowitej bądź dziesiętnej i posiada dostępne następujące elementy:

Value
Allows the current value of the slider to be altered. The default action, when assigning a shortcut to a slider, is to display a popup edit box so you can enter a value. Value elements are also used for modifying some on-screen graphs. When modifying the value element with a shortcut you may not exceed the bounds set in the visual slider.
Force
This is the same as the value element described above, but it allows you to exceed the bounds set in the visual slider.
Zoom
Allows you to change the upper and lower bounds of the visual slider without altering the current value.
Button
A standard button element that allows the button to the right of the slider (if present) to be activated. For example, a slider may include a color picker to visually set its value based on selected elements of the image.