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 remote-tracking branch 'origin/feat/flatpak' into feat/v096

islandmed939092aef118
diff --cc CHANGELOG.md
index 6b252501,8d5afcf4..08da05d1
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@@ -7,44 -7,14 +7,51 @@@ All notable changes to SculptForge are
## [Unreleased]
### Added
+- Extract (Tool > SubTool > Extract), as in ZBrush: the masked, visible part of a SubTool becomes a shell with Thick (a share of the SubTool's size; negative grows inward, 0 makes a single-sided surface), E Smt (smooths the stepped edge) and Double (both ways). Extract shows a preview below the source that follows the settings; Accept keeps it as a new SubTool with outer, inner and rim polygroups and the source's polypaint, as one undo step (undo removes the SubTool, redo puts it back). TCorne and TBorder make the rim triangles instead of quads at sharp corners or all along it. An unaccepted preview goes when the source changes and is never saved. Commands: extract, extract_accept, extract_cancel.
+- Mirror And Weld (Tool > Geometry > Modify Topology, X / Y / Z): keeps the + side of the plane through the origin, cuts polygons crossing it, mirrors the half and welds the seam into one watertight mesh, keeping polygroups, polypaint, mask, UVs, quads and sculpt layers (`mirror_and_weld`, with `side=negative` for the other half). Undoable.
+- A flat viewport background (#21): Preferences > Display > Background (also in the Render palette) switches between the gradient (the default) and Flat Colour with a colour picker. Store Config keeps it, projects keep their own, and `set_background` (mode, color) scripts it.
+- Mirror (Tool > Deformation, X / Y / Z): flips the SubTool across the plane through the origin, or in place with `pivot=center` (`mirror`). Undoable.
+- A log file, `sculptforge.log` in the user data folder (`%APPDATA%\SculptForge\SculptForge` on Windows,
+ `~/Library/Application Support/SculptForge/SculptForge` on macOS, `~/.local/share/SculptForge/SculptForge` on
+ Linux), so a crash is never silent: it holds the version, system and GPU, everything SDL_Log reports (the
+ Windows build has no console), each command run (written before it runs), and on a crash a note with the
+ cause, the last command and, on Linux and macOS, a stack trace. Each start keeps the previous session's log as
+ `sculptforge-previous.log` and notes when that session didn't close normally; the restore dialog after a
+ crash points to it. **Help > Open log folder** opens the folder; `--log-dir` writes the log elsewhere, and
+ `--crash-test segv|abort|throw` crashes on purpose to test the note (ctest `crash_log`).
+ - A Flatpak (#18): `SculptForge-<version>-x86_64.flatpak` and `-aarch64.flatpak` on every release (with
+ version-less copies, `SculptForge-linux-x86_64.flatpak` and `SculptForge-linux-arm64.flatpak`), built from
+ source on the freedesktop 26.08 runtime by `packaging/flatpak/org.sculptforge.SculptForge.yml`
+ (`packaging/flatpak/build.sh` builds it locally). Sandbox: Wayland or X11, OpenGL, devices (for the SpaceMouse),
+ network and the home folder. In a Flatpak the Blender bridge uses the host's folder and tells the add-on to start
+ the app through Flatpak's launcher; the add-on also looks for that launcher. A package for the FlatPark
+ repository, wrapping the release tarballs, is ready in `packaging/flatpak/flatpark/`.
+### Fixed
+- Strokes on dense meshes keep their shape (#19). When one dab cost more than a frame, the app placed every dab
+ of a long pointer movement before reading the pointer again, so the next movement was longer still and a fast
+ curve came out as a straight line. Dabs now wait in a queue that the app works through for 10 ms a frame,
+ between reading the pointer and drawing; a long gap between pointer samples is drawn as a curve through the
+ last samples, not a chord; and when the queue holds more than 24 dabs (or more than 0.05 s of work, whichever
+ is larger) every second waiting dab is dropped, so the brush stays near the pointer. Measured with the new
+ `--measure-stroke 3,200` (a fast two-turn circle, 200 px brush) on a 21M-triangle sphere: dabs were up to
+ 69 px off the circle before and are within 4 px now, at 82 ms frames instead of 143 ms. Light meshes place
+ the same dabs as before. Based on a patch by @bribblej-web in #19. `SF_STROKE_IMMEDIATE=1` places every dab
+ at once as before; `SF_STROKE_BACKLOG=N` sets the queue limit in dabs (0: never drop).
+- The AppImage's root icon and `.DirIcon` are 512 px PNG files, not links to the SVG (#17), so AppImage managers
+ such as AppManager and Gear Lever show the icon when they integrate it, and the current appimagetool accepts
+ the AppDir. The AppImage is now built with appimagetool directly (packaging/linux/build-appimage.sh), which
+ checks the AppDir before packing it.
+- Divide crashed on models with a vertex shared by 22 or more triangles (#16), such as a cylinder sent from Blender
+ with Triangle Fan caps of 22 sides or more (21 worked) or Blender's UV sphere. The first subdivision level
+ works out each vertex's neighbours from the base mesh; around a high-valence base vertex the list was gathered
+ with every polygon twice before removing the repeats, which overran its 64 slots (3 x valence) and corrupted
+ the stack when the viewport shaded the new level. The repeats are now removed before the list is joined, so
+ it never holds more than 2 x valence (implicit adjacency is only used up to valence 32; above that the stored
+ adjacency has no limit). Unit tests divide fan cylinders of 3 to 300 sides and UV spheres up to 200 segments,
+ through OBJ and through the Blender Bridge, and compare every level's adjacency with a plain rebuild; a UI test
+ receives the issue's meshes from the bridge and divides them in the app.
+
## [0.9.5] - 2026-10-31
The day after launch, people filed ten issues. 0.9.5 answers all of them: ZSpheres for blocking out a base mesh,
diff --cc docs/guide/whats-new.md
index a320b473,fa34ce84..2747d81e
--- a/docs/guide/whats-new.md
+++ b/docs/guide/whats-new.md
@@@ -7,38 -7,14 +7,46 @@@ chapter opens by itself the first time
## Next version
+### Extract
+
+Mask part of a SubTool and **Tool > SubTool > Extract** turns it into a shell that fits the surface exactly: a
+helmet, a strap, a piece of armour. Set **Thick**, **E Smt** and **Double** while the preview shows, then
+**Accept** keeps it as a new SubTool (and <kbd>Ctrl</kbd>+<kbd>Z</kbd> takes it away again). **TCorne** and
+**TBorder** give the rim triangles instead of quads. See [Extract a shell](subtools.md#extract-a-shell).
+
+### Mirror And Weld
+
+**Tool > Geometry > Modify Topology > Mirror And Weld** mirrors one side of a model onto the other across X, Y
+or Z and welds the seam into one watertight mesh, keeping polygroups and polypaint. **Tool > Deformation >
+Mirror** flips a SubTool. See [Mirror And Weld](geometry.md#mirror-and-weld).
+
+### A flat background
+
+**Preferences > Display > Background** (also in the Render palette) switches the view from the gradient to a
+flat colour you pick. Store Config keeps it, and projects keep their own. See
+[The background](interface.md#the-background).
+
+ ### Flatpak
+
+ SculptForge comes as a Flatpak for x86_64 and ARM64 Linux: one file on the releases page that runs in Flatpak's
+ sandbox on any distribution, installed with `flatpak install --user ./SculptForge-linux-x86_64.flatpak`. It can
+ open projects and models anywhere in your home folder, works with pen tablets and a
+ SpaceMouse, and the Blender bridge finds it by itself. See
+ [Installing SculptForge](installing.md#flatpak).
+
+### Fixes
+
+- Fast strokes on very dense meshes keep their curve. When one dab cost more than a frame, a quick arc came out
+ as a straight line; now the dabs wait in a queue the app works through between frames, so it keeps reading
+ the pointer. Based on a patch by @bribblej-web. See [Performance](performance.md).
+- The AppImage has a PNG icon at its root, so AppImage managers (AppManager, Gear Lever) show SculptForge's
+ icon when they add it to your menu.
+- Divide (<kbd>Ctrl</kbd>+<kbd>D</kbd>) no longer crashes on models with a point where many polygons meet, such
+ as a Blender cylinder with Triangle Fan caps of 22 or more sides or a UV sphere's poles.
+- SculptForge now keeps a log file, `sculptforge.log`, in its settings folder (**Help > Open log folder**). After
+ a crash it says what crashed and what you did last; attach it when you report a problem. See
+ [The log file](troubleshooting.md#the-log-file).
+
## Version 0.9.5
### ZSpheres