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
GL _ UNGÜLTIGER _ WERT
Die Breite oder Höhe war negativ.
GL _ INVALID _ OPERATION
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
Gl.h
Bibliothek
Opengl32.lib
DLL
Opengl32.dll

Weitere Informationen

glBegin

glEnable

glEnd

glIsEnabled

glViewport