Skip to content

Free, open-source 3D sculpting for Linux, macOS and Windows: dense meshes, remeshing, painting, built-in AI (image/text to 3D), Send to Unreal, game-ready LODs, Gaussian splats and OpenUSD.

Merge remote-tracking branch 'origin/feat/piemenu' into feat/inbox2

islandmed2e7027af98e6
diff --cc CHANGELOG.md
index 48a643f3,0745a745..144c4b6c
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@@ -6,69 -6,15 +6,77 @@@ All notable changes to SculptForge are
## [Unreleased]
+## [0.10.4] - 2026-11-01
+
### Added
+ - Radial (pie) menus (#45): up to 8 menus of up to 8 items, each item any action the command palette (F3) finds
+ (brushes, tools, commands, toggles). Hold a menu's key, flick toward an item and let go to run it; tap the key and
+ the pie stays open for a click. A menu can also open from a mouse button (middle, back, forward) or a pen side
+ button while it is held. Two built in: **Brushes** on <kbd>T</kbd> and **Masking** on <kbd>Y</kbd> (free in
+ every input style). Edit them in Preferences > Input > Radial Menus: add, remove and reorder items, pick each
+ action with the palette's search, give it your own label and icon, set the menu's key and button. Store Config
+ keeps them in ui.json; Export / Import shares one menu as a small JSON file holding only action names (unknown
+ actions are left out, counts and text lengths are capped).
+- Insert your own mesh (#34): **Append > Insert on the model > Active SubTool's copy...** (another SubTool) or
+ **From file...** (`.obj`, `.ply`, `.glb`), dragged onto the surface like the shapes: centred, sized by the drag,
+ its up axis along the normal, turned by the drag and mirrored by symmetry, one undo step
+ (`insert_mesh subtool=<name>|file=<path>`).
+- **Keep Masked** for Voxel Remesh, Decimate and QRemesh (#43, off by default): masked areas keep their
+ triangles exactly; the rest is rebuilt and, for the remeshers, joined to them along the mask's edge with a
+ strip of triangles so the model stays closed (`keep_masked=true` on `remesh`, `decimate`, `qremesh`).
+- Triple-click another SubTool in the viewport to make it the active one and frame it (#43).
+- **Preferences > Input > Hold Space and drag to move the camera** (#43, off by default since ZBrush's Space opens
+ the QuickMenu): with Space held, left-drag rotates, right- or middle-drag pans and Ctrl+drag zooms, anywhere on
+ the canvas; never while typing in a text field.
+- Twelve more built-in alphas (#43): Pores, Cracks, Scales, Rivets, Stitches, Fabric Weave, Bark, Rock Strata,
+ Wrinkles, Skin Folds, Hair Strands and Dot Grid; and six more VDM brushes: Rivet, Stitches, Skin Fold, Wrinkle
+ Line, Crack and Rock Ledge. All are generated in code the first time they're used (no downloaded or bundled
+ image files), with thumbnails in the pickers and the LightBox (whose Brush tab now lists the built-in VDMs too).
+
+### Fixed
+- SelectRect and SelectLasso (hide / show) ignored symmetry (#51 follow-up): with X / Y / Z on, the mirror image of
+ the shape counts as inside too, as with MaskRect and MaskLasso (`hide_rect` / `hide_lasso symmetry=x`).
+
+## [0.10.3] - 2026-11-01
+
+### Added
+- Preferences > Tablet > Mouse mode (relative) (#54): for tablets whose driver is set to mouse mode, the pen moves
+ the cursor by how far it moves, like a mouse.
+- Alternate smooth (#40, as in ZBrush): start a stroke with Shift held, then let go of Shift while still pressing,
+ and the rest of the stroke smooths without shrinking the form (a Taubin smooth). Brush > Smooth keeps volume
+ makes that the Shift / Smooth brush smooth (letting go of Shift then switches to the plain one).
+- Ctrl+drag on the background with MaskPen draws a mask rectangle while dragging (#48) and masks what it covers;
+ one that covers none of the model clears the mask, as before (and as in ZBrush, without DynaMesh's remesh).
+- Axis gizmo (#43): click an end of the X / Y / Z gizmo in the canvas corner to snap to that side view
+ (orthographic), as in Blender; the negative ends are drawn too and the end under the pointer is ringed.
+- Undo and Redo on the right shelf (#43); stored layouts get them at the top once (layout version 3).
+- **Continuous** is also in the left shelf's stroke picker, under the stroke tiles (#43).
+- Insert on the model respects X / Y / Z symmetry (#43): a mirrored copy on the other side, one undo step
+ (`insert_primitive symmetry=x`).
+- SubTool thumbnails in the SubTool list (#43), drawn from each SubTool's existing GPU buffers (no upload, the
+ motion proxy on dense meshes), one per frame at most and only once a change has settled, never during a stroke.
+
+- Ways to support SculptForge (memberships on the website; the app stays free and behaves the same for
+ everyone). Each one only opens https://sculptforge.app/donate.html in the browser: **Help > Support
+ SculptForge...**, a line in the first-run welcome (new: a small note on the very first start, also Help > Welcome
+ in the command palette), a line at the end of **What's New**, and a **Supporters** section in **Help > About**
+ listing the names in `docs/supporters.txt`, compiled in and shown as plain text (control and invisible formatting
+ characters removed, 40 characters and 2000 names at most). After about ten hours of sculpting (counted locally
+ in project.json) one dismissible note shows along the bottom of the canvas, never at launch and never again.
+ No payment code, network calls, tracking or licence checks.
+
+### Changed
+- The Mask display toggle (right shelf, <kbd>Ctrl</kbd>+<kbd>H</kbd>) says in its help and the status bar that a
+ hidden mask still masks (#43).
+
+### Fixed
+- Pen tablets in mouse (relative) mode (#54): lifting the pen and putting it down elsewhere made the cursor jump
+ back to where the pen was on the tablet. Turn on Preferences > Tablet > Mouse mode.
+- MaskLasso and MaskRect ignored symmetry (#51): the mirror image of the shape is masked too now, as with mask
+ strokes. A Ctrl+click on the model with MaskLasso or MaskRect blurs the mask (Ctrl+Alt+click sharpens it), as
+ with MaskPen; it did nothing. A lasso or rectangle that covers none of the model clears the mask.
+- macOS (#41): reopening in full screen (restored from the last session, #35) left the menu bar and window buttons
+ unreachable until another display was clicked; full screen is now entered after the window is on screen.
## [0.10.2] - 2026-11-01
diff --cc docs/guide/interface.md
index 88ab8912,11fa059e..125823ac
--- a/docs/guide/interface.md
+++ b/docs/guide/interface.md
@@@ -443,9 -439,8 +443,10 @@@ the numpad views and Blender's sculpt-m
style, **Emulate Numpad** makes the number row work as the numpad, and **Import Blender keymap...** takes the keys
from a keymap you exported in Blender. **Right click opens the QuickMenu** (on by default, in every style) opens
the [QuickMenu](sculpting.md#the-quickmenu) with a right click on the canvas; a right drag navigates either
-way. **Radial Menus** edits your pie menus and their keys (see [Radial menus](sculpting.md#radial-menus)).
+way. **Hold Space and drag to move the camera** (off by default) turns <kbd>Space</kbd> into a camera key: held,
+left-drag rotates, right- or middle-drag pans and <kbd>Ctrl</kbd>+drag zooms (see
- [Navigation](navigation.md#mouse-and-pen)). **Cursor follows surface** (on by default) lays the brush rings on the model under the pointer (see
++[Navigation](navigation.md#mouse-and-pen)). **Radial Menus** edits your pie menus and their keys (see [Radial menus](sculpting.md#radial-menus)).
+ **Cursor follows surface** (on by default) lays the brush rings on the model under the pointer (see
[Draw Size and Focal Shift](sculpting.md#draw-size-z-intensity-rgb-intensity-and-focal-shift)); off, they are flat circles on the screen. **Rotation** chooses free rotation (ZBrush) or a turntable. See
[Coming from ZBrush](coming-from-zbrush.md).
diff --cc docs/guide/sculpting.md
index fc085f74,cbd148b2..8dc31154
--- a/docs/guide/sculpting.md
+++ b/docs/guide/sculpting.md
@@@ -493,9 -486,8 +521,10 @@@ also have a **Pressure curve** setting
- a pressure curve for all brushes (Soft, Linear or Firm, or set **Curve**, **Minimum**, **Maximum**, **Threshold**
and **Full pressure at** yourself), applied before each brush's own curve;
- the eraser end (default **Invert**, like holding <kbd>Alt</kbd>) and the side buttons (default:
- lower button right-click to rotate the view, upper button **Invert**, third button **Pan view**);
+ lower button right-click to rotate the view, upper button **Invert**, third button **Pan view**). A side button
+ can open a [radial menu](#radial-menus) instead (Preferences > Input > Radial Menus).
+- **Mouse mode (relative)**, for a tablet whose driver is set to mouse mode: the pen moves the cursor by how far
+ it moves, and putting it down elsewhere on the tablet leaves the cursor where it was.
**Store Config** (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd>) keeps these settings. Setup notes for Windows
Ink, macOS and Linux are in
diff --cc src/app/App.cpp
index 32c25ef4,f0ecc3cc..2c2a71e2
--- a/src/app/App.cpp
+++ b/src/app/App.cpp
@@@ -1043,11 -1029,10 +1043,12 @@@ int App::run()
// Input
// ---------------------------------------------------------------------------
-void App::handleEvent(const SDL_Event& e) {
- if (dropPenMouseEvent(e)) return; // pen side buttons are mapped in Tablet.cpp, not left to SDL
- if (strayMouseMotion(e)) return; // neither the canvas nor the UI follows a driver's stray mouse events
+void App::handleEvent(const SDL_Event& event) {
+ if (dropPenMouseEvent(event)) return; // pen side buttons are mapped in Tablet.cpp, not left to SDL
+ if (strayMouseMotion(event)) return; // neither the canvas nor the UI follows a driver's stray mouse events
+ SDL_Event e = event;
+ mapPenPosition(e); // a tablet in mouse mode moves the cursor relatively (#54), for the canvas and the UI
+ if (radialMouseEvent(e)) return; // clicks on an open radial menu, and the buttons that open one (RadialMenu.cpp)
ImGui_ImplSDL3_ProcessEvent(&e);
const ImGuiIO& io = ImGui::GetIO();
@@@ -1109,8 -1086,8 +1113,9 @@@
onKey(e.key.key, e.key.mod);
break;
case SDL_EVENT_KEY_UP:
+ if (e.key.key == SDLK_SPACE) spaceHeld_ = false;
if (e.key.key == SDLK_SPACE) quickMenuKeyUp(); // a held Space closes the QuickMenu when let go
+ radialKeyUp(e.key.key); // a radial menu's held key: run the slot pointed at
break;
case SDL_EVENT_DROP_FILE:
if (e.drop.data) openPathConfirmed(e.drop.data);
diff --cc src/app/UiTest.cpp
index 6ec9dcde,542fd29c..6ff4529e
--- a/src/app/UiTest.cpp
+++ b/src/app/UiTest.cpp
@@@ -114,7 -108,9 +118,9 @@@
// 2 DragDot, 3 Spray, 4 LazyMouse), vdms (VDM brush maps), vdm_files (.sfvdm in the library)
// z_intensity, smooth_intensity, rgb_intensity (0-100), focal_shift (-100..100), draw_size,
// size_popup_open (the S / U / I / O slider), size_knob_x / size_knob_y (its knob, pixels),
- // quickmenu_open, right_click_menu, space_camera, space_held, lazy_mouse, input_style (0 ZBrush, 1 SculptForge, 2 Blender), turntable,
-// quickmenu_open, right_click_menu, radial_open / radial_menu (-1 none) / radial_held /
++// quickmenu_open, right_click_menu, space_camera, space_held, radial_open / radial_menu (-1 none) / radial_held /
+ // radial_hover / radial_ran (radial menus: open, the menu, held by its key or button, the
+ // slot pointed at, the slot run last), radial_menus, radial_slots_N, lazy_mouse, input_style (0 ZBrush, 1 SculptForge, 2 Blender), turntable,
// camera_ortho, mask_brush (Blender's Mask brush on), shortcut_conflicts (keys two actions
// claim), brush_type (BrushType
// index, -1 for a custom brush or Paint), last_dab_x / last_dab_y (window pixels), paint_r
@@@ -417,8 -410,16 +423,18 @@@ double Demo::query(const std::string& n
if (name == "draw_size") return std::round(app_.radiusPx_);
if (name == "quickmenu_open") return app_.quickMenu_.open ? 1.0 : 0.0;
if (name == "right_click_menu") return app_.uiPrefs_.rightClickQuickMenu ? 1.0 : 0.0;
+ if (name == "space_camera") return app_.uiPrefs_.spaceCamera ? 1.0 : 0.0;
+ if (name == "space_held") return app_.spaceHeld_ ? 1.0 : 0.0;
+ if (name == "radial_open") return app_.radial_.menu >= 0 ? 1.0 : 0.0;
+ if (name == "radial_menu") return double(app_.radial_.menu); // -1: none open
+ if (name == "radial_held") return app_.radial_.menu >= 0 && app_.radial_.hold != App::RadialHold::None ? 1.0 : 0.0;
+ if (name == "radial_hover") return double(app_.radial_.hover);
+ if (name == "radial_ran") return double(app_.radial_.ran); // the slot run last, -1: none yet
+ if (name == "radial_menus") return double(app_.radialMenus_.size());
+ if (name.rfind("radial_slots_", 0) == 0) { // radial_slots_N: menu N's items (1-based), -1: no such menu
+ const size_t i = size_t(std::max(0, std::atoi(name.c_str() + 13) - 1));
+ return i < app_.radialMenus_.size() ? double(app_.radialMenus_[i].slots.size()) : -1.0;
+ }
if (name == "size_popup_open" || name == "size_knob_x" || name == "size_knob_y") {
ImVec2 knob(-1.0f, -1.0f);
const bool open = PickerUi::sliderKnob(knob);
@@@ -1174,19 -1153,26 +1190,39 @@@ bool Demo::parseStep(int line, const st
if (file.is_relative()) file = std::filesystem::path(std::u8string(scriptDir_.begin(), scriptDir_.end())) / file;
const auto u8 = file.lexically_normal().u8string();
run([this, path = std::string(u8.begin(), u8.end())] { app_.openPathConfirmed(path); });
+ } else if (verb == "choose_file") { // choose_file insert|append <path>: what a native file dialog would answer
+ if (!need(2)) return false;
+ App::FileAction action;
+ if (w[1] == "insert") action = App::FileAction::InsertMesh;
+ else if (w[1] == "append") action = App::FileAction::AppendSubtool;
+ else {
+ error = "'choose_file' takes insert or append";
+ return false;
+ }
+ auto file = std::filesystem::path(std::u8string(w[2].begin(), w[2].end()));
+ if (file.is_relative()) file = std::filesystem::path(std::u8string(scriptDir_.begin(), scriptDir_.end())) / file;
+ const auto u8 = file.lexically_normal().u8string();
+ run([this, action, path = std::string(u8.begin(), u8.end())] { app_.queueFile(action, path); });
+ } else if (verb == "radial_import" || verb == "radial_export") {
+ // radial_import FILE (relative to the script) / radial_export N FILE (in the shots folder): what the file
+ // dialogs of Preferences > Input > Radial Menus do with the path the user picked.
+ const bool import = verb == "radial_import";
+ if (!need(import ? 1 : 2)) return false;
+ const std::string name = w[import ? 1 : 2];
+ run([this, line, import, name, menu = int(num(1, 1)) - 1] {
+ auto file = std::filesystem::path(std::u8string(name.begin(), name.end()));
+ if (file.is_relative()) { // an import reads what radial_export wrote, or else a file beside the script
+ const auto out = std::filesystem::path(std::u8string(shotDir_.begin(), shotDir_.end())) / file;
+ std::error_code ec;
+ file = !import || std::filesystem::exists(out, ec)
+ ? out
+ : std::filesystem::path(std::u8string(scriptDir_.begin(), scriptDir_.end())) / file;
+ }
+ const auto u8 = file.lexically_normal().u8string();
+ const std::string path(u8.begin(), u8.end());
+ const bool ok = import ? app_.importRadialMenu(path) : app_.exportRadialMenu(menu, path);
+ if (!ok) fail(line, std::string(import ? "radial_import" : "radial_export") + " failed: " + app_.status_);
+ });
} else if (verb == "copy") {
if (!need(2)) return false;
namespace fs = std::filesystem;