lolPing如何画出一个透明置顶轮盘:多显示器坐标与任务栏规避技巧
lolPing如何画出一个透明置顶轮盘:多显示器坐标与任务栏规避技巧
lolPing 是一个把《英雄联盟》的 ping 轮盘搬到整个 Windows 桌面的开源工具:按住 Alt 拖动,就能在任意显示器上画出一个透明、置顶、不抢焦点的 ping 轮盘。这篇文章带你拆解它的核心实现——一个 8 扇区的 SVG 轮盘如何"凭空"出现、多显示器的鼠标坐标如何在三层坐标系之间精确换算,以及它如何用 1 个 DIP 的留白巧妙避开任务栏的判定机制。
透明置顶轮盘:一个 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:
sector()函数(src/renderer/overlay/wheel.ts#L15-L21)用两条半径加两段圆弧A命令,切出一个 45° 的环形扇区;- 全部尺寸来自 src/shared/geometry.ts#L2 的常量
WHEEL = { innerR: 86, outerR: 188, extR: 288, ... },8 个图标均匀分布在半径 137 的圆环上; - 悬停判断同样靠几何:
pickSlice()(src/shared/geometry.ts#L9-L13)把鼠标相对轮盘中心的偏移转成角度,除以 45° 就得到扇区编号,落在innerR以内则返回-1(中心是"死区",松开即取消)。
轮盘打开时只是一次 left/top 定位加一个 0.12 秒的淡入缩放动画(src/renderer/overlay/overlay.css#L5-L9),整个轮盘始终只有一份 SVG,靠坐标移动跟随鼠标。
多显示器坐标:物理像素 → DIP → 窗口局部 三步换算
按住 Alt 后,鼠标事件由底层 hook helper 捕获,此时拿到的是物理像素的全局坐标。但 Electron 窗口工作在 DIP(逻辑像素),而 ping 又要画在某个显示器的窗口局部坐标里。这三次换算全部在 src/main/coords.ts 完成:
- 找显示器:
displayAtPhysical()先看坐标落在哪块屏的phys矩形内,不在任何屏上就取最近的一块,保证坐标永不"失踪"; - 物理像素 → DIP:
physicalToDip()(src/main/coords.ts#L37-L41)按该屏的缩放比例换算,例如 150% 缩放的副屏上物理坐标 (3740, 150) 会变成 DIP (3640, 100); - 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
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 留白"的组合,几乎是可以直接套用的完整模板。


