Функция glGetPixelMapuiv
Функции glGetPixelMapfv, glGetPixelMapuiv и glGetPixelMapusv возвращают указанную карту пикселей.
Синтаксис
void WINAPI glGetPixelMapuiv(
GLenum map,
GLuint *values
);
Параметры
-
map
-
Имя возвращаемой карты пикселей. Допустимые значения: GL_PIXEL_MAP_I_TO_I, GL_PIXEL_MAP_S_TO_S, GL_PIXEL_MAP_I_TO_R, GL_PIXEL_MAP_I_TO_G, GL_PIXEL_MAP_I_TO_B, GL_PIXEL_MAP_I_TO_A, GL_PIXEL_MAP_R_TO_R, GL_PIXEL_MAP_G_TO_G, GL_PIXEL_MAP_B_TO_B и GL_PIXEL_MAP_A_TO_A.
-
Значения
-
Возвращает содержимое карты пикселей.
Возвращаемое значение
Эта функция не возвращает значение.
Коды ошибок
Следующие коды ошибок могут быть получены функцией glGetError .
| Имя | Значение |
|---|---|
|
Map не является допустимым значением. |
|
Функция была вызвана между вызовом glBegin и соответствующим вызовом glEnd. |
Комментарии
Описание допустимых значений для параметра map см. в разделе glPixelMap. Функция glGetPixelMap возвращает в значениях содержимое карты пикселей, указанной в map. Используйте карты пикселей во время выполнения glReadPixels, glDrawPixels, glCopyPixels, glTexImage1D и glTexImage2D для сопоставления цветовых индексов, индексов трафарета, компонентов цвета и компонентов глубины с другими значениями.
При запросе целочисленные значения без знака линейно сопоставляются с внутренним фиксированным представлением или представлением с плавающей запятой, так что 1,0 сопоставляется с наибольшим представляемым целым числом, а 0,0 — с нулем. Возвращаемые целочисленные значения без знака не определены, если значение карты не находилось в диапазоне [0,1].
Чтобы определить требуемый размер карты, вызовите glGet с соответствующей символьной константой.
Если возникает ошибка, содержимое значений не изменяется.
Следующие функции извлекают сведения, связанные с glGetPixelMap:
glGet с аргументом GL_PIXEL_MAP_I_TO_I_SIZE
glGet с аргументом GL_PIXEL_MAP_S_TO_S_SIZE
glGet с аргументом GL_PIXEL_MAP_I_TO_R_SIZE
glGet с аргументом GL_PIXEL_MAP_I_TO_G_SIZE
glGet с аргументом GL_PIXEL_MAP_I_TO_B_SIZE
glGet с аргументом GL_PIXEL_MAP_I_TO_A_SIZE
glGet с аргументом GL_PIXEL_MAP_R_TO_R_SIZE
glGet с аргументом GL_PIXEL_MAP_G_TO_G_SIZE
glGet с аргументом GL_PIXEL_MAP_B_TO_B_SIZE
glGet с аргументом GL_PIXEL_MAP_A_TO_A_SIZE
glGet с аргументом GL_MAX_PIXEL_MAP_TABLE
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера |
Windows 2000 Server [только классические приложения] |
| Заголовок |
|
| Библиотека |
|
| DLL |
|