GlazeWM多显示器DPI缩放场景下的外间距适配问题解析

在现代化多显示器工作环境中，不同DPI缩放比例的显示器并存已成为常态。GlazeWM窗口管理器在v3.4.0版本中针对这一场景做出了重要改进，特别是解决了外间距(outer_gap)在多显示器环境下的适配问题。

问题背景

当用户使用不同DPI缩放比例的显示器组合时（例如4K显示器设置200%缩放与1080p显示器100%缩放组合），窗口管理器的像素级参数会出现显示不一致的情况。具体表现为：

1. 外间距参数在不同显示器上呈现不同物理尺寸
2. 高DPI显示器上的间距看起来比预期更小
3. 低DPI显示器上的间距看起来异常放大

这种现象源于系统对高DPI显示器的虚拟像素与实际物理像素的转换机制。传统窗口管理器若未考虑DPI缩放因子，就会导致布局参数在不同显示器上产生视觉差异。

技术原理

现代操作系统采用虚拟像素机制处理高DPI显示器：

• 系统为每个显示器维护独立的DPI缩放因子(scale_factor)
• 应用程序接收的是经过缩放的虚拟像素坐标
• 实际渲染时需要将虚拟像素乘以缩放因子得到物理像素

GlazeWM原有的外间距实现直接使用配置的像素值，未考虑显示器特定的缩放因子，导致：

• 高DPI显示器：外间距 = 配置值 / scale_factor → 实际显示过小
• 低DPI显示器：外间距 = 配置值 → 保持原样

解决方案

v3.4.0版本引入的gaps.scale_with_dpi配置项提供了两种工作模式：

1. 缩放模式(默认开启)

   • 外间距值会自动乘以显示器缩放因子
   • 公式：物理间距 = 配置间距 × scale_factor
   • 确保不同显示器上获得相同的物理尺寸效果

2. 传统模式(关闭选项)

   • 保持原有行为，使用配置的像素值直接作为虚拟像素
   • 适用于需要保持绝对像素精度的特殊场景

最佳实践建议

对于多显示器用户，建议采用以下配置策略：

gaps:
  scale_with_dpi: true  # 启用DPI感知缩放
  outer_gap: 60        # 这个值将在不同显示器上自动适配

注意事项：

• 此功能需要配合支持DPI感知的组件（如zebar状态栏）使用
• 混合DPI环境下建议先在主显示器上调试间距效果
• 对于特殊布局需求，可针对特定显示器设置独立的外间距值

版本兼容性说明

该功能自v3.4.0版本开始提供，旧版本用户如需此功能建议升级。对于无法升级的环境，可通过手动计算不同显示器的间距值来实现近似效果，但维护成本较高。

通过这一改进，GlazeWM在多显示器工作环境下的视觉一致性得到了显著提升，使窗口管理器的布局参数能够真正实现"一次配置，多屏适用"的理想效果。