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 |
---|---|
|
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. |
|
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. |
|
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. |
|
Non è stato registrato alcun errore. Il valore di questa costante simbolica è garantito che sia zero. |
|
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. |
|
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. |
|
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 |
|
Libreria |
|
DLL |
|