Linux环境下Python+OpenCV HighGUI如何捕获大写键盘输入？

问题背景 #

在Linux环境下基于OpenCV HighGUI开发图像读取显示项目时，使用cv2.waitKey()无法捕获大写字母的ASCII码（比如按下Shift+A或开启Caps Lock按A，始终得到小写a的97而非大写A的65）。原代码及示例输出如下：

原代码 #

import cv2

if __name__ == "__main__":
    # 创建HighGUI窗口
    cv2.namedWindow("image")

    while True:
        # 在窗口中显示图像
        img = cv2.imread("images/histogram.png")
        cv2.imshow("image", img)

        # 等待按键事件
        key = cv2.waitKey(0)

        # 判断是否按下ESC键
        if key == 27:
            break

        # 判断是否为大写字母
        if key >= ord("A") and key <= ord("Z"):
            print(f"按下大写字母 '{chr(key)}'!")
        else:
            print(f"未检测到大写字母。ASCII码: '{key}'")

    # 销毁窗口
    cv2.destroyAllWindows()

示例输出 #

未检测到大写字母。ASCII码: '97' # 按下a
未检测到大写字母。ASCII码: '225' # 按下左Shift
未检测到大写字母。ASCII码: '97' # 按下Shift+A
未检测到大写字母。ASCII码: '229' # 按下Caps Lock
未检测到大写字母。ASCII码: '97' # 开启Caps Lock后按A

原因分析 #

在Linux的X11窗口环境中，cv2.waitKey()的行为特性：

• 直接返回字符的小写ASCII码，不会自动根据Shift/Caps Lock转换为大写
• Shift、Caps Lock等修饰键会被作为独立的按键事件返回（左Shift对应225，Caps Lock对应229），不会与字符键组合生成大写码

解决方案 #

通过跟踪修饰键的状态（Shift是否按下、Caps Lock是否激活），结合返回的字符码来判断实际输入的大小写。修改后的代码如下：

import cv2

if __name__ == "__main__":
    cv2.namedWindow("image")
    shift_pressed = False
    caps_lock_active = False

    while True:
        img = cv2.imread("images/histogram.png")
        cv2.imshow("image", img)
        key = cv2.waitKey(0)

        if key == 27:
            break
        
        # 处理修饰键状态
        if key == 225 or key == 226:  # 左右Shift按下
            shift_pressed = True
            continue
        elif key == 229:  # Caps Lock切换激活状态
            caps_lock_active = not caps_lock_active
            continue
        elif key == -1:  # 无有效按键事件
            continue
        
        # 判断实际输入的字符大小写
        char = chr(key)
        if char.islower():
            # 根据Shift和Caps Lock的组合状态确定最终字符
            if (shift_pressed and not caps_lock_active) or (not shift_pressed and caps_lock_active):
                upper_char = char.upper()
                print(f"按下大写字母 '{upper_char}'!")
            else:
                print(f"按下小写字母 '{char}'!")
        else:
            print(f"按下字符 '{char}'，ASCII码: '{key}'")
        
        # 处理完字符键后重置Shift状态（waitKey()无法捕获Shift松开事件）
        shift_pressed = False

    cv2.destroyAllWindows()

关键说明 #

• 用shift_pressed跟踪Shift键的按下状态，处理完字符键后必须重置（因为waitKey()仅能捕获Shift按下事件，无法捕获松开事件）
• 用caps_lock_active跟踪Caps Lock的激活状态，每次按下Caps Lock键时切换状态
• 通过Shift和Caps Lock的组合逻辑，将小写字符转换为大写，实现正确的大写字母检测

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