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
See also: Draft Snap and Draft Constrain.


 * 1) Optionally select one or more objects, or one or more subelements of Draft Lines or Draft Wires.
 * 2) There are several ways to invoke the command:
 * 3) * Press the button.
 * 4) * Select the option from the menu.
 * 5) * Use the keyboard shortcut: then.
 * 6) If you have not yet selected an object: select an object in the 3D view.
 * 7) The  task panel opens. See Options for more information.
 * 8) Pick the first point, the center of rotation, in the 3D view, or type coordinates and press the  button.
 * 9) Pick the second point in the 3D view, or enter a.
 * 10) Pick the third point in the 3D view, or enter a.

Options
The single character keyboard shortcuts and the modifier key mentioned here can be changed. See Draft Preferences.


 * 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 create rotated copies instead of rotating the original objects.
 * Press or click the  checkbox to toggle subelement mode. If subelement mode is on, the command will rotate the selected subelements instead of the whole objects. The subelements must belong to Draft objects with a  property, such as Draft Wires.
 * If copy mode and subelement mode are both on, and edges of Draft Wires are selected, new wires will be created from those edges.
 * 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 see the created copies.
 * Press or the  button to abort the command.

Preferences
See also: Preferences Editor and Draft Preferences.


 * To change the number of decimals used for the input of coordinates and angles:.
 * To store and reuse the same copy mode setting across commands:.
 * To reselect the base objects after copying objects:.

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: