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.

29.5 KB
Raw Blame
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Masking - SculptForge User Guide</title>
  <meta name="description" content="A mask protects part of the model from change. Masked areas are drawn darker, and every brush, the Paint brush and colour fills leave them alone. This chapter covers painting masks with Ctrl, masking with a lasso or rectangle, the background gestures, and the Tool &gt; Masking panel for inverting, blur">
  <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/masking.html">
  <meta property="og:type" content="article">
  <meta property="og:title" content="Masking - SculptForge User Guide">
  <meta property="og:description" content="A mask protects part of the model from change. Masked areas are drawn darker, and every brush, the Paint brush and colour fills leave them alone. This chapter covers painting masks with Ctrl, masking with a lasso or rectangle, the background gestures, and the Tool &gt; Masking panel for inverting, blur">
  <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=5">
  <meta property="og:url" content="https://sculptforge.app/guide/masking.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="brush-packs.html" data-next="face-groups.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">Masking</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" class="current" aria-current="page">Masking</a><ul class="toc-sections"><li><a href="#how-masks-work">How masks work</a></li><li><a href="#paint-a-mask">Paint a mask</a></li><li><a href="#mask-with-a-lasso-or-rectangle">Mask with a lasso or rectangle</a></li><li><a href="#background-gestures">Background gestures</a></li><li><a href="#mask-keys">Mask keys</a></li><li><a href="#the-masking-panel">The Masking panel</a></li><li><a href="#common-tasks">Common tasks</a></li><li><a href="#masks-and-painting">Masks and painting</a></li><li><a href="#masking-from-a-script">Masking from a script</a></li><li><a href="#see-also">See also</a></li></ul></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">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="masking">Masking</h1>
<p>A mask protects part of the model from change. Masked areas are drawn darker, and every brush, the Paint brush and colour fills leave them alone. This chapter covers painting masks with <kbd>Ctrl</kbd>, masking with a lasso or rectangle, the background gestures, and the <strong>Tool &gt; Masking</strong> panel for inverting, blurring, growing and building masks from cavities, peaks, face groups, vertex paint, the direction the surface faces or the mesh border.</p>
<figure class="shot"><a href="images/masking.jpg" class="zoom"><img src="images/masking.jpg" alt="A mask painted on the lion&#x27;s mane, with the Masking sub-palette" width="960" height="557" loading="lazy" decoding="async"></a><figcaption>A mask painted on the lion&#x27;s mane, with the Masking sub-palette</figcaption></figure>
<h2 id="how-masks-work">How masks work<a class="anchor" href="#how-masks-work" aria-label="Link to this section">#</a></h2>
<ul>
<li>
A mask is a value per vertex from 0 (free) to 1 (fully masked). Values in between give partial protection, so a soft mask edge blends sculpting into the protected area.
</li>
<li>
Masks belong to a Part: each Part has its own mask.
</li>
<li>
Masks are saved in projects (<code>.sfproj</code>) and in Bridge files, so they survive a round trip through the Bridge.
</li>
<li>
Masking is not a layer and isn&#x27;t affected by sculpt layers: a mask stroke always works on the model itself.
</li>
<li>
Mask strokes and mask commands are undoable like any other change.
</li>
</ul>
<p>To see the mask, keep <strong>Mask</strong> on in the right shelf. The same toggle is <strong>Show mask</strong> in <strong>Tool &gt; Masking</strong>, and <strong>Show Mask</strong> in the <strong>Render</strong> palette. Turning it off hides the darkening without clearing the mask: it still protects the surface, the status bar says so, and turning it on again shows the same mask. <strong>Clear Mask</strong> (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>A</kbd>) is what removes it.</p>
<h2 id="paint-a-mask">Paint a mask<a class="anchor" href="#paint-a-mask" aria-label="Link to this section">#</a></h2>
<ol>
<li>
Hold <kbd>Ctrl</kbd> and drag on the model. The area under the brush becomes masked.
</li>
<li>
Hold <kbd>Ctrl</kbd>+<kbd>Alt</kbd> and drag to erase the mask.
</li>
</ol>
<p>Mask strokes use the current <strong>Size</strong>, symmetry and, with a pen, pressure (when <strong>Pressure &gt; Strength</strong> is on). How much each stroke masks is set by <strong>Mask Strength</strong> in <strong>Tool &gt; Masking</strong> (0.01 to 1, default 1): lower values build up a soft, partial mask over several strokes. Mask strokes always use a round tip, whatever alpha you have selected, and a <strong>Drag Stamp</strong> stroke masks with dabs along the path instead of one stamp.</p>
<p>On macOS, <kbd>Cmd</kbd> works wherever this guide says <kbd>Ctrl</kbd>.</p>
<h2 id="mask-with-a-lasso-or-rectangle">Mask with a lasso or rectangle<a class="anchor" href="#mask-with-a-lasso-or-rectangle" aria-label="Link to this section">#</a></h2>
<p>To mask a large or sharply outlined area in one go, pick a mask selection shape. Holding <kbd>Ctrl</kbd> turns the brush on the left shelf into the mask brush: with <kbd>Ctrl</kbd> held, click the brush tile (or press <kbd>B</kbd>) to pick <strong>Mask Pen</strong>, <strong>Lasso Mask</strong> or <strong>Rectangle Mask</strong>, or click the stroke tile to pick the stroke (<strong>Dots</strong>, <strong>Lasso</strong> or <strong>Rect</strong>). The same shapes sit at the top of <strong>Tool &gt; Masking</strong>:</p>
<div class="table-wrap"><table><thead><tr><th>Shape</th><th><kbd>Ctrl</kbd> + drag</th></tr></thead><tbody><tr><td><strong>Mask Pen</strong> (default)</td><td>Paints the mask with the brush, as described above.</td></tr><tr><td><strong>Lasso Mask</strong></td><td>Draws a free-hand outline that closes back to where you started. Everything inside is masked.</td></tr><tr><td><strong>Rectangle Mask</strong></td><td>Draws a rectangle. Everything inside is masked.</td></tr></tbody></table></div>
<p>With <strong>Lasso Mask</strong> or <strong>Rectangle Mask</strong>:</p>
<ol>
<li>
Hold <kbd>Ctrl</kbd> and drag around the area. The drag can start on the model or on the background. The shape is drawn as you drag, white with a dark veil.
</li>
<li>
Let go to mask what&#x27;s inside. Hold <kbd>Ctrl</kbd>+<kbd>Alt</kbd> instead to unmask what&#x27;s inside (the shape is drawn blue). You can press or release <kbd>Alt</kbd> while dragging; what counts is whether it is held when you let go.
</li>
</ol>
<p>The selection works in screen space, like the visibility rectangle: a vertex counts as inside when it falls inside the shape as you see it, including vertices on the far side of the model. Hidden parts are left alone. With symmetry on (<strong>X</strong>, <strong>Y</strong>, <strong>Z</strong> on the top shelf), the mirror image of what&#x27;s inside is masked too, as a mask stroke mirrors. A shape that covers none of the model clears the mask instead. <strong>Mask Strength</strong> sets how much a selection masks or unmasks, and each selection is one undo step. A lasso that crosses itself leaves out the areas it encloses twice.</p>
<p>Turn on <strong>Front faces only</strong> (under the shape buttons, shown for Lasso Mask and Rectangle Mask) to mask only what faces you: the far side of the model and folds turned away from you are left as they are. It follows the mirror image too when symmetry is on.</p>
<p>The cursor turns into a small cross while <kbd>Ctrl</kbd> is held, since the brush size doesn&#x27;t matter for a selection.</p>
<h2 id="background-gestures">Background gestures<a class="anchor" href="#background-gestures" aria-label="Link to this section">#</a></h2>
<p>With <kbd>Ctrl</kbd> held, clicks and drags on the empty background act on the whole mask:</p>
<div class="table-wrap"><table><thead><tr><th>Gesture</th><th>Effect</th></tr></thead><tbody><tr><td><kbd>Ctrl</kbd> + click the background</td><td>Invert the mask</td></tr><tr><td><kbd>Ctrl</kbd> + drag on the background</td><td>Draw a mask rectangle (Mask Pen; Lasso Mask draws a lasso): what it covers is masked, mirrored by the symmetry. A shape that covers none of the model clears the mask.</td></tr><tr><td><kbd>Ctrl</kbd> + drag on the background, with nothing masked</td><td>Zoom the view in the SculptForge style (the default); with the Classic sculpting keys it draws the mask rectangle above (see <a href="shortcuts.html#classic-sculpting-keys">Keyboard and mouse</a>)</td></tr></tbody></table></div>
<p>On the model, a <kbd>Ctrl</kbd> + click that doesn&#x27;t drag works on the mask&#x27;s edges, whichever mask shape is picked:</p>
<div class="table-wrap"><table><thead><tr><th>Gesture</th><th>Effect</th></tr></thead><tbody><tr><td><kbd>Ctrl</kbd> + click the model</td><td>Blur the mask (once per click; same as <strong>Blur</strong>)</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Alt</kbd> + click the model</td><td>Sharpen the mask (same as <strong>Sharpen</strong>)</td></tr></tbody></table></div>
<h2 id="mask-keys">Mask keys<a class="anchor" href="#mask-keys" aria-label="Link to this section">#</a></h2>
<div class="table-wrap"><table><thead><tr><th>Key</th><th>Effect</th></tr></thead><tbody><tr><td><kbd>Ctrl</kbd>+<kbd>A</kbd></td><td>Mask All</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>A</kbd></td><td>Clear Mask</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>I</kbd></td><td>Invert Mask</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>H</kbd></td><td>Show or hide the mask&#x27;s shading (View Mask)</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>W</kbd></td><td>Group from Mask: the masked part becomes a new face group and the mask is cleared (see <a href="face-groups.html">Face Groups</a>)</td></tr></tbody></table></div>
<p>A drag starts after the cursor moves a few pixels, so a slightly shaky click still inverts. With <strong>Lasso Mask</strong> or <strong>Rectangle Mask</strong>, a <kbd>Ctrl</kbd> + drag on the background draws that shape; to clear the mask, draw it away from the model, or use <strong>Clear</strong>.</p>
<h2 id="the-masking-panel">The Masking panel<a class="anchor" href="#the-masking-panel" aria-label="Link to this section">#</a></h2>
<p>Open <strong>Tool &gt; Masking</strong> (the Tool palette is in the right tray by default). It has three rows of buttons, each with a picture of what it does (the masked part dark, as in the viewport); hold <kbd>Ctrl</kbd> over a button for its hint. Every button is one undo step.</p>
<figure class="shot"><a href="images/masking-panel.jpg" class="zoom"><img src="images/masking-panel.jpg" alt="Tool &gt; Masking: Shapes, Mask by and Adjust" width="308" height="840" loading="lazy" decoding="async"></a><figcaption>Tool &gt; Masking: Shapes, Mask by and Adjust</figcaption></figure>
<p><strong>Shapes</strong>: what <kbd>Ctrl</kbd> + drag does.</p>
<div class="table-wrap"><table><thead><tr><th>Button</th><th>What it does</th><th>Command</th></tr></thead><tbody><tr><td><strong>Mask Pen</strong></td><td>Paint the mask with the brush; <kbd>Ctrl</kbd>+<kbd>Alt</kbd> erases.</td><td></td></tr><tr><td><strong>Lasso Mask</strong></td><td>Mask what is inside a free shape you draw.</td><td><code>mask_lasso</code></td></tr><tr><td><strong>Rectangle Mask</strong></td><td>Mask what is inside a rectangle.</td><td><code>mask_rect</code></td></tr></tbody></table></div>
<p><strong>Front faces only</strong> (lasso and rectangle) masks only what faces you. <strong>Mask Strength</strong> is how much each stroke, shape or <strong>Mask by</strong> button masks (0.01 to 1).</p>
<p><strong>Mask by</strong>: build a whole mask at once. Each one replaces the current mask.</p>
<div class="table-wrap"><table><thead><tr><th>Button</th><th>What it masks</th><th>Command</th></tr></thead><tbody><tr><td><strong>By cavity</strong></td><td>Concave areas: creases, folds, pores.</td><td><code>mask_by_cavity</code></td></tr><tr><td><strong>By peaks</strong></td><td>Convex areas: ridges, peaks and sharp edges (the opposite of By cavity).</td><td><code>mask_by_peaks</code></td></tr><tr><td><strong>By face group</strong></td><td>One face group (the number under <strong>Mask by options</strong>).</td><td><code>mask_by_facegroup</code></td></tr><tr><td><strong>By colour</strong></td><td>Vertex paint close to the main colour (the left shelf&#x27;s swatch); unpainted clay counts as white.</td><td><code>mask_by_color</code></td></tr><tr><td><strong>By facing</strong></td><td>Surface that faces the camera (or up, or down) within an angle: the front of a face, the top of a rock.</td><td><code>mask_by_facing</code></td></tr><tr><td><strong>By border</strong></td><td>The open edges of the mesh and the rings of edges inside them, so sculpting keeps the border in place. A closed mesh has no open edges, and the status bar says so.</td><td><code>mask_border</code></td></tr></tbody></table></div>
<p><strong>Adjust</strong>: change the mask there is.</p>
<div class="table-wrap"><table><thead><tr><th>Button</th><th>What it does</th><th>Command</th></tr></thead><tbody><tr><td><strong>Grow</strong> / <strong>Shrink</strong></td><td>Expand or contract the masked region by one ring of edges per pass.</td><td><code>mask_grow</code> / <code>mask_shrink</code></td></tr><tr><td><strong>Sharpen</strong> / <strong>Blur</strong></td><td>Tighten or soften the mask&#x27;s edges.</td><td><code>mask_sharpen</code> / <code>mask_blur</code></td></tr><tr><td><strong>Invert</strong></td><td>Masked becomes free and free becomes masked.</td><td><code>mask_invert</code></td></tr><tr><td><strong>Clear</strong></td><td>Unmask everything.</td><td><code>mask_clear</code></td></tr><tr><td><strong>All</strong></td><td>Mask every visible vertex.</td><td><code>mask_all</code></td></tr></tbody></table></div>
<p><strong>Passes</strong> sets how many times Grow, Shrink, Sharpen and Blur run (1 to 20). <strong>Mask by options</strong> holds the rest:</p>
<div class="table-wrap"><table><thead><tr><th>Option</th><th>For</th><th></th></tr></thead><tbody><tr><td><strong>Cavity / peaks threshold</strong></td><td>How deep a crease (By cavity) or sharp a ridge (By peaks) must be (-0.2 to 0.5, default 0.02). 0 takes anything; higher keeps only the strongest.</td><td><code>threshold=</code></td></tr><tr><td><strong>Face group</strong></td><td>The face group id By face group masks.</td><td><code>group=</code></td></tr><tr><td><strong>Colour tolerance</strong></td><td>How different a colour may be and still count for By colour (0.01 to 1, default 0.15).</td><td><code>tolerance=</code></td></tr><tr><td><strong>Faces the camera / up / down</strong> and <strong>Angle</strong></td><td>The direction By facing compares with, and how far the surface may turn from it (default 60 degrees).</td><td><code>x= y= z= angle=</code></td></tr><tr><td><strong>Border rings</strong></td><td>How wide By border masks, in rings of edges (1 to 20, default 2).</td><td><code>rings=</code></td></tr><tr><td><strong>Face Group borders</strong></td><td>By border also masks where face groups meet.</td><td><code>facegroups=true</code></td></tr><tr><td><strong>Soft</strong></td><td>By border fades the mask from the border towards the innermost ring.</td><td><code>soft=true</code></td></tr></tbody></table></div>
<p>Mask operations only change visible parts of the model; hidden parts keep their mask. <strong>Clear</strong> is the exception and frees everything.</p>
<h2 id="common-tasks">Common tasks<a class="anchor" href="#common-tasks" aria-label="Link to this section">#</a></h2>
<h3 id="protect-detail-while-smoothing">Protect detail while smoothing<a class="anchor" href="#protect-detail-while-smoothing" aria-label="Link to this section">#</a></h3>
<ol>
<li>
Click <strong>By cavity</strong> to mask the creases and pores.
</li>
<li>
Smooth with <kbd>Shift</kbd>. The cavities keep their sharpness while the surface between them relaxes.
</li>
<li>
<kbd>Ctrl</kbd> + drag on the background to clear the mask when you&#x27;re done.
</li>
</ol>
<p>Raise <strong>threshold</strong> if too much is masked; lower <strong>Mask Strength</strong> for partial protection.</p>
<h3 id="sculpt-one-part-only">Sculpt one part only<a class="anchor" href="#sculpt-one-part-only" aria-label="Link to this section">#</a></h3>
<ol>
<li>
Paint a mask over the part you want to work on with <kbd>Ctrl</kbd>.
</li>
<li>
<kbd>Ctrl</kbd> + click the background to invert it. Now everything <em>except</em> that part is protected.
</li>
<li>
Sculpt freely; strokes that cross the edge stop at the mask.
</li>
</ol>
<h3 id="mask-a-whole-face-group">Mask a whole face group<a class="anchor" href="#mask-a-whole-face-group" aria-label="Link to this section">#</a></h3>
<p>The quickest way works without knowing the group&#x27;s number:</p>
<ol>
<li>
<kbd>Ctrl</kbd>+<kbd>Shift</kbd> + click the group to isolate it (see <a href="face-groups.html">Face Groups and visibility</a>).
</li>
<li>
Click <strong>All</strong>: only visible vertices are masked.
</li>
<li>
<kbd>Ctrl</kbd>+<kbd>Shift</kbd> + click the background to show everything again. The mask stays.
</li>
</ol>
<p><strong>By face group</strong> masks a group by its id. The viewport doesn&#x27;t show ids, but the console does: isolate the group, then open the console (<kbd>`</kbd>) and read the <code>isolate_face group group=N</code> line. Enter that number in <strong>Mask by options &gt; Face group</strong> and click <strong>By face group</strong>.</p>
<h3 id="sculpt-without-breaking-the-border">Sculpt without breaking the border<a class="anchor" href="#sculpt-without-breaking-the-border" aria-label="Link to this section">#</a></h3>
<p>A plane, a cloth panel or a part cut from a larger model has an open border that should stay where it is, for example to keep it lined up with the piece it joins:</p>
<ol>
<li>
Set <strong>Rings</strong> to how wide the protected strip should be.
</li>
<li>
Click <strong>By border</strong>. The open edges and the rings inside them are masked.
</li>
<li>
Sculpt freely; the border doesn&#x27;t move. Tick <strong>Soft</strong> first for a gradual transition into the sculpted area.
</li>
</ol>
<p>Tick <strong>Face Group borders</strong> to also protect the seams between face groups. This is Blender&#x27;s <em>Mask from mesh boundary</em> (and, with face sets, <em>Mask from face set boundary</em>).</p>
<h3 id="a-soft-edged-mask">A soft-edged mask<a class="anchor" href="#a-soft-edged-mask" aria-label="Link to this section">#</a></h3>
<p>Paint the mask, then click <strong>Blur</strong> a few times (or set <strong>passes</strong> to 3-5 first). <strong>Sharpen</strong> does the opposite.</p>
<h3 id="turn-a-mask-into-a-face-group">Turn a mask into a face group<a class="anchor" href="#turn-a-mask-into-a-face-group" aria-label="Link to this section">#</a></h3>
<p>Click <strong>From mask</strong> in <strong>Tool &gt; Face Groups</strong>: the masked triangles become a new face group. See <a href="face-groups.html">Face Groups and visibility</a>.</p>
<h2 id="masks-and-painting">Masks and painting<a class="anchor" href="#masks-and-painting" aria-label="Link to this section">#</a></h2>
<p>Vertex Paint respects the mask too: the Paint brush, <strong>Rgb</strong> strokes and <strong>Fill</strong> leave masked areas alone, so you can mask an area and fill the rest with a colour. See <a href="vertex-paint.html">Vertex Paint and materials</a>.</p>
<h2 id="masking-from-a-script">Masking from a script<a class="anchor" href="#masking-from-a-script" 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>mask_clear</code>, <code>mask_all</code>, <code>mask_invert</code></td><td></td></tr><tr><td><code>mask_blur</code>, <code>mask_sharpen</code>, <code>mask_grow</code>, <code>mask_shrink</code></td><td><code>iterations</code> (1-100, default 1)</td></tr><tr><td><code>mask_by_cavity</code></td><td><code>strength</code> (0-1, default 1), <code>threshold</code> (-1 to 1, default 0.02)</td></tr><tr><td><code>mask_by_facegroup</code></td><td><code>group</code> (required), <code>add=true</code> to add to the current mask instead of replacing it</td></tr><tr><td><code>mask_border</code></td><td><code>rings</code> (1-20, default 1), <code>facegroups=true</code> to also mask face group borders, <code>soft=true</code> to fade inwards, <code>strength</code> (0-1, default 1), <code>add=true</code> to add to the current mask</td></tr><tr><td><code>mask_rect</code></td><td><code>x0 y0 x1 y1</code> (-1 to 1, y up), <code>unmask</code>, <code>strength</code> (0-1, default 1), optional <code>view_proj</code> matrix; without a view the rectangle spans the mesh seen from the front</td></tr><tr><td><code>mask_lasso</code></td><td><code>points</code> (required): the outline as <code>&quot;x0 y0 x1 y1 ...&quot;</code>, at least 3 points in the same -1 to 1 space; <code>unmask</code>, <code>strength</code>, <code>view_proj</code> as for <code>mask_rect</code></td></tr></tbody></table></div>
<div class="code-block"><pre class="code"><code class="language-sh">sculptforge-cli -c &#x27;open path=head.obj; mask_by_cavity threshold=0.05; mask_blur iterations=2; save_project path=head.sfproj&#x27;</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
<aside class="callout callout-not-yet"><p><strong>Not yet:</strong> masking by topology, by normals or by alpha, Mask By Smoothness, and MaskCurve are not available yet.</p></aside>
<h2 id="see-also">See also<a class="anchor" href="#see-also" aria-label="Link to this section">#</a></h2>
<ul>
<li>
<a href="face-groups.html">Face Groups and visibility</a>: groups, isolating and hiding parts
</li>
<li>
<a href="sculpting.html">Sculpting and brushes</a>: modifier keys and brush settings
</li>
<li>
<a href="vertex-paint.html">Vertex Paint and materials</a>: fills that respect the mask
</li>
</ul>
      </article>
      <nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="brush-packs.html"><span>Previous</span>Brush packs</a><a class="next" rel="next" href="face-groups.html"><span>Next</span>Face Groups and visibility</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/masking.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-masks-work">How masks work</a></li><li><a href="#paint-a-mask">Paint a mask</a></li><li><a href="#mask-with-a-lasso-or-rectangle">Mask with a lasso or rectangle</a></li><li><a href="#background-gestures">Background gestures</a></li><li><a href="#mask-keys">Mask keys</a></li><li><a href="#the-masking-panel">The Masking panel</a></li><li><a href="#common-tasks">Common tasks</a></li><li><a href="#masks-and-painting">Masks and painting</a></li><li><a href="#masking-from-a-script">Masking from a script</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>