Compartilhar via


Uso das funções de consulta

Existem quatro funções de consulta para obter variáveis ​​de estado simples e uma para determinar se um estado específico está ativado ou desativado:

Os protótipos para as funções de consulta são:

void glGetBooleanv(GLenum pname , GLboolean * params );

void glGetIntegerv(GLenum pname , GLint * params );

void glGetFloatv(GLenum pname , GLfloat * params );

void glGetDoublev(GLenum pname , GLdouble * params );

Respectivamente, as funções de consulta obtêm variáveis ​​de estado booleanas, inteiras, de ponto flutuante ou de precisão dupla. O parâmetro pname é uma constante simbólica que indica a variável de estado a ser retornada, enquanto params é um ponteiro para uma matriz do tipo indicado na qual colocar os dados retornados. Os valores possíveis de pname estão listados em Variáveis ​​de estado OpenGL. Uma conversão de tipo é executada se necessário para retornar a variável desejada como o tipo de dados solicitado.

O protótipo de glIsEnabled é:

GLboolean glIsEnabled(GLenum cap );

Se o modo especificado por cap estiver habilitado, glIsEnabled retornará GL_TRUE. Se o modo especificado por cap estiver desabilitado, glIsEnabled retornará GL_FALSE. Os valores possíveis de cap estão listados em Variáveis ​​de estado OpenGL.

Outras funções especializadas retornam variáveis ​​de estado específicas. Para descobrir quando usar essas funções, consulte Variáveis ​​de estado OpenGL e o Manual de referência OpenGL. Para obter mais informações sobre o recurso de tratamento de erros do OpenGL e a função glGetError, consulte Tratamento de erros.

As funções que retornam variáveis ​​de estado específicas são: