1991-2006 Silicon Graphics, Inc.

glGetPolygonStipple

3G

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 × 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 × 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 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/.