gl.Scissor(x, y, width, height)
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.
#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.
#GL_SCISSOR_BOX
gl.IsEnabled() mit dem Argument #GL_SCISSOR_TEST