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: 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.md
new file mode 100644
index 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.md
index 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** panel
on 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 number
the step gives and press <kbd>Enter</kbd> (or drag the slider that appears). <kbd>[</kbd> and <kbd>]</kbd> make
diff --git a/docs/guide/interface.md b/docs/guide/interface.md
index 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 your
models, 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.md
index 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.cpp
index 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.sfui
index 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 escape
expect_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 escape
click "Stroke##palette.stroke"
click "Stroke/##totray"
expect "Stroke/Drag Stamp"