• 操作系統(tǒng)：ubuntu22.04
• OpenCV版本：OpenCV4.9
• IDE:Visual Studio Code
• 編程語(yǔ)言：C++11

算法描述

為視頻捕獲打開(kāi)一個(gè)視頻文件、捕獲設(shè)備或 IP 視頻流。
這是一個(gè)重載成員函數(shù)，提供給用戶方便使用。它與上述函數(shù)的不同之處僅在于它所接受的參數(shù)。
參數(shù)與構(gòu)造函數(shù) VideoCapture(const String& filename, int apiPreference = CAP_ANY) 相同。

open() 函數(shù)是 OpenCV 中 VideoCapture 類的一個(gè)成員函數(shù)，用于初始化視頻捕獲設(shè)備或打開(kāi)一個(gè)視頻文件。這個(gè)函數(shù)允許你在創(chuàng)建 VideoCapture 對(duì)象后動(dòng)態(tài)地打開(kāi)一個(gè)視頻文件或設(shè)備。

函數(shù)原型1

virtual bool cv::VideoCapture::open	
(const String & 	filename,int 	apiPreference = CAP_ANY 
)	

參數(shù)1

• 參數(shù)filename (const String&)：
  • 描述：指定要打開(kāi)的視頻文件路徑或網(wǎng)絡(luò)流地址。
  • 示例：“video.mp4” 或 “rtsp://username:password@ipaddress:port/stream”
• apiPreference (int, 可選)：
  • 描述：指定用于打開(kāi)視頻文件或設(shè)備的后端標(biāo)識(shí)符。
  • 默認(rèn)值：CAP_ANY （表示任何可用的后端）
  • 示例：CAP_FFMPEG, CAP_V4L2, 等

返回值

如果文件已成功打開(kāi)，則返回 true。

該方法首先調(diào)用 VideoCapture::release() 來(lái)關(guān)閉已打開(kāi)的文件或相機(jī)。

代碼示例

#include <iostream>
#include <opencv2/opencv.hpp>int main()
{// 創(chuàng)建一個(gè) VideoCapture 對(duì)象cv::VideoCapture cap;// 定義視頻文件路徑std::string filename = "video.mp4";// 嘗試打開(kāi)視頻文件if ( !cap.open( filename ) ){std::cout << "Failed to open video file: " << filename << std::endl;return -1;}// 檢查是否成功打開(kāi)了視頻文件if ( !cap.isOpened() ){std::cout << "Error opening video file: " << filename << std::endl;return -1;}// 循環(huán)讀取并顯示視頻幀while ( true ){// 從視頻流中讀取下一幀cv::Mat frame;cap >> frame;  // 或者使用 cap.read(frame);// 如果沒(méi)有讀取到幀，則退出循環(huán)if ( frame.empty() ){std::cout << "No frame grabbed." << std::endl;break;}// 顯示視頻幀cv::imshow( "Video Stream", frame );// 按 'q' 鍵退出循環(huán)if ( cv::waitKey( 1 ) == 'q' ){break;}}// 釋放資源cap.release();cv::destroyAllWindows();return 0;
}

函數(shù)原型2

為視頻捕獲打開(kāi)一個(gè)視頻文件、捕獲設(shè)備或 IP 視頻流，并帶有 API 偏好和參數(shù)。

這是一個(gè)重載成員函數(shù)，提供給用戶方便使用。它與上述函數(shù)的不同之處僅在于它所接受的參數(shù)。

params 參數(shù)允許指定額外的參數(shù)，這些參數(shù)編碼為成對(duì)的形式（paramId_1, paramValue_1, paramId_2, paramValue_2, …）。參見(jiàn) cv::VideoCaptureProperties。

virtual bool cv::VideoCapture::open
(const String & 	filename,int 	apiPreference,const std::vector< int > & 	params 
)		

參數(shù)2

• filename (const String&)：
  • 描述：指定要打開(kāi)的視頻文件路徑或網(wǎng)絡(luò)流地址。
  • 示例：“video.mp4” 或 “rtsp://username:password@ipaddress:port/stream”
• apiPreference (int, 可選)：
  • 描述：指定用于打開(kāi)視頻文件或設(shè)備的后端標(biāo)識(shí)符。
  • 默認(rèn)值：CAP_ANY （表示任何可用的后端）
  • 示例：CAP_FFMPEG, CAP_V4L2, 等
• params (const std::vector&, 可選)：
  • 描述：允許指定額外的參數(shù)，這些參數(shù)編碼為成對(duì)的形式（paramId_1, paramValue_1, paramId_2, paramValue_2, …）。
  • 默認(rèn)值：空向量（表示不使用額外參數(shù)）

返回值

類型：bool
描述：返回值指示是否成功初始化了視頻捕獲。如果返回 true，則表示成功初始化；如果返回 false，則表示初始化失敗。

函數(shù)原型3

為視頻捕獲打開(kāi)一個(gè)攝像頭。

這是一個(gè)重載成員函數(shù)，提供給用戶方便使用。它與上述函數(shù)的不同之處僅在于它所接受的參數(shù)。

參數(shù)與構(gòu)造函數(shù) VideoCapture(int index, int apiPreference = CAP_ANY) 相同。

virtual bool cv::VideoCapture::open	
(int 	index,int 	apiPreference = CAP_ANY 
)		

參數(shù)3

• index (int)：
  • 描述：指定要打開(kāi)的攝像頭設(shè)備的索引。通常，索引 0 表示系統(tǒng)中的第一個(gè)攝像頭，索引 1 表示第二個(gè)攝像頭，以此類推。
  • 示例：0（表示第一個(gè)攝像頭設(shè)備），1（表示第二個(gè)攝像頭設(shè)備）
• apiPreference (int, 可選)：
  • 描述：指定用于打開(kāi)視頻設(shè)備的后端標(biāo)識(shí)符。
  • 默認(rèn)值：CAP_ANY （表示任何可用的后端）
  • 示例：CAP_FFMPEG, CAP_V4L2, 等

返回值3

類型：bool
描述：返回值指示是否成功初始化了視頻捕獲。如果返回 true，則表示成功初始化；如果返回 false，則表示初始化失敗。

代碼示例

#include <iostream>
#include <opencv2/opencv.hpp>int main()
{// 創(chuàng)建一個(gè) VideoCapture 對(duì)象cv::VideoCapture cap;// 定義攝像頭設(shè)備索引int cameraIndex = 0;  // 第一個(gè)攝像頭設(shè)備// 嘗試打開(kāi)攝像頭設(shè)備if ( !cap.open( cameraIndex, cv::CAP_ANY ) ){std::cout << "Failed to open camera at index: " << cameraIndex << std::endl;return -1;}// 檢查是否成功打開(kāi)了攝像頭設(shè)備if ( !cap.isOpened() ){std::cout << "Error opening camera at index: " << cameraIndex << std::endl;return -1;}// 循環(huán)讀取并顯示視頻幀while ( true ){// 從視頻流中讀取下一幀cv::Mat frame;cap >> frame;  // 或者使用 cap.read(frame);// 如果沒(méi)有讀取到幀，則退出循環(huán)if ( frame.empty() ){std::cout << "No frame grabbed." << std::endl;break;}// 顯示視頻幀cv::imshow( "Camera Stream", frame );// 按 'q' 鍵退出循環(huán)if ( cv::waitKey( 1 ) == 'q' ){break;}}// 釋放資源cap.release();cv::destroyAllWindows();return 0;
}

函數(shù)原型4

為視頻捕獲打開(kāi)一個(gè)攝像頭，帶有 API 偏好和參數(shù)。

這是一個(gè)重載成員函數(shù)，提供給用戶方便使用。它與上述函數(shù)的不同之處僅在于它所接受的參數(shù)。

params 參數(shù)允許指定額外的參數(shù)，這些參數(shù)編碼為成對(duì)的形式（paramId_1, paramValue_1, paramId_2, paramValue_2, …）。參見(jiàn) cv::VideoCaptureProperties。

virtual bool cv::VideoCapture::open
(int 	index,int 	apiPreference,const std::vector< int > & 	params 
)		

參數(shù)4

• index (int)：
  • 描述：指定要打開(kāi)的攝像頭設(shè)備的索引。通常，索引 0 表示系統(tǒng)中的第一個(gè)攝像頭，索引 1 表示第二個(gè)攝像頭，以此類推。
  • 示例：0（表示第一個(gè)攝像頭設(shè)備），1（表示第二個(gè)攝像頭設(shè)備）
• apiPreference (int, 可選)：
  • 描述：指定用于打開(kāi)視頻設(shè)備的后端標(biāo)識(shí)符。
  • 默認(rèn)值：CAP_ANY （表示任何可用的后端）
  • 示例：CAP_FFMPEG, CAP_V4L2, 等
• params (const std::vector&, 可選)：
  • 描述：允許指定額外的參數(shù)，這些參數(shù)編碼為成對(duì)的形式（paramId_1, paramValue_1, paramId_2, paramValue_2, …）。
  • 默認(rèn)值：空向量（表示不使用額外參數(shù)）

返回值

類型：bool
描述：返回值指示是否成功初始化了視頻捕獲。如果返回 true，則表示成功初始化；如果返回 false，則表示初始化失敗。