CDC::MaskBlt

아티클
02/21/2013

지정 된 마스크와 래스터 작업을 사용 하 여 원본 및 대상 비트맵에 대 한 색 데이터를 결합 합니다.

BOOL MaskBlt(
   int x,
   int y,
   int nWidth,
   int nHeight,
   CDC* pSrcDC,
   int xSrc,
   int ySrc,
   CBitmap& maskBitmap,
   int xMask,
   int yMask,
   DWORD dwRop 
);

매개 변수

x
대상 사각형의 왼쪽 위 모퉁이의 x 좌표 논리를 지정합니다.
y
대상 사각형의 왼쪽 위 모퉁이의 y 좌표 논리를 지정합니다.
nWidth
논리 단위로 대상 사각형 및 소스 비트맵의 너비를 지정합니다.
nHeight
논리 단위로 대상 사각형 및 소스 비트맵의 높이 지정합니다.
pSrcDC
비트맵에서 복사할 장치 컨텍스트를 식별 합니다.이 0이 여야 합니다의 dwRop 소스를 포함 하는 래스터 작업 매개 변수를 지정 합니다.
xSrc
소스 비트맵의 왼쪽 위 모퉁이의 x 좌표 논리를 지정합니다.
ySrc
소스 비트맵의 왼쪽 위 모퉁이의 y 좌표 논리를 지정합니다.
maskBitmap
단색 마스크 비트맵을 색 비트맵 장치 컨텍스트에서 소스와 함께 식별 합니다.
xMask
지정한 마스크 비트맵의 가로 픽셀 오프셋을 지정 된 maskBitmap 매개 변수.
yMask
지정 된 마스크 비트맵의 세로 픽셀 오프셋을 지정 된 maskBitmap 매개 변수.
dwRop
전경색과 배경색 모두 삼진 래스터 작업 함수를 사용 하 여 원본 및 대상 데이터의 조합을 제어 하는 코드를 지정 합니다.배경 래스터 작업을 코드는이 값의 상위 단어의 상위 바이트에 저장 됩니다. 전경 래스터 작업을 코드의 낮은 바이트의 상위 워드의이 값이 저장 됩니다. 이 값의 하위 워드는 무시 되 고 0이 되어야 합니다.매크로 MAKEROP4 이러한 조합을 전경색과 배경색의 래스터 작업을 코드를 만듭니다.포그라운드 및 백그라운드에서이 함수의 컨텍스트를 토론에 대 한 설명 단원을 참조 하십시오.참조는 BitBlt 멤버 함수 목록은 일반적인 래스터 작업을 코드.

반환 값

함수가 성공 하면 0이 아닌. 그렇지 않으면 0입니다.

설명

값이 지정 된 마스크에서 1 maskBitmap 전경 래스터 작업 코드를 지정 하는 dwRop 해당 위치에서 적용 해야 합니다.배경 래스터 작업을 코드에서 지정 된 마스크에 0 값을 표시 합니다. dwRop 해당 위치에서 적용 해야 합니다.마스크 사각형 소스 래스터 작업을 필요한 경우 소스 사각형을 포함 해야 합니다.있지 않으면 함수가 실패 합니다.래스터 작업 소스는 필요 하지 않은 경우 사각형 마스크 대상 사각형을 포함 해야 합니다.있지 않으면 함수가 실패 합니다.

이 함수를 호출할 때 원본 장치 컨텍스트를 회전 또는 기울이기 변환을 적용 되 면 오류가 발생 합니다.그러나 다른 종류의 변형이 가능 합니다.

소스, 패턴 및 대상 비트맵의 색 형식은 다를 경우,이 함수는 패턴 소스 형식 또는 대상 형식에 맞게 변환 합니다.단색 비트맵 마스크 비트맵 없으면 오류가 발생 합니다.확장된 메타 파일 기록 되 면 오류가 발생과 0을 반환 하는 함수에서는 확장 메타 파일 디바이스 컨텍스트 소스 장치 컨텍스트를 식별 하는 경우.모든 장치를 지 원하는 MaskBlt.응용 프로그램에서 호출 해야 GetDeviceCaps 장치는이 기능을 지원 하는지 여부를 결정 합니다.비트맵이 마스크를 제공 하는 경우이 함수를 정확 하 게 같은 동작 BitBlt, 전경 래스터 작업을 코드를 사용 합니다.소스 디바이스 컨텍스트에 비트맵에서 픽셀 마스크 비트맵 구조 (0, 0) 지점에서 오프셋 됩니다.이 비트맵 마스크에 마스크 집합이 있는 경우에 유용 합니다. 응용 프로그램 쉽게 하나라 blitting 마스크 작업에 픽셀 오프셋을 조정 하 여 적용할 수 있으며 사각형 크기를 전송 하려면 MaskBlt.