glPolygonStipple — set the polygon stippling pattern
void glPolygonStipple( | const GLubyte * | pattern) ; |
pattern
Specifies a pointer to a
Polygon stippling, like line stippling (see glLineStipple), masks out certain fragments produced by rasterization, creating a pattern. Stippling is independent of polygon antialiasing.
pattern
is a pointer to a
GL_COLOR_INDEX
, and data type
of GL_BITMAP
.
That is,
the stipple pattern is represented as a
GL_UNPACK_SWAP_BYTES
and GL_UNPACK_LSB_FIRST
affect the assembling of the bits into a
stipple pattern.
Pixel transfer operations
(shift, offset, pixel map)
are not applied to the stipple image,
however.
If a non-zero named buffer object is bound to the GL_PIXEL_UNPACK_BUFFER
target
(see glBindBuffer) while a stipple pattern is
specified, pattern
is treated as a byte offset into the buffer object's data store.
To enable and disable polygon stippling, call
glEnable and glDisable
with argument GL_POLYGON_STIPPLE
. Polygon stippling is initially
disabled. If it's enabled,
a rasterized polygon fragment with window coordinates
GL_INVALID_OPERATION
is generated if a non-zero buffer object name is bound to the
GL_PIXEL_UNPACK_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_UNPACK_BUFFER
target and the data would be unpacked from the buffer
object such that the memory reads required would exceed the data store size.
GL_INVALID_OPERATION
is generated if glPolygonStipple
is executed between the execution of glBegin
and the corresponding execution of glEnd.
glIsEnabled with argument GL_POLYGON_STIPPLE
glGet with argument GL_PIXEL_UNPACK_BUFFER_BINDING
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/.