![]() |
OpenCV 4.12.0
開源計算機視覺
|
| enum cv::VideoCaptureAPIs |
#include <opencv2/videoio.hpp>
cv::VideoCapture API 後端識別符號。
為捕獲物件選擇首選API。用於 VideoCapture::VideoCapture() 建構函式或 VideoCapture::open()。
#include <opencv2/videoio.hpp>
cv::VideoCapture 通用屬性識別符號。
讀/寫屬性涉及多個層面。在此鏈中可能會發生一些意外結果。實際行為取決於裝置硬體、驅動程式和 API 後端。
| 列舉器 | |
|---|---|
| CAP_PROP_POS_MSEC Python: cv.CAP_PROP_POS_MSEC | 影片檔案當前位置(毫秒)。 |
| CAP_PROP_POS_FRAMES Python: cv.CAP_PROP_POS_FRAMES | 接下來要解碼/捕獲的幀的0基索引。當在RAW模式下(CAP_PROP_FORMAT == -1)設定索引 i 時,這將尋找到關鍵幀 k,其中 k <= i。 |
| CAP_PROP_POS_AVI_RATIO Python: cv.CAP_PROP_POS_AVI_RATIO | 影片檔案的相對位置:0=影片開頭,1=影片結尾。 |
| CAP_PROP_FRAME_WIDTH Python: cv.CAP_PROP_FRAME_WIDTH | 影片流中幀的寬度。 |
| CAP_PROP_FRAME_HEIGHT Python: cv.CAP_PROP_FRAME_HEIGHT | 影片流中幀的高度。 |
| CAP_PROP_FPS Python: cv.CAP_PROP_FPS | 幀率。 |
| CAP_PROP_FOURCC Python: cv.CAP_PROP_FOURCC | 編解碼器的4字元程式碼。參見 VideoWriter::fourcc。 |
| CAP_PROP_FRAME_COUNT Python: cv.CAP_PROP_FRAME_COUNT | 影片檔案中的幀數。 |
| CAP_PROP_FORMAT Python: cv.CAP_PROP_FORMAT | VideoCapture::retrieve() 返回的 Mat 物件的格式(參見 Mat::type())。設定為 -1 以獲取未解碼的 RAW 影片流(作為 Mat 8UC1)。 |
| CAP_PROP_MODE Python: cv.CAP_PROP_MODE | 指示當前捕獲模式的後端特定值。 |
| CAP_PROP_BRIGHTNESS Python: cv.CAP_PROP_BRIGHTNESS | 影像亮度(僅適用於支援此功能的攝像機)。 |
| CAP_PROP_CONTRAST Python: cv.CAP_PROP_CONTRAST | 影像對比度(僅適用於攝像機)。 |
| CAP_PROP_SATURATION Python: cv.CAP_PROP_SATURATION | 影像飽和度(僅適用於攝像機)。 |
| CAP_PROP_HUE Python: cv.CAP_PROP_HUE | 影像色調(僅適用於攝像機)。 |
| CAP_PROP_GAIN Python: cv.CAP_PROP_GAIN | 影像增益(僅適用於支援此功能的攝像機)。 |
| CAP_PROP_EXPOSURE Python: cv.CAP_PROP_EXPOSURE | 曝光(僅適用於支援此功能的攝像機)。 |
| CAP_PROP_CONVERT_RGB Python: cv.CAP_PROP_CONVERT_RGB | 布林標誌,指示影像是否應轉換為 RGB。 |
| CAP_PROP_WHITE_BALANCE_BLUE_U Python: cv.CAP_PROP_WHITE_BALANCE_BLUE_U | 當前不支援。 |
| CAP_PROP_RECTIFICATION Python: cv.CAP_PROP_RECTIFICATION | 立體攝像機的校正標誌(注意:目前僅由 DC1394 v 2.x 後端支援)。 |
| CAP_PROP_MONOCHROME Python: cv.CAP_PROP_MONOCHROME | |
| CAP_PROP_SHARPNESS Python: cv.CAP_PROP_SHARPNESS | |
| CAP_PROP_AUTO_EXPOSURE Python: cv.CAP_PROP_AUTO_EXPOSURE | DC1394:曝光控制由攝像機完成,使用者可以使用此功能調整參考水平。 |
| CAP_PROP_GAMMA Python: cv.CAP_PROP_GAMMA | |
| CAP_PROP_TEMPERATURE Python: cv.CAP_PROP_TEMPERATURE | |
| CAP_PROP_TRIGGER Python: cv.CAP_PROP_TRIGGER | |
| CAP_PROP_TRIGGER_DELAY Python: cv.CAP_PROP_TRIGGER_DELAY | |
| CAP_PROP_WHITE_BALANCE_RED_V Python: cv.CAP_PROP_WHITE_BALANCE_RED_V | |
| CAP_PROP_ZOOM Python: cv.CAP_PROP_ZOOM | Android:可能會切換物理攝像機/鏡頭。因子和範圍取決於硬體。 |
| CAP_PROP_FOCUS Python: cv.CAP_PROP_FOCUS | |
| CAP_PROP_GUID Python: cv.CAP_PROP_GUID | |
| CAP_PROP_ISO_SPEED Python: cv.CAP_PROP_ISO_SPEED | |
| CAP_PROP_BACKLIGHT Python: cv.CAP_PROP_BACKLIGHT | |
| CAP_PROP_PAN Python: cv.CAP_PROP_PAN | |
| CAP_PROP_TILT Python: cv.CAP_PROP_TILT | |
| CAP_PROP_ROLL Python: cv.CAP_PROP_ROLL | |
| CAP_PROP_IRIS Python: cv.CAP_PROP_IRIS | |
| CAP_PROP_SETTINGS Python: cv.CAP_PROP_SETTINGS | 彈出影片/攝像機濾鏡對話方塊(注意:目前僅由 DSHOW 後端支援。屬性值被忽略) |
| CAP_PROP_BUFFERSIZE Python: cv.CAP_PROP_BUFFERSIZE | |
| CAP_PROP_AUTOFOCUS Python: cv.CAP_PROP_AUTOFOCUS | |
| CAP_PROP_SAR_NUM Python: cv.CAP_PROP_SAR_NUM | 取樣寬高比:num/den (num) |
| CAP_PROP_SAR_DEN Python: cv.CAP_PROP_SAR_DEN | 取樣寬高比:num/den (den) |
| CAP_PROP_BACKEND Python: cv.CAP_PROP_BACKEND | 當前後端(列舉 VideoCaptureAPIs)。只讀屬性。 |
| CAP_PROP_CHANNEL Python: cv.CAP_PROP_CHANNEL | 影片輸入或通道號(僅適用於支援此功能的攝像機) |
| CAP_PROP_AUTO_WB Python: cv.CAP_PROP_AUTO_WB | 啟用/停用自動白平衡 |
| CAP_PROP_WB_TEMPERATURE Python: cv.CAP_PROP_WB_TEMPERATURE | 白平衡色溫 |
| CAP_PROP_CODEC_PIXEL_FORMAT Python: cv.CAP_PROP_CODEC_PIXEL_FORMAT | (只讀)編解碼器的畫素格式。4字元程式碼 - 參見 VideoWriter::fourcc。是 AV_PIX_FMT_* 的子集,如果未知則為 -1 |
| CAP_PROP_BITRATE Python: cv.CAP_PROP_BITRATE | (只讀)影片位元率(kbits/秒) |
| CAP_PROP_ORIENTATION_META Python: cv.CAP_PROP_ORIENTATION_META | (只讀)由流元資料定義的幀旋轉(僅適用於 FFmpeg 和 AVFoundation 後端) |
| CAP_PROP_ORIENTATION_AUTO Python: cv.CAP_PROP_ORIENTATION_AUTO | 如果為 true - 考慮影片檔案元資料旋轉 CvCapture 的輸出幀(僅適用於 FFmpeg 和 AVFoundation 後端)(https://github.com/opencv/opencv/issues/15499) |
| CAP_PROP_HW_ACCELERATION Python: cv.CAP_PROP_HW_ACCELERATION | (僅限開啟時)硬體加速型別(參見 VideoAccelerationType)。僅透過 cv::VideoCapture 建構函式 / .open() 方法中的 `params` 引數支援設定。預設值是後端特定的。 |
| CAP_PROP_HW_DEVICE Python: cv.CAP_PROP_HW_DEVICE | (僅限開啟時)硬體裝置索引(如果存在多個 GPU,則選擇 GPU)。裝置列舉是加速型別特定的。 |
| CAP_PROP_HW_ACCELERATION_USE_OPENCL Python: cv.CAP_PROP_HW_ACCELERATION_USE_OPENCL | (僅限開啟時)如果非零,則建立新的 OpenCL 上下文並將其繫結到當前執行緒。建立的 OpenCL 上下文(如果尚未附加)將附加影片加速上下文,以最佳化硬體加速解碼器和 cv::UMat 之間的 GPU 資料複製。 |
| CAP_PROP_OPEN_TIMEOUT_MSEC Python: cv.CAP_PROP_OPEN_TIMEOUT_MSEC | (僅限開啟時)開啟影片捕獲的超時時間(毫秒)(僅適用於 FFmpeg 和 GStreamer 後端) |
| CAP_PROP_READ_TIMEOUT_MSEC Python: cv.CAP_PROP_READ_TIMEOUT_MSEC | (僅限開啟時)從影片捕獲讀取的超時時間(毫秒)(僅適用於 FFmpeg 和 GStreamer 後端) |
| CAP_PROP_STREAM_OPEN_TIME_USEC Python: cv.CAP_PROP_STREAM_OPEN_TIME_USEC | (只讀)自 1970 年 1 月 1 日以來流開啟時的微秒時間。僅適用於 FFmpeg 後端。對 RTSP 和其他直播流有用。 |
| CAP_PROP_VIDEO_TOTAL_CHANNELS Python: cv.CAP_PROP_VIDEO_TOTAL_CHANNELS | (只讀)影片通道數 |
| CAP_PROP_VIDEO_STREAM Python: cv.CAP_PROP_VIDEO_STREAM | (僅限開啟時)指定影片流,0基索引。使用 -1 停用檔案或IP攝像機的影片流。預設值為 0。 |
| CAP_PROP_AUDIO_STREAM Python: cv.CAP_PROP_AUDIO_STREAM | (僅限開啟時)在多語言媒體檔案中指定流,-1 - 停用音訊處理或麥克風。預設值為 -1。 |
| CAP_PROP_AUDIO_POS Python: cv.CAP_PROP_AUDIO_POS | (只讀)音訊位置以樣本測量。前一個抓取片段的精確音訊樣本時間戳。參見 CAP_PROP_AUDIO_SAMPLES_PER_SECOND 和 CAP_PROP_AUDIO_SHIFT_NSEC。 |
| CAP_PROP_AUDIO_SHIFT_NSEC Python: cv.CAP_PROP_AUDIO_SHIFT_NSEC | (只讀)包含音訊流開始和影片流開始之間的時間差(納秒)。正值表示音訊在第一個影片幀之後開始。負值表示音訊在第一個影片幀之前開始。 |
| CAP_PROP_AUDIO_DATA_DEPTH Python: cv.CAP_PROP_AUDIO_DATA_DEPTH | (開啟,讀取)每樣本位數的一種替代定義,但明確處理 32F / 32S。 |
| CAP_PROP_AUDIO_SAMPLES_PER_SECOND Python: cv.CAP_PROP_AUDIO_SAMPLES_PER_SECOND | (開啟,讀取)由檔案/編解碼器輸入確定。如果未指定,則選擇的音訊取樣率為 44100。 |
| CAP_PROP_AUDIO_BASE_INDEX Python: cv.CAP_PROP_AUDIO_BASE_INDEX | (只讀)用於 .retrieve() 呼叫的第一個音訊通道的索引。該音訊通道號在影片通道之後繼續列舉。 |
| CAP_PROP_AUDIO_TOTAL_CHANNELS Python: cv.CAP_PROP_AUDIO_TOTAL_CHANNELS | (只讀)所選音訊流中的音訊通道數(單聲道、立體聲等) |
| CAP_PROP_AUDIO_TOTAL_STREAMS Python: cv.CAP_PROP_AUDIO_TOTAL_STREAMS | (只讀)音訊流數量。 |
| CAP_PROP_AUDIO_SYNCHRONIZE Python: cv.CAP_PROP_AUDIO_SYNCHRONIZE | (開啟,讀取)啟用音訊同步。 |
| CAP_PROP_LRF_HAS_KEY_FRAME Python: cv.CAP_PROP_LRF_HAS_KEY_FRAME | 僅限 FFmpeg 後端 - 指示從 VideoCapture::read() 輸出的最後一個原始幀 (LRF),當 VideoCapture 使用 VideoCapture::open(CAP_FFMPEG, {CAP_PROP_FORMAT, -1}) 或 VideoCapture::set(CAP_PROP_FORMAT,-1) 初始化後且在第一次呼叫 VideoCapture::read() 之前,是否包含關鍵幀的編碼資料。 |
| CAP_PROP_CODEC_EXTRADATA_INDEX Python: cv.CAP_PROP_CODEC_EXTRADATA_INDEX | 正索引表示影片後端支援返回額外資料。這可以透過 cap.retrieve(data, <返回的索引>) 獲取。例如,當從 h264 編碼的 RTSP 流讀取時,FFmpeg 後端可以從呼叫 cap.retrieve(data, <返回的索引>) 中返回 SPS 和/或 PPS(如果可用,即在 DESCRIBE 請求的回覆中傳送)。 |
| CAP_PROP_FRAME_TYPE Python: cv.CAP_PROP_FRAME_TYPE | (只讀)僅限 FFmpeg 後端 - 最近讀取幀的幀型別 ASCII 碼(73 = 'I',80 = 'P',66 = 'B',如果未知則為 63 = '?')。 |
| CAP_PROP_N_THREADS Python: cv.CAP_PROP_N_THREADS | (僅限開啟時)設定要使用的最大執行緒數。使用 0 表示使用與 CPU 核心數相同的執行緒數(僅適用於 FFmpeg 後端)。 |
| CAP_PROP_PTS Python: cv.CAP_PROP_PTS | (只讀)僅限 FFmpeg 後端 - 使用 FPS 時間基準的最近讀取幀的顯示時間戳。例如,fps = 25,VideoCapture::get(CAP_PROP_PTS) = 3,顯示時間 = 3/25 秒。 |
| CAP_PROP_DTS_DELAY Python: cv.CAP_PROP_DTS_DELAY | (只讀)僅限 FFmpeg 後端 - 使用 FPS 時間基準的顯示時間戳 (pts) 和解壓縮時間戳 (dts) 之間的最大差異。例如,當 frame_num = 0 時延遲最大,如果為 true,VideoCapture::get(CAP_PROP_PTS) = 0 且 VideoCapture::get(CAP_PROP_DTS_DELAY) = 2,dts = -2。非零值通常意味著流使用 B 幀編碼,這些 B 幀不按顯示順序解碼。 |
#include <opencv2/videoio.hpp>
cv::VideoWriter 通用屬性識別符號。
| 列舉器 | |
|---|---|
| VIDEOWRITER_PROP_QUALITY Python: cv.VIDEOWRITER_PROP_QUALITY | 編碼影片流的當前質量(0..100%)。可以在某些編解碼器中動態調整。 |
| VIDEOWRITER_PROP_FRAMEBYTES Python: cv.VIDEOWRITER_PROP_FRAMEBYTES | (只讀):剛編碼的影片幀的大小。請注意,編碼順序可能與表示順序不同。 |
| VIDEOWRITER_PROP_NSTRIPES Python: cv.VIDEOWRITER_PROP_NSTRIPES | 並行編碼的條帶數。-1 表示自動檢測。 |
| VIDEOWRITER_PROP_IS_COLOR Python: cv.VIDEOWRITER_PROP_IS_COLOR | 如果非零,編碼器將期望並編碼彩色幀,否則將使用灰度幀。 |
| VIDEOWRITER_PROP_DEPTH Python: cv.VIDEOWRITER_PROP_DEPTH | 預設為 CV_8U。 |
| VIDEOWRITER_PROP_HW_ACCELERATION Python: cv.VIDEOWRITER_PROP_HW_ACCELERATION | (僅限開啟時)硬體加速型別(參見 VideoAccelerationType)。僅透過 VideoWriter 建構函式 / .open() 方法中的 `params` 引數支援設定。預設值是後端特定的。 |
| VIDEOWRITER_PROP_HW_DEVICE Python: cv.VIDEOWRITER_PROP_HW_DEVICE | (僅限開啟時)硬體裝置索引(如果存在多個 GPU,則選擇 GPU)。裝置列舉是加速型別特定的。 |
| VIDEOWRITER_PROP_HW_ACCELERATION_USE_OPENCL Python: cv.VIDEOWRITER_PROP_HW_ACCELERATION_USE_OPENCL | (僅限開啟時)如果非零,則建立新的 OpenCL 上下文並將其繫結到當前執行緒。建立的 OpenCL 上下文(如果尚未附加)將附加影片加速上下文,以最佳化 cv::UMat 和硬體加速編碼器之間的 GPU 資料複製。 |
| VIDEOWRITER_PROP_RAW_VIDEO Python: cv.VIDEOWRITER_PROP_RAW_VIDEO | (僅限開啟時)設定為非零以啟用編碼原始影片流的封裝。每個原始編碼影片幀應作為 CV_8UC1 Mat 的單行或單列傳遞給 VideoWriter::write()。
|
| VIDEOWRITER_PROP_KEY_INTERVAL Python: cv.VIDEOWRITER_PROP_KEY_INTERVAL | (僅限開啟時)使用原始影片封裝設定關鍵幀間隔 (VIDEOWRITER_PROP_RAW_VIDEO != 0)。未設定時預設為 1。僅限 FFmpeg 後端。 |
| VIDEOWRITER_PROP_KEY_FLAG Python: cv.VIDEOWRITER_PROP_KEY_FLAG | 設定為非零以表示後續幀是關鍵幀,如果不是則設定為零,當封裝原始影片時 (VIDEOWRITER_PROP_RAW_VIDEO != 0)。僅限 FFmpeg 後端。 |
| VIDEOWRITER_PROP_PTS Python: cv.VIDEOWRITER_PROP_PTS | 指定每個幀的顯示時間戳,使用 FPS 時間基準。此屬性僅在封裝外部編碼影片時才需要,其中解碼順序與顯示順序不同,例如具有雙向 B 幀的 GOP 模式。該值應由您的外部編碼器提供,對於固定幀率的影片源,它等同於將當前幀的顯示時間 (CAP_PROP_POS_MSEC) 除以幀持續時間 (1000.0 / VideoCapture::get(CAP_PROP_FPS))。可以透過 VideoCapture::get(CAP_PROP_PTS) 從生成的封裝影片檔案中查詢。僅限 FFmpeg 後端。 |
| VIDEOWRITER_PROP_DTS_DELAY Python: cv.VIDEOWRITER_PROP_DTS_DELAY | 指定顯示時間戳 (pts) 和解壓縮時間戳 (dts) 之間使用 FPS 時間基準的最大差異。此屬性僅在封裝外部編碼影片時才需要,其中解碼順序與顯示順序不同,例如具有雙向 B 幀的 GOP 模式。該值應根據編碼期間使用的特定 GOP 模式計算。例如,在顯示順序為 IBP 且解碼順序為 IPB 的 GOP 中,此值將為 1,因為 B 幀是第二個顯示的幀,但卻是第三個解碼的幀。可以透過 VideoCapture::get(CAP_PROP_DTS_DELAY) 從生成的封裝影片檔案中查詢。非零值通常意味著流使用 B 幀編碼。僅限 FFmpeg 後端。 |