DirectShow DirectShow 레퍼런스 인터페이스 IBasicVideo [목차열람] [주소복사] [슬롯비우기] |
Microsoft DirectX 9.0 |
IBasicVideo 인터페이스를 사용하면 애플리케이션으로 목적지 직사각형, 전송원직사각형등의 비디오 프로퍼티를 설정할 수 있다. 이 인터페이스는비디오 렌더러 필터에 처리 되지만, 필터 그래프 매니저로 애플리케이션에 공개된다. 애플리케이션은, 항상 필터 그래프 매니저로부터 이 인터페이스를 얻어올 필요가 있다.
이 인터페이스의 메서드를 사용하는 경우, 비디오 렌더러가 접속되고 있을 필요가 있다. 비디오가 접속되지 않은 경우는, 모든 메서드가 VFW_E_NOT_CONNECTED 를 돌려준다. 비디오 렌더러로 설정된 프로퍼티는, 연속한 접속과 접속 해제동안에서 보관 유지된다.
IBasicVideo 인터페이스는, 비디오 이미지에 관련하는 다음의 직사각형을 조작한다.
전송원직사각형이란 원의 이미지로 표시되는 부분이다.
목적지직사각형이란 비디오 윈도우로 전송원직사각형을 받는 부분이다.
비디오직사각형이란 원의 비디오 이미지이다.
즉, 비디오 렌더러는 이미지를 전송원직사각형에 맞추어 트리밍 해, 트리밍 한 직사각형을 목적지 직사각형에 맞추어 확대 또는 축소한다. 직사각형의 사이즈는 모두 픽셀 단위로 지정한다.
IBasicVideo 인터페이스는,IDispatch 로부터 계승하는 메서드 이외에 이하의 메서드도 공개한다.
메서드 | 설명 |
get_AvgTimePerFrame | 연속하는 프레임간의 평균 시간을 얻어온다. |
get_BitErrorRate | 비디오 스트림의 대체로의 비트 에러 레이트를 얻어온다. |
get_BitRate | 비디오 스트림의 대체로의 bit rate를 얻어온다. |
get_DestinationHeight | 목적지 직사각형의 높이를 얻어온다. |
get_DestinationLeft | 목적지 직사각형의 x 좌표를 얻어온다. |
get_DestinationTop | 목적지 직사각형의 y 좌표를 얻어온다. |
get_DestinationWidth | 목적지 직사각형의 폭을 얻어온다. |
get_SourceHeight | 전송원직사각형의 높이를 얻어온다. |
get_SourceLeft | 전송원직사각형의 x 좌표를 얻어온다. |
get_SourceTop | 전송원직사각형의 y 좌표를 얻어온다. |
get_SourceWidth | 전송원직사각형의 폭을 얻어온다. |
get_VideoHeight | 비디오의 높이를 얻어온다. |
get_VideoWidth | 비디오의 폭을 얻어온다. |
GetCurrentImage | 렌더러로 대기하고 있는 현재의 이미지의 복사를 돌려준다. |
GetDestinationPosition | 목적지 직사각형을 얻어온다. |
GetSourcePosition | 전송원직사각형을 얻어온다. |
GetVideoPaletteEntries | 비디오가 필요로 하는 컬러 팔레트 엔트리를 얻어온다. |
GetVideoSize | 비디오의 본래의 사이즈를 얻어온다. |
IsUsingDefaultDestination | 렌더러가 디폴트의 목적지 직사각형을 사용하고 있는지를 문의한다. |
IsUsingDefaultSource | 렌더러가 디폴트의 전송원직사각형을 사용하고 있는지를 문의한다. |
put_DestinationHeight | 목적지 직사각형의 높이를 설정한다. |
put_DestinationLeft | 목적지 직사각형의 x 좌표를 설정한다. |
put_DestinationTop | 목적지 직사각형의 y 좌표를 설정한다. |
put_DestinationWidth | 목적지 직사각형의 폭을 설정한다. |
put_SourceHeight | 비디오 직사각형의 높이를 설정한다. |
put_SourceLeft | 전송원직사각형의 x 좌표를 설정한다. |
put_SourceTop | 전송원직사각형의 y 좌표를 설정한다. |
put_SourceWidth | 전송원직사각형의 폭을 설정한다. |
SetDefaultDestinationPosition | 디폴트의 목적지 직사각형에 돌아온다. |
SetDefaultSourcePosition | 디폴트의 전송원직사각형에 돌아온다. |
SetDestinationPosition | 목적지 직사각형을 설정한다. |
SetSourcePosition | 전송원직사각형을 설정한다. |