OpenLogi

滚动

配置应用级滚轮处理、每设备主滚轮控件、惯性滚动、拇指滚轮预设,以及按住时水平滚动。

OpenLogi 将应用级滚轮处理与每只鼠标的滚轮设置分开。 在设置(Settings)→通用(General)中调整主机侧控件。 在鼠标的指针(Pointer)标签页中调整与当前连接相关的控件。 棘轮与自由滚动模式见 SmartShift。

应用级滚轮设置

平滑滚动(Smooth scrolling)会将符合条件的传统鼠标滚轮刻度替换为有限时长的缓动滚动。 它默认关闭。 连续触控板输入保持原生处理。

垂直滚动灵敏度(Vertical Scroll Sensitivity)会将传统垂直滚轮距离缩放到 1~100 的范围。 默认值 14 为 1×。 它不会缩放触控板输入。

拇指滚轮灵敏度(Thumb Wheel Sensitivity)使用相同的 1~100 范围。 默认值 14 为 1×。 它设置拇指滚轮滚动速度和离散动作阈值的应用级默认值。 设备可以在配置中覆盖此值。

每设备主滚轮

选中鼠标并打开指针(Pointer)标签页。 下列控件取决于当前连接的滚轮能力。

  • 反转滚动方向(Invert scroll direction)会反转这只鼠标的垂直滚轮方向。 触控板保持系统滚动方向。 如果滚轮报告原生 HID++ 反转能力,OpenLogi 会使用该模式。 否则,OpenLogi 会在捕获滚轮事件时反转方向。
  • 滚轮分辨率(Wheel resolution)提供设备默认值(Device default)、标准(Standard)和高分辨率(High resolution)。 设备默认值不会更改滚轮。 标准会在每个物理棘轮刻度滚动一次。 高分辨率会检测棘轮刻度之间的移动。
  • 平滑滚轮(Smooth wheel)是带 HID++ 0x2121 主滚轮的每设备开关。 OpenLogi 会转移每个滚轮报告,并输出缓动滚动。 即使关闭平滑滚动,此开关仍会生效。 输出仍会使用这只鼠标的反转设置和垂直滚动灵敏度。

平滑滚轮需要输入钩子访问权限和 capture_mouse_events = true。 在 macOS 上,钩子还需要辅助功能访问权限。 如果任一条件不满足,滚轮会保持原生处理。

关闭平滑滚轮、禁用鼠标或退出代理时,OpenLogi 会将滚轮恢复为原生上报。 如果代理先停止,滚轮会保持转移状态,直到代理再次运行或鼠标重连。 鼠标重连会取消转移。

当前连接报告 0x2121 时,才会显示平滑滚轮卡片。 如果其他连接已启用该功能,当前连接会显示其他连接状态。 你可以在这里关闭它,但不能在当前连接没有 0x2121 时启用它。

惯性滚动

惯性滚动(Momentum scrolling)让页面在滚轮自由滚动后继续滑动。 它只对开启了平滑滚轮的鼠标生效。 当 SmartShift 让滚轮自由滚动时,页面按你拨动滚轮的速度滑出。 滑动逐渐减速,你触碰滚轮时立即停止。 棘轮滚动仍然逐格滚动。 它默认关闭。 OpenLogi 只在 macOS 上测试过此功能。

在设置(Settings)→通用(General)中设置所有鼠标的默认值。 这张卡片还会显示有几只鼠标单独设置。 在鼠标的指针(Pointer)标签页中为这只鼠标单独设置。 那里的卡片会说明这只鼠标是否使用设置→通用中的设置。 使用通用设置(Use General settings)会删除这只鼠标的单独设置。 与设置→通用相同的设置也会删除单独设置。

在指针标签页中,开启自由滚动时惯性滑动(Glide on free spin)时,会询问是否同时开启平滑滚轮。 惯性滑动开启时关闭平滑滚轮,会询问是否同时关闭两者。 这两个对话框只修改当前选中的鼠标。

控件作用配置键
自由滚动时惯性滑动(Glide on free spin)开启惯性滚动。enabled
每格距离(Distance per notch)设置滚轮每格滚动的距离,范围为 10 至 60 参考像素,默认值 28。它也决定拨动滚轮时滑动的起始速度。pixels_per_notch
滑动曲线(Glide shape)可选锐利(Sharp)、线性(Linear)、平滑(Smooth,默认)或飘逸(Floaty)。每种曲线滑动的距离相同。越平滑的曲线越早减速,尾段越长。glide_shape
最大滑动速度(Max glide speed)设置一次拨动能达到的最快滑动速度,范围为 2000 至 15000 px/s,默认值 8000。max_glide_speed
滑动长度(Glide length)设置滑动的时间常数,范围为 150 至 1200 ms,默认值 400。glide_ms
重复加速(Repeat speed-up)每次朝同一方向再次拨动时,滑动速度乘以这个百分比,最多达到最大滑动速度的 3 倍。范围为 100 至 200,默认值 135。100 表示关闭。repeat_boost

恢复默认值(Reset to defaults)会恢复所有滑块和曲线,不改变开关。 macOS 接收像素事件。 Windows 和 Linux 按默认距离缩放原生滚轮刻度,因此应用程序可能改变最终距离。

拇指滚轮

受支持的拇指滚轮(Thumb Wheel)使用 HID++ 0x2150。 两个方向保存为 ThumbwheelScrollUp 和 ThumbwheelScrollDown 绑定。 灵敏度不是 14,或任一方向偏离原生绑定时,OpenLogi 会转移拇指滚轮。

GUI 会将下列精确方向组合识别为预设:

  • 后退/前进、撤销/重做、浏览器后退/前进和上一个/下一个标签页。
  • 上一个/下一个桌面、下一个/上一个桌面和上一首/下一首。
  • 增大/减小音量、减小/增大音量和循环灵敏度预设。
  • 垂直滚动、垂直滚动(反向)、水平滚动和水平滚动(反向)。

减小/增大音量会反转增大/减小音量。 水平滚动保持原生方向,且不会转移滚轮。 **水平滚动(反向)**会交换方向并转移滚轮。 一次拇指滚轮滑动可以多次触发离散动作,包括音量更改。

关闭平滑滚动时,已转移的横向拇指滚轮输入仍会作为带阶段的手势输出。 最后一个刻度后 120 ms,该手势结束。 这使依赖横向滑动阶段的应用保持响应。

Thumbwheel 是电容轻点报告,而不是机械点击。 它的默认动作是不执行任何操作(Do Nothing)。 GUI 不提供该控件,因为无意的拇指接触也可能产生轻点。 只有接受这种行为时,才在配置中绑定它。

按住时水平滚动

在没有拇指滚轮的鼠标上,按住后退(Back)或前进(Forward)并转动主滚轮。 按住期间,主滚轮成为虚拟横向拇指滚轮。 向远离你的方向转动时向左滚动,向靠近你的方向转动时向右滚动。 反转滚动方向会反转这些方向。

未转动滚轮就松开按键时,会执行按钮的 click 动作。 转动过滚轮的按压不会执行其他动作。 只有添加滚轮按住绑定后,此功能才会启用。

滚轮按住需要通过 HID++ 0x1b04 为该按钮提供原始滚轮上报。 只有部分固件提供此能力。 它还需要鼠标钩子和 capture_mouse_events = true。 在 macOS 上,这意味着需要辅助功能访问权限。

没有原始滚轮上报或鼠标钩子时,OpenLogi 只捕获按钮的 click 动作。 主滚轮保持原生处理。 关闭鼠标捕获时,按钮保留原生功能。

绑定改变、鼠标断开连接或代理退出时,OpenLogi 会将按钮和滚轮交还给固件。 OpenLogi 不会设置固件的持久标志。 设备断电重启也会清除转移状态。

在默认配置档中,选择后退(Back)或前进(Forward),然后启用按住时水平滚动(Hold to scroll sideways)。 只有按钮报告原始滚轮支持时,才会显示该开关。 沿用的绑定仍会在不受支持的鼠标上显示,因此你可以关闭它。 更改按钮动作会保留滚轮按住设置,并更改 click。

在手势按钮上启用滚轮按住会退出手势模式,并保留手势映射的点击(Click)动作。 再次启用手势会恢复保存的手势方向。 滚轮按住按设备设置,不按应用设置。 应用配置档为该按钮指定动作后,会在该应用中替换滚轮按住设置。

在配置中

下例组合应用级滚动处理、每设备滚轮控件、惯性滚动、拇指滚轮绑定和 Back 滚轮按住设置。 设备的 momentum_scrolling 表是一份完整的设置。 表中省略的键取默认值,不取设置→通用中的值。 完整参考见配置。

schema_version = 9

[app_settings]
capture_mouse_events = true
smooth_scroll = true
vertical_scroll_sensitivity = 20  # 1~100;14 为 1×。
thumbwheel_sensitivity = 14       # 应用级拇指滚轮默认值。

[app_settings.momentum_scrolling]
enabled = true
glide_shape = "smooth"            # "sharp"、"linear"、"smooth" 或 "floaty"。

[devices."unit:6be9d300"]
invert_scroll = true
scroll_resolution = "high"        # "low"、"high",省略则为设备默认值。
smooth_wheel = true
thumbwheel_sensitivity = 30       # 每设备覆盖值。

[devices."unit:6be9d300".bindings]
ThumbwheelScrollUp = "HorizontalScrollLeft"
ThumbwheelScrollDown = "HorizontalScrollRight"
Back = { click = "BrowserBack", wheel = "HorizontalScroll" }

[devices."unit:6be9d300".momentum_scrolling]
enabled = true
glide_ms = 600                    # 这只鼠标滑动得更久。

**状态:**macOS、Linux 和 Windows。每设备控件需要当前连接提供对应的设备能力。协议细节见 0x2121 hiResWheel、0x2150 thumbwheel 和 0x1b04 specialKeysMSEButtons。

本页目录