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:
- glGetClipPlane
- glGetError
- glGetLight
- glGetMap
- glGetMaterial
- glGetPixelMap
- glGetPolygonStipple
- glGetString
- glGetTexEnv
- glGetTexGen
- glGetTexImage
- glGetTexLevelParameter
- glGetTexParameter