# ROTATE3D Command
[GstarCAD 2011](../../Index.md) → [Commands](../%28Commands%29.md) → [R](%28R%29.md)
## Function Description:
> Move objects about a three-dimensional axis
**Menu:**
> Modify\>3D Operations\>3D Rotate
**Command
Entry:**
> ROTATE3D
Command Prompt:
> Select objects to rotate:
>
> Select axis by: \[Entity/Last/View/Xaxis/Yaxis/Zaxis\]\<2
> Points\>:
>
> **2 Points**
>
> Use two
> points to define the axis of rotation. Pressing ENTER at the main ROTATE3D
> prompt displays the following prompts. Specifying a point at the main prompt
> skips the prompt for the first point.
>
> Specify the first rotation axis point:
>
> Specify the second rotation axis
> point:
>
> \[Reference/Rotation Angle\]\<Rotation
> Angle\>:
>
> Rotation Angle: Rotate the
> object about the selected axis the specified amount from the current
> orientation.
>
> Reference: Specify the reference angle and the new angle.
>
> Specify the reference angle \<Current\>: Specify the
> starting angle
>
> Specify the new angle: Specify the ending angle
>
> The difference between the starting angle and the ending
> angle is the computed rotation angle.
>
> **Entity**
>
> Align the axis of rotation with an
> existing object.
>
> Select an arc, circle, ellipse, line, 2D or 3D-polyline
> segment:
>
> > **Arc**
> >
> > Align the axis of rotation with the 3D axis of the arc
> > (perpendicular to the plane of the arc and passing through the center of
> > the arc).
> >
> > \[Reference/Rotation Angle\]\<Rotation Angle\>:
> >
> > Rotation Angle
> >
> > Rotates the object about the selected axis the
> > specified amount from the current orientation
> >
> > Reference
> >
> > Specifies the reference angle and the new angle.
> >
> > Specify the reference angle \<Current\>: Specify the
> > starting angle
> >
> > Specify the new angle: Specify the ending angle
> >
> > **Circle or Ellipse**
> >
> > Align the axis of rotation with the 3D axis of the
> > circle or ellipse (perpendicular to the plane of the circle and passing
> > through the center of the circle or ellipse).
> >
> > \[Reference/Rotation Angle\]\<Rotation Angle\>:
> >
> > Rotation Angle: Rotate the object about the selected
> > axis the specified amount from the current orientation
> >
> > Reference: Specify the reference angle and the new angle.
> >
> > Specify the reference angle \<Current\>: Specify the
> > starting angle
> >
> > Specify the new angle: Specify the ending angle
> >
> > **Line**
> >
> > Align the axis of rotation with the line selected.
> >
> > \[Reference/Rotation Angle\]\<Rotation Angle\>:
> >
> > Rotation Angle: Rotate the object about the selected
> > axis the specified amount from the current orientation
> >
> > Reference: Specify the reference angle and the new
> > angle.
> >
> > Specify the reference angle \<Current\>: Specify the
> > starting angle
> >
> > Specify the new angle: Specify the ending angle
> >
> > Specify the new angle: Specify the ending angle
> >
> > **2D or 3D-polyline segment**
> >
> > Align the axis of rotation with a segment of the
> > polyline. Treats a straight segment as a line segment. Treats an arc
> > segment as an arc.
> >
> > \[Reference/Rotation Angle\]\<Rotation Angle\>:
> >
> > Rotation Angle: Rotate the object about the selected
> > axis the specified amount from the current orientation
> >
> > Reference: Specify the reference angle and the new
> > angle.
> >
> > Specify the reference angle \<Current\>: Specify the
> > starting angle
> >
> > Specify the new angle: Specify the ending angle
>
> **Last**
>
> Use the last axis of rotation.
>
> \[Reference/Rotation Angle\]\<Rotation Angle\>:
>
> Rotation Angle: Rotate the object about the selected axis
> the specified amount from the current orientation.
>
> Reference: Specify the reference angle and the new angle.
>
> Specify the reference angle \<Current\>: Specify the starting
> angle
>
> Specify the new angle: Specify the ending angle
>
> View
>
> Align the axis of rotation with the
> viewing direction of the current viewport that passes through the selected
> point.
>
> Specify point on view direction axis \<0,0,0\>:
>
> \[Reference/Rotation Angle\]\<Rotation Angle\>:
>
> Rotation Angle: Rotate the object about the selected axis
> the specified amount from the current orientation.
>
> Reference: Specify the reference angle and the new angle.
>
> Specify the reference angle \<Current\>: Specify the starting
> angle
>
> Specify the new angle: Specify the ending angle
>
> **X Axis**
>
> Align the axis of rotation with one of
> the X axis that pass through the selected point
>
> Specify point on the X axis \<0,0,0\>:
>
> \[Reference/Rotation Angle\]\<Rotation Angle\>:
>
> Rotation Angle: Rotate the object about the selected axis
> the specified amount from the current orientation.
>
> Reference: Specify the reference angle and the new angle.
>
> Specify the reference angle \<Current\>: Specify the starting
> angle
>
> Specify the new angle: Specify the ending angle
>
> Y Axis
>
> Align the axis of rotation with one of
> the Y axis that pass through the selected point
>
> Specify point on the Y axis \<0,0,0\>:
>
> \[Reference/Rotation Angle\]\<Rotation Angle\>:
>
> Rotation Angle: Rotate the object about the selected axis
> the specified amount from the current orientation.
>
> Reference: Specify the reference angle and the new angle.
>
> Specify the reference angle \<Current\>: Specify the starting
> angle
>
> Specify the new angle: Specify the ending angle
>
> Z Axis
>
> Align the axis of rotation with one of
> the Z axis that pass through the selected point
>
> Specify point on the Z axis \<0,0,0\>:
>
> \[Reference/Rotation Angle\]\<Rotation Angle\>:
>
> Rotation Angle: Rotate the object about the selected axis
> the specified amount from the current orientation.
>
> Reference: Specify the reference angle and the new angle.
>
> Specify the reference angle \<Current\>: Specify the starting
> angle
>
> Specify the new angle: Specify the ending angle
## Other versions with matching text
[GstarCAD 2012](../../../2012/Commands/R/ROTATE3D%20Command.md)