lolPing如何画出一个透明置顶轮盘:多显示器坐标与任务栏规避技巧

原创2026-10-15 19:14:021,346 阅读

lolPing如何画出一个透明置顶轮盘:多显示器坐标与任务栏规避技巧

lolPing 是一个把《英雄联盟》的 ping 轮盘搬到整个 Windows 桌面的开源工具:按住 Alt 拖动,就能在任意显示器上画出一个透明、置顶、不抢焦点的 ping 轮盘。这篇文章带你拆解它的核心实现——一个 8 扇区的 SVG 轮盘如何"凭空"出现、多显示器的鼠标坐标如何在三层坐标系之间精确换算,以及它如何用 1 个 DIP 的留白巧妙避开任务栏的判定机制。

lolPing透明置顶轮盘悬浮在桌面应用之上,展示ping轮盘与多显示器效果

透明置顶轮盘:一个 BrowserWindow 就能实现

很多工具以为"悬浮窗"需要复杂的 API,其实 lolPing 的核心只靠一个配置好的 Electron BrowserWindow。在 src/main/overlayManager.ts#L204-L239 的 createWindow 中,几个关键参数各司其职:

  • transparent: true + backgroundColor: '#00000000':窗口完全透明,只有绘制的 ping 和轮盘可见;
  • setAlwaysOnTop(true, 'screen-saver'):使用最高层的置顶级别,压在几乎所有应用之上;
  • setIgnoreMouseEvents(true):鼠标点击直接穿透窗口,轮盘只是"画给你看",操作由底层 hook 捕获;
  • focusable: false + showInactive():显示窗口时不抢焦点,游戏和当前输入不会被打断。

macOS 上还会额外设置 type: 'panel' 和 setVisibleOnAllWorkspaces,让轮盘能悬浮在全屏应用之上(src/main/overlayManager.ts#L221-L231)。

轮盘本体:8 个扇区由纯 SVG 拼出

轮盘绘制在 src/renderer/overlay/wheel.ts 中,没有用 Canvas,而是一段运行时生成的 SVG:

  1. sector() 函数(src/renderer/overlay/wheel.ts#L15-L21)用两条半径加两段圆弧 A 命令,切出一个 45° 的环形扇区;
  2. 全部尺寸来自 src/shared/geometry.ts#L2 的常量 WHEEL = { innerR: 86, outerR: 188, extR: 288, ... },8 个图标均匀分布在半径 137 的圆环上;
  3. 悬停判断同样靠几何:pickSlice()(src/shared/geometry.ts#L9-L13)把鼠标相对轮盘中心的偏移转成角度,除以 45° 就得到扇区编号,落在 innerR 以内则返回 -1(中心是"死区",松开即取消)。

轮盘打开时只是一次 left/top 定位加一个 0.12 秒的淡入缩放动画(src/renderer/overlay/overlay.css#L5-L9),整个轮盘始终只有一份 SVG,靠坐标移动跟随鼠标。

lolPing多显示器坐标映射演示:在不同屏幕上按住Alt拖动即可打开ping轮盘

多显示器坐标:物理像素 → DIP → 窗口局部 三步换算

按住 Alt 后,鼠标事件由底层 hook helper 捕获,此时拿到的是物理像素的全局坐标。但 Electron 窗口工作在 DIP(逻辑像素),而 ping 又要画在某个显示器的窗口局部坐标里。这三次换算全部在 src/main/coords.ts 完成:

  1. 找显示器:displayAtPhysical() 先看坐标落在哪块屏的 phys 矩形内,不在任何屏上就取最近的一块,保证坐标永不"失踪";
  2. 物理像素 → DIP:physicalToDip()(src/main/coords.ts#L37-L41)按该屏的缩放比例换算,例如 150% 缩放的副屏上物理坐标 (3740, 150) 会变成 DIP (3640, 100);
  3. DIP → 窗口局部:physicalToLocal()(src/main/coords.ts#L44-L50)再减去目标显示器 DIP 原点,得到可以直接画在 overlay 里的 CSS 像素坐标。

其中有个容易忽略的细节:轮盘一旦打开,就锁定在打开它的那块屏上。如果拖到别的显示器再松手,坐标仍按原屏换算(见 tests/main/coords.test.ts#L24-L27 的用例),这样跨屏拖动时轮盘不会被坐标跳变"拽飞"。

房间同步还需要一个稳定的显示器编号:numberDisplays()(src/main/displayNumbers.ts#L12-L16)把主屏定为 #1,其余屏按"先左到右、再上到下"排序编号;ping 在共享给房间前还会被归一化为该屏的相对比例(src/main/displayNumbers.ts#L21-L25),所以不同分辨率的朋友看到的 ping 也落在同一位置。

任务栏规避:为什么窗口底部故意少 1 个 DIP

lolPing设置窗口中的触发键与轮盘配置界面

Windows 上有个隐蔽的判定:当一个可见窗口完整覆盖整块显示器时,Explorer 会认为它是全屏应用——任务栏会被藏到它后面,自动隐藏的任务栏也不会滑出来,甚至影响"全屏游戏中暂停 ping"的判定。

lolPing 的解法极其克制,就一行(src/main/overlayManager.ts#L32-L37):

  • Windows:overlay 窗口高度 = 屏幕高度 − 1 DIP,窗口仍从屏幕左上角 (0, 0) 起算,坐标体系完全不变,只是底边让出 1 个 DIP;
  • macOS:无此问题,窗口完整覆盖 d.bounds。

测试用例直接验证了这一点:两块 1920×1080 / 1280×1024 的屏,Windows 下窗口高度分别变成 1079 和 1023(tests/main/overlayManager.test.ts#L191-L203)。更妙的是,rebuild() 里在窗口 ready-to-show 后还会重新 setBounds 一次,因为混合 DPI 环境下首帧尺寸可能被系统算错(src/main/overlayManager.ts#L233-L236)。完整的推理过程写在 docs/design.md#L179 中。

总结:三个关键设计点

技巧 实现位置 一句话原理
透明置顶轮盘 src/main/overlayManager.ts#L204-L239 透明 + screen-saver 置顶 + 鼠标穿透 + 不抢焦点
多显示器坐标换算 src/main/coords.ts 物理像素 → DIP → 窗口局部,三步换算且轮盘锁定打开时的屏
任务栏规避 src/main/overlayManager.ts#L36-L37 Windows 下窗口底部让出 1 DIP,骗过 Explorer 的全屏判定

想自己动手画一个桌面悬浮轮盘,这套"透明窗口 + SVG 扇区 + 三层坐标换算 + 1 DIP 留白"的组合,几乎是可以直接套用的完整模板。

登录后查看全文
lolPing