Функция glGetColorTableParameterivEXT

Статья
06/13/2023

Функции glGetColorTableParameterfvEXT и glGetColorTableParameterivEXT получают параметры палитры из таблиц цветов.

Синтаксис

void WINAPI glGetColorTableParameterivEXT(
   GLenum target,
   GLenum pname,
   GLint  *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 [только классические приложения]
Заголовок	Gl.h

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

glColorSubTableEXT
glColorTableEXT
glGetColorTableEXT
glGetColorTableParameterfvEXT
wglGetProcAddress

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