Manual for QuadPen 0.14.0

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#

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:

Theme#

QuadPen includes eight interface themes:

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

Colours

Sizes and colours are saved at once. Reset colours restores the QuadPen defaults.

Shortcuts#

Every tool and command shortcut can be changed.

  1. Pick the page: General, Topology, UV Layout or Bake.

  2. Click the key button next to a tool or command.

  3. 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)#

ToolKeyToolKey
MoveTabTubesU
DrawDCircleO
StripSSliceK
CreateCCutV
QuadQPatchP
ExtrudeEGuidesJ
BridgeCtrl+BMaskM
SlideGEraseX
BrushB

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#

CommandDefaultCommandDefault
UndoCtrl+ZSave sceneCtrl+S
RedoCtrl+YOpen sceneCtrl+O
New sceneCtrl+NExport low polyCtrl+E
Frame selection / sceneFLoad high polyCtrl+H
Select allCtrl+ADelete selectionDelete
CancelEscSettingsCtrl+,
FullscreenF11

Topology#

CommandDefaultCommandDefault
Vertex mode1Edge loopL
Edge mode2Edge ringShift+L
Face mode3Insert edge loopI
Multi mode4WeldW
Toggle snappingNMergeShift+W
Snap allAlt+SRadial menuSpace
Native retopologyCtrl+RClean retopologyCtrl+Del
Gizmo smaller[Gizmo larger]
Hide selected facesHHide unselected facesShift+H
Show hidden facesAlt+HShell: drag thicknessShift+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#

CommandDefaultCommandDefault
Select toolQPicks pointsF9
Move toolWPicks edgesF10
Rotate toolEPicks facesF11
Scale toolRPicks islandsF12
CutShift+XSewShift+S
UnfoldUOptimizeO
StraightenTPackCtrl+P
PinPUnpinShift+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:

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.

FileWindowsmacOSLinux
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.