fonction glRenderMode

La fonction glRenderMode définit le mode de rastérisation.

Syntaxe

GLint WINAPI glRenderMode(
   GLenum mode
);

Paramètres

mode

Mode de rastérisation. Les trois valeurs suivantes sont acceptées. La valeur par défaut est GL_RENDER.

Valeur	Signification
GL_RENDER	Mode rendu. Les primitives sont rastérisées, produisant des fragments de pixels, qui sont écrits dans le framebuffer. Il s’agit du mode normal et également du mode par défaut.
GL_SELECT	Mode sélection. Aucun fragment de pixel n’est produit et aucune modification n’est apportée au contenu du framebuffer. Au lieu de cela, un enregistrement des noms de primitives qui auraient été dessinés si le mode de rendu était GL_RENDER est retourné dans une mémoire tampon de sélection, qui doit être créée (voir glSelectBuffer) avant l’entrée du mode de sélection.
GL_FEEDBACK	Mode de commentaires. Aucun fragment de pixel n’est produit et aucune modification n’est apportée au contenu du framebuffer. Au lieu de cela, les coordonnées et les attributs des sommets qui auraient été dessinés si le mode de rendu avait été GL_RENDER sont retournés dans une mémoire tampon de commentaires, qui doit être créée (voir glFeedbackBuffer) avant d’entrer le mode de commentaires.

Codes d’erreur

Les codes d’erreur suivants peuvent être récupérés par la fonction glGetError .

Nom	Signification
GL_INVALID_ENUM	mode n’était pas l’une des trois valeurs acceptées.
GL_INVALID_OPERATION	La fonction a été appelée avec l’argument GL_SELECT avant que glSelectBuffer n’ait été appelé au moins une fois.
GL_INVALID_OPERATION	La fonction a été appelée avec l’argument GL_FEEDBACK avant que glBeedbackBuffer n’ait été appelé au moins une fois.
GL_INVALID_OPERATION	La fonction a été appelée entre un appel à glBegin et l’appel à glEnd correspondant.

Notes

La fonction glRenderMode prend un argument, le mode, qui peut supposer l’une des trois valeurs prédéfinies ci-dessus.

La valeur de retour de la fonction glRenderMode est déterminée par le mode de rendu au moment où glRenderMode est appelé, plutôt que par mode. Les valeurs retournées pour les trois modes de rendu sont les suivantes.

Valeur	Signification
GL_RENDER	Zéro.
GL_SELECT	Nombre d’enregistrements d’accès transférés vers la mémoire tampon de sélection.
GL_FEEDBACK	Nombre de valeurs (et non de sommets) transférées vers la mémoire tampon de commentaires.

Pour plus d’informations sur l’opération de sélection et de commentaires, consultez glSelectBuffer et glFeedbackBuffer .

Si une erreur est générée, glRenderMode retourne zéro quel que soit le mode de rendu actuel.

La fonction suivante récupère les informations relatives à glRenderMode :

glGet avec argument GL_RENDER_MODE

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

glFeedbackBuffer

glInitNames

glLoadName

glPassThrough

glPushName

glSelectBuffer