Draft Clone

Description
The tool produces linked copies of a selected shape. This means that if the original object changes its shape and properties, all clones change as well. Nevertheless, each clone retains its unique position, rotation, and scale, as well as its view properties like shape color, line width, and transparency.

The Clone 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 create simple copies, that are completely independent from an original object, use Draft Move, Draft Rotate, and Draft Scale. To position copies in an orthogonal array use Draft Array; to position copies along a path use Draft PathArray; to position copies at specified points use Draft PointArray.



Usage

 * 1) Select an object that you wish to clone.
 * 2) Press the  button.

Depending on its options, the tool also creates a clone at a specified scale.

Clones of 2D objects created with the Draft or Sketcher Workbenches will also be 2D objects, and therefore can be used as such for the PartDesign Workbench.

All Arch Workbench objects have the possibility to behave as clones by using their property. If you use the Draft Clone tool on a selected Arch object, you will produce such an Arch clone instead of a regular Draft clone.

Limitations
Currently, Sketcher Sketches cannot be mapped to the faces of a clone.

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

Properties

 * : specifies a list of base objects which are being cloned.
 * : specifies the scaling factor for the clone, in each X, Y, and Z direction.
 * : if it is and  includes many shapes that intersect each other, the resulting clone will be fuse them together into a single shape, or make a compound of them.

Scripting
See also: Autogenerated API documentation and FreeCAD Scripting Basics.

To create a Draft Clone use the method  of the Draft module. It can also create Arch Clones from Arch objects. This method replaces the deprecated method.


 * contains the objects to be cloned. It is either a single object or a list of objects.
 * is the displacement vector to be applied to the clone.
 * If is  and  contains a single Arch object an Arch Clone is created. Set  to  to create a Draft Clone instead.
 * is returned with the clone object.

Example: