OpenCV 4.12.0
开源计算机视觉
加载中...
搜索中...
无匹配项
视频 I/O 标志

详细描述

枚举

枚举  cv::VideoCaptureAPIs {
  cv::CAP_ANY = 0 ,
  cv::CAP_VFW = 200 ,
  cv::CAP_V4L = 200 ,
  cv::CAP_V4L2 = CAP_V4L ,
  cv::CAP_FIREWIRE = 300 ,
  cv::CAP_FIREWARE = CAP_FIREWIRE ,
  cv::CAP_IEEE1394 = CAP_FIREWIRE ,
  cv::CAP_DC1394 = CAP_FIREWIRE ,
  cv::CAP_CMU1394 = CAP_FIREWIRE ,
  cv::CAP_QT = 500 ,
  cv::CAP_UNICAP = 600 ,
  cv::CAP_DSHOW = 700 ,
  cv::CAP_PVAPI = 800 ,
  cv::CAP_OPENNI = 900 ,
  cv::CAP_OPENNI_ASUS = 910 ,
  cv::CAP_ANDROID = 1000 ,
  cv::CAP_XIAPI = 1100 ,
  cv::CAP_AVFOUNDATION = 1200 ,
  cv::CAP_GIGANETIX = 1300 ,
  cv::CAP_MSMF = 1400 ,
  cv::CAP_WINRT = 1410 ,
  cv::CAP_INTELPERC = 1500 ,
  cv::CAP_REALSENSE = 1500 ,
  cv::CAP_OPENNI2 = 1600 ,
  cv::CAP_OPENNI2_ASUS = 1610 ,
  cv::CAP_OPENNI2_ASTRA = 1620 ,
  cv::CAP_GPHOTO2 = 1700 ,
  cv::CAP_GSTREAMER = 1800 ,
  cv::CAP_FFMPEG = 1900 ,
  cv::CAP_IMAGES = 2000 ,
  cv::CAP_ARAVIS = 2100 ,
  cv::CAP_OPENCV_MJPEG = 2200 ,
  cv::CAP_INTEL_MFX = 2300 ,
  cv::CAP_XINE = 2400 ,
  cv::CAP_UEYE = 2500 ,
  cv::CAP_OBSENSOR = 2600
}
 cv::VideoCapture API 后端标识符。 更多...
 
枚举  cv::VideoCaptureProperties {
  cv::CAP_PROP_POS_MSEC =0 ,
  cv::CAP_PROP_POS_FRAMES =1 ,
  cv::CAP_PROP_POS_AVI_RATIO =2 ,
  cv::CAP_PROP_FRAME_WIDTH =3 ,
  cv::CAP_PROP_FRAME_HEIGHT =4 ,
  cv::CAP_PROP_FPS =5 ,
  cv::CAP_PROP_FOURCC =6 ,
  cv::CAP_PROP_FRAME_COUNT =7 ,
  cv::CAP_PROP_FORMAT =8 ,
  cv::CAP_PROP_MODE =9 ,
  cv::CAP_PROP_BRIGHTNESS =10 ,
  cv::CAP_PROP_CONTRAST =11 ,
  cv::CAP_PROP_SATURATION =12 ,
  cv::CAP_PROP_HUE =13 ,
  cv::CAP_PROP_GAIN =14 ,
  cv::CAP_PROP_EXPOSURE =15 ,
  cv::CAP_PROP_CONVERT_RGB =16 ,
  cv::CAP_PROP_WHITE_BALANCE_BLUE_U =17 ,
  cv::CAP_PROP_RECTIFICATION =18 ,
  cv::CAP_PROP_MONOCHROME =19 ,
  cv::CAP_PROP_SHARPNESS =20 ,
  cv::CAP_PROP_AUTO_EXPOSURE =21 ,
  cv::CAP_PROP_GAMMA =22 ,
  cv::CAP_PROP_TEMPERATURE =23 ,
  cv::CAP_PROP_TRIGGER =24 ,
  cv::CAP_PROP_TRIGGER_DELAY =25 ,
  cv::CAP_PROP_WHITE_BALANCE_RED_V =26 ,
  cv::CAP_PROP_ZOOM =27 ,
  cv::CAP_PROP_FOCUS =28 ,
  cv::CAP_PROP_GUID =29 ,
  cv::CAP_PROP_ISO_SPEED =30 ,
  cv::CAP_PROP_BACKLIGHT =32 ,
  cv::CAP_PROP_PAN =33 ,
  cv::CAP_PROP_TILT =34 ,
  cv::CAP_PROP_ROLL =35 ,
  cv::CAP_PROP_IRIS =36 ,
  cv::CAP_PROP_SETTINGS =37 ,
  cv::CAP_PROP_BUFFERSIZE =38 ,
  cv::CAP_PROP_AUTOFOCUS =39 ,
  cv::CAP_PROP_SAR_NUM =40 ,
  cv::CAP_PROP_SAR_DEN =41 ,
  cv::CAP_PROP_BACKEND =42 ,
  cv::CAP_PROP_CHANNEL =43 ,
  cv::CAP_PROP_AUTO_WB =44 ,
  cv::CAP_PROP_WB_TEMPERATURE =45 ,
  cv::CAP_PROP_CODEC_PIXEL_FORMAT =46 ,
  cv::CAP_PROP_BITRATE =47 ,
  cv::CAP_PROP_ORIENTATION_META =48 ,
  cv::CAP_PROP_ORIENTATION_AUTO =49 ,
  cv::CAP_PROP_HW_ACCELERATION =50 ,
  cv::CAP_PROP_HW_DEVICE =51 ,
  cv::CAP_PROP_HW_ACCELERATION_USE_OPENCL =52 ,
  cv::CAP_PROP_OPEN_TIMEOUT_MSEC =53 ,
  cv::CAP_PROP_READ_TIMEOUT_MSEC =54 ,
  cv::CAP_PROP_STREAM_OPEN_TIME_USEC =55 ,
  cv::CAP_PROP_VIDEO_TOTAL_CHANNELS = 56 ,
  cv::CAP_PROP_VIDEO_STREAM = 57 ,
  cv::CAP_PROP_AUDIO_STREAM = 58 ,
  cv::CAP_PROP_AUDIO_POS = 59 ,
  cv::CAP_PROP_AUDIO_SHIFT_NSEC = 60 ,
  cv::CAP_PROP_AUDIO_DATA_DEPTH = 61 ,
  cv::CAP_PROP_AUDIO_SAMPLES_PER_SECOND = 62 ,
  cv::CAP_PROP_AUDIO_BASE_INDEX = 63 ,
  cv::CAP_PROP_AUDIO_TOTAL_CHANNELS = 64 ,
  cv::CAP_PROP_AUDIO_TOTAL_STREAMS = 65 ,
  cv::CAP_PROP_AUDIO_SYNCHRONIZE = 66 ,
  cv::CAP_PROP_LRF_HAS_KEY_FRAME = 67 ,
  cv::CAP_PROP_CODEC_EXTRADATA_INDEX = 68 ,
  cv::CAP_PROP_FRAME_TYPE = 69 ,
  cv::CAP_PROP_N_THREADS = 70 ,
  cv::CAP_PROP_PTS = 71 ,
  cv::CAP_PROP_DTS_DELAY = 72
}
 cv::VideoCapture 通用属性标识符。 更多...
 
枚举  cv::VideoWriterProperties {
  cv::VIDEOWRITER_PROP_QUALITY = 1 ,
  cv::VIDEOWRITER_PROP_FRAMEBYTES = 2 ,
  cv::VIDEOWRITER_PROP_NSTRIPES = 3 ,
  cv::VIDEOWRITER_PROP_IS_COLOR = 4 ,
  cv::VIDEOWRITER_PROP_DEPTH = 5 ,
  cv::VIDEOWRITER_PROP_HW_ACCELERATION = 6 ,
  cv::VIDEOWRITER_PROP_HW_DEVICE = 7 ,
  cv::VIDEOWRITER_PROP_HW_ACCELERATION_USE_OPENCL = 8 ,
  cv::VIDEOWRITER_PROP_RAW_VIDEO = 9 ,
  cv::VIDEOWRITER_PROP_KEY_INTERVAL = 10 ,
  cv::VIDEOWRITER_PROP_KEY_FLAG = 11 ,
  cv::VIDEOWRITER_PROP_PTS = 12 ,
  cv::VIDEOWRITER_PROP_DTS_DELAY = 13
}
 cv::VideoWriter 通用属性标识符。 更多...
 

枚举类型文档

◆ VideoCaptureAPIs

#include <opencv2/videoio.hpp>

cv::VideoCapture API 后端标识符。

为捕获对象选择首选API。用于 VideoCapture::VideoCapture() 构造函数或 VideoCapture::open()

注意
枚举器
CAP_ANY 
Python: cv.CAP_ANY

自动检测 == 0。

CAP_VFW 
Python: cv.CAP_VFW

适用于 Windows 的视频(已废弃,已移除)

CAP_V4L 
Python: cv.CAP_V4L

V4L/V4L2 捕获支持。

CAP_V4L2 
Python: cv.CAP_V4L2

与 CAP_V4L 相同。

CAP_FIREWIRE 
Python: cv.CAP_FIREWIRE

IEEE 1394 驱动程序。

CAP_FIREWARE 
Python: cv.CAP_FIREWARE

与 CAP_FIREWIRE 值相同。

CAP_IEEE1394 
Python: cv.CAP_IEEE1394

与 CAP_FIREWIRE 值相同。

CAP_DC1394 
Python: cv.CAP_DC1394

与 CAP_FIREWIRE 值相同。

CAP_CMU1394 
Python: cv.CAP_CMU1394

与 CAP_FIREWIRE 值相同。

CAP_QT 
Python: cv.CAP_QT

QuickTime(已废弃,已移除)

CAP_UNICAP 
Python: cv.CAP_UNICAP

Unicap 驱动程序(已废弃,已移除)

CAP_DSHOW 
Python: cv.CAP_DSHOW

DirectShow(通过 videoInput)

CAP_PVAPI 
Python: cv.CAP_PVAPI

PvAPI, Prosilica GigE SDK。

CAP_OPENNI 
Python: cv.CAP_OPENNI

OpenNI(适用于 Kinect)

CAP_OPENNI_ASUS 
Python: cv.CAP_OPENNI_ASUS

OpenNI(适用于 Asus Xtion)

CAP_ANDROID 
Python: cv.CAP_ANDROID

适用于 Android 的 MediaNDK (API Level 21+) 和 NDK Camera (API level 24+)。

CAP_XIAPI 
Python: cv.CAP_XIAPI

XIMEA 摄像机 API。

CAP_AVFOUNDATION 
Python: cv.CAP_AVFOUNDATION

适用于 iOS 的 AVFoundation 框架(OS X Lion 将具有相同的 API)

CAP_GIGANETIX 
Python: cv.CAP_GIGANETIX

Smartek Giganetix GigEVisionSDK。

CAP_MSMF 
Python: cv.CAP_MSMF

Microsoft Media Foundation(通过 videoInput)。请参阅上面的平台特定说明。

CAP_WINRT 
Python: cv.CAP_WINRT

使用 Media Foundation 的 Microsoft Windows Runtime。

CAP_INTELPERC 
Python: cv.CAP_INTELPERC

RealSense(原 Intel 感知计算 SDK)

CAP_REALSENSE 
Python: cv.CAP_REALSENSE

CAP_INTELPERC 的同义词。

CAP_OPENNI2 
Python: cv.CAP_OPENNI2

OpenNI2(适用于 Kinect)

CAP_OPENNI2_ASUS 
Python: cv.CAP_OPENNI2_ASUS

OpenNI2(适用于 Asus Xtion 和 Occipital Structure 传感器)

CAP_OPENNI2_ASTRA 
Python: cv.CAP_OPENNI2_ASTRA

OpenNI2(适用于 Orbbec Astra)

CAP_GPHOTO2 
Python: cv.CAP_GPHOTO2

gPhoto2 连接

CAP_GSTREAMER 
Python: cv.CAP_GSTREAMER

GStreamer。

CAP_FFMPEG 
Python: cv.CAP_FFMPEG

使用 FFMPEG 库打开和录制视频文件或流。

CAP_IMAGES 
Python: cv.CAP_IMAGES

OpenCV 图像序列(例如 img_%02d.jpg)

CAP_ARAVIS 
Python: cv.CAP_ARAVIS

Aravis SDK。

CAP_OPENCV_MJPEG 
Python: cv.CAP_OPENCV_MJPEG

内置 OpenCV MotionJPEG 编解码器。

CAP_INTEL_MFX 
Python: cv.CAP_INTEL_MFX

Intel MediaSDK。

CAP_XINE 
Python: cv.CAP_XINE

XINE 引擎(Linux)

CAP_UEYE 
Python: cv.CAP_UEYE

uEye 摄像机 API

CAP_OBSENSOR 
Python: cv.CAP_OBSENSOR

适用于 Orbbec 3D 传感器设备/模块(Astra+、Femto、Astra2、Gemini2、Gemini2L、Gemini2XL、Gemini330、Femto Mega)。注意:Astra2 摄像机目前仅支持 Windows 和 Linux 内核版本不高于 4.15,更高版本的 Linux 内核可能会出现异常。

◆ VideoCaptureProperties

#include <opencv2/videoio.hpp>

cv::VideoCapture 通用属性标识符。

读/写属性涉及多个层面。在此链中可能会发生一些意外结果。实际行为取决于设备硬件、驱动程序和 API 后端。

另请参见
视频 I/O API 后端的附加标志VideoCapture::get()VideoCapture::set()
枚举器
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。
GStreamer 注意:如果使用自定义管道,此标志将被忽略。用户有责任解释管道输出。

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 帧不按显示顺序解码。

◆ VideoWriterProperties

#include <opencv2/videoio.hpp>

cv::VideoWriter 通用属性标识符。

另请参见
VideoWriter::get(), VideoWriter::set()
枚举器
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()

注意
如果关键帧间隔不为 1,则必须由用户手动指定。这可以在初始化期间将 VIDEOWRITER_PROP_KEY_INTERVAL 作为额外编码器参数之一传递给 VideoWriter::VideoWriter(const String &, int, double, const Size &, const std::vector< int > ¶ms) 来完成,或者在写入每帧之前通过 VideoWriter::set() 设置 VIDEOWRITER_PROP_KEY_FLAG 来完成。仅限 FFMpeg 后端。
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 后端。