manual/editors/3dview/controls/snapping.rst

@@ -218,18 +218,3 @@ Affect
 Specifies which transformations are affected by snapping.
 By default, snapping only happens while moving something,
 but you can also enable it for rotating and scaling.
-
-
-Multiple Snap Targets
----------------------
-
-While you're transforming a selection with snapping enabled,
-you can press :kbd:`A` whenever there's a highlighted snap target to
-mark it. With multiple such targets marked, the selection will
-then be snapped to their average location.
-
-Marking a target more than once will give it more weight.
-
-.. figure:: /images/editors_3dview_controls_snapping_target-multiple.png
-
-   Multiple snapping targets.

manual/modeling/index.rst

@@ -18,3 +18,4 @@
    empties.rst
    modifiers/index.rst
    geometry_nodes/index.rst
+   transform/index.rst

manual/modeling/transform/index.rst

@@ -0,0 +1,11 @@
+.. _bpy.ops.transform:
+
+#############
+  Transform
+#############
+
+.. toctree::
+   :maxdepth: 2
+
+   introduction.rst
+   modal_map.rst

manual/modeling/transform/introduction.rst

@@ -0,0 +1,61 @@
+.. index:: Transform; Modeling Transform
+.. index:: Modeling Transform
+
+************
+Introduction
+************
+
+Transform is the modality of operations that perform transformations in 2D and 3D elements.
+Transformations can include things like moving, rotating, scaling,
+and applying other operations to objects in the scene.
+
+They work by changing the geometry which you can edit directly.
+
+
+Operators
+=========
+
+.. _bpy.ops.transform.transform:
+
+There are several transformation operations included in Blender.
+Here are some of the main operations available:
+
+
+.. _bpy.ops.transform.translate:
+
+Move
+----
+
+This operations allows you to move elements along the X, Y, and Z axes in the scene.
+
+
+.. _bpy.ops.transform.rotate:
+
+Rotate
+------
+
+You can use this function to rotate elements around the X, Y, and Z axes.
+
+
+.. _bpy.ops.transform.resize:
+
+Scale
+-----
+
+Scaling allows you to increase or decrease the size of an object along the X, Y, and Z axes.
+
+
+.. _bpy.ops.transform.align:
+
+Align to View
+-------------
+
+This is useful for aligning objects with the view from the camera or another specific viewpoint.
+
+
+.. _bpy.ops.transform.mirror:
+
+Mirror
+------
+
+Mirrors objects along one or more axes.

manual/modeling/transform/modal_map.rst

@@ -0,0 +1,62 @@
+
+*******************
+Transform Modal Map
+*******************
+
+During a transformation, some hotkeys can change the behavior of the operation.
+
+You can check editing the keys of these modal modifiers in
+:menuselection:`Blender Preferences --> Keymap --> Transform Modal Map`
+(at the bottom of the keymap).
+
+
+Constraints
+===========
+
+When moving, rotating or scaling, if you only want certain axes to be affected,
+you can restrict the transformation to those axes.
+
+By default the constraint keys are :kbd:`X`, `Y` and `Z`.
+This constraint can be restricted to plane if :kbd`Shift`
+is pressed or automatically detected if :kbd:`MMB` is pressed.
+
+It is worth noting that if you press the same contraint hotkey a second time,
+you change the orientation from Local to Global or vice versa. Pressing a third time disables the constraint.
+
+
+Snapping
+========
+
+Transform operations use the :doc:`snapping settings </editors/3dview/controls/snapping>` set in the scene.
+However, some options can be changed during the transformation.
+
+
+Snap Invert
+-----------
+
+Even if the magnetic icon is disabled, you can still enable snapping during a transformation.
+The default hotkey in this case is :kbd:`Ctrl`.
+
+
+Set Snap Base
+-------------
+
+Snap Base is taken automatically depending on the :ref:`Snap With <bpy.types.ToolSettings.snap_target>` options.
+However, this automatic snap detection point of origin is not always what the user desires.
+Therefore, transform operations have a utility to set a new snap origin point during the transformation.
+By default the hotkey is :kbd:`B`.
+
+
+Add Snap Point
+--------------
+
+While you're transforming a selection with snapping enabled,
+you can press :kbd:`A` whenever there's a highlighted snap target to
+mark it. With multiple such targets marked, the selection will
+then be snapped to their average location.
+
+Marking a target more than once will give it more weight.
+
+.. figure:: /images/editors_3dview_controls_snapping_target-multiple.png
+
+   Multiple snapping targets.