Manual for QuadPen 0.14.0

Editing tools

On this page

Editing tools select, move, and clean up retopology geometry. Commands act on the current vertex, edge, or face selection and respect Live symmetry.

Move tool and transforms#

Select Move (Tab): the first button of the mode bar, or the first tool in the tool dock. The active selection mode (the MODE buttons next to it) determines whether you pick vertices, edges, or faces; MULTI picks all three. Clicking Move, Rotate or Scale in the mode bar also switches to the Move tool.

TransformBehavior
MoveDrag across the reference surface. Axis handles constrain the move to X, Y, or Z and reproject the moved vertices. The handles start a little way out from the middle: press on the selected vertex itself (the middle of the gizmo) to move it freely, with snap and merge. A move with a handle merges on drop too.
RotateDrag around the selection centroid. Axis handles rotate around X, Y, or Z; dragging elsewhere rotates in the screen plane.
ScaleDrag toward or away from the centroid for uniform scale. Axis handles are hidden.

Choose the transform from the mode bar or the SELECTION section. With Soft enabled, nearby vertices follow the transform with a radial falloff. Moving components requires a loaded reference surface.

Cleanup commands#

Unless noted, these commands are in the Modify menu and the EDIT inspector section.

CommandWhat it does
Weld (W)Merges coincident or close selected vertices.
Merge (Shift+W)Merges all selected vertices into one.
Collapse selectedIn vertex mode, merges selected vertices. In edge mode, collapses edges and turns quads into triangles. Invalid non-manifold collapses are rejected.
Connect selected edgesSplits the shared face between two or more selected edges.
Insert edge loop (I)Adds a loop through the ring containing the selected or hovered edge.
Spin selected edgesRepeats boundary or wire edges around an axis through the centre of the picked edges. Set the axis, steps, and angle in the Modify menu. When the result would break the mesh (swept faces that cross or lie on each other, or a border edge turned a full circle, which would give it three faces) nothing is changed and the status bar says why.
Delete selected edgesRemoves the selected edges and keeps the faces: the two faces on either side of an edge become one face. Two triangles make a quad; two quads make one quad where the edge's corners are used by nothing else (at a border). Where the joined face would have more than 4 corners the edge stays, and the status bar says so (to remove a whole edge loop, Shift+middle-click it). A border edge takes its face with it; a loose edge is removed. Delete does the same when edges are picked in Edge mode.
Delete selectedRemoves faces touched by the current component selection, plus selected loose wires.
Delete loose wires & verticesRemoves leftover wire edges and unused vertices after drawing or cleanup.
Make quads from trianglesMerges adjacent triangle pairs into quads.
Subdivide / Subdivide selected islandsSplits every face, or only complete connected islands. See Symmetry and subdivision.
Flip normals (inspector)Reverses the winding of all faces.
Fix normals (inspector)Turns round only the faces that are inside out against their neighbours, and says how many it turned. Use it before exporting if a face looks dark in another program.
Erase (X)Click a face to delete it, plus its mirror under Live symmetry. Click right on an edge between two faces (it lights up) to remove the edge: the two faces become one, as with Delete selected edges. Hold the button and drag to erase every face the cursor passes; the whole drag is one undo step. Where there is no face under the cursor, it removes a loose edge, or a loose vertex together with the loose edges that end on it.
Relax (top bar, EDIT section, Modify menu)Smooths selected vertices, or all vertices when nothing is selected, and reprojects them. It has no shortcut, so it cannot be pressed by accident.
Snap to surface (Alt+S)Projects every retopology vertex onto the closest point of the reference.

Selection commands#

The SELECTION section holds the selection commands; they are listed in Navigation and selection. F frames the selection from the viewport.

Slide and Brush#

Slide (G) moves selected edge loops along their adjacent faces. Select one or more edges, then drag a vertex on the loop.

Brush (B) paints changes onto the retopology. Modes are Move, Relax, Inflate, Standard, Screen project, Conform, Pinch, Select, and Delete. Set Size, Falloff, and Strength in the TOOL card or in the floating BRUSH panel. Selection only limits the brush to selected components, Keep the border fixed leaves the vertices on the open border where they are (only the inside is moved or smoothed), and Backfaces allows painting through the surface. Hold Shift for temporary Relax; Ctrl or Alt inverts the effect.

Delete mode removes what the brush passes over. Choose Vertices, Edges or Faces in the TOOL card; the circle turns red. A face goes when its centre is inside the circle, an edge when its midpoint is, a vertex when it is. As with the Delete key, deleting vertices or edges also removes the faces that use them. Symmetry mirrors the deletion, Use selection limits it to selected vertices, Backfaces reaches through the surface, and one stroke is one undo step.

With the Brush active, right-drag adjusts Size, Shift + right-drag adjusts Falloff, and middle-drag adjusts Strength. Hold Alt for the normal camera navigation shortcuts while the Brush is active. The floating panel shows the current values.

Snapping#

Press N, click the magnet in the top bar, or open the v menu. Modes are Off, Vertex, Edge, Face, Vertex + edge, and All (vertex, edge, face). Sensitivity sets a 2–48 pixel search radius. Vertex and edge snapping search the retopology and visible high-poly surface; face snapping uses the exact point under the cursor. The Snapping tab in Settings has the same controls.

While you move vertices, edges or faces, the ones being moved are never snap targets, so they snap to the rest of the mesh. Low-poly vertices are snap targets in every Snap to setting except Edge, also in the default Face, and a low-poly vertex wins over a nearer high-poly vertex.

Merge on vertex snap (on by default, in the v menu and Settings) decides what happens when you let go:

Snapping assists placement. Snap to surface is different: it projects every vertex onto the reference.

Undo and redo#

Use Ctrl+Z to undo and Ctrl+Y to redo. UV data is restored with the mesh. If a command cannot be applied, the status bar explains why without changing the geometry.

Undo covers more than edits of the mesh:

Not undoable: Remesh, Decimate and loading or replacing the high poly, turning Symmetry on or off, and a layer's eye.

Smoothing from any tool#

Hold Shift and drag on the model in any tool: the brush smooths (Relax) under the cursor with the Brush tool's Size, Falloff, Strength and Keep the border fixed, and the tool stays as it was when you let go. One drag is one undo step.

Shift+click keeps its own meaning in every tool (add to the selection in Move, pick more edges in Extrude and Bridge). In Move, a Shift+drag that starts beside the low poly is still the box that adds to the selection; started on the low poly it smooths.