VideoCapture类常用API个人总结

一下“#”后的内容皆为注释

相关API :

1、创建Video Capture类的构造函数：

C++: VideoCapture::VideoCapture()# VideoCapture video（0）（此为默认使用电脑自带摄像头）
C++: VideoCapture::VideoCapture(const string& filename)#VideoCapture video（“1.avi”）
C++: VideoCapture::VideoCapture(int device)#VideoCapture video(1/2/3) (有多个摄像头时可用1、2、3使用不同摄像头)

参数:
filename – 打开的视频文件名。
device – 打开的视频捕获设备id ，如果只有一个摄像头可以填0，表示打开默认的摄像头。 

2、其他相关API

C++: bool VideoCapture::open(const string& filename) #先实例化再初始化：VideoCapture capture;capture.open("dog.avi");在实例化的同时进行初始化：VideoCapture("dog.avi");
C++: bool VideoCapture::open(int device) #device – 打开的视频捕获设备id ，如果只有一个摄像头可以填0，表示打开默认的摄像头。
C++: bool VideoCapture::isOpened()#功能：判断视频读取或者摄像头调用是否成功，成功则返回true。
C++: void VideoCapture::release() #关闭视频文件或摄像头。
C++: bool VideoCapture::grab() #功能：从视频文件或捕获设备中抓取下一个帧，假如调用成功返回true。
C++: bool VideoCapture::retrieve(Mat& image, int channel=0) #功能：解码并且返回刚刚抓取的视频帧，假如没有视频帧被捕获（相机没有连接或者视频文件中没有更多的帧）将返回false。
C++: bool VideoCapture::read(Mat& image) #功能：该函数结合VideoCapture::grab()和VideoCapture::retrieve()其中之一被调用，用于捕获、解码和返回下一个视频帧这是一个最方便的函数
                    对于读取视频文件或者捕获数据从解码和返回刚刚捕获的帧，假如没有视频帧被捕获（相机没有连接或者视频文件中没有更多的帧）将返回false。
C++: double VideoCapture::get(int propId) #功能：一个视频有很多属性，比如：帧率、总帧数、尺寸、格式等，VideoCapture的get方法可以获取这些属性。Note: 
                    如果查询的视频属性是VideoCapture类不支持的，将会返回0。见附录1。//get()是获取
C++: bool VideoCapture::set(int propertyId, double value) #功能：设置VideoCapture类的属性，设置成功返回ture,失败返回false。参数：第一个是属性ID，第二个是该属性要设置的值。//set()是设置

附录1：
VideoCapture::get() / set() (设置是永久改变的)参数

常用：
CV_CAP_PROP_FRAME_WIDTH 视频流帧的宽度/一帧图像的宽度
CV_CAP_PROP_FRAME_HEIGHT 视频流帧的高./一帧图像的高度
CV_CAP_PROP_FPS 帧率.
CV_CAP_PROP_FRAME_COUNT 视频文件的帧数.
CV_CAP_PROP_BRIGHTNESS 图像亮度 (只对摄像头).
CV_CAP_PROP_CONTRAST 图像对比度 (只对摄像头).
CV_CAP_PROP_SATURATION 图像饱和度 (只对摄像头).
CV_CAP_PROP_HUE 色调 (只对摄像头).
CV_CAP_PROP_GAIN 增益(只对摄像头).
CV_CAP_PROP_EXPOSURE 曝光(只对摄像头).

不常用：
CV_CAP_PROP_POS_MSEC 视频当前点的毫秒值或视频捕捉的时间戳
CV_CAP_PROP_POS_FRAMES 下次将被捕获的0基索引的帧
CV_CAP_PROP_POS_AVI_RATIO 视频文件的相关位置: 0 - 视频开始, 1 - 视频结束.
CV_CAP_PROP_FOURCC  4字符编码的编码器.
CV_CAP_PROP_FORMAT 由retrieve()返回矩阵对象的格式 .
CV_CAP_PROP_MODE 后端指定值指示当前捕捉的模式.
CV_CAP_PROP_CONVERT_RGB 布尔型标记图像是否应该被转换为RGB.
CV_CAP_PROP_WHITE_BALANCE 白平衡（目前不支持）
CV_CAP_PROP_RECTIFICATION 立体相机的矫正标记(note: only supported by DC1394 v 2.x backend currently

以上为个人总结的笔记，若有不足多多见谅。