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: starter meshes on the start page; feature_shots.py cleans the scratch files tests leave

islandmedfaedca7f95ab
diff --git a/docs/guide/index.md b/docs/guide/index.md
index 0cb40ba0..11bac14e 100644
--- a/docs/guide/index.md
+++ b/docs/guide/index.md
@@ -14,6 +14,7 @@ Read it inside SculptForge (**Help > User Guide**, or <kbd>Shift</kbd>+<kbd>F1</
| Install it | [Install SculptForge](installing.md): downloads for Windows, macOS and Linux |
| Set it up on Windows | [The Windows notes](installing.md#windows): SmartScreen, pen tablets (Windows Ink, Mouse mode), screen scaling |
| Make your first sculpt | [Your first sculpt in 10 minutes](first-sculpt.md): a mushroom house from the default sphere |
+| Start from a head or body | [Starter meshes](projects.md#start-from-a-starter-mesh): base meshes with clean quads, **File > New from Starter Mesh** |
| Find your way around | [The interface](interface.md): the menus **File, Edit, Sculpt, Paint, Mesh, View, Render, Help**, the shelves and the Tool panel; [Navigating the view](navigation.md) |
| Learn the brushes | [Sculpting and brushes](sculpting.md) |
| Switch from ZBrush | [Coming from ZBrush](coming-from-zbrush.md) (the ZBrush-style layout and keys) and the [Glossary](glossary.md) |
diff --git a/tools/guide/feature_shots.py b/tools/guide/feature_shots.py
index b249613f..de6c8f34 100644
--- a/tools/guide/feature_shots.py
+++ b/tools/guide/feature_shots.py
@@ -13,6 +13,7 @@ import argparse
import os
import pathlib
import re
+import shutil
import subprocess
import sys
@@ -49,18 +50,22 @@ def main() -> int:
ap.add_argument("--out", type=pathlib.Path, default=pathlib.Path("build/guide-features"))
args = ap.parse_args()
env = dict(os.environ, SDL_APP_ID=os.environ.get("SDL_APP_ID", "sculptforge-agent"))
+ scratch = lambda: set(ROOT.glob("sf_ui_*")) | set(ROOT.glob("ui-shots")) # files some tests leave in the working folder
+ before = scratch()
for name in TESTS:
src = ROOT / "tests" / "ui" / f"{name}.sfui"
tmp = src.with_name(f"_guide_{name}.sfui") # beside the original, so its relative paths still resolve
tmp.write_text(convert(src.read_text(encoding="utf-8")), encoding="utf-8")
try:
- r = subprocess.run([args.app, "--ui-test", str(tmp), "--ui-out", str(args.out / name)], env=env,
+ r = subprocess.run([args.app, "--ui-test", str(tmp), "--ui-out", str(args.out / name)], env=env, cwd=ROOT,
capture_output=True, text=True, timeout=900)
finally:
tmp.unlink()
fails = [line for line in r.stdout.splitlines() if line.startswith("FAIL")]
# A failed check late in a test still leaves the shots before it; make_images.py says if one is missing.
print(f"{name}: {'ok' if r.returncode == 0 else fails[0] if fails else f'exit {r.returncode}'}")
+ for extra in scratch() - before:
+ shutil.rmtree(extra) if extra.is_dir() else extra.unlink()
return 0