glPolygonStipple-Funktion

Die glPolygonStipple-Funktion legt das Polygon-Stippmuster fest.

Syntax

void WINAPI glPolygonStipple(
   const GLubyte *mask
);

Parameter

mask

Ein Zeiger auf ein Stipplemuster von 32 x 32, das auf die gleiche Weise aus dem Arbeitsspeicher entpackt wird, wie glDrawPixels Pixel auspackt.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Fehlercodes

Der folgende Fehlercode kann von der glGetError-Funktion abgerufen werden.

Name	Bedeutung
GL_INVALID_OPERATION	Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen.

Bemerkungen

Die glPolygonStipple-Funktion legt das Polygon-Stippmuster fest. Polygonstippling, wie Linienstippling (siehe glLineStipple), maskiert bestimmte Fragmente, die durch die Rasterung erzeugt werden, und erstellt ein Muster. Stippling ist unabhängig von Polygon-Antialiasing.

Der Maskenparameter ist ein Zeiger auf ein Stipplemuster von 32x32, das genau wie die Pixeldaten, die für glDrawPixels bereitgestellt werden, im Speicher gespeichert wird, wobei die Höhe und Breite jeweils 32, das Pixelformat GL_COLOR_INDEX und der Datentyp von GL_BITMAP. Das heißt, das Stipplemuster wird als 32x32-Array von 1-Bit-Farbindizes dargestellt, die in nicht signierten Bytes verpackt sind. Die GlPixelStore-Funktionsparameter , z. B. GL_UNPACK_SWAP_BYTES und GL_UNPACK_LSB_FIRST, wirken sich auf die Zusammenstellung der Bits zu einem Stipplemuster aus. Pixelübertragungsvorgänge (Umschalt-, Offset- und Pixelzuordnung) werden jedoch nicht auf das Stipplebild angewendet.

Polygonstippling ist mit glEnable und glDisable mithilfe von Argument GL_POLYGON_STIPPLE aktiviert und deaktiviert. Wenn aktiviert, wird ein gerastertes Polygonfragment mit den Fensterkoordinaten x_w und y_w an die nächste Stufe von OpenGL gesendet, wenn das (x_w mod 32)th Bit in der (y_w mod 32)th Zeile des Stipplemusters eins ist. Wenn das Polygonstippen deaktiviert ist, ist es so, als ob das Stipplemuster alle wären.

Die folgenden Funktionen rufen Informationen im Zusammenhang mit glPolygonStipple ab:

glGetPolygonStipple

glIsEnabled mit Argument GL_POLYGON_STIPPLE

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

Siehe auch

glBegin

glDrawPixels

glEnd

glLineStipple

glPixelStore

glPixelTransfer