Bezeichnung
gl.Scissor -- definiert die Scherenbox
Übersicht
gl.Scissor(x, y, width, height)
Beschreibung
gl.Scissor() definiert ein Rechteck, die so genannte Scherenbox, in Fensterkoordinaten. Die ersten beiden Argumente, x und y, geben die linke untere Ecke des Feldes an. width und height spezifizieren die Breite und Höhe der Box.

Um den Scherentest zu aktivieren und zu deaktivieren, rufen Sie gl.Enable() und gl.Disable() mit Argument #GL_SCISSOR_TEST auf. Der Test ist zunächst deaktiviert. Während der Test aktiviert ist, können nur Pixel, die sich in der Scherenbox befinden, durch Zeichnungsbefehle verändert werden. Fensterkoordinaten haben ganzzahlige Werte an den gemeinsamen Ecken von Rahmenpufferpixeln. gl.Scissor(0,0,1,1) erlaubt die Änderung nur des unteren linken Pixels im Fenster und gl.Scissor(0,0,0,0) erlaubt keine Änderung von Pixeln im Fenster.

Wenn der Scherentest deaktiviert ist, ist es, als ob die Scherenbox das gesamte Fenster umfasst.

Weitere Informationen finden Sie in einem OpenGL-Referenzhandbuch.

Eingaben
x
gibt die linke Ecke der Scherenbox an; zunächst 0
y
gibt die untere Ecke der Scherenbox an; zunächst 0
width
gibt die Breite der Scherenbox an
height
gibt die Höhe der Scherenbox an
Fehler
#GL_INVALID_VALUE wird erzeugt, wenn entweder width oder height negativ ist.

#GL_INVALID_OPERATION wird erzeugt, wenn gl.Scissor() zwischen gl.Begin() und gl.End() ausgeführt wird.

Verbundene get-operationen
gl.Get() mit dem Argument #GL_SCISSOR_BOX

gl.IsEnabled() mit dem Argument #GL_SCISSOR_TEST


Navigation zeigen