OpenCV摄像头参数说明

vvv97967
已于 2023-09-24 15:12:40 修改
阅读量2.1k
点赞数 3
文章标签：数码相机 opencv 计算机视觉 python
于 2023-09-24 12:37:34 首次发布
带 “#” 的为原文上没有注释，个人加上去的，可能会有错误
来源：opencv/modules/videoio/include/opencv2/videoio.hpp at master · opencv/opencv (github.com)
使用方法参考这篇文章：
CAP_PROP_POS_MSEC       =0,  视频文件当前位置，以毫秒为单位。
CAP_PROP_POS_FRAMES     =1,  下一个要解码/捕获的帧的0为基础的索引。
CAP_PROP_POS_AVI_RATIO  =2,  视频文件的相对位置：0=电影开始，1=电影结束。
CAP_PROP_FRAME_WIDTH    =3,  视频流中帧的宽度。
CAP_PROP_FRAME_HEIGHT   =4,  视频流中帧的高度。
CAP_PROP_FPS            =5,  帧速率。
CAP_PROP_FOURCC         =6,  编解码器的4字符代码。请参考 VideoWriter::fourcc 。
CAP_PROP_FRAME_COUNT    =7,  视频文件中的帧数。
CAP_PROP_FORMAT         =8,  由 VideoCapture::retrieve() 返回的 %Mat 对象的格式(参见 Mat::type())。设定值 -1 以获取未解码的RAW视频流(作为Mat 8UC1)。
CAP_PROP_MODE           =9,  指示当前捕获模式的后端特定值。
CAP_PROP_BRIGHTNESS    =10,  图像的亮度(仅适用于支持的相机)。
CAP_PROP_CONTRAST      =11,  图像的对比度(仅适用于相机)。
CAP_PROP_SATURATION    =12,  图像的饱和度(仅适用于相机)。
CAP_PROP_HUE           =13,  图像的色调(仅适用于相机)。
CAP_PROP_GAIN          =14,  图像的增益(仅适用于支持的相机)。
CAP_PROP_EXPOSURE      =15,  曝光(仅适用于支持的相机)。
CAP_PROP_CONVERT_RGB   =16,  布尔标志，指示图像是否应转换为RGB。
                             *GStreamer注释*：在使用自定义管道的情况下，此标志将被忽略。解释管道输出是用户的责任。
CAP_PROP_WHITE_BALANCE_BLUE_U =17,  目前不支持。#蓝色通道的白平衡设置。
CAP_PROP_RECTIFICATION =18,  立体摄像头的校正标志(注意：目前仅由DC1394 v 2.x后端支持)。
CAP_PROP_MONOCHROME    =19,	#是否为单色模式（通常用于判断摄像头是否仅捕获灰度图像。
CAP_PROP_SHARPNESS     =20,		#图像的锐度。
CAP_PROP_AUTO_EXPOSURE =21,  DC1394：由相机完成曝光控制，用户可以使用此功能调整参考水平。
CAP_PROP_GAMMA         =22,	#图像的伽玛值。
CAP_PROP_TEMPERATURE   =23,	#白平衡的色温或可能的摄像头温度。
CAP_PROP_TRIGGER       =24,	#触发模式，通常用于外部设备触发摄像头捕获。
CAP_PROP_TRIGGER_DELAY =25,	#触发延迟，通常用于设置外部触发与摄像头捕获之间的时间延迟。
CAP_PROP_WHITE_BALANCE_RED_V =26,		#红色通道的白平衡设置。
CAP_PROP_ZOOM          =27,	#缩放设置，例如用于调整摄像头的焦距。
CAP_PROP_FOCUS         =28,	#聚焦设置。
CAP_PROP_GUID          =29,	#通常是设备的全球唯一标识符。
CAP_PROP_ISO_SPEED     =30,	#ISO速度设置，表示摄像头的感光度。
CAP_PROP_BACKLIGHT     =32,	#背光补偿设置。
CAP_PROP_PAN           =33,	#摄像头的平移设置。
CAP_PROP_TILT          =34,	#摄像头的倾斜设置。
CAP_PROP_ROLL          =35,	#摄像头的旋转设置。
CAP_PROP_IRIS          =36,	#相机的光圈设置。
CAP_PROP_SETTINGS      =37,  弹出视频/相机过滤对话框(注意：目前仅由DSHOW后端支持。属性值被忽略)
CAP_PROP_BUFFERSIZE    =38,	 #缓冲区大小，可能表示摄像头内部缓冲的帧数。
CAP_PROP_AUTOFOCUS     =39,	 #自动对焦设置。
CAP_PROP_SAR_NUM       =40,  样本宽高比：num/den (num)
CAP_PROP_SAR_DEN       =41,  样本宽高比：num/den (den)
CAP_PROP_BACKEND       =42,  当前后端(enum VideoCaptureAPIs)。只读属性
CAP_PROP_CHANNEL       =43,  视频输入或通道号(仅适用于支持的相机)
CAP_PROP_AUTO_WB       =44,  启用/禁用自动白平衡
CAP_PROP_WB_TEMPERATURE=45,  白平衡色温
CAP_PROP_CODEC_PIXEL_FORMAT =46,     (只读) 编解码器的像素格式。4字符代码 - 请参考 VideoWriter::fourcc 。[AV_PIX_FMT_*](https://github.com/FFmpeg/FFmpeg/blob/master/libavcodec/raw.c)的子集，或者如果未知则为-1
CAP_PROP_BITRATE       =47,  (只读) 以kbits/s为单位的视频比特率
CAP_PROP_ORIENTATION_META=48,  (只读) 由流元数据定义的帧旋转(仅适用于FFmpeg和AVFoundation后端)
CAP_PROP_ORIENTATION_AUTO=49,  如果为真 - 考虑视频文件的元数据旋转CvCapture的输出帧 (仅适用于FFmpeg和AVFoundation后端) (https://github.com/opencv/opencv/issues/15499)
CAP_PROP_HW_ACCELERATION=50,  (**仅开放**) 硬件加速类型 (参见 #VideoAccelerationType)。仅通过cv::VideoCapture构造函数中的`params`参数或.open()方法设置。默认值是后端特定的。
CAP_PROP_HW_DEVICE      =51,  (**仅开放**) 硬件设备索引(如果有多个可用，则选择GPU)。设备枚举是加速类型特定的。
CAP_PROP_HW_ACCELERATION_USE_OPENCL=52,  (**仅开放**) 如果非零，则创建新的OpenCL上下文并绑定到当前线程。创建的OpenCL上下文附带了视频加速上下文(如果尚未附加)，以优化GPU数据在硬件加速解码器和cv::UMat之间的复制。
CAP_PROP_OPEN_TIMEOUT_MSEC=53,  (**仅开放**) 打开视频捕获的超时时间(毫秒) (仅适用于FFmpeg和GStreamer后端)
CAP_PROP_READ_TIMEOUT_MSEC=54,  (**仅开放**) 从视频捕获中读取的超时时间(毫秒) (仅适用于FFmpeg和GStreamer后端)
CAP_PROP_STREAM_OPEN_TIME_USEC =55,  (只读) 自1970年1月1日起，流打开的微秒时间。仅适用于FFmpeg后端。对于RTSP和其他实时流非常有用
CAP_PROP_VIDEO_TOTAL_CHANNELS = 56,  (只读) 视频通道数。
CAP_PROP_VIDEO_STREAM = 57,  (**仅开放**) 指定视频流，基于0的索引。使用-1禁用文件或IP摄像头的视频流。默认值为0。
CAP_PROP_AUDIO_STREAM = 58,  (**仅开放**) 在多语言媒体文件中指定流，-1 - 禁用音频处理或麦克风。默认值是-1。
CAP_PROP_AUDIO_POS = 59,  (只读) 音频位置以样本为单位。精确的音频样本时间戳，用于之前抓取的片段。请参阅CAP_PROP_AUDIO_SAMPLES_PER_SECOND和CAP_PROP_AUDIO_SHIFT_NSEC。
CAP_PROP_AUDIO_SHIFT_NSEC = 60,  (仅读取) 音频流和视频流开始之间的时间差，以纳秒为单位。正值意味着音频在第一帧视频之后开始。负值意味着音频在第一帧视频之前开始。
CAP_PROP_AUDIO_DATA_DEPTH = 61,  (开放，读) 位每样本的替代定义，但明确处理32F / 32S
CAP_PROP_AUDIO_SAMPLES_PER_SECOND = 62,  (开放，读) 从文件/编解码器输入确定。如果未指定，则选择的音频采样率为44100
CAP_PROP_AUDIO_BASE_INDEX = 63,  (只读) .retrieve()调用的第一个音频通道的索引。该音频通道号在视频通道后继续枚举。
CAP_PROP_AUDIO_TOTAL_CHANNELS = 64,  (只读) 选定音频流中的音频通道数(单声道、立体声等)。
CAP_PROP_AUDIO_TOTAL_STREAMS = 65,  (只读) 音频流数。
CAP_PROP_AUDIO_SYNCHRONIZE = 66,  (开放，读) 启用音频同步。
CAP_PROP_LRF_HAS_KEY_FRAME = 67,  仅FFmpeg后端 - 指示最后一个原始帧(LRF)，当VideoCapture初始化为VideoCapture::open(CAP_FFMPEG, {CAP_PROP_FORMAT, -1})或在第一次调用VideoCapture::read()之前调用VideoCapture::set(CAP_PROP_FORMAT,-1)时，输出是否包含关键帧的编码数据。
CAP_PROP_CODEC_EXTRADATA_INDEX = 68,  正索引表示视频后端支持返回额外数据。可以作为cap.retrieve(data, <returned index>)检索。例如，当从h264编码的RTSP流中读取时，FFmpeg后端可以返回SPS和/或PPS(如果可用)(如果响应描述请求发送)，从cap.retrieve(data, <returned index>)调用中返回。
CAP_PROP_FRAME_TYPE = 69,  (只读) 仅FFmpeg后端 - 最近读取的帧的帧类型ascii代码 (73 = 'I', 80 = 'P', 66 = 'B' 或 63 = '?' 如果未知)。
CAP_PROP_N_THREADS = 70,  (**仅开放**) 设置要使用的最大线程数。使用0使用与CPU核心一样多的线程(仅适用于FFmpeg后端)。