glGetPolygonStipple-Funktion

Die glGetPolygonStipple-Funktion gibt das Polygon-Stipple-Muster zurück.

Syntax

void WINAPI glGetPolygonStipple(
   GLubyte *mask
);

Parameter

mask

Gibt das Stipplemuster zurück.

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 glGetPolygonStipple-Funktion gibt ein Polygon-Stipplemuster von 32x32 über den Maskenparameter zurück. Das Muster wird in den Arbeitsspeicher gepackt, als ob glReadPixels mit der Höhe und Breite von 32, dem Typ der GL_BITMAP und dem Format der GL_COLOR_INDEX aufgerufen würden, und das Stipplemuster in einem internen 32x32-Farbindexpuffer gespeichert würde. Im Gegensatz zu glReadPixels werden Pixelübertragungsvorgänge (Umschalt-, Offset- und Pixelzuordnung) jedoch nicht auf das zurückgegebene Stipple-Bild angewendet.

Wenn ein Fehler generiert wird, wird keine Änderung am Inhalt der Maske vorgenommen.

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

glEnd

glPixelStore

glPixelTransfer

glPolygonStipple

glReadPixels