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.

Guide: ZBrush-style wording in prose (title strip, orange accent, SubTool, Polyframe), coming-from-ZBrush paths note; shots.sfui in the default look and task menus

islandmedf90c17d20838
diff --git a/docs/guide/coming-from-zbrush.md b/docs/guide/coming-from-zbrush.md
index 424fc46d..5a941a2d 100644
--- a/docs/guide/coming-from-zbrush.md
+++ b/docs/guide/coming-from-zbrush.md
@@ -8,8 +8,10 @@ of relearning. SculptForge has its own keymap and offers ZBrush-style, Blender a
New installs start in SculptForge's own layout, with menus by task. For the alphabetical palette bar and the
two-row top shelf you know, click **Coming from ZBrush? Use the ZBrush-style layout** in the welcome, or pick
**Edit > Preferences > Interface > Look > Layout > ZBrush-style** (see [Looks and layouts](interface.md#looks-and-layouts)).
-The palette paths in this guide (**Tool > Parts**) work in both: in the SculptForge layout the palettes are
-sections of the menus, and <kbd>F3</kbd> finds any of them.
+Paths in this guide name the SculptForge layout's menus. In the ZBrush-style layout, leave out the menu:
+**Edit > Preferences > Input** is the palette named **Preferences**, **Sculpt > Stroke** the palette named
+**Stroke**; **Tool > Parts** is the same in both. See [Menus and palettes](interface.md#menus-and-palettes) for
+every palette's menu, and <kbd>F3</kbd> finds any of them by name.
## ZBrush terms in SculptForge
@@ -79,7 +81,7 @@ either. See [Keyboard and mouse](shortcuts.md#zbrush-style-keys) for the full li
## What's the same
-- **The layout.** Shelves around the canvas, palettes in alphabetical order in the palette bar and the trays,
+- **The layout** (in the ZBrush-style layout). Shelves around the canvas, palettes in alphabetical order in the palette bar and the trays,
sub-palettes that fold, the Library on <kbd>,</kbd>, Ctrl-hover help on every control, Ctrl+Alt+click to
assign a hotkey, **Store Config** on <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd>. See
[The interface](interface.md).
diff --git a/docs/guide/dynamic-topology.md b/docs/guide/dynamic-topology.md
index 0afdb1d9..23d2e945 100644
--- a/docs/guide/dynamic-topology.md
+++ b/docs/guide/dynamic-topology.md
@@ -5,7 +5,7 @@ ZBrush's **Sculptris Pro** and Blender's **Dyntopo** do. Pull a sphere out into
new shapes get triangles of their own instead of stretched ones; block in a creature from a ball without
remeshing first.
-![A sphere with horns pulled out by Tendril with Dynamic on, in Polyframe and shaded](images/dynamic-topology.jpg)
+![A sphere with horns pulled out by Tendril with Dynamic on, as wireframe and shaded](images/dynamic-topology.jpg)
## Turn it on
@@ -90,7 +90,7 @@ triangles merges them over several dabs rather than all at once, to keep the bru
```
dyntopo enabled=true detail=60
-stroke points="0.3,0.6,1 0.5,0.4,1" brush=SnakeHook radius=0.2 symmetry=x
+stroke points="0.3,0.6,1 0.5,0.4,1" brush=Tendril radius=0.2 symmetry=x
dyntopo enabled=false
```
diff --git a/docs/guide/exporting.md b/docs/guide/exporting.md
index c54a6a56..0e5c2207 100644
--- a/docs/guide/exporting.md
+++ b/docs/guide/exporting.md
@@ -33,7 +33,7 @@ only hold triangles.
UVs are kept through OBJ, FBX, USD, glTF and GoZ-compatible files, in and out. A Part with a painted
[texture](texture-painting.md) is exported with it: the PNG is written next to the file as
-`<name>_color.png` (`<name>_<SubTool>_color.png` with several Parts) and referenced by the model, or embedded
+`<name>_color.png` (`<name>_<Part>_color.png` with several Parts) and referenced by the model, or embedded
in GLB and USDZ files. Spaces in the file name become `_` in the names of the files written beside it
(`my scene.obj` gets `my_scene.mtl` and `my_scene_color.png`), because OBJ and MTL separate file names with
spaces. **Tool > Texture Map > Auto UV** gives any sculpt UVs before export. Normal, displacement and other maps
diff --git a/docs/guide/troubleshooting.md b/docs/guide/troubleshooting.md
index 0735d8d1..776c10a9 100644
--- a/docs/guide/troubleshooting.md
+++ b/docs/guide/troubleshooting.md
@@ -209,7 +209,7 @@ SculptForge keeps its settings in one folder per user:
| `brush-gallery-cache/`, `brush-gallery.json` | Community brush gallery cache and its address |
| `thumbs/` | Cached Library and picker thumbnails (safe to delete) |
-Your **library folder** (projects, tools, alphas, images, splats and QuickSaves shown in the Library) is
+Your **library folder** (projects, tools, alphas, images, splats and snapshots shown in the Library) is
separate: `Documents/SculptForge` by default, changeable in **Edit > Preferences > Library > Library folder**.
> **Tip:** To move settings to another computer, copy `ui.json`, `ai.json` and the `brushes` folder. For a
diff --git a/docs/guide/vertex-paint.md b/docs/guide/vertex-paint.md
index 8c24268d..ebc40f53 100644
--- a/docs/guide/vertex-paint.md
+++ b/docs/guide/vertex-paint.md
@@ -177,7 +177,7 @@ To choose one:
previous material back.
- Open **Render > Materials**, or the **Material** tab of the Library.
-![The material picker with the seven Lit Spheres and Studio](images/material-picker.jpg)
+![The material picker with the built-in Lit Spheres and Studio](images/material-picker.jpg)
Vertex Paint multiplies the material, and cavity shading stays on with every material (strongest with Sculpt). The
material is saved with the project: projects saved with Studio open with Studio.
diff --git a/docs/guide/welcome.md b/docs/guide/welcome.md
index c6548d80..3edb4e84 100644
--- a/docs/guide/welcome.md
+++ b/docs/guide/welcome.md
@@ -39,7 +39,7 @@ of the canvas, once, and never again after you close it.
face group. See [Masking](masking.md) and [Face Groups and visibility](face-groups.md).
- **Keep separate meshes** as Parts (body, eyes, teeth, armour), each with its own undo history. See
[Parts](parts.md).
-- **Paint colour** on the surface (vertex paint) and look at the model through seven Lit Sphere materials. See
+- **Paint colour** on the surface (vertex paint) and look at the model through the built-in Lit Sphere materials or your own. See
[Vertex Paint and materials](vertex-paint.md).
- **Sculpt layers** that double as blend shapes (morph targets), with live weights. See [Sculpt layers and
blend shapes](layers.md).
diff --git a/tools/guide/shots.sfui b/tools/guide/shots.sfui
index 3b941386..0e4e9255 100644
--- a/tools/guide/shots.sfui
+++ b/tools/guide/shots.sfui
@@ -1,19 +1,20 @@
-# Screenshots for the user guide (docs/guide/images). Run from the source folder:
+# Screenshots for the user guide (docs/guide/images), in the default look and layout (Forge Terminal, Tokyo Night,
+# the SculptForge layout's task menus). Run from the source folder:
# build/sculptforge --ui-test tools/guide/shots.sfui --ui-out build/guide-shots
# python3 tools/guide/make_images.py build/guide-shots
+# For the HiDPI check, run it again with --size 3200x1920 (the same layout at 2x) and look at the shots.
# make_images.py crops, labels and compresses them into docs/guide/images.
+run ui_look look=forge scheme=tokyo_night layout=sculptforge
run open path=assets/demo/lion-head.glb
wait_idle 20
shot overview
-# Palettes: a drop-down, then the same palette in the right tray.
-click "Draw##palette.draw"
+# Menus: the Sculpt menu on its Draw & Tablet and Stroke sections, then the Stroke palette in the right tray.
+click "Sculpt##menu.sculpt"
+click "Draw & Tablet##section.draw"
shot draw-palette
-key escape
-click "File##palette.file"
+click "Stroke##section.stroke"
shot palette-dropdown
-key escape
-click "Stroke##palette.stroke"
click "Stroke/##totray"
click "Tool/Parts"
shot palette-tray
@@ -68,7 +69,8 @@ key backtick
expect_value console_open == 0
# Preferences: Config and Interface open (Shift+click keeps both).
-click "Preferences##palette.preferences"
+click "Edit##menu.edit"
+click "Preferences##section.preferences"
click "Preferences/Config"
hold shift
click "Preferences/Interface"
@@ -77,35 +79,45 @@ shot preferences
key escape
# Brushes: Brush Lab, the Brush palette's custom brushes with their menu, the community gallery.
+click "Sculpt##menu.sculpt"
+click "Brush##section.brush"
click "AI Brush"
wait 0.3
shot brush-lab
+click "Sculpt##menu.sculpt"
+click "Brush##section.brush"
click "AI Brush"
-click "Brush##palette.brush"
+key escape
+click "Sculpt##menu.sculpt"
+click "Brush##section.brush"
right_click "Wrinkle"
wait 0.2
shot brush-library
key escape
key escape
-click "Brush##palette.brush"
+click "Sculpt##menu.sculpt"
+click "Brush##section.brush"
click "Community brushes##ui.brush_gallery"
key escape
wait_idle 30
wait 1
shot community-brushes
-click "Brush##palette.brush"
+click "Sculpt##menu.sculpt"
+click "Brush##section.brush"
click "Community brushes##ui.brush_gallery"
key escape
expect_not "Community brushes/Share yours"
# Generate 3D and the Tool > Export sub-palette.
-click "Generate##palette.generate"
+click "Mesh##menu.mesh"
+click "Generate 3D##section.generate"
click "Generate 3D##ui.generate3d"
drop ../../assets/demo/teddy-sketch.png
wait 0.5
shot generate-3d
-click "Generate##palette.generate"
+click "Mesh##menu.mesh"
+click "Generate 3D##section.generate"
click "Generate 3D##ui.generate3d"
key escape
expect_not "Generate 3D/From image"
@@ -126,7 +138,7 @@ run mask_clear
# Vertex Paint: cavity paint, with the Color palette.
run paint_fill color=bone
run paint_from_cavity color=4a2c18 strength=0.9
-click "Color##palette.color"
+click "Paint##menu.paint"
wait 0.2
shot polypaint
key escape
@@ -194,15 +206,16 @@ click "Wire##view.polyf"
# Gaussian splats made from the lion.
run open path=assets/demo/lion-head.glb
run mesh_to_splats
-click "Render##palette.render"
+click "View##menu.view"
click "Show Mesh"
key escape
-click "Splats##palette.splats"
+click "Render##menu.render"
+click "Gaussian Splats##section.splats"
wait 0.3
shot splats
key escape
run splat_clear
-click "Render##palette.render"
+click "View##menu.view"
click "Show Mesh"
key escape
@@ -339,7 +352,8 @@ camera 25 5
zoom 1.6
wait 0.2
shot shading-smooth
-click "Material##palette.material"
+click "Render##menu.render"
+click "Materials##section.material"
click "Flat##material.flat"
run subtool_shading name=Eyes mode=smooth
wait 0.2
@@ -354,7 +368,8 @@ run set_shading mode=smooth
run new_sphere subdivisions=5
run load_matcap path=tests/ui/data/Gold.png
camera 20 10
-click "Material##palette.material"
+click "Render##menu.render"
+click "Materials##section.material"
wait_idle 20
wait 0.2
shot custom-matcaps