1 <?xml version=
"1.0" encoding=
"UTF-8"?>
2 <!DOCTYPE html PUBLIC
"-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
3 <!-- saved from url=(0013)about:internet -->
4 <?xml-stylesheet type=
"text/xsl" href=
"mathml.xsl"?><html xmlns=
"http://www.w3.org/1999/xhtml" xmlns:
pref=
"http://www.w3.org/2002/Math/preference" pref:
renderer=
"mathplayer-dl"><head><meta http-equiv=
"Content-Type" content=
"text/html; charset=UTF-8" /><link rel=
"stylesheet" type=
"text/css" href=
"opengl-man.css" /><title>glPolygonMode - OpenGL
4 Reference Pages
</title><meta name=
"generator" content=
"DocBook XSL Stylesheets V1.69.1" /></head><body><div class=
"refentry" lang=
"en" xml:
lang=
"en"><a id=
"glPolygonMode"></a><div class=
"titlepage"></div><div class=
"refnamediv"><h2>Name
</h2><p>glPolygonMode — select a polygon rasterization mode
</p></div><div class=
"refsynopsisdiv"><h2>C Specification
</h2><div class=
"funcsynopsis"><p><code class=
"funcdef">void
<b class=
"fsfunc">glPolygonMode
</b>(
</code>GLenum
<var class=
"pdparam">face
</var>, GLenum
<var class=
"pdparam">mode
</var><code>)
</code>;
</p></div></div><div class=
"refsect1" lang=
"en" xml:
lang=
"en"><a id=
"parameters"></a><h2>Parameters
</h2><div class=
"variablelist"><dl><dt><span class=
"term"><em class=
"parameter"><code>face
</code></em></span></dt><dd><p>
5 Specifies the polygons that
<em class=
"parameter"><code>mode
</code></em> applies to.
6 Must be
<code class=
"constant">GL_FRONT_AND_BACK
</code> for front- and back-facing polygons.
7 </p></dd><dt><span class=
"term"><em class=
"parameter"><code>mode
</code></em></span></dt><dd><p>
8 Specifies how polygons will be rasterized.
10 <code class=
"constant">GL_POINT
</code>,
11 <code class=
"constant">GL_LINE
</code>, and
12 <code class=
"constant">GL_FILL
</code>.
13 The initial value is
<code class=
"constant">GL_FILL
</code> for both front- and back-facing polygons.
14 </p></dd></dl></div></div><div class=
"refsect1" lang=
"en" xml:
lang=
"en"><a id=
"description"></a><h2>Description
</h2><p>
15 <code class=
"function">glPolygonMode
</code> controls the interpretation of polygons for rasterization.
16 <em class=
"parameter"><code>face
</code></em> describes which polygons
<em class=
"parameter"><code>mode
</code></em> applies to:
17 both front and back-facing polygons (
<code class=
"constant">GL_FRONT_AND_BACK
</code>).
18 The polygon mode affects only the final rasterization of polygons.
20 a polygon's vertices are lit and
21 the polygon is clipped and possibly culled before these modes are applied.
23 Three modes are defined and can be specified in
<em class=
"parameter"><code>mode
</code></em>:
24 </p><div class=
"variablelist"><dl><dt><span class=
"term"><code class=
"constant">GL_POINT
</code></span></dt><dd><p>
25 Polygon vertices that are marked as the start of a boundary edge
27 Point attributes such as
28 <code class=
"constant">GL_POINT_SIZE
</code> and
29 <code class=
"constant">GL_POINT_SMOOTH
</code> control
30 the rasterization of the points.
31 Polygon rasterization attributes other than
<code class=
"constant">GL_POLYGON_MODE
</code> have no effect.
32 </p></dd><dt><span class=
"term"><code class=
"constant">GL_LINE
</code></span></dt><dd><p>
33 Boundary edges of the polygon are drawn as line segments.
34 Line attributes such as
35 <code class=
"constant">GL_LINE_WIDTH
</code> and
36 <code class=
"constant">GL_LINE_SMOOTH
</code> control
37 the rasterization of the lines.
38 Polygon rasterization attributes other than
<code class=
"constant">GL_POLYGON_MODE
</code> have no effect.
39 </p></dd><dt><span class=
"term"><code class=
"constant">GL_FILL
</code></span></dt><dd><p>
40 The interior of the polygon is filled.
41 Polygon attributes such as
<code class=
"constant">GL_POLYGON_SMOOTH
</code> control the rasterization of the polygon.
42 </p></dd></dl></div></div><div class=
"refsect1" lang=
"en" xml:
lang=
"en"><a id=
"examples"></a><h2>Examples
</h2><p>
43 To draw a surface with outlined polygons,
45 </p><pre class=
"programlisting">
46 glPolygonMode(
<code class=
"constant">GL_FRONT_AND_BACK
</code>,
<code class=
"constant">GL_LINE
</code>);
48 </p></div><div class=
"refsect1" lang=
"en" xml:
lang=
"en"><a id=
"notes"></a><h2>Notes
</h2><p>
49 Vertices are marked as boundary or nonboundary with an edge flag.
50 Edge flags are generated internally by the GL when it decomposes
51 triangle stips and fans.
52 </p></div><div class=
"refsect1" lang=
"en" xml:
lang=
"en"><a id=
"errors"></a><h2>Errors
</h2><p>
53 <code class=
"constant">GL_INVALID_ENUM
</code> is generated if either
<em class=
"parameter"><code>face
</code></em> or
<em class=
"parameter"><code>mode
</code></em> is not
55 </p></div><div class=
"refsect1" lang=
"en" xml:
lang=
"en"><a id=
"associatedgets"></a><h2>Associated Gets
</h2><p>
56 <a href=
"glGet.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glGet
</span></span></a> with argument
<code class=
"constant">GL_POLYGON_MODE
</code>
57 </p></div><div class=
"refsect1" lang=
"en" xml:
lang=
"en"><a id=
"seealso"></a><h2>See Also
</h2><p>
58 <a href=
"glLineWidth.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glLineWidth
</span></span></a>,
59 <a href=
"glPointSize.xml"><span class=
"citerefentry"><span class=
"refentrytitle">glPointSize
</span></span></a>
60 </p></div><div class=
"refsect1" lang=
"en" xml:
lang=
"en"><a id=
"Copyright"></a><h2>Copyright
</h2><p>
61 Copyright
<span class=
"trademark"></span>©
1991-
2006
62 Silicon Graphics, Inc. This document is licensed under the SGI
63 Free Software B License. For details, see
64 <a href=
"http://oss.sgi.com/projects/FreeB/" target=
"_top">http://oss.sgi.com/projects/FreeB/
</a>.
65 </p></div></div></body></html>