wglSetLayerPaletteEntries 함수(wingdi.h)

지정된 디바이스 컨텍스트에 대해 지정된 색 인덱스 계층 평면의 색상표 항목을 설정합니다.

구문

int wglSetLayerPaletteEntries(
  HDC            unnamedParam1,
  int            unnamedParam2,
  int            unnamedParam3,
  int            unnamedParam4,
  const COLORREF *unnamedParam5
);

매개 변수

unnamedParam1

형식: HDC

레이어 팔레트를 설정할 창의 디바이스 컨텍스트입니다.

unnamedParam2

형식: int

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

unnamedParam3

형식: int

설정할 첫 번째 색상표 항목입니다.

unnamedParam4

형식: int

설정할 색상표 항목의 수입니다.

unnamedParam5

형식: const COLORREF*

RGB 색 정보를 포함하는 cEntries 구조체 배열의 첫 번째 멤버에 대한 포인터입니다.

반환 값

형식: int

함수가 성공하면 반환 값은 창의 지정된 레이어 평면에서 색상표에 설정된 항목의 수입니다. 함수가 실패하거나 픽셀 형식을 선택하지 않으면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

창의 각 색 인덱스 평면에는 크기가 2^n인 색상표가 있습니다. 여기서 n 은 레이어 평면의 비트 평면 수입니다. 색상표의 투명한 인덱스 는 수정할 수 없습니다.

wglRealizeLayerPalette 함수를 사용하여 레이어 팔레트를 실현합니다. 처음에는 레이어 팔레트에 흰색 항목만 포함됩니다.

wglSetLayerPaletteEntries 함수는 기본 평면 팔레트의 색상표 항목을 설정하지 않습니다. 기본 평면 팔레트를 업데이트하려면 GDI 팔레트 함수를 사용합니다.

요구 사항

추가 정보

LAYERPLANEDESCRIPTOR

Windows의 OpenGL

PIXELFORMATDESCRIPTOR

WGL 함수

wglDescribeLayerPlane

wglGetLayerPaletteEntries

wglRealizeLayerPalette