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
Merge QRemesh retopology and ProjectAll
islandmede8c9ff642436
diff --cc CHANGELOG.mdindex 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 mapsdiff --cc CMakeLists.txtindex c461d620,7be84df1..4d94baab--- a/CMakeLists.txt+++ b/CMakeLists.txt@@@ -57,14 -55,12 +57,18 @@@ add_library(sculptforge_core STATIsrc/core/PaintLayer.cppsrc/core/Texture.cppsrc/core/TextureCommands.cpp+ src/core/Multires.cpp+ src/core/MultiresCommands.cppsrc/core/AutoUv.cpp+ src/core/SurfaceQuery.cpp+ src/core/QRemesh.cpp+ src/core/Projection.cpp+ src/core/RetopoCommands.cppthird_party/xatlas/xatlas.cpp+ src/core/Bake.cpp+ src/core/BakeImage.cpp+ src/core/Tangents.cpp+ third_party/mikktspace/mikktspace.csrc/core/Matcap.cppsrc/core/Project.cppsrc/core/Guide.cpp@@@ -168,9 -164,7 +172,10 @@@ if(SCULPTFORGE_BUILD_APPsrc/app/PanelPolypaint.cppsrc/app/PanelPaintLayers.cppsrc/app/PanelTexture.cpp+ src/app/PanelGeometry.cpp+ src/app/Gizmo.cpp+ src/app/PanelBake.cpp+ src/app/PanelRetopo.cppsrc/app/PanelGoz.cppsrc/app/PanelProject.cppsrc/app/PanelSubTools.cppdiff --cc README.mdindex 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` fileskeep polygroups, mask and polypaint) or as OBJ, FBX or GLB.diff --cc ROADMAP.mdindex 1a5750f0,5267545f..3b05f80d--- a/ROADMAP.md+++ b/ROADMAP.md@@@ -109,12 -109,13 +109,13 @@@ always-latest downloadsRanked 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 brushesdiff --cc THIRD_PARTY_NOTICES.mdindex 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.mdindex 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.mdindex 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.mdindex 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 (**H11. [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 helpdiff --cc docs/guide/whats-new.mdindex 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 mapsdiff --cc src/app/App.cppindex 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 fppollUnreal();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.hindex 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.cppindex 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.cppindex 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& nif (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 stconst 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 timeif (t > timeout) fail(line, "still busy after " + number(timeout) + " s");