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.

17.1 KB
Raw Blame
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Micro levels: hundreds of millions of polygons - SculptForge User Guide</title>
  <meta name="description" content="Subdivision levels store every vertex of every level. That is what lets you step down and reshape, but it costs about 90 bytes per triangle: a 300 million triangle model would need 27 GB. Micro levels go past the highest subdivision level without a mesh: each triangle of that level carries a regular">
  <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/micro-levels.html">
  <meta property="og:type" content="article">
  <meta property="og:title" content="Micro levels: hundreds of millions of polygons - SculptForge User Guide">
  <meta property="og:description" content="Subdivision levels store every vertex of every level. That is what lets you step down and reshape, but it costs about 90 bytes per triangle: a 300 million triangle model would need 27 GB. Micro levels go past the highest subdivision level without a mesh: each triangle of that level carries a regular">
  <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=5">
  <meta property="og:url" content="https://sculptforge.app/guide/micro-levels.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="subdivision-levels.html" data-next="dynamic-topology.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">Micro levels: hundreds of millions of polygons</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" class="current" aria-current="page">Micro levels: hundreds of millions of polygons</a><ul class="toc-sections"><li><a href="#making-a-micro-level">Making a micro level</a></li><li><a href="#sculpting">Sculpting</a></li><li><a href="#baking-down-and-exporting">Baking down and exporting</a></li><li><a href="#very-large-levels-and-laptops">Very large levels and laptops</a></li><li><a href="#scripting">Scripting</a></li><li><a href="#see-also">See also</a></li></ul></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">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="micro-levels-hundreds-of-millions-of-polygons">Micro levels: hundreds of millions of polygons</h1>
<p>Subdivision levels store every vertex of every level. That is what lets you step down and reshape, but it costs about 90 bytes per triangle: a 300 million triangle model would need 27 GB. <strong>Micro levels</strong> go past the highest subdivision level without a mesh: each triangle of that level carries a regular grid of heights, one 16-bit number per point, and the micro triangles are worked out on the fly by the brushes and by the graphics card. 300 million micro triangles take about 0.4 GB, sculpt in real time and draw at 60+ frames per second.</p>
<figure class="shot"><a href="images/micro-300m.jpg" class="zoom"><img src="images/micro-300m.jpg" alt="A sphere with 335 million micro triangles: surface noise, a Clay Block band, Crease and Sharp Crease lines (Micro 4, 420 MB)" width="1200" height="825" loading="lazy" decoding="async"></a><figcaption>A sphere with 335 million micro triangles: surface noise, a Clay Block band, Crease and Sharp Crease lines (Micro 4, 420 MB)</figcaption></figure>
<h2 id="making-a-micro-level">Making a micro level<a class="anchor" href="#making-a-micro-level" aria-label="Link to this section">#</a></h2>
<ol>
<li>
Add levels to the Part up to a comfortable highest one (0.3 to 2 million triangles is the sweet spot).
</li>
<li>
In <strong>Tool &gt; Geometry</strong>, set the <strong>Micro</strong> slider. Each step is four times the triangles: the label shows the total (Micro 4 on a 1.2 million triangle level is 300 million micro triangles).
</li>
<li>
Click <strong>Add Micro</strong>. The surface stays exactly as smooth as before; the micro level starts flat on it.
</li>
</ol>
<p>The micro level sits on the highest subdivision level, so step up to it first. While a micro level exists you can&#x27;t change subdivision levels (Bake it or delete it first).</p>
<div class="table-wrap"><table><thead><tr><th>Micro level</th><th>Micro triangles per triangle</th><th>Memory per micro triangle</th></tr></thead><tbody><tr><td>3</td><td>64</td><td>1.4 bytes</td></tr><tr><td>4</td><td>256</td><td>1.2 bytes</td></tr><tr><td>5</td><td>1,024</td><td>1.1 bytes</td></tr><tr><td>6, 7</td><td>4,096, 16,384</td><td>1.05 bytes</td></tr></tbody></table></div>
<p>For the smoothest view, prefer a higher micro level on fewer base triangles: 300 million as Micro 5 on 300,000 triangles draws faster than Micro 4 on 1.2 million.</p>
<h2 id="sculpting">Sculpting<a class="anchor" href="#sculpting" aria-label="Link to this section">#</a></h2>
<p>These brushes work on micro levels: <strong>Standard</strong>, <strong>Clay</strong>, <strong>Clay Block</strong>, <strong>Smooth</strong>, <strong>Inflate</strong>, <strong>Flatten</strong>, <strong>Trim</strong>, <strong>Layer</strong>, <strong>Pinch</strong>, <strong>Crease</strong>, <strong>Sharp Crease</strong> and <strong>Mask</strong> (with <kbd>Ctrl</kbd>). Symmetry, Falloff, pressure, alphas (Drag Stamp included) and the mask work as usual, and every stroke is one undo step.</p>
<ul>
<li>
A micro level stores one height per point, so it moves the surface in and out, never sideways. <strong>Pinch</strong>, <strong>Crease</strong> and <strong>Sharp Crease</strong> pull the height profile together instead of the points (the result looks the same for creases and folds), and stay clean at full strength.
</li>
<li>
<strong>Move</strong> reshapes the level below the micro level (the base) and the micro detail rides along on it, in its own frame: drag an ear back without smearing the pores. To move the micro surface itself along its normals, tick <strong>Move along normals</strong>.
</li>
<li>
Big brushes are evaluated on a coarser grid (about 50 points across the brush) and the change is spread smoothly over the points in between, so a brush that covers half the model costs about as much as a small one. The detail under it is kept.
</li>
<li>
Brushes that slide the surface (Tendril, Nudge, VDM stamps) and custom recipe brushes don&#x27;t apply to micro levels; recipe brushes act as Standard.
</li>
</ul>
<p>Vertex Paint, sculpt layers, face group colours and the wireframe aren&#x27;t shown on micro levels yet.</p>
<h2 id="baking-down-and-exporting">Baking down and exporting<a class="anchor" href="#baking-down-and-exporting" aria-label="Link to this section">#</a></h2>
<ul>
<li>
<strong>Bake Micro</strong> makes a regular mesh of the micro level in a new Part (the micro level stays). <code>micro_bake level=3</code> bakes a coarser micro level; <code>replace=true</code> replaces this Part instead. UVs, face groups, hidden faces and the micro mask carry over.
</li>
<li>
<strong>Export Displacement</strong> writes a 32-bit EXR displacement map over the base UVs (needs UVs) next to the project: the height of the micro surface above the flat base triangles, along the interpolated normal. <code>micro_export_displacement path=detail.png type=vector</code> writes a vector map (object space) or a 16-bit PNG (mid-grey = 0; the message says the scale).
</li>
</ul>
<p>Projects keep micro levels (project format 7; projects without one are still written as format 6, so older versions open them). Untouched areas take almost no room in the file.</p>
<h2 id="very-large-levels-and-laptops">Very large levels and laptops<a class="anchor" href="#very-large-levels-and-laptops" aria-label="Link to this section">#</a></h2>
<p>A micro level larger than the resident cache your hardware profile allows (a quarter of the memory when there is no profile yet) is kept <strong>out of core</strong>: in a file in the cache folder (<code>~/.cache/sculptforge</code>), of which only the parts you sculpt or look at stay in memory. A billion micro triangles then fit on a 16 GB machine. The status line under the slider says when a level is out of core. <code>SF_MICRO_OUT_OF_CORE=1</code> forces it (for testing); <code>SF_MICRO_SWAP_DIR</code> picks the folder.</p>
<p>How many triangles a frame draws for micro levels follows the machine: the view lowers the detail of far and small areas until a frame fits the budget (2 million on a laptop profile, 8 million on a workstation).</p>
<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>What it does</th></tr></thead><tbody><tr><td><code>micro_divide level=4</code> or <code>micro_divide triangles=300</code></td><td>Add a micro level (by level, or about this many million micro triangles)</td></tr><tr><td><code>micro_delete</code></td><td>Remove it (undoable)</td></tr><tr><td><code>micro_info</code></td><td>Level, micro triangles, memory, displacement range</td></tr><tr><td><code>micro_bake level=4 replace=false</code></td><td>Bake down to a mesh</td></tr><tr><td><code>micro_export_displacement path=disp.exr size=4096 type=scalar</code></td><td>Displacement map over the base UVs</td></tr><tr><td><code>micro_noise amplitude=0.0015 scale=120</code></td><td>Procedural surface noise over the whole micro level</td></tr></tbody></table></div>
<p><code>sculptforge --bench-micro --bench-sizes 33,100,300</code> measures memory, brush and frame times on your computer.</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="subdivision-levels.html">Subdivision levels</a>
</li>
<li>
<a href="performance.html">Performance</a>
</li>
<li>
<a href="baking.html">Baking normal and displacement maps</a>
</li>
</ul>
      </article>
      <nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="subdivision-levels.html"><span>Previous</span>Subdivision levels</a><a class="next" rel="next" href="dynamic-topology.html"><span>Next</span>Dynamic topology</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/micro-levels.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="#making-a-micro-level">Making a micro level</a></li><li><a href="#sculpting">Sculpting</a></li><li><a href="#baking-down-and-exporting">Baking down and exporting</a></li><li><a href="#very-large-levels-and-laptops">Very large levels and laptops</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>