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: 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.mdindex 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.pyindex b249613f..de6c8f34 100644--- a/tools/guide/feature_shots.py+++ b/tools/guide/feature_shots.py@@ -13,6 +13,7 @@ import argparseimport osimport pathlibimport re+import shutilimport subprocessimport 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 resolvetmp.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