如何利用python-xlib确定性判断显示输出的扩展/镜像模式

好问题！其实完全可以通过Python Xlib结合XRandr扩展来实现这个需求——毕竟原生Xlib的基础输出信息接口确实没直接提供镜像/扩展的状态，得借助XRandr来获取显示布局的细节。

X11环境中，显示输出（比如HDMI-1）的镜像/扩展模式是由XRandr扩展管理的：

• 镜像（克隆）模式：多个输出绑定到同一个CRTC（显示控制器），共享同一帧画面
• 扩展模式：每个输出绑定到独立的CRTC，且这些CRTC的显示区域是拼接（比如左右/上下相邻）的

所以我们的核心步骤就是：

1. 连接X服务器并初始化XRandr扩展
2. 定位目标输出，找到它绑定的CRTC
3. 检查该CRTC是否绑定了多个已连接的输出（判断镜像）
4. 如果是单个输出，再检查其他CRTC的位置是否和目标CRTC的区域相邻（判断扩展）

from Xlib import display
from Xlib.ext import randr

def check_display_mode(target_output_name):
    # 连接到本地X服务器
    dpy = display.Display()
    root = dpy.screen().root

    # 初始化XRandr扩展（确保系统支持）
    try:
        randr_version = dpy.randr_query_version()
    except Exception as e:
        print(f"系统不支持XRandr扩展：{e}")
        dpy.close()
        return

    # 获取当前屏幕的所有显示资源（输出、CRTC等）
    screen_resources = root.xrandr_get_screen_resources()
    config_timestamp = screen_resources.config_timestamp

    # 定位目标输出
    target_output = None
    for output in screen_resources.outputs:
        output_info = dpy.xrandr_get_output_info(output, config_timestamp)
        # Xlib返回的输出名称是字节串，需要解码为字符串
        if output_info.name.decode() == target_output_name:
            target_output = output
            break

    if not target_output:
        print(f"未找到输出设备：{target_output_name}")
        dpy.close()
        return

    # 获取目标输出的详细信息，包括绑定的CRTC
    target_output_info = dpy.xrandr_get_output_info(target_output, config_timestamp)
    target_crtc = target_output_info.crtc

    # 收集绑定到同一个CRTC的所有已连接输出
    same_crtc_outputs = []
    for output in screen_resources.outputs:
        output_info = dpy.xrandr_get_output_info(output, config_timestamp)
        # 只统计已连接的输出
        if output_info.crtc == target_crtc and output_info.connection == randr.RR_Connected:
            same_crtc_outputs.append(output_info.name.decode())

    # 判断模式
    if len(same_crtc_outputs) > 1:
        print(f"输出 {target_output_name} 处于**镜像（克隆）模式**，同组输出：{', '.join(same_crtc_outputs)}")
    else:
        # 获取目标CRTC的显示区域信息
        target_crtc_info = dpy.xrandr_get_crtc_info(target_crtc, config_timestamp)
        target_x, target_y, target_w, target_h = (
            target_crtc_info.x, target_crtc_info.y,
            target_crtc_info.width, target_crtc_info.height
        )

        # 检查是否有其他CRTC的区域与目标区域相邻（扩展模式的典型特征）
        is_extended = False
        for crtc in screen_resources.crtcs:
            if crtc == target_crtc:
                continue
            crtc_info = dpy.xrandr_get_crtc_info(crtc, config_timestamp)
            # 检查是否左右相邻或上下相邻
            if (crtc_info.x == target_x + target_w) or (crtc_info.x + crtc_info.width == target_x):
                is_extended = True
            elif (crtc_info.y == target_y + target_h) or (crtc_info.y + crtc_info.height == target_y):
                is_extended = True

        if is_extended:
            print(f"输出 {target_output_name} 处于**扩展模式**")
        else:
            print(f"输出 {target_output_name} 为独立显示（未扩展也未镜像）")

    dpy.close()

# 使用示例：检查HDMI-1的模式
if __name__ == "__main__":
    check_display_mode("HDMI-1")

• XRandr扩展依赖：确保你的系统支持XRandr（绝大多数现代X11桌面环境都支持），如果不支持会抛出异常
• 输出名称匹配：Xlib返回的输出名称是字节类型，需要解码为字符串再和目标名称对比
• 连接状态过滤：只统计RR_Connected状态的输出，避免把未连接的设备算进去
• 扩展模式判断：这里采用了最常见的“相邻区域”判断逻辑，适配大多数桌面环境的扩展布局；如果是更复杂的扩展布局（比如重叠、非对齐），可能需要调整判断逻辑

内容的提问来源于stack exchange，提问作者user2694295