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

Há duas maneiras de remover atalhos padrão:

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.

Uma ação é geralmente (mas nem sempre) uma operação que você pode realizar usando a interface de usuário de apontar e clicar do Ansel. Por exemplo:

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

Esses tipos de ações de apontar e clicar são normalmente definidos como a aplicação de um efeito a um elemento de um widget, onde esses termos são definidos da seguinte forma:

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

As ações na seção “vistas” só podem ser executadas a partir da vista do Ansel especificada. Tal como acontece com as ações globais, a maioria não tem elementos específicos, pois são usadas para realizar operações únicas.

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 os módulos utilitários possuem os seguintes 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).

Além disso, estão disponíveis atalhos para todos os controles em cada módulo, bem como para quaisquer predefinições armazenadas (veja abaixo).

Processing modules

Módulos de processamento têm os mesmos elementos e padrões que os módulos utilitários com os seguintes elementos adicionais:

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

Um controle deslizante permite que você altere continuamente um valor inteiro ou decimal e tem os seguintes elementos disponíveis:

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.