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.
C++ 3d3d-sculptingcppdear-imguidigital-sculptingfbxgame-developmentgaussian-splattinggltfimage-to-3dmcpopenglopenusdsculptingtext-to-3dunreal-engine
<!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'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'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'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'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 > 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 > Materials > Viewport Shading > 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 > Texture Map > Auto UV</strong>, then <strong>New Texture</strong>).
</li>
<li>
In <strong>Tool > 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'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'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'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's own surface, baked on its UVs at its texture'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'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 > Bake</strong> (<a href="baking.html">Baking</a>): it also bakes from a Part'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's Fill layers with <code>material_recipe action=save name="My Rust" 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'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'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 > 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 & 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>