funzione glGetError

La funzione glGetError restituisce informazioni sugli errori.

Sintassi

GLenum WINAPI glGetError(void);

Parametri

Questa funzione non ha parametri.

Valore restituito

La funzione glGetError restituisce uno dei codici di errore seguenti.

Codice restituito	Descrizione
GL_INVALID_ENUM	Un valore inaccettabile viene specificato per un argomento enumerato. La funzione che causa l'errore viene ignorata, senza alcun effetto collaterale diverso da quello di impostare il flag di errore.
GL_INVALID_VALUE	Un argomento numerico non è compreso nell'intervallo. La funzione che causa l'errore viene ignorata, senza alcun effetto collaterale diverso da quello di impostare il flag di errore.
GL_INVALID_OPERATION	L'operazione specificata non è consentita nello stato corrente. La funzione che causa l'errore viene ignorata, senza alcun effetto collaterale diverso da quello di impostare il flag di errore.
GL_NO_ERROR	Non è stato registrato alcun errore. Il valore di questa costante simbolica è garantito che sia zero.
GL_STACK_OVERFLOW	Questa funzione causerebbe un overflow dello stack. La funzione che causa l'errore viene ignorata, senza alcun effetto collaterale diverso da quello di impostare il flag di errore.
GL_STACK_UNDERFLOW	Questa funzione causerebbe un sottoflow dello stack. La funzione che causa l'errore viene ignorata, senza alcun effetto collaterale diverso da quello di impostare il flag di errore.
GL_OUT_OF_MEMORY	Memoria insufficiente per eseguire la funzione. Lo stato di OpenGL non è definito, ad eccezione dello stato dei flag di errore, dopo aver registrato questo errore.

Si noti che glGetError restituisce GL_INVALID_OPERATION se viene chiamato tra una chiamata a glBegin e la relativa chiamata corrispondente a glEnd.

Commenti

Ogni errore rilevabile viene assegnato un codice numerico e un nome simbolico. Quando si verifica un errore, il flag di errore viene impostato sul valore del codice di errore appropriato. Nessun altro errore viene registrato finché glGetError non viene chiamato, il codice di errore viene restituito e il flag viene reimpostato in GL_NO_ERROR. Se una chiamata a glGetError restituisce GL_NO_ERROR, non è stato rilevato alcun errore dall'ultima chiamata a glGetError o dall'inizializzazione di OpenGL.

Per consentire implementazioni distribuite, potrebbero essere presenti diversi flag di errore. Se un singolo flag di errore ha registrato un errore, il valore di tale flag viene restituito e tale flag viene reimpostato in GL_NO_ERROR quando viene chiamato glGetError . Se più flag ha registrato un errore, glGetError restituisce e cancella un valore di flag di errore arbitrario. Se tutti i flag di errore devono essere reimpostati, è consigliabile chiamare sempre glGetError in un ciclo finché non restituisce GL_NO_ERROR.

Inizialmente, tutti i flag di errore vengono impostati su GL_NO_ERROR.

Quando viene impostato un flag di errore, i risultati di un'operazione OpenGL non vengono definiti solo se si è verificato GL_OUT_OF_MEMORY. In tutti gli altri casi, la funzione che genera l'errore viene ignorata e non ha alcun effetto sul contenuto openGL o framebuffer.

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