102 lines
8.3 KiB
HTML
102 lines
8.3 KiB
HTML
<html><head><title>Draft Polygon</title><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><link type='text/css' href='wiki.css' rel='stylesheet'></head><body><h1>Draft Polygon</h1></div>
|
|
|
|
<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr"><div class="mw-parser-output"><table class="fcinfobox wikitable ct" >
|
|
<tr>
|
|
<td class="ctTitle">
|
|
<h3><span class="mw-headline" id="Draft_Polygon"><a href="https://www.freecadweb.org/wiki/index.php?title=File:Draft_Polygon.png" class="image"><img alt="Draft Polygon.png" src="32px-Draft_Polygon.png" width="32" height="32" srcset="/wiki/images/thumb/8/8e/Draft_Polygon.png/48px-Draft_Polygon.png 1.5x, /wiki/images/8/8e/Draft_Polygon.png 2x" /></a> Draft Polygon</span></h3>
|
|
</td></tr>
|
|
<tr>
|
|
<th class="ctOdd">Menu location
|
|
</th></tr>
|
|
<tr>
|
|
<td class="ctEven">Draft → Polygon
|
|
</td></tr>
|
|
<tr>
|
|
<th class="ctOdd">Workbenches
|
|
</th></tr>
|
|
<tr>
|
|
<td class="ctEven"><a href="Draft_Module.html" title="Draft Module">Draft</a>, <a href="Arch_Module.html" title="Arch Module">Arch</a>
|
|
</td></tr>
|
|
<tr>
|
|
<th class="ctOdd">Default shortcut
|
|
</th></tr>
|
|
<tr>
|
|
<td class="ctEven">P G
|
|
</td></tr>
|
|
<tr>
|
|
<th class="ctOdd">See also
|
|
</th></tr>
|
|
<tr>
|
|
<td class="ctEven">None
|
|
</td></tr>
|
|
<tr>
|
|
<td class="ctToc"><br /><div id="toc" class="toc"><div class="toctitle"><h2>Contents</h2></div>
|
|
<ul>
|
|
<li class="toclevel-1"><a href="#Draft_Polygon"><span class="tocnumber">1</span> <span class="toctext">Draft Polygon</span></a></li>
|
|
<li class="toclevel-1 tocsection-1"><a href="#Description"><span class="tocnumber">2</span> <span class="toctext">Description</span></a></li>
|
|
<li class="toclevel-1 tocsection-2"><a href="#How_to_use"><span class="tocnumber">3</span> <span class="toctext">How to use</span></a></li>
|
|
<li class="toclevel-1 tocsection-3"><a href="#Options"><span class="tocnumber">4</span> <span class="toctext">Options</span></a></li>
|
|
<li class="toclevel-1 tocsection-4"><a href="#Properties"><span class="tocnumber">5</span> <span class="toctext">Properties</span></a></li>
|
|
<li class="toclevel-1 tocsection-5"><a href="#Scripting"><span class="tocnumber">6</span> <span class="toctext">Scripting</span></a></li>
|
|
</ul>
|
|
</div>
|
|
|
|
</td></tr></table>
|
|
<p><br />
|
|
</p>
|
|
<h2><span class="mw-headline" id="Description">Description</span></h2>
|
|
<p>The polygon tool creates a regular polygon by picking two points, the center and a second point defining a radius. It takes the <a href="Draft_Linestyle.html" title="Draft Linestyle">linewidth and color</a> previously set on the Tasks tab.
|
|
</p><p><a href="https://www.freecadweb.org/wiki/index.php?title=File:Draft_polygon_example.jpg" class="image"><img alt="Draft polygon example.jpg" src="400px-Draft_polygon_example.jpg" width="400" height="256" srcset="/wiki/images/thumb/5/5f/Draft_polygon_example.jpg/600px-Draft_polygon_example.jpg 1.5x, /wiki/images/5/5f/Draft_polygon_example.jpg 2x" /></a>
|
|
</p>
|
|
<h2><span class="mw-headline" id="How_to_use">How to use</span></h2>
|
|
<ol><li> Press the <span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;"><a href="https://www.freecadweb.org/wiki/index.php?title=File:Draft_Polygon.png" class="image"><img alt="Draft Polygon.png" src="16px-Draft_Polygon.png" width="16" height="16" srcset="/wiki/images/thumb/8/8e/Draft_Polygon.png/24px-Draft_Polygon.png 1.5x, 32px-Draft_Polygon.png 2x" /></a> <a class="mw-selflink selflink">Draft Polygon</a></span> button, or press <span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;">P</span> then <span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;">G</span> keys</li>
|
|
<li> Click a first point on the 3D view, or type a <a href="Draft_Coordinates.html" title="Draft Coordinates">coordinate</a> to indicate the center</li>
|
|
<li> Adjust the desired number of sides in the options dialog, </li>
|
|
<li> Click another point on the 3D view, or type a radius value to define the polygon radius. The polygon will also be a face, even if it appears as wireframe.</li></ol>
|
|
<h2><span class="mw-headline" id="Options">Options</span></h2>
|
|
<ul><li> To enter coordinates manually, simply enter the numbers, then press <span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;">ENTER</span> between each X, Y and Z component.</li>
|
|
<li> Press <span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;">T</span> or click the checkbox to check/uncheck the <span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;"><b>Continue</b></span> button. If continue mode is on, the Polygon tool will restart after you finish or close it, allowing you to draw another one without pressing the Polygon button again.</li>
|
|
<li> Press <span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;">CTRL</span> while drawing to force <a href="Draft_Snap.html" title="Draft Snap">snapping</a> your point to the nearest snap location, independently of the distance.</li>
|
|
<li> Press <span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;">SHIFT</span> while drawing to <a href="Draft_Constrain.html" title="Draft Constrain">constrain</a> your next point horizontally or vertically in relation to the last one.</li>
|
|
<li> Press <span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;">I</span> or the <span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;"><b>Filled</b></span> button to have the polygon filled with a face after it has been closed</li>
|
|
<li> Press <span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;">ESC</span> or the <span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;"><b>Cancel</b></span> button to abort the current command.</li>
|
|
<li> Polygons, when in "Flat Lines" display mode, can display a hatch pattern, by setting their "Pattern" property below.</li></ul>
|
|
<h2><span class="mw-headline" id="Properties">Properties</span></h2>
|
|
<ul><li> <span style="font-size: 0.6em;padding-right:10px;">DATA</span><b>Radius</b>: The radius of the defining circle</li>
|
|
<li> <span style="font-size: 0.6em;padding-right:10px;">DATA</span><b>Draw Mode</b>: Specifies if the polygon is inscribed or circumscribed around the defining circle</li>
|
|
<li> <span style="font-size: 0.6em;padding-right:10px;">DATA</span><b>Faces Number</b>: The number of sides of the polygon</li>
|
|
<li> <span style="font-size: 0.6em;padding-right:10px;">DATA</span><b>Chamfer Size</b>: Specifies the size of chamfered corners</li>
|
|
<li> <span style="font-size: 0.6em;padding-right:10px;">DATA</span><b>Fillet Radius</b>: Specifies a curvature radius to give to the corners of the rectangle</li>
|
|
<li> <span style="font-size: 0.6em;padding-right:10px;">DATA</span><b>Make Face</b>: Fills the polygon with a face</li>
|
|
<li> <span style="font-size: 0.6em;padding-right:10px;">VIEW</span><b>Pattern</b>: Specifies a hatch pattern to fill the wire with</li>
|
|
<li> <span style="font-size: 0.6em;padding-right:10px;">VIEW</span><b>Pattern Size</b>: Specifies the size of the hatch pattern</li></ul>
|
|
<p>See also <a href="Draft_Pattern.html" title="Draft Pattern">Draft Pattern</a> page.
|
|
</p>
|
|
<h2><span class="mw-headline" id="Scripting">Scripting</span></h2>
|
|
<p>The Polygon tool can by used in <a href="Macros.html" title="Macros">macros</a> and from the python console by using the following function:
|
|
</p>
|
|
<pre>makePolygon(nfaces,[radius],[inscribed],[placement],[face]) </pre>
|
|
<ul><li> Creates a polygon object with the given number of faces and the radius. </li>
|
|
<li> If inscribed is False, the polygon is circumscribed around a circle with the given radius, otherwise it is inscribed. </li>
|
|
<li> If face is True, the resulting shape is displayed as a face, otherwise as a wireframe. </li>
|
|
<li> Returns the newly created object.</li></ul>
|
|
<p>Example:
|
|
</p>
|
|
<pre>import Draft
|
|
Draft.makePolygon(5,radius=3) </pre>
|
|
<div style="clear:both"></div>
|
|
</div>
|
|
|
|
|
|
|
|
</div>
|
|
|
|
</div><div class="printfooter">
|
|
Online version: "<a dir="ltr" href="https://www.freecadweb.org/wiki/index.php?title=Draft_Polygon&oldid=279540">http://www.freecadweb.org/wiki/index.php?title=Draft_Polygon&oldid=279540</a>"</div>
|
|
<div id="catlinks" class="catlinks" data-mw="interface"></div><div class="visualClear"></div>
|
|
</div>
|
|
</div>
|
|
<div id="mw-navigation">
|
|
<h2>Navigation menu</h2>
|
|
|
|
</body></html> |