현재 열려 있는 카메라 장치 또는 동영상 파일로부터 여러 가지 정보를 받아 오기 위해서는 VideoCapture::get() 함수를 사용합니다.
double VideoCapture::get(int propId) const; |
|
• propId |
속성 ID. VideoCaptureProperties 열거형 중 하나를 지정합니다. |
• 반환값 |
지정한 속성 값. 만약 지정한 속성을 얻을 수 없으면 0을 반환합니다. |
VideoCapture::get() 함수는 인자로 지정한 속성 ID(propId)에 해당하는 속성 값을 반환합니다. VideoCapture::get() 함수의 인자로 지정할 수 있는 속성 ID는 VideoCaptureProperties 열거형 상수 중 하나를 지정할 수 있으며, 자주 사용되는 상수와 의미를 표 4-2에 정리했습니다. 표 4-2에 열거된 상수 중에는 동영상 파일에서만 동작하는 속성도 있고, 카메라에 대해서만 사용할 수 있는 속성도 있습니다. 몇몇 속성은 실제 사용하는 카메라 하드웨어와 드라이버가 지원해야 동작하는 속성도 있습니다. 표 4-2에 열거한 속성은 OpenCV에서 지원하는 많은 속성 중 일부이며, 전체 속성은 OpenCV 문서 사이트를 참고하기 바랍니다.
▼ 표 4-2 주요 VideoCaptureProperties 열거형 상수
VideoCaptureProperties 열거형 상수 |
설명 |
CAP_PROP_POS_MSEC |
비디오 파일에서 현재 위치(밀리초 단위) |
CAP_PROP_POS_FRAMES |
현재 프레임 위치(0-기반) |
CAP_PROP_POS_AVI_RATIO |
[0, 1] 구간으로 표현한 동영상 프레임의 상대적 위치(0: 시작, 1: 끝) |
CAP_PROP_FRAME_WIDTH |
비디오 프레임의 가로 크기 |
CAP_PROP_FRAME_HEIGHT |
비디오 프레임의 세로 크기 |
CAP_PROP_FPS |
초당 프레임 수 |
CAP_PROP_FOURCC |
fourcc 코드(코덱을 표현하는 정수 값) |
CAP_PROP_FRAME_COUNT |
비디오 파일의 전체 프레임 수 |
CAP_PROP_BRIGHTNESS |
(카메라에서 지원하는 경우) 밝기 조절 |
CAP_PROP_CONTRAST |
(카메라에서 지원하는 경우) 명암비 조절 |
CAP_PROP_SATURATION |
(카메라에서 지원하는 경우) 채도 조절 |
CAP_PROP_HUE |
(카메라에서 지원하는 경우) 색상 조절 |
CAP_PROP_GAIN |
(카메라에서 지원하는 경우) 감도 조절 |
CAP_PROP_EXPOSURE |
(카메라에서 지원하는 경우) 노출 조절 |
CAP_PROP_ZOOM |
(카메라에서 지원하는 경우) 줌 조절 |
CAP_PROP_FOCUS |
(카메라에서 지원하는 경우) 초점 조절 |