|Draft → Move|
|Introduced in version|
|Draft Array, Draft PathArray|
The Move tool moves or copies the selected objects from one point to another.
The Move tool can be used on 2D shapes created with the Draft Workbench or Sketcher Workbench, but can also be used on many types of 3D objects such as those created with the Part Workbench or Arch Workbench.
Moving an object from one point to another point
How to use
- Select the objects that you wish to move or copy.
- Press the button, or press then keys. If no object is selected, you will be invited to select one.
- 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.
- Click another point on the 3D view, or type a coordinate and press the button. This is the new position of the base point.
When moving an object that is based on a Sketcher Sketch, for example, a feature created with the PartDesign Workbench (Pad, Revolution, etc.) you must move the original sketch. If you move the derived object, it will just go back to the position defined by the sketch.
- Press , or after a point to constrain the next point on the given axis.
- 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.
- Press or click the checkbox to toggle relative mode. If relative mode is on, the coordinates of the next point are relative to the last one; if not, they are absolute, taken from the origin (0,0,0).
- Press or click the checkbox to toggle continue mode. If continue mode is on, the Move tool will restart after you finish the operation, allowing you to move or copy the objects again without pressing the tool button again.
- Press or click the checkbox to toggle copy mode. If copy mode is on, the Move tool will keep the original shape in its place but will make a copy at the second point.
- You can use both and to place several copies in sequence. In this case, the duplicated element is the last placed copy.
- Hold after the first point to also toggle copy mode. Keeping pressed after clicking on the second point will allow you to continue placing copies; release to finish the operation and see all copies.
- Hold snapping your point to the nearest snap location, independently of the distance. while moving to force
- Hold constrain your next point horizontally or vertically in relation to the last one. while moving to
- Press or the button to abort the current command; copies already placed will remain.
movedlist = move(objectslist, vector, copy=False)
- Moves the base point of the objects in
objectslistby the displacement and direction indicated by
objectslistis either a single object or a list of objects.
- The displacement vector is relative to the base point of the object, which means that if an object is moved 2 units, and then another 2 units, it will have moved 4 units in total from its original position.
Truecopies are created instead of moving the original objects.
movedlistis returned with the original moved objects, or with the new copies.
movedlistis either a single object or a list of objects, depending on the input
import FreeCAD, Draft Polygon1 = Draft.makePolygon(5, radius=1000) Polygon2 = Draft.makePolygon(3, radius=500) Polygon3 = Draft.makePolygon(6, radius=220) Draft.move(Polygon1, FreeCAD.Vector(500, 500, 0)) Draft.move(Polygon1, FreeCAD.Vector(500, 500, 0)) Draft.move(Polygon2, FreeCAD.Vector(1000, -1000, 0)) Draft.move(Polygon3, FreeCAD.Vector(-500, -500, 0)) List1 = [Polygon1, Polygon2, Polygon3] vector = FreeCAD.Vector(-2000, -2000, 0) List2 = Draft.move(List1, vector, copy=True) List3 = Draft.move(List1, -2*vector, copy=True)