FreeCAD-Doc/localwiki/Draft_Line-en.html
2018-07-19 18:47:02 -05:00

96 lines
8.8 KiB
HTML

<html><head><title>Draft Line/en</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 Line/en</h1></div>
<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr"><hr/><div class="mw-parser-output"><table class="fcinfobox wikitable ct" >
<tr>
<td class="ctTitle">
<h3><span class="mw-headline" id=".7B.7B.7BName.2Fen.7D.7D.7D"><a href="https://www.freecadweb.org/wiki/index.php?title=File:Draft_Line.png" class="image"><img alt="Draft Line.png" src="32px-Draft_Line.png" width="32" height="32" srcset="/wiki/images/thumb/a/a8/Draft_Line.png/48px-Draft_Line.png 1.5x, /wiki/images/a/a8/Draft_Line.png 2x" /></a> {{{Name/en}}}</span></h3>
</td></tr>
<tr>
<th class="ctOdd">Menu location
</th></tr>
<tr>
<td class="ctEven">Draft → Line
</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">L I
</td></tr>
<tr>
<th class="ctOdd">See also
</th></tr>
<tr>
<td class="ctEven"><a href="Draft_Wire.html" title="Draft Wire">Draft Wire</a>
</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="#.7B.7B.7BName.2Fen.7D.7D.7D"><span class="tocnumber">1</span> <span class="toctext">{{{Name/en}}}</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 Line tool creates a straight, two-points line in the current <a href="Draft_SelectPlane.html" title="Draft SelectPlane">work plane</a>. It takes the <a href="Draft_Linestyle.html" title="Draft Linestyle">linewidth and color</a> previously set on the Tasks tab. The Line tool behaves exactly like the <a href="Draft_Wire.html" title="Draft Wire">Draft Wire</a> tool, except that it stops after two points.
</p><p><a href="https://www.freecadweb.org/wiki/index.php?title=File:Draft_Line_example.jpg" class="image"><img alt="Draft Line example.jpg" src="400px-Draft_Line_example.jpg" width="400" height="232" srcset="/wiki/images/thumb/6/6c/Draft_Line_example.jpg/600px-Draft_Line_example.jpg 1.5x, /wiki/images/6/6c/Draft_Line_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_Line.png" class="image"><img alt="Draft Line.png" src="16px-Draft_Line.png" width="16" height="16" srcset="/wiki/images/thumb/a/a8/Draft_Line.png/24px-Draft_Line.png 1.5x, 32px-Draft_Line.png 2x" /></a> <a href="Draft_Line.html" title="Draft Line">Draft Line</a></span> button, or press <span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;">L</span> then <span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;">I</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></li>
<li> Click a second point on the 3D view, or type a <a href="Draft_Coordinates.html" title="Draft Coordinates">coordinate</a></li></ol>
<h2><span class="mw-headline" id="Options">Options</span></h2>
<ul><li> Press <span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;">X</span>, <span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;">Y</span> or <span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;">Z</span> after the first point to constrain the second point on the given axis.</li>
<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;">R</span> or click the checkbox to check/uncheck the <span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;"><b>Relative</b></span> button. If relative mode is on, the coordinates of the second point are relative to the first one. If not, they are absolute, taken from the (0,0,0) origin point.</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 Line tool will restart after you give the second point, allowing you to draw another line segment without pressing the Line 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 second point horizontally or vertically in relation to the first one.</li>
<li> Press <span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;">CTRL</span>+<span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;">Z</span> or 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_UndoLine.png" class="image"><img alt="Draft UndoLine.png" src="12px-Draft_UndoLine.png" width="12" height="12" srcset="/wiki/images/thumb/d/dd/Draft_UndoLine.png/18px-Draft_UndoLine.png 1.5x, /wiki/images/thumb/d/dd/Draft_UndoLine.png/24px-Draft_UndoLine.png 2x" /></a> <b><a href="Draft_UndoLine.html" title="Draft UndoLine">Undo</a></b></span> button to undo the last point.</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 Line command.</li>
<li> If several connected <a href="Draft_Line.html" title="Draft Line">Draft Lines</a> are selected they can be transformed into a wire by pressing the <b>Draft Upgrade</b> Button.</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>Start</b>: The start point</li>
<li> <span style="font-size: 0.6em;padding-right:10px;">DATA</span><b>End</b>: The end point</li>
<li> <span style="font-size: 0.6em;padding-right:10px;">DATA</span><b>Subdivisions</b>: Divides the line with the given number of subdivisions <span style="font-size:x-small;"><a href="Release_notes_0.16.html" title="Release notes 0.16">available in version 0.16</a></span></li></ul>
<p><br />
</p>
<h2><span class="mw-headline" id="Scripting">Scripting</span></h2>
<p>The Line 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>makeLine (Vector, Vector) </pre>
<ul><li> Creates a line between the two given vectors. The current draft linewidth and color will be used.</li>
<li> Returns the newly created object.</li></ul>
<p>Example:
</p>
<pre>import FreeCAD, Draft
Draft.makeLine(FreeCAD.Vector(0,0,0),FreeCAD.Vector(2,0,0)) </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_Line/en&amp;oldid=208854">http://www.freecadweb.org/wiki/index.php?title=Draft_Line/en&amp;oldid=208854</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>