GLGETPOLYGONSTIPPLE
Section: Misc. Reference Manual Pages (3G)
Page Index
NAME
glGetPolygonStipple
- return the polygon stipple pattern
C SPECIFICATION
void
glGetPolygonStipple(
GLubyte
*mask )
delim $$
PARAMETERS
- mask
-
Returns the stipple pattern. The initial value is all 1's.
DESCRIPTION
glGetPolygonStipple returns to
mask a $32 ~times~ 32$ polygon stipple pattern.
The pattern is packed into memory as if
glReadPixels
with both
height and
width of 32,
type of
GL_BITMAP,
and
format of
GL_COLOR_INDEX were called,
and the stipple pattern were stored in an internal $32 ~times~ 32$ color
index buffer.
Unlike
glReadPixels,
however,
pixel transfer operations
(shift, offset, pixel map)
are not applied to the returned stipple image.
NOTES
If an error is generated,
no change is made to the contents of
mask.
ERRORS
GL_INVALID_OPERATION is generated if
glGetPolygonStipple
is executed between the execution of
glBegin
and the corresponding execution of
glEnd.
SEE ALSO
glPixelStore(3G),
glPixelTransfer(3G),
glPolygonStipple(3G),
glReadPixels(3G)