fonction glGetString

La fonction glGetString retourne une chaîne décrivant la connexion OpenGL actuelle.

Syntaxe

const GLubyte* WINAPI glGetString(
   GLenum name
);

Paramètres

name

Une des constantes symboliques suivantes.

Valeur	Signification
GL_VENDOR	Retourne la société responsable de cette implémentation OpenGL. Ce nom ne change pas d’une mise en production à l’autre.
GL_RENDERER	Retourne le nom du convertisseur. Ce nom est généralement spécifique à une configuration particulière d’une plateforme matérielle. Il ne change pas d’une mise en production à l’autre.
GL_VERSION	Retourne une version ou un numéro de version.
GL_EXTENSIONS	Retourne une liste séparée par des espaces des extensions prises en charge à OpenGL.

Codes d’erreur

Les codes d’erreur suivants peuvent être récupérés par la fonction glGetError .

Name	Signification
GL_INVALID_ENUM	name n’était pas une valeur acceptée.
GL_INVALID_OPERATION	La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd.

Notes

La fonction glGetString retourne un pointeur vers une chaîne statique décrivant certains aspects de la connexion OpenGL actuelle.

Étant donné qu’OpenGL n’inclut pas de requêtes pour les caractéristiques de performances d’une implémentation, il est attendu que certaines applications soient écrites pour reconnaître les plateformes connues et modifient leur utilisation d’OpenGL en fonction des caractéristiques de performances connues de ces plateformes. Les chaînes GL_VENDOR et GL_RENDERER ensemble spécifient une plateforme de manière unique, et ne changeront pas d’une mise en production à l’autre. Ils doivent être utilisés en tant que tels par les algorithmes de reconnaissance de plateforme.

Le format et le contenu de la chaîne retournée par glGetString dépendent de l’implémentation, sauf que :

• Les noms d’extension n’incluent pas d’espace et sont séparés par des espaces dans la chaîne GL_EXTENSIONS.

• La chaîne GL_VERSION commence par un numéro de version. Le numéro de version utilise l’une des formes suivantes :

  major_number. minor_number

  major_number. minor_number. release_number

• Les informations spécifiques au fournisseur peuvent suivre le numéro de version. Son format dépend de l’implémentation, mais un espace sépare toujours le numéro de version et les informations spécifiques au fournisseur.

• Toutes les chaînes sont terminées par un caractère Null.

Si une erreur est générée, glGetString retourne zéro.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Gl.h
Bibliothèque	Opengl32.lib
DLL	Opengl32.dll

Voir aussi

glBegin

glEnd