Pyglet项目窗口全屏切换时位置偏移问题分析

在Pyglet 2.1版本中，Windows平台下存在一个窗口位置偏移的bug：当用户反复切换窗口的全屏和窗口化模式时，窗口会逐渐向左上方偏移。这个问题在2.0.15版本中并不存在，表明这是2.1版本引入的回归问题。

问题现象

当用户通过快捷键反复切换窗口的全屏状态时，每次从全屏返回窗口模式，窗口都会向左上方移动一小段距离。经过多次切换后，窗口可能会完全移出屏幕可见区域。根据开发者测试，每次移动的距离大约等于窗口标题栏和边框的厚度。

技术分析

这个问题主要出现在Windows平台（Win32 API），而在Linux的Wayland+GNOME环境下表现正常。经过代码审查发现，问题源于窗口从全屏模式返回时，系统没有正确恢复窗口的原始位置。

在Pyglet的窗口管理逻辑中，当退出全屏模式时，理论上应该恢复窗口之前的位置和尺寸。但在Windows实现中，系统似乎没有正确处理位置信息，导致每次切换都会产生累积偏移。

解决方案

针对Windows平台的修复方案已经提交，核心思路是：

1. 在进入全屏模式前，精确记录窗口的原始位置
2. 退出全屏模式时，主动设置窗口位置而非依赖系统自动恢复
3. 确保位置计算考虑了窗口边框和标题栏的尺寸

这个修复已经在Windows 10环境下验证有效。对于Linux平台，由于不同桌面环境的行为差异，可能需要单独的修复方案。

开发者建议

对于遇到类似问题的开发者，建议：

1. 升级到包含修复的Pyglet版本
2. 如果必须使用2.1版本，可以考虑自行实现窗口位置记忆逻辑
3. 跨平台开发时，应对不同平台的全屏切换行为进行充分测试

这个问题提醒我们，在实现跨平台图形应用时，窗口管理相关的系统调用需要特别注意平台差异性，特别是涉及全屏切换这类复杂操作时。