Allegro5在MacOS高分辨率显示器下的鼠标坐标问题分析

问题背景

在MacOS平台上使用Allegro5游戏开发库时，开发者发现当应用程序运行在高分辨率显示模式下（NSHighResolutionCapable设置为true），调用al_set_mouse_xy()函数设置鼠标位置会出现坐标值被减半的现象。这导致鼠标无法精确定位到预期的屏幕位置，影响了游戏或应用程序的用户体验。

问题现象

当应用程序启用高分辨率模式时：

• 调用al_set_mouse_xy(100, 100)实际将鼠标移动到(50, 50)位置
• 同时产生的事件中也包含减半后的坐标值(50, 50)
• 使用al_draw_pixel(100, 100)绘制的像素点与鼠标实际位置不匹配

而当禁用高分辨率模式（NSHighResolutionCapable设为false）时，鼠标坐标表现正常。

技术分析

这个问题源于Allegro5在MacOS平台上的鼠标坐标处理逻辑。在源代码中，Allegro5尝试通过获取显示器的缩放因子来调整鼠标坐标：

// 获取显示缩放因子
CGFloat scale = 1.0f;
if (floor(NSAppKitVersionNumber) > NSAppKitVersionNumber10_6) {
    scale = [[NSScreen mainScreen] backingScaleFactor];
}
// 应用缩放因子调整坐标
point.x /= scale;
point.y /= scale;

然而，实际上MacOS的核心图形服务CGDisplayMoveCursorToPoint()函数已经自动处理了高分辨率显示器的坐标转换。这意味着Allegro5的双重缩放导致了坐标值被错误地减半。

解决方案

经过测试验证，简单地移除上述坐标缩放代码可以解决问题。修改后：

• 在高分辨率模式下，鼠标坐标表现正常
• 在普通分辨率模式下，鼠标坐标同样表现正常
• 鼠标位置与绘制的像素点能够精确对齐

这表明CGDisplayMoveCursorToPoint()函数内部已经包含了必要的坐标转换逻辑，不需要额外的缩放处理。

对开发者的建议

对于使用Allegro5开发MacOS应用程序的开发者，如果遇到类似问题，可以：

1. 检查当前使用的Allegro5版本是否包含此修复
2. 如果使用较旧版本，可以考虑手动应用此修改
3. 在跨平台开发时，注意不同操作系统下高分辨率处理的差异
4. 测试时应该同时验证高分辨率和普通分辨率模式下的表现

这个问题也提醒我们，在处理高分辨率显示时，需要充分了解各平台API的行为差异，避免重复转换导致的问题。

总结

Allegro5在MacOS平台上的鼠标坐标处理存在一个高分辨率显示模式下的缩放问题，这是由于对系统API行为的误解导致的。理解系统API的底层行为对于开发跨平台图形应用程序至关重要，可以避免类似的双重转换问题。这个问题也展示了在适配高分辨率显示器时需要考虑的各种因素。