GdiAlphaBlend 함수(wingdi.h)

아티클
03/08/2023

GdiAlphaBlend 함수는 투명 또는 반투명 픽셀이 있는 비트맵을 표시합니다.

구문

BOOL GdiAlphaBlend(
  [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] BLENDFUNCTION ftn
);

매개 변수

[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] ftn

원본 및 대상 비트맵에 대한 알파 혼합 함수, 전체 원본 비트맵에 적용할 전역 알파 값 및 원본 비트맵에 대한 형식 정보입니다. 원본 및 대상 혼합 함수는 현재 AC_SRC_OVER 제한됩니다. BLENDFUNCTION 및 EMRALPHABLEND 구조를 참조하세요.

반환 값

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

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

이 함수는 다음 값을 반환할 수 있습니다.

반환 코드	설명
ERROR_INVALID_PARAMETER	하나 이상의 입력 매개 변수가 잘못되었습니다.

설명

참고 이 함수는 AlphaBlend와 동일합니다.

원본 사각형과 대상 사각형의 크기가 같지 않으면 원본 비트맵이 대상 사각형과 일치하도록 확장됩니다. SetStretchBltMode 함수를 사용하는 경우 iStretchMode 값이 이 함수에 대해 COLORONCOLOR로 자동으로 변환됩니다(즉, BLACKONWHITE, WHITEONBLACK 및 HALFTONE이 COLORONCOLOR로 변경됨).

대상 좌표는 현재 대상 디바이스 컨텍스트에 지정된 변환을 사용하여 변환됩니다. 원본 좌표는 원본 디바이스 컨텍스트에 대해 현재 지정된 변환을 사용하여 변환됩니다.

원본 디바이스 컨텍스트가 향상된 메타파일 디바이스 컨텍스트를 식별하는 경우 오류가 발생하고 함수는 FALSE를 반환합니다.

대상 및 원본 비트맵의 색 형식이 같지 않으면 GdiAlphaBlend 는 원본 비트맵을 대상 비트맵과 일치하도록 변환합니다.

GdiAlphaBlend 는 미러링을 지원하지 않습니다. 원본 또는 대상의 너비 또는 높이가 음수이면 이 호출이 실패합니다.

프린터로 렌더링할 때 먼저 SHADEBLENDCAPS를 사용하여 GetDeviceCaps 를 호출하여 프린터가 GdiAlphaBlend와의 혼합을 지원하는지 확인합니다. 디스플레이 DC의 경우 모든 혼합 작업이 지원되며 이러한 플래그는 작업이 가속화되는지 여부를 나타냅니다.

원본과 대상이 동일한 표면인 경우, 즉 화면 또는 동일한 메모리 비트맵이고 원본 및 대상 사각형이 겹치면 오류가 발생하고 함수가 FALSE를 반환합니다.

원본 사각형은 원본 표면 내에 완전히 있어야 합니다. 그렇지 않으면 오류가 발생하고 함수는 FALSE를 반환합니다.

원본 또는 대상의 너비 또는 높이가 음수이면 GdiAlphaBlend가 실패합니다.

BLENDFUNCTION의 SourceConstantAlpha 멤버는 전체 소스 비트맵에 사용할 알파 투명도 값을 지정합니다. SourceConstantAlpha 값은 픽셀당 알파 값과 결합됩니다. SourceConstantAlpha가 0이면 이미지가 투명한 것으로 간주됩니다. 픽셀당 알파 값만 사용하려는 경우 SourceConstantAlpha 값을 255(이미지가 불투명하다는 것을 나타냅니다)로 설정합니다.

요구 사항

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