GLGETPOLYGONSTIPPLE(3G) 					   OpenGL Manual					   GLGETPOLYGONSTIPPLE(3G)

NAME

       glGetPolygonStipple - return the polygon stipple pattern

C SPECIFICATION

       void glGetPolygonStipple(GLubyte * pattern);

PARAMETERS

       pattern
	   Returns the stipple pattern. The initial value is all 1's.

DESCRIPTION

       glGetPolygonStipple returns to pattern a 32 x 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
       x 32 color index buffer. Unlike glReadPixels(), however, pixel transfer operations (shift, offset, pixel map) are not applied to the
       returned stipple image.

       If a non-zero named buffer object is bound to the GL_PIXEL_PACK_BUFFER target (see glBindBuffer()) while a polygon stipple pattern is
       requested, pattern is treated as a byte offset into the buffer object's data store.

NOTES

       If an error is generated, no change is made to the contents of pattern.

ERRORS

       GL_INVALID_OPERATION is generated if a non-zero buffer object name is bound to the GL_PIXEL_PACK_BUFFER target and the buffer object's data
       store is currently mapped.

       GL_INVALID_OPERATION is generated if a non-zero buffer object name is bound to the GL_PIXEL_PACK_BUFFER target and the data would be packed
       to the buffer object such that the memory writes required would exceed the data store size.

       GL_INVALID_OPERATION is generated if glGetPolygonStipple is executed between the execution of glBegin() and the corresponding execution of
       glEnd().

ASSOCIATED GETS

       glGet() with argument GL_PIXEL_PACK_BUFFER_BINDING

SEE ALSO

       glPixelStore(), glPixelTransfer(), glPolygonStipple(), glReadPixels()

COPYRIGHT

       Copyright (C) 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see
       http://oss.sgi.com/projects/FreeB/.

AUTHORS

       opengl.org

opengl.org							    06/10/2014						   GLGETPOLYGONSTIPPLE(3G)