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

89 lines
7.3 KiB
HTML

<html><head><title>Draft SetWorkingPlaneProxy</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 SetWorkingPlaneProxy</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_SetWorkingPlaneProxy"><a href="https://www.freecadweb.org/wiki/index.php?title=File:Draft_SetWorkingPlaneProxy.png" class="image"><img alt="Draft SetWorkingPlaneProxy.png" src="32px-Draft_SetWorkingPlaneProxy.png" width="32" height="32" srcset="/wiki/images/thumb/0/03/Draft_SetWorkingPlaneProxy.png/48px-Draft_SetWorkingPlaneProxy.png 1.5x, /wiki/images/0/03/Draft_SetWorkingPlaneProxy.png 2x" /></a> Draft SetWorkingPlaneProxy</span></h3>
</td></tr>
<tr>
<th class="ctOdd">Menu location
</th></tr>
<tr>
<td class="ctEven">Draft → Utilities → Create WP Proxy
</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">None
</td></tr>
<tr>
<th class="ctOdd">See also
</th></tr>
<tr>
<td class="ctEven"><a href="Draft_SelectPlane.html" title="Draft SelectPlane">Draft SelectPlane</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="#Draft_SetWorkingPlaneProxy"><span class="tocnumber">1</span> <span class="toctext">Draft SetWorkingPlaneProxy</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>This command will place a Proxy object in the document, placed and aligned to the current <a href="Draft_SelectPlane.html" title="Draft SelectPlane">Working Plane</a>. When using the <a href="Draft_SelectPlane.html" title="Draft SelectPlane">Draft SelectPlane</a> command with such a Proxy object selected, or by double-clicking it in the tree view, the working plane will be positioned and aligned back with the proxy object. The camera position and hidden/shown state of objects are also stored in the Proxy object, and can be restored if the corresponding properties are enabled (see below).
</p>
<h2><span class="mw-headline" id="How_to_use">How to use</span></h2>
<ol><li> Make sure the <a href="Draft_SelectPlane.html" title="Draft SelectPlane">Working Plane</a> is set as you want.</li>
<li> Press Draft -&gt; Utilities -&gt; <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_SetWorkingPlaneProxy.png" class="image"><img alt="Draft SetWorkingPlaneProxy.png" src="16px-Draft_SetWorkingPlaneProxy.png" width="16" height="16" srcset="/wiki/images/thumb/0/03/Draft_SetWorkingPlaneProxy.png/24px-Draft_SetWorkingPlaneProxy.png 1.5x, 32px-Draft_SetWorkingPlaneProxy.png 2x" /></a> <a class="mw-selflink selflink">Create WP Proxy</a></span></li></ol>
<h2><span class="mw-headline" id="Options">Options</span></h2>
<ul><li> WP proxies can be manipulated (moved and rotated) like any other FreeCAD object</li>
<li> The size and appearance of the proxy object can be set in the View properties</li>
<li> The position of the camera is stored in the Proxy object upon creation. That position can be changed anytime by right-clicking the Proxy object, then select the "Write camera position" option to store the current camera position.</li>
<li> The hidden/shown state of all the objects currently in the document is also stored in the Proxy object upon creation. That state can be updated anytime by right-clicking the Proxy object, then select the "Write objects state" option.</li>
<li> The Working Plane stored in the Proxy object can be restored by double-clicking the Proxy object in the tree view, or by using the <a href="Draft_SelectPlane.html" title="Draft SelectPlane">Draft SelectPlane</a> tool with the Proxy object selected.</li>
<li> If the <b>RestoreView</b> property is set to True, the camera position will also be restored to the saved position on double-clicking the Proxy object or using <a href="Draft_SelectPlane.html" title="Draft SelectPlane">Draft SelectPlane</a> </li>
<li> If the <b>RestoreState</b> property is set to True, the objects hidden/shown state will also be restored to the saved position on double-clicking the Proxy object or using <a href="Draft_SelectPlane.html" title="Draft SelectPlane">Draft SelectPlane</a>. If new objects have been added to the document after the state was stored in the Proxy object, the visibility of these new objects will be unchanged</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>Placement</b>: Stores the position of this Proxy and the corresponding Working Plane</li>
<li> <span style="font-size: 0.6em;padding-right:10px;">VIEW</span><b>Display Size</b>: The size of the Proxy object in the 3D view</li>
<li> <span style="font-size: 0.6em;padding-right:10px;">VIEW</span><b>Arrow Size</b>: The size of the arrows on the 3 axes</li>
<li> <span style="font-size: 0.6em;padding-right:10px;">VIEW</span><b>Restore View</b>: If true, the camera position will be restored on activating (by double-click or <a href="Draft_SelectPlane.html" title="Draft SelectPlane">Draft SelectPlane</a>) this object</li>
<li> <span style="font-size: 0.6em;padding-right:10px;">VIEW</span><b>Restore State</b>: If true, the visibility state of all objects in the current document will be restored on activating (by double-click or <a href="Draft_SelectPlane.html" title="Draft SelectPlane">Draft SelectPlane</a>) this object</li></ul>
<h2><span class="mw-headline" id="Scripting">Scripting</span></h2>
<p>Working plane proxy objects can easily be created in scripts and <a href="Macros.html" title="Macros">macros</a>:
</p><p>Example:
</p>
<pre>import FreeCAD,Draft
currentWP = FreeCAD.DraftWorkingPlane
Draft.makeWorkingPlaneProxy(currentWP.getPlacement()) </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_SetWorkingPlaneProxy&amp;oldid=234773">http://www.freecadweb.org/wiki/index.php?title=Draft_SetWorkingPlaneProxy&amp;oldid=234773</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>