Função glGetTexLevelParameteriv

As funções glGetTexLevelParameterfv e glGetTexLevelParameteriv retornam valores de parâmetro de textura para um nível específico de detalhes.

Sintaxe

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

Parâmetros

destino

O nome simbólico da textura de destino: GL_TEXTURE_1D, GL_TEXTURE_2D, GL_PROXY_TEXTURE_1D ou GL_PROXY_TEXTURE_2D.

level

O número de nível de detalhes da imagem desejada. O nível 0 é o nível de imagem base. O nível n é a nª imagem de redução de mipmap.

Pname

O nome simbólico de um parâmetro de textura. Os nomes de parâmetro a seguir são aceitos.

Valor Significado
GL_TEXTURE_WIDTH
O parâmetro params retorna um único valor que contém a largura da imagem de textura. Esse valor inclui a borda da imagem de textura.
GL_TEXTURE_HEIGHT
O parâmetro params retorna um único valor que contém a altura da imagem de textura. Esse valor inclui a borda da imagem de textura.
GL_TEXTURE_INTERNAL_FORMAT
O parâmetro params retorna um único valor que descreve o formato texel da textura.
GL_TEXTURE_BORDER
O parâmetro params retorna um único valor: a largura em pixels da borda da imagem de textura.
GL_TEXTURE_RED_SIZE
A resolução de armazenamento interno do componente vermelho de um texel. A resolução escolhida pelo OpenGL será uma correspondência próxima para a resolução solicitada pelo usuário com o argumento de componente glTexImage1D ou glTexImage2D.
GL_TEXTURE_GREEN_SIZE
A resolução de armazenamento interno do componente verde de um texel. A resolução escolhida pelo OpenGL será uma correspondência próxima para a resolução solicitada pelo usuário com o argumento de componente glTexImage1D ou glTexImage2D.
GL_TEXTURE_BLUE_SIZE
A resolução de armazenamento interno do componente azul de um texel. A resolução escolhida pelo OpenGL será uma correspondência próxima para a resolução solicitada pelo usuário com o argumento de componente glTexImage1D ou glTexImage2D.
GL_TEXTURE_ALPHA_SIZE
A resolução de armazenamento interno do componente alfa de um texel. A resolução escolhida pelo OpenGL será uma correspondência próxima para a resolução solicitada pelo usuário com o argumento de componente glTexImage1D ou glTexImage2D.
GL_TEXTURE_LUMINANCE_SIZE
A resolução de armazenamento interno do componente de luminância de um texel. A resolução escolhida pelo OpenGL será uma correspondência próxima para a resolução solicitada pelo usuário com o argumento de componente glTexImage1D ou glTexImage2D.
GL_TEXTURE_INTENSITY_SIZE
A resolução de armazenamento interno do componente de intensidade de um texel. A resolução escolhida pelo OpenGL será uma correspondência próxima para a resolução solicitada pelo usuário com o argumento de componente glTexImage1D ou glTexImage2D.
GL_TEXTURE_COMPONENTS
O parâmetro params retorna um único valor: o número de componentes na imagem de textura.

params

Retorna os dados solicitados.

Retornar valor

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

Códigos de erro

Os códigos de erro a seguir podem ser recuperados pela função glGetError .

Nome Significado
GL_INVALID_ENUM
target ou pname não era um valor aceito.
GL_INVALID_VALUE
o nível é menor que zero ou maior que o log2*(max)*, em que max é o valor retornado de GL_MAX_TEXTURE_SIZE.
GL_INVALID_OPERATION
A função foi chamada entre uma chamada para glBegin e a chamada correspondente para glEnd.

Comentários

A função glGetTexLevelParameter retorna valores de parâmetro de textura params para um valor específico de nível de detalhe, especificado como level. O parâmetro de destino define a textura de destino, seja GL_TEXTURE_1D, GL_TEXTURE_2D, GL_PROXY_TEXTURE_1D ou GL_PROXY_TEXTURE_2D para especificar texturização unidimensional ou bidimensional. O parâmetro pname especifica o parâmetro de textura cujo valor ou valores serão retornados.

Se um erro for gerado, nenhuma alteração será feita no conteúdo de parâmetros.

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
Biblioteca
Opengl32.lib
DLL
Opengl32.dll

Confira também

glBegin

glEnd

glGetTexParameter

glTexImage1D

glTexImage2D

glTexParameter