Name
gl.GetPolygonStipple -- return the polygon stipple pattern
Synopsis
maskArray = gl.GetPolygonStipple()
Function
gl.GetPolygonStipple() returns to pattern a 32*32 polygon stipple pattern. The pattern is packed into memory as if gl.ReadPixels() 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*32 color index buffer. Unlike gl.ReadPixels(), however, pixel transfer operations (shift, offset, pixel map) are not applied to the returned stipple image. Since #GL_BITMAP uses only 1-bit per pixel, the table returned by this function will always have exactly 128 elements containing 8 pixels per table element.

Please consult an OpenGL reference manual for more information.

Inputs
none

Results
maskArray
table containing the stipple pattern; the initial value is all 1's
Errors
#GL_INVALID_OPERATION is generated if gl.GetPolygonStipple() is executed between the execution of gl.Begin() and the corresponding execution of gl.End() .

Show TOC