glGetString-Funktion
Die glGetString-Funktion gibt eine Zeichenfolge zurück, die die aktuelle OpenGL-Verbindung beschreibt.
Syntax
const GLubyte* WINAPI glGetString(
GLenum name
);
Parameter
-
name
-
Eine der folgenden symbolischen Konstanten.
Wert Bedeutung - GL_VENDOR
Gibt das Unternehmen zurück, das für diese OpenGL-Implementierung verantwortlich ist. Dieser Name ändert sich nicht von Release zu Release. - GL_RENDERER
Gibt den Namen des Renderers zurück. Dieser Name ist in der Regel spezifisch für eine bestimmte Konfiguration einer Hardwareplattform. Es ändert sich nicht von Release zu Release. - GL_VERSION
Gibt eine Version oder Versionsnummer zurück. - GL_EXTENSIONS
Gibt eine durch Leerzeichen getrennte Liste der unterstützten Erweiterungen für OpenGL zurück.
Fehlercodes
Die folgenden Fehlercodes können von der glGetError-Funktion abgerufen werden.
| Name | Bedeutung |
|---|---|
|
name war kein akzeptierter Wert. |
|
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen. |
Bemerkungen
Die glGetString-Funktion gibt einen Zeiger auf eine statische Zeichenfolge zurück, die einen Aspekt der aktuellen OpenGL-Verbindung beschreibt.
Da OpenGL keine Abfragen für die Leistungsmerkmale einer Implementierung enthält, wird erwartet, dass einige Anwendungen geschrieben werden, um bekannte Plattformen zu erkennen und ihre OpenGL-Nutzung basierend auf bekannten Leistungsmerkmalen dieser Plattformen zu ändern. Die Zeichenfolgen GL_VENDOR und GL_RENDERER zusammen eindeutig eine Plattform angeben und werden von Release zu Release nicht geändert. Sie sollten als solche von Plattformerkennungsalgorithmen verwendet werden.
Format und Inhalt der Zeichenfolge, die glGetString zurückgibt, hängen von der Implementierung ab, mit dem Unterschied:
Erweiterungsnamen enthalten keine Leerzeichen und werden in der GL_EXTENSIONS Zeichenfolge durch Leerzeichen getrennt.
Die GL_VERSION Zeichenfolge beginnt mit einer Versionsnummer. Die Versionsnummer verwendet eines der folgenden Formulare:
major_number. minor_number
major_number. minor_number. release_number
Anbieterspezifische Informationen können der Versionsnummer folgen. Das Format hängt von der Implementierung ab, aber ein Leerzeichen trennt immer die Versionsnummer und die herstellerspezifischen Informationen.
Alle Zeichenfolgen sind NULL-endend.
Wenn ein Fehler generiert wird, gibt glGetString null zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|