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 QRemesh retopology and ProjectAll

islandmede8c9ff642436
diff --cc CHANGELOG.md
index fd3e3f96,90a88cbc..891fff8d
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@@ -6,71 -6,27 +6,92 @@@ All notable changes to SculptForge are
## [Unreleased]
+### Subdivision levels (multiresolution)
+- Divide (Tool > Geometry, Ctrl+D, `subdiv_divide`) adds a subdivision level per SubTool and keeps the lower
+ ones: Catmull-Clark on meshes with quads (quads stay quads), Loop on triangle meshes, flat with Smt off.
+- Lower Res / Higher Res (Shift+D / D, `subdiv_lower`, `subdiv_higher`) and the SDiv slider (`subdiv_level`)
+ step between levels. Detail is stored per level as a displacement in the local frame of the smoothed level
+ below, so reshaping a low level carries it along; edits at a high level are restricted (full weighting) to
+ the lower ones. Round trips without edits are bit-for-bit.
+- Mask, polypaint, paint layers, polygroups, hidden faces and UVs follow the levels (copied down, interpolated or
+ inherited up where they changed); sculpt layers have their own detail per level; the texture is shared.
+- Del Lower, Del Higher (`subdiv_delete_lower`, `subdiv_delete_higher`) and Reconstruct Subdiv
+ (`subdiv_reconstruct`: finds the lower level of a regular Catmull-Clark or Loop subdivision, keeping the mesh
+ and its vertex order). `subdiv_info` lists the levels; `subdiv_export` writes the visible SubTools at another
+ level (e.g. the base cage) in any export format.
+- Each level change is one undo step, as is each stroke at any level; level edits share unchanged levels
+ copy-on-write. The two levels left last keep their topology and BVH, so stepping back and forth is instant
+ (1-45 ms at 6.5M triangles).
+- Projects save every level (project format 4). The SubTool list shows "SDiv n/m".
+- Ctrl+D now runs Divide; the one-way Subdivide stays in Tool > Geometry and as `subdivide`.
+
+### Gizmo 3D (moving, scaling, rotating and posing)
+- Gizmo 3D modes, as in ZBrush: W Move, E Scale, R Rotate, Q back to Draw (top shelf, Transform palette, F3).
+ Move has axis arrows, plane squares and a view-plane centre; Rotate has axis rings and a view ring; Scale has
+ axis boxes and a uniform centre. Shift snaps (15 degrees, a round grid step, 10%). The amount shows beside the
+ gizmo while dragging. Dragging off the handles still navigates; Ctrl still masks.
+- Transforms move the active SubTool, or only its unmasked part: partly masked vertices move partly, hidden ones
+ never. Falloff eases the movement in over a distance from the mask's edge (measured along the surface, as a
+ share of the size) for soft joints when posing. With symmetry on, a masked transform is mirrored across the
+ symmetry plane.
+- Pivot: follows the centre of what moves; Alt+drag the gizmo to move it (or turn its axes) without the model,
+ Alt+click the model or To Surface to put it on the surface, Reset; World or Surface axes (Y along the normal,
+ turning with rotations). The gizmo follows undo / redo of its own steps and is saved in projects (`gizmo` key,
+ no format bump).
+- Gizmo 3D panel: pivot, options and numeric Move / Rotate / Scale with Apply; All SubTools (Transpose All, one
+ undo step per SubTool).
+- `transform` command (translate, rotate, scale, pivot, orient, masked, falloff, symmetry, all); each gizmo drag
+ is echoed to the console as the command that repeats it.
+- One undo step per drag that restores positions bit for bit. Sculpt layers move with the surface (the base and
+ every layer's offsets). Topology, quads, UVs, textures, polypaint and polygroups are untouched.
+- Fast on big meshes: a drag recomputes from the drag's start (no drift), transforms only the moving vertices
+ through a per-weight lookup table on several threads, turns normals of rigid parts and recomputes only where
+ the movement varies, uploads only the changed vertex range and refits the BVH once on release. On 1.3M
+ triangles: about 2 ms to transform and 7 ms to upload per drag frame, 20-40 ms on release.
+
+### Normal, displacement and AO map baking
+- Tool > Bake (and the `bake` command) bakes a high-poly source (one SubTool, or every visible one but the
+ active) onto the active SubTool's UVs: tangent-space normal, object-space normal, displacement, ambient
+ occlusion, cavity and colour (polypaint or painted texture) maps, 1K to 8K.
+- Tangent-space maps use MikkTSpace tangents (vendored, zlib), as Blender, Unreal, Unity and Godot compute them;
+ OpenGL or DirectX green convention. Unit-tested to decode to the high-poly's normals within 0.2 degrees on
+ average.
+- Rays along the low-poly's smoothed normals through a front / rear cage, measured automatically by default or
+ set by hand, keeping the high-poly hit nearest the low-poly; 1-16 rays per texel of anti-aliasing; padding
+ around UV islands; tile-parallel on every core over a dedicated thread-safe BVH, in the background with
+ progress and Cancel.
+- Displacement as a 16-bit PNG (mid-grey = 0, scale reported) and a 32-bit float OpenEXR in world units.
+- The baked normal map shows on the low-poly in the viewport (new normal-map shader with per-corner MikkTSpace
+ tangents), with a Preview Normal Map toggle.
+- Send to Unreal imports the baked normal map too (`T_<Name>_N`, normal-map compression, green flipped for
+ OpenGL maps) when the editor runs on the same computer.
+- Maps are written as `<SubTool>_normal.png`, `_ao.png`, `_displacement.png` / `.exr` and so on, beside the
+ last export by default.
+
+ ### Quad retopology and detail projection
+ - QRemesh (Tool > Geometry > QRemesh, `qremesh`): automatic quad retopology like ZBrush's ZRemesher. A
+ field-aligned method after Instant Meshes (Jakob et al. 2015; field formulas follow its BSD-3 reference code,
+ credited in THIRD_PARTY_NOTICES.md): a multi-resolution 4-RoSy orientation field and position field, polygon
+ extraction, then every polygon split into quads and relaxed onto the sculpt. The result is 100% quads,
+ 2-manifold and closed where the sculpt is, within about 5% of the target count.
+ - Options: Target Polygons with Half / Same / Double, Adaptive Size (curvature-driven quad size), Keep Groups
+ (edge loops along polygroup borders, groups kept), Detect Edges (loops on hard edges over 50 degrees),
+ Use Polypaint (red = up to 4x the density, blue = down to a quarter), Symmetry (one half remeshed and mirrored,
+ welded on the seam), Keep Original (the old SubTool kept hidden below, for ProjectAll).
+ - Runs in the background in the app with a progress bar and Cancel; one undo step. Mask and polypaint are
+ interpolated onto the new mesh; sculpt layers are baked.
+ - ProjectAll (Tool > SubTool > Project, `project_all`): moves the active SubTool onto the other visible
+ SubTools (rays both ways along the normal, nearest hit within Dist, else the closest point) and takes their
+ polypaint. Dist, Mean, PA Blur, Geometry / Polypaint toggles, an optional single `source`; respects the mask
+ and hidden faces; shape goes into the active sculpt layer, colour into the active paint layer; one undo step.
+ - Fast on dense meshes (all threads, a read-only BVH): 1.3M triangles to 5,000 quads in 1.7 s, to 100,000 in
+ 6 s; ProjectAll onto 1.25M vertices in 0.6 s (10-core desktop).
+ - New guide chapter "Quad retopology and detail projection", glossary entries; UI test `tests/ui/retopo.sfui`,
+ unit tests `tests/test_retopo.cpp` (manifold, quad %, target count, Hausdorff distance, projection error).
+
+### Changed
+- Wireframe (PolyF) is Shift+F only: W is now the Gizmo 3D's Move, as in ZBrush.
+
## [0.4.2] - 2026-10-23
### Texture painting on UV maps
diff --cc CMakeLists.txt
index c461d620,7be84df1..4d94baab
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@@ -57,14 -55,12 +57,18 @@@ add_library(sculptforge_core STATI
src/core/PaintLayer.cpp
src/core/Texture.cpp
src/core/TextureCommands.cpp
+ src/core/Multires.cpp
+ src/core/MultiresCommands.cpp
src/core/AutoUv.cpp
+ src/core/SurfaceQuery.cpp
+ src/core/QRemesh.cpp
+ src/core/Projection.cpp
+ src/core/RetopoCommands.cpp
third_party/xatlas/xatlas.cpp
+ src/core/Bake.cpp
+ src/core/BakeImage.cpp
+ src/core/Tangents.cpp
+ third_party/mikktspace/mikktspace.c
src/core/Matcap.cpp
src/core/Project.cpp
src/core/Guide.cpp
@@@ -168,9 -164,7 +172,10 @@@ if(SCULPTFORGE_BUILD_APP
src/app/PanelPolypaint.cpp
src/app/PanelPaintLayers.cpp
src/app/PanelTexture.cpp
+ src/app/PanelGeometry.cpp
+ src/app/Gizmo.cpp
+ src/app/PanelBake.cpp
+ src/app/PanelRetopo.cpp
src/app/PanelGoz.cpp
src/app/PanelProject.cpp
src/app/PanelSubTools.cpp
diff --cc README.md
index 4763a60d,066e193d..a293f7d0
--- a/README.md
+++ b/README.md
@@@ -53,11 -53,11 +53,12 @@@ Plug in Claude, fal.ai or Meshy, or ru
| Masking, polygroups, visibility (Ctrl / Ctrl+Shift, lasso or rectangle), polypaint, MatCaps | **Yes** | Yes |
| Polypaint layers with blend modes (Multiply, Overlay, Screen...) | **Yes** (new in 0.4) | Opacity only |
| Texture painting on UVs (1K-8K, same paint layers), automatic UV unwrap | **Yes** (new in 0.5) | Polypaint, converted to a texture |
+ | Automatic quad retopology (ZRemesher-style) and ProjectAll detail transfer | **Yes** (new in 0.5) | Yes |
| Quads kept from import, shown and exported as quads | **Yes** (new in 0.4) | Yes |
| SubTools (separate meshes: append, split, merge, solo, Alt+click to select) | **Yes** (new in 0.3) | Yes |
+| Gizmo 3D: move, scale, rotate and pose (masked parts, soft joints, Transpose All) | **Yes** (new in 0.5) | Yes |
| GoZ exchange with ZBrush | **Yes** (new in 0.2; not yet tested against a live ZBrush) | Yes |
- | Multiresolution (subdivision levels), dynamic topology, ZRemesher-class retopology, UV editing | Not yet ([roadmap](ROADMAP.md)) | Yes |
+ | Multiresolution (subdivision levels), dynamic topology, UV editing | Not yet ([roadmap](ROADMAP.md)) | Yes |
SculptForge doesn't read ZBrush's proprietary `.ZTL`/`.ZPR` files; bring models over with GoZ (`.GoZ` files
keep polygroups, mask and polypaint) or as OBJ, FBX or GLB.
diff --cc ROADMAP.md
index 1a5750f0,5267545f..3b05f80d
--- a/ROADMAP.md
+++ b/ROADMAP.md
@@@ -109,12 -109,13 +109,13 @@@ always-latest downloads
Ranked by what sculptors cite most on the ZBrush, Polycount, Blender and Mudbox forums:
-- πŸ“‹ Multiresolution subdivision levels (step up and down, keep detail, reconstruct)
+- βœ… Multiresolution subdivision levels (step up and down, keep detail, reconstruct)
- - πŸ“‹ ZRemesher-class quad retopology with guides and density, plus Project / Project All detail transfer
+ - βœ… ZRemesher-class quad retopology (QRemesh: target count, Adaptive Size, Keep Groups, polypaint density,
+ symmetry) plus ProjectAll detail transfer (v0.5); πŸ“‹ curve guides
- βœ… Automatic UV unwrapping (Auto UV, xatlas) and texture painting on UV maps (v0.5)
-- πŸ“‹ Normal / displacement map baking
+- βœ… Normal / displacement / AO / cavity / colour map baking with MikkTSpace tangents and a viewport preview (v0.5)
- πŸ“‹ Performance at 20-100M polygons, multithreaded brushes, fast undo
-- πŸ“‹ A transpose / gizmo tool for posing and moving parts
+- βœ… Gizmo 3D for moving, scaling, rotating and posing parts (W / E / R, masked falloff, Transpose All) (v0.5)
## Phase 3 β€” AI assistant, beyond brushes
diff --cc THIRD_PARTY_NOTICES.md
index c48e2899,d2d94e24..6f99bfee
--- a/THIRD_PARTY_NOTICES.md
+++ b/THIRD_PARTY_NOTICES.md
@@@ -13,7 -13,7 +13,8 @@@ licenses require
| [stb_image / stb_image_write](https://github.com/nothings/stb) | commit 013ac3be | MIT License or Public Domain (Unlicense), at your choice | Image loading and PNG writing. Vendored in third_party/stb. |
| [ufbx](https://github.com/ufbx/ufbx) | 0.23.1 (commit 5955c5c) | MIT License or Public Domain (Unlicense), at your choice | FBX import. Vendored in third_party/ufbx. |
| [xatlas](https://github.com/jpcy/xatlas) | commit f700c77 | MIT License | Automatic UV unwrapping (UV > Auto UV) for texture painting. Vendored in third_party/xatlas. |
+| [MikkTSpace](https://github.com/mmikk/MikkTSpace) | commit 3e895b4 | zlib License | Tangent frames for baked tangent-space normal maps (Tool > Bake), matching Blender, Unreal, Unity and Godot. Vendored in third_party/mikktspace. |
+ | [Instant Meshes](https://github.com/wjakob/instant-meshes) | formulas only, nothing vendored | BSD 3-Clause License | QRemesh (Tool > Geometry): the field formulas in src/core/QRemesh.cpp (extrinsic 4-RoSy orientation / position compatibility, the middle point of two tangent planes, lattice rounding) follow its reference code. The rest of QRemesh is our own. |
| [Inter typeface](https://github.com/rsms/inter) | 4.1 | SIL Open Font License 1.1 | User interface font, embedded in the desktop app. Vendored in assets/fonts. |
| [libcurl](https://curl.se) | system library | curl License (MIT/X derivate) | HTTPS for optional AI features on Linux and macOS. Linked dynamically from the operating system; Windows uses the built-in WinHTTP instead. |
@@@ -454,26 -454,37 +455,63 @@@ SOFTWARE
---
+## MikkTSpace
+
+https://github.com/mmikk/MikkTSpace β€” zlib License
+
+```
+Copyright (C) 2011 by Morten S. Mikkelsen
+
+This software is provided 'as-is', without any express or implied
+warranty. In no event will the authors be held liable for any damages
+arising from the use of this software.
+
+Permission is granted to anyone to use this software for any purpose,
+including commercial applications, and to alter it and redistribute it
+freely, subject to the following restrictions:
+
+1. The origin of this software must not be misrepresented; you must not
+ claim that you wrote the original software. If you use this software
+ in a product, an acknowledgment in the product documentation would be
+ appreciated but is not required.
+2. Altered source versions must be plainly marked as such, and must not be
+ misrepresented as being the original software.
+3. This notice may not be removed or altered from any source distribution.
+```
++
++---
++
+ ## Instant Meshes
+
+ https://github.com/wjakob/instant-meshes β€” BSD 3-Clause License. Wenzel Jakob, Marco Tarini, Daniele Panozzo
+ and Olga Sorkine-Hornung, *Instant Field-Aligned Meshes*, ACM Transactions on Graphics (SIGGRAPH Asia) 2015.
+
+ ```
+ Copyright (c) 2015 Wenzel Jakob, Daniele Panozzo, Marco Tarini,
+ and Olga Sorkine-Hornung. All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions are met:
+
+ 1. Redistributions of source code must retain the above copyright notice, this
+ list of conditions and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright notice,
+ this list of conditions and the following disclaimer in the documentation
+ and/or other materials provided with the distribution.
+
+ 3. Neither the name of the copyright holder nor the names of its contributors
+ may be used to endorse or promote products derived from this software
+ without specific prior written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+ FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+ CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ ```
diff --cc docs/guide/geometry.md
index ea9bfb5d,73b047a1..ef6523e2
--- a/docs/guide/geometry.md
+++ b/docs/guide/geometry.md
@@@ -11,9 -11,9 +11,10 @@@ All of them work on the **active SubToo
| Tool | Where | Triangles | Quads | Keeps sculpt layers | Keeps mask and polypaint | Keeps polygroups, hidden faces, UVs |
|---|---|---|---|---|---|---|
-| Subdivide | **Tool > Geometry > Subdivide**, <kbd>Ctrl</kbd>+<kbd>D</kbd> | x4 per level | Each quad becomes four | Yes | Yes (interpolated) | Yes |
+| Divide (levels) | **Tool > Geometry > Divide**, <kbd>Ctrl</kbd>+<kbd>D</kbd> | x4 per level, lower levels kept | Each quad becomes four (Catmull-Clark) | Yes | Yes (interpolated) | Yes |
+| Subdivide | **Tool > Geometry > Subdivide** | x4 per level | Each quad becomes four | Yes | Yes (interpolated) | Yes |
| Voxel Remesh | **Tool > Remesh > Voxel Remesh** | Set by resolution | All quads (new ones) | Baked in | Yes (transferred) | No (reset) |
+ | QRemesh | **Tool > Geometry > QRemesh** | Set by Target Polygons | All quads, with edge loops | Baked in | Yes (transferred) | Polygroups with Keep Groups; no hidden faces or UVs |
| Decimate | **Tool > Geometry > Decimate** | Reduced | No, all triangles | Yes | Yes | Yes |
| LOD chain | **Tool > Export** | One level per ratio step | LOD0 keeps them; lower levels are triangles | Yes, on every level | Yes | Yes |
diff --cc docs/guide/glossary.md
index 78367d44,239d82b3..42551f3d
--- a/docs/guide/glossary.md
+++ b/docs/guide/glossary.md
@@@ -93,12 -87,8 +95,13 @@@ for what is planned
| Shelves, palettes, trays | The interface around the canvas: shelves hold the most-used controls, palettes hold everything, trays hold pinned palettes. See [The interface](interface.md) |
| Studio brush folder | A shared, read-only brush folder for a team (`SCULPTFORGE_BRUSH_PATH`). See [For studios](studios.md) |
| Paint target (Vertex / Texture) | Where painting goes on a SubTool that has a texture: its vertices (polypaint) or its texture. Top shelf, next to **Rgb**. See [Texture painting](texture-painting.md#vertex-or-texture) |
+ | QRemesh | SculptForge's automatic quad retopology (ZBrush's ZRemesher), in **Tool > Geometry**. See [Quad retopology](retopology.md) |
-| Padding (gutter) | The few texels around each UV island that texture painting also fills, so seams don't show. See [Texture painting](texture-painting.md) |
+| Padding (gutter) | The few texels around each UV island that texture painting and baking also fill, so seams don't show. See [Texture painting](texture-painting.md) and [Baking](baking.md) |
+| Bake | Capture a high-poly's detail as images (maps) on a low-poly's UVs. See [Baking](baking.md) |
+| Cage (front / rear distance) | How far in front of and behind the low-poly the bake's rays look for the high-poly. See [Baking](baking.md#how-the-bake-works) |
+| Displacement map | A map of how far the high-poly lies from the low-poly along its normal; mid-grey = 0. See [Baking](baking.md#displacement-mid-grey-is-zero) |
+| MikkTSpace | The standard way of computing tangents that game engines share, so tangent-space normal maps look the same everywhere. See [Baking](baking.md) |
+| Normal map | A map of surface directions that makes a low-poly shade like the high-poly. Tangent-space maps are relative to the surface (for engines), object-space maps to the model. See [Baking](baking.md) |
| Texel | One pixel of a texture. Texture painting paints texels; their 3D position on the model decides the brush falloff |
| UV island | A piece of the surface flattened into the texture square. Auto UV cuts the model into islands along seams |
diff --cc docs/guide/index.md
index d1458576,1820fc3d..25d233fd
--- a/docs/guide/index.md
+++ b/docs/guide/index.md
@@@ -29,28 -29,26 +29,29 @@@ You can read it inside SculptForge (**H
11. [Polypaint and materials](polypaint.md)
12. [Texture painting](texture-painting.md)
13. [Sculpt layers and blend shapes](layers.md)
-14. [Subdivide, remesh, decimate and LODs](geometry.md)
-15. [Quad retopology and detail projection](retopology.md)
+14. [Subdivision levels](subdivision-levels.md)
+15. [Moving, rotating and posing (Gizmo 3D)](gizmo.md)
+16. [Subdivide, remesh, decimate and LODs](geometry.md)
++17. [Quad retopology and detail projection](retopology.md)
## AI and capture
- 17. [Image and text to 3D](generate-3d.md)
- 18. [Gaussian splats](splats.md)
-16. [Image and text to 3D](generate-3d.md)
-17. [Gaussian splats](splats.md)
++18. [Image and text to 3D](generate-3d.md)
++19. [Gaussian splats](splats.md)
## Files and pipelines
- 19. [Baking normal and displacement maps](baking.md)
- 20. [Exporting, Unreal and ZBrush](exporting.md)
- 21. [Projects, autosave and QuickSave](projects.md)
- 22. [Scripting and automation](scripting.md)
- 23. [SculptForge for studios](studios.md)
-18. [Exporting, Unreal and ZBrush](exporting.md)
-19. [Projects, autosave and QuickSave](projects.md)
-20. [Scripting and automation](scripting.md)
-21. [SculptForge for studios](studios.md)
++20. [Baking normal and displacement maps](baking.md)
++21. [Exporting, Unreal and ZBrush](exporting.md)
++22. [Projects, autosave and QuickSave](projects.md)
++23. [Scripting and automation](scripting.md)
++24. [SculptForge for studios](studios.md)
## Reference
- 24. [Keyboard and mouse](shortcuts.md)
- 25. [Troubleshooting and FAQ](troubleshooting.md)
- 26. [Glossary](glossary.md)
-22. [Keyboard and mouse](shortcuts.md)
-23. [Troubleshooting and FAQ](troubleshooting.md)
-24. [Glossary](glossary.md)
++25. [Keyboard and mouse](shortcuts.md)
++26. [Troubleshooting and FAQ](troubleshooting.md)
++27. [Glossary](glossary.md)
## Getting help
diff --cc docs/guide/whats-new.md
index 1a1defcb,137ef432..28b714e4
--- a/docs/guide/whats-new.md
+++ b/docs/guide/whats-new.md
@@@ -7,61 -7,16 +7,71 @@@ chapter opens by itself the first time
## Next version (in development)
+### Subdivision levels
+
+Sculpt one model at several resolutions, as with ZBrush's SDiv: big forms low, fine detail high, and back down
+without losing anything.
+
+- **Divide** (<kbd>Ctrl</kbd>+<kbd>D</kbd>) adds a level and keeps the ones below. Quads stay quads
+ (Catmull-Clark); **Smt** off divides without smoothing.
+- **Lower Res** / **Higher Res** (<kbd>Shift</kbd>+<kbd>D</kbd> / <kbd>D</kbd>) and the **SDiv** slider step
+ between levels. Detail sculpted high rides along when you reshape low, and edits high show up softened below.
+ Stepping back and forth is instant, even at millions of polygons.
+- Mask, polypaint, paint layers, polygroups, hidden faces, UVs and sculpt layers follow the levels.
+- **Del Lower**, **Del Higher** and **Reconstruct Subdiv** (find the lower levels of a model subdivided
+ elsewhere). Undo walks back through strokes and level changes; projects save every level; the SubTool list
+ shows "SDiv 3/5".
+- <kbd>Ctrl</kbd>+<kbd>D</kbd> now divides with levels; the old one-way **Subdivide** is still in
+ **Tool > Geometry**.
+
+See [Subdivision levels](subdivision-levels.md).
+
+### Gizmo 3D: move, scale, rotate and pose
+
+ZBrush's Gizmo 3D, with the same keys: <kbd>W</kbd> Move, <kbd>E</kbd> Scale, <kbd>R</kbd> Rotate, <kbd>Q</kbd>
+back to Draw (also on the top shelf and in the **Transform** palette).
+
+- **Handles over the model.** Arrows, plane squares and a free-move centre; axis rings and a view ring; axis
+ boxes and a uniform centre. <kbd>Shift</kbd> snaps to 15 degrees, the grid or 10% steps.
+- **Only the unmasked part moves**, so posing is: mask the body, <kbd>Alt</kbd>+click the shoulder to put the
+ pivot there, raise **Falloff** for a soft joint, turn the arm. With X symmetry both arms move together.
+- **Pivot tools**: <kbd>Alt</kbd>+drag the gizmo to move it alone, **Reset**, **To Surface**, World or Surface
+ axes.
+- **Numeric entry** in the Gizmo 3D panel, **All SubTools** (Transpose All), one undo step per drag, sculpt
+ layers move with the surface, and the `transform` command for scripts.
+- Fast on big models: a drag frame on 1.3 million triangles takes about 10 ms.
+
+<kbd>W</kbd> no longer toggles the wireframe: use <kbd>Shift</kbd>+<kbd>F</kbd> (as in ZBrush) or **PolyF** on the
+right shelf. See [Moving, rotating and posing](gizmo.md).
+
+### Normal, displacement and AO map baking
+
+Bake the detail of a high-poly sculpt into maps on a low-poly's UVs, for game engines and renderers:
+**Tool > Bake**.
+
+- **Six maps in one go**: tangent-space normal, object-space normal, displacement (16-bit PNG with mid-grey =
+ 0, plus a 32-bit EXR in world units), ambient occlusion, cavity and colour (polypaint or texture).
+- **Right in every engine.** Tangent-space maps use MikkTSpace tangents, as Blender, Unreal, Unity and Godot
+ do; pick the OpenGL or DirectX green convention.
+- **Check it on the model.** The low-poly shows its baked normal map in the viewport as soon as the bake ends,
+ next to the high-poly.
+- **ZBrush-style controls**: source SubTool, 1K-8K, anti-aliasing, automatic or manual front and rear ray
+ distances, padding around UV islands. Bakes run in the background on every core, with progress and Cancel.
+- **Send to Unreal** brings the normal map along, set up as a normal map. The `bake` command does it all from
+ scripts.
+
+See [Baking normal and displacement maps](baking.md).
+
+ ### Quad retopology and detail projection
+
+ - **QRemesh** (**Tool > Geometry**, like ZRemesher) rebuilds a sculpt as clean quads whose edge loops follow
+ the forms, near a **Target Polygons** count, in the background. **Keep Groups**, **Adaptive Size**,
+ **Use Polypaint**, **Symmetry** and **Half / Same / Double** work as in ZBrush.
+ - **ProjectAll** (**Tool > SubTool > Project**) puts the sculpted detail and polypaint back onto the divided
+ quads, with **Dist**, **Mean** and **PA Blur**, and respects the mask.
+
+ See [Quad retopology and detail projection](retopology.md).
+
## Version 0.4.2
### Texture painting on UV maps
diff --cc src/app/App.cpp
index f00dbcf4,5f3b0282..21ce16b4
--- a/src/app/App.cpp
+++ b/src/app/App.cpp
@@@ -340,7 -340,7 +340,8 @@@ int App::runUiTest(int w, int h, int fp
pollUnreal();
pollGenerator();
pollAutoUv();
+ pollBake();
+ pollQRemesh();
updateCameraAspect();
Demo::beginFrame();
@@@ -493,7 -493,7 +494,8 @@@ int App::runRecording()
pollBrushRequest();
pollUnreal();
pollAutoUv();
+ pollBake();
+ pollQRemesh();
updateCameraAspect();
Demo::beginFrame();
@@@ -558,7 -558,7 +560,8 @@@ int App::run()
pollUnreal();
pollGoz();
pollAutoUv();
+ pollBake();
+ pollQRemesh();
int fbW = 0, fbH = 0, winW = 0, winH = 0;
SDL_GetWindowSizeInPixels(window_, &fbW, &fbH);
@@@ -1220,7 -1209,8 +1223,8 @@@ void App::drawUi()
"version 3 or later. It comes with ABSOLUTELY NO WARRANTY.");
ImGui::Spacing();
ImGui::TextWrapped("Built with SDL 3 (zlib), Dear ImGui (MIT), GLM (MIT), stb (MIT/public domain), ufbx "
- "(MIT/public domain), xatlas (MIT), MikkTSpace (zlib) and the Inter typeface (SIL OFL 1.1). Uses libcurl (curl license) "
- "(MIT/public domain), xatlas (MIT) and the Inter typeface (SIL OFL 1.1). QRemesh follows Instant Meshes "
++ "(MIT/public domain), xatlas (MIT), MikkTSpace (zlib) and the Inter typeface (SIL OFL 1.1). QRemesh follows Instant Meshes "
+ "(BSD-3-Clause). Uses libcurl (curl license) "
"where available.");
ImGui::Spacing();
if (ImGui::Button("License")) SDL_OpenURL("https://github.com/islandmed/SculptForge/blob/main/LICENSE");
diff --cc src/app/App.h
index ad892ec9,040769b1..9e9316d6
--- a/src/app/App.h
+++ b/src/app/App.h
@@@ -19,8 -19,8 +19,9 @@@
#include "core/Commands.h"
#include "core/Image.h"
#include "core/Document.h"
+#include "core/MeshTransform.h"
#include "core/AutoUv.h"
+ #include "core/QRemesh.h"
#include "core/Stroke.h"
#include "core/Tablet.h"
#include "core/Texture.h"
diff --cc src/app/Config.cpp
index 414361b7,464f96a3..3774b1ef
--- a/src/app/Config.cpp
+++ b/src/app/Config.cpp
@@@ -330,8 -307,7 +330,9 @@@ void App::initActions()
// the same id and own P (Paint), the symmetry toggles and Tab.
registerShellActions();
registerTextureUiActions(); // Tool > Texture Map, the Vertex / Texture paint target (PanelTexture.cpp)
+ registerGizmoActions(); // Q W E R: Draw, and the Gizmo 3D's Move, Scale, Rotate (Gizmo.cpp)
+ registerBakeUiActions(); // Tool > Bake (PanelBake.cpp)
+ registerRetopoUiActions(); // Geometry > QRemesh, SubTool > ProjectAll (PanelRetopo.cpp)
// Every command, so the command palette finds anything scriptable.
actions_.registerCommands(
diff --cc src/app/UiTest.cpp
index 01be0b97,48c69cad..068fed08
--- a/src/app/UiTest.cpp
+++ b/src/app/UiTest.cpp
@@@ -61,13 -55,8 +61,14 @@@
// painting goes into the texture), texture_layers, active_texture_layer,
// texture_painted (texels of the texture composite that aren't white),
// texture_mean_r / texture_mean_g / texture_mean_b (mean composite, sRGB 0-255),
- // auto_uv_running
+ // auto_uv_running, qremesh_running (QRemesh working in the background),
+ // quads (quad pairs in the active SubTool), quad_percent (quads among its polygons)
+// sdiv (the current subdivision level, 1 = base; 0 without levels), sdiv_levels (0 = none)
+// gizmo_mode (0 Draw, 1 Move, 2 Scale, 3 Rotate), gizmo_hover (handle under the cursor,
+// 0 = none, in gizmo_drag's order from 1), gizmo_falloff, pivot_x / pivot_y / pivot_z,
+// center_x / center_y / center_z and size_x / size_y / size_z (active mesh bounds)
+// bake_running, baked_maps (maps in the last bake), bake_size, bake_files (files it wrote),
+// normal_map_preview (1 when the active SubTool shows its baked normal map)
// (mesh values are the active SubTool's)
// snapshot remember the active mesh's vertices (for the moved* values)
// remember VALUE NAME keep VALUE's current value as $NAME
@@@ -238,7 -224,10 +239,11 @@@ double Demo::query(const std::string& n
if (name == "texture_layers") return hasTexture(m) ? double(m.texture->layers.size()) : 0.0;
if (name == "active_texture_layer") return hasTexture(m) && !m.texture->layers.empty() ? double(m.texture->activeLayer) : -1.0;
if (name == "auto_uv_running") return app_.autoUv_ ? 1.0 : 0.0;
+ if (const double v = app_.bakeTestValue(name); !std::isnan(v)) return v;
+ if (name == "qremesh_running") return app_.qremesh_ ? 1.0 : 0.0;
+ if (name == "quads") return double(m.quadCount());
+ if (name == "quad_percent")
+ return m.triangleCount() ? 100.0 * double(m.quadCount()) / double(m.triangleCount() - m.quadCount()) : 0.0;
if (name == "texture_painted" || name.rfind("texture_mean_", 0) == 0) {
if (!hasTexture(m)) return 0.0;
const std::vector<uint8_t>& px = m.texture->pixels;
@@@ -761,7 -691,7 +766,7 @@@ bool Demo::parseStep(int line, const st
const bool idle = !busy(app_.pendingBrush_) && !busy(app_.pendingGenerator_) && !busy(app_.pendingModels_) &&
!busy(app_.pendingUnreal_) && !busy(app_.pendingComfyCheck_) && !app_.galleryBusy() &&
!app_.thumbs_.busy() && !app_.libraryScanner_.busy() && !app_.autoUv_ &&
- !app_.bakeBusy();
- !app_.qremesh_;
++ !app_.bakeBusy() && !app_.qremesh_;
if (idle) return true;
SDL_Delay(10); // real work runs in real time
if (t > timeout) fail(line, "still busy after " + number(timeout) + " s");