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.
C++ 3d3d-sculptingcppdear-imguidigital-sculptingfbxgame-developmentgaussian-splattinggltfimage-to-3dmcpopenglopenusdsculptingtext-to-3dunreal-engine
#43 and #41: UI test (quick_tools.sfui), guide pages and changelog
islandmed7d3f23bf4379
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 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### Removeddiff --git a/docs/guide/interface.md b/docs/guide/interface.mdindex 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.mdindex 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 maskdiff --git a/docs/guide/navigation.md b/docs/guide/navigation.mdindex 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 fshrink with depth. The front, side and top views (<kbd>Numpad 1</kbd>, <kbd>3</kbd>, <kbd>7</kbd>) switch toorthographic 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 thecamera.@@ -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.mdindex 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 sizediff --git a/docs/guide/subtools.md b/docs/guide/subtools.mdindex 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.-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), sizedto 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`) ora 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.sfuinew file mode 100644index 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