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.

18.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>Gaussian splats - SculptForge User Guide</title>
  <meta name="description" content="Gaussian splats are the format behind phone and photogrammetry captures from apps such as Polycam, Luma, Postshot, Scaniverse and KIRI. SculptForge uses them three ways: as a reference to sculpt against, as a source for a sculptable, animation-ready mesh with its colours, and as an output when you t">
  <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/splats.html">
  <meta property="og:type" content="article">
  <meta property="og:title" content="Gaussian splats - SculptForge User Guide">
  <meta property="og:description" content="Gaussian splats are the format behind phone and photogrammetry captures from apps such as Polycam, Luma, Postshot, Scaniverse and KIRI. SculptForge uses them three ways: as a reference to sculpt against, as a source for a sculptable, animation-ready mesh with its colours, and as an output when you t">
  <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=5">
  <meta property="og:url" content="https://sculptforge.app/guide/splats.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="generate-3d.html" data-next="scan-to-splat.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">Gaussian splats</span></button>
      <div id="guide-toc" class="toc-panel">
        <div class="guide-search" role="search">
          <input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
          <div class="search-results" id="guide-results" hidden></div>
        </div>
        <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="brush-packs.html">Brush packs</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="linked-duplicates.html">Linked Duplicates</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="tube.html">Tube: draw in 3D space</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">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" class="current" aria-current="page">Gaussian splats</a><ul class="toc-sections"><li><a href="#supported-files">Supported files</a></li><li><a href="#load-a-capture-as-a-reference">Load a capture as a reference</a></li><li><a href="#make-a-capture-sculptable">Make a capture sculptable</a></li><li><a href="#turn-a-sculpt-into-splats">Turn a sculpt into splats</a></li><li><a href="#save-splats">Save splats</a></li><li><a href="#from-scripts">From scripts</a></li><li><a href="#see-also">See also</a></li></ul></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="gaussian-splats">Gaussian splats</h1>
<p>Gaussian splats are the format behind phone and photogrammetry captures from apps such as Polycam, Luma, Postshot, Scaniverse and KIRI. SculptForge uses them three ways: as a reference to sculpt against, as a source for a sculptable, animation-ready mesh with its colours, and as an output when you turn a sculpt into splats. This chapter covers all three.</p>
<figure class="shot"><a href="images/splats.jpg" class="zoom"><img src="images/splats.jpg" alt="A Gaussian splat capture made from the lion, with the mesh hidden and the Splats button on the right shelf" width="980" height="775" loading="lazy" decoding="async"></a><figcaption>A Gaussian splat capture made from the lion, with the mesh hidden and the Splats button on the right shelf</figcaption></figure>
<p>To make a splat yourself from a phone video or photos, see <a href="scan-to-splat.html">Scan an object into a splat</a>.</p>
<h2 id="supported-files">Supported files<a class="anchor" href="#supported-files" aria-label="Link to this section">#</a></h2>
<div class="table-wrap"><table><thead><tr><th>Format</th><th>Open</th><th>Save</th></tr></thead><tbody><tr><td>PLY (standard 3D Gaussian Splatting layout, spherical harmonics up to degree 3)</td><td>Yes</td><td>Yes</td></tr><tr><td><code>.splat</code> (compact web-viewer format)</td><td>Yes</td><td>Yes</td></tr><tr><td>glTF / GLB with <code>KHR_gaussian_splatting</code></td><td>Yes</td><td>Yes</td></tr><tr><td>OpenUSD <code>.usda</code> / <code>.usdz</code> with a <code>ParticleField3DGaussianSplat</code> prim</td><td>Yes</td><td>Yes</td></tr></tbody></table></div>
<p>A PLY file can hold either a mesh or splats; SculptForge tells them apart by their contents.</p>
<h2 id="load-a-capture-as-a-reference">Load a capture as a reference<a class="anchor" href="#load-a-capture-as-a-reference" aria-label="Link to this section">#</a></h2>
<ol>
<li>
Open the capture with <strong>File &gt; Open...</strong> (<kbd>Ctrl</kbd>+<kbd>O</kbd>), drop it onto the window, or double-click it in the Library <strong>Splats</strong> tab.
</li>
<li>
The splats load <strong>next to</strong> your sculpt: the current mesh stays, and the capture is drawn around it as a reference.
</li>
<li>
<strong>Render &gt; Gaussian Splats</strong> moves into the right tray by itself, and a <strong>Splats</strong> button appears on the right shelf to show or hide the capture.
</li>
</ol>
<p>Most captures arrive upside down, off-centre and at an arbitrary scale. Use the buttons in the <strong>Splats</strong> palette to place them:</p>
<div class="table-wrap"><table><thead><tr><th>Button</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Flip</strong></td><td>Turns the capture upside down (180 degrees about X). Most captures need this</td></tr><tr><td><strong>Turn 90</strong></td><td>Turns it 90 degrees about the vertical axis</td></tr><tr><td><strong>Fit</strong></td><td>Centres it at the origin and scales it to the size of a new sphere</td></tr><tr><td><strong>Clean floaters</strong></td><td>Removes faint splats and stray outliers around the subject</td></tr></tbody></table></div>
<p>The palette also shows the number of splats and their spherical-harmonic degree (for example &quot;1250000 splats (SH 3)&quot;), and has:</p>
<ul>
<li>
<strong>Show</strong> and <strong>Show mesh</strong> to show or hide the capture and the sculpt.
</li>
<li>
An <strong>opacity</strong> slider (0.05 to 1) to see the sculpt through the capture.
</li>
</ul>
<aside class="callout callout-tip"><p><strong>Tip:</strong> To sculpt a character over a scan, lower the opacity to about 0.4, turn on <strong>X</strong> symmetry and block in the forms on a sphere or a converted mesh with Clay Block and Move.</p></aside>
<h2 id="make-a-capture-sculptable">Make a capture sculptable<a class="anchor" href="#make-a-capture-sculptable" aria-label="Link to this section">#</a></h2>
<p><strong>Make sculptable</strong> (under <strong>From scan</strong> in <strong>Render &gt; Gaussian Splats</strong>) turns the capture into a clean Part you can sculpt and animate: a watertight surface without floaters, quad topology with loops round the eyes and mouth when it is a head, and the capture&#x27;s colours. The splats stay, hidden. It has its own chapter: <a href="scan-to-sculptable.html">From scan to sculptable mesh</a>.</p>
<h2 id="turn-a-sculpt-into-splats">Turn a sculpt into splats<a class="anchor" href="#turn-a-sculpt-into-splats" aria-label="Link to this section">#</a></h2>
<p><strong>Sculpt to splats</strong> (in <strong>Render &gt; Gaussian Splats</strong> when no splats are loaded, or from the command palette) covers the visible Parts with flat, oriented splats with soft clay shading baked in. Use it to show a sculpt in splat viewers, web scenes or engines that render 3D Gaussian splats. It replaces any loaded splats.</p>
<p>From a script you can choose the number of splats and whether to bake shading:</p>
<div class="code-block"><pre class="code"><code class="language-sh">sculptforge-cli -c &#x27;open path=bust.glb; mesh_to_splats count=500000 shading=true; splat_save path=bust.ply&#x27;</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
<h2 id="save-splats">Save splats<a class="anchor" href="#save-splats" aria-label="Link to this section">#</a></h2>
<p>Click <strong>Save splats...</strong> in <strong>Render &gt; Gaussian Splats</strong>, or <strong>File &gt; Save Splats...</strong>. Choose the format by the file type: PLY (for SuperSplat, Postshot and most tools), glTF (<code>.glb</code> with <code>KHR_gaussian_splatting</code>) or OpenUSD (<code>.usda</code> / <code>.usdz</code>). The <code>splat_save</code> command also writes <code>.splat</code>.</p>
<p>Placement you made with <strong>Flip</strong>, <strong>Turn 90</strong> and <strong>Fit</strong> is kept exactly in glTF and USD. PLY has no placement, so it is baked into the splats; if the capture was rotated, view-dependent colour (spherical harmonics above degree 0) is dropped from the PLY, because it would point the wrong way.</p>
<p>When you export USD (<strong>File &gt; Export USD / USDZ...</strong>) with splats loaded, they are included in the same file as a <code>ParticleField3DGaussianSplat</code> prim next to the meshes.</p>
<p>Projects (<code>.sfproj</code>) keep loaded splats and their placement.</p>
<p><strong>Clear</strong> in <strong>Render &gt; Gaussian Splats</strong> removes the capture.</p>
<h2 id="from-scripts">From scripts<a class="anchor" href="#from-scripts" aria-label="Link to this section">#</a></h2>
<div class="table-wrap"><table><thead><tr><th>Command</th><th>What it does</th><th>Key parameters</th></tr></thead><tbody><tr><td><code>open</code></td><td>Loads a capture as a reference next to the sculpt</td><td><code>path</code></td></tr><tr><td><code>splat_info</code></td><td>Reports the loaded splats</td><td></td></tr><tr><td><code>splat_transform</code></td><td>Rotates and places the capture</td><td><code>rotate_x</code>, <code>rotate_y</code>, <code>rotate_z</code> (degrees), <code>fit</code>, <code>reset</code></td></tr><tr><td><code>splat_clean</code></td><td>Removes faint splats and floaters</td><td><code>min_opacity</code> (default 0.05), <code>keep</code> (0.5 to 1, default 0.98)</td></tr><tr><td><code>splat_to_mesh</code></td><td>Make sculptable: a new Part with quads, face loops and colour (<a href="scan-to-sculptable.html#from-scripts">details</a>)</td><td><code>detail</code> (default 256), <code>preset</code> (game, film, sculpt), <code>color</code> (vertex paint, texture, none), <code>crop</code>, <code>face_guides</code></td></tr><tr><td><code>splat_test_capture</code></td><td>Loads a built-in test capture (a head or a mug)</td><td><code>kind</code></td></tr><tr><td><code>mesh_to_splats</code></td><td>Turns the visible Parts into splats</td><td><code>count</code> (default 250000), <code>shading</code> (default true)</td></tr><tr><td><code>splat_save</code></td><td>Saves <code>.ply</code>, <code>.splat</code>, <code>.glb</code>, <code>.usda</code> or <code>.usdz</code></td><td><code>path</code></td></tr><tr><td><code>splat_clear</code></td><td>Removes the splats</td><td></td></tr></tbody></table></div>
<p>A complete phone-capture-to-game-asset pipeline:</p>
<div class="code-block"><pre class="code"><code class="language-sh">sculptforge-cli -c &#x27;open path=scan.ply; splat_transform rotate_x=180 fit=true; splat_to_mesh preset=game color=texture; export_glb path=asset.glb&#x27;</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
<p>To render only the splats headless, use <code>sculptforge scan.ply --render scan.png --hide-mesh</code> (see <a href="scripting.html#the-sculptforge-app-on-the-command-line">Scripting and automation</a>).</p>
<h2 id="see-also">See also<a class="anchor" href="#see-also" aria-label="Link to this section">#</a></h2>
<ul>
<li>
<a href="scan-to-sculptable.html">From scan to sculptable mesh</a>: Make sculptable in detail
</li>
<li>
<a href="generate-3d.html">Image and text to 3D</a>: another way to get a base mesh
</li>
<li>
<a href="geometry.html">Subdivide, Remesh, Decimate and LODs</a>: clean up a converted mesh
</li>
<li>
<a href="exporting.html">Exporting</a>: USD and glTF exports that carry splats
</li>
</ul>
      </article>
      <nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="generate-3d.html"><span>Previous</span>Image and text to 3D</a><a class="next" rel="next" href="scan-to-splat.html"><span>Next</span>Scan an object into a splat</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/splats.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="#supported-files">Supported files</a></li><li><a href="#load-a-capture-as-a-reference">Load a capture as a reference</a></li><li><a href="#make-a-capture-sculptable">Make a capture sculptable</a></li><li><a href="#turn-a-sculpt-into-splats">Turn a sculpt into splats</a></li><li><a href="#save-splats">Save splats</a></li><li><a href="#from-scripts">From scripts</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>