DirectShow DirectShow 레퍼런스 DirectShow base class base class 레퍼런스 CDrawImage   [목차열람] [주소복사] [슬롯비우기]

CDrawImage 클래스

CDrawImage 클래스는, 비디오 렌더러 필터의 드로잉(Drawing)를 관리하는 헬퍼-클래스이다. 모든 드로잉(Drawing) 조작을 GDI 를 사용해 실행한다. 이 클래스는 DirectDraw 에 의한 렌더링을 지원 하지 않는다. CDrawImage 클래스에서는, 비디오 윈도우를 관리하는 오너 필터도 CBaseWindow 클래스를 사용하고 있을 필요가 있다. CDrawImage 생성자은,CBaseWindow 개체의 포인터를 받는다.

다음 그림은 커스텀 비디오 렌더러 필터에 있어서의 이 클래스의 바람직한 사용 방법을 나타내고 있다.

이 클래스의 사용 방법은 다음대로.

• 핀을 접속 할 때CDrawImage::NotifyMediaType 메서드와 CDrawImage::NotifyAllocator 메서드를 호출한다.
• 미디어 타입이 변화했을 때는,NotifyMediaType 를 다시 호출한다.
• 렌더링을 하기 전에,CDrawImage::SetDrawContext 를 호출한다.
• 전송원직사각형이 변화했을 때는 CDrawImage::SetSourceRect 를, 목적지 직사각형이 변화했을 때는 CDrawImage::SetTargetRect 를 호출한다.
• 팔레트화 된 이미지용의 팔레트를 관리한다. 이것에 대해서는, 이 후의 팔레트에 관한 섹션으로 설명한다.

할당자

위의 그림에 나타낸 필터는, 커스텀 할당자 클래스인 CImageAllocator 를 사용하고 있다. 이 할당자는, GDI 함수 CreateDIBSection 를 사용해 공유 메모리에 DIB 를 생성 한다. 이 할당자로 생성 한 샘플은 CImageSample 개체이다.

필터가 접속을 위한 할당자를 소유하고 있는 경우, 미디어 샘플은 확실히 CImageSample 개체이다. 그 경우,CDrawImage 개체는 BitBlt 또는 StretchBlt 를 사용해 드로잉(Drawing)를 최적화할 수 있다. 그 이외의 경우는, 저속의 SetDIBitsToDevice 또는 StretchDIBits 함수를 사용해야 한다. 고속 옵션은 CDrawImage::FastRender 메서드로 처리 해, 저속 옵션은 CDrawImage::SlowRender 메서드로 처리 한다. 이름은 Slow 이지만,SlowRender 에서도 (새로운 하드웨어에서는 특히) 큰 퍼포먼스에의 영향은 없다.

팔레트

드로잉(Drawing)에 FastRender 메서드를 사용해, 이미지가 팔레트화 되고 있는 경우, 필터는 다음과 같이 팔레트를 관리할 필요가 있다.

• CImageSample 클래스에는,DIBDATA 구조체에 저장 된 팔레트의 버전을 나타내는 수치가 포함되어 있다. 이 값은, 할당자가 샘플을 생성 할 경우에 초기화된다.
• CDrawImage 클래스에도, 생성시에 초기화되는 팔레트의 버전 수치가 포함된다.
• 미디어 타입이 팔레트화 된 새로운 포맷으로 바뀔 때마다,CDrawImage::IncrementPaletteVersion 를 호출한다. 이 메서드는 CDrawImage 개체의 팔레트 버전수를 인크리먼트(increment) 한다. 필터가 CImagePalette 클래스를 사용해 팔레트 정보를 관리하는 경우는, 미디어 타입이 변화할 때마다 CImagePalette::PreparePalette 를 호출하는 것만으로 좋다. PreparePalette 메서드는 필요한 경우에 한해서 팔레트의 버전을 인크리먼트(increment) 한다.
• FastRender 메서드는 CDrawImage 의 팔레트의 버전을 샘플의 팔레트의 버전과 비교한다. 샘플의 버전의 수치가 CDrawImage 의 버전의 수치부터 늦는 경우,FastRender 메서드는 CDrawImage::UpdateColourTable 를 호출한다. UpdateColourTable 메서드는, GDI 함수 SetDIBColorTable 를 사용해, 장치 문맥에 컬러 테이블을 설정한다. 게다가 샘플의 팔레트의 버전을 최신 버전수에 갱신한다.
• 핀이 재접속했을 경우, 필터는 CDrawImage::ResetPaletteVersion 를 호출해 팔레트의 버전을 리셋 한다. 핀의 재접속시, 할당자는 모든 샘플을 재할인 맞히고 한다.

요건

헤더 : Winutil.h 로 선언해, Streams.h 를 인클루드 한다.

라이브러리 : Strmbase.lib (리테일 빌드) 또는 Strmbasd.lib (디버그 빌드).