DrawDibBegin 함수(vfw.h)

  • 아티클

DrawDib 함수는 DrawDib DC의 매개 변수를 변경하거나 새 DrawDib DC를 초기화합니다.

구문

BOOL VFWAPI DrawDibBegin(
  HDRAWDIB           hdd,
  HDC                hdc,
  int                dxDst,
  int                dyDst,
  LPBITMAPINFOHEADER lpbi,
  int                dxSrc,
  int                dySrc,
  UINT               wFlags
);

매개 변수

hdd

DrawDib DC에 대한 핸들입니다.

hdc

그리기 위해 DC에 대한 핸들입니다. 이 매개 변수는 선택 사항입니다.

dxDst

대상 사각형의 너비(MM_TEXT 클라이언트 단위)입니다.

dyDst

대상 사각형의 높이(MM_TEXT 클라이언트 단위)입니다.

lpbi

이미지 형식을 포함하는 BITMAPINFOHEADER 구조체에 대한 포인터입니다. DIB의 색 테이블은 이미지 형식을 따르며 biHeight 멤버는 양수 값이어야 합니다.

dxSrc

원본 사각형의 너비(픽셀)입니다.

dySrc

원본 사각형의 높이(픽셀)입니다.

wFlags

함수에 적용 가능한 플래그입니다. 다음 값이 정의됩니다.

값 의미
DDF_ANIMATE 색상표 애니메이션을 허용합니다. 이 값이 있는 경우 DrawDib는 LOGPALETTE 구조체의 palPalEntry 배열 항목에서 PC_RESERVED 설정하여 가능한 한 많은 항목을 예약하며 DrawDibChangePalette 함수를 사용하여 색상표에 애니메이션 효과를 적용할 수 있습니다. 애플리케이션에서 DrawDibDraw 함수와 함께 DrawDibBegin 함수를 사용하는 경우 DrawDibDraw 대신 DrawDibBegin으로 이 값을 설정합니다.
DDF_BACKGROUNDPAL 디스플레이에 사용되는 현재 색상표를 변경하지 않고 백그라운드 작업으로 그리는 데 사용되는 팔레트를 인식합니다. (이 값은 DDF_SAME_HDC 함께 사용할 수 없습니다.)
DDF_BUFFER DrawDib에서 화면 끄기 버퍼를 사용하려고 하면 DDF_UPDATE 사용할 수 있습니다. 이렇게 하면 압축 해제 및 화면에 직접 그리기를 사용할 수 없습니다. DrawDib에서 화면 외부 버퍼를 만들 수 없는 경우 압축을 풀거나 화면에 직접 그립니다. 자세한 내용은 DrawDibDraw에 설명된 DDF_UPDATE 및 DDF_DONTDRAW 값을 참조하세요.
DDF_DONTDRAW 현재 이미지는 그려지지 않지만 압축이 해제됩니다. DDF_UPDATE 나중에 이미지를 그리는 데 사용할 수 있습니다. 이 플래그는 DDF_PREROLL 플래그를 대체합니다.
DDF_FULLSCREEN 지원되지 않습니다.
DDF_HALFTONE DIB의 색상표에 관계없이 항상 DIB를 표준 팔레트로 디더링합니다. 애플리케이션에서 DrawDibDraw와 함께 DrawDibBegin을 사용하는 경우 DrawDibDraw 대신 DrawDibBegin으로 이 값을 설정합니다.
DDF_JUSTDRAWIT GDI를 사용하여 이미지를 그립니다. DrawDib 함수가 이미지를 압축 해제, 확장 또는 디더링하는 것을 금지합니다. 이는 StretchDIBits 함수와 차별화되는 기능의 DrawDib를 제거합니다.
DDF_SAME_DRAW DrawDibDraw에 현재 그리기 매개 변수를 사용합니다. DrawDibDraw 또는 DrawDibBegin을 사용한 이후 lpbi, dxDest, dyDest, dxSrc 및 dySrc가 변경되지 않은 경우에만 이 값을 사용합니다. 이 플래그는 DDF_SAME_DIB 및 DDF_SAME_SIZE 플래그를 대체합니다.
DDF_SAME_HDC 현재 DC 핸들 및 현재 DC와 연결된 팔레트를 사용합니다.
DDF_UPDATE 마지막 버퍼링된 비트맵을 다시 그려야 합니다. 이 값으로 그리기에 실패하면 버퍼링된 이미지를 사용할 수 없으며 디스플레이를 업데이트하기 전에 새 이미지를 지정해야 합니다.

반환 값

성공하면 TRUE를 반환하고 그렇지 않으면 FALSE를 반환합니다.

설명

이 함수는 lpbi 로 지정된 DIB를 DC에 그릴 준비를 합니다. 이미지는 dxDest 및 dyDest로 지정된 크기로 확장됩니다. dxDest 및 dyDest가 -1로 설정된 경우 DIB는 늘어나지 않고 1:1 배율로 그려집니다.

DrawDibBegin을 다시 실행하고, 새 플래그를 지정하고, dxDest, dyDest, lpbi, dxSrc 또는 dySrc 설정 중 하나 이상을 변경하여 DrawDib DC의 플래그를 업데이트할 수 있습니다.

DrawDibBegin의 매개 변수가 변경되지 않은 경우 함수에 대한 후속 호출은 영향을 주지 않습니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 vfw.h
라이브러리 Vfw32.lib
DLL Msvfw32.dll

추가 정보

DrawDib 함수