Windows & Dock Layouts

·

Every standalone window in Vertexix is listed on the Window menu, each with a checkmark showing whether it is open right now. Clicking an entry toggles it: it opens the window if it is closed and closes it if it is open. Most windows also have their own button elsewhere (an icon-bar button, a sidebar row), but this menu is the one place that lists them all together.

The Window menu open listing every window with checkmarks beside the open ones, and two windows docked beside the viewport
The Window menu, with checkmarks beside the open windows and two windows docked beside the viewport.

The Window menu

The windows appear in this order. Voxel Tree and Numeric are listed in every mode, not only in Voxel mode.

Window What it's for Manual page
Selection Tools Selecting faces, materials and regions of the mesh. Selection Tools
Material Tools Working with the mesh's materials. Material Tools
Camera Camera and view settings. Camera Window
Head Tracking Webcam head tracking: the 3D view moves with your head. Head Tracking
Scratch Pad A scratch area for trying out colors and strokes. Scratch Pad
Surface Presets Saved surface presets for painting. Surface Presets
Sculpt Layers The layer stack for sculpting. Sculpt Layers
Seam Tools Placing and editing UV seams. Seam Tools
Vertex Density Paint Painting where the generated mesh should be denser or sparser. Vertex Density Paint
Image Viewer Viewing UV layouts and textures in 2D. Image Viewer
PBR Settings / OpenGL Settings Render settings for the viewport. The label follows the current render mode; it is the same window either way. PBR View
MatCap Browser Choosing a MatCap for the OpenGL view. MatCap Browser
Horizon Presets Choosing the viewport background. Viewport Background
Animation... Animation playback and controls. Animation
Keyboard Shortcuts A reference of the current keyboard shortcuts. Keyboard Shortcuts
Color - Wheel Picking a color from a color wheel. Color Picker & Swatches
Color - Bar Picking a color from color bars. Color Picker & Swatches
Swatches Saved color swatches. Color Picker & Swatches
Gradient Editor Editing gradients for painting. Gradient & Bucket Fill
Layers The texture layer stack for painting. Texture Layers
Paths - Paint Painting along paths. Stroke Tool
Paths - Sculpt Sculpting along paths. Sculpt Paths
Node Editor Building node-based textures. Node Editor
Node Presets Saved node setups. Node Presets
Merge Merging mesh parts. Merge Window
Voxel Tree The voxel object tree. Voxel Tree & Numeric
Numeric Typing exact values for voxel objects. Voxel Tree & Numeric
Settings... The Settings window. Its checkmark shows whether it is open, but this entry only opens it — close it from the window itself. Settings

Below these, separated by a line, are the dock layout entries described in Saving dock layouts.

Docking windows

Tool windows can be docked. Drag a window by its title bar (or its tab, if it is already docked) and drop targets appear; release over one to dock it. No modifier key is needed. Windows can dock:

  • against each other, stacking as tabs or splitting the space between them;
  • along the screen edge opposite the sidebar.

They never dock over the 3D view itself or onto the sidebar. The sidebar, the icon toolbar and the orientation gizmo are fixed and cannot be docked, and true modal dialogs never dock.

To undock a window, drag it out by its title bar or tab. A window dragged past the edge of the main Vertexix window becomes its own operating-system window, with a normal title bar, so you can move it to another monitor.

Saving dock layouts

The bottom of the Window menu manages named dock layouts:

  • Save Dock Layout... — “Save the current panel arrangement under a name, to reload later or set as a default for Retopology/Painting/Sculpting/Voxel mode in Settings > Interface.” Type a name and click OK (or press Enter).
  • Load Dock Layout — a submenu listing every saved layout; click one to apply it. It is greyed out until at least one layout has been saved.
  • Update Dock Layout... — overwrites the layout assigned to the mode you are currently in with the arrangement on screen, without asking for a name. It is greyed out when the current mode has no layout assigned; use Save Dock Layout... instead.

To have a layout applied automatically, assign it in Settings > Interface, which has one dropdown per mode: Retopology Dock Layout:, Painting Dock Layout:, Sculpting Dock Layout:, Voxel Dock Layout: and Quad-Patcher Dock Layout:. Each lists your saved layouts plus (None), which means nothing is applied automatically for that mode. Picking a layout for the mode you are in applies it straight away.

The Quad-Patcher's own layout

The Quad-Patcher counts as a mode of its own for docking. While it is open, the Quad-Patcher Dock Layout applies, together with the windows you had open the last time you used it. When you close it, Retopology's layout and windows come back. Switching to another tab while it is open goes straight to that tab's layout. To set one up:

  1. Open the Quad-Patcher and arrange the windows the way you want them.
  2. Choose Window > Save Dock Layout... and give the layout a name.
  3. Pick that name for Quad-Patcher Dock Layout: in Settings > Interface.

After that, Update Dock Layout... used while the Quad-Patcher is open updates the Quad-Patcher's layout, not Retopology's. Loading a layout never opens or closes the Quad-Patcher itself.

Resetting window placement

Window positions, sizes and docking are remembered between sessions in imgui_layout.ini, next to the program. Delete that file (with Vertexix closed) to put every window back in its default place. See Resetting.