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
GL_INVALID_ENUM
name non è un valore accettato.
GL_INVALID_OPERATION
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
Gl.h
Libreria
Opengl32.lib
DLL
Opengl32.dll

Vedi anche

glBegin

glEnd