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.

Merge fix/whats-new-home (0.10.9): home page release area from whats-new.md

islandmed25dec448231a
diff --cc docs/guide/index.md
index 11bac14e,7c5a4bb5..2bc194d7
--- a/docs/guide/index.md
+++ b/docs/guide/index.md
@@@ -1,25 -1,14 +1,26 @@@
# SculptForge User Guide
- SculptForge is a free, open-source sculpting app for VFX, animation and games. This guide covers everything in
- it: the interface, sculpting, masking, painting, Parts, AI generation, and getting your work into a game engine,
- a film pipeline, Blender or ZBrush. It is written for SculptForge 0.10.
+ This guide explains every part of SculptForge, the free, open-source sculpting app for VFX, animation and games:
+ how the interface is organised, how to sculpt, mask, paint (on vertices or textures) and manage Parts, how to generate models with AI,
+ and how to get your work into a game engine, a film pipeline, Blender or ZBrush. It is updated with every
+ release; [What's new](whats-new.md) lists what changed.
-You can read it inside SculptForge (**Help > User Guide**, or <kbd>Shift</kbd>+<kbd>F1</kbd>) or on the
-[SculptForge website](https://sculptforge.app/guide/). New to sculpting? Make
-[your first sculpt in 10 minutes](first-sculpt.md). If you're coming from ZBrush, start with
-[Coming from ZBrush](coming-from-zbrush.md) and keep the [Glossary](glossary.md) at hand: it has SculptForge's names for ZBrush terms and the ZBrush-style keys.
+Read it inside SculptForge (**Help > User Guide**, or <kbd>Shift</kbd>+<kbd>F1</kbd>) or on the
+[SculptForge website](https://sculptforge.app/guide/).
+
+## Start here
+
+| You want to | Read |
+|---|---|
+| 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) |
+| Switch from Blender | [Blender keys](shortcuts.md#blender-keys), and [Working with Blender](blender.md) for the bridge add-on |
+| Fix a problem | [Troubleshooting](troubleshooting.md) |
![The SculptForge window with its main regions labelled](images/interface-overview.jpg)
diff --cc scripts/release.sh
index b4752407,a2e951bc..89471c0b
--- a/scripts/release.sh
+++ b/scripts/release.sh
@@@ -155,23 -157,8 +157,23 @@@ words_ok()
grep -qF "expect_text \"Version $V\"" tests/ui/whats_new.sfui ||
die "tests/ui/whats_new.sfui doesn't check Version $V" "update its first expect_text lines to the new section (the version and one line from it), commit, push main"
}
+# UI scale / DPI (#87): the Windows manifest still asks for per-monitor DPI v2, and the "dpi" UI tests (100-200 %, a
+# display-scale event) pass on main's build. BUILD_DIR (default build) is the coordinator's tree, already built for
+# the full ctest; only the app is rebuilt here.
+dpi_ok() {
+ local b=${BUILD_DIR:-build} heavy=(nice -n 19 ionice -c3)
+ [ -x "$HOME/Work/.sf/heavy.sh" ] && heavy=("$HOME/Work/.sf/heavy.sh") # one heavy job machine-wide
+ grep -q '<dpiAwareness[^>]*>PerMonitorV2' packaging/windows/sculptforge.manifest 2>/dev/null &&
+ grep -q 'packaging/windows/sculptforge.manifest' CMakeLists.txt ||
+ die "the Windows build no longer declares per-monitor DPI v2" "restore packaging/windows/sculptforge.manifest and its target_sources line in CMakeLists.txt (git log -p -- packaging/windows)"
+ [ -f "$b/CTestTestfile.cmake" ] || die "no build tree at $b for the DPI UI tests" "cmake -S . -B $b -DCMAKE_BUILD_TYPE=Release, or BUILD_DIR=<your build> scripts/release.sh $V --from check"
+ "${heavy[@]}" cmake --build "$b" --target sculptforge -j3 >/dev/null || die "the app doesn't build in $b" "cmake --build $b --target sculptforge and fix the error"
+ SDL_APP_ID=sculptforge-agent "${heavy[@]}" ctest --test-dir "$b" -L dpi --output-on-failure >"$b/release-dpi.log" 2>&1 ||
+ die "the UI scale / DPI tests fail (ctest -L dpi; log: $b/release-dpi.log)" "fix them on a branch, merge to main, run again from step check"
+ ok "UI scale tests (100-200 %, display-scale event) pass; Windows manifest declares PerMonitorV2"
+}
- # Everything the steps after the tag need that doesn't depend on the release existing. In mode "bump" a missing
- # card is fine when CARD is set (bump writes it).
+ # Everything the steps after the tag need that doesn't depend on the release existing. The home page card is
+ # checked through the features block until bump writes it.
preflight() {
local mode=${1:-} t auth pr state owner branch pk
for t in git gh curl python3 base64 awk; do command -v "$t" >/dev/null || die "$t is not installed" "install $t"; done