LibreCAD中鼠标坐标偏移问题的技术分析与解决方案

问题背景

在LibreCAD的QT6版本中，开发人员发现了一个与鼠标坐标处理相关的异常现象。当用户进行绘图操作时，如创建线条起点或设置相对零点，实际创建的图形元素位置与鼠标点击位置存在明显偏移。这种偏移在X轴方向为正偏移，Y轴方向为负偏移，且偏移量在不同缩放级别下保持相同的像素值。

问题现象

1. 实体捕捉异常：在平行线命令中，原始线条的捕捉成功率取决于鼠标移动方向。从线条一侧移动鼠标时能正确捕捉，而从另一侧移动则无法捕捉。

2. 定位精度问题：当用户尝试设置相对零点或绘制线条起点时，实际创建的图形元素位置与鼠标点击位置不一致，存在固定像素值的偏移。

技术分析

经过深入调查，发现问题根源在于QCursor的焦点设置。在LibreCAD中，使用了自定义的鼠标光标图像，这些图像的焦点本应位于光标中心位置。

在QT6版本中，QCursor构造函数的hotX/Y参数行为发生了变化：

• 在QT5及更早版本中，默认行为是将焦点置于光标图像中心
• 在QT6中，如果不显式设置hotX/Y=-1，焦点会被默认置于光标图像的右下角

这种焦点位置的差异导致了鼠标坐标系统与实际绘图坐标系统之间的映射出现偏差。当用户点击屏幕时，系统使用的是焦点位置作为坐标参考点，而LibreCAD的绘图逻辑期望的是光标中心作为参考点，从而产生了固定的像素级偏移。

解决方案

开发团队通过以下修改解决了该问题：

1. 在创建自定义光标时，明确设置hotX/Y参数为-1，强制QT6使用光标图像中心作为焦点
2. 确保所有自定义光标的焦点位置与LibreCAD的坐标处理逻辑保持一致

这一修改确保了鼠标事件坐标与绘图坐标系统的正确映射，消除了定位偏差问题。

技术影响

该问题的解决不仅修复了直接的坐标偏移问题，还对以下方面产生了积极影响：

1. 绘图精度：用户现在可以精确地在预期位置创建图形元素
2. 用户体验：实体捕捉功能变得更加可靠和一致
3. 跨版本兼容性：确保了LibreCAD在不同QT版本间的行为一致性

结论

这个案例展示了底层GUI框架升级可能带来的微妙但重要的行为变化。LibreCAD开发团队通过深入分析鼠标坐标处理流程，准确识别并修复了QT6特有的光标焦点处理问题，为软件的稳定性和精确性提供了保障。这也提醒开发者，在跨版本升级时，需要特别关注看似简单的UI元素可能带来的连锁反应。