fonction glGetError

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, n’ayant aucun effet secondaire autre que de définir l’indicateur d’erreur.
GL_INVALID_VALUE	Un argument numérique est hors de portée. La fonction incriminée est ignorée, n’ayant aucun 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, n’ayant aucun 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 la pile. La fonction incriminée est ignorée, n’ayant aucun 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, n’ayant aucun effet secondaire autre que de définir l’indicateur d’erreur.
GL_OUT_OF_MEMORY	Il ne reste pas assez 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 à glEnd correspondant.

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, il n’y a pas eu d’erreur détectable 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 retourne 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 définis que si GL_OUT_OF_MEMORY s’est produit. Dans tous les autres cas, la fonction qui génère l’erreur est ignorée et n’a aucun effet sur l’état OpenGL ou le contenu de framebuffer.

Spécifications

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