一、waitkey函数是什么

waitkey函数是openCV库中一个非常重要的函数，它的主要作用是等待用户按下某个键，同时它还会返回该按键的ASCII码值。在图像处理的过程中，waitkey函数通常用来实现按键控制，比如实现按Esc键退出程序。

int waitKey(int delay)

二、waitkey函数的调用方法

waitkey函数的调用非常简单，只需要将想要等待的时间以毫秒为单位作为参数传递给该函数即可。如果在等待过程中用户没有按下任何键，waitkey函数会在超时后返回-1。

例如：

char key = 0;
while(key != 27) // 27是ASCII码中的Esc键
{
    Mat frame;
    cap >> frame; // 读取一帧图像
    imshow("video", frame); // 在窗口中显示该帧图像
    key = waitKey(30); // 等待30毫秒，如果用户按下任意键则返回该键的ASCII码值
}

三、waitkey函数的注意事项

四、waitkey函数的实例

1、实现按Esc键退出程序

int main()
{
    VideoCapture cap(0); // 打开摄像头
    if (!cap.isOpened()) // 如果摄像头未正常打开，则结束程序
        return -1;
    namedWindow("video", CV_WINDOW_NORMAL); // 建立一个名为"video"的窗口
    char key = 0;
    while(key != 27) // 27是ASCII码中的Esc键
    {
        Mat frame;
        cap >> frame; // 读取一帧图像
        imshow("video", frame); // 在窗口中显示该帧图像
        key = waitKey(30); // 等待30毫秒，如果用户按下任意键则返回该键的ASCII码值
    }
    destroyWindow("video"); // 销毁窗口
    return 0;
}

2、实现按下s键保存当前帧图像

int main()
{
    VideoCapture cap(0); // 打开摄像头
    if (!cap.isOpened()) // 如果摄像头未正常打开，则结束程序
        return -1;
    namedWindow("video", CV_WINDOW_NORMAL); // 建立一个名为"video"的窗口
    char key = 0;
    int count = 0; // 用于保存图像的计数器
    while(key != 27) // 27是ASCII码中的Esc键
    {
        Mat frame;
        cap >> frame; // 读取一帧图像
        imshow("video", frame); // 在窗口中显示该帧图像
        key = waitKey(30); // 等待30毫秒，如果用户按下任意键则返回该键的ASCII码值
        if (key == 's') // 如果用户按下s键，则保存当前帧图像
        {
            String savePath = format("./image/frame_%d.jpg", count++);
            imwrite(savePath, frame);
            cout << "Save image " << savePath << " successfully!" << endl;
        }
    }
    destroyWindow("video"); // 销毁窗口
    return 0;
}

3、实现通过按下数字键来切换视频流

int main()
{
    vector files; // 用于存储视频流文件名的向量
    files.push_back("./video/video1.mp4");
    files.push_back("./video/video2.mp4");
    files.push_back("./video/video3.mp4");
    int index = 0; // 当前视频流的索引
    VideoCapture cap(files[index]); // 打开第一个视频流
    if (!cap.isOpened()) // 如果视频流未正常打开，则结束程序
        return -1;
    namedWindow("video", CV_WINDOW_NORMAL); // 建立一个名为"video"的窗口
    char key = 0;
    while(key != 27) // 27是ASCII码中的Esc键
    {
        Mat frame;
        cap >> frame; // 读取一帧图像
        imshow("video", frame); // 在窗口中显示该帧图像
        key = waitKey(30); // 等待30毫秒，如果用户按下任意键则返回该键的ASCII码值
        if (key >= '1' && key <= '3') // 如果用户按下数字键，则切换到对应的视频流
        {
            index = key - '1';
            cap.release(); // 释放当前视频流
            cap.open(files[index]); // 打开新的视频流
        }
    }
    destroyWindow("video"); // 销毁窗口
    return 0;
}

4、实现打开多个摄像头并显示在不同的窗口中

int main()
{
    VideoCapture cap1(0); // 打开第一个摄像头
    if (!cap1.isOpened()) // 如果摄像头未正常打开，则结束程序
        return -1;
    VideoCapture cap2(1); // 打开第二个摄像头
    if (!cap2.isOpened()) // 如果摄像头未正常打开，则结束程序
        return -1;
    namedWindow("video1", CV_WINDOW_NORMAL); // 建立一个名为"video1"的窗口
    namedWindow("video2", CV_WINDOW_NORMAL); // 建立一个名为"video2"的窗口
    char key = 0;
    while(key != 27) // 27是ASCII码中的Esc键
    {
        Mat frame1, frame2;
        cap1 >> frame1; // 读取第一个摄像头的一帧图像
        cap2 >> frame2; // 读取第二个摄像头的一帧图像
        imshow("video1", frame1); // 在"video1"窗口中显示第一个摄像头的帧图像
        imshow("video2", frame2); // 在"video2"窗口中显示第二个摄像头的帧图像
        key = waitKey(30); // 等待30毫秒，如果用户按下任意键则返回该键的ASCII码值
    }
    destroyWindow("video1"); // 销毁"video1"窗口
    destroyWindow("video2"); // 销毁"video2"窗口
    return 0;
}