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.

#43 and #41: UI test (quick_tools.sfui), guide pages and changelog

islandmed7d3f23bf4379
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4d270eff..601391c7 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,24 @@ All notable changes to SculptForge are listed here. The format follows
## [Unreleased]
+### Added
+- Axis gizmo (#43): click an end of the X / Y / Z gizmo in the canvas corner to snap to that side view
+ (orthographic), as in Blender; the negative ends are drawn too and the end under the pointer is ringed.
+- Undo and Redo on the right shelf (#43); stored layouts get them at the top once (layout version 3).
+- **Continuous** is also in the left shelf's stroke picker, under the stroke tiles (#43).
+- Insert on the model respects X / Y / Z symmetry (#43): a mirrored copy on the other side, one undo step
+ (`insert_primitive symmetry=x`).
+- SubTool thumbnails in the SubTool list (#43), drawn from each SubTool's existing GPU buffers (no upload, the
+ motion proxy on dense meshes), one per frame at most and only once a change has settled, never during a stroke.
+
+### Changed
+- The Mask display toggle (right shelf, <kbd>Ctrl</kbd>+<kbd>H</kbd>) says in its help and the status bar that a
+ hidden mask still masks (#43).
+
+### Fixed
+- macOS (#41): reopening in full screen (restored from the last session, #35) left the menu bar and window buttons
+ unreachable until another display was clicked; full screen is now entered after the window is on screen.
+
## [0.10.2] - 2026-11-01
### Removed
diff --git a/docs/guide/interface.md b/docs/guide/interface.md
index ccf6b12f..d22f8eaa 100644
--- a/docs/guide/interface.md
+++ b/docs/guide/interface.md
@@ -16,7 +16,7 @@ how to rearrange the interface and keep your changes.
| Top shelf | Above the canvas | LightBox, Sculpt/Paint, Zadd/Zsub, Rgb, Draw Size, Z Intensity, symmetry, pressure |
| Left shelf | Left of the canvas | Brush, Stroke, Alpha and Material tiles, the colour picker |
| Canvas | Centre | The 3D view; strokes and navigation start only here |
-| Right shelf | Right of the canvas | Frame, Move, Zoom and Rotate, display toggles, Solo |
+| Right shelf | Right of the canvas | Undo and Redo, Frame, Move, Zoom and Rotate, display toggles, Solo |
| Bottom shelf | Below the canvas | Your quick brushes |
| Trays | Far left and far right | Palettes you keep open; the right tray holds the Tool palette by default |
@@ -154,11 +154,14 @@ unmasked area with the main colour.
### Right shelf
+- **Undo** and **Redo** (<kbd>Ctrl</kbd>+<kbd>Z</kbd>, <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Z</kbd>): greyed out when
+ there is nothing to undo or redo. A layout you customised before they were added gets them at the top.
- **Frame** (<kbd>F</kbd>): fits the model in the view.
- **Move**, **Zoom**, **Rotate**: drag on these buttons to pan, zoom and orbit the view, as in ZBrush.
- **PolyF** (<kbd>Shift</kbd>+<kbd>F</kbd>): shows the mesh's polygons: quads as quads, triangles as triangles.
- **Groups**: colours each polygroup.
-- **Mask**: darkens masked areas (on by default).
+- **Mask** (<kbd>Ctrl</kbd>+<kbd>H</kbd>): shows or hides the mask's darkening (on by default). Hiding it keeps
+ the mask, which still protects the surface.
- **Paint**: shows polypaint colours (on by default).
- **Solo**: shows only the active SubTool (available with two or more SubTools).
- **Splats**: shows or hides a Gaussian splat capture (only shown while one is loaded).
diff --git a/docs/guide/masking.md b/docs/guide/masking.md
index 123283f5..50b5b7d8 100644
--- a/docs/guide/masking.md
+++ b/docs/guide/masking.md
@@ -16,9 +16,11 @@ from cavities or polygroups.
- Masking is not a layer and isn't affected by sculpt layers: a mask stroke always works on the model itself.
- Mask strokes and mask commands are undoable like any other change.
-To see the mask, keep **Mask** on in the right shelf (it is on by default). The same toggle is **Show mask** in
-**Tool > Masking**, and **Show Mask** in the **Render** palette. Turning it off hides the darkening; the mask
-still protects the surface.
+To see the mask, keep **Mask** on in the right shelf (it is on by default; <kbd>Ctrl</kbd>+<kbd>H</kbd> toggles it,
+as ZBrush's View Mask). The same toggle is **Show mask** in **Tool > Masking**, and **Show Mask** in the **Render**
+palette. Turning it off hides the darkening without clearing the mask: it still protects the surface, the status
+bar says so, and turning it on again shows the same mask. **Clear Mask** (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>A</kbd>)
+is what removes it.
## Paint a mask
diff --git a/docs/guide/navigation.md b/docs/guide/navigation.md
index 6862172b..ae350da7 100644
--- a/docs/guide/navigation.md
+++ b/docs/guide/navigation.md
@@ -17,6 +17,11 @@ view with a 35 degree field of view, or orthographic (<kbd>Numpad 5</kbd>): no f
shrink with depth. The front, side and top views (<kbd>Numpad 1</kbd>, <kbd>3</kbd>, <kbd>7</kbd>) switch to
orthographic until you rotate again, as in Blender.
+The X / Y / Z gizmo in the top left of the canvas (**Draw > Camera > Axes**) shows the world axes as the camera
+sees them. Click an end to look from that side, as in Blender: **X** the right view, **Y** the top, **Z** the front,
+and the plain dot at the other end of each axis the left, bottom or back view. These are orthographic like the
+numpad views. The end under the pointer gets a ring.
+
Navigation starts only on the canvas. A drag that begins on a shelf, a tray or a palette never moves the
camera.
@@ -42,6 +47,7 @@ camera.
| Zoom | Mouse wheel; <kbd>Alt</kbd>+left-drag on the background, then let go of <kbd>Alt</kbd> and keep dragging; <kbd>Ctrl</kbd>+right-drag; <kbd>Ctrl</kbd>+middle-drag; with the SculptForge input style also <kbd>Ctrl</kbd>+left-drag on the background |
| Frame the model | <kbd>F</kbd> (Blender style: <kbd>Home</kbd>), or **Frame** on the right shelf |
| Front, right, top view | <kbd>Numpad 1</kbd>, <kbd>Numpad 3</kbd>, <kbd>Numpad 7</kbd>; <kbd>Ctrl</kbd> for the back, left and bottom |
+| Front, side, top or bottom view with the mouse | Click an end of the axis gizmo in the canvas corner |
| Orthographic on or off | <kbd>Numpad 5</kbd> |
| Turn in 15 degree steps | <kbd>Numpad 4</kbd> / <kbd>Numpad 6</kbd> (around), <kbd>Numpad 8</kbd> / <kbd>Numpad 2</kbd> (over); <kbd>Numpad 9</kbd>: the other side |
| Frame the active SubTool | <kbd>Numpad .</kbd> |
diff --git a/docs/guide/sculpting.md b/docs/guide/sculpting.md
index 7e98249e..ac34623a 100644
--- a/docs/guide/sculpting.md
+++ b/docs/guide/sculpting.md
@@ -215,6 +215,9 @@ shelf, which opens the stroke picker, or from the **Stroke** palette.
The setting slider appears under the stroke tiles when **Spray** or **LazyMouse** is selected. With LazyMouse,
the viewport draws the string between the cursor and the brush point.
+**Continuous**, under the stroke tiles in the stroke picker and in the **Stroke** palette, keeps the brush working
+while you hold it still on the model (30 dabs a second), with any stroke type.
+
Notes:
- With **DragRect**, the stamp is placed where you first click. While you drag, it is redrawn at the new size
diff --git a/docs/guide/subtools.md b/docs/guide/subtools.md
index 8487e1b3..f3da7a84 100644
--- a/docs/guide/subtools.md
+++ b/docs/guide/subtools.md
@@ -25,7 +25,9 @@ The list is in **Tool > SubTool**, which is open in the right tray by default.
![The SubTool sub-palette with several SubTools, the active one highlighted](images/subtools.jpg)
-Each row shows the SubTool's name, its triangle count and an eye.
+Each row shows a small picture of the SubTool, its name, its triangle count and an eye. The pictures are drawn from
+the model the viewport already has on the graphics card, so they cost almost nothing even on very dense SubTools,
+and they catch up a moment after you stop changing a SubTool (not during a stroke).
| To | Do this |
|---|---|
@@ -54,6 +56,9 @@ Click **Append** and choose:
- **Sphere**, **Cube** or **Plane**: a new primitive placed beside the visible model (to the right, on +X), sized
to about a third of the largest visible SubTool.
+- **Insert on the model**: choose a shape, then drag on the active SubTool's surface to add it there as a new
+ polygroup (the drag sets its size and turns it). With **Symmetry** X, Y or Z on, a mirrored copy goes on the other
+ side too, in the same undo step; a shape inserted right on a mirror plane isn't doubled.
- **From file...**: a model (`.obj`, `.fbx`, `.glb`, `.gltf`, `.ply`, `.stl`, `.GoZ`, `.usda`, `.usd`, `.usdz`) or
a project (`.sfproj`). A file with several objects adds one SubTool per object.
diff --git a/tests/ui/quick_tools.sfui b/tests/ui/quick_tools.sfui
new file mode 100644
index 00000000..dc1c90eb
--- /dev/null
+++ b/tests/ui/quick_tools.sfui
@@ -0,0 +1,82 @@
+# #43: the axis gizmo snaps to side views, Undo / Redo on the right shelf, Continuous in the left shelf's
+# stroke picker, the mask shown and hidden without clearing it, Insert mirrored by symmetry, SubTool thumbnails.
+run new_sphere subdivisions=4
+key f
+
+# The axis gizmo (top left of the canvas): a click on an end looks from that side, orthographic.
+expect_value camera_ortho == 0
+axis_click +x
+expect_value camera_yaw > 89.9
+expect_value camera_yaw < 90.1
+expect_value camera_pitch == 0
+expect_value camera_ortho == 1
+expect_value camera_aligned == 1
+shot axis_right
+axis_click +y
+expect_value camera_pitch < -89.9
+expect_value camera_aligned == 1
+axis_click -x
+expect_value camera_yaw < -89.9
+expect_value camera_pitch == 0
+axis_click +z
+expect_value camera_yaw == 0
+expect_value camera_pitch == 0
+shot axis_front
+
+# Undo and Redo top the right shelf.
+expect "Undo##edit.undo"
+expect "Redo##edit.redo"
+expect_value can_undo == 0
+stroke 0.3 0.4 0.7 0.5
+expect_value can_undo == 1
+click "Undo##edit.undo"
+expect_value can_undo == 0
+expect_status Undo
+click "Redo##edit.redo"
+expect_value can_undo == 1
+shot shelf_undo_redo
+
+# Continuous sits in the left shelf's stroke picker, beside the strokes.
+expect_value stroke_continuous == 0
+click "##tile.stroke"
+wait 0.1
+expect "Continuous##stroke.continuous"
+shot stroke_picker_continuous
+click "Continuous##stroke.continuous"
+expect_value stroke_continuous == 1
+key escape
+
+# The right shelf's Mask hides the mask and shows it again; it stays on the model meanwhile.
+key ctrl+a
+expect_value masked > 1000
+remember masked all
+click "Mask##view.mask"
+expect_value show_mask == 0
+expect_value masked == $all
+expect_status Mask hidden
+shot mask_hidden
+click "Mask##view.mask"
+expect_value show_mask == 1
+expect_value masked == $all
+key ctrl+shift+a
+expect_value masked == 0
+
+# Insert on the model with X symmetry (on by default): a mirrored copy, one undo step.
+remember triangles base
+click "SubTools/Append"
+hover "Insert on the model"
+click "Cone##insert"
+stroke 0.8 0.45 0.86 0.45
+expect_status 2 cones (mirrored)
+expect_value triangles > $base
+shot insert_mirrored
+key ctrl+z
+expect_value triangles == $base
+key escape
+
+# SubTool thumbnails: each row shows its SubTool, rendered from the GPU mesh.
+click "SubTools/Append"
+click "Cube"
+expect_value subtools == 2
+wait_value subtool_thumbnails == 2 10
+shot subtool_thumbnails