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 |
|---|---|
|
mode n’était pas l’une des trois valeurs acceptées. |
|
La fonction a été appelée avec l’argument GL_SELECT avant que glSelectBuffer n’ait été appelé au moins une fois. |
|
La fonction a été appelée avec l’argument GL_FEEDBACK avant que glBeedbackBuffer n’ait été appelé au moins une fois. |
|
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 |
|
| Bibliothèque |
|
| DLL |
|