glPolygonStipple

Aus DGL Wiki
Wechseln zu: Navigation, Suche

Vorlage:unvollständig

glPolygonStipple


Name

glPolygonStipple - Setzt das Muster mit dem Polygone getüpfelt werden.


Delphi-Spezifikation

procedure glPolygonStipple(const mask : PGLubyte;)


Parameter

mask Spezifiziert einen Zeiger auf einem 32x32 Tüpfel-Muster, dass im Speicher genauso abgelegt wird wie bei glDrawPixels.


Beschreibung

Das tüpfeln von Polygonen, ebenso wie bei Linien (siehe glLineStipple), deckte bestimmte Fragmente bei der Rasterung ab und erzeugt somit ein Muster. Das Tüpfeln ist hierbei abhängig vom Antialiasing des Polygons.

Der Parameter mask ist ein Zeiger auf ein 32*32 großes Muster, welches so abgespeichert wurde wie ein solches für den Aufruf von glDrawPixels mit der Höhe und Breite von 32 , dem Pixel-Format GL_COLOR_INDEX und dem Datentyp GL_BITMAP(siehe Beispiel von glBitmap). Das heißt, dass das Muster als ein 32*32 großes Array von 1 Bit Farben Indexen angesehen wird, welches in (vorzeichenlose) Bytes gepackt wurde. Die Parameter von glPixelStore wie etwa GL_UNPACK_SWAP_BYTES und GL_UNPACK_LSB_FIRST, bestimmen die Verarbeitung der Bits zu dem Muster. Pixel Übertragungs(en: "pixel transfer") Operationen (etwa shift offset oder pixel map) werden allerdings nicht auf das Muster angewant.

Um das Tüpfeln von Polygonen zu aktivieren oder zu deaktivieren, rufe glEnable und glDisable mit dem Argument GL_POLYGON_STIPPLE auf.
Das Tüpfeln von Polygonen ist beim Start deaktiviert.
Wenn es aktiviert ist, wird ein rasterisiertes Fragment mit den Fensterkoordinaten xw und yw nur dann zur nächsten Stufe der Rendering Pipeline geschickt, wenn das (xw mod 32)te Bit in der (yw mod 32)sten Zeile des Tüpfelmusters 1 (eins/true) ist. When das Tüpfeln der Polygone deaktiviert ist, verhält sich die GL so als ob das Tüpfelmuster nur aus Einzen besteht.


Fehlermeldungen

GL_INVALID_OPERATION wird generiert wenn glPolygoneStipple innerhalb eines glBegin-glEnd Blocks aufgerufen wird.


Zugehörige Wertrückgaben

glGetPolygonStipple
glIsEnabled mit dem Token with argument GL_POLYGON_STIPPLE

Siehe auch

glDrawPixels, glLineStipple, glPixelStore, glPixelTransfer