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 perf/bigbrush-p99 (0.10.9): big-brush p99 spikes

islandmededd798eacfa3
diff --cc CHANGELOG.md
index bd7a3646,87d2f2fb..6b70b9cd
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@@ -6,154 -6,29 +6,174 @@@ 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.
+- 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. The rings follow **Outlines** (Off: the fill and label only; Subtle, the default: one faint line; On: the
+ look's full flavour) and **Outline opacity**. Animations draw frames only while they run.
+ - Large brushes on dense meshes no longer stall the view: from 2 million vertices a stroke's dabs are placed on the
+ stroke thread (the same dabs, in the same order, as the frame loop places them; no preview), so a frame keeps
+ drawing while a 240 px dab moves millions of vertices, and a light batch is still waited for within the frame.
+ On the standard scene's 240 px brush the slowest frames drop from 139 ms (15M) and 306 ms (33M) to about 30 ms in
+ first runs, and lifting the pen no longer waits (162 ms at 33M). `SF_BACKGROUND_DABS=0` turns it off.
+ - Move on dense meshes no longer stalls: it worked out its whole region's normals and bounds again for every pointer
+ sample (several times a frame with a 240 Hz pen, more the slower the frame got: seconds at 33M under load). The
+ positions still follow every sample; the normals and bounds now follow once a frame, and the mesh comes out the
+ same, bit for bit.
+ - The first orbit after a long stroke no longer stalls (180-300 ms at 33M): the moving view's lighter stand-ins for
+ the changed areas are rebuilt a few milliseconds a frame, the rest drawn in full detail until then.
### 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.
+- The pen picks a brush, then stops clicking the panels and the canvas until the mouse is used (#95; Huion Kamvas,
+ display tablets, Wacom with Windows Ink on or off): SDL 3.2 keeps one "a pen is touching" flag for all pens, and
+ once Windows took a pen away while it touched (a drag capturing the mouse), it made no mouse events for any pen
+ again. SculptForge now makes the pen tip's mouse events from the pen's own and ignores SDL's, lets go of the
+ button whenever the pen leaves, and ignores the mouse presses some drivers (Huion) send beside the pen's, whose
+ release may never come. A replay test covers Windows Ink, a Huion-style pen + mouse stream, SDL's stuck state and
+ Wintab-style input.
+- Tablet Mouse mode (#72, 0.10.8): it followed the system cursor, which with the tablet driver in pen mode is where
+ the pen is, so it felt the same as Pen mode. Now only the pen's movement moves the cursor, with no jump when the
+ pen comes back elsewhere, and while the pen is in range the arrow is drawn at the brush (the system's, at the
+ pen's place on the tablet, is hidden), so arrow, brush and clicks agree.
+- With two screens, moving the pointer to the other screen made SculptForge draw as if it were in the background
+ until the pointer came back (Windows 11). It now keeps drawing after any input while its window has focus,
+ wherever the pointer is, and rests only when it loses focus.
+- Turn AI off: **Preferences > AI > Enable AI features** (also asked in the first-run welcome). Off hides AI Brush,
+ Generate 3D and their menu, shelf and command palette entries, removes the AI commands from scripts, the CLI and
+ the MCP tool list, and stops every AI network call; the MCP server and the offline Relief / Inflate / Stamp stay.
+ Saved at once. Studios: `SF_AI=off` (or `--no-ai`) turns it off and locks it. About and the website now say:
+ "Your art is never uploaded or used for training. AI features run only when you use them and can be turned off."
+- The enlarged brush or alpha thumbnail you point at in a picker is drawn over its neighbours again, not
+ under them (#86, thanks tristratos).
+ - Help > Benchmark (and `--benchmark`) checks the memory free now before each scene instead of trusting the
+ computer's total: a scene that doesn't fit (15M needs about 2.2 GB free, 33M about 5 GB, plus a margin) is skipped
+ with a clear message ("33M skipped: needs ~5 GB free, 1.3 GB available. Close other apps and run again") rather
+ than running the system out of memory. The result lists skipped scenes; the command line exits with code 2.
+ - Subdivide, Divide, Divide to a micro level and Voxel Remesh ask first ("Not enough free memory", Continue anyway or
+ Cancel) when the mesh they would build doesn't fit the memory free now.
+ - Runs started by scripts and agents (`SDL_APP_ID=sculptforge-agent`, or `SF_ISOLATE=1`) use their own settings and
+ log folder for every mode (renders, `--bench`, `--calibrate` too), so they no longer write into your
+ sculptforge.log or move your session's log aside. Isolated runs remove their temporary folder when they pass.
## [0.10.8] - 2026-11-02
diff --cc docs/guide/whats-new.md
index 3d79b351,f80ce842..1cd74ff9
--- a/docs/guide/whats-new.md
+++ b/docs/guide/whats-new.md
@@@ -7,115 -7,15 +7,124 @@@ 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).
+- **The pen keeps working the panels**: with some tablets (Huion, pen displays, Wacom with Windows Ink on or off)
+ the pen picked one brush, then stopped clicking menus and the canvas until you used the mouse. SculptForge now
+ makes the pen's clicks itself (#95). See [Troubleshooting](troubleshooting.md#pen-tablets).
+- **Mouse mode is relative again**: with **Mouse mode** on (Preferences > Tablet) the pen moves the cursor by how
+ far it moves, whatever the driver's mode, and the arrow is drawn right at the brush (#72).
+- **Two screens**: SculptForge no longer slows down when the pointer is on your other screen; it rests only when
+ its window loses focus.
+- **Turn AI off**: **Preferences > AI > Enable AI features** (the welcome asks too). Off hides AI Brush and
+ Generate 3D everywhere and SculptForge makes no AI network calls. Your art is never uploaded or used for training. AI features run only when you use them and can be turned off. Studios can set `SF_AI=off`.
+ See [The interface](interface.md#turning-ai-off).
+- **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).
+ - **Big brushes stay smooth on dense meshes**: on models from about 4 million triangles a stroke's dabs are worked
+ out beside the view, so a 240 px brush on 33 million triangles no longer freezes the view for a third of a
+ second at a time (slowest frames about 35 ms instead of 300), and letting go of the pen is instant. The stroke
+ itself comes out the same.
+ - **Move keeps up on dense meshes**: Move no longer slows to a crawl on 33 million triangles with a fast pen, and the
+ first orbit after a long stroke no longer hitches.
+ - **No more running out of memory**: **Help > Benchmark** skips a scene your computer hasn't got the free memory
+ for (and says how much to free), and Subdivide, Divide, Micro and Voxel Remesh ask first when the result
+ wouldn't fit in the memory free now.
## Version 0.10.8
diff --cc src/app/App.cpp
index 17ddcd4b,26503c9b..8e8477b2
--- a/src/app/App.cpp
+++ b/src/app/App.cpp
@@@ -1057,134 -1124,9 +1057,134 @@@ int App::run()
int(drag_ != Drag::None), int(backgroundBusy()), int(perf_.framesStill < 10));
}
finishProject();
- return 0;
+ return options_.benchmark && proofSkippedScenes() ? 2 : 0; // (--benchmark: a scene skipped for memory)
}
+// The UI scale (Preferences > Interface > UI scale, #87). Automatic follows the window's display: on Windows
+// (per-monitor DPI v2) and with X11's Xft.dpi that is the content scale, and moving the window to a monitor at another
+// scale sends SDL_EVENT_WINDOW_DISPLAY_SCALE_CHANGED. Tests and videos size the UI for their frame instead.
+float App::targetUiScale() const {
+ float automatic = 1.0f;
+ if (displayScaleOverride_ > 0.0f) automatic = displayScaleOverride_; // UI tests: display_scale
+ else if (!options_.recordPath.empty() || !options_.uiTest.empty()) automatic = float(options_.height) / 900.0f;
+ else if (window_) automatic = automaticUiScale(SDL_GetWindowDisplayScale(window_), SDL_GetWindowPixelDensity(window_));
+ return resolveUiScale(uiPrefs_.uiScale, automatic);
+}
+
+// Live, between frames (the atlas can't change inside one): the fonts rasterised again at the new size, the style
+// rebuilt from scratch (applyLook), and the shell lays itself out at uiScale_ on the next frame.
+void App::applyUiScale() {
+ uiScaleDirty_ = false;
+ const float scale = targetUiScale();
+ if (!uiScaleChanged(uiScale_, scale)) return;
+ SDL_Log("UI scale %.0f%%", double(scale * 100.0f));
+ uiScale_ = scale;
+ ImGui::GetIO().Fonts->Clear();
+ buildUiFonts(scale);
+ if (ImGui::GetIO().BackendRendererUserData) ImGui_ImplOpenGL3_DestroyFontsTexture(); // the next NewFrame uploads it
+ applyLook();
+}
+
+void App::requestUiScale() {
+ uiScaleDirty_ = true;
+ redrawIn(0.0);
+}
+
+// Every font the UI uses, rasterised at `scale` for crisp text (Dear ImGui 1.91 has no dynamic font sizes).
+void App::buildUiFonts(float scale) {
+ ImGuiIO& io = ImGui::GetIO();
+ const bool recording = !options_.recordPath.empty() || !options_.uiTest.empty();
+ // Inter (SIL OFL), embedded in the binary. Rasterised at the final size for crisp text.
+ ImFontConfig fontConfig;
+ fontConfig.FontDataOwnedByAtlas = false;
+ fontConfig.OversampleH = 2;
+ fontRegular_ = io.Fonts->AddFontFromMemoryTTF(const_cast<unsigned char*>(assets::fontRegular), int(assets::fontRegular_size),
+ 15.0f * scale, &fontConfig);
+ // Lucide icons (ISC/MIT) merged into the UI font, so ICON_LC_* strings work in any label.
+ {
+ static const ImWchar kIconRanges[] = {ICON_MIN_LC, ICON_MAX_LC, 0};
+ ImFontConfig icons;
+ icons.MergeMode = true;
+ icons.PixelSnapH = true;
+ icons.FontDataOwnedByAtlas = false;
+ icons.GlyphMinAdvanceX = 15.0f * scale;
+ icons.GlyphOffset = ImVec2(0, 2.0f * scale);
+ io.Fonts->AddFontFromMemoryTTF(const_cast<unsigned char*>(assets::fontLucide), int(assets::fontLucide_size),
+ 15.0f * scale, &icons, kIconRanges);
+ }
+ // Shell fonts: 12 px captions and 10 px right-shelf labels (with icons), large shelf icons, SemiBold titles.
+ {
+ auto addIcons = [&](float size) {
+ static const ImWchar kIconRanges[] = {ICON_MIN_LC, ICON_MAX_LC, 0};
+ ImFontConfig icons;
+ icons.MergeMode = true;
+ icons.PixelSnapH = true;
+ icons.FontDataOwnedByAtlas = false;
+ icons.GlyphMinAdvanceX = size * scale;
+ icons.GlyphOffset = ImVec2(0, size * 0.13f * scale);
+ io.Fonts->AddFontFromMemoryTTF(const_cast<unsigned char*>(assets::fontLucide), int(assets::fontLucide_size),
+ size * scale, &icons, kIconRanges);
+ };
+ fontSmall_ = io.Fonts->AddFontFromMemoryTTF(const_cast<unsigned char*>(assets::fontRegular),
+ int(assets::fontRegular_size), 12.0f * scale, &fontConfig);
+ addIcons(12.0f);
+ fontTiny_ = io.Fonts->AddFontFromMemoryTTF(const_cast<unsigned char*>(assets::fontRegular),
+ int(assets::fontRegular_size), 10.5f * scale, &fontConfig);
+ fontBold_ = io.Fonts->AddFontFromMemoryTTF(const_cast<unsigned char*>(assets::fontSemiBold),
+ int(assets::fontSemiBold_size), 15.0f * scale, &fontConfig);
+ addIcons(15.0f);
+ static const ImWchar kIconRanges[] = {ICON_MIN_LC, ICON_MAX_LC, 0};
+ ImFontConfig big;
+ big.PixelSnapH = true;
+ big.FontDataOwnedByAtlas = false;
+ fontIcons_ = io.Fonts->AddFontFromMemoryTTF(const_cast<unsigned char*>(assets::fontLucide), int(assets::fontLucide_size),
+ 20.0f * scale, &big, kIconRanges);
+ }
+ { // JetBrains Mono (SIL OFL) for the looks (Preferences > Interface > Look), with the icons and box drawing.
+ static const ImWchar kMonoRanges[] = {0x0020, 0x00FF, 0x2010, 0x2027, 0x2190, 0x21FF, 0x2500, 0x259F, 0x25A0, 0x25FF, 0};
+ static const ImWchar kIconRanges[] = {ICON_MIN_LC, ICON_MAX_LC, 0};
+ auto addMono = [&](const unsigned char* data, unsigned long long size, float px) {
+ ImFont* f = io.Fonts->AddFontFromMemoryTTF(const_cast<unsigned char*>(data), int(size), px * scale, &fontConfig, kMonoRanges);
+ ImFontConfig icons;
+ icons.MergeMode = true;
+ icons.PixelSnapH = true;
+ icons.FontDataOwnedByAtlas = false;
+ icons.GlyphMinAdvanceX = px * scale;
+ icons.GlyphOffset = ImVec2(0, px * 0.13f * scale);
+ io.Fonts->AddFontFromMemoryTTF(const_cast<unsigned char*>(assets::fontLucide), int(assets::fontLucide_size), px * scale,
+ &icons, kIconRanges);
+ return f;
+ };
+ fontMono_ = addMono(assets::fontMono, assets::fontMono_size, 15.0f);
+ fontMonoSmall_ = addMono(assets::fontMono, assets::fontMono_size, 12.0f);
+ fontMonoTiny_ = addMono(assets::fontMono, assets::fontMono_size, 10.5f);
+ fontMonoBold_ = addMono(assets::fontMonoBold, assets::fontMonoBold_size, 15.0f);
+ fontInterSmall_ = fontSmall_;
+ fontInterTiny_ = fontTiny_;
+ fontInterBold_ = fontBold_;
+ theme::fonts = {fontMono_, fontMonoSmall_, fontMonoBold_};
+ }
+ { // The support card's display sizes (PanelSupportCard.cpp): Latin only, so the atlas grows by a few glyphs.
+ static const ImWchar kCardRanges[] = {0x0020, 0x00FF, 0x2014, 0x2014, 0x2019, 0x2019, 0x2026, 0x2026, 0};
+ fontCardTitle_ = io.Fonts->AddFontFromMemoryTTF(const_cast<unsigned char*>(assets::fontSemiBold),
+ int(assets::fontSemiBold_size), 40.0f * scale, &fontConfig, kCardRanges);
+ fontCardHead_ = io.Fonts->AddFontFromMemoryTTF(const_cast<unsigned char*>(assets::fontSemiBold),
+ int(assets::fontSemiBold_size), 21.0f * scale, &fontConfig, kCardRanges);
+ fontCardBody_ = io.Fonts->AddFontFromMemoryTTF(const_cast<unsigned char*>(assets::fontRegular),
+ int(assets::fontRegular_size), 16.5f * scale, &fontConfig, kCardRanges);
+ }
+ addHelpFonts(scale); // Ctrl-help titles (Inter SemiBold) and the console (ProggyClean)
+ guide_.addFonts(scale); // User Guide headings
+ if (recording) { // the demo captions, sized for the video
+ fontCaption_ = io.Fonts->AddFontFromMemoryTTF(const_cast<unsigned char*>(assets::fontSemiBold),
+ int(assets::fontSemiBold_size), float(options_.height) * 0.042f,
+ &fontConfig);
+ fontCaptionSub_ = io.Fonts->AddFontFromMemoryTTF(const_cast<unsigned char*>(assets::fontRegular),
+ int(assets::fontRegular_size), float(options_.height) * 0.024f,
+ &fontConfig);
+ }
+}
+
// ---------------------------------------------------------------------------
// Input
// ---------------------------------------------------------------------------
@@@ -2530,8 -2378,8 +2558,9 @@@ void App::drawUi()
drawSupportUi(); // the first-run welcome, the one support reminder (PanelSupport.cpp)
guide_.draw(*this); // Help > User Guide
drawPacksUi(); // pack review, New Pack, macro confirmation and editor (PanelPacks.cpp)
+ drawMemoryConfirm(); // "Not enough free memory" before a big mesh (MemoryConfirm.cpp)
drawHelpConsoleUi(); // console, command palette, Controls (F1), Ctrl-hover help: last, on top
+ drawWhatsNew(); // What's New after an update or from the Help menu (WhatsNewPopup.cpp)
drawSupportCard(); // the support card at launch, over everything (PanelSupportCard.cpp)
}
diff --cc src/app/main.cpp
index 0d7174a2,e9d5b5ba..2f593d98
--- a/src/app/main.cpp
+++ b/src/app/main.cpp
@@@ -81,18 -76,17 +81,21 @@@ void usage()
" --crash-test KIND Crash on purpose (segv, abort or throw) to test the crash note in the log");
}
+// The folder isolateSettings made (removed when the run succeeds, kept with its log when it fails).
+std::filesystem::path g_isolatedDir;
+
// UI tests must never read or change the user's real settings, recent files or
// autosaves: point the per-user data directories at a fresh temporary folder.
+ std::filesystem::path g_isolatedDir; // isolateSettings' folder, removed when the run ends well
+
void isolateSettings() {
- if (!g_isolatedDir.empty()) return;
+ if (!g_isolatedDir.empty()) return; // (once: --run with --measure-stroke asks twice)
std::error_code ec;
const auto dir = std::filesystem::temp_directory_path(ec) /
("sculptforge-ui-test-" + std::to_string(std::chrono::steady_clock::now().time_since_epoch().count()));
+ g_isolatedDir = dir;
std::filesystem::create_directories(dir, ec);
+ g_isolatedDir = dir;
const std::string d = dir.string();
#if defined(_WIN32)
_putenv_s("APPDATA", d.c_str());