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.

22.8 KB
Raw Blame
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Face Groups and visibility - SculptForge User Guide</title>
  <meta name="description" content="Face Groups (experienced sculptors: Face groups) divide a Part&#x27;s surface into named regions, shown as flat colours when you turn them on. You use them to hide and isolate parts of a model so you can reach what you want to sculpt, to build masks, and to split a model into Parts. This chapter covers c">
  <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/face-groups.html">
  <meta property="og:type" content="article">
  <meta property="og:title" content="Face Groups and visibility - SculptForge User Guide">
  <meta property="og:description" content="Face Groups (experienced sculptors: Face groups) divide a Part&#x27;s surface into named regions, shown as flat colours when you turn them on. You use them to hide and isolate parts of a model so you can reach what you want to sculpt, to build masks, and to split a model into Parts. This chapter covers c">
  <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=5">
  <meta property="og:url" content="https://sculptforge.app/guide/face-groups.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="masking.html" data-next="selection-sets.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">Face Groups and visibility</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" class="current" aria-current="page">Face Groups and visibility</a><ul class="toc-sections"><li><a href="#show-face-groups">Show face groups</a></li><li><a href="#create-face-groups">Create face groups</a></li><li><a href="#hide-and-show-parts">Hide and show parts</a></li><li><a href="#typical-workflows">Typical workflows</a></li><li><a href="#face-groups-and-other-tools">Face Groups and other tools</a></li><li><a href="#face-groups-from-a-script">Face Groups from a script</a></li><li><a href="#see-also">See also</a></li></ul></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="face-groups-and-visibility">Face Groups and visibility</h1>
<p>Face Groups (experienced sculptors: Face groups) divide a Part&#x27;s surface into named regions, shown as flat colours when you turn them on. You use them to hide and isolate parts of a model so you can reach what you want to sculpt, to build masks, and to split a model into Parts. This chapter covers creating face groups, the <kbd>Ctrl</kbd>+<kbd>Shift</kbd> visibility gestures and the <strong>Tool &gt; Face Groups</strong> and <strong>Tool &gt; Visibility</strong> controls.</p>
<figure class="shot"><a href="images/face-groups.jpg" class="zoom"><img src="images/face-groups.jpg" alt="Face Groups shown as colours, with the Face Groups sub-palette" width="960" height="561" loading="lazy" decoding="async"></a><figcaption>Face Groups shown as colours, with the Face Groups sub-palette</figcaption></figure>
<h2 id="show-face-groups">Show face groups<a class="anchor" href="#show-face-groups" aria-label="Link to this section">#</a></h2>
<p>Click <strong>Groups</strong> in the right shelf to colour each face group of the active Part. The same toggle is <strong>Show face groups</strong> in <strong>Tool &gt; Face Groups</strong> and <strong>Show Face Groups</strong> in the <strong>View</strong> menu. The grouping buttons turn the colours on for you, so you see the result straight away.</p>
<p>The number next to <strong>Show face groups</strong> is how many face groups are visible right now.</p>
<p>A mesh without face groups is one group. Face Groups come from:</p>
<ul>
<li>
the grouping buttons below;
</li>
<li>
OBJ files: each <code>g</code> group becomes a face group (SculptForge also writes face groups as <code>g</code> groups when it exports OBJ);
</li>
<li>
Bridge files and SculptForge projects, which keep face groups.
</li>
</ul>
<h2 id="create-face-groups">Create face groups<a class="anchor" href="#create-face-groups" aria-label="Link to this section">#</a></h2>
<p>Open <strong>Tool &gt; Face Groups</strong>. Grouping works on the <strong>visible</strong> part of the Part only; hidden parts keep their groups. So you can isolate one part and regroup just that part.</p>
<div class="table-wrap"><table><thead><tr><th>Control</th><th>What it does</th><th>Command</th></tr></thead><tbody><tr><td><strong>By normals</strong></td><td>A new group wherever the surface turns more than the angle next to it (1 to 90 degrees, default 30). Each flat side of a box becomes its own group.</td><td><code>facegroup_auto_by_normals</code></td></tr><tr><td><strong>By pieces</strong></td><td>One group per disconnected piece, such as separate eyes or buttons in one mesh.</td><td><code>facegroup_by_connectivity</code></td></tr><tr><td><strong>From mask</strong></td><td>Masked triangles move into a new group.</td><td><code>facegroup_from_mask</code></td></tr><tr><td><strong>Group by UVs</strong></td><td>One group per UV island: triangles that touch without a UV seam between them share a group. Needs UVs (<strong>Tool &gt; Texture Map &gt; Auto UV</strong> or an imported model&#x27;s).</td><td><code>facegroup_uv</code></td></tr><tr><td><strong>Merge visible</strong></td><td>Everything visible becomes one group.</td><td><code>facegroup_merge_visible</code></td></tr><tr><td><strong>Clear groups</strong></td><td>Remove all face groups; the whole Part becomes one group again.</td><td><code>facegroup_clear</code></td></tr></tbody></table></div>
<p>Each button is one undo step.</p>
<h3 id="group-a-region-you-painted">Group a region you painted<a class="anchor" href="#group-a-region-you-painted" aria-label="Link to this section">#</a></h3>
<ol>
<li>
Paint a mask over the region with <kbd>Ctrl</kbd> (see <a href="masking.html">Masking</a>).
</li>
<li>
Click <strong>From mask</strong> in <strong>Tool &gt; Face Groups</strong>.
</li>
<li>
<kbd>Ctrl</kbd> + drag on the background to clear the mask.
</li>
</ol>
<h2 id="hide-and-show-parts">Hide and show parts<a class="anchor" href="#hide-and-show-parts" aria-label="Link to this section">#</a></h2>
<p>Visibility is the main reason to have face groups: hide what is in the way, sculpt what&#x27;s left, then show everything again. Hidden parts can&#x27;t be sculpted, painted or masked, so hiding also protects them.</p>
<p>All of the gestures use <kbd>Ctrl</kbd>+<kbd>Shift</kbd> in the viewport (<kbd>Cmd</kbd>+<kbd>Shift</kbd> on macOS):</p>
<div class="table-wrap"><table><thead><tr><th>Gesture</th><th>Effect</th></tr></thead><tbody><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd> + click a face group, everything shown</td><td>Isolate it: show only that group.</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd> + click a face group, something hidden</td><td>Hide that group.</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd> + click the isolated group again</td><td>Invert the visibility: show everything else instead.</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Alt</kbd> + click a face group</td><td>Hide that group.</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd> + click the background</td><td>Show everything.</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd> + drag a rectangle on the background, around nothing</td><td>Reverse the visibility.</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd> + drag</td><td>Keep what&#x27;s inside the rectangle (or lasso), hide the rest. The shape is drawn green.</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Alt</kbd> + drag</td><td>Hide what&#x27;s inside the rectangle (or lasso). The shape is drawn red.</td></tr></tbody></table></div>
<p>Whether a drag draws a rectangle or a lasso is set by <strong>Select Rectangle</strong> and <strong>Select Lasso</strong> at the top of <strong>Tool &gt; Visibility</strong> (Select Rectangle by default), or, with <kbd>Ctrl</kbd>+<kbd>Shift</kbd> held: the left shelf then shows the selection brush, and clicking the brush tile (or pressing <kbd>B</kbd>) or the stroke tile picks <strong>Select Rectangle</strong> or <strong>Select Lasso</strong>. With <strong>Select Lasso</strong>, the drag traces a free-hand outline that closes back to where you started; drag around a part as if you were drawing round it with a pen. The drag can start on the model or on the background.</p>
<p>Both shapes work in screen space: a triangle counts as inside when its centre falls inside the shape as you see it, including triangles on the far side of the model. A lasso that crosses itself leaves out the areas it encloses twice. You can press or release <kbd>Alt</kbd> while dragging; what counts is whether it is held when you let go.</p>
<p>With symmetry on (<strong>X</strong>, <strong>Y</strong>, <strong>Z</strong> on the top shelf), the mirror image of the shape counts as inside too, as with the mask selections: keeping the left eye keeps the right one, and hiding one ear hides both (<code>hide_rect</code> / <code>hide_lasso symmetry=x</code>).</p>
<p>SculptForge refuses a change that would hide everything. Every visibility change is one undo step, so <kbd>Ctrl</kbd>+<kbd>Z</kbd> brings back what you just hid.</p>
<h3 id="the-visibility-sub-palette">The Visibility sub-palette<a class="anchor" href="#the-visibility-sub-palette" aria-label="Link to this section">#</a></h3>
<p>Open <strong>Tool &gt; Visibility</strong>:</p>
<div class="table-wrap"><table><thead><tr><th>Control</th><th>What it does</th><th>Command</th></tr></thead><tbody><tr><td><strong>Select Rectangle</strong> / <strong>Select Lasso</strong></td><td>The shape <kbd>Ctrl</kbd>+<kbd>Shift</kbd> + drag draws: a rectangle or a free-hand lasso.</td><td><code>hide_rect</code> / <code>hide_lasso</code></td></tr><tr><td><strong>Show all</strong></td><td>Show every hidden part again. Available when something is hidden.</td><td><code>show_all</code></td></tr><tr><td><strong>Invert visible</strong></td><td>Hide what is visible and show what is hidden.</td><td><code>invert_visibility</code></td></tr><tr><td><strong>Remove Hidden</strong></td><td>Permanently remove the hidden triangles from the mesh. Undoable.</td><td><code>delete_hidden</code></td></tr><tr><td><strong>Delete masked</strong></td><td>Remove the masked triangles (their corners&#x27; average mask above 50%). Undoable. Available when something is masked.</td><td><code>delete_masked</code></td></tr></tbody></table></div>
<p><strong>Remove Hidden</strong> and <strong>Delete masked</strong> keep every attribute of what remains (mask, vertex paint, face groups, UVs and sculpt layers). Use it to cut away parts of a scan or a generated model, or to remove the inside of a mesh after you isolated the outside.</p>
<h2 id="typical-workflows">Typical workflows<a class="anchor" href="#typical-workflows" aria-label="Link to this section">#</a></h2>
<h3 id="work-on-one-part-of-a-character">Work on one part of a character<a class="anchor" href="#work-on-one-part-of-a-character" aria-label="Link to this section">#</a></h3>
<ol>
<li>
Click <strong>By pieces</strong> (for a mesh made of separate parts) or <strong>By normals</strong>.
</li>
<li>
<kbd>Ctrl</kbd>+<kbd>Shift</kbd> + click the part you want, for example the head.
</li>
<li>
Sculpt. The rest of the body is hidden and can&#x27;t be touched.
</li>
<li>
<kbd>Ctrl</kbd>+<kbd>Shift</kbd> + click the background to show everything.
</li>
</ol>
<h3 id="clean-up-a-scan-or-a-generated-model">Clean up a scan or a generated model<a class="anchor" href="#clean-up-a-scan-or-a-generated-model" aria-label="Link to this section">#</a></h3>
<ol>
<li>
Turn the model so the unwanted piece is on screen.
</li>
<li>
<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Alt</kbd> + drag a rectangle over it to hide it. For an awkward shape, pick <strong>Select Lasso</strong> in <strong>Tool &gt; Visibility</strong> first and draw around it.
</li>
<li>
Click <strong>Remove Hidden</strong> in <strong>Tool &gt; Visibility</strong>.
</li>
</ol>
<h3 id="split-a-model-into-parts">Split a model into Parts<a class="anchor" href="#split-a-model-into-parts" aria-label="Link to this section">#</a></h3>
<p>Group the model, then click <strong>Split groups</strong> in <strong>Tool &gt; Parts</strong>: each face group becomes its own Part. <strong>Split parts</strong> does the same by disconnected piece. See <a href="parts.html">Parts</a>.</p>
<h2 id="face-groups-and-other-tools">Face Groups and other tools<a class="anchor" href="#face-groups-and-other-tools" aria-label="Link to this section">#</a></h2>
<ul>
<li>
<strong>Masking</strong>: <strong>By face group</strong> in <strong>Tool &gt; Masking</strong> masks one group (see <a href="masking.html">Masking</a>).
</li>
<li>
<strong>Brushes and vertex paint</strong> skip hidden faces.
</li>
<li>
<strong>Projects</strong> save face groups and what&#x27;s hidden; <strong>Bridge</strong> and <strong>OBJ</strong> carry face groups in and out.
</li>
<li>
Each Part has its own face groups and visibility. To show and hide whole Parts, use the eye icons and <strong>Solo</strong> in <strong>Tool &gt; Parts</strong>.
</li>
</ul>
<h2 id="face-groups-from-a-script">Face Groups from a script<a class="anchor" href="#face-groups-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>facegroup_auto_by_normals</code></td><td><code>angle</code> (1-180 degrees, default 30)</td></tr><tr><td><code>facegroup_by_connectivity</code>, <code>facegroup_uv</code>, <code>facegroup_from_mask</code>, <code>facegroup_merge_visible</code>, <code>facegroup_clear</code></td><td></td></tr><tr><td><code>isolate_facegroup</code>, <code>hide_facegroup</code></td><td><code>group</code> (required): the face group id</td></tr><tr><td><code>show_all</code>, <code>invert_visibility</code>, <code>delete_hidden</code></td><td></td></tr><tr><td><code>hide_rect</code></td><td><code>x0 y0 x1 y1</code> (-1 to 1, y up), <code>inside</code>, optional <code>view_proj</code> matrix; without a view the rectangle spans the mesh seen from the front</td></tr><tr><td><code>hide_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>inside</code>, <code>view_proj</code> as for <code>hide_rect</code></td></tr></tbody></table></div>
<p>When you isolate or hide a group in the viewport, the console (<kbd>`</kbd>) shows the command with the group&#x27;s id, for example <code>isolate_facegroup group=3</code>, which you can reuse in scripts.</p>
<div class="code-block"><pre class="code"><code class="language-sh">sculptforge-cli -c &#x27;open path=robot.obj; face group_by_connectivity; part_split_groups; save_project path=robot.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> a face group paint brush, Group Front, face groups from UV islands or Vertex Paint, and face group-based crease edges 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="masking.html">Masking</a>: build masks from face groups and face groups from masks
</li>
<li>
<a href="parts.html">Parts</a>: split by groups, show, hide and solo whole Parts
</li>
<li>
<a href="shortcuts.html">Keyboard and mouse reference</a>
</li>
</ul>
      </article>
      <nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="masking.html"><span>Previous</span>Masking</a><a class="next" rel="next" href="selection-sets.html"><span>Next</span>Selection sets and morph targets</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/face-groups.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="#show-face-groups">Show face groups</a></li><li><a href="#create-face-groups">Create face groups</a></li><li><a href="#hide-and-show-parts">Hide and show parts</a></li><li><a href="#typical-workflows">Typical workflows</a></li><li><a href="#face-groups-and-other-tools">Face Groups and other tools</a></li><li><a href="#face-groups-from-a-script">Face Groups 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>