视频 I/O 标志

详细说明

枚举
enum	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 后端标识符。 更多...
enum	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 通用属性标识符。 更多...
enum	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 通用属性标识符。 更多...

枚举类型文档 (Enumeration Type Documentation)

VideoCaptureAPIs

enum cv::VideoCaptureAPIs

#include <opencv2/videoio.hpp>

cv::VideoCapture API 后端标识符。

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

注意

• 后端仅在与您的 OpenCV 二进制文件构建时可用。有关更多信息，请参阅 OpenCV 视频 I/O 概览。
• Microsoft Media Foundation 后端尝试使用硬件加速转换（如果可能）。环境变量“OPENCV_VIDEOIO_MSMF_ENABLE_HW_TRANSFORMS”设置为 0 会禁用它，并可能缩短初始化时间。更多详情：https://learn.microsoft.com/en-us/windows/win32/medfound/mf-readwrite-enable-hardware-transforms

枚举值 (Enumerator)
CAP_ANY  Python: cv.CAP_ANY	自动检测 == 0。
CAP_VFW  Python: cv.CAP_VFW	Video For 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 Perceptual Computing 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

enum cv::VideoCaptureProperties

#include <opencv2/videoio.hpp>

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

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

另请参阅

其他视频 I/O API 后端标志，VideoCapture::get()，VideoCapture::set()

枚举值 (Enumerator)
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	布尔标志，指示是否应将图像转换为 BGR。 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/s
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，如果存在多个）。设备枚举是加速类型特定的。
CAP_PROP_HW_ACCELERATION_USE_OPENCL  Python: cv.CAP_PROP_HW_ACCELERATION_USE_OPENCL	(仅打开时) 如果非零，则创建新的 OpenCL 上下文并将其绑定到当前线程。与视频加速上下文创建的 OpenCL 上下文（如果尚未附加）附加，以优化 GPU 数据在硬件加速解码器和 cv::UMat 之间的复制。
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) 调用之前）包含关键帧的编码数据。
CAP_PROP_CODEC_EXTRADATA_INDEX  Python: cv.CAP_PROP_CODEC_EXTRADATA_INDEX	正索引表示视频后端支持返回额外数据。这可以通过 cap.retrieve(data, <returned index>) 检索。例如，当从 h264 编码的 RTSP 流读取时，FFmpeg 后端可以通过 cap.retrieve(data, <returned index>) 调用返回 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

enum cv::VideoWriterProperties

#include <opencv2/videoio.hpp>

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

另请参阅

VideoWriter::get(), VideoWriter::set()

枚举值 (Enumerator)
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，如果存在多个）。设备枚举是加速类型特定的。
VIDEOWRITER_PROP_HW_ACCELERATION_USE_OPENCL  Python: cv.VIDEOWRITER_PROP_HW_ACCELERATION_USE_OPENCL	(仅打开时) 如果非零，则创建新的 OpenCL 上下文并将其绑定到当前线程。与视频加速上下文创建的 OpenCL 上下文（如果尚未附加）附加，以优化 cv::UMat 和硬件加速编码器之间的数据复制。
VIDEOWRITER_PROP_RAW_VIDEO  Python: cv.VIDEOWRITER_PROP_RAW_VIDEO	(仅打开时) 设置为非零以启用编码的原始视频流的封装。每个原始编码视频帧应通过 VideoWriter::write() 作为 CV_8UC1 Mat 的单行或单列传递。 注意 如果关键帧间隔不为 1，则必须由用户手动指定。这可以在初始化时通过将 VIDEOWRITER_PROP_KEY_INTERVAL 作为附加编码器参数之一传递给 VideoWriter::VideoWriter(const String &, int, double, const Size &, const std::vector< int > &params) 来完成，或者在写入每帧之前使用 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 后端。