editor.html 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346
  1. <!DOCTYPE html>
  2. <!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
  3. <!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
  4. <head>
  5. <meta charset="utf-8">
  6. <meta name="viewport" content="width=device-width, initial-scale=1.0">
  7. <title>Geometry Editor &mdash; FlatCAM 7 documentation</title>
  8. <link href='https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700' rel='stylesheet' type='text/css'>
  9. <script type="text/javascript">
  10. var DOCUMENTATION_OPTIONS = {
  11. URL_ROOT:'./',
  12. VERSION:'7',
  13. COLLAPSE_INDEX:false,
  14. FILE_SUFFIX:'.html',
  15. HAS_SOURCE: true
  16. };
  17. </script>
  18. <script type="text/javascript" src="_static/jquery.js"></script>
  19. <script type="text/javascript" src="_static/underscore.js"></script>
  20. <script type="text/javascript" src="_static/doctools.js"></script>
  21. <script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
  22. <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
  23. <script type="text/javascript" src="_static/js/theme.js"></script>
  24. <script type="text/javascript">
  25. jQuery(function () {
  26. SphinxRtdTheme.StickyNav.enable();
  27. });
  28. </script>
  29. <link rel="top" title="FlatCAM 7 documentation" href="index.html"/>
  30. <link rel="next" title="Shell Command Line Interface" href="flatcamshell.html"/>
  31. <link rel="prev" title="Common Procedures" href="procedures.html"/>
  32. <script src="https://cdnjs.cloudflare.com/ajax/libs/modernizr/2.6.2/modernizr.min.js"></script>
  33. <script>
  34. (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
  35. (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
  36. m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
  37. })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
  38. ga('create', 'UA-55008703-1', 'auto');
  39. ga('send', 'pageview');
  40. </script>
  41. </head>
  42. <body class="wy-body-for-nav" role="document">
  43. <div class="wy-grid-for-nav">
  44. <nav data-toggle="wy-nav-shift" class="wy-nav-side">
  45. <div class="wy-side-nav-search" style="background-color: #3d3d3d;">
  46. <!--<a href="index.html" class="icon icon-home"> FlatCAM</a>-->
  47. <!--<a href="http://flatcam.org" class="icon icon-home"> FlatCAM</a>-->
  48. <a href="http://flatcam.org">
  49. <img src="http://flatcam.org/static/images/fcweblogo1.png"
  50. style="height: auto;
  51. width: auto;
  52. border-radius: 0px;
  53. background-color: #3d3d3d;
  54. margin: auto">
  55. </a>
  56. <div role="search">
  57. <form id ="rtd-search-form" class="wy-form" action="search.html" method="get">
  58. <input type="text" name="q" placeholder="Search docs" />
  59. <input type="hidden" name="check_keywords" value="yes" />
  60. <input type="hidden" name="area" value="default" />
  61. </form>
  62. </div>
  63. </div>
  64. <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
  65. <ul class="current">
  66. <li class="toctree-l1"><a class="reference internal" href="introduction.html">Introduction</a></li>
  67. <li class="toctree-l1"><a class="reference internal" href="installation.html">Installation</a><ul>
  68. <li class="toctree-l2"><a class="reference internal" href="installation.html#windows-installer">Windows Installer</a></li>
  69. <li class="toctree-l2"><a class="reference internal" href="installation.html#ubuntu">Ubuntu</a></li>
  70. <li class="toctree-l2"><a class="reference internal" href="installation.html#manual-installation">Manual Installation</a></li>
  71. </ul>
  72. </li>
  73. <li class="toctree-l1"><a class="reference internal" href="basics.html">Basics</a><ul>
  74. <li class="toctree-l2"><a class="reference internal" href="basics.html#source-files">Source Files</a></li>
  75. <li class="toctree-l2"><a class="reference internal" href="basics.html#objects-and-tasks">Objects and Tasks</a></li>
  76. <li class="toctree-l2"><a class="reference internal" href="basics.html#creating-saving-and-loading-projects">Creating, Saving and Loading Projects</a></li>
  77. <li class="toctree-l2"><a class="reference internal" href="basics.html#navigating-plots">Navigating Plots</a></li>
  78. </ul>
  79. </li>
  80. <li class="toctree-l1"><a class="reference internal" href="procedures.html">Common Procedures</a><ul>
  81. <li class="toctree-l2"><a class="reference internal" href="procedures.html#isolation-routing">Isolation Routing</a></li>
  82. <li class="toctree-l2"><a class="reference internal" href="procedures.html#wide-isolation-routing">Wide Isolation Routing</a></li>
  83. <li class="toctree-l2"><a class="reference internal" href="procedures.html#cnc-jobs-for-drill-files">CNC Jobs for Drill Files</a></li>
  84. <li class="toctree-l2"><a class="reference internal" href="procedures.html#side-pcb">2-side PCB</a></li>
  85. <li class="toctree-l2"><a class="reference internal" href="procedures.html#copper-area-clear">Copper Area Clear</a></li>
  86. <li class="toctree-l2"><a class="reference internal" href="procedures.html#board-cutout">Board Cutout</a></li>
  87. <li class="toctree-l2"><a class="reference internal" href="procedures.html#bed-flattening">Bed Flattening</a></li>
  88. </ul>
  89. </li>
  90. <li class="toctree-l1 current"><a class="current reference internal" href="">Geometry Editor</a><ul>
  91. <li class="toctree-l2"><a class="reference internal" href="#introduction">Introduction</a></li>
  92. <li class="toctree-l2"><a class="reference internal" href="#creating-new-geometry-objects">Creating New Geometry Objects</a></li>
  93. <li class="toctree-l2"><a class="reference internal" href="#editing-existing-geometry-objects">Editing Existing Geometry Objects</a></li>
  94. </ul>
  95. </li>
  96. <li class="toctree-l1"><a class="reference internal" href="flatcamshell.html">Shell Command Line Interface</a><ul>
  97. <li class="toctree-l2"><a class="reference internal" href="flatcamshell.html#the-shell-window">The Shell Window</a></li>
  98. <li class="toctree-l2"><a class="reference internal" href="flatcamshell.html#shell-language">Shell Language</a></li>
  99. </ul>
  100. </li>
  101. <li class="toctree-l1"><a class="reference internal" href="cmdreference.html">Shell Command Reference</a><ul>
  102. <li class="toctree-l2"><a class="reference internal" href="cmdreference.html#add-circle">add_circle</a></li>
  103. <li class="toctree-l2"><a class="reference internal" href="cmdreference.html#add-poly">add_poly</a></li>
  104. <li class="toctree-l2"><a class="reference internal" href="cmdreference.html#add-rect">add_rect</a></li>
  105. <li class="toctree-l2"><a class="reference internal" href="cmdreference.html#cncjob">cncjob</a></li>
  106. <li class="toctree-l2"><a class="reference internal" href="cmdreference.html#delete">delete</a></li>
  107. <li class="toctree-l2"><a class="reference internal" href="cmdreference.html#follow">follow</a></li>
  108. <li class="toctree-l2"><a class="reference internal" href="cmdreference.html#geo-union">geo_union</a></li>
  109. <li class="toctree-l2"><a class="reference internal" href="cmdreference.html#get-names">get_names</a></li>
  110. <li class="toctree-l2"><a class="reference internal" href="cmdreference.html#help">help</a></li>
  111. <li class="toctree-l2"><a class="reference internal" href="cmdreference.html#isolate">isolate</a></li>
  112. <li class="toctree-l2"><a class="reference internal" href="cmdreference.html#make-docs">make_docs</a></li>
  113. <li class="toctree-l2"><a class="reference internal" href="cmdreference.html#new">new</a></li>
  114. <li class="toctree-l2"><a class="reference internal" href="cmdreference.html#new-geometry">new_geometry</a></li>
  115. <li class="toctree-l2"><a class="reference internal" href="cmdreference.html#offset">offset</a></li>
  116. <li class="toctree-l2"><a class="reference internal" href="cmdreference.html#open-excellon">open_excellon</a></li>
  117. <li class="toctree-l2"><a class="reference internal" href="cmdreference.html#open-gcode">open_gcode</a></li>
  118. <li class="toctree-l2"><a class="reference internal" href="cmdreference.html#open-gerber">open_gerber</a></li>
  119. <li class="toctree-l2"><a class="reference internal" href="cmdreference.html#open-project">open_project</a></li>
  120. <li class="toctree-l2"><a class="reference internal" href="cmdreference.html#options">options</a></li>
  121. <li class="toctree-l2"><a class="reference internal" href="cmdreference.html#paint-poly">paint_poly</a></li>
  122. <li class="toctree-l2"><a class="reference internal" href="cmdreference.html#plot">plot</a></li>
  123. <li class="toctree-l2"><a class="reference internal" href="cmdreference.html#save-project">save_project</a></li>
  124. <li class="toctree-l2"><a class="reference internal" href="cmdreference.html#scale">scale</a></li>
  125. <li class="toctree-l2"><a class="reference internal" href="cmdreference.html#set-active">set_active</a></li>
  126. <li class="toctree-l2"><a class="reference internal" href="cmdreference.html#write-gcode">write_gcode</a></li>
  127. </ul>
  128. </li>
  129. </ul>
  130. </div>
  131. &nbsp;
  132. </nav>
  133. <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
  134. <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
  135. <i data-toggle="wy-nav-top" class="icon icon-reorder"></i>
  136. <a href="index.html">FlatCAM</a>
  137. </nav>
  138. <div class="wy-nav-content">
  139. <div class="rst-content">
  140. <div role="navigation" aria-label="breadcrumbs navigation">
  141. <ul class="wy-breadcrumbs">
  142. <li><a href="index.html">Docs</a> &raquo;</li>
  143. <li>Geometry Editor</li>
  144. <li class="wy-breadcrumbs-aside">
  145. <a href="_sources/editor.txt" rel="nofollow"> View page source</a>
  146. </li>
  147. </ul>
  148. <hr/>
  149. </div>
  150. <div role="main">
  151. <div class="section" id="geometry-editor">
  152. <h1>Geometry Editor<a class="headerlink" href="#geometry-editor" title="Permalink to this headline">¶</a></h1>
  153. <div class="section" id="introduction">
  154. <h2>Introduction<a class="headerlink" href="#introduction" title="Permalink to this headline">¶</a></h2>
  155. <p>The Geometry Editor is a drawing CAD that allows you to edit
  156. FlatCAM Geometry Objects or create new ones from scratch. This
  157. provides the ultimate flexibility by letting you specify precisely
  158. and arbitrarily what you want your CNC router to do.</p>
  159. </div>
  160. <div class="section" id="creating-new-geometry-objects">
  161. <h2>Creating New Geometry Objects<a class="headerlink" href="#creating-new-geometry-objects" title="Permalink to this headline">¶</a></h2>
  162. <p>To create a blank Geometry Object, simply click on the menu item
  163. <strong>Edit→New Geometry Object</strong> or click the <strong>New Blank Geometry</strong> button on
  164. the toolbar. A Geometry object with the name &#8220;New Geometry&#8221; will
  165. be added to your project list.</p>
  166. <img alt="_images/editor1.png" class="align-center" src="_images/editor1.png" />
  167. <div class="admonition seealso">
  168. <p class="first admonition-title">See also</p>
  169. <p class="last">FlatCAM Shell command <a class="reference internal" href="cmdreference.html#new-geometry"><em>new_geometry</em></a></p>
  170. </div>
  171. </div>
  172. <div class="section" id="editing-existing-geometry-objects">
  173. <h2>Editing Existing Geometry Objects<a class="headerlink" href="#editing-existing-geometry-objects" title="Permalink to this headline">¶</a></h2>
  174. <p>To edit a Geometry Object, select it from the project list and
  175. click on the menu item <strong>Edit→Edit Geometry</strong> or on the <strong>Edit Geometry</strong>
  176. toolbar button.</p>
  177. <p>This will make a copy of the selected object in the editor and
  178. the editor toolbar buttons will become active.</p>
  179. <p>Changes made to the geometry in the editor will not affect the
  180. Geometry Object until the <strong>Edit-&gt;Update Geometry</strong> button or
  181. <strong>Update Geometry</strong> toolbar button is clicked.
  182. This replaces the geometry in the currently selected Geometry
  183. Object (which can be different from which the editor copied its
  184. contents originally) with the geometry in the editor.</p>
  185. <div class="section" id="selecting-shapes">
  186. <h3>Selecting Shapes<a class="headerlink" href="#selecting-shapes" title="Permalink to this headline">¶</a></h3>
  187. <p>When the <strong>Selection Tool</strong> is active in the toolbar (Hit <tt class="docutils literal"><span class="pre">Esc</span></tt>), clicking on the
  188. plot will select the nearest shape. If one shape is inside the other,
  189. you might need to move the outer one to get to the inner one. This
  190. behavior might be improved in the future.</p>
  191. <p>Holding the <tt class="docutils literal"><span class="pre">Control</span></tt> key while clicking will add the nearest shape
  192. to the set of selected objects.</p>
  193. </div>
  194. <div class="section" id="creating-shapes">
  195. <h3>Creating Shapes<a class="headerlink" href="#creating-shapes" title="Permalink to this headline">¶</a></h3>
  196. <p>The shape creation tools in the editor are:</p>
  197. <ul class="simple">
  198. <li>Circle</li>
  199. <li>Rectangle</li>
  200. <li>Polygon</li>
  201. <li>Path</li>
  202. </ul>
  203. <img alt="_images/editor2.png" class="align-center" src="_images/editor2.png" />
  204. <p>After clicking on the respective toolbar button, follow the instructions
  205. on the status bar.</p>
  206. <p>Shapes that do not require a fixed number of clicks to complete, like
  207. polygons and paths, are complete by hitting the <tt class="docutils literal"><span class="pre">Space</span></tt> key.</p>
  208. <div class="admonition seealso">
  209. <p class="first admonition-title">See also</p>
  210. <p class="last">The FlatCAM Shell commands <a class="reference internal" href="cmdreference.html#add-circle"><em>add_circle</em></a>, <a class="reference internal" href="cmdreference.html#add-poly"><em>add_poly</em></a> and <a class="reference internal" href="cmdreference.html#add-rect"><em>add_rect</em></a>,
  211. create shapes directly on a given Geometry Object.</p>
  212. </div>
  213. </div>
  214. <div class="section" id="union">
  215. <h3>Union<a class="headerlink" href="#union" title="Permalink to this headline">¶</a></h3>
  216. <p>Clicking on the <strong>Union</strong> tool after selecting two or more shapes
  217. will create a union. For closed shapes, their union is a polygon covering
  218. the area that all the selected shapes encompassed. Unions of disjoint shapes
  219. can still be created and is equivalent to grouping shapes.</p>
  220. <img alt="_images/editor_union.png" class="align-center" src="_images/editor_union.png" />
  221. <div class="admonition seealso">
  222. <p class="first admonition-title">See also</p>
  223. <p class="last">The FlatCAM Shell command <a class="reference internal" href="cmdreference.html#geo-union"><em>geo_union</em></a> executes a union of
  224. all geometry in a Geometry object.</p>
  225. </div>
  226. </div>
  227. <div class="section" id="moving-and-copying">
  228. <h3>Moving and Copying<a class="headerlink" href="#moving-and-copying" title="Permalink to this headline">¶</a></h3>
  229. <p>The <strong>Move</strong> and <strong>Copy</strong> tools work on selected objects. As soon as the tool
  230. is selected (On the toolbar or the <tt class="docutils literal"><span class="pre">m</span></tt> and <tt class="docutils literal"><span class="pre">c</span></tt> keys) the reference point
  231. is set at the mouse pointer location. Clicking on the plot sets the target
  232. location and finalizes the operation. An outline of the shapes is shown
  233. while moving the mouse.</p>
  234. <div class="admonition seealso">
  235. <p class="first admonition-title">See also</p>
  236. <p class="last">The FlatCAM Shell command <a class="reference internal" href="cmdreference.html#offset"><em>offset</em></a> will move (offset) all
  237. the geometry in a Geometry Object. This can also be done in
  238. the <strong>Selected</strong> panel for selected FlatCAM object.</p>
  239. </div>
  240. </div>
  241. <div class="section" id="cancelling-an-operation">
  242. <h3>Cancelling an operation<a class="headerlink" href="#cancelling-an-operation" title="Permalink to this headline">¶</a></h3>
  243. <p>Hitting the <tt class="docutils literal"><span class="pre">Esc</span></tt> key cancels whatever tool/operation is active and
  244. selects the <strong>Selection Tool</strong>.</p>
  245. </div>
  246. <div class="section" id="deleting-selected-shapes">
  247. <h3>Deleting selected shapes<a class="headerlink" href="#deleting-selected-shapes" title="Permalink to this headline">¶</a></h3>
  248. <p>Selections are deleted by hitting the <tt class="docutils literal"><span class="pre">-</span></tt> sign key.</p>
  249. </div>
  250. <div class="section" id="other">
  251. <h3>Other<a class="headerlink" href="#other" title="Permalink to this headline">¶</a></h3>
  252. <div class="admonition seealso">
  253. <p class="first admonition-title">See also</p>
  254. <p class="last">The FlatCAM Shell command <a class="reference internal" href="cmdreference.html#scale"><em>scale</em></a> changes the size of the
  255. geometry in a Geometry Object.</p>
  256. </div>
  257. </div>
  258. </div>
  259. </div>
  260. </div>
  261. <footer>
  262. <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
  263. <a href="flatcamshell.html" class="btn btn-neutral float-right" title="Shell Command Line Interface"/>Next <span class="icon icon-circle-arrow-right"></span></a>
  264. <a href="procedures.html" class="btn btn-neutral" title="Common Procedures"><span class="icon icon-circle-arrow-left"></span> Previous</a>
  265. </div>
  266. <hr/>
  267. <div role="contentinfo">
  268. <p>
  269. &copy; Copyright 2014, Juan Pablo Caram.
  270. </p>
  271. </div>
  272. <a href="https://github.com/snide/sphinx_rtd_theme">Sphinx theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>
  273. </footer>
  274. </div>
  275. </div>
  276. </section>
  277. </div>
  278. </body>
  279. </html>