/usr/share/doc/sketch-doc/sketch/Swept-polygons.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Copyright (C) 2005 to 2012 Eugene K. Ressler.

This manual is for sketch, version 0.3 (build 7),
Sunday, March 20, 2016, a program that converts descriptions of simple
three-dimensional scenes into line drawings. This version generates
PSTricks or PGF/TikZ code suitable for use with the
TeX document processing system.

Sketch is free software. You can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3, or (at your option)
any later version.

Sketch is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with sketch; see the file COPYING.txt.  If not, see
http://www.gnu.org/copyleft.
 -->
<!-- Created by GNU Texinfo 6.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>Sketch: Swept polygons</title>

<meta name="description" content="Sketch: Swept polygons">
<meta name="keywords" content="Sketch: Swept polygons">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Index-of-syntax.html#Index-of-syntax" rel="index" title="Index of syntax">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Sweeps.html#Sweeps" rel="up" title="Sweeps">
<link href="Swept-blocks.html#Swept-blocks" rel="next" title="Swept blocks">
<link href="Swept-lines.html#Swept-lines" rel="prev" title="Swept lines">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en">
<a name="Swept-polygons"></a>
<div class="header">
<p>
Next: <a href="Swept-blocks.html#Swept-blocks" accesskey="n" rel="next">Swept blocks</a>, Previous: <a href="Swept-lines.html#Swept-lines" accesskey="p" rel="prev">Swept lines</a>, Up: <a href="Sweeps.html#Sweeps" accesskey="u" rel="up">Sweeps</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index-of-syntax.html#Index-of-syntax" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Swept-polygons-1"></a>
<h4 class="subsubsection">3.2.6.3 Swept polygons</h4>
<a name="index-polygon-sweep-1"></a>
<p>If <var>swept_object</var> is a polygon, the <code>sweep</code> connects
<em><var>n</var>+1</em> successive copies of the closed polyline border of
the polygon to form body polygons exactly as though the border were a
swept polyline as described in <a href="Swept-lines.html#Swept-lines">Swept lines</a>.
<a name="index-body-polygon-2"></a>
<a name="index-polygon_002c-body-2"></a>
If there are <em>m</em> points in the
original polygon, then <em>m<var>n</var></em> body polygons are formed by
this sweep.  The body polygons form an <em>extrusion</em> of the boundary of the
original polygon with two holes at the open ends.  
</p>
<p>Finally, the sweep adds two copies of the original polygon to cover
the holes.  We call these hole-filling polygons <em>ends</em>.
<a name="index-end-polygon-1"></a>
<a name="index-polygon_002c-end-1"></a>
In this manner, <code>sweep</code> forms the boundary of a three-dimensional
object from a two-dimensional polygon.
</p>
<p>The order of vertices 
<a name="index-polygon-vertex-order-3"></a>
<a name="index-order_002c-polygon-vertex-3"></a>
of end polygons is important for correct culling as described above.
An exact copy of the original polygon with vertex order intact forms
the first end polygon.  The other end polygon results from
transforming and the reversing the order of vertices in the original.
The transform places the original polygon at the uncovered hole;
it is
</p><div class="example">
<pre class="example"><em><var>T_1</var>^n</em> then <em><var>T_2</var>^n</em> then &hellip; then <em><var>T_r</var>^n</em>.
</pre></div>
<p>If there are no options on the swept polygon, then the &lsquo;<samp>sweep</samp>&rsquo;
options are copied to each output polygon.  If the swept polygon does
have options, these are copied to the ends; the sweep options are
copied to the body polygons.  In this manner, body and ends may be
drawn with different characteristics such as <code>fillcolor</code>.
</p>



</body>
</html>
sketch-doc 1:0.3.7-2 / usr / share / doc / sketch-doc / sketch / Swept-polygons.html
