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
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.mdindex 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 aNew installs start in SculptForge's own layout, with menus by task. For the alphabetical palette bar and thetwo-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 toassign 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.mdindex 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 intonew shapes get triangles of their own instead of stretched ones; block in a creature from a ball withoutremeshing first.-+## 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=xdyntopo enabled=false```diff --git a/docs/guide/exporting.md b/docs/guide/exporting.mdindex 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 embeddedin 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 withspaces. **Tool > Texture Map > Auto UV** gives any sculpt UVs before export. Normal, displacement and other mapsdiff --git a/docs/guide/troubleshooting.md b/docs/guide/troubleshooting.mdindex 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) isseparate: `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 adiff --git a/docs/guide/vertex-paint.md b/docs/guide/vertex-paint.mdindex 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.-+Vertex Paint multiplies the material, and cavity shading stays on with every material (strongest with Sculpt). Thematerial is saved with the project: projects saved with Studio open with Studio.diff --git a/docs/guide/welcome.md b/docs/guide/welcome.mdindex 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 andblend shapes](layers.md).diff --git a/tools/guide/shots.sfui b/tools/guide/shots.sfuiindex 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=sculptforgerun open path=assets/demo/lion-head.glbwait_idle 20shot 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 backtickexpect_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 shiftclick "Preferences/Interface"@@ -77,35 +79,45 @@ shot preferenceskey 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.3shot 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.2shot brush-librarykey escapekey escape-click "Brush##palette.brush"+click "Sculpt##menu.sculpt"+click "Brush##section.brush"click "Community brushes##ui.brush_gallery"key escapewait_idle 30wait 1shot community-brushes-click "Brush##palette.brush"+click "Sculpt##menu.sculpt"+click "Brush##section.brush"click "Community brushes##ui.brush_gallery"key escapeexpect_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.pngwait 0.5shot generate-3d-click "Generate##palette.generate"+click "Mesh##menu.mesh"+click "Generate 3D##section.generate"click "Generate 3D##ui.generate3d"key escapeexpect_not "Generate 3D/From image"@@ -126,7 +138,7 @@ run mask_clear# Vertex Paint: cavity paint, with the Color palette.run paint_fill color=bonerun paint_from_cavity color=4a2c18 strength=0.9-click "Color##palette.color"+click "Paint##menu.paint"wait 0.2shot polypaintkey escape@@ -194,15 +206,16 @@ click "Wire##view.polyf"# Gaussian splats made from the lion.run open path=assets/demo/lion-head.glbrun 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.3shot splatskey escaperun splat_clear-click "Render##palette.render"+click "View##menu.view"click "Show Mesh"key escape@@ -339,7 +352,8 @@ camera 25 5zoom 1.6wait 0.2shot shading-smooth-click "Material##palette.material"+click "Render##menu.render"+click "Materials##section.material"click "Flat##material.flat"run subtool_shading name=Eyes mode=smoothwait 0.2@@ -354,7 +368,8 @@ run set_shading mode=smoothrun new_sphere subdivisions=5run load_matcap path=tests/ui/data/Gold.pngcamera 20 10-click "Material##palette.material"+click "Render##menu.render"+click "Materials##section.material"wait_idle 20wait 0.2shot custom-matcaps