NAME

glGetPolygonStipple - return the polygon stipple pattern

C SPECIFICATION

void ggllGGeettPPoollyyggoonnSSttiippppllee( GLubyte _*_m_a_s_k )

        

delim $$

PARAMETERS

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

DESCRIPTION

ggllGGeettPPoollyyggoonnSSttiippppllee returns to _m_a_s_k a $32 ~times~ 32$ polygon stipple pattern. The pattern is packed into memory as if ggllRReeaaddPPiixxeellss with both _h_e_i_g_h_t and _w_i_d_t_h of 32, _t_y_p_e of GGLL__BBIITTMMAAPP, and _f_o_r_m_a_t of GGLL__CCOOLLOORR__IINNDDEEXX were called, and the stipple pattern were stored in an internal $32 ~times~ 32$ color index buffer. Unlike ggllRReeaaddPPiixxeellss, however, pixel transfer operations (shift, offset, pixel map) are not applied to the returned stipple image.

NOTES

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

ERRORS

GGLL__IINNVVAALLIIDD__OOPPEERRAATTIIOONN is generated if ggllGGeettPPoollyyggoonnSSttiippppllee is executed between the execution of ggllBBeeggiinn and the corresponding execution of ggllEEnndd.

SEE ALSO

ggllPPiixxeellSSttoorree((33GG)), ggllPPiixxeellTTrraannssffeerr((33GG)), ggllPPoollyyggoonnSSttiippppllee((33GG)), ggllRReeaaddPPiixxeellss((33GG))