Version vom 3. Januar 2009, 16:16 Uhr

glScissor

Name

glScissor - Definiert die Scissor-Box. (scissor stammt aus dem Lateinischem und bedeutet Vorschneider)

Delphi-Spezifikation

procedure glScissor(x : glInt; y : glInt; width : glSizei; height : glSizei);

Parameter

Beschreibung

glScissor beschreibt ein Rechteck (die Scissorbox genannt) in Fensterkoordinaten. Die beiden ersten Argumente (x und y) geben die untere/linke Ecke der Box and; width und height beschreiben die Dimensionen der Box.

Um den Scissortest zu aktivieren bzw. zu deaktivieren, ruft man glEnable bzw. glDisable mit dem Argument GL_SCISSOR_TEST auf. Der Test ist in der Grundeinstellung deaktiviert. Sobald der Test aktiviert ist, können nur Pixel die innerhalb der Scissorbox liegen von Zeichenkommandos modifiziert werden. Fensterkoordinaten sind Ganzzahlen und bezeichnen die Kante welche 2 Framebuffer Pixel trennt. glScissor(0,0,1,1) z.B. lässt nur die Modifikation des Pixels welches ganz unten links liegt zu, während glScissor(0,0,0,0) überhaupt keine Pixelmodifkationen zulässt.

Sobald der Scissortest deaktiviert wird, verhält es sich so als würde die Scissorbox den kompletten Viewport beschreiben.

Hinweise

Am leichtesten fällt die Verwendung von glScissor im Orthomodus (glOrtho) da hier die Positionsbestimmung leichter fällt, vorallem wenn die Auflösung des Orthomodus pixel genau ist.

Will man anstelle einer simplen Box eine kompliziertere Form als Schablone verwenden, können dazu die Methoden des Stenciltests (z.B. glStencilFunc) verwendet werden.

Fehlermeldungen

GL_INVALID_VALUE wird generiert wenn Höhe oder Breite negativ sind.

GL_INVALID_OPERATION wird generiert wenn glScissor zwischen einem glBegin und dem dazugehörigem glEnd aufgerufen wird.

Zugehörige Wertrückgaben

glGet mit dem Argument GL_SCISSOR_BOX.
glIsEnabled mit dem Argument GL_SCISSOR_TEST.

Siehe auch

glEnable, glViewport