Função glGetColorTableParameterivEXT

As funções glGetColorTableParameterfvEXT e glGetColorTableParameterivEXT obtêm parâmetros de paleta de tabelas de cores.

Sintaxe

void WINAPI glGetColorTableParameterivEXT(
   GLenum target,
   GLenum pname,
   GLint  *params
);

Parâmetros

destino

A textura de destino da paleta para a qual você deseja dados de parâmetro. Deve ser TEXTURE_1D, TEXTURE_2D, PROXY_TEXTURE_1D ou PROXY_TEXTURE_2D.

Pname

Uma constante simbólica para o tipo de dados de parâmetro de paleta apontados por parâmetros.

Veja a seguir as constantes simbólicas aceitas e seus significados.

Valor	Significado
GL_COLOR_TABLE_FORMAT_EXT	Retornar o formato interno especificado pela chamada mais recente para glColorTableEXT ou o valor padrão.
GL_COLOR_TABLE_WIDTH_EXT	Retornar a largura da paleta atual.
GL_COLOR_TABLE_RED_SIZE_EXT	Retorne o tamanho real usado internamente para armazenar o componente vermelho dos dados da paleta.
GL_COLOR_TABLE_GREEN_SIZE_EXT	Retorne o tamanho real usado internamente para armazenar o componente verde dos dados da paleta.
GL_COLOR_TABLE_BLUE_SIZE_EXT	Retorne o tamanho real usado internamente para armazenar o componente azul dos dados da paleta.
GL_COLOR_TABLE_ALPHA_SIZE_EXT	Retorne o tamanho real usado internamente para armazenar o componente alfa dos dados da paleta.

params

Aponta para os dados de parâmetro da tabela de cores especificados pelo parâmetro pname .

Retornar valor

Essa função não retorna um valor.

Comentários

Você usa as funções glGetColorTableParameterivEXT e glGetColorTableParameterfvEXT para recuperar dados de parâmetro específicos de tabelas de cores definidas com glColorTableEXT para paletas de textura de destino. Além disso, você pode usar essas funções para determinar o número de entradas de tabela de cores que glGetColorTableEXT retorna.

Quando o parâmetro de destino é GL_PROXY_TEXTURE_1D ou GL_PROXY_TEXTURE_2D e a implementação não dá suporte aos valores especificados para formato ou largura, glColorTableEXT pode falhar ao criar a tabela de cores solicitada. Nesse caso, a tabela de cores está vazia e todos os parâmetros recuperados serão zero. Você pode determinar se o OpenGL dá suporte a um formato e tamanho de tabela de cores específicos chamando glColorTableEXT com um destino proxy e, em seguida, chamando glGetColorTableParameterivEXT ou glGetColorTableParameterfvEXT para determinar se o parâmetro de largura corresponde ao definido por glColorTableEXT. Se a largura recuperada for zero, a solicitação de tabela de cores por glColorTable falhará. Se a largura recuperada não for zero, você poderá chamar glColorTable com o destino real com TEXTURE_1D ou TEXTURE_2D para definir a tabela de cores.

As funções glGetColorTableParameterivEXT e glGetColorTableParameterfvEXT são funções de extensão que não fazem parte da biblioteca OpenGL padrão, mas fazem parte da extensão GL_EXT_paletted_texture. Para marcar se a implementação do OpenGL dá suporte a glGetColorTableParameterivEXT e glGetColorTableParameterfvEXT, chame glGetString(GL_EXTENSIONS). Se retornar GL_EXT_paletted_texture, há suporte para glGetColorTableParameterivEXT e glGetColorTableParameterfvEXT . Para obter o endereço de função de uma função de extensão, chame wglGetProcAddress.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	Gl.h

Confira também

glColorSubTableEXT

glColorTableEXT

glGetColorTableEXT

glGetColorTableParameterfvEXT

wglGetProcAddress