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