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 and changelog: QRemesh 2 (method, quality report, how it works, comparison with the legacy method), third-party notice

islandmed194556e712fe
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 41e8bc82..1b4e3db4 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -17,7 +17,10 @@ All notable changes to SculptForge are listed here. The format follows
change of density needs; symmetry mirrors the field and the result exactly; the result is deterministic.
Loop-aware relaxation lets vertices slide along loops on ridges but not off them. Against the legacy method on
the lion scan, the ICT head, a creature sculpted from a sphere and a hard-surface part at 2k / 5k / 10k quads:
- BENCHSUMMARY
+ a quarter to a fiftieth of the poles at the same distance to the sculpt (lion 5k: 1,028 → 199 poles, corners
+ 18.2° → 7.9° off square; ICT head 5k: 511 → 186; creature 10k: 308 → 37; a 1.3M-triangle sculpt at 10k:
+ 401 → 8; boxes: one pole per corner and 0.000% distance). The full table is in the guide (Quad retopology >
+ How it works). A 1.3M-triangle sculpt takes about 4 s to 5,000 quads.
- **Quality report** after QRemesh, in the status line, the QRemesh panel and the `qremesh` command's message:
poles (by valence), how far quad corners are from square, and the distance to the sculpt (mean and Hausdorff).
`quality=false` skips the measuring.
diff --git a/docs/guide/images/qremesh2-compare.jpg b/docs/guide/images/qremesh2-compare.jpg
new file mode 100644
index 00000000..5173da5d
Binary files /dev/null and b/docs/guide/images/qremesh2-compare.jpg differ
diff --git a/docs/guide/retopology.md b/docs/guide/retopology.md
index a6f93c1a..a07dc64b 100644
--- a/docs/guide/retopology.md
+++ b/docs/guide/retopology.md
@@ -102,13 +102,32 @@ al. 2013), in its own implementation:
With **Symmetry** one half is remeshed with the mirror plane as a feature line and mirrored, so the field and
the result are exactly symmetric. The result is the same every time for the same settings.
-Compared with the legacy method on the same models and targets (M1 Pro, 10 cores), QRemesh 2 has a quarter to a
-tenth of the poles and quad corners closer to square at the same distance to the sculpt:
-
-BENCHTABLE
-
-A 1.3-million-triangle sculpt takes about 4 seconds to 5,000 quads; dense sculpts are first decimated in
-parallel to a working resolution, so 21 million triangles take DENSE21.
+![The lion scan at 5,000 quads. Left: the legacy method, 1,028 poles. Right: QRemesh 2, 199 poles, with loops along the mane and round the muzzle and a clean box on the base](images/qremesh2-compare.jpg)
+
+Compared with the legacy method on the same models and targets, QRemesh 2 has a quarter to a fiftieth of the
+poles at the same distance to the sculpt (poles, then the mean angle of quad corners off 90 degrees, then the mean
+distance in % of the model's size; legacy first):
+
+| Model | Target | Poles | Corners off square | Distance |
+|---|---|---|---|---|
+| Lion scan (47k triangles) | 2,000 | 433 to 116 | 22.7° to 7.8° | 0.295% to 0.290% |
+| | 5,000 | 1,028 to 199 | 18.2° to 7.9° | 0.125% to 0.120% |
+| | 10,000 | 1,665 to 398 | 14.5° to 8.3° | 0.059% to 0.060% |
+| ICT head (28k, symmetry) | 2,000 | 269 to 128 | 12.6° to 8.1° | 0.112% to 0.106% |
+| | 5,000 | 511 to 186 | 8.8° to 8.4° | 0.040% to 0.044% |
+| | 10,000 | 727 to 248 | 6.6° to 7.9° | 0.016% to 0.019% |
+| Creature from a sphere (82k, symmetry) | 2,000 | 96 to 22 | 4.6° to 8.5° | 0.035% to 0.037% |
+| | 10,000 | 308 to 37 | 3.4° to 6.8° | 0.007% to 0.007% |
+| Hard-surface part (3 boxes) | 2,000 | 56 to 24 | 2.0° to 0.7° | 0.082% to 0.000% |
+| | 10,000 | 24 to 28 | 0.3° to 0.7° | 0.000% to 0.000% |
+| Sculpted sphere (1.3M) | 2,000 | 84 to 8 | 4.3° to 3.9° | 0.037% to 0.035% |
+| | 10,000 | 401 to 8 | 4.3° to 5.2° | 0.008% to 0.007% |
+
+On smooth sculpts with Adaptive Size the corners are a few degrees further from square than the legacy method's:
+the grid bends to vary the quad size instead of adding poles. Set Adaptive Size to 0 for the squarest grid.
+
+A 1.3-million-triangle sculpt takes about 4 seconds to 5,000 quads on a 10-core M1 Pro; denser sculpts are first
+decimated in parallel blocks to a working resolution (DENSE21).
The legacy method (**Method > Legacy**, `method=legacy`) is the Instant Meshes style field-aligned method of
SculptForge 0.9 (Jakob, Tarini, Panozzo and Sorkine-Hornung, 2015): faster on small models but with many more