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.
C++ 3d3d-sculptingcppdear-imguidigital-sculptingfbxgame-developmentgaussian-splattinggltfimage-to-3dmcpopenglopenusdsculptingtext-to-3dunreal-engine
Merge remote-tracking branch 'origin/feat/piemenu' into feat/inbox2
islandmed2e7027af98e6
diff --cc CHANGELOG.mdindex 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-01diff --cc docs/guide/interface.mdindex 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-mstyle, **Emulate Numpad** makes the number row work as the numpad, and **Import Blender keymap...** takes the keysfrom a keymap you exported in Blender. **Right click opens the QuickMenu** (on by default, in every style) opensthe [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.mdindex 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 WindowsInk, macOS and Linux are indiff --cc src/app/App.cppindex 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 atbreak;case SDL_EVENT_DROP_FILE:if (e.drop.data) openPathConfirmed(e.drop.data);diff --cc src/app/UiTest.cppindex 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& nif (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 stif (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;