Draft Rotate

Description
The Rotate tool rotates or copies the selected objects by a given angle around a reference point.

The Rotate 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.

To move without rotation, use Draft Move. To produce various copies in different arrangements use Draft Array, Draft PathArray and Draft PointArray.



Usage

 * 1) Select the objects that you wish to move or copy.
 * 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, through which the axis of rotation will pass.
 * 4) Click a second point on the 3D view, or type a base angle. This defines a baseline that will rotate around the first point.
 * 5) Click a third point on the 3D view, or type a rotation angle. This indicates the rotation of the baseline, and thus the objects.

Options
The single character keyboard shortcuts available in the task panel can be changed. See Draft Preferences. The shortcuts mentioned here are the default shortcuts.


 * To manually enter the coordinates for the center of rotation enter the X, Y and Z component, and press after each. Or you can press the  button when you have the desired values. It is advisable to move the pointer out of the 3D view before entering coordinates.
 * The checkbox has no purpose for this command.
 * Press or click the  checkbox to toggle global mode. If global mode is on, coordinates are relative to the global coordinate system, else they are relative to the working plane coordinate system.
 * Press or click the  checkbox to toggle continue mode. If continue mode is on, the command will restart after finishing. This mode really only makes sense if copy mode is switched on. Depending on the  preference, either the original objects are selected for the next command call or the copies that were created last. See Preferences.
 * Press or click the  checkbox to toggle copy mode. If copy mode is on, the command will copy the selected objects instead of rotating them.
 * Press or click the  checkbox to toggle subelements mode. If subelements mode is on, the command will rotate the selected subelements instead of the whole objects. The subelements must belong to objects with a  property.
 * Holding down after entering the  will also toggle copy mode. While  is held down multiple points can be picked for the . Release  to finish the command and to see the created copies.
 * Press or the  button to abort the command.

Preferences
See also: Preferences Editor and Draft Preferences.


 * To switch on copy mode by default check:.
 * To reselect the base objects after copying objects check:.

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

To rotate objects use the method of the Draft module.


 * contains the objects to be rotated. It is either a single object or a list of objects.
 * is the angle of rotation in degrees.
 * is the center point of rotation.
 * is the direction of the axis of rotation.
 * If is  copies are created instead of rotating the original objects.
 * is returned with the original rotated objects, or with the new copies. It is either a single object or a list of objects, depending on.

Example: