Função glGetString
A função glGetString retorna uma cadeia de caracteres que descreve a conexão OpenGL atual.
Sintaxe
const GLubyte* WINAPI glGetString(
GLenum name
);
Parâmetros
-
name
-
Uma das seguintes constantes simbólicas.
Valor Significado - GL_VENDOR
Retorna a empresa responsável por essa implementação do OpenGL. Esse nome não muda de versão para versão. - GL_RENDERER
Retorna o nome do renderizador. Esse nome normalmente é específico para uma configuração específica de uma plataforma de hardware. Ele não muda de versão para lançamento. - GL_VERSION
Retorna uma versão ou um número de versão. - GL_EXTENSIONS
Retorna uma lista separada por espaço de extensões com suporte para OpenGL.
Códigos de erro
Os códigos de erro a seguir podem ser recuperados pela função glGetError .
| Nome | Significado |
|---|---|
|
name não era um valor aceito. |
|
A função foi chamada entre uma chamada para glBegin e a chamada correspondente para glEnd. |
Comentários
A função glGetString retorna um ponteiro para uma cadeia de caracteres estática que descreve algum aspecto da conexão OpenGL atual.
Como o OpenGL não inclui consultas para as características de desempenho de uma implementação, espera-se que alguns aplicativos sejam gravados para reconhecer plataformas conhecidas e modifiquem o uso do OpenGL com base nas características de desempenho conhecidas dessas plataformas. As cadeias de caracteres GL_VENDOR e GL_RENDERER juntas especificam exclusivamente uma plataforma e não serão alteradas de versão para lançamento. Eles devem ser usados como tal por algoritmos de reconhecimento de plataforma.
O formato e o conteúdo da cadeia de caracteres que glGetString retorna dependem da implementação, exceto que:
Os nomes de extensão não incluirão caracteres de espaço e serão separados por caracteres de espaço na cadeia de caracteres GL_EXTENSIONS.
A cadeia de caracteres GL_VERSION começa com um número de versão. O número de versão usa um destes formulários:
major_number. minor_number
major_number. minor_number. release_number
Informações específicas do fornecedor podem seguir o número da versão. Seu formato depende da implementação, mas um espaço sempre separa o número de versão e as informações específicas do fornecedor.
Todas as cadeias de caracteres são terminadas em nulo.
Se um erro for gerado, glGetString retornará zero.
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 |
|
| Biblioteca |
|
| DLL |
|