<html><head><title>Draft Array/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 Array/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_Array.png" class="image"><img alt="Draft Array.png" src="32px-Draft_Array.png" width="32" height="32" srcset="/wiki/images/thumb/c/c8/Draft_Array.png/48px-Draft_Array.png 1.5x, /wiki/images/c/c8/Draft_Array.png 2x" /></a> {{{Name/en}}}</span></h3>
</td></tr>
<tr>
<th class="ctOdd">Menu location
</th></tr>
<tr>
<td class="ctEven">Draft → Array
</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_PathArray.html" title="Draft PathArray">PathArray</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="#Scripting"><span class="tocnumber">4</span> <span class="toctext">Scripting</span></a>
<ul>
<li class="toclevel-2 tocsection-4"><a href="#Simple_array"><span class="tocnumber">4.1</span> <span class="toctext">Simple array</span></a></li>
<li class="toclevel-2 tocsection-5"><a href="#Parametric_array"><span class="tocnumber">4.2</span> <span class="toctext">Parametric array</span></a></li>
</ul>
</li>
</ul>
</div>
</td></tr></table>
<p><br />
</p>
<h2><span class="mw-headline" id="Description">Description</span></h2>
<p>The Array tool creates an orthogonal (3-axes) or polar array from a selected object. If no object is selected, you will be invited to select one.
</p><p><a href="https://www.freecadweb.org/wiki/index.php?title=File:Draft_Array_example.jpg" class="image"><img alt="Draft Array example.jpg" src="400px-Draft_Array_example.jpg" width="400" height="179" srcset="/wiki/images/thumb/3/3e/Draft_Array_example.jpg/600px-Draft_Array_example.jpg 1.5x, /wiki/images/thumb/3/3e/Draft_Array_example.jpg/800px-Draft_Array_example.jpg 2x" /></a>
</p>
<h2><span class="mw-headline" id="How_to_use">How to use</span></h2>
<ol><li> Select an object you wish to make an array with</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:Draft_Array.png" class="image"><img alt="Draft Array.png" src="16px-Draft_Array.png" width="16" height="16" srcset="/wiki/images/thumb/c/c8/Draft_Array.png/24px-Draft_Array.png 1.5x, 32px-Draft_Array.png 2x" /></a> <a href="Draft_Array.html" title="Draft Array">Draft Array</a></span> button</li>
<li> Select <span style="font-size: 0.6em;padding-right:10px;">DATA</span><b>Array Type</b>: Specifies the type of the array, ortho or polar</li>
<li> For orthogonal arrays:
<ol><li> <span style="font-size: 0.6em;padding-right:10px;">DATA</span><b>Interval X</b>: The interval between each copy on the first axis</li>
<li> <span style="font-size: 0.6em;padding-right:10px;">DATA</span><b>Interval Y</b>: The interval between each copy on the second axis</li>
<li> <span style="font-size: 0.6em;padding-right:10px;">DATA</span><b>Interval Z</b>: The interval between each copy on the third axis</li>
<li> <span style="font-size: 0.6em;padding-right:10px;">DATA</span><b>Number X</b>: The number of copies on the first axis</li>
<li> <span style="font-size: 0.6em;padding-right:10px;">DATA</span><b>Number Y</b>: The number of copies on the second axis</li>
<li> <span style="font-size: 0.6em;padding-right:10px;">DATA</span><b>Number Z</b>: The number of copies on the third axis</li></ol></li>
<li> For polar arrays:
<ol><li> <span style="font-size: 0.6em;padding-right:10px;">DATA</span><b>Axis</b>: The normal direction of the array circle</li>
<li> <span style="font-size: 0.6em;padding-right:10px;">DATA</span><b>Center</b>: The center point of the array</li>
<li> <span style="font-size: 0.6em;padding-right:10px;">DATA</span><b>Angle</b>: The angle to cover with copies</li>
<li> <span style="font-size: 0.6em;padding-right:10px;">DATA</span><b>Number Polar</b>: The number of copies</li></ol></li></ol>
<h2><span class="mw-headline" id="Scripting">Scripting</span></h2>
<p>The Array tool can by used in <a href="Macros.html" title="Macros">macros</a> and from the python console by using one of the following functions, depending if you wish to obtain simple, standalone copies of your base object, or a parametric array object, that stays linked to the original object.
</p>
<h3><span class="mw-headline" id="Simple_array">Simple array</span></h3>
<p>For rectangular array:
</p>
<pre>array (objectslist,xvector,yvector,xnum,ynum,[zvector,znum]) </pre>
<p>For polar array:
</p>
<pre>array (objectslist,center,totalangle,totalnum) </pre>
<ul><li> Creates an array of the objects contained in list (that can be an object or a list of objects) with, in case of rectangular array, xnum of iterations in the x direction at xvector distance between iterations, and same for y direction with yvector and ynum. In case of polar array, center is a vector, totalangle is the angle to cover (in degrees) and totalnum is the number of objects, including the original. </li>
<li> This function produces standalone copies of the base object(s)</li></ul>
<h3><span class="mw-headline" id="Parametric_array">Parametric array</span></h3>
<p>For rectangular array:
</p>
<pre>makeArray (object,xvector,yvector,xnum,ynum) </pre>
<p>For polar array:
</p>
<pre>makeArray (object,center,totalangle,totalnum) </pre>
<ul><li> Creates an array of the given object with, in case of rectangular array, xnum of iterations in the x direction at xvector distance between iterations, and same for y direction with yvector and ynum. In case of polar array, center is a vector, totalangle is the angle to cover (in degrees) and totalnum is the number of objects, including the original. </li>
<li> The result of this function is a parametric Draft Array object.</li></ul>
<p>Example:
</p>
<pre>import FreeCAD,Draft
Draft.array(FreeCAD.ActiveDocument.ActiveObject,FreeCAD.Vector(2,0,0),FreeCAD.Vector(0,2,0),2,2) </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_Array/en&oldid=221374">http://www.freecadweb.org/wiki/index.php?title=Draft_Array/en&oldid=221374</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>