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