Manual for QuadPen 0.14.0

Drawing tools

On this page

Drawing tools create new retopology geometry on the reference surface. Most strokes must start on the surface; Tubes and Slice are exceptions. In Draw, right-click selects a stroke.

Draw#

Select Draw (D), choose Line, Loft, or Sweep in the TOOL card, drag strokes, then press Enter or click Create geometry.

Line samples strokes, splits crossings, and closes small loops into triangles or quads. A stroke that starts or ends on a vertex of the low poly is joined to exactly that vertex, so two strokes drawn from two border vertices to one new point close a quad with the border between them. The same works as one stroke drawn like an L: a sharp corner in a stroke is kept as a vertex, whatever Points is set to. A gentle curve is not a corner. Set Points to 2 for the most predictable faces; higher values often leave longer loops as wire edges. Strokes that cross on a curved part of the model are joined where they meet on the surface, even though the straight lines between their points pass each other at different depths.

Loft connects two parallel strokes with quads. With Points at 2, Loft picks the number of quads itself so they come out roughly square; set Points higher to choose the count. Auto-invert second stroke handles opposite drawing directions, Reverse second stroke flips them manually, and Chain all strokes lofts every consecutive pair.

Sweep wraps a tube around a centerline. Sweep steps sets the side count and Sweep radius is a percentage of scene size.

Steady mouse (Draw, Strip and Guides tool cards) smooths out hand jitter: the stroke follows the cursor on a short string, drawn as a line from the stroke end to the cursor. Steady length sets the length of the string; longer is smoother and lags more.

Strip and Quad#

Strip (S) lays a ribbon of quads. Drag across the surface. In the TOOL card, Strip width sets the width; Quads along sets how many quads the strip gets along the stroke (all the way left is Auto: quads about as long as they are wide); Quads across sets how many quads the strip is wide (1 to 16). A line under the sliders states the resulting edge counts. When a strip one quad wide starts on an existing border edge, the whole ribbon uses that edge's width and carries on from it; a strip several quads wide does not attach to an existing edge. With Live symmetry on, a strip drawn across the symmetry plane ends on the plane and is mirrored, so the two halves meet in a seam instead of lying on top of each other.

Quad (Q) creates one quad from four surface clicks. Clicks snap to existing vertices, and the face is created on the fourth click.

Tubes and Circle#

Tubes (U) builds a quad tube from ordered cross-sections. Drag each section straight across the limb, in order; a stroke may start or end in empty space, and only the part over the reference is sampled. With Wrap around the high poly on (the default) every section becomes a full ring round the limb, on the far side too, so the result is a closed tube. The ring is the outline of the high poly where the section cuts it. It also works when the limb is made of several pieces (strands, tendons, plates): the ring goes round all of them. Another limb next to it is left out. Where the high poly is open, the ring goes straight across the opening and the status bar says which section. A section on a flat sheet, or where the limb is grown into the body, cannot be wrapped: the status bar says which one. Turn Wrap off to build only the part you drew on. Large gaps start a new section. Sections may lie close together, for example two on a knuckle: every section keeps its own ring. Set Divisions (points per ring) and Cap ends; use Delete last, Invert last, or Reset to correct the list. Press Enter or Create with at least two sections.

Circle (O) drags a screen-space disk from its center. Divisions sets the radial count. Geo steps at 0 creates only a border ring; higher values fill the disk. Fill chooses how the middle is closed: Quads (the default) or Triangles, a fan around a centre vertex. With Live symmetry on, a circle drawn over the symmetry plane is centred on the plane and built as two mirrored halves that share the vertices on the plane.

Patch#

Patch (P) fills a region in one of four modes:

Lines mode. Draw the border lines of the patch one after another, each starting where the previous one ended (a ring marks the spot); end the last line where the first began to close the patch.

The quads show live while you draw. The line you are drawing shows its division points and its count at the pointer; turn the wheel while you hold the button to change that count (no Ctrl needed while drawing). From the second line on, the quads fill in as you draw. While the patch is still open, a dashed straight line closes it from the last line's end back to the first start, and the quads show it closed that way: press Enter to fill it so, or keep drawing lines.

Presets cover Grid 2×2–6×6 and radial 6–16 stroke layouts. Stitch welds the patch border, within Stitch radius and never further than half a cell of the patch, to vertices that were there before the patch; the inside of a patch and its own new vertices are never welded. Border guides adds the borders to automatic retopology guides.

Create#

Create (C) places vertices and edges directly:

  1. Click the reference to place the first vertex.

  2. Click again to connect a new vertex to the active one.

  3. Ctrl-click an existing vertex to make it active.

  4. Shift-click a loose edge to split it.

Turn on Make faces to add a triangle or quad when the chain closes a loop.

The CHAIN switches in the TOOL card decide how a chain ends and continues. All four are on by default:

Esc also ends the chain.

Bridge#

Bridge (Ctrl+B) fills a gap between open edges: border edges of faces, and lines drawn with Create that have no face yet. The tool stays active, so you can bridge again and again.

Edges mode works side to side:

In Freehand or Straight mode, drag across the gap from one side to the other; the ends snap to open edges. In Freehand, with Follow the stroke on, the new rows follow the line you draw instead of the straight way across; with Segments at 1 the number of rows is chosen from the length of the stroke. The preview reports SNAP EDGE, warns FAR EDGE, or shows NO BOUNDARY EDGE when the snap is unreliable.

In Paint mode, press in the gap between two borders, near a vertex on each side, and drag along the gap: a quad joins each pair of border vertices the cursor passes. The highlighted rung shows where the next quad starts; it only takes border vertices you can see and click, so in a crease it starts next to the cursor, not on the far corner of a strip. One drag is one undo step.

Segments (in the Bridge tool card, and Bridge segments in the Modify menu) sets how many rows of quads a bridge makes between the two sides. It also applies to Modify → Bridge selected faces and Bridge selected loops. Right after a bridge, a LAST COMMAND card at the top of the inspector shows its Segments: change it and the bridge is redone with the new count. The card goes away as soon as you edit anything else.

Slice and Cut#

Slice (K) cuts with a plane defined by a screen-space line through the camera. Drag the line across the mesh. Only the faces under the stroke that face the camera are cut. Deep cuts straight through, so faces on the far side of the model are cut too. Extended continues the cut past both ends of the stroke, across the whole mesh. Offset moves the plane along its normal. Clean cuts only cuts only the faces that split without an extra edge (quads crossed through two opposite edges, which become two quads) and leaves alone the faces the line would clip a corner off. Force faces retries when the cut lands exactly on vertices or edges. Slice works with or without a reference surface.

Cut (V) draws a cut stroke across the retopology. Crossed edges are split and the crossed faces are divided. Only edges you can see are cut; the far side of the model is left alone unless See through is on. The ends of the stroke snap: to a vertex within 10 pixels, otherwise to an edge within 8 pixels, so you can cut vertex to vertex (a clean diagonal with no new vertices), vertex to edge, or edge to edge. A crossing right next to a vertex goes through that vertex. New vertices lie on the edge they cut. Make quads merges the triangles the cut made into quads where possible, and Relax cut (off by default) smooths and reprojects the new vertices.

A low poly only holds triangles and quads. Where a cut or a slice stops inside the mesh, the face beyond the last cut edge gets one joining edge (a quad becomes a quad and a triangle).

Shell and Extrude#

Shell adds a rim to border loops. Use Modify → Shell border loops or the SHELL section. Thickness and Offset are percentages of scene size. Picked scales the rim at selected vertices with Selected thickness.

To set the thickness by eye, press Shift+S (or Drag in view in the SHELL section, or Modify → Shell: drag thickness in view) and move the mouse left or right in the viewport: the rim is previewed live. Click applies it; Esc or right-click cancels.

Extrude (E) pulls new quads from border edges. With Whole line on (the default), dragging one border edge extrudes the whole border line it belongs to, up to its corners, in one go: the same line a click takes in Bridge. Turn it off to extrude one edge at a time. To pick the edges yourself (4 along a side, or 20), pick them first: drag a box over them starting beside the border (Shift adds to the picked edges, Alt removes), Shift-click them one by one, or double-click to pick the whole border. Then drag any picked edge outward and all of them extrude together. The new faces are shown while you drag. Crawl follows the reference, Project back moves along the boundary normal, and Free move uses the screen plane. With Keep the new edges selected (on by default) the extruded edges are the selection afterwards, so the next drag carries on from them. A new vertex that lands within the snap sensitivity of an existing vertex is merged into it when Merge on vertex snap is on. In Crawl and Project back the drag has to end over the high poly; the status bar says so when it does not.

For a face region, use Modify → Extrude selected faces with the Extrude (Edit section) percentage.