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 |
|---|---|
|
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 xw und yw an die nächste Stufe von OpenGL gesendet, wenn das (xw mod 32)th Bit in der (yw 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:
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 |
|
| Bibliothek |
|
| DLL |
|