Draft Scale
Draft Scale |
Menu location |
---|
Draft → Scale |
Workbenches |
Draft, Arch |
Default shortcut |
S C |
Introduced in version |
- |
See also |
Draft Clone, Draft Offset |
Description
The Scale tool scales selected objects around a base point. If no object is selected, you will be invited to select one.
How to use
- Select objects you wish to scale.
- Press the Draft Scale button, or press S then C keys.
- Click a first point on the 3D view, or type a coordinate and press the add point button. This serves as the base point of the operation.
- Change the X factor, Y factor, or Z factor and press Enter or the OK button to finish the scaling.
Options
- To enter coordinates manually, simply enter the numbers, then press Enter between each X, Y and Z component. You can press the add point 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.
- Note: even if the scaling factors are left at their default values (1.0, 1.0, 1.0), a clone allows you 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.
- Note: 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
See also: Draft API and FreeCAD Scripting Basics.
The Scale tool can be used in macros and from the Python console by using the following function:
scaledlist = scale(objectslist, delta=Vector(1,1,1), center=Vector(0,0,0), copy=False, legacy=False)
- Scales the objects in
objectslist
by the factors specified by the components ofdelta
, defined as aFreeCAD.Vector
, and usingcenter
as base point.objectslist
is either a single object or a list of objects.
- If
copy
isTrue
copies are created instead of modifying the original objects. - If
legacy
isTrue
, direct copy mode is used (outdated), otherwise a parametric copy is made. scaledlist
is returned with the original scaled objects, or with the new copies.scaledlist
is either a single object or a list of objects, depending on the inputobjectslist
.
Example:
import FreeCAD,Draft
Draft.scale(FreeCAD.ActiveDocument.ActiveObject,FreeCAD.Vector(2,2,2))