glScissor-Funktion
Die glScissor-Funktion definiert das Scissor-Feld.
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 Scissor-Felds.
-
y
-
Die y-Koordinate (horizontale Achse) für die untere linke Ecke des Scissor-Felds. Zusammen geben x und y die untere linke Ecke des Scissor-Felds an. Anfänglich (0,0).
-
width
-
Die Breite des Scissor-Felds.
-
height
-
Die Höhe des Scissor-Felds. Wenn ein OpenGL-Kontext zum ersten Mal 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 glEndaufgerufen. |
Hinweise
Die glScissor-Funktion definiert ein Rechteck, das als Scissor-Feld bezeichnet wird, in Fensterkoordinaten. Die ersten beiden Parameter , x und y, geben die untere linke Ecke des Felds an. Die Parameter width und height geben die Breite und Höhe des Felds an.
Der Scissor-Test ist mit glEnable und glDisable mit dem Argument GL SCISSOR TEST aktiviert und _ _ deaktiviert. Während der Scissor-Test aktiviert ist, können nur Pixel, die im Scissor-Feld liegen, durch Zeichnungsbefehle geändert werden. Fensterkoordinaten haben ganzzahlige Werte an den gemeinsamen Ecken von Framepufferpixeln, 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 änderungen an allen Pixeln im Fenster nicht zu.
Wenn der Scissor-Test deaktiviert ist, sieht es so aus, als ob das Scissor-Feld das gesamte Fenster einschließt.
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 |
|