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>Material painting (PBR) - SculptForge User Guide</title>
<meta name="description" content="A painted texture can carry more than colour. Turn on material channels and the Paint brush paints how rough, how metallic, how bumpy and how bright the surface is, all in one stroke, the way game engines and renderers describe materials (physically based rendering, PBR). Every channel lives on the ">
<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/pbr-painting.html">
<meta property="og:type" content="article">
<meta property="og:title" content="Material painting (PBR) - SculptForge User Guide">
<meta property="og:description" content="A painted texture can carry more than colour. Turn on material channels and the Paint brush paints how rough, how metallic, how bumpy and how bright the surface is, all in one stroke, the way game engines and renderers describe materials (physically based rendering, PBR). Every channel lives on the ">
<meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=5">
<meta property="og:url" content="https://sculptforge.app/guide/pbr-painting.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="uv-editor.html" data-next="fill-layers.html">
<div class="scroll-progress" aria-hidden="true"></div>
<header class="nav">
<div class="wrap nav-inner">
<a class="brand" href="../index.html"><img class="brand-mark" src="../img/bust-mark-44.png" srcset="../img/bust-mark-88.png 2x, ../img/bust-mark-132.png 3x" width="44" height="44" alt=""><span>SculptForge</span></a>
<nav aria-label="Main">
<a href="../index.html#features">Features</a>
<a href="../index.html#demos">Demos</a>
<a href="../brushes.html">Brushes</a>
<a href="index.html" aria-current="page">Guide</a>
<a class="nav-dl" href="../index.html#download">Download</a>
<a class="gh" href="https://discord.gg/gWrYkEmQhH">Discord</a>
<a class="gh" href="https://github.com/islandmed/SculptForge">GitHub</a>
</nav>
</div>
</header>
<div class="wrap guide-layout">
<div class="guide-side">
<button class="toc-toggle" type="button" aria-expanded="false" aria-controls="guide-toc">
<span>Contents</span><span class="toc-current">Material painting (PBR)</span></button>
<div id="guide-toc" class="toc-panel">
<div class="guide-search" role="search">
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
<nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What's new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="brush-packs.html">Brush packs</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="linked-duplicates.html">Linked Duplicates</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="tube.html">Tube: draw in 3D space</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html" class="current" aria-current="page">Material painting (PBR)</a><ul class="toc-sections"><li><a href="#the-channels">The channels</a></li><li><a href="#turn-channels-on">Turn channels on</a></li><li><a href="#paint-a-material">Paint a material</a></li><li><a href="#layers-and-channels">Layers and channels</a></li><li><a href="#the-pbr-viewport">The PBR viewport</a></li><li><a href="#see-one-channel-on-its-own">See one channel on its own</a></li><li><a href="#height-and-normals">Height and normals</a></li><li><a href="#carrying-channels-through-geometry-changes">Carrying channels through geometry changes</a></li><li><a href="#projects">Projects</a></li><li><a href="#commands">Commands</a></li><li><a href="#limitations">Limitations</a></li></ul></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="material-painting-pbr">Material painting (PBR)</h1>
<p>A painted texture can carry more than colour. Turn on <strong>material channels</strong> and the Paint brush paints how rough, how metallic, how bumpy and how bright the surface is, all in one stroke, the way game engines and renderers describe materials (physically based rendering, PBR). Every channel lives on the same UVs and paint layers as the colour from <a href="texture-painting.html">Texture painting</a>, and goes out to Unreal, Unity, Godot, Blender, glTF and USD with <a href="export-presets.html">Export presets</a>.</p>
<figure class="shot"><a href="images/pbr-solo-roughness.jpg" class="zoom"><img src="images/pbr-solo-roughness.jpg" alt="Solo roughness view: a glossy horizontal stroke on Base and a rough vertical stroke on a layer" width="960" height="580" loading="lazy" decoding="async"></a><figcaption>Solo roughness view: a glossy horizontal stroke on Base and a rough vertical stroke on a layer</figcaption></figure>
<h2 id="the-channels">The channels<a class="anchor" href="#the-channels" aria-label="Link to this section">#</a></h2>
<div class="table-wrap"><table><thead><tr><th>Channel</th><th>What it holds</th><th>Stored as</th></tr></thead><tbody><tr><td>Base Color</td><td>The surface colour. Always there.</td><td>8-bit sRGB (the texture you already paint)</td></tr><tr><td>Roughness</td><td>0 is mirror-like, 1 fully matte. Starts at 0.65.</td><td>8-bit</td></tr><tr><td>Metallic</td><td>0 for paint, stone, skin, plastic; 1 for bare metal. Starts at 0.</td><td>8-bit</td></tr><tr><td>Normal</td><td>Fine surface direction, a tangent-space normal map (OpenGL, green up). Starts flat.</td><td>8-bit RGB</td></tr><tr><td>Height</td><td>Painted relief, 0.5 = none. Also adds to the normal ("height to normal").</td><td>16-bit</td></tr><tr><td>Ambient Occlusion</td><td>How much light reaches crevices, 1 = open.</td><td>8-bit</td></tr><tr><td>Emissive</td><td>Light the surface gives off, black = none.</td><td>8-bit sRGB</td></tr><tr><td>Opacity</td><td>1 = opaque. Exported in the base colour's alpha.</td><td>8-bit</td></tr></tbody></table></div>
<p>A channel you turn on costs no memory until you paint it: channels are stored as 64 x 64 tiles, and a tile nobody painted is not stored at all (a tile of one value is stored as that one value). Turning a channel off discards what was painted in it; <strong>Undo</strong> brings it back.</p>
<h2 id="turn-channels-on">Turn channels on<a class="anchor" href="#turn-channels-on" aria-label="Link to this section">#</a></h2>
<ol>
<li>
Give the Part a texture (<a href="texture-painting.html">Texture painting</a>).
</li>
<li>
Open <strong>Tool > Texture Map</strong>. Under <strong>Material Channels</strong>, tick the channels you want (for a typical game asset: Roughness, Metallic and Normal; add Height to paint relief, Ambient Occlusion to paint dirt into crevices).
</li>
<li>
<strong>Channel memory</strong> below the ticks shows what the painted tiles use; the same number, for every Part, is in <strong>Edit > Preferences > Performance</strong> under Memory.
</li>
</ol>
<h2 id="paint-a-material">Paint a material<a class="anchor" href="#paint-a-material" aria-label="Link to this section">#</a></h2>
<p>Open the <strong>Paint</strong> menu. With a material texture, a <strong>Material</strong> section appears under the swatches:</p>
<figure class="shot"><a href="images/pbr-brush-material.jpg" class="zoom"><img src="images/pbr-brush-material.jpg" alt="Paint > Material: material swatches, and per channel a tick, value swatches and a slider; Material Channels in Tool > Texture Map" width="360" height="940" loading="lazy" decoding="async"></a><figcaption>Paint > Material: material swatches, and per channel a tick, value swatches and a slider; Material Channels in Tool > Texture Map</figcaption></figure>
<ul>
<li>
<strong>Material swatches</strong> set the colour, roughness and metallic at once (bare metal, gold, copper, rust, gloss paint, rubber, stone, clay) and make the brush paint those channels.
</li>
<li>
One row per channel: the tick says whether the brush paints that channel; the five grey squares pick 0, 25, 50, 75 or 100%; the slider sets any value. Normal has two tilt sliders (0, 0 paints a flat normal). Emissive has a colour.
</li>
</ul>
<p>Untick Base Color to paint only roughness (a wet patch, a polished edge) without touching the colour. Every stroke is one undo step for all the channels it painted. The brush's falloff, alpha, pen pressure, symmetry and mask apply to every channel alike; erasing (<kbd>Alt</kbd>) paints Base back to each channel's default and makes layers transparent.</p>
<p><strong>C over the model picks the whole material</strong>: the colour and every channel under the cursor become the brush material, and the brush then paints all of the texture's channels.</p>
<h2 id="layers-and-channels">Layers and channels<a class="anchor" href="#layers-and-channels" aria-label="Link to this section">#</a></h2>
<p>Paint layers (<a href="texture-painting.html#paint-layers-on-a-texture">Texture painting</a>) hold every channel. In <strong>Tool > Paint Layers</strong>, each layer row gets a row of <strong>channel chips</strong> (BC, R, M, N, H, AO, E, Op):</p>
<ul>
<li>
<strong>Click</strong> a chip to turn that channel of the layer on or off. A rust layer can carry colour and roughness but leave metallic alone; a scratches layer can affect only the normal.
</li>
<li>
<strong>Right-click</strong> a chip for the channel's <strong>blend mode</strong> and <strong>opacity</strong>. The ten paint-layer blend modes work per channel (Multiply on roughness halves it where you paint, Screen brightens AO...). The Normal channel adds <strong>Normal Combine</strong>, which lays the layer's normal detail onto the normals below instead of replacing them. A chip with a <code>*</code> uses a blend mode other than Normal or less than full opacity.
</li>
<li>
The layer's own opacity, visibility and lock apply to all its channels.
</li>
</ul>
<p>Merge down and Flatten keep the look of every channel. Duplicate copies a layer with its channels.</p>
<h2 id="the-pbr-viewport">The PBR viewport<a class="anchor" href="#the-pbr-viewport" aria-label="Link to this section">#</a></h2>
<p><strong>Render > Materials > Viewport Shading</strong> switches the view between <strong>Lit Sphere</strong> (the default, made for reading forms while sculpting) and <strong>PBR</strong>, which lights the material channels the way game engines and renderers do: rough surfaces spread the light, metals reflect the environment in their own colour, painted height and normals catch the light, emissive glows.</p>
<figure class="shot"><a href="images/pbr-viewport.jpg" class="zoom"><img src="images/pbr-viewport.jpg" alt="PBR viewport, Photo Studio: gold metal and a raised rough red stroke" width="1100" height="660" loading="lazy" decoding="async"></a><figcaption>PBR viewport, Photo Studio: gold metal and a raised rough red stroke</figcaption></figure>
<ul>
<li>
<strong>Environment</strong>: <strong>Studio</strong> (made by SculptForge), <strong>Photo Studio</strong>, <strong>Small Studio</strong> and <strong>Outdoor Sky</strong> (free CC0 photographs from Poly Haven). HDR images (<code>.hdr</code>, <code>.exr</code>) in the folders listed in the <code>SCULPTFORGE_HDRI_PATH</code> environment variable are added to the list.
</li>
<li>
<strong>Exposure</strong> in stops, <strong>Rotation</strong> of the environment, and the <strong>Tone map</strong>: ACES (filmic contrast), AgX (softer, keeps bright colours from going flat), Reinhard or None.
</li>
<li>
<strong>Show environment</strong> puts the environment behind the model, with a <strong>Blur</strong>.
</li>
<li>
<strong>Roughness</strong> and <strong>Metallic</strong> apply to Parts without a material texture (their colour comes from vertex paint or the base colour), so you can judge a sculpt as metal or clay too.
</li>
<li>
<strong>Cavity</strong> darkens the sculpt's creases a little so fine detail reads under even light; 0 is plain PBR.
</li>
</ul>
<figure class="shot"><a href="images/pbr-environment.jpg" class="zoom"><img src="images/pbr-environment.jpg" alt="The environment behind the model: Outdoor Sky with the AgX tone map" width="960" height="676" loading="lazy" decoding="async"></a><figcaption>The environment behind the model: Outdoor Sky with the AgX tone map</figcaption></figure>
<p>The view stays as fast as Lit Sphere: lighting is precomputed per environment (on a worker thread when you switch), and only the pixels on screen pay for it. A 20.9-million-triangle Part draws in about 8 ms in PBR next to about 6 ms with Lit Sphere on an Apple M1 Pro. The settings are saved with the project (<code>viewport_shading mode=pbr environment=outdoor_sky exposure=0.5 tone_map=agx</code>).</p>
<h2 id="see-one-channel-on-its-own">See one channel on its own<a class="anchor" href="#see-one-channel-on-its-own" aria-label="Link to this section">#</a></h2>
<p><strong>Tool > Texture Map > Normal view</strong> opens a list: pick <strong>Solo Roughness</strong> (or any enabled channel) and the model shows just that channel, in grey for roughness, metallic, height, AO and opacity, as colours for the normal (with the height's normal in it) and in colour for emissive. Painting updates it live. Pick <strong>Normal view</strong> to go back. The viewport doesn't yet render the channels together as a lit PBR material; the solo view is how you check them for now.</p>
<h2 id="height-and-normals">Height and normals<a class="anchor" href="#height-and-normals" aria-label="Link to this section">#</a></h2>
<p>Height is stored with 16 bits, so slow ramps don't band. Its slope becomes a normal that is combined onto the Normal channel (Normal Combine) wherever a normal is shown or exported, so painting height also gives the shading detail. <code>texture_channels height_normal_strength=4</code> sets how steep that normal is (0: height adds no normal).</p>
<h2 id="carrying-channels-through-geometry-changes">Carrying channels through geometry changes<a class="anchor" href="#carrying-channels-through-geometry-changes" aria-label="Link to this section">#</a></h2>
<p>Auto UV, Voxel Remesh, Quad Remesh and merging Parts move every channel and every layer's channels onto the new UVs, as they do the colour. A part without a channel takes that channel's default when Parts merge.</p>
<h2 id="projects">Projects<a class="anchor" href="#projects" aria-label="Link to this section">#</a></h2>
<p>Projects with material channels are saved as format 7 (SculptForge 0.10 and later opens them). A project without material channels is still saved as format 6, so older versions keep opening it. Older projects open as they did.</p>
<h2 id="commands">Commands<a class="anchor" href="#commands" aria-label="Link to this section">#</a></h2>
<div class="table-wrap"><table><thead><tr><th>Command</th><th>What it does</th></tr></thead><tbody><tr><td><code>texture_channels enable=roughness,metallic,normal</code></td><td>Turn channels on (<code>disable=...</code> off; no arguments lists them)</td></tr><tr><td><code>paint_material roughness=0.2 metallic=1 color=c0c0c8</code></td><td>Set the brush material; <code>channels=all</code> / <code>channels=roughness</code> say exactly what it paints</td></tr><tr><td><code>texture_layer_channel channel=normal blend=normal_combine</code></td><td>A layer's channel settings (<code>enabled</code>, <code>blend</code>, <code>opacity</code>; <code>layer</code> or <code>index</code>)</td></tr><tr><td><code>channel_view channel=roughness</code></td><td>Solo a channel in the viewport (<code>off</code> to go back)</td></tr><tr><td><code>export_maps preset=unreal folder=...</code></td><td>Write the maps (<a href="export-presets.html">Export presets</a>)</td></tr><tr><td><code>viewport_shading mode=pbr environment=photo_studio exposure=0.3</code></td><td>The PBR viewport (<code>mode=lit_sphere</code> to go back; <code>rotation</code>, <code>tone_map</code>, <code>background</code>, <code>blur</code>, <code>roughness</code>, <code>metallic</code>, <code>cavity</code>)</td></tr></tbody></table></div>
<h2 id="limitations">Limitations<a class="anchor" href="#limitations" aria-label="Link to this section">#</a></h2>
<ul>
<li>
Fill layers, their mask generators, Mesh Maps and Material Recipes have their own chapter: <a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a>.
</li>
<li>
One texture per Part (UDIM tiles bake as files, <a href="baking.html">Baking</a>, but paint goes into one texture).
</li>
<li>
Memory: colour, roughness, metallic, height and AO on Base plus three layers, each with a few big strokes, take about 370 MB at 4K and 1.5 GB at 8K (most of it the colour layers); a layer painted everywhere adds about 200 MB of channels at 4K and 800 MB at 8K. Edit > Preferences > Performance shows the numbers for your scene. Paint at 4K unless you need 8K.
</li>
<li>
Export Maps takes a few seconds at 4K and about ten at 8K (PNG compression).
</li>
</ul>
</article>
<nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="uv-editor.html"><span>Previous</span>UV Editor</a><a class="next" rel="next" href="fill-layers.html"><span>Next</span>Fill layers, Mesh Maps and Material Recipes</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/pbr-painting.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="#the-channels">The channels</a></li><li><a href="#turn-channels-on">Turn channels on</a></li><li><a href="#paint-a-material">Paint a material</a></li><li><a href="#layers-and-channels">Layers and channels</a></li><li><a href="#the-pbr-viewport">The PBR viewport</a></li><li><a href="#see-one-channel-on-its-own">See one channel on its own</a></li><li><a href="#height-and-normals">Height and normals</a></li><li><a href="#carrying-channels-through-geometry-changes">Carrying channels through geometry changes</a></li><li><a href="#projects">Projects</a></li><li><a href="#commands">Commands</a></li><li><a href="#limitations">Limitations</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>