glScissor-Funktion
Die glScissor-Funktion definiert die Scherenbox.
Syntax
void WINAPI glScissor(
GLint x,
GLint y,
GLsizei width,
GLsizei height
);
Parameter
-
x
-
Die x-Koordinate (vertikale Achse) für die untere linke Ecke des Scherenfelds.
-
y
-
Die y-Koordinate (horizontale Achse) für die linke untere Ecke des Scherenfelds. Zusammen geben x und y die linke untere Ecke des Scherenfelds an. Anfänglich (0,0).
-
width
-
Die Breite des Scherenfelds.
-
height
-
Die Höhe der Scherenbox. Wenn ein OpenGL-Kontext zuerst an ein Fenster angefügt wird, werden Breite und Höhe auf die Abmessungen dieses Fensters festgelegt.
Rückgabewert
Diese Funktion gibt keinen Wert zurück.
Fehlercodes
Der folgende Fehlercode kann von der glGetError-Funktion abgerufen werden.
| Name | Bedeutung |
|---|---|
|
Die Breite oder Höhe war negativ. |
|
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen. |
Bemerkungen
Die glScissor-Funktion definiert ein Rechteck, das als Scherenfeld bezeichnet wird, in Fensterkoordinaten. Die ersten beiden Parameter x und y geben die linke untere Ecke des Felds an. Die Parameter width und height geben die Breite und Höhe des Felds an.
Der Scissor-Test wird mithilfe von glEnable und glDisable mit argument GL_SCISSOR_TEST aktiviert und deaktiviert. Während der Scherentest aktiviert ist, können nur Pixel, die sich im Scherenfeld befinden, durch Zeichnungsbefehle geändert werden. Fensterkoordinaten haben ganzzahlige Werte an den freigegebenen Ecken von Framebuffer-Pixeln, sodass glScissor(0,0,1,1) nur das untere linke Pixel im Fenster geändert werden kann, und glScissor(0,0,0,0) lässt die Änderung an allen Pixeln im Fenster nicht zu.
Wenn der Scherentest deaktiviert ist, sieht es so aus, als ob das Scherenfeld das gesamte Fenster enthält.
Die folgenden Funktionen rufen Informationen im Zusammenhang mit glScissor ab:
glGet mit argument GL_SCISSOR_BOX
glIsEnabled mit Argument GL_SCISSOR_TEST
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|