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: idle redraw in the 0.9.5 CHANGELOG and What's New, performance guide (measure-idle, SF_CONTINUOUS_REDRAW)

islandmeda72acc875ad2
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 250f6cf3..e7e1856f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -39,6 +39,12 @@ All notable changes to SculptForge are listed here. The format follows
Windows). It now opens with its knob (the current value) right under the brush cursor, at any UI scale and
with a pen, and stays open while you drag until you let go, click elsewhere or press Esc.
- B, M, S and the LightBox key followed the built-in key even after you gave the action another one.
+- SculptForge kept the graphics card and a little of the processor busy while it sat idle (#14): it drew a new
+ frame 60 or more times a second whatever happened. It now draws only when something changes: your input,
+ a stroke or view move, a background job (progress bars, splat training, the update check), a message from the
+ phone or the Blender Bridge, or an animation. Idle, it draws nothing (measured: 120 frames a second and 8% of
+ a processor core before, 0 frames and 0.1% after). UI tests and `--record` still draw every frame.
+ `sculptforge --measure-idle 5` prints the idle frame rate; `SF_CONTINUOUS_REDRAW=1` draws every frame as before.
## [0.9.4] - 2026-10-29
diff --git a/docs/guide/performance.md b/docs/guide/performance.md
index 29c87399..1bd51029 100644
--- a/docs/guide/performance.md
+++ b/docs/guide/performance.md
@@ -93,6 +93,13 @@ stepping subdivision levels, saving and opening a project, and turning the view,
| `--bench-view` | Measure only what the view costs: uploading to the graphics card, a few strokes, and turning the view |
| `--bench-out report.md` | Write the report to a file |
+When nothing changes, SculptForge draws nothing: the graphics card and processor rest until you move the mouse,
+press a key, or something finishes in the background. `sculptforge --measure-idle 5` sits idle for five
+seconds (after a short start) and prints the frames drawn and the processor time used. If the view ever stops
+updating when it should (a driver that misbehaves), start SculptForge with the environment variable
+`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.
+
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 8fb455a6..ae731689 100644
--- a/docs/guide/whats-new.md
+++ b/docs/guide/whats-new.md
@@ -32,6 +32,8 @@ check exactly what a brush did; **This SubTool** keeps one SubTool smooth or fla
again instead of shaking the view.
- The S / U / I / O slider opens with its knob under the cursor and stays open while you drag it.
- The Blender Bridge add-on installs again: its zip was missing a file.
+- Idle, SculptForge no longer keeps your graphics card busy: it draws a new frame only when something changes
+ (before, 60 or more a second all the time).
## Version 0.9.4