OpenLogi

Actions Ring

在指针位置打开并配置八位置启动器。按方向瞄准、按住选择、选择大小,并支持完整的按应用布局与可选触觉反馈。

操作环(Actions Ring)是一个在指针位置展开的八位置启动器。 从设备详情页的操作环(Actions Ring)标签打开它。

带按键的指针设备、带触觉面板的设备,以及显示按键(Keys)标签的键盘,都有此标签。 显示按键(Keys)标签的键盘可将一个键绑定为显示操作环(Show Actions Ring)。 MX Master 4 的触觉感应面板(Haptic Sense Panel)也是受支持的控件。在新设备上,该面板默认绑定为显示操作环。

打开操作环

按下绑定为显示操作环(Show Actions Ring)的控件,即可在指针位置打开操作环。 再次触发该操作可关闭操作环。

文档上方的操作环,指向粘贴

朝粘贴方向移动即可选中,并显示其标签。

瞄准位置

把指针朝某个位置的方向移动,即可选中它。每个位置占据其方向两侧共 45° 的扇区,因此指针不必到达位置本身。指针移过头时,仍会选中该位置。

指针停在中心附近时,不会选中任何位置。朝空位置瞄准也不会选中任何位置。

选中的位置会放大,并有一道光束从中心指向它。它的标签以气泡形式显示在旁边。过长的标签会换一行,然后以省略号结尾。其他位置显示为半透明圆片,后面没有底板。

选择位置

操作环提供两种选择方式:

  • 点击。 短按会打开操作环并保持打开。瞄准后点击,即可运行选中的位置。
  • 按住后松开。 按住触发控件 250 毫秒或更久,瞄准后松开。在某个位置上松开会运行它。没有选中位置时松开会关闭操作环。

只有触发控件的按下本身打开操作环时,按住后松开才有效。由手势或长按打开的操作环在松开后仍保持打开。

在中心附近点击(包括点击中心的 ×)会关闭操作环。朝空位置点击也会关闭它。在 macOS 上,点击操作环外部也可关闭它。操作环会在 15 秒后关闭。

配置操作环

选择设备

选择设备,然后在设备详情页打开操作环(Actions Ring)。

选择布局

使用配置文件(Profile)选择默认(Default)或一个应用。

编辑位置

选择一个位置,然后选择它的操作、图标和可选标签。

绑定触发操作

将显示操作环(Show Actions Ring)分配给受支持的鼠标控件或键盘键。

编辑器下方,Show ring on button press 可为此设备打开或关闭操作环。操作环大小(Ring size)设置其大小。设备支持触觉时,还会显示触觉反馈(Haptic feedback)。

操作环编辑器,包含槽位编辑与环大小设置

操作环标签页,底部为环大小。

操作环大小

操作环大小(Ring size)提供小(Small)、中(Medium)和大(Large)。默认为中。大小属于设备,适用于该设备的所有布局。

小是更紧凑的操作环,适合几乎不移动鼠标的手。大是更宽的操作环,位置也更大。中心区域(不会选中任何位置的范围)随操作环一起变大。

大小位置到中心的距离位置大小中心区域半径
小62 pt36 pt20 pt
中76 pt44 pt24 pt
大96 pt54 pt28 pt

小、中、大三种尺寸的操作环

小、中、大。

位置

每个非空位置保存一个操作、一个可选自定义图标和一个可选文字标签。 选择清除位置(Clear slot)会删除整个条目。省略条目即为空位置。

编辑器禁止在位置中使用显示操作环(Show Actions Ring)和 None。 前者会递归打开操作环。后者不表示空位置。

位置默认操作
TopCut
TopRightCopy
RightPaste
BottomRightBrowserForward
BottomPlayPause
BottomLeftBrowserBack
LeftUndo
TopLeftRedo

使用图标(Icon)中的使用操作图标(Use action icon)可保留操作自带图标, 也可以选择自定义图标。悬停位置时,自定义标签会按原文显示。

额外的通用图标包括:

  • 文件夹(Folder)、文件(File)、地球(Globe)和终端(Terminal)
  • 星标(Star)、心形(Heart)、日历(Calendar)和铃铛(Bell)
  • 用户(User)、调色板(Palette)和书籍(Book)

只有设备上报触觉支持时,才会显示触觉反馈(Haptic feedback)开关。 启用后,悬停或激活非空位置时,OpenLogi 会请求触觉反馈。

编辑器还提供以下高级功能(Power User)操作:

  • 输入文本(Type Text)
  • 仅 macOS 提供的运行 AppleScript(Run AppleScript)
  • 运行 Shell 命令(Run Shell Command)

操作环编辑器不提供工作流(Workflow)。工作流仍可在键盘编辑器中使用。

按应用布局

使用配置文件(Profile)编辑默认(Default)布局或应用布局。 未保存布局的应用会显示默认布局。首次编辑位置时,OpenLogi 会将默认布局复制为该应用的布局。

运行时由前台应用选择布局。在编辑器中选择应用不会改变前台应用。删除应用的操作环布局不会删除该应用的按键覆盖。

应用布局会替换默认布局。应用需要的每个位置都必须列出;未列出的位置为空。

在配置中

操作环设置位于 config.toml 的 [devices.<key>.action_ring] 下。action_ring.per_app 与按键配置文件使用相同的 应用选择器,包括 Windows 的 exe:<name>.exe 和 app:<alias> 键。选择器行为见 按应用配置,完整参考见配置。

schema_version = 11

[devices."unit:6be9d300".action_ring]
enabled = true
haptics = true
size = "medium"  # "small"、"medium" 或 "large"

[devices."unit:6be9d300".action_ring.default.slots]
Top = { action = "Copy" }
Right = { action = "Paste", icon = "Keyboard", label = "Paste plain text" }

# 此布局会替换默认布局。未列出的位置为空。
[devices."unit:6be9d300".action_ring.per_app."com.google.Chrome".slots]
Top = { action = "Paste" }

平台行为

OpenLogi 会在包含指针的显示器上打开操作环。在 Wayland 上,OpenLogi 会为每个显示器创建一个覆盖全屏的窗口,并在指针位置绘制操作环。Windows 可在混合 DPI 显示器上正确定位操作环。

**状态:**macOS、Linux 和 Windows 均可用。触觉反馈需要设备提供 0x19b0 hapticFeedback。仅 macOS 支持点击外部关闭。

本页目录