1 <?xml version=
"1.0" encoding=
"UTF-8"?>
2 <!DOCTYPE book PUBLIC
"-//OASIS//DTD DocBook MathML Module V1.1b1//EN"
3 "http://www.oasis-open.org/docbook/xml/mathml/1.1CR1/dbmathml.dtd">
4 <refentry id=
"glGetPolygonStipple">
9 <holder>Silicon Graphics, Inc.
</holder>
12 <refentrytitle>glGetPolygonStipple
</refentrytitle>
13 <manvolnum>3G
</manvolnum>
16 <refname>glGetPolygonStipple
</refname>
17 <refpurpose>return the polygon stipple pattern
</refpurpose>
19 <refsynopsisdiv><title>C Specification
</title>
22 <funcdef>void
<function>glGetPolygonStipple
</function></funcdef>
23 <paramdef>GLubyte *
<parameter>pattern
</parameter></paramdef>
27 <!-- eqn: ignoring delim $$ -->
28 <refsect1 id=
"parameters"><title>Parameters
</title>
31 <term><parameter>pattern
</parameter></term>
34 Returns the stipple pattern. The initial value is all
1's.
40 <refsect1 id=
"description"><title>Description
</title>
42 <function>glGetPolygonStipple
</function> returns to
<parameter>pattern
</parameter> a
43 <inlineequation><mml:math>
44 <!-- eqn: 32 times 32:-->
47 <mml:mo>×</mml:mo>
50 </mml:math></inlineequation>
51 polygon stipple pattern.
52 The pattern is packed into memory as if
<citerefentry><refentrytitle>glReadPixels
</refentrytitle></citerefentry>
53 with both
<emphasis>height
</emphasis> and
<emphasis>width
</emphasis> of
32,
54 <emphasis>type
</emphasis> of
<constant>GL_BITMAP
</constant>,
55 and
<emphasis>format
</emphasis> of
<constant>GL_COLOR_INDEX
</constant> were called,
56 and the stipple pattern were stored in an internal
57 <inlineequation><mml:math>
58 <!-- eqn: 32 times 32:-->
61 <mml:mo>×</mml:mo>
64 </mml:math></inlineequation>
67 Unlike
<citerefentry><refentrytitle>glReadPixels
</refentrytitle></citerefentry>,
69 pixel transfer operations
70 (shift, offset, pixel map)
71 are not applied to the returned stipple image.
74 If a non-zero named buffer object is bound to the
<constant>GL_PIXEL_PACK_BUFFER
</constant> target
75 (see
<citerefentry><refentrytitle>glBindBuffer
</refentrytitle></citerefentry>) while a polygon stipple pattern is
76 requested,
<parameter>pattern
</parameter> is treated as a byte offset into the buffer object's data store.
79 <refsect1 id=
"notes"><title>Notes
</title>
81 If an error is generated,
82 no change is made to the contents of
<parameter>pattern
</parameter>.
85 <refsect1 id=
"errors"><title>Errors
</title>
87 <constant>GL_INVALID_OPERATION
</constant> is generated if a non-zero buffer object name is bound to the
88 <constant>GL_PIXEL_PACK_BUFFER
</constant> target and the buffer object's data store is currently mapped.
91 <constant>GL_INVALID_OPERATION
</constant> is generated if a non-zero buffer object name is bound to the
92 <constant>GL_PIXEL_PACK_BUFFER
</constant> target and the data would be packed to the buffer
93 object such that the memory writes required would exceed the data store size.
96 <constant>GL_INVALID_OPERATION
</constant> is generated if
<function>glGetPolygonStipple
</function>
97 is executed between the execution of
<citerefentry><refentrytitle>glBegin
</refentrytitle></citerefentry>
98 and the corresponding execution of
<citerefentry><refentrytitle>glEnd
</refentrytitle></citerefentry>.
101 <refsect1 id=
"associatedgets"><title>Associated Gets
</title>
103 <citerefentry><refentrytitle>glGet
</refentrytitle></citerefentry> with argument
<constant>GL_PIXEL_PACK_BUFFER_BINDING
</constant>
106 <refsect1 id=
"seealso"><title>See Also
</title>
108 <citerefentry><refentrytitle>glPixelStore
</refentrytitle></citerefentry>,
109 <citerefentry><refentrytitle>glPixelTransfer
</refentrytitle></citerefentry>,
110 <citerefentry><refentrytitle>glPolygonStipple
</refentrytitle></citerefentry>,
111 <citerefentry><refentrytitle>glReadPixels
</refentrytitle></citerefentry>
114 <refsect1 id=
"Copyright"><title>Copyright
</title>
116 Copyright
<trademark class=
"copyright"></trademark> 1991-
2006
117 Silicon Graphics, Inc. This document is licensed under the SGI
118 Free Software B License. For details, see
119 <ulink url=
"http://oss.sgi.com/projects/FreeB/">http://oss.sgi.com/projects/FreeB/
</ulink>.