DockDoor多屏环境下窗口预览尺寸异常问题分析与修复

DockDoor多屏环境下窗口预览尺寸异常问题分析与修复

DockDoor Window peeking for macOS 项目地址: https://gitcode.com/gh_mirrors/do/DockDoor

在多显示器工作环境中，macOS应用DockDoor在1.2.0版本出现了一个影响用户体验的显示问题：当应用程序窗口位于非主显示器时，其预览图像的尺寸会出现异常。本文将深入分析该问题的技术原理和解决方案。

问题现象

当用户使用多个显示器（如三屏配置）时，DockDoor对非主显示器上窗口的预览会出现尺寸不匹配现象。具体表现为：

1. 预览窗口框架尺寸正确
2. 但内部预览内容明显缩小
3. 导致预览图像与窗口框架不对齐

技术背景

macOS的多显示器处理机制中，每个显示器都有自己的坐标空间和缩放因子。窗口管理系统需要正确处理：

• 显示器间的DPI差异
• 不同的缩放比例设置
• 跨显示器窗口位置计算

问题根源

通过分析发现，问题出在窗口截图获取逻辑中：

1. 系统API返回的窗口尺寸未考虑目标显示器的缩放因子
2. 截图时未进行正确的坐标空间转换
3. 导致生成的预览图像与实际的窗口尺寸比例不一致

解决方案

开发团队在v1.2.1版本中修复了该问题，主要改进包括：

1. 获取窗口所在显示器的缩放因子
2. 对截图尺寸进行正确的比例换算
3. 确保预览图像与窗口框架保持1:1对应关系

用户建议

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

1. 始终使用[NSWindow screen]获取窗口所在显示器
2. 注意NSScreen的backingScaleFactor属性
3. 进行截图操作前确保坐标系统转换正确

该修复体现了DockDoor团队对多显示器工作场景的重视，确保了用户在不同显示器配置下都能获得一致的预览体验。

DockDoor Window peeking for macOS 项目地址: https://gitcode.com/gh_mirrors/do/DockDoor