Xournal++在Wayland下缩放比例不为1时的光标偏移问题分析

问题现象

Xournal++手写笔记软件在Wayland显示协议环境下运行时，当系统缩放比例设置为1.25等非1值时，出现了手写笔输入位置与实际显示位置不匹配的问题。具体表现为：用户使用数位笔进行书写时，墨水痕迹会出现在距离光标实际位置有一定偏移的位置上。

环境特征

该问题最初在Hyprland合成器环境下被发现，具有以下典型特征：

1. 仅在Wayland协议下出现
2. 缩放比例为1时表现正常
3. 影响版本包括Xournal++ 1.2.3开发版
4. 使用GTK3 3.24.42图形库

技术分析

经过深入排查，发现该问题具有以下技术特点：

1. 显示协议特异性：在Plasma Wayland环境下无法复现，表明问题与特定合成器实现相关
2. 输入子系统行为：通过gtk3-demo测试工具验证，基础绘图功能坐标正确，说明GTK3层输入事件处理正常
3. 历史兼容性：早期Hyprland 0.38版本曾正常工作，但后续出现异常

根本原因

问题最终定位到Hyprland合成器在处理高DPI缩放时的坐标转换逻辑存在缺陷。Wayland协议要求客户端和合成器共同处理显示缩放，而Hyprland在特定版本中对非整数缩放系数的处理不够完善，导致传递给应用程序的输入坐标未正确考虑缩放因素。

解决方案

该问题已在Hyprland后续版本中得到修复。用户可采取以下措施：

1. 升级Hyprland到最新稳定版本
2. 临时将系统缩放比例设置为1
3. 考虑使用其他经过验证的Wayland合成器（如Plasma Wayland）

技术启示

此案例揭示了Wayland生态系统中一个重要问题：不同合成器实现对于高DPI支持存在差异。应用开发者需要注意：

1. 正确处理Wayland下的缩放因子通知
2. 实现完整的HiDPI支持路径
3. 针对不同合成器进行兼容性测试

对于数位板用户，建议在Wayland环境下优先选择经过充分验证的桌面环境组合，以确保最佳的手写输入体验。