glRenderMode, fonction

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 rasterisé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 de sélection. Aucun fragment de pixel n’est produit et aucun changement n’est apporté 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éé (voir glSelectBuffer) avant l’entrée du mode de sélection.
GL_FEEDBACK
Mode commentaires. Aucun fragment de pixel n’est produit et aucun changement n’est apporté 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 était GL_RENDER sont retournés dans une mémoire tampon de commentaires, qui doit être créée (voir glFeedbackBuffer) avant que le mode de commentaires ne soit entré.

Codes d’erreur

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

Nom Signification
GL_INVALID_ENUM
le 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 ait été appelée au moins une fois.
GL_INVALID_OPERATION
La fonction a été appelée avec l’argument GL_FEEDBACK avant que glBeedbackBuffer ait été appelée au moins une fois.
GL_INVALID_OPERATION
La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd.

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 vertex) transférées à la mémoire tampon de commentaires.

Pour plus d’informations sur l’opération de sélection et de commentaires, reportez-vous à 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 l’argument GL_RENDER_MODE

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

glFeedbackBuffer

glInitNames

glLoadName

glPassThrough

glPushName

glSelectBuffer