funzione glGetString
La funzione glGetString restituisce una stringa che descrive la connessione OpenGL corrente.
Sintassi
const GLubyte* WINAPI glGetString(
GLenum name
);
Parametri
-
nome
-
Una delle costanti simboliche seguenti.
Valore Significato - GL_VENDOR
Restituisce l'azienda responsabile dell'implementazione openGL. Questo nome non cambia dal rilascio al rilascio. - GL_RENDERER
Restituisce il nome del renderer. Questo nome è in genere specifico di una specifica configurazione di una piattaforma hardware. Non cambia dal rilascio al rilascio. - GL_VERSION
Restituisce un numero di versione o di versione. - GL_EXTENSIONS
Restituisce un elenco delimitato da spazi di estensioni supportate in OpenGL.
Codici di errore
I codici di errore seguenti possono essere recuperati dalla funzione glGetError .
| Nome | Significato |
|---|---|
|
name non è un valore accettato. |
|
La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd. |
Commenti
La funzione glGetString restituisce un puntatore a una stringa statica che descrive alcuni aspetti della connessione OpenGL corrente.
Poiché OpenGL non include query per le caratteristiche delle prestazioni di un'implementazione, è previsto che alcune applicazioni vengano scritte per riconoscere le piattaforme note e modificheranno l'utilizzo di OpenGL in base alle caratteristiche delle prestazioni note di queste piattaforme. Le stringhe GL_VENDOR e GL_RENDERER insieme specificano in modo univoco una piattaforma e non cambieranno da rilascio a rilascio. Devono essere usati come tali dagli algoritmi di riconoscimento della piattaforma.
Il formato e il contenuto della stringa restituita da glGetString dipendono dall'implementazione, ad eccezione del fatto che:
I nomi di estensione non includono caratteri di spazio e saranno separati da spazi nella stringa GL_EXTENSIONS.
La stringa GL_VERSION inizia con un numero di versione. Il numero di versione usa uno dei formati seguenti:
major_number. minor_number
major_number. minor_number. release_number
Le informazioni specifiche del fornitore possono seguire il numero di versione. Il formato dipende dall'implementazione, ma uno spazio separa sempre il numero di versione e le informazioni specifiche del fornitore.
Tutte le stringhe sono con terminazione Null.
Se viene generato un errore, glGetString restituisce zero.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| Intestazione |
|
| Libreria |
|
| DLL |
|