Hyprland 桌面环境中工作区预览缩放问题的分析与解决

在 Hyprland 桌面环境中，当用户启用 XWayland 的 force_zero_scaling 选项并设置非整数 DPI 缩放比例时，工作区预览功能会出现显示异常。本文将深入分析这一问题的成因，并提供多种解决方案。

问题现象

用户在使用 wlr-randr --scale 1.25 命令设置显示缩放，并启用 xwayland{ force_zero_scaling = true } 配置后，发现工作区预览出现以下问题：

1. 预览窗口无法正确填充工作区空间
2. 预览元素尺寸与屏幕实际显示比例不匹配
3. 在多显示器环境下，不同分辨率的显示器显示不一致

技术背景

Hyprland 是一个基于 Wayland 的现代平铺式窗口管理器。当涉及到显示缩放时，存在两个关键因素：

1. Wayland 原生缩放：通过 wlr-randr 工具设置
2. XWayland 兼容性缩放：通过 force_zero_scaling 选项控制

这两种缩放机制的交互导致了工作区预览的显示异常。

根本原因分析

问题核心在于 Hyprland 报告显示器尺寸时，未考虑实际应用的缩放系数。具体表现为：

1. 显示器原始分辨率被直接使用，而窗口尺寸已经过缩放
2. 在非整数缩放比例下（如 1.25），计算误差更为明显
3. 多显示器环境下，每个显示器的缩放比例可能不同

解决方案

方案一：调整用户配置中的预览缩放参数

通过修改用户配置文件中的 overview 缩放参数，可以部分缓解显示问题：

// .config/ags/user_options.js
const userConfigOptions = {
    'overview': {
        'scale': 0.18, // 调整此值
        'numOfCols': 4, // 减少列数以适应屏幕
    },
}

方案二：基于 GDK 的精确尺寸计算

对于更精确的尺寸计算，可以使用 GDK 库获取实际显示尺寸：

const SCREEN_GEOMETRY = {}

range(Gdk.Display.get_default()?.get_n_monitors() || 1, 0).forEach(id => {
    const display = Gdk.Display.get_default()
    const monitor = display.get_monitor(id)
    const monitor_geometry = monitor.get_geometry()

    SCREEN_GEOMETRY[id] = {
        width: monitor_geometry.width,
        height: monitor_geometry.height,
    }
});

方案三：Hyprland 原生解决方案

项目维护者最终实现了原生解决方案，通过自动计算缩放后的显示器尺寸：

// 自动计算缩放后的显示器尺寸
export const SCREEN_WIDTH = Number(hypr.monitors[0].width / hypr.monitors[0].scale)
export const SCREEN_HEIGHT = Number(hypr.monitors[0].height / hypr.monitors[0].scale)

多显示器环境下的特殊考虑

对于多显示器配置，需要注意：

1. 每个显示器可能有不同的缩放系数
2. 窗口管理器需要为每个显示器单独计算尺寸
3. 在混合 DPI 环境下，需要更复杂的处理逻辑

最佳实践建议

1. 对于单显示器用户，使用方案三的原生解决方案最为简单可靠
2. 对于特殊缩放比例（如 1.066667），建议使用 GDK 方法
3. 在多显示器环境下，考虑为每个显示器单独配置预览参数

结论

Hyprland 桌面环境中的工作区预览缩放问题源于显示器尺寸报告与窗口实际缩放的不一致。通过理解底层机制并应用适当的解决方案，用户可以恢复正常的预览功能。随着项目的持续发展，这一问题已在最新版本中得到有效解决。