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
GL_INVALID_VALUE	La largeur ou la hauteur était négative.
GL_INVALID_OPERATION	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	Gl.h
Bibliothèque	Opengl32.lib
DLL	Opengl32.dll

Voir aussi

glBegin

glEnable

glEnd

glIsEnabled

glViewport