TransparentBlt 함수(wingdi.h)

아티클
03/08/2023

TransparentBlt 함수는 지정된 원본 디바이스 컨텍스트에서 대상 디바이스 컨텍스트로 픽셀 사각형에 해당하는 색 데이터의 비트 블록 전송을 수행합니다.

구문

BOOL TransparentBlt(
  [in] HDC  hdcDest,
  [in] int  xoriginDest,
  [in] int  yoriginDest,
  [in] int  wDest,
  [in] int  hDest,
  [in] HDC  hdcSrc,
  [in] int  xoriginSrc,
  [in] int  yoriginSrc,
  [in] int  wSrc,
  [in] int  hSrc,
  [in] UINT crTransparent
);

매개 변수

[in] hdcDest

대상 디바이스 컨텍스트에 대한 핸들입니다.

[in] xoriginDest

대상 사각형의 왼쪽 위 모서리에 있는 x 좌표(논리 단위)입니다.

[in] yoriginDest

대상 사각형의 왼쪽 위 모서리에 있는 논리 단위의 y 좌표입니다.

[in] wDest

대상 사각형의 너비(논리 단위)입니다.

[in] hDest

대상 사각형의 높이(논리 단위)입니다.

[in] hdcSrc

원본 디바이스 컨텍스트에 대한 핸들입니다.

[in] xoriginSrc

원본 사각형의 x 좌표(논리 단위)입니다.

[in] yoriginSrc

원본 사각형의 y 좌표(논리 단위)입니다.

[in] wSrc

원본 사각형의 너비(논리 단위)입니다.

[in] hSrc

원본 사각형의 높이(논리 단위)입니다.

[in] crTransparent

투명으로 처리할 원본 비트맵의 RGB 색입니다.

반환 값

함수가 성공하면 반환 값은 TRUE입니다.

함수가 실패하면 반환 값은 FALSE입니다.

설명

TransparentBlt 함수는 호환되는 DDB(비트맵)에서 작동합니다.

TransparentBlt 함수는 소스 비트맵의 모든 형식을 지원합니다. 그러나 32 bpp 비트맵의 경우 알파 값만 복사합니다. AlphaBlend를 사용하여 투명도를 사용하여 픽셀당 32비트 비트맵을 지정합니다.

원본 및 대상 사각형의 크기가 같지 않으면 원본 비트맵이 대상 사각형과 일치하도록 확장됩니다. SetStretchBltMode 함수를 사용하면 BLACKONWHITE 및 WHITEONBLACK의 iStretchMode 모드가 TransparentBlt 함수의 COLORONCOLOR로 변환됩니다.

대상 디바이스 컨텍스트는 대상 좌표의 변환 유형을 지정합니다. 원본 디바이스 컨텍스트는 원본 좌표의 변환 형식을 지정합니다.

원본 또는 대상의 너비 또는 높이가 음수이면 TransparentBlt에서 비트맵을 미러 않습니다.

여러 모니터 시스템에서 사용되는 경우 hdcSrc 와 hdcDest 는 모두 동일한 디바이스를 참조해야 합니다. 그렇지 않으면 함수가 실패합니다. 다른 디바이스의 DC 간에 데이터를 전송하려면 GetDIBits를 호출하여 메모리 비트맵을 DIB로 변환합니다. 두 번째 디바이스에 DIB를 표시하려면 SetDIBits 또는 StretchDIBits를 호출합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	wingdi.h(Windows.h 포함)
라이브러리	Msimg32.lib
DLL	Msimg32.dll