Поделиться через


Функция wglGetLayerPaletteEntries (wingdi.h)

Извлекает записи палитры из заданной плоскости слоя цветового индекса для указанного контекста устройства.

Синтаксис

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

Параметры

unnamedParam1

Тип: HDC

Контекст устройства окна, плоскости слоев которого должны быть описаны.

unnamedParam2

Тип: int

Плоскость перекрытия или подложки. Положительные значения iLayerPlane определяют плоскости наложения, где 1 — первая плоскость наложения на main плоскости, 2 — вторая плоскость наложения над первой плоскостью наложения и т. д. Отрицательные значения определяют плоскости подложки, где 1 — первая подложная плоскость под main плоскостью, 2 — вторая подложка под первой плоскостью и т. д. Количество плоскостей наложения и подложки задается в элементе bReserved структуры PIXELFORMATDESCRIPTOR .

unnamedParam3

Тип: int

Первая извлекаемая запись палитры.

unnamedParam4

Тип: int

Количество извлекаемых записей палитры.

unnamedParam5

Тип: COLORREF*

Массив структур, содержащих значения цветов RGB палитры. Массив должен содержать по крайней мере столько же структур, сколько указано в cEntries.

Возвращаемое значение

Тип: int

Если функция выполняется успешно, возвращаемое значение — это количество записей, заданных в палитре в заданной плоскости слоя окна.

Если функция завершается сбоем или если формат пикселей не выбран, возвращаемое значение равно нулю. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Каждая плоскость слоя цветового индекса в окне имеет палитру размером 2^n, где n — это число битовых плоскостей в плоскости слоя. Невозможно изменить прозрачный индекс палитры.

Используйте функцию wglRealizeLayerPalette , чтобы реализовать палитру слоев. Изначально палитра слоев содержит только записи для белого цвета.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header wingdi.h
Библиотека Opengl32.lib
DLL Opengl32.dll

См. также раздел

COLORREF

LAYERPLANEDESCRIPTOR

OpenGL в Windows

PIXELFORMATDESCRIPTOR

Функции WGL

wglDescribeLayerPlane

wglRealizeLayerPalette

wglSetLayerPaletteEntries