glGetError, fonction

La fonction glGetError retourne des informations d’erreur.

Syntaxe

GLenum WINAPI glGetError(void);

Paramètres

Cette fonction n’a pas de paramètres.

Valeur retournée

La fonction glGetError retourne l’un des codes d’erreur suivants.

Code de retour Description
GL_INVALID_ENUM
Une valeur inacceptable est spécifiée pour un argument énuméré. La fonction incriminée est ignorée, sans effet secondaire autre que de définir l’indicateur d’erreur.
GL_INVALID_VALUE
Un argument numérique est hors limites. La fonction incriminée est ignorée, sans effet secondaire autre que de définir l’indicateur d’erreur.
GL_INVALID_OPERATION
L’opération spécifiée n’est pas autorisée dans l’état actuel. La fonction incriminée est ignorée, sans effet secondaire autre que de définir l’indicateur d’erreur.
GL_NO_ERROR
Aucune erreur n’a été enregistrée. La valeur de cette constante symbolique est garantie de zéro.
GL_STACK_OVERFLOW
Cette fonction provoquerait un dépassement de capacité de pile. La fonction incriminée est ignorée, sans effet secondaire autre que de définir l’indicateur d’erreur.
GL_STACK_UNDERFLOW
Cette fonction provoquerait un sous-flux de pile. La fonction incriminée est ignorée, sans effet secondaire autre que de définir l’indicateur d’erreur.
GL_OUT_OF_MEMORY
Il n’y a pas suffisamment de mémoire pour exécuter la fonction. L’état d’OpenGL n’est pas défini, à l’exception de l’état des indicateurs d’erreur, une fois cette erreur enregistrée.

Notez que glGetError retourne GL_INVALID_OPERATION s’il est appelé entre un appel à glBegin et son appel correspondant à glEnd.

Notes

Chaque erreur détectable se voit attribuer un code numérique et un nom symbolique. Lorsqu’une erreur se produit, l’indicateur d’erreur est défini sur la valeur de code d’erreur appropriée. Aucune autre erreur n’est enregistrée tant que glGetError n’est pas appelé, que le code d’erreur est retourné et que l’indicateur est réinitialisé à GL_NO_ERROR. Si un appel à glGetError retourne GL_NO_ERROR, aucune erreur détectable n’a été détectée depuis le dernier appel à glGetError ou depuis l’initialisation d’OpenGL.

Pour autoriser les implémentations distribuées, il peut y avoir plusieurs indicateurs d’erreur. Si un indicateur d’erreur unique a enregistré une erreur, la valeur de cet indicateur est retournée et cet indicateur est réinitialisé à GL_NO_ERROR lorsque glGetError est appelé. Si plusieurs indicateurs ont enregistré une erreur, glGetError renvoie et efface une valeur d’indicateur d’erreur arbitraire. Si tous les indicateurs d’erreur doivent être réinitialisés, vous devez toujours appeler glGetError dans une boucle jusqu’à ce qu’il retourne GL_NO_ERROR.

Initialement, tous les indicateurs d’erreur sont définis sur GL_NO_ERROR.

Lorsqu’un indicateur d’erreur est défini, les résultats d’une opération OpenGL ne sont pas définis uniquement si GL_OUT_OF_MEMORY s’est produit. Dans tous les autres cas, la fonction générant l’erreur est ignorée et n’a aucun effet sur l’état OpenGL ou le contenu du framebuffer.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge
Windows 2000 Server [applications de bureau uniquement]
En-tête
Gl.h
Bibliothèque
Opengl32.lib
DLL
Opengl32.dll

Voir aussi

glBegin

glEnd