KOReader中旋转屏幕时QuickMenu定位异常问题分析

问题背景

KOReader是一款流行的开源电子书阅读软件，在v2024.11版本中，用户报告了一个关于QuickMenu定位的显示问题。当设备屏幕旋转后，通过手势触发的QuickMenu不会出现在手势结束位置，而是固定在硬件定义的边缘位置，这影响了用户的操作体验。

问题现象

在设备默认方向下，QuickMenu能够正确显示在手势结束位置。但当屏幕旋转90度或180度后，QuickMenu的显示位置不再跟随手势的实际结束点，而是固定在设备的物理边缘位置。这种不一致性导致用户在不同屏幕方向下获得不同的交互体验。

技术分析

根据代码提交记录，问题主要出在ges.end_pos参数的获取上。在屏幕旋转情况下：

1. ges.pos（手势起始位置）能够正确获取
2. ges.end_pos（手势结束位置）却无法正确反映旋转后的坐标

这表明在坐标转换处理中存在缺陷，当设备方向改变时，系统没有对结束位置坐标进行适当的旋转矩阵转换。

解决方案

开发团队通过以下方式修复了该问题：

1. 修正了手势结束位置的坐标转换逻辑
2. 确保在不同屏幕方向下都能正确计算QuickMenu的显示位置
3. 保持与手势起始位置处理方式的一致性

修复后，QuickMenu现在能够：

• 在默认方向下保持原有正确行为
• 在旋转屏幕后仍能准确显示在手势结束位置
• 提供一致的用户体验

影响范围

该问题主要影响以下场景：

• 使用手势操作触发QuickMenu的用户
• 经常旋转屏幕方向阅读的用户
• 依赖精确菜单定位的操作流程

总结

KOReader团队快速响应并修复了这个影响用户体验的问题，展示了开源社区的高效协作。这个案例也提醒我们，在处理涉及屏幕旋转的交互时，需要特别注意坐标转换的完整性和一致性，确保在所有方向下都能提供相同的操作体验。