********************* Basic Transformations ********************* .. _bpy.ops.transform.translate: Move ==== .. admonition:: Reference :class: refbox :Mode: Object Mode, Edit Mode, and Pose Mode :Menu: :menuselection:`Object/Mesh/Curve/Surface --> Transform --> Move` :Hotkey: :kbd:`G` In Object Mode, the move option lets you move objects. Translation means changing location of objects. It also lets you move any elements that make up the object within the 3D space of the active 3D View. Pressing :kbd:`G` activates "Move" transformation mode. The selected object or element then moves freely according to the mouse pointer's location and camera. To confirm the action, press :kbd:`LMB`. While Move is active, the amount of change in the X, Y, and Z coordinates is displayed in the footer (at the upper left corner) of the 3D Viewport. .. figure:: /images/scene-layout_object_editing_transform_basics_grab-display-values.png Translation Display. .. tip:: Moving an object in Object Mode changes the object's origin. Moving the object's vertices/edges/faces in Edit Mode does not change the object's origin. .. _bpy.ops.transform.rotate: Rotate ====== .. admonition:: Reference :class: refbox :Mode: Object and Edit Modes :Menu: :menuselection:`Object/Mesh/Curve/Surface --> Transform --> Rotate` :Hotkey: :kbd:`R` Rotation is also known as a spin, twist, orbit, pivot, revolve, or roll and involves changing the orientation of elements (vertices, edges, faces, objects, etc.) around one or more axes or the :doc:`Pivot Point `. The angle of rotation is displayed in the footer (at the upper left corner) of the 3D Viewport. .. figure:: /images/scene-layout_object_editing_transform_basics_rotate-display-values.png Rotation values. .. _view3d-transform-trackball: .. _bpy.ops.transform.trackball: Trackball Rotation ------------------ A free rotation mode. Press :kbd:`R R` to enable Trackball rotation. .. _bpy.ops.transform.resize: Scale ===== .. admonition:: Reference :class: refbox :Mode: Object and Edit Modes :Menu: :menuselection:`Object/Mesh/Curve/Surface --> Transform --> Scale` :Hotkey: :kbd:`S` Scaling means changing proportions of objects. Pressing :kbd:`S` will enter the *Scale* transformation mode where the selected element is scaled inward or outward according to the mouse pointer's location. The element's scale will increase as the mouse pointer is moved away from the Pivot Point and decrease as the pointer is moved towards it. If the mouse pointer crosses from the original side of the :doc:`Pivot Point ` to the opposite side, the scale will continue in the negative direction and flip the element. .. figure:: /images/scene-layout_object_editing_transform_basics_scale-basic-usage.png Basic scale usage. From left to right, the panels show: the original Object, a scaled down Object, a scaled up Object and a scale-flipped Object. The amount of scaling will be displayed in the footer of the 3D Viewport. .. figure:: /images/scene-layout_object_editing_transform_basics_scale-display-values.png Scale values. .. _tool-scale-cage: Scale Cage ---------- .. admonition:: Reference :class: refbox :Mode: Object and Edit Modes :Menu: :menuselection:`Toolbar --> Scale --> Scale Cage` The *Scale Cage* tool is a bounding box around the object(s) which scales objects from a particular point or axis. The tool works by selecting a scale point and dragging inwards or outwards to adjust the scale accordingly. The origin for the scale will be from the point on the cube directly opposite from the point selected. Selecting points on the faces of the cube scales along one axis, selecting points on the edges of the cube scales along two axes, and selecting points on the vertices of the cube scales along all three axes. .. figure:: /images/scene-layout_object_editing_transform_basics_scale_cage.png :align: center Scale Cage tool. Common Options ============== There are multiple ways to transform an element which include: - The keyboard shortcut. - The menu in the header. - The :doc:`3D Transform Gizmos `. - The :doc:`Transform panel ` in the Sidebar region or the Object tab. Confirm and Cancel ------------------ :kbd:`LMB` click to accept changes. To cancel the transformation press :kbd:`RMB` or :kbd:`Esc` instead. This will reset the object or element to its original state. .. seealso:: Using combination of shortcuts gives you more control over your transformation. See :doc:`Transform Control `. Adjust Last Operation --------------------- In the case of the 3D View, there is the possibility to tweak the operation once accepted, using the specific :ref:`ui-undo-redo-adjust-last-operation` panel corresponding to the tool. Value The amount of the transformation. Vector, Angle Constrain Axis Used to constraint the transformation to one or more axes. X, Y, Z Orientation Shows the :doc:`Orientations ` of the constraint axes. Proportional Editing, Falloff, Size Activates/deactivates *Proportional Editing* and configures the *Falloff* type and *Size* of the :doc:`/scene_layout/object/editing/transform/control/proportional_edit` tool. .. _modeling_transform_edit-texture-space: Edit Texture Space :kbd:`Shift-T`:kbd:`Shift-Alt-T` This checkbox lets you apply the transformation on the :ref:`Texture Space `, instead of the object or element itself. Only available in translation and scale. This option is also available via the shortcuts, :kbd:`Shift-T` (move) and :kbd:`Shift-Alt-T` (scale). Confirm on Release Shows if either the operation was drag-and-release or move-and-confirm. Workflow -------- Using Keyboard Shortcuts ^^^^^^^^^^^^^^^^^^^^^^^^ #. Use :kbd:`LMB` to select the elements you want to transform. #. Tap :kbd:`G`, or :kbd:`R`, or :kbd:`S` once to enter the transformation mode. #. Transform the elements by moving the mouse. #. :kbd:`LMB` click to accept changes.