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>Subdivide, remesh, decimate and LODs - SculptForge User Guide</title>
  <meta name="description" content="These tools change the topology of the active Part: add resolution for detail, rebuild an even surface, reduce the triangle count, make it symmetric, or make a chain of levels of detail for a game engine. This chapter explains what each one does to your mesh and its attributes, and when to use it.">
  <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/geometry.html">
  <meta property="og:type" content="article">
  <meta property="og:title" content="Subdivide, remesh, decimate and LODs - SculptForge User Guide">
  <meta property="og:description" content="These tools change the topology of the active Part: add resolution for detail, rebuild an even surface, reduce the triangle count, make it symmetric, or make a chain of levels of detail for a game engine. This chapter explains what each one does to your mesh and its attributes, and when to use it.">
  <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=5">
  <meta property="og:url" content="https://sculptforge.app/guide/geometry.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="gizmo.html" data-next="cut.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">Subdivide, remesh, decimate and LODs</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" class="current" aria-current="page">Subdivide, remesh, decimate and LODs</a><ul class="toc-sections"><li><a href="#at-a-glance">At a glance</a></li><li><a href="#quads-and-triangles">Quads and triangles</a></li><li><a href="#subdivide">Subdivide</a></li><li><a href="#voxel-remesh">Voxel remesh</a></li><li><a href="#quad-remesh">Quad Remesh</a></li><li><a href="#fill-holes">Fill Holes</a></li><li><a href="#decimate">Decimate</a></li><li><a href="#make-symmetric">Make Symmetric</a></li><li><a href="#mirror">Mirror</a></li><li><a href="#merge-by-distance">Merge by Distance</a></li><li><a href="#check-mesh">Check Mesh</a></li><li><a href="#lod-chains">LOD chains</a></li><li><a href="#undo-and-safety">Undo and safety</a></li><li><a href="#scripting">Scripting</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></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="subdivide-remesh-decimate-and-lods">Subdivide, remesh, decimate and LODs</h1>
<p>These tools change the topology of the active Part: add resolution for detail, rebuild an even surface, reduce the triangle count, make it symmetric, or make a chain of levels of detail for a game engine. This chapter explains what each one does to your mesh and its attributes, and when to use it.</p>
<p>All of them work on the <strong>active Part</strong> and, except the LOD preview, are undoable with <kbd>Ctrl</kbd>+<kbd>Z</kbd>.</p>
<p>In <strong>Tool &gt; Geometry</strong> they are grouped by what you do: <strong>Levels</strong> (see <a href="subdivision-levels.html">Subdivision levels</a>), <strong>Micro Detail</strong>, <strong>Resolution</strong> (Decimate, Quad Remesh, Subdivide), <strong>Cleanup</strong> (Fill Holes) and <strong>Symmetry</strong> (Make Symmetric).</p>
<h2 id="at-a-glance">At a glance<a class="anchor" href="#at-a-glance" aria-label="Link to this section">#</a></h2>
<div class="table-wrap"><table><thead><tr><th>Tool</th><th>Where</th><th>Triangles</th><th>Quads</th><th>Keeps sculpt layers</th><th>Keeps mask and vertex paint</th><th>Keeps face groups, hidden faces, UVs</th></tr></thead><tbody><tr><td>Add Level</td><td><strong>Tool &gt; Geometry &gt; Add Level</strong>, <kbd>Ctrl</kbd>+<kbd>D</kbd></td><td>x4 per level, lower levels kept</td><td>Each quad becomes four (Catmull-Clark)</td><td>Yes</td><td>Yes (interpolated)</td><td>Yes</td></tr><tr><td>Subdivide</td><td><strong>Tool &gt; Geometry &gt; Subdivide</strong></td><td>x4 per level</td><td>Each quad becomes four</td><td>Yes</td><td>Yes (interpolated)</td><td>Yes</td></tr><tr><td>Voxel Remesh</td><td><strong>Tool &gt; Remesh &gt; Voxel Remesh</strong></td><td>Set by resolution</td><td>All quads (new ones)</td><td>Baked in</td><td>Yes (transferred)</td><td>No (reset); a texture is kept on new UVs with Keep Texture</td></tr><tr><td>Quad Remesh</td><td><strong>Tool &gt; Geometry &gt; Quad Remesh</strong></td><td>Set by Target Quads</td><td>All quads, with edge loops</td><td>Baked in</td><td>Yes (transferred)</td><td>Face Groups with Follow Face Groups; no hidden faces; a texture is kept on new UVs with Keep Texture</td></tr><tr><td>Decimate</td><td><strong>Tool &gt; Geometry &gt; Decimate</strong></td><td>Reduced</td><td>No, all triangles</td><td>Yes</td><td>Yes</td><td>Yes</td></tr><tr><td>Make Symmetric</td><td><strong>Tool &gt; Geometry &gt; Symmetry</strong></td><td>Twice the kept side</td><td>Yes</td><td>Yes</td><td>Yes (mirrored)</td><td>Yes (mirrored)</td></tr><tr><td>LOD chain</td><td><strong>Tool &gt; Export</strong></td><td>One level per ratio step</td><td>LOD0 keeps them; lower levels are triangles</td><td>Yes, on every level</td><td>Yes</td><td>Yes</td></tr></tbody></table></div>
<h2 id="quads-and-triangles">Quads and triangles<a class="anchor" href="#quads-and-triangles" aria-label="Link to this section">#</a></h2>
<p>SculptForge sculpts on triangles, but it remembers which pairs of triangles were one quad. A model you open from the Bridge, Blender or Maya (OBJ, FBX, PLY, USD) keeps its quads: <strong>Wire</strong> draws them as quads, without the diagonal, and OBJ, FBX, PLY, USD and Bridge exports write them back as quads, corner for corner. Polygons with more than four sides are split into triangles. The new <strong>Plane</strong> and <strong>Cube</strong> are made of quads, and so is the result of a voxel remesh.</p>
<p>Sculpting, masking, vertex paint, sculpt layers, undo, Parts and project files all keep the quads. Subdivide turns every quad into four quads. Two things turn quads into triangles:</p>
<ul>
<li>
<strong>Decimate</strong> (and the lower levels of a LOD chain) collapses edges, so its result is all triangles.
</li>
<li>
When the two halves of a quad end up in different face groups, or one half is deleted, they show and export as two triangles.
</li>
</ul>
<p>glTF (<code>.glb</code>) and STL only hold triangles, so those exports always write triangles.</p>
<h2 id="subdivide">Subdivide<a class="anchor" href="#subdivide" aria-label="Link to this section">#</a></h2>
<p>For sculpting at several resolutions use <strong>Add Level</strong> (<kbd>Ctrl</kbd>+<kbd>D</kbd>), which keeps the lower levels to step back to: see <a href="subdivision-levels.html">Subdivision levels</a>. <strong>Subdivide (removes levels)</strong> is the one-way version; on a Part with levels it asks before removing them.</p>
<p><strong>Tool &gt; Geometry &gt; Subdivide</strong> smooths the mesh with Loop subdivision. Each level multiplies the triangle count by four and rounds off the shape slightly.</p>
<ul>
<li>
Sculpt layers are subdivided with the mesh, so blend shapes keep working.
</li>
<li>
Mask, vertex paint and UVs are interpolated; face groups and hidden faces carry over.
</li>
<li>
Each quad becomes four quads; triangles become four triangles.
</li>
<li>
SculptForge refuses to subdivide past 50 million triangles.
</li>
</ul>
<aside class="callout callout-note"><p><strong>Note:</strong> Subdivide replaces the mesh with a denser one and drops any <a href="subdivision-levels.html">subdivision levels</a>: it subdivides the level you are on, which becomes the new base, and the status line says so (undo brings the levels back). Voxel Remesh, Decimate and Quad Remesh do the same. To add triangles only where you sculpt, use <a href="dynamic-topology.html">Dynamic topology</a>.</p></aside>
<aside class="callout callout-tip"><p><strong>Tip:</strong> The bar along the top shows the triangle count of the whole scene. A few million triangles sculpt smoothly on a recent GPU; go up a level only when you need finer detail.</p></aside>
<h2 id="voxel-remesh">Voxel remesh<a class="anchor" href="#voxel-remesh" aria-label="Link to this section">#</a></h2>
<p><strong>Tool &gt; Remesh &gt; Voxel Remesh</strong> rebuilds the active Part as an even, watertight surface. Use it to:</p>
<ul>
<li>
fuse overlapping pieces into one surface (append a sphere, overlap it, merge, remesh);
</li>
<li>
even out stretched triangles after heavy Move or Tendril work;
</li>
<li>
clean up scans, splat conversions and AI-generated models before sculpting.
</li>
</ul>
<p>The <strong>Resolution</strong> slider next to the button sets how many voxels span the longest side of the model (32 to 512, as the <code>remesh</code> command; default 200). Higher keeps more detail and makes more triangles. 512 is safe on an 8 GB computer: a 28M-triangle scan remeshes at 512 in about 8 s (14 s on 4 cores) into about 760,000 triangles; a round 2M-triangle sculpt, which fills its box, in about 3 s (5 s on 4 cores) into about 2.5 million triangles, with about 2 GB of memory at its peak.</p>
<figure class="shot"><a href="images/remesh.jpg" class="zoom"><img src="images/remesh.jpg" alt="Wireframe of a model before and after a voxel remesh" width="900" height="437" loading="lazy" decoding="async"></a><figcaption>Wireframe of a model before and after a voxel remesh</figcaption></figure>
<p>What happens to your data:</p>
<ul>
<li>
Sculpt layers are baked into the surface: the result has no layers.
</li>
<li>
Mask and vertex paint are transferred from the nearest original vertex.
</li>
<li>
Face Groups, hidden faces and UVs are reset (everything becomes visible, one face group). Hidden parts are remeshed too.
</li>
<li>
A painted texture is kept with <strong>Keep Texture</strong> (on by default, shown next to the button when the Part has a texture): the result gets Auto UVs and the texture is projected onto it, every layer included, in the same undo step. This runs in the background (Auto UV of a few hundred thousand triangles takes several seconds) with a progress bar and <strong>Cancel</strong>. Off: the texture is dropped. See <a href="texture-painting.html#uvs-and-geometry">Texture painting</a>.
</li>
<li>
Separate pieces that don&#x27;t touch stay separate pieces; overlapping ones are merged.
</li>
<li>
The new surface is made of even quads (the original&#x27;s quads are rebuilt, not kept).
</li>
<li>
<strong>Keep Masked</strong> (off by default): masked areas keep their triangles exactly, detail included, and only the rest is remeshed. The new surface is joined to the masked area along the mask&#x27;s edge by a narrow strip of triangles, so the model stays closed. A triangle counts as masked when all three of its corners are at least half masked. A ragged mask edge is tidied by itself (#67): where it touches itself the corner triangles are remeshed, masked spots smaller than the new polygons are remeshed with the rest, and narrow gaps between masked areas are kept; the status line says when it did. If it still can&#x27;t be joined, the status line says what to change (blur or grow the mask, or unmask where two parts overlap) and nothing changes. Command: <code>remesh keep_masked=true</code>.
</li>
</ul>
<p>To remesh several Parts into one, first combine them with <strong>Merge visible...</strong> or <strong>Merge down...</strong> in <a href="parts.html#merge-parts">Parts</a>.</p>
<h3 id="quick-remesh">Quick Remesh<a class="anchor" href="#quick-remesh" aria-label="Link to this section">#</a></h3>
<p>Remesh as you sculpt, without going to the palette (#121). Turn on <strong>Tool &gt; Remesh &gt; Quick Remesh</strong>, then:</p>
<ul>
<li>
press <kbd>Shift</kbd>+<kbd>R</kbd>, or
</li>
<li>
hold <kbd>N</kbd> and click or drag on the background (anywhere off the model; on the model it stays a brush stroke).
</li>
</ul>
<p>Either one remeshes the active Part at the <strong>Resolution</strong> above, with <strong>Keep Masked</strong> and <strong>Keep Texture</strong> as set there. It runs in the background with the same progress bar and <strong>Cancel</strong>, so you can keep sculpting; the status bar says when it&#x27;s done and how many triangles the Part has now. Each remesh is one undo step. If you sculpt or undo while it runs, it doesn&#x27;t throw that work away: it remeshes the Part again as it is now.</p>
<p>Both keys change in <strong>Edit &gt; Preferences &gt; Hotkeys</strong> (<em>Quick Remesh</em> and <em>Quick Remesh (hold and drag)</em>). Neither <kbd>Shift</kbd>+<kbd>R</kbd> nor <kbd>N</kbd> is used by any key style, and holding <kbd>N</kbd> changes no other drag on the background: without it, a drag there turns, pans or zooms the view, or draws the mask and hide shapes, exactly as your key style says. With Quick Remesh off, the keys only tell you where to turn it on.</p>
<p><strong>Remesh after each stroke</strong> (off by default) does it for you: when you lift the pen after a stroke that stretched the surface (edges pulled to more than 1.6 times their length, as a long Move or Snake Hook pull does), the active Part is remeshed in the background. Strokes that don&#x27;t stretch anything, and masking or painting, never remesh. Sculpting never waits for it. It skips Parts with subdivision levels, sculpt layers or a painted texture (Keep Texture), where a remesh would bake or drop them; use the button or <kbd>Shift</kbd>+<kbd>R</kbd> there.</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; Geometry &gt; Quad Remesh</strong> is automatic quad retopology: it rebuilds the Part as clean quads whose edge loops follow the forms, close to a target polygon count, with Follow Face Groups, Size Variation, vertex paint density and symmetry. <strong>Project Detail</strong> (<strong>Tool &gt; Parts &gt; Project</strong>) brings the sculpted detail back onto the new topology after you divide it. Both have their own chapter: <a href="retopology.html">Quad retopology and detail projection</a>.</p>
<h2 id="fill-holes">Fill Holes<a class="anchor" href="#fill-holes" aria-label="Link to this section">#</a></h2>
<p><strong>Tool &gt; Geometry &gt; Fill Holes</strong> caps every open boundary of the active Part, such as a hole, an open bottom or the rim of an extracted shell. The new patch&#x27;s triangles are sized like the ones around the hole, and the patch follows the curve of the surface around it, so a hole in a sphere closes round, not flat. The rest of the Part is not changed. The patches get a <a href="face-groups.html">face group</a> of their own, so you can mask or hide them in one click. Fill Holes makes an open scan or an extracted part watertight without a remesh. <kbd>Ctrl</kbd>+<kbd>Z</kbd> brings the holes back.</p>
<h2 id="decimate">Decimate<a class="anchor" href="#decimate" aria-label="Link to this section">#</a></h2>
<p><strong>Tool &gt; Geometry &gt; Decimate</strong> reduces the triangle count while keeping the shape, using quadric edge collapse. The <strong>Keep</strong> slider next to the button sets the fraction of triangles to keep (0.05 to 0.95, default 0.50).</p>
<p>Decimation keeps open borders in place, and because it only removes vertices, every remaining vertex keeps its exact sculpt layer offsets, mask and vertex paint. Face Groups, hidden flags and UVs survive on the remaining triangles. The result is all triangles: quads are not kept.</p>
<p>With <strong>Keep Masked</strong> (under the button, off by default) masked vertices are never removed, so masked areas keep their triangles exactly and only the rest is decimated (<code>decimate keep_masked=true</code>).</p>
<p>Use it to make a lighter version of a finished sculpt for export, 3D printing or a review, or to bring a dense scan down to something you can work with.</p>
<aside class="callout callout-tip"><p><strong>Tip:</strong> Decimate a duplicate Part (<strong>Tool &gt; Parts &gt; Duplicate</strong>) when you want to keep the full-resolution sculpt in the same project.</p></aside>
<h2 id="make-symmetric">Make Symmetric<a class="anchor" href="#make-symmetric" aria-label="Link to this section">#</a></h2>
<p><strong>Make Symmetric</strong>, in <strong>Tool &gt; Geometry &gt; Symmetry</strong>, makes a model symmetric: it keeps the half on the</p>
<ul>
<li>
side of the chosen axis (+X is the model&#x27;s left, your right when you look at its face), mirrors it onto the other side and welds the two halves along the middle into one watertight mesh. Use it after sculpting one side without symmetry, to finish a half model, or to repair a model whose sides have drifted apart.
</li>
</ul>
<figure class="shot"><a href="images/mirror-weld.jpg" class="zoom"><img src="images/mirror-weld.jpg" alt="A head with a scar and a brow ridge on one side, then the same head after Make Symmetric X" width="900" height="648" loading="lazy" decoding="async"></a><figcaption>A head with a scar and a brow ridge on one side, then the same head after Make Symmetric X</figcaption></figure>
<ul>
<li>
Pick the axis with <strong>X</strong>, <strong>Y</strong> and <strong>Z</strong> beside the button (X is on by default). With several on, they apply one after the other.
</li>
<li>
The mirror plane goes through the world&#x27;s origin, the same plane symmetry uses. Polygons that cross it are cut on it, so the seam is clean wherever the model sits. Points on an open edge within 0.1% of the model&#x27;s size from the plane are welded onto it, which closes a half model whose seam isn&#x27;t exactly at 0.
</li>
<li>
Face Groups, vertex paint, the mask, UVs, quads and sculpt layers are kept; the mirrored side takes the kept side&#x27;s. Subdivision levels are removed (undo restores them), as with the other tools on this page.
</li>
<li>
To keep the <strong>other</strong> side, flip the model first with <strong>Tool &gt; Deformation &gt; Mirror</strong>, or run <code>mirror_and_weld side=negative</code>.
</li>
</ul>
<h2 id="mirror">Mirror<a class="anchor" href="#mirror" aria-label="Link to this section">#</a></h2>
<p><strong>Tool &gt; Deformation &gt; Mirror</strong> flips the Part across the plane through the origin on the chosen axes, with its surface still facing outward. Face Groups, vertex paint, UVs and layers come along; subdivision levels are removed (undo restores them). <code>mirror pivot=center</code> flips it in place about its own centre instead.</p>
<h2 id="merge-by-distance">Merge by Distance<a class="anchor" href="#merge-by-distance" aria-label="Link to this section">#</a></h2>
<p><strong>Tool &gt; Geometry &gt; Merge by Distance</strong> merges the points of the active Part that are closer together than the <strong>Distance</strong> slider into one. Use it on an import whose triangles don&#x27;t share their points (an STL, or a model another program split at its seams): until they are merged, every triangle is loose and a brush tears the surface apart.</p>
<ul>
<li>
The line under the slider counts the points that will merge, and those points show on the model in orange while the section is open. On meshes with more than 1.5 million points the count updates when you let go of the slider.
</li>
<li>
<strong>0</strong> merges only points exactly on top of each other. The slider goes up to 2% of the Part&#x27;s size; scripts can use any distance.
</li>
<li>
Points are taken in order: each one within the distance of a point kept before it merges into the nearest of them and takes its position, mask, vertex paint and sculpt layer offsets. Triangles that collapse (two corners on one point) are removed, and so are points no triangle uses.
</li>
<li>
One undo step. Subdivision levels are removed (undo restores them).
</li>
</ul>
<h2 id="check-mesh">Check Mesh<a class="anchor" href="#check-mesh" aria-label="Link to this section">#</a></h2>
<p><strong>Tool &gt; Geometry &gt; Check Mesh</strong> looks for what makes a mesh hard to sculpt, remesh, 3D print or export. <strong>Check</strong> counts the problems; it changes nothing. Each problem found gets a row with its count and a <strong>Fix</strong> button that changes only what that row names, as one undo step.</p>
<div class="table-wrap"><table><thead><tr><th>Row</th><th>What it is</th><th>What Fix does</th></tr></thead><tbody><tr><td><strong>Non-manifold edges</strong></td><td>Edges shared by three or more triangles (a fin, a wall inside the mesh)</td><td>Each triangle past the first two gets its own copy of the edge, so it comes loose; nothing is deleted</td></tr><tr><td><strong>Holes</strong></td><td>Open boundary loops</td><td>Caps each with a patch, as <a href="#fill-holes">Fill Holes</a> does</td></tr><tr><td><strong>Duplicate triangles</strong></td><td>Triangles on the same three points as another, either way round</td><td>Deletes the copies</td></tr><tr><td><strong>Degenerate triangles</strong></td><td>Triangles that use one point twice</td><td>Deletes them</td></tr><tr><td><strong>Zero-area triangles</strong></td><td>Three different points in one line (a sliver)</td><td>Collapses each one&#x27;s shortest edge</td></tr><tr><td><strong>Flipped triangles</strong></td><td>Triangles wound against their neighbours, or a closed piece that is inside out</td><td>Turns them to match the rest of their piece, and closed pieces right way out</td></tr><tr><td><strong>Isolated points</strong></td><td>Points no triangle uses</td><td>Removes them</td></tr></tbody></table></div>
<p><strong>Fix all</strong> fixes every row except <strong>Holes</strong>, in one undo step: a mesh can be open on purpose (a cloth panel, a mask, a relief), so holes are only capped when you click their own <strong>Fix</strong>. After a fix the list checks again.</p>
<h2 id="lod-chains">LOD chains<a class="anchor" href="#lod-chains" aria-label="Link to this section">#</a></h2>
<p>A level-of-detail chain is a series of lighter copies of the model for game engines: LOD0 is the full sculpt, and each level after it has a fixed fraction of the triangles of the one before.</p>
<ol>
<li>
Open <strong>Tool &gt; Export</strong>.
</li>
<li>
Set <strong>LODs</strong> (2 to 6 levels, including LOD0) and <strong>Reduction</strong> (the triangle ratio from one level to the next, 0.1 to 0.9, default 0.50).
</li>
<li>
Click <strong>Generate LOD chain</strong>.
</li>
</ol>
<figure class="shot"><a href="images/export.jpg" class="zoom"><img src="images/export.jpg" alt="The Export sub-palette with a generated LOD chain" width="320" height="740" loading="lazy" decoding="async"></a><figcaption>The Export sub-palette with a generated LOD chain</figcaption></figure>
<p>A table lists each level with its triangle count and its budget as a percentage of LOD0. Click a level to preview it on the canvas (wireframe turns on and sculpting pauses); click <strong>Sculpt</strong> in the table to go back to the editable mesh. The next stroke, or a change to <strong>LODs</strong> or <strong>Reduction</strong>, clears the chain; click <strong>Generate LOD chain</strong> again to rebuild it.</p>
<p>Blend shapes (<a href="layers.html">sculpt layers</a>) are kept on every level, so morph targets work at every LOD.</p>
<p>To write the chain to disk:</p>
<ul>
<li>
<strong>LOD chain (GLB per level)</strong> in the same sub-palette, or <strong>File &gt; Export LOD Chain...</strong>, writes one GLB per level named <code>&lt;name&gt;_LOD0.glb</code>, <code>&lt;name&gt;_LOD1.glb</code> and so on.
</li>
<li>
<strong>Send to Unreal</strong> and <strong>Export FBX for Unreal...</strong> pack the LODs into one FBX for Unreal&#x27;s automatic LOD import.
</li>
</ul>
<p>See <a href="exporting.html">Exporting</a> for these exports and their options.</p>
<aside class="callout callout-note"><p><strong>Note:</strong> The preview in <strong>Tool &gt; Export</strong> is of the active Part. The exports themselves build a chain for every visible Part.</p></aside>
<h2 id="undo-and-safety">Undo and safety<a class="anchor" href="#undo-and-safety" aria-label="Link to this section">#</a></h2>
<p>Subdivide, remesh, Quad Remesh, decimate, Make Symmetric, Mirror, Merge by Distance, every Check Mesh fix and Remove Hidden are single undo steps on the active Part. They can use a lot of memory on dense meshes, and undo keeps a full copy of the previous mesh for each of them. Before a big change on a heavy sculpt:</p>
<ul>
<li>
<strong>Snapshot</strong> (<strong>File &gt; Save Snapshot</strong>) keeps a timestamped copy of the scene without touching your project file; see <a href="projects.html#snapshots">Projects</a>.
</li>
<li>
<strong>Duplicate</strong> the Part to keep the old version side by side.
</li>
</ul>
<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>subdivide</code></td><td><code>levels</code> 1-4 (default 1)</td></tr><tr><td><code>remesh</code></td><td><code>resolution</code> 32-512 voxels across the longest side (default 200); <code>keep_texture</code> (default true)</td></tr><tr><td><code>decimate</code></td><td><code>ratio</code> 0.01-1 of the triangles to keep (default 0.5), or <code>triangles</code> for an exact target</td></tr><tr><td><code>qremesh</code></td><td><code>target</code> quads (default 5000), <code>adaptive</code>, <code>keep_groups</code>, <code>detect_edges</code>, <code>use_vertexpaint</code>, <code>symmetry</code>, <code>keep_original</code>, <code>keep_texture</code>; see <a href="retopology.html#scripting">Quad retopology</a></td></tr><tr><td><code>close_holes</code></td><td><code>max_edges</code> closes only holes with at most that many boundary edges (default 0: all); <code>refine</code> (default true; false: as few triangles as possible); <code>new_group</code> (default true)</td></tr><tr><td><code>mirror_and_weld</code></td><td><code>axis</code> x, y, z or several, e.g. <code>xz</code> (default x); <code>side</code> positive (default) or negative</td></tr><tr><td><code>mirror</code></td><td><code>axis</code> (default x); <code>pivot</code> origin (default) or center</td></tr><tr><td><code>weld_points</code></td><td><code>distance</code> in scene units (0: only exactly coincident points); <code>preview=true</code> only counts them</td></tr><tr><td><code>mesh_check</code></td><td>Lists the problems, e.g. <code>holes=2 flipped=14</code></td></tr><tr><td><code>mesh_fix</code></td><td><code>issue</code> non_manifold, holes, duplicate, degenerate, zero_area, flipped, isolated or all (all but holes)</td></tr><tr><td><code>export_lods</code></td><td><code>path</code> (base name), <code>levels</code> 1-8 including LOD0 (default 4), <code>ratio</code> 0.1-0.9 (default 0.5)</td></tr></tbody></table></div>
<div class="code-block"><pre class="code"><code class="language-sh">sculptforge-cli -c &#x27;open path=scan.obj; remesh resolution=256; decimate triangles=200000; export_lods path=out/rock.glb levels=4 ratio=0.5&#x27;</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
<p>The command line accepts a wider remesh range (32-512) than the palette slider.</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="retopology.html">Quad retopology and detail projection</a>: Quad Remesh and Project Detail
</li>
<li>
<a href="parts.html">Parts</a>: merge pieces before a remesh, duplicate before a decimate
</li>
<li>
<a href="layers.html">Sculpt layers and blend shapes</a>
</li>
<li>
<a href="exporting.html">Exporting</a>: LOD chains, FBX for Unreal, Send to Unreal
</li>
<li>
<a href="generate-3d.html">Image and text to 3D</a>: generated models are voxel-remeshed for sculpting
</li>
</ul>
      </article>
      <nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="gizmo.html"><span>Previous</span>Moving, rotating and posing (Gizmo)</a><a class="next" rel="next" href="cut.html"><span>Next</span>Cut: line, lasso, rectangle and polyline</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/geometry.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="#at-a-glance">At a glance</a></li><li><a href="#quads-and-triangles">Quads and triangles</a></li><li><a href="#subdivide">Subdivide</a></li><li><a href="#voxel-remesh">Voxel remesh</a></li><li><a href="#quad-remesh">Quad Remesh</a></li><li><a href="#fill-holes">Fill Holes</a></li><li><a href="#decimate">Decimate</a></li><li><a href="#make-symmetric">Make Symmetric</a></li><li><a href="#mirror">Mirror</a></li><li><a href="#merge-by-distance">Merge by Distance</a></li><li><a href="#check-mesh">Check Mesh</a></li><li><a href="#lod-chains">LOD chains</a></li><li><a href="#undo-and-safety">Undo and safety</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>