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-polish-0109 (0.10.9: brush previews, #98, #90, #85, #86, Library on small screens); its notices chip left out: cursor-look's viewport hints (Preferences > Hints, Don't show again) already do this

islandmedea476e342ee3
diff --cc CHANGELOG.md
index 067ca602,d3626811..bb2fab40
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@@ -6,174 -6,24 +6,185 @@@ 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.
+- Smooth face group borders only (Brush palette): Smooth straightens the borders between face groups along the
+ surface and leaves the rest alone, for clean clothing edges (#81, thanks bossian0220).
+- Colour tints the material (Color palette, on by default): the current colour tints the Lit Sphere material of
+ Parts with no vertex paint; grey leaves it as it is (thanks ThinkingPolygons).
+- Cut (#101, #91): one tool that cuts the active Part with a Line, Lasso, Rectangle or Polyline drawn on the screen,
+ in the Ctrl+Shift brush picker and in Tool > Cut. Away removes what the shape covers through the whole Part and
+ closes the cut with a flat cap (a face group of its own), In cuts a flat-bottomed pocket Depth deep, Add extrudes
+ the shape out of the surface (boolean union). An exact boolean in screen space: the uncut surface and its mask,
+ colours, UVs and layers are kept, and the result is watertight. Follows X/Y/Z and radial symmetry; one undo step.
+ Scriptable as the `cut` command.
+- Mask Lasso and Mask Rectangle: Front faces only (#91), also `front_faces_only` on mask_lasso / mask_rect.
+- Duplicate Part shortcut: Ctrl+Shift+D (also Duplicate Part in the command palette).
+
+### 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 in every look is calm and clear: buttons, menu items, shelf buttons and palette headers brighten a little in
+ about 100 ms (no accent tint), pressed is a touch darker, and brush, alpha, material and look tiles (shelves,
+ pickers, Library) lift slightly without moving anything; the active tile keeps its orange outline. Sliders
+ brighten, grow a knob and show their exact value. Hover and keyboard-focus rings follow **Outlines** (Off: none;
+ Subtle; On) and **Outline opacity**. New **Preferences > Interface > Reduce motion**: colour changes only, no easing
+ or lifting. 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 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."
+- 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.
+- Clay and Clay Block follow Intensity and pen pressure: below the default Intensity a dab no longer planes the
+ surface all the way to its plane, so light strokes and low Intensity build gently instead of looking the same as
+ full strength (#83, thanks NimeNayota). Custom clay brushes and micro levels too.
+- Alphas work on micro levels: Drag Stamp and every other stroke stamp the alpha instead of a round dab (#92,
+ thanks Devon0209).
+- Strokes keep sculpting across a silhouette: when the cursor slides just past the edge of a form seen in profile
+ and the brush still covers it, the dab lands on the edge instead of stopping (#84, thanks Bro-Code-99).
+ - Brush shelf previews: Tendril and Elastic Tendril pull a long horn out past the ball (Tendril's preview re-aimed
+ every dab at the ball and dropped the dabs past its edge; scripted Tendril strokes now drag in the view plane as
+ the viewport does), and Layer and Nudge draw clean shapes instead of a pinched plateau and a torn ridge. Previews
+ are re-rendered once (thumbnail version 4). A new test sculpts every built-in brush's preview and checks its shape.
+ - Library > Projects listed each project twice on Windows: recent files and the User folder spelled the same path
+ with different slashes (#90). Paths are now compared normalised, and without case on Windows.
+ - The Library's close button stays on screen on small displays (1280x720), and Esc closes the Library (#80).
+ - The right shelf's region outline is no longer drawn under its buttons, and the "x" buttons (Library, console,
+ window, palettes) are centred (#98).
-- The "Strokes start off the model" chip over the 3D view no longer stays there for good: it shows for a few seconds
- after the setting changes, and its x hides it until Preferences > Interface > Reset hidden notices (Discord).
+ - macOS: a window closed in full screen reopens maximised instead of full screen, so the traffic lights and menu
+ bar stay reachable (#85, again after #41).
-### Added
-- Preferences > Interface > Show hints and notices (on by default) and Reset hidden notices.
-
## [0.10.8] - 2026-11-02
### Fixed
diff --cc CMakeLists.txt
index 0e16c081,6a6f5774..31a0ad8a
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@@ -703,13 -645,10 +704,17 @@@ if(SCULPTFORGE_BUILD_TESTS
add_test(NAME ui_size_popup_scaled COMMAND sculptforge --ui-test ${CMAKE_CURRENT_SOURCE_DIR}/tests/ui/size_popup.sfui
--size 2400x1350 --ui-out ${CMAKE_CURRENT_BINARY_DIR}/ui-shots/size_popup_scaled)
set_tests_properties(ui_size_popup_scaled PROPERTIES LABELS ui TIMEOUT 300)
+ # UI scale (#87) at 1600x900, where Automatic in a test is exactly 100 %; label "dpi": release.sh step check runs them before the tag.
+ add_test(NAME ui_ui_scale_900 COMMAND sculptforge --ui-test ${CMAKE_CURRENT_SOURCE_DIR}/tests/ui/ui_scale.sfui
+ --size 1600x900 --ui-out ${CMAKE_CURRENT_BINARY_DIR}/ui-shots/ui_scale_900)
+ set_tests_properties(ui_ui_scale_900 PROPERTIES LABELS "ui;dpi" TIMEOUT 300)
+ if(TEST ui_ui_scale)
+ set_tests_properties(ui_ui_scale PROPERTIES LABELS "ui;dpi")
+ endif()
+ # The Library on a 1280x720 screen (#80): its close button stays on screen.
+ add_test(NAME ui_library_small_screen_720 COMMAND sculptforge --ui-test ${CMAKE_CURRENT_SOURCE_DIR}/tests/ui/library_small_screen.sfui
+ --size 1280x720 --ui-out ${CMAKE_CURRENT_BINARY_DIR}/ui-shots/library_small_screen_720)
+ set_tests_properties(ui_library_small_screen_720 PROPERTIES LABELS ui TIMEOUT 300)
add_test(NAME ui_user_guide_1080 COMMAND sculptforge --ui-test ${CMAKE_CURRENT_SOURCE_DIR}/tests/ui/user_guide.sfui
--size 1920x1080 --ui-out ${CMAKE_CURRENT_BINARY_DIR}/ui-shots/user_guide_1080)
set_tests_properties(ui_user_guide_1080 PROPERTIES LABELS ui TIMEOUT 300)
diff --cc docs/guide/interface.md
index abb01939,92e0dd67..786f7104
--- a/docs/guide/interface.md
+++ b/docs/guide/interface.md
@@@ -594,17 -520,26 +596,19 @@@ choice for the next session, and each p
> **ZBrush:** like turning the gradient off in the Document palette (**Range** 0) and choosing the **Back**
> colour.
-**Preferences > Library** has **Show at startup** (on by default), the number of **Rows**, **Placement**
+**Edit > Preferences > Library** has **Show at startup** (on by default), the number of **Rows**, **Placement**
(along the top of the canvas, or at the bottom above the bottom shelf) and the **Library folder**.
-**Preferences > Autosave** sets how often a recovery copy is saved (see [Projects, autosave and snapshots](projects.md)).
-
-![The Preferences palette with the Config and Interface sub-palettes](images/preferences.jpg)
-
-### Hints and notices
+**Edit > Preferences > Autosave** sets how often a recovery copy is saved (see [Projects, autosave and snapshots](projects.md)).
-A setting that changes how strokes start, such as **Start strokes off the model** (Preferences > Input), shows a
-small chip over the top of the 3D view for a few seconds when you turn it on. Click the chip (its **x**) to stop
-showing it for good. **Preferences > Interface > Show hints and notices** (on by default) turns every such notice
-off; **Reset hidden notices** shows the ones you hid again. Both are remembered without Store Config.
+![Edit > Preferences with the Config and Interface sub-palettes](images/preferences.jpg)
-### Fullscreen, the palette bar and the camera notch
+### Fullscreen, hiding panels and the camera notch
-- <kbd>F11</kbd> (or **Render > Fullscreen**) fills the screen with SculptForge; press it again to go back to
+- <kbd>F11</kbd> (or **View > Fullscreen**) fills the screen with SculptForge; press it again to go back to
- a window. `sculptforge --fullscreen` starts that way.
+ a window. `sculptforge --fullscreen` starts that way. SculptForge reopens the way you left it; on macOS a window
+ closed in full screen reopens maximised instead, so the menu bar and the window buttons stay reachable (press
+ <kbd>F11</kbd> or the green button to go full screen again).
-- **Menus** in the title strip hides the palette bar; click it again to bring it back.
+- In the ZBrush-style layout, **Menus** in the title strip hides the palette bar; click it again to bring it back.
- <kbd>Tab</kbd> hides the shelves and trays.
- On MacBooks with a camera notch, SculptForge keeps the interface below the notch when it fills the screen
and fills the band beside the notch with the shell colour. **Automatic** asks macOS for the safe area (on
diff --cc docs/guide/whats-new.md
index 98c4fc9e,8f2f2f26..ee18c78e
--- a/docs/guide/whats-new.md
+++ b/docs/guide/whats-new.md
@@@ -7,130 -7,15 +7,136 @@@ 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**.
+- **Calm, clear hover**: buttons, menus and shelves brighten a little as you point at them, tiles lift a little,
+ sliders show their exact value, and the keyboard focus gets a ring as strong as your **Outlines** setting. 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).
+- **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.
+- **Clay follows Intensity and pressure**: Clay and Clay Block build gently with a light pen or a low Intensity
+ instead of planing flat as at full strength (#83). See [Sculpting](sculpting.md#built-in-brushes).
+- **Alphas on micro levels**: Drag Stamp and every stroke stamp your alpha on a micro level too (#92).
+- **Brushes hold on at silhouettes**: a stroke sliding past the edge of a form in profile keeps sculpting while the
+ brush still covers it (#84).
+- **Smooth face group borders**: a Brush palette option that straightens jagged clothing edges between face
+ groups and leaves the rest alone (#81). See [Smooth face group borders](sculpting.md#smooth-face-group-borders).
+- **Colour tints the material**: pick a colour and Parts with no vertex paint take it on in the Lit Sphere
+ material. See [Vertex Paint and materials](vertex-paint.md#materials-lit-spheres).
+- **Cut**: one tool that cuts the active Part with a **Line**, **Lasso**, **Rectangle** or **Polyline**. **Away**
+ removes what the shape covers and closes the cut with a flat cap, **In** cuts a flat-bottomed pocket and **Add**
+ raises the shape out of the surface. The result stays watertight and follows the symmetry. Hold
+ <kbd>Ctrl</kbd>+<kbd>Shift</kbd> and pick a Cut shape, or open **Tool > Cut**. See [Cut](cut.md) (#101, #91).
+- **Mask: Front faces only**: Mask Lasso and Mask Rectangle can leave the far side alone
+ ([Masking](masking.md#mask-with-a-lasso-or-rectangle), #91).
+- **Duplicate Part** has a shortcut: <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>D</kbd> ([Parts](parts.md)).
+ - **Brush previews fixed**: the shelf shows Tendril and Elastic Tendril as long horns pulled out past the ball, as
+ they behave in the viewport, and Layer and Nudge with clean shapes; previews are rebuilt once after updating.
+ - **Library**: projects no longer show twice on Windows (#90); the close button stays on small screens and
+ <kbd>Esc</kbd> closes the Library (#80).
+ - **Cleaner outlines**: the right shelf's outline draws correctly and the **x** buttons are centred (#98).
-- **Quieter notices**: **Strokes start off the model** shows its chip for a few seconds when you turn it on, then
- it goes; click the chip's **x** to never see it again. **Preferences > Interface > Show hints and notices** turns
- them all off, and **Reset hidden notices** brings them back.
+ - **macOS**: a window closed in full screen reopens maximised, with the window buttons reachable (#85).
## Version 0.10.8
diff --cc src/app/App.cpp
index ba6bba5b,df0f5234..b9872933
--- a/src/app/App.cpp
+++ b/src/app/App.cpp
@@@ -137,18 -132,13 +137,14 @@@ bool App::init(const AppOptions& option
SDL_Log("SDL_CreateWindow failed: %s", SDL_GetError());
return false;
}
+ wintab_.open(window_); // Windows: pressure from a tablet driver without Windows Ink (Wintab.h)
if (rememberWindow_) { // #35: where and how big it was last time
if (saved.placed) SDL_SetWindowPosition(window_, saved.x, saved.y);
- #if defined(__APPLE__)
- // #41: full screen on macOS is its own Space, entered from a window already on screen and key; entered
- // here, before the first frame, the menu bar and traffic lights couldn't be revealed. The loop enters it
- // after the first swap instead.
- if (saved.fullscreen) fullscreenAfterFirstFrame_ = true;
- #else
- if (saved.fullscreen) SDL_SetWindowFullscreen(window_, true);
- #endif
- else if (saved.maximized) SDL_MaximizeWindow(window_);
+ if (restoresFullscreen(saved.fullscreen)) SDL_SetWindowFullscreen(window_, true);
+ // #41, #85: on macOS full screen is a Space of its own; entered at start-up (before the first frame, or right
+ // after it) the menu bar and traffic lights couldn't be revealed. A window that was full screen comes back
+ // filling the screen as a maximised window instead (the green button, or F11, takes it full screen again).
+ else if (saved.maximized || saved.fullscreen) SDL_MaximizeWindow(window_);
}
{
Image icon;
diff --cc src/app/Config.h
index c990f96f,70b75013..67911f62
--- a/src/app/Config.h
+++ b/src/app/Config.h
@@@ -14,8 -13,8 +14,9 @@@
#include "core/SpaceMouse.h"
#include "core/Tablet.h"
+#include <set>
#include <string>
+ #include <vector>
namespace sf {