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.

Docs: stroke queue and AppImage icon in What's New (next version), CHANGELOG [Unreleased], performance guide

islandmedf9e976523fd1
diff --git a/CHANGELOG.md b/CHANGELOG.md
index fb357786..9cff913a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,22 @@ All notable changes to SculptForge are listed here. The format follows
## [Unreleased]
+### 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.
+
## [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 --git a/docs/guide/performance.md b/docs/guide/performance.md
index 1bd51029..70b85e5d 100644
--- a/docs/guide/performance.md
+++ b/docs/guide/performance.md
@@ -100,6 +100,14 @@ updating when it should (a driver that misbehaves), start SculptForge with the e
`SF_CONTINUOUS_REDRAW=1` to draw every frame as versions before 0.9.5 did, and please
[report it](troubleshooting.md#report-a-problem); `SF_REDRAW_LOG=1` logs why each frame was drawn.
+On a very dense mesh a dab can cost more than a frame. The dabs of a stroke then wait in a queue that
+SculptForge works through for a few milliseconds each frame, reading the pen or mouse in between, so a fast
+curve stays a curve; if the brush falls far behind, every second waiting dab is left out (a wider spacing)
+so it catches up. `sculptforge --run "new_sphere" --measure-stroke 3,200` draws a fast circle for three seconds
+with a 200-pixel brush and prints how far the dabs strayed from it and the frame times.
+`SF_STROKE_IMMEDIATE=1` places every dab as soon as the pointer moves (versions before 0.9.6),
+`SF_STROKE_BACKLOG=0` never leaves dabs out, and `SF_STROKE_LOG=1` logs the queue each frame.
+
The `perf_info` command (also in the [Console](scripting.md)) prints the threads in use and the memory the
scene holds; `set_multithreading enabled=false` turns multithreading off from a script.
diff --git a/docs/guide/whats-new.md b/docs/guide/whats-new.md
index e462ccdb..1a42e9ff 100644
--- a/docs/guide/whats-new.md
+++ b/docs/guide/whats-new.md
@@ -5,6 +5,16 @@ chapter opens by itself the first time you start a new version; you can always f
**Help > What's New**. Every detail is in the
[changelog](https://github.com/islandmed/SculptForge/blob/main/CHANGELOG.md).
+## Next version
+
+### 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.
+
## Version 0.9.5
### ZSpheres
diff --git a/tests/ui/whats_new.sfui b/tests/ui/whats_new.sfui
index f11b447f..96d8bb9a 100644
--- a/tests/ui/whats_new.sfui
+++ b/tests/ui/whats_new.sfui
@@ -4,10 +4,10 @@ click "Help##palette.help"
click "What's New##help.whats_new"
expect_value guide_open == 1
expect_guide whats-new.md
+expect_text "Next version"
+expect_text "Fast strokes on very dense meshes"
expect_text "Version 0.9.5"
expect_text "ZSpheres"
-expect_text "Blender keys"
-expect_text "Flat shading"
expect_text "Version 0.9.4"
expect_text "Version 0.9.3"
expect_text "Version 0.9.2"
@@ -20,5 +20,5 @@ expect_text "Version 0.6"
expect_text "Version 0.5"
expect_text "Version 0.4.2"
# The newest section is on screen.
-expect_text "ZSpheres"
+expect_text "AppImage managers"
shot whats-new