wglRealizeLayerPalette 함수(wingdi.h)

아티클
08/27/2023

wglRealizeLayerPalette 함수는 지정된 색인 계층 평면의 색상표 항목을 실제 색상표로 매핑하거나 RGBA 레이어 평면의 팔레트를 초기화합니다.

구문

BOOL wglRealizeLayerPalette(
  HDC  unnamedParam1,
  int  unnamedParam2,
  BOOL unnamedParam3
);

매개 변수

unnamedParam1

레이어 평면 팔레트를 실제 색상표로 실현할 창의 디바이스 컨텍스트를 지정합니다.

unnamedParam2

오버레이 또는 언더레이 평면을 지정합니다. iLayerPlane의 양수 값은 오버레이 평면을 식별합니다. 여기서 1은 기본 평면의 첫 번째 오버레이 평면이고 2는 첫 번째 오버레이 평면의 두 번째 오버레이 평면입니다. 음수 값은 언더레이 평면을 식별합니다. 여기서 1은 기본 평면 아래의 첫 번째 언더레이 평면이고 2는 첫 번째 언더레이 평면 아래의 두 번째 언더레이 평면입니다. 오버레이 및 언더레이 평면의 수는 PIXELFORMATDESCRIPTOR 구조체의 bReserved 멤버에 제공됩니다.

unnamedParam3

색상표를 실제 색상표로 구현할지 여부를 나타냅니다. bRealize가 TRUE이면 색상표 항목이 사용 가능한 실제 색상표에 매핑됩니다. bRealize가 FALSE이면 창의 레이어 평면에 대한 팔레트 항목이 더 이상 필요하지 않으며 다른 포그라운드 창에서 사용할 수 있도록 해제될 수 있습니다.

반환 값

함수가 성공하면 bRealize가 TRUE이고 실제 팔레트를 사용할 수 없는 경우에도 반환 값은 TRUE입니다. 함수가 실패하거나 픽셀 형식이 선택되지 않은 경우 반환 값은 FALSE입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

레이어 평면의 실제 색상표는 레이어 평면이 있는 창 간의 공유 리소스입니다. 창이 두 개 이상 지정된 물리적 계층 평면에 대한 팔레트를 실현하려고 하면 한 번에 하나의 팔레트만 실현됩니다. wglRealizeLayerPalette 함수를 호출하면 포그라운드 창의 레이어 팔레트가 항상 먼저 실현됩니다.

창의 레이어 팔레트가 실현되면 색상표 항목은 항상 일대일로 실제 색상표에 매핑됩니다. GDI 논리 팔레트와 달리 wglRealizeLayerPalette 를 사용하면 다른 창의 레이어 팔레트를 현재 물리적 팔레트에 매핑하지 않습니다.

창이 전경 창이 될 때마다 wglRealizeLayerPalette 를 호출하여 레이어 평면의 픽셀 유형이 RGBA인 경우에도 레이어 팔레트를 다시 실현합니다.

wglRealizeLayerPalette는 기본 평면의 팔레트를 인식하지 못하므로 GDI 팔레트 함수를 사용하여 기본 평면 팔레트를 실현합니다.

요구 사항

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