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.6 KB
Raw Blame
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Sculpt layers and blend shapes - SculptForge User Guide</title>
  <meta name="description" content="Sculpt layers hold changes on top of the base mesh, each with its own weight: a smile, a blink, a corrective shape or a variation you want to dial in and out. Because a layer is a set of per-vertex offsets, it exports straight to game engines and DCC tools as a blend shape (morph target). This chapt">
  <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/layers.html">
  <meta property="og:type" content="article">
  <meta property="og:title" content="Sculpt layers and blend shapes - SculptForge User Guide">
  <meta property="og:description" content="Sculpt layers hold changes on top of the base mesh, each with its own weight: a smile, a blink, a corrective shape or a variation you want to dial in and out. Because a layer is a set of per-vertex offsets, it exports straight to game engines and DCC tools as a blend shape (morph target). This chapt">
  <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=5">
  <meta property="og:url" content="https://sculptforge.app/guide/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="fill-layers.html" data-next="facial-shapes.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">Sculpt layers and blend shapes</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" class="current" aria-current="page">Sculpt layers and blend shapes</a><ul class="toc-sections"><li><a href="#how-layers-work">How layers work</a></li><li><a href="#the-layers-sub-palette">The Layers sub-palette</a></li><li><a href="#add-a-layer-and-sculpt-into-it">Add a layer and sculpt into it</a></li><li><a href="#adjust-and-preview-weights">Adjust and preview weights</a></li><li><a href="#delete-a-layer">Delete a layer</a></li><li><a href="#layers-and-subdivision-levels">Layers and subdivision levels</a></li><li><a href="#export-blend-shapes">Export blend shapes</a></li><li><a href="#scripting">Scripting</a></li><li><a href="#see-also">See also</a></li></ul></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="sculpt-layers-and-blend-shapes">Sculpt layers and blend shapes</h1>
<p>Sculpt layers hold changes on top of the base mesh, each with its own weight: a smile, a blink, a corrective shape or a variation you want to dial in and out. Because a layer is a set of per-vertex offsets, it exports straight to game engines and DCC tools as a blend shape (morph target). This chapter covers creating, sculpting into, weighting, playing and exporting layers.</p>
<h2 id="how-layers-work">How layers work<a class="anchor" href="#how-layers-work" aria-label="Link to this section">#</a></h2>
<ul>
<li>
Each layer stores how far every vertex moves from the base. The shape you see is the base plus every layer times its weight.
</li>
<li>
New strokes go into the <strong>active</strong> layer, or into the base mesh when <strong>Base mesh</strong> is selected.
</li>
<li>
Layers belong to a <a href="parts.html">Part</a>: each Part has its own list of layers.
</li>
<li>
A weight of 0 turns a layer off, 1 shows it as sculpted. Scripts can also set negative weights or weights above 1 to exaggerate a shape.
</li>
<li>
Layers work on every <a href="subdivision-levels.html">subdivision level</a>: see <a href="#layers-and-subdivision-levels">Layers and subdivision levels</a>.
</li>
<li>
Layers survive <a href="geometry.html#subdivide">subdividing</a>, <a href="geometry.html#decimate">decimating</a> and <a href="geometry.html#lod-chains">LOD chains</a>. A <a href="geometry.html#voxel-remesh">voxel remesh</a> bakes them into the surface (the layers are gone afterwards).
</li>
</ul>
<aside class="callout callout-note"><p><strong>Note:</strong> Sculpt layers are not the <strong>Layer</strong> brush. The Layer brush raises the surface to a fixed height; sculpt layers are the blend-shape stack described here.</p></aside>
<h2 id="the-layers-sub-palette">The Layers sub-palette<a class="anchor" href="#the-layers-sub-palette" aria-label="Link to this section">#</a></h2>
<p>Open <strong>Tool &gt; Layers</strong> in the right tray.</p>
<figure class="shot"><a href="images/layers.jpg" class="zoom"><img src="images/layers.jpg" alt="The Layers sub-palette with a base mesh and two blend shapes" width="320" height="520" loading="lazy" decoding="async"></a><figcaption>The Layers sub-palette with a base mesh and two blend shapes</figcaption></figure>
<p>From top to bottom:</p>
<ul>
<li>
<strong>Base mesh</strong>: select it to sculpt the base shape.
</li>
<li>
One block per layer: a radio button with the layer&#x27;s name (select it to sculpt into that layer), <strong>Play</strong>, <strong>X</strong> (delete) and a <strong>weight</strong> slider from 0 to 1.
</li>
<li>
A name field and <strong>+ Add</strong> at the bottom.
</li>
</ul>
<p>The Layers list highlights the active layer; in the Classic layout the title strip also shows it (<code>Layer Smile</code>, or <code>Layer Base</code>).</p>
<h2 id="add-a-layer-and-sculpt-into-it">Add a layer and sculpt into it<a class="anchor" href="#add-a-layer-and-sculpt-into-it" aria-label="Link to this section">#</a></h2>
<ol>
<li>
Type a name in the field at the bottom of <strong>Tool &gt; Layers</strong>, for example <code>Smile</code> or <code>BlinkL</code>.
</li>
<li>
Click <strong>+ Add</strong> (or press <kbd>Enter</kbd> in the field). The new layer becomes the active one.
</li>
<li>
Sculpt. Every stroke goes into the layer until you select another layer or <strong>Base mesh</strong>. Moving, scaling and rotating with the <a href="gizmo.html">Transform gizmo</a> (or the <code>transform</code> command) goes into the layer too, masked or not.
</li>
</ol>
<p>A layer whose weight is 0 can&#x27;t be sculpted into: SculptForge tells you to raise the weight first.</p>
<aside class="callout callout-tip"><p><strong>Tip:</strong> Name layers the way your engine or rig expects (<code>jawOpen</code>, <code>BlinkL</code>): the names become the blend shape and morph target names in exported files. For a face, <strong>Tool &gt; Facial Shapes</strong> makes all 52 ARKit shapes for you: see <a href="facial-shapes.html">Facial shapes and live face</a>.</p></aside>
<h2 id="adjust-and-preview-weights">Adjust and preview weights<a class="anchor" href="#adjust-and-preview-weights" aria-label="Link to this section">#</a></h2>
<ul>
<li>
Drag a layer&#x27;s <strong>weight</strong> slider to blend it in and out.
</li>
<li>
<strong>Play</strong> animates the layer from 0 to 1 and back, over and over, so you can judge the motion. Click <strong>Stop</strong> to end it; the weight returns to 1. Starting a stroke also stops playback.
</li>
</ul>
<p>Weights are saved with the project and used by exports that keep weights (USD writes the current weights).</p>
<h2 id="delete-a-layer">Delete a layer<a class="anchor" href="#delete-a-layer" aria-label="Link to this section">#</a></h2>
<p>Click <strong>X</strong> next to the layer. Its offsets are removed from the mesh and the base mesh becomes the active target. Deleting a layer is undoable.</p>
<h2 id="layers-and-subdivision-levels">Layers and subdivision levels<a class="anchor" href="#layers-and-subdivision-levels" aria-label="Link to this section">#</a></h2>
<p>With <a href="subdivision-levels.html">subdivision levels</a> a layer works the way 3D Layers do: record it at the top level for the fine detail of an expression, and it stays with the Part whatever level you work on.</p>
<ul>
<li>
<strong>Each layer has its own detail on every level.</strong> Step down with <strong>Lower Level</strong> (<kbd>Shift</kbd>+<kbd>D</kbd>) and a lower level shows the broad part of the layer, exactly as it would show the same strokes made in the base. Step back up and the layer is there as you recorded it, to the last vertex.
</li>
<li>
<strong>Weights are shared by all levels.</strong> Turn a layer off (weight 0) or blend it at a low level and the top shows the same when you go back up; the slider and <strong>Play</strong> work at every level.
</li>
<li>
<strong>Sculpt into a layer at any level.</strong> At a low level a stroke into a layer makes a broad change that the higher levels follow smoothly; the detail recorded above it stays. A layer added at a low level shows on every level above it too.
</li>
<li>
<strong>Reshape the base at a low level</strong> (or turn it with the <a href="gizmo.html">Gizmo</a>) and each layer&#x27;s detail rides on the new shape: its offsets turn with the surface instead of pointing the old way.
</li>
<li>
<strong>Add Level</strong> carries the layers to the new level. <strong>Rebuild Lower Levels</strong> keeps them, exact at the top. <strong>Remove Below</strong> and <strong>Remove Above</strong> keep the current level&#x27;s layers as they are.
</li>
<li>
<strong>Deleting a layer</strong> removes it from every level. Undo steps back through strokes, level changes and divisions with their layers.
</li>
<li>
<strong>Projects</strong> keep every level&#x27;s layers. <strong>Exports</strong> write the current level with its layers as blend shapes, so export from the top for the game mesh; <code>subdiv_export path=face_low.glb level=1</code> writes the base cage with its blend shapes instead.
</li>
</ul>
<p>The tools that rebuild the mesh (Voxel Remesh, Quad Remesh, Decimate, Subdivide) work on the current level and drop the levels, as described in <a href="subdivision-levels.html">Subdivision levels</a>; Voxel Remesh and Quad Remesh bake the layers into the surface.</p>
<h2 id="export-blend-shapes">Export blend shapes<a class="anchor" href="#export-blend-shapes" aria-label="Link to this section">#</a></h2>
<div class="table-wrap"><table><thead><tr><th>Format</th><th>What layers become</th></tr></thead><tbody><tr><td>glTF / GLB (<strong>File &gt; Export GLB...</strong>, <kbd>Ctrl</kbd>+<kbd>E</kbd>)</td><td>Morph targets</td></tr><tr><td>FBX</td><td>Blend shapes</td></tr><tr><td>USD / USDZ</td><td>UsdSkel blend shapes, with their current weights</td></tr><tr><td>Send to Unreal / Export FBX for Unreal</td><td>A skeletal mesh with morph targets</td></tr><tr><td>LOD chain</td><td>Blend shapes are kept on every LOD</td></tr><tr><td>Project (<code>.sfproj</code>)</td><td>Everything: layers, weights and the active layer</td></tr><tr><td>OBJ, PLY, STL</td><td>The current blended shape only</td></tr></tbody></table></div>
<p>Importing works the other way: glTF morph targets and FBX or USD blend shapes open as sculpt layers. See <a href="exporting.html">Exporting</a>.</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>layer_add name=Smile</code></td><td>Add a layer and make it active</td></tr><tr><td><code>layer_set_active index=0</code></td><td>Choose the layer strokes go into (<code>-1</code> = base mesh)</td></tr><tr><td><code>layer_set_weight index=0 weight=0.5</code></td><td>Set a layer&#x27;s weight (negative or above 1 exaggerates)</td></tr><tr><td><code>layer_remove index=0</code></td><td>Delete a layer</td></tr></tbody></table></div>
<p>Layers are addressed by index, starting at 0 for the top layer.</p>
<div class="code-block"><pre class="code"><code class="language-text">layer_add name=jawOpen; stroke points=&quot;0,-0.3,1 0,-0.5,1&quot; brush=Inflate; export_glb path=head.glb</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
<h2 id="see-also">See also<a class="anchor" href="#see-also" aria-label="Link to this section">#</a></h2>
<ul>
<li>
<a href="parts.html">Parts</a>
</li>
<li>
<a href="geometry.html">Subdivide, remesh, decimate and LODs</a>
</li>
<li>
<a href="exporting.html">Exporting</a>: glTF morph targets, FBX blend shapes, Send to Unreal
</li>
</ul>
      </article>
      <nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="fill-layers.html"><span>Previous</span>Fill layers, Mesh Maps and Material Recipes</a><a class="next" rel="next" href="facial-shapes.html"><span>Next</span>Facial shapes and live face</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/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="#how-layers-work">How layers work</a></li><li><a href="#the-layers-sub-palette">The Layers sub-palette</a></li><li><a href="#add-a-layer-and-sculpt-into-it">Add a layer and sculpt into it</a></li><li><a href="#adjust-and-preview-weights">Adjust and preview weights</a></li><li><a href="#delete-a-layer">Delete a layer</a></li><li><a href="#layers-and-subdivision-levels">Layers and subdivision levels</a></li><li><a href="#export-blend-shapes">Export blend shapes</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>