Draft Scale/tr

Description
The Scale tool scales or copies selected objects around a base point.

The Scale tool can produce a copy or a Draft Clone at a defined scale. Use Draft Offset to produce a scaled copy of a wire set at a certain offset. A simple copy with no scaling can be produced with Draft Move.

This 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 Workbench or PartDesign Workbench.



How to use

 * 1) Select the objects that you wish to scale.
 * 2) Press the  button, or press  then  keys. If no object is selected, you will be invited to select one.
 * 3) Click a first point on the 3D view, or type a coordinate and press the  button. This serves as the base point of the operation.
 * 4) Set the X, Y, and Z factors, and the appropriate result options, then press  or the  button to finish the operation.

Options

 * To enter coordinates manually, simply enter the numbers, then press between each X, Y and Z component. You can press the  button when you have the desired values to insert the point.
 * Fill in the X, Y and Z factors to define the scaling along that direction.
 * Click the "Uniform scaling" checkbox to lock the X, Y and Z factors to the same value.
 * Click the "Working plane orientation" checkbox to lock the X, Y and Z scaling along the current Working Plane; otherwise, global X, Y and Z directions are used.
 * Three options control the result of the scaling operation:
 * Create a clone. A Draft Clone of the original object will be created. This will work for all object types.
 * even if the scaling factors are left at their default values (1.0, 1.0, 1.0), once the clone is created you will be able to change these factors manually in the property editor.
 * Modify original. The original object will have its size modified. This will only work with Draft objects and non-parametric Part shapes.
 * Create a copy. A scaled copy of the original object will be created. This will work for all object types, but only the copies of Draft objects will be parametric.
 * a copy is a completely different object from the original shape; it will be created at the specified scale, and then will have its own set of properties. On the other hand, a Draft Clone is linked to the original shape and the only property that can be changed is the scale.

Scripting
Draft API and FreeCAD Scripting Basics.

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


 * Scales the objects in by the factors specified by the components of, defined as a , and using  as base point.
 * is either a single object or a list of objects.
 * If is  copies are created instead of modifying the original objects.
 * If is, direct copy mode is used (outdated), otherwise a parametric copy is made.
 * is returned with the original scaled objects, or with the new clones.
 * is either a single object or a list of objects, depending on the input.

Example: