Settings and shortcuts
On this page
Open File → Settings… (Ctrl+,) to reach the six settings pages: General, Navigation, Theme, Model, Shortcuts, and Snapping. The Help menu also links directly to the Navigation, Keyboard shortcuts, and Snapping pages.
Every page has the same layout: the name of a setting on the left, its control on the right, with headings between groups. Hover a name for its explanation.
General#
Preset file. Save to file… writes a
.qpuifile with every setting of this window, the panel layout and all shortcuts. Load from file… applies such a file and makes it this computer's settings. Use it to carry your setup to another machine.Autosave. Save a recovery copy every sets how often unsaved work is written to a recovery file in the settings folder (default 3 minutes, 0 turns it off). The file is removed when you save or close normally; if QuadPen crashes or the PC loses power, the next start offers Recover (reopens the work, marked unsaved, with Save going back to the original file) or Discard.
Updates. Check when QuadPen starts turns the startup update check on or off, and Check now checks immediately. Only the version number of your copy is sent.
Navigation#
Choose one of the five navigation presets. Camera mouse bindings change immediately. See Navigation and selection for the full mouse binding table.
The zoom direction has two separate switches:
Invert drag zoom reverses zooming by dragging (Alt + right mouse button in the Maya preset). On by default.
Invert mouse wheel zoom reverses the mouse wheel and the trackpad pinch. Off by default.
Theme#
QuadPen includes eight interface themes:
Dark
White
Light Gray
Dark Gray
System
Maya
3ds Max
Blender
The theme applies to panels, menus, dialogs, toolbar icons, and the viewport background. System follows the operating system light or dark preference. Dark Gray is the fresh default. You can also switch themes from View → Theme.
Model#
Sizes
Vertex size scales the vertex dots (0.5× to 3×), with a slider.
Edge width sets the low-poly edge width (1 to 5 px), with a slider.
Colours
High poly: Surface — the base clay color, lit with a broad highlight and soft rim reflection.
Surface fill — the translucent low-poly fill. It is shaded smoothly, from the surface normals at its corners, in a narrow range of light, so the edges drawn on it stay visible on its darker side too.
Edges — unselected low-poly wires.
Vertices — unselected vertex dots.
Mouse-over — hovered vertices, edges, faces and their labels.
Selected — selected vertices, edges and faces.
Border — open border edges and their vertices.
Sizes and colours are saved at once. Reset colours restores the QuadPen defaults.
Shortcuts#
Every tool and command shortcut can be changed.
Pick the page: General, Topology, UV Layout or Bake.
Click the key button next to a tool or command.
Press the new key or key combination. Esc cancels.
A change is saved at once. Reset tool keys, Reset command keys and Reset all restore the defaults.
A shortcut belongs to its workspace. General shortcuts work everywhere. Topology shortcuts only work in the Topo workspace, UV Layout shortcuts only in UV Layout. That is why the same key can mean two things: W is Weld in Topo and the Move tool in UV Layout. The modelling tool keys are silent in UV Layout, except Move.
Tool shortcuts can be a single key or Ctrl + key. Space is reserved for the radial menu.
The SHORTCUTS section in the inspector offers the same tool and command bindings without opening the Settings window.
Default shortcuts#
Tools (Topology)#
| Tool | Key | Tool | Key |
|---|---|---|---|
| Move | Tab | Tubes | U |
| Draw | D | Circle | O |
| Strip | S | Slice | K |
| Create | C | Cut | V |
| Quad | Q | Patch | P |
| Extrude | E | Guides | J |
| Bridge | Ctrl+B | Mask | M |
| Slide | G | Erase | X |
| Brush | B |
Shift + drag smooths with the brush from any tool, and leaves the tool as it was. In Move, start the drag on the low poly; started beside it, Shift + drag is the box that adds to the selection.
General#
| Command | Default | Command | Default |
|---|---|---|---|
| Undo | Ctrl+Z | Save scene | Ctrl+S |
| Redo | Ctrl+Y | Open scene | Ctrl+O |
| New scene | Ctrl+N | Export low poly | Ctrl+E |
| Frame selection / scene | F | Load high poly | Ctrl+H |
| Select all | Ctrl+A | Delete selection | Delete |
| Cancel | Esc | Settings | Ctrl+, |
| Fullscreen | F11 |
Topology#
| Command | Default | Command | Default |
|---|---|---|---|
| Vertex mode | 1 | Edge loop | L |
| Edge mode | 2 | Edge ring | Shift+L |
| Face mode | 3 | Insert edge loop | I |
| Multi mode | 4 | Weld | W |
| Toggle snapping | N | Merge | Shift+W |
| Snap all | Alt+S | Radial menu | Space |
| Native retopology | Ctrl+R | Clean retopology | Ctrl+Del |
| Gizmo smaller | [ | Gizmo larger | ] |
| Hide selected faces | H | Hide unselected faces | Shift+H |
| Show hidden faces | Alt+H | Shell: drag thickness | Shift+S |
Relax has no shortcut. Use the Relax button in the top bar, the inspector or the Modify menu.
In the Draw and Tubes tools, Enter builds geometry from the current strokes or sections.
UV Layout#
| Command | Default | Command | Default |
|---|---|---|---|
| Select tool | Q | Picks points | F9 |
| Move tool | W | Picks edges | F10 |
| Rotate tool | E | Picks faces | F11 |
| Scale tool | R | Picks islands | F12 |
| Cut | Shift+X | Sew | Shift+S |
| Unfold | U | Optimize | O |
| Straighten | T | Pack | Ctrl+P |
| Pin | P | Unpin | Shift+P |
1, 2 and 3 (vertex, edge and face mode for the 3D view) also work in UV Layout.
Bake#
Bake has no shortcuts of its own. The General shortcuts work there.
Snapping#
The Snapping page contains the same controls as the top-bar magnet and the v menu:
Enable snapping (N).
Snap to: Off, Vertex, Edge, Face, Vertex + edge, or All (vertex, edge, face), as buttons side by side.
Sensitivity from 2 to 48 pixels.
Merge on vertex snap: what you move onto other low-poly vertices merges with them on release (on by default). See Editing tools.
Vertex and edge snapping search the retopology and the visible high-poly surface. Face snapping uses the exact surface point under the cursor.
Configuration paths#
QuadPen stores settings and recent files per user.
| File | Windows | macOS | Linux |
|---|---|---|---|
| Settings and layout | %APPDATA%\QuadPen\quadpen_layout.ini | ~/Library/Application Support/QuadPen/quadpen_layout.ini | ~/.config/QuadPen/quadpen_layout.ini |
| Recent files | %APPDATA%\QuadPen\quadpen_recent.txt | ~/Library/Application Support/QuadPen/quadpen_recent.txt | ~/.config/QuadPen/quadpen_recent.txt |
For a portable setup, place a quadpen_layout.ini in the folder where you start QuadPen (the working directory). When that file exists, QuadPen keeps its settings and recent list in the local folder instead of the per-user location. Setting the environment variable QUADPEN_CONFIG_DIR to a folder makes QuadPen use that folder instead.
Shortcuts are saved in the settings file under the name of the tool or command (key.tool.Bridge, key.cmd.Undo). Shortcuts changed in a version before this layout start again from the defaults.
Use View → Save layout and settings and View → Load layout and settings to write or reload the settings file explicitly. To move a setup between computers use the preset file on the General page.