Linux系统下Python中如何保持OpenCV窗口的键盘焦点

现状 #

在Python中使用OpenCV打开多窗口时，需要窗口持续保留键盘焦点：

• Windows：已实现对应功能
• macOS：系统自动支持该需求
• Linux：尚未完善，需通过获取名为cv2window的OpenCV窗口句柄（QWidget.window()）来实现窗口激活，现有跨平台代码仅在Windows/macOS环境正常运行

Linux实现方案 #

方案1：结合PyQt激活窗口 #

如果项目已使用PyQt，可直接通过控件句柄激活窗口：

import cv2
from PyQt5.QtWidgets import QWidget

# 初始化OpenCV窗口
cv2.namedWindow("cv2window")
# 假设已将OpenCV窗口嵌入QWidget实例
cv_widget = QWidget()

# 获取窗口句柄并激活
window_handle = cv_widget.window()
cv_widget.activateWindow()
cv_widget.raise_()

# 常规显示循环
while True:
    frame = cv2.imread("sample.jpg")
    cv2.imshow("cv2window", frame)
    if cv2.waitKey(1) & 0xFF == ord("q"):
        break

cv2.destroyAllWindows()

方案2：用系统工具wmctrl（无PyQt依赖） #

依赖Linux下的窗口管理工具wmctrl，先通过包管理器安装：

sudo apt install wmctrl  # Debian/Ubuntu系

然后通过Python调用工具查找并激活目标窗口：

import cv2
import subprocess

cv2.namedWindow("cv2window")

# 查找cv2window的窗口ID并激活
output = subprocess.check_output(["wmctrl", "-l"]).decode("utf-8")
for line in output.splitlines():
    if "cv2window" in line:
        win_id = line.split()[0]
        subprocess.run(["wmctrl", "-i", "-a", win_id])
        break

# 显示循环
while True:
    frame = cv2.imread("sample.jpg")
    cv2.imshow("cv2window", frame)
    if cv2.waitKey(1) & 0xFF == ord("q"):
        break

cv2.destroyAllWindows()

补充说明 #

• 若需要更底层的控制，可直接使用Xlib库操作X11窗口，但代码复杂度会更高
• 确保cv2window窗口名称唯一，避免wmctrl匹配错误

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