如何在OpenCV中获取最新帧？实现单次按键无循环显示当前帧

需求与问题描述 #

我希望在任意按键事件触发时，拍摄并显示摄像头的最新帧，且仅执行一次拍摄操作（不使用无限循环）。目前遇到的问题是显示的帧并非最新，而是上一帧，推测VideoCapture对象存在帧缓存。使用的是OpenCV 4.6.0版本和笔记本电脑摄像头，现有代码如下：

#include <iostream>
#include <opencv2/opencv.hpp>

int main() {
    cv::VideoCapture cap0(0);

    cv::Mat frame0;
    for (;;)
    {
        cap0.read(frame0);
        if (!frame0.empty())
        {
            imshow("cap0", frame0);
        }
        cv::waitKey(0);
    }
    return 0;
}

问题根源 #

笔记本摄像头自带硬件缓存，同时OpenCV的VideoCapture内部也会缓存若干帧。摄像头持续输出的帧会被暂存到缓存中，直接调用read()只能获取缓存中最早的旧帧，而非当前实时的最新帧。

解决方案 #

方法一：按键触发时清空缓存再读最新帧 #

该方法通过在按键事件触发后，先读取并丢弃所有缓存帧，再获取最新帧，同时仅在按键时执行读取操作，避免无意义的循环读取：

#include <iostream>
#include <opencv2/opencv.hpp>

int main() {
    cv::VideoCapture cap0(0);
    if (!cap0.isOpened()) {
        std::cerr << "无法打开摄像头" << std::endl;
        return -1;
    }

    cv::Mat frame0;
    cv::namedWindow("cap0", cv::WINDOW_NORMAL);

    // 单次触发版本：去掉外层while即可
    while (true) {
        int key = cv::waitKey(0); // 阻塞等待按键
        if (key == 27) break; // 按ESC退出

        // 清空所有缓存帧
        cv::Mat temp;
        while (cap0.read(temp));
        
        // 读取当前最新帧
        if (cap0.read(frame0) && !frame0.empty()) {
            cv::imshow("cap0", frame0);
        }
    }

    cap0.release();
    cv::destroyAllWindows();
    return 0;
}

如果只需要单次按键触发，直接移除外层的while(true)循环即可，执行一次后程序会结束。

方法二：使用窗口事件回调实现无循环触发 #

通过注册OpenCV窗口的键盘事件回调，无需显式循环读取帧，仅在按键按下时执行缓存清空与最新帧获取操作：

#include <iostream>
#include <opencv2/opencv.hpp>

cv::VideoCapture cap;

void onKeyEvent(int event, int x, int y, int flags, void* userdata) {
    if (event == cv::EVENT_KEYDOWN) {
        // 清空缓存
        cv::Mat temp;
        while (cap.read(temp));
        
        // 获取并显示最新帧
        cv::Mat frame;
        if (cap.read(frame) && !frame.empty()) {
            cv::imshow("cap0", frame);
        }

        // 若仅需单次触发，执行以下代码退出程序
        // cap.release();
        // cv::destroyWindow("cap0");
        // exit(0);
    }
}

int main() {
    cap.open(0);
    if (!cap.isOpened()) {
        std::cerr << "无法打开摄像头" << std::endl;
        return -1;
    }

    cv::namedWindow("cap0", cv::WINDOW_NORMAL);
    cv::setMouseCallback("cap0", onKeyEvent, nullptr);

    // 保持窗口存活并响应事件，无需循环读取帧
    cv::waitKey(0);

    cap.release();
    cv::destroyAllWindows();
    return 0;
}

该方案完全避免了主动循环读取帧的逻辑，仅在按键事件触发时执行拍摄操作。

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