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: where Preferences is in each layout; Classic Edit palette gets Preferences... (#144)
islandmed22177d171166
diff --git a/changes/docs-classic-preferences-path.md b/changes/docs-classic-preferences-path.mdnew file mode 100644index 00000000..2d5cd1bd--- /dev/null+++ b/changes/docs-classic-preferences-path.md@@ -0,0 +1,9 @@+---+whats_new: **Edit > Preferences...** in the Classic layout too: Preferences is its own palette there, and now Edit also+ opens it. The guide says where Preferences is in each layout (also <kbd>Ctrl</kbd>+<kbd>,</kbd> or F3 > Preferences).+fixed: The guide's **Edit > Preferences** paths now say where Preferences is in the Classic layout (its own palette in+ the palette bar), and the Classic layout's **Edit** palette has **Preferences...** too. Thanks NicTanghe (#144).+testers:+ - Any OS, Classic layout (Edit > Preferences > Interface > Layout: Classic): Edit > Preferences... opens the+ Preferences palette under its name in the palette bar; Ctrl+, does the same.+---diff --git a/docs/guide/first-sculpt.md b/docs/guide/first-sculpt.mdindex b29bb927..eee060f0 100644--- a/docs/guide/first-sculpt.md+++ b/docs/guide/first-sculpt.md@@ -10,7 +10,8 @@ steps.The lesson uses the default look: the **SculptForge layout**, with the menus **File, Edit, Sculpt, Paint, Mesh,View, Render, Help** along the top, a tool shelf under them, the brushes along the bottom and the **Tool** panelon the right. If you switched to the **Classic layout**, the **Classic layout** notes say where things-are there. Every step can be undone with <kbd>Ctrl</kbd>+<kbd>Z</kbd>, so experiment freely.+are there; Preferences, for one, is its own **Preferences** palette there instead of **Edit > Preferences**+([where Preferences is](interface.md#interface-preferences)). Every step can be undone with <kbd>Ctrl</kbd>+<kbd>Z</kbd>, so experiment freely.Each brush remembers its own size. To set it, hold the cursor over the canvas, press <kbd>S</kbd>, type the numberthe step gives and press <kbd>Enter</kbd> (or drag the slider that appears). <kbd>[</kbd> and <kbd>]</kbd> makediff --git a/docs/guide/interface.md b/docs/guide/interface.mdindex a0172ac9..d6d71144 100644--- a/docs/guide/interface.md+++ b/docs/guide/interface.md@@ -33,6 +33,10 @@ a two-row top shelf; the rest is the same. See [The title strip](#the-title-stri**Edit > Preferences > Interface > Look** sets how the interface looks and how it is laid out. Neither changes yourmodels, brushes or shortcuts.+> **Where Preferences is:** **Edit > Preferences** in the SculptForge layout; in the Classic layout, its own+> **Preferences** palette in the palette bar (also **Edit > Preferences...**). In both, <kbd>Ctrl</kbd>+<kbd>,</kbd>+> (<kbd>Cmd</kbd>+<kbd>,</kbd> on macOS) or <kbd>F3</kbd> > **Preferences** opens it.+**Layout**:- **SculptForge** (the default for new installs): a status bar along the top with the task menus **File, Edit,@@ -520,6 +524,10 @@ Layout keeps it.### Interface preferences+> **Where Preferences is:** **Edit > Preferences** in the SculptForge layout; in the Classic layout, its own+> **Preferences** palette in the palette bar (also **Edit > Preferences...**). In both, <kbd>Ctrl</kbd>+<kbd>,</kbd>+> (<kbd>Cmd</kbd>+<kbd>,</kbd> on macOS) or <kbd>F3</kbd> > **Preferences** opens it.+**Edit > Preferences > Interface**:| Setting | Default | What it does |diff --git a/docs/guide/quick-tour.md b/docs/guide/quick-tour.mdindex a163aa6e..46ce8dac 100644--- a/docs/guide/quick-tour.md+++ b/docs/guide/quick-tour.md@@ -117,6 +117,10 @@ closes it, and it doesn't come back by itself.Blender or Maya. Picking the Classic sculpting keys offers this tour once. See[Keyboard and mouse](shortcuts.md).+> **Where Preferences is:** **Edit > Preferences** in the SculptForge layout; in the Classic layout, its own+> **Preferences** palette in the palette bar (also **Edit > Preferences...**). In both, <kbd>Ctrl</kbd>+<kbd>,</kbd>+> (<kbd>Cmd</kbd>+<kbd>,</kbd> on macOS) or <kbd>F3</kbd> > **Preferences** opens it.+## See also- [Your first sculpt in 10 minutes](first-sculpt.md)diff --git a/src/app/Palettes.cpp b/src/app/Palettes.cppindex 756ef953..542a065f 100644--- a/src/app/Palettes.cpp+++ b/src/app/Palettes.cpp@@ -503,6 +503,18 @@ void App::drawPalette_Edit() {ImGui::EndDisabled();ui::HelpAction(*this, "edit.redo");menuAction(*this, "brush.paste");+ // The Classic layout has Preferences as its own palette; Edit is where people look first (#144).+ if (!sculptForgeLayout()) {+ ImGui::Separator();+ const std::string shortcut = actions().shortcutText("ui.palette.preferences");+ const std::string label = std::string(tr("Preferences")) + "...##edit.preferences";+ const Action* a = actions().find("ui.palette.preferences");+ if (ImGui::MenuItem(label.c_str(), shortcut.empty() ? nullptr : shortcut.c_str()) && a && a->run) {+ actions().touch(a->id);+ a->run();+ }+ ui::HelpAction(*this, "ui.palette.preferences");+ }}void App::drawPalette_File() {diff --git a/tests/ui/shell_layout.sfui b/tests/ui/shell_layout.sfuiindex 1d5c6d8e..5acc1d93 100644--- a/tests/ui/shell_layout.sfui+++ b/tests/ui/shell_layout.sfui@@ -54,6 +54,11 @@ expect "Draw/Add"expect_not "Stroke/Drag Stamp"key escapeexpect_not "Draw/Add"+# Edit > Preferences... opens the Preferences palette, where people look for it first (#144).+click "Edit##palette.edit"+click "Preferences...##edit.preferences"+expect "Input##preferences.input"+key escapeclick "Stroke##palette.stroke"click "Stroke/##totray"expect "Stroke/Drag Stamp"