知乎

在设置 WSLg 下 HiDPI 的时, 界面正常的放大后, 标题栏等窗口装饰还是很小, 最后还是没有完全解决, 但了解了下面这些.

窗口装饰 window decorations

• 标题栏, 包括: 窗口名称 最小化 最大化 关闭, 有移动功能
• 窗口边框, 有改变窗口大小功能

X11 下的窗口装饰

• X Server 不提供窗口装饰
• 通常由 Window Manager 窗口管理器(比如 openbox, i3, kwin) 绘制处理
• 客户程序(X clients) 可以要求 WM 不绘制窗口装饰¹, 但通常客户端会自己绘制²

Wayland 下的窗口装饰

Wayland Compositor

• 相当于 X Server
• 参考实现 weston 也是 WSLg 用的, 没有窗口装饰

服务端窗口装饰(Server Side Decoration)

• Wayland Compositor 可以提供窗口装饰
• 需要实现一个未稳定的 wayland 协议: zxdg_decoration_manager_v1³
• 具体的实现有: Qt6 Wayland Compositor⁴, KWin⁵
• KDE的开发人员对CSD⁶和SSD⁷的文章值得一看
• Weston 有一个提案可能会实现 SSD Add support for server-side decorations: xdg-decoration-unstable-v1

客户端窗口装饰(Client Side Decoration CSD)

• 通用的 libdecor 库
  一个插件化的系统, LIBDECOR_PLUGIN_DIR 指定插件目录, 但不能指定明确的插件, 有如下插件:
  • /usr/lib/libdecor/plugins-1/libdecor-cairo.so
  • /usr/lib/libdecor/plugins-1/libdecor-gtk.so
• Gtk3, Gtk4 由程序自绘(功能由控件库提供)
  • 普通的标题栏, 使用Gtk.Window.set_title等函数
  • Gtk.HeaderBar² 提供的多功能标题栏
  • 上述两种均受 GDK_SCALE 和 GDK_DPI_SCALE 影响
• Qt5, Qt6 由控件库自绘
  • 普通的标题栏, 插件化
    默认插件为: /usr/lib/qt6/plugins/wayland-decoration-client/libbradient.so
    不受QT_SCALE_FACTOR影响
    本人已修改官方插件使之支持HiDPI: qt-wayland-decorations-bradient-mkii
    用法: QT_WAYLAND_DECORATION=bradient-mkii featherpad
  • 也可以完全自绘⁸, 但目前没有方便的控件
    window.setWindowFlags(Qt::FramelessWindowHint)

X11 程序在 Wayland 中

• Gtk2 Qt4 xterm 等 X11 程序, 由 xwayland 作为 X Server
• Wayland Compositor 内嵌一个 Window Manager, 只用于 X11 程序, 负责绘制此类程序的窗口装饰
  参见 xwayland/window-manager.c, 应该是可以创建主题, 但目前写死了大小,颜色,字体和图标.
• 使用 wayland 缩放时适配 HiDPI
• 客户程序自行处理 HiDPI 时, 不会缩放

大混乱

综上所述, 同一个 wayland compositor 下, 可能同时出现7,8种不同的窗口装饰
X下的客户端默认服务端(WM)是提供窗口装饰的, 客户程序只需要设置窗口属性为 frameless, 就可以自行绘制窗口装饰
而在 wayland 下, 客户端需要查询服务端是否提供窗口装饰, 再来决定处理方式, 复杂了很多, 可能会搞出双边框来

References 参考链接