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.

Una acción es normalmente (pero no siempre) una operación que podría hacerse usando la interfaz de usuario point-and-click de Ansel. Por ejemplo:

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

Estas acciones de tipo apuntar y hacer clic normalmente se definen como la aplicación de un efecto a un elemento de un widget, donde estos términos se definen de la siguiente manera:

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

Las acciones en la sección “vistas” solo se pueden ejecutar desde la vista Ansel especificada. Al igual que con las acciones globales, la mayoría no tiene elementos específicos, ya que se utilizan para realizar operaciones puntuales.

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

Todos los módulos de utilidades tienen los siguientes elementos:

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).

Además, los accesos directos están disponibles para todos los controles de cada módulo, así como para cualquier preajuste almacenado (ver más abajo).

Processing modules

Los módulos de procesamiento tienen los mismos elementos y valores predeterminados que los módulos de utilidad con los siguientes elementos adicionales:

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

Un control deslizante le permite modificar continuamente un valor entero o decimal y tiene los siguientes elementos disponibles:

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.