enum cv::VideoCaptureProperties

Overview

VideoCapture generic properties identifier. More…

#include <videoio.hpp>

enum VideoCaptureProperties
{
    CAP_PROP_POS_MSEC             =0,
    CAP_PROP_POS_FRAMES           =1,
    CAP_PROP_POS_AVI_RATIO        =2,
    CAP_PROP_FRAME_WIDTH          =3,
    CAP_PROP_FRAME_HEIGHT         =4,
    CAP_PROP_FPS                  =5,
    CAP_PROP_FOURCC               =6,
    CAP_PROP_FRAME_COUNT          =7,
    CAP_PROP_FORMAT               =8,
    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,
    CAP_PROP_WHITE_BALANCE_BLUE_U =17,
    CAP_PROP_RECTIFICATION        =18,
    CAP_PROP_MONOCHROME           =19,
    CAP_PROP_SHARPNESS            =20,
    CAP_PROP_AUTO_EXPOSURE        =21,
    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,
    CAP_PROP_BACKLIGHT            =32,
    CAP_PROP_PAN                  =33,
    CAP_PROP_TILT                 =34,
    CAP_PROP_ROLL                 =35,
    CAP_PROP_IRIS                 =36,
    CAP_PROP_SETTINGS             =37,
    CAP_PROP_BUFFERSIZE           =38,
    CAP_PROP_AUTOFOCUS            =39,
};

Detailed Documentation

VideoCapture generic properties identifier.

Reading / writing properties involves many layers. Some unexpected result might happens along this chain. Effective behaviour depends from device hardware, driver and API Backend.

See also:

Additional flags for video I/O API backends, VideoCapture::get(), VideoCapture::set()

Enum Values

CAP_PROP_POS_MSEC

Current position of the video file in milliseconds.

CAP_PROP_POS_FRAMES

0-based index of the frame to be decoded/captured next.

CAP_PROP_POS_AVI_RATIO

Relative position of the video file: 0=start of the film, 1=end of the film.

CAP_PROP_FRAME_WIDTH

Width of the frames in the video stream.

CAP_PROP_FRAME_HEIGHT

Height of the frames in the video stream.

CAP_PROP_FPS

Frame rate.

CAP_PROP_FOURCC

4-character code of codec. see VideoWriter::fourcc.

CAP_PROP_FRAME_COUNT

Number of frames in the video file.

CAP_PROP_FORMAT

Format of the Mat objects returned by VideoCapture::retrieve().

CAP_PROP_MODE

Backend-specific value indicating the current capture mode.

CAP_PROP_BRIGHTNESS

Brightness of the image (only for those cameras that support).

CAP_PROP_CONTRAST

Contrast of the image (only for cameras).

CAP_PROP_SATURATION

Saturation of the image (only for cameras).

CAP_PROP_HUE

Hue of the image (only for cameras).

CAP_PROP_GAIN

Gain of the image (only for those cameras that support).

CAP_PROP_EXPOSURE

Exposure (only for those cameras that support).

CAP_PROP_CONVERT_RGB

Boolean flags indicating whether images should be converted to RGB.

CAP_PROP_WHITE_BALANCE_BLUE_U

Currently unsupported.

CAP_PROP_RECTIFICATION

Rectification flag for stereo cameras (note: only supported by DC1394 v 2.x backend currently).

CAP_PROP_AUTO_EXPOSURE

DC1394: exposure control done by camera, user can adjust reference level using this feature.

CAP_PROP_SETTINGS

Pop up video/camera filter dialog (note: only supported by DSHOW backend currently. The property value is ignored)