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 |
|