Personalização de teclas de atalho

Keys

Atalhos disponíveis

Ao personalizar teclas de atalho é útil usar teclas que não entrem em conflito com o padrão do Blender.

Aqui estão as teclas que não são usadas e não são passíveis de serem usadas no futuro.

F-Keys (F5 - F8)

Estas teclas F (incluindo a combinação de modifier) foram intencionalmente mantidas livres para os usuários vincularem suas próprias teclas.

OSKey (também conhecida como Windows-Key, Cmd or Super)

O liquidificador não usa esta tecla para qualquer coisa.

macOS é uma exceção, onde Cmd substitui Ctrl exceto nos casos em que entraria em conflito com os atalhos do sistema.

Modifier Double Click

Binding modifier keys as primary keys is supported, to avoid conflicts with regular usage you can bind them to double click.

Teclas de ações multiplas

Clique/ Arraste

É possível configurar uma única tecla para realizar múltiplas operações usando o evento Click ao invés de Press (pressionar). Então você pode vincular Drag (arrastar) a uma ação separada.

This is useful for mixing actions where one uses a drag event, e.g: Toggle a setting using with tab, drag to open a pie menu showing all options related to the setting.

Click/Tweak

Unlike click/drag, this only works for the mouse buttons, but has the advantage that tweak events can be directional.

To use this, events in this keymap must use Click instead of Press, then you can bind Tweak actions to the mouse buttons.

This is used in the default keymap in the 3D Viewport, Alt-MMB dragging in different directions rotates the view.

Operações comuns

This section lists useful generic operations which can be used.

Key Bindings for Pop-Ups

Menus and panels can be assigned key shortcuts, even if they’re only accessible from submenus elsewhere.

Abra um menu pop-up (wm.call_menu`)

Abrir qualquer menu na tecla .

Abra um menu redondo tipo torta (wm.call_menu_pie`)

Abra qualquer menu redondo tipo torta pressionando a tecla .

Abra um Painel (wm.call_panel`)

Abra um painel pop-up (também conhecido como pop-over).

Key Bindings for Properties

There are many properties you might want to bind a key with. To avoid having to define operators for each property, there are generic operators for this purpose:

Operators for adjusting properties begin with wm.context_.

Algumas delas incluem:

  • wm.context_toggle toggle a Boolean property.

  • wm.context_cycle_enum cycle an enum property forwards or backwards.

  • wm.context_menu_enum show a pop-up menu for an enum property.

  • wm.context_pie_enum show a pie menu for an enum property.

  • wm.context_scale_float scale a number (used for increasing / decreasing brush size for example).

  • wm.context_toggle_enum toggle between two options of an enum.

  • wm.context_modal_mouse moving the cursor to interactively change a value.

See bpy.ops.wm for a complete list.

Each of these operators has a data_path setting to reference the property to change.

To find the data_path, basic Python knowledge is needed.

For example, you can use the Python Console to access a Boolean property you wish to map to a key:

bpy.context.object.show_name

To bind this to a key, add a new keymap item using the operator wm.context_toggle with data_path set to object.show_name (notice the bpy.context prefix is implicit).

See bpy.context for other context attributes.

The Python API documentation can be used to find properties or you may use the Python Console’s auto-complete to inspect available properties.