键位映射自定义

快捷键/关键体

可用按键

在自定义键位映射时，应尽量使用不会与Blender默认键位映射相冲突的按键。

下面这些是尚未用到的，且将来不大可能用到的按键。

功能键 (F5 - F8)

这些功能键（包括与辅助按键组合）是有意保留下来供用户绑定自己的快捷键的。

OSKey (也称之为 Windows键, Cmd 或 Super)

Blender不使用这个按键来绑定操作。

macOS 是例外， Cmd 替代 Ctrl ，与系统按键绑定冲突的情形除外。

与辅助键组合

Blender支持与辅助键组合绑定作为快捷键，以避免与常规用法冲突。

多动作按键

单击/拖动

使用 单击 事件替代 按压 来配置单个按键执行多个操作是可能的，而后你可以将另外的动作与 拖动 绑定。

这对于混合使用拖动事件的操作非常有用，例如：使用 Tab 切换设置，拖动以打开显示与设置相关的所有选项的饼图菜单。

3D视图中的默认键位映射用到了该组合， Alt-MMB 向不同方向拖动来旋转视图。

通用操作

本节列出一些可供使用的通用实用操作。

弹出菜单按键绑定

可以为菜单和面板指定快捷键，即使它们只能从其他地方的子菜单访问。

打开一组弹出菜单 (wm.call_menu)

通过按键打开任意菜单。

打开一组饼菜单 (wm.call_menu_pie)

通过按键打开任意饼菜单。

打开面板 (wm.call_panel)

打开弹出面板 (也称之为弹窗)。

菜单 & 面板标识符

在用户设置中启用 界面 ‣ 显示 ‣ Python工具提示 ，可以获得菜单的 名称。

然后将光标悬停在弹出按钮或菜单项上。对于子菜单，您需要使用后退箭头来防止子菜单打开并获得焦点。

属性按键绑定

用户可能想将很多属性与按键绑定。为了避免需要对每个属性定义操作，有几个作此用途的通用操作:

用于调整属性的 “操作” 以 wm.context_ 开头。

其中包括:

  • wm.context_toggle 切换布尔属性。

  • wm.context_cycle_enum 用于 enum 属性前后循环。

  • wm.context_menu_enum 用于为枚举属性弹出菜单。

  • wm.context_pie_enum 显示枚举属性为饼菜单。

  • wm.context_scale_float 缩放数值（比如用于增大/减小笔刷大小）。

  • wm.context_toggle_enum 用于在枚举的两个选项之间切换。

  • wm.context_modal_mouse 用于移动游标交互修改数值。

完整列表见 bpy.ops.wm。

每个 “操作” 都有一个 data_path 设置，用于引用所调整的数值。

找到 data_path 需要一些基础的 Python知识。

例如，您可以使用 Python 控制台访问要映射到键的布尔属性：

  1. bpy.context.object.show_name

使用 “操作” wm.context_toggle 配合以设置为 object.show_name 的 data_path``（注意 ``bpy.context 前缀是隐式的），来为其绑定按键。

其他上下文属性见 bpy.context。

可使用Python API文档查找属性， 或者使用Python 控制台的自动补全功能来查看可用的属性。