FreeCAD-Doc/localwiki/TechDraw_Dimension_Horizontal.html
2018-07-08 12:11:49 -05:00

94 lines
7.1 KiB
HTML

<html><head><title>TechDraw Dimension Horizontal</title><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><link type='text/css' href='wiki.css' rel='stylesheet'></head><body><h1>TechDraw Dimension Horizontal</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="TechDraw_Dimension_Horizontal"><a href="https://www.freecadweb.org/wiki/index.php?title=File:TechDraw_Dimension_Horizontal.png" class="image"><img alt="TechDraw Dimension Horizontal.png" src="32px-TechDraw_Dimension_Horizontal.png" width="32" height="32" srcset="/wiki/images/thumb/1/14/TechDraw_Dimension_Horizontal.png/48px-TechDraw_Dimension_Horizontal.png 1.5x, /wiki/images/1/14/TechDraw_Dimension_Horizontal.png 2x" /></a> TechDraw Dimension Horizontal</span></h3>
</td></tr>
<tr>
<th class="ctOdd">Menu location
</th></tr>
<tr>
<td class="ctEven">TechDraw → Dimension Horizontal
</td></tr>
<tr>
<th class="ctOdd">Workbenches
</th></tr>
<tr>
<td class="ctEven"><a href="TechDraw_Module.html" title="TechDraw Module">TechDraw</a>
</td></tr>
<tr>
<th class="ctOdd">Default shortcut
</th></tr>
<tr>
<td class="ctEven">
</td></tr>
<tr>
<th class="ctOdd">See also
</th></tr>
<tr>
<td class="ctEven">
</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="#TechDraw_Dimension_Horizontal"><span class="tocnumber">1</span> <span class="toctext">TechDraw Dimension Horizontal</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>
<li class="toclevel-1 tocsection-6"><a href="#Notes"><span class="tocnumber">7</span> <span class="toctext">Notes</span></a></li>
</ul>
</div>
</td></tr></table>
<p><br />
</p>
<h2><span class="mw-headline" id="Description">Description</span></h2>
<p>The Dimension Horizontal tool adds a horizontal dimension to a View. The dimension may be between two vertices, the length of one edge or the horizontal distance between 2 edges. The distance will initially be the projected distance (ie as shown on the drawing), but this may be changed to the actual 3D distance using the Link Dimension <a href="https://www.freecadweb.org/wiki/index.php?title=File:LinkDimension.png" class="image"><img alt="LinkDimension.png" src="24px-LinkDimension.png" width="24" height="24" srcset="/wiki/images/thumb/e/e6/LinkDimension.png/36px-LinkDimension.png 1.5x, /wiki/images/thumb/e/e6/LinkDimension.png/48px-LinkDimension.png 2x" /></a> tool.
</p>
<div class="center"><div class="floatnone"><a href="https://www.freecadweb.org/wiki/index.php?title=File:HorizontalSample.png" class="image"><img alt="HorizontalSample.png" src="HorizontalSample.png" width="200" height="200" /></a></div></div>
<h2><span class="mw-headline" id="How_to_use">How to use</span></h2>
<ol><li> Select the points or edge which define your measurement.</li>
<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:Dimension_Horizontal.png" class="image"><img alt="Dimension Horizontal.png" src="24px-Dimension_Horizontal.png" width="24" height="24" srcset="/wiki/images/thumb/b/b3/Dimension_Horizontal.png/36px-Dimension_Horizontal.png 1.5x, /wiki/images/thumb/b/b3/Dimension_Horizontal.png/48px-Dimension_Horizontal.png 2x" /></a> <a class="mw-selflink selflink">Dimension Horizontal</a></span> button</li>
<li> A dimension will be added to the View. The dimension may be dragged to the desired position.</li></ol>
<h2><span class="mw-headline" id="Options">Options</span></h2>
<p>None.
</p>
<h2><span class="mw-headline" id="Properties">Properties</span></h2>
<ul><li> <span style="font-size: 0.6em;padding-right:10px;">DATA</span><b>X</b>: Horizontal position of the dimension text relative to the View.</li>
<li> <span style="font-size: 0.6em;padding-right:10px;">DATA</span><b>Y</b>: Vertical position of the dimension text relative to the View.</li>
<li> <span style="font-size: 0.6em;padding-right:10px;">DATA</span><b>FormatSpec</b>: Allows additional text to be added to the dimension text. Dimension value will replace&#160;%.2f (or other valid <a rel="nofollow" class="external text" href="https://en.wikipedia.org/wiki/Printf_format_string">printf</a> format specifier). </li>
<li> <span style="font-size: 0.6em;padding-right:10px;">DATA</span><b>Type</b>: Length,radius,diameter, etc. Not normally manipulated by the end user. </li>
<li> <span style="font-size: 0.6em;padding-right:10px;">DATA</span><b>MeasureType</b>: "True" - based on 3D geometry or "Projected" - based on the drawing. Not normally manipulated directly by the end user.</li>
<li> <span style="font-size: 0.6em;padding-right:10px;">DATA</span><b>Arbitrary</b>: "True" - ignore actual value and display FormatSpec as value. "False" - use actual value.</li>
<li> <span style="font-size: 0.6em;padding-right:10px;">VIEW</span><b>Font</b>: The name of the font to use for the dimension text.</li>
<li> <span style="font-size: 0.6em;padding-right:10px;">VIEW</span><b>Fontsize</b>: Dimension text size in mm.</li>
<li> <span style="font-size: 0.6em;padding-right:10px;">VIEW</span><b>LineWidth</b>: Dimension line weight. </li>
<li> <span style="font-size: 0.6em;padding-right:10px;">VIEW</span><b>Color</b>: Color for lines and text.</li></ul>
<h2><span class="mw-headline" id="Scripting">Scripting</span></h2>
<p>Horizonatal dimensions can be added to Pages using Python.
</p>
<pre>dim1 = FreeCAD.ActiveDocument.addObject('TechDraw::DrawViewDimension','Dimension')
dim1.Type = "DistanceX"
dim1.References2D=[(view1, 'Edge1')]
rc = page.addView(dim1) </pre>
<h2><span class="mw-headline" id="Notes">Notes</span></h2>
<ul><li> All Dimensions are extremely vulnerable to the infamous "topological naming" issue. It is not possible at this time to keep references to 2D (projected) or 3D (actual) geometrical objects in sync with changes in the model. It is recommended that Dimensions be added towards the end of the drawing creation process. </li></ul>
<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=TechDraw_Dimension_Horizontal&amp;oldid=251973">http://www.freecadweb.org/wiki/index.php?title=TechDraw_Dimension_Horizontal&amp;oldid=251973</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>