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.

35.2 KB
Raw Blame
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Quad retopology and detail projection - SculptForge User Guide</title>
  <meta name="description" content="Quad Remesh rebuilds a sculpt as clean, all-quad topology whose edge loops follow the forms. Project Detail then moves a mesh onto the surface of other Parts, so the detail of the original sculpt comes back onto the new topology. Together they turn a dense, messy sculpt (a voxel remesh, a scan, an A">
  <meta name="theme-color" content="#111114">
  <meta name="color-scheme" content="dark">
  <link rel="icon" type="image/png" sizes="32x32" href="../img/favicon-32.png?v=7">
  <link rel="icon" type="image/png" sizes="64x64" href="../img/favicon-64.png?v=7">
  <link rel="apple-touch-icon" href="../img/apple-touch-icon.png?v=7">
  <link rel="canonical" href="https://sculptforge.app/guide/retopology.html">
  <meta property="og:type" content="article">
  <meta property="og:title" content="Quad retopology and detail projection - SculptForge User Guide">
  <meta property="og:description" content="Quad Remesh rebuilds a sculpt as clean, all-quad topology whose edge loops follow the forms. Project Detail then moves a mesh onto the surface of other Parts, so the detail of the original sculpt comes back onto the new topology. Together they turn a dense, messy sculpt (a voxel remesh, a scan, an A">
  <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=5">
  <meta property="og:url" content="https://sculptforge.app/guide/retopology.html">
  <link rel="stylesheet" href="../style.css?v=19">
  <script src="../motion.js?v=12" defer></script>
  <script data-goatcounter="https://sculptforge.goatcounter.com/count" async src="https://gc.zgo.at/count.js"></script>
  <script src="search-index.js?v=52" defer></script>
</head>
<body class="guide-page" data-prev="cut.html" data-next="generate-3d.html">
  <div class="scroll-progress" aria-hidden="true"></div>
  <header class="nav">
    <div class="wrap nav-inner">
      <a class="brand" href="../index.html"><img class="brand-mark" src="../img/bust-mark-44.png" srcset="../img/bust-mark-88.png 2x, ../img/bust-mark-132.png 3x" width="44" height="44" alt=""><span>SculptForge</span></a>
      <nav aria-label="Main">
        <a href="../index.html#features">Features</a>
        <a href="../index.html#demos">Demos</a>
        <a href="../brushes.html">Brushes</a>
        <a href="index.html" aria-current="page">Guide</a>
        <a class="nav-dl" href="../index.html#download">Download</a>
        <a class="gh" href="https://discord.gg/gWrYkEmQhH">Discord</a>
        <a class="gh" href="https://github.com/islandmed/SculptForge">GitHub</a>
      </nav>
    </div>
  </header>
  <div class="wrap guide-layout">
    <div class="guide-side">
      <button class="toc-toggle" type="button" aria-expanded="false" aria-controls="guide-toc">
        <span>Contents</span><span class="toc-current">Quad retopology and detail projection</span></button>
      <div id="guide-toc" class="toc-panel">
        <div class="guide-search" role="search">
          <input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
          <div class="search-results" id="guide-results" hidden></div>
        </div>
        <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="brush-packs.html">Brush packs</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="linked-duplicates.html">Linked Duplicates</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="tube.html">Tube: draw in 3D space</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html" class="current" aria-current="page">Quad retopology and detail projection</a><ul class="toc-sections"><li><a href="#the-usual-workflow">The usual workflow</a></li><li><a href="#quad-remesh">Quad Remesh</a></li><li><a href="#quad-remesh-guides">Quad Remesh Guides</a></li><li><a href="#project-detail">Project Detail</a></li><li><a href="#scripting">Scripting</a></li><li><a href="#see-also">See also</a></li></ul></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li><li><a href="security.html">Security overview for IT reviews</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li><li><a href="discord.html">Show SculptForge on Discord</a></li></ul></nav>
      </div>
    </div>
    <main class="guide-main" id="top">
      <article class="guide-article">
<h1 id="quad-retopology-and-detail-projection">Quad retopology and detail projection</h1>
<p><strong>Quad Remesh</strong> rebuilds a sculpt as clean, all-quad topology whose edge loops follow the forms. <strong>Project Detail</strong> then moves a mesh onto the surface of other Parts, so the detail of the original sculpt comes back onto the new topology. Together they turn a dense, messy sculpt (a voxel remesh, a scan, an AI-generated model) into a light quad mesh you can divide, sculpt on, unwrap and animate.</p>
<figure class="shot"><a href="images/qremesh.jpg" class="zoom"><img src="images/qremesh.jpg" alt="A lion bust after Quad Remesh: 5,000 quads whose loops follow the mane, shown with Wire" width="1100" height="660" loading="lazy" decoding="async"></a><figcaption>A lion bust after Quad Remesh: 5,000 quads whose loops follow the mane, shown with Wire</figcaption></figure>
<h2 id="the-usual-workflow">The usual workflow<a class="anchor" href="#the-usual-workflow" aria-label="Link to this section">#</a></h2>
<ol>
<li>
Select the sculpt and open <strong>Tool &gt; Remesh</strong> (the same Quad Remesh controls are also under <strong>Tool &gt; Geometry</strong>). Under <strong>Quad Remesh</strong>, turn on <strong>Keep Original</strong>.
</li>
<li>
Set <strong>Target Quads</strong> (for example 5000) and click <strong>Quad Remesh</strong>. It runs in the background: a progress bar replaces the button, and <strong>Cancel</strong> stops it. The result replaces the Part, and the sculpt as it was is kept as a hidden Part called &quot;<em>name</em> Original&quot; right below it.
</li>
<li>
Add two or three levels to the new mesh (<strong>Tool &gt; Geometry &gt; Add Level</strong>, <kbd>Ctrl</kbd>+<kbd>D</kbd>).
</li>
<li>
Show the original again (the eye in <strong>Tool &gt; Parts</strong>) and click <strong>Project Detail</strong> under <strong>Tool &gt; Parts &gt; Project</strong>. The divided quads snap onto the sculpt and take its vertex paint.
</li>
<li>
Hide or delete the original. You now have the same sculpt on clean quads.
</li>
</ol>
<figure class="shot"><a href="images/project-all.jpg" class="zoom"><img src="images/project-all.jpg" alt="Left: the retopology of a sculpted sphere. Right: divided twice and projected, the ridges and the crease are back" width="1320" height="510" loading="lazy" decoding="async"></a><figcaption>Left: the retopology of a sculpted sphere. Right: divided twice and projected, the ridges and the crease are back</figcaption></figure>
<p>Both steps are single undo steps (<kbd>Ctrl</kbd>+<kbd>Z</kbd>).</p>
<h2 id="quad-remesh">Quad Remesh<a class="anchor" href="#quad-remesh" aria-label="Link to this section">#</a></h2>
<p><strong>Tool &gt; Remesh &gt; Quad Remesh</strong> (also under <strong>Tool &gt; Geometry</strong>) works on the active Part.</p>
<div class="table-wrap"><table><thead><tr><th>Control</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Quad Remesh</strong></td><td>Starts the retopology. The status line reports the result and its quality, e.g. &quot;Quad Remesh: 5072 quads from 47214 triangles (100% quads) in 6.5 s. Quality: 260 poles (141 x3, 113 x5, 6 other), corners 8.5 deg off square, distance to the sculpt 0.106% mean / 1.27% max of its size&quot;</td></tr><tr><td><strong>Method</strong></td><td><strong>Quad Remesh 2</strong> (the default): the whole layout is solved at once as an integer grid, so poles appear only where the form needs them and loops run unbroken. <strong>Legacy</strong>: the method of SculptForge 0.9, kept for comparison and for closed guide loops</td></tr><tr><td><strong>Target Quads</strong></td><td>About how many quads to make (100 to 200,000 on the slider, more from scripts). The result is usually within 5% of it</td></tr><tr><td><strong>50% / 100% / 200%</strong></td><td>Set the target to half, the same as or twice the Part&#x27;s current polygon count</td></tr><tr><td><strong>Size Variation</strong></td><td>0 makes quads all about the same size. Higher values make smaller quads where the surface curves and bigger ones on flat areas, for the same total</td></tr><tr><td><strong>Follow Face Groups</strong></td><td>Edge loops run exactly along the face group borders, and the result keeps the face groups</td></tr><tr><td><strong>Keep Hard Edges</strong></td><td>Hard edges get an edge loop, so boxes and bevels stay crisp (on by default). Quad Remesh 2 takes faces meeting at more than about 60 degrees along a line at least a few quads long (a scan&#x27;s or a sculpt&#x27;s deep creases are left to the flow); the legacy method any edge over 50 degrees</td></tr><tr><td><strong>Use Vertex Paint</strong></td><td>Paint where you want density: red areas get up to four times the quads, blue areas down to a quarter, white areas are unchanged</td></tr><tr><td><strong>Symmetry</strong></td><td>Remesh one half and mirror it, welded on the seam, for exactly symmetric topology (on by default). It mirrors on the axis chosen in <strong>Sculpt &gt; Symmetry &amp; Gizmo</strong> (X if none), across the model&#x27;s own middle plane: the world&#x27;s centre plane when the model is symmetric about it, otherwise the plane through the model&#x27;s middle, so a model moved away from the centre works too. A model that isn&#x27;t mirror-symmetric is remeshed whole instead, and the status line says &quot;Symmetry off: the model isn&#x27;t mirror-symmetric&quot;; one that is nearly symmetric (a bump on one side) gets mirrored topology that follows each side&#x27;s own surface</td></tr><tr><td><strong>Keep Original</strong></td><td>Keep the Part as it was, hidden, below the new one, ready for Project Detail. Off: the Part is replaced (undo brings it back)</td></tr><tr><td><strong>Keep Masked</strong></td><td>Masked areas keep their triangles exactly, as a fixed piece: only the unmasked part is remeshed (the target counts its quads), and it&#x27;s joined to the masked part along the mask&#x27;s edge with a strip of triangles, so the model stays closed. If the mask&#x27;s edge can&#x27;t be joined up, the status line says so and nothing changes (off by default; <code>qremesh keep_masked=true</code>)</td></tr><tr><td><strong>Keep Texture</strong></td><td>Shown when the Part has a painted texture (on by default): Auto UV the result and project the texture onto it. Off: the texture is dropped</td></tr><tr><td><strong>Quad Remesh Guides</strong></td><td>Picks the guides brush: draw curves on the model for the edge loops to follow. See <a href="#quad-remesh-guides">Quad Remesh Guides</a></td></tr><tr><td><strong>Delete Last</strong> / <strong>Clear</strong></td><td>Delete the last guide curve drawn (with its mirror copies), or all of them</td></tr><tr><td><strong>Guide Strength</strong></td><td>How far around each guide the edge flow follows it: 0 = only the loop on the curve, 100 = about six quads to each side (default 50)</td></tr><tr><td><strong>Quality Report</strong></td><td>Shown after a Quad Remesh of the active Part: the poles (vertices with other than four edges, by how many edges), how far quad corners are from square (mean and worst 1%), and how far the new surface is from the sculpt (mean and maximum, in % of its size)</td></tr></tbody></table></div>
<p>What happens to your data:</p>
<ul>
<li>
The result is all quads (stored as pairs of triangles, so <strong>Wire</strong> draws quads and OBJ, FBX, PLY, USD and Bridge export them as quads), closed wherever the sculpt is closed. Open edges of the sculpt stay open, along the same outline.
</li>
<li>
Sculpt layers are baked into the surface: the result has no layers.
</li>
<li>
Mask and vertex paint are interpolated from the closest point of the sculpt (vertex paint is blurred to the new resolution until you project it back onto a divided copy).
</li>
<li>
Face Groups are kept with <strong>Follow Face Groups</strong>; otherwise the result is one face group. The old UVs are dropped. A painted texture is kept with <strong>Keep Texture</strong> (on by default): the result gets Auto UVs and the texture, every layer of it, is projected onto them from the old surface, in the same undo step. See <a href="texture-painting.html#uvs-and-geometry">Texture painting</a>.
</li>
<li>
Hidden parts are remeshed too.
</li>
<li>
Separate pieces stay separate and none is dropped: small ones (eyes, teeth, rivets, anything that would get fewer than about 100 quads) are remeshed on their own with at least 32 quads, more for small round pieces with Size Variation. A piece the grid can&#x27;t cover at all is kept as it was (as triangles).
</li>
<li>
Thin parts (a blade, a fin, a slab thinner than a quad) keep both their sides, and with <strong>Keep Hard Edges</strong> their hard edges keep a loop each and their corners stay put. Their corners can still be cut a little when the part is much thinner than a quad: raise the target, or use vertex paint density there.
</li>
</ul>
<h3 id="guiding-the-edge-flow">Guiding the edge flow<a class="anchor" href="#guiding-the-edge-flow" aria-label="Link to this section">#</a></h3>
<ul>
<li>
<strong>Quad Remesh Guides</strong> put an edge loop exactly where you draw: around the eyes, the mouth, a joint. See below.
</li>
<li>
<strong>Face Groups</strong> are as strong a guide. Paint a group around an eye, the mouth or a muscle, turn on <strong>Follow Face Groups</strong>, and loops will circle it. See <a href="face-groups.html">Face Groups</a>.
</li>
<li>
<strong>Vertex Paint</strong> sets the density with <strong>Use Vertex Paint</strong>: paint the face red and the back of the head blue to spend the quads where they matter.
</li>
<li>
<strong>Size Variation</strong> around 0.5 gives detailed areas more quads without your help; use 0 for an even mesh, for example before more sculpting.
</li>
</ul>
<h3 id="how-it-works">How it works<a class="anchor" href="#how-it-works" aria-label="Link to this section">#</a></h3>
<p>Quad Remesh 2 builds the layout the way recent research quad remeshers do (integer-grid maps, as in <em>Mixed-Integer Quadrangulation</em>, Bommes, Zimmer and Kobbelt 2009, and <em>Integer-Grid Maps for Reliable Quad Meshing</em>, Bommes et al. 2013), in its own implementation:</p>
<ol>
<li>
<strong>A working surface.</strong> The sculpt is brought to about three triangle edges per quad edge with even triangles (dense sculpts are first decimated in parallel blocks), keeping open edges, face group borders (<strong>Follow Face Groups</strong>) and real hard edges (<strong>Keep Hard Edges</strong>; creases shorter than two quads or softer than about 55 degrees at the quad scale are sculpt detail, not hard edges) on their exact place.
</li>
<li>
<strong>Curvature and directions.</strong> The principal curvature directions, smoothed over about one quad, and a smooth cross field (the directions the edges take) solved over the whole surface at once: it follows the curvature where the surface clearly bends one way (limbs, lips, brows, ridges), the feature lines exactly, and is as smooth as possible elsewhere. It is solved on a copy of the surface smoothed at the quad scale, so pores and scratches don&#x27;t add poles. Vertex Paint density turns it the way a change of density needs.
</li>
<li>
<strong>The grid.</strong> A seamless parametrization whose integer lines are the edge loops: feature lines and guides lie exactly on grid lines, singularities (the poles) exactly on grid points, and across the seams the grid only turns by quarter turns. Its integer unknowns are rounded nearest-first, each round followed by a re-solve.
</li>
<li>
<strong>Extraction</strong> of that grid at the target density (not split from a coarser one), every face a quad; the rare places where the grid folds are repaired locally and stay all quads.
</li>
<li>
<strong>Loop-aware relaxation</strong>: smoothing on the sculpt in which a vertex can slide along a loop that runs over a ridge but not off it, then projection onto the sculpt.
</li>
</ol>
<p>With <strong>Symmetry</strong> 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.</p>
<figure class="shot"><a href="images/qremesh2-compare.jpg" class="zoom"><img src="images/qremesh2-compare.jpg" alt="The lion scan at 5,000 quads. Left: the legacy method, 1,028 poles. Right: Quad Remesh 2, 199 poles, with loops along the mane and round the muzzle and a clean box on the base" width="1600" height="864" loading="lazy" decoding="async"></a><figcaption>The lion scan at 5,000 quads. Left: the legacy method, 1,028 poles. Right: Quad Remesh 2, 199 poles, with loops along the mane and round the muzzle and a clean box on the base</figcaption></figure>
<p>Compared with the legacy method on the same models and targets, Quad Remesh 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&#x27;s size; legacy first):</p>
<div class="table-wrap"><table><thead><tr><th>Model</th><th>Target</th><th>Poles</th><th>Corners off square</th><th>Distance</th></tr></thead><tbody><tr><td>Lion scan (47k triangles)</td><td>2,000</td><td>433 to 116</td><td>22.7° to 7.8°</td><td>0.295% to 0.290%</td></tr><tr><td></td><td>5,000</td><td>1,028 to 199</td><td>18.2° to 7.9°</td><td>0.125% to 0.120%</td></tr><tr><td></td><td>10,000</td><td>1,665 to 398</td><td>14.5° to 8.3°</td><td>0.059% to 0.060%</td></tr><tr><td>ICT head (28k, symmetry)</td><td>2,000</td><td>269 to 91</td><td>12.6° to 8.9°</td><td>0.108% to 0.101%</td></tr><tr><td></td><td>5,000</td><td>511 to 114</td><td>8.8° to 8.0°</td><td>0.039% to 0.040%</td></tr><tr><td></td><td>10,000</td><td>727 to 214</td><td>6.6° to 7.7°</td><td>0.015% to 0.018%</td></tr><tr><td>Creature from a sphere (82k, symmetry)</td><td>2,000</td><td>96 to 22</td><td>4.6° to 8.5°</td><td>0.035% to 0.037%</td></tr><tr><td></td><td>10,000</td><td>308 to 37</td><td>3.4° to 6.8°</td><td>0.007% to 0.007%</td></tr><tr><td>Hard-surface part (3 boxes)</td><td>2,000</td><td>56 to 24</td><td>2.0° to 0.7°</td><td>0.082% to 0.000%</td></tr><tr><td></td><td>10,000</td><td>24 to 28</td><td>0.3° to 0.7°</td><td>0.000% to 0.000%</td></tr><tr><td>Sculpted sphere (1.3M)</td><td>2,000</td><td>84 to 8</td><td>4.3° to 3.9°</td><td>0.037% to 0.035%</td></tr><tr><td></td><td>10,000</td><td>401 to 8</td><td>4.3° to 5.2°</td><td>0.008% to 0.007%</td></tr></tbody></table></div>
<p>On smooth sculpts with Size Variation the corners are a few degrees further from square than the legacy method&#x27;s: the grid bends to vary the quad size instead of adding poles. Set Size Variation to 0 for the squarest grid.</p>
<p>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: 5.2 million triangles take 7 to 9 seconds (1.3 GB at most) and 21 million about 20 seconds (4.7 GB), at 2,000 to 10,000 quads.</p>
<p>The legacy method (<strong>Method &gt; Legacy</strong>, <code>method=legacy</code>) 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 poles, and its result is extracted at twice the spacing and split, which shows as paired loops.</p>
<h2 id="quad-remesh-guides">Quad Remesh Guides<a class="anchor" href="#quad-remesh-guides" aria-label="Link to this section">#</a></h2>
<p>Draw curves on the sculpt and Quad Remesh puts an edge loop along each one, and turns the flow around it to follow, like quad remesh Guides brush. With Quad Remesh 2 an open curve is an exact edge loop: the grid line lies on it. Closed loops (round an eye) and loops across the symmetry plane are, for now, done by the legacy method for that piece (the status line says so). Use them where the topology has to work for animation: rings around the eyes and the mouth, loops around the shoulders, elbows and knees, a line down the middle of a muscle.</p>
<figure class="shot"><a href="images/qremesh-guides.jpg" class="zoom"><img src="images/qremesh-guides.jpg" alt="Left: Quad Remesh on its own. Middle: loops drawn round the eyes and the mouth with Quad Remesh Guides. Right: Quad Remesh again, with an edge loop on every curve and rings around them" width="1200" height="384" loading="lazy" decoding="async"></a><figcaption>Left: Quad Remesh on its own. Middle: loops drawn round the eyes and the mouth with Quad Remesh Guides. Right: Quad Remesh again, with an edge loop on every curve and rings around them</figcaption></figure>
<ol>
<li>
Click <strong>Quad Remesh Guides</strong> under <strong>Tool &gt; Geometry &gt; Quad Remesh</strong> (or pick it in the brush picker, <kbd>B</kbd>). The cursor becomes a small ring.
</li>
<li>
Drag on the model to draw a curve. It is drawn on the surface and snapped to it. A curve that ends near where it started is closed into a loop: draw round an eye and let go where you began.
</li>
<li>
With symmetry on (<kbd>X</kbd> in the top shelf), each curve is mirrored to the other side as you draw. A curve that is its own mirror image, a loop round the mouth across the middle, is kept once.
</li>
<li>
Click <strong>Quad Remesh</strong>. The status line says how many guides it followed.
</li>
</ol>
<p>Editing the curves:</p>
<ul>
<li>
<strong>Alt</strong>+click a curve to delete it (it turns red under the cursor while <kbd>Alt</kbd> is held), with its mirror copy.
</li>
<li>
<strong>Delete Last</strong> removes the last curve drawn; <strong>Clear</strong> removes them all.
</li>
<li>
<kbd>Ctrl</kbd> still masks and <kbd>Shift</kbd> still smooths while the guides brush is picked, and dragging the background still turns the view. Pick any brush to sculpt again.
</li>
</ul>
<p>The guides belong to the Part: each Part has its own, they are saved in the project, and <strong>Keep Original</strong> gives the kept original a copy, so you can change them and remesh again. They show over the model, solid while the guides brush is picked and thin otherwise, so you can see the loop Quad Remesh put on them. Drawing and deleting guides isn&#x27;t part of undo (<kbd>Ctrl</kbd>+<kbd>Z</kbd> undoes your sculpting as before).</p>
<p>Good to know:</p>
<ul>
<li>
Quad Remesh snaps the guides onto the sculpt as it is when you run it, so sculpting after drawing them is fine. A guide left far from the surface, for example after moving the Part with the Gizmo, is ignored and the status line says so: draw it again.
</li>
<li>
A loop gets an even number of quads around it, so it closes cleanly. Two guides closer together than about a quad compete for the same loop; draw them further apart or raise <strong>Target Quads</strong>. A very small loop, about 25 quads round or fewer, may not close, and the edges just outside it bend to fit the extra quads the next ring needs: raise <strong>Target Quads</strong>.
</li>
<li>
<strong>Guide Strength</strong> doesn&#x27;t change the loop on the curve, only how far around it the other edges turn to follow. Lower it when guides are close to each other or to the symmetry plane.
</li>
</ul>
<h3 id="how-the-guides-work">How the guides work<a class="anchor" href="#how-the-guides-work" aria-label="Link to this section">#</a></h3>
<p>Each curve constrains Quad Remesh&#x27;s cross field (the directions the edges take) to run along it, falling off over a few quads (<strong>Guide Strength</strong>), and adds a lattice line on the curve, so one edge loop lies on it. Along a closed curve the lattice corners are placed at even steps, an even number of them (a ring of quads round a disk always has an even number of sides), so the loop meets itself without a kink. With symmetry Quad Remesh remeshes one half, so a loop across the middle is cut there: its corners start on the seam, where it meets its mirror image. Quad Remesh then checks the loops and the quads near the guides; if a loop came out broken or a fan of seven or more edges sits by a guide, it tries again with a different start for the field and keeps the best. Measured on a sphere with a circular guide around an &quot;eye&quot;, the edges near the curve are within about 2 to 8 degrees of its direction (about 22 degrees without the guide), and the loop closes.</p>
<h2 id="project-detail">Project Detail<a class="anchor" href="#project-detail" aria-label="Link to this section">#</a></h2>
<p><strong>Tool &gt; Parts &gt; Project &gt; Project Detail</strong> projects every other <em>visible</em> Part onto the active one. Each vertex looks along its normal, both ways, and moves to the nearest surface it finds within <strong>Dist</strong>; if there is none straight along the normal, it takes the closest point within <strong>Dist</strong>.</p>
<div class="table-wrap"><table><thead><tr><th>Control</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Project Detail</strong></td><td>Projects the visible Parts onto the active one (one undo step)</td></tr><tr><td><strong>Dist</strong></td><td>How far to search, as a fraction of the Part&#x27;s size (bounding-box diagonal). Default 0.02. Raise it if parts don&#x27;t pick up the detail; lower it where two surfaces are close together (lips, eyelids, fingers)</td></tr><tr><td><strong>Blur</strong></td><td>Smooths the projected result this many times, to soften noise from the source</td></tr><tr><td><strong>Mean</strong></td><td>Where there is surface on both sides of a vertex, settle halfway between them instead of on the nearest</td></tr><tr><td><strong>Geometry</strong></td><td>Project the shape (into the active sculpt layer, if you have layers)</td></tr><tr><td><strong>Vertex Paint</strong></td><td>Project the vertex paint (into the active paint layer) when a source has any</td></tr></tbody></table></div>
<ul>
<li>
<strong>The mask protects:</strong> fully masked vertices don&#x27;t move; partly masked ones move part of the way. Mask the areas you have already fixed and project again with a different <strong>Dist</strong>.
</li>
<li>
Hidden faces of the source are ignored, and hidden parts of the target don&#x27;t move.
</li>
<li>
Project Detail is fast enough to use on dense meshes: about 0.6 seconds to project 1.25 million vertices from a 1.3-million-triangle sculpt.
</li>
</ul>
<aside class="callout callout-tip"><p><strong>Tip:</strong> Project after each division, not only at the end: divide once, Project Detail, divide again, Project Detail. Each pass starts closer to the sculpt, so a small <strong>Dist</strong> is enough and thin parts don&#x27;t jump to the wrong surface.</p></aside>
<h2 id="scripting">Scripting<a class="anchor" href="#scripting" aria-label="Link to this section">#</a></h2>
<div class="table-wrap"><table><thead><tr><th>Command</th><th>Options</th></tr></thead><tbody><tr><td><code>qremesh</code></td><td><code>method</code> (<code>v2</code>, the default, or <code>legacy</code>), <code>quality</code> (report poles, corner angles and the distance to the sculpt, default true), <code>target</code> (16 to 2,000,000, default 5000), <code>adaptive</code> (0-1, default 0.5), <code>keep_groups</code>, <code>detect_edges</code> (default true), <code>use_vertexpaint</code>, <code>symmetry</code> (<code>x</code>, <code>y</code> or <code>z</code>; off by default in scripts; the mirror plane is found from the model), <code>symmetry_center</code> (use this plane instead, e.g. <code>0</code> for the world&#x27;s centre), <code>keep_original</code>, <code>smooth</code> (relaxation passes, default 6), <code>seed</code> (legacy method only; Quad Remesh 2 has no random start), <code>keep_texture</code> (default true), <code>guides</code> (follow the Part&#x27;s Quad Remesh Guides, default true), <code>curves_strength</code> (0-100, default 50)</td></tr><tr><td><code>qremesh_guide</code></td><td><code>points</code> (the curve, <code>&quot;x,y,z x,y,z ...&quot;</code>), <code>view</code> (project the points onto the surface along this direction, as a stroke from the camera; default: each point to the closest surface point), <code>symmetry</code> (<code>x</code>, <code>xz</code>...; mirror the curve)</td></tr><tr><td><code>qremesh_guide_delete_last</code>, <code>qremesh_guides_clear</code>, <code>qremesh_guides_info</code></td><td>Delete the last curve, delete all, list them</td></tr><tr><td><code>project_all</code></td><td><code>distance</code> (0.001-1, default 0.02), <code>mean</code>, <code>blur</code> (0-20), <code>geometry</code> (default true), <code>vertexpaint</code> (default true), <code>source</code> (one Part&#x27;s name instead of all visible ones)</td></tr></tbody></table></div>
<div class="code-block"><pre class="code"><code class="language-sh">sculptforge-cli -c &#x27;open path=scan.glb; qremesh target=8000 adaptive=0.3 keep_original=true; subdivide levels=2; part_visibility index=1 visible=true; project_all distance=0.02; export_fbx path=retopo.fbx&#x27;</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
<div class="code-block"><pre class="code"><code class="language-sh">sculptforge-cli -c &#x27;open path=head.glb; qremesh_guide points=&quot;0.2,0.3,2 0.3,0.4,2 0.4,0.3,2 0.3,0.2,2 0.2,0.3,2&quot; view=0,0,-1 symmetry=x; qremesh target=4000 symmetry=x curves_strength=70&#x27;</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
<p>From scripts <code>qremesh</code> runs straight away (it doesn&#x27;t return until it&#x27;s done); in the app the button runs it in the background.</p>
<h2 id="see-also">See also<a class="anchor" href="#see-also" aria-label="Link to this section">#</a></h2>
<ul>
<li>
<a href="geometry.html">Subdivide, remesh, decimate and LODs</a>: voxel remesh first to fuse pieces, subdivide after Quad Remesh
</li>
<li>
<a href="parts.html">Parts</a>: show, hide and duplicate the original
</li>
<li>
<a href="face-groups.html">Face Groups and visibility</a>: guides for Follow Face Groups
</li>
<li>
<a href="projects.html">Projects</a>: Quad Remesh Guides are saved with each Part
</li>
<li>
<a href="texture-painting.html">Texture painting</a>: Auto UV on the new topology
</li>
</ul>
      </article>
      <nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="cut.html"><span>Previous</span>Cut: line, lasso, rectangle and polyline</a><a class="next" rel="next" href="generate-3d.html"><span>Next</span>Image and text to 3D</a></nav>
      <p class="guide-meta fine">Also in the app: <strong>Help &gt; User Guide</strong> (<kbd>Shift</kbd>+<kbd>F1</kbd>).
        Found a mistake? <a href="https://github.com/islandmed/SculptForge/edit/main/docs/guide/retopology.md">Edit this page on GitHub</a>.</p>
    </main>
    <aside class="on-page" aria-label="On this page"><p>On this page</p><ul><li><a href="#the-usual-workflow">The usual workflow</a></li><li><a href="#quad-remesh">Quad Remesh</a></li><li><a href="#quad-remesh-guides">Quad Remesh Guides</a></li><li><a href="#project-detail">Project Detail</a></li><li><a href="#scripting">Scripting</a></li><li><a href="#see-also">See also</a></li></ul></aside>
  </div>
  <footer class="footer">
    <div class="wrap footer-grid">
      <div>
        <a class="brand" href="../index.html"><img class="brand-mark" src="../img/bust-mark-44.png" srcset="../img/bust-mark-88.png 2x, ../img/bust-mark-132.png 3x" width="32" height="32" alt=""><span>SculptForge</span></a>
        <p class="fine">Copyright © 2026 The SculptForge contributors.<br>The SculptForge User Guide is part of
          SculptForge, licensed under the <a href="https://github.com/islandmed/SculptForge/blob/main/LICENSE">GNU GPL v3.0 or later</a>.</p>
      </div>
      <div class="links">
        <a href="../performance/">Performance</a>
        <a href="index.html">User guide</a>
        <a href="../supporters.html">Members</a>
        <a href="https://github.com/islandmed/SculptForge">Source code</a>
        <a href="https://discord.gg/gWrYkEmQhH">Community Discord</a>
        <a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
        <a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
      </div>
      <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
    </div>
  </footer>
</body>
</html>