fonction glScissor
La fonction glScissor définit la boîte de ciseaux.
Syntaxe
void WINAPI glScissor(
GLint x,
GLint y,
GLsizei width,
GLsizei height
);
Paramètres
-
x
-
Coordonnée x (axe vertical) pour l’angle inférieur gauche de la boîte de ciseaux.
-
y
-
Coordonnée y (axe horizontal) pour le coin inférieur gauche de la boîte de ciseaux. Ensemble, x et y spécifient le coin inférieur gauche de la boîte de ciseaux. Initialement (0,0).
-
width
-
Largeur de la boîte de ciseaux.
-
height
-
Hauteur de la boîte de ciseaux. Lorsqu’un contexte OpenGL est attaché pour la première fois à une fenêtre, la largeur et la hauteur sont définies sur les dimensions de cette fenêtre.
Valeur renvoyée
Cette fonction ne retourne pas de valeur.
Codes d’erreur
Le code d’erreur suivant peut être récupéré par la fonction glGetError .
| Name | Signification |
|---|---|
|
La largeur ou la hauteur était négative. |
|
La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd. |
Notes
La fonction glScissor définit un rectangle, appelé zone de ciseaux, en coordonnées de fenêtre. Les deux premiers paramètres, x et y, spécifient le coin inférieur gauche de la zone. Les paramètres width et height spécifient la largeur et la hauteur de la zone.
Le test de ciseaux est activé et désactivé à l’aide de glEnable et glDisable avec l’argument GL_SCISSOR_TEST. Bien que le test de ciseaux soit activé, seuls les pixels qui se trouvent dans la zone ciseaux peuvent être modifiés par des commandes de dessin. Les coordonnées de fenêtre ont des valeurs entières aux coins partagés des pixels framebuffer. Ainsi , glScisor(0,0,1,1) autorise uniquement la modification du pixel inférieur gauche dans la fenêtre, et glScissor(0,0,0,0) interdit la modification de tous les pixels de la fenêtre.
Lorsque le test de ciseaux est désactivé, c’est comme si la boîte de ciseaux incluait la fenêtre entière.
Les fonctions suivantes récupèrent des informations relatives à glScissor :
glGet avec argument GL_SCISSOR_BOX
glIsEnabled avec argument GL_SCISSOR_TEST
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 |
|