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
GL_INVALID_ENUM
name não era um valor aceito.
GL_INVALID_OPERATION
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
Gl.h
Biblioteca
Opengl32.lib
DLL
Opengl32.dll

Confira também

glBegin

glEnd