Freigeben über


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
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