如何让OpenCV摄像头窗口始终处于所有窗口最底层？（Ubuntu+PyInstaller）

在Ubuntu环境中，OpenCV的imshow没有直接提供设置窗口层级的接口，要实现窗口始终在最底层（不遮挡其他窗口且不易被察觉），有两种可行方案：

方案一：借助wmctrl命令行工具 #

这种方法依赖系统自带的窗口管理工具，操作简单：

1. 先安装wmctrl（如果系统没装的话）：

   sudo apt install wmctrl
   

2. 修改你的OpenCV代码，在窗口显示后调用wmctrl设置层级：

   import cv2
   import subprocess
   import time
   
   vid = cv2.VideoCapture(0)
   window_set = False
   
   while(True):
       ret, frame = vid.read()
       if not ret:
           break
       cv2.imshow('frame', frame)
       
       # 仅首次设置窗口层级，避免重复调用
       if not window_set:
           # 给窗口预留创建时间
           time.sleep(0.1)
           try:
               # 将名为'frame'的窗口设置为底层
               subprocess.run(['wmctrl', '-r', 'frame', '-b', 'add,below'], check=True)
               window_set = True
           except subprocess.CalledProcessError:
               # 窗口未创建成功时继续尝试
               pass
       
       if cv2.waitKey(1) & 0xFF == ord('q'):
           break
   
   vid.release()
   cv2.destroyAllWindows()
   

方案二：直接调用X11底层API（无额外依赖） #

这种方法无需安装第三方工具，直接调用Ubuntu原生的X11库，更适合打包分发：

import cv2
import ctypes

# 加载X11系统库
Xlib = ctypes.CDLL('libX11.so.6')

# 定义X11函数的参数和返回值类型
Xlib.XOpenDisplay.argtypes = [ctypes.c_char_p]
Xlib.XOpenDisplay.restype = ctypes.c_void_p
Xlib.XDefaultRootWindow.argtypes = [ctypes.c_void_p]
Xlib.XDefaultRootWindow.restype = ctypes.c_ulong
Xlib.XFindWindowByName.argtypes = [ctypes.c_void_p, ctypes.c_ulong, ctypes.c_char_p]
Xlib.XFindWindowByName.restype = ctypes.c_ulong
Xlib.XLowerWindow.argtypes = [ctypes.c_void_p, ctypes.c_ulong]
Xlib.XCloseDisplay.argtypes = [ctypes.c_void_p]

# 建立X11显示连接
display = Xlib.XOpenDisplay(None)
if not display:
    raise Exception("无法连接X11显示服务")

vid = cv2.VideoCapture(0)
window_set = False

while(True):
    ret, frame = vid.read()
    if not ret:
        break
    cv2.imshow('frame', frame)
    
    # 仅设置一次窗口层级
    if not window_set:
        # 查找目标窗口ID
        root_win = Xlib.XDefaultRootWindow(display)
        win_id = Xlib.XFindWindowByName(display, root_win, b'frame')
        if win_id != 0:
            # 将窗口置于最底层
            Xlib.XLowerWindow(display, win_id)
            window_set = True
    
    if cv2.waitKey(1) & 0xFF == ord('q'):
        break

vid.release()
cv2.destroyAllWindows()
Xlib.XCloseDisplay(display)

PyInstaller打包注意事项 #

• 方案一：打包后运行程序前，需确保目标Ubuntu系统已安装wmctrl；若要适配无wmctrl的环境，可在启动脚本中加入自动安装逻辑。
• 方案二：无需额外处理依赖，X11库是Ubuntu系统默认自带的，打包后可直接运行。

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