1GLPOLYGONSTIPPLE(3G)                                      GLPOLYGONSTIPPLE(3G)
2
3
4

NAME

6       glPolygonStipple - set the polygon stippling pattern
7
8

C SPECIFICATION

10       void glPolygonStipple( const GLubyte *mask )
11
12

PARAMETERS

14       mask  Specifies  a  pointer  to  a  32×32  stipple pattern that will be
15             unpacked from memory in the same way  that  glDrawPixels  unpacks
16             pixels.
17

DESCRIPTION

19       Polygon  stippling,  like line stippling (see glLineStipple), masks out
20       certain fragments produced by rasterization, creating a pattern.  Stip‐
21       pling is independent of polygon antialiasing.
22
23       mask  is  a pointer to a 32×32 stipple pattern that is stored in memory
24       just like the pixel data supplied to a glDrawPixels  call  with  height
25       and width both equal to 32, a pixel of GL_COLOR_INDEX, and data type of
26       GL_BITMAP.  That is, the stipple pattern  is  represented  as  a  32×32
27       array  of  1-bit  color indices packed in unsigned bytes.  glPixelStore
28       parameters like GL_UNPACK_SWAP_BYTES and GL_UNPACK_LSB_FIRST affect the
29       assembling  of  the bits into a stipple pattern.  Pixel transfer opera‐
30       tions (shift, offset, pixel map) are not applied to the stipple  image,
31       however.
32
33       To  enable  and  disable polygon stippling, call glEnable and glDisable
34       with argument GL_POLYGON_STIPPLE. Polygon stippling is  initially  dis‐
35       abled. If it's enabled, a rasterized polygon fragment with window coor‐
36       dinates xw and yw is sent to the next stage of the GL if  and  only  if
37       the  (xwmod32)th bit in the (ywmod32)th row of the stipple pattern is 1
38       (one).  When polygon stippling is disabled, it is  as  if  the  stipple
39       pattern consists of all 1's.
40

ERRORS

42       GL_INVALID_OPERATION  is  generated  if  glPolygonStipple  is  executed
43       between the execution of glBegin and  the  corresponding  execution  of
44       glEnd.
45

ASSOCIATED GETS

47       glGetPolygonStipple
48       glIsEnabled with argument GL_POLYGON_STIPPLE
49

SEE ALSO

51       glDrawPixels(3G),          glLineStipple(3G),         glPixelStore(3G),
52       glPixelTransfer(3G)
53
54
55
56                                                          GLPOLYGONSTIPPLE(3G)
Impressum