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 fix/ui-scale-dpi (0.10.9, #87)

islandmed12a58a1e500e
diff --cc CHANGELOG.md
index 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-02
diff --cc docs/guide/interface.md
index 47b6145d,0d970322..2f26d5e6
--- a/docs/guide/interface.md
+++ b/docs/guide/interface.md
@@@ -503,22 -490,11 +503,27 @@@ Quad Remesh, Forge Spheres, Library, Li
English 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 ten
brushes, <kbd>I</kbd> opens Intensity like <kbd>U</kbd>, and <kbd>Ctrl</kbd>+drag on the background zooms when
diff --cc docs/guide/whats-new.md
index 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.8
diff --cc src/app/UiTest.cpp
index 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")