xenocara/doc/gl-docs/GL/gl/getpolygonstipple.3gl
2006-11-29 17:00:35 +00:00

53 lines
1.4 KiB
Plaintext

'\" e
'\"! eqn | mmdoc
'\"macro stdmacro
.ds Vn Version 1.2
.ds Dt 24 September 1999
.ds Re Release 1.2.1
.ds Dp Jan 14 18:30
.ds Dm 01 getpolygo
.ds Xs 49553 4 getpolygonstipple.gl
.TH GLGETPOLYGONSTIPPLE 3G
.SH NAME
.B "glGetPolygonStipple
\- return the polygon stipple pattern
.SH C SPECIFICATION
void \f3glGetPolygonStipple\fP(
GLubyte \fI*mask\fP )
.nf
.fi
.EQ
delim $$
.EN
.SH PARAMETERS
.TP \w'\f2mask\fP\ \ 'u
\f2mask\fP
Returns the stipple pattern. The initial value is all 1's.
.SH DESCRIPTION
\%\f3glGetPolygonStipple\fP returns to \f2mask\fP a $32 ~times~ 32$ polygon stipple pattern.
The pattern is packed into memory as if \%\f3glReadPixels\fP
with both \f2height\fP and \f2width\fP of 32,
\f2type\fP of \%\f3GL_BITMAP\fP,
and \f2format\fP of \%\f3GL_COLOR_INDEX\fP were called,
and the stipple pattern were stored in an internal $32 ~times~ 32$ color
index buffer.
Unlike \%\f3glReadPixels\fP,
however,
pixel transfer operations
(shift, offset, pixel map)
are not applied to the returned stipple image.
.SH NOTES
If an error is generated,
no change is made to the contents of \f2mask\fP.
.SH ERRORS
\%\f3GL_INVALID_OPERATION\fP is generated if \%\f3glGetPolygonStipple\fP
is executed between the execution of \%\f3glBegin\fP
and the corresponding execution of \%\f3glEnd\fP.
.SH SEE ALSO
\%\f3glPixelStore(3G)\fP,
\%\f3glPixelTransfer(3G)\fP,
\%\f3glPolygonStipple(3G)\fP,
\%\f3glReadPixels(3G)\fP