Goxel在Wayland环境下光标位置偏移问题的分析与解决

Goxel是一款优秀的3D建模软件，但在Linux系统的Wayland环境下（特别是使用Sway窗口管理器时），当显示器缩放比例不为1.0时，会出现光标位置与实际绘制位置不匹配的问题。本文将深入分析这一问题的成因及解决方案。

问题现象

在Wayland环境下，当设置显示器缩放比例为1.5或更高时，用户会观察到：

• 3D立方体的绘制位置明显偏离实际鼠标光标位置
• 偏移方向通常向左上方偏移
• 偏移量与缩放比例成正比

技术分析

该问题源于GLFW库在不同平台和显示服务器下的坐标系统处理差异。在macOS和Wayland环境下，GLFW已经对坐标进行了适当的缩放处理，而Goxel代码中额外的坐标缩放操作导致了位置偏移。

具体来说，Goxel原本的代码逻辑是：

1. 获取鼠标坐标(xpos, ypos)
2. 获取显示器缩放比例(scales[0], scales[1])
3. 将坐标除以缩放比例

这种处理方式在X11环境下是正确的，但在Wayland和macOS下会导致双重缩放，从而产生位置偏移。

解决方案

经过开发者社区的讨论和测试，最终解决方案是：

1. 完全移除坐标缩放处理代码
2. 直接使用GLFW提供的原始坐标值

这一修改已通过测试验证，在以下环境中工作正常：

• Sway窗口管理器
• GNOME Wayland
• 多种缩放比例设置(1.5x, 2x等)

技术意义

这个修复不仅解决了Wayland环境下的问题，还统一了不同平台下的坐标处理逻辑，使Goxel在各种显示环境下都能提供一致的用户体验。对于教育领域（如3D打印教学）尤为重要，因为精确的光标位置对于建模教学至关重要。

用户建议

对于使用Goxel 0.14.0或更早版本的用户：

• 可以手动应用此补丁
• 或升级到0.15.0及以上版本

该问题已在Goxel 0.15.0版本中正式修复，建议所有Linux Wayland用户升级到此版本或更高版本以获得最佳体验。