Changeset View
Changeset View
Standalone View
Standalone View
manual/modeling/meshes/editing/mesh_options.rst
| Context not available. | |||||
| .. _bpy.types.Mesh.use_mirror_x: | .. _bpy.types.Mesh.use_mirror_x: | ||||
| X Mirror | Mirror | ||||
| ======== | ======== | ||||
| The *X Mirror* option of the *Mesh Options* panel allows you to edit symmetrical vertices on the other side | The *Mirror* option of the *Mesh Options* panel allows you to transform vertices symmetrically | ||||
| of the mesh in a single action. When you transform an element (vertex, edge or face), | according to the chosen axis. When you transform an element (vertex, edge or face), | ||||
| if there is its exact X-mirrored counterpart (in local space), | if there is its exact axis-mirrored counterpart (in local space), | ||||
| it will be transformed accordingly, through a symmetry along the local X axis. | it will be transformed accordingly, through a symmetry along the chosen axis. | ||||
| .. note:: | .. note:: | ||||
| The conditions for *X Mirror* to work are quite strict, which can make it difficult to use. | The conditions for *Mirror* to work are quite strict, which can make it difficult to use. | ||||
| To have an exact mirrored version of a (half) mesh, | To have an exact mirrored version of a (half) mesh, | ||||
| it's easier and simpler to use the :doc:`Mirror Modifier </modeling/modifiers/generate/mirror>`. | it's easier and simpler to use the :doc:`Mirror Modifier </modeling/modifiers/generate/mirror>`. | ||||
| Context not available. | |||||
| .. note:: | .. note:: | ||||
| For *Topology Mirror* to work the *X Mirror* option must be enabled. | For *Topology Mirror* to work the *Mirror* option must be enabled. | ||||
| When using the *X Mirror* option to work on mirrored Mesh Geometry, the vertices that | When using any of the three *Mirror Axis* options to work on a mirrored Mesh Geometry, the vertices that | ||||
| are mirrored must be perfectly placed. If they are not exactly positioned in their mirror | are mirrored must be perfectly placed. If they are not exactly positioned in their mirror | ||||
| locations then *X Mirror* will not treat those vertices as mirrored. | locations then the *Mirror Axis* will not treat those vertices as mirrored. | ||||
| *Topology Mirror* tries to address this problem by determining which vertices are mirrored vertices not only by | *Topology Mirror* tries to address this problem by determining which vertices are mirrored vertices not only by | ||||
| using their positions but also by looking at how those vertices are related to others in the Mesh Geometry. | using their positions but also by looking at how those vertices are related to others in the Mesh Geometry. | ||||
| It looks at the overall topology to determine if particular vertices will be treated as mirrored. | It looks at the overall topology to determine if particular vertices will be treated as mirrored. | ||||
| The effect of this is that mirrored vertices can be non-symmetrical and yet still be treated as mirrored when | The effect of this is that mirrored vertices can be non-symmetrical and yet still be treated as mirrored. | ||||
| *X Mirror* and *Topology Mirror* are both active. | |||||
| .. note:: | .. note:: | ||||
| Context not available. | |||||
| then delete the default cube and add a Monkey object to the 3D View. | then delete the default cube and add a Monkey object to the 3D View. | ||||
| #. Press :kbd:`Tab` to put the Monkey object into *Edit Mode*. | #. Press :kbd:`Tab` to put the Monkey object into *Edit Mode*. | ||||
| #. With the *X Mirror* option disabled move one of the Monkey object's vertices slightly. | #. With all the *Mirror Axis* options disabled move one of the Monkey object's vertices slightly. | ||||
| #. Then Turn *X Mirror* option on again but leave *Topology Mirror* disabled. | #. Then Turn the *X Axis Mirror* on but leave *Topology Mirror* disabled. | ||||
| #. If you now move that vertex again *X Mirror* will not work and the mirrored | #. If you now move that vertex again, the *X Axis Mirror* will not work and the mirrored | ||||
| vertices will not be altered. | vertices will not be altered. | ||||
| #. If you then enable *Topology Mirror* and move the same vertices again, | #. If you then enable *Topology Mirror* and move the same vertices again, | ||||
| then *X Mirror* should still mirror the other vertex, | then *X Axis Mirror* should still mirror the other vertex, | ||||
| even though they are not perfectly positioned. | even though they are not perfectly positioned. | ||||
| Context not available. | |||||
| Enables the Auto Merge feature. | Enables the Auto Merge feature. | ||||
| Split Edges & Faces | Split Edges & Faces | ||||
| Detects the intersection of each transformed edge, creating a new vertex in place and sectioning the edge. | Detects the intersection of each transformed edge, creating a new vertex in place and sectioning the edge and the face if any. | ||||
| Threshold | Threshold | ||||
| Defines the maximum distance between vertices that are merged by the *Auto Merge*. | Defines the maximum distance between vertices that are merged by the *Auto Merge*. | ||||
| Context not available. | |||||