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.

UV Editor: Alt+U (Shift+U stays the Smooth intensity pop-up), What's New entry after the selection sets, per-frame timing value for UI tests

islandmed9c4c62bf6542
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 23e70d6f..d6b0517c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,7 +8,7 @@ All notable changes to SculptForge are listed here. The format follows
## [0.10.5] - 2026-11-01
### Added
-- **UV Editor** (Tool > Texture Map > UV Editor, Shift+U): a window with the active Part's UV layout over the UDIM
+- **UV Editor** (Tool > Texture Map > UV Editor, Alt+U): a window with the active Part's UV layout over the UDIM
tile grid, drawn on the GPU (pan, zoom, a checker or the painted texture behind). Select vertices, edges, faces or
islands (1-4) by click or box, or on the model with **Select in 3D**; move, rotate and scale with the selection's
handles or G / R / S (X / Y lock an axis, Ctrl snaps). **Seam Tool**: drag on the model to mark seams along the
diff --git a/docs/guide/glossary.md b/docs/guide/glossary.md
index 66b42ba3..461ad54c 100644
--- a/docs/guide/glossary.md
+++ b/docs/guide/glossary.md
@@ -68,7 +68,7 @@ for what is planned.
| Texture palette | Not yet as a palette of texture images. **Tool > Texture Map > Import Texture** loads an image onto the UVs |
| Transpose, Gizmo 3D (Move W, Scale E, Rotate R) | **Gizmo**: same keys, arrows, rings and boxes; masked parts stay, Falloff softens the joint. See [Gizmo](gizmo.md) |
| Transpose All | **All Parts** in the Gizmo panel. See [Gizmo](gizmo.md#all-parts) |
-| UV Master (Unwrap), UV editing | The **UV Editor** (<kbd>Shift</kbd>+<kbd>U</kbd>): seams on the model, Least Stretch, Conformal, By Face Groups, Planar and Unfold unwraps, UDIM packing, texel density, trim sheets (`uv_unwrap`, `uv_pack`...). **Tool > Texture Map > Auto UV** (`uv_auto`) is the one-click unwrap. See [UV Editor](uv-editor.md) |
+| UV Master (Unwrap), UV editing | The **UV Editor** (<kbd>Alt</kbd>+<kbd>U</kbd>): seams on the model, Least Stretch, Conformal, By Face Groups, Planar and Unfold unwraps, UDIM packing, texel density, trim sheets (`uv_unwrap`, `uv_pack`...). **Tool > Texture Map > Auto UV** (`uv_auto`) is the one-click unwrap. See [UV Editor](uv-editor.md) |
| VDM brush, 3D alpha, Create VDM brush from the VDM plane | The **VDM** brush and **Brush > Vector Displacement**: built-in maps, **Load VDM...** (EXR), **New VDM Plane**, **Create VDM**, **Export EXR...**. See [Vector displacement brushes](sculpting.md#vector-displacement-brushes) |
| Zadd / Zsub | **Add** / **Sub** on the top shelf; <kbd>Alt</kbd> flips for one stroke |
| ZPlugin | No in-app plugin system yet. Automate with the Python module, `sculptforge-cli` and MCP ([Scripting](scripting.md)) |
diff --git a/docs/guide/shortcuts.md b/docs/guide/shortcuts.md
index b6177bf7..5527e9a2 100644
--- a/docs/guide/shortcuts.md
+++ b/docs/guide/shortcuts.md
@@ -176,7 +176,7 @@ generated from SculptForge's action registry, the same source as the Controls wi
| Action | Keys | What it does |
|---|---|---|
-| UV Editor | <kbd>Shift</kbd>+<kbd>U</kbd> | Open the UV Editor: the Part's UV layout in 2D over the UDIM tiles. Select vertices, edges, faces or islands (here or on the model), move, rotate and scale them, mark seams, unwrap, pack, set texel density and lay islands into trim sheet strips. Stretch and texel density show live on the model while you edit. |
+| UV Editor | <kbd>Alt</kbd>+<kbd>U</kbd> | Open the UV Editor: the Part's UV layout in 2D over the UDIM tiles. Select vertices, edges, faces or islands (here or on the model), move, rotate and scale them, mark seams, unwrap, pack, set texel density and lay islands into trim sheet strips. Stretch and texel density show live on the model while you edit. |
<!-- END GENERATED: shortcuts -->
diff --git a/docs/guide/texture-painting.md b/docs/guide/texture-painting.md
index 76c649e9..9ea4e04c 100644
--- a/docs/guide/texture-painting.md
+++ b/docs/guide/texture-painting.md
@@ -33,7 +33,7 @@ by hand, with more choices.
mask work as they do for vertex paint.
Click **Show UVs** to see the texture with the UV layout drawn over it, below the buttons, or open the
-[UV Editor](uv-editor.md) (<kbd>Shift</kbd>+<kbd>U</kbd>) to cut seams, unwrap, pack and edit the UVs. Paint on the model and
+[UV Editor](uv-editor.md) (<kbd>Alt</kbd>+<kbd>U</kbd>) to cut seams, unwrap, pack and edit the UVs. Paint on the model and
watch the texture fill in.
## Vertex or Texture
diff --git a/docs/guide/uv-editor.md b/docs/guide/uv-editor.md
index c72b2982..5eb39e29 100644
--- a/docs/guide/uv-editor.md
+++ b/docs/guide/uv-editor.md
@@ -6,7 +6,7 @@ trim sheets, and hand editing of vertices, edges, faces and islands. While you w
colours and a checker, so stretch and density show up on the surface the moment they appear, and a painted texture
can move with every edit so the model keeps its look.
-Open it with **Tool > Texture Map > UV Editor**, or <kbd>Shift</kbd>+<kbd>U</kbd>. It opens over the right of the
+Open it with **Tool > Texture Map > UV Editor**, or <kbd>Alt</kbd>+<kbd>U</kbd>. It opens over the right of the
canvas with the model moved to the left; drag its title bar or its edges to place it anywhere.
![The UV Editor: the lion's islands after Unwrap, with island colours and a checker on the model](images/uv-editor.jpg)
diff --git a/docs/guide/whats-new.md b/docs/guide/whats-new.md
index 5836c212..54f79a2a 100644
--- a/docs/guide/whats-new.md
+++ b/docs/guide/whats-new.md
@@ -7,16 +7,6 @@ chapter opens by itself the first time you start a new version; you can always f
## Version 0.10.5
-- **UV Editor** (**Tool > Texture Map > UV Editor**, <kbd>Shift</kbd>+<kbd>U</kbd>): the Part's UVs flat over the UDIM
- tiles, drawn by the graphics card so a million triangles stay smooth. Draw seams on the model with the **Seam
- Tool** (or take them from face groups, island borders or sharp edges), then **Unwrap**: **Least Stretch**,
- **Conformal**, **By Face Groups**, **Planar**, **Unfold Islands** or **Auto Seams**, with closed and tangled pieces
- cut for you. **Pack** into one tile or across UDIM tiles, **Set** and **Match** texel density, lay islands into
- **trim sheet** strips, and select vertices, edges, faces or islands (in the view or on the model) to move, rotate,
- scale, pin, weld, split, straighten and flip them. The model shows stretch, texel density, islands and a checker
- live while you edit, and a painted texture moves with every change so the model keeps its look. Every step is one
- undo step and a `uv_*` command for scripts. See [UV Editor](uv-editor.md).
-
- **Selection sets** (**Tool > Selection Sets**): store as many named snapshots of a Part's mask, face groups,
visibility, vertex paint, UVs and shape as you like, and restore them at any subdivision level, not only the one
they were stored at. Combine two sets (union, intersect, subtract), restore one onto the current mask or
@@ -28,6 +18,16 @@ chapter opens by itself the first time you start a new version; you can always f
- **Sets for pipelines**: `selection_set_*` commands for scripts, `sculptforge-cli` and the AI assistant,
`doc.selection_set()` / `doc.set_selection_set()` in Python, `.sfsets` files to move sets between Parts and
scenes, and USD exports that carry them as GeomSubsets and primvars (read back on import).
+- **UV Editor** (**Tool > Texture Map > UV Editor**, <kbd>Alt</kbd>+<kbd>U</kbd>): the Part's UVs flat over the UDIM
+ tiles, drawn by the graphics card so a million triangles stay smooth. Draw seams on the model with the **Seam
+ Tool** (or take them from face groups, island borders or sharp edges), then **Unwrap**: **Least Stretch**,
+ **Conformal**, **By Face Groups**, **Planar**, **Unfold Islands** or **Auto Seams**, with closed and tangled pieces
+ cut for you. **Pack** into one tile or across UDIM tiles, **Set** and **Match** texel density, lay islands into
+ **trim sheet** strips, and select vertices, edges, faces or islands (in the view or on the model) to move, rotate,
+ scale, pin, weld, split, straighten and flip them. The model shows stretch, texel density, islands and a checker
+ live while you edit, and a painted texture moves with every change so the model keeps its look. Every step is one
+ undo step and a `uv_*` command for scripts. See [UV Editor](uv-editor.md).
+
- **Fixed: the viewport on some Windows PCs** (#29): on displays whose window uses another colour format (seen with
NVIDIA and high-resolution screens) the model never appeared and the cursor left trails. The view now reaches the
window on every format, and falls back to drawing directly if a driver still refuses.
diff --git a/src/app/PanelUvEditor.cpp b/src/app/PanelUvEditor.cpp
index a6dd18e8..bb7d022e 100644
--- a/src/app/PanelUvEditor.cpp
+++ b/src/app/PanelUvEditor.cpp
@@ -1,7 +1,7 @@
// SculptForge - open source digital sculpting
// SPDX-License-Identifier: GPL-3.0-or-later
//
-// The UV Editor (Tool > Texture Map > UV Editor, Shift+U): a window with the active Part's UV layout in 2D,
+// The UV Editor (Tool > Texture Map > UV Editor, Alt+U): a window with the active Part's UV layout in 2D,
// drawn on the GPU (render/UvView.h) over the UDIM tile grid with a checker or the painted texture behind it.
//
// - Select vertices, edges, faces or islands (1-4) by clicking or dragging a box (Shift adds, Ctrl removes), or
@@ -173,6 +173,7 @@ struct UvEditorState {
};
std::unique_ptr<Job> job;
int unwraps = 0; // finished (UI tests)
+ double frameMs = 0.0; // what the last frame of the window cost on the CPU (UI tests: uv_frame_ms)
};
// The UV Editor's work, with App's internals (a friend of App).
@@ -799,7 +800,7 @@ void App::registerUvEditorActions() {
runCommand(name, a);
if (uvEditor_) uvEditor_->dirty = true;
};
- add("ui.uv_editor", "UV Editor", ICON_LC_GRID_2X2, "Shift+U",
+ add("ui.uv_editor", "UV Editor", ICON_LC_GRID_2X2, "Alt+U",
[this] {
showUvEditor_ = !showUvEditor_;
if (showUvEditor_) { // the model to the left of the window, which opens over the right of the canvas
@@ -951,6 +952,7 @@ void App::drawUvEditor() {
UvEditorUi u = uvUi(*this, uvEditor_);
UvEditorState& s = *uvEditor_;
const float scale = uiScale_;
+ const Uint64 frameStart = SDL_GetTicksNS();
if (!s.gpuTried) {
s.gpuTried = true;
if (!s.gpu.init(s.gpuError)) SDL_Log("UV Editor: %s", s.gpuError.c_str());
@@ -1376,6 +1378,7 @@ void App::drawUvEditor() {
"shows the UVs' new place on it (what trim sheets want).",
kPath);
ImGui::EndChild();
+ s.frameMs = double(SDL_GetTicksNS() - frameStart) * 1e-6;
ImGui::End();
}
@@ -1563,6 +1566,7 @@ double App::uvEditorTestValue(const std::string& name) {
if (name == "uv_select_mode") return double(int(doc_.uvSelection.mode));
if (name == "uv_unwrapping") return uvEditor_ && uvEditor_->job ? 1.0 : 0.0;
if (name == "uv_unwraps") return uvEditor_ ? double(uvEditor_->unwraps) : 0.0;
+ if (name == "uv_frame_ms") return uvEditor_ ? uvEditor_->frameMs : 0.0;
if (name == "uv_tool") return uvEditor_ ? double(uvEditor_->tool) : 0.0;
if (name == "uv_view_triangles") return uvEditor_ ? double(uvEditor_->gpu.triangles()) : 0.0;
if (name == "uv_overlay") return uvEditorOverlay(doc_.activeSubtoolInfo().id) && !uvEditor_->overlay.colors.empty() ? 1.0 : 0.0;
diff --git a/tests/ui/uv_editor.sfui b/tests/ui/uv_editor.sfui
index 1d8c6632..589a1b40 100644
--- a/tests/ui/uv_editor.sfui
+++ b/tests/ui/uv_editor.sfui
@@ -1,9 +1,9 @@
-# UV Editor (Tool > Texture Map > UV Editor, Shift+U): the 2D layout drawn on the GPU, seams drawn on the model,
+# UV Editor (Tool > Texture Map > UV Editor, Alt+U): the 2D layout drawn on the GPU, seams drawn on the model,
# unwrapping, the colours and checker on the model, packing across UDIM tiles, texel density, trim strips,
# selecting and moving islands with undo.
drop ../../assets/demo/lion-head.glb
wait_idle 60
-key shift+u
+key alt+u
expect_value uv_editor_open == 1
expect "UV Editor/Unwrap##uvunwrap"
expect_value uv_islands == 0
@@ -107,5 +107,5 @@ click "UV Editor/Select in 3D"
# The window closes with its key.
hover_window 0.2 0.5
-key shift+u
+key alt+u
expect_value uv_editor_open == 0