Функция glGetColorTableParameterfvEXT
Функции glGetColorTableParameterfvEXT и glGetColorTableParameterivEXT получают параметры палитры из таблиц цветов.
Синтаксис
void WINAPI glGetColorTableParameterfvEXT(
GLenum target,
GLenum pname,
GLfloat *params
);
Параметры
-
target
-
Целевая текстура палитры, для которой нужны данные параметров. Должен быть TEXTURE_1D, TEXTURE_2D, PROXY_TEXTURE_1D или PROXY_TEXTURE_2D.
-
pname
-
Символьная константа для типа данных параметров палитры, на которые указывают params.
Ниже приведены принятые символические константы и их значения.
Значение Значение - GL_COLOR_TABLE_FORMAT_EXT
Возвращает внутренний формат, заданный последним вызовом glColorTableEXT или значением по умолчанию. - GL_COLOR_TABLE_WIDTH_EXT
Возвращает ширину текущей палитры. - GL_COLOR_TABLE_RED_SIZE_EXT
Возвращает фактический размер, используемый внутри для хранения красного компонента данных палитры. - GL_COLOR_TABLE_GREEN_SIZE_EXT
Возвращает фактический размер, используемый для хранения зеленого компонента данных палитры. - GL_COLOR_TABLE_BLUE_SIZE_EXT
Возвращает фактический размер, используемый внутри для хранения синего компонента данных палитры. - GL_COLOR_TABLE_ALPHA_SIZE_EXT
Возвращает фактический размер, используемый для хранения альфа-компонента данных палитры. -
params
-
Указывает на данные параметра таблицы цветов, заданные параметром pname .
Возвращаемое значение
Эта функция не возвращает значение.
Комментарии
Функции glGetColorTableParameterivEXT и glGetColorTableParameterfvEXT используются для получения определенных данных параметров из таблиц цветов, заданных с помощью glColorTableEXT для целевых палитр текстур. Кроме того, эти функции можно использовать для определения количества записей таблицы цветов, возвращаемых glGetColorTableEXT .
Если целевой параметр GL_PROXY_TEXTURE_1D или GL_PROXY_TEXTURE_2D, а реализация не поддерживает значения , указанные для формата или ширины, glColorTableEXT может не создать запрошенную таблицу цветов. В этом случае таблица цветов пуста, а все полученные параметры будут равны нулю. Чтобы определить, поддерживает ли OpenGL определенный формат таблицы цветов и размер, вызовите glColorTableEXT с целевым прокси-сервером, а затем вызовите метод glGetColorTableParameterivEXT или glGetColorTableParameterfvEXT , чтобы определить, соответствует ли параметр ширины параметру, заданному методом glColorTableEXT. Если полученная ширина равна нулю, запрос таблицы цветов по glColorTable завершился ошибкой . Если ширина не равна нулю, можно вызвать glColorTable с реальным целевым объектом с TEXTURE_1D или TEXTURE_2D, чтобы задать таблицу цветов.
Функции glGetColorTableParameterivEXT и glGetColorTableParameterfvEXT — это функции расширения, которые не являются частью стандартной библиотеки OpenGL, но являются частью расширения GL_EXT_paletted_texture. Чтобы проверка, поддерживает ли ваша реализация OpenGL glGetColorTableParameterivEXT и glGetColorTableParameterfvEXT, вызовите glGetString(GL_EXTENSIONS). Если возвращается GL_EXT_paletted_texture, поддерживаются glGetColorTableParameterivEXT и glGetColorTableParameterfvEXT . Чтобы получить адрес функции расширения, вызовите wglGetProcAddress.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера |
Windows 2000 Server [только классические приложения] |
| Заголовок |
|