hypr-dynamic-cursors 性能实测指南:硬件光标 vs 软件光标的代价与 NVIDIA 自动回退机制
hypr-dynamic-cursors 性能实测指南:硬件光标 vs 软件光标的代价与 NVIDIA 自动回退机制
hypr-dynamic-cursors 是 Hyprland 的一款光标插件:它把光标模拟成一个真实物体,移动时光标会 tilt(倾斜)、rotate(旋转)或 stretch(拉伸),并支持 shake to find(抖动放大查找光标)。本文不讲花哨效果,只回答一个问题——这套动态光标对性能到底有什么代价,以及 NVIDIA 用户为什么会被自动切到软件光标。
一、原理速览:光标是在哪里画出来的
理解性能之前,先要知道 Wayland 下光标有两条渲染路径,而插件通过 src/main.cpp 里的函数钩子(function hooks) 接管了其中全部关键函数:
renderSoftwareCursorsFor→ 插件重实现为 renderSoftware,把旋转/拉伸变换塞进本来就存在的绘制调用里;renderHWCursorBuffer→ 插件重实现为 renderHardware,每帧把带变换的光标画进硬件光标的独立 buffer;onCursorMoved/damageIfSoftware等也各有一个钩子,负责计算角度和标记脏区。
插件内部还有一个按最高刷新率显示器帧时间自适应的 tick 定时器(见 tickRaw),光标静止时几乎不干活,所有开销都发生在"光标在动"的时候。
⚠️ 由于依赖 Hyprland 的 function hooks,插件只在 x86_64 上真正生效,其他架构下可加载但不做事。
二、硬件光标的代价:中等开销,"相当于一个动画光标"
硬件光标由显示控制器的独立平面显示,优点是几乎不占合成器帧时间。但它的致命点是——形状是固定的:想改变光标外观,就得往 cursor buffer 里重画并整块提交。
而动态光标要"平滑地转",就必须频繁换形状。作者的说法很直白:性能约等于"每次移动鼠标时显示一个动画光标形状"。具体代价体现在 renderHardware 中:
- 每次角度越过阈值,就要创建/复用一条三缓冲的 cursor swapchain(
options.length = 3),渲染一帧再setCursor提交给 KMS; - 阈值由
threshold控制(默认 2°):值越小转动越丝滑,但硬件光标换形越频繁,开销越高,这是一个典型的"顺滑度 vs 性能"滑杆。
另外硬件光标平面有尺寸上限(output->cursorPlaneSize(),见 cursor.cpp#L185-L200),超过就自动退回软件路径——这正是放大功能必须牺牲硬件光标的根源,下一节细说。
三、软件光标:插件的额外开销近乎为零
如果你本身就使用软件光标,那么好消息是:这个插件几乎没有额外性能影响。
原因见 renderSoftware:旋转不是重新画一遍,而是通过 toTransform 生成一个 3×3 变换矩阵,直接乘进本来就存在的绘制调用的投影矩阵里,多出来的只是一次矩阵运算。
配套的脏区处理也做了优化:damageSoftware 会按光标尺寸的对角线向外扩展脏区,一次性覆盖所有旋转角度,避免旋转过程中反复触发整屏重绘。
📌 注意:软件光标"本身"并不高效(每次移动都要进合成器帧缓冲),所以如果你的机器配置较高,硬件光标 + 大一点
threshold通常是更优解。
四、shake to find 放大瞬间:自动切换软件光标
抖动放大是本插件最实用的功能,检测算法灵感来自 KDE Plasma:保留 1 秒的位置采样历史,用"总路程 / 运动包围盒对角线"衡量抖动强度(见 Shake.cpp#L35-L88)。
一旦开始放大,代码里发生的事很关键(cursor.cpp#L439-L453):
- 放大倍率
scale > 1时,调用lockSoftwareAll()锁定软件光标,硬件光标立刻失效; - 放大结束、倍率回到 1 后,自动
unlockSoftwareAll()解锁,交还硬件光标。
为什么必须这样?因为硬件光标平面尺寸有限,放大 4 倍的光标大概率超出上限。所以你会观察到:放大的那 2 秒(默认 timeout = 2000 ms),合成器临时用软件光标绘制。这是设计使然,不是 bug。
顺带一提:高分辨率 hyprcursor 主题是在独立线程异步加载的(highres.cpp#L74-L95),会话不会卡死,但加载期间 CPU 会短暂抬头,且高清晰度要等一两秒才可用。
五、NVIDIA 自动回退机制:为什么必须放弃硬件光标
这是 NVIDIA 用户最关心的部分。机制与原因如下(详见 README.md):
- 驱动限制:NVIDIA 驱动下,Hyprland 只能用 CPU 往硬件光标的 buffer 里画图;
- 代价爆炸:动态光标在光标移动时可能每帧都往该 buffer 画一次,放在 CPU 上执行极其昂贵;
- 实现成本:要让 CPU 绘制路径工作,整套绘制逻辑还得为 CPU 重新实现一遍。
所以插件在 NVIDIA GPU 上会自动强制合成器使用软件光标,以一点小性能代价换掉上述两个大坑。对你来说这意味着:
- NVIDIA 用户不需要做任何配置,加载插件即自动回退;
- 回退后的体验 ≈ 上面的"软件光标路径",日常移动几乎没有额外开销,只有放大瞬间与软件光标本底开销存在。
六、动手实测:hw_debug 开关与三个调优参数
插件内置了硬件光标调试开关,实测时非常有用:
if hl.plugin.dynamic_cursors then
hl.config { plugin = { dynamic_cursors = {
hw_debug = true, -- 显示整个光标 buffer 的位置与每次更新
threshold = 2, -- 角度阈值:越小越顺滑,hw 光标开销越高
mode = "tilt",
}}}
end
hw_debug = true:屏幕上会标出硬件光标 buffer 的完整区域,每次 buffer 更新时可视化,直接"肉眼看"提交频率(cursor.cpp#L265-L268);threshold:把 2° 调到 4~5° 可以明显降低硬件光换形频率,肉眼观感损失很小;tilt.window/stretch.window:速度采样窗口,调大(如 150 ms)让慢速移动更平滑,但会增加迟滞感。
💡 在嵌套 Hyprland 会话里实测时,如果插件"没反应",把 ignore_warps 设为 false 即可(嵌套会话的鼠标输入处理方式不同)。
七、性能结论速查表
| 场景 | 额外开销 | 说明 |
|---|---|---|
| 软件光标 + 效果 | ⭐ 近乎零 | 变换并入既有绘制调用 |
| 硬件光标 + 效果 | ⭐⭐ 中等 | 相当于移动中显示动画光标 |
| 放大(shake to find) | ⭐⭐ 中等 | 自动临时锁定软件光标,超时后恢复 |
| NVIDIA GPU | 自动回退软件光标 | 规避 CPU 逐帧绘制硬件 buffer 的昂贵路径 |
| hyprcursor 高分辨率加载 | 一次性 | 独立线程异步加载,期间 CPU 短暂升高 |
一句话总结:Amd/Intel 硬件光标用户付出的是"动画光标级"的中等开销且可用 threshold 微调;NVIDIA 用户被自动切到软件光标路径,反而几乎零额外代价——这套设计把每一类硬件上的最坏情况都堵住了。
想深入了解配置项与形状规则,参考 README.md 的配置章节,源码入口在 src/cursor.cpp 与 src/config/ConfigManager.cpp。