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 fix/ui-scale-dpi (0.10.9, #87)
islandmed12a58a1e500e
diff --cc CHANGELOG.mdindex fd82b9ee,016ae5fb..677ff60a--- a/CHANGELOG.md+++ b/CHANGELOG.md@@@ -6,121 -6,11 +6,125 @@@ All notable changes to SculptForge are## [Unreleased]+### Added+- Alpha options in the Alpha palette (#76, requested by rodrigomoretto): **Follow stroke direction** turns the alpha+ along the stroke with Blender's Rake smoothing (the direction is taken again every 20 pixels), **Angle** and **Angle+ jitter** turn it by a fixed or a random amount per dab, and **Tile across / down** repeat it 1 to 8 times inside+ the brush. They work with custom and Community brushes, are kept per brush, and the preview shows the tiling.+ Scripts: `brush_alpha_options`.+- **View > Lock camera** (Shift+L, the same switch as Preferences > Input > Start strokes off the model) and a+ **CAMERA LOCKED** chip in the status bar while it is on (#62 follow-up).+- Blender style: **Preferences > Input > Emulate 3 Button Mouse** (off by default): Alt+left-drag turns the view+ everywhere, as before.+- Each brush keeps its own settings (#78, requested by dCo3lh0 and on Discord): Draw Size, Z Intensity, Falloff, RGB+ Intensity, the stroke (with Spray's scatter and Lazy Stroke's radius) and the alpha follow the brush, custom and+ Community brushes included. Switching back brings back the values that brush had this session; a brush not used yet+ starts from the current values. **Brush > Save Brush Settings** keeps them for every start (`brush-settings.json`+ in the user data folder), **Brush > Reset Brush to Default** restores the shipped values, and **Preferences >+ Input > Share size and intensity across brushes** (off by default) keeps Draw Size and Z Intensity shared as before.+- **Gizmo size** (Draw > Camera): the corner axes come in Small, Medium (as before, the default) and Large, on top+ of the UI scale; clicking an end still snaps to that side at every size. Saved in the preferences.+- **View Figure** (Draw > Camera, beside Axes, off by default): a small shaded head in the canvas corner that turns+ with the camera; click it to snap to the nearest side view. Requested on Discord.+- Starter meshes (Discord #ideas): a human head with eye and mouth loops, a bust, a full body in A-pose, a hand, a+ foot, an ear, an eye, a stylised head, a creature head blockout (skull, jaw and horns as Parts), a torso, and+ bevelled rounded box, cylinder, capsule and ring primitives. All quads, centimetres, centred, standing on the+ ground and symmetric where they should be; they open with subdivision levels over a small base cage (the whole+ set adds 0.8 MB). **File > New from Starter Mesh**, a **Starter meshes** folder with thumbnails in Library > Tool,+ **Start from a head** in the welcome, and `new_starter_mesh` for scripts. The human meshes are cut from the+ MakeHuman base mesh (CC0); the rest are generated by `tools/starter/build_starter_meshes.py`+ (docs/starter-meshes.md).+- "Your first sculpt in 10 minutes" (docs/guide/first-sculpt.md): a twelve-step lesson for complete beginners that+ turns the default sphere into a mushroom house: masked Move strokes for the walls and an overhanging cap, colour+ filled through the mask, Divide twice, a door and framed windows carved with Crease and Clay, raised spots+ painted with a hard-edged Paint brush, PBR shading and a saved render. The welcome has a big **Start the 10-minute+ lesson** button, and **Help > Your first sculpt (10 min)** opens it. Its screenshots come from+ tests/ui/first_sculpt.sfui, which ctest runs so the lesson keeps working. The website links it from the homepage+ and the guide index.+- **Render > Materials > Save Render**: the view without the interface at twice its size, saved as a PNG in the+ library's Images folder (Library > Image).+- Upstream watch for studios: a weekly check of OpenUSD, MaterialX, OpenColorIO, OpenEXR, OpenVDB, OpenSubdiv,+ OpenTimelineIO, OpenAssetIO, the VFX Reference Platform, Blender, Unreal Engine, Godot, SDL3, Dear ImGui and Python+ opens a tracking issue for each new release, plus a monthly "Upstream digest" (targets in `packaging/upstream.json`).+- Insider daily drops: almost every day a new alpha, brush, VDM or Kelvinlet preset, made by SculptForge's own+ procedural tools and checked on a test sculpt (too faint, seams, torn surfaces and near-duplicates are left out),+ posted to Insiders as an .sfpack. Supporters get the month's drops as one Insider Pack at month end, and everyone+ gets that pack free three months later (`tools/drops/`, `.github/workflows/insider-drop.yml`).+- Focus Detail (experimental, off by default): a billion-micro-triangle asset streamed from one compressed file.+ Detail loads in under and ahead of the brush and wherever the camera would show it; everything else shows a+ coarse version. Saving writes only the changed tiles. Try `sculptforge --benchmark standard-1b` or+ `sculptforge --focus-detail FILE.sfdetail`; design and numbers in docs/design/focus-detail.md.+- Precision work (guide: Sculpting > Precision work). **Steady Stroke** (<kbd>L</kbd>) now works with every stroke+ type (Dots, Drag Stamp, Slide Stamp, Spray), with **Catch up on release** (finish the line to the cursor) and the+ string drawn to the lagging brush; the Lazy Stroke type is Dots with it on. **World Size** (Draw palette) keeps+ Draw Size in model units, so the brush stays the same size on the surface as you zoom; every Draw Size slider+ and the cursor show px and mm. Draw Size goes down to 0.5 px; <kbd>Shift</kbd>+<kbd>[</kbd> /+ <kbd>Shift</kbd>+<kbd>]</kbd> step 1 px, <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+right-drag scrubs the size finely,+ and small brushes space their dabs closer so tiny strokes stay continuous. **Precision drag**: hold+ <kbd>Shift</kbd>+<kbd>Alt</kbd> while drawing and the brush moves at a quarter of the pen's speed, at+ **Precision Intensity**. **A pressure curve per brush**: 2 to 5 points with Soft, Linear, Firm and Fine detail+ presets, in Brush Lab and Preferences > Tablet.++### Changed+- What's New is a window now: after an update (and from **Help > What's New**) a centred card shows the version's main+ features, each with a picture, one line and a **Try it** button that opens it (switch the look, open the membership+ card, select the brush, open the benchmark...), plus the full release notes, the Discord and Close. It takes the+ look's colours, fades in, follows the UI scale and works from the keyboard (Esc, Tab, Enter). The guide chapter and+ the website page show the last three versions in full (a band with the date, the feature cards, "All changes"+ folded) and the older ones as short groups (0.10.1 to 0.10.5, 0.9.x, 0.8 and earlier); the contents list follows.+ The data is a ```features block per version in docs/guide/whats-new.md, read by the app and build_site.py alike.+- Image and text to 3D work out of the box with no token: the free Hugging Face default is now **Hunyuan3D 2.1**,+ for new installs and for everyone who never picked a model (an explicit choice is kept; a saved TRELLIS.2 is+ kept when a token is saved too). TRELLIS.2 shows as "Best detail (needs token)".+- TRELLIS.2 without a Hugging Face token no longer fails: Hunyuan3D 2.1 runs instead and the status line says+ "TRELLIS.2 needs a free Hugging Face token (Preferences > AI); used Hunyuan3D 2.1 instead." The token can now be+ set in the new **Preferences > AI** too.+- Generated models get **Quad Remesh** by default instead of voxel remesh: clean quads (about resolution² / 2, 32768+ at the default 256) with one subdivision level projected onto the model, ready to sculpt and subdivide. A voxel+ pass cleans up holes and overlapping pieces first. It runs in the background with the progress bar (about 20 s+ for a typical Hunyuan3D model). **Remesh** in Generate 3D also offers Voxel remesh and Off; the CLI takes+ `remesh=quad|voxel|false` (`true` means quad) and `levels=0-2`. The status line says "remeshed to N quads".+- The Hunyuan3D licence notice (the Tencent Hunyuan Community License doesn't cover use in the EU, UK or South+ Korea) is shown once, the first time a Hunyuan3D model runs, and stays in the Model picker's tooltip.+- Hover highlights that pop, in every look: buttons, menu items, shelf buttons and palette headers ease into an+ accent-tinted fill with a crisp accent border and a brighter label in about 100 ms (Forge Terminal: the accent+ border; Phosphor: an inverse-video glow; Blueprint: a cyan line glow; Classic: a subtle warm highlight), and+ pressed is a touch darker. Brush, alpha, material and look tiles (shelves, pickers, Library) lift slightly with a+ soft shadow and an accent glow ring, without moving anything; the active tile keeps its orange outline. Sliders+ brighten, grow a knob and show their exact value. The keyboard focus gets the same ring. New **Preferences >+ Interface > Reduce motion**: colour changes only, no easing or lifting. Animations draw frames only while they run.+- Hover highlights that pop, in every look: buttons, menu items, shelf buttons and palette headers ease into an+ accent-tinted fill with a crisp accent border and a brighter label in about 100 ms (Forge Terminal: the accent+ border; Phosphor: an inverse-video glow; Blueprint: a cyan line glow; Classic: a subtle warm highlight), and+ pressed is a touch darker. Brush, alpha, material and look tiles (shelves, pickers, Library) lift slightly with a+ soft shadow and an accent glow ring, without moving anything; the active tile keeps its orange outline. Sliders+ brighten, grow a knob and show their exact value. The keyboard focus gets the same ring. New **Preferences >+ Interface > Reduce motion**: colour changes only, no easing or lifting. Animations draw frames only while they run.+### Fixed+- Blender style: Alt+left-drag on the model masks and Ctrl+Alt+left-drag unmasks, as Blender 5.1+'s default+ sculpt keymap does, instead of turning the view (#77, reported by TheRedWaxPolice). Beside the model Alt+drag still+ turns the view, and Alt+Shift+drag pans anywhere. Shift+F (Strength) sets the brush's Intensity instead of Smooth's.+- UI test runs remove their temporary settings folder when they pass (thousands of runs had filled `/tmp`).+- Tablets (a Wacom Intuos 3 report): a tablet plugged in after launch works without a restart ("Tablet connected" /+ "Tablet disconnected" in the status bar), also through Wacom Bridge; on Windows, pressure now also comes from the+ Wacom driver with "Use Windows Ink" off (Wintab); a pen without pressure draws at full strength instead of not at+ all, and Preferences > Input and > Tablet say "Pressure: on" or "not detected" with a troubleshooting link. The+ view no longer jumps when the pen comes back into range elsewhere or leaves mid-drag. The active Part changes only+ with the keyboard's Alt and a quick click (not with a pen button set to Alt, a long pen press or quick pen taps),+ and the status bar says "Active Part: <name> (Alt+click)".+- The enlarged brush or alpha thumbnail you point at in a picker is drawn over its neighbours again, not+ under them (#86, thanks tristratos).+- The enlarged brush or alpha thumbnail you point at in a picker is drawn over its neighbours again, not+ under them (#86, thanks tristratos).+- The brush centre now sits exactly under the cursor at high zoom and on HiDPI screens: the brush's ray is worked+ out from the camera directly, and the view is drawn on whole pixels where the rays are cast (it could be up to+ half a pixel off). The surface point under the brush is lightly filtered, so strokes on dense meshes no longer+ wobble.+ - Preferences > Interface > UI scale applies at once: text, controls and panels resize live, no restart (#87).+ Before, the choice waited for the next start and was lost unless Store Config saved it. Automatic now follows+ the monitor the window is on: on Windows (per-monitor DPI v2, now declared in the app's manifest) dragging the+ window between a 100 % and a 150 % monitor, or changing Settings > Display > Scale, rescales the UI right away.## [0.10.8] - 2026-11-02diff --cc docs/guide/interface.mdindex 47b6145d,0d970322..2f26d5e6--- a/docs/guide/interface.md+++ b/docs/guide/interface.md@@@ -503,22 -490,11 +503,27 @@@ Quad Remesh, Forge Spheres, Library, LiEnglish name. Anything not translated yet (most Ctrl-help descriptions, this guide) shows in English. Scripts and`sculptforge-cli` commands are the same in every language.+ **UI scale** also applies at once: text, buttons, shelves and trays resize on the next frame; Store Config keeps it.+ **Automatic** uses the scale of the monitor the window is on (Windows: **Settings > Display > Scale**; macOS and+ Wayland: the display's scaling; X11: the desktop's font DPI). Drag the window to a monitor at another scale, or+ change the system setting, and the interface follows. A chosen size (100% to 200%) stays the same on every monitor.++**Preferences > Cursor**:++| Setting | Default | What it does |+|---|---|---|+| **Viewport cursor** | Crosshair | The pointer over the 3D view: a crosshair, or the arrow (#73). The crosshair stays while the view turns, pans or zooms. Panels, menus and popups always show the arrow |+| **Cursor follows surface** | On | The brush ring lies on the model: a true circle at the brush's real size, in the plane of the surface (averaged over the brush, so bumps don't bend it), with a short line along the surface's direction. Symmetry and radial copies show as dots where their dabs land. Off: a flat ring on the screen |+| **Hide ring while stroking** | Off | While a stroke runs, only the dot where the brush touches (and the symmetry dots) shows, not the ring |++**Preferences > Hints**: **Show hints in the viewport** (on) and one box per hint (Strokes start off the model,+Previewing an LOD, Face landmark steps). Each hint over the 3D view also has its own **Don't show again**; **Show+all hints again** brings them all back. Store Config keeps them.++**Scrolling panels with a pen**: on small screens a palette or tray that doesn't fit scrolls with the mouse wheel,+and also with a **left-drag on empty space** in it (between and beside the controls) or a **middle-drag anywhere**+on it, as you would scroll a list with a finger (#100).+**Preferences > Input** sets the key **Style** (the first start sets it from your **Coming from** answer):**SculptForge** (the default for new installs): <kbd>1</kbd> to <kbd>9</kbd> and <kbd>0</kbd> pick the first tenbrushes, <kbd>I</kbd> opens Intensity like <kbd>U</kbd>, and <kbd>Ctrl</kbd>+drag on the background zooms whendiff --cc docs/guide/whats-new.mdindex 73232f5a,6d2ff93f..2e4e5495--- a/docs/guide/whats-new.md+++ b/docs/guide/whats-new.md@@@ -7,97 -7,9 +7,100 @@@ three versions in full, then the older## Version 0.10.9+```features+date: unreleased+tagline: Your first sculpt in ten minutes, starter meshes, brushes that keep their settings, and tablets that just work.+highlight: Your first sculpt in 10 minutes: a beginner lesson from sphere to a rendered mushroom house+highlight: Starter meshes: heads, a body, hands and clean primitives, all quads with levels ready+highlight: Each brush keeps its own size, intensity, stroke and alpha+highlight: Tablets: plug in while running, pressure with or without Windows Ink, no camera jumps+title: Your first sculpt+line: A 12-step lesson that turns the default sphere into a painted, rendered mushroom house.+image: images/wn-first-sculpt.jpg+action: help.first_sculpt+link: first-sculpt.md+title: Starter meshes+line: Start from a head, bust, body, hand or clean primitive, all quads at life size.+image: images/wn-starter-meshes.jpg+action: file.new_starter+link: projects.md#start-from-a-starter-mesh+title: Brushes keep their settings+line: Size, intensity, falloff, stroke and alpha follow each brush; Save Brush Settings keeps them.+image: images/wn-brush-settings.jpg+action: brush:Clay+link: sculpting.md#each-brush-keeps-its-own-settings+title: What's New, redesigned+line: The main features as cards with a Try it button; older versions fold into short groups.+image: images/wn-whats-new.jpg+action: guide:whats-new.md+```++- **Each brush keeps its own settings**: Draw Size, Intensity, Falloff, RGB Intensity, stroke and alpha follow+ the brush, custom and Community brushes included. **Brush > Save Brush Settings** keeps them for the next start,+ **Reset Brush to Default** puts back the shipped values, and **Preferences > Input > Share size and intensity+ across brushes** keeps the old way (#78). See [Sculpting](sculpting.md#each-brush-keeps-its-own-settings).+- **Alpha options** (**Alpha** palette): **Follow stroke direction** turns the alpha along the stroke, smoothed as+ Blender's Rake does; **Angle** and **Angle jitter** turn it by a fixed or a random amount; **Tile** repeats it+ inside the brush. They work with custom and Community brushes too, and each brush keeps its own (#76). See+ [Alpha options](sculpting.md#alpha-options).+- **Blender style: Alt+drag masks** on the model and Ctrl+Alt+drag unmasks, as in Blender 5.1 and later; beside the+ model Alt+drag still turns the view. **Preferences > Input > Emulate 3 Button Mouse** makes Alt+drag turn the view+ everywhere. Shift+F now sets the brush's Intensity, not Smooth's (#77).+- **View > Lock camera** (<kbd>Shift</kbd>+<kbd>L</kbd>): drags that start beside the model sculpt instead of+ turning the view, and the status bar shows **CAMERA LOCKED** while it is on (#62).+- **Tablets**: plug a tablet in while SculptForge runs and it just works ("Tablet connected" in the status bar),+ also through Wacom Bridge. On Windows, pressure works with the Wacom driver's **Use Windows Ink** on or off.+ **Preferences > Input** shows whether pressure is detected, with a troubleshooting link. The view no longer jumps+ when the pen comes back into range, and the active Part changes only with **Alt+click** on the keyboard; the+ status bar names the new Part. See [Troubleshooting](troubleshooting.md#pen-tablets).+- **Smaller (or larger) corner axes**: **Draw > Camera > Gizmo size** sets Small, Medium or Large+ ([Navigation](navigation.md)).+- **View Figure**: turn it on beside **Axes** for a small head in the corner that turns with the view; click it to+ snap to the nearest side.+- **Starter meshes**: start a sculpt from a human head with eye and mouth loops, a bust, a full body in A-pose, a+ hand, a foot, an ear, an eye, a stylised head, a creature head, a torso, or a bevelled box, cylinder, capsule or+ ring, all clean quads at life size with subdivision levels ready. **File > New from Starter Mesh**, the Library's+ **Tool > Starter meshes**, or **Start from a head** in the welcome. See+ [Projects](projects.md#start-from-a-starter-mesh).+- **Your first sculpt in 10 minutes**: a step-by-step lesson for people who have never sculpted. Turn the+ default sphere into a little mushroom house with a spotted red cap, a door and glowing windows, using masks,+ Move, Inflate, Crease and Clay, Vertex Paint and PBR shading, and save a render to share. Start it from the+ welcome's **Start the 10-minute lesson** button or **Help > Your first sculpt (10 min)**. See+ [Your first sculpt](first-sculpt.md).+- **Save Render** (**Render > Materials**): the view without the interface, at twice its size, as a PNG in your+ Library (**Library > Image**).++- **A new What's New**: after an update, a window shows the main features as cards with a picture, one line and a+ **Try it** button that opens the feature (switch the look, select the brush, open the membership card...).+ **Help > What's New** opens it again; <kbd>Esc</kbd> closes it. This chapter shows the last three versions in+ full and folds the older ones into short groups, on the website too.+- **Image to 3D with no setup**: the free default is now Hunyuan3D 2.1, which needs no token. TRELLIS.2 ("Best+ detail") still needs a free Hugging Face token (**Preferences > AI**); without one, Hunyuan3D 2.1 runs instead+ and the status line tells you. Your own model choice is kept. See [Image and text to 3D](generate-3d.md).+- **Generated models arrive as clean quads**: Quad Remesh is now the default, with one subdivision level holding+ the detail, so you can sculpt and subdivide straight away. Voxel remesh and Off are still in **Remesh**.+- **Hover highlights that pop**: buttons, menus and shelves light up in your look's accent as you point at them,+ tiles lift a little, sliders show their exact value, and the keyboard focus gets the same ring. Prefer less+ movement? Turn on **Preferences > Interface > Reduce motion** ([Interface](interface.md)).+- **Picker thumbnails on top**: the enlarged thumbnail you point at in a picker is no longer hidden under its+ neighbours (#86).+- **Hover highlights that pop**: buttons, menus and shelves light up in your look's accent as you point at them,+ tiles lift a little, sliders show their exact value, and the keyboard focus gets the same ring. Prefer less+ movement? Turn on **Preferences > Interface > Reduce motion** ([Interface](interface.md)).+- **Picker thumbnails on top**: the enlarged thumbnail you point at in a picker is no longer hidden under its+ neighbours (#86).+- **Focus Detail (experimental)**: sculpt a head of a billion micro triangles from one compressed file. Detail+ loads where you look and where the brush is heading, and the rest shows a lighter version. Saving writes only+ what you changed. Try it with `sculptforge --benchmark standard-1b` (Linux and macOS for now).+- **Precision work** for pores, wrinkles, jewellery and trims: **Steady Stroke** (<kbd>L</kbd>) with every stroke+ type and a catch-up on release; **World Size**, so the brush keeps its size in mm on the surface as you zoom;+ Draw Size down to 0.5 px with <kbd>Shift</kbd>+<kbd>[</kbd> / <kbd>]</kbd> for 1 px steps; hold+ <kbd>Shift</kbd>+<kbd>Alt</kbd> while drawing to move the brush at a quarter of the pen's speed; and a pressure+ curve for each brush with a **Fine detail** preset. The brush centre now sits exactly under the cursor at any+ zoom. See [Precision work](sculpting.md#precision-work).+ - **UI scale works live**: **Preferences > Interface > UI scale** (100% to 200%) resizes text and panels at once,+ no restart. **Automatic** follows the monitor the window is on, so on Windows moving it between a 100% and a+ 150% monitor rescales it right away (#87). See [The interface](interface.md#interface-preferences).## Version 0.10.8diff --cc src/app/UiTest.cppindex 899a18d4,9059a619..18fa3154--- a/src/app/UiTest.cpp+++ b/src/app/UiTest.cpp@@@ -735,10 -665,16 +739,19 @@@ double Demo::query(const std::string& n// fractions of the canvas height from its top (-1: the strip isn't shown).if (name == "timeline_top") return app_.uiPrefs_.timelineTop ? 1.0 : 0.0;// The style's minimum window height in unscaled px (32): switching looks must not scale it again each time.+ if (name == "ui_scale") return std::round(double(app_.uiScale_) * 100.0); // percent, as built now (#87)+ if (name == "font_height") { // the default UI font's size in pixels, as rasterised in the atlas+ const ImGuiIO& io = ImGui::GetIO();+ const ImFont* f = io.FontDefault ? io.FontDefault : io.Fonts->Fonts.empty() ? nullptr : io.Fonts->Fonts[0];+ return f ? double(f->FontSize) : 0.0;+ }+ if (name == "frame_height") return double(ImGui::GetFrameHeight()); // a button's height: font + style padding+ if (name == "panel_width") return double(app_.shell_.rightShelf.w); // the right shelf, 52 logical px+ if (name == "title_height") return double(app_.shell_.title.h);if (name == "style_window_min") return double(ImGui::GetStyle().WindowMinSize.y / std::max(app_.uiScale_, 0.01f));+ // Draw > Camera > Gizmo size and View Figure: the axes' length in unscaled px (34 at Medium), the figure shown.+ if (name == "axis_gizmo_length") return double(34.0f * app_.axisGizmoUnit() / std::max(app_.uiScale_, 0.01f));+ if (name == "view_figure") return app_.uiPrefs_.showViewFigure ? 1.0 : 0.0;if (name == "timeline_y" || name == "axis_gizmo_y") {const auto c = app_.canvasRect();if (name == "timeline_y")