## Sphinx Warnings

`105: WARNING: undefined label: 'bpy.ops.screen.redo_last'`

Note the preview is not accurate and warnings may not indicate real issues.

# Tool Settings

## Options

Reference

Mode:

Edit Mode

Panel:

Sidebar ‣ Tool tab ‣ Options panel

### Transform

Correct Face Attributes

Adjust geometry attributes like UVs and Color Attributes while transforming.

Keep Connected

Merge attributes connected to the same vertex while using Correct Face Attributes.

Tip

Keeping UVs connected is useful for organic modeling, but not for architectural modeling.

#### Mirror

Mirror allows you to transform vertices symmetrically according to the chosen axis. When you transform an element (vertex, edge or face), if there is its exact axis-mirrored counterpart (in local space), it will be transformed accordingly, through a symmetry along the chosen axis.

Note

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, its easier and simpler to use the Mirror Modifier.

#### Topology Mirror

Note

For Topology Mirror to work, at least one of the three Mirror Axis must be enabled.

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 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 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. The effect of this is that mirrored vertices can be non-symmetrical and yet still be treated as mirrored.

Note

The Topology Mirror functionality will work more reliably on mesh geometry which is more detailed. If you use very simple geometry, for example a Cube or UV Sphere, the Topology Mirror option will often not work.

##### Example

For an example of how to use Topology Mirror open up a new Blender scene, then delete the default cube and add a Monkey object to the 3D Viewport.

1. Press Tab to put the Monkey object into Edit Mode.

2. With all the Mirror Axis options disabled move one of the Monkey objects vertices slightly.

3. Then Turn the X Axis Mirror on but leave Topology Mirror disabled.

4. If you now move that vertex again, the X Axis Mirror will not work and the mirrored vertices will not be altered.

5. If you then enable Topology Mirror and move the same vertices again, then X Axis Mirror should still mirror the other vertex, even though they are not perfectly positioned.

#### Auto Merge

Reference

Mode:

Edit Mode

Menu:

Sidebar ‣ Tool ‣ Options ‣ Auto Merge

When enabled, as soon as a vertex moves closer to another one than the Threshold setting, they are automatically merged. This option affects interactive operations only (tweaks made in the bpy.ops.screen.redo_last panel are considered interactive too). If the exact spot where a vertex is moved contains more than one vertex, then the merge will be performed between the moved vertex and one of those.

Split Edges & Faces

Detects the intersection of each transformed edge, creating a new vertex in place and sectioning the edge and the face if any.

Threshold

Defines the maximum distance between vertices that are merged.

### UVs

Live Unwrap

Automatically recalculates the UV unwrapping every time an edge has its seam property changed. Note, this is different than the Live Unwrap option in the UV Editor.