File: mirror.rst

package info (click to toggle)
blender-doc 4.3-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 253,604 kB
  • sloc: python: 13,030; javascript: 322; makefile: 113; sh: 107
file content (50 lines) | stat: -rw-r--r-- 1,769 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
.. _bpy.ops.transform.mirror:

******
Mirror
******

.. reference::

   :Mode:      Object and Edit Modes
   :Menu:      :menuselection:`Object/Mesh --> Mirror`
   :Shortcut:  :kbd:`Ctrl-M`

Mirroring an object or mesh selection will create a reversed version of the selection.
The position of the mirrored version of the selection is determined by
the :doc:`Pivot Point </editors/3dview/controls/pivot_point/index>`.
A common use of mirroring is to model half an object, duplicate it and then use
the mirror transform to create a reversed version to complete the model.

.. note::

   Mirrored duplicates can also be created with a :doc:`Mirror Modifier </modeling/modifiers/generate/mirror>`.

.. _fig-mesh-duplicating-mirror-selection:

.. figure:: /images/scene-layout_object_editing_mirror_example.png

   Mirroring a selection.


Usage
=====

To mirror a selection along a particular global axis, press:
:kbd:`Ctrl-M`, followed by :kbd:`X`, :kbd:`Y` or :kbd:`Z`.
The image :ref:`Mirroring a Selection <fig-mesh-duplicating-mirror-selection>`
shows the results of this action after a mesh element has been duplicated.

In mesh mode, you can mirror the selection on the currently selected
:doc:`Transform Orientations </editors/3dview/controls/orientation>`
by pressing the appropriate axis key a second time. For example,
if the Transform Orientation is set to *Normal*, pressing:
:kbd:`Ctrl-M`, followed by :kbd:`X` and then :kbd:`X` again
will mirror the selection along the X axis of the *Normal Orientation*.

.. figure:: /images/scene-layout_object_editing_mirror_panel.png

   Mirror :ref:`bpy.ops.screen.redo_last` panel.

You can alternatively hold the :kbd:`MMB` to interactively mirror the object by moving
the mouse in the direction of the mirror axis.