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>Vertex Paint and materials - SculptForge User Guide</title>
<meta name="description" content="Vertex Paint (experienced sculptors: Vertex Paint) stores a colour on every vertex of the mesh, so you can paint a sculpt without UVs or textures. This chapter covers the Paint brush, painting while you sculpt, fills and cavity paint, picking colours, paint layers with blend modes, and the Lit Spher">
<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/vertex-paint.html">
<meta property="og:type" content="article">
<meta property="og:title" content="Vertex Paint and materials - SculptForge User Guide">
<meta property="og:description" content="Vertex Paint (experienced sculptors: Vertex Paint) stores a colour on every vertex of the mesh, so you can paint a sculpt without UVs or textures. This chapter covers the Paint brush, painting while you sculpt, fills and cavity paint, picking colours, paint layers with blend modes, and the Lit Spher">
<meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=5">
<meta property="og:url" content="https://sculptforge.app/guide/vertex-paint.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="tube.html" data-next="texture-painting.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">Vertex Paint and materials</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" class="current" aria-current="page">Vertex Paint and materials</a><ul class="toc-sections"><li><a href="#how-vertex-paint-works">How vertex paint works</a></li><li><a href="#paint-with-the-paint-brush">Paint with the Paint brush</a></li><li><a href="#paint-while-sculpting">Paint while sculpting</a></li><li><a href="#choose-a-colour">Choose a colour</a></li><li><a href="#fill-cavity-paint-and-clear">Fill, cavity paint and clear</a></li><li><a href="#line-gradient">Line Gradient</a></li><li><a href="#paint-through-a-stencil">Paint through a Stencil</a></li><li><a href="#paint-layers">Paint layers</a></li><li><a href="#materials-lit-spheres">Materials (Lit Spheres)</a></li><li><a href="#smooth-and-flat-shading">Smooth and flat shading</a></li><li><a href="#scripting">Scripting</a></li><li><a href="#see-also">See also</a></li></ul></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="vertex-paint-and-materials">Vertex Paint and materials</h1>
<p>Vertex Paint (experienced sculptors: Vertex Paint) stores a colour on every vertex of the mesh, so you can paint a sculpt without UVs or textures. This chapter covers the Paint brush, painting while you sculpt, fills and cavity paint, picking colours, paint layers with blend modes, and the Lit Sphere materials that change how the model is shaded in the viewport.</p>
<h2 id="how-vertex-paint-works">How vertex paint works<a class="anchor" href="#how-vertex-paint-works" aria-label="Link to this section">#</a></h2>
<ul>
<li>
Colour is stored per vertex. The detail you can paint is limited by how dense the mesh is: on a light mesh, colour edges look soft. <a href="geometry.html#subdivide">Subdivide</a> or <a href="geometry.html#voxel-remesh">remesh</a> at a higher resolution before fine painting.
</li>
<li>
Painting respects the <a href="masking.html">mask</a> (masked areas keep their colour) and skips <a href="face-groups.html">hidden faces</a>.
</li>
<li>
Symmetry works for painting as it does for sculpting.
</li>
<li>
Vertex Paint is per Part and is saved in projects. It is exported as vertex colours to PLY, glTF/GLB, OBJ, USD (<code>displayColor</code>) and Bridge files. FBX export doesn't include it.
</li>
<li>
A mesh starts without vertex paint. The first paint stroke or fill adds it (white everywhere you haven't painted).
</li>
</ul>
<aside class="callout callout-note"><p><strong>Texture painting:</strong> to paint finer than the mesh, give the Part a texture and paint into it instead; the Paint brush, fills and paint layers work the same way. <strong>Vertex Paint > Texture</strong> bakes vertex paint into a texture. See <a href="texture-painting.html">Texture painting</a>.</p></aside>
<h2 id="paint-with-the-paint-brush">Paint with the Paint brush<a class="anchor" href="#paint-with-the-paint-brush" aria-label="Link to this section">#</a></h2>
<ol>
<li>
Press <kbd>P</kbd>, click <strong>Paint</strong> on the top shelf, or pick <strong>Paint</strong> on the bottom shelf.
</li>
<li>
Choose a colour (see below).
</li>
<li>
Stroke over the model. Size, the stroke type and the alpha work as they do for sculpting; <strong>Colour intensity</strong> (<kbd>I</kbd>) sets how strongly the colour goes on.
</li>
</ol>
<p>While the Paint brush is active:</p>
<ul>
<li>
<kbd>Alt</kbd> paints back towards white.
</li>
<li>
<kbd>Shift</kbd> still smooths the shape.
</li>
<li>
The surface isn't changed.
</li>
</ul>
<p>Press <kbd>P</kbd> again, or click <strong>Sculpt</strong> on the top shelf, to go back to sculpting.</p>
<figure class="shot"><a href="images/vertex-paint.jpg" class="zoom"><img src="images/vertex-paint.jpg" alt="Vertex Paint on a sculpt with the Paint menu open" width="870" height="780" loading="lazy" decoding="async"></a><figcaption>Vertex Paint on a sculpt with the Paint menu open</figcaption></figure>
<h2 id="paint-while-sculpting">Paint while sculpting<a class="anchor" href="#paint-while-sculpting" aria-label="Link to this section">#</a></h2>
<p>Turn on <strong>Rgb</strong> on the top shelf (or <strong>RGB while sculpting</strong> in the <strong>Paint</strong> menu). Every sculpt brush then also paints the current colour along its stroke. The Smooth brush and <kbd>Shift</kbd>-smoothing never paint.</p>
<h2 id="choose-a-colour">Choose a colour<a class="anchor" href="#choose-a-colour" aria-label="Link to this section">#</a></h2>
<ul>
<li>
The <strong>left shelf</strong> has a colour picker (a square plus a hue strip), two swatches and a <strong>Fill</strong> button. Clicking the second swatch swaps it with the main colour.
</li>
<li>
Under the two swatches, the <strong>recent colours</strong> are the last eight you painted with or filled with, newest first. Click one to paint with it again. They are kept when you restart.
</li>
<li>
The <strong>Paint</strong> menu has a larger hue wheel with a hex value, ten preset swatches (white, near black, red, orange, yellow, green, blue, purple, skin and brown) and the fill buttons.
</li>
<li>
Press <kbd>C</kbd> with the cursor over the model to pick the colour under it (the mesh needs vertex paint for this, or a texture while painting into the texture).
</li>
</ul>
<h2 id="fill-cavity-paint-and-clear">Fill, cavity paint and clear<a class="anchor" href="#fill-cavity-paint-and-clear" aria-label="Link to this section">#</a></h2>
<p>The <strong>Paint</strong> menu has four buttons:</p>
<div class="table-wrap"><table><thead><tr><th>Button</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Fill</strong></td><td>Fills the unmasked area with the colour (the whole mesh when nothing is masked). Same as <strong>Fill</strong> on the left shelf</td></tr><tr><td><strong>Fill masked</strong></td><td>Fills only the masked area. Available when the mesh has a mask</td></tr><tr><td><strong>Cavity</strong></td><td>Darkens the creases and cavities with a dark brown, respecting the mask. A quick way to bring out detail</td></tr><tr><td><strong>Clear</strong></td><td>Removes all vertex paint from the active Part</td></tr></tbody></table></div>
<p>All of them are undoable. <strong>Show vertex paint</strong> in the same palette (or <strong>Paint</strong> on the right shelf) turns the colours off in the viewport without deleting them.</p>
<aside class="callout callout-tip"><p><strong>Tip:</strong> To paint a base colour and then dirt in the creases: <strong>Fill</strong> with the base colour, then <strong>Cavity</strong>. For a different cavity colour or strength, use the command (below).</p></aside>
<h2 id="line-gradient">Line Gradient<a class="anchor" href="#line-gradient" aria-label="Link to this section">#</a></h2>
<p><strong>Line Gradient</strong> (under <strong>Clear</strong>) paints a straight colour ramp across the model as you see it: turn it on, then drag a line over the view. The paint colour at the start of the line runs into the <strong>End</strong> colour at its end; past the ends the two colours carry on. Tick <strong>Clear</strong> to fade the paint colour out instead, so the paint underneath shows through towards the end. The swap button swaps the two colours.</p>
<p>The line stays on screen with a handle at each end until you keep it: drag a handle, or change a colour, and the gradient is painted again in place of the last one. <kbd>Enter</kbd> keeps it (so does turning the view or any other edit), <kbd>Esc</kbd> takes it back. Each gradient is one undo step. It respects the mask like <strong>Fill</strong>, never paints hidden faces, and goes into the texture when the Part paints into one. With it on, <kbd>Ctrl</kbd> still masks and <kbd>Shift</kbd> still smooths; turn it off with its button or <kbd>Esc</kbd>.</p>
<h2 id="paint-through-a-stencil">Paint through a Stencil<a class="anchor" href="#paint-through-a-stencil" aria-label="Link to this section">#</a></h2>
<p>A <a href="sculpting.html#stencil">Stencil</a> (<strong>Sculpt > Alpha > Stencil</strong>) paints too: load a photo or a pattern, place it over the model, and paint over it with the Paint brush. Where it covers the model the brush lays the image's colours (with your Colour intensity, falloff and mask); everywhere else it paints nothing. Turn off <strong>Paint its colours</strong> to paint the paint colour through the image's brightness instead (a grayscale pattern as a mask). Turn the model or move the stencil and paint again to cover a whole model.</p>
<h2 id="paint-layers">Paint layers<a class="anchor" href="#paint-layers" aria-label="Link to this section">#</a></h2>
<p>Paint layers stack vertex paint the way Photoshop stacks image layers. Each layer has its own name, visibility, opacity and <strong>blend mode</strong>, so you can paint dirt on a Multiply layer, glow on a Screen layer or tint on an Overlay layer, then change or hide it later without repainting the rest. Every Part has its own stack.</p>
<figure class="shot"><a href="images/paint-layers.jpg" class="zoom"><img src="images/paint-layers.jpg" alt="Tool > Paint Layers: Base, a Multiply dirt layer, a Soft Light tint and an empty Normal layer" width="960" height="557" loading="lazy" decoding="async"></a><figcaption>Tool > Paint Layers: Base, a Multiply dirt layer, a Soft Light tint and an empty Normal layer</figcaption></figure>
<h3 id="how-paint-layers-work">How paint layers work<a class="anchor" href="#how-paint-layers-work" aria-label="Link to this section">#</a></h3>
<ul>
<li>
<strong>Base</strong> is the bottom layer: the Part's vertex paint, always opaque. With only Base, vertex paint works exactly as it did before, and nothing changes in your files.
</li>
<li>
Layers above Base start transparent. Painting on a layer adds colour <strong>and coverage</strong>: where you haven't painted, the layer is see-through. Painting never touches the layers you aren't on.
</li>
<li>
What you see, and what every export writes, is the stack composited from Base up: each visible layer blends its colour over the result below with its blend mode, scaled by its coverage and opacity.
</li>
<li>
Blending happens on display colours, like Photoshop, so the modes behave as Photoshop users expect: 50% grey on an Overlay or Soft Light layer changes nothing, white on Multiply changes nothing, black on Screen changes nothing.
</li>
<li>
The Paint brush, <strong>Rgb</strong> while sculpting, <strong>Fill</strong>, <strong>Fill masked</strong> and <strong>Cavity</strong> all write into the <strong>active</strong> layer (highlighted in the list; the <strong>Paint</strong> menu shows "Painting on: ..."). They respect the mask and hidden faces on every layer.
</li>
<li>
With the Paint brush on a layer, <kbd>Alt</kbd> <strong>erases</strong> the layer's paint (on Base it paints back towards white, as before).
</li>
<li>
A hidden or locked layer can't be painted, filled or cleared; the status line says why.
</li>
</ul>
<h3 id="blend-modes">Blend modes<a class="anchor" href="#blend-modes" aria-label="Link to this section">#</a></h3>
<div class="table-wrap"><table><thead><tr><th>Mode</th><th>Effect</th></tr></thead><tbody><tr><td>Normal</td><td>The layer's colour covers what is below</td></tr><tr><td>Multiply</td><td>Darkens: dirt, shadows, cavity grime. White does nothing</td></tr><tr><td>Screen</td><td>Lightens: highlights, glow, dust. Black does nothing</td></tr><tr><td>Overlay</td><td>Adds contrast and tints the midtones. 50% grey does nothing</td></tr><tr><td>Soft Light</td><td>A gentler Overlay, good for skin tints and colour variation</td></tr><tr><td>Add</td><td>Adds the colours (Photoshop's Linear Dodge); strong highlights</td></tr><tr><td>Subtract</td><td>Subtracts the layer's colour</td></tr><tr><td>Darken / Lighten</td><td>Keeps the darker / lighter colour, channel by channel</td></tr><tr><td>Difference</td><td>The difference between the colours; useful for checking two paint passes against each other</td></tr></tbody></table></div>
<h3 id="the-paint-layers-sub-palette">The Paint Layers sub-palette<a class="anchor" href="#the-paint-layers-sub-palette" aria-label="Link to this section">#</a></h3>
<p>Open <strong>Tool > Paint Layers</strong> in the right tray (it sits under the sculpt <strong>Layers</strong> sub-palette). The list shows the layers top first, with Base at the bottom, like Photoshop's Layers panel. Each row has the name, the blend mode and opacity, a lock and an eye.</p>
<ul>
<li>
<strong>Click</strong> a row to paint on that layer. <strong>Double-click</strong> it to rename. <strong>Right-click</strong> for Rename, Duplicate, Merge down, Clear and Delete.
</li>
<li>
The <strong>eye</strong> shows or hides the layer; the <strong>lock</strong> protects it from painting, fills, clears and merges.
</li>
<li>
Under the list: the active layer's <strong>blend mode</strong> and <strong>Opacity</strong> slider. The opacity previews live while you drag and is one undo step when you let go.
</li>
<li>
<strong>New</strong> adds a transparent layer above the active one. <strong>Duplicate</strong> copies the active layer (Base becomes an opaque layer). <strong>Delete</strong> removes the active layer.
</li>
<li>
The arrows move the active layer up or down. <strong>Merge down</strong> merges it into the layer below (into Base for the lowest layer). <strong>Flatten</strong> bakes every visible layer into Base and removes the layers; hidden layers are discarded.
</li>
<li>
<strong>Clear layer</strong> makes the active layer transparent again (Base: white). <strong>Fill layer</strong> fills it with the current colour, like <strong>Fill</strong> in the <strong>Paint</strong> menu.
</li>
</ul>
<p>Hold <kbd>Ctrl</kbd> over any control for its description. Every action is undoable with <kbd>Ctrl</kbd>+<kbd>Z</kbd>.</p>
<aside class="callout callout-tip"><p><strong>Tip:</strong> Merging onto Base, and merging a layer onto a Normal layer it fully covers, keeps the look exactly. Merging a Multiply, Overlay or other blended layer onto a partly transparent layer can't always match, so the result takes the lower layer's blend mode, as in Photoshop.</p></aside>
<h3 id="paint-layers-and-sculpt-layers">Paint layers and sculpt layers<a class="anchor" href="#paint-layers-and-sculpt-layers" aria-label="Link to this section">#</a></h3>
<p>They are separate stacks. <strong>Tool > Layers</strong> holds sculpt layers: shape changes exported as blend shapes. <strong>Tool > Paint Layers</strong> holds colour. Selecting a sculpt layer doesn't change the paint layer you paint on, and the other way round, so a stroke with <strong>Rgb</strong> on can sculpt into the "Smile" layer and paint into the "Blush" layer at once.</p>
<h3 id="files-parts-and-geometry">Files, Parts and geometry<a class="anchor" href="#files-parts-and-geometry" aria-label="Link to this section">#</a></h3>
<ul>
<li>
Paint layers are saved in projects (<code>.sfproj</code>) with their names, blend modes, opacity, visibility, lock and the active layer. Older versions of SculptForge open these projects with the paint flattened.
</li>
<li>
Exports (OBJ, PLY, glTF/GLB, USD, Bridge) write the composited colours, exactly what the viewport shows.
</li>
<li>
<a href="parts.html">Duplicating</a> a Part copies its layers, and <a href="parts.html#split-a-part">Split</a> keeps them on each piece. <a href="geometry.html#subdivide">Subdividing</a> and <a href="geometry.html#decimate">decimating</a> keep them too.
</li>
<li>
<a href="parts.html#merge-parts">Merging</a> Parts, a <a href="geometry.html#voxel-remesh">voxel remesh</a> and other rebuilds keep the look but flatten the layers into Base.
</li>
</ul>
<h2 id="materials-lit-spheres">Materials (Lit Spheres)<a class="anchor" href="#materials-lit-spheres" aria-label="Link to this section">#</a></h2>
<p>The materials are material capture (lit sphere) images: each one is a picture of a lit sphere that shades the whole model. They change only how the model is shaded in the viewport. They aren't exported and don't change vertex paint.</p>
<div class="table-wrap"><table><thead><tr><th>Material</th><th>Look</th></tr></thead><tbody><tr><td>Soft Clay</td><td>The default: a matte warm light grey with a clear light and shadow side and a soft rim</td></tr><tr><td>Sculpt</td><td>Made for sculpting: neutral warm clay under a strong key light from the upper left, a crisp highlight and deep cavity shading, so small strokes and undulations stay readable</td></tr><tr><td>Red Wax</td><td>Glossy deep red wax, the classic sculpting look</td></tr><tr><td>Clay</td><td>Matte grey-brown clay</td></tr><tr><td>Skin</td><td>Warm, soft skin tones</td></tr><tr><td>Chrome</td><td>Mirror-like metal, good for checking surface flow</td></tr><tr><td>White</td><td>Neutral off-white for judging forms</td></tr><tr><td>Bronze</td><td>Polished bronze</td></tr><tr><td>Studio</td><td>Softer clay shading with studio lighting (the default in earlier versions). Its colour is <strong>Base colour</strong> in <strong>Render > Materials</strong></td></tr></tbody></table></div>
<p>To choose one:</p>
<ul>
<li>
Press <kbd>M</kbd> for the material picker under the cursor, or click the <strong>Material</strong> tile on the left shelf. Point at a material to preview it on the model, click to keep it. <kbd>Esc</kbd> or clicking away puts the previous material back.
</li>
<li>
Open <strong>Render > Materials</strong>, or the <strong>Material</strong> tab of the Library.
</li>
</ul>
<figure class="shot"><a href="images/material-picker.jpg" class="zoom"><img src="images/material-picker.jpg" alt="The material picker with the built-in Lit Spheres and Studio" width="480" height="225" loading="lazy" decoding="async"></a><figcaption>The material picker with the built-in Lit Spheres and Studio</figcaption></figure>
<p>Vertex Paint multiplies the material, and cavity shading stays on with every material (strongest with Sculpt). The material is saved with the project: projects saved with Studio open with Studio.</p>
<p><strong>Colour tints the material</strong> (in the <strong>Paint</strong> menu, on by default): on a Part with no vertex paint yet, the current colour tints its Lit Sphere material, so you can try a skin, stone or bronze tone without painting anything. The colour's hue and saturation tint it; grey (the starting colour) and black leave the material as it is, and the material keeps its own light and shade. Once a Part has vertex paint, the paint shows instead. PBR shading uses the material channels and is not tinted. Saved with the project.</p>
<aside class="callout callout-tip"><p><strong>Tip:</strong> <strong>Sculpt</strong> is the material to judge strokes with. The prettier ones (Skin, Red Wax) soften small detail; switch to them for presenting.</p></aside>
<h3 id="your-own-lit-spheres">Your own Lit Spheres<a class="anchor" href="#your-own-lit-spheres" aria-label="Link to this section">#</a></h3>
<p>Your own Lit Spheres are material capture (lit sphere) images too (Sloan and others, 2001): the view colours each point of the model with the sphere's colour where its surface faces the same way. Any lit-sphere image works: a square PNG, JPG or EXR with the sphere filling it (a non-square image is cropped to its centre; big ones are scaled to 1024 pixels).</p>
<ul>
<li>
<strong>Render > Materials > Load Lit Sphere...</strong> picks an image. It joins the material list under its file name, the view uses it, and a copy goes into the <strong>Lit Spheres</strong> folder of your library (<strong>Documents/SculptForge/Lit Spheres</strong>, or the folder set in <strong>Edit > Preferences > Library</strong>), so it is there next time.
</li>
<li>
Or put images into that <strong>Lit Spheres</strong> folder yourself: they show up the next time you open the material picker, <strong>Render > Materials</strong> or the Library's Material tab, no restart needed. Studios can share a read-only folder by listing it in the <code>SCULPTFORGE_LITSPHERE_PATH</code> environment variable (separated by <code>:</code>, <code>;</code> on Windows); those load when SculptForge starts.
</li>
<li>
<strong>Drop an image onto the Library's Material tab</strong> to load it the same way (dropped on the canvas, an image keeps its usual meaning).
</li>
<li>
<strong>Rename</strong> one: right-click it in the material picker, <strong>Render > Materials</strong> or the Library's Material tab and choose <strong>Rename...</strong>, type the name and press <kbd>Enter</kbd>. Its file in the Lit Spheres folder is renamed too. A name another Lit Sphere already has is refused, so nothing is overwritten. Projects that use it keep their look: they find it by its pixels, not its name.
</li>
<li>
<strong>Organise</strong> them in folders: each sub-folder of the Lit Spheres folder (one level) is a heading in the lists. Right-click a Lit Sphere and choose <strong>Move to folder</strong> for an existing folder, <strong>New folder...</strong> to make one, or <strong>Lit Spheres (no folder)</strong> to take it out again. You can also make the folders in your file manager.
</li>
<li>
Lit Spheres from a pack, from a studio folder or carried only by the open project have no file of yours to change: Rename and Move to folder are greyed out, and pointing at them says why.
</li>
<li>
To remove one, right-click it and choose <strong>Remove</strong>. An image from your Lit Spheres folder goes to the trash (the Recycle Bin on Windows), so you can still get it back. On macOS it is only hidden until you restart, and the message says where its file is so you can delete it yourself. Built-in materials can't be removed.
</li>
</ul>
<figure class="shot"><a href="images/custom-lit-spheres.jpg" class="zoom"><img src="images/custom-lit-spheres.jpg" alt="A Lit Sphere loaded from an image (Gold) in Render > Materials" width="544" height="700" loading="lazy" decoding="async"></a><figcaption>A Lit Sphere loaded from an image (Gold) in Render > Materials</figcaption></figure>
<figure class="shot"><a href="images/lit-sphere-folders.jpg" class="zoom"><img src="images/lit-sphere-folders.jpg" alt="Right-click a Lit Sphere for Rename... and Move to folder; the Metals folder is a heading in the list" width="354" height="452" loading="lazy" decoding="async"></a><figcaption>Right-click a Lit Sphere for Rename... and Move to folder; the Metals folder is a heading in the list</figcaption></figure>
<p>Your Lit Spheres appear in the material picker (<kbd>M</kbd>), <strong>Render > Materials</strong> and the Library, after the built-in ones, those in folders under their folder's name. A project that uses one carries a copy of the image, so it opens with the same look on another computer (or after you delete the file). Loading an image with the same name again replaces it. EXR images are read as linear light, so very bright highlights clip to white.</p>
<h2 id="smooth-and-flat-shading">Smooth and flat shading<a class="anchor" href="#smooth-and-flat-shading" aria-label="Link to this section">#</a></h2>
<p><strong>Smooth</strong> shading (the default) blends the light across polygons, so the surface reads as one form. <strong>Flat</strong> shading lights every polygon on its own, so you see the faces: how the mesh is built, where its vertices sit, and exactly what a stroke, crease or pinch did to the geometry, without smooth blending hiding small lumps. It helps most when blocking out forms on a low-poly base mesh.</p>
<ul>
<li>
<strong>Render > Materials > Shading</strong>: <strong>Smooth</strong> | <strong>Flat</strong> for the whole scene. The same buttons are in <strong>Tool > Display</strong>.
</li>
<li>
<strong>This Part</strong>: <strong>Scene</strong> (the default) follows the scene's shading; <strong>Smooth</strong> or <strong>Flat</strong> keeps the active Part that way whatever the scene says, for example a flat body with smooth eyes.
</li>
</ul>
<figure class="shot"><a href="images/shading.jpg" class="zoom"><img src="images/shading.jpg" alt="Smooth and Flat shading on the template head, with its eyes kept smooth" width="960" height="621" loading="lazy" decoding="async"></a><figcaption>Smooth and Flat shading on the template head, with its eyes kept smooth</figcaption></figure>
<p>Shading works with every material, vertex paint, textures and the mask. Like the material, it only changes the view: exports are unaffected. Projects save the scene's shading and each Part's own; projects from before open with your preferred shading. The scene's shading you choose is also the preference for the next session (it saves itself). Smooth and Flat have no default shortcut, so no classic key changes meaning; assign one under <strong>Edit > Preferences > Hotkeys</strong> if you switch often.</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>set_color color=#c08060</code></td><td>Set the paint colour: <code>rrggbb</code>, <code>#rrggbb</code> (quote it in scripts), <code>r,g,b</code> or a name such as <code>white</code>, <code>skin</code>, <code>bone</code></td></tr><tr><td><code>paint_fill area=unmasked</code></td><td>Fill; <code>area</code> is <code>unmasked</code> (default), <code>masked</code> or <code>all</code>; <code>strength</code> 0-1</td></tr><tr><td><code>paint_gradient x0=-1 y0=0 x1=1 y1=0 to=clear</code></td><td>Line Gradient from the paint colour (or <code>color</code>) at the start to <code>to</code> (a colour, or <code>clear</code>) at the end; the line in -1..1 view coordinates (<code>view_proj</code>, default the front view); <code>area</code> as <code>paint_fill</code></td></tr><tr><td><code>paint_from_cavity color=#202020 strength=0.7 smoothing=2</code></td><td>Cavity paint (defaults: dark brown, 0.7, 2 blur passes)</td></tr><tr><td><code>paint_clear</code></td><td>Remove all vertex paint, paint layers included</td></tr><tr><td><code>paint_layer_add name=Dirt blend=multiply opacity=0.8</code></td><td>Add a paint layer above the active one and paint on it</td></tr><tr><td><code>paint_layer_set index=0 opacity=0.5 blend=overlay visible=false locked=true name=Grime</code></td><td>Change a layer (<code>layer=Dirt</code> picks it by name; default: the active layer)</td></tr><tr><td><code>paint_layer_select layer=Base</code></td><td>Paint on another layer (<code>index=-1</code> is Base, 0 the first layer above it)</td></tr><tr><td><code>paint_layer_duplicate</code>, <code>paint_layer_delete</code>, <code>paint_layer_clear</code></td><td>Copy, delete or clear the active (or given) layer</td></tr><tr><td><code>paint_layer_move direction=up</code></td><td>Move a layer up or down the stack</td></tr><tr><td><code>paint_layer_merge</code> / <code>paint_layer_flatten</code></td><td>Merge down / bake every visible layer into Base</td></tr><tr><td><code>paint_layer_list</code></td><td>List the layers, top first (<code>*</code> marks the active one)</td></tr><tr><td><code>set_material name=Chrome</code></td><td>Viewport material: a Lit Sphere name (<code>Soft Clay</code> is the default, your own Lit Spheres included) or <code>studio</code> (desktop app only)</td></tr><tr><td><code>load_litsphere path=gold.png</code></td><td>Load a Lit Sphere image and use it; <code>keep=false</code> doesn't copy it into the Lit Spheres folder (desktop app only)</td></tr><tr><td><code>rename_litsphere name=Gold to="Old Gold"</code></td><td>Rename one of your Lit Spheres and its image in the Lit Spheres folder; a name in use is refused (desktop app only)</td></tr><tr><td><code>move_litsphere name=Gold folder=Metals</code></td><td>Move one of your Lit Spheres into a sub-folder of the Lit Spheres folder (made if needed; <code>folder=""</code> moves it back) (desktop app only)</td></tr><tr><td><code>remove_litsphere name=Gold</code></td><td>Remove one of your Lit Spheres; its image in the Lit Spheres folder goes to the trash (desktop app only)</td></tr><tr><td><code>set_background mode=flat color=60,70,80</code></td><td>The view's background: <code>gradient</code> (the default) or <code>flat</code> with a colour (<code>#rrggbb</code>, <code>r,g,b</code> or a name); see <a href="interface.html#the-background">The background</a> (desktop app only)</td></tr><tr><td><code>set_shading mode=flat</code></td><td>The scene's shading: <code>smooth</code> (the default) or <code>flat</code> (desktop app only)</td></tr><tr><td><code>part_shading mode=smooth name=Eyes</code></td><td>A Part's own shading: <code>default</code> (follow the scene), <code>smooth</code> or <code>flat</code>; <code>index</code> or <code>name</code> picks the Part (default: the active one)</td></tr></tbody></table></div>
<div class="code-block"><pre class="code"><code class="language-text">set_color color="#d9b38c"; paint_fill; paint_from_cavity strength=0.5
paint_layer_add name=Dirt blend=multiply opacity=0.8; paint_from_cavity color=4a2c18 strength=0.9</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="masking.html">Masking</a>: protect areas from painting
</li>
<li>
<a href="layers.html">Sculpt layers and blend shapes</a>: the shape counterpart of paint layers
</li>
<li>
<a href="sculpting.html">Sculpting and brushes</a>: Size, Falloff, strokes and alphas also apply to painting
</li>
<li>
<a href="exporting.html">Exporting</a>: which formats carry vertex colours
</li>
</ul>
</article>
<nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="tube.html"><span>Previous</span>Tube: draw in 3D space</a><a class="next" rel="next" href="texture-painting.html"><span>Next</span>Texture painting</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/vertex-paint.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-vertex-paint-works">How vertex paint works</a></li><li><a href="#paint-with-the-paint-brush">Paint with the Paint brush</a></li><li><a href="#paint-while-sculpting">Paint while sculpting</a></li><li><a href="#choose-a-colour">Choose a colour</a></li><li><a href="#fill-cavity-paint-and-clear">Fill, cavity paint and clear</a></li><li><a href="#line-gradient">Line Gradient</a></li><li><a href="#paint-through-a-stencil">Paint through a Stencil</a></li><li><a href="#paint-layers">Paint layers</a></li><li><a href="#materials-lit-spheres">Materials (Lit Spheres)</a></li><li><a href="#smooth-and-flat-shading">Smooth and flat shading</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 & 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>