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.

19.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>Fill layers, Mesh Maps and Material Recipes - SculptForge User Guide</title>
  <meta name="description" content="A Fill layer lays a material over the whole Part, through a mask that you build from effects instead of painting it by hand: worn paint on the edges, dirt in the crevices, dust on the surfaces that face up. The mask reads the Part&#x27;s Mesh Maps (its ambient occlusion, curvature, thickness and more, ba">
  <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/fill-layers.html">
  <meta property="og:type" content="article">
  <meta property="og:title" content="Fill layers, Mesh Maps and Material Recipes - SculptForge User Guide">
  <meta property="og:description" content="A Fill layer lays a material over the whole Part, through a mask that you build from effects instead of painting it by hand: worn paint on the edges, dirt in the crevices, dust on the surfaces that face up. The mask reads the Part&#x27;s Mesh Maps (its ambient occlusion, curvature, thickness and more, ba">
  <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=5">
  <meta property="og:url" content="https://sculptforge.app/guide/fill-layers.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="pbr-painting.html" data-next="layers.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">Fill layers, Mesh Maps and Material Recipes</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" class="current" aria-current="page">Fill layers, Mesh Maps and Material Recipes</a><ul class="toc-sections"><li><a href="#lay-a-material-recipe">Lay a Material Recipe</a></li><li><a href="#make-a-fill-layer">Make a Fill layer</a></li><li><a href="#mesh-maps">Mesh Maps</a></li><li><a href="#save-your-own-recipe">Save your own recipe</a></li><li><a href="#projects">Projects</a></li><li><a href="#commands">Commands</a></li></ul></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">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="fill-layers-mesh-maps-and-material-recipes">Fill layers, Mesh Maps and Material Recipes</h1>
<p>A <strong>Fill layer</strong> lays a material over the whole Part, through a <strong>mask</strong> that you build from effects instead of painting it by hand: worn paint on the edges, dirt in the crevices, dust on the surfaces that face up. The mask reads the Part&#x27;s <strong>Mesh Maps</strong> (its ambient occlusion, curvature, thickness and more, baked on its UVs), so the wear lands where the form says it should, and it moves with the form: sculpt a new crease and the paint chips along it a moment later. <strong>Material Recipes</strong> are ready-made stacks of Fill layers you can lay on any Part.</p>
<figure class="shot"><a href="images/fill-painted-edges.jpg" class="zoom"><img src="images/fill-painted-edges.jpg" alt="Painted Edges on a sculpted sphere: the paint has chipped away along the creases" width="760" height="600" loading="lazy" decoding="async"></a><figcaption>Painted Edges on a sculpted sphere: the paint has chipped away along the creases</figcaption></figure>
<p>Fill layers live in <strong>Tool &gt; Paint Layers</strong> next to your paint layers, on a Part with a texture (<a href="texture-painting.html">Texture painting</a>). Turn on <strong>Render &gt; Materials &gt; Viewport Shading &gt; PBR</strong> to see the metal, the roughness and the bumps as they will look in a game engine (<a href="pbr-painting.html#the-pbr-viewport">Material painting</a>).</p>
<h2 id="lay-a-material-recipe">Lay a Material Recipe<a class="anchor" href="#lay-a-material-recipe" aria-label="Link to this section">#</a></h2>
<ol>
<li>
Give the Part UVs and a texture (<strong>Tool &gt; Texture Map &gt; Auto UV</strong>, then <strong>New Texture</strong>).
</li>
<li>
In <strong>Tool &gt; Paint Layers</strong>, open <strong>Material Recipe</strong> and pick one:
<ul>
<li>
<strong>Worn Metal</strong>: dull steel, polished bright on the edges, grime in the creases.
</li>
<li>
<strong>Painted Edges</strong>: painted metal with the paint chipped off its edges.
</li>
<li>
<strong>Dirt and Dust</strong>: dirt packed in the crevices and pale dust on top, to lay over any material.
</li>
<li>
<strong>Rusted Iron</strong>: dark iron with rust spreading from the crevices.
</li>
</ul>
</li>
</ol>
<ol start="3">
<li>
The recipe adds its Fill layers on top of your layers, turning on the material channels it needs. The first time, the Part&#x27;s Mesh Maps are baked in the background (a progress bar shows); the layers fill in when they are ready.
</li>
</ol>
<p>Every layer of the recipe stays editable, and <strong>Undo</strong> removes the whole recipe in one step.</p>
<h2 id="make-a-fill-layer">Make a Fill layer<a class="anchor" href="#make-a-fill-layer" aria-label="Link to this section">#</a></h2>
<p><strong>+ Fill Layer</strong> adds a Fill layer in the current colour, covering everything. With it active, the panel shows:</p>
<ul>
<li>
<strong>Colour</strong> and the channels it lays down (<strong>BC</strong> base colour, <strong>R</strong> roughness, <strong>M</strong> metallic, <strong>H</strong> height), with a slider for each value.
</li>
<li>
<strong>Mask</strong>: the effects, top to bottom. Each one has a switch, a remove button and its own settings; from the second one on, a blend mode says how it combines with the effects above it (multiply, add, subtract, min, max, screen, replace).
</li>
<li>
<strong>Add mask effect</strong> adds one at the bottom.
</li>
</ul>
<figure class="shot"><a href="images/fill-layer-panel.jpg" class="zoom"><img src="images/fill-layer-panel.jpg" alt="The Fill layer panel: colour, channels and the mask effects with their settings" width="320" height="900" loading="lazy" decoding="async"></a><figcaption>The Fill layer panel: colour, channels and the mask effects with their settings</figcaption></figure>
<h3 id="mask-effects">Mask effects<a class="anchor" href="#mask-effects" aria-label="Link to this section">#</a></h3>
<div class="table-wrap"><table><thead><tr><th>Effect</th><th>What it does</th><th>Reads</th></tr></thead><tbody><tr><td><strong>Edge Wear</strong></td><td>Convex edges and ridges, where things get rubbed and chipped</td><td>Curvature</td></tr><tr><td><strong>Dirt</strong></td><td>Crevices, creases and corners, where dirt collects</td><td>Ambient occlusion, curvature</td></tr><tr><td><strong>Gradient</strong></td><td>Along a direction across the Part (e.g. darker toward the bottom)</td><td>Position</td></tr><tr><td><strong>Thickness</strong></td><td>Thin parts: ears, fins, edges of a blade</td><td>Thickness</td></tr><tr><td><strong>Light Direction</strong></td><td>Surfaces facing a direction: dust and snow on top, moss on one side</td><td>World normal</td></tr><tr><td><strong>Noise</strong></td><td>Fractal noise in 3D, so it has no seams at UV island borders</td><td>Position</td></tr><tr><td><strong>Paint</strong></td><td>A mask you paint by hand (below)</td><td></td></tr><tr><td><strong>Levels</strong></td><td>Input and output range and gamma of the mask so far</td><td></td></tr><tr><td><strong>Blur</strong></td><td>Softens the mask so far (within UV islands only)</td><td></td></tr><tr><td><strong>Invert</strong></td><td>Flips the mask so far</td><td></td></tr><tr><td><strong>Fill</strong></td><td>A constant value</td><td></td></tr></tbody></table></div>
<p>The generators (the first five) have the same settings: <strong>Level</strong> (how much of the surface they cover), <strong>Softness</strong> (how wide the transition is), <strong>Break-up</strong> (how much noise roughens the edge of the mask) and <strong>Noise size</strong> (as a fraction of the Part&#x27;s size).</p>
<h3 id="paint-a-mask">Paint a mask<a class="anchor" href="#paint-a-mask" aria-label="Link to this section">#</a></h3>
<p>Add a <strong>Paint</strong> effect, keep the Fill layer active and paint on the model with the <strong>Paint</strong> brush: you paint the layer&#x27;s mask (white adds, <kbd>Alt</kbd> removes), and the layer updates as you paint. Strokes undo like any stroke. Combine it with generators: for example <strong>Edge Wear</strong>, then <strong>Paint</strong> with <strong>Subtract</strong> to keep an edge clean by hand.</p>
<h2 id="mesh-maps">Mesh Maps<a class="anchor" href="#mesh-maps" aria-label="Link to this section">#</a></h2>
<p>Mesh Maps are the Part&#x27;s own surface, baked on its UVs at its texture&#x27;s size: <strong>ambient occlusion</strong>, <strong>curvature</strong> (convex edges bright, creases dark), <strong>thickness</strong>, <strong>position</strong> (16-bit), <strong>world normal</strong> and <strong>ID</strong> (a colour per face group). Fill layers read them; you don&#x27;t have to look at them.</p>
<p>The line under the Fill buttons says what is baked. <strong>Bake</strong> bakes them again in full (after changing the UVs, for example: that happens by itself when a Fill layer needs them). Baking runs on every core in the background.</p>
<p><strong>Live</strong> (on by default): after each stroke, only the tiles of the texture near what you sculpted are baked again, from the triangles within reach of the change, and the Fill layers re-evaluate those tiles. The result is the same as baking everything again (it is tested texel for texel), in a fraction of the time: on a test Part with 82,000 triangles and 2K maps, a full bake takes about 10 seconds and a local change about half a second. Turn <strong>Live</strong> off to keep the maps as they are while you sculpt.</p>
<p>To bake maps as image files for other programs, use <strong>Tool &gt; Bake</strong> (<a href="baking.html">Baking</a>): it also bakes from a Part&#x27;s top subdivision level onto its lowest, and to UDIM tiles.</p>
<h2 id="save-your-own-recipe">Save your own recipe<a class="anchor" href="#save-your-own-recipe" aria-label="Link to this section">#</a></h2>
<p>A recipe is a small text file (<code>.sfmaterial</code>) listing the Fill layers, their materials and masks. Save the active Part&#x27;s Fill layers with <code>material_recipe action=save name=&quot;My Rust&quot; path=my_rust.sfmaterial</code> and lay it on another Part with <code>material_recipe path=my_rust.sfmaterial</code>. The built-in recipes are files of the same kind in the source code&#x27;s <code>assets/materials</code> folder.</p>
<h2 id="projects">Projects<a class="anchor" href="#projects" aria-label="Link to this section">#</a></h2>
<p>Fill layers are saved with the project (format 7): their settings and painted masks, and their last result, so older versions open the project with the layers showing as ordinary paint layers. Mesh Maps are not saved; they are baked again when a Fill layer needs them.</p>
<h2 id="commands">Commands<a class="anchor" href="#commands" 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>material_recipe name=worn_metal</code></td><td>Lay a recipe on the active Part (<code>action=list</code>, <code>action=save path=...</code>, <code>path=file</code>)</td></tr><tr><td><code>fill_layer generator=edge_wear color=#e0e0e8 metallic=1 level=0.6</code></td><td>Add a Fill layer (<code>action=add</code> is the default)</td></tr><tr><td><code>fill_layer action=effect generator=dirt blend=add</code></td><td>Add a mask effect to the active Fill layer (<code>effect=1 level=0.4</code> edits one)</td></tr><tr><td><code>fill_layer action=remove_effect effect=1</code></td><td>Remove a mask effect</td></tr><tr><td><code>fill_layer action=set roughness=0.3</code></td><td>Change the layer&#x27;s material</td></tr><tr><td><code>mesh_maps</code></td><td>Bake the Mesh Maps now (<code>action=info</code>, <code>action=clear</code>, <code>action=live live=false</code>)</td></tr></tbody></table></div>
      </article>
      <nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="pbr-painting.html"><span>Previous</span>Material painting (PBR)</a><a class="next" rel="next" href="layers.html"><span>Next</span>Sculpt layers and blend shapes</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/fill-layers.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="#lay-a-material-recipe">Lay a Material Recipe</a></li><li><a href="#make-a-fill-layer">Make a Fill layer</a></li><li><a href="#mesh-maps">Mesh Maps</a></li><li><a href="#save-your-own-recipe">Save your own recipe</a></li><li><a href="#projects">Projects</a></li><li><a href="#commands">Commands</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>