glScissor-Funktion

Artikel
06/13/2023

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
GL_INVALID_VALUE	Die Breite oder Höhe war negativ.
GL_INVALID_OPERATION	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	Gl.h
Bibliothek	Opengl32.lib
DLL	Opengl32.dll

Weitere Informationen

glBegin
glEnable
glEnd
glIsEnabled
glViewport