Draft PointArray

Description
The tool places copies of a selected shape along various selected points.

The PointArray tool can be used on 2D shapes created with the Draft Workbench, but can also be used on many types of 3D objects such as those created with the Part, PartDesign, or Arch Workbenches.

To position copies in an orthogonal array use Draft Array; to position copies along a path use Draft PathArray; to create copies or clones, and manually place them use Draft Move, Draft Rotate, and Draft Clone.



Usage

 * 1) Select an object that you wish to distribute.
 * 2) Select a point compound.
 * 3) Press the  button.

To create a point compound select various Draft Points and then press the button.

Each element in the array is an exact clone of the original object, but the entire array is considered a single unit in terms of properties and appearance.

Options
There are no options for this tool. Either it works with the selected objects or not.

Properties
The compound object needs to have a, , or attribute. Each of the objects inside the compound should be Draft Points that have, , and attributes. The compounds could be created with Part Compound ( attribute) or with Draft Upgrade ( attribute).
 * : the object to duplicate.
 * : (read-only) specifies the number of copies of the base object. This number will depend on the number of Draft Points in the compound.
 * : specifies a compound object with point objects that indicate where the copies of the object will appear.

Scripting
Draft API and FreeCAD Scripting Basics.

The PointArray tool can be used in macros and from the Python console by using the following function:


 * Creates a object from the  object, by placing the copies along.
 * is an object with, , or attributes that define the position of the copies.

Example: