rename upstream-man-pages to upstream-doc
[clinton/guile-figl.git] / upstream-doc / man2 / xhtml / gluPwlCurve.xml
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
2 <!-- saved from url=(0013)about:internet -->
3 <?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" /><title>gluPwlCurve</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="gluPwlCurve"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>gluPwlCurve — describe a piecewise linear NURBS trimming curve</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">gluPwlCurve</b>(</code></td><td>GLUnurbs*  </td><td><var class="pdparam">nurb</var>, </td></tr><tr><td> </td><td>GLint  </td><td><var class="pdparam">count</var>, </td></tr><tr><td> </td><td>GLfloat*  </td><td><var class="pdparam">data</var>, </td></tr><tr><td> </td><td>GLint  </td><td><var class="pdparam">stride</var>, </td></tr><tr><td> </td><td>GLenum  </td><td><var class="pdparam">type</var><code>)</code>;</td></tr></table></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>nurb</code></em></span></dt><dd><p>
4 Specifies the NURBS object (created with <a class="citerefentry" href="gluNewNurbsRenderer.xml"><span class="citerefentry"><span class="refentrytitle">gluNewNurbsRenderer</span></span></a>).
5 </p></dd><dt><span class="term"><em class="parameter"><code>count</code></em></span></dt><dd><p>
6 Specifies the number of points on the curve.
7 </p></dd><dt><span class="term"><em class="parameter"><code>data</code></em></span></dt><dd><p>
8 Specifies an array containing the curve points.
9 </p></dd><dt><span class="term"><em class="parameter"><code>stride</code></em></span></dt><dd><p>
10 Specifies the offset (a number of single-precision floating-point values)
11 between points on the curve.
12 </p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>
13 Specifies the type of curve.
14 Must be either <code class="constant">GLU_MAP1_TRIM_2</code> or <code class="constant">GLU_MAP1_TRIM_3</code>.
15 </p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
16 <code class="function">gluPwlCurve</code> describes a piecewise linear trimming curve for a NURBS surface.
17 A piecewise linear curve consists of a list of
18 coordinates of points in the parameter space for the
19 NURBS surface to be trimmed. These points are connected
20 with line segments to form a curve. If the curve is
21 an approximation to a curve that is not piecewise linear,
22 the points should be close enough in parameter space that the
23 resulting path appears curved at the resolution used in the application.
24 </p><p>
25 If <em class="parameter"><code>type</code></em> is
26 <code class="constant">GLU_MAP1_TRIM_2</code>, then it describes a curve in two-dimensional (<span class="emphasis"><em>u</em></span>
27 and <span class="emphasis"><em>v</em></span>) parameter space. If it is <code class="constant">GLU_MAP1_TRIM_3</code>, then it
28 describes a curve in two-dimensional homogeneous (<span class="emphasis"><em>u</em></span>, <span class="emphasis"><em>v</em></span>,
29 and <span class="emphasis"><em>w</em></span>) parameter space.
30 See the <a class="citerefentry" href="gluBeginTrim.xml"><span class="citerefentry"><span class="refentrytitle">gluBeginTrim</span></span></a> reference page for more information
31 about trimming curves.
32 </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="notes"></a><h2>Notes</h2><p>
33 To describe a trim curve that closely follows the contours of a NURBS
34 surface, call <a class="citerefentry" href="gluNurbsCurve.xml"><span class="citerefentry"><span class="refentrytitle">gluNurbsCurve</span></span></a>.
35 </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
36 <a class="citerefentry" href="gluBeginCurve.xml"><span class="citerefentry"><span class="refentrytitle">gluBeginCurve</span></span></a>,
37 <a class="citerefentry" href="gluBeginTrim.xml"><span class="citerefentry"><span class="refentrytitle">gluBeginTrim</span></span></a>,
38 <a class="citerefentry" href="gluNewNurbsRenderer.xml"><span class="citerefentry"><span class="refentrytitle">gluNewNurbsRenderer</span></span></a>,
39 <a class="citerefentry" href="gluNurbsCurve.xml"><span class="citerefentry"><span class="refentrytitle">gluNurbsCurve</span></span></a>
40 </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
41 Copyright <span class="trademark"></span>© 1991-2006
42 Silicon Graphics, Inc. This document is licensed under the SGI
43 Free Software B License. For details, see
44 <a class="ulink" href="http://oss.sgi.com/projects/FreeB/" target="_top">http://oss.sgi.com/projects/FreeB/</a>.
45 </p></div></div></body></html>