Draft Clone: Difference between revisions

From FreeCAD Documentation
(There are no options for this tool. Either it works with the selected objects or not. Information moved to how to use)
(Information from the options)
Line 21: Line 21:
==How to use== <!--T:4-->
==How to use== <!--T:4-->
# Select an object that you wish to clone.
# Select an object that you wish to clone.
# Press the {{Button|[[Image:Draft Clone.png|16px]] [[Draft Clone]]}} button.
# Press the {{Button|[[Image:Draft Clone.svg|16px]] [[Draft Clone]]}} button.

Clones of 2D objects created with the [[Draft Workbench|Draft]] or [[Sketcher Workbench]]es 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 {{PropertyData|CloneOf}} property. If you use the Draft Clone tool on a selected Arch object, you will produce such an Arch cloned object instead of a regular Draft clone.


==Options== <!--T:9-->
==Options== <!--T:9-->

Revision as of 01:04, 16 November 2018

Draft Clone

Menu location
Draft → Clone
Workbenches
Draft, Arch
Default shortcut
None
Introduced in version
-
See also
Draft Move, Draft Scale

Description

The Draft Clone 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.

How to use

  1. Select an object that you wish to clone.
  2. Press the Draft Clone button.

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 DataCloneOf property. If you use the Draft Clone tool on a selected Arch object, you will produce such an Arch cloned object instead of a regular Draft clone.

Options

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

Properties

  • DataScale: Specifies an optional scale factor for the clone
  • DataFuse: If this clone is using several objects, this specifies if the result is a fusion or a compound introduced in version 0.17
  • The result of the Draft Scale tool is also a clone
  • No sketches can be mapped to faces of a clone. That is at the moment a known limitation.

Scripting

The Clone tool can by used in macros and from the python console by using the following function:

clone (obj,[delta])
  • Makes a clone of the given object(s).
  • The clone is an exact, linked copy of the given object.
  • If the original object changes, the final object changes too. Optionally, you can give a delta Vector to move the clone away from the original position.

Example:

import Draft
Draft.clone(FreeCAD.ActiveDocument.ActiveObject)