FLTK项目在Wayland下多显示器工具提示位置问题解析

问题背景

FLTK作为一款轻量级的跨平台GUI工具库，在Linux系统下支持X11和Wayland两种显示协议。近期发现，在使用Wayland协议且配置双显示器的情况下，当应用程序窗口位于右侧显示器时，工具提示(Tooltip)的显示位置会出现偏移问题。

问题现象

具体表现为：

1. 在左侧显示器上，工具提示能正常显示在鼠标光标下方
2. 在右侧显示器上，工具提示会出现明显的水平偏移（向右移动）
3. 修复水平偏移后，又发现垂直方向也出现偏移（向下移动）

技术分析

这个问题源于Wayland协议下多显示器坐标处理的一个特殊情况。在Wayland环境中：

1. 多显示器被视为一个统一的虚拟桌面空间
2. 每个显示器都有其在该虚拟空间中的坐标位置
3. 工具提示的定位需要正确考虑显示器在虚拟空间中的偏移量

在原始代码中，工具提示的位置计算没有充分考虑显示器在虚拟空间中的偏移量，特别是当窗口位于非主显示器（如右侧显示器）时，坐标转换出现了偏差。

解决方案

开发团队通过两次提交解决了这个问题：

1. 第一次提交修复了水平方向的偏移问题，通过正确计算显示器在虚拟空间中的X坐标偏移
2. 第二次提交修复了垂直方向的偏移问题，补充了Y坐标偏移的正确计算

关键点在于确保工具提示的位置计算考虑了：

• 当前显示器在虚拟桌面中的起始坐标
• 鼠标在当前窗口中的相对位置
• 显示器之间的坐标转换关系

验证方法

用户可以通过以下步骤验证修复效果：

1. 配置双显示器环境（1920x1080分辨率）
2. 运行FLTK的测试程序（如tree demo）
3. 将窗口分别放置在左右显示器上
4. 悬停鼠标观察工具提示位置是否正确

总结

这个问题展示了跨平台GUI开发中处理多显示器环境的复杂性。FLTK团队通过精确计算显示器在虚拟空间中的坐标偏移，确保了工具提示在各种显示器配置下都能正确定位。这也提醒开发者，在多显示器环境下，GUI元素的定位需要特别考虑显示器间的坐标转换关系。