Manual for QuadPen 0.14.0

Interface

On this page

QuadPen is organized around a single 3D viewport, with a menu bar and mode bar above it, a tool dock on one side, and an inspector on the other. Panels can be resized, hidden, and moved.

The menus between Edit and View follow the workspace tab on the right of the bar: Topology and Modify in Topo, UV Layout in UV Layout, and Baking in Bake.

MenuMain commands
FileScene open, save, and new; recent files; load high poly; load low poly; export; Settings; quit.
EditUndo and redo; selection modes; select all, none, or invert; edge loop and ring; frame.
Topology (Topo)Clean Retopology; new and merge retopo objects; Live symmetry; automatic retopology settings.
Modify (Topo)Loop, weld, merge, bridge, extrude, collapse, connect, delete, spin, split, subdivide, relax, snap, and shell commands.
UV Layout (UV Layout)Unwrap and Auto Unwrap; mark, clear and generate seams; Cut and Sew; Unfold, Optimize, Straighten, Pin and Unpin; Pack, texel density, rotate, flip and fit; what the UV editor picks; the UV display on the model.
Baking (Bake)Bake maps; which maps to bake; map size; normal map options; the baked map shown on the model; open the maps folder; all bake settings.
ViewFrame, fullscreen, theme, display, panels, isolate and show all, snapping, layout, subdivision preview.
HelpLicense (trial days left, activate a key), About QuadPen, Check for Updates, Documentation, Report a bug, and shortcuts to the navigation, keyboard, and snapping settings.

Help → About QuadPen… shows the version, developer, platform, website, support email and license, with buttons for the website, documentation, EULA and support. Documentation opens the online manual. Report a bug… opens an email with the version prefilled. Check for Updates… asks quadpen.com for the newest version and shows the answer: up to date, or the new version with its notes and a Download button that opens the download page.

When QuadPen starts it checks once in the background. If a newer version is out, a bar under the toolbars says so, with What's New (the notes), Download and Later (hides the bar until the next version). Without an internet connection nothing is shown. QuadPen never downloads or installs anything by itself.

The snapping button in the top bar is one control in two parts, like SYMMETRY: click the icon to turn snapping on or off (N), click the arrow joined to it for the snap type, the sensitivity and Merge on vertex snap. The dropdown stays open while you change things; click outside to close it.

Press Space for the radial command menu. Choose a tool around the ring; click the center hub to cycle vertex, edge, and face selection modes.

Mode bar#

Tool dock#

The tool dock is a narrow icon column on the left by default. Hover over an icon to see its name, shortcut, and a hint.

Close the dock with its × button and reopen it from View → Tool dock. View → Tool dock on left controls which side it occupies.

Inspector#

The inspector is on the right by default and resizable. Its sections collapse and expand independently:

View → Inspector on left controls which side the inspector occupies.

Scene panel#

The SCENE section is a layer panel, in the spirit of a layer list in a paint program. HIGH POLY rows are on top, LOW POLY rows below. Each row has an eye to hide or show the object, its name, and its triangle or face count. The active row is highlighted. Click a row to make that object the active one; a cross appears on the row under the pointer to delete it. Layers keep their order and their visibility when you switch. Click the name of the active low poly to rename it.

New adds an empty low-poly layer and makes it active (the previous one stays in the list, even when it is still empty). Duplicate adds a copy of the active layer and makes the copy active. Delete removes the active layer; the last layer is emptied instead. Load… loads a low poly into the active layer, Merge merges the visible low polys into the active one, Isolate hides everything except the active high poly and low poly, and Show All restores visibility. A low poly whose eye is off is not drawn and cannot be edited until you show it again.

Viewport and statistics#

The viewport draws the reference surface with the retopology on top. The high-poly reference uses light clay with a broad studio highlight and soft rim reflection, so it reads differently from the matte retopo cage. The retopo surface is a translucent neutral gray skin with near-black interior wires. Boundary edges are crimson and selected components are red. Small and medium meshes show a blue dot on every vertex; dense meshes show blue dots only on boundary, selected, hovered and active vertices. The hovered component is teal and labelled VERTEX, EDGE or FACE beside the cursor. The active vertex is teal. Enable Vertex dots in the SELECTION section to force every vertex dot on a dense mesh. Dot size is set in Settings → Model. The retopology on the far side of the high poly is not drawn, however thin the part is. See through draws the whole retopology overlay on top of the reference, the far side included.

The transform gizmo keeps a constant on-screen size. Use the - and + buttons next to Gizmo in the SELECTION section, or the [ and ] keys, to make it smaller or larger. This keeps the handles usable when you zoom close to small components.

Settings → Model contains a two-column color table for the high-poly reference, low-poly surface, edges, vertices, mouse-over, selection and boundary colors. The colors are saved with the layout and can be reset to the TopoGun defaults.

The statistics overlay sits at the bottom left. It reports retopology vertices, edges, faces, and triangles, reference triangles, frame rate, selection count, and total quads. Toggle it with STATS or View → Statistics overlay. The name and triangle count of the high poly are shown in SCENE and here, not in a section of their own.

A separate status bar at the bottom of the window shows the latest message, reference and retopo counts, and selection size.

View cube#

The view cube sits at the top right. Click a labeled face to snap to Front, Back, Left, Right, Top, or Bottom. Drag the cube to orbit. The button below it switches between perspective and orthographic projection and remains available when the cube is hidden.

File dialogs#

Open, save, load high poly, load low poly, and export use your operating system's file dialog: the Windows file picker, the macOS Open/Save panel, or the Linux desktop's file chooser. The dialog shows network drives, cloud storage, recent places and the usual OS shortcuts. QuadPen keeps a Recent files list in the File menu.

Choose a file and confirm; the OS dialog handles overwrite confirmation. Esc or Cancel closes the dialog.

Toasts and progress#

Short notices appear near the top center and are marked INFO, DONE, or ERROR. Long operations such as loading a high-poly reference or opening and saving a scene show a centered spinner panel until the job finishes.