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 |
---|---|
|
name n’était pas une valeur acceptée. |
|
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 |
|
Bibliothèque |
|
DLL |
|