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
Capture from phone: say what to do when the phone can't open the page (Android Chrome blocking home-network addresses -> use Firefox; Linux firewall port), in the window and the guide
islandmed3c25d1ab74bf
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex dde80269..de53e98f 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -6,6 +6,12 @@ All notable changes to SculptForge are listed here. The format follows## [Unreleased]+### Fixed+- Capture from phone tells you what to do when the phone can't open the page: Android Chrome can refuse every+ home-network address ("This site can't be reached", ERR_TOO_MANY_RETRIES), so use Firefox on the phone; and Linux+ firewalls (ufw, firewalld) need the port allowed. In the window and in the guide's Phone capture chapter.+- Baking: Cancel is honoured on small bakes too.+## [0.9.0] - 2026-10-26Maquette to performance: scan with your phone, make the scan sculptable, give a head its facial shapes anddiff --git a/docs/guide/phone-capture.md b/docs/guide/phone-capture.mdindex f4e3e7ef..77cf3357 100644--- a/docs/guide/phone-capture.md+++ b/docs/guide/phone-capture.md@@ -21,6 +21,27 @@ there is a new code. A code nobody uses expires after 10 minutes.> both devices, and allow SculptForge through the firewall (Windows asks the first time; choose private networks).> If the computer has several networks, pick the Wi-Fi one under **Network** in the window.+### "This site can't be reached" on Android++Recent versions of Chrome on Android can refuse to open any address on your home network, even your router's,+and show **This site can't be reached** (under Details: `ERR_TOO_MANY_RETRIES`). Until SculptForge's capture page+moves to the website, the simplest fix is to **use Firefox on the phone**: install it from the Play Store, open the+address shown under the QR code (for example `http://10.0.0.117:8765`), allow it to reach devices on your local+network when it asks, and type the 6-digit code. Firefox can also be set as the phone's default browser so the+camera's QR links open there.++### Linux firewall++Many Linux desktops (Omarchy, Ubuntu with ufw enabled, Fedora with firewalld) block incoming connections, so the+phone's request never arrives. Allow SculptForge's port from your home network only, for example with ufw:++```+sudo ufw allow from 10.0.0.0/24 to any port 8765 proto tcp comment 'SculptForge phone capture'+```++Use your own network's range (the first three numbers of the address under the QR code, then `.0/24`). With+firewalld: `sudo firewall-cmd --add-port=8765/tcp` (add `--permanent` to keep it).+## Scan an objectTap **Scan an object**, read the tips, and tap **Record a video**. Walk slowly all the way round the object, thendiff --git a/src/app/PanelPhone.cpp b/src/app/PanelPhone.cppindex 81b7e3f2..cdecb14e 100644--- a/src/app/PanelPhone.cpp+++ b/src/app/PanelPhone.cpp@@ -408,6 +408,7 @@ void App::drawPhoneWindow() {"File > Capture from phone");ImGui::TextUnformatted("Scan with your phone's camera");hint("Phone and computer on the same Wi-Fi. No app to install.");+ hint("Page won't open? Use Firefox on the phone: some Chrome versions block home-network addresses.");ImGui::Spacing();ImGui::TextDisabled("No camera? Open this in the phone's browser:");ImGui::Text("http://%s", st.address.c_str());@@ -457,6 +458,11 @@ void App::drawPhoneWindow() {ImGui::BulletText("Windows: allow SculptForge on private networks\nwhen the firewall asks.");ImGui::BulletText("macOS: allow incoming connections for SculptForge\n(System Settings > Network > Firewall).");ImGui::BulletText("Several networks? Pick the Wi-Fi one under Network.");+ ImGui::BulletText("Android Chrome says \"This site can't be reached\"\n(ERR_TOO_MANY_RETRIES)? Recent Chrome versions can\n"+ "block every home-network address, even your router.\nUse Firefox on the phone instead and allow it to\n"+ "reach local devices when it asks.");+ ImGui::BulletText("Linux: allow port %d through the firewall, e.g.\nsudo ufw allow from <your network>/24 to any\nport %d proto tcp",+ int(phone_->port()), int(phone_->port()));ImGui::TreePop();}}diff --git a/tests/ui/phone_link.sfui b/tests/ui/phone_link.sfuiindex 7beef969..016d0e99 100644--- a/tests/ui/phone_link.sfui+++ b/tests/ui/phone_link.sfui@@ -22,6 +22,11 @@ hold ctrlhover "##phoneqr"expect_help "Point your phone's camera"hold none+expect_text "Use Firefox on the phone"+click "The phone can't open the page?"+expect_text "ERR_TOO_MANY_RETRIES"+shot troubleshooting+click "The phone can't open the page?"shot window# Only the session's token opens the link.diff --git a/website/guide/phone-capture.html b/website/guide/phone-capture.htmlindex 2c7bad1f..3d21edb7 100644--- a/website/guide/phone-capture.html+++ b/website/guide/phone-capture.html@@ -64,6 +64,12 @@ Point the phone's camera at the QR code and tap the link it shows. The capt<p>The phone and the computer must be on the same Wi-Fi. If the phone has no QR scanner, open the address shown under the code in its browser and type the 6-digit pairing code.</p><p>The link works only while the window is open: closing it stops SculptForge listening, and the next time you open it there is a new code. A code nobody uses expires after 10 minutes.</p><aside class="callout callout-tip"><p><strong>Tip:</strong> The phone can't open the page? Check that it isn't on a guest network or mobile data, turn off VPNs on both devices, and allow SculptForge through the firewall (Windows asks the first time; choose private networks). If the computer has several networks, pick the Wi-Fi one under <strong>Network</strong> in the window.</p></aside>+<h3 id="this-site-cant-be-reached-on-android">"This site can't be reached" on Android<a class="anchor" href="#this-site-cant-be-reached-on-android" aria-label="Link to this section">#</a></h3>+<p>Recent versions of Chrome on Android can refuse to open any address on your home network, even your router's, and show <strong>This site can't be reached</strong> (under Details: <code>ERR_TOO_MANY_RETRIES</code>). Until SculptForge's capture page moves to the website, the simplest fix is to <strong>use Firefox on the phone</strong>: install it from the Play Store, open the address shown under the QR code (for example <code>http://10.0.0.117:8765</code>), allow it to reach devices on your local network when it asks, and type the 6-digit code. Firefox can also be set as the phone's default browser so the camera's QR links open there.</p>+<h3 id="linux-firewall">Linux firewall<a class="anchor" href="#linux-firewall" aria-label="Link to this section">#</a></h3>+<p>Many Linux desktops (Omarchy, Ubuntu with ufw enabled, Fedora with firewalld) block incoming connections, so the phone's request never arrives. Allow SculptForge's port from your home network only, for example with ufw:</p>+<div class="code-block"><pre class="code"><code>sudo ufw allow from 10.0.0.0/24 to any port 8765 proto tcp comment 'SculptForge phone capture'</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>+<p>Use your own network's range (the first three numbers of the address under the QR code, then <code>.0/24</code>). With firewalld: <code>sudo firewall-cmd --add-port=8765/tcp</code> (add <code>--permanent</code> to keep it).</p><h2 id="scan-an-object">Scan an object<a class="anchor" href="#scan-an-object" aria-label="Link to this section">#</a></h2><p>Tap <strong>Scan an object</strong>, read the tips, and tap <strong>Record a video</strong>. Walk slowly all the way round the object, then once more a little lower, for 20 to 60 seconds:</p><ul>diff --git a/website/guide/search-index.js b/website/guide/search-index.jsindex 483c5262..daa71240 100644--- a/website/guide/search-index.js+++ b/website/guide/search-index.js@@ -1 +1 @@-window.GUIDE_INDEX=[{"p":"index.html","c":"SculptForge User Guide","a":"","h":"SculptForge User Guide","t":"This guide explains every part of SculptForge, the free, open-source sculpting app for VFX, animation and games: how the interface is organised, how to sculpt, mask, paint (on vertices or textures) and manage SubTools, how to generate models with AI, and how to get your work into a game engine, a film pipeline, Blender or ZBrush. It is written for SculptForge 0.4. You can read it inside SculptForge (Help > User Guide, or Shift+F1) or on the SculptForge website. If you're coming from ZBrush, start with Coming from ZBrush and keep the Glossary at hand: ZBrush's keys and gestures work as they are. The SculptForge window with its main regions labelled"},{"p":"index.html","c":"SculptForge User Guide","a":"getting-started","h":"Getting started","t":"Welcome to SculptForge What's new Coming from ZBrush Installing SculptForge The interface Navigating the view"},{"p":"index.html","c":"SculptForge User Guide","a":"sculpting","h":"Sculpting","t":"Sculpting and brushes Brush Lab and sharing brushes Masking Polygroups and visibility SubTools Polypaint and materials Texture painting Sculpt layers and blend shapes Facial shapes and live face Subdivision levels Dynamic topology Moving, rotating and posing (Gizmo 3D) Subdivide, remesh, decimate and LODs Quad retopology and detail projection"},{"p":"index.html","c":"SculptForge User Guide","a":"ai-and-capture","h":"AI and capture","t":"Image and text to 3D Gaussian splats Scan an object into a splat From scan to sculptable mesh Phone capture and AR"},{"p":"index.html","c":"SculptForge User Guide","a":"files-and-pipelines","h":"Files and pipelines","t":"Baking normal and displacement maps Exporting, Unreal and ZBrush Working with Blender Projects, autosave and QuickSave Scripting and automation SculptForge for studios"},{"p":"index.html","c":"SculptForge User Guide","a":"reference","h":"Reference","t":"Keyboard and mouse Performance and big meshes Troubleshooting and FAQ Glossary"},{"p":"index.html","c":"SculptForge User Guide","a":"getting-help","h":"Getting help","t":"Hold Ctrl and point at any button for what it does, its shortcut and its script command. Press F1 for every shortcut and mouse gesture, and F3 to find any command by name. Ask questions and report problems on the issue tracker (Help > Report a problem). SculptForge is free software under the GNU General Public License v3.0 or later. This guide is part of SculptForge and is covered by the same licence."},{"p":"welcome.html","c":"Welcome to SculptForge","a":"","h":"Welcome to SculptForge","t":"SculptForge is a free, open-source digital sculpting application for VFX, animation and games. This chapter explains what it is, what it can and can't do yet, and how the rest of this guide is organised."},{"p":"welcome.html","c":"Welcome to SculptForge","a":"what-sculptforge-is","h":"What SculptForge is","t":"SculptForge is a focused sculpting tool with the brushes, symmetry, masking and navigation that ZBrush artists already know, built around a ZBrush-style interface: shelves around a canvas, alphabetical palettes that hold every function, a LightBox of thumbnails and pop-up pickers. It runs natively on Windows, macOS and Linux, starts in a moment, works offline and costs nothing. ZBrush's keys and gestures work out of the box: see Coming from ZBrush. There is no account, no subscription, no licence server and no telemetry. It is free software under the GNU General Public License v3.0 or later. You own everything you make with it: the GPL covers the program, not your models."},{"p":"welcome.html","c":"Welcome to SculptForge","a":"what-you-can-do-with-it","h":"What you can do with it","t":"Sculpt with fourteen built-in brushes (Standard, Clay, Clay Buildup, Dam Standard, Move, Smooth, Inflate, Pinch, Flatten, Crease, Trim, Snake Hook, Layer and Nudge), four stroke types, brush alphas, X/Y/Z symmetry and tablet pressure. See Sculpting and brushes. Design brushes in words with Brush Lab: describe \"dry cracked mud\" and an AI builds a brush recipe you can tweak with sliders, keep in your library and share as a file or a one-line brush code. See Brush Lab and sharing brushes. Mask, group and hide parts of the model the ZBrush way: Ctrl to paint a mask, Ctrl+Shift to isolate a polygroup. See Masking and Polygroups and visibility. Keep separate meshes as SubTools (body, eyes, teeth, armour), each with its own undo history. See SubTools. Paint colour on the surface (polypaint) and look at the model through seven MatCap materials. See Polypaint and materials. Sculpt layers that double as blend shapes (morph targets), with live weights. See Sculpt layers and blend shapes. Rebuild the mesh: Loop subdivision, voxel remesh (similar to DynaMesh), decimation and one-click LOD chains. See Subdivide, remesh, decimate and LODs. Generate a model from a sketch, concept art or a description, free through Hugging Face or on your own ComfyUI server. See Image and text to 3D. Work with Gaussian splats from phone captures: sculpt against them or turn them into meshes. See Gaussian splats. Export to glTF/GLB, FBX, OpenUSD, OBJ, STL and PLY, send models straight into Unreal Engine, and exchange them with ZBrush through GoZ. See Exporting, Unreal and ZBrush. Automate everything: every action is a command you can type in the console, run headless with sculptforge-cli, script from Python or hand to an AI agent over MCP. See Scripting and automation."},{"p":"welcome.html","c":"Welcome to SculptForge","a":"what-it-doesnt-do-yet","h":"What it doesn't do yet","t":"SculptForge is young (version 0.8; see What's new). Some things ZBrush artists rely on are still on the roadmap: QRemesh curve guides. UV editing (seams, relax) and UDIM tiles. Booleans and stencils. Others are not on the roadmap: ZSpheres, ZModeler, the 2.5D canvas, and reading ZBrush's own .ZTL and .ZPR files directly (bring models over with GoZ, the ZTool Export plug-in for ZBrush, or as OBJ, FBX or GLB). Not yet: where a chapter describes a ZBrush feature SculptForge doesn't have, it says so in a callout like this one. The project's ROADMAP.md lists what is planned and in which order."},{"p":"welcome.html","c":"Welcome to SculptForge","a":"coming-from-zbrush","h":"Coming from ZBrush","t":"Most habits carry over. You sculpt with a left drag, hold Alt to subtract and Shift to smooth, drag on the background to rotate, Alt+drag to pan, and hold Ctrl to mask. The palettes have the names you expect (Alpha, Brush, Stroke, Tool, Transform...), the Tool palette holds the SubTool, Masking and Polygroups sub-palettes, B opens the brush pop-up with the same letter keys (B, S, T picks Standard), , opens the LightBox and Ctrl+Shift+I stores your interface, and S U I O, Space, Ctrl+W and the mask keys do what your hands expect. Coming from ZBrush lists what is the same, what differs and every shortcut side by side; the Glossary maps ZBrush terms to SculptForge ones."},{"p":"welcome.html","c":"Welcome to SculptForge","a":"how-this-guide-is-organised","h":"How this guide is organised","t":"Getting started: installing, the interface and navigating the view. Sculpting: brushes, Brush Lab, masking, polygroups, SubTools, polypaint, layers and mesh operations. AI and capture: generating models from images and text, and Gaussian splats. Files and pipelines: exporting, projects, scripting and studio deployment. Reference: keyboard and mouse, troubleshooting and the glossary. Inside SculptForge, Help > User Guide opens this guide in its own window with a table of contents, search and links between chapters. Two other kinds of help are always a keystroke away: Hold Ctrl and point at any button, slider or tile to see what it does, its shortcut and the script command behind it. Press F1 for the Controls sheet (every shortcut and mouse gesture) or F3 to search for any command by name."},{"p":"welcome.html","c":"Welcome to SculptForge","a":"getting-help-and-reporting-problems","h":"Getting help and reporting problems","t":"Help > Report a problem opens the issue tracker on GitHub (github.com/islandmed/SculptForge/issues). Include your operating system, your graphics card and what you did just before the problem; see Troubleshooting and FAQ for what else helps. Help > Website & documentation opens the SculptForge website."},{"p":"welcome.html","c":"Welcome to SculptForge","a":"see-also","h":"See also","t":"Installing SculptForge The interface Glossary"},{"p":"whats-new.html","c":"What's new","a":"","h":"What's new","t":"What changed in each version of SculptForge, newest first, with links to the chapters that explain it. This chapter opens by itself the first time you start a new version; you can always find it again under Help > What's New. Every detail is in the changelog."},{"p":"whats-new.html","c":"What's new","a":"version-090","h":"Version 0.9.0","t":"Maquette to performance: scan an object or a clay maquette with your phone, turn the scan into a clean mesh you can sculpt and animate, give a head the 52 ARKit facial shapes, and drive them live with your own face."},{"p":"whats-new.html","c":"What's new","a":"facial-shapes-and-live-face","h":"Facial shapes and live face","t":"Tool > Facial Shapes > Generate Facial Shapes gives a sculpted head the 52 Apple ARKit blend shapes (eyeBlinkLeft, jawOpen, mouthSmileRight, ...) as sculpt layers, fitted to its proportions from a template head with those shapes (ICT-FaceKit, MIT licence). Eyes, teeth and tongue SubTools get theirs too. Fix any shape by sculpting into its layer, check them with the Face test presets and sliders, and export them with their ARKit names to GLB, USD, FBX and Blender (as shape keys). face_weights drives them live from a face feed, and recorded takes play in the viewport and bake into a glTF animation or USD time samples. new_head starts a scene with a human head to sculpt on. See Facial shapes and live face."},{"p":"whats-new.html","c":"What's new","a":"scan-an-object-into-a-splat","h":"Scan an object into a splat","t":"Film an object with your phone, or take photos all around it, and SculptForge trains a Gaussian splat from it on your own graphics card. The splat appears in the viewport after a few hundred steps and sharpens while it trains; you can orbit around it, stop when it's good enough, or cancel. Pick Video... or Photos Folder... under Splats > Train from capture, or drop a video onto the window. The free Brush trainer is offered as a one-click download the first time. See Scan an object into a splat."},{"p":"whats-new.html","c":"What's new","a":"make-sculptable-from-a-scan-to-a-production-asset","h":"Make sculptable: from a scan to a production asset","t":"One click in the Splats palette turns a Gaussian-splat capture into a clean SubTool you can sculpt, rig and animate: a watertight surface with the floaters and background gone and open bottoms sealed, quad topology at a Game, Film or Sculpt budget, edge loops round the eyes and mouth and along the nasolabial folds when the capture is a head (mirrored across the face), and the capture's colours as polypaint or a texture. A crop box cuts away the table or the room; Review shows the face landmarks to nudge before remeshing. The splats stay, hidden. Five million splats take about ten seconds on a laptop. See From scan to sculptable mesh."},{"p":"whats-new.html","c":"What's new","a":"your-phone-as-sculptforges-camera","h":"Your phone as SculptForge's camera","t":"File > Capture from phone shows a QR code: scan it and your phone's browser can send SculptForge a scan (walk round an object for 20 to 60 seconds), a photo to turn into a model, or a splat file from a scanning app. Tap View in AR to see your sculpt standing on your desk, updated as you sculpt, and Face capture to drive a character's facial shapes with your own face, live. No app to install. See Phone capture and AR."},{"p":"whats-new.html","c":"What's new","a":"version-081","h":"Version 0.8.1","t":"Fixes from a ZBrush artist's testing, and a way to bring your ZTools over."},{"p":"whats-new.html","c":"What's new","a":"more-like-zbrush","h":"More like ZBrush","t":"ZBrush zoom direction. With the ZBrush input style, dragging up zooms out on every zoom drag, as in ZBrush. See Navigation. Ctrl and Ctrl+Shift brushes. Hold Ctrl and the left shelf shows the mask brush; with Ctrl held the Brush and Stroke pickers pick MaskPen, MaskLasso or MaskRect. Ctrl+Shift does the same for SelectRect and SelectLasso. See Masking. Group by UVs. One polygroup per UV island, in Tool > Polygroups. See Polygroups and visibility."},{"p":"whats-new.html","c":"What's new","a":"texture-painting-one-click-to-start-and-faster","h":"Texture painting: one click to start, and faster","t":"With the Paint brush on, a SubTool without a texture now shows New Texture on the top shelf and in the Color palette: click it and SculptForge unwraps the model if it has no UVs (Auto UV, in the background) and gives it a texture, so the next stroke paints texels. Big brushes on 4K textures paint four to five times faster. See Texture painting."},{"p":"whats-new.html","c":"What's new","a":"bring-your-ztools-over","h":"Bring your ZTools over","t":"ZBrush's .ZTL files are proprietary, but a free plug-in for ZBrush now converts them once, and then SculptForge opens the .ZTL itself, every SubTool with its polygroups, polypaint, mask and UVs. See Coming from ZBrush."},{"p":"whats-new.html","c":"What's new","a":"version-08","h":"Version 0.8","t":"Dynamic topology, vector displacement brushes, QRemesh Guides, and sculpt layers on every subdivision level."},{"p":"whats-new.html","c":"What's new","a":"dynamic-topology-sculptris-pro","h":"Dynamic topology (Sculptris Pro)","t":"Turn on Dynamic on the top shelf and the brush adds triangles where it needs detail and removes them where it doesn't: pull a sphere into horns or fingers without stretching, block in from a ball without remeshing. Detail sets how small the triangles get, relative to the brush (zoom in for finer ones) or, with Constant detail, one size for the whole mesh. Symmetry makes mirrored triangles, borders and masks are kept, and each stroke is one small undo step. See Dynamic topology."},{"p":"whats-new.html","c":"What's new","a":"vector-displacement-brushes","h":"Vector displacement brushes","t":"One drag stamps a whole shape, overhangs and all: the new VDM brush presses a vector displacement map, so a horn can lean over, an ear can curl and scales can overlap, which no alpha can do. Four maps come with it (Horn, Ear Curl, Scales, Nostril); make your own by sculpting on a VDM Plane and clicking Create VDM, or load the EXRs Blender's VDM Brush Baker makes (and export yours for Blender). The new DragDot stroke slides a stamp into place. See Vector displacement brushes."},{"p":"whats-new.html","c":"What's new","a":"zbrush-keys-in-blenders-sculpt-mode","h":"ZBrush keys in Blender's Sculpt Mode","t":"The Blender add-on has a new preference, ZBrush-style keys in Sculpt Mode: S, U and O for Draw Size, Strength and Focal Shift, B for the brushes by their ZBrush names, Space for the quick menu, Alt to dig in, Ctrl to mask, Ctrl+Shift to hide, D and Shift+D for subdivision levels, and more. See Working with Blender."},{"p":"whats-new.html","c":"What's new","a":"draw-the-edge-loops-you-want","h":"Draw the edge loops you want","t":"QRemesh Guides are ZBrush's ZRemesher Guides brush: draw curves on the sculpt, around the eyes, the mouth or a joint, and QRemesh puts an edge loop on each one and turns the flow around it to follow. A curve that ends where it started becomes a loop that closes cleanly, symmetry mirrors what you draw, and Curves Strength sets how far around a curve the flow follows it. Guides are kept with each SubTool and saved in the project. See QRemesh Guides."},{"p":"whats-new.html","c":"What's new","a":"sculpt-layers-on-every-subdivision-level","h":"Sculpt layers on every subdivision level","t":"Sculpt layers now have a guide section on how they work with subdivision levels, like ZBrush's 3D Layers: record a layer at the top, step down and up, divide, reconstruct or delete levels, save, and it's still there, with one weight for every level. See Layers and subdivision levels."},{"p":"whats-new.html","c":"What's new","a":"version-07","h":"Version 0.7","t":"ZBrush's keys and gestures by default, and a bridge that sends models between Blender and SculptForge."},{"p":"whats-new.html","c":"What's new","a":"your-zbrush-hands-just-work","h":"Your ZBrush hands just work","t":"SculptForge now follows ZBrush's keys and gestures by default. A ZBrush sculptor tried an earlier version and put it down because it didn't feel like ZBrush; this release goes through every habit of the first hour. Coming from ZBrush lists what's the same, what's different and every shortcut side by side. S, U, I, O open Draw Size, Z Intensity, RGB Intensity and Focal Shift under the cursor, and Space opens the QuickMenu with all of them plus the brush, stroke, alpha and material. Focal Shift shapes the brush falloff, shown as the cursor's inner ring. RGB Intensity gives painting a strength of its own, and Smooth keeps its own Z Intensity, so a gentle brush still smooths properly. ZBrush's brush letters: B C B ClayBuildup, B D S DamStandard, B M V Move, B I N Inflate... Masking: Ctrl+click the model blurs the mask, Ctrl+Alt+click sharpens it; Ctrl+A, Ctrl+Shift+A, Ctrl+I, Ctrl+H and Ctrl+W (group masked) work as in ZBrush. Strokes and the view: Shift pressed mid-stroke draws a straight line; Shift+click, let go and drag rolls the view; Shift+Alt+click frames a SubTool; L toggles LazyMouse and V swaps colours. Visibility: Ctrl+Shift+click on a partly hidden mesh hides the group, as in ZBrush. Prefer the old keys? Preferences > Input > Style > SculptForge brings back the number keys for brushes, I for Z Intensity and the Ctrl+drag zoom. See Sculpting and brushes, Masking and Keyboard and mouse."},{"p":"whats-new.html","c":"What's new","a":"works-with-blender","h":"Works with Blender","t":"Keep Blender for your scene and sculpt in SculptForge: the new SculptForge Bridge add-on for Blender 4.2 and newer sends the selected objects to SculptForge with one click (starting it if needed), and File > Blender > Send to Blender sends them back. The objects update in place, keeping their transform, materials and modifiers; quads, UVs, colours, the mask and face sets (polygroups) come across both ways. See Working with Blender."},{"p":"whats-new.html","c":"What's new","a":"version-06","h":"Version 0.6","t":"Performance: half the memory, a view that turns twice as fast, quicker brushes on huge meshes, and SculptForge now tells you when there's a new version."},{"p":"whats-new.html","c":"What's new","a":"lighter-sculpts","h":"Lighter sculpts","t":"A sculpt with subdivision levels takes about half the memory it did: a 33 million triangle model with its levels needs about 3.4 GB instead of 5.6, so a laptop with 32 GB holds models of 100 million triangles and more. Divide goes past 100 million triangles. The limit now follows your computer's memory instead of stopping at 50 million. Opening a project is twice as fast and no longer needs twice the model's memory while it loads. Project files of divided models are about 30% smaller. Projects from 0.5 open as before; save a copy if you still need to open it in 0.5. Sculpting gives exactly the same results as before: only the way the levels and the mesh's neighbour lists are stored changed. See Performance and big meshes."},{"p":"whats-new.html","c":"What's new","a":"big-brushes-on-huge-meshes","h":"Big brushes on huge meshes","t":"Brushes are quicker on tens of millions of polygons. On a 33 million triangle model a medium brush takes about 7.5 ms per dab (12 in 0.5), a brush covering a tenth of the model (a million vertices per dab with symmetry) about 45 ms (60 to 80 in 0.5), and masking and painting about twice as fast. Undoing a big stroke is about twice as fast too, and sculpting needs about 300 MB less memory at that size. See Performance and big meshes."},{"p":"whats-new.html","c":"What's new","a":"a-faster-lighter-viewport","h":"A faster, lighter viewport","t":"Turning the view around a huge sculpt is now about twice as fast (a 33 million triangle model: 109 frames a second with 4x antialiasing, 270 with Fast Navigation, from 49 and 68), and the graphics card needs about a third of the memory it did. Only what you can see is drawn. The mesh is drawn in patches of a few thousand triangles; patches outside the view, and on closed meshes the ones facing away from you, are skipped. Fast Navigation draws a lighter version of big meshes while the view moves, about a fifth of the triangles, and the full mesh again as soon as it stops. A 100 million triangle sphere turns at about 100 frames a second on an M1 Pro laptop. A third of the graphics memory: about 15 bytes per triangle (it was over 40 on meshes with quads), so bigger sculpts fit on the graphics card. The wireframe's edges are only kept while the wireframe is on. Opening a big model or dividing it sends it to the graphics card about 40% faster. See Performance and big meshes."},{"p":"whats-new.html","c":"What's new","a":"stl-files-print-at-the-right-size","h":"STL files print at the right size","t":"STL export is now in millimetres with Z up, as slicers expect: models used to arrive 1000 times too small and lying on their back. Set a print height in millimetres when you export, and STL files you open come in upright at their real size. See Exporting."},{"p":"whats-new.html","c":"What's new","a":"update-notifications","h":"Update notifications","t":"Once a day SculptForge looks on its website for a newer version, and if there is one, a small banner says what's in it, with What's new, Download, Later and Skip this version. It downloads one small file and sends nothing about you or your computer. Turn it off under Preferences > Updates, or check by hand with Help > Check for updates. Builds from a package manager (such as the AUR package) leave the checking to the package manager."},{"p":"whats-new.html","c":"What's new","a":"version-05","h":"Version 0.5","t":"The ZBrush workflow core: subdivision levels, quad retopology, map baking, the Gizmo 3D, and speed at tens of millions of polygons."},{"p":"whats-new.html","c":"What's new","a":"subdivision-levels","h":"Subdivision levels","t":"Sculpt one model at several resolutions, as with ZBrush's SDiv: big forms low, fine detail high, and back down without losing anything. Divide (Ctrl+D) adds a level and keeps the ones below. Quads stay quads (Catmull-Clark); Smt off divides without smoothing. Lower Res / Higher Res (Shift+D / D) and the SDiv slider step between levels. Detail sculpted high rides along when you reshape low, and edits high show up softened below. Stepping back and forth is instant, even at millions of polygons. Mask, polypaint, paint layers, polygroups, hidden faces, UVs and sculpt layers follow the levels. Del Lower, Del Higher and Reconstruct Subdiv (find the lower levels of a model subdivided elsewhere). Undo walks back through strokes and level changes; projects save every level; the SubTool list shows \"SDiv 3/5\". Ctrl+D now divides with levels; the old one-way Subdivide is still in Tool > Geometry. See Subdivision levels."},{"p":"whats-new.html","c":"What's new","a":"gizmo-3d-move-scale-rotate-and-pose","h":"Gizmo 3D: move, scale, rotate and pose","t":"ZBrush's Gizmo 3D, with the same keys: W Move, E Scale, R Rotate, Q back to Draw (also on the top shelf and in the Transform palette). Handles over the model. Arrows, plane squares and a free-move centre; axis rings and a view ring; axis boxes and a uniform centre. Shift snaps to 15 degrees, the grid or 10% steps. Only the unmasked part moves, so posing is: mask the body, Alt+click the shoulder to put the pivot there, raise Falloff for a soft joint, turn the arm. With X symmetry both arms move together. Pivot tools: Alt+drag the gizmo to move it alone, Reset, To Surface, World or Surface axes. Numeric entry in the Gizmo 3D panel, All SubTools (Transpose All), one undo step per drag, sculpt layers move with the surface, and the transform command for scripts. Fast on big models: a drag frame on 1.3 million triangles takes about 10 ms. W no longer toggles the wireframe: use Shift+F (as in ZBrush) or PolyF on the right shelf. See Moving, rotating and posing."},{"p":"whats-new.html","c":"What's new","a":"normal-displacement-and-ao-map-baking","h":"Normal, displacement and AO map baking","t":"Bake the detail of a high-poly sculpt into maps on a low-poly's UVs, for game engines and renderers: Tool > Bake. Six maps in one go: tangent-space normal, object-space normal, displacement (16-bit PNG with mid-grey = 0, plus a 32-bit EXR in world units), ambient occlusion, cavity and colour (polypaint or texture). Right in every engine. Tangent-space maps use MikkTSpace tangents, as Blender, Unreal, Unity and Godot do; pick the OpenGL or DirectX green convention. Check it on the model. The low-poly shows its baked normal map in the viewport as soon as the bake ends, next to the high-poly. ZBrush-style controls: source SubTool, 1K-8K, anti-aliasing, automatic or manual front and rear ray distances, padding around UV islands. Bakes run in the background on every core, with progress and Cancel. Send to Unreal brings the normal map along, set up as a normal map. The bake command does it all from scripts. See Baking normal and displacement maps."},{"p":"whats-new.html","c":"What's new","a":"quad-retopology-and-detail-projection","h":"Quad retopology and detail projection","t":"QRemesh (Tool > Geometry, like ZRemesher) rebuilds a sculpt as clean quads whose edge loops follow the forms, near a Target Polygons count, in the background. Keep Groups, Adaptive Size, Use Polypaint, Symmetry and Half / Same / Double work as in ZBrush. ProjectAll (Tool > SubTool > Project) puts the sculpted detail and polypaint back onto the divided quads, with Dist, Mean and PA Blur, and respects the mask. See Quad retopology and detail projection."},{"p":"whats-new.html","c":"What's new","a":"performance-at-tens-of-millions-of-polygons","h":"Performance at tens of millions of polygons","t":"Sculpting a 33 million triangle model on a laptop now keeps up with the display: a medium brush costs about 10 ms per dab instead of 400, and turning the view runs at 50-70 frames a second instead of 32. Brushes use every core: every brush, mask and paint stroke, the normal updates and the picking structure. Results are exactly the same as on one core. Strokes send the graphics card only what they changed. Before, a dab with symmetry on a subdivided model re-sent most of the mesh. Fast undo: undo keeps only the vertices a stroke changed, and the first polypaint stroke on a model no longer copies the whole mesh for undo. Less memory: about 30% less per triangle for a sculpting mesh. Faster projects: saving and opening big projects is faster, and projects over 4 GB save (ZIP64). Preferences > Performance: Antialiasing (Off to 8x), Fast Navigation (big scenes drop antialiasing while the view moves), Multithreading, what your last stroke cost per dab, and the memory the scene holds. A SubTool too big for the graphics card is left out of the view with a message, instead of failing. sculptforge --bench measures your machine. See Performance and big meshes."},{"p":"whats-new.html","c":"What's new","a":"polish","h":"Polish","t":"Your paint survives Auto UV and retopology. Auto UV on a painted SubTool moves the texture and its layers onto the new UVs. Voxel Remesh and QRemesh have a Keep Texture option (on by default) that unwraps the new surface and projects the texture onto it, and merging SubTools keeps their textures in one. Each is a single undo step. See Texture painting. Faster, safer Auto UV on dense sculpts: no more crash or folded UVs on dense smooth meshes, and a million-triangle sculpt unwraps in a quarter of a minute or so. Decimate keeps the texture exact across UV seams. Subdivision levels, polished. Tools that rebuild the mesh (remesh, Decimate, QRemesh, Subdivide, Delete Hidden, merge and split) tell you they removed the levels and that the level you were on became the new base; Ctrl+Z brings them all back. Sculpt layers' fine detail turns with a low level you pose with the Gizmo, and SubTools you aren't working on no longer hold cached levels in memory. QRemesh symmetry follows your model. Symmetry (now on by default) mirrors across the model's own middle, so a model away from the centre comes out mirror-symmetric too. If the model isn't symmetric, QRemesh remeshes it whole and tells you. Eyes, teeth and rivets get their own quads instead of disappearing, and thin hard-edged parts such as blades and fins keep both sides and their edges. See Quad retopology. Tidier top shelf: the Vertex / Texture paint target only shows when the SubTool has a texture. Exports checked by other tools: textured GLB, USD/USDZ, FBX and OBJ files were checked with the Khronos validator, OpenUSD and ufbx, and the texture is the right way up in each. A model saved as my scene.obj now writes my_scene.mtl so other apps find it. See Exporting."},{"p":"whats-new.html","c":"What's new","a":"texture-painting-on-uv-maps","h":"Texture painting on UV maps","t":"Paint into a texture instead of the vertices, so the colour detail comes from the texture (1K to 8K), not from the mesh: sharp decals, pores and freckles on a light game mesh. Auto UV. Tool > Texture Map > Auto UV unwraps any sculpt in the background. Models that come in with UVs keep them, and now OBJ, FBX, USD and glTF carry UVs in and out too. New Texture. Pick a size and click New Texture: the Paint brush, Rgb sculpting, fills, cavity paint and colour picking (C) now work on the texture, with the mask, symmetry, pen pressure and alphas. Strokes never paint through to the far side, and seams stay invisible. Vertex or Texture. A toggle on the top shelf chooses where paint goes for each SubTool. The same paint layers. Tool > Paint Layers works on the texture's layers: blend modes, opacity, merge, flatten, all undoable. Convert both ways, Show UVs, Import / Export Texture (PNG). Projects save textures and their layers, and model exports write the texture next to the model (OBJ .mtl, glTF, USD, FBX, GoZ). See Texture painting."},{"p":"whats-new.html","c":"What's new","a":"version-041","h":"Version 0.4.1","t":"A fix for graphics tablets: the brush ring no longer flickers between two places on the model (it looked like a second brush blinking, most often while masking or smoothing). Some tablet drivers, Windows Ink among them, send extra mouse movements beside the pen's; now, while the pen is in range, only the pen moves the brush. See Pen tablets if your pen still misbehaves."},{"p":"whats-new.html","c":"What's new","a":"version-04","h":"Version 0.4","t":"Version 0.4 is about making SculptForge feel like home to ZBrush artists. It was shaped by feedback from a working ZBrush modeler and by what sculptors say on the ZBrush and Mudbox forums."},{"p":"whats-new.html","c":"What's new","a":"navigation-that-works-like-zbrush","h":"Navigation that works like ZBrush","t":"Free rotation. Dragging turns the model the way the cursor moves and can roll it right over the top, as in ZBrush. If you prefer the model to stay upright, set Preferences > Interface > Rotation to Turntable. Snap to a view. Hold Shift while rotating to snap to the nearest front, back, side, top or bottom view. ZBrush zoom. Alt+drag on the background pans; let go of Alt while still dragging and the rest of the drag zooms. With the right mouse button, Alt pans and Ctrl zooms. See Navigating the view."},{"p":"whats-new.html","c":"What's new","a":"mask-and-isolate-with-a-lasso-or-rectangle","h":"Mask and isolate with a lasso or rectangle","t":"MaskLasso and MaskRect. Pick the shape at the top of Tool > Masking, then Ctrl+drag to mask everything inside it; add Alt to unmask. The drag can start on the model or beside it. SelectLasso. In Tool > Visibility, pick SelectLasso next to SelectRect, then Ctrl+Shift+drag a free-hand shape to keep only what's inside (add Alt to hide it instead). See Mask with a lasso or rectangle and Polygroups and visibility."},{"p":"whats-new.html","c":"What's new","a":"a-material-made-for-sculpting","h":"A material made for sculpting","t":"The new Sculpt material is the default: plain clay under a strong key light, with crisp highlights and deep shading in the creases, so even small strokes stay easy to read. The other materials are still in the material picker (M), and projects keep the material they were saved with. See Polypaint and materials."},{"p":"whats-new.html","c":"What's new","a":"quads-stay-quads","h":"Quads stay quads","t":"Models you bring in from ZBrush (GoZ) or as OBJ, FBX, PLY or USD keep their quads: PolyF shows them as quads, and exporting writes them back as quads. Subdivide turns each quad into four, voxel remesh now gives an even grid of quads (like DynaMesh), and new cubes and planes are made of quads. See Quads and triangles."},{"p":"whats-new.html","c":"What's new","a":"paint-layers","h":"Paint layers","t":"Polypaint now has layers, like Photoshop: each SubTool can have a stack of colour layers with their own opacity, visibility, lock and blend mode (Multiply, Screen, Overlay, Soft Light, Add and more). Painting on a layer never destroys what's underneath, and you can merge, flatten, duplicate and reorder layers. ZBrush has never had this. Find it in Tool > Paint Layers, and see Paint layers. The Paint Layers sub-palette with three layers and their blend modes"},{"p":"whats-new.html","c":"What's new","a":"easier-to-install","h":"Easier to install","t":"The download links now always get the newest version, and there are one-command installers for Windows, macOS and Linux."},{"p":"whats-new.html","c":"What's new","a":"version-03","h":"Version 0.3","t":"SubTools: several separate meshes in one scene. Append, duplicate, split, merge, solo, and Alt+click to select. See SubTools. A ZBrush-style interface: shelves around the canvas, alphabetical palettes, the LightBox (,), the brush, stroke, alpha and material pickers, hold-Ctrl help on every control and a command palette (F3). See The interface. Graphics tablets: pen pressure, the eraser end and pen buttons. See Sculpting and brushes. A brush library with brush codes to share and a community gallery. See Brush Lab and sharing brushes. ComfyUI workflows for image and text to 3D. See Image and text to 3D. This user guide, built into the app (Help > User Guide, Shift+F1)."},{"p":"whats-new.html","c":"What's new","a":"version-02","h":"Version 0.2","t":"Masking, polygroups and visibility, and polypaint with MatCaps. New brushes: DamStandard, ClayBuildup, SnakeHook, Trim, Layer and Nudge, with strokes and alphas. Project files with autosave, recent files and QuickSave, and GoZ exchange with ZBrush."},{"p":"whats-new.html","c":"What's new","a":"version-01","h":"Version 0.1","t":"The first release: sculpting with symmetry and sculpt layers, voxel remesh and decimation, game-ready LOD chains and Send to Unreal, image and text to 3D with free AI models, Gaussian splats, OpenUSD, and scripting from the command line, Python and AI agents."},{"p":"coming-from-zbrush.html","c":"Coming from ZBrush","a":"","h":"Coming from ZBrush","t":"This chapter is for sculptors whose hands already know ZBrush. It lists what works the same, what is different, and the shortcuts side by side, so you can start sculpting instead of relearning. SculptForge follows ZBrush's keys and gestures by default; where it has habits of its own, they are kept as a preference."},{"p":"coming-from-zbrush.html","c":"Coming from ZBrush","a":"whats-the-same","h":"What's the same","t":"The layout. Shelves around the canvas, palettes in alphabetical order in the palette bar and the trays, sub-palettes that fold, the LightBox on ,, Ctrl-hover help on every control, Ctrl+Alt+click to assign a hotkey, Store Config on Ctrl+Shift+I. See The interface. Navigation. Drag on the background to rotate freely (over the top, too), Alt+drag to move, Alt+click, let go of Alt and drag to scale, Shift during a rotation to snap to a side view, Shift+click, let go of Shift and drag to roll. Right-drag navigation works as with ZBrush's RightClick Navigation turned on, over the model too. F frames the model. See Navigating the view. Sculpting modifiers. Alt swaps Zadd and Zsub, Shift smooths (Smooth keeps its own Z Intensity), Shift pressed after a stroke starts draws a straight line. Brush keys. B then two letters, with ZBrush's letters: B S T Standard, B C B ClayBuildup, B D S DamStandard, B M V Move, B I N Inflate, B S M Smooth, B S H SnakeHook, B P I Pinch. Brush settings. S Draw Size, U Z Intensity, I RGB Intensity, O Focal Shift, each as a slider under the cursor; [ and ] step the size; Space opens the QuickMenu; L toggles LazyMouse. The cursor's outer ring is the Draw Size, the inner ring the Focal Shift. See Sculpting and brushes. Masking. Ctrl paints a mask and Ctrl+Alt erases it; Ctrl+click the model blurs it and Ctrl+Alt+click sharpens it; Ctrl+click the background inverts it and Ctrl+drag there clears it. MaskLasso and MaskRect: with Ctrl held the shelf shows the mask brush, and the Brush (B) and Stroke pickers pick it. See Masking. Visibility and polygroups. Ctrl+Shift+drag keeps the inside (press Alt to hide it instead), Ctrl+Shift+click a group to isolate it (on a partly hidden mesh: to hide it), Ctrl+Shift+click the background to show everything, Ctrl+W to group the masked part. SelectRect and SelectLasso, also from the Brush and Stroke pickers with Ctrl+Shift held. Group by UVs is UV Groups. See Polygroups and visibility. SubTools with Alt+click to select one and Shift+Alt+click to select and frame it; subdivision levels with Ctrl+D, D and Shift+D; PolyFrame on Shift+F; QuickSave on 9. See SubTools and Subdivision levels. GoZ. Send models to and from ZBrush. See Exporting, Unreal and ZBrush. VDM brushes with DragRect and DragDot, and your own made from a VDM plane. See Vector displacement brushes. Sculpting in Blender too? The Blender add-on can give Blender's Sculpt Mode ZBrush's keys. See Working with Blender."},{"p":"coming-from-zbrush.html","c":"Coming from ZBrush","a":"bring-your-ztools-over","h":"Bring your ZTools over","t":"ZBrush's .ZTL files are proprietary, so SculptForge can't read them directly. The free SculptForge ZTool Export plug-in runs inside ZBrush and converts them once: Download SculptForgeZToolExport.txt (also attached to every release) and copy it into ZBrush's ZStartup/ZPlugs64 folder, then restart ZBrush. Or load it once with ZScript > Load. In ZBrush, ZPlugin > SculptForge > Convert ZTL asks for a .ZTL, loads it and writes each SubTool next to it as a GoZ file (Dragon.ZTL gives Dragon.sf001_Body.GoZ, Dragon.sf002_Horns.GoZ...). Save for SculptForge does the same for the ZTool you have open, saving the .ZTL where you choose. In SculptForge, open the .ZTL (File > Open, or drop it on the window). Its SubTools open in the same order with the same names, polygroups, polypaint, mask and UVs. Each SubTool comes over at its highest subdivision level; the lower levels, sculpt layers and ZBrush materials don't. If you change the ZTool in ZBrush later, convert it again: SculptForge warns when the .ZTL is newer than its conversion. .ZPR projects can't be converted; save their ZTools first. Note: the plug-in is new and hasn't been tested in every ZBrush version yet. If it stops with an error or a SubTool is missing, please report it with your ZBrush version; exporting each SubTool with Tool > Export as .GoZ or .OBJ works in the meantime."},{"p":"coming-from-zbrush.html","c":"Coming from ZBrush","a":"whats-different","h":"What's different","t":"ZBrush SculptForge Why Transpose action line (W E R) The Gizmo 3D on the same keys; mask what should stay, and Alt+click to put the pivot on the model Simpler to learn; ZBrush has a Gizmo 3D too. See Gizmo 3D Edit mode (T) and the 2.5D canvas Always in Edit mode SculptForge is a 3D sculpting app only Perspective toggle (P) Always perspective; P is the Paint brush (colour only, ZBrush's Rgb on, Zadd off) Stroke replay (1, 2, 3) Not yet N lists the SubTools The SubTool sub-palette in the right tray DynaMesh, ZRemesher Voxel Remesh and QRemesh in Tool > Geometry See Geometry and Retopology Sculptris Pro Dynamic on the top shelf, with its Detail slider See Dynamic topology Open edges hold their shape when smoothed Smooth pulls an open border in a little with each pass Mask the border first when it matters Values 0-100 everywhere The same for Z Intensity, RGB Intensity and Focal Shift; Draw Size is the radius in pixels The Glossary maps every ZBrush term to its SculptForge name."},{"p":"coming-from-zbrush.html","c":"Coming from ZBrush","a":"the-sculptforge-input-style","h":"The SculptForge input style","t":"Earlier versions of SculptForge had a few keys of their own, and some people like them. Preferences > Input > Style switches between: ZBrush (default) SculptForge 1 to 9, 0 Free (9 is QuickSave) Pick the ten first brushes (Standard, Clay, Smooth, Move ...) I RGB Intensity at the cursor Z Intensity at the cursor (as U) Ctrl+drag on the background with nothing masked Nothing Zooms Zoom drags (Ctrl+right-drag, Alt then release) Up zooms out Up zooms in Preferences > Input > Rotation chooses free rotation (ZBrush) or a turntable that keeps the model upright, as in Blender or Maya. Press Store Config (Ctrl+Shift+I) to keep either."},{"p":"coming-from-zbrush.html","c":"Coming from ZBrush","a":"shortcuts-side-by-side","h":"Shortcuts side by side","t":"Action ZBrush SculptForge Rotate / move / scale the view Drag / Alt+drag / Alt, release, drag on the background Same Snap to a side view / roll Shift while rotating / Shift+click, release, drag Same Frame F F Brush pop-up B B Draw Size / Z Intensity / RGB Intensity / Focal Shift S / U / I / O Same QuickMenu Space Space (right-click navigates) LazyMouse L L Pick colour / switch colour C / V Same Symmetry X X Undo / redo Ctrl+Z / Ctrl+Shift+Z Same (also Ctrl+Y) Divide / higher / lower res Ctrl+D / D / Shift+D Same Mask all / clear / invert / view Ctrl+A / Ctrl+Shift+A / Ctrl+I / Ctrl+H Same Group masked Ctrl+W Ctrl+W PolyFrame Shift+F Shift+F Draw / Move / Scale / Rotate Q / W / E / R Same keys, Gizmo 3D LightBox , , Hide the palettes Tab Tab QuickSave 9 9 Store Config / Load UI / Save UI Ctrl+Shift+I / Ctrl+L / Ctrl+Shift+Alt+I Same Perspective P Always on (P is Paint) Search every command F3 Every shortcut is in Keyboard and mouse, generated from the app itself, and can be changed with Ctrl+Alt+click or Preferences > Hotkeys."},{"p":"coming-from-zbrush.html","c":"Coming from ZBrush","a":"see-also","h":"See also","t":"Keyboard and mouse Glossary: ZBrush terms and their SculptForge names Exporting, Unreal and ZBrush: GoZ"},{"p":"installing.html","c":"Installing SculptForge","a":"","h":"Installing SculptForge","t":"This chapter covers what SculptForge needs, which package to download for your system, what to expect the first time you open it, and how to build it from source."},{"p":"installing.html","c":"Installing SculptForge","a":"system-requirements","h":"System requirements","t":"Operating system: Windows 10 or 11 (x64), macOS 11 or later (Apple Silicon or Intel), or a 64-bit Linux distribution (x86_64 or ARM64) with X11 or Wayland. Graphics: a GPU and driver that support OpenGL 3.3 (core profile). Any graphics card from the last ten years qualifies, including integrated Intel, AMD and Apple GPUs. SculptForge asks for 4x multisampling and falls back to none if the driver refuses it. Input: a three-button mouse works for everything. A pen tablet adds pressure (see Sculpting and brushes). Network: not needed for sculpting. The free AI features (Brush Lab and image or text to 3D) and the community brush gallery need an internet connection unless you run models on your own machine. Note: SculptForge is a 64-bit desktop application. There is no web, iPad or Android version."},{"p":"installing.html","c":"Installing SculptForge","a":"download","h":"Download","t":"Each link below downloads the newest version. Pick the one for your system: System Download How to install Windows 10/11 (x64) Installer (.exe) Run the installer (adds a Start menu shortcut) Windows, portable Portable .zip Unzip anywhere and run bin\\sculptforge.exe macOS 11+ (Apple Silicon and Intel) SculptForge.dmg Open the disk image and drag SculptForge to Applications Ubuntu, Debian, Mint, Pop!_OS .deb for x86_64 or ARM64 sudo apt install ./sculptforge_amd64.deb Fedora, RHEL, Rocky, Alma 8+ .rpm for x86_64 or ARM64 sudo dnf install ./sculptforge.x86_64.rpm Any Linux AppImage for x86_64 or ARM64 chmod +x the file, then run it Arch Linux packaging/arch/PKGBUILD in the source makepkg -si in that folder (an AUR package is planned) Studio pipelines SculptForge--...-vfx2026.tar.gz or ...-vfx2027.tar.gz See SculptForge for studios Most PCs are x86_64; ARM64 is for ARM laptops, Raspberry Pi and Apple Silicon Macs running Linux. Older versions are on the releases page."},{"p":"installing.html","c":"Installing SculptForge","a":"install-with-one-command","h":"Install with one command","t":"Instead of downloading by hand you can install (or update) with one command. On macOS and Linux it installs for your user only, with no administrator password: curl -fsSL https://raw.githubusercontent.com/islandmed/SculptForge/main/install/install.sh | sh On Windows, in PowerShell (it downloads and starts the installer): irm https://raw.githubusercontent.com/islandmed/SculptForge/main/install/install.ps1 | iex Both check the download against the release's checksums before installing. To uninstall on macOS or Linux, run the first command with sh -s -- --uninstall at the end instead of sh. Every release also has a SHA256SUMS.txt file with the checksum of each download, so you can confirm a file arrived intact. Each package contains two programs: SculptForge, the desktop application, and sculptforge-cli, the headless command-line tool for scripts, build farms and AI agents (see Scripting and automation). On macOS the command-line tool sits inside the app bundle, at SculptForge.app/Contents/MacOS/sculptforge-cli."},{"p":"installing.html","c":"Installing SculptForge","a":"opening-sculptforge-for-the-first-time","h":"Opening SculptForge for the first time","t":"The builds are not code-signed yet, so your operating system may warn you the first time."},{"p":"installing.html","c":"Installing SculptForge","a":"macos-gatekeeper","h":"macOS: Gatekeeper","t":"macOS may say that SculptForge \"cannot be opened because the developer cannot be verified\". In Finder, open the Applications folder. Right-click (or Ctrl+click) SculptForge and choose Open. Click Open in the dialog that appears. You only need to do this once. On recent macOS versions you may instead have to go to System Settings > Privacy & Security and click Open Anyway next to the message about SculptForge."},{"p":"installing.html","c":"Installing SculptForge","a":"windows-smartscreen","h":"Windows: SmartScreen","t":"Windows may show \"Windows protected your PC\". Click More info. Click Run anyway."},{"p":"installing.html","c":"Installing SculptForge","a":"linux","h":"Linux","t":"The .deb and .rpm packages add SculptForge to your desktop's application menu. An AppImage needs to be made executable first (chmod +x SculptForge-*.AppImage, or tick \"Allow executing file as program\" in your file manager's properties)."},{"p":"installing.html","c":"Installing SculptForge","a":"what-you-see-at-start-up","h":"What you see at start-up","t":"SculptForge opens a 1600 x 960 window with a sphere ready to sculpt and the LightBox open along the top of the canvas on its Project tab, so you can reopen recent work with a double-click. Press , (comma) to close it, or turn off Preferences > LightBox > Show at startup. The first start also creates your library folder (Documents/SculptForge, with Projects, Tools, Brushes, Alphas, Images, Splats and QuickSave sub-folders), which the LightBox shows as User. You can open a file directly from the command line, too: sculptforge model.obj (or a .glb, .sfproj, splat capture or image). sculptforge --fullscreen starts filling the screen; sculptforge --help lists every option. The next chapter, The interface, explains what everything on screen does."},{"p":"installing.html","c":"Installing SculptForge","a":"updating-and-uninstalling","h":"Updating and uninstalling","t":"SculptForge doesn't install updates by itself, but it tells you when there is one. Once a day at start-up it downloads a small file from its website that names the newest version; if yours is older, a banner at the top of the 3D view says what's new, with What's new, Download, Later and Skip this version. Nothing about you or your computer is sent. Help > Check for updates asks right away, and Preferences > Updates turns the daily check off. Builds from a package manager (such as the AUR package) leave updates to the package manager and don't check. To update, download the new release and install it over the old one. Your settings, brushes and library are kept: they live in your user folders, not next to the program (see Troubleshooting and FAQ for where). To uninstall, use your system's usual method (Settings > Apps on Windows, dragging the app to the Bin on macOS, sudo apt remove sculptforge or sudo dnf remove sculptforge on Linux, or delete the AppImage). Delete the settings and library folders as well if you want to remove everything."},{"p":"installing.html","c":"Installing SculptForge","a":"building-from-source","h":"Building from source","t":"You need CMake 3.24 or later and a C++20 compiler: GCC 11+, Clang 14+, Xcode 15+ or Visual Studio 2022. Dear ImGui, GLM and (if it isn't installed already) SDL3 are downloaded automatically. AI features use libcurl on Linux and macOS and the built-in WinHTTP on Windows. git clone https://github.com/islandmed/SculptForge.git cd SculptForge # Linux only: compilers and X11/Wayland/GL/curl headers (Debian/Ubuntu or Fedora/RHEL) sudo ./packaging/linux/install-build-deps.sh cmake -S . -B build -DCMAKE_BUILD_TYPE=Release cmake --build build --parallel ctest --test-dir build --output-on-failure ./build/sculptforge On Windows the program is build\\Release\\sculptforge.exe; on macOS run open build/SculptForge.app. Useful CMake options: Option Default What it does SCULPTFORGE_BUILD_APP ON Build the desktop application (turn off for a headless build of sculptforge-cli only) SCULPTFORGE_BUILD_PYTHON OFF Build the Python module (import sculptforge); needs Python development headers SCULPTFORGE_BUILD_TESTS ON Build the unit and UI tests SCULPTFORGE_USE_SYSTEM_SDL ON Use an installed SDL3 if one is found Running cpack in the build folder makes the platform's packages (.deb, .rpm and .tar.gz on Linux, a .dmg on macOS, an installer and a .zip on Windows)."},{"p":"installing.html","c":"Installing SculptForge","a":"see-also","h":"See also","t":"The interface Troubleshooting and FAQ SculptForge for studios"},{"p":"interface.html","c":"The interface","a":"","h":"The interface","t":"SculptForge's window is laid out like ZBrush's: a canvas in the middle, shelves of the most-used controls around it, a bar of alphabetical palettes that hold every function, and trays at the sides where palettes can stay open. This chapter walks through each region, the pop-up pickers, the LightBox, the built-in help, and how to rearrange the interface and keep your changes. The SculptForge window with its main regions labelled"},{"p":"interface.html","c":"The interface","a":"the-regions-at-a-glance","h":"The regions at a glance","t":"Region Where What it holds Title strip Top edge Document name, scene statistics, status messages, QuickSave, layout presets, Menus, Search Palette bar Under the title strip The 16 palettes, which hold every function Top shelf Above the canvas LightBox, Sculpt/Paint, Zadd/Zsub, Rgb, Draw Size, Z Intensity, symmetry, pressure Left shelf Left of the canvas Brush, Stroke, Alpha and Material tiles, the colour picker Canvas Centre The 3D view; strokes and navigation start only here Right shelf Right of the canvas Frame, Move, Zoom and Rotate, display toggles, Solo Bottom shelf Below the canvas Your quick brushes Trays Far left and far right Palettes you keep open; the right tray holds the Tool palette by default Press Tab to hide the shelves and trays for a bigger canvas, and again to bring them back. The palette bar stays, so every function is still one click away."},{"p":"interface.html","c":"The interface","a":"the-title-strip","h":"The title strip","t":"From left to right: SculptForge and the document name (\"Untitled\" until you save). A * after the name means there are unsaved changes; click the name to save (Ctrl+S). Scene statistics: vertices and triangles across all SubTools, the active SubTool and its position (\"SubTool Body (2/5)\"), the active sculpt layer (\"Layer Base\" when you sculpt the base mesh), the number of Gaussian splats when a capture is loaded, and the frame rate. The status message: the result of the last command or action. Errors show in red for a few seconds. Point at a long message to read all of it. QuickSave: saves a timestamped copy of the whole scene to your library without touching your project file (see Projects, autosave and QuickSave). 1, 2, 3: the layout presets (see Layout presets). Menus: shows or hides the palette bar. Search (F3): opens the command palette. Minimize and Close at the far right. Close asks to save changes first, as Ctrl+Q does."},{"p":"interface.html","c":"The interface","a":"palettes","h":"Palettes","t":"Every function in SculptForge lives in one of 16 palettes. Click a palette's name in the palette bar and it drops down under the name. Click another name to switch, or press Esc or click outside to close it. The Stroke palette open as a drop-down from the palette bar The palette bar lists File and Edit first and Help last, where other desktop applications put them, and the rest in alphabetical order. If you prefer ZBrush's strict A to Z order, turn on Preferences > Interface > Palettes strictly A-Z (ZBrush order). Palette What's in it File New Sphere, New Plane, Open, Open Recent, Save, Save As, autosave interval, Import and every export (OBJ, GLB, LOD chain, USD/USDZ, FBX for Unreal, Send to Unreal, splats), ZBrush (GoZ), Quit Edit Undo and Redo (with the name of the step), Paste brush Alpha The brush alphas: Round, Square, Noise, images from your library, Load image, Invert loaded image Brush AI Brush (Brush Lab), Community brushes, Paste brush, your custom brushes, Front faces only, Invert (Alt), the recipe editor for a custom brush, and every brush as a thumbnail grid with a filter Color The Paint brush, RGB while sculpting, the paint colour and swatches, Fill, Fill masked, Cavity, Clear, Show polypaint Draw Draw Size, Z Intensity, RGB Intensity, Focal Shift, Sculpt/Paint, Zadd/Zsub, Rgb, Front, and the tablet options (Pressure > strength, Pressure > size) with a pen readout Generate Generate 3D (image or text to 3D), Relief, Inflate and Stamp from an image, and the AI brush provider settings Material The seven MatCap materials (Sculpt, the default, first) and Studio, Base colour Preferences Config, Interface, Input, Hotkeys, LightBox, Tablet, Performance, Updates and Autosave sub-palettes (see Customizing the interface) Render Wireframe, Show Mesh, Show Polypaint, Show Mask, Show Polygroups, Show Splats, Frame, Fullscreen Script Console, Run script file, Copy session as script, Clear console Splats Gaussian splat tools: show, flip, turn, fit, clean floaters, Make sculptable, sculpt to splats, save, clear Stroke The stroke types (Dots, DragRect, Spray, LazyMouse) and their settings Tool The active SubTool with Open, Save and Import, and the SubTool, Layers, Paint Layers, Geometry, Remesh, Masking, Polygroups, Visibility, Export and Display sub-palettes Transform Draw, Move, Scale and Rotate (the Gizmo 3D with its pivot, axes, options and numeric entry), Symmetry X, Y and Z, Frame, Solo, PolyF Help Controls, User Guide, What's New, Command palette, Website & documentation, Report a problem, About SculptForge"},{"p":"interface.html","c":"The interface","a":"sub-palettes","h":"Sub-palettes","t":"Large palettes are divided into sub-palettes: headers you click to open or close. The Tool palette is the main example (SubTool, Layers, Geometry and so on). By default opening one sub-palette closes the others in the same palette, which keeps the palette short. Shift+click a header to open it without closing the others, or turn off Preferences > Interface > One sub-palette open. ZBrush: as in ZBrush, SubTool, Layers, Masking, Polygroups and Visibility are sub-palettes of the Tool palette rather than palettes of their own. SculptForge's Remesh sub-palette is where DynaMesh would be."},{"p":"interface.html","c":"The interface","a":"trays","h":"Trays","t":"The trays are columns at the far left and far right of the window where palettes stay open while you work. The right tray is open by default and holds the Tool palette; the left tray starts closed and empty. Put a palette in a tray: open it from the palette bar and click the tray icon at the left of its header. It goes into the right tray; Shift+click the icon to put it in the left tray. You can also drag the icon onto a tray. Take it out again: click the tray icon in its header inside the tray. The palette returns to the bar. Collapse it in place: click its title (or the arrow at the right of the header). Find it: a palette that is in a tray shows its name in orange in the palette bar. Clicking the name scrolls the tray to the palette and flashes its header. Open or close a tray: click its divider, the thin strip with a grip between the tray and the shelves. Drag the divider to make the tray wider or narrower (240 to 480 pixels). The Stroke palette kept in the right tray above the Tool palette When a tray holds several palettes, Preferences > Interface > Auto collapse left tray (on by default) and Auto collapse right tray (off by default) collapse the other palettes when the one you open would not fit. When you open a Gaussian splat capture, the Splats palette moves into the right tray by itself. Note: on a window narrower than 1280 pixels (at 100% UI scale) the right tray folds away and palettes open as drop-downs only. The left-shelf tiles get smaller and the bottom shelf scrolls sideways with the mouse wheel."},{"p":"interface.html","c":"The interface","a":"the-shelves","h":"The shelves","t":"Shelves surround the canvas and hold the controls you use all the time. Point at anything with Ctrl held to see what it does. Right-click an item for Remove from shelf; see Customizing the interface to add items."},{"p":"interface.html","c":"The interface","a":"top-shelf","h":"Top shelf","t":"First row: LightBox (,): shows or hides the LightBox. Sculpt / Paint (P): brushes change the shape, or paint colour without sculpting. Zadd / Zsub: brushes add to or subtract from the surface. Holding Alt flips it for one stroke. Rgb: sculpt brushes paint the colour at the same time. Draw Size: the brush radius in screen pixels (2 to 800). Z Intensity: how strongly each dab changes the surface (1 to 100). While Shift is held it shows Smooth's own value. Second row: AI Brush: opens Brush Lab (see Brush Lab and sharing brushes). Front: front faces only, so brushes leave the far side of thin parts alone. X, Y, Z: symmetry across each axis (X toggles X). Pressure > Strength and Pressure > Size: what pen pressure controls. ActiveTris / TotalTris at the right: the triangles you can see and sculpt (visible SubTools, hidden parts left out) and the total in the scene. Draw Size and Z Intensity are sliders with the label inside, as in ZBrush: drag along them, or Ctrl+click to type a value."},{"p":"interface.html","c":"The interface","a":"left-shelf","h":"Left shelf","t":"Four large tiles, each showing the current choice. Click one to open its pop-up picker: Brush: the active brush, with a rendered preview. Stroke: Dots, DragRect, Spray or LazyMouse. Alpha: the brush's stamp shape. Material: how the model is shaded in the view. Under them is the colour picker for polypaint (a saturation/value square and a hue strip), two swatches (the main and second colour; click either to swap them, like ZBrush's Alternate) and Fill, which fills the unmasked area with the main colour."},{"p":"interface.html","c":"The interface","a":"right-shelf","h":"Right shelf","t":"Frame (F): fits the model in the view. Move, Zoom, Rotate: drag on these buttons to pan, zoom and orbit the view, as in ZBrush. PolyF (Shift+F): shows the mesh's polygons: quads as quads, triangles as triangles. Groups: colours each polygroup. Mask: darkens masked areas (on by default). Paint: shows polypaint colours (on by default). Solo: shows only the active SubTool (available with two or more SubTools). Splats: shows or hides a Gaussian splat capture (only shown while one is loaded). Toggles that are on have an orange background. See Navigating the view for the camera."},{"p":"interface.html","c":"The interface","a":"bottom-shelf","h":"Bottom shelf","t":"A row of quick brushes: Standard, Clay, ClayBuildup, DamStandard, Move, Smooth, Inflate, Pinch, Flatten, Crease, Trim, SnakeHook, Layer, Nudge and Paint. The small digit in a tile's corner is its shortcut (1 to 9 and 0 select the first ten built-in brushes, P is Paint). The active brush has an orange outline. The bottom shelf of quick brushes Add a brush: click + at the end of the shelf and pick any brush, built-in or one of your own. Or right-click a brush in the brush picker and choose Add to bottom shelf. Custom brushes show a small sparkle in the corner. Remove a brush: right-click its tile and choose Remove from shelf."},{"p":"interface.html","c":"The interface","a":"pop-up-pickers","h":"Pop-up pickers","t":"Pickers are pop-up grids of thumbnails. They open beside the left-shelf tile you click, or under the mouse when you use a key. They close when you pick something, press Esc or click elsewhere. Pointing at a tile for a moment shows Quick Info: a large preview and a description."},{"p":"interface.html","c":"The interface","a":"brush-picker","h":"Brush picker","t":"Press B (or click the Brush tile). The picker shows a Recent row, then Built-in, Custom (your brushes and Brush Lab creations) and Library (.sfbrush files in your library that aren't loaded yet; picking one loads it). The brush picker after pressing B and typing S Choose a brush with the keyboard the ZBrush way: Press B. Type the first letter of the brush. Only the brushes starting with that letter stay, and each shows an orange letter: the next key that tells it apart. Press that orange letter to pick the brush. For example B S T picks Standard. Backspace takes back a letter and Enter picks the first match. If no name starts with what you typed, the picker falls back to names that contain it. The letter chips along the top (with a count for each letter) filter by a click as well. Right-click a brush for Add to bottom shelf and, for custom brushes, Copy brush code, Rename..., Save as .sfbrush..., Delete... and Reveal in folder (see Brush Lab and sharing brushes)."},{"p":"interface.html","c":"The interface","a":"stroke-alpha-and-material-pickers","h":"Stroke, Alpha and Material pickers","t":"Stroke (click the Stroke tile): Dots, DragRect, Spray and LazyMouse, with Scatter for Spray and Lazy radius for LazyMouse. See Sculpting and brushes. Alpha (click the Alpha tile): Round, Square and Noise, the image alpha you loaded, images in your library's Alphas folder, Load image... and Invert loaded image. Material (M, or click the Material tile): the MatCaps and Studio. Point at a material to preview it on the model; click to keep it. Closing the picker without clicking puts the old material back. See Polypaint and materials."},{"p":"interface.html","c":"The interface","a":"sliders-at-the-cursor-and-the-quickmenu","h":"Sliders at the cursor and the QuickMenu","t":"As in ZBrush, press S for a Draw Size slider under the mouse, U for Z Intensity, I for RGB Intensity or O for Focal Shift. Drag the slider, or type a number and press Enter (Esc cancels). The pop-up closes when you release the slider. [ and ] make the brush 10% smaller or larger at any time. Space opens the QuickMenu with all of them and the brush, stroke, alpha and material (see The QuickMenu)."},{"p":"interface.html","c":"The interface","a":"the-lightbox","h":"The LightBox","t":"The LightBox is a strip of thumbnails across the top of the canvas for browsing everything you can load. Press , (comma) or click LightBox on the top shelf to show or hide it. It opens on its own at start-up (see Preferences). The LightBox on the Tool tab Tab Shows Double-click Project Projects (.sfproj) in your library and recently opened projects Open the project Tool Sphere, Plane and Cube, and model files in your library Open (replaces the scene) Brush Every brush: built-in, custom and .sfbrush files Select or load the brush Alpha Round, Square, Noise and images in your Alphas folder Use as the brush alpha Material The MatCaps and Studio Use the material Image Reference images in your library A menu: Generate 3D, relief, inflate, project onto the model, use as alpha Splats Gaussian splat captures (.ply, .splat) Open the capture as a reference QuickSave The autosave and your QuickSaves, newest first Open it Recent Recently opened files of every kind Open it Working with the strip: Shift+double-click a model, project or primitive to append it to the scene as a new SubTool instead of replacing the scene. Drag sideways (or use the mouse wheel) to scroll through the strip. A drag of more than a few pixels scrubs, so a plain click still selects. Drag a tile down out of the LightBox onto the canvas to load it, like a double-click. Folders open with a double-click; the first tile inside a folder goes back up. The arrows at the top go back and forward through tabs and folders, and the breadcrumb shows where you are. Type in Filter to show only items whose names contain the text. Choose 1 to 4 rows of thumbnails. Open folder... adds a folder of your own to the root of every tab. On the QuickSave tab, Save now makes a QuickSave. Right-click a tile for Open, Append as SubTool, the image actions, Show in file manager and Refresh thumbnail. At the root of the Tool and Image tabs is a Built-in folder (the models and images that ship with SculptForge, such as the demo lion head), and the Project, Tool, Brush, Alpha, Image and Splats tabs have a User folder, your library folder (Documents/SculptForge by default). To use a different library folder, choose it in Preferences > LightBox > Library folder. ZBrush: the LightBox works like ZBrush's: comma toggles it, double-click loads, and Built-in and User folders play the part of ZBrush's Maxon and User folders."},{"p":"interface.html","c":"The interface","a":"ctrl-hover-help","h":"Ctrl-hover help","t":"Hold Ctrl and point at any button, slider, tile or shelf item. A box shows the item's name, its shortcut as keycaps, what it does, where it lives (for example \"Tool > Geometry\") and the script command it runs. Ctrl-hover help on the Subdivide button Hold Ctrl+Alt instead to see the scripting reference for items that run a command: the command's usage line and each parameter with its type and description. This is the same information the console, sculptforge-cli and AI agents use. Without Ctrl, icon-only buttons and labels that don't fit show their name after a short delay (Preferences > Interface > Tooltip delay). Turn Ctrl-hover help off with Preferences > Interface > Popup Info (Ctrl+hover help), and make the box more or less see-through with Popup Info opacity."},{"p":"interface.html","c":"The interface","a":"the-controls-sheet","h":"The Controls sheet","t":"Press F1 (or Help > Controls) for the Controls window. The Keyboard tab lists every action that has a shortcut, grouped by palette and generated from the actions themselves, so it always shows your current keys. The Mouse & pen tab lists the gestures. Type in the filter field to search both. Double-click a row on the Keyboard tab to give that action a new key."},{"p":"interface.html","c":"The interface","a":"this-guide","h":"This guide","t":"Help > User Guide (Shift+F1) opens this guide in its own window: the contents on the left (the open chapter lists its sections), the chapter on the right, and links between chapters. The User Guide window on the Masking chapter Search: type in the search box (Ctrl+F) to find every section that mentions all of your words. Click a result to jump there; the words are marked on the page. Esc clears it. Back and forward: the arrow buttons, Alt+Left / Alt+Right, or the back and forward buttons of your mouse. From any control: while Ctrl-hover help is showing, press F1 (keep Ctrl held) to open the chapter about that control. The help box shows which chapter it is (\"Learn more: ...\"). Code blocks have a Copy button, and Open in browser shows the same page on the SculptForge website. The guide is built into SculptForge, so it works offline and always matches your version."},{"p":"interface.html","c":"The interface","a":"the-command-palette","h":"The command palette","t":"Press F3 (or Ctrl+Shift+P, or click Search in the title strip) to find any action or command by name and run it. It opens at the top centre of the canvas. The command palette searching for subdivide Type part of a name, a palette or a word from the description. The search is forgiving: letters in order are enough (\"sbdv\" finds Subdivide), and every word you type must match somewhere. Each row shows the action, its palette and its shortcut. Up and Down (or Page Up and Page Down) choose a row, Enter runs it and Esc closes the palette. With nothing typed, the palette lists the actions you used most recently. Commands with a required parameter (for example image_relief path=) open in the console with the name already typed. Other commands run with their default values; Shift+Enter sends a command with parameters to the console instead, so you can set them first. Everything scriptable is in the command palette, including commands that have no button in the interface."},{"p":"interface.html","c":"The interface","a":"the-console","h":"The console","t":"Press ` (the backtick key, left of 1 on US keyboards) to open the console, a strip between the canvas and the bottom shelf. It works like ZBrush's ZScript window: Every command you run, from a button, a key, the command palette, a script or an AI agent, appears as a script line followed by its result. Errors show in red. Type a command and press Enter: for example remesh resolution=200 or subdivide; decimate ratio=0.5. Tab completes command and parameter names, Up and Down recall earlier lines, and help (or help remesh) explains commands. Drag the console's top edge to make it taller or shorter. The Script palette has Run script file..., Copy session as script (every command you ran this session, ready to replay, which makes it a macro recorder) and Clear console. The console after a few commands See Scripting and automation for the command language, scripts and headless use."},{"p":"interface.html","c":"The interface","a":"customizing-the-interface","h":"Customizing the interface","t":"Everything about the layout can change: which palettes sit in the trays, what's on each shelf, and which keys do what. As in ZBrush, changes last until you quit unless you store them with Store Config."},{"p":"interface.html","c":"The interface","a":"move-add-and-remove-shelf-items","h":"Move, add and remove shelf items","t":"Open Preferences > Config and turn on Enable Customize. The shelves get a dashed orange outline and the status line reads \"Customize: Ctrl+Alt+drag to move or remove items\". Hold Ctrl+Alt and drag any button, slider or tile: onto a shelf to put it there (an orange line shows where it will go), which is how you add buttons from palettes to a shelf; along its shelf, or to another shelf, to move it; off the shelves (onto the canvas, for example) to remove it. Turn Enable Customize off when you're done, and press Ctrl+Shift+I to keep the result. Right-clicking a shelf item and choosing Remove from shelf works without Customize mode."},{"p":"interface.html","c":"The interface","a":"assign-shortcuts","h":"Assign shortcuts","t":"Hold Ctrl+Alt and click any button (with Customize off), then press the key you want. Esc cancels and Backspace removes the button's shortcut. Or open Preferences > Hotkeys, find the action (there's a filter), click its key button and press the new key. Keys you changed show in orange. Default shortcuts undoes every change. Or double-click a row in the Controls window (F1). If the key already belongs to another action, it moves to the new one (as in ZBrush) and the status line says which action lost it."},{"p":"interface.html","c":"The interface","a":"store-config-and-friends","h":"Store Config and friends","t":"All in Preferences > Config: Item What it does Store Config (Ctrl+Shift+I) Keeps the current layout, shortcuts and interface preferences for future sessions Restore Custom UI Goes back to what the last Store Config saved Restore Standard UI Goes back to the built-in layout and default shortcuts (Store Config afterwards to make it stick) Save UI... Saves the layout, shortcuts and preferences to a .json file you can share Load UI... (Ctrl+L) Loads such a file (Store Config afterwards to keep it) The first time you change the layout in a session, the status line reminds you once: \"Layout changed - Ctrl+Shift+I to keep it\". What a session changes by itself (the console and LightBox being open, the LightBox tab) doesn't count as a layout change. ZBrush: Store Config has the same shortcut as in ZBrush, and SculptForge never saves the layout on its own either."},{"p":"interface.html","c":"The interface","a":"layout-presets","h":"Layout presets","t":"The 1, 2 and 3 buttons in the title strip (also in Preferences > Config) switch between three layouts: Standard: the Tool palette in the right tray and shelves around the canvas. Sculpt: both trays closed, for the largest canvas. Wide: Brush, Stroke and Alpha in the left tray, Tool and Material in the right tray. A preset changes the layout only (the console, LightBox and left-handed setting stay as they are). Store Config keeps it."},{"p":"interface.html","c":"The interface","a":"interface-preferences","h":"Interface preferences","t":"Preferences > Interface: Setting Default What it does Popup Info (Ctrl+hover help) On Ctrl-hover help boxes Popup Info opacity 0.97 How solid the help box is Tooltip delay 0.5 s How long to point at an icon-only button before its name appears One sub-palette open On Opening a sub-palette closes the others in that palette Auto collapse left tray / right tray On / Off Collapse other palettes in the tray when one wouldn't fit Palettes strictly A-Z (ZBrush order) Off Strict alphabetical palette bar instead of File and Edit first, Help last Left-handed layout Off Mirrors the shelves and trays: tools on the right, navigation on the left UI scale Automatic Size of text and controls (100% to 200%); takes effect at the next start Camera notch Automatic Keeps the interface below a laptop's camera notch in fullscreen (see below) Preferences > Input sets the key Style: ZBrush (the default) or SculptForge, which brings back the keys of SculptForge 0.6 and earlier: 1 to 9 and 0 pick the first ten brushes (9 is QuickSave in the ZBrush style), I opens Z Intensity like U, and Ctrl+drag on the background zooms when nothing is masked. Rotation chooses free rotation (ZBrush) or a turntable. See Coming from ZBrush. Preferences > LightBox has Show at startup (on by default), the number of Rows, Placement (along the top of the canvas, or at the bottom above the bottom shelf) and the Library folder. Preferences > Autosave sets how often a recovery copy is saved (see Projects, autosave and QuickSave). The Preferences palette with the Config and Interface sub-palettes"},{"p":"interface.html","c":"The interface","a":"fullscreen-the-palette-bar-and-the-camera-notch","h":"Fullscreen, the palette bar and the camera notch","t":"F11 (or Render > Fullscreen) fills the screen with SculptForge; press it again to go back to a window. sculptforge --fullscreen starts that way. Menus in the title strip hides the palette bar; click it again to bring it back. Tab hides the shelves and trays. On MacBooks with a camera notch, SculptForge keeps the interface below the notch when it fills the screen and fills the band beside the notch with the shell colour. Automatic asks macOS for the safe area (on Linux it recognises a notched MacBook display); Always reserve always keeps a band free at the top, whatever the display; Off uses the full height."},{"p":"interface.html","c":"The interface","a":"see-also","h":"See also","t":"Navigating the view Keyboard and mouse Scripting and automation Troubleshooting and FAQ"},{"p":"navigation.html","c":"Navigating the view","a":"","h":"Navigating the view","t":"This chapter explains how to rotate, pan and zoom the camera with a mouse, a pen or the right-shelf buttons, how to frame the model, and which display toggles help while you sculpt."},{"p":"navigation.html","c":"Navigating the view","a":"how-the-camera-works","h":"How the camera works","t":"The camera orbits around a target point. By default rotation is free, as in ZBrush: dragging turns the model about the screen's own axes, so it follows the cursor and can roll right over the top. Hold Shift while rotating to snap to the nearest front, back, side, top or bottom view; let go of Shift and the drag carries on from where the cursor is. If you prefer the model to stay upright, as in Blender or Maya, set Preferences > Interface > Rotation to Turntable: sideways drags then turn the model around its vertical axis and up-down drags tilt it, stopping just short of looking straight down or up. Panning moves the target; zooming moves the camera closer to it or further away. The view is a perspective view with a 35 degree field of view. Navigation starts only on the canvas. A drag that begins on a shelf, a tray or a palette never moves the camera. ZBrush: the gestures are ZBrush's. Dragging on the background (or right-dragging) rotates, with Shift to snap; Alt+drag pans, and letting go of Alt while still dragging zooms; Ctrl+right-drag zooms and Alt+right-drag pans, as with ZBrush's right-click navigation. As in ZBrush, dragging up (forward) zooms out and dragging down zooms in, and when you rotate or pan the model follows the cursor. The right-shelf Move, Zoom and Rotate buttons work as in ZBrush."},{"p":"navigation.html","c":"Navigating the view","a":"mouse-and-pen","h":"Mouse and pen","t":"To Do this Rotate Left-drag on the background, or right-drag anywhere on the canvas; add Shift to snap to an axis view Roll (turn about the view axis) Shift+click the background, let go of Shift, then drag (ZBrush) Pan Alt+left-drag on the background, Alt+right-drag, or middle-drag Zoom Mouse wheel; Alt+left-drag on the background, then let go of Alt and keep dragging; Ctrl+right-drag; Ctrl+middle-drag; with the SculptForge input style also Ctrl+left-drag on the background Frame the model F, or Frame on the right shelf Zoom drags go the ZBrush way: drag up to zoom out, down to zoom in. The SculptForge input style (Preferences > Input) reverses them: drag up to come closer. | Frame one SubTool | Shift+Alt+click it (it becomes the active SubTool) | \"Background\" means any part of the canvas where the cursor isn't over the model. A left-drag that starts on the model sculpts instead, so with a pen or a one-button mouse, start rotations beside the model. When the model fills the view, zoom out a little or use the right-shelf buttons. Note: Ctrl+left-drag on the background clears the mask when something is masked (and Ctrl+click there inverts it); with the SculptForge input style it zooms while nothing is masked. Use the wheel or Ctrl+middle-drag to zoom on a masked model. See Masking. On macOS, Cmd works wherever this guide says Ctrl for these gestures, except Ctrl+middle-drag, which needs Ctrl itself."},{"p":"navigation.html","c":"Navigating the view","a":"the-right-shelf-navigation-buttons","h":"The right-shelf navigation buttons","t":"The right shelf has three buttons you drag on rather than click, as in ZBrush. They are handy with a pen, on a laptop trackpad, or when the model fills the canvas and there is no background to drag on. The right shelf: Frame, Move, Zoom and Rotate, then the display toggles Button Drag on it to Frame (click) Fit the whole scene in the view (F) Move Pan the view Zoom Zoom: drag up to come closer, down to move away Rotate Orbit the view The button stays orange while you drag. Frame is also in the Render and Transform palettes."},{"p":"navigation.html","c":"Navigating the view","a":"framing","h":"Framing","t":"Frame (F) points the camera at the centre of the scene and moves it back until everything fits: every visible SubTool, plus the Gaussian splats when they are shown. SculptForge frames the scene for you when you open a file or start from a new primitive. Use it after panning far away, or when a model comes in at an unusual scale."},{"p":"navigation.html","c":"Navigating the view","a":"display-toggles-that-help-navigation","h":"Display toggles that help navigation","t":"These live on the right shelf and in the Render palette: PolyF (Shift+F): shows the polygons of the active SubTool over the surface, ZBrush's PolyFrame. Quads show as quads (see Quads and triangles). Useful for judging mesh density before you subdivide or remesh. Groups: colours each polygroup. Mask: darkens masked areas. Paint: shows polypaint colours (off shows the plain material). Solo: shows only the active SubTool, to get at parts hidden behind others. Show Mesh (Render palette): hides the sculpt, for example to look at a splat capture on its own. Fullscreen (F11) and hiding the shelves (Tab) give the canvas the most room. See The interface."},{"p":"navigation.html","c":"Navigating the view","a":"not-yet","h":"Not yet","t":"Not yet: SculptForge has no orthographic view, no rotation around the point under the cursor (the camera always orbits its target, which Frame sets to the scene centre), no floor grid and no saved camera views. Pan the target onto the area you're working on to orbit around it."},{"p":"navigation.html","c":"Navigating the view","a":"see-also","h":"See also","t":"The interface Keyboard and mouse Sculpting and brushes"},{"p":"sculpting.html","c":"Sculpting and brushes","a":"","h":"Sculpting and brushes","t":"This chapter covers everything that happens when you drag a brush across a model: the built-in brushes and the custom brushes that ship with SculptForge, brush size and strength, modifier keys, stroke types, alphas, symmetry and pen pressure. To design your own brushes, see Brush Lab and sharing brushes. Sculpting the lion head with X symmetry"},{"p":"sculpting.html","c":"Sculpting and brushes","a":"your-first-stroke","h":"Your first stroke","t":"Pick a brush: click it on the bottom shelf, press its number key, or press B to open the brush picker. Left-drag on the model. The brush works on the surface under the cursor. Hold Alt while dragging to invert the brush (dig in instead of building up), or hold Shift to smooth. Press Ctrl+Z to undo a stroke, Ctrl+Shift+Z (or Ctrl+Y) to redo it. Each SubTool keeps its own history of up to about 1 GB; the oldest steps are dropped beyond that. Dragging on the background never sculpts: it rotates the view (see Navigation). The brush only works on the active SubTool, and only on parts that are visible and not masked. ZBrush: the modifiers are the ones you know. Alt flips Zadd and Zsub for one stroke, Shift smooths with any brush, Ctrl paints a mask (see Masking)."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"built-in-brushes","h":"Built-in brushes","t":"SculptForge has fourteen sculpting brushes plus the Paint brush. The first ten have number keys; all of them are on the bottom shelf by default and in the brush picker. Brush Key What it does With Alt Standard 1 Raises the surface along the stroke, the all-purpose brush. Digs in Clay 2 Builds up clay that fills the hollows first, with a slightly flat top. Carves away Smooth 3 Relaxes the surface, evening out bumps. The same brush Shift gives you. No change Move 4 Grabs the surface under the cursor and pulls it along, parallel to the screen. No change Inflate 5 Swells the surface outward along its normals. Deflates Crease 6 Cuts a sharp crease and pinches its sides in. Raises a ridge Flatten 7 Presses the surface toward a plane through the brush area. Pushes away from the plane Pinch 8 Pulls the surface toward the stroke to tighten edges. Spreads it apart DamStandard 9 A narrow, deep V-shaped crease with the sides pinched in. A sharp ridge ClayBuildup 0 Square, flat-topped clay strokes for blocking in forms. Carves flat-bottomed SnakeHook Pulls the surface out into horns and tendrils that taper as you drag. No change Trim Trim Dynamic: shaves away everything above a plane for hard surfaces. Fills up to the plane Layer Raises the surface to one fixed height per stroke; overlapping passes never stack. Lowers to a fixed depth Nudge Slides the surface sideways along the stroke without lifting it. No change Paint P Paints colour without sculpting. See Polypaint and materials. Paints back to white Notes on particular brushes: Move and SnakeHook move the surface with the cursor instead of placing dabs, so stroke types (Dots, Spray and so on) don't apply to them. Layer sets its height from the brush size and Z Intensity. Pen pressure lowers the height when Pressure > Strength is on, so you can feather the edge of a layer. Trim gives crisp planes on cylinders and edges. Use it with Front on when you work on thin shapes. ZBrush: DamStandard, ClayBuildup, SnakeHook, Trim (Dynamic), Layer and Nudge behave like their ZBrush namesakes. Brushes such as hPolish, ClayTubes, Slash or the IMM and curve brushes are not built in; you can get close to several of them with a custom brush in Brush Lab."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"custom-brushes-that-ship-with-sculptforge","h":"Custom brushes that ship with SculptForge","t":"Besides the built-in brushes, SculptForge ships seven custom brushes. They are recipes: data that you can open and change in Brush Lab. They appear in the Custom section of the brush picker and in Brush > Custom brushes. Brush What it does Wrinkle Fine, sharp creases for skin folds and fabric wrinkles. Palette Knife Flattens and drags clay sideways like a sculptor's knife. Dragon Scales Stamps rounded overlapping scales along the stroke. Stone Chisel Scrapes hard planes and breaks them up with cracks for rocks and ruins. Skin Pores Sprinkles tiny pores for close-up skin detail. Clay Buildup Builds up flat-topped strokes of clay for blocking in forms. Edge Wear Chips and softens only the sharp edges and ridges, for weathered props. Custom brushes respond to Alt, Shift, the mask, symmetry and the stroke settings just like built-in ones. Their thumbnails carry a small sparkle when you put them on the bottom shelf."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"pick-a-brush","h":"Pick a brush","t":"You can choose a brush in several places: Bottom shelf: click a tile. The active brush has an orange outline and the number key is shown in the corner of each tile. Number keys: 1 to 9 and 0 pick the first ten built-in brushes (see the table above); P toggles the Paint brush. Brush tile at the top of the left shelf: click it to open the brush picker beside it. Brush palette: the same grid of thumbnails, with a filter field, plus your custom brush list. Command palette (F3): type the brush name and press Enter."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"the-brush-picker","h":"The brush picker","t":"Press B to open the brush picker under the mouse. It shows a Recent row (once you have picked brushes), then Built-in, Custom and Library sections. The Library section lists .sfbrush files in the Brushes folder of your LightBox library that aren't loaded yet; picking one loads it. The brush picker after pressing B, with letter badges The picker works the ZBrush way, by typing letters: Press B. Type the first letter of the brush. Only brushes starting with that letter stay, and each shows an orange key badge: the next letter that tells it apart from the others. Press the letter on the badge to pick that brush. For example B, S, T picks Standard, and with the brushes that ship, B, C, L picks Clay. If no brush name starts with what you typed, the picker falls back to names that contain it. Backspace removes the last letter, Enter picks the first match, and Esc or a click outside closes the picker. The letter chips along the top (A 2, C 4 ...) show how many brushes start with each letter; click one to filter by it. Hover a tile for a large preview and the brush's description. Right-click a tile for Add to bottom shelf, and on custom brushes also Copy brush code, Rename..., Save as .sfbrush..., Delete... and Reveal in folder (see Brush Lab and sharing brushes). ZBrush: B then two letters is the same muscle memory. Holding Ctrl while picking to choose a masking brush is not supported; mask strokes always use Ctrl with the current settings."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"draw-size-z-intensity-rgb-intensity-and-focal-shift","h":"Draw Size, Z Intensity, RGB Intensity and Focal Shift","t":"These values control every brush, with ZBrush's names and keys. Draw Size and Z Intensity are on the top shelf; all four are in the Draw palette and the QuickMenu. Setting Range Default How to change it Draw Size 2 to 800 60 Brush radius in screen pixels. [ and ] make it 10% smaller or larger (hold to repeat). S opens a slider at the cursor. Z Intensity 1 to 100 50 How strongly each dab changes the surface. U opens a slider at the cursor. RGB Intensity 1 to 100 100 How strongly painting colours the surface (the Paint brush, and sculpting with Rgb on). I opens a slider at the cursor. Focal Shift -100 to 100 0 The brush falloff. Below 0 the full-strength centre widens into a broad, hard tip; above 0 it narrows to a soft point. O opens a slider at the cursor. Because Draw Size is measured on screen, the brush covers less of the model as you zoom in, which is what you want for detail work. The brush cursor shows two rings, as in ZBrush: the outer one is the Draw Size, the inner one is Focal Shift (where the brush works at half strength). Masking, painting, Move and SnakeHook follow Focal Shift too; custom brushes made in Brush Lab keep their own tip shape. The S, U, I and O pop-ups take the mouse or the keyboard: drag the slider and release to close it, or type a number and press Enter (a minus first for a negative Focal Shift). Esc closes the pop-up without typing anything new."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"smooths-own-z-intensity","h":"Smooth's own Z Intensity","t":"Smooth keeps a Z Intensity of its own, as in ZBrush, so a gentle Standard stroke at 10 still smooths at full speed. Hold Shift (or pick the Smooth brush) and the Z Intensity slider shows Smooth Z Intensity: change it there, or hold Shift and press U. It starts at 50. The Draw palette"},{"p":"sculpting.html","c":"Sculpting and brushes","a":"sculpt-paint-zadd-zsub-rgb-and-front","h":"Sculpt, Paint, Zadd, Zsub, Rgb and Front","t":"These toggles sit on the top shelf and in the Draw palette: Control What it does Sculpt / Paint Sculpt makes brushes change the shape. Paint (P) paints colour only. Zadd / Zsub Zadd makes brushes add (the default), Zsub makes them subtract. Alt flips the current choice for one stroke. Rgb Sculpt brushes also paint the current colour as they sculpt (ZBrush Rgb with Zadd). Front Front faces only: brushes leave the far side of thin parts alone, such as the back of an ear or a cape. The Brush palette has the same Front and invert settings as the checkboxes Front faces only and Invert (Alt)."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"modifier-keys-while-sculpting","h":"Modifier keys while sculpting","t":"Hold Effect Alt Inverts the brush for this stroke (see the table of brushes). Shift (before the stroke) Smooths with the Smooth brush, whatever brush is active, at Smooth's own Z Intensity. With the Paint brush active, Shift still smooths the shape. Shift (after the stroke started) Draws a straight line from where you pressed Shift, snapped to 45 degree steps on screen. Let go of Shift to carry on freehand. Ctrl Paints a mask instead of sculpting; Ctrl+Alt erases it. A Ctrl+click without dragging blurs the mask (Ctrl+Alt+click sharpens it). See Masking. Ctrl+Shift Visibility gestures: isolate, hide and show polygroups. See Polygroups and visibility."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"the-quickmenu","h":"The QuickMenu","t":"Press Space for ZBrush's QuickMenu under the cursor: the Brush, Stroke, Alpha and Material tiles, Draw Size, Focal Shift, Z Intensity and RGB Intensity, Zadd / Zsub, Sculpt / Paint, Rgb and X symmetry. Hold Space and let go to close it again (it stays while the pointer is on it), or tap Space to keep it open until you click elsewhere or press Esc. Clicking a tile opens its picker."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"strokes","h":"Strokes","t":"The stroke type decides how cursor movement becomes brush dabs. Choose it from the Stroke tile on the left shelf, which opens the stroke picker, or from the Stroke palette. The stroke picker Stroke What it does Setting Dots Even dabs along the path: the classic brush stroke (default). None; spacing comes from the brush. DragRect Click and drag one stamp: the drag length sets its size and its direction the rotation. Great with alphas. None DragDot Click and drag one stamp of the brush's Draw Size: it slides over the surface under the cursor and lands where you let go. Great for VDMs. None Spray Scattered dabs of random size, strength and rotation, for organic texture. Scatter (0 to 2, default 1): how far dabs land from the cursor, as a fraction of the brush size. LazyMouse The brush trails the cursor on a string, for smooth, steady lines. Lazy radius (1 to 300 px, default 40): longer is steadier. The setting slider appears under the stroke tiles when Spray or LazyMouse is selected. With LazyMouse, the viewport draws the string between the cursor and the brush point. Notes: With DragRect, the stamp is placed where you first click. While you drag, it is redrawn at the new size and angle, and it is committed when you release. With DragDot, the stamp appears under the cursor at once and follows it while you drag; the mesh under it goes back to how it was as it moves on. Mask strokes (Ctrl) always use dots, even when DragRect or DragDot is selected. Custom brushes set their own dab spacing and can add jitter (see Brush Lab). ZBrush: DragRect, DragDot, Spray and LazyMouse match ZBrush's. Freehand and Dots are the same thing here. Roll and curve strokes are not available yet."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"alphas","h":"Alphas","t":"An alpha is a grayscale stamp that shapes the brush tip: white is full effect, black is none. It affects every brush, built-in or custom. Choose one from the Alpha tile on the left shelf (the alpha picker) or the Alpha palette, which also shows a large preview of the current alpha. The alpha picker Alpha What it does Round The plain round falloff (no alpha). The default. Square A square stamp with soft edges. Noise A noisy stamp for rough, organic texture. To use your own image: Click Load image... in the alpha picker or the Alpha palette. Choose a PNG, JPG, BMP, TGA, PSD or GIF. Colour images are converted to grayscale. Turn on Invert loaded image before loading if your image is white where it should have no effect. Images you keep in the Alphas folder of your LightBox library (Documents/SculptForge/Alphas by default) appear in the picker's Images section, so you can switch between them with one click. The alpha's top edge points up the screen; with DragRect it follows the drag direction instead. From a script: brush_set_alpha name=square, or brush_set_alpha path=bark.png invert=true. ZBrush: there is no alpha library browser with hundreds of alphas yet, and alpha options such as MidValue, Rf (radial fade) or tiling are not available. Any grayscale image works, including alphas you already have as PNG."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"vector-displacement-brushes","h":"Vector displacement brushes","t":"A vector displacement brush (ZBrush's VDM brushes, Blender's \"VDM brushes\") stamps a whole 3D shape in one click: a horn, an ear, a cluster of scales, a nostril. An alpha can only push the surface up or down; a vector displacement map (VDM) moves every point of the stamp in any direction, so the shape can lean over, curl and overhang, as nothing made with a height ever can. Horns, an ear curl, scales and two nostrils, one stamp each, and Brush > Vector Displacement"},{"p":"sculpting.html","c":"Sculpting and brushes","a":"stamp-a-vdm","h":"Stamp a VDM","t":"Open the Brush palette and its Vector Displacement section, and click a map: Horn, Ear Curl, Scales or Nostril. The VDM brush becomes the brush and the stroke becomes DragRect. (While the VDM brush is the brush, the Alpha tile on the left shelf shows its map, and the alpha picker lists the maps first. The VDM brush is also in the brush picker: B V D.) Click on the model where the stamp should sit and drag: the drag's length sets the size and its direction points the top of the map, so a horn leans the way you drag. Let go to keep it. DragDot stamps at the Draw Size instead and slides the stamp under the cursor until you let go. Z Intensity 50 (the default) presses the map at its own shape; 100 doubles it, lower values flatten it. Alt digs the shape in: the sideways motion stays and the height flips (a horn becomes a curved hole, a nostril a bump). Blender's VDM brushes invert the same way. Symmetry mirrors the stamp exactly (the mirrored horn leans the mirrored way), the mask holds it back, and each stamp is one undo step. Sculpt layers record it like any stroke. The Dots stroke works too: each dab adds the shape again, for rows of studs or scales. Tip: a VDM moves points sideways, so it needs points to move: on a coarse mesh the shape breaks up into spikes. Divide first (the model above has 330 000 triangles), and stamp at the highest subdivision level; stepping down and back up keeps the stamp. Use Front faces only on thin parts so the stamp doesn't reach through to the other side."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"make-your-own-vdm","h":"Make your own VDM","t":"In Brush > Vector Displacement, click New VDM Plane. A flat 2 x 2 grid appears as a new SubTool, seen from the top, with its border masked (so the stamp blends into any surface); the other SubTools are hidden. Plane Res sets how many quads it has (256 by default). Sculpt the shape with any brush: overhangs are welcome (Move, SnakeHook, Inflate). Divide the plane for finer detail. Keep the border flat. Type a name, choose the Map Size (256 pixels holds most shapes, 512 fine detail) and click Create VDM. The new map is saved in your brush library, shows in the list and becomes the VDM brush's map. Show your model again in the SubTool palette (its eye) and stamp away. The top of the screen when you look at the plane from the top is the top of the map: the side a DragRect drag points to. The plane's UVs record where each point started, so what Create VDM captures is how far each point moved, sideways and up."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"load-and-export-maps-blender-zbrush","h":"Load and export maps (Blender, ZBrush)","t":"Load VDM... reads an OpenEXR (16- or 32-bit, any compression) or a .sfvdm; dropping an .exr on the window does the same. A loaded EXR is kept in your brush library as a .sfvdm, so it's there next time. Export EXR... writes the brush's map as a 32-bit float EXR. Right-click a map you made or loaded to delete it. Maps use the convention of Blender's VDM Brush Baker and its Draw brush with Vector Displacement: Channel Means R X: toward the stamp's right G Y: toward the stamp's top (the image's top row; the drag direction of DragRect) B Z: out of the surface Units brush radii: (0, 0, 0.5) lifts the surface by half the radius; the map covers the brush's square So maps from Blender's VDM Brush Baker load as they are, and exported maps work in Blender: add an image texture with the EXR (Color Space: Non-Color) to a Draw brush, set the texture's Mapping to Area Plane, turn on Vector Displacement in the brush's Texture panel, and use the Anchored stroke at Strength 1 (see Working with Blender). Blender's brush touches only the round area of the brush, so the corners of a map are cut off there; in SculptForge the whole square stamps. ZBrush keeps its VDMs inside brushes (as 3D alphas) and doesn't export them as EXR by itself; maps made with Tool > Vector Displacement Map or third-party exporters use axes set by ZBrush's Vector Displacement Flip options. If a map from ZBrush stamps lying on its side, load it again with Swap Y/Z; if it is mirrored or leans the wrong way, with Flip X or Flip Y (Flip Z for a map that digs in where it should rise). Scale multiplies a map made in other units. From a script: vdm_set name=horn or vdm_set path=ear.exr swap_yz=true, vdm_stamp point=0,0.5,0 radius=0.3 angle=30, vdm_new_plane, vdm_capture name=\"My horn\" exr=horn.exr, vdm_export path=horn.exr, vdm_list, vdm_delete name=\"My horn\". ZBrush: the VDM brush works like ZBrush's VDM brushes with DragRect or DragDot. Not available yet: several VDMs in one brush (ZBrush's Create Multiple Alpha Brush), MidValue and the alpha options for 3D alphas, and reading ZBrush's own brush files."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"symmetry","h":"Symmetry","t":"Symmetry mirrors every stroke, including mask and paint strokes. X mirrors left and right. It is on by default; press X to toggle it. Y mirrors top and bottom, and Z mirrors front and back. They have no default key (you can assign one; see The interface). The X, Y and Z buttons are on the top shelf and in the Transform palette. You can combine them: X and Z together give four-way symmetry. Symmetry mirrors across the scene's axes through the origin. Models that are centred on the origin, such as SculptForge's primitives and most character exports, mirror correctly. If a stroke lands in the wrong place on the other side, the model is off-centre. ZBrush: this is ZBrush's world symmetry with the >X< axis on. Local symmetry, radial symmetry and topological (poseable) symmetry are not available yet."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"pen-pressure-and-tablets","h":"Pen pressure and tablets","t":"SculptForge reads pen pressure from graphics tablets and pen displays through the operating system. When it receives pen input, the Draw palette shows Pen pressure with the current value; before that it says No pen detected. Two toggles decide what pressure does. They are on the top shelf and in Draw > Tablet: Toggle Default Effect Pressure > Strength On Pen pressure scales the brush strength. Pressure > Size Off Pen pressure scales the brush size (down to 5% at the lightest touch). Pressure applies only to strokes made with the pen; mouse strokes always use full pressure. Custom brushes also have a Pressure curve setting that makes them respond to a light or a firm touch (see Brush Lab). If the pen moves the cursor but pressure does nothing, see Troubleshooting. Preferences > Tablet checks and tunes the pen: a pressure meter and a draw-test area, to see what the tablet reports at a light touch and a full press; a pressure curve for all brushes (Soft, Linear or Firm, or set Curve, Minimum, Maximum, Threshold and Full pressure at yourself), applied before each brush's own curve; the eraser end (default Invert, like holding Alt) and the side buttons (default: lower button right-click to rotate the view, upper button Invert, third button Pan view). Store Config (Ctrl+Shift+I) keeps these settings. Setup notes for Windows Ink, macOS and Linux are in docs/tablet.md."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"customize-the-bottom-shelf","h":"Customize the bottom shelf","t":"The bottom shelf holds your most-used brushes. By default it shows Standard, Clay, ClayBuildup, DamStandard, Move, Smooth, Inflate, Pinch, Flatten, Crease, Trim, SnakeHook, Layer, Nudge and Paint. The bottom shelf Add a brush: click the + tile at the end of the shelf and pick a brush, built-in or custom. Or right-click any tile in the brush picker and choose Add to bottom shelf. Remove a brush: right-click its tile and choose Remove from shelf. Reorder: turn on Preferences > Config > Enable Customize, then Ctrl+Alt+drag a tile to a new place. Change a brush's key: Ctrl+Alt+click its tile, then press the new key. Shelf changes last until you quit. Press Ctrl+Shift+I (Store Config) to keep them. See The interface for more on customizing."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"sculpt-from-a-script","h":"Sculpt from a script","t":"The stroke command applies a brush along a path on the active SubTool, as one undo step. It is useful for scripted detailing and for AI agents: sculptforge-cli -c 'new_sphere subdivisions=6; stroke brush=Crease points=\"-0.6,0.2,0 0,0.4,0 0.6,0.2,0\" symmetry=x; export_glb path=out.glb' Points are projected onto the surface along view (default 0,0,-1, the front view). radius (world units), strength, pressure, invert, spacing, curve and seed work as in the viewport. See Scripting and automation."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"see-also","h":"See also","t":"Brush Lab and sharing brushes: design brushes with AI, the brush library and brush codes Masking: protect areas from every brush Polypaint and materials: Paint brush, Rgb and colour Sculpt layers and blend shapes: sculpt into a layer you can dial in and out Dynamic topology: brushes that add triangles where they need them (Sculptris Pro) Keyboard and mouse reference"},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"","h":"Brush Lab and sharing brushes","t":"Brush Lab designs sculpting brushes from a description: type \"dry cracked mud\" and an AI model builds the brush, then you refine it in words or with sliders. This chapter covers Brush Lab, the AI providers it can use, the recipe settings, your brush library, and the ways to share brushes: .sfbrush files, one-line brush codes, studio folders and the community gallery. Brush Lab with a brush designed from a description"},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"what-a-custom-brush-is","h":"What a custom brush is","t":"A custom brush is a recipe: about twenty named values that describe how the brush moves the surface, the shape of its tip, a surface pattern, stroke spacing and masking. A recipe is data, never code, so brushes are safe to download and share. The AI only fills in these values; you can see and change every one of them. Custom brushes work everywhere built-in brushes do: on the bottom shelf, in the brush picker (B), with Alt, Shift, masks, symmetry, strokes and alphas."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"open-brush-lab","h":"Open Brush Lab","t":"Click AI Brush on the top shelf, or AI Brush at the top of the Brush palette. Brush Lab is a floating window; it opens at the top-left corner of the canvas the first time, and you can drag it anywhere. Click the button again, or the window's close box, to hide it."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"design-a-brush","h":"Design a brush","t":"Open Brush Lab. Type a description in the field at the bottom, the way you'd describe the brush to another sculptor, for example bark of an old oak tree or soft folds in heavy cloth. Or click one of the starter ideas, such as Overlapping dragon scales or Dry cracked mud. Press Enter or click Create. While the model works, the conversation shows \"Designing brush\". When the brush is ready, it becomes the active brush and the status bar says so. Try it on the model. The model replies with the brush name in brackets and a sentence on what the brush does and what to try next. Errors (no connection, rate limits, a model that didn't return a recipe) appear in red in the same conversation."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"refine-a-brush-in-words","h":"Refine a brush in words","t":"With Refine the selected brush ticked, your next message changes the active custom brush instead of creating a new one: \"sharper\", \"less buildup\", \"make the scales smaller\". The model sees the current recipe and your conversation so far. Clear chat starts a new conversation."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"tune-a-brush-with-sliders","h":"Tune a brush with sliders","t":"Open the Recipe section of Brush Lab to see every value of the active custom brush. The same editor appears in the Brush palette as Edit recipe: NAME when a custom brush is active. Hover a slider for a description. Setting Range What it does Direction normal, inflate, view, stroke Which way the surface moves: out of the surface, outward in every direction, toward the camera, or along the stroke. Depth -1 to 1 Adds material (positive) or carves it away (negative). Plane none, clay, flatten, fill, scrape Planar behaviour: flat-topped clay layers, levelling, raising only low spots, or cutting only high spots. Plane amount 0 to 1 Strength of the plane behaviour. Pinch -1 to 1 Pulls the surface toward the stroke for crisp creases (negative spreads it apart). Drag 0 to 1 Smears the surface along the stroke, like a palette knife. Auto smooth 0 to 1 Relaxes the surface after each dab for softer, cleaner results. Hardness 0 to 1 Soft airbrush edge (0) to hard-edged stamp (1). Tip sharpness 0 to 1 Round, broad tip (0) to a narrow needle point (1). Pattern none, noise, scales, ridges, pores, cracks A surface texture stamped by the brush. Pattern size 0.03 to 2 Size of the pattern relative to the brush size. Pattern amount 0 to 1 How strongly the pattern shows. Spacing 0.02 to 2 Distance between dabs, relative to the brush size. Jitter 0 to 1 Random scatter of dabs around the stroke. Pressure curve 0.3 to 3 Tablet response: above 1 needs a firmer press, below 1 responds to a light touch. Front faces only on / off Only affects surfaces facing the camera, protecting thin parts. Cavity mask -1 to 1 Positive: only cavities. Negative: only ridges and peaks (as Edge Wear does). The name field at the top of the editor renames the brush when you press Enter. Tip: to adapt a built-in recipe such as Dragon Scales, select it and move the sliders. Your version is saved to your library and replaces the built-in one; delete it to get the original back."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"choose-an-ai-provider","h":"Choose an AI provider","t":"Brush Lab works out of the box with no account or key. Open the AI provider section of Brush Lab (also in Generate > AI brush provider) to choose another service. Provider What you need Notes Free - no account or key (default) Nothing An open model (GPT-OSS 20B) hosted by Pollinations.ai. Only your description and settings are sent. Rate limited to about one request every few seconds. If it can't be reached, a running local Ollama is used instead. Anthropic (Claude) - your key An Anthropic API key Uses claude-opus-5-5 by default. Effort (low, medium, high) trades speed for more considered brushes. OpenAI-compatible (OpenAI, Ollama, LM Studio...) An endpoint, a model name and, for hosted services, a key Any server that speaks the OpenAI chat completions API, including local models. For Anthropic and OpenAI-compatible providers you can edit the Endpoint, Model and API key fields. Leave the key empty to use the ANTHROPIC_API_KEY or OPENAI_API_KEY environment variable. Click Save settings to keep your choice; settings and keys are stored only on your computer, in ai.json in the SculptForge settings folder (readable only by you). Requests go only to the endpoint you set."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"run-a-model-on-your-own-computer","h":"Run a model on your own computer","t":"For private, offline use with no rate limits, run a local model with Ollama or LM Studio: Install Ollama and download the recommended model: ollama pull qwen3:4b-instruct (2.5 GB, works without a graphics card). In AI provider, choose OpenAI-compatible (OpenAI, Ollama, LM Studio...). Click Ollama (or LM Studio) to fill in the local endpoint. Click Find models. SculptForge checks the connection, shows \"Connected\" with the number of installed models, and lets you pick one from the Model list. Click Save settings. The Run a model on this computer section in the panel shows the install steps for your operating system. The model needs about 4 GB of free memory; expect 10-20 seconds per brush on a laptop CPU and a few seconds with a GPU. The full walkthrough for Windows, macOS, Linux and LM Studio is in docs/local-ai.md."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"your-brush-library","h":"Your brush library","t":"Every brush you create or refine in Brush Lab is saved to your brush library automatically, a moment after your last change (slider edits save when you release the slider). The library loads at every start, in the app, in sculptforge-cli and in the Python module, so your brushes are always there. The library is a folder of .sfbrush files in the SculptForge settings folder: System Brush library Linux ~/.local/share/SculptForge/SculptForge/brushes macOS ~/Library/Application Support/SculptForge/SculptForge/brushes Windows %APPDATA%\\SculptForge\\SculptForge\\brushes The Custom brushes list in the Brush palette, with its right-click menu"},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"the-custom-brushes-list","h":"The Custom brushes list","t":"The Brush palette lists every custom brush under Custom brushes. A small tag after a name says where the brush comes from when it isn't simply yours or built in: Tag Meaning (none) A built-in brush, or a brush in your library yours Your version, which replaces a built-in or studio brush of the same name studio From a shared studio folder (read-only) gallery Installed from the community gallery (kept in your library) project Came with the open project and isn't in your library unsaved Made this session (for example picked from the picker's Library section, or loaded by a script) and not in your library Hover a brush for its description, origin and file. Right-click it for: Copy brush code: one line of text to share (see below). Save .sfbrush...: write the brush to a file. Rename...: rename it. Renaming a built-in or studio brush saves a renamed copy and keeps the original. Delete...: remove it from your library, after a confirmation. Only brushes in your own library can be deleted. If your brush replaced a built-in or studio brush, that one is used again. Reveal in folder: open the folder that holds its file. The same menu is available when you right-click a custom brush in the brush picker. When brushes share a name, your library wins over studio folders, and studio folders win over built-in brushes."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"brush-codes","h":"Brush codes","t":"A brush code is the whole recipe in one line of text, starting with sfbrush1:. Paste it into a chat, an email, an issue or a forum post. Copy: right-click a custom brush (in Brush > Custom brushes or the brush picker) and choose Copy brush code. Paste: copy a code, then press Ctrl+V over the viewport, click Paste brush in Brush Lab, or choose Edit > Paste brush. The brush is installed in your library and becomes active. Pasting also accepts the text of a .sfbrush file. Codes are validated like files: values outside their range are clamped, and anything that isn't a recipe is refused."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"brush-files-sfbrush","h":"Brush files (.sfbrush)","t":"A .sfbrush file is a small JSON file holding one recipe. Save: right-click the brush and choose Save .sfbrush..., or click Save .sfbrush... under the recipe sliders. Install: click Install .sfbrush... under the recipe sliders, or drop the file onto the SculptForge window. The brush goes into your library. Library folder: .sfbrush files in the Brushes folder of your LightBox library (Documents/SculptForge by default) appear in the Library section of the brush picker and in LightBox's Brush tab. Picking one loads it for the session. The file format and every key are documented in docs/brushes.md."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"studio-brush-folders","h":"Studio brush folders","t":"A studio can share brushes read-only from network folders. Set the environment variable SCULPTFORGE_BRUSH_PATH to one or more folders (separated by : on Linux and macOS, ; on Windows). Every .sfbrush file in them loads at start-up, tagged studio. Artists can't change or delete studio brushes; if they edit one, their own version is saved in their library under the same name. The Rez package adds the folder in SCULPTFORGE_STUDIO_BRUSHES to this path. See For studios. Projects (.sfproj) also store the brushes they use, so a scene opens with its brushes on any machine."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"the-community-gallery","h":"The community gallery","t":"The community gallery is a public collection of free (CC0) brushes shared by other sculptors. Click Community brushes at the top of the Brush palette. Search by name or description (scales, skin, stone...), or pick a tag from the All tags list. Click Install under a brush. It is downloaded, checked against its SHA-256 checksum, installed in your library and made active. Installed brushes show Installed. The Community brushes window The gallery is cached, so the window still opens offline (with a notice) showing the brushes from your last visit. Refresh fetches the latest list. Share yours opens the gallery's page on GitHub, where you can submit a brush you saved as .sfbrush with a pull request. You can also browse the gallery on the website at sculptforge.app/brushes.html. Studios can mirror the gallery or run their own. Enter a URL or folder in the Gallery field at the bottom of the window and click Use, or set SCULPTFORGE_BRUSH_GALLERY (which then takes precedence and hides the field). See docs/brushes.md for the gallery format."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"brushes-from-scripts","h":"Brushes from scripts","t":"Every brush operation is also a command, for sculptforge-cli, the console, Python and AI agents: Command What it does brush_ai prompt=... Design a brush from a description (optional provider, endpoint, model). brush_create name=... depth=... Create or update a brush from recipe values. brush_list / brush_library List custom brushes (with their source and file, and the library folders). brush_save path=... Save a brush as .sfbrush (name defaults to the active brush). brush_load path=... Load a .sfbrush file for this session only. brush_install path=... / code=... / json=... Install a brush into your library and make it active. brush_code Print a brush as a brush code. brush_rename to=... / brush_delete name=... Rename or delete a brush. brush_gallery_search / brush_gallery_install name=... Search and install from the community gallery. # Design a brush for free and save it for the team sculptforge-cli -c 'brush_ai prompt=\"weathered stone edges\"; brush_save path=stone.sfbrush' # Install a gallery brush and try it on a sphere sculptforge-cli -c 'brush_gallery_install name=\"Snake Scales\"; new_sphere subdivisions=6; stroke points=\"-0.5,0,0 0.5,0.2,0\"' See Scripting and automation for running commands."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"see-also","h":"See also","t":"Sculpting and brushes: built-in brushes, strokes, alphas and pressure For studios: shared brush folders and pipelines Troubleshooting: AI provider errors and rate limits"},{"p":"masking.html","c":"Masking","a":"","h":"Masking","t":"A mask protects part of the model from change. Masked areas are drawn darker, and every brush, the Paint brush and colour fills leave them alone. This chapter covers painting masks with Ctrl, masking with a lasso or rectangle, the background gestures, and the Tool > Masking controls for inverting, blurring, growing and building masks from cavities or polygroups. A mask painted on the lion's mane, with the Masking sub-palette"},{"p":"masking.html","c":"Masking","a":"how-masks-work","h":"How masks work","t":"A mask is a value per vertex from 0 (free) to 1 (fully masked). Values in between give partial protection, so a soft mask edge blends sculpting into the protected area. Masks belong to a SubTool: each SubTool has its own mask. Masks are saved in projects (.sfproj) and in .GoZ files, so they survive a round trip to ZBrush. Masking is not a layer and isn't affected by sculpt layers: a mask stroke always works on the model itself. Mask strokes and mask commands are undoable like any other change. To see the mask, keep Mask on in the right shelf (it is on by default). The same toggle is Show mask in Tool > Masking, and Show Mask in the Render palette. Turning it off hides the darkening; the mask still protects the surface."},{"p":"masking.html","c":"Masking","a":"paint-a-mask","h":"Paint a mask","t":"Hold Ctrl and drag on the model. The area under the brush becomes masked. Hold Ctrl+Alt and drag to erase the mask. Mask strokes use the current Draw Size, symmetry and, with a pen, pressure (when Pressure > Strength is on). How much each stroke masks is set by Mask Strength in Tool > Masking (0.01 to 1, default 1): lower values build up a soft, partial mask over several strokes. Mask strokes always use a round tip, whatever alpha you have selected, and a DragRect stroke masks with dabs along the path instead of one stamp. On macOS, Cmd works wherever this guide says Ctrl. ZBrush: this is ZBrush's Ctrl-masking with the MaskPen brush, the default. MaskLasso and MaskRect are described next."},{"p":"masking.html","c":"Masking","a":"mask-with-a-lasso-or-rectangle","h":"Mask with a lasso or rectangle","t":"To mask a large or sharply outlined area in one go, pick a mask selection shape. As in ZBrush, holding Ctrl turns the brush on the left shelf into the mask brush: with Ctrl held, click the brush tile (or press B) to pick MaskPen, MaskLasso or MaskRect, or click the stroke tile to pick the stroke (Dots, Lasso or Rect). The same shapes sit at the top of Tool > Masking: Shape Ctrl + drag MaskPen (default) Paints the mask with the brush, as described above. MaskLasso Draws a free-hand outline that closes back to where you started. Everything inside is masked. MaskRect Draws a rectangle. Everything inside is masked. With MaskLasso or MaskRect: Hold Ctrl and drag around the area. The drag can start on the model or on the background. The shape is drawn as you drag, white with a dark veil. Let go to mask what's inside. Hold Ctrl+Alt instead to unmask what's inside (the shape is drawn blue). You can press or release Alt while dragging; what counts is whether it is held when you let go. The selection works in screen space, like the visibility rectangle: a vertex counts as inside when it falls inside the shape as you see it, including vertices on the far side of the model. Hidden parts are left alone. Mask Strength sets how much a selection masks or unmasks, and each selection is one undo step. A lasso that crosses itself leaves out the areas it encloses twice. The cursor turns into a small cross while Ctrl is held, since the brush size doesn't matter for a selection. ZBrush: these are ZBrush's MaskLasso and MaskRect brushes. Like ZBrush, the shape stays selected until you pick another one, so switch back to MaskPen to paint masks again. Holding Ctrl shows the mask brush on the shelf and Ctrl with the Brush or Stroke picker picks it, as in ZBrush. MaskCurve is not available yet."},{"p":"masking.html","c":"Masking","a":"background-gestures","h":"Background gestures","t":"With Ctrl held, clicks and drags on the empty background act on the whole mask: Gesture Effect Ctrl + click the background Invert the mask Ctrl + drag on the background Clear the mask (MaskPen) Ctrl + drag on the background, with nothing masked Nothing, as in ZBrush (the SculptForge input style zooms the view, see Coming from ZBrush) On the model, a Ctrl + click that doesn't drag works on the mask's edges, as in ZBrush: Gesture Effect Ctrl + click the model Blur the mask (once per click; same as Blur) Ctrl+Alt + click the model Sharpen the mask (same as Sharpen)"},{"p":"masking.html","c":"Masking","a":"mask-keys","h":"Mask keys","t":"Key Effect Ctrl+A Mask All Ctrl+Shift+A Clear Mask Ctrl+I Invert Mask Ctrl+H Show or hide the mask's shading (View Mask) Ctrl+W Group Masked: the masked part becomes a new polygroup and the mask is cleared (see Polygroups) A drag starts after the cursor moves a few pixels, so a slightly shaky click still inverts. With MaskLasso or MaskRect, a Ctrl + drag on the background draws the shape instead; clear the mask with Clear, or Ctrl+Alt + drag a shape around the whole model."},{"p":"masking.html","c":"Masking","a":"the-masking-sub-palette","h":"The Masking sub-palette","t":"Open Tool > Masking (the Tool palette is in the right tray by default). Every button is one undo step. Control What it does Command Show mask Darken masked areas in the viewport. MaskPen / MaskLasso / MaskRect What Ctrl + drag does: paint with the brush, or mask inside a lasso or rectangle. mask_lasso / mask_rect Mask Strength How much each mask stroke or selection masks (0.01 to 1), and the mask value By cavity gives the deepest cavities. Clear Unmask everything. mask_clear Invert Masked becomes free and free becomes masked. mask_invert All Mask every visible vertex. mask_all Blur Soften the mask edges by averaging with neighbouring vertices. mask_blur Sharpen Tighten soft edges, pushing values toward fully masked or free. mask_sharpen Grow Expand the masked region by one ring of edges per pass. mask_grow Shrink Contract the masked region by one ring of edges per pass. mask_shrink passes How many times Blur, Sharpen, Grow and Shrink run (1 to 20 here, default 1). iterations= By cavity Mask concave areas (creases, folds, pores), replacing the current mask. mask_by_cavity threshold How concave a spot must be for By cavity (-0.2 to 0.5, default 0.02). 0 masks anything concave; higher values keep only deep creases. threshold= By polygroup Mask one polygroup, replacing the current mask. The number field next to it is the polygroup id. mask_by_polygroup Mask operations only change visible parts of the model; hidden parts keep their mask. Clear is the exception and frees everything."},{"p":"masking.html","c":"Masking","a":"protect-detail-while-smoothing","h":"Protect detail while smoothing","t":"Click By cavity to mask the creases and pores. Smooth with Shift. The cavities keep their sharpness while the surface between them relaxes. Ctrl + drag on the background to clear the mask when you're done. Raise threshold if too much is masked; lower Mask Strength for partial protection."},{"p":"masking.html","c":"Masking","a":"sculpt-one-part-only","h":"Sculpt one part only","t":"Paint a mask over the part you want to work on with Ctrl. Ctrl + click the background to invert it. Now everything except that part is protected. Sculpt freely; strokes that cross the edge stop at the mask."},{"p":"masking.html","c":"Masking","a":"mask-a-whole-polygroup","h":"Mask a whole polygroup","t":"The quickest way works without knowing the group's number: Ctrl+Shift + click the group to isolate it (see Polygroups and visibility). Click All: only visible vertices are masked. Ctrl+Shift + click the background to show everything again. The mask stays. By polygroup masks a group by its id. The viewport doesn't show ids, but the console does: isolate the group, then open the console (`) and read the isolate_polygroup group=N line. Enter that number in the field next to By polygroup and click it."},{"p":"masking.html","c":"Masking","a":"a-soft-edged-mask","h":"A soft-edged mask","t":"Paint the mask, then click Blur a few times (or set passes to 3-5 first). Sharpen does the opposite."},{"p":"masking.html","c":"Masking","a":"turn-a-mask-into-a-polygroup","h":"Turn a mask into a polygroup","t":"Click From mask in Tool > Polygroups: the masked triangles become a new polygroup. See Polygroups and visibility."},{"p":"masking.html","c":"Masking","a":"masks-and-painting","h":"Masks and painting","t":"Polypaint respects the mask too: the Paint brush, Rgb strokes and Fill leave masked areas alone, so you can mask an area and fill the rest with a colour. See Polypaint and materials."},{"p":"masking.html","c":"Masking","a":"masking-from-a-script","h":"Masking from a script","t":"Command Options mask_clear, mask_all, mask_invert mask_blur, mask_sharpen, mask_grow, mask_shrink iterations (1-100, default 1) mask_by_cavity strength (0-1, default 1), threshold (-1 to 1, default 0.02) mask_by_polygroup group (required), add=true to add to the current mask instead of replacing it mask_rect x0 y0 x1 y1 (-1 to 1, y up), unmask, strength (0-1, default 1), optional view_proj matrix; without a view the rectangle spans the mesh seen from the front mask_lasso points (required): the outline as \"x0 y0 x1 y1 ...\", at least 3 points in the same -1 to 1 space; unmask, strength, view_proj as for mask_rect sculptforge-cli -c 'open path=head.obj; mask_by_cavity threshold=0.05; mask_blur iterations=2; save_project path=head.sfproj' Not yet: masking by topology, by normals or by alpha, Mask By Smoothness, and MaskCurve are not available yet."},{"p":"masking.html","c":"Masking","a":"see-also","h":"See also","t":"Polygroups and visibility: groups, isolating and hiding parts Sculpting and brushes: modifier keys and brush settings Polypaint and materials: fills that respect the mask"},{"p":"polygroups.html","c":"Polygroups and visibility","a":"","h":"Polygroups and visibility","t":"Polygroups divide a SubTool'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 SubTools. This chapter covers creating polygroups, the Ctrl+Shift visibility gestures and the Tool > Polygroups and Tool > Visibility controls. Polygroups shown as colours, with the Polygroups sub-palette"},{"p":"polygroups.html","c":"Polygroups and visibility","a":"show-polygroups","h":"Show polygroups","t":"Click Groups in the right shelf to colour each polygroup of the active SubTool. The same toggle is Show polygroups in Tool > Polygroups and Show Polygroups in the Render palette. The grouping buttons turn the colours on for you, so you see the result straight away. The number next to Show polygroups is how many polygroups are visible right now. A mesh without polygroups is one group. Polygroups come from: the grouping buttons below; OBJ files: each g group becomes a polygroup, as ZBrush writes them (SculptForge also writes polygroups as g groups when it exports OBJ); .GoZ files from ZBrush and SculptForge projects, which keep polygroups."},{"p":"polygroups.html","c":"Polygroups and visibility","a":"create-polygroups","h":"Create polygroups","t":"Open Tool > Polygroups. Grouping works on the visible part of the SubTool only; hidden parts keep their groups. So you can isolate one part and regroup just that part. Control What it does Command By normals 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. polygroup_auto_by_normals By pieces One group per disconnected piece, such as separate eyes or buttons in one mesh. polygroup_by_connectivity From mask Masked triangles move into a new group. polygroup_from_mask Group by UVs One group per UV island: triangles that touch without a UV seam between them share a group. Needs UVs (Tool > Texture Map > Auto UV or an imported model's). polygroup_uv Merge visible Everything visible becomes one group. polygroup_merge_visible Clear groups Remove all polygroups; the whole SubTool becomes one group again. polygroup_clear Each button is one undo step. ZBrush: By normals is Auto Groups / Groups By Normals, By pieces is Auto Groups on a mesh with separate parts, From mask is Group Masked, Group by UVs is UV Groups, and Merge visible is Group Visible. Ctrl+W works as in ZBrush: the masked part becomes a new group and the mask is cleared (with nothing masked, everything visible becomes one group)."},{"p":"polygroups.html","c":"Polygroups and visibility","a":"group-a-region-you-painted","h":"Group a region you painted","t":"Paint a mask over the region with Ctrl (see Masking). Click From mask in Tool > Polygroups. Ctrl + drag on the background to clear the mask."},{"p":"polygroups.html","c":"Polygroups and visibility","a":"hide-and-show-parts","h":"Hide and show parts","t":"Visibility is the main reason to have polygroups: hide what is in the way, sculpt what's left, then show everything again. Hidden parts can't be sculpted, painted or masked, so hiding also protects them. All of the gestures use Ctrl+Shift in the viewport (Cmd+Shift on macOS): Gesture Effect Ctrl+Shift + click a polygroup, everything shown Isolate it: show only that group. Ctrl+Shift + click a polygroup, something hidden Hide that group (as in ZBrush). Ctrl+Shift + click the isolated group again Invert the visibility: show everything else instead. Ctrl+Shift+Alt + click a polygroup Hide that group. Ctrl+Shift + click the background Show everything. Ctrl+Shift + drag a rectangle on the background, around nothing Reverse the visibility. Ctrl+Shift + drag Keep what's inside the rectangle (or lasso), hide the rest. The shape is drawn green. Ctrl+Shift+Alt + drag Hide what's inside the rectangle (or lasso). The shape is drawn red. Whether a drag draws a rectangle or a lasso is set by SelectRect and SelectLasso at the top of Tool > Visibility (SelectRect by default), or, as in ZBrush, with Ctrl+Shift held: the left shelf then shows the selection brush, and clicking the brush tile (or pressing B) or the stroke tile picks SelectRect or SelectLasso. With SelectLasso, 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. 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 Alt while dragging; what counts is whether it is held when you let go. SculptForge refuses a change that would hide everything, as ZBrush does. Every visibility change is one undo step, so Ctrl+Z brings back what you just hid. ZBrush: the gestures are the same as ZBrush's SelectRect and SelectLasso with polygroups. Grow and Shrink visibility and hiding by clicking with the rectangle brush are not available yet."},{"p":"polygroups.html","c":"Polygroups and visibility","a":"the-visibility-sub-palette","h":"The Visibility sub-palette","t":"Open Tool > Visibility: Control What it does Command SelectRect / SelectLasso The shape Ctrl+Shift + drag draws: a rectangle or a free-hand lasso. hide_rect / hide_lasso Show all Show every hidden part again. Available when something is hidden. show_all Invert visible Hide what is visible and show what is hidden. invert_visibility Delete hidden Permanently remove the hidden triangles from the mesh. Undoable. delete_hidden Delete hidden keeps every attribute of what remains (mask, polypaint, polygroups, 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":"polygroups.html","c":"Polygroups and visibility","a":"work-on-one-part-of-a-character","h":"Work on one part of a character","t":"Click By pieces (for a mesh made of separate parts) or By normals. Ctrl+Shift + click the part you want, for example the head. Sculpt. The rest of the body is hidden and can't be touched. Ctrl+Shift + click the background to show everything."},{"p":"polygroups.html","c":"Polygroups and visibility","a":"clean-up-a-scan-or-a-generated-model","h":"Clean up a scan or a generated model","t":"Turn the model so the unwanted piece is on screen. Ctrl+Shift+Alt + drag a rectangle over it to hide it. For an awkward shape, pick SelectLasso in Tool > Visibility first and draw around it. Click Delete hidden in Tool > Visibility."},{"p":"polygroups.html","c":"Polygroups and visibility","a":"split-a-model-into-subtools","h":"Split a model into SubTools","t":"Group the model, then click Split groups in Tool > SubTool: each polygroup becomes its own SubTool. Split parts does the same by disconnected piece. See SubTools."},{"p":"polygroups.html","c":"Polygroups and visibility","a":"polygroups-and-other-tools","h":"Polygroups and other tools","t":"Masking: By polygroup in Tool > Masking masks one group (see Masking). Brushes and polypaint skip hidden faces. Projects save polygroups and what's hidden; GoZ and OBJ carry polygroups to and from ZBrush. Each SubTool has its own polygroups and visibility. To show and hide whole SubTools, use the eye icons and Solo in Tool > SubTool."},{"p":"polygroups.html","c":"Polygroups and visibility","a":"polygroups-from-a-script","h":"Polygroups from a script","t":"Command Options polygroup_auto_by_normals angle (1-180 degrees, default 30) polygroup_by_connectivity, polygroup_uv, polygroup_from_mask, polygroup_merge_visible, polygroup_clear isolate_polygroup, hide_polygroup group (required): the polygroup id show_all, invert_visibility, delete_hidden hide_rect x0 y0 x1 y1 (-1 to 1, y up), inside, optional view_proj matrix; without a view the rectangle spans the mesh seen from the front hide_lasso points (required): the outline as \"x0 y0 x1 y1 ...\", at least 3 points in the same -1 to 1 space; inside, view_proj as for hide_rect When you isolate or hide a group in the viewport, the console (`) shows the command with the group's id, for example isolate_polygroup group=3, which you can reuse in scripts. sculptforge-cli -c 'open path=robot.obj; polygroup_by_connectivity; subtool_split_groups; save_project path=robot.sfproj' Not yet: a polygroup paint brush, Group Front, polygroups from UV islands or PolyPaint, and polygroup-based crease edges are not available yet."},{"p":"polygroups.html","c":"Polygroups and visibility","a":"see-also","h":"See also","t":"Masking: build masks from polygroups and polygroups from masks SubTools: split by groups, show, hide and solo whole SubTools Keyboard and mouse reference"},{"p":"subtools.html","c":"SubTools","a":"","h":"SubTools","t":"A scene in SculptForge can hold several separate meshes, called SubTools, just as in ZBrush: a body, eyes, teeth, a helmet and a sword can each live in their own SubTool. This chapter covers the SubTool list, selecting, adding, hiding, reordering, merging and splitting SubTools, and how they travel through files."},{"p":"subtools.html","c":"SubTools","a":"how-subtools-work","h":"How SubTools work","t":"Only the active SubTool is sculpted, painted, masked or changed by a command. The others are drawn slightly darker and greyer so you can see which one you are working on. Each SubTool keeps its own mesh, mask, polypaint, polygroups, hidden faces, UVs and sculpt layers. Each SubTool has its own undo history. Ctrl+Z undoes the last change in the active SubTool, and switching SubTools doesn't lose the history of the others. Adding, deleting, reordering, merging and splitting SubTools are not undoable, as in ZBrush. Merges and deletes ask for confirmation first. The title strip shows the active SubTool and its place in the list, for example SubTool Helmet (2/5). ZBrush: SubTools work the way you expect: one active SubTool, the rest dimmed, Alt+click in the viewport to switch. There is no folder grouping of SubTools yet."},{"p":"subtools.html","c":"SubTools","a":"the-subtool-list","h":"The SubTool list","t":"The list is in Tool > SubTool, which is open in the right tray by default. The SubTool sub-palette with several SubTools, the active one highlighted Each row shows the SubTool's name, its triangle count and an eye. To Do this Select a SubTool Click its row, or Alt+click it in the viewport Rename it Double-click the row (or right-click > Rename), type, press Enter Hide or show it Click the eye at the end of the row Duplicate or delete it Right-click the row > Duplicate or Delete... See its vertex and triangle counts Point at the row for a moment The list shows six rows and scrolls when there are more. Names are kept unique: renaming a SubTool to a name that is already taken adds a number. Selecting a hidden SubTool shows it again, because you can't sculpt what you can't see."},{"p":"subtools.html","c":"SubTools","a":"select-a-subtool-in-the-viewport","h":"Select a SubTool in the viewport","t":"Hold Alt and click another SubTool on the canvas. It becomes the active one and the list scrolls to it. Alt+click only selects when you click a SubTool other than the active one and release without moving. If you drag instead, Alt keeps its usual meaning: an inverted stroke on the active SubTool, or a pan when you start off the model."},{"p":"subtools.html","c":"SubTools","a":"add-a-subtool","h":"Add a SubTool","t":"Click Append and choose: Sphere, Cube or Plane: a new primitive placed beside the visible model (to the right, on +X), sized to about a third of the largest visible SubTool. From file...: a model (.obj, .fbx, .glb, .gltf, .ply, .stl, .GoZ, .usda, .usd, .usdz) or a project (.sfproj). A file with several objects adds one SubTool per object. The new SubTool becomes the active one. You can also add files as SubTools from elsewhere: Import in the Tool palette header (or File > Import) adds a model file as a new SubTool. In the LightBox Tool tab, Shift+double-click a model, or right-click it and choose Append as SubTool. Tip: Duplicate copies the active SubTool with its layers and attributes, names it copy and puts it right under the original. Use it to keep a safe copy before a destructive step such as a remesh."},{"p":"subtools.html","c":"SubTools","a":"show-hide-and-solo","h":"Show, hide and solo","t":"The eye on each row shows or hides that SubTool. Solo shows only the active SubTool. Click it again to bring the others back. The Solo button on the right shelf does the same. Unhide all shows every SubTool. Hidden SubTools aren't drawn, can't be selected with Alt+click, and are left out of exports. Note: SubTool visibility is different from hiding part of a mesh with polygroups or a rectangle. That hides faces inside one SubTool; see Polygroups and visibility."},{"p":"subtools.html","c":"SubTools","a":"reorder-subtools","h":"Reorder SubTools","t":"The up and down arrow buttons under the list move the active SubTool one place up or down. The order matters for Merge down and is the order objects are written to files."},{"p":"subtools.html","c":"SubTools","a":"merge-subtools","h":"Merge SubTools","t":"Merge down... merges the active SubTool with the one below it. Merge visible... merges every visible SubTool into one new SubTool called Merged. Hidden SubTools stay as they are. Merging keeps every attribute, gives each original mesh its own polygroups (so you can split them again later) and matches sculpt layers by name. The merged SubTool starts with an empty undo history. A SubTool with subdivision levels is merged (or split) at the level it is on, which becomes the base of the result; the status line names the SubTools that lost their levels. Painted textures are kept too: the merged SubTool gets new Auto UVs and one texture, the size of the largest, holding each part's paint exactly (texture layers are flattened; parts without a texture are white). On big meshes the Auto UV takes a while. Scripts can skip it with keep_texture=false, which drops the textures. Tip: Merge first when you want one voxel remesh to fuse several pieces into a single watertight surface."},{"p":"subtools.html","c":"SubTools","a":"split-a-subtool","h":"Split a SubTool","t":"Split groups makes one SubTool per polygroup. It is available when the active SubTool has more than one polygroup. Split parts makes one SubTool per disconnected piece, largest first. Both replace the active SubTool with the pieces. Because a merge keeps each original mesh in its own polygroup, Split groups undoes a merge."},{"p":"subtools.html","c":"SubTools","a":"delete-a-subtool","h":"Delete a SubTool","t":"Click Delete... (or right-click a row > Delete...) and confirm. The last SubTool can't be deleted, and a delete can't be undone."},{"p":"subtools.html","c":"SubTools","a":"subtools-in-files","h":"SubTools in files","t":"Format What happens to SubTools Project (.sfproj) Every SubTool is saved with its name, visibility, attributes, layers and active layer OBJ Each visible SubTool is an o object; on import, o objects become SubTools and g groups become polygroups glTF / GLB One node and mesh per visible SubTool, both ways FBX One model per visible SubTool (with LODs, an LOD group each), both ways USD One Mesh prim per visible SubTool, both ways GoZ Each visible SubTool is sent to ZBrush as its own SubTool PLY, STL, splat conversion The visible SubTools are merged into one mesh Opening a multi-object file replaces the scene with one SubTool per object. See Exporting for the details of each format."},{"p":"subtools.html","c":"SubTools","a":"scripting","h":"Scripting","t":"Every SubTool action is a command, so you can use them in the console, scripts, Python and MCP agents. SubTools are addressed by index (0 is the top of the list) or name; without either, the active one is used. Command What it does subtool_list List the SubTools subtool_select index=1 Make a SubTool active subtool_append type=cube Add a primitive (sphere, cube, plane); path= adds a file; size= (0.05-2, default 0.35) subtool_duplicate Copy a SubTool subtool_delete name=Helmet Delete a SubTool subtool_rename to=Body Rename a SubTool subtool_visibility visible=false Show or hide (toggles when visible is left out) subtool_solo / subtool_show_all Solo the active SubTool / show every SubTool subtool_move direction=up Move a SubTool up or down the list subtool_merge_down / subtool_merge_visible Merge subtool_split_groups / subtool_split_parts Split subtool_append type=sphere name=EyeL size=0.12; subtool_duplicate; subtool_rename to=EyeR"},{"p":"subtools.html","c":"SubTools","a":"see-also","h":"See also","t":"Polygroups and visibility: hide parts of one SubTool Sculpt layers and blend shapes: layers belong to each SubTool Exporting: how SubTools reach other applications Projects, autosave and QuickSave"},{"p":"polypaint.html","c":"Polypaint and materials","a":"","h":"Polypaint and materials","t":"Polypaint stores a colour on every vertex of the mesh, so you can paint a sculpt without UVs or textures, as in ZBrush. This chapter covers the Paint brush, painting while you sculpt, fills and cavity paint, picking colours, paint layers with blend modes, and the MatCap materials that change how the model is shaded in the viewport."},{"p":"polypaint.html","c":"Polypaint and materials","a":"how-polypaint-works","h":"How polypaint works","t":"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. Subdivide or remesh at a higher resolution before fine painting. Painting respects the mask (masked areas keep their colour) and skips hidden faces. Symmetry works for painting as it does for sculpting. Polypaint is per SubTool and is saved in projects. It is exported as vertex colours to PLY, glTF/GLB, OBJ, USD (displayColor) and GoZ. FBX export doesn't include it. A mesh starts without polypaint. The first paint stroke or fill adds it (white everywhere you haven't painted). Texture painting: to paint finer than the mesh, give the SubTool a texture and paint into it instead; the Paint brush, fills and paint layers work the same way. Polypaint > Texture bakes polypaint into a texture. See Texture painting."},{"p":"polypaint.html","c":"Polypaint and materials","a":"paint-with-the-paint-brush","h":"Paint with the Paint brush","t":"Press P, click Paint on the top shelf, or pick Paint on the bottom shelf. Choose a colour (see below). Stroke over the model. Draw Size, the stroke type and the alpha work as they do for sculpting; RGB Intensity (I) sets how strongly the colour goes on. While the Paint brush is active: Alt paints back towards white. Shift still smooths the shape, as in ZBrush. The surface isn't changed. Press P again, or click Sculpt on the top shelf, to go back to sculpting. Polypaint on a sculpt with the Color palette open ZBrush: Paint is ZBrush's Rgb on with Zadd off. Sculpt with Rgb on is Rgb with Zadd: the brush sculpts and paints at once."},{"p":"polypaint.html","c":"Polypaint and materials","a":"paint-while-sculpting","h":"Paint while sculpting","t":"Turn on Rgb on the top shelf (or RGB while sculpting in the Color palette). Every sculpt brush then also paints the current colour along its stroke. The Smooth brush and Shift-smoothing never paint."},{"p":"polypaint.html","c":"Polypaint and materials","a":"choose-a-colour","h":"Choose a colour","t":"The left shelf has a colour picker (a square plus a hue strip), two swatches and a Fill button. Clicking the second swatch swaps it with the main colour, like ZBrush's Alternate. The Color palette 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. Press C with the cursor over the model to pick the colour under it (the mesh needs polypaint for this, or a texture while painting into the texture)."},{"p":"polypaint.html","c":"Polypaint and materials","a":"fill-cavity-paint-and-clear","h":"Fill, cavity paint and clear","t":"The Color palette has four buttons: Button What it does Fill Fills the unmasked area with the colour (the whole mesh when nothing is masked). Same as Fill on the left shelf Fill masked Fills only the masked area. Available when the mesh has a mask Cavity Darkens the creases and cavities with a dark brown, respecting the mask. A quick way to bring out detail Clear Removes all polypaint from the active SubTool All of them are undoable. Show polypaint in the same palette (or Paint on the right shelf) turns the colours off in the viewport without deleting them. Tip: To paint a base colour and then dirt in the creases: Fill with the base colour, then Cavity. For a different cavity colour or strength, use the command (below)."},{"p":"polypaint.html","c":"Polypaint and materials","a":"paint-layers","h":"Paint layers","t":"Paint layers stack polypaint the way Photoshop stacks image layers. Each layer has its own name, visibility, opacity and blend mode, 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 SubTool has its own stack. Tool > Paint Layers: Base, a Multiply dirt layer, a Soft Light tint and an empty Normal layer"},{"p":"polypaint.html","c":"Polypaint and materials","a":"how-paint-layers-work","h":"How paint layers work","t":"Base is the bottom layer: the SubTool's polypaint, always opaque. With only Base, polypaint works exactly as it did before, and nothing changes in your files. Layers above Base start transparent. Painting on a layer adds colour and coverage: where you haven't painted, the layer is see-through. Painting never touches the layers you aren't on. 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. 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. The Paint brush, Rgb while sculpting, Fill, Fill masked and Cavity all write into the active layer (highlighted in the list; the Color palette shows \"Painting on: ...\"). They respect the mask and hidden faces on every layer. With the Paint brush on a layer, Alt erases the layer's paint (on Base it paints back towards white, as before). A hidden or locked layer can't be painted, filled or cleared; the status line says why."},{"p":"polypaint.html","c":"Polypaint and materials","a":"blend-modes","h":"Blend modes","t":"Mode Effect Normal The layer's colour covers what is below Multiply Darkens: dirt, shadows, cavity grime. White does nothing Screen Lightens: highlights, glow, dust. Black does nothing Overlay Adds contrast and tints the midtones. 50% grey does nothing Soft Light A gentler Overlay, good for skin tints and colour variation Add Adds the colours (Photoshop's Linear Dodge); strong highlights Subtract Subtracts the layer's colour Darken / Lighten Keeps the darker / lighter colour, channel by channel Difference The difference between the colours; useful for checking two paint passes against each other"},{"p":"polypaint.html","c":"Polypaint and materials","a":"the-paint-layers-sub-palette","h":"The Paint Layers sub-palette","t":"Open Tool > Paint Layers in the right tray (it sits under the sculpt Layers 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. Click a row to paint on that layer. Double-click it to rename. Right-click for Rename, Duplicate, Merge down, Clear and Delete. The eye shows or hides the layer; the lock protects it from painting, fills, clears and merges. Under the list: the active layer's blend mode and Opacity slider. The opacity previews live while you drag and is one undo step when you let go. New adds a transparent layer above the active one. Duplicate copies the active layer (Base becomes an opaque layer). Delete removes the active layer. The arrows move the active layer up or down. Merge down merges it into the layer below (into Base for the lowest layer). Flatten bakes every visible layer into Base and removes the layers; hidden layers are discarded. Clear layer makes the active layer transparent again (Base: white). Fill layer fills it with the current colour, like Fill in the Color palette. Hold Ctrl over any control for its description. Every action is undoable with Ctrl+Z. Tip: 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":"polypaint.html","c":"Polypaint and materials","a":"paint-layers-and-sculpt-layers","h":"Paint layers and sculpt layers","t":"They are separate stacks. Tool > Layers holds sculpt layers: shape changes exported as blend shapes. Tool > Paint Layers holds colour. Selecting a sculpt layer doesn't change the paint layer you paint on, and the other way round, so a stroke with Rgb on can sculpt into the \"Smile\" layer and paint into the \"Blush\" layer at once."},{"p":"polypaint.html","c":"Polypaint and materials","a":"files-subtools-and-geometry","h":"Files, SubTools and geometry","t":"Paint layers are saved in projects (.sfproj) with their names, blend modes, opacity, visibility, lock and the active layer. Older versions of SculptForge open these projects with the paint flattened. Exports (OBJ, PLY, glTF/GLB, USD, GoZ) write the composited colours, exactly what the viewport shows. Duplicating a SubTool copies its layers, and Split keeps them on each piece. Subdividing and decimating keep them too. Merging SubTools, a voxel remesh and other rebuilds keep the look but flatten the layers into Base. ZBrush and Mudbox: ZBrush's polypaint layers only have opacity. Here every layer also has a blend mode, its own coverage and a lock, like the paint layers in Mudbox and Photoshop."},{"p":"polypaint.html","c":"Polypaint and materials","a":"materials-matcaps","h":"Materials (MatCaps)","t":"Materials change only how the model is shaded in the viewport. They aren't exported and don't change polypaint. Material Look Sculpt The default, 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 Red Wax Glossy deep red wax, the classic sculpting look Clay Matte grey-brown clay Skin Warm, soft skin tones Chrome Mirror-like metal, good for checking surface flow White Neutral off-white for judging forms Bronze Polished bronze Studio Softer clay shading with studio lighting (the default in earlier versions). Its colour is Base colour in the Material palette To choose one: Press M for the material picker under the cursor, or click the Material tile on the left shelf. Point at a material to preview it on the model, click to keep it. Esc or clicking away puts the previous material back. Open the Material palette, or the Material tab of the LightBox. The material picker with the seven MatCaps and Studio Polypaint 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. Tip: Sculpt is the material to judge strokes with. The prettier ones (Skin, Red Wax) soften small detail; switch to them for presenting. Not yet: loading your own MatCap images, and physically based materials or BPR-style renders."},{"p":"polypaint.html","c":"Polypaint and materials","a":"scripting","h":"Scripting","t":"Command What it does set_color color=#c08060 Set the paint colour: rrggbb, #rrggbb (quote it in scripts), r,g,b or a name such as white, skin, bone paint_fill area=unmasked Fill; area is unmasked (default), masked or all; strength 0-1 paint_from_cavity color=#202020 strength=0.7 smoothing=2 Cavity paint (defaults: dark brown, 0.7, 2 blur passes) paint_clear Remove all polypaint, paint layers included paint_layer_add name=Dirt blend=multiply opacity=0.8 Add a paint layer above the active one and paint on it paint_layer_set index=0 opacity=0.5 blend=overlay visible=false locked=true name=Grime Change a layer (layer=Dirt picks it by name; default: the active layer) paint_layer_select layer=Base Paint on another layer (index=-1 is Base, 0 the first layer above it) paint_layer_duplicate, paint_layer_delete, paint_layer_clear Copy, delete or clear the active (or given) layer paint_layer_move direction=up Move a layer up or down the stack paint_layer_merge / paint_layer_flatten Merge down / bake every visible layer into Base paint_layer_list List the layers, top first (* marks the active one) set_material name=Chrome Viewport material: a MatCap name (Sculpt is the default) or studio (desktop app only) 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"},{"p":"polypaint.html","c":"Polypaint and materials","a":"see-also","h":"See also","t":"Masking: protect areas from painting Sculpt layers and blend shapes: the shape counterpart of paint layers Sculpting and brushes: Draw Size, Focal Shift, strokes and alphas also apply to painting Exporting: which formats carry vertex colours"},{"p":"texture-painting.html","c":"Texture painting","a":"","h":"Texture painting","t":"Texture painting puts the colour into an image laid over the model's UVs, instead of on its vertices. The detail you can paint then comes from the texture's resolution, not from how dense the mesh is: a 4K texture on a light, game-ready mesh holds pores, freckles and sharp decals that polypaint could only show on millions of polygons. Everything you know from polypaint still applies: the same Paint brush, colours, fills, symmetry, mask and paint layers with blend modes. Texture painting: a sharp texture stroke above a soft polypaint stroke, with the UV view in Tool > Texture Map"},{"p":"texture-painting.html","c":"Texture painting","a":"start-in-one-click","h":"Start in one click","t":"Press P for the Paint brush (or turn on Rgb). While the SubTool has no texture, New Texture appears on the top shelf and in the Color palette. Click it: if the model has no UVs, SculptForge runs Auto UV first (in the background; the status bar shows its progress), then gives it a white texture (2K, or the size chosen in Tool > Texture Map) and switches painting to Texture. Paint away. The steps below do the same thing by hand, with more choices."},{"p":"texture-painting.html","c":"Texture painting","a":"paint-a-texture-in-four-steps","h":"Paint a texture in four steps","t":"Open Tool > Texture Map in the right tray. If the SubTool has no UVs (the sub-palette says \"No UVs\"), click Auto UV. SculptForge cuts the model into UV islands and packs them into the texture square. It works in the background with a progress bar; on a few hundred thousand triangles it takes seconds, on millions it can take a minute or more. Models imported with UVs (from ZBrush, Maya, Blender...) already have them: skip this step. Choose a size (1K, 2K, 4K or 8K; 2K is the default) and click New Texture. The model now carries a white texture, and painting goes into it: Texture lights up next to Vertex on the top shelf. Press P and paint. Draw Size, RGB Intensity, pen pressure, the stroke type, the alpha, symmetry and the mask work as they do for polypaint. Click Show UVs to see the texture with the UV layout drawn over it, below the buttons. Paint on the model and watch the texture fill in."},{"p":"texture-painting.html","c":"Texture painting","a":"vertex-or-texture","h":"Vertex or Texture","t":"When a SubTool has a texture, Vertex and Texture appear on the top shelf next to Rgb (and in the Color, Paint Layers and Texture Map palettes). They choose where paint goes: Texture: the Paint brush, Rgb while sculpting, Fill, Fill masked, Cavity, Clear and the Paint Layers palette work on the texture. Vertex: they work on the polypaint, exactly as before. The model shows both: the polypaint multiplied by the texture, over the material. If paint looks as coarse as the mesh's polygons, it is going into the vertices: check that Texture is lit, and that the SubTool carries no old polypaint (Tool > Paint Layers, or Polypaint > Texture to move it into the texture). Texture paint itself is as sharp as the texture: a hard alpha gives the same texels on a two-triangle plane as on a dense mesh. Each SubTool keeps its own choice, saved in the project. Show texture (Texture Map, or the Color palette) hides the texture in the viewport without deleting it."},{"p":"texture-painting.html","c":"Texture painting","a":"how-texture-painting-works","h":"How texture painting works","t":"Each texel under the brush gets its 3D position on the surface, so the falloff, the alpha and the brush size are the same as for polypaint, and a stroke looks the same whatever the UV layout. Front faces only: the brush never paints through a thin part onto its far side, and never on surfaces facing away from you. The mask keeps masked areas as they are, and hidden faces are never painted. Symmetry paints the mirrored side too, even where the two sides have different UV islands. Around every UV island the paint runs on a few texels into the empty space (padding), so seams don't show as thin lines when the texture is filtered or mipmapped. One stroke is one undo step. SculptForge stores only the 64x64-texel tiles the stroke touched, so undo stays light even on an 8K texture. Layer edits (new layer, fill, clear, merge, flatten, delete) also keep only the tiles they changed, and an empty or single-colour tile costs almost nothing. Only an edit that changes a whole painted layer at once, like clearing a fully painted Base, stores the full layer. Alt paints back towards white on Base, and erases on a paint layer, as with polypaint. C over the model picks the texture's colour under the cursor. Tip: Painting stays fast with big textures on big meshes: only the triangles under the brush are visited, the texels are painted on every core, and only the changed 64x64 tiles of the texture are sent to the graphics card. A big brush on a 4K texture takes a few milliseconds per dab. Memory is the limit: a 4K texture takes 64 MB per layer, an 8K texture 256 MB."},{"p":"texture-painting.html","c":"Texture painting","a":"paint-layers-on-a-texture","h":"Paint layers on a texture","t":"Tool > Paint Layers works on the texture's own stack while painting goes into the texture: new layers, blend modes, opacity, visibility, lock, Merge down, Flatten, Clear and Fill layer behave exactly as described in Paint layers. Switch to Vertex and the palette shows the polypaint layers again; the two stacks are separate."},{"p":"texture-painting.html","c":"Texture painting","a":"convert-between-polypaint-and-texture","h":"Convert between polypaint and texture","t":"Button What it does Polypaint > Texture Bakes the polypaint (all its layers, as shown) into the active texture layer. Makes a 2K texture if there is none Texture > Polypaint Sets the polypaint of every vertex to the texture's colour under it. Detail finer than the mesh is lost; vertices on a UV seam take the average of both sides Both are undoable. Polypaint > Texture is a quick way to move an existing polypainted sculpt onto a game mesh's texture after giving it UVs."},{"p":"texture-painting.html","c":"Texture painting","a":"import-and-export","h":"Import and export","t":"Export Texture... saves the texture (every visible layer composited) as a PNG. Import Texture... loads a PNG, JPEG, TGA, BMP or PSD as the SubTool's texture (it replaces the texture's layers; undoable). The image is laid on the UVs as it is, so a texture made for these UVs in another app lines up. Projects (.sfproj) save the texture with all its layers, blend modes and settings. Exporting the model writes the texture next to it as a PNG and references it, so other apps pick it up: OBJ writes a .mtl material with map_Kd; glTF/GLB embeds it as the base colour texture; USD binds a preview material that reads it; FBX and GoZ export write the PNG beside the file. See Exporting. Delete Texture removes it (undoable); painting goes back to the vertices."},{"p":"texture-painting.html","c":"Texture painting","a":"uvs-and-geometry","h":"UVs and geometry","t":"Auto UV replaces any existing UVs. If the SubTool already has a painted texture, the paint moves with it: every texel of the new layout takes the colour of the same point of the surface from the old one, for the Base and every texture layer (with their blend modes, opacity and names), and the islands get a padded border. It is one undo step: undo brings back the old UVs and the old texture exactly. Moving a 4K texture takes a fraction of a second on a million triangles (the unwrap itself takes longer; see below). The paint is resampled once, so very fine detail softens slightly (well under one texel). Subdividing, decimating, splitting and duplicating keep the UVs, so the texture stays on. Decimate leaves the vertices on UV seams in place, so the texture stays exact across seams. Keep Texture (on by default, shown under Tool > Remesh and Tool > Geometry > QRemesh when the SubTool has a texture): a voxel remesh or QRemesh builds a new surface without UVs, so SculptForge unwraps the result with Auto UV and projects the texture onto it from the old surface (each new texel takes the colour of the closest point of the old one), keeping every layer. It is part of the same undo step. It adds the time of an Auto UV of the result, so a voxel remesh of a painted SubTool runs in the background with a progress bar and Cancel. Turn it off to drop the texture instead (the status line says so). Paint finer than the new surface's detail is kept, since it lives in the texture. Merging SubTools keeps their textures: the merged SubTool gets Auto UVs and one texture (the size of the largest) holding each part's paint, with the texture layers flattened. Parts without a texture come out white. Auto UV on dense meshes: the islands are kept to about 4,000 triangles each, so a million-triangle sculpt unwraps in a quarter of a minute or so and gets a few hundred islands. UVs outside the 0-1 square (tiles, UDIMs) aren't painted. ZBrush: ZBrush paints polypaint and converts it to a texture afterwards (Texture Map > New From Polypaint). SculptForge can do both: paint the texture directly, or bake polypaint with Polypaint > Texture. Auto UV plays the part of UV Master's Unwrap."},{"p":"texture-painting.html","c":"Texture painting","a":"scripting","h":"Scripting","t":"Command What it does uv_auto Unwrap the active SubTool (xatlas); resolution=4096 packs the islands for that texture size. A painted texture moves onto the new UVs (keep_texture=false leaves it as it was) texture_create size=2048 Give the SubTool a texture (1024, 2048, 4096, 8192 or 1k...8k) and paint into it; from_polypaint=true starts from the polypaint paint_target target=texture Where painting goes: vertex or texture texture_from_polypaint Bake the polypaint into the active texture layer polypaint_from_texture Copy the texture into the polypaint texture_export path=skin.png Save the texture as a PNG texture_import path=skin.png Load an image as the texture texture_delete Remove the texture remesh, qremesh, subtool_merge_down and subtool_merge_visible keep a texture unless you add keep_texture=false. paint_fill, paint_from_cavity, paint_clear and every paint_layer_* command work on the texture while paint_target is texture. See Scripting and automation."},{"p":"layers.html","c":"Sculpt layers and blend shapes","a":"","h":"Sculpt layers and blend shapes","t":"Sculpt layers hold changes on top of the base mesh, each with its own weight: a smile, a blink, a corrective shape or a variation you want to dial in and out. Because a layer is a set of per-vertex offsets, it exports straight to game engines and DCC tools as a blend shape (morph target). This chapter covers creating, sculpting into, weighting, playing and exporting layers."},{"p":"layers.html","c":"Sculpt layers and blend shapes","a":"how-layers-work","h":"How layers work","t":"Each layer stores how far every vertex moves from the base. The shape you see is the base plus every layer times its weight. New strokes go into the active layer, or into the base mesh when Base mesh is selected. Layers belong to a SubTool: each SubTool has its own list of layers. A weight of 0 turns a layer off, 1 shows it as sculpted. Scripts can also set negative weights or weights above 1 to exaggerate a shape. Layers work on every subdivision level, like ZBrush's 3D Layers: see Layers and subdivision levels. Layers survive subdividing, decimating and LOD chains. A voxel remesh bakes them into the surface (the layers are gone afterwards). Note: Sculpt layers are not the Layer brush. The Layer brush raises the surface to a fixed height; sculpt layers are the blend-shape stack described here."},{"p":"layers.html","c":"Sculpt layers and blend shapes","a":"the-layers-sub-palette","h":"The Layers sub-palette","t":"Open Tool > Layers in the right tray. The Layers sub-palette with a base mesh and two blend shapes From top to bottom: Base mesh: select it to sculpt the base shape. One block per layer: a radio button with the layer's name (select it to sculpt into that layer), Play, X (delete) and a weight slider from 0 to 1. A name field and + Add at the bottom. The title strip shows the active layer (Layer Smile, or Layer Base)."},{"p":"layers.html","c":"Sculpt layers and blend shapes","a":"add-a-layer-and-sculpt-into-it","h":"Add a layer and sculpt into it","t":"Type a name in the field at the bottom of Tool > Layers, for example Smile or BlinkL. Click + Add (or press Enter in the field). The new layer becomes the active one. Sculpt. Every stroke goes into the layer until you select another layer or Base mesh. A layer whose weight is 0 can't be sculpted into: SculptForge tells you to raise the weight first. Tip: Name layers the way your engine or rig expects (jawOpen, BlinkL): the names become the blend shape and morph target names in exported files. For a face, Tool > Facial Shapes makes all 52 ARKit shapes for you: see Facial shapes and live face."},{"p":"layers.html","c":"Sculpt layers and blend shapes","a":"adjust-and-preview-weights","h":"Adjust and preview weights","t":"Drag a layer's weight slider to blend it in and out. Play animates the layer from 0 to 1 and back, over and over, so you can judge the motion. Click Stop to end it; the weight returns to 1. Starting a stroke also stops playback. Weights are saved with the project and used by exports that keep weights (USD writes the current weights)."},{"p":"layers.html","c":"Sculpt layers and blend shapes","a":"delete-a-layer","h":"Delete a layer","t":"Click X next to the layer. Its offsets are removed from the mesh and the base mesh becomes the active target. Deleting a layer is undoable."},{"p":"layers.html","c":"Sculpt layers and blend shapes","a":"layers-and-subdivision-levels","h":"Layers and subdivision levels","t":"With subdivision levels a layer works the way ZBrush's 3D Layers do: record it at the top level for the fine detail of an expression, and it stays with the SubTool whatever level you work on. Each layer has its own detail on every level. Step down with Lower Res (Shift+D) and a lower level shows the broad part of the layer, exactly as it would show the same strokes made in the base. Step back up and the layer is there as you recorded it, to the last vertex. Weights are shared by all levels. Turn a layer off (weight 0) or blend it at a low level and the top shows the same when you go back up; the slider and Play work at every level. Sculpt into a layer at any level. At a low level a stroke into a layer makes a broad change that the higher levels follow smoothly; the detail recorded above it stays. A layer added at a low level shows on every level above it too. Reshape the base at a low level (or turn it with the Gizmo 3D) and each layer's detail rides on the new shape: its offsets turn with the surface instead of pointing the old way. Divide carries the layers to the new level. Reconstruct Subdiv keeps them, exact at the top. Del Lower and Del Higher keep the current level's layers as they are. Deleting a layer removes it from every level. Undo steps back through strokes, level changes and divisions with their layers. Projects keep every level's layers. Exports write the current level with its layers as blend shapes, so export from the top for the game mesh; subdiv_export path=face_low.glb level=1 writes the base cage with its blend shapes instead. The tools that rebuild the mesh (Voxel Remesh, QRemesh, Decimate, Subdivide) work on the current level and drop the levels, as described in Subdivision levels; Voxel Remesh and QRemesh bake the layers into the surface."},{"p":"layers.html","c":"Sculpt layers and blend shapes","a":"export-blend-shapes","h":"Export blend shapes","t":"Format What layers become glTF / GLB (File > Export GLB..., Ctrl+E) Morph targets FBX Blend shapes USD / USDZ UsdSkel blend shapes, with their current weights Send to Unreal / Export FBX for Unreal A skeletal mesh with morph targets LOD chain Blend shapes are kept on every LOD Project (.sfproj) Everything: layers, weights and the active layer OBJ, PLY, STL The current blended shape only Importing works the other way: glTF morph targets and FBX or USD blend shapes open as sculpt layers. See Exporting. ZBrush: Layers here are close to ZBrush's 3D Layers with the slider used as a morph, and they follow subdivision levels the same way. Selecting a layer is its REC; a weight of 0 is its eye. There are no layer folders and no per-layer mask yet."},{"p":"layers.html","c":"Sculpt layers and blend shapes","a":"scripting","h":"Scripting","t":"Command What it does layer_add name=Smile Add a layer and make it active layer_set_active index=0 Choose the layer strokes go into (-1 = base mesh) layer_set_weight index=0 weight=0.5 Set a layer's weight (negative or above 1 exaggerates) layer_remove index=0 Delete a layer Layers are addressed by index, starting at 0 for the top layer. layer_add name=jawOpen; stroke points=\"0,-0.3,1 0,-0.5,1\" brush=Inflate; export_glb path=head.glb"},{"p":"layers.html","c":"Sculpt layers and blend shapes","a":"see-also","h":"See also","t":"SubTools Subdivide, remesh, decimate and LODs Exporting: glTF morph targets, FBX blend shapes, Send to Unreal"},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"","h":"Facial shapes and live face","t":"Generate Facial Shapes gives a sculpted head the 52 blend shapes Apple ARKit and Google's MediaPipe use for face capture (eyeBlinkLeft, jawOpen, mouthSmileRight and the rest), fitted to that head's own proportions. They are ordinary sculpt layers: you fix any of them by sculpting, test them with expression presets, export them as morph targets to a rig, a game engine or Blender, and drive them live, so the character makes your expressions. Tool > Facial Shapes, with the template head smiling"},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"what-you-need","h":"What you need","t":"A humanoid head (human or stylised) as the active SubTool, its face pointing at the front view (+Z) with Y up, as SculptForge's front view shows it. A bust with shoulders is fine. Separate SubTools for the eyes, teeth and tongue, if the sculpt has them (see SubTools). Nothing to download: the template head the shapes come from is built into SculptForge. To try it on a ready-made head, type new_head in the console (`): a life-size human head with a mouth and eye sockets, and its eyes as a second SubTool."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"generate-the-shapes","h":"Generate the shapes","t":"Select the head SubTool and open Tool > Facial Shapes. Click Generate Facial Shapes. It takes a second or two (more on millions of vertices). The status line says how well the template fitted: the fit error (as a share of the head's height; under 1% is good) and how much of the template's face found the sculpt. Tool > Layers now lists the 52 shapes, all at weight 0, so the sculpt looks unchanged. Generating again replaces the 52 layers (other layers stay). Undo brings back the previous ones, together with any fixes you had sculpted into them."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"options","h":"Options","t":"Symmetry: Auto makes each Left / Right pair exact mirror images when the sculpt is symmetric about X = 0; On always mirrors (a slightly asymmetric sculpt gets the average); Off keeps each side as fitted. SubTools too: also give the other SubTools the shapes they need (below)."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"how-it-works","h":"How it works","t":"SculptForge carries a template head with all 52 shapes: the ICT Face Model Light from ICT-FaceKit by the USC Institute for Creative Technologies, under the MIT licence (free for commercial work: studios can ship what it makes). Generating: Finds the face. Without landmarks it looks for the nose tip (the most forward point near the middle) and the head's height, then lines the template's face up with the sculpt's (rotation, scale and position). Wraps the template around the sculpt (non-rigid registration): the template is pulled onto the closest points of the sculpt, stiffly at first and then more and more loosely, so it takes the sculpt's shape without tearing. Transfers each shape with deformation transfer: each small piece of the template's surface moves in the shape the way it moves on the template, rebuilt on the fitted template. A wide face gets a wide smile, a long jaw a long jaw drop. Binds the sculpt to the fitted template: every vertex near the face follows the closest point of the template, so your sculpted detail (wrinkles, pores) rides along. Vertices away from the face (the back of a bust, the shoulders) don't move. Left and Right are the character's own: eyeBlinkLeft closes the character's left eye, which is on your right in the front view. That is what ARKit and MediaPipe mean."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"landmarks","h":"Landmarks","t":"If the fit goes wrong (a strongly stylised face, a head turned a lot, a bust whose shoulders stick out further than the nose), guide it with landmarks: Landmarks found on the marble bust: eye corners, nose tip, mouth corners Click Auto Landmarks to see where the automatic fit puts the eye corners, the nose tip, the mouth corners and the chin. Click Place Landmarks. The canvas asks for each landmark in turn (right eye outer corner, right eye inner corner, left eye inner, left eye outer, nose tip, right mouth corner, left mouth corner, chin): click it on the sculpt. To move one, click its dot, then its new place. Click Generate Facial Shapes. With 3 or more landmarks the fit starts from them and pulls the template's landmarks onto yours; all 8 fit best. Clear removes them (the fit is automatic again). Landmarks aren't saved with the project."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"subtools","h":"SubTools","t":"With SubTools too on, the other visible SubTools get shapes by their names: SubTool name contains It gets eye (not lash, brow or lid) the 8 eyeLook... shapes: each eye turns about its own centre (about 30 degrees sideways, 25 up or down). One SubTool may hold both eyes. teeth, tooth, gum or jaw the jaw shapes (jawOpen, jawLeft, jawRight, jawForward, tongueOut): the part below the bite moves with the lower jaw, the upper teeth stay. tongue the jaw shapes, and tongueOut pushes it out past the lips. anything else that sits on the face (brows, lashes, a beard, a moustache) the shapes that move the skin under it. SubTools that aren't on the face get none. The eyes' shapes are rotations stored as blend shapes, so halfway (weight 0.5) an eye is a little smaller than a true rotation would leave it, as with any blend-shape eye. Rigs that turn eyes with bones can ignore those shapes."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"mouth-and-eyes-what-to-expect","h":"Mouth and eyes: what to expect","t":"An open or slit mouth (the lips separate surfaces, ideally with a mouth bag behind them) opens cleanly: jawOpen drops the lower lip and the chin, mouthFunnel and mouthPucker shape the lips. A closed mouth sculpted as one continuous surface can't open: the shapes that part the lips move the lower lip and stretch the skin between the lips like a membrane. Cut the mouth first (sculpt a slit, or start from new_head, which has a mouth bag), or sculpt the fix into jawOpen. Eyelids close over the eyeballs in eyeBlinkLeft / eyeBlinkRight when the eyes are a separate SubTool. Eyes sculpted into the head's own surface (one mesh) would be pulled along by the lids: split them into their own SubTool first (Split parts). mouthClose is meant to be used with jawOpen: it closes the lips while the jaw is open (the ARKit convention). On its own it pushes the lips through each other. tongueOut: the template has no tongue shape, so on the head it opens the jaw a little; a tongue SubTool moves out."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"fix-a-shape-by-sculpting","h":"Fix a shape by sculpting","t":"The shapes are a starting point, like a rigger's first pass. To fix one: In Tool > Layers, select its layer (the radio button with its name). Set its weight to 1 (its slider here or in Tool > Layers) and the other shapes to 0 (Neutral below). Sculpt: every stroke goes into that shape. Use X symmetry for a centre shape; for a Left / Right pair, fix one and regenerate with Symmetry on only if you haven't fixed the other side yet."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"face-test","h":"Face test","t":"Under Face test: Presets show common expressions built from the shapes: Neutral, Smile, Grin, Surprise, Anger, Sad, Disgust, Fear, Blink, Wink, Kiss, Aah, Ooh, Puff, Look left, Tongue out. Preset amount sets how strongly. Eyes, Brows, Jaw, Mouth, Cheeks & nose, Tongue open a slider per shape. A slider drives the shape of that name on every SubTool (the eyes turn with eyeLookUpLeft). Neither creates undo steps. The weights are saved with the project and written to exports (as the default pose)."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"all-52-shapes","h":"All 52 shapes","t":"Each shape at weight 1 on the template head (new_head) and on a real sculpture, \"Marble Bust 01\" by Rico Cilliers (Poly Haven, CC0), straight out of Generate Facial Shapes, without any fixes: Every ARKit shape on the template head Every ARKit shape on the marble bust"},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"live-face","h":"Live face","t":"face_weights sets shape weights from a JSON object, fast enough for a live feed (30 or more calls a second): face_weights json={\"jawOpen\":0.4,\"eyeBlinkLeft\":1,\"mouthSmileRight\":0.6} It changes only the vertices those shapes move, re-uploads only those to the graphics card, makes no undo step and doesn't mark the project as changed. Names not given keep their weight; unknown names are reported. The whole face message from a phone, {\"type\":\"face\",\"t\":...,\"weights\":{...},\"head\":[...]}, works as the JSON too. On a 700,000 vertex head whose every vertex is face, a frame that changes all 52 weights takes about 9 ms on an M1 Pro (most of it updating normals); heads with a body or shoulders change only the face. The phone link points your phone's camera at your face and sends this feed, so the character makes your expressions (see the phone link's own chapter). Anything else that produces ARKit or MediaPipe blendshape weights can drive it too: a script (Scripting and automation), the MCP server or the Python module."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"takes","h":"Takes","t":"A take is a recorded face feed: the phone link saves one as JSON frames, or write your own. Load Take... plays a take on the shapes, looping (Loop), with Play / Pause. Accepted: a JSON array of face messages, an object with a \"frames\" array, or JSON Lines (one message per line); \"t\" is in milliseconds. MediaPipe's \"blendshapes\": [{\"categoryName\": ..., \"score\": ...}] works too. Bake Take turns the loaded take into keyframes at 30 frames a second, kept in the project. Exports then carry the animation: GLB as a glTF animation of the morph target weights (Blender, three.js, Unity, Godot and Unreal play it), USD as time samples of the blend shape weights (Omniverse, Maya, Houdini, Blender). FBX exports the shapes but not the animation yet. Clear Baked Take removes it. From the console: face_take_play path=take.json, face_take_stop, face_take_bake path=take.json fps=30, face_take_clear."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"export-the-shapes","h":"Export the shapes","t":"The ARKit names are kept exactly in every format: Export The shapes become Animation (baked take) GLB (File > Export) morph targets, named in extras.targetNames glTF animation of the weights USD / USDZ UsdSkel blend shapes time samples on the SkelAnimation FBX (and Send to Unreal) blend shape channels; Unreal: morph targets on a skeletal mesh not yet Blender bridge (File > Blender > Send to Blender) shape keys, at their weights, on every object not yet Each SubTool exports as its own object with its own shapes (the eyes with their eyeLook shapes, the teeth with the jaw's). Apple's ARKit, Unreal's Live Link Face and most face-capture tools drive meshes by these names directly."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"commands","h":"Commands","t":"Command What it does face_shapes_generate [landmarks=] [symmetry=auto/on/off] [subtools=true] [level=N] Generate Facial Shapes on the active SubTool face_landmarks_detect the automatic landmarks, as the JSON landmarks= takes face_weights json= set shape weights (live) face_preset name=Smile [amount=1] show a preset face_take_play path= / face_take_stop play a take in the viewport (the app only) face_take_bake path= [fps=30] / face_take_clear bake a take for export / remove it new_head a new scene with the template head and its eyes"},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"subdivision-levels","h":"Subdivision levels","t":"On a SubTool with subdivision levels the shapes are made on the lowest level with at least 20,000 vertices (level= picks another), and the levels carry them up: at the top level the shapes bend your high-level detail along instead of flattening it."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"memory","h":"Memory","t":"Each shape is a full sculpt layer: 52 shapes add about 620 bytes per vertex (on top of what the mesh itself uses), so about 620 MB on a million-vertex head. Generate on a level of a million vertices or less and let the levels carry the shapes up."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"limits","h":"Limits","t":"The fit expects a humanoid head with the face pointing at the front view. Animals and creatures (the lion bust) fit poorly or not at all; landmarks help with stylised humans. Hair sculpted as part of the head moves with the brows and forehead; keep hair in its own SubTool. Landmarks are placed by hand or found by the fit itself; there is no image-based face detector."},{"p":"subdivision-levels.html","c":"Subdivision levels","a":"","h":"Subdivision levels","t":"Subdivision levels let you sculpt one model at several resolutions, as with ZBrush's SDiv: block in the big forms on a light version of the mesh, add pores and wrinkles on a dense one, and go back down to change the silhouette without losing the detail. Every SubTool has its own levels. A cube cage, a middle level and the top level of the same sculpt Everything is in Tool > Geometry: Control Shortcut What it does Divide Ctrl+D Adds a level above the highest one and steps to it Smt Smooths the next Divide (on by default) Lower Res Shift+D Steps one level down Higher Res D Steps one level up SDiv slider Steps to any level (1 is the base cage) Del Lower Deletes the levels below the current one Del Higher Deletes the levels above the current one Reconstruct Subdiv Finds a lower level for a mesh that was subdivided elsewhere Under the buttons the palette says where you are (\"SDiv 3 of 5\") and how many triangles the base and the top have. The SubTool list shows the level of every SubTool that has them (\"SDiv 3/5\")."},{"p":"subdivision-levels.html","c":"Subdivision levels","a":"divide","h":"Divide","t":"Divide (Ctrl+D) adds a level with four times the polygons. The lower levels stay, so you can step back down at any time. Quads stay quads. A mesh with quads is divided with Catmull-Clark subdivision: each quad becomes four quads, and a triangle among them becomes three quads. A mesh of triangles only (a sphere from New Sphere, a scan) is divided with Loop subdivision: each triangle becomes four. Smt (next to Divide) smooths the new level, rounding off the shape the way ZBrush does. Turn it off to divide flat: the new level keeps the hard edges and flat faces of the one below, for hard-surface pieces. Divide always adds the level on top. If you are at a lower level it steps to the highest first. Mask, polypaint, paint layers and UVs are interpolated onto the new level; polygroups and hidden faces carry over; sculpt layers are divided with the shape. How far you can divide depends on your computer's memory: about 160 million triangles with 32 GB (each triangle of a divided model takes about 90 bytes, plus some room while dividing). Divide says so when the next level wouldn't fit. Tip: Start from a light mesh. A cube of 108 triangles divided five times is a smooth 110,000-triangle head-sized blob; a 25,000-triangle base divided four times is already 6.5 million."},{"p":"subdivision-levels.html","c":"Subdivision levels","a":"stepping-between-levels","h":"Stepping between levels","t":"Press Shift+D to step down and D to step up, or drag the SDiv slider. Each step is instant once you have visited a level; the first visit after a big edit lower down takes a moment on millions of triangles. What happens to your sculpting when you change level: Detail survives. Each level stores its detail as a small offset from the smoothed shape of the level below, measured along that surface (its normal and tangents). Stepping up and down without sculpting gives back exactly the same mesh. Big changes low, detail follows. Sculpt, move or inflate at a low level and step up: the higher levels follow the new shape and the wrinkles, pores and scales you sculpted on them ride along on top. Detail edits show up below. Sculpt at a high level and step down: the lower levels take on a softened version of the change, so the silhouette stays honest whichever level you look at. Fine detail is too small for a low level and only shows as a gentle swelling there."},{"p":"subdivision-levels.html","c":"Subdivision levels","a":"what-follows-the-levels","h":"What follows the levels","t":" When you change it at one level Shape Carried up as detail, softened down (see above) Sculpt layers Each layer has its own detail on every level, kept relative to the surface like the shape's: rotate or reshape a low level and a layer's wrinkles turn and bend with it. Weights apply to all levels. See Layers and subdivision levels Mask Copied down to the vertices below, interpolated up where it changed Polypaint and paint layers As the mask: paint at a low level for broad colour, at a high level for detail. Painting low only changes the higher levels where you painted Polygroups, hidden faces Copied down to the parent faces, inherited up by the faces they contain UVs Copied down and interpolated up Texture Shared by every level (it lives on the UVs) Clearing the mask, removing a layer or deleting the paint layers does it on every level."},{"p":"subdivision-levels.html","c":"Subdivision levels","a":"del-lower-and-del-higher","h":"Del Lower and Del Higher","t":"Del Lower deletes the levels below the current one: the current level becomes the new base cage (SDiv 1). Del Higher deletes the levels above, and the detail sculpted on them. Both are undoable. Deleting down to a single level leaves an ordinary mesh."},{"p":"subdivision-levels.html","c":"Subdivision levels","a":"reconstruct-subdiv","h":"Reconstruct Subdiv","t":"A model that was subdivided in another application (or exported from SculptForge at its top level) comes in as one dense mesh. Reconstruct Subdiv finds the mesh it was subdivided from and adds it as a new lowest level, keeping the dense mesh exactly as it was. Press it again for more levels. It works at the lowest level (SDiv 1). The mesh must be a regular subdivision: all quads from Catmull-Clark subdivision (Blender's Subdivision Surface, Maya's Smooth, ZBrush's Divide), or all triangles from Loop subdivision. Otherwise it says so and leaves the mesh alone. The vertices of the new lower level sit on the dense mesh's corner vertices, as in ZBrush. Tip: The Cube from Tool > SubTool > Append is a regular quad grid, so Reconstruct Subdiv takes it down to a 3 x 3 cube in four steps."},{"p":"subdivision-levels.html","c":"Subdivision levels","a":"undo-projects-and-exporting","h":"Undo, projects and exporting","t":"Undo (Ctrl+Z) is one step per stroke at any level, and one step per level change, so undo walks back through your strokes and level changes in the order you made them. Divide, Del Lower, Del Higher and Reconstruct are single undo steps. Steps share the levels they didn't change, so they cost little memory. Projects (.sfproj) save every level of every SubTool and open at the level you saved at. They use project format 5 (sculpt-layer detail relative to the surface), so older SculptForge versions ask you to update before opening them. Projects saved with format 4 open as before and are converted as they load. Exports and GoZ write the current level. To write another one, step to it first, or use the subdiv_export command (subdiv_export path=base.obj level=1 writes the base cage of every visible SubTool, in any export format). LODs and Send to Unreal start from the current level too. Tools that rebuild the mesh (Voxel Remesh, Decimate, QRemesh, Subdivide, Delete hidden, merging and splitting SubTools) work on the level you are on, including what you just sculpted there, and make a new mesh without levels: that level becomes the new base. The status line says so, e.g. Subdivision levels removed: SDiv 3 of 5 kept as the new base (undo restores them). Ctrl+Z brings every level back, at the level you were on. Merging and splitting SubTools can't be undone (as in ZBrush), so step to the level you want to keep first, or save before. Note: Subdivide (in Tool > Geometry, below Divide) is still there: it replaces the mesh with a denser one and keeps no levels. Use Divide unless you want exactly that."},{"p":"subdivision-levels.html","c":"Subdivision levels","a":"commands","h":"Commands","t":"Every control is a command you can run in the console, from a script or over MCP (see Scripting): Command What it does subdiv_divide smooth=true Divide; smooth=false divides flat (Smt off) subdiv_level level=2 Step to a level (1 = base) subdiv_lower, subdiv_higher Lower Res, Higher Res subdiv_delete_lower, subdiv_delete_higher Del Lower, Del Higher subdiv_reconstruct Reconstruct Subdiv subdiv_info List the levels and their triangle counts subdiv_export path=base.obj level=1 Export the visible SubTools at a level"},{"p":"subdivision-levels.html","c":"Subdivision levels","a":"speed-and-memory","h":"Speed and memory","t":"Measured on an Apple M1 Pro (Asahi Linux), a cube divided four times to 6.5 million triangles: 1.6M triangles at the top 6.5M triangles at the top Divide to the top level 0.4 s 4.3 s Step down / up between visited levels 1-4 ms 0.1-45 ms Step down right after sculpting the top 0.05-0.13 s 0.2-0.6 s Step up after reshaping the base 0.05-0.15 s 0.6 s Memory for all levels 120 MB 480 MB SculptForge keeps the two levels you visited last ready to show, so going back and forth between a low and a high level (the usual rhythm) is instant. Only the active SubTool keeps them: selecting another SubTool frees that memory (50-170 MB for a SubTool with 1.8 million triangles at the top), and the first level change after you come back takes a moment longer (about 0.1 s at that size) while the level is prepared again. ZBrush: Divide, Smt, Lower Res, Higher Res, SDiv, Del Lower, Del Higher and Reconstruct Subdiv work as in ZBrush. Not yet: Freeze SubDivision Levels, Cage, Rstr, Suv (UV smoothing on divide) and creased edges."},{"p":"dynamic-topology.html","c":"Dynamic topology","a":"","h":"Dynamic topology","t":"With Dynamic on, the brush adds triangles where it needs detail and removes them where it doesn't, as ZBrush's Sculptris Pro and Blender's Dyntopo do. Pull a sphere out into horns, ears or fingers and the new shapes get triangles of their own instead of stretched ones; block in a creature from a ball without remeshing first. A sphere with horns pulled out by Snake Hook with Dynamic on, in Polyframe and shaded"},{"p":"dynamic-topology.html","c":"Dynamic topology","a":"turn-it-on","h":"Turn it on","t":"Control Where What it does Dynamic Top shelf, Draw palette Turns dynamic topology on or off (ZBrush's Sculptris Pro button) Detail Top shelf (while Dynamic is on), Draw palette How small the triangles get: 0 coarse, 100 fine (default 50) Constant detail Draw palette Off: the size follows the brush. On: one size for the whole mesh Then sculpt as usual. Every brush works with it except Move (it drags the surface without remeshing), the mask and paint brushes, and the stamping strokes DragRect and DragDot (so VDM stamps don't remesh either). Smooth remeshes towards larger triangles, so smoothing also simplifies, as in ZBrush. Tip: Turn on PolyF (Shift+F) to see the triangles appear under the brush."},{"p":"dynamic-topology.html","c":"Dynamic topology","a":"how-big-the-triangles-get","h":"How big the triangles get","t":"By default the triangle size follows the brush size on screen, as in Sculptris Pro: zoom in or make the brush smaller for finer triangles, zoom out or make it bigger for coarser ones. At Detail 50 an edge is about an eighth of the brush radius; Detail 100 makes them about three times smaller, Detail 0 three times bigger. With Constant detail on, every stroke aims for the same size whatever the zoom and brush, set by Detail relative to the size of the mesh (at 50, about a hundredth of its bounding box diagonal). Use it to bring a whole model to an even density, or to keep the density while you change brush sizes. It is a preference: Store Config (Ctrl+Shift+I) keeps it. Under the brush, edges longer than the target are split, edges much shorter are merged away, and the new triangles are evened out. Outside the brush nothing changes, so you can have big triangles on the back of a head and fine ones around the eyes."},{"p":"dynamic-topology.html","c":"Dynamic topology","a":"what-it-keeps-and-what-it-doesnt","h":"What it keeps and what it doesn't","t":"Symmetry. With X (or Y, Z) symmetry on, both sides are remeshed together and get mirrored triangles, not just mirrored shapes. Mask and visibility. Fully masked and hidden parts are left alone. Partly masked areas are remeshed but move less, as usual. Borders. Open edges and the borders between polygroups stay where they are; their vertices only slide along them. New triangles take the polygroup of the triangle they came from. Polypaint, mask values and sculpt layers are carried onto new vertices (blended between their neighbours). Quads under the brush become triangles. The rest of the mesh keeps its quads. UVs are dropped the first time a stroke remeshes a SubTool (the status bar says so), since the new triangles have none. Undo brings them back. Unwrap again with Auto UV when you are done."},{"p":"dynamic-topology.html","c":"Dynamic topology","a":"subdivision-levels","h":"Subdivision levels","t":"Dynamic topology works on meshes without subdivision levels, as in ZBrush. On a SubTool with levels, Dynamic stays off and the status bar says why: go to the level you want to keep and use Del Lower and Del Higher in Tool > Geometry first. If you turn it on and then pick a SubTool that has levels, strokes sculpt it without remeshing. A good workflow: block in with Dynamic, then QRemesh or Voxel Remesh for an even base, Divide for levels, and sculpt the fine detail on them."},{"p":"dynamic-topology.html","c":"Dynamic topology","a":"undo-and-speed","h":"Undo and speed","t":"Each stroke is one undo step. Undo puts every triangle back exactly, and it only keeps the part of the mesh the stroke changed, so it costs little memory even on millions of triangles (a few megabytes per stroke). Dynamic topology is fastest on meshes of up to a few million triangles. On the benchmark computer (an M1 Pro), a dab with a medium brush on a one-million-triangle sphere takes 9 to 13 milliseconds including the screen update; undoing a stroke on such a mesh takes about a tenth of a second. A very big brush over very small triangles merges them over several dabs rather than all at once, to keep the brush responsive. See Performance and big meshes."},{"p":"dynamic-topology.html","c":"Dynamic topology","a":"from-a-script","h":"From a script","t":"dyntopo enabled=true detail=60 stroke points=\"0.3,0.6,1 0.5,0.4,1\" brush=SnakeHook radius=0.2 symmetry=x dyntopo enabled=false dyntopo without arguments reports the settings; constant=true switches to a constant detail size. It works the same from the console, sculptforge-cli, MCP and Python. See Scripting and automation."},{"p":"dynamic-topology.html","c":"Dynamic topology","a":"see-also","h":"See also","t":"Sculpting and brushes Subdivision levels Subdivide, remesh, decimate and LODs Coming from ZBrush"},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"","h":"Moving, rotating and posing (Gizmo 3D)","t":"The Gizmo 3D moves, rotates and scales a whole SubTool, or only the part of it you haven't masked. Use it to place parts (an eye in its socket, a sword in a hand), to fix proportions, and to pose: mask the body, put the pivot at the shoulder and swing the arm. It works like ZBrush's Gizmo 3D, with the same keys. The Gizmo 3D's Move, Scale and Rotate modes; the handle under the cursor turns yellow"},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"the-three-modes","h":"The three modes","t":"Press a key, or click the button on the top shelf (they're also in the Transform palette): Key Mode What you drag W Move An arrow moves along that axis. A square moves in its plane. The ring in the centre moves freely in the view plane E Scale A box stretches along that axis. The disc in the centre scales evenly: drag right or up to grow, left or down to shrink R Rotate A ring turns about that axis. The outer white ring turns about the view direction Q Draw Back to sculpting: brushes work again and the gizmo goes away Pressing the same key again also goes back to Draw. X is red, Y green and Z blue; the handle under the cursor turns yellow. While the gizmo is on, dragging anywhere off its handles still turns, pans and zooms the view, and Ctrl still paints the mask, so you can mask and move without leaving the gizmo. While you drag, the amount shows beside the gizmo (the distance, the angle or the percentage), and a rotation draws the swept angle as a slice. Each drag is one undo step (Ctrl+Z), and the gizmo goes back with it."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"snapping","h":"Snapping","t":"Hold Shift while dragging to snap: Rotate: 15 degree steps. Move: whole steps of the grid, a round number about a twentieth of the model's size (0.1, 0.2, 0.5, 1...). Scale: 10% steps. You can press and release Shift during the drag."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"moving-only-part-of-a-subtool","h":"Moving only part of a SubTool","t":"The gizmo respects the mask: masked parts stay where they are, partly masked parts move partly, and hidden parts never move. To move only the head of a figure, mask everything else (or paint the mask on the head and invert it with Ctrl+click on the background), then drag. Turn Mask off in the Gizmo 3D panel to move the whole SubTool whatever the mask."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"posing-a-limb","h":"Posing a limb","t":"Mask what should stay: for an arm, everything but the arm (Ctrl+paint, or MaskLasso). Press R. The gizmo jumps to the centre of the unmasked arm. Put the pivot at the joint: hold Alt and click the model at the shoulder or elbow. (Or click To Surface, then click the model.) Raise Falloff in the Gizmo 3D panel, for example to 15%. The turn then eases in over that distance from the mask's edge, so the joint bends smoothly instead of creasing along the mask line. Drag a ring. Release, then drag again to refine; each drag is its own undo step. Posing: upper arm masked, pivot at the elbow (left); the forearm turning with a 29% falloff (right) Falloff only ever eases in on the unmasked side: the masked part stays exactly where it was. It is measured along the surface, as a share of the SubTool's size, so it bends the same way on a rough model and on one with millions of polygons."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"symmetry","h":"Symmetry","t":"With X, Y or Z symmetry on (top shelf), a masked transform is mirrored: the unmasked part on the other side of the symmetry plane takes the mirror image of the move, so both arms rise together. This needs a mask and a pivot off the plane; a SubTool moved as a whole just moves."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"the-pivot","h":"The pivot","t":"The pivot is the point rotation and scaling turn about, and where the gizmo sits. It starts at the centre of what will move (the SubTool, or its unmasked part) and follows it when you change the mask or pick another SubTool. To Do this Move the gizmo without moving the model Alt+drag any Move handle Turn the gizmo's axes without turning the model Alt+drag a Rotate ring (the axes switch to Surface) Put the pivot on the surface Alt+click the model, or To Surface then click the model Type the pivot The three numbers under the mode buttons in the Gizmo 3D panel Go back to the centre, with world axes Reset After a drag the gizmo moves (and with Surface axes, turns) with what it moved."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"world-or-surface-axes","h":"World or Surface axes","t":"World keeps the gizmo's arrows and rings on the world's X, Y and Z. Surface lines them up with the surface where you put the pivot (Y along the surface normal) and turns them with your rotations, which is handy for sliding a part along itself, or for twisting a forearm about its own length."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"typing-exact-values","h":"Typing exact values","t":"The Gizmo 3D panel opens in the corner of the canvas while the gizmo is on. Under the options it has Move (X, Y, Z), Rotate (degrees about X, then Y, then Z) and Scale (percent). Type the amounts and click Apply: the model moves, turns and scales by them about the pivot, along the gizmo's axes, in one undo step. Clear sets them back to 0 and 100%. The values stay after Apply, so clicking Apply again repeats the step (rotate by 15 degrees, again, again)."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"all-subtools","h":"All SubTools","t":"Turn on All SubTools in the panel to move every visible SubTool together (ZBrush's Transpose All), for example to turn a whole character with its eyes, teeth and clothes. The pivot is the centre of all of them. Each SubTool gets its own undo step: undo goes back in the active SubTool, and selecting another SubTool undoes its part."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"what-a-transform-keeps","h":"What a transform keeps","t":"A transform only changes where the vertices are. Polygroups, quads, UVs, polypaint, textures, the mask and the topology stay as they are. Sculpt layers move with the surface: the base and every layer's offsets are transformed together, so a layer you sculpted on a forearm stays on it after posing, and layer sliders keep working. With subdivision levels you can pose at a low level: the detail of the higher levels, sculpt layers included, turns with it when you step back up. Projects save the result, and the gizmo's pivot and options too."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"scripting","h":"Scripting","t":"Every gizmo drag appears in the console as the transform command that repeats it, so Copy session as script replays your posing. You can also type it, or use it in scripts and sculptforge-cli: transform translate=0,0.5,0 transform rotate=0,0,45 pivot=1.2,0.4,0 falloff=0.15 transform scale=2 all=true Parameter Meaning translate Movement x,y,z in world units rotate Degrees about X, then Y, then Z (of orient) scale One number, or x,y,z along the axes of orient (above 0) pivot center (default: the centre of what moves), origin, or x,y,z orient world (default), or the axes as x,y,z Euler degrees masked true (default) leaves masked parts; false moves everything falloff Soft joint width as a share of the size, 0-1 (default 0) symmetry Mirror a masked transform across these planes, e.g. x all Every visible SubTool (Transpose All)"},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"speed","h":"Speed","t":"The gizmo recomputes every frame from where the drag started, touching only the vertices that move, and sends only the changed range to the graphics card. On a 1.3 million triangle model a drag frame takes about 2 ms to transform plus about 7 ms to upload, and the release about 20 to 40 ms; undo is as fast."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"see-also","h":"See also","t":"Masking SubTools Sculpt layers and blend shapes Keyboard and mouse"},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"","h":"Subdivide, remesh, decimate and LODs","t":"These tools change the topology of the active SubTool: add resolution for detail, rebuild an even surface, reduce the triangle count, or make a chain of levels of detail for a game engine. This chapter explains what each one does to your mesh and its attributes, and when to use it. All of them work on the active SubTool and, except the LOD preview, are undoable with Ctrl+Z."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"at-a-glance","h":"At a glance","t":"Tool Where Triangles Quads Keeps sculpt layers Keeps mask and polypaint Keeps polygroups, hidden faces, UVs Divide (levels) Tool > Geometry > Divide, Ctrl+D x4 per level, lower levels kept Each quad becomes four (Catmull-Clark) Yes Yes (interpolated) Yes Subdivide Tool > Geometry > Subdivide x4 per level Each quad becomes four Yes Yes (interpolated) Yes Voxel Remesh Tool > Remesh > Voxel Remesh Set by resolution All quads (new ones) Baked in Yes (transferred) No (reset); a texture is kept on new UVs with Keep Texture QRemesh Tool > Geometry > QRemesh Set by Target Polygons All quads, with edge loops Baked in Yes (transferred) Polygroups with Keep Groups; no hidden faces; a texture is kept on new UVs with Keep Texture Decimate Tool > Geometry > Decimate Reduced No, all triangles Yes Yes Yes LOD chain Tool > Export One level per ratio step LOD0 keeps them; lower levels are triangles Yes, on every level Yes Yes"},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"quads-and-triangles","h":"Quads and triangles","t":"SculptForge sculpts on triangles, but it remembers which pairs of triangles were one quad. A model you open from ZBrush (GoZ), Blender or Maya (OBJ, FBX, PLY, USD) keeps its quads: PolyF draws them as quads, without the diagonal, and OBJ, FBX, PLY, USD and GoZ exports write them back as quads, corner for corner. Polygons with more than four sides are split into triangles. The new Plane and Cube are made of quads, and so is the result of a voxel remesh. Sculpting, masking, polypaint, sculpt layers, undo, SubTools and project files all keep the quads. Subdivide turns every quad into four quads. Two things turn quads into triangles: Decimate (and the lower levels of a LOD chain) collapses edges, so its result is all triangles. When the two halves of a quad end up in different polygroups, or one half is deleted, they show and export as two triangles. glTF (.glb) and STL only hold triangles, so those exports always write triangles. ZBrush: Besides keeping the quads you bring in, SculptForge can make new ones from any mesh: QRemesh (like ZRemesher) builds quads with flowing edge loops. See Quad retopology."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"subdivide","h":"Subdivide","t":"For sculpting at several resolutions use Divide (Ctrl+D), which keeps the lower levels to step back to: see Subdivision levels. Subdivide is the one-way version. Tool > Geometry > Subdivide smooths the mesh with Loop subdivision. Each level multiplies the triangle count by four and rounds off the shape slightly, like ZBrush's Divide with Smt on. Sculpt layers are subdivided with the mesh, so blend shapes keep working. Mask, polypaint and UVs are interpolated; polygroups and hidden faces carry over. Each quad becomes four quads; triangles become four triangles. SculptForge refuses to subdivide past 50 million triangles. Note: Subdivide replaces the mesh with a denser one and drops any subdivision levels: it subdivides the level you are on, which becomes the new base, and the status line says so (undo brings the levels back). Voxel Remesh, Decimate and QRemesh do the same. To add triangles only where you sculpt, use Dynamic topology. Tip: The title strip shows the vertex and triangle counts of the whole scene. A few million triangles sculpt smoothly on a recent GPU; go up a level only when you need finer detail."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"voxel-remesh","h":"Voxel remesh","t":"Tool > Remesh > Voxel Remesh rebuilds the active SubTool as an even, watertight surface, like ZBrush's DynaMesh. Use it to: fuse overlapping pieces into one surface (append a sphere, overlap it, merge, remesh); even out stretched triangles after heavy Move or Snake Hook work; clean up scans, splat conversions and AI-generated models before sculpting. The Resolution slider next to the button sets how many voxels span the longest side of the model (64 to 400 in the palette, default 200). Higher keeps more detail and makes more triangles. Wireframe of a model before and after a voxel remesh What happens to your data: Sculpt layers are baked into the surface: the result has no layers. Mask and polypaint are transferred from the nearest original vertex. Polygroups, hidden faces and UVs are reset (everything becomes visible, one polygroup). Hidden parts are remeshed too. A painted texture is kept with Keep Texture (on by default, shown next to the button when the SubTool has a texture): the result gets Auto UVs and the texture is projected onto it, every layer included, in the same undo step. This runs in the background (Auto UV of a few hundred thousand triangles takes several seconds) with a progress bar and Cancel. Off: the texture is dropped. See Texture painting. Separate pieces that don't touch stay separate pieces; overlapping ones are merged. The new surface is made of even quads (the original's quads are rebuilt, not kept). To remesh several SubTools into one, first combine them with Merge visible... or Merge down... in SubTools. ZBrush: There is no Project option, Groups-aware remesh or Blur slider yet. Like DynaMesh, the remesh produces an even grid of quads, not flowing edge loops. For quads with edge loops that follow the forms, use QRemesh (like ZRemesher), and ProjectAll to get the detail back."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"qremesh","h":"QRemesh","t":"Tool > Geometry > QRemesh is automatic quad retopology, like ZBrush's ZRemesher: it rebuilds the SubTool as clean quads whose edge loops follow the forms, close to a target polygon count, with Keep Groups, Adaptive Size, polypaint density and symmetry. ProjectAll (Tool > SubTool > Project) brings the sculpted detail back onto the new topology after you divide it. Both have their own chapter: Quad retopology and detail projection."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"decimate","h":"Decimate","t":"Tool > Geometry > Decimate reduces the triangle count while keeping the shape, using quadric edge collapse (the same family of algorithm as ZBrush's Decimation Master). The Keep slider next to the button sets the fraction of triangles to keep (0.05 to 0.95, default 0.50). Decimation keeps open borders in place, and because it only removes vertices, every remaining vertex keeps its exact sculpt layer offsets, mask and polypaint. Polygroups, hidden flags and UVs survive on the remaining triangles. The result is all triangles: quads are not kept. Use it to make a lighter version of a finished sculpt for export, 3D printing or a review, or to bring a dense scan down to something you can work with. Tip: Decimate a duplicate SubTool (Tool > SubTool > Duplicate) when you want to keep the full-resolution sculpt in the same project."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"lod-chains","h":"LOD chains","t":"A level-of-detail chain is a series of lighter copies of the model for game engines: LOD0 is the full sculpt, and each level after it has a fixed fraction of the triangles of the one before. Open Tool > Export. Set LODs (2 to 6 levels, including LOD0) and Reduction (the triangle ratio from one level to the next, 0.1 to 0.9, default 0.50). Click Generate LOD chain. The Export sub-palette with a generated LOD chain A table lists each level with its triangle count and its budget as a percentage of LOD0. Click a level to preview it on the canvas (wireframe turns on and sculpting pauses); click Sculpt in the table to go back to the editable mesh. The next stroke, or a change to LODs or Reduction, clears the chain; click Generate LOD chain again to rebuild it. Blend shapes (sculpt layers) are kept on every level, so morph targets work at every LOD. To write the chain to disk: LOD chain (GLB per level) in the same sub-palette, or File > Export LOD Chain..., writes one GLB per level named _LOD0.glb, _LOD1.glb and so on. Send to Unreal and Export FBX for Unreal... pack the LODs into one FBX for Unreal's automatic LOD import. See Exporting for these exports and their options. Note: The preview in Tool > Export is of the active SubTool. The exports themselves build a chain for every visible SubTool."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"undo-and-safety","h":"Undo and safety","t":"Subdivide, remesh, QRemesh, decimate and delete hidden are single undo steps on the active SubTool. They can use a lot of memory on dense meshes, and undo keeps a full copy of the previous mesh for each of them. Before a big change on a heavy sculpt: QuickSave (title strip) keeps a timestamped copy of the scene without touching your project file; see Projects. Duplicate the SubTool to keep the old version side by side."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"scripting","h":"Scripting","t":"Command Options subdivide levels 1-4 (default 1) remesh resolution 32-512 voxels across the longest side (default 200); keep_texture (default true) decimate ratio 0.01-1 of the triangles to keep (default 0.5), or triangles for an exact target qremesh target quads (default 5000), adaptive, keep_groups, detect_edges, use_polypaint, symmetry, keep_original, keep_texture; see Quad retopology export_lods path (base name), levels 1-8 including LOD0 (default 4), ratio 0.1-0.9 (default 0.5) sculptforge-cli -c 'open path=scan.obj; remesh resolution=256; decimate triangles=200000; export_lods path=out/rock.glb levels=4 ratio=0.5' The command line accepts a wider remesh range (32-512) than the palette slider."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"see-also","h":"See also","t":"Quad retopology and detail projection: QRemesh and ProjectAll SubTools: merge pieces before a remesh, duplicate before a decimate Sculpt layers and blend shapes Exporting: LOD chains, FBX for Unreal, Send to Unreal Image and text to 3D: generated models are voxel-remeshed for sculpting"},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"","h":"Quad retopology and detail projection","t":"QRemesh rebuilds a sculpt as clean, all-quad topology whose edge loops follow the forms, like ZBrush's ZRemesher. ProjectAll then moves a mesh onto the surface of other SubTools, so the detail of the original sculpt comes back onto the new topology, like ZBrush's Project All. Together they turn a dense, messy sculpt (a voxel remesh, a scan, an AI-generated model) into a light quad mesh you can divide, sculpt on, unwrap and animate. A lion bust after QRemesh: 5,000 quads whose loops follow the mane, shown with PolyF"},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"the-usual-workflow","h":"The usual workflow","t":"Select the sculpt and open Tool > Geometry. Under QRemesh, turn on Keep Original. Set Target Polygons (for example 5000) and click QRemesh. It runs in the background: a progress bar replaces the button, and Cancel stops it. The result replaces the SubTool, and the sculpt as it was is kept as a hidden SubTool called \"name Original\" right below it. Divide the new mesh two or three times (Tool > Geometry > Subdivide, Ctrl+D). Show the original again (the eye in Tool > SubTool) and click ProjectAll under Tool > SubTool > Project. The divided quads snap onto the sculpt and take its polypaint. Hide or delete the original. You now have the same sculpt on clean quads. Left: the retopology of a sculpted sphere. Right: divided twice and projected, the ridges and the crease are back Both steps are single undo steps (Ctrl+Z)."},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"qremesh","h":"QRemesh","t":"Tool > Geometry > QRemesh works on the active SubTool. Control What it does QRemesh Starts the retopology. The status line reports the result, e.g. \"QRemesh: 4987 quads from 47214 triangles (100% quads) in 1.0 s\" Target Polygons About how many quads to make (100 to 200,000 on the slider, more from scripts). The result is usually within 5% of it Half / Same / Double Set the target to half, the same as or twice the SubTool's current polygon count Adaptive Size 0 makes quads all about the same size. Higher values make smaller quads where the surface curves and bigger ones on flat areas, for the same total Keep Groups Edge loops run exactly along the polygroup borders, and the result keeps the polygroups Detect Edges Hard edges, where faces meet at more than 50 degrees, get an edge loop, so boxes and bevels stay crisp (on by default) Use Polypaint Paint where you want density: red areas get up to four times the quads, blue areas down to a quarter, white areas are unchanged Symmetry Remesh one half and mirror it, welded on the seam, for exactly symmetric topology (on by default). It mirrors on the axis chosen in the Transform palette (X if none), across the model's own middle plane: the world's centre plane when the model is symmetric about it, otherwise the plane through the model's middle, so a model moved away from the centre works too. A model that isn't mirror-symmetric is remeshed whole instead, and the status line says \"Symmetry off: the model isn't mirror-symmetric\"; one that is nearly symmetric (a bump on one side) gets mirrored topology that follows each side's own surface Keep Original Keep the SubTool as it was, hidden, below the new one, ready for ProjectAll. Off: the SubTool is replaced, as in ZBrush (undo brings it back) Keep Texture Shown when the SubTool has a painted texture (on by default): Auto UV the result and project the texture onto it. Off: the texture is dropped QRemesh Guides Picks the guides brush: draw curves on the model for the edge loops to follow. See QRemesh Guides Delete Last / Clear Delete the last guide curve drawn (with its mirror copies), or all of them Curves Strength How far around each guide the edge flow follows it: 0 = only the loop on the curve, 100 = about six quads to each side (default 50) What happens to your data: The result is all quads (stored as pairs of triangles, so PolyF draws quads and OBJ, FBX, PLY, USD and GoZ export them as quads), closed wherever the sculpt is closed. Open edges of the sculpt stay open, along the same outline. Sculpt layers are baked into the surface: the result has no layers. Mask and polypaint are interpolated from the closest point of the sculpt (polypaint is blurred to the new resolution until you project it back onto a divided copy). Polygroups are kept with Keep Groups; otherwise the result is one polygroup. The old UVs are dropped. A painted texture is kept with Keep Texture (on by default): the result gets Auto UVs and the texture, every layer of it, is projected onto them from the old surface, in the same undo step. See Texture painting. Hidden parts are remeshed too. Separate pieces stay separate and none is dropped: small ones (eyes, teeth, rivets, anything that would get fewer than about 100 quads) are remeshed on their own with at least 32 quads, more for small round pieces with Adaptive Size. A piece the grid can't cover at all is kept as it was (as triangles). Thin parts (a blade, a fin, a slab thinner than a quad) keep both their sides, and with Detect Edges their hard edges keep a loop each and their corners stay put. Their corners can still be cut a little when the part is much thinner than a quad: raise the target, or use polypaint density there."},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"guiding-the-edge-flow","h":"Guiding the edge flow","t":"QRemesh Guides put an edge loop exactly where you draw: around the eyes, the mouth, a joint. See below. Polygroups are as strong a guide. Paint a group around an eye, the mouth or a muscle, turn on Keep Groups, and loops will circle it. See Polygroups. Polypaint sets the density with Use Polypaint: paint the face red and the back of the head blue to spend the quads where they matter. Adaptive Size around 0.5 gives detailed areas more quads without your help; use 0 for an even mesh, for example before more sculpting."},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"how-it-works","h":"How it works","t":"QRemesh is a field-aligned method after Instant Field-Aligned Meshes (Jakob, Tarini, Panozzo and Sorkine-Hornung, 2015). It smooths a cross field (the directions the quad edges should take) over the surface from coarse to fine, places a grid of the wanted size along it, extracts the polygons where neighbouring grid corners meet, splits every polygon into quads and relaxes them back onto the sculpt. It is fast: about 2 seconds for a 1.3-million-triangle sculpt to 5,000 quads, and 6 seconds to 100,000 quads, on a 10-core desktop. ZBrush: QRemesh Guides are ZBrush's ZRemesher Guides brush, and Curves Strength its slider of that name. Keep Groups, Use Polypaint, Adaptive Size, Half / Same / Double and symmetry work as you know them. There is no Freeze Border / Freeze Groups yet, and the mask doesn't steer QRemesh: use polypaint for density."},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"qremesh-guides","h":"QRemesh Guides","t":"Draw curves on the sculpt and QRemesh puts an edge loop along each one, and turns the flow around it to follow, like ZBrush's ZRemesher Guides brush. Use them where the topology has to work for animation: rings around the eyes and the mouth, loops around the shoulders, elbows and knees, a line down the middle of a muscle. Left: QRemesh on its own. Middle: loops drawn round the eyes and the mouth with QRemesh Guides. Right: QRemesh again, with an edge loop on every curve and rings around them Click QRemesh Guides under Tool > Geometry > QRemesh (or pick it in the brush picker, B). The cursor becomes a small ring. Drag on the model to draw a curve. It is drawn on the surface and snapped to it. A curve that ends near where it started is closed into a loop: draw round an eye and let go where you began. With symmetry on (X in the top shelf), each curve is mirrored to the other side as you draw. A curve that is its own mirror image, a loop round the mouth across the middle, is kept once. Click QRemesh. The status line says how many guides it followed. Editing the curves: Alt+click a curve to delete it (it turns red under the cursor while Alt is held), with its mirror copy. Delete Last removes the last curve drawn; Clear removes them all. Ctrl still masks and Shift still smooths while the guides brush is picked, and dragging the background still turns the view. Pick any brush to sculpt again. The guides belong to the SubTool: each SubTool has its own, they are saved in the project, and Keep Original gives the kept original a copy, so you can change them and remesh again. They show over the model, solid while the guides brush is picked and thin otherwise, so you can see the loop QRemesh put on them. Drawing and deleting guides isn't part of undo (Ctrl+Z undoes your sculpting as before). Good to know: QRemesh snaps the guides onto the sculpt as it is when you run it, so sculpting after drawing them is fine. A guide left far from the surface, for example after moving the SubTool with the Gizmo, is ignored and the status line says so: draw it again. A loop gets an even number of quads around it, so it closes cleanly. Two guides closer together than about a quad compete for the same loop; draw them further apart or raise Target Polygons. A very small loop, about 25 quads round or fewer, may not close, and the edges just outside it bend to fit the extra quads the next ring needs: raise Target Polygons. Curves Strength doesn't change the loop on the curve, only how far around it the other edges turn to follow. Lower it when guides are close to each other or to the symmetry plane."},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"how-the-guides-work","h":"How the guides work","t":"Each curve constrains QRemesh's cross field (the directions the edges take) to run along it, falling off over a few quads (Curves Strength), and adds a lattice line on the curve, so one edge loop lies on it. Along a closed curve the lattice corners are placed at even steps, an even number of them (a ring of quads round a disk always has an even number of sides), so the loop meets itself without a kink. With symmetry QRemesh remeshes one half, so a loop across the middle is cut there: its corners start on the seam, where it meets its mirror image. QRemesh then checks the loops and the quads near the guides; if a loop came out broken or a fan of seven or more edges sits by a guide, it tries again with a different start for the field and keeps the best. Measured on a sphere with a circular guide around an \"eye\", the edges near the curve are within about 2 to 8 degrees of its direction (about 22 degrees without the guide), and the loop closes."},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"projectall","h":"ProjectAll","t":"Tool > SubTool > Project > ProjectAll projects every other visible SubTool onto the active one. Each vertex looks along its normal, both ways, and moves to the nearest surface it finds within Dist; if there is none straight along the normal, it takes the closest point within Dist. Control What it does ProjectAll Projects the visible SubTools onto the active one (one undo step) Dist How far to search, as a fraction of the SubTool's size (bounding-box diagonal). Default 0.02. Raise it if parts don't pick up the detail; lower it where two surfaces are close together (lips, eyelids, fingers) PA Blur Smooths the projected result this many times, to soften noise from the source Mean Where there is surface on both sides of a vertex, settle halfway between them instead of on the nearest Geometry Project the shape (into the active sculpt layer, if you have layers) Polypaint Project the polypaint (into the active paint layer) when a source has any The mask protects: fully masked vertices don't move; partly masked ones move part of the way. Mask the areas you have already fixed and project again with a different Dist. Hidden faces of the source are ignored, and hidden parts of the target don't move. ProjectAll is fast enough to use on dense meshes: about 0.6 seconds to project 1.25 million vertices from a 1.3-million-triangle sculpt. Tip: Project after each division, not only at the end: divide once, ProjectAll, divide again, ProjectAll. Each pass starts closer to the sculpt, so a small Dist is enough and thin parts don't jump to the wrong surface."},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"scripting","h":"Scripting","t":"Command Options qremesh target (16 to 2,000,000, default 5000), adaptive (0-1, default 0.5), keep_groups, detect_edges (default true), use_polypaint, symmetry (x, y or z; off by default in scripts; the mirror plane is found from the model), symmetry_center (use this plane instead, e.g. 0 for the world's centre), keep_original, smooth (relaxation passes, default 6), seed, keep_texture (default true), guides (follow the SubTool's QRemesh Guides, default true), curves_strength (0-100, default 50) qremesh_guide points (the curve, \"x,y,z x,y,z ...\"), view (project the points onto the surface along this direction, as a stroke from the camera; default: each point to the closest surface point), symmetry (x, xz...; mirror the curve) qremesh_guide_delete_last, qremesh_guides_clear, qremesh_guides_info Delete the last curve, delete all, list them project_all distance (0.001-1, default 0.02), mean, blur (0-20), geometry (default true), polypaint (default true), source (one SubTool's name instead of all visible ones) sculptforge-cli -c 'open path=scan.glb; qremesh target=8000 adaptive=0.3 keep_original=true; subdivide levels=2; subtool_visibility index=1 visible=true; project_all distance=0.02; export_fbx path=retopo.fbx' sculptforge-cli -c 'open path=head.glb; qremesh_guide points=\"0.2,0.3,2 0.3,0.4,2 0.4,0.3,2 0.3,0.2,2 0.2,0.3,2\" view=0,0,-1 symmetry=x; qremesh target=4000 symmetry=x curves_strength=70' From scripts qremesh runs straight away (it doesn't return until it's done); in the app the button runs it in the background."},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"see-also","h":"See also","t":"Subdivide, remesh, decimate and LODs: voxel remesh first to fuse pieces, subdivide after QRemesh SubTools: show, hide and duplicate the original Polygroups and visibility: guides for Keep Groups Projects: QRemesh Guides are saved with each SubTool Texture painting: Auto UV on the new topology"},{"p":"generate-3d.html","c":"Image and text to 3D","a":"","h":"Image and text to 3D","t":"SculptForge can turn a picture or a written description into a full 3D model that you can sculpt straight away. This chapter covers the Generate 3D window, the services it can use (free Hugging Face models, your own ComfyUI server, paid fal.ai or Meshy, your own command line, or an offline blockout) and the offline image tools: relief, inflate and stamp. The Generate 3D window with a sketch loaded and the Hugging Face service selected"},{"p":"generate-3d.html","c":"Image and text to 3D","a":"how-it-works","h":"How it works","t":"You give SculptForge an image (a sketch, concept art, a photo of a figurine) or a short description. The service you picked reconstructs a complete mesh: front, back, limbs and all. SculptForge opens the result as a new scene and, unless you turn it off, voxel-remeshes it into one even, watertight surface, so the brushes behave the same as on any other sculpt. Nothing leaves your computer until you choose a hosted service and press Generate 3D model. For exactly what is sent where, see AI services and privacy below. ZBrush: ZBrush has no built-in image-to-3D. The closest workflow is blocking out a base mesh by hand with DynaMesh or ZSpheres; here you get a starting shape in seconds and refine it with the usual brushes."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"open-the-generate-3d-window","h":"Open the Generate 3D window","t":"Any of these opens it: Drop an image file (PNG, JPG, BMP, TGA, PSD or GIF) onto the SculptForge window. The image is loaded as the picture for the From image tab and the window opens. Open the Generate palette and click Generate 3D. Press F3, type generate and press Enter. The window has two tabs, From image and From text. Warning: A generated model replaces the current scene without asking, and arrives as a new, untitled scene. Save your work (Ctrl+S) before you generate."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"generate-from-an-image","h":"Generate from an image","t":"On the From image tab, click Choose image... (or drop a file onto the window). A preview and the image size appear. Pick a service in the drop-down under Full 3D model (AI reconstruction). The default is Hugging Face free models. Set the service's options (model, token or key, see below). Leave Remesh for sculpting on and set its Resolution (96 to 400, default 256). Higher keeps more detail and makes more triangles. Click Generate 3D model. A progress bar shows the queue position and progress; Cancel stops the job. When it finishes, the status line reports the triangle count before and after remeshing, for example \"Generated model imported (412000 tris, remeshed to 180000) - ready to sculpt\"."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"pictures-that-work-well","h":"Pictures that work well","t":"One character or object per image. A plain or transparent background. SculptForge crops the subject out of a transparent background, centres it on a square and scales it to at most 1024 pixels before sending it. The whole subject in frame, seen from the front or a three-quarter view. A clean concept turnaround pose works better than a busy illustration with scenery."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"generate-from-text","h":"Generate from text","t":"On the From text tab, type one object into the box, for example \"a stylised dragon head with curled horns\" or \"a cartoon fox sitting\". Pick Hugging Face - free models, fal.ai, Meshy or ComfyUI - your server. Text to 3D does not work with My generator command or Offline blockout. Click Generate 3D model. Which model runs depends on the service: Service Text-to-3D model Hugging Face Hunyuan3D 2 mini Turbo (Tencent), or Hunyuan3D 2 if you chose it in Model. Any other choice uses Turbo fal.ai Hunyuan3D 3.1 Rapid (Tencent) Meshy Meshy's own text-to-3D model ComfyUI The text workflow you choose (the bundled text-to-3d uses FLUX.1 schnell and Hunyuan3D 2.1)"},{"p":"generate-3d.html","c":"Image and text to 3D","a":"services","h":"Services","t":"Service Cost and setup Good for Hugging Face - free models Free, no account. A free token raises the daily allowance Trying things out, personal work fal.ai - paid, your key Paid per generation, needs a fal.ai key Reliable capacity, newer models Meshy - paid, your key Paid, needs a Meshy key Meshy's own models ComfyUI - your server Free, runs on your own GPU or a studio server Privacy, custom workflows, studios My generator command Free, any program you run locally Your own model or a studio service Offline blockout (inflate silhouette) Free and instant, no network Simple shapes, a quick start"},{"p":"generate-3d.html","c":"Image and text to 3D","a":"hugging-face-free","h":"Hugging Face (free)","t":"This runs each model author's own public demo on Hugging Face's shared ZeroGPU hardware. Pick a Model: Model Notes Hunyuan3D 2.1 (Tencent) The default. Detailed shapes, about 20 seconds TRELLIS.2 (Microsoft) The most detail. Needs a Hugging Face token Hunyuan3D 2 mini Turbo (Tencent) The fastest, about 6 seconds Hunyuan3D 2 (Tencent) Stable Fast 3D (Stability AI) Quick and simple, removes the background itself GPU time is rationed per person per day, there can be a queue at busy times, and a demo can be paused or changed by its owner. To raise the allowance, create a free token with read access at huggingface.co/settings/tokens and paste it into HF token (or set the HF_TOKEN environment variable). When the allowance runs out you see \"Hugging Face's free GPU time is used up for now\"; add a token, wait for it to refill, or pick another model. Warning: The Hunyuan3D models are under the Tencent Hunyuan Community License, which does not cover use in the European Union, the United Kingdom or South Korea. If you work there, choose TRELLIS.2, Stable Fast 3D or a paid service. Each model has its own licence; read it before using results commercially."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"falai-and-meshy-paid","h":"fal.ai and Meshy (paid)","t":"fal.ai: choose a Model (TRELLIS.2, Hunyuan3D 3.1 Pro, Hunyuan3D 3.1 Rapid or Meshy 6) or type any fal model id into Model id. Paste your key from fal.ai/dashboard/keys into API key, or set FAL_KEY. Meshy: paste your key from meshy.ai (API settings) into API key, or set MESHY_API_KEY. Generations are billed to your account with that service. Errors such as \"The API key was rejected\", \"Out of credits on this account\" or \"Rate limited\" come from the service."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"comfyui-your-own-server","h":"ComfyUI (your own server)","t":"Runs any ComfyUI workflow on your own computer or a studio GPU server, with whatever models it has. Nothing is sent anywhere else. Start ComfyUI. It listens on http://127.0.0.1:8188 by default. If SculptForge runs on another computer, start ComfyUI with --listen (only on a network you trust: ComfyUI has no login). Install the models your workflow needs. The bundled Hunyuan3D 2.1 workflow needs hunyuan_3d_v2.1.safetensors in ComfyUI/models/checkpoints. In Generate 3D, pick ComfyUI - your server, enter the Server address and click Test connection. A good answer looks like \"Connected: ComfyUI 0.42.0 - NVIDIA GeForce RTX 4090 (24.0 GB)\". Choose a Workflow: a bundled one, or Other file (API format)... for your own. Click Generate 3D model. The progress bar shows your place in ComfyUI's queue. Bundled workflows: Workflow Tab Needs hunyuan3d-image-to-3d From image The Hunyuan3D 2.1 checkpoint (7.4 GB) and a GPU with about 10 GB of memory text-to-3d From text FLUX.1 schnell, BiRefNet and Hunyuan3D 2.1 (about 25 GB of downloads) and a GPU sculptforge-inflate From image The ComfyUI-SculptForge node pack; no GPU. A quick blockout to check your setup Your own workflows must be saved in ComfyUI's API format (in ComfyUI: Workflow > Export (API)). To tell SculptForge where the inputs go, give nodes these titles: Node title What SculptForge does sf_image Puts the uploaded picture into this Load Image node. Without one, the first Load Image node is used sf_prompt Puts your description into this node's text, prompt or string input. Without one, the first CLIP Text Encode not titled \"negative\" is used sf_seed Sets the seed. Inputs named seed or noise_seed get it too SculptForge imports the first mesh file the workflow saves (Save GLB, Preview 3D and most 3D node packs work). For error messages and their fixes, see Troubleshooting."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"my-generator-command","h":"My generator command","t":"Runs any command line on your computer: a local open-source model, a studio service, or a script that calls a cloud API. Type the command into the box. It must contain {input} (replaced with the image path) and {output} (replaced with the path to write, ending in .glb). Both are quoted for you, so don't add quotes. The command must write a GLB file to {output} and exit with status 0. The box starts with a command that runs SculptForge's own silhouette inflation, which is a quick way to check that the pipeline works: sculptforge-cli --set input={input} --set output={output} -c 'image_inflate path=$input subdivisions=2; export_glb path=$output' A wrapper for your own model can be as small as this: # my_generator.py {input} {output} import sys image_path, output_path = sys.argv[1], sys.argv[2] # load your model, run it on image_path, write a .glb to output_path Keep API keys in environment variables that your script reads, not in the command line."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"offline-blockout","h":"Offline blockout","t":"Offline blockout (inflate silhouette) inflates the outline of the picture into a rounded, closed mesh. It is instant and needs no network, but it is a puffy blockout, not a reconstruction: fine for simple shapes, not for characters."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"save-your-settings","h":"Save your settings","t":"Save settings (the small button under Generate 3D model) stores the service, model, keys, token, ComfyUI address and generator command in your ai.json settings file, so they are set the next time you start SculptForge. Keys in ai.json are readable only by your user account. See where settings live."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"quick-shapes-from-an-image-offline","h":"Quick shapes from an image (offline)","t":"The From image tab also has three offline tools under Quick shapes (offline). They need no network and run instantly. The same tools are in the Generate palette as Relief, Inflate and Stamp. Tool What it makes Settings Silhouette blockout > Inflate A rounded, closed base mesh from the outline. Replaces the scene Thickness (0.2 to 2, lower is flatter), Detail (64 to 384) Relief > Make relief A height-field relief: light areas rise. For logos, coins, emblems, height maps and texture photos. Replaces the scene Depth (0.01 to 0.5 of the width), Detail (64 to 1024), Dark is high Stamp onto model > Stamp from this view Projects the image onto the current model from the current view as surface detail, into the active sculpt layer Depth (0.001 to 0.1 of the model size), Dark is high Tip: Stamp writes into the active sculpt layer, so add a layer first (Tool > Layers) if you want to dial the detail in and out afterwards. See Layers and blend shapes."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"after-generating","h":"After generating","t":"Generated meshes are a starting point. A typical next pass: Check the size of the remeshed result in the title strip (Verts, Tris). If the detail is too soft, generate again with a higher Resolution, or run Tool > Remesh > Voxel Remesh at a higher value on the result. Turn on X symmetry if the subject is symmetrical, and sculpt the forms with Clay Buildup, Move and Dam Standard (Sculpting and brushes). Save a project (Ctrl+S): generated scenes start untitled."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"from-scripts-and-agents","h":"From scripts and agents","t":"The same services are available as commands, in the console, sculptforge-cli, Python and MCP agents: # free (Hunyuan3D 2.1 on Hugging Face) sculptforge-cli -c 'image_to_3d path=hero.png; export_glb path=hero.glb' # TRELLIS.2 with a Hugging Face token HF_TOKEN=hf_... sculptforge-cli -c 'image_to_3d path=hero.png model=trellis-2; export_glb path=hero.glb' # fal.ai, keeping the raw (not remeshed) result FAL_KEY=... sculptforge-cli -c 'image_to_3d path=hero.png service=fal model=fal-ai/trellis-2 remesh=false; export_glb path=hero.glb' # text to 3D on your own ComfyUI, repeatable with a seed sculptforge-cli -c 'text_to_3d prompt=\"a carved stone owl\" service=comfyui url=http://gpu-box:8188 seed=42; export_usd path=owl.usdz' # is the ComfyUI server up? sculptforge-cli -c 'comfyui_check' # offline tools sculptforge-cli -c 'image_relief path=logo.png depth=0.08; export_stl path=logo.stl' sculptforge-cli -c 'image_inflate path=sketch.png thickness=0.7; save_project path=blockout.sfproj' Command Key parameters image_to_3d path (required), service (huggingface, fal, meshy, comfyui, command, inflate), model, workflow, url, seed, remesh (default true), resolution (64 to 512, default 256) text_to_3d prompt (required), service (huggingface, fal, meshy, comfyui), model, workflow, url, seed, remesh, resolution image_relief path (required), depth (default 0.12), resolution (default 384), invert image_inflate path (required), thickness (default 1), resolution (default 160), subdivisions (default 1) image_project path (required), depth (default 0.03), invert. Projects from the front (+Z) comfyui_check url Without service=, commands use the settings you saved in the app. See Scripting and automation."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"privacy-and-model-licences","h":"Privacy and model licences","t":"SculptForge has no servers of its own and no telemetry. A hosted service receives only the prepared image (or your text) and your key or token, if any. The free Hugging Face option runs the model authors' own demos; SculptForge does not host or bundle any model. Each model has its own licence: TRELLIS.2 is MIT; Hunyuan3D models use the Tencent Hunyuan Community License (not for use in the EU, UK or South Korea); Stable Fast 3D uses the Stability AI Community License (free under US $1M annual revenue). Read the licence before commercial use. With ComfyUI, the picture goes only to the server address you entered. The full table of what is sent where is in docs/ai-services.md in the SculptForge repository."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"see-also","h":"See also","t":"Sculpting and brushes: refine the generated model Subdivide, Remesh, Decimate and LODs: voxel remesh in detail Gaussian splats: start from a phone capture instead of a picture Scripting and automation: batch generation from the command line Troubleshooting: quota and connection messages"},{"p":"splats.html","c":"Gaussian splats","a":"","h":"Gaussian splats","t":"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. A splat capture loaded next to the sculpt, with the Splats palette in the right tray To make a splat yourself from a phone video or photos, see Scan an object into a splat."},{"p":"splats.html","c":"Gaussian splats","a":"supported-files","h":"Supported files","t":"Format Open Save PLY (standard 3D Gaussian Splatting layout, spherical harmonics up to degree 3) Yes Yes .splat (compact web-viewer format) Yes Yes glTF / GLB with KHR_gaussian_splatting Yes Yes OpenUSD .usda / .usdz with a ParticleField3DGaussianSplat prim Yes Yes A PLY file can hold either a mesh or splats; SculptForge tells them apart by their contents."},{"p":"splats.html","c":"Gaussian splats","a":"load-a-capture-as-a-reference","h":"Load a capture as a reference","t":"Open the capture with File > Open... (Ctrl+O), drop it onto the window, or double-click it in the LightBox Splats tab. The splats load next to your sculpt: the current mesh stays, and the capture is drawn around it as a reference. The Splats palette moves into the right tray by itself, and a Splats button appears on the right shelf to show or hide the capture. Most captures arrive upside down, off-centre and at an arbitrary scale. Use the buttons in the Splats palette to place them: Button What it does Flip Turns the capture upside down (180 degrees about X). Most captures need this Turn 90 Turns it 90 degrees about the vertical axis Fit Centres it at the origin and scales it to the size of a new sphere Clean floaters Removes faint splats and stray outliers around the subject The palette also shows the number of splats and their spherical-harmonic degree (for example \"1250000 splats (SH 3)\"), and has: Show and Show mesh to show or hide the capture and the sculpt. An opacity slider (0.05 to 1) to see the sculpt through the capture. Tip: To sculpt a character over a scan, lower the opacity to about 0.4, turn on X symmetry and block in the forms on a sphere or a converted mesh with Clay Buildup and Move."},{"p":"splats.html","c":"Gaussian splats","a":"make-a-capture-sculptable","h":"Make a capture sculptable","t":"Make sculptable (under From scan in the Splats palette) turns the capture into a clean SubTool 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's colours. The splats stay, hidden. It has its own chapter: From scan to sculptable mesh."},{"p":"splats.html","c":"Gaussian splats","a":"turn-a-sculpt-into-splats","h":"Turn a sculpt into splats","t":"Sculpt to splats (in the Splats palette when no splats are loaded, or from the command palette) covers the visible SubTools 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. From a script you can choose the number of splats and whether to bake shading: sculptforge-cli -c 'open path=bust.glb; mesh_to_splats count=500000 shading=true; splat_save path=bust.ply'"},{"p":"splats.html","c":"Gaussian splats","a":"save-splats","h":"Save splats","t":"Click Save splats... in the Splats palette, or File > Save Splats.... Choose the format by the file type: PLY (for SuperSplat, Postshot and most tools), glTF (.glb with KHR_gaussian_splatting) or OpenUSD (.usda / .usdz). The splat_save command also writes .splat. Placement you made with Flip, Turn 90 and Fit 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. When you export USD (File > Export USD / USDZ...) with splats loaded, they are included in the same file as a ParticleField3DGaussianSplat prim next to the meshes. Projects (.sfproj) keep loaded splats and their placement. Clear in the Splats palette removes the capture."},{"p":"splats.html","c":"Gaussian splats","a":"from-scripts","h":"From scripts","t":"Command What it does Key parameters open Loads a capture as a reference next to the sculpt path splat_info Reports the loaded splats splat_transform Rotates and places the capture rotate_x, rotate_y, rotate_z (degrees), fit, reset splat_clean Removes faint splats and floaters min_opacity (default 0.05), keep (0.5 to 1, default 0.98) splat_to_mesh Make sculptable: a new SubTool with quads, face loops and colour (details) detail (default 256), preset (game, film, sculpt), color (polypaint, texture, none), crop, face_guides splat_test_capture Loads a built-in test capture (a head or a mug) kind mesh_to_splats Turns the visible SubTools into splats count (default 250000), shading (default true) splat_save Saves .ply, .splat, .glb, .usda or .usdz path splat_clear Removes the splats A complete phone-capture-to-game-asset pipeline: sculptforge-cli -c 'open path=scan.ply; splat_transform rotate_x=180 fit=true; splat_to_mesh preset=game color=texture; export_glb path=asset.glb' To render only the splats headless, use sculptforge scan.ply --render scan.png --hide-mesh (see Scripting and automation)."},{"p":"splats.html","c":"Gaussian splats","a":"see-also","h":"See also","t":"From scan to sculptable mesh: Make sculptable in detail Image and text to 3D: another way to get a base mesh Subdivide, Remesh, Decimate and LODs: clean up a converted mesh Exporting: USD and glTF exports that carry splats"},{"p":"scan-to-splat.html","c":"Scan an object into a splat","a":"","h":"Scan an object into a splat","t":"Walk around a clay maquette, a prop or a toy with your phone, and SculptForge turns the video or photos into a Gaussian splat in the viewport. You watch it sharpen while it trains, and you can orbit around it the whole time. From there you can sculpt against it, make it sculptable, or save it for a splat viewer or a game engine. Nothing is uploaded: everything runs on your own computer."},{"p":"scan-to-splat.html","c":"Scan an object into a splat","a":"what-you-need","h":"What you need","t":"A phone or a camera. Any phone that films 1080p or better works. You don't need a special app. A graphics card. Training runs on the GPU: NVIDIA, AMD or Intel on Windows and Linux, or an Apple silicon Mac. No CUDA is needed. A gaming GPU trains a Fast preview in a few minutes. Three free tools, which SculptForge runs as separate programs: Tool What it does How you get it Brush (Apache-2.0) Trains the splat SculptForge offers to download it the first time (about 45 MB on Linux and macOS, 160 MB on Windows) COLMAP (BSD) Works out where each photo was taken Windows: offered as a download (128 MB). Linux: your distribution's colmap package. macOS: brew install colmap ffmpeg Reads frames from a video Usually installed already; Linux: the ffmpeg package, macOS: brew install ffmpeg Captures from the SculptForge phone link that carry the phone's own camera positions, and COLMAP or nerfstudio datasets, don't need COLMAP. Photo folders don't need ffmpeg."},{"p":"scan-to-splat.html","c":"Scan an object into a splat","a":"capture-tips","h":"Capture tips","t":"The capture decides the quality far more than the settings do. Pick a matte object. Clay, wood, stone, painted plastic and fabric scan well. Shiny metal, glass, mirrors, water and see-through plastic don't: the trainer can't tell reflections from surface. Avoid thin and fuzzy parts such as hair, fur, wire, antennas and leaves, or expect them to come out soft. Use even, soft light. An overcast day, a room with daylight from several windows, or two lamps bounced off the walls. Avoid hard shadows, and don't move the lights or let your own shadow fall on the object. Give it texture. A plain white object on a plain white table is hard to place; put it on a patterned cloth or a newspaper. Walk all the way around. Keep the object in the middle, filling about half the frame. Go round once at eye level and once a little higher, looking down. Every part of the object should be seen from several sides. Move slowly and smoothly. Each view should overlap the last by about two thirds. Blurred frames are dropped automatically, but a capture that is blurred everywhere can't be fixed. Keep the object still, and don't use a turntable: the background would not turn with it. Length: a 20 to 60 second video, or 40 to 150 photos."},{"p":"scan-to-splat.html","c":"Scan an object into a splat","a":"train-a-splat","h":"Train a splat","t":"Open the Splats palette (the Splats menu, or press F3 and type \"train\"). Under Train from capture, pick a preset: Fast preview or Quality. Click Video... and pick the video, or Photos Folder... and pick the folder of photos. You can also drop a video file onto the window. Captures sent from the phone link start by themselves. The first time, a window asks to download Brush. It says what it downloads, from where and how big it is; nothing is downloaded until you click Download Brush. The download is checked against its SHA-256 checksum before it is used. If you already have Brush, click Choose Brush... instead. Training then runs in the background, in three stages: Stage What happens Frames A video is read at 5 frames a second and the sharpest frame of each moment is kept (80 for Fast preview, 200 for Quality). Photos are used as they are Camera positions COLMAP finds where each photo was taken (skipped when the capture already knows) Training Brush trains the splat. Every few hundred steps the viewport shows the latest result The panel over the viewport shows the step, the quality so far, how long it has run and roughly how long is left: PSNR compares the splat with photos it was not trained on, in decibels. Under 18 is rough, 22 to 26 is good and over 26 is sharp. A PSNR that stops rising means more training won't help much. Good enough - stop ends training and keeps what it has learned so far as the result. Cancel ends training and saves nothing. You can orbit, pan and zoom while it trains. While the splat trains, the sculpt is hidden so the splat isn't inside it; tick Show mesh in the Splats palette to bring it back."},{"p":"scan-to-splat.html","c":"Scan an object into a splat","a":"presets","h":"Presets","t":"Preset Steps Image size Frames from a video Colour Fast preview 5,000 up to 1024 px 80 simple view-dependent colour (SH 1) Quality 30,000 up to 1920 px 200 full view-dependent colour (SH 3) Start with Fast preview to check the capture, then train Quality from the same capture."},{"p":"scan-to-splat.html","c":"Scan an object into a splat","a":"where-the-result-goes","h":"Where the result goes","t":"The finished splat is saved as a PLY next to the capture: for a folder: /splat/.ply for a video: -splat/.ply beside the video A copy goes into the Splats tab of the LightBox, so you can open it again later. The work folder beside the result holds the frames, the camera positions and the logs (brush.log, colmap.log); you can delete it. The splat comes in centred and upright: SculptForge uses the camera positions to put the object at the middle of the scene with the cameras' \"up\" pointing up. Use Flip, Turn 90 and Fit in the Splats palette if it still needs a turn. Then: Make it sculptable. Lower the opacity and sculpt against it as a reference. Save splats... to .ply, .splat, .glb or .usdz for other apps."},{"p":"scan-to-splat.html","c":"Scan an object into a splat","a":"tools-and-settings","h":"Tools and settings","t":"The Tools section of Train from capture shows which tools were found. SculptForge looks for each one in this order: An environment variable: SCULPTFORGE_BRUSH, SCULPTFORGE_COLMAP or SCULPTFORGE_FFMPEG (the full path of the program). Studios can point every workstation at a shared, approved build this way. The program chosen with Choose Brush... or Choose COLMAP.... A download made by SculptForge, in the tools folder of SculptForge's settings folder. brush_app, colmap and ffmpeg on the PATH. There is no ready-made Brush for Linux on ARM (for example Asahi Linux on an Apple silicon Mac) or for Intel Macs. Build it from its source with Rust (cargo build --release in a Brush checkout) and choose the brush_app it builds."},{"p":"scan-to-splat.html","c":"Scan an object into a splat","a":"from-the-command-line","h":"From the command line","t":"splat_train works in scripts, sculptforge-cli, Python and the MCP server. There it waits until training has finished, then loads the result: sculptforge-cli -c \"splat_train source=walkaround.mp4 preset=fast; splat_save path=walkaround.glb\" Parameter Meaning source A video, a folder of photos, a phone-link capture folder, or a COLMAP / nerfstudio dataset out Where to put the result and the work files (default: next to the capture) preset fast or quality In the app, splat_train starts training in the background and splat_train_cancel stops it (splat_train_cancel finish=true is Good enough - stop)."},{"p":"scan-to-splat.html","c":"Scan an object into a splat","a":"captures-with-camera-positions","h":"Captures with camera positions","t":"A capture folder can say where every photo was taken, which skips COLMAP. The phone link writes this in its capture.json; other tools can too: {\"kind\": \"splat\", \"device\": \"...\", \"files\": [\"IMG_0000.jpg\", \"...\"], \"fl_x\": 1450, \"w\": 1920, \"h\": 1440, \"frames\": [{\"file\": \"IMG_0000.jpg\", \"transform_matrix\": [[...], [...], [...], [0, 0, 0, 1]]}]} transform_matrix is the camera-to-world transform, row by row, with the camera looking down its -Z axis and +Y up (the OpenGL and nerfstudio convention, the same as ARKit and WebXR). fl_x, fl_y, cx, cy, w and h are in pixels and can also be given per frame. Folders that already contain a COLMAP model (images and sparse/0) or a nerfstudio transforms.json are trained as they are."},{"p":"scan-to-splat.html","c":"Scan an object into a splat","a":"if-it-goes-wrong","h":"If it goes wrong","t":"\"COLMAP could not place the cameras\": too few views overlap, the photos are blurred, or the object is shiny or plain. Capture again more slowly, with more texture around the object. The details are in work/colmap.log. \"Brush stopped with an error\": often the graphics card ran out of memory. Try Fast preview, close other GPU-heavy programs, or update the graphics driver. The details are in work/brush.log. The splat is cloudy or full of floaters: train Quality, then use Clean floaters. Shiny and see-through parts stay cloudy whatever you do. Only part of the object came out: the other side wasn't seen from enough angles. Walk around again."},{"p":"scan-to-sculptable.html","c":"From scan to sculptable mesh","a":"","h":"From scan to sculptable mesh","t":"A Gaussian-splat capture looks great but you can't sculpt, rig or animate it. Make sculptable turns it into a clean SubTool you can: a watertight surface with the floaters and background gone, quad topology at the polygon budget you choose, edge loops round the eyes and mouth when the capture is a head, and the capture's colours as polypaint or a texture. One click, in the background, with the splats kept next to the result. A test head capture, the review of its face landmarks and loops, and the finished quads with its colours"},{"p":"scan-to-sculptable.html","c":"From scan to sculptable mesh","a":"one-click","h":"One click","t":"Load a capture (see Gaussian splats): File > Open... or drop a .ply, .splat, .glb or .usdz onto the window. Place it with Flip, Turn 90 and Fit if it arrives upside down. For a head, turn the view so you look at the face, roughly from the front (within about 40 degrees is enough). The face is looked for from the current view. In the Splats palette, under From scan, click Make sculptable. A progress bar and Cancel show while it works. When it's done: a new SubTool named after the capture holds the sculptable mesh, and is active; a hidden \" Scan\" SubTool keeps the dense voxel surface it was made from (turn off Keep scan if you don't want it); the splats are hidden, not deleted (Show in the Splats palette brings them back); an untouched starting sphere is hidden too. No capture at hand? Try a test head in the Splats palette (shown while no splats are loaded) loads a built-in one: a stylised head as 200,000 coloured splats with a few floaters and the hidden inside splats real captures have. splat_test_capture kind=object loads a mug with a thin handle instead. The From scan section of the Splats palette"},{"p":"scan-to-sculptable.html","c":"From scan to sculptable mesh","a":"the-options","h":"The options","t":"Control What it does Detail How finely the surface follows the capture, in voxels across the subject (96 to 512, default 256). Higher keeps thinner parts and more detail and takes longer Game / Film / Sculpt The polygon budget. Game: about 4,000 quads, for real-time characters and props. Film: about 12,000 quads, for close-ups and smooth deformation. Sculpt: a 2,000-quad base with two subdivision levels, the scan's detail projected onto the top level, so you sculpt with levels straight away Face loops When the capture is a head: find the eyes, nose, mouth and chin and give QRemesh edge loops round the eyes and mouth and along the nasolabial folds, mirrored across the face (see below) Review Stop after the scan to check the face landmarks and the loops before remeshing Polypaint / Texture Where the capture's colours go: the vertices (polypaint), or a 2K texture on automatic UVs (sharp colour on a light mesh, for games and exports) Keep scan Keep the dense voxel surface as a hidden \" Scan\" SubTool, to ProjectAll more detail from later Crop Box Only the splats inside the box count (see below) More > Min Opacity Splats fainter than this are ignored (haze and floaters are usually faint). Default 0.2 More > Close Gaps Seal gaps up to this many voxels between splats. Default 2 More > Fill holes Fill big holes such as the open bottom of a subject that stood on a table. Turn it off for open cavities like a cup More > All pieces Keep every solid piece instead of only the largest (the floaters come back too) Hold Ctrl and point at any of them for help; F3 finds Make sculptable, Finish, Place by hand and Crop Box by name."},{"p":"scan-to-sculptable.html","c":"From scan to sculptable mesh","a":"face-loops-animation-topology-for-heads","h":"Face loops: animation topology for heads","t":"Faces deform around the eyes and the mouth, so animation topology has rings of edges there and a loop from the nose down past the mouth corners (the nasolabial fold), the same on both sides. With Face loops on, Make sculptable looks for a face on the scan as seen from the current view: a depth and colour picture of it, the middle line where it is mirror-symmetric, the nose as the strongest bump on that line, the eyes as a matching pair of hollows (and darker spots) above it, the line between the lips below it, then the chin. From those eight landmarks (the corners of both eyes, the nose tip, the mouth corners, the chin) it draws QRemesh Guides for QRemesh to follow: a ring round each eye, and a bigger one round the eye socket when the polygon budget is high enough for it; a ring round the lips; the nasolabial loop: from each side of the nose down the fold past the mouth corner and under the lower lip; all of them mirrored across the face, and QRemesh's symmetry on, so both halves get the same edge flow. The guides stay on the result SubTool, so you can QRemesh it again at another density (Geometry > QRemesh) and the loops come back. Small loops are left out at low budgets, where they couldn't come out as clean rings. If no face is found (the status bar says why), the result is remeshed without face loops. Turn the view to face the head and run it again, or use Review and place the landmarks by hand."},{"p":"scan-to-sculptable.html","c":"From scan to sculptable mesh","a":"review-and-nudge-the-landmarks","h":"Review and nudge the landmarks","t":"With Review on, Make sculptable stops after the scan: the \" Scan\" SubTool shows with the landmarks as blue dots and the guide loops as orange lines. Drag a dot to move a landmark onto the right spot. Its partner on the other side follows (mirrored), and the loops are rebuilt when you let go. Place by hand asks for the eight landmarks one click at a time (the panel and the cursor say which is next): the outer and inner corner of the eye on the left of the screen, the inner and outer corner of the other eye, the nose tip, the left and right mouth corners, the chin. Find again looks for the face again from the current view. Finish remeshes the scan along the loops and colours it; Back leaves the review and keeps the scan."},{"p":"scan-to-sculptable.html","c":"From scan to sculptable mesh","a":"the-crop-box","h":"The crop box","t":"Captures usually include the ground, a table or the room. Make sculptable keeps only the largest solid piece, which drops floaters, but a table the subject stands on is joined to it. Click Crop Box: a yellow box appears round the capture with a handle on each face. Drag a handle to move that face (drag the bottom one up to cut the table away), then Make sculptable: only the splats inside the box count. The box shows while the splats are shown; click Crop Box again to turn it off."},{"p":"scan-to-sculptable.html","c":"From scan to sculptable mesh","a":"what-happens-inside","h":"What happens inside","t":"Surface. Every Gaussian adds its opacity-weighted density to a voxel grid (in parallel, with the same result on any number of threads). Where the density is high enough is the shell of the subject; small gaps close, small separate pieces of shell (floaters) are dropped, and space boxed in by the shell on five of six sides counts as inside, which seals big holes such as an open bottom. The outside is flooded from the edges, the largest solid piece is kept, and a smooth watertight surface is made from it. Colour. Each vertex (or texel) takes the colour of the splats around it, weighted by their opacity and distance. Splats behind the surface, inside the subject, are faded out: trained captures fill the inside with splats of any colour. Topology. QRemesh rebuilds the scan as quads at the budget's polygon count, along the face guides, with symmetry. Sculpt then divides it twice and projects the scan onto the top level (as ProjectAll does)."},{"p":"scan-to-sculptable.html","c":"From scan to sculptable mesh","a":"speed","h":"Speed","t":"Measured on an M1 Pro laptop (10 cores, 2021) with the built-in test head at Film density, from click to the finished SubTool: Splats Detail 256 Detail 384 Detail 512 Peak memory (512) 1 million 3.4 s (surface 1.3 s) 5.5 s (surface 2.6 s) 8.8 s (surface 5.1 s) 1.0 GB 5 million 7.2 s (surface 4.2 s) 9.1 s (surface 5.6 s) 13.2 s (surface 8.0 s) 1.2 GB The rest of the time is QRemesh and colour. Everything runs on the CPU, so a studio PC with more cores is faster; no GPU or CUDA is needed."},{"p":"scan-to-sculptable.html","c":"From scan to sculptable mesh","a":"how-good-is-it","h":"How good is it?","t":"What works well: Watertight, manifold surfaces every time (no holes, no non-manifold edges), with floaters and stray background pieces dropped and open bottoms sealed. Faithful colour: on test captures with known colours the transferred polypaint is within a few percent of the original, and the wrongly coloured splats inside the subject don't bleed through. Clean quads (97% or more) with symmetric rings round the eyes and mouth on faces it finds. Thin parts survive down to a few voxels across (a mug handle at Detail 160 stays a handle, its hole open). What to expect: The scan has a fine ripple (voxel-scale, a little like orange peel) where the capture's splats are sparse; the quad result smooths it out, but the Sculpt preset projects it onto the top level, where the Smooth brush takes it away. The surface sits about a voxel outside the splats (the shell's thickness). Raise Detail to make that smaller. The face finder works from geometry and colour, not a trained model: it is reliable on clear faces seen from the front (busts, maquettes, game heads) and can miss on heavily stylised faces, closed-eye or beard-covered ones, profiles, or a head that isn't upright in the view. Then use Review and Place by hand. Fill holes also fills deep open cavities (the inside of a cup, an open mouth); turn it off for those. Hair and fur become a solid shell, as with any surface reconstruction. Splat captures carry view-dependent colour; Make sculptable uses the base colour of each splat (no reflections or highlights baked in), which is what you want for a sculpt."},{"p":"scan-to-sculptable.html","c":"From scan to sculptable mesh","a":"from-scripts","h":"From scripts","t":"The same pipeline runs from the console, sculptforge-cli, MCP and Python: Command What it does Key parameters splat_to_mesh Make sculptable detail (32 to 768, default 256; resolution is the same), preset (game, film or sculpt), target (quads; 0 keeps the voxel surface), levels, face_guides (auto or off), landmarks (JSON, instead of finding them), front, up (the face's directions, default \"0 0 1\" and \"0 1 0\"), color (polypaint, texture or none), texture_size, crop (\"minx miny minz maxx maxy maxz\"), min_opacity, keep, close, fill_holes, keep_parts, smooth, symmetry, keep_scan, stage (all, scan or finish), seed face_guides Finds a face on the active SubTool (or takes landmarks) and replaces its QRemesh Guides with the face loops; the message ends with the landmarks as JSON landmarks, front, up, target splat_test_capture Loads the built-in test head or mug capture kind (head or object), count, floaters, open_bottom # A scan to a textured game asset, in one go. sculptforge-cli -c 'open path=bust.ply; splat_transform rotate_x=180 fit=true; splat_to_mesh preset=game color=texture; export_glb path=bust.glb' # The app's review in two steps: the scan with its face guides (the message lists the landmarks found), then the # quads along those guides. sculptforge-cli -c 'open path=head.ply; splat_to_mesh stage=scan preset=film; splat_to_mesh stage=finish preset=film; export_glb path=head.glb' To correct the landmarks from a script, run face_guides between the two stages with landmarks= set to the JSON the scan stage printed, edited: {\"eye_outer_l\": [x, y, z], \"eye_inner_l\": [...], \"eye_inner_r\": [...], \"eye_outer_r\": [...], \"nose_tip\": [...], \"mouth_l\": [...], \"mouth_r\": [...], \"chin\": [...]} (l is the side on the left of the screen when looking at the face). Each run in the app is echoed to the console as a splat_to_mesh line (with the landmarks when you reviewed them), so you can copy it into a batch script."},{"p":"scan-to-sculptable.html","c":"From scan to sculptable mesh","a":"see-also","h":"See also","t":"Gaussian splats: loading, placing and saving captures Quad retopology and detail projection: QRemesh, QRemesh Guides and ProjectAll Subdivision levels: sculpting the Sculpt preset's levels Texture painting: painting on the Texture result"},{"p":"phone-capture.html","c":"Phone capture and AR","a":"","h":"Phone capture and AR","t":"Your phone becomes SculptForge's camera and second screen. Scan an object by walking around it, send a photo to turn into a model, bring in a splat from a scanning app, look at your sculpt standing on your real desk in AR, and drive a character's face with your own. There is no app to install and no account: the phone's browser talks to SculptForge over your Wi-Fi."},{"p":"phone-capture.html","c":"Phone capture and AR","a":"pair-your-phone","h":"Pair your phone","t":"Choose File > Capture from phone (or the phone button in the LightBox's header). A window opens with a QR code. Point the phone's camera at the QR code and tap the link it shows. The capture page opens, already paired with this window: the badge at its top shows your computer's name. The phone and the computer must be on the same Wi-Fi. If the phone has no QR scanner, open the address shown under the code in its browser and type the 6-digit pairing code. The link works only while the window is open: closing it stops SculptForge listening, and the next time you open it there is a new code. A code nobody uses expires after 10 minutes. Tip: The phone can't open the page? Check that it isn't on a guest network or mobile data, turn off VPNs on both devices, and allow SculptForge through the firewall (Windows asks the first time; choose private networks). If the computer has several networks, pick the Wi-Fi one under Network in the window."},{"p":"phone-capture.html","c":"Phone capture and AR","a":"scan-an-object","h":"Scan an object","t":"Tap Scan an object, read the tips, and tap Record a video. Walk slowly all the way round the object, then once more a little lower, for 20 to 60 seconds: slow and steady, no quick turns; soft, even light, without hard shadows or shiny reflections; the whole object in the middle of the screen, at about the same distance all the way (don't zoom). You can also send a video you already took, or 20 to 200 photos (Choose photos). The page warns you when a video is very short or very long. Tap Send to SculptForge: the upload shows its progress on the phone and in SculptForge's window. Big videos over shaky Wi-Fi are fine: the page sends them in pieces and carries on where it stopped if the connection drops. Keep the page open and the screen on until it says Sent. What arrives is saved in your library's Captures folder (see below) and handed to splat training, which turns it into a Gaussian splat that sharpens in the viewport while it trains. See Gaussian splats."},{"p":"phone-capture.html","c":"Phone capture and AR","a":"one-photo-to-3d","h":"One photo to 3D","t":"Tap One photo to 3D and take a photo (or choose one). One object, the whole of it in the picture, on a plain background works best. SculptForge loads it into Generate > Image to 3D and starts generating with the service chosen there (free Hugging Face models by default). Turn off Generate from a photo at once in the window to check the photo first and press Generate yourself. See Image and text to 3D. The phone sends large photos at about 2048 pixels, which is plenty and much faster."},{"p":"phone-capture.html","c":"Phone capture and AR","a":"send-a-splat-file","h":"Send a splat file","t":"Already scanned it with Scaniverse, Polycam or Luma? Export a Gaussian splat .ply from the app, tap Send a splat file and choose it. It opens next to your sculpt as a splat. A .ply that is a plain mesh becomes a new SubTool instead, so it never replaces your work."},{"p":"phone-capture.html","c":"Phone capture and AR","a":"view-in-ar","h":"View in AR","t":"Tap View in AR, choose what to show (the Active SubTool or the Whole scene) and how big it should be on the desk (10 cm to 1 m), then Get the model. SculptForge prepares a phone-friendly copy: reduced to about 80,000 triangles, its polypaint or texture baked into one texture, standing on its base. When it is ready, tap View in AR and point the phone at a desk or the floor. iPhone and iPad open it in AR Quick Look (a USDZ file). Android opens it in Google's Scene Viewer (a GLB file; needs Google Play Services for AR). Download the model saves the file instead. Keep sculpting: while the phone is looking, every few seconds after a stroke SculptForge exports the model again and the page says Updated from your sculpt. Tap View in AR again to see the change. Turn off Update after each stroke in the window to stop that."},{"p":"phone-capture.html","c":"Phone capture and AR","a":"face-capture","h":"Face capture","t":"Tap Face capture, then Start face capture. Your phone's front camera tracks your face with MediaPipe Face Landmarker, which runs on the phone: the video never leaves it. About 30 times a second only the 52 expression weights (the ARKit set: jawOpen, eyeBlinkLeft, mouthSmileRight...) and the head's rotation go to SculptForge. Prop the phone up at eye level, about an arm's length away, with light on your face. The window's Face section shows a little face following yours and the frame rate. The weights drive the character's facial shapes on the active SubTool (made with Generate facial shapes). If the character winks with the wrong eye, tick Mirror left and right. Record face take records the feed until you press it again. Each take is saved in the Captures folder as take.jsonl: one line per frame with the 52 weights, the head rotation and the time, ready to play back or export. Note: The camera only works on secure (HTTPS) pages, so the face page lives on the SculptForge website. The address it opens carries the connection details after a #, which browsers never send to the website. To set up the connection the phone sends one encrypted message through SculptForge's relay (or ntfy.sh, a free public relay, if ours can't be reached); neither can read it. Without internet, tap Connect without internet on the face page. After that the face data goes straight over your Wi-Fi."},{"p":"phone-capture.html","c":"Phone capture and AR","a":"the-captures-folder","h":"The Captures folder","t":"Everything the phone sends is saved in your library (the folder the LightBox shows, normally Documents/SculptForge), under Captures, one folder per capture: Captures/2026-10-26_195803-splat/scan.mov Captures/2026-10-26_195803-splat/capture.json Captures/2026-10-26_201544-photo/IMG_0412.jpg Captures/2026-10-26_203012-face/take.jsonl capture.json records the kind (splat, photo, ply or face), the device, the files and the times. The window's Received list opens a capture's folder."},{"p":"phone-capture.html","c":"Phone capture and AR","a":"privacy-and-security","h":"Privacy and security","t":"Only devices on your local network can connect, and only while the window is open. Every request needs the session's secret token (it is in the QR code) or the pairing code. Uploads have size limits (4 GB a file, 8 GB a capture), file names are cleaned, and files are written only inside the Captures folder. Nothing you capture is uploaded anywhere except to your computer. A photo goes on to the image-to-3D service you chose in SculptForge, as it does when you pick it yourself."},{"p":"baking.html","c":"Baking normal and displacement maps","a":"","h":"Baking normal and displacement maps","t":"Game engines and renderers want light meshes. Baking captures the detail of your high-poly sculpt as images laid over the UVs of a low-poly version: a normal map makes the low-poly shade as if it had every crease and pore, a displacement map stores how far the surface moves, and ambient occlusion, cavity and colour maps feed materials. Tool > Bake makes all of them in one go, in the background, and shows the normal map on the low-poly right away so you can compare it with the sculpt. A 330,000-triangle sculpt (left) next to its 2,000-triangle low-poly wearing the baked normal map (right), with Tool > Bake open"},{"p":"baking.html","c":"Baking normal and displacement maps","a":"what-you-need","h":"What you need","t":"A high-poly source: one or more SubTools with the detail. They stay as they are. A low-poly SubTool with UVs, in the same place as the high-poly. It can come from another app (import it with Tool > SubTool > Append; models with UVs keep them), or you make it in SculptForge: Duplicate the sculpt, Tool > Geometry > Decimate it, then Tool > Texture Map > Auto UV. The maps go onto the active SubTool, so select the low-poly before baking."},{"p":"baking.html","c":"Baking normal and displacement maps","a":"bake-in-five-steps","h":"Bake in five steps","t":"Select the low-poly SubTool and open Tool > Bake in the right tray. The first line says which SubTool the maps go onto, or \"No UVs\" if it needs Auto UV first. Source: leave All visible SubTools to bake from everything that is shown (except the low-poly), or pick one SubTool. Tick the maps you want, and choose the size (1K, 2K, 4K or 8K). Click Bake. A progress bar shows while it works on every processor core; you can keep working, or click Cancel Bake. When it is done, the status line reports what was baked and where the files went, and the low-poly shows its normal map. Hide the high-poly (Tool > SubTool, the eye) to compare, or untick Preview Normal Map to see the bare low-poly."},{"p":"baking.html","c":"Baking normal and displacement maps","a":"the-maps","h":"The maps","t":"Map File What it holds Normal (tangent) _normal.png The high-poly's surface direction relative to the low-poly, in tangent space. The map for game engines Normal (object) _normal_object.png The high-poly's normals in model space. For tools that want object-space maps Displacement _displacement.png and .exr The distance from the low-poly to the high-poly along the low-poly's normal Ambient Occlusion _ao.png How much of the sky each point sees: darker in creases, folds and cavities Cavity _cavity.png The fine surface curvature: mid-grey where the surface is smooth, dark in cracks, light on ridges Colour _color.png The source's polypaint, or its painted texture is the low-poly SubTool's name. Colour is skipped when the source has neither polypaint nor a texture."},{"p":"baking.html","c":"Baking normal and displacement maps","a":"tangent-space-normal-maps-that-look-right-everywhere","h":"Tangent-space normal maps that look right everywhere","t":"SculptForge computes tangents with MikkTSpace, the same method Blender, Unreal Engine, Unity, Godot, Substance and xNormal use. A map baked here shows correctly in all of them, as long as the low-poly is exported with its normals and UVs (every SculptForge export keeps them). Choose the green channel convention under the map settings: OpenGL (Y+): Blender, Unity, Godot, Substance, three.js. The default. DirectX (Y-): Unreal Engine's native convention. Send to Unreal flips an OpenGL map on import (see below), so you only need DirectX when you import into Unreal by hand."},{"p":"baking.html","c":"Baking normal and displacement maps","a":"displacement-mid-grey-is-zero","h":"Displacement: mid-grey is zero","t":"The 16-bit PNG stores zero displacement as mid-grey, the high-poly outside the low-poly as lighter and inside as darker. White means +scale and black -scale in world units; the scale is the largest distance found, shown under the Bake button (\"Displacement: mid-grey = 0, white = +0.0143\") and in the status line. Use it as the displacement strength in your renderer (with a midlevel of 0.5). With EXR displacement ticked, a 32-bit float OpenEXR holds the real distances in world units, with no scale to set."},{"p":"baking.html","c":"Baking normal and displacement maps","a":"settings","h":"Settings","t":"Setting What it does Source The high-poly: one SubTool, or every visible SubTool except the active one. Hidden faces of the source are ignored Size 1K, 2K (default), 4K or 8K square AA Anti-aliasing: 1 to 4 means 1, 4, 9 or 16 rays per texel, averaged. 2 (the default) gives clean edges Auto distance Measure how far the high-poly lies in front of and behind the low-poly, and cast rays just that far. After a bake, Front and Rear show what it measured Front / Rear With Auto off: how far in front of the low-poly rays start, and how far behind it they look, as a percentage of the model's size (its bounding-box diagonal). ZBrush and Substance call these the max frontal and rear distances Padding Texels around each UV island filled with the island's edge colours, so seams don't show once an engine mipmaps the map. 8 suits 2K; use 16 for 4K and 8K OpenGL / DirectX The normal map's green channel convention (see above) AO rays, AO reach Ambient occlusion quality, and how far away geometry still darkens a point (a percentage of the model's size) Output folder Where the files go. Empty: beside your last export, else the project's folder, else Bakes in your library folder. Open Folder shows it after a bake EXR displacement Also write the displacement as a 32-bit float EXR"},{"p":"baking.html","c":"Baking normal and displacement maps","a":"how-the-bake-works","h":"How the bake works","t":"For every texel of the low-poly's UVs, SculptForge finds the matching point on the low-poly and casts a ray along its smoothed normal, from Front outside the surface to Rear inside it (a \"cage\"), and keeps the high-poly hit nearest to the low-poly. The normal, distance, occlusion and colour found there go into the maps. Rays follow the smoothed normals, so hard edges of the low-poly don't leave gaps. Missing detail (\"x% of texels found no surface\" in red under the Bake button): rays didn't reach the high-poly. Turn off Auto distance and raise Front and Rear. Detail from the wrong place (for example the inside of an ear showing on its back): the rays reach too far. Lower Rear (or Front), or bake the parts from separate SubTools with Source. The bake works on copies, so you can keep sculpting meanwhile. If the low-poly's triangles or UVs change afterwards, the normal map preview turns off because it no longer fits (undo brings it back). Tip: Bake time grows with the map area and the number of rays. On a 10-core Apple M1 Pro, from a 1.3-million-triangle sculpt: a 4K tangent normal map plus displacement (AA 2) takes about 4 seconds, the same at 8K about 11 seconds. Ambient occlusion costs the most: adding it at 4K with 48 rays per texel brings the bake to about 30 seconds. Try settings at 1K, then bake the final maps at 4K."},{"p":"baking.html","c":"Baking normal and displacement maps","a":"send-to-unreal-with-the-normal-map","h":"Send to Unreal with the normal map","t":"When the last bake made a normal map, its low-poly SubTool is shown and still fits the map, Send to Unreal (Tool > Export) imports the map too, as T__N next to the mesh, set up as a normal map (linear, normal map compression), with Unreal's Flip Green Channel set for an OpenGL map. This works with an Unreal Editor on the same computer; for one on another computer, import the PNG by hand. See Exporting, Unreal and ZBrush."},{"p":"baking.html","c":"Baking normal and displacement maps","a":"commands","h":"Commands","t":"Command What it does bake Bake onto the active SubTool and write the maps. Options: source=all or a SubTool name, maps=normal,object_normal,displacement,ao,cavity,color (or all), size=2048 (512 to 8192, or 1k...8k), out=folder, name=prefix, front=0.02 and rear=0.02 (fractions of the model's size, or auto), samples=2, padding=8, ao_rays=48, ao_distance=0.05, green=opengl or directx, displacement_scale= (world units at white), exr=true For example, from the console or sculptforge-cli: subtool_select name=Body_low; bake source=Body maps=normal,ao,displacement size=4096 out=maps The command runs in the foreground (scripts wait for it); the Bake button runs the same bake in the background. See Scripting and automation."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"","h":"Exporting, Unreal and ZBrush","t":"This chapter covers getting your sculpt out of SculptForge: the export formats and what each one keeps, LOD chains for games, sending a mesh straight into a running Unreal Editor, and exchanging models with ZBrush through GoZ. To keep everything (SubTools, layers, mask, polypaint, brushes) use a project file instead; see Projects, autosave and QuickSave."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"export-formats-at-a-glance","h":"Export formats at a glance","t":"Exports write every visible SubTool. Hidden SubTools are left out. Exporting doesn't rename the document or mark it saved, so your next Ctrl+S still saves the project. Format Where in the app Keeps Use it for glTF binary (.glb) File > Export GLB... (Ctrl+E) One node per SubTool, sculpt layers as morph targets, polypaint as vertex colour, UVs and the painted texture (embedded) Games, Blender, three.js, web viewers LOD chain (.glb per level) File > Export LOD Chain... As GLB, one file per level, blend shapes on every level Game engines OpenUSD (.usda, .usdz) File > Export USD / USDZ... One Mesh prim per SubTool, quads, layers as UsdSkel blend shapes, polypaint as displayColor, UVs (primvars:st) and the painted texture through a preview material (inside a USDZ), loaded splats Film pipelines, Omniverse, Apple AR Quick Look FBX for Unreal (.fbx) File > Export FBX for Unreal... Unreal naming and scale, quads, UVs, LOD group, layers as blend shapes, the painted texture as a PNG beside it Unreal Engine (by hand) Wavefront OBJ (.obj) File > Export OBJ... One o object per SubTool, quads, polygroups as g groups, polypaint as vertex colour, UVs, the painted texture through a .mtl (map_Kd) and a PNG beside it. Layers are baked into the current blend Any 3D app, ZBrush ZBrush GoZ (.GoZ) File > ZBrush (GoZ) > Export GoZ... Quads, polygroups, mask, polypaint, UVs, the painted texture as a PNG beside it ZBrush STL (.stl) File > ZBrush (GoZ) > Export STL... Geometry only (triangles), visible SubTools merged, in millimetres with Z up 3D printing PLY (.ply) export_ply command Geometry, quads and polypaint, visible SubTools merged Scan tools, MeshLab, Blender FBX (general) export_fbx command One model per SubTool, quads, UVs, blend shapes, optional LOD groups, the painted texture Other FBX pipelines The GLB, LOD chain and FBX for Unreal exports are also in the Tool palette under Export, together with the LOD and Unreal settings. \"Quads\" means the quads the model came in with (or got from Plane, Cube, Subdivide or Voxel Remesh) are written as quads, the rest as triangles; see Quads and triangles. glTF and STL can only hold triangles. The Tool > Export sub-palette with a generated LOD chain and the Unreal Engine settings UVs are kept through OBJ, FBX, USD, glTF and GoZ, in and out. A SubTool with a painted texture is exported with it: the PNG is written next to the file as _color.png (__color.png with several SubTools) and referenced by the model, or embedded in GLB and USDZ files. Spaces in the file name become _ in the names of the files written beside it (my scene.obj gets my_scene.mtl and my_scene_color.png), because OBJ and MTL separate file names with spaces. Tool > Texture Map > Auto UV gives any sculpt UVs before export. Normal, displacement and other maps come from Tool > Bake as separate image files. Textured exports are checked against other tools, not only read back by SculptForge: GLB files pass the Khronos glTF validator with no errors or warnings; USD and USDZ files pass OpenUSD's validators (the USDZ files are uncompressed, 64-byte aligned and have the root layer first); FBX files load in ufbx's strict mode with their textures connected; and in all four formats plus OBJ, the texture is sampled the right way up (each format's UV convention), checked colour by colour against SculptForge's own sampling. The scripts are in tools/export_check/ in the source tree."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"scale-and-axes","h":"Scale and axes","t":"glTF, USD and OBJ are written Y-up with 1 unit = 1 metre, the same space you sculpt in. FBX uses centimetres: export_fbx multiplies positions by 100 by default (scale=), so 1 unit = 1 m. STL is written in millimetres with Z up, as slicers expect: a 0.3 m sculpt prints 300 mm tall, standing upright. export_stl height_mm=80 scales it to a print height instead (see 3D printing). Opening an STL converts back, so a downloaded print model comes in upright and at its real size. STL files from SculptForge 0.5 and earlier (metres, Y up) are recognised and open as they were saved. PLY keeps positions as they are (no unit conversion). For Unreal, Height sets the real-world size directly (see below)."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"export-a-model","h":"Export a model","t":"Show the SubTools you want to export and hide the others (the eye icon in Tool > SubTool). Choose the export in the File palette and pick a file name. The status line confirms the export (\"Exported ...\"). A SubTool with subdivision levels is exported at the level you are on. To write the base cage (or any other level) without stepping to it, use subdiv_export path=base.obj level=1. From a script, each format is one command: sculptforge-cli -c 'open path=bust.sfproj; export_glb path=bust.glb' sculptforge-cli -c 'open path=bust.sfproj; export_usd path=bust.usdz' sculptforge-cli -c 'open path=bust.sfproj; save_obj path=bust.obj' sculptforge-cli -c 'open path=bust.sfproj; export_fbx path=bust.fbx lods=3 ratio=0.5' sculptforge-cli -c 'open path=bust.sfproj; export_stl path=bust.stl; export_ply path=bust.ply'"},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"3d-printing","h":"3D printing","t":"File > ZBrush (GoZ) > Export STL... writes every visible SubTool as one binary STL, ready for a slicer (PrusaSlicer, Cura, Bambu Studio, OrcaSlicer ...). The status line gives the printed size, for example \"Exported lion.stl (47214 triangles, 320.8 x 206.6 x 436.4 mm)\": width, depth and height as the slicer shows them. Size: 1 unit in SculptForge is 1 m, so 1 unit becomes 1000 mm. To print at a given height, use export_stl path=lion.stl height_mm=80, or scale the model in the slicer. One solid: overlapping SubTools go into the file as they are, which some slicers and print services reject. Merge visible them (SubTools) and Remesh to turn them into one closed surface first. Detail: printers resolve about 0.05-0.1 mm, so millions of triangles rarely help. Decimate makes the file smaller without visible loss. sculptforge-cli -c 'open path=bust.sfproj; export_stl path=bust.stl height_mm=120' sculptforge-cli -c 'open path=bust.sfproj; export_stl path=bust.stl scale=1 z_up=false' # sculpt space as it is"},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"lod-chains-for-games","h":"LOD chains for games","t":"A LOD (level of detail) chain is the same model at decreasing triangle counts, so an engine can draw distant objects cheaply. SculptForge builds it with quadric decimation, keeping blend shapes on every level. Open Tool > Export. Set LODs (2 to 6 levels, including LOD0) and Reduction (0.1 to 0.9: the triangle ratio from one level to the next, default 0.5). Click Generate LOD chain. A table lists each level with its triangle count and its share of LOD0. Click a level (LOD0, LOD1 ...) to inspect it in the viewport; the wireframe turns on. Click Sculpt to go back to the editable mesh. Export with LOD chain (GLB per level), or send it to Unreal (below). Changing the sliders clears the preview; click Generate LOD chain to build it again. The LOD chain export writes _LOD0.glb, _LOD1.glb and so on next to the path you choose. With several visible SubTools, each SubTool is decimated on its own. sculptforge-cli -c 'open path=rock.obj; export_lods path=out/rock.glb levels=4 ratio=0.5' To reduce the sculpt itself instead of exporting copies, use Tool > Geometry > Decimate; see Subdivide, Remesh, Decimate and LODs."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"send-to-unreal","h":"Send to Unreal","t":"Send to Unreal exports an Unreal-ready FBX and imports it into a running Unreal Editor (5.x) on this computer or another one on your network. Nothing is installed into your project: it uses Unreal's built-in Python remote execution. Your sculpt What arrives in Unreal No sculpt layers A static mesh SM_ with the LOD chain from Tool > Export Sculpt layers A skeletal mesh SK_ with one morph target per layer (Unreal adds a single root bone) Several visible SubTools One FBX model per SubTool, combined into one asset on import Any A material slot M_Clay, and the real-world size from Height A baked normal map (Tool > Bake) The texture T__N, set up as a normal map (Unreal on this computer only) Sending the same asset again updates it in place (same name and folder), so references in your levels stay intact."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"one-time-setup-in-unreal","h":"One-time setup in Unreal","t":"Edit > Plugins: enable Python Editor Script Plugin, then restart the editor. Edit > Project Settings > Plugins > Python: tick Enable Remote Execution?. That's all when Unreal runs on the same computer."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"send","h":"Send","t":"Open Tool > Export and find the Unreal Engine section. Set Folder (the content folder, default /Game/SculptForge) and Height (the model's height in Unreal, in centimetres; it starts at the model's current height with 1 unit = 1 m). For a static mesh, set LODs and Reduction above (default 4 levels). Click Send to Unreal, or press Ctrl+U. The status line reports the result. The line under the buttons tells you what will be sent: \"Static mesh with 4 LODs\" or \"Skeletal mesh with 2 morph targets\"."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"unreal-on-another-computer","h":"Unreal on another computer","t":"On the Unreal machine, in Project Settings > Plugins > Python, open Advanced and set Multicast Time-To-Live to 1 and Multicast Bind Address to 0.0.0.0. In SculptForge, tick Unreal is on another computer. Both computers must be on the same network, and the SculptForge computer's firewall must allow incoming connections from the Unreal machine: the editor connects back to SculptForge to fetch the file."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"import-by-hand","h":"Import by hand","t":"Export FBX for Unreal... (in the File palette and in Tool > Export) writes the same file. The file name becomes the asset name. Drag it into the Content Browser: static meshes pick up their LODs from the file's LOD group; for skeletal meshes choose Skeletal Mesh and tick Import Morph Targets."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"from-scripts","h":"From scripts","t":"sculptforge-cli -c 'open path=statue.obj; unreal_send destination=/Game/Props height_cm=200 lods=4' sculptforge-cli -c 'unreal_editors network=true' # list editors on the network sculptforge-cli -c 'open path=statue.obj; export_unreal folder=out height_cm=200' unreal_send also takes name=, project= (pick one editor when several are open) and network=true. Note: Layered sculpts are sent as skeletal meshes without the LOD chain, because Unreal's morph targets need a skeletal mesh (Unreal can generate skeletal LODs itself). The Unreal link has been tested against a stand-in editor that speaks the same protocol but not yet against every Unreal version. If an import fails, Unreal's Output Log shows the importer's messages."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"exchange-models-with-zbrush-goz","h":"Exchange models with ZBrush (GoZ)","t":"SculptForge reads and writes ZBrush's GoZ format and can talk to a running ZBrush through the GoZ bridge on Windows and macOS. The commands are in File > ZBrush (GoZ): Item What it does Send to ZBrush Writes every visible SubTool to the shared GoZ folder and tells ZBrush (starting it if needed). Each SubTool arrives as its own ZBrush SubTool. Turns on Receive automatically Receive from ZBrush Loads what ZBrush last sent with GoZ. Each object updates the SubTool it was sent from (one undo step), or becomes a new SubTool Receive automatically Checks once a second for a new GoZ send from ZBrush and receives it Custom GoZ folder Use another GoZ folder, for example inside a Wine prefix Import GoZ... Opens a .GoZ file, replacing the scene Export GoZ... Writes a .GoZ file. With several visible SubTools, one file per SubTool next to the path Export STL... Writes a binary STL of the visible SubTools The default GoZ folder is C:\\Users\\Public\\Pixologic on Windows and /Users/Shared/Pixologic on macOS. ZBrush doesn't run on Linux, so there the bridge needs a custom folder; GoZ files still import and export."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"a-round-trip","h":"A round trip","t":"In SculptForge, choose File > ZBrush (GoZ) > Send to ZBrush. ZBrush starts or comes forward with the SubTools. If ZBrush was not running and does not import them, press GoZ in ZBrush. Work in ZBrush, then press GoZ there to send the model back. SculptForge receives it automatically and updates the matching SubTools. Each update is an undo step on that SubTool. GoZ keeps polygroups, mask, polypaint and UVs. Quads from ZBrush stay quads: PolyF shows them as quads, and they go back to ZBrush as the same quads. GoZ has no hidden-face flag, so hidden faces are sent like any others. ZBrush: SculptForge can't read ZBrush's own .ZTL and .ZPR files (they are proprietary and undocumented). Bring models over with GoZ, export OBJ or FBX from ZBrush, or convert your ZTools once with the SculptForge ZTool Export plug-in for ZBrush, after which SculptForge opens the .ZTL itself (see Coming from ZBrush). Subdivision levels don't come across: SculptForge receives the mesh at the level you sent. Note: The GoZ bridge follows the format of the open-source Blender GoZ add-on (GoB) and is tested with files, but has not yet been tested against a live ZBrush. If a send does not arrive, export a .GoZ file and import it in ZBrush by hand, and please report it (Help > Report a problem). From scripts: goz_export path=, goz_import path=, goz_send, goz_receive and export_stl path= (see 3D printing for its options)."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"blender","h":"Blender","t":"To sculpt Blender objects in SculptForge and send them back into the same objects, use the SculptForge Bridge add-on and File > Blender: see Working with Blender. For a one-off exchange, OBJ, FBX and glTF all carry SubTools, UVs and quads both ways."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"see-also","h":"See also","t":"Working with Blender: the Blender add-on Projects, autosave and QuickSave: save everything, not just the mesh SubTools: which SubTools are exported Layers and blend shapes: what becomes morph targets Subdivide, Remesh, Decimate and LODs: decimate before exporting Gaussian splats: saving splats For studios: formats in a pipeline"},{"p":"blender.html","c":"Working with Blender","a":"","h":"Working with Blender","t":"Keep Blender for the scene, rigging, shading and animation, and sculpt in SculptForge: the SculptForge Bridge add-on sends the selected objects from Blender to SculptForge with one click, and one click in SculptForge sends them back. The objects update in place in Blender: their transform, materials and modifiers stay as they were. It works like GoZ between ZBrush and other apps, on Linux, Windows and macOS, with Blender 4.2 or newer."},{"p":"blender.html","c":"Working with Blender","a":"install-the-add-on","h":"Install the add-on","t":"Download sculptforge_bridge.zip from the latest release (or the SculptForge website). In Blender choose Edit > Preferences > Get Extensions, open the menu at the top right and choose Install from Disk..., then pick the zip. (You can also drag the zip into Blender's window.) The SculptForge tab appears in the 3D View's sidebar (press N). Send and Receive are also in the Object menu and in File > Import / Export. Start SculptForge once after installing it: it records where it is installed, so the add-on can start it for you. If the add-on still can't find it (for example an AppImage you keep somewhere unusual), set its path in the add-on's preferences (Edit > Preferences > Add-ons > SculptForge Bridge). Tip: Older Blender versions or a classic add-on install: sculptforge_bridge--legacy.zip installs through Edit > Preferences > Add-ons > Install from Disk. The add-on needs Blender 4.2 or newer either way."},{"p":"blender.html","c":"Working with Blender","a":"a-round-trip","h":"A round trip","t":"In Blender, select one or more mesh objects and click Send to SculptForge in the SculptForge tab. SculptForge starts, or, if it's already open, loads them within a second. Each object becomes a SubTool with the object's name, placed as it is in the Blender scene. Sculpt, paint, mask, divide, remesh: anything SculptForge does. In SculptForge choose File > Blender > Send to Blender. Every visible SubTool goes back. Blender picks it up by itself within a second (or click Receive from SculptForge). Each object that came from Blender is updated; a SubTool you added in SculptForge becomes a new object. Sending again from Blender updates the same SubTools: each update is one undo step on that SubTool in SculptForge, and each receive in Blender is one undo step there. File > Blender in SculptForge"},{"p":"blender.html","c":"Working with Blender","a":"what-comes-across","h":"What comes across","t":" Blender SculptForge Shape The object's mesh, in its own space The SubTool, placed in the scene with the object's transform Faces Triangles and quads; n-gons as triangle fans Triangles and quads (PolyF shows the quads) UVs The active UV map UVs Colour The active colour attribute (point or face corner) Polypaint Mask The sculpt mask Mask Face sets Sculpt mode face sets Polygroups Name Object name SubTool name Blender is Z-up and SculptForge Y-up, both in metres; the add-on and SculptForge convert between them, so the model stands the same way in both and a round trip changes nothing. Objects with a negative scale (mirrored) come across the right way out. When the topology doesn't change (you only sculpted, painted or masked), Blender's mesh keeps everything it had: its n-gons, edges, seams, creases, custom attributes and the other UV maps; only the positions, the active UV map, colour, mask and face sets are updated. When the topology changes (Divide, a remesh, QRemesh, Subdivide...), the object's mesh is rebuilt from what SculptForge sent. The object keeps its transform, materials, modifiers and the names of its active UV map and colour attribute; things tied to the old faces (material per face, seams, other UV maps, shape keys) can't follow and are reset."},{"p":"blender.html","c":"Working with Blender","a":"modifiers","h":"Modifiers","t":"The Modifiers setting in the SculptForge tab chooses what an object with modifiers sends: Keep live (the default): the mesh under the modifiers. They keep working in Blender on the sculpted mesh, for example a Mirror or a Subdivision Surface. Apply: what you see, with the modifiers applied. When it comes back, the mesh holds their result, so the add-on turns those modifiers off (they stay on the object, switched off, if you want them again)."},{"p":"blender.html","c":"Working with Blender","a":"settings","h":"Settings","t":"In the SculptForge tab: Receive automatically: after a send, load what SculptForge sends back as soon as it arrives (on by default). Off: click Receive from SculptForge yourself. In SculptForge's File > Blender: Receive automatically: load what Blender sends as soon as it arrives (on by default). The add-on's preferences add the path of SculptForge and the exchange folder (below)."},{"p":"blender.html","c":"Working with Blender","a":"zbrush-style-keys-in-sculpt-mode","h":"ZBrush-style keys in Sculpt Mode","t":"Sculpting in Blender too? Turn on ZBrush-style keys in Sculpt Mode in the add-on's preferences (Edit > Preferences > Add-ons > SculptForge Bridge) and Blender's Sculpt Mode answers to ZBrush's keys where Blender has the same thing. Turning it off removes them again, and Blender's own keys are back; so does disabling the add-on. The preferences list every key while it's on. ZBrush key In Blender's Sculpt Mode S / U / O Draw Size / Z Intensity (Strength) / Focal Shift (Hardness), dragged at the cursor Space Blender's Sculpt quick menu at the cursor (brush, size, strength) B The brush list by ZBrush name (Standard, DamStandard, Clay, ClayBuildup, Move, SnakeHook...): type a few letters, Enter picks Alt+drag Zsub: the brush digs in Ctrl+drag / Ctrl+Alt+drag Mask / unmask, drawn as a lasso Ctrl+Shift+drag / Ctrl+Shift+Alt+drag Show only what's inside / hide what's inside Ctrl+W Group the masked part as a face set and clear the mask (with nothing masked: the visible part) Ctrl+D / D / Shift+D Divide (a Multires level) / SDiv up / SDiv down (never adds a level) X Symmetry X Shift+F PolyFrame (the wireframe overlay) F / P Frame the model / perspective on and off L LazyMouse (Blender: Stabilize Stroke) W / E / R Move / Scale / Rotate Shift+drag Smooth (Blender already does this) The ZBrush brushes map to Blender's closest: Standard = Draw, DamStandard = Draw Sharp, ClayBuildup = Clay Strips, Move = Grab, Move Elastic = Elastic Grab, TrimDynamic = Trim (Scrape in Blender 4.2), Crease = Crease Sharp, MaskPen = Mask. What Blender has no key for, or can't do the ZBrush way: I (RGB Intensity): Blender's sculpt brushes don't paint. Ctrl+drag on the model doesn't paint the mask with a round brush: Blender can't switch to the Mask brush for one stroke, so it draws a mask lasso (pick the Mask brush with B to paint it). Dragging on the empty background doesn't rotate: a keymap can't tell the model from the background. Use the middle mouse button, or Blender's Emulate 3 Button Mouse. Ctrl+click on the background (invert or clear the mask) and Ctrl+Shift+click (show all): use Ctrl+I, Alt+M and Alt+H. B then two letters: a Blender menu takes one key at a time, so B opens the list and the letters filter it. Alt+click a SubTool: Blender's objects aren't SubTools (Alt+Q switches the object you sculpt). Stroke types (DragRect, Spray...): each Blender brush sets its stroke method in its Stroke panel. These keys take Blender's place while they're on: F no longer sets the radius (that's S), B no longer draws a box mask, Ctrl+drag no longer inverts the brush (that's Alt), and Space no longer plays the animation in Sculpt Mode."},{"p":"blender.html","c":"Working with Blender","a":"vector-displacement-maps","h":"Vector displacement maps","t":"SculptForge's VDM brushes and Blender's use the same maps (see Vector displacement brushes): From Blender: a map baked with Blender's VDM Brush Baker loads with Brush > Vector Displacement > Load VDM... as it is. To Blender: Export EXR... writes the VDM brush's map. In Blender, in Sculpt Mode with a Draw brush: in the brush's Texture panel add a new image texture and open the EXR (set its Color Space to Non-Color), set Mapping to Area Plane, turn on Vector Displacement, then set the stroke method to Anchored and Strength to 1. Drag on the model to stamp it."},{"p":"blender.html","c":"Working with Blender","a":"how-it-works","h":"How it works","t":"The two programs share a folder in your user data: ~/.local/share/SculptForge/SculptForge/blender on Linux, %APPDATA%\\SculptForge\\SculptForge\\blender on Windows, ~/Library/Application Support/SculptForge/SculptForge/blender on macOS. Each side writes its meshes there as .GoZ files (the format SculptForge also uses with ZBrush) with a small list of the objects, and checks the other side's list once a second. Nothing goes over the network. To use another folder, set it in the add-on's preferences and start SculptForge with the environment variable SCULPTFORGE_BLENDER_EXCHANGE set to the same folder. From scripts and the MCP server: blender_send and blender_receive (both take folder=). Starting SculptForge with --blender loads what Blender last sent."},{"p":"blender.html","c":"Working with Blender","a":"limits-and-troubleshooting","h":"Limits and troubleshooting","t":"Blender as a Flatpak or Snap sees a different user data folder and may not be allowed to start other programs. Set the add-on's exchange folder to a folder both can reach, start SculptForge yourself with SCULPTFORGE_BLENDER_EXCHANGE set to it, and send. Linked duplicates (objects sharing one mesh) all show the last one received. Shape keys: the Basis and the keys named like SculptForge's layers are updated; other keys keep their shapes. Subdivision levels don't go to Blender: it receives the level you're on (like GoZ). Sculpt layers arrive as shape keys (Basis plus one key per layer, with its name and weight), so the 52 facial shapes keep their ARKit names. Shape keys don't come back from Blender, and textures stay in SculptForge. Nothing arrives in SculptForge? Check File > Blender > Receive automatically, or choose Receive from Blender. Nothing arrives in Blender? Click Receive from SculptForge; automatic receiving starts after the first send from that Blender session. Objects in Edit Mode or Sculpt Mode are updated too: the add-on switches to Object Mode for the update and back."},{"p":"blender.html","c":"Working with Blender","a":"see-also","h":"See also","t":"Exporting, Unreal and ZBrush: files, game engines and GoZ SubTools: each Blender object is a SubTool Polygroups and visibility: Blender's face sets"},{"p":"projects.html","c":"Projects, autosave and QuickSave","a":"","h":"Projects, autosave and QuickSave","t":"A SculptForge project (.sfproj) saves your whole scene in one file, so you can close the app and carry on exactly where you stopped. This chapter covers saving and opening projects, the unsaved-changes prompt, recent files, autosave and crash recovery, QuickSave, and the LightBox tabs that show your work."},{"p":"projects.html","c":"Projects, autosave and QuickSave","a":"what-a-project-keeps","h":"What a project keeps","t":"A .sfproj file holds everything SculptForge knows about the scene: every SubTool, with its name, visibility, mesh, mask, polypaint, polygroups, hidden faces and UVs; every sculpt layer with its weight, and the active layer of each SubTool; each SubTool's QRemesh Guides, the curves QRemesh's edge loops follow; loaded Gaussian splats and their placement; your custom brushes, so a project opened on another computer still has them; the camera, the material and display settings, the brush, Draw Size, Z Intensity (and Smooth's), RGB Intensity, Focal Shift, paint colour and symmetry; a thumbnail, shown in the LightBox. Undo history isn't saved: an opened project starts with a clean history. Model formats such as OBJ, GLB or FBX can't hold all of this (masks, hidden faces, splats, brushes), so writing them is an export, not a save. See Exporting. ZBrush: A .sfproj is the equivalent of a ZBrush project (.ZPR), and saving a single SubTool scene is close to saving a .ZTL. SculptForge can't read .ZPR files, and opens a .ZTL only after the ZTool Export plug-in converted it in ZBrush; otherwise bring models over with GoZ or as OBJ, FBX or GLB."},{"p":"projects.html","c":"Projects, autosave and QuickSave","a":"save-a-project","h":"Save a project","t":"File > Save (Ctrl+S) saves to the current project. The first time, it asks for a file name. File > Save As... (Ctrl+Shift+S) saves under a new name. Clicking the document name in the title strip also saves. The title strip shows the document name with * after it while there are unsaved changes, and the window title starts with *. Any edit in any SubTool counts, as do splat edits and layer weight changes. If you opened a model file (an OBJ, say) rather than a project, Save asks where to save a new .sfproj; the original model file is left alone."},{"p":"projects.html","c":"Projects, autosave and QuickSave","a":"open-a-project-or-model","h":"Open a project or model","t":"File > Open... (Ctrl+O) opens a project, a model or a splat capture. Opening a project or model replaces the scene. File > Open Recent lists the last 10 files you opened or saved. Files that no longer exist are dropped from the list. Clear Recent empties it. Drop a file onto the window to open it. In the LightBox, double-click a project or model. File > New Sphere (Ctrl+N) and File > New Plane start a fresh scene. When you open a project, its saved camera, material and brush settings come back too."},{"p":"projects.html","c":"Projects, autosave and QuickSave","a":"the-unsaved-changes-prompt","h":"The unsaved-changes prompt","t":"When the scene has unsaved changes, New Sphere, New Plane, Open..., Open Recent, dropping a model or project, Quit (Ctrl+Q) and closing the window first ask: Save saves the project (asking for a name if it has none), then carries on; Don't Save discards the changes and carries on; Cancel goes back to your work. Dropping an image or a .sfbrush file never asks, because it doesn't replace the scene."},{"p":"projects.html","c":"Projects, autosave and QuickSave","a":"autosave-and-crash-recovery","h":"Autosave and crash recovery","t":"While the scene has unsaved changes, SculptForge writes a recovery copy every few minutes (every 5 minutes by default; it waits until you finish a stroke). Change the interval, or turn it off with 0, in Preferences > Autosave or with the Autosave (min) slider in the File palette (0 to 60 minutes). The recovery copy is autosave.sfproj in the SculptForge settings folder (see Troubleshooting for where that is on your system). It is deleted once your work is saved or you discard the changes. If SculptForge didn't close normally (a crash or power cut), the next start asks Restore Autosave?: Restore opens the autosaved scene as an untitled, unsaved document. Save it to keep it. Discard deletes the recovery copy. The autosave also appears first in the LightBox QuickSave tab while it exists. Note: Autosave is a safety net, not a substitute for saving. It keeps only the latest copy and is removed as soon as you save."},{"p":"projects.html","c":"Projects, autosave and QuickSave","a":"quicksave","h":"QuickSave","t":"QuickSave in the title strip saves a timestamped copy of the whole scene, like ZBrush's QuickSave. Your project file, its name and its unsaved state are not changed, so QuickSave is safe to press before any risky step. Copies go to the QuickSave folder of your library (by default Documents/SculptForge/QuickSave), named like QuickSave 2026-10-21 23-15-04.sfproj. The last 10 QuickSaves are kept; older ones are deleted. They appear in the LightBox QuickSave tab, newest first, labelled with their date and time. Double-click one to open it. The tab also has a Save now button. QuickSave has no default shortcut. To give it one, hold Ctrl+Alt, click the QuickSave button and press a key (see The interface)."},{"p":"projects.html","c":"Projects, autosave and QuickSave","a":"your-library-folder-and-the-lightbox","h":"Your library folder and the LightBox","t":"SculptForge keeps a library folder for your work, by default SculptForge in your Documents folder. It is created on first use with these sub-folders: Folder LightBox tab What goes there Projects Project Your .sfproj files Tools Tool Models to open or append as SubTools Brushes Brush .sfbrush files Alphas Alpha Grayscale images for brush alphas Images Image Sketches and concept art for Generate 3D Splats Splats Gaussian splat captures QuickSave QuickSave QuickSave copies Change it in Preferences > LightBox > Library folder, then Store Config (Ctrl+Shift+I) to keep the setting. Press , (comma) to show the LightBox. The tabs that matter for projects: Project: the projects in your Projects folder, plus any recent project saved elsewhere. Each shows the thumbnail saved with it. QuickSave: the autosave (when there is one) and your QuickSaves, newest first. Recent: everything in Open Recent, of every kind. Double-click a tile to open it (you are asked about unsaved changes first). In the Tool tab, Shift+double-click a model to append it as a SubTool instead. The LightBox showing project thumbnails"},{"p":"projects.html","c":"Projects, autosave and QuickSave","a":"scripting","h":"Scripting","t":"Command What it does save_project path=work/dragon.sfproj Save the project (without path, to the current project) open_project path=work/dragon.sfproj Open a project (open also recognises .sfproj) open path=scan.obj Open a model, splat capture or project new_sphere subdivisions=6 / new_plane resolution=128 Start a new scene Projects saved by sculptforge-cli or Python open in the app too. For the file layout, see docs/project-format.md."},{"p":"projects.html","c":"Projects, autosave and QuickSave","a":"see-also","h":"See also","t":"The interface: LightBox, shortcuts and Store Config SubTools Exporting: formats for other applications Troubleshooting: where settings and the autosave live"},{"p":"scripting.html","c":"Scripting and automation","a":"","h":"Scripting and automation","t":"Every operation in SculptForge is a named command with parameters. The same commands run from the console inside the app, from script files, from the sculptforge-cli tool on a build farm, from Python, and from AI agents through the Model Context Protocol (MCP). This chapter explains the script language, the console, both command-line programs, the Python module and MCP setup. ZBrush: The console plays the role of ZBrush's ZScript window, and Copy session as script is a macro recorder. The language is much simpler than ZScript: one command per statement, with named parameters."},{"p":"scripting.html","c":"Scripting and automation","a":"the-script-language","h":"The script language","t":"A script is a list of statements. Each statement is a command name followed by name=value parameters: new_sphere subdivisions=5 subdivide levels=1 remesh resolution=256; decimate ratio=0.5 # two statements on one line export_glb path=\"My Sculpts/bust.glb\" The rules: Statements are separated by new lines or by ;. # starts a comment that runs to the end of the line (outside quotes). Parameters are name=value with no spaces around =. true and false are booleans; numbers are numbers; anything else is text. Put text in double quotes when it contains spaces, ;, # or \", or when it must stay text even though it looks like a number. Inside quotes only \\\" and \\\\ are escapes, so Windows paths such as \"C:\\Users\\me\\head.obj\" work as written. Colours with a # must be quoted: set_color color=\"#d9a07a\". Paths are UTF-8. Relative paths are relative to the current folder of the program running the script. Scripts stop at the first command that fails."},{"p":"scripting.html","c":"Scripting and automation","a":"the-console","h":"The console","t":"Press the backtick key (left of 1), or choose Script > Console, to open the console strip above the bottom shelf. Drag its top edge to resize it. The console showing commands run from the interface and typed by hand Every command you run appears in the console as a script line, whether it came from a button, a shortcut, the command palette or the console itself, followed by its result. Failures show in red with the reason. Type a statement and press Enter to run it. Several statements separated by ; run in order and stop at the first failure. Tab completes command names, then parameter names. Press Tab again to list the candidates. Up and Down walk through the last 200 lines you typed. The history is kept between sessions. help (or ?) lists every command; help remesh explains one command and its parameters. clear empties the log. The console buttons (also in the Script palette): Button What it does Run script file... Runs a text file of statements (.sfscript or .txt), stopping at the first failure Copy session as script Puts every command run this session on the clipboard as a script you can save and run again Clear console Empties the log. The session script is kept Tip: To record a macro, work normally, then click Copy session as script, paste it into a text file and edit out what you don't need. Run it later with Run script file... or sculptforge-cli -f."},{"p":"scripting.html","c":"Scripting and automation","a":"the-command-palette","h":"The command palette","t":"Press F3 (or Ctrl+Shift+P, or click Search in the title strip) to search every command, brush and setting by name. Enter runs the highlighted entry; Shift+Enter opens it in the console so you can add parameters first. Commands that need parameters always open in the console. With an empty search, the palette lists what you used recently. See The interface. The command palette searching for a command Tip: Hold Ctrl+Alt and point at a button to see the scripting parameters of the command behind it."},{"p":"scripting.html","c":"Scripting and automation","a":"commonly-used-commands","h":"Commonly used commands","t":"sculptforge-cli --list (or help in the console) prints every command with all its parameters. These are the ones you will use most: Area Command Key parameters Scene new_sphere subdivisions (0 to 8, default 6) Scene new_plane resolution (cells per side, default 128) Files open path: models, projects, splats, GoZ Files save_project path (default: the current project) Files open_project path Geometry subdivide levels (1 to 4, default 1) Geometry remesh resolution (32 to 512, default 200) Geometry decimate ratio (default 0.5) or triangles Geometry qremesh target (default 5000), adaptive, keep_groups, detect_edges, use_polypaint, symmetry, keep_original SubTools project_all distance (default 0.02), mean, blur, geometry, polypaint, source Geometry mesh_info Sculpting stroke points (required), brush, radius, strength, invert, symmetry Brushes brush_set_alpha name (round, square, noise) or path, invert Brushes brush_ai prompt (required), provider, model, endpoint Brushes brush_install path, code or json Brushes brush_save path (required), name Layers layer_add name Layers layer_set_weight index, weight (both required) Masking mask_by_cavity strength, threshold Masking mask_invert, mask_clear, mask_blur, mask_grow iterations where it applies Polygroups polygroup_auto_by_normals angle (default 30) Visibility isolate_polygroup, hide_polygroup group (required) Visibility show_all, delete_hidden Transform transform translate, rotate, scale, pivot, orient, masked, falloff, symmetry, all (Gizmo 3D) SubTools subtool_append type (sphere, cube, plane) or path, name, size SubTools subtool_select index or name Polypaint set_color, paint_fill color, area (unmasked, masked, all) Polypaint paint_from_cavity color, strength, smoothing AI image_to_3d path (required), service, model, remesh, resolution AI text_to_3d prompt (required), service, model Export export_glb, export_usd, export_stl, export_ply path (required); export_stl also height_mm, scale, z_up Export export_fbx path (required), lods, ratio, scale Export export_lods path (required), levels, ratio Unreal unreal_send destination, height_cm, lods, network Splats splat_to_mesh (Make sculptable) detail, preset, color, crop, face_guides, stage Splats face_guides landmarks, front, up, target Edit undo, redo A few commands exist only inside the app, because they change the view rather than the model: set_material (name= a MatCap such as Sculpt, or Studio) and new_cube."},{"p":"scripting.html","c":"Scripting and automation","a":"sculptforge-cli","h":"sculptforge-cli","t":"sculptforge-cli runs commands without a window: on a server, a render farm node or in a build pipeline. It keeps one scene for the whole run, loads your brush library (and studio brushes), and uses the same ai.json settings as the app. sculptforge-cli [options] -c, --command \"<script>\" Run commands, separated by ';' (can be given several times) -f, --file <script.txt> Run commands from a file ('-' reads standard input) --set NAME=VALUE Define a variable; script values written $NAME are replaced -l, --list List every command and its parameters --schema Print the commands as LLM tool definitions (JSON) --mcp Run as an MCP server on standard input and output -q, --quiet Only print errors -h, --help Show this help Each command prints its result on one line (export_glb: Exported out/rock.glb). The exit status is 0 when everything succeeded, 1 for a usage or script syntax error, and 2 when a command failed (the error names the line and the command). Variables make one script reusable. A value written $NAME (the whole value) is replaced with the --set value, so paths with spaces stay intact: cat > lods.sfscript <<'EOF' open path=$in remesh resolution=256 export_lods path=$out levels=4 ratio=0.5 EOF for f in rocks/*.obj; do sculptforge-cli --set in=\"$f\" --set out=\"lods/$(basename \"$f\" .obj).glb\" -f lods.sfscript done More examples: # Concept art -> sculptable model -> USDZ (free, via Hugging Face) sculptforge-cli -c 'image_to_3d path=hero.png; export_usd path=hero.usdz' # Design a brush (free, no key) and save it for the team sculptforge-cli -c 'brush_ai prompt=\"weathered stone edges\"; brush_save path=stone.sfbrush' # Cavity dirt on a sculpt, then a coloured PLY sculptforge-cli -c 'open path=bust.sfproj; paint_from_cavity color=\"#3a2a20\" strength=0.8; export_ply path=bust.ply' Warning: Without the quotes, #3a2a20 would start a comment. In a shell, put the whole script in single quotes so the double quotes reach SculptForge."},{"p":"scripting.html","c":"Scripting and automation","a":"the-sculptforge-app-on-the-command-line","h":"The SculptForge app on the command line","t":"The desktop app takes a few options too, for renders and start-up scripts: Option What it does sculptforge FILE Opens a model, project, splat capture or image at start-up --run \"\" Runs commands at start-up --render out.png Renders the scene to an image and exits --turntable N With --render: N frames around the model (out_000.png ...) --size WxH Render size (default 1024x1024) --view YAW,PITCH Camera angles in degrees (default -30,-15) --zoom F Move the camera F times closer than the framed view --wireframe, --polygroups Render with the wireframe or polygroup colours --hide-mesh Render only the Gaussian splats --fullscreen Start filling the screen (F11 toggles) --demo NAME, --record out.mp4 Play a scripted demo, and record it to a video (needs ffmpeg) --ui-test FILE.sfui, --ui-out DIR Run an interface test script (for developers) A review sheet for a model, eight frames around it: sculptforge model.glb --render review/model.png --turntable 8 --size 1024x1024 Rendering needs an OpenGL 3.3 capable GPU or software renderer and a display. On a headless Linux node, run it under a virtual display such as Xvfb (xvfb-run sculptforge ...)."},{"p":"scripting.html","c":"Scripting and automation","a":"python","h":"Python","t":"SculptForge has a Python module, sculptforge, with the same commands plus NumPy access to the mesh. It is included in the VFX Reference Platform builds and the Rez package (see For studios); when building from source, configure CMake with -DSCULPTFORGE_BUILD_PYTHON=ON. import sculptforge as sf doc = sf.Document() # loads your brush library, like the app sf.run(doc, \"open\", path=\"/show/troll/troll_base.fbx\") sf.run(doc, \"remesh\", resolution=320) sf.run_script(doc, \"decimate ratio=0.25; export_lods path=/out/troll.glb levels=4\") verts, tris = doc.vertices, doc.triangles # NumPy (N, 3) float32 and (M, 3) uint32 doc.set_mesh(verts * 1.1, tris) # bring in a mesh from your own tools (clears undo) print(doc.subtools) # [{'name': ..., 'visible': ..., 'triangles': ...}] doc.active_subtool = \"Helmet\" # select by index or name for name, weight in doc.layers: # sculpt layers (blend shapes) print(name, weight) print([c[\"name\"] for c in sf.commands()]) # every command with its parameters Function or property What it does sf.run(doc, command, **params) Runs one command and returns its message sf.run_script(doc, script) Runs a script in the syntax above and returns the messages sf.commands() Lists every command with its parameters sf.tool_schema() The commands as LLM tool definitions (JSON) doc.vertices, doc.base_vertices, doc.normals, doc.triangles Mesh arrays of the active SubTool (copies) doc.mask, doc.colors, doc.polygroups, doc.hidden Attribute arrays you can read and assign (None if absent) doc.layers, doc.layer_delta(i) Sculpt layers as (name, weight) and their per-vertex offsets doc.subtools, doc.active_subtool The SubTool list and the active SubTool doc.splat_count Number of loaded Gaussian splats Failures raise sculptforge.CommandError. Long operations release the GIL, so you can run them on worker threads."},{"p":"scripting.html","c":"Scripting and automation","a":"ai-agents-mcp","h":"AI agents (MCP)","t":"sculptforge-cli --mcp runs SculptForge as an MCP server. An AI agent (Claude Code, Claude Desktop or any MCP client) gets every command as a tool and works on one scene for the session: it can open files, generate models, sculpt strokes, remesh, paint and export. Claude Code: claude mcp add sculptforge -- /path/to/sculptforge-cli --mcp Claude Desktop or another client: add a stdio server whose command is the full path to sculptforge-cli and whose argument is --mcp. For Claude Desktop that is an entry in its configuration file like this: { \"mcpServers\": { \"sculptforge\": { \"command\": \"/path/to/sculptforge-cli\", \"args\": [\"--mcp\"] } } } Then ask for something like \"make a sphere, remesh it at 128 and export it to ~/Desktop/ball.glb\". File paths are on your machine. The agent works headless; to see the result, open the exported file in SculptForge. sculptforge-cli --schema prints the same tool definitions as JSON, for wiring SculptForge into your own agent."},{"p":"scripting.html","c":"Scripting and automation","a":"see-also","h":"See also","t":"The interface: the command palette and Ctrl-hover help For studios: Rez, the VFX builds and farm rendering Image and text to 3D and Exporting: the commands in context Keyboard and mouse reference"},{"p":"studios.html","c":"SculptForge for studios","a":"","h":"SculptForge for studios","t":"SculptForge is built to drop into animation, VFX and game studios that run their own pipelines: native on Linux, scriptable, standards-based, with no licence server and nothing that phones home. This chapter is for pipeline TDs and IT: the VFX Reference Platform builds, Rez deployment, shared brush libraries, environment variables, headless use and licensing."},{"p":"studios.html","c":"SculptForge for studios","a":"vfx-reference-platform-builds","h":"VFX Reference Platform builds","t":"SculptForge tracks the VFX Reference Platform. Every commit is built and tested in the platform's reference environments: CY2026 CY2027 SculptForge Linux compiler GCC 14.2 GCC 14.2 Built and tested with gcc-toolset-14 glibc 2.28 (EL8) 2.34 (EL9) Rocky Linux 8 and 9 builds; CI checks that no newer glibc symbols are used C++ C++20 C++20 C++20 Python 3.13 3.13 The sculptforge module is built and tested against 3.13 Windows VS 2022 17.6+ VS build tools 14.44+ Visual Studio 2022 macOS minimum 14.0 14.0 Universal binary with deployment target 11.0 FBX 2020.x 2020.x Writes FBX 7.4 binary, which FBX SDK 2020 reads SculptForge doesn't depend on Qt, OpenEXR, Boost, TBB or other platform libraries, so it can't conflict with the versions your other tools load. Its few dependencies (SDL3, Dear ImGui, GLM, ufbx) are linked into the binaries. Each release includes SculptForge--linux--vfx2026.tar.gz (Rocky 8, glibc 2.28) and ...-vfx2027.tar.gz (Rocky 9, glibc 2.34), for x86_64 and ARM64, with the Python module under lib/sculptforge/python."},{"p":"studios.html","c":"SculptForge for studios","a":"deploy-with-rez","h":"Deploy with Rez","t":"packaging/rez/package.py in the source tree builds and installs a Rez package: cd packaging/rez SCULPTFORGE_PYTHON=$(which python3.13) rez-build --install # or --release for your release repository rez-env sculptforge -- sculptforge # the app rez-env sculptforge -- sculptforge-cli --list # every pipeline command rez-env sculptforge python-3.13 -- python -c \"import sculptforge\" The package puts bin/ on PATH and the Python module on PYTHONPATH, and sets SCULPTFORGE_ROOT. The Python module is built for the first python3 found unless SCULPTFORGE_PYTHON names an interpreter."},{"p":"studios.html","c":"SculptForge for studios","a":"studio-brush-libraries","h":"Studio brush libraries","t":"Each artist's own brushes live in their user brush library, one .sfbrush file per brush (see Brush Lab and sharing brushes). To give a whole team the same brushes, put .sfbrush files on a share and list it in SCULPTFORGE_BRUSH_PATH: export SCULPTFORGE_BRUSH_PATH=/studio/brushes:/show/troll/brushes # ';' between folders on Windows sculptforge-cli -c 'brush_library' # every brush, where it comes from and its file, plus the folders The app, sculptforge-cli and the Python module load these folders at start-up, read-only: SculptForge never writes into them, so the share can be mounted read-only. Studio brushes show a studio tag in the Custom brushes list. When brushes share a name, the artist's own wins over a studio one, which wins over a built-in. Among studio folders, the first one listed wins. Refining a studio brush in Brush Lab saves the artist's own version (tagged yours) without touching the share. Deleting that version brings the studio brush back. To publish a brush, copy its .sfbrush file into the share: right-click it in the Custom brushes list > Save .sfbrush..., or take it from an artist's user library. With Rez, set the share once for everyone: when SCULPTFORGE_STUDIO_BRUSHES is set as the package resolves (in a site package, your rezconfig or the launcher), it is appended to SCULPTFORGE_BRUSH_PATH. export SCULPTFORGE_STUDIO_BRUSHES=/studio/brushes rez-env sculptforge -- sculptforge"},{"p":"studios.html","c":"SculptForge for studios","a":"environment-variables","h":"Environment variables","t":"Variable Effect SCULPTFORGE_BRUSH_PATH Read-only studio brush folders (:-separated, ; on Windows) SCULPTFORGE_STUDIO_BRUSHES With the Rez package: appended to SCULPTFORGE_BRUSH_PATH SCULPTFORGE_BRUSH_GALLERY Use another community brush gallery index (a URL or a folder), for example an in-house mirror HF_TOKEN (or HUGGING_FACE_HUB_TOKEN) Hugging Face token for the free image-to-3D models FAL_KEY, MESHY_API_KEY Keys for the paid generation services ANTHROPIC_API_KEY, OPENAI_API_KEY Keys for Brush Lab providers XDG_DATA_HOME (Linux), APPDATA (Windows) Move the settings folder (see where settings live) Keys from the environment are used when none is saved in the app, so a launcher can supply them without writing them to each artist's settings."},{"p":"studios.html","c":"SculptForge for studios","a":"headless-and-farm-use","h":"Headless and farm use","t":"sculptforge-cli runs every editing operation without a display: imports, remeshing, decimation, LOD chains, FBX, USD and glTF export, splat conversion and AI generation. See Scripting and automation. sculptforge --render out.png --turntable 8 renders review images and turntables offscreen. It needs an OpenGL 3.3 context; on a headless Linux node, run it under Xvfb. sculptforge-cli --mcp exposes the same operations to AI agents through the Model Context Protocol. import sculptforge gives Python the same commands plus NumPy arrays of the mesh, for your own tools. A typical farm job turns incoming scans into game-ready assets: sculptforge-cli --set in=/ingest/scan_042.ply --set usd=/assets/scan_042.usda --set glb=/assets/scan_042.glb -c ' open path=$in splat_transform rotate_x=180 fit=true splat_clean splat_to_mesh detail=320 preset=game color=texture export_usd path=$usd export_lods path=$glb levels=4 ratio=0.5 ' A --set variable replaces a whole value, so pass complete paths (with their extensions) as variables."},{"p":"studios.html","c":"SculptForge for studios","a":"formats-in-a-pipeline","h":"Formats in a pipeline","t":"Format Read Write Notes OpenUSD (.usda, .usdz) Yes Yes Meshes, xform ops, Z-up stages, UsdSkel blend shapes, ParticleField Gaussian splats, textures; checked with OpenUSD's validators FBX Yes (any version) Yes (7.4 binary) LOD groups, blend shapes, centimetre units, textures; checked with ufbx's strict mode glTF / GLB Yes Yes Morph targets, vertex colours, KHR_gaussian_splatting, embedded textures; checked with the Khronos validator OBJ Yes Yes Objects as SubTools, groups as polygroups, vertex colours, textures through .mtl PLY Yes Yes Meshes with vertex colours, Gaussian splats STL Yes (binary and ASCII) Yes (binary) ZBrush GoZ Yes Yes Polygroups, mask, polypaint, UVs SculptForge project (.sfproj) Yes Yes Everything; a documented ZIP of JSON and binary arrays Binary .usdc files and USD references or payloads aren't read yet; convert with usdcat in.usd -o out.usda. The project format is described in docs/project-format.md in the source tree, so pipeline tools can read it without SculptForge."},{"p":"studios.html","c":"SculptForge for studios","a":"licensing","h":"Licensing","t":"SculptForge is free software under the GNU General Public License, version 3 or later. In practice: Using it is unrestricted, commercially or otherwise, on any number of machines. There are no seats, licence servers or accounts. Your artwork belongs to you. The GPL covers the program, not the models you make with it. You can modify it in-house. The GPL only requires you to share source if you distribute the modified program outside your organisation. Internal use, including across your own facilities and farm, is generally not considered distribution. (This is the common reading of the GPL, not legal advice; check with your counsel.) SculptForge has no telemetry and no servers of its own. AI features are optional and talk only to the service each artist chooses, or to your own ComfyUI server."},{"p":"studios.html","c":"SculptForge for studios","a":"not-yet","h":"Not yet","t":"Planned pipeline features, roughly in order: OpenColorIO viewport display, Alembic export, fuller USD authoring (layers, variants, references, .usdc), UVs and texture baking, multiresolution sculpting. Pipeline requests are welcome as issues on the project's GitHub page."},{"p":"studios.html","c":"SculptForge for studios","a":"see-also","h":"See also","t":"Scripting and automation Exporting, Send to Unreal and GoZ Brush Lab and sharing brushes Image and text to 3D: running models on your own ComfyUI server Troubleshooting"},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"","h":"Keyboard and mouse","t":"This chapter is the reference for every default keyboard shortcut and mouse gesture in SculptForge. Inside the app, F1 opens the same list as the Controls window, showing your own keys if you've changed any."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"changing-shortcuts","h":"Changing shortcuts","t":"Every key below can be reassigned: hold Ctrl+Alt and click a button, then press the new key, or use Preferences > Hotkeys. Press Ctrl+Shift+I (Store Config) to keep your changes. See Customizing the interface. On macOS, Cmd works wherever a shortcut says Ctrl. Single-letter shortcuts don't fire while you type in a text field."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"keyboard-shortcuts","h":"Keyboard shortcuts","t":"The table lists the default shortcut of every action, grouped by palette. It is generated from SculptForge's action registry, the same source as the Controls window."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"brush","h":"Brush","t":"Action Keys What it does Brush picker B Pop up every brush under the cursor. Type the first letter of a brush, then the orange letter on its tile (B S T = Standard). Paste brush Ctrl+V Add the brush on the clipboard: a brush code someone shared, or the text of a .sfbrush file."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"color","h":"Color","t":"Action Keys What it does Pick colour C Take the paint colour from the model under the cursor. Switch Color V Swap the main and the secondary colour."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"draw","h":"Draw","t":"Action Keys What it does Draw Size at cursor S A Draw Size slider under the cursor: drag it, or type a number and press Enter. Focal Shift at cursor O A Focal Shift slider under the cursor: below 0 a broad, hard brush tip, above 0 a soft point (-100..100). The inner ring of the brush cursor shows it. Larger brush ] Make the brush 10% larger (hold to repeat). Paint P Paint colour without sculpting (ZBrush Rgb on, Zadd off). Alt paints back to white, Shift still smooths. RGB Intensity at cursor I An RGB Intensity slider under the cursor: how strongly painting colours the surface (1-100). Smaller brush [ Make the brush 10% smaller (hold to repeat). Z Intensity at cursor U A Z Intensity slider under the cursor: drag it, or type a number (1-100) and press Enter. Hold Shift (or pick Smooth) to set Smooth's own Z Intensity."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"edit","h":"Edit","t":"Action Keys What it does Redo Ctrl+Shift+Z or Ctrl+Y Redo the last undone action. Undo Ctrl+Z Undo the last action."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"file","h":"File","t":"Action Keys What it does Export GLB... Ctrl+E Export the model as glTF binary, with sculpt layers as blend shapes (morph targets). New Sphere Ctrl+N Replace the scene with a new sphere ready for sculpting. Open... Ctrl+O Open a project (.sfproj), a model (.obj, .glb, .fbx, .stl, .ply, .usd ...) or splats. Quit Ctrl+Q Close SculptForge (asks to save changes first). Save Ctrl+S Save the project (.sfproj: every SubTool, layer, brush and setting). Asks for a name the first time. Save As... Ctrl+Shift+S Save the project under a new name. Send to Unreal Ctrl+U Export a game-ready FBX and import it into the running Unreal Editor (Python remote execution)."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"help","h":"Help","t":"Action Keys What it does Command palette F3 or Ctrl+Shift+P Search every command, brush and setting by name and run it. Commands that need parameters open in the console. Controls F1 Every shortcut and mouse gesture, generated from the commands themselves. QuickMenu Space ZBrush's QuickMenu under the cursor: brush, stroke, alpha, material, colour, Draw Size, Focal Shift and the intensities. Hold Space and let go to close it, or tap Space to keep it open. User Guide Shift+F1 The SculptForge user guide: every tool explained, with search. Hold Ctrl over a control and press F1 to open the chapter about it."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"lightbox","h":"LightBox","t":"Action Keys What it does LightBox , Show or hide the LightBox: thumbnails of your projects, models, brushes, alphas, materials, images, splats and QuickSaves along the top of the canvas. Double-click to load."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"material","h":"Material","t":"Action Keys What it does Material picker M Pop up the materials under the cursor. Hover one to preview it on the model; click to keep it."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"preferences","h":"Preferences","t":"Action Keys What it does Load UI... Ctrl+L Load a layout file someone shared (or you saved with Save UI). Save UI... Ctrl+Alt+Shift+I Save the layout, shortcuts and interface preferences to a file you can share. Shelves Tab Hide or show the shelves and trays around the canvas. Store Config Ctrl+Shift+I Keep the current layout, shortcuts and interface preferences for future sessions. Like ZBrush, SculptForge never saves them on its own."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"render","h":"Render","t":"Action Keys What it does Fullscreen F11 Fill the screen with SculptForge (again: back to a window). Mask Ctrl+H Darken masked areas. Wireframe Shift+F Show the mesh's polygons (quads and triangles) over the surface (ZBrush PolyFrame)."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"script","h":"Script","t":"Action Keys What it does Console ` The script console: every command you run appears as a script line, and you can type commands yourself."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"stroke","h":"Stroke","t":"Action Keys What it does LazyMouse L LazyMouse on or off: the brush trails the cursor on a string, for steady lines."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"tool","h":"Tool","t":"Action Keys What it does Clear Mask Ctrl+Shift+A Unmask everything (also: Ctrl+drag on the background). Divide Ctrl+D Add a subdivision level: four times the polygons, and the lower levels are kept, so you can step down to shape big forms and back up to the detail. Quads stay quads (Catmull-Clark). Smt off divides without smoothing. Group Masked Ctrl+W Turn the masked part into a new polygroup and clear the mask (ZBrush Ctrl+W). With nothing masked, everything visible becomes one group. Higher Res D Step one subdivision level up (more polygons, for detail). Edits made below carry the detail along. Invert Mask Ctrl+I Mask what is unmasked and unmask what is masked (also: Ctrl+click the background). Lower Res Shift+D Step one subdivision level down (fewer polygons, for big forms). The detail of the higher levels is kept. Mask All Ctrl+A Mask the whole visible SubTool."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"transform","h":"Transform","t":"Action Keys What it does Draw Q Draw mode: brushes sculpt and paint (leaves the Gizmo 3D). Frame F Fit the whole model in the view. Move W Gizmo 3D, Move: drag an arrow to move along an axis, a square to move in a plane, the centre to move in the view. Masked parts stay; Shift snaps to the grid; Alt+drag moves only the gizmo. W again: back to Draw. Rotate R Gizmo 3D, Rotate: drag a ring to turn about that axis, the outer ring to turn in the view. Mask the body and put the pivot at a joint to pose a limb. Shift snaps to 15 degrees. R again: back to Draw. Scale E Gizmo 3D, Scale: drag a box to stretch along an axis or the centre to scale evenly (right or up: bigger). Shift snaps to 10% steps. E again: back to Draw. X X Mirror strokes across X (left and right)."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"mouse-and-pen-gestures","h":"Mouse and pen gestures","t":"Action Gesture Sculpt Left-drag on the model Invert the brush (subtract) Hold Alt while sculpting Smooth Hold Shift while sculpting (works with any brush, and with Paint) Straight line Press Shift after a stroke has started (45 degree steps) Roll the view Shift+click the background, let go of Shift, drag Rotate Left-drag on the background, or right-drag; hold Shift to snap to an axis view Pan Alt+left-drag on the background, Alt+right-drag, or middle-drag Zoom Mouse wheel; Alt+drag on the background then release Alt; Ctrl+right-drag; Ctrl+middle-drag; with the SculptForge input style also Ctrl+left-drag on the background (when nothing is masked) Paint the mask Hold Ctrl while stroking on the model Erase the mask Hold Ctrl+Alt while stroking on the model Blur / sharpen the mask Ctrl+click / Ctrl+Alt+click the model Invert the mask Ctrl+click the background Clear the mask Ctrl+drag on the background (with MaskPen), or Ctrl+Shift+A Mask inside a lasso or rectangle Ctrl+drag with MaskLasso or MaskRect picked in Tool > Masking (add Alt: unmask) Isolate a polygroup Ctrl+Shift+click it (again: invert the visibility; with something hidden already: hide it) Hide a polygroup Ctrl+Shift+Alt+click it Show everything Ctrl+Shift+click the background Hide outside a rectangle or lasso Ctrl+Shift+drag (add Alt: hide inside); SelectRect or SelectLasso in Tool > Visibility Select a SubTool Alt+click it in the view (Shift+Alt+click: select and frame it) Move, scale or rotate with the Gizmo 3D W, E or R, then drag a handle; hold Shift to snap (15 degrees, the grid, 10%) Move the gizmo only Alt+drag a gizmo handle Put the gizmo's pivot on the model Alt+click the model in Move, Scale or Rotate mode Pan, zoom or orbit with a button Drag on Move, Zoom or Rotate on the right shelf Help on any control Hold Ctrl and point at it (Ctrl+Alt: scripting parameters) Assign a shortcut Ctrl+Alt+click any button, then press the key Move or remove shelf items Ctrl+Alt+drag (with Enable Customize on) Tablet pressure Used automatically when a pen is detected (Pressure > Strength / Pressure > Size) Open files Drop a model (.obj, .glb ...), project, brush (.sfbrush), splat capture or image onto the window"},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"keys-inside-pop-ups-and-panels","h":"Keys inside pop-ups and panels","t":"Some keys only mean something while a pop-up or panel has the keyboard."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"brush-picker-b","h":"Brush picker (B)","t":"Key Action A letter Keep the brushes whose names start with the letters typed so far The orange letter on a tile Pick that brush (B S T = Standard) Backspace Take back one letter Enter Pick the first match Esc Close"},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"sliders-at-the-cursor-s-u-i-o","h":"Sliders at the cursor (S, U, I, O)","t":"Key Action Digits and . Type a value Enter Apply the typed value and close Esc Close without applying a typed value"},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"command-palette-f3","h":"Command palette (F3)","t":"Key Action Up / Down, Page Up / Page Down Choose a row Enter Run it Shift+Enter Open a command with parameters in the console to edit them Esc Close"},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"console-","h":"Console (`)","t":"Key Action Enter Run the line (statements separated by ;) Tab Complete a command or parameter name; press again to list the candidates Up / Down Walk through earlier lines (the last 200 are remembered between sessions)"},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"shortcut-capture-ctrlaltclick","h":"Shortcut capture (Ctrl+Alt+click)","t":"Key Action Any key or chord Becomes the new shortcut (taken from another action if it had it) Backspace or Delete Remove the shortcut Esc Cancel"},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"zbrush-keys-that-work-differently","h":"ZBrush keys that work differently","t":"ZBrush's keys and gestures work in SculptForge (with Preferences > Input > Style on ZBrush, the default). The few that differ, because the feature works differently or doesn't exist yet: ZBrush SculptForge P (perspective) P is the Paint brush; the view is always in perspective T (Edit mode) Always in Edit mode: there is no 2.5D canvas W / E / R (Transpose line) The Gizmo 3D (see Gizmo 3D) 1, 2, 3 (replay and record strokes) Not yet N (list the SubTools) Tool > SubTool in the right tray F1 to F6 (pop-ups) F1 is the Controls window, F3 the command palette; B, M and the left-shelf tiles pop up brushes, strokes, alphas and materials Ctrl+E (edge loop), Ctrl+U (reload ZScript) Export GLB and Send to Unreal H (hide the ZScript window) ` toggles the console See Coming from ZBrush for the whole list."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"see-also","h":"See also","t":"The interface Navigating the view Masking Polygroups and visibility"},{"p":"performance.html","c":"Performance and big meshes","a":"","h":"Performance and big meshes","t":"SculptForge is built to sculpt tens of millions of polygons. Brushes, normal updates and the picking structure run on every core of your processor, a stroke sends the graphics card only the part of the mesh it changed, and undo stores only the vertices a stroke touched, so it stays quick however big the model is. This chapter explains what to expect, the settings in Preferences > Performance, and how to get the most out of a big sculpt. Preferences > Performance after a stroke: antialiasing, Fast Navigation, multithreading, what the stroke cost per dab, and memory"},{"p":"performance.html","c":"Performance and big meshes","a":"what-to-expect","h":"What to expect","t":"On a 2021 laptop (Apple M1 Pro, 10 cores, integrated GPU), with X symmetry on and a medium Draw Size: Mesh One dab of a medium brush Turning the view 4 million triangles about 2 ms about 350 frames a second 16 million triangles about 4.5 ms about 170 frames a second 33 million triangles about 7.5 ms about 110 (4x antialiasing), 270 with Fast Navigation Turning the view stays smooth at 100 million triangles: about 50 frames a second with 4x antialiasing, 100 with Fast Navigation. These figures are for closed models (no holes); see \"Closed meshes draw faster\" below. A dab is one step of the brush along the stroke; the app draws several per frame when you move fast. Under 16 ms per dab a stroke keeps up with a 60 Hz display. Very large brushes cost more, since they move more vertices: a brush covering a tenth of a 33 million triangle sphere (about a million vertices per dab with symmetry) takes about 45 ms per dab with Standard, 21 ms with Smooth and 15 ms with Move, of which sending the change to the graphics card is about a third. Performance figures has the full measurements, and how to run the same benchmark on your own machine."},{"p":"performance.html","c":"Performance and big meshes","a":"preferences--performance","h":"Preferences > Performance","t":"Open Preferences and click Performance. Control What it does Antialiasing (Off, 2x, 4x, 8x) How many samples per pixel the 3D view uses to smooth edges. 4x is the default. More samples look smoother and cost more on huge meshes. If the graphics card can't make room for them, the view quietly uses fewer and the panel says so Fast Navigation While you rotate, pan or zoom a scene of 10 million triangles or more, draw it without antialiasing and draw big meshes as a lighter version with about a fifth of their triangles, so the view keeps up. The full mesh, smooth again, is back as soon as the view stops. On by default Multithreading Run brushes, normal and picking updates and project saving on every core (the number of threads is shown beside it). The results are exactly the same with it off; turn it off only to compare speeds or rule it out when something goes wrong Last stroke What your last stroke cost per dab: Brush (finding and moving the vertices), Normals (shading), BVH (the structure that finds the surface under the cursor), and the GPU upload per frame Memory What the scene holds: the meshes, the BVHs, the subdivision levels kept for stepping between them, the undo history (up to 1 GB; the oldest steps are dropped beyond that) and, roughly, the graphics card's buffers Like the other preferences, these last until you quit; Preferences > Config > Store Config keeps them. Every setting is also in the F3 command palette (type \"antialiasing\", \"fast navigation\" or \"multithreading\")."},{"p":"performance.html","c":"Performance and big meshes","a":"working-with-big-meshes","h":"Working with big meshes","t":"Sculpt at the lowest level that holds the detail. With subdivision levels you can shape the forms a few levels down and only go to the top for fine detail. Each level down is four times lighter. Hide what you're not working on. Hidden SubTools aren't drawn and hidden parts of a SubTool aren't sculpted (Tool > Visibility). A hidden SubTool costs no drawing time at all. Memory. A divided model takes about 85 bytes per triangle: about 37 for the sculpting mesh, 17 for its BVH and 29 for its subdivision levels. A 33 million triangle sculpt with levels needs about 3.4 GB of memory, a 100 million one about 9 GB (and a little more while dividing). Opening a project needs only a little more than the model itself. A mesh without levels (an import, a remesh) takes about 60 bytes per triangle for the mesh. Project files over 4 GB are saved in the ZIP64 format. How far Divide goes depends on the memory: about 160 million triangles on a computer with 32 GB. The graphics card. A mesh needs about 15 bytes per triangle on the graphics card (polypaint and a mask add about 3; the wireframe, while it is on, about 4; the lighter version Fast Navigation draws, once you move the view, about 1.5). If a SubTool doesn't fit, SculptForge doesn't draw it and says so in the status bar instead of failing: hide other SubTools or step down a subdivision level. Closed meshes draw faster. Parts of a mesh that face away from you are skipped when the mesh is closed (no holes or hidden parts) and you look at it from outside. A mesh with holes, hidden polygons, or a view from inside it draws everything, which can take about twice as long on huge meshes. Undo keeps only what each stroke changed, so a stroke on a 33 million triangle mesh undoes in a few tens of milliseconds, and the history holds many such strokes within its 1 GB."},{"p":"performance.html","c":"Performance and big meshes","a":"dynamic-topology","h":"Dynamic topology","t":"Dynamic topology only works where the brush is, so its speed depends on how many triangles the brush covers rather than on the size of the mesh: on an M1 Pro a medium dab takes 9 to 13 milliseconds on a one-million-triangle sphere. It gets slower when a big brush (or a low Detail) has to merge many small triangles at once; it then spreads the work over several dabs. Undoing a stroke rebuilds the mesh's connections, which takes about a tenth of a second per million triangles. sculptforge --bench --bench-dyntopo measures it on your machine."},{"p":"performance.html","c":"Performance and big meshes","a":"measuring-your-own-machine","h":"Measuring your own machine","t":"sculptforge --bench builds a sphere at 4, 16 and 32 million triangles and measures every brush, undo, stepping subdivision levels, saving and opening a project, and turning the view, then prints a report. sculptforge-cli --bench measures the same without the graphics card. Options: Option What it does --bench-sizes 4,16,32 The sizes, in millions of triangles --bench-dabs 40 Dabs per test stroke --bench-brushes large Only the brushes whose name contains the text (here the large-radius ones) --bench-no-project Skip saving and opening the project (which needs twice the memory) --bench-view Measure only what the view costs: uploading to the graphics card, a few strokes, and turning the view --bench-out report.md Write the report to a file The perf_info command (also in the Console) prints the threads in use and the memory the scene holds; set_multithreading enabled=false turns multithreading off from a script."},{"p":"performance.html","c":"Performance and big meshes","a":"see-also","h":"See also","t":"Subdivision levels Troubleshooting and FAQ Glossary"},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"","h":"Troubleshooting and FAQ","t":"This chapter collects fixes for common problems: start-up and graphics errors, tablets, AI service messages, ComfyUI errors, the camera notch, first-launch warnings on macOS and Windows, where SculptForge keeps its settings, how to reset the interface, and how to report a bug."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"sculptforge-doesnt-start","h":"SculptForge doesn't start","t":"SculptForge draws with OpenGL 3.3 (core profile). Almost every GPU from the last decade supports it, but an old driver, a remote desktop session or a virtual machine without 3D acceleration may not. Update your graphics driver from the GPU maker (NVIDIA, AMD, Intel) or your Linux distribution. Virtual machines: turn on 3D acceleration in the VM settings. Remote desktop: some remote sessions only offer an older OpenGL. Run SculptForge locally, or use a remote tool that forwards the GPU. Linux: on a machine without a working GPU driver, Mesa's software renderer works (slowly): LIBGL_ALWAYS_SOFTWARE=1 sculptforge. To see why it stopped, start it from a terminal and read the messages. It prints the OpenGL version and GPU it found at start-up (for example OpenGL 4.6 (Core Profile) Mesa 26.1.8 on ...), or the error, such as OpenGL 3.3 context creation failed or Missing OpenGL function: .... Linux: run sculptforge in a terminal. macOS: run /Applications/SculptForge.app/Contents/MacOS/SculptForge in Terminal. Windows: the release build has no console window; if it closes straight away, update the driver first."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"first-launch-warnings-on-macos-and-windows","h":"First launch warnings on macOS and Windows","t":"The release builds aren't code-signed yet, so the operating system warns the first time. macOS (Gatekeeper): \"SculptForge can't be opened because it is from an unidentified developer\". In Finder, right-click (or Ctrl+click) SculptForge in Applications and choose Open, then Open again. macOS remembers the choice. On recent macOS versions you may instead need System Settings Privacy & Security > Open Anyway. Windows (SmartScreen): \"Windows protected your PC\". Click More info, then Run anyway. Download SculptForge only from the official releases page on GitHub (the website that Help > Website & documentation opens links to it)."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"the-viewport-is-slow","h":"The viewport is slow","t":"Check the triangle count in the title strip (Tris). Millions of triangles on a laptop GPU are heavy; Tool > Geometry > Decimate or a lower Voxel Remesh resolution brings it down. See Subdivide, Remesh, Decimate and LODs. Turn off Wireframe (Shift+F) on dense meshes. Hide SubTools you aren't working on, or Solo the active one. A large Gaussian splat capture costs GPU time too: lower the count with Clean floaters, or untick Show in the Splats palette while you sculpt. On laptops with two GPUs, make sure SculptForge runs on the dedicated one (in the GPU maker's control panel or the operating system's graphics settings). Preferences > Performance: lower Antialiasing (or turn it off), keep Fast Navigation on, and look at Last stroke to see whether brushes or the graphics card take the time. Step down a subdivision level for big changes. See Performance and big meshes. A SubTool missing from the view with \"Not enough GPU memory\" in the status bar didn't fit on the graphics card: hide other SubTools or step down a level."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"pen-tablets","h":"Pen tablets","t":"SculptForge reads pen pressure through the operating system's standard pen input, so most Wacom, XP-Pen, Huion and similar tablets, and pen displays, work without settings. Open the Draw palette. Under Tablet it shows \"Pen pressure: 0.42\" once the pen has come near the tablet, or \"No pen detected\". Pressure > strength (on by default) and Pressure > size choose what pressure controls. They are also on the top shelf. A custom brush can also set its own pressure response (pressureCurve in its recipe, see Brush Lab and sharing brushes). If no pen is detected or pressure doesn't change: Install or update the tablet maker's driver, then restart SculptForge. Windows: most drivers have a Windows Ink option. If pressure doesn't reach SculptForge, try switching it (on or off) in the tablet driver's settings for SculptForge or for all applications, then restart SculptForge. Linux: check that the system sees the pen as a tablet (for example in your desktop's tablet settings). If the cursor moves but strokes have no pressure, test in another application to see whether the driver reports pressure at all."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"hugging-face-free-image-and-text-to-3d","h":"Hugging Face (free image and text to 3D)","t":"Message What to do Hugging Face's free GPU time is used up for now The anonymous daily allowance ran out. Add a free token (huggingface.co/settings/tokens, read access) in HF token in the Generate 3D window, or set HF_TOKEN; or wait for it to refill (about a day); or pick another model The Hugging Face Space is asleep or restarting The model's demo is starting up. Try again in a minute, or pick another model Waiting in the queue for a long time The demos are shared. Try a faster model (Hunyuan3D 2 mini Turbo, Stable Fast 3D) or another time of day TRELLIS.2 fails without a token TRELLIS.2 needs a Hugging Face token"},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"falai-and-meshy","h":"fal.ai and Meshy","t":"Message What to do The API key was rejected Check the key in the Generate 3D window, or the FAL_KEY / MESHY_API_KEY variable Out of credits on this account Top up your account with that service Model or endpoint not found Check the fal model id Rate limited Wait a moment and try again"},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"brush-lab","h":"Brush Lab","t":"The default Free provider uses a hosted open model with no account. If it is unreachable and Ollama runs on your computer, SculptForge uses your local model instead. \"Rate limited by the provider\" means too many requests in a short time: wait a few seconds. For setup of local models, see Brush Lab and sharing brushes."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"no-connection-at-all","h":"No connection at all","t":"AI features need internet access (except a local Ollama, LM Studio or ComfyUI). Behind a company proxy or firewall, ask IT to allow the service you use: huggingface.co (and *.hf.space), fal.ai, meshy.ai, or the Pollinations.ai text endpoint for the free Brush Lab model."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"comfyui-errors","h":"ComfyUI errors","t":"Message What to do Nothing is answering at http://... ComfyUI isn't running at that address, or a firewall blocks it. Check the address and port (8188 by default). For another computer, start ComfyUI with --listen ...answered, but not like ComfyUI Something else uses that port, or a proxy is in the way. Use the address ComfyUI prints when it starts This workflow was saved in ComfyUI's editor format Export it again in ComfyUI with Workflow > Export (API) This ComfyUI does not have the node ... or ...is missing the nodes ... Install the custom nodes the workflow uses (ComfyUI Manager > Install Missing Custom Nodes) and restart ComfyUI ...names a model file this server doesn't have Download the model into the right subfolder of ComfyUI's models folder, for example models/checkpoints ComfyUI rejected the workflow: node N ... An input is out of range. Open the workflow in ComfyUI: it shows the same error on that node The workflow finished but saved no mesh file End the workflow with Save GLB or another node that saves a mesh ...the GPU ran out of memory The GPU ran out of memory. Lower the resolution or octree size, or use a smaller model The job disappeared from ComfyUI's queue Someone cleared the queue or ComfyUI restarted. Generate again The workflow has no Load Image node You chose a text workflow on the From image tab. Use it from From text See Image and text to 3D for setup."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"the-top-of-the-window-is-hidden-behind-the-camera-notch","h":"The top of the window is hidden behind the camera notch","t":"On MacBooks with a camera notch, SculptForge keeps the interface below the notch when it fills the screen. If the title strip or palette bar is still covered, or a plain band appears where you don't want one, change Preferences > Interface > Camera notch: Automatic (asks the system on macOS, recognises notched MacBook displays on Linux), Always reserve, or Off. F11 switches between fullscreen and a window."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"text-and-buttons-are-too-small-or-too-large","h":"Text and buttons are too small or too large","t":"Preferences > Interface > UI scale sets the size (Automatic, 100% to 200%). It takes effect the next time SculptForge starts, and only if you press Store Config (Ctrl+Shift+I)."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"my-layout-or-shortcuts-are-gone-after-a-restart","h":"My layout or shortcuts are gone after a restart","t":"Like ZBrush, SculptForge never saves the layout on its own. Press Store Config (Ctrl+Shift+I) to keep the current layout, shortcuts and interface preferences. See The interface."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"reset-the-interface","h":"Reset the interface","t":"Preferences > Config > Restore Standard UI returns to the built-in layout and default shortcuts. Press Store Config afterwards to make it stick. Restore Custom UI goes back to what the last Store Config saved. To start completely fresh, quit SculptForge and delete ui.json (layout, shortcuts, interface preferences) and imgui.ini (positions of floating windows such as Brush Lab) from the settings folder below."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"a-key-does-nothing","h":"A key does nothing","t":"Shortcuts don't fire while you type in a text field: click the canvas first. Check the key in Help > Controls (F1), which shows every shortcut as currently assigned; a key you reassigned shows in orange in Preferences > Hotkeys, where Default shortcuts undoes every change."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"where-settings-live","h":"Where settings live","t":"SculptForge keeps its settings in one folder per user: System Settings folder Linux ~/.local/share/SculptForge/SculptForge/ (or $XDG_DATA_HOME/SculptForge/SculptForge/) macOS ~/Library/Application Support/SculptForge/SculptForge/ Windows %APPDATA%\\SculptForge\\SculptForge\\ (usually C:\\Users\\\\AppData\\Roaming\\SculptForge\\SculptForge\\) File or folder What it holds ui.json Layout, shortcut changes and interface preferences, written by Store Config imgui.ini Positions and sizes of floating windows ai.json AI settings: providers, models, keys, ComfyUI address (readable only by your account) project.json Recent files and the autosave interval autosave.sfproj The autosaved copy of unsaved work (removed once you save) clean_exit Marks a normal exit; without it, the autosave is offered for restore console_history.txt The console's command history recent_actions.txt Recently used entries of the command palette brushes/ Your brush library, one .sfbrush file per brush brush-gallery-cache/, brush-gallery.json Community brush gallery cache and its address thumbs/ Cached LightBox and picker thumbnails (safe to delete) Your library folder (projects, tools, alphas, images, splats and QuickSaves shown in the LightBox) is separate: Documents/SculptForge by default, changeable in Preferences > LightBox > Library folder. Tip: To move settings to another computer, copy ui.json, ai.json and the brushes folder. For a shared layout, use Preferences > Config > Save UI... and Load UI... instead."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"recovering-work-after-a-crash","h":"Recovering work after a crash","t":"SculptForge autosaves unsaved work every 5 minutes by default (Preferences > Autosave, 0 turns it off). After a crash, the next start asks \"SculptForge did not close normally last time. Restore the autosaved work?\". Restore opens it as unsaved work (save it under a name); Discard deletes it. See Projects, autosave and QuickSave."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"frequently-asked-questions","h":"Frequently asked questions","t":"Can SculptForge open ZBrush files (.ZTL, .ZPR)? Not directly: they are proprietary and undocumented. Convert ZTools once in ZBrush with the free SculptForge ZTool Export plug-in, then open the .ZTL in SculptForge (see Coming from ZBrush). Or use GoZ, or export OBJ or FBX from ZBrush (see Exporting, Send to Unreal and GoZ). .ZPR projects can't be converted; open their ZTools instead. Does it have subdivision levels, DynaMesh, ZRemesher or UVs? Voxel remesh works like DynaMesh, QRemesh like ZRemesher (with ProjectAll to bring the detail back; see Quad retopology), Auto UV unwraps any model, and Divide adds subdivision levels you can step up and down (see Subdivision levels). Dynamic on the top shelf is dynamic topology, like Sculptris Pro (see Dynamic topology). Is it really free? Can I sell what I make? Yes and yes. SculptForge is GPL-3.0-or-later free software; the licence covers the program, not your models. The AI models have their own licences (see Image and text to 3D). Does SculptForge send anything about me anywhere? No. There is no telemetry and no account. AI features talk only to the service you choose, when you use them. Does it work offline? Yes. Everything except the hosted AI services works offline, and Brush Lab and image-to-3D can run on local models (Ollama, LM Studio, your own ComfyUI or generator command). Where are my brushes? In the brushes folder in the settings folder above. Brush Lab saves every brush you make or refine there."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"report-a-problem","h":"Report a problem","t":"Choose Help > Report a problem to open the issue tracker on GitHub (you need a free GitHub account). A good report includes: The SculptForge version (Help > About SculptForge) and your operating system. Your GPU and driver: the OpenGL ... on ... line SculptForge prints at start-up (see SculptForge doesn't start), or the GPU name from your system settings. Steps to reproduce: what you did, what you expected and what happened instead. The commands you ran: open the console (the backtick key, left of 1), click Copy session as script and paste it into the report. It often reproduces the problem exactly. A file if the problem is with a particular model (a small .sfproj or the original file), and a screenshot for display problems. For a security problem, don't open a public issue; follow SECURITY.md in the repository instead."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"see-also","h":"See also","t":"Installing SculptForge The interface Glossary"},{"p":"glossary.html","c":"Glossary","a":"","h":"Glossary","t":"This chapter maps ZBrush terms to their SculptForge equivalents, so you can find a familiar tool quickly, and explains the terms that only SculptForge uses. \"Not yet\" means SculptForge doesn't have it today; see the roadmap for what is planned."},{"p":"glossary.html","c":"Glossary","a":"zbrush-terms-in-sculptforge","h":"ZBrush terms in SculptForge","t":"ZBrush SculptForge Alpha Alpha: built-in round, square and noise, or any grayscale image. Left shelf, Alpha palette. See Sculpting Auto Groups Tool > Polygroups > By pieces (polygroup_by_connectivity) BPR render Not yet as a renderer. Headless renders and turntables with sculptforge --render (Scripting) Brush pop-up (B) Brush picker, B, then type letters (B S T = Standard) Clip brushes Not yet. The Trim brush shaves to a plane Curve brushes, IMM, ZModeler, ZSpheres Not yet Decimation Master Tool > Geometry > Decimate (decimate). See Geometry Del Hidden Tool > Visibility > Delete hidden (delete_hidden) Del Lower, Del Higher Tool > Geometry > Del Lower / Del Higher (subdiv_delete_lower, subdiv_delete_higher). See Subdivision levels Divide (Ctrl+D), Smt Tool > Geometry > Divide, Ctrl+D, with Smt beside it (subdiv_divide). See Subdivision levels Document, 2.5D canvas, pixols Not planned: SculptForge is a 3D sculpting app only Draw Size Draw Size (top shelf, S, [ / ]) DynaMesh Voxel Remesh (Tool > Remesh, remesh). See Geometry Focal Shift No slider for the built-in brushes. Custom brushes have Hardness and Tip sharpness in their recipe Ghost, Transp Not yet. Inactive SubTools are drawn slightly dimmed GoZ GoZ: .GoZ import and export and the GoZ bridge (File > ZBrush (GoZ)). See Exporting Group Masked Tool > Polygroups > From mask (polygroup_from_mask) Group Visible Tool > Polygroups > Merge visible (polygroup_merge_visible) Groups By Normals Tool > Polygroups > By normals with an angle (polygroup_auto_by_normals) Bake, Multi Map Exporter (normal / displacement / AO maps) Tool > Bake (bake): tangent and object-space normal, displacement, AO, cavity and colour maps from a high-poly SubTool onto a low-poly's UVs. See Baking Layers (sculpt layers) Tool > Layers: sculpt layers with weights, exported as blend shapes. See Layers LazyMouse LazyMouse stroke type (Stroke palette) LightBox LightBox, , (comma) Live Boolean Not yet Local symmetry, radial symmetry Not yet. Symmetry is X, Y and Z across the world axes Mask by Cavity Tool > Masking > By cavity (mask_by_cavity) Masking (Ctrl) Hold Ctrl to paint the mask, Ctrl+Alt to erase. See Masking MaskLasso, MaskRect Tool > Masking: pick the shape, then Ctrl+drag (add Alt to unmask). See Masking MatCap Material: seven MatCaps, Sculpt the default, plus Studio (M). Custom MatCap images not yet. See Polypaint Morph target A sculpt layer; exported as glTF morph targets and FBX/USD blend shapes Mrgb, M (material channel) Not yet: there is no per-vertex material channel Polyframe (PolyF, Shift+F) PolyF on the right shelf, or Shift+F Polygroups Polygroups: same idea, same Ctrl+Shift gestures. See Polygroups and visibility Polypaint Polypaint: Paint brush (P), Rgb, fills, cavity paint. See Polypaint Polypaint layers Tool > Paint Layers: Photoshop-style colour layers with blend modes. See Paint layers Project All (ProjectAll) Tool > SubTool > Project > ProjectAll (project_all), with Dist, Mean and PA Blur; respects the mask. See Quad retopology Projection Master Not yet. Generate > Stamp projects an image onto the model from the view QuickSave QuickSave in the title strip; the last 10 are kept. See Projects Rgb Rgb on the top shelf (paint while sculpting) Rgb Intensity, Z Intensity, Focal Shift Same names and keys: RGB Intensity (I), Z Intensity (U), Focal Shift (O) in the Draw palette and the QuickMenu Sculptris Pro, dynamic topology Dynamic on the top shelf, with Detail (dyntopo). See Dynamic topology Reconstruct Subdiv Tool > Geometry > Reconstruct Subdiv (subdiv_reconstruct) SDiv, Lower Res / Higher Res (Shift+D / D) Tool > Geometry: the SDiv slider, Lower Res Shift+D, Higher Res D (subdiv_level). See Subdivision levels SelectLasso, SelectRect Tool > Visibility: pick the shape, then Ctrl+Shift+drag (add Alt to hide). See Polygroups Solo Solo on the right shelf or in Tool > SubTool Spotlight Not yet Preferences > Performance, Preferences > Mem Preferences > Performance: Antialiasing, Fast Navigation,"},{"p":"glossary.html","c":"Glossary","a":"sculptforge-terms","h":"SculptForge terms","t":"Term Meaning Brush Lab The AI brush creator: describe a brush in words and it builds a recipe you can tweak. Opens from AI Brush. See Brush Lab Brush code One line of text (sfbrush1:...) that holds a whole brush, for sharing in chat or a forum. Paste with Ctrl+V Brush library Your saved custom brushes, loaded at every start Brush recipe The data that defines a custom brush (direction, depth, plane, pinch, pattern and so on): values, never code .sfbrush A file holding one brush recipe .sfproj A SculptForge project file: the whole scene. See Projects Cross field The directions QRemesh wants quad edges to follow at every point of the surface, smoothed over the whole model. Singularities (where three or five quads meet) appear where the field must turn Command palette F3: search every command, brush and setting by name and run it Community gallery Shared CC0 brushes you can install in one click (Community brushes) Console The script console (backtick key): every action appears as a script line Ctrl help Hold Ctrl and point at a control to see what it does, its shortcut and its command Gaussian splat A 3D capture made of soft coloured blobs (from phone scanning apps). Load one as a reference, make it a sculptable mesh, or turn a sculpt into splats. See Gaussian splats and From scan to sculptable mesh Falloff (Gizmo 3D) How far a gizmo move eases in from the mask's edge, as a share of the SubTool's size: a soft joint when posing. See Gizmo 3D Generate 3D Turn an image or a description into a sculptable model. See Image and text to 3D Gizmo 3D The Move / Scale / Rotate handles (W E R) for placing and posing a SubTool or its unmasked part. See Gizmo 3D LOD chain A series of lighter copies of a model (LOD0, LOD1...) for game engines. See Geometry MCP Model Context Protocol: sculptforge-cli --mcp lets AI agents such as Claude run SculptForge commands Pivot The point the Gizmo 3D turns and scales about. Alt+click the model to put it there. See The pivot Subdivide One-way subdivision without levels (Tool > Geometry > Subdivide, subdivide); Divide keeps the levels Send to Unreal Export and import a model into a running Unreal Editor in one step (Ctrl+U) Shelves, palettes, trays The interface around the canvas: shelves hold the most-used controls, palettes hold everything, trays hold pinned palettes. See The interface Studio brush folder A shared, read-only brush folder for a team (SCULPTFORGE_BRUSH_PATH). See For studios Paint target (Vertex / Texture) Where painting goes on a SubTool that has a texture: its vertices (polypaint) or its texture. Top shelf, next to Rgb. See Texture painting QRemesh SculptForge's automatic quad retopology (ZBrush's ZRemesher), in Tool > Geometry. See Quad retopology Mirror plane (QRemesh) The plane QRemesh's Symmetry mirrors across: the model's own middle (the world's centre plane when the model is symmetric about it), found from the model. Like ZBrush's local symmetry. See Quad retopology Padding (gutter) The few texels around each UV island that texture painting and baking also fill, so seams don't show. See Texture painting and Baking Bake Capture a high-poly's detail as images (maps) on a low-poly's UVs. See Baking Cage (front / rear distance) How far in front of and behind the low-poly the bake's rays look for the high-poly. See Baking Displacement map A map of how far the high-poly lies from the low-poly along its normal; mid-grey = 0. See Baking Keep Texture Remesh option (Voxel Remesh, QRemesh): give the new surface Auto UVs and project the painted texture onto it, so the paint survives. See Texture painting MikkTSpace The standard way of computing tangents that game engines share, so tangent-space normal maps look the same everywhere. See Baking Normal map A map of surface directions that makes a low-poly shade like the high-poly. Tangent-space maps are relative to the surface (for engines), object-space maps to the model. See Baking Texel One pixel of a texture. Texture painting paints texels; their"},{"p":"glossary.html","c":"Glossary","a":"see-also","h":"See also","t":"Welcome to SculptForge The interface Keyboard and mouse reference"}];+window.GUIDE_INDEX=[{"p":"index.html","c":"SculptForge User Guide","a":"","h":"SculptForge User Guide","t":"This guide explains every part of SculptForge, the free, open-source sculpting app for VFX, animation and games: how the interface is organised, how to sculpt, mask, paint (on vertices or textures) and manage SubTools, how to generate models with AI, and how to get your work into a game engine, a film pipeline, Blender or ZBrush. It is written for SculptForge 0.4. You can read it inside SculptForge (Help > User Guide, or Shift+F1) or on the SculptForge website. If you're coming from ZBrush, start with Coming from ZBrush and keep the Glossary at hand: ZBrush's keys and gestures work as they are. The SculptForge window with its main regions labelled"},{"p":"index.html","c":"SculptForge User Guide","a":"getting-started","h":"Getting started","t":"Welcome to SculptForge What's new Coming from ZBrush Installing SculptForge The interface Navigating the view"},{"p":"index.html","c":"SculptForge User Guide","a":"sculpting","h":"Sculpting","t":"Sculpting and brushes Brush Lab and sharing brushes Masking Polygroups and visibility SubTools Polypaint and materials Texture painting Sculpt layers and blend shapes Facial shapes and live face Subdivision levels Dynamic topology Moving, rotating and posing (Gizmo 3D) Subdivide, remesh, decimate and LODs Quad retopology and detail projection"},{"p":"index.html","c":"SculptForge User Guide","a":"ai-and-capture","h":"AI and capture","t":"Image and text to 3D Gaussian splats Scan an object into a splat From scan to sculptable mesh Phone capture and AR"},{"p":"index.html","c":"SculptForge User Guide","a":"files-and-pipelines","h":"Files and pipelines","t":"Baking normal and displacement maps Exporting, Unreal and ZBrush Working with Blender Projects, autosave and QuickSave Scripting and automation SculptForge for studios"},{"p":"index.html","c":"SculptForge User Guide","a":"reference","h":"Reference","t":"Keyboard and mouse Performance and big meshes Troubleshooting and FAQ Glossary"},{"p":"index.html","c":"SculptForge User Guide","a":"getting-help","h":"Getting help","t":"Hold Ctrl and point at any button for what it does, its shortcut and its script command. Press F1 for every shortcut and mouse gesture, and F3 to find any command by name. Ask questions and report problems on the issue tracker (Help > Report a problem). SculptForge is free software under the GNU General Public License v3.0 or later. This guide is part of SculptForge and is covered by the same licence."},{"p":"welcome.html","c":"Welcome to SculptForge","a":"","h":"Welcome to SculptForge","t":"SculptForge is a free, open-source digital sculpting application for VFX, animation and games. This chapter explains what it is, what it can and can't do yet, and how the rest of this guide is organised."},{"p":"welcome.html","c":"Welcome to SculptForge","a":"what-sculptforge-is","h":"What SculptForge is","t":"SculptForge is a focused sculpting tool with the brushes, symmetry, masking and navigation that ZBrush artists already know, built around a ZBrush-style interface: shelves around a canvas, alphabetical palettes that hold every function, a LightBox of thumbnails and pop-up pickers. It runs natively on Windows, macOS and Linux, starts in a moment, works offline and costs nothing. ZBrush's keys and gestures work out of the box: see Coming from ZBrush. There is no account, no subscription, no licence server and no telemetry. It is free software under the GNU General Public License v3.0 or later. You own everything you make with it: the GPL covers the program, not your models."},{"p":"welcome.html","c":"Welcome to SculptForge","a":"what-you-can-do-with-it","h":"What you can do with it","t":"Sculpt with fourteen built-in brushes (Standard, Clay, Clay Buildup, Dam Standard, Move, Smooth, Inflate, Pinch, Flatten, Crease, Trim, Snake Hook, Layer and Nudge), four stroke types, brush alphas, X/Y/Z symmetry and tablet pressure. See Sculpting and brushes. Design brushes in words with Brush Lab: describe \"dry cracked mud\" and an AI builds a brush recipe you can tweak with sliders, keep in your library and share as a file or a one-line brush code. See Brush Lab and sharing brushes. Mask, group and hide parts of the model the ZBrush way: Ctrl to paint a mask, Ctrl+Shift to isolate a polygroup. See Masking and Polygroups and visibility. Keep separate meshes as SubTools (body, eyes, teeth, armour), each with its own undo history. See SubTools. Paint colour on the surface (polypaint) and look at the model through seven MatCap materials. See Polypaint and materials. Sculpt layers that double as blend shapes (morph targets), with live weights. See Sculpt layers and blend shapes. Rebuild the mesh: Loop subdivision, voxel remesh (similar to DynaMesh), decimation and one-click LOD chains. See Subdivide, remesh, decimate and LODs. Generate a model from a sketch, concept art or a description, free through Hugging Face or on your own ComfyUI server. See Image and text to 3D. Work with Gaussian splats from phone captures: sculpt against them or turn them into meshes. See Gaussian splats. Export to glTF/GLB, FBX, OpenUSD, OBJ, STL and PLY, send models straight into Unreal Engine, and exchange them with ZBrush through GoZ. See Exporting, Unreal and ZBrush. Automate everything: every action is a command you can type in the console, run headless with sculptforge-cli, script from Python or hand to an AI agent over MCP. See Scripting and automation."},{"p":"welcome.html","c":"Welcome to SculptForge","a":"what-it-doesnt-do-yet","h":"What it doesn't do yet","t":"SculptForge is young (version 0.8; see What's new). Some things ZBrush artists rely on are still on the roadmap: QRemesh curve guides. UV editing (seams, relax) and UDIM tiles. Booleans and stencils. Others are not on the roadmap: ZSpheres, ZModeler, the 2.5D canvas, and reading ZBrush's own .ZTL and .ZPR files directly (bring models over with GoZ, the ZTool Export plug-in for ZBrush, or as OBJ, FBX or GLB). Not yet: where a chapter describes a ZBrush feature SculptForge doesn't have, it says so in a callout like this one. The project's ROADMAP.md lists what is planned and in which order."},{"p":"welcome.html","c":"Welcome to SculptForge","a":"coming-from-zbrush","h":"Coming from ZBrush","t":"Most habits carry over. You sculpt with a left drag, hold Alt to subtract and Shift to smooth, drag on the background to rotate, Alt+drag to pan, and hold Ctrl to mask. The palettes have the names you expect (Alpha, Brush, Stroke, Tool, Transform...), the Tool palette holds the SubTool, Masking and Polygroups sub-palettes, B opens the brush pop-up with the same letter keys (B, S, T picks Standard), , opens the LightBox and Ctrl+Shift+I stores your interface, and S U I O, Space, Ctrl+W and the mask keys do what your hands expect. Coming from ZBrush lists what is the same, what differs and every shortcut side by side; the Glossary maps ZBrush terms to SculptForge ones."},{"p":"welcome.html","c":"Welcome to SculptForge","a":"how-this-guide-is-organised","h":"How this guide is organised","t":"Getting started: installing, the interface and navigating the view. Sculpting: brushes, Brush Lab, masking, polygroups, SubTools, polypaint, layers and mesh operations. AI and capture: generating models from images and text, and Gaussian splats. Files and pipelines: exporting, projects, scripting and studio deployment. Reference: keyboard and mouse, troubleshooting and the glossary. Inside SculptForge, Help > User Guide opens this guide in its own window with a table of contents, search and links between chapters. Two other kinds of help are always a keystroke away: Hold Ctrl and point at any button, slider or tile to see what it does, its shortcut and the script command behind it. Press F1 for the Controls sheet (every shortcut and mouse gesture) or F3 to search for any command by name."},{"p":"welcome.html","c":"Welcome to SculptForge","a":"getting-help-and-reporting-problems","h":"Getting help and reporting problems","t":"Help > Report a problem opens the issue tracker on GitHub (github.com/islandmed/SculptForge/issues). Include your operating system, your graphics card and what you did just before the problem; see Troubleshooting and FAQ for what else helps. Help > Website & documentation opens the SculptForge website."},{"p":"welcome.html","c":"Welcome to SculptForge","a":"see-also","h":"See also","t":"Installing SculptForge The interface Glossary"},{"p":"whats-new.html","c":"What's new","a":"","h":"What's new","t":"What changed in each version of SculptForge, newest first, with links to the chapters that explain it. This chapter opens by itself the first time you start a new version; you can always find it again under Help > What's New. Every detail is in the changelog."},{"p":"whats-new.html","c":"What's new","a":"version-090","h":"Version 0.9.0","t":"Maquette to performance: scan an object or a clay maquette with your phone, turn the scan into a clean mesh you can sculpt and animate, give a head the 52 ARKit facial shapes, and drive them live with your own face."},{"p":"whats-new.html","c":"What's new","a":"facial-shapes-and-live-face","h":"Facial shapes and live face","t":"Tool > Facial Shapes > Generate Facial Shapes gives a sculpted head the 52 Apple ARKit blend shapes (eyeBlinkLeft, jawOpen, mouthSmileRight, ...) as sculpt layers, fitted to its proportions from a template head with those shapes (ICT-FaceKit, MIT licence). Eyes, teeth and tongue SubTools get theirs too. Fix any shape by sculpting into its layer, check them with the Face test presets and sliders, and export them with their ARKit names to GLB, USD, FBX and Blender (as shape keys). face_weights drives them live from a face feed, and recorded takes play in the viewport and bake into a glTF animation or USD time samples. new_head starts a scene with a human head to sculpt on. See Facial shapes and live face."},{"p":"whats-new.html","c":"What's new","a":"scan-an-object-into-a-splat","h":"Scan an object into a splat","t":"Film an object with your phone, or take photos all around it, and SculptForge trains a Gaussian splat from it on your own graphics card. The splat appears in the viewport after a few hundred steps and sharpens while it trains; you can orbit around it, stop when it's good enough, or cancel. Pick Video... or Photos Folder... under Splats > Train from capture, or drop a video onto the window. The free Brush trainer is offered as a one-click download the first time. See Scan an object into a splat."},{"p":"whats-new.html","c":"What's new","a":"make-sculptable-from-a-scan-to-a-production-asset","h":"Make sculptable: from a scan to a production asset","t":"One click in the Splats palette turns a Gaussian-splat capture into a clean SubTool you can sculpt, rig and animate: a watertight surface with the floaters and background gone and open bottoms sealed, quad topology at a Game, Film or Sculpt budget, edge loops round the eyes and mouth and along the nasolabial folds when the capture is a head (mirrored across the face), and the capture's colours as polypaint or a texture. A crop box cuts away the table or the room; Review shows the face landmarks to nudge before remeshing. The splats stay, hidden. Five million splats take about ten seconds on a laptop. See From scan to sculptable mesh."},{"p":"whats-new.html","c":"What's new","a":"your-phone-as-sculptforges-camera","h":"Your phone as SculptForge's camera","t":"File > Capture from phone shows a QR code: scan it and your phone's browser can send SculptForge a scan (walk round an object for 20 to 60 seconds), a photo to turn into a model, or a splat file from a scanning app. Tap View in AR to see your sculpt standing on your desk, updated as you sculpt, and Face capture to drive a character's facial shapes with your own face, live. No app to install. See Phone capture and AR."},{"p":"whats-new.html","c":"What's new","a":"version-081","h":"Version 0.8.1","t":"Fixes from a ZBrush artist's testing, and a way to bring your ZTools over."},{"p":"whats-new.html","c":"What's new","a":"more-like-zbrush","h":"More like ZBrush","t":"ZBrush zoom direction. With the ZBrush input style, dragging up zooms out on every zoom drag, as in ZBrush. See Navigation. Ctrl and Ctrl+Shift brushes. Hold Ctrl and the left shelf shows the mask brush; with Ctrl held the Brush and Stroke pickers pick MaskPen, MaskLasso or MaskRect. Ctrl+Shift does the same for SelectRect and SelectLasso. See Masking. Group by UVs. One polygroup per UV island, in Tool > Polygroups. See Polygroups and visibility."},{"p":"whats-new.html","c":"What's new","a":"texture-painting-one-click-to-start-and-faster","h":"Texture painting: one click to start, and faster","t":"With the Paint brush on, a SubTool without a texture now shows New Texture on the top shelf and in the Color palette: click it and SculptForge unwraps the model if it has no UVs (Auto UV, in the background) and gives it a texture, so the next stroke paints texels. Big brushes on 4K textures paint four to five times faster. See Texture painting."},{"p":"whats-new.html","c":"What's new","a":"bring-your-ztools-over","h":"Bring your ZTools over","t":"ZBrush's .ZTL files are proprietary, but a free plug-in for ZBrush now converts them once, and then SculptForge opens the .ZTL itself, every SubTool with its polygroups, polypaint, mask and UVs. See Coming from ZBrush."},{"p":"whats-new.html","c":"What's new","a":"version-08","h":"Version 0.8","t":"Dynamic topology, vector displacement brushes, QRemesh Guides, and sculpt layers on every subdivision level."},{"p":"whats-new.html","c":"What's new","a":"dynamic-topology-sculptris-pro","h":"Dynamic topology (Sculptris Pro)","t":"Turn on Dynamic on the top shelf and the brush adds triangles where it needs detail and removes them where it doesn't: pull a sphere into horns or fingers without stretching, block in from a ball without remeshing. Detail sets how small the triangles get, relative to the brush (zoom in for finer ones) or, with Constant detail, one size for the whole mesh. Symmetry makes mirrored triangles, borders and masks are kept, and each stroke is one small undo step. See Dynamic topology."},{"p":"whats-new.html","c":"What's new","a":"vector-displacement-brushes","h":"Vector displacement brushes","t":"One drag stamps a whole shape, overhangs and all: the new VDM brush presses a vector displacement map, so a horn can lean over, an ear can curl and scales can overlap, which no alpha can do. Four maps come with it (Horn, Ear Curl, Scales, Nostril); make your own by sculpting on a VDM Plane and clicking Create VDM, or load the EXRs Blender's VDM Brush Baker makes (and export yours for Blender). The new DragDot stroke slides a stamp into place. See Vector displacement brushes."},{"p":"whats-new.html","c":"What's new","a":"zbrush-keys-in-blenders-sculpt-mode","h":"ZBrush keys in Blender's Sculpt Mode","t":"The Blender add-on has a new preference, ZBrush-style keys in Sculpt Mode: S, U and O for Draw Size, Strength and Focal Shift, B for the brushes by their ZBrush names, Space for the quick menu, Alt to dig in, Ctrl to mask, Ctrl+Shift to hide, D and Shift+D for subdivision levels, and more. See Working with Blender."},{"p":"whats-new.html","c":"What's new","a":"draw-the-edge-loops-you-want","h":"Draw the edge loops you want","t":"QRemesh Guides are ZBrush's ZRemesher Guides brush: draw curves on the sculpt, around the eyes, the mouth or a joint, and QRemesh puts an edge loop on each one and turns the flow around it to follow. A curve that ends where it started becomes a loop that closes cleanly, symmetry mirrors what you draw, and Curves Strength sets how far around a curve the flow follows it. Guides are kept with each SubTool and saved in the project. See QRemesh Guides."},{"p":"whats-new.html","c":"What's new","a":"sculpt-layers-on-every-subdivision-level","h":"Sculpt layers on every subdivision level","t":"Sculpt layers now have a guide section on how they work with subdivision levels, like ZBrush's 3D Layers: record a layer at the top, step down and up, divide, reconstruct or delete levels, save, and it's still there, with one weight for every level. See Layers and subdivision levels."},{"p":"whats-new.html","c":"What's new","a":"version-07","h":"Version 0.7","t":"ZBrush's keys and gestures by default, and a bridge that sends models between Blender and SculptForge."},{"p":"whats-new.html","c":"What's new","a":"your-zbrush-hands-just-work","h":"Your ZBrush hands just work","t":"SculptForge now follows ZBrush's keys and gestures by default. A ZBrush sculptor tried an earlier version and put it down because it didn't feel like ZBrush; this release goes through every habit of the first hour. Coming from ZBrush lists what's the same, what's different and every shortcut side by side. S, U, I, O open Draw Size, Z Intensity, RGB Intensity and Focal Shift under the cursor, and Space opens the QuickMenu with all of them plus the brush, stroke, alpha and material. Focal Shift shapes the brush falloff, shown as the cursor's inner ring. RGB Intensity gives painting a strength of its own, and Smooth keeps its own Z Intensity, so a gentle brush still smooths properly. ZBrush's brush letters: B C B ClayBuildup, B D S DamStandard, B M V Move, B I N Inflate... Masking: Ctrl+click the model blurs the mask, Ctrl+Alt+click sharpens it; Ctrl+A, Ctrl+Shift+A, Ctrl+I, Ctrl+H and Ctrl+W (group masked) work as in ZBrush. Strokes and the view: Shift pressed mid-stroke draws a straight line; Shift+click, let go and drag rolls the view; Shift+Alt+click frames a SubTool; L toggles LazyMouse and V swaps colours. Visibility: Ctrl+Shift+click on a partly hidden mesh hides the group, as in ZBrush. Prefer the old keys? Preferences > Input > Style > SculptForge brings back the number keys for brushes, I for Z Intensity and the Ctrl+drag zoom. See Sculpting and brushes, Masking and Keyboard and mouse."},{"p":"whats-new.html","c":"What's new","a":"works-with-blender","h":"Works with Blender","t":"Keep Blender for your scene and sculpt in SculptForge: the new SculptForge Bridge add-on for Blender 4.2 and newer sends the selected objects to SculptForge with one click (starting it if needed), and File > Blender > Send to Blender sends them back. The objects update in place, keeping their transform, materials and modifiers; quads, UVs, colours, the mask and face sets (polygroups) come across both ways. See Working with Blender."},{"p":"whats-new.html","c":"What's new","a":"version-06","h":"Version 0.6","t":"Performance: half the memory, a view that turns twice as fast, quicker brushes on huge meshes, and SculptForge now tells you when there's a new version."},{"p":"whats-new.html","c":"What's new","a":"lighter-sculpts","h":"Lighter sculpts","t":"A sculpt with subdivision levels takes about half the memory it did: a 33 million triangle model with its levels needs about 3.4 GB instead of 5.6, so a laptop with 32 GB holds models of 100 million triangles and more. Divide goes past 100 million triangles. The limit now follows your computer's memory instead of stopping at 50 million. Opening a project is twice as fast and no longer needs twice the model's memory while it loads. Project files of divided models are about 30% smaller. Projects from 0.5 open as before; save a copy if you still need to open it in 0.5. Sculpting gives exactly the same results as before: only the way the levels and the mesh's neighbour lists are stored changed. See Performance and big meshes."},{"p":"whats-new.html","c":"What's new","a":"big-brushes-on-huge-meshes","h":"Big brushes on huge meshes","t":"Brushes are quicker on tens of millions of polygons. On a 33 million triangle model a medium brush takes about 7.5 ms per dab (12 in 0.5), a brush covering a tenth of the model (a million vertices per dab with symmetry) about 45 ms (60 to 80 in 0.5), and masking and painting about twice as fast. Undoing a big stroke is about twice as fast too, and sculpting needs about 300 MB less memory at that size. See Performance and big meshes."},{"p":"whats-new.html","c":"What's new","a":"a-faster-lighter-viewport","h":"A faster, lighter viewport","t":"Turning the view around a huge sculpt is now about twice as fast (a 33 million triangle model: 109 frames a second with 4x antialiasing, 270 with Fast Navigation, from 49 and 68), and the graphics card needs about a third of the memory it did. Only what you can see is drawn. The mesh is drawn in patches of a few thousand triangles; patches outside the view, and on closed meshes the ones facing away from you, are skipped. Fast Navigation draws a lighter version of big meshes while the view moves, about a fifth of the triangles, and the full mesh again as soon as it stops. A 100 million triangle sphere turns at about 100 frames a second on an M1 Pro laptop. A third of the graphics memory: about 15 bytes per triangle (it was over 40 on meshes with quads), so bigger sculpts fit on the graphics card. The wireframe's edges are only kept while the wireframe is on. Opening a big model or dividing it sends it to the graphics card about 40% faster. See Performance and big meshes."},{"p":"whats-new.html","c":"What's new","a":"stl-files-print-at-the-right-size","h":"STL files print at the right size","t":"STL export is now in millimetres with Z up, as slicers expect: models used to arrive 1000 times too small and lying on their back. Set a print height in millimetres when you export, and STL files you open come in upright at their real size. See Exporting."},{"p":"whats-new.html","c":"What's new","a":"update-notifications","h":"Update notifications","t":"Once a day SculptForge looks on its website for a newer version, and if there is one, a small banner says what's in it, with What's new, Download, Later and Skip this version. It downloads one small file and sends nothing about you or your computer. Turn it off under Preferences > Updates, or check by hand with Help > Check for updates. Builds from a package manager (such as the AUR package) leave the checking to the package manager."},{"p":"whats-new.html","c":"What's new","a":"version-05","h":"Version 0.5","t":"The ZBrush workflow core: subdivision levels, quad retopology, map baking, the Gizmo 3D, and speed at tens of millions of polygons."},{"p":"whats-new.html","c":"What's new","a":"subdivision-levels","h":"Subdivision levels","t":"Sculpt one model at several resolutions, as with ZBrush's SDiv: big forms low, fine detail high, and back down without losing anything. Divide (Ctrl+D) adds a level and keeps the ones below. Quads stay quads (Catmull-Clark); Smt off divides without smoothing. Lower Res / Higher Res (Shift+D / D) and the SDiv slider step between levels. Detail sculpted high rides along when you reshape low, and edits high show up softened below. Stepping back and forth is instant, even at millions of polygons. Mask, polypaint, paint layers, polygroups, hidden faces, UVs and sculpt layers follow the levels. Del Lower, Del Higher and Reconstruct Subdiv (find the lower levels of a model subdivided elsewhere). Undo walks back through strokes and level changes; projects save every level; the SubTool list shows \"SDiv 3/5\". Ctrl+D now divides with levels; the old one-way Subdivide is still in Tool > Geometry. See Subdivision levels."},{"p":"whats-new.html","c":"What's new","a":"gizmo-3d-move-scale-rotate-and-pose","h":"Gizmo 3D: move, scale, rotate and pose","t":"ZBrush's Gizmo 3D, with the same keys: W Move, E Scale, R Rotate, Q back to Draw (also on the top shelf and in the Transform palette). Handles over the model. Arrows, plane squares and a free-move centre; axis rings and a view ring; axis boxes and a uniform centre. Shift snaps to 15 degrees, the grid or 10% steps. Only the unmasked part moves, so posing is: mask the body, Alt+click the shoulder to put the pivot there, raise Falloff for a soft joint, turn the arm. With X symmetry both arms move together. Pivot tools: Alt+drag the gizmo to move it alone, Reset, To Surface, World or Surface axes. Numeric entry in the Gizmo 3D panel, All SubTools (Transpose All), one undo step per drag, sculpt layers move with the surface, and the transform command for scripts. Fast on big models: a drag frame on 1.3 million triangles takes about 10 ms. W no longer toggles the wireframe: use Shift+F (as in ZBrush) or PolyF on the right shelf. See Moving, rotating and posing."},{"p":"whats-new.html","c":"What's new","a":"normal-displacement-and-ao-map-baking","h":"Normal, displacement and AO map baking","t":"Bake the detail of a high-poly sculpt into maps on a low-poly's UVs, for game engines and renderers: Tool > Bake. Six maps in one go: tangent-space normal, object-space normal, displacement (16-bit PNG with mid-grey = 0, plus a 32-bit EXR in world units), ambient occlusion, cavity and colour (polypaint or texture). Right in every engine. Tangent-space maps use MikkTSpace tangents, as Blender, Unreal, Unity and Godot do; pick the OpenGL or DirectX green convention. Check it on the model. The low-poly shows its baked normal map in the viewport as soon as the bake ends, next to the high-poly. ZBrush-style controls: source SubTool, 1K-8K, anti-aliasing, automatic or manual front and rear ray distances, padding around UV islands. Bakes run in the background on every core, with progress and Cancel. Send to Unreal brings the normal map along, set up as a normal map. The bake command does it all from scripts. See Baking normal and displacement maps."},{"p":"whats-new.html","c":"What's new","a":"quad-retopology-and-detail-projection","h":"Quad retopology and detail projection","t":"QRemesh (Tool > Geometry, like ZRemesher) rebuilds a sculpt as clean quads whose edge loops follow the forms, near a Target Polygons count, in the background. Keep Groups, Adaptive Size, Use Polypaint, Symmetry and Half / Same / Double work as in ZBrush. ProjectAll (Tool > SubTool > Project) puts the sculpted detail and polypaint back onto the divided quads, with Dist, Mean and PA Blur, and respects the mask. See Quad retopology and detail projection."},{"p":"whats-new.html","c":"What's new","a":"performance-at-tens-of-millions-of-polygons","h":"Performance at tens of millions of polygons","t":"Sculpting a 33 million triangle model on a laptop now keeps up with the display: a medium brush costs about 10 ms per dab instead of 400, and turning the view runs at 50-70 frames a second instead of 32. Brushes use every core: every brush, mask and paint stroke, the normal updates and the picking structure. Results are exactly the same as on one core. Strokes send the graphics card only what they changed. Before, a dab with symmetry on a subdivided model re-sent most of the mesh. Fast undo: undo keeps only the vertices a stroke changed, and the first polypaint stroke on a model no longer copies the whole mesh for undo. Less memory: about 30% less per triangle for a sculpting mesh. Faster projects: saving and opening big projects is faster, and projects over 4 GB save (ZIP64). Preferences > Performance: Antialiasing (Off to 8x), Fast Navigation (big scenes drop antialiasing while the view moves), Multithreading, what your last stroke cost per dab, and the memory the scene holds. A SubTool too big for the graphics card is left out of the view with a message, instead of failing. sculptforge --bench measures your machine. See Performance and big meshes."},{"p":"whats-new.html","c":"What's new","a":"polish","h":"Polish","t":"Your paint survives Auto UV and retopology. Auto UV on a painted SubTool moves the texture and its layers onto the new UVs. Voxel Remesh and QRemesh have a Keep Texture option (on by default) that unwraps the new surface and projects the texture onto it, and merging SubTools keeps their textures in one. Each is a single undo step. See Texture painting. Faster, safer Auto UV on dense sculpts: no more crash or folded UVs on dense smooth meshes, and a million-triangle sculpt unwraps in a quarter of a minute or so. Decimate keeps the texture exact across UV seams. Subdivision levels, polished. Tools that rebuild the mesh (remesh, Decimate, QRemesh, Subdivide, Delete Hidden, merge and split) tell you they removed the levels and that the level you were on became the new base; Ctrl+Z brings them all back. Sculpt layers' fine detail turns with a low level you pose with the Gizmo, and SubTools you aren't working on no longer hold cached levels in memory. QRemesh symmetry follows your model. Symmetry (now on by default) mirrors across the model's own middle, so a model away from the centre comes out mirror-symmetric too. If the model isn't symmetric, QRemesh remeshes it whole and tells you. Eyes, teeth and rivets get their own quads instead of disappearing, and thin hard-edged parts such as blades and fins keep both sides and their edges. See Quad retopology. Tidier top shelf: the Vertex / Texture paint target only shows when the SubTool has a texture. Exports checked by other tools: textured GLB, USD/USDZ, FBX and OBJ files were checked with the Khronos validator, OpenUSD and ufbx, and the texture is the right way up in each. A model saved as my scene.obj now writes my_scene.mtl so other apps find it. See Exporting."},{"p":"whats-new.html","c":"What's new","a":"texture-painting-on-uv-maps","h":"Texture painting on UV maps","t":"Paint into a texture instead of the vertices, so the colour detail comes from the texture (1K to 8K), not from the mesh: sharp decals, pores and freckles on a light game mesh. Auto UV. Tool > Texture Map > Auto UV unwraps any sculpt in the background. Models that come in with UVs keep them, and now OBJ, FBX, USD and glTF carry UVs in and out too. New Texture. Pick a size and click New Texture: the Paint brush, Rgb sculpting, fills, cavity paint and colour picking (C) now work on the texture, with the mask, symmetry, pen pressure and alphas. Strokes never paint through to the far side, and seams stay invisible. Vertex or Texture. A toggle on the top shelf chooses where paint goes for each SubTool. The same paint layers. Tool > Paint Layers works on the texture's layers: blend modes, opacity, merge, flatten, all undoable. Convert both ways, Show UVs, Import / Export Texture (PNG). Projects save textures and their layers, and model exports write the texture next to the model (OBJ .mtl, glTF, USD, FBX, GoZ). See Texture painting."},{"p":"whats-new.html","c":"What's new","a":"version-041","h":"Version 0.4.1","t":"A fix for graphics tablets: the brush ring no longer flickers between two places on the model (it looked like a second brush blinking, most often while masking or smoothing). Some tablet drivers, Windows Ink among them, send extra mouse movements beside the pen's; now, while the pen is in range, only the pen moves the brush. See Pen tablets if your pen still misbehaves."},{"p":"whats-new.html","c":"What's new","a":"version-04","h":"Version 0.4","t":"Version 0.4 is about making SculptForge feel like home to ZBrush artists. It was shaped by feedback from a working ZBrush modeler and by what sculptors say on the ZBrush and Mudbox forums."},{"p":"whats-new.html","c":"What's new","a":"navigation-that-works-like-zbrush","h":"Navigation that works like ZBrush","t":"Free rotation. Dragging turns the model the way the cursor moves and can roll it right over the top, as in ZBrush. If you prefer the model to stay upright, set Preferences > Interface > Rotation to Turntable. Snap to a view. Hold Shift while rotating to snap to the nearest front, back, side, top or bottom view. ZBrush zoom. Alt+drag on the background pans; let go of Alt while still dragging and the rest of the drag zooms. With the right mouse button, Alt pans and Ctrl zooms. See Navigating the view."},{"p":"whats-new.html","c":"What's new","a":"mask-and-isolate-with-a-lasso-or-rectangle","h":"Mask and isolate with a lasso or rectangle","t":"MaskLasso and MaskRect. Pick the shape at the top of Tool > Masking, then Ctrl+drag to mask everything inside it; add Alt to unmask. The drag can start on the model or beside it. SelectLasso. In Tool > Visibility, pick SelectLasso next to SelectRect, then Ctrl+Shift+drag a free-hand shape to keep only what's inside (add Alt to hide it instead). See Mask with a lasso or rectangle and Polygroups and visibility."},{"p":"whats-new.html","c":"What's new","a":"a-material-made-for-sculpting","h":"A material made for sculpting","t":"The new Sculpt material is the default: plain clay under a strong key light, with crisp highlights and deep shading in the creases, so even small strokes stay easy to read. The other materials are still in the material picker (M), and projects keep the material they were saved with. See Polypaint and materials."},{"p":"whats-new.html","c":"What's new","a":"quads-stay-quads","h":"Quads stay quads","t":"Models you bring in from ZBrush (GoZ) or as OBJ, FBX, PLY or USD keep their quads: PolyF shows them as quads, and exporting writes them back as quads. Subdivide turns each quad into four, voxel remesh now gives an even grid of quads (like DynaMesh), and new cubes and planes are made of quads. See Quads and triangles."},{"p":"whats-new.html","c":"What's new","a":"paint-layers","h":"Paint layers","t":"Polypaint now has layers, like Photoshop: each SubTool can have a stack of colour layers with their own opacity, visibility, lock and blend mode (Multiply, Screen, Overlay, Soft Light, Add and more). Painting on a layer never destroys what's underneath, and you can merge, flatten, duplicate and reorder layers. ZBrush has never had this. Find it in Tool > Paint Layers, and see Paint layers. The Paint Layers sub-palette with three layers and their blend modes"},{"p":"whats-new.html","c":"What's new","a":"easier-to-install","h":"Easier to install","t":"The download links now always get the newest version, and there are one-command installers for Windows, macOS and Linux."},{"p":"whats-new.html","c":"What's new","a":"version-03","h":"Version 0.3","t":"SubTools: several separate meshes in one scene. Append, duplicate, split, merge, solo, and Alt+click to select. See SubTools. A ZBrush-style interface: shelves around the canvas, alphabetical palettes, the LightBox (,), the brush, stroke, alpha and material pickers, hold-Ctrl help on every control and a command palette (F3). See The interface. Graphics tablets: pen pressure, the eraser end and pen buttons. See Sculpting and brushes. A brush library with brush codes to share and a community gallery. See Brush Lab and sharing brushes. ComfyUI workflows for image and text to 3D. See Image and text to 3D. This user guide, built into the app (Help > User Guide, Shift+F1)."},{"p":"whats-new.html","c":"What's new","a":"version-02","h":"Version 0.2","t":"Masking, polygroups and visibility, and polypaint with MatCaps. New brushes: DamStandard, ClayBuildup, SnakeHook, Trim, Layer and Nudge, with strokes and alphas. Project files with autosave, recent files and QuickSave, and GoZ exchange with ZBrush."},{"p":"whats-new.html","c":"What's new","a":"version-01","h":"Version 0.1","t":"The first release: sculpting with symmetry and sculpt layers, voxel remesh and decimation, game-ready LOD chains and Send to Unreal, image and text to 3D with free AI models, Gaussian splats, OpenUSD, and scripting from the command line, Python and AI agents."},{"p":"coming-from-zbrush.html","c":"Coming from ZBrush","a":"","h":"Coming from ZBrush","t":"This chapter is for sculptors whose hands already know ZBrush. It lists what works the same, what is different, and the shortcuts side by side, so you can start sculpting instead of relearning. SculptForge follows ZBrush's keys and gestures by default; where it has habits of its own, they are kept as a preference."},{"p":"coming-from-zbrush.html","c":"Coming from ZBrush","a":"whats-the-same","h":"What's the same","t":"The layout. Shelves around the canvas, palettes in alphabetical order in the palette bar and the trays, sub-palettes that fold, the LightBox on ,, Ctrl-hover help on every control, Ctrl+Alt+click to assign a hotkey, Store Config on Ctrl+Shift+I. See The interface. Navigation. Drag on the background to rotate freely (over the top, too), Alt+drag to move, Alt+click, let go of Alt and drag to scale, Shift during a rotation to snap to a side view, Shift+click, let go of Shift and drag to roll. Right-drag navigation works as with ZBrush's RightClick Navigation turned on, over the model too. F frames the model. See Navigating the view. Sculpting modifiers. Alt swaps Zadd and Zsub, Shift smooths (Smooth keeps its own Z Intensity), Shift pressed after a stroke starts draws a straight line. Brush keys. B then two letters, with ZBrush's letters: B S T Standard, B C B ClayBuildup, B D S DamStandard, B M V Move, B I N Inflate, B S M Smooth, B S H SnakeHook, B P I Pinch. Brush settings. S Draw Size, U Z Intensity, I RGB Intensity, O Focal Shift, each as a slider under the cursor; [ and ] step the size; Space opens the QuickMenu; L toggles LazyMouse. The cursor's outer ring is the Draw Size, the inner ring the Focal Shift. See Sculpting and brushes. Masking. Ctrl paints a mask and Ctrl+Alt erases it; Ctrl+click the model blurs it and Ctrl+Alt+click sharpens it; Ctrl+click the background inverts it and Ctrl+drag there clears it. MaskLasso and MaskRect: with Ctrl held the shelf shows the mask brush, and the Brush (B) and Stroke pickers pick it. See Masking. Visibility and polygroups. Ctrl+Shift+drag keeps the inside (press Alt to hide it instead), Ctrl+Shift+click a group to isolate it (on a partly hidden mesh: to hide it), Ctrl+Shift+click the background to show everything, Ctrl+W to group the masked part. SelectRect and SelectLasso, also from the Brush and Stroke pickers with Ctrl+Shift held. Group by UVs is UV Groups. See Polygroups and visibility. SubTools with Alt+click to select one and Shift+Alt+click to select and frame it; subdivision levels with Ctrl+D, D and Shift+D; PolyFrame on Shift+F; QuickSave on 9. See SubTools and Subdivision levels. GoZ. Send models to and from ZBrush. See Exporting, Unreal and ZBrush. VDM brushes with DragRect and DragDot, and your own made from a VDM plane. See Vector displacement brushes. Sculpting in Blender too? The Blender add-on can give Blender's Sculpt Mode ZBrush's keys. See Working with Blender."},{"p":"coming-from-zbrush.html","c":"Coming from ZBrush","a":"bring-your-ztools-over","h":"Bring your ZTools over","t":"ZBrush's .ZTL files are proprietary, so SculptForge can't read them directly. The free SculptForge ZTool Export plug-in runs inside ZBrush and converts them once: Download SculptForgeZToolExport.txt (also attached to every release) and copy it into ZBrush's ZStartup/ZPlugs64 folder, then restart ZBrush. Or load it once with ZScript > Load. In ZBrush, ZPlugin > SculptForge > Convert ZTL asks for a .ZTL, loads it and writes each SubTool next to it as a GoZ file (Dragon.ZTL gives Dragon.sf001_Body.GoZ, Dragon.sf002_Horns.GoZ...). Save for SculptForge does the same for the ZTool you have open, saving the .ZTL where you choose. In SculptForge, open the .ZTL (File > Open, or drop it on the window). Its SubTools open in the same order with the same names, polygroups, polypaint, mask and UVs. Each SubTool comes over at its highest subdivision level; the lower levels, sculpt layers and ZBrush materials don't. If you change the ZTool in ZBrush later, convert it again: SculptForge warns when the .ZTL is newer than its conversion. .ZPR projects can't be converted; save their ZTools first. Note: the plug-in is new and hasn't been tested in every ZBrush version yet. If it stops with an error or a SubTool is missing, please report it with your ZBrush version; exporting each SubTool with Tool > Export as .GoZ or .OBJ works in the meantime."},{"p":"coming-from-zbrush.html","c":"Coming from ZBrush","a":"whats-different","h":"What's different","t":"ZBrush SculptForge Why Transpose action line (W E R) The Gizmo 3D on the same keys; mask what should stay, and Alt+click to put the pivot on the model Simpler to learn; ZBrush has a Gizmo 3D too. See Gizmo 3D Edit mode (T) and the 2.5D canvas Always in Edit mode SculptForge is a 3D sculpting app only Perspective toggle (P) Always perspective; P is the Paint brush (colour only, ZBrush's Rgb on, Zadd off) Stroke replay (1, 2, 3) Not yet N lists the SubTools The SubTool sub-palette in the right tray DynaMesh, ZRemesher Voxel Remesh and QRemesh in Tool > Geometry See Geometry and Retopology Sculptris Pro Dynamic on the top shelf, with its Detail slider See Dynamic topology Open edges hold their shape when smoothed Smooth pulls an open border in a little with each pass Mask the border first when it matters Values 0-100 everywhere The same for Z Intensity, RGB Intensity and Focal Shift; Draw Size is the radius in pixels The Glossary maps every ZBrush term to its SculptForge name."},{"p":"coming-from-zbrush.html","c":"Coming from ZBrush","a":"the-sculptforge-input-style","h":"The SculptForge input style","t":"Earlier versions of SculptForge had a few keys of their own, and some people like them. Preferences > Input > Style switches between: ZBrush (default) SculptForge 1 to 9, 0 Free (9 is QuickSave) Pick the ten first brushes (Standard, Clay, Smooth, Move ...) I RGB Intensity at the cursor Z Intensity at the cursor (as U) Ctrl+drag on the background with nothing masked Nothing Zooms Zoom drags (Ctrl+right-drag, Alt then release) Up zooms out Up zooms in Preferences > Input > Rotation chooses free rotation (ZBrush) or a turntable that keeps the model upright, as in Blender or Maya. Press Store Config (Ctrl+Shift+I) to keep either."},{"p":"coming-from-zbrush.html","c":"Coming from ZBrush","a":"shortcuts-side-by-side","h":"Shortcuts side by side","t":"Action ZBrush SculptForge Rotate / move / scale the view Drag / Alt+drag / Alt, release, drag on the background Same Snap to a side view / roll Shift while rotating / Shift+click, release, drag Same Frame F F Brush pop-up B B Draw Size / Z Intensity / RGB Intensity / Focal Shift S / U / I / O Same QuickMenu Space Space (right-click navigates) LazyMouse L L Pick colour / switch colour C / V Same Symmetry X X Undo / redo Ctrl+Z / Ctrl+Shift+Z Same (also Ctrl+Y) Divide / higher / lower res Ctrl+D / D / Shift+D Same Mask all / clear / invert / view Ctrl+A / Ctrl+Shift+A / Ctrl+I / Ctrl+H Same Group masked Ctrl+W Ctrl+W PolyFrame Shift+F Shift+F Draw / Move / Scale / Rotate Q / W / E / R Same keys, Gizmo 3D LightBox , , Hide the palettes Tab Tab QuickSave 9 9 Store Config / Load UI / Save UI Ctrl+Shift+I / Ctrl+L / Ctrl+Shift+Alt+I Same Perspective P Always on (P is Paint) Search every command F3 Every shortcut is in Keyboard and mouse, generated from the app itself, and can be changed with Ctrl+Alt+click or Preferences > Hotkeys."},{"p":"coming-from-zbrush.html","c":"Coming from ZBrush","a":"see-also","h":"See also","t":"Keyboard and mouse Glossary: ZBrush terms and their SculptForge names Exporting, Unreal and ZBrush: GoZ"},{"p":"installing.html","c":"Installing SculptForge","a":"","h":"Installing SculptForge","t":"This chapter covers what SculptForge needs, which package to download for your system, what to expect the first time you open it, and how to build it from source."},{"p":"installing.html","c":"Installing SculptForge","a":"system-requirements","h":"System requirements","t":"Operating system: Windows 10 or 11 (x64), macOS 11 or later (Apple Silicon or Intel), or a 64-bit Linux distribution (x86_64 or ARM64) with X11 or Wayland. Graphics: a GPU and driver that support OpenGL 3.3 (core profile). Any graphics card from the last ten years qualifies, including integrated Intel, AMD and Apple GPUs. SculptForge asks for 4x multisampling and falls back to none if the driver refuses it. Input: a three-button mouse works for everything. A pen tablet adds pressure (see Sculpting and brushes). Network: not needed for sculpting. The free AI features (Brush Lab and image or text to 3D) and the community brush gallery need an internet connection unless you run models on your own machine. Note: SculptForge is a 64-bit desktop application. There is no web, iPad or Android version."},{"p":"installing.html","c":"Installing SculptForge","a":"download","h":"Download","t":"Each link below downloads the newest version. Pick the one for your system: System Download How to install Windows 10/11 (x64) Installer (.exe) Run the installer (adds a Start menu shortcut) Windows, portable Portable .zip Unzip anywhere and run bin\\sculptforge.exe macOS 11+ (Apple Silicon and Intel) SculptForge.dmg Open the disk image and drag SculptForge to Applications Ubuntu, Debian, Mint, Pop!_OS .deb for x86_64 or ARM64 sudo apt install ./sculptforge_amd64.deb Fedora, RHEL, Rocky, Alma 8+ .rpm for x86_64 or ARM64 sudo dnf install ./sculptforge.x86_64.rpm Any Linux AppImage for x86_64 or ARM64 chmod +x the file, then run it Arch Linux packaging/arch/PKGBUILD in the source makepkg -si in that folder (an AUR package is planned) Studio pipelines SculptForge--...-vfx2026.tar.gz or ...-vfx2027.tar.gz See SculptForge for studios Most PCs are x86_64; ARM64 is for ARM laptops, Raspberry Pi and Apple Silicon Macs running Linux. Older versions are on the releases page."},{"p":"installing.html","c":"Installing SculptForge","a":"install-with-one-command","h":"Install with one command","t":"Instead of downloading by hand you can install (or update) with one command. On macOS and Linux it installs for your user only, with no administrator password: curl -fsSL https://raw.githubusercontent.com/islandmed/SculptForge/main/install/install.sh | sh On Windows, in PowerShell (it downloads and starts the installer): irm https://raw.githubusercontent.com/islandmed/SculptForge/main/install/install.ps1 | iex Both check the download against the release's checksums before installing. To uninstall on macOS or Linux, run the first command with sh -s -- --uninstall at the end instead of sh. Every release also has a SHA256SUMS.txt file with the checksum of each download, so you can confirm a file arrived intact. Each package contains two programs: SculptForge, the desktop application, and sculptforge-cli, the headless command-line tool for scripts, build farms and AI agents (see Scripting and automation). On macOS the command-line tool sits inside the app bundle, at SculptForge.app/Contents/MacOS/sculptforge-cli."},{"p":"installing.html","c":"Installing SculptForge","a":"opening-sculptforge-for-the-first-time","h":"Opening SculptForge for the first time","t":"The builds are not code-signed yet, so your operating system may warn you the first time."},{"p":"installing.html","c":"Installing SculptForge","a":"macos-gatekeeper","h":"macOS: Gatekeeper","t":"macOS may say that SculptForge \"cannot be opened because the developer cannot be verified\". In Finder, open the Applications folder. Right-click (or Ctrl+click) SculptForge and choose Open. Click Open in the dialog that appears. You only need to do this once. On recent macOS versions you may instead have to go to System Settings > Privacy & Security and click Open Anyway next to the message about SculptForge."},{"p":"installing.html","c":"Installing SculptForge","a":"windows-smartscreen","h":"Windows: SmartScreen","t":"Windows may show \"Windows protected your PC\". Click More info. Click Run anyway."},{"p":"installing.html","c":"Installing SculptForge","a":"linux","h":"Linux","t":"The .deb and .rpm packages add SculptForge to your desktop's application menu. An AppImage needs to be made executable first (chmod +x SculptForge-*.AppImage, or tick \"Allow executing file as program\" in your file manager's properties)."},{"p":"installing.html","c":"Installing SculptForge","a":"what-you-see-at-start-up","h":"What you see at start-up","t":"SculptForge opens a 1600 x 960 window with a sphere ready to sculpt and the LightBox open along the top of the canvas on its Project tab, so you can reopen recent work with a double-click. Press , (comma) to close it, or turn off Preferences > LightBox > Show at startup. The first start also creates your library folder (Documents/SculptForge, with Projects, Tools, Brushes, Alphas, Images, Splats and QuickSave sub-folders), which the LightBox shows as User. You can open a file directly from the command line, too: sculptforge model.obj (or a .glb, .sfproj, splat capture or image). sculptforge --fullscreen starts filling the screen; sculptforge --help lists every option. The next chapter, The interface, explains what everything on screen does."},{"p":"installing.html","c":"Installing SculptForge","a":"updating-and-uninstalling","h":"Updating and uninstalling","t":"SculptForge doesn't install updates by itself, but it tells you when there is one. Once a day at start-up it downloads a small file from its website that names the newest version; if yours is older, a banner at the top of the 3D view says what's new, with What's new, Download, Later and Skip this version. Nothing about you or your computer is sent. Help > Check for updates asks right away, and Preferences > Updates turns the daily check off. Builds from a package manager (such as the AUR package) leave updates to the package manager and don't check. To update, download the new release and install it over the old one. Your settings, brushes and library are kept: they live in your user folders, not next to the program (see Troubleshooting and FAQ for where). To uninstall, use your system's usual method (Settings > Apps on Windows, dragging the app to the Bin on macOS, sudo apt remove sculptforge or sudo dnf remove sculptforge on Linux, or delete the AppImage). Delete the settings and library folders as well if you want to remove everything."},{"p":"installing.html","c":"Installing SculptForge","a":"building-from-source","h":"Building from source","t":"You need CMake 3.24 or later and a C++20 compiler: GCC 11+, Clang 14+, Xcode 15+ or Visual Studio 2022. Dear ImGui, GLM and (if it isn't installed already) SDL3 are downloaded automatically. AI features use libcurl on Linux and macOS and the built-in WinHTTP on Windows. git clone https://github.com/islandmed/SculptForge.git cd SculptForge # Linux only: compilers and X11/Wayland/GL/curl headers (Debian/Ubuntu or Fedora/RHEL) sudo ./packaging/linux/install-build-deps.sh cmake -S . -B build -DCMAKE_BUILD_TYPE=Release cmake --build build --parallel ctest --test-dir build --output-on-failure ./build/sculptforge On Windows the program is build\\Release\\sculptforge.exe; on macOS run open build/SculptForge.app. Useful CMake options: Option Default What it does SCULPTFORGE_BUILD_APP ON Build the desktop application (turn off for a headless build of sculptforge-cli only) SCULPTFORGE_BUILD_PYTHON OFF Build the Python module (import sculptforge); needs Python development headers SCULPTFORGE_BUILD_TESTS ON Build the unit and UI tests SCULPTFORGE_USE_SYSTEM_SDL ON Use an installed SDL3 if one is found Running cpack in the build folder makes the platform's packages (.deb, .rpm and .tar.gz on Linux, a .dmg on macOS, an installer and a .zip on Windows)."},{"p":"installing.html","c":"Installing SculptForge","a":"see-also","h":"See also","t":"The interface Troubleshooting and FAQ SculptForge for studios"},{"p":"interface.html","c":"The interface","a":"","h":"The interface","t":"SculptForge's window is laid out like ZBrush's: a canvas in the middle, shelves of the most-used controls around it, a bar of alphabetical palettes that hold every function, and trays at the sides where palettes can stay open. This chapter walks through each region, the pop-up pickers, the LightBox, the built-in help, and how to rearrange the interface and keep your changes. The SculptForge window with its main regions labelled"},{"p":"interface.html","c":"The interface","a":"the-regions-at-a-glance","h":"The regions at a glance","t":"Region Where What it holds Title strip Top edge Document name, scene statistics, status messages, QuickSave, layout presets, Menus, Search Palette bar Under the title strip The 16 palettes, which hold every function Top shelf Above the canvas LightBox, Sculpt/Paint, Zadd/Zsub, Rgb, Draw Size, Z Intensity, symmetry, pressure Left shelf Left of the canvas Brush, Stroke, Alpha and Material tiles, the colour picker Canvas Centre The 3D view; strokes and navigation start only here Right shelf Right of the canvas Frame, Move, Zoom and Rotate, display toggles, Solo Bottom shelf Below the canvas Your quick brushes Trays Far left and far right Palettes you keep open; the right tray holds the Tool palette by default Press Tab to hide the shelves and trays for a bigger canvas, and again to bring them back. The palette bar stays, so every function is still one click away."},{"p":"interface.html","c":"The interface","a":"the-title-strip","h":"The title strip","t":"From left to right: SculptForge and the document name (\"Untitled\" until you save). A * after the name means there are unsaved changes; click the name to save (Ctrl+S). Scene statistics: vertices and triangles across all SubTools, the active SubTool and its position (\"SubTool Body (2/5)\"), the active sculpt layer (\"Layer Base\" when you sculpt the base mesh), the number of Gaussian splats when a capture is loaded, and the frame rate. The status message: the result of the last command or action. Errors show in red for a few seconds. Point at a long message to read all of it. QuickSave: saves a timestamped copy of the whole scene to your library without touching your project file (see Projects, autosave and QuickSave). 1, 2, 3: the layout presets (see Layout presets). Menus: shows or hides the palette bar. Search (F3): opens the command palette. Minimize and Close at the far right. Close asks to save changes first, as Ctrl+Q does."},{"p":"interface.html","c":"The interface","a":"palettes","h":"Palettes","t":"Every function in SculptForge lives in one of 16 palettes. Click a palette's name in the palette bar and it drops down under the name. Click another name to switch, or press Esc or click outside to close it. The Stroke palette open as a drop-down from the palette bar The palette bar lists File and Edit first and Help last, where other desktop applications put them, and the rest in alphabetical order. If you prefer ZBrush's strict A to Z order, turn on Preferences > Interface > Palettes strictly A-Z (ZBrush order). Palette What's in it File New Sphere, New Plane, Open, Open Recent, Save, Save As, autosave interval, Import and every export (OBJ, GLB, LOD chain, USD/USDZ, FBX for Unreal, Send to Unreal, splats), ZBrush (GoZ), Quit Edit Undo and Redo (with the name of the step), Paste brush Alpha The brush alphas: Round, Square, Noise, images from your library, Load image, Invert loaded image Brush AI Brush (Brush Lab), Community brushes, Paste brush, your custom brushes, Front faces only, Invert (Alt), the recipe editor for a custom brush, and every brush as a thumbnail grid with a filter Color The Paint brush, RGB while sculpting, the paint colour and swatches, Fill, Fill masked, Cavity, Clear, Show polypaint Draw Draw Size, Z Intensity, RGB Intensity, Focal Shift, Sculpt/Paint, Zadd/Zsub, Rgb, Front, and the tablet options (Pressure > strength, Pressure > size) with a pen readout Generate Generate 3D (image or text to 3D), Relief, Inflate and Stamp from an image, and the AI brush provider settings Material The seven MatCap materials (Sculpt, the default, first) and Studio, Base colour Preferences Config, Interface, Input, Hotkeys, LightBox, Tablet, Performance, Updates and Autosave sub-palettes (see Customizing the interface) Render Wireframe, Show Mesh, Show Polypaint, Show Mask, Show Polygroups, Show Splats, Frame, Fullscreen Script Console, Run script file, Copy session as script, Clear console Splats Gaussian splat tools: show, flip, turn, fit, clean floaters, Make sculptable, sculpt to splats, save, clear Stroke The stroke types (Dots, DragRect, Spray, LazyMouse) and their settings Tool The active SubTool with Open, Save and Import, and the SubTool, Layers, Paint Layers, Geometry, Remesh, Masking, Polygroups, Visibility, Export and Display sub-palettes Transform Draw, Move, Scale and Rotate (the Gizmo 3D with its pivot, axes, options and numeric entry), Symmetry X, Y and Z, Frame, Solo, PolyF Help Controls, User Guide, What's New, Command palette, Website & documentation, Report a problem, About SculptForge"},{"p":"interface.html","c":"The interface","a":"sub-palettes","h":"Sub-palettes","t":"Large palettes are divided into sub-palettes: headers you click to open or close. The Tool palette is the main example (SubTool, Layers, Geometry and so on). By default opening one sub-palette closes the others in the same palette, which keeps the palette short. Shift+click a header to open it without closing the others, or turn off Preferences > Interface > One sub-palette open. ZBrush: as in ZBrush, SubTool, Layers, Masking, Polygroups and Visibility are sub-palettes of the Tool palette rather than palettes of their own. SculptForge's Remesh sub-palette is where DynaMesh would be."},{"p":"interface.html","c":"The interface","a":"trays","h":"Trays","t":"The trays are columns at the far left and far right of the window where palettes stay open while you work. The right tray is open by default and holds the Tool palette; the left tray starts closed and empty. Put a palette in a tray: open it from the palette bar and click the tray icon at the left of its header. It goes into the right tray; Shift+click the icon to put it in the left tray. You can also drag the icon onto a tray. Take it out again: click the tray icon in its header inside the tray. The palette returns to the bar. Collapse it in place: click its title (or the arrow at the right of the header). Find it: a palette that is in a tray shows its name in orange in the palette bar. Clicking the name scrolls the tray to the palette and flashes its header. Open or close a tray: click its divider, the thin strip with a grip between the tray and the shelves. Drag the divider to make the tray wider or narrower (240 to 480 pixels). The Stroke palette kept in the right tray above the Tool palette When a tray holds several palettes, Preferences > Interface > Auto collapse left tray (on by default) and Auto collapse right tray (off by default) collapse the other palettes when the one you open would not fit. When you open a Gaussian splat capture, the Splats palette moves into the right tray by itself. Note: on a window narrower than 1280 pixels (at 100% UI scale) the right tray folds away and palettes open as drop-downs only. The left-shelf tiles get smaller and the bottom shelf scrolls sideways with the mouse wheel."},{"p":"interface.html","c":"The interface","a":"the-shelves","h":"The shelves","t":"Shelves surround the canvas and hold the controls you use all the time. Point at anything with Ctrl held to see what it does. Right-click an item for Remove from shelf; see Customizing the interface to add items."},{"p":"interface.html","c":"The interface","a":"top-shelf","h":"Top shelf","t":"First row: LightBox (,): shows or hides the LightBox. Sculpt / Paint (P): brushes change the shape, or paint colour without sculpting. Zadd / Zsub: brushes add to or subtract from the surface. Holding Alt flips it for one stroke. Rgb: sculpt brushes paint the colour at the same time. Draw Size: the brush radius in screen pixels (2 to 800). Z Intensity: how strongly each dab changes the surface (1 to 100). While Shift is held it shows Smooth's own value. Second row: AI Brush: opens Brush Lab (see Brush Lab and sharing brushes). Front: front faces only, so brushes leave the far side of thin parts alone. X, Y, Z: symmetry across each axis (X toggles X). Pressure > Strength and Pressure > Size: what pen pressure controls. ActiveTris / TotalTris at the right: the triangles you can see and sculpt (visible SubTools, hidden parts left out) and the total in the scene. Draw Size and Z Intensity are sliders with the label inside, as in ZBrush: drag along them, or Ctrl+click to type a value."},{"p":"interface.html","c":"The interface","a":"left-shelf","h":"Left shelf","t":"Four large tiles, each showing the current choice. Click one to open its pop-up picker: Brush: the active brush, with a rendered preview. Stroke: Dots, DragRect, Spray or LazyMouse. Alpha: the brush's stamp shape. Material: how the model is shaded in the view. Under them is the colour picker for polypaint (a saturation/value square and a hue strip), two swatches (the main and second colour; click either to swap them, like ZBrush's Alternate) and Fill, which fills the unmasked area with the main colour."},{"p":"interface.html","c":"The interface","a":"right-shelf","h":"Right shelf","t":"Frame (F): fits the model in the view. Move, Zoom, Rotate: drag on these buttons to pan, zoom and orbit the view, as in ZBrush. PolyF (Shift+F): shows the mesh's polygons: quads as quads, triangles as triangles. Groups: colours each polygroup. Mask: darkens masked areas (on by default). Paint: shows polypaint colours (on by default). Solo: shows only the active SubTool (available with two or more SubTools). Splats: shows or hides a Gaussian splat capture (only shown while one is loaded). Toggles that are on have an orange background. See Navigating the view for the camera."},{"p":"interface.html","c":"The interface","a":"bottom-shelf","h":"Bottom shelf","t":"A row of quick brushes: Standard, Clay, ClayBuildup, DamStandard, Move, Smooth, Inflate, Pinch, Flatten, Crease, Trim, SnakeHook, Layer, Nudge and Paint. The small digit in a tile's corner is its shortcut (1 to 9 and 0 select the first ten built-in brushes, P is Paint). The active brush has an orange outline. The bottom shelf of quick brushes Add a brush: click + at the end of the shelf and pick any brush, built-in or one of your own. Or right-click a brush in the brush picker and choose Add to bottom shelf. Custom brushes show a small sparkle in the corner. Remove a brush: right-click its tile and choose Remove from shelf."},{"p":"interface.html","c":"The interface","a":"pop-up-pickers","h":"Pop-up pickers","t":"Pickers are pop-up grids of thumbnails. They open beside the left-shelf tile you click, or under the mouse when you use a key. They close when you pick something, press Esc or click elsewhere. Pointing at a tile for a moment shows Quick Info: a large preview and a description."},{"p":"interface.html","c":"The interface","a":"brush-picker","h":"Brush picker","t":"Press B (or click the Brush tile). The picker shows a Recent row, then Built-in, Custom (your brushes and Brush Lab creations) and Library (.sfbrush files in your library that aren't loaded yet; picking one loads it). The brush picker after pressing B and typing S Choose a brush with the keyboard the ZBrush way: Press B. Type the first letter of the brush. Only the brushes starting with that letter stay, and each shows an orange letter: the next key that tells it apart. Press that orange letter to pick the brush. For example B S T picks Standard. Backspace takes back a letter and Enter picks the first match. If no name starts with what you typed, the picker falls back to names that contain it. The letter chips along the top (with a count for each letter) filter by a click as well. Right-click a brush for Add to bottom shelf and, for custom brushes, Copy brush code, Rename..., Save as .sfbrush..., Delete... and Reveal in folder (see Brush Lab and sharing brushes)."},{"p":"interface.html","c":"The interface","a":"stroke-alpha-and-material-pickers","h":"Stroke, Alpha and Material pickers","t":"Stroke (click the Stroke tile): Dots, DragRect, Spray and LazyMouse, with Scatter for Spray and Lazy radius for LazyMouse. See Sculpting and brushes. Alpha (click the Alpha tile): Round, Square and Noise, the image alpha you loaded, images in your library's Alphas folder, Load image... and Invert loaded image. Material (M, or click the Material tile): the MatCaps and Studio. Point at a material to preview it on the model; click to keep it. Closing the picker without clicking puts the old material back. See Polypaint and materials."},{"p":"interface.html","c":"The interface","a":"sliders-at-the-cursor-and-the-quickmenu","h":"Sliders at the cursor and the QuickMenu","t":"As in ZBrush, press S for a Draw Size slider under the mouse, U for Z Intensity, I for RGB Intensity or O for Focal Shift. Drag the slider, or type a number and press Enter (Esc cancels). The pop-up closes when you release the slider. [ and ] make the brush 10% smaller or larger at any time. Space opens the QuickMenu with all of them and the brush, stroke, alpha and material (see The QuickMenu)."},{"p":"interface.html","c":"The interface","a":"the-lightbox","h":"The LightBox","t":"The LightBox is a strip of thumbnails across the top of the canvas for browsing everything you can load. Press , (comma) or click LightBox on the top shelf to show or hide it. It opens on its own at start-up (see Preferences). The LightBox on the Tool tab Tab Shows Double-click Project Projects (.sfproj) in your library and recently opened projects Open the project Tool Sphere, Plane and Cube, and model files in your library Open (replaces the scene) Brush Every brush: built-in, custom and .sfbrush files Select or load the brush Alpha Round, Square, Noise and images in your Alphas folder Use as the brush alpha Material The MatCaps and Studio Use the material Image Reference images in your library A menu: Generate 3D, relief, inflate, project onto the model, use as alpha Splats Gaussian splat captures (.ply, .splat) Open the capture as a reference QuickSave The autosave and your QuickSaves, newest first Open it Recent Recently opened files of every kind Open it Working with the strip: Shift+double-click a model, project or primitive to append it to the scene as a new SubTool instead of replacing the scene. Drag sideways (or use the mouse wheel) to scroll through the strip. A drag of more than a few pixels scrubs, so a plain click still selects. Drag a tile down out of the LightBox onto the canvas to load it, like a double-click. Folders open with a double-click; the first tile inside a folder goes back up. The arrows at the top go back and forward through tabs and folders, and the breadcrumb shows where you are. Type in Filter to show only items whose names contain the text. Choose 1 to 4 rows of thumbnails. Open folder... adds a folder of your own to the root of every tab. On the QuickSave tab, Save now makes a QuickSave. Right-click a tile for Open, Append as SubTool, the image actions, Show in file manager and Refresh thumbnail. At the root of the Tool and Image tabs is a Built-in folder (the models and images that ship with SculptForge, such as the demo lion head), and the Project, Tool, Brush, Alpha, Image and Splats tabs have a User folder, your library folder (Documents/SculptForge by default). To use a different library folder, choose it in Preferences > LightBox > Library folder. ZBrush: the LightBox works like ZBrush's: comma toggles it, double-click loads, and Built-in and User folders play the part of ZBrush's Maxon and User folders."},{"p":"interface.html","c":"The interface","a":"ctrl-hover-help","h":"Ctrl-hover help","t":"Hold Ctrl and point at any button, slider, tile or shelf item. A box shows the item's name, its shortcut as keycaps, what it does, where it lives (for example \"Tool > Geometry\") and the script command it runs. Ctrl-hover help on the Subdivide button Hold Ctrl+Alt instead to see the scripting reference for items that run a command: the command's usage line and each parameter with its type and description. This is the same information the console, sculptforge-cli and AI agents use. Without Ctrl, icon-only buttons and labels that don't fit show their name after a short delay (Preferences > Interface > Tooltip delay). Turn Ctrl-hover help off with Preferences > Interface > Popup Info (Ctrl+hover help), and make the box more or less see-through with Popup Info opacity."},{"p":"interface.html","c":"The interface","a":"the-controls-sheet","h":"The Controls sheet","t":"Press F1 (or Help > Controls) for the Controls window. The Keyboard tab lists every action that has a shortcut, grouped by palette and generated from the actions themselves, so it always shows your current keys. The Mouse & pen tab lists the gestures. Type in the filter field to search both. Double-click a row on the Keyboard tab to give that action a new key."},{"p":"interface.html","c":"The interface","a":"this-guide","h":"This guide","t":"Help > User Guide (Shift+F1) opens this guide in its own window: the contents on the left (the open chapter lists its sections), the chapter on the right, and links between chapters. The User Guide window on the Masking chapter Search: type in the search box (Ctrl+F) to find every section that mentions all of your words. Click a result to jump there; the words are marked on the page. Esc clears it. Back and forward: the arrow buttons, Alt+Left / Alt+Right, or the back and forward buttons of your mouse. From any control: while Ctrl-hover help is showing, press F1 (keep Ctrl held) to open the chapter about that control. The help box shows which chapter it is (\"Learn more: ...\"). Code blocks have a Copy button, and Open in browser shows the same page on the SculptForge website. The guide is built into SculptForge, so it works offline and always matches your version."},{"p":"interface.html","c":"The interface","a":"the-command-palette","h":"The command palette","t":"Press F3 (or Ctrl+Shift+P, or click Search in the title strip) to find any action or command by name and run it. It opens at the top centre of the canvas. The command palette searching for subdivide Type part of a name, a palette or a word from the description. The search is forgiving: letters in order are enough (\"sbdv\" finds Subdivide), and every word you type must match somewhere. Each row shows the action, its palette and its shortcut. Up and Down (or Page Up and Page Down) choose a row, Enter runs it and Esc closes the palette. With nothing typed, the palette lists the actions you used most recently. Commands with a required parameter (for example image_relief path=) open in the console with the name already typed. Other commands run with their default values; Shift+Enter sends a command with parameters to the console instead, so you can set them first. Everything scriptable is in the command palette, including commands that have no button in the interface."},{"p":"interface.html","c":"The interface","a":"the-console","h":"The console","t":"Press ` (the backtick key, left of 1 on US keyboards) to open the console, a strip between the canvas and the bottom shelf. It works like ZBrush's ZScript window: Every command you run, from a button, a key, the command palette, a script or an AI agent, appears as a script line followed by its result. Errors show in red. Type a command and press Enter: for example remesh resolution=200 or subdivide; decimate ratio=0.5. Tab completes command and parameter names, Up and Down recall earlier lines, and help (or help remesh) explains commands. Drag the console's top edge to make it taller or shorter. The Script palette has Run script file..., Copy session as script (every command you ran this session, ready to replay, which makes it a macro recorder) and Clear console. The console after a few commands See Scripting and automation for the command language, scripts and headless use."},{"p":"interface.html","c":"The interface","a":"customizing-the-interface","h":"Customizing the interface","t":"Everything about the layout can change: which palettes sit in the trays, what's on each shelf, and which keys do what. As in ZBrush, changes last until you quit unless you store them with Store Config."},{"p":"interface.html","c":"The interface","a":"move-add-and-remove-shelf-items","h":"Move, add and remove shelf items","t":"Open Preferences > Config and turn on Enable Customize. The shelves get a dashed orange outline and the status line reads \"Customize: Ctrl+Alt+drag to move or remove items\". Hold Ctrl+Alt and drag any button, slider or tile: onto a shelf to put it there (an orange line shows where it will go), which is how you add buttons from palettes to a shelf; along its shelf, or to another shelf, to move it; off the shelves (onto the canvas, for example) to remove it. Turn Enable Customize off when you're done, and press Ctrl+Shift+I to keep the result. Right-clicking a shelf item and choosing Remove from shelf works without Customize mode."},{"p":"interface.html","c":"The interface","a":"assign-shortcuts","h":"Assign shortcuts","t":"Hold Ctrl+Alt and click any button (with Customize off), then press the key you want. Esc cancels and Backspace removes the button's shortcut. Or open Preferences > Hotkeys, find the action (there's a filter), click its key button and press the new key. Keys you changed show in orange. Default shortcuts undoes every change. Or double-click a row in the Controls window (F1). If the key already belongs to another action, it moves to the new one (as in ZBrush) and the status line says which action lost it."},{"p":"interface.html","c":"The interface","a":"store-config-and-friends","h":"Store Config and friends","t":"All in Preferences > Config: Item What it does Store Config (Ctrl+Shift+I) Keeps the current layout, shortcuts and interface preferences for future sessions Restore Custom UI Goes back to what the last Store Config saved Restore Standard UI Goes back to the built-in layout and default shortcuts (Store Config afterwards to make it stick) Save UI... Saves the layout, shortcuts and preferences to a .json file you can share Load UI... (Ctrl+L) Loads such a file (Store Config afterwards to keep it) The first time you change the layout in a session, the status line reminds you once: \"Layout changed - Ctrl+Shift+I to keep it\". What a session changes by itself (the console and LightBox being open, the LightBox tab) doesn't count as a layout change. ZBrush: Store Config has the same shortcut as in ZBrush, and SculptForge never saves the layout on its own either."},{"p":"interface.html","c":"The interface","a":"layout-presets","h":"Layout presets","t":"The 1, 2 and 3 buttons in the title strip (also in Preferences > Config) switch between three layouts: Standard: the Tool palette in the right tray and shelves around the canvas. Sculpt: both trays closed, for the largest canvas. Wide: Brush, Stroke and Alpha in the left tray, Tool and Material in the right tray. A preset changes the layout only (the console, LightBox and left-handed setting stay as they are). Store Config keeps it."},{"p":"interface.html","c":"The interface","a":"interface-preferences","h":"Interface preferences","t":"Preferences > Interface: Setting Default What it does Popup Info (Ctrl+hover help) On Ctrl-hover help boxes Popup Info opacity 0.97 How solid the help box is Tooltip delay 0.5 s How long to point at an icon-only button before its name appears One sub-palette open On Opening a sub-palette closes the others in that palette Auto collapse left tray / right tray On / Off Collapse other palettes in the tray when one wouldn't fit Palettes strictly A-Z (ZBrush order) Off Strict alphabetical palette bar instead of File and Edit first, Help last Left-handed layout Off Mirrors the shelves and trays: tools on the right, navigation on the left UI scale Automatic Size of text and controls (100% to 200%); takes effect at the next start Camera notch Automatic Keeps the interface below a laptop's camera notch in fullscreen (see below) Preferences > Input sets the key Style: ZBrush (the default) or SculptForge, which brings back the keys of SculptForge 0.6 and earlier: 1 to 9 and 0 pick the first ten brushes (9 is QuickSave in the ZBrush style), I opens Z Intensity like U, and Ctrl+drag on the background zooms when nothing is masked. Rotation chooses free rotation (ZBrush) or a turntable. See Coming from ZBrush. Preferences > LightBox has Show at startup (on by default), the number of Rows, Placement (along the top of the canvas, or at the bottom above the bottom shelf) and the Library folder. Preferences > Autosave sets how often a recovery copy is saved (see Projects, autosave and QuickSave). The Preferences palette with the Config and Interface sub-palettes"},{"p":"interface.html","c":"The interface","a":"fullscreen-the-palette-bar-and-the-camera-notch","h":"Fullscreen, the palette bar and the camera notch","t":"F11 (or Render > Fullscreen) fills the screen with SculptForge; press it again to go back to a window. sculptforge --fullscreen starts that way. Menus in the title strip hides the palette bar; click it again to bring it back. Tab hides the shelves and trays. On MacBooks with a camera notch, SculptForge keeps the interface below the notch when it fills the screen and fills the band beside the notch with the shell colour. Automatic asks macOS for the safe area (on Linux it recognises a notched MacBook display); Always reserve always keeps a band free at the top, whatever the display; Off uses the full height."},{"p":"interface.html","c":"The interface","a":"see-also","h":"See also","t":"Navigating the view Keyboard and mouse Scripting and automation Troubleshooting and FAQ"},{"p":"navigation.html","c":"Navigating the view","a":"","h":"Navigating the view","t":"This chapter explains how to rotate, pan and zoom the camera with a mouse, a pen or the right-shelf buttons, how to frame the model, and which display toggles help while you sculpt."},{"p":"navigation.html","c":"Navigating the view","a":"how-the-camera-works","h":"How the camera works","t":"The camera orbits around a target point. By default rotation is free, as in ZBrush: dragging turns the model about the screen's own axes, so it follows the cursor and can roll right over the top. Hold Shift while rotating to snap to the nearest front, back, side, top or bottom view; let go of Shift and the drag carries on from where the cursor is. If you prefer the model to stay upright, as in Blender or Maya, set Preferences > Interface > Rotation to Turntable: sideways drags then turn the model around its vertical axis and up-down drags tilt it, stopping just short of looking straight down or up. Panning moves the target; zooming moves the camera closer to it or further away. The view is a perspective view with a 35 degree field of view. Navigation starts only on the canvas. A drag that begins on a shelf, a tray or a palette never moves the camera. ZBrush: the gestures are ZBrush's. Dragging on the background (or right-dragging) rotates, with Shift to snap; Alt+drag pans, and letting go of Alt while still dragging zooms; Ctrl+right-drag zooms and Alt+right-drag pans, as with ZBrush's right-click navigation. As in ZBrush, dragging up (forward) zooms out and dragging down zooms in, and when you rotate or pan the model follows the cursor. The right-shelf Move, Zoom and Rotate buttons work as in ZBrush."},{"p":"navigation.html","c":"Navigating the view","a":"mouse-and-pen","h":"Mouse and pen","t":"To Do this Rotate Left-drag on the background, or right-drag anywhere on the canvas; add Shift to snap to an axis view Roll (turn about the view axis) Shift+click the background, let go of Shift, then drag (ZBrush) Pan Alt+left-drag on the background, Alt+right-drag, or middle-drag Zoom Mouse wheel; Alt+left-drag on the background, then let go of Alt and keep dragging; Ctrl+right-drag; Ctrl+middle-drag; with the SculptForge input style also Ctrl+left-drag on the background Frame the model F, or Frame on the right shelf Zoom drags go the ZBrush way: drag up to zoom out, down to zoom in. The SculptForge input style (Preferences > Input) reverses them: drag up to come closer. | Frame one SubTool | Shift+Alt+click it (it becomes the active SubTool) | \"Background\" means any part of the canvas where the cursor isn't over the model. A left-drag that starts on the model sculpts instead, so with a pen or a one-button mouse, start rotations beside the model. When the model fills the view, zoom out a little or use the right-shelf buttons. Note: Ctrl+left-drag on the background clears the mask when something is masked (and Ctrl+click there inverts it); with the SculptForge input style it zooms while nothing is masked. Use the wheel or Ctrl+middle-drag to zoom on a masked model. See Masking. On macOS, Cmd works wherever this guide says Ctrl for these gestures, except Ctrl+middle-drag, which needs Ctrl itself."},{"p":"navigation.html","c":"Navigating the view","a":"the-right-shelf-navigation-buttons","h":"The right-shelf navigation buttons","t":"The right shelf has three buttons you drag on rather than click, as in ZBrush. They are handy with a pen, on a laptop trackpad, or when the model fills the canvas and there is no background to drag on. The right shelf: Frame, Move, Zoom and Rotate, then the display toggles Button Drag on it to Frame (click) Fit the whole scene in the view (F) Move Pan the view Zoom Zoom: drag up to come closer, down to move away Rotate Orbit the view The button stays orange while you drag. Frame is also in the Render and Transform palettes."},{"p":"navigation.html","c":"Navigating the view","a":"framing","h":"Framing","t":"Frame (F) points the camera at the centre of the scene and moves it back until everything fits: every visible SubTool, plus the Gaussian splats when they are shown. SculptForge frames the scene for you when you open a file or start from a new primitive. Use it after panning far away, or when a model comes in at an unusual scale."},{"p":"navigation.html","c":"Navigating the view","a":"display-toggles-that-help-navigation","h":"Display toggles that help navigation","t":"These live on the right shelf and in the Render palette: PolyF (Shift+F): shows the polygons of the active SubTool over the surface, ZBrush's PolyFrame. Quads show as quads (see Quads and triangles). Useful for judging mesh density before you subdivide or remesh. Groups: colours each polygroup. Mask: darkens masked areas. Paint: shows polypaint colours (off shows the plain material). Solo: shows only the active SubTool, to get at parts hidden behind others. Show Mesh (Render palette): hides the sculpt, for example to look at a splat capture on its own. Fullscreen (F11) and hiding the shelves (Tab) give the canvas the most room. See The interface."},{"p":"navigation.html","c":"Navigating the view","a":"not-yet","h":"Not yet","t":"Not yet: SculptForge has no orthographic view, no rotation around the point under the cursor (the camera always orbits its target, which Frame sets to the scene centre), no floor grid and no saved camera views. Pan the target onto the area you're working on to orbit around it."},{"p":"navigation.html","c":"Navigating the view","a":"see-also","h":"See also","t":"The interface Keyboard and mouse Sculpting and brushes"},{"p":"sculpting.html","c":"Sculpting and brushes","a":"","h":"Sculpting and brushes","t":"This chapter covers everything that happens when you drag a brush across a model: the built-in brushes and the custom brushes that ship with SculptForge, brush size and strength, modifier keys, stroke types, alphas, symmetry and pen pressure. To design your own brushes, see Brush Lab and sharing brushes. Sculpting the lion head with X symmetry"},{"p":"sculpting.html","c":"Sculpting and brushes","a":"your-first-stroke","h":"Your first stroke","t":"Pick a brush: click it on the bottom shelf, press its number key, or press B to open the brush picker. Left-drag on the model. The brush works on the surface under the cursor. Hold Alt while dragging to invert the brush (dig in instead of building up), or hold Shift to smooth. Press Ctrl+Z to undo a stroke, Ctrl+Shift+Z (or Ctrl+Y) to redo it. Each SubTool keeps its own history of up to about 1 GB; the oldest steps are dropped beyond that. Dragging on the background never sculpts: it rotates the view (see Navigation). The brush only works on the active SubTool, and only on parts that are visible and not masked. ZBrush: the modifiers are the ones you know. Alt flips Zadd and Zsub for one stroke, Shift smooths with any brush, Ctrl paints a mask (see Masking)."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"built-in-brushes","h":"Built-in brushes","t":"SculptForge has fourteen sculpting brushes plus the Paint brush. The first ten have number keys; all of them are on the bottom shelf by default and in the brush picker. Brush Key What it does With Alt Standard 1 Raises the surface along the stroke, the all-purpose brush. Digs in Clay 2 Builds up clay that fills the hollows first, with a slightly flat top. Carves away Smooth 3 Relaxes the surface, evening out bumps. The same brush Shift gives you. No change Move 4 Grabs the surface under the cursor and pulls it along, parallel to the screen. No change Inflate 5 Swells the surface outward along its normals. Deflates Crease 6 Cuts a sharp crease and pinches its sides in. Raises a ridge Flatten 7 Presses the surface toward a plane through the brush area. Pushes away from the plane Pinch 8 Pulls the surface toward the stroke to tighten edges. Spreads it apart DamStandard 9 A narrow, deep V-shaped crease with the sides pinched in. A sharp ridge ClayBuildup 0 Square, flat-topped clay strokes for blocking in forms. Carves flat-bottomed SnakeHook Pulls the surface out into horns and tendrils that taper as you drag. No change Trim Trim Dynamic: shaves away everything above a plane for hard surfaces. Fills up to the plane Layer Raises the surface to one fixed height per stroke; overlapping passes never stack. Lowers to a fixed depth Nudge Slides the surface sideways along the stroke without lifting it. No change Paint P Paints colour without sculpting. See Polypaint and materials. Paints back to white Notes on particular brushes: Move and SnakeHook move the surface with the cursor instead of placing dabs, so stroke types (Dots, Spray and so on) don't apply to them. Layer sets its height from the brush size and Z Intensity. Pen pressure lowers the height when Pressure > Strength is on, so you can feather the edge of a layer. Trim gives crisp planes on cylinders and edges. Use it with Front on when you work on thin shapes. ZBrush: DamStandard, ClayBuildup, SnakeHook, Trim (Dynamic), Layer and Nudge behave like their ZBrush namesakes. Brushes such as hPolish, ClayTubes, Slash or the IMM and curve brushes are not built in; you can get close to several of them with a custom brush in Brush Lab."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"custom-brushes-that-ship-with-sculptforge","h":"Custom brushes that ship with SculptForge","t":"Besides the built-in brushes, SculptForge ships seven custom brushes. They are recipes: data that you can open and change in Brush Lab. They appear in the Custom section of the brush picker and in Brush > Custom brushes. Brush What it does Wrinkle Fine, sharp creases for skin folds and fabric wrinkles. Palette Knife Flattens and drags clay sideways like a sculptor's knife. Dragon Scales Stamps rounded overlapping scales along the stroke. Stone Chisel Scrapes hard planes and breaks them up with cracks for rocks and ruins. Skin Pores Sprinkles tiny pores for close-up skin detail. Clay Buildup Builds up flat-topped strokes of clay for blocking in forms. Edge Wear Chips and softens only the sharp edges and ridges, for weathered props. Custom brushes respond to Alt, Shift, the mask, symmetry and the stroke settings just like built-in ones. Their thumbnails carry a small sparkle when you put them on the bottom shelf."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"pick-a-brush","h":"Pick a brush","t":"You can choose a brush in several places: Bottom shelf: click a tile. The active brush has an orange outline and the number key is shown in the corner of each tile. Number keys: 1 to 9 and 0 pick the first ten built-in brushes (see the table above); P toggles the Paint brush. Brush tile at the top of the left shelf: click it to open the brush picker beside it. Brush palette: the same grid of thumbnails, with a filter field, plus your custom brush list. Command palette (F3): type the brush name and press Enter."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"the-brush-picker","h":"The brush picker","t":"Press B to open the brush picker under the mouse. It shows a Recent row (once you have picked brushes), then Built-in, Custom and Library sections. The Library section lists .sfbrush files in the Brushes folder of your LightBox library that aren't loaded yet; picking one loads it. The brush picker after pressing B, with letter badges The picker works the ZBrush way, by typing letters: Press B. Type the first letter of the brush. Only brushes starting with that letter stay, and each shows an orange key badge: the next letter that tells it apart from the others. Press the letter on the badge to pick that brush. For example B, S, T picks Standard, and with the brushes that ship, B, C, L picks Clay. If no brush name starts with what you typed, the picker falls back to names that contain it. Backspace removes the last letter, Enter picks the first match, and Esc or a click outside closes the picker. The letter chips along the top (A 2, C 4 ...) show how many brushes start with each letter; click one to filter by it. Hover a tile for a large preview and the brush's description. Right-click a tile for Add to bottom shelf, and on custom brushes also Copy brush code, Rename..., Save as .sfbrush..., Delete... and Reveal in folder (see Brush Lab and sharing brushes). ZBrush: B then two letters is the same muscle memory. Holding Ctrl while picking to choose a masking brush is not supported; mask strokes always use Ctrl with the current settings."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"draw-size-z-intensity-rgb-intensity-and-focal-shift","h":"Draw Size, Z Intensity, RGB Intensity and Focal Shift","t":"These values control every brush, with ZBrush's names and keys. Draw Size and Z Intensity are on the top shelf; all four are in the Draw palette and the QuickMenu. Setting Range Default How to change it Draw Size 2 to 800 60 Brush radius in screen pixels. [ and ] make it 10% smaller or larger (hold to repeat). S opens a slider at the cursor. Z Intensity 1 to 100 50 How strongly each dab changes the surface. U opens a slider at the cursor. RGB Intensity 1 to 100 100 How strongly painting colours the surface (the Paint brush, and sculpting with Rgb on). I opens a slider at the cursor. Focal Shift -100 to 100 0 The brush falloff. Below 0 the full-strength centre widens into a broad, hard tip; above 0 it narrows to a soft point. O opens a slider at the cursor. Because Draw Size is measured on screen, the brush covers less of the model as you zoom in, which is what you want for detail work. The brush cursor shows two rings, as in ZBrush: the outer one is the Draw Size, the inner one is Focal Shift (where the brush works at half strength). Masking, painting, Move and SnakeHook follow Focal Shift too; custom brushes made in Brush Lab keep their own tip shape. The S, U, I and O pop-ups take the mouse or the keyboard: drag the slider and release to close it, or type a number and press Enter (a minus first for a negative Focal Shift). Esc closes the pop-up without typing anything new."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"smooths-own-z-intensity","h":"Smooth's own Z Intensity","t":"Smooth keeps a Z Intensity of its own, as in ZBrush, so a gentle Standard stroke at 10 still smooths at full speed. Hold Shift (or pick the Smooth brush) and the Z Intensity slider shows Smooth Z Intensity: change it there, or hold Shift and press U. It starts at 50. The Draw palette"},{"p":"sculpting.html","c":"Sculpting and brushes","a":"sculpt-paint-zadd-zsub-rgb-and-front","h":"Sculpt, Paint, Zadd, Zsub, Rgb and Front","t":"These toggles sit on the top shelf and in the Draw palette: Control What it does Sculpt / Paint Sculpt makes brushes change the shape. Paint (P) paints colour only. Zadd / Zsub Zadd makes brushes add (the default), Zsub makes them subtract. Alt flips the current choice for one stroke. Rgb Sculpt brushes also paint the current colour as they sculpt (ZBrush Rgb with Zadd). Front Front faces only: brushes leave the far side of thin parts alone, such as the back of an ear or a cape. The Brush palette has the same Front and invert settings as the checkboxes Front faces only and Invert (Alt)."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"modifier-keys-while-sculpting","h":"Modifier keys while sculpting","t":"Hold Effect Alt Inverts the brush for this stroke (see the table of brushes). Shift (before the stroke) Smooths with the Smooth brush, whatever brush is active, at Smooth's own Z Intensity. With the Paint brush active, Shift still smooths the shape. Shift (after the stroke started) Draws a straight line from where you pressed Shift, snapped to 45 degree steps on screen. Let go of Shift to carry on freehand. Ctrl Paints a mask instead of sculpting; Ctrl+Alt erases it. A Ctrl+click without dragging blurs the mask (Ctrl+Alt+click sharpens it). See Masking. Ctrl+Shift Visibility gestures: isolate, hide and show polygroups. See Polygroups and visibility."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"the-quickmenu","h":"The QuickMenu","t":"Press Space for ZBrush's QuickMenu under the cursor: the Brush, Stroke, Alpha and Material tiles, Draw Size, Focal Shift, Z Intensity and RGB Intensity, Zadd / Zsub, Sculpt / Paint, Rgb and X symmetry. Hold Space and let go to close it again (it stays while the pointer is on it), or tap Space to keep it open until you click elsewhere or press Esc. Clicking a tile opens its picker."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"strokes","h":"Strokes","t":"The stroke type decides how cursor movement becomes brush dabs. Choose it from the Stroke tile on the left shelf, which opens the stroke picker, or from the Stroke palette. The stroke picker Stroke What it does Setting Dots Even dabs along the path: the classic brush stroke (default). None; spacing comes from the brush. DragRect Click and drag one stamp: the drag length sets its size and its direction the rotation. Great with alphas. None DragDot Click and drag one stamp of the brush's Draw Size: it slides over the surface under the cursor and lands where you let go. Great for VDMs. None Spray Scattered dabs of random size, strength and rotation, for organic texture. Scatter (0 to 2, default 1): how far dabs land from the cursor, as a fraction of the brush size. LazyMouse The brush trails the cursor on a string, for smooth, steady lines. Lazy radius (1 to 300 px, default 40): longer is steadier. The setting slider appears under the stroke tiles when Spray or LazyMouse is selected. With LazyMouse, the viewport draws the string between the cursor and the brush point. Notes: With DragRect, the stamp is placed where you first click. While you drag, it is redrawn at the new size and angle, and it is committed when you release. With DragDot, the stamp appears under the cursor at once and follows it while you drag; the mesh under it goes back to how it was as it moves on. Mask strokes (Ctrl) always use dots, even when DragRect or DragDot is selected. Custom brushes set their own dab spacing and can add jitter (see Brush Lab). ZBrush: DragRect, DragDot, Spray and LazyMouse match ZBrush's. Freehand and Dots are the same thing here. Roll and curve strokes are not available yet."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"alphas","h":"Alphas","t":"An alpha is a grayscale stamp that shapes the brush tip: white is full effect, black is none. It affects every brush, built-in or custom. Choose one from the Alpha tile on the left shelf (the alpha picker) or the Alpha palette, which also shows a large preview of the current alpha. The alpha picker Alpha What it does Round The plain round falloff (no alpha). The default. Square A square stamp with soft edges. Noise A noisy stamp for rough, organic texture. To use your own image: Click Load image... in the alpha picker or the Alpha palette. Choose a PNG, JPG, BMP, TGA, PSD or GIF. Colour images are converted to grayscale. Turn on Invert loaded image before loading if your image is white where it should have no effect. Images you keep in the Alphas folder of your LightBox library (Documents/SculptForge/Alphas by default) appear in the picker's Images section, so you can switch between them with one click. The alpha's top edge points up the screen; with DragRect it follows the drag direction instead. From a script: brush_set_alpha name=square, or brush_set_alpha path=bark.png invert=true. ZBrush: there is no alpha library browser with hundreds of alphas yet, and alpha options such as MidValue, Rf (radial fade) or tiling are not available. Any grayscale image works, including alphas you already have as PNG."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"vector-displacement-brushes","h":"Vector displacement brushes","t":"A vector displacement brush (ZBrush's VDM brushes, Blender's \"VDM brushes\") stamps a whole 3D shape in one click: a horn, an ear, a cluster of scales, a nostril. An alpha can only push the surface up or down; a vector displacement map (VDM) moves every point of the stamp in any direction, so the shape can lean over, curl and overhang, as nothing made with a height ever can. Horns, an ear curl, scales and two nostrils, one stamp each, and Brush > Vector Displacement"},{"p":"sculpting.html","c":"Sculpting and brushes","a":"stamp-a-vdm","h":"Stamp a VDM","t":"Open the Brush palette and its Vector Displacement section, and click a map: Horn, Ear Curl, Scales or Nostril. The VDM brush becomes the brush and the stroke becomes DragRect. (While the VDM brush is the brush, the Alpha tile on the left shelf shows its map, and the alpha picker lists the maps first. The VDM brush is also in the brush picker: B V D.) Click on the model where the stamp should sit and drag: the drag's length sets the size and its direction points the top of the map, so a horn leans the way you drag. Let go to keep it. DragDot stamps at the Draw Size instead and slides the stamp under the cursor until you let go. Z Intensity 50 (the default) presses the map at its own shape; 100 doubles it, lower values flatten it. Alt digs the shape in: the sideways motion stays and the height flips (a horn becomes a curved hole, a nostril a bump). Blender's VDM brushes invert the same way. Symmetry mirrors the stamp exactly (the mirrored horn leans the mirrored way), the mask holds it back, and each stamp is one undo step. Sculpt layers record it like any stroke. The Dots stroke works too: each dab adds the shape again, for rows of studs or scales. Tip: a VDM moves points sideways, so it needs points to move: on a coarse mesh the shape breaks up into spikes. Divide first (the model above has 330 000 triangles), and stamp at the highest subdivision level; stepping down and back up keeps the stamp. Use Front faces only on thin parts so the stamp doesn't reach through to the other side."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"make-your-own-vdm","h":"Make your own VDM","t":"In Brush > Vector Displacement, click New VDM Plane. A flat 2 x 2 grid appears as a new SubTool, seen from the top, with its border masked (so the stamp blends into any surface); the other SubTools are hidden. Plane Res sets how many quads it has (256 by default). Sculpt the shape with any brush: overhangs are welcome (Move, SnakeHook, Inflate). Divide the plane for finer detail. Keep the border flat. Type a name, choose the Map Size (256 pixels holds most shapes, 512 fine detail) and click Create VDM. The new map is saved in your brush library, shows in the list and becomes the VDM brush's map. Show your model again in the SubTool palette (its eye) and stamp away. The top of the screen when you look at the plane from the top is the top of the map: the side a DragRect drag points to. The plane's UVs record where each point started, so what Create VDM captures is how far each point moved, sideways and up."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"load-and-export-maps-blender-zbrush","h":"Load and export maps (Blender, ZBrush)","t":"Load VDM... reads an OpenEXR (16- or 32-bit, any compression) or a .sfvdm; dropping an .exr on the window does the same. A loaded EXR is kept in your brush library as a .sfvdm, so it's there next time. Export EXR... writes the brush's map as a 32-bit float EXR. Right-click a map you made or loaded to delete it. Maps use the convention of Blender's VDM Brush Baker and its Draw brush with Vector Displacement: Channel Means R X: toward the stamp's right G Y: toward the stamp's top (the image's top row; the drag direction of DragRect) B Z: out of the surface Units brush radii: (0, 0, 0.5) lifts the surface by half the radius; the map covers the brush's square So maps from Blender's VDM Brush Baker load as they are, and exported maps work in Blender: add an image texture with the EXR (Color Space: Non-Color) to a Draw brush, set the texture's Mapping to Area Plane, turn on Vector Displacement in the brush's Texture panel, and use the Anchored stroke at Strength 1 (see Working with Blender). Blender's brush touches only the round area of the brush, so the corners of a map are cut off there; in SculptForge the whole square stamps. ZBrush keeps its VDMs inside brushes (as 3D alphas) and doesn't export them as EXR by itself; maps made with Tool > Vector Displacement Map or third-party exporters use axes set by ZBrush's Vector Displacement Flip options. If a map from ZBrush stamps lying on its side, load it again with Swap Y/Z; if it is mirrored or leans the wrong way, with Flip X or Flip Y (Flip Z for a map that digs in where it should rise). Scale multiplies a map made in other units. From a script: vdm_set name=horn or vdm_set path=ear.exr swap_yz=true, vdm_stamp point=0,0.5,0 radius=0.3 angle=30, vdm_new_plane, vdm_capture name=\"My horn\" exr=horn.exr, vdm_export path=horn.exr, vdm_list, vdm_delete name=\"My horn\". ZBrush: the VDM brush works like ZBrush's VDM brushes with DragRect or DragDot. Not available yet: several VDMs in one brush (ZBrush's Create Multiple Alpha Brush), MidValue and the alpha options for 3D alphas, and reading ZBrush's own brush files."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"symmetry","h":"Symmetry","t":"Symmetry mirrors every stroke, including mask and paint strokes. X mirrors left and right. It is on by default; press X to toggle it. Y mirrors top and bottom, and Z mirrors front and back. They have no default key (you can assign one; see The interface). The X, Y and Z buttons are on the top shelf and in the Transform palette. You can combine them: X and Z together give four-way symmetry. Symmetry mirrors across the scene's axes through the origin. Models that are centred on the origin, such as SculptForge's primitives and most character exports, mirror correctly. If a stroke lands in the wrong place on the other side, the model is off-centre. ZBrush: this is ZBrush's world symmetry with the >X< axis on. Local symmetry, radial symmetry and topological (poseable) symmetry are not available yet."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"pen-pressure-and-tablets","h":"Pen pressure and tablets","t":"SculptForge reads pen pressure from graphics tablets and pen displays through the operating system. When it receives pen input, the Draw palette shows Pen pressure with the current value; before that it says No pen detected. Two toggles decide what pressure does. They are on the top shelf and in Draw > Tablet: Toggle Default Effect Pressure > Strength On Pen pressure scales the brush strength. Pressure > Size Off Pen pressure scales the brush size (down to 5% at the lightest touch). Pressure applies only to strokes made with the pen; mouse strokes always use full pressure. Custom brushes also have a Pressure curve setting that makes them respond to a light or a firm touch (see Brush Lab). If the pen moves the cursor but pressure does nothing, see Troubleshooting. Preferences > Tablet checks and tunes the pen: a pressure meter and a draw-test area, to see what the tablet reports at a light touch and a full press; a pressure curve for all brushes (Soft, Linear or Firm, or set Curve, Minimum, Maximum, Threshold and Full pressure at yourself), applied before each brush's own curve; the eraser end (default Invert, like holding Alt) and the side buttons (default: lower button right-click to rotate the view, upper button Invert, third button Pan view). Store Config (Ctrl+Shift+I) keeps these settings. Setup notes for Windows Ink, macOS and Linux are in docs/tablet.md."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"customize-the-bottom-shelf","h":"Customize the bottom shelf","t":"The bottom shelf holds your most-used brushes. By default it shows Standard, Clay, ClayBuildup, DamStandard, Move, Smooth, Inflate, Pinch, Flatten, Crease, Trim, SnakeHook, Layer, Nudge and Paint. The bottom shelf Add a brush: click the + tile at the end of the shelf and pick a brush, built-in or custom. Or right-click any tile in the brush picker and choose Add to bottom shelf. Remove a brush: right-click its tile and choose Remove from shelf. Reorder: turn on Preferences > Config > Enable Customize, then Ctrl+Alt+drag a tile to a new place. Change a brush's key: Ctrl+Alt+click its tile, then press the new key. Shelf changes last until you quit. Press Ctrl+Shift+I (Store Config) to keep them. See The interface for more on customizing."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"sculpt-from-a-script","h":"Sculpt from a script","t":"The stroke command applies a brush along a path on the active SubTool, as one undo step. It is useful for scripted detailing and for AI agents: sculptforge-cli -c 'new_sphere subdivisions=6; stroke brush=Crease points=\"-0.6,0.2,0 0,0.4,0 0.6,0.2,0\" symmetry=x; export_glb path=out.glb' Points are projected onto the surface along view (default 0,0,-1, the front view). radius (world units), strength, pressure, invert, spacing, curve and seed work as in the viewport. See Scripting and automation."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"see-also","h":"See also","t":"Brush Lab and sharing brushes: design brushes with AI, the brush library and brush codes Masking: protect areas from every brush Polypaint and materials: Paint brush, Rgb and colour Sculpt layers and blend shapes: sculpt into a layer you can dial in and out Dynamic topology: brushes that add triangles where they need them (Sculptris Pro) Keyboard and mouse reference"},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"","h":"Brush Lab and sharing brushes","t":"Brush Lab designs sculpting brushes from a description: type \"dry cracked mud\" and an AI model builds the brush, then you refine it in words or with sliders. This chapter covers Brush Lab, the AI providers it can use, the recipe settings, your brush library, and the ways to share brushes: .sfbrush files, one-line brush codes, studio folders and the community gallery. Brush Lab with a brush designed from a description"},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"what-a-custom-brush-is","h":"What a custom brush is","t":"A custom brush is a recipe: about twenty named values that describe how the brush moves the surface, the shape of its tip, a surface pattern, stroke spacing and masking. A recipe is data, never code, so brushes are safe to download and share. The AI only fills in these values; you can see and change every one of them. Custom brushes work everywhere built-in brushes do: on the bottom shelf, in the brush picker (B), with Alt, Shift, masks, symmetry, strokes and alphas."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"open-brush-lab","h":"Open Brush Lab","t":"Click AI Brush on the top shelf, or AI Brush at the top of the Brush palette. Brush Lab is a floating window; it opens at the top-left corner of the canvas the first time, and you can drag it anywhere. Click the button again, or the window's close box, to hide it."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"design-a-brush","h":"Design a brush","t":"Open Brush Lab. Type a description in the field at the bottom, the way you'd describe the brush to another sculptor, for example bark of an old oak tree or soft folds in heavy cloth. Or click one of the starter ideas, such as Overlapping dragon scales or Dry cracked mud. Press Enter or click Create. While the model works, the conversation shows \"Designing brush\". When the brush is ready, it becomes the active brush and the status bar says so. Try it on the model. The model replies with the brush name in brackets and a sentence on what the brush does and what to try next. Errors (no connection, rate limits, a model that didn't return a recipe) appear in red in the same conversation."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"refine-a-brush-in-words","h":"Refine a brush in words","t":"With Refine the selected brush ticked, your next message changes the active custom brush instead of creating a new one: \"sharper\", \"less buildup\", \"make the scales smaller\". The model sees the current recipe and your conversation so far. Clear chat starts a new conversation."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"tune-a-brush-with-sliders","h":"Tune a brush with sliders","t":"Open the Recipe section of Brush Lab to see every value of the active custom brush. The same editor appears in the Brush palette as Edit recipe: NAME when a custom brush is active. Hover a slider for a description. Setting Range What it does Direction normal, inflate, view, stroke Which way the surface moves: out of the surface, outward in every direction, toward the camera, or along the stroke. Depth -1 to 1 Adds material (positive) or carves it away (negative). Plane none, clay, flatten, fill, scrape Planar behaviour: flat-topped clay layers, levelling, raising only low spots, or cutting only high spots. Plane amount 0 to 1 Strength of the plane behaviour. Pinch -1 to 1 Pulls the surface toward the stroke for crisp creases (negative spreads it apart). Drag 0 to 1 Smears the surface along the stroke, like a palette knife. Auto smooth 0 to 1 Relaxes the surface after each dab for softer, cleaner results. Hardness 0 to 1 Soft airbrush edge (0) to hard-edged stamp (1). Tip sharpness 0 to 1 Round, broad tip (0) to a narrow needle point (1). Pattern none, noise, scales, ridges, pores, cracks A surface texture stamped by the brush. Pattern size 0.03 to 2 Size of the pattern relative to the brush size. Pattern amount 0 to 1 How strongly the pattern shows. Spacing 0.02 to 2 Distance between dabs, relative to the brush size. Jitter 0 to 1 Random scatter of dabs around the stroke. Pressure curve 0.3 to 3 Tablet response: above 1 needs a firmer press, below 1 responds to a light touch. Front faces only on / off Only affects surfaces facing the camera, protecting thin parts. Cavity mask -1 to 1 Positive: only cavities. Negative: only ridges and peaks (as Edge Wear does). The name field at the top of the editor renames the brush when you press Enter. Tip: to adapt a built-in recipe such as Dragon Scales, select it and move the sliders. Your version is saved to your library and replaces the built-in one; delete it to get the original back."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"choose-an-ai-provider","h":"Choose an AI provider","t":"Brush Lab works out of the box with no account or key. Open the AI provider section of Brush Lab (also in Generate > AI brush provider) to choose another service. Provider What you need Notes Free - no account or key (default) Nothing An open model (GPT-OSS 20B) hosted by Pollinations.ai. Only your description and settings are sent. Rate limited to about one request every few seconds. If it can't be reached, a running local Ollama is used instead. Anthropic (Claude) - your key An Anthropic API key Uses claude-opus-5-5 by default. Effort (low, medium, high) trades speed for more considered brushes. OpenAI-compatible (OpenAI, Ollama, LM Studio...) An endpoint, a model name and, for hosted services, a key Any server that speaks the OpenAI chat completions API, including local models. For Anthropic and OpenAI-compatible providers you can edit the Endpoint, Model and API key fields. Leave the key empty to use the ANTHROPIC_API_KEY or OPENAI_API_KEY environment variable. Click Save settings to keep your choice; settings and keys are stored only on your computer, in ai.json in the SculptForge settings folder (readable only by you). Requests go only to the endpoint you set."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"run-a-model-on-your-own-computer","h":"Run a model on your own computer","t":"For private, offline use with no rate limits, run a local model with Ollama or LM Studio: Install Ollama and download the recommended model: ollama pull qwen3:4b-instruct (2.5 GB, works without a graphics card). In AI provider, choose OpenAI-compatible (OpenAI, Ollama, LM Studio...). Click Ollama (or LM Studio) to fill in the local endpoint. Click Find models. SculptForge checks the connection, shows \"Connected\" with the number of installed models, and lets you pick one from the Model list. Click Save settings. The Run a model on this computer section in the panel shows the install steps for your operating system. The model needs about 4 GB of free memory; expect 10-20 seconds per brush on a laptop CPU and a few seconds with a GPU. The full walkthrough for Windows, macOS, Linux and LM Studio is in docs/local-ai.md."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"your-brush-library","h":"Your brush library","t":"Every brush you create or refine in Brush Lab is saved to your brush library automatically, a moment after your last change (slider edits save when you release the slider). The library loads at every start, in the app, in sculptforge-cli and in the Python module, so your brushes are always there. The library is a folder of .sfbrush files in the SculptForge settings folder: System Brush library Linux ~/.local/share/SculptForge/SculptForge/brushes macOS ~/Library/Application Support/SculptForge/SculptForge/brushes Windows %APPDATA%\\SculptForge\\SculptForge\\brushes The Custom brushes list in the Brush palette, with its right-click menu"},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"the-custom-brushes-list","h":"The Custom brushes list","t":"The Brush palette lists every custom brush under Custom brushes. A small tag after a name says where the brush comes from when it isn't simply yours or built in: Tag Meaning (none) A built-in brush, or a brush in your library yours Your version, which replaces a built-in or studio brush of the same name studio From a shared studio folder (read-only) gallery Installed from the community gallery (kept in your library) project Came with the open project and isn't in your library unsaved Made this session (for example picked from the picker's Library section, or loaded by a script) and not in your library Hover a brush for its description, origin and file. Right-click it for: Copy brush code: one line of text to share (see below). Save .sfbrush...: write the brush to a file. Rename...: rename it. Renaming a built-in or studio brush saves a renamed copy and keeps the original. Delete...: remove it from your library, after a confirmation. Only brushes in your own library can be deleted. If your brush replaced a built-in or studio brush, that one is used again. Reveal in folder: open the folder that holds its file. The same menu is available when you right-click a custom brush in the brush picker. When brushes share a name, your library wins over studio folders, and studio folders win over built-in brushes."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"brush-codes","h":"Brush codes","t":"A brush code is the whole recipe in one line of text, starting with sfbrush1:. Paste it into a chat, an email, an issue or a forum post. Copy: right-click a custom brush (in Brush > Custom brushes or the brush picker) and choose Copy brush code. Paste: copy a code, then press Ctrl+V over the viewport, click Paste brush in Brush Lab, or choose Edit > Paste brush. The brush is installed in your library and becomes active. Pasting also accepts the text of a .sfbrush file. Codes are validated like files: values outside their range are clamped, and anything that isn't a recipe is refused."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"brush-files-sfbrush","h":"Brush files (.sfbrush)","t":"A .sfbrush file is a small JSON file holding one recipe. Save: right-click the brush and choose Save .sfbrush..., or click Save .sfbrush... under the recipe sliders. Install: click Install .sfbrush... under the recipe sliders, or drop the file onto the SculptForge window. The brush goes into your library. Library folder: .sfbrush files in the Brushes folder of your LightBox library (Documents/SculptForge by default) appear in the Library section of the brush picker and in LightBox's Brush tab. Picking one loads it for the session. The file format and every key are documented in docs/brushes.md."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"studio-brush-folders","h":"Studio brush folders","t":"A studio can share brushes read-only from network folders. Set the environment variable SCULPTFORGE_BRUSH_PATH to one or more folders (separated by : on Linux and macOS, ; on Windows). Every .sfbrush file in them loads at start-up, tagged studio. Artists can't change or delete studio brushes; if they edit one, their own version is saved in their library under the same name. The Rez package adds the folder in SCULPTFORGE_STUDIO_BRUSHES to this path. See For studios. Projects (.sfproj) also store the brushes they use, so a scene opens with its brushes on any machine."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"the-community-gallery","h":"The community gallery","t":"The community gallery is a public collection of free (CC0) brushes shared by other sculptors. Click Community brushes at the top of the Brush palette. Search by name or description (scales, skin, stone...), or pick a tag from the All tags list. Click Install under a brush. It is downloaded, checked against its SHA-256 checksum, installed in your library and made active. Installed brushes show Installed. The Community brushes window The gallery is cached, so the window still opens offline (with a notice) showing the brushes from your last visit. Refresh fetches the latest list. Share yours opens the gallery's page on GitHub, where you can submit a brush you saved as .sfbrush with a pull request. You can also browse the gallery on the website at sculptforge.app/brushes.html. Studios can mirror the gallery or run their own. Enter a URL or folder in the Gallery field at the bottom of the window and click Use, or set SCULPTFORGE_BRUSH_GALLERY (which then takes precedence and hides the field). See docs/brushes.md for the gallery format."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"brushes-from-scripts","h":"Brushes from scripts","t":"Every brush operation is also a command, for sculptforge-cli, the console, Python and AI agents: Command What it does brush_ai prompt=... Design a brush from a description (optional provider, endpoint, model). brush_create name=... depth=... Create or update a brush from recipe values. brush_list / brush_library List custom brushes (with their source and file, and the library folders). brush_save path=... Save a brush as .sfbrush (name defaults to the active brush). brush_load path=... Load a .sfbrush file for this session only. brush_install path=... / code=... / json=... Install a brush into your library and make it active. brush_code Print a brush as a brush code. brush_rename to=... / brush_delete name=... Rename or delete a brush. brush_gallery_search / brush_gallery_install name=... Search and install from the community gallery. # Design a brush for free and save it for the team sculptforge-cli -c 'brush_ai prompt=\"weathered stone edges\"; brush_save path=stone.sfbrush' # Install a gallery brush and try it on a sphere sculptforge-cli -c 'brush_gallery_install name=\"Snake Scales\"; new_sphere subdivisions=6; stroke points=\"-0.5,0,0 0.5,0.2,0\"' See Scripting and automation for running commands."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"see-also","h":"See also","t":"Sculpting and brushes: built-in brushes, strokes, alphas and pressure For studios: shared brush folders and pipelines Troubleshooting: AI provider errors and rate limits"},{"p":"masking.html","c":"Masking","a":"","h":"Masking","t":"A mask protects part of the model from change. Masked areas are drawn darker, and every brush, the Paint brush and colour fills leave them alone. This chapter covers painting masks with Ctrl, masking with a lasso or rectangle, the background gestures, and the Tool > Masking controls for inverting, blurring, growing and building masks from cavities or polygroups. A mask painted on the lion's mane, with the Masking sub-palette"},{"p":"masking.html","c":"Masking","a":"how-masks-work","h":"How masks work","t":"A mask is a value per vertex from 0 (free) to 1 (fully masked). Values in between give partial protection, so a soft mask edge blends sculpting into the protected area. Masks belong to a SubTool: each SubTool has its own mask. Masks are saved in projects (.sfproj) and in .GoZ files, so they survive a round trip to ZBrush. Masking is not a layer and isn't affected by sculpt layers: a mask stroke always works on the model itself. Mask strokes and mask commands are undoable like any other change. To see the mask, keep Mask on in the right shelf (it is on by default). The same toggle is Show mask in Tool > Masking, and Show Mask in the Render palette. Turning it off hides the darkening; the mask still protects the surface."},{"p":"masking.html","c":"Masking","a":"paint-a-mask","h":"Paint a mask","t":"Hold Ctrl and drag on the model. The area under the brush becomes masked. Hold Ctrl+Alt and drag to erase the mask. Mask strokes use the current Draw Size, symmetry and, with a pen, pressure (when Pressure > Strength is on). How much each stroke masks is set by Mask Strength in Tool > Masking (0.01 to 1, default 1): lower values build up a soft, partial mask over several strokes. Mask strokes always use a round tip, whatever alpha you have selected, and a DragRect stroke masks with dabs along the path instead of one stamp. On macOS, Cmd works wherever this guide says Ctrl. ZBrush: this is ZBrush's Ctrl-masking with the MaskPen brush, the default. MaskLasso and MaskRect are described next."},{"p":"masking.html","c":"Masking","a":"mask-with-a-lasso-or-rectangle","h":"Mask with a lasso or rectangle","t":"To mask a large or sharply outlined area in one go, pick a mask selection shape. As in ZBrush, holding Ctrl turns the brush on the left shelf into the mask brush: with Ctrl held, click the brush tile (or press B) to pick MaskPen, MaskLasso or MaskRect, or click the stroke tile to pick the stroke (Dots, Lasso or Rect). The same shapes sit at the top of Tool > Masking: Shape Ctrl + drag MaskPen (default) Paints the mask with the brush, as described above. MaskLasso Draws a free-hand outline that closes back to where you started. Everything inside is masked. MaskRect Draws a rectangle. Everything inside is masked. With MaskLasso or MaskRect: Hold Ctrl and drag around the area. The drag can start on the model or on the background. The shape is drawn as you drag, white with a dark veil. Let go to mask what's inside. Hold Ctrl+Alt instead to unmask what's inside (the shape is drawn blue). You can press or release Alt while dragging; what counts is whether it is held when you let go. The selection works in screen space, like the visibility rectangle: a vertex counts as inside when it falls inside the shape as you see it, including vertices on the far side of the model. Hidden parts are left alone. Mask Strength sets how much a selection masks or unmasks, and each selection is one undo step. A lasso that crosses itself leaves out the areas it encloses twice. The cursor turns into a small cross while Ctrl is held, since the brush size doesn't matter for a selection. ZBrush: these are ZBrush's MaskLasso and MaskRect brushes. Like ZBrush, the shape stays selected until you pick another one, so switch back to MaskPen to paint masks again. Holding Ctrl shows the mask brush on the shelf and Ctrl with the Brush or Stroke picker picks it, as in ZBrush. MaskCurve is not available yet."},{"p":"masking.html","c":"Masking","a":"background-gestures","h":"Background gestures","t":"With Ctrl held, clicks and drags on the empty background act on the whole mask: Gesture Effect Ctrl + click the background Invert the mask Ctrl + drag on the background Clear the mask (MaskPen) Ctrl + drag on the background, with nothing masked Nothing, as in ZBrush (the SculptForge input style zooms the view, see Coming from ZBrush) On the model, a Ctrl + click that doesn't drag works on the mask's edges, as in ZBrush: Gesture Effect Ctrl + click the model Blur the mask (once per click; same as Blur) Ctrl+Alt + click the model Sharpen the mask (same as Sharpen)"},{"p":"masking.html","c":"Masking","a":"mask-keys","h":"Mask keys","t":"Key Effect Ctrl+A Mask All Ctrl+Shift+A Clear Mask Ctrl+I Invert Mask Ctrl+H Show or hide the mask's shading (View Mask) Ctrl+W Group Masked: the masked part becomes a new polygroup and the mask is cleared (see Polygroups) A drag starts after the cursor moves a few pixels, so a slightly shaky click still inverts. With MaskLasso or MaskRect, a Ctrl + drag on the background draws the shape instead; clear the mask with Clear, or Ctrl+Alt + drag a shape around the whole model."},{"p":"masking.html","c":"Masking","a":"the-masking-sub-palette","h":"The Masking sub-palette","t":"Open Tool > Masking (the Tool palette is in the right tray by default). Every button is one undo step. Control What it does Command Show mask Darken masked areas in the viewport. MaskPen / MaskLasso / MaskRect What Ctrl + drag does: paint with the brush, or mask inside a lasso or rectangle. mask_lasso / mask_rect Mask Strength How much each mask stroke or selection masks (0.01 to 1), and the mask value By cavity gives the deepest cavities. Clear Unmask everything. mask_clear Invert Masked becomes free and free becomes masked. mask_invert All Mask every visible vertex. mask_all Blur Soften the mask edges by averaging with neighbouring vertices. mask_blur Sharpen Tighten soft edges, pushing values toward fully masked or free. mask_sharpen Grow Expand the masked region by one ring of edges per pass. mask_grow Shrink Contract the masked region by one ring of edges per pass. mask_shrink passes How many times Blur, Sharpen, Grow and Shrink run (1 to 20 here, default 1). iterations= By cavity Mask concave areas (creases, folds, pores), replacing the current mask. mask_by_cavity threshold How concave a spot must be for By cavity (-0.2 to 0.5, default 0.02). 0 masks anything concave; higher values keep only deep creases. threshold= By polygroup Mask one polygroup, replacing the current mask. The number field next to it is the polygroup id. mask_by_polygroup Mask operations only change visible parts of the model; hidden parts keep their mask. Clear is the exception and frees everything."},{"p":"masking.html","c":"Masking","a":"protect-detail-while-smoothing","h":"Protect detail while smoothing","t":"Click By cavity to mask the creases and pores. Smooth with Shift. The cavities keep their sharpness while the surface between them relaxes. Ctrl + drag on the background to clear the mask when you're done. Raise threshold if too much is masked; lower Mask Strength for partial protection."},{"p":"masking.html","c":"Masking","a":"sculpt-one-part-only","h":"Sculpt one part only","t":"Paint a mask over the part you want to work on with Ctrl. Ctrl + click the background to invert it. Now everything except that part is protected. Sculpt freely; strokes that cross the edge stop at the mask."},{"p":"masking.html","c":"Masking","a":"mask-a-whole-polygroup","h":"Mask a whole polygroup","t":"The quickest way works without knowing the group's number: Ctrl+Shift + click the group to isolate it (see Polygroups and visibility). Click All: only visible vertices are masked. Ctrl+Shift + click the background to show everything again. The mask stays. By polygroup masks a group by its id. The viewport doesn't show ids, but the console does: isolate the group, then open the console (`) and read the isolate_polygroup group=N line. Enter that number in the field next to By polygroup and click it."},{"p":"masking.html","c":"Masking","a":"a-soft-edged-mask","h":"A soft-edged mask","t":"Paint the mask, then click Blur a few times (or set passes to 3-5 first). Sharpen does the opposite."},{"p":"masking.html","c":"Masking","a":"turn-a-mask-into-a-polygroup","h":"Turn a mask into a polygroup","t":"Click From mask in Tool > Polygroups: the masked triangles become a new polygroup. See Polygroups and visibility."},{"p":"masking.html","c":"Masking","a":"masks-and-painting","h":"Masks and painting","t":"Polypaint respects the mask too: the Paint brush, Rgb strokes and Fill leave masked areas alone, so you can mask an area and fill the rest with a colour. See Polypaint and materials."},{"p":"masking.html","c":"Masking","a":"masking-from-a-script","h":"Masking from a script","t":"Command Options mask_clear, mask_all, mask_invert mask_blur, mask_sharpen, mask_grow, mask_shrink iterations (1-100, default 1) mask_by_cavity strength (0-1, default 1), threshold (-1 to 1, default 0.02) mask_by_polygroup group (required), add=true to add to the current mask instead of replacing it mask_rect x0 y0 x1 y1 (-1 to 1, y up), unmask, strength (0-1, default 1), optional view_proj matrix; without a view the rectangle spans the mesh seen from the front mask_lasso points (required): the outline as \"x0 y0 x1 y1 ...\", at least 3 points in the same -1 to 1 space; unmask, strength, view_proj as for mask_rect sculptforge-cli -c 'open path=head.obj; mask_by_cavity threshold=0.05; mask_blur iterations=2; save_project path=head.sfproj' Not yet: masking by topology, by normals or by alpha, Mask By Smoothness, and MaskCurve are not available yet."},{"p":"masking.html","c":"Masking","a":"see-also","h":"See also","t":"Polygroups and visibility: groups, isolating and hiding parts Sculpting and brushes: modifier keys and brush settings Polypaint and materials: fills that respect the mask"},{"p":"polygroups.html","c":"Polygroups and visibility","a":"","h":"Polygroups and visibility","t":"Polygroups divide a SubTool'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 SubTools. This chapter covers creating polygroups, the Ctrl+Shift visibility gestures and the Tool > Polygroups and Tool > Visibility controls. Polygroups shown as colours, with the Polygroups sub-palette"},{"p":"polygroups.html","c":"Polygroups and visibility","a":"show-polygroups","h":"Show polygroups","t":"Click Groups in the right shelf to colour each polygroup of the active SubTool. The same toggle is Show polygroups in Tool > Polygroups and Show Polygroups in the Render palette. The grouping buttons turn the colours on for you, so you see the result straight away. The number next to Show polygroups is how many polygroups are visible right now. A mesh without polygroups is one group. Polygroups come from: the grouping buttons below; OBJ files: each g group becomes a polygroup, as ZBrush writes them (SculptForge also writes polygroups as g groups when it exports OBJ); .GoZ files from ZBrush and SculptForge projects, which keep polygroups."},{"p":"polygroups.html","c":"Polygroups and visibility","a":"create-polygroups","h":"Create polygroups","t":"Open Tool > Polygroups. Grouping works on the visible part of the SubTool only; hidden parts keep their groups. So you can isolate one part and regroup just that part. Control What it does Command By normals 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. polygroup_auto_by_normals By pieces One group per disconnected piece, such as separate eyes or buttons in one mesh. polygroup_by_connectivity From mask Masked triangles move into a new group. polygroup_from_mask Group by UVs One group per UV island: triangles that touch without a UV seam between them share a group. Needs UVs (Tool > Texture Map > Auto UV or an imported model's). polygroup_uv Merge visible Everything visible becomes one group. polygroup_merge_visible Clear groups Remove all polygroups; the whole SubTool becomes one group again. polygroup_clear Each button is one undo step. ZBrush: By normals is Auto Groups / Groups By Normals, By pieces is Auto Groups on a mesh with separate parts, From mask is Group Masked, Group by UVs is UV Groups, and Merge visible is Group Visible. Ctrl+W works as in ZBrush: the masked part becomes a new group and the mask is cleared (with nothing masked, everything visible becomes one group)."},{"p":"polygroups.html","c":"Polygroups and visibility","a":"group-a-region-you-painted","h":"Group a region you painted","t":"Paint a mask over the region with Ctrl (see Masking). Click From mask in Tool > Polygroups. Ctrl + drag on the background to clear the mask."},{"p":"polygroups.html","c":"Polygroups and visibility","a":"hide-and-show-parts","h":"Hide and show parts","t":"Visibility is the main reason to have polygroups: hide what is in the way, sculpt what's left, then show everything again. Hidden parts can't be sculpted, painted or masked, so hiding also protects them. All of the gestures use Ctrl+Shift in the viewport (Cmd+Shift on macOS): Gesture Effect Ctrl+Shift + click a polygroup, everything shown Isolate it: show only that group. Ctrl+Shift + click a polygroup, something hidden Hide that group (as in ZBrush). Ctrl+Shift + click the isolated group again Invert the visibility: show everything else instead. Ctrl+Shift+Alt + click a polygroup Hide that group. Ctrl+Shift + click the background Show everything. Ctrl+Shift + drag a rectangle on the background, around nothing Reverse the visibility. Ctrl+Shift + drag Keep what's inside the rectangle (or lasso), hide the rest. The shape is drawn green. Ctrl+Shift+Alt + drag Hide what's inside the rectangle (or lasso). The shape is drawn red. Whether a drag draws a rectangle or a lasso is set by SelectRect and SelectLasso at the top of Tool > Visibility (SelectRect by default), or, as in ZBrush, with Ctrl+Shift held: the left shelf then shows the selection brush, and clicking the brush tile (or pressing B) or the stroke tile picks SelectRect or SelectLasso. With SelectLasso, 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. 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 Alt while dragging; what counts is whether it is held when you let go. SculptForge refuses a change that would hide everything, as ZBrush does. Every visibility change is one undo step, so Ctrl+Z brings back what you just hid. ZBrush: the gestures are the same as ZBrush's SelectRect and SelectLasso with polygroups. Grow and Shrink visibility and hiding by clicking with the rectangle brush are not available yet."},{"p":"polygroups.html","c":"Polygroups and visibility","a":"the-visibility-sub-palette","h":"The Visibility sub-palette","t":"Open Tool > Visibility: Control What it does Command SelectRect / SelectLasso The shape Ctrl+Shift + drag draws: a rectangle or a free-hand lasso. hide_rect / hide_lasso Show all Show every hidden part again. Available when something is hidden. show_all Invert visible Hide what is visible and show what is hidden. invert_visibility Delete hidden Permanently remove the hidden triangles from the mesh. Undoable. delete_hidden Delete hidden keeps every attribute of what remains (mask, polypaint, polygroups, 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":"polygroups.html","c":"Polygroups and visibility","a":"work-on-one-part-of-a-character","h":"Work on one part of a character","t":"Click By pieces (for a mesh made of separate parts) or By normals. Ctrl+Shift + click the part you want, for example the head. Sculpt. The rest of the body is hidden and can't be touched. Ctrl+Shift + click the background to show everything."},{"p":"polygroups.html","c":"Polygroups and visibility","a":"clean-up-a-scan-or-a-generated-model","h":"Clean up a scan or a generated model","t":"Turn the model so the unwanted piece is on screen. Ctrl+Shift+Alt + drag a rectangle over it to hide it. For an awkward shape, pick SelectLasso in Tool > Visibility first and draw around it. Click Delete hidden in Tool > Visibility."},{"p":"polygroups.html","c":"Polygroups and visibility","a":"split-a-model-into-subtools","h":"Split a model into SubTools","t":"Group the model, then click Split groups in Tool > SubTool: each polygroup becomes its own SubTool. Split parts does the same by disconnected piece. See SubTools."},{"p":"polygroups.html","c":"Polygroups and visibility","a":"polygroups-and-other-tools","h":"Polygroups and other tools","t":"Masking: By polygroup in Tool > Masking masks one group (see Masking). Brushes and polypaint skip hidden faces. Projects save polygroups and what's hidden; GoZ and OBJ carry polygroups to and from ZBrush. Each SubTool has its own polygroups and visibility. To show and hide whole SubTools, use the eye icons and Solo in Tool > SubTool."},{"p":"polygroups.html","c":"Polygroups and visibility","a":"polygroups-from-a-script","h":"Polygroups from a script","t":"Command Options polygroup_auto_by_normals angle (1-180 degrees, default 30) polygroup_by_connectivity, polygroup_uv, polygroup_from_mask, polygroup_merge_visible, polygroup_clear isolate_polygroup, hide_polygroup group (required): the polygroup id show_all, invert_visibility, delete_hidden hide_rect x0 y0 x1 y1 (-1 to 1, y up), inside, optional view_proj matrix; without a view the rectangle spans the mesh seen from the front hide_lasso points (required): the outline as \"x0 y0 x1 y1 ...\", at least 3 points in the same -1 to 1 space; inside, view_proj as for hide_rect When you isolate or hide a group in the viewport, the console (`) shows the command with the group's id, for example isolate_polygroup group=3, which you can reuse in scripts. sculptforge-cli -c 'open path=robot.obj; polygroup_by_connectivity; subtool_split_groups; save_project path=robot.sfproj' Not yet: a polygroup paint brush, Group Front, polygroups from UV islands or PolyPaint, and polygroup-based crease edges are not available yet."},{"p":"polygroups.html","c":"Polygroups and visibility","a":"see-also","h":"See also","t":"Masking: build masks from polygroups and polygroups from masks SubTools: split by groups, show, hide and solo whole SubTools Keyboard and mouse reference"},{"p":"subtools.html","c":"SubTools","a":"","h":"SubTools","t":"A scene in SculptForge can hold several separate meshes, called SubTools, just as in ZBrush: a body, eyes, teeth, a helmet and a sword can each live in their own SubTool. This chapter covers the SubTool list, selecting, adding, hiding, reordering, merging and splitting SubTools, and how they travel through files."},{"p":"subtools.html","c":"SubTools","a":"how-subtools-work","h":"How SubTools work","t":"Only the active SubTool is sculpted, painted, masked or changed by a command. The others are drawn slightly darker and greyer so you can see which one you are working on. Each SubTool keeps its own mesh, mask, polypaint, polygroups, hidden faces, UVs and sculpt layers. Each SubTool has its own undo history. Ctrl+Z undoes the last change in the active SubTool, and switching SubTools doesn't lose the history of the others. Adding, deleting, reordering, merging and splitting SubTools are not undoable, as in ZBrush. Merges and deletes ask for confirmation first. The title strip shows the active SubTool and its place in the list, for example SubTool Helmet (2/5). ZBrush: SubTools work the way you expect: one active SubTool, the rest dimmed, Alt+click in the viewport to switch. There is no folder grouping of SubTools yet."},{"p":"subtools.html","c":"SubTools","a":"the-subtool-list","h":"The SubTool list","t":"The list is in Tool > SubTool, which is open in the right tray by default. The SubTool sub-palette with several SubTools, the active one highlighted Each row shows the SubTool's name, its triangle count and an eye. To Do this Select a SubTool Click its row, or Alt+click it in the viewport Rename it Double-click the row (or right-click > Rename), type, press Enter Hide or show it Click the eye at the end of the row Duplicate or delete it Right-click the row > Duplicate or Delete... See its vertex and triangle counts Point at the row for a moment The list shows six rows and scrolls when there are more. Names are kept unique: renaming a SubTool to a name that is already taken adds a number. Selecting a hidden SubTool shows it again, because you can't sculpt what you can't see."},{"p":"subtools.html","c":"SubTools","a":"select-a-subtool-in-the-viewport","h":"Select a SubTool in the viewport","t":"Hold Alt and click another SubTool on the canvas. It becomes the active one and the list scrolls to it. Alt+click only selects when you click a SubTool other than the active one and release without moving. If you drag instead, Alt keeps its usual meaning: an inverted stroke on the active SubTool, or a pan when you start off the model."},{"p":"subtools.html","c":"SubTools","a":"add-a-subtool","h":"Add a SubTool","t":"Click Append and choose: Sphere, Cube or Plane: a new primitive placed beside the visible model (to the right, on +X), sized to about a third of the largest visible SubTool. From file...: a model (.obj, .fbx, .glb, .gltf, .ply, .stl, .GoZ, .usda, .usd, .usdz) or a project (.sfproj). A file with several objects adds one SubTool per object. The new SubTool becomes the active one. You can also add files as SubTools from elsewhere: Import in the Tool palette header (or File > Import) adds a model file as a new SubTool. In the LightBox Tool tab, Shift+double-click a model, or right-click it and choose Append as SubTool. Tip: Duplicate copies the active SubTool with its layers and attributes, names it copy and puts it right under the original. Use it to keep a safe copy before a destructive step such as a remesh."},{"p":"subtools.html","c":"SubTools","a":"show-hide-and-solo","h":"Show, hide and solo","t":"The eye on each row shows or hides that SubTool. Solo shows only the active SubTool. Click it again to bring the others back. The Solo button on the right shelf does the same. Unhide all shows every SubTool. Hidden SubTools aren't drawn, can't be selected with Alt+click, and are left out of exports. Note: SubTool visibility is different from hiding part of a mesh with polygroups or a rectangle. That hides faces inside one SubTool; see Polygroups and visibility."},{"p":"subtools.html","c":"SubTools","a":"reorder-subtools","h":"Reorder SubTools","t":"The up and down arrow buttons under the list move the active SubTool one place up or down. The order matters for Merge down and is the order objects are written to files."},{"p":"subtools.html","c":"SubTools","a":"merge-subtools","h":"Merge SubTools","t":"Merge down... merges the active SubTool with the one below it. Merge visible... merges every visible SubTool into one new SubTool called Merged. Hidden SubTools stay as they are. Merging keeps every attribute, gives each original mesh its own polygroups (so you can split them again later) and matches sculpt layers by name. The merged SubTool starts with an empty undo history. A SubTool with subdivision levels is merged (or split) at the level it is on, which becomes the base of the result; the status line names the SubTools that lost their levels. Painted textures are kept too: the merged SubTool gets new Auto UVs and one texture, the size of the largest, holding each part's paint exactly (texture layers are flattened; parts without a texture are white). On big meshes the Auto UV takes a while. Scripts can skip it with keep_texture=false, which drops the textures. Tip: Merge first when you want one voxel remesh to fuse several pieces into a single watertight surface."},{"p":"subtools.html","c":"SubTools","a":"split-a-subtool","h":"Split a SubTool","t":"Split groups makes one SubTool per polygroup. It is available when the active SubTool has more than one polygroup. Split parts makes one SubTool per disconnected piece, largest first. Both replace the active SubTool with the pieces. Because a merge keeps each original mesh in its own polygroup, Split groups undoes a merge."},{"p":"subtools.html","c":"SubTools","a":"delete-a-subtool","h":"Delete a SubTool","t":"Click Delete... (or right-click a row > Delete...) and confirm. The last SubTool can't be deleted, and a delete can't be undone."},{"p":"subtools.html","c":"SubTools","a":"subtools-in-files","h":"SubTools in files","t":"Format What happens to SubTools Project (.sfproj) Every SubTool is saved with its name, visibility, attributes, layers and active layer OBJ Each visible SubTool is an o object; on import, o objects become SubTools and g groups become polygroups glTF / GLB One node and mesh per visible SubTool, both ways FBX One model per visible SubTool (with LODs, an LOD group each), both ways USD One Mesh prim per visible SubTool, both ways GoZ Each visible SubTool is sent to ZBrush as its own SubTool PLY, STL, splat conversion The visible SubTools are merged into one mesh Opening a multi-object file replaces the scene with one SubTool per object. See Exporting for the details of each format."},{"p":"subtools.html","c":"SubTools","a":"scripting","h":"Scripting","t":"Every SubTool action is a command, so you can use them in the console, scripts, Python and MCP agents. SubTools are addressed by index (0 is the top of the list) or name; without either, the active one is used. Command What it does subtool_list List the SubTools subtool_select index=1 Make a SubTool active subtool_append type=cube Add a primitive (sphere, cube, plane); path= adds a file; size= (0.05-2, default 0.35) subtool_duplicate Copy a SubTool subtool_delete name=Helmet Delete a SubTool subtool_rename to=Body Rename a SubTool subtool_visibility visible=false Show or hide (toggles when visible is left out) subtool_solo / subtool_show_all Solo the active SubTool / show every SubTool subtool_move direction=up Move a SubTool up or down the list subtool_merge_down / subtool_merge_visible Merge subtool_split_groups / subtool_split_parts Split subtool_append type=sphere name=EyeL size=0.12; subtool_duplicate; subtool_rename to=EyeR"},{"p":"subtools.html","c":"SubTools","a":"see-also","h":"See also","t":"Polygroups and visibility: hide parts of one SubTool Sculpt layers and blend shapes: layers belong to each SubTool Exporting: how SubTools reach other applications Projects, autosave and QuickSave"},{"p":"polypaint.html","c":"Polypaint and materials","a":"","h":"Polypaint and materials","t":"Polypaint stores a colour on every vertex of the mesh, so you can paint a sculpt without UVs or textures, as in ZBrush. This chapter covers the Paint brush, painting while you sculpt, fills and cavity paint, picking colours, paint layers with blend modes, and the MatCap materials that change how the model is shaded in the viewport."},{"p":"polypaint.html","c":"Polypaint and materials","a":"how-polypaint-works","h":"How polypaint works","t":"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. Subdivide or remesh at a higher resolution before fine painting. Painting respects the mask (masked areas keep their colour) and skips hidden faces. Symmetry works for painting as it does for sculpting. Polypaint is per SubTool and is saved in projects. It is exported as vertex colours to PLY, glTF/GLB, OBJ, USD (displayColor) and GoZ. FBX export doesn't include it. A mesh starts without polypaint. The first paint stroke or fill adds it (white everywhere you haven't painted). Texture painting: to paint finer than the mesh, give the SubTool a texture and paint into it instead; the Paint brush, fills and paint layers work the same way. Polypaint > Texture bakes polypaint into a texture. See Texture painting."},{"p":"polypaint.html","c":"Polypaint and materials","a":"paint-with-the-paint-brush","h":"Paint with the Paint brush","t":"Press P, click Paint on the top shelf, or pick Paint on the bottom shelf. Choose a colour (see below). Stroke over the model. Draw Size, the stroke type and the alpha work as they do for sculpting; RGB Intensity (I) sets how strongly the colour goes on. While the Paint brush is active: Alt paints back towards white. Shift still smooths the shape, as in ZBrush. The surface isn't changed. Press P again, or click Sculpt on the top shelf, to go back to sculpting. Polypaint on a sculpt with the Color palette open ZBrush: Paint is ZBrush's Rgb on with Zadd off. Sculpt with Rgb on is Rgb with Zadd: the brush sculpts and paints at once."},{"p":"polypaint.html","c":"Polypaint and materials","a":"paint-while-sculpting","h":"Paint while sculpting","t":"Turn on Rgb on the top shelf (or RGB while sculpting in the Color palette). Every sculpt brush then also paints the current colour along its stroke. The Smooth brush and Shift-smoothing never paint."},{"p":"polypaint.html","c":"Polypaint and materials","a":"choose-a-colour","h":"Choose a colour","t":"The left shelf has a colour picker (a square plus a hue strip), two swatches and a Fill button. Clicking the second swatch swaps it with the main colour, like ZBrush's Alternate. The Color palette 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. Press C with the cursor over the model to pick the colour under it (the mesh needs polypaint for this, or a texture while painting into the texture)."},{"p":"polypaint.html","c":"Polypaint and materials","a":"fill-cavity-paint-and-clear","h":"Fill, cavity paint and clear","t":"The Color palette has four buttons: Button What it does Fill Fills the unmasked area with the colour (the whole mesh when nothing is masked). Same as Fill on the left shelf Fill masked Fills only the masked area. Available when the mesh has a mask Cavity Darkens the creases and cavities with a dark brown, respecting the mask. A quick way to bring out detail Clear Removes all polypaint from the active SubTool All of them are undoable. Show polypaint in the same palette (or Paint on the right shelf) turns the colours off in the viewport without deleting them. Tip: To paint a base colour and then dirt in the creases: Fill with the base colour, then Cavity. For a different cavity colour or strength, use the command (below)."},{"p":"polypaint.html","c":"Polypaint and materials","a":"paint-layers","h":"Paint layers","t":"Paint layers stack polypaint the way Photoshop stacks image layers. Each layer has its own name, visibility, opacity and blend mode, 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 SubTool has its own stack. Tool > Paint Layers: Base, a Multiply dirt layer, a Soft Light tint and an empty Normal layer"},{"p":"polypaint.html","c":"Polypaint and materials","a":"how-paint-layers-work","h":"How paint layers work","t":"Base is the bottom layer: the SubTool's polypaint, always opaque. With only Base, polypaint works exactly as it did before, and nothing changes in your files. Layers above Base start transparent. Painting on a layer adds colour and coverage: where you haven't painted, the layer is see-through. Painting never touches the layers you aren't on. 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. 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. The Paint brush, Rgb while sculpting, Fill, Fill masked and Cavity all write into the active layer (highlighted in the list; the Color palette shows \"Painting on: ...\"). They respect the mask and hidden faces on every layer. With the Paint brush on a layer, Alt erases the layer's paint (on Base it paints back towards white, as before). A hidden or locked layer can't be painted, filled or cleared; the status line says why."},{"p":"polypaint.html","c":"Polypaint and materials","a":"blend-modes","h":"Blend modes","t":"Mode Effect Normal The layer's colour covers what is below Multiply Darkens: dirt, shadows, cavity grime. White does nothing Screen Lightens: highlights, glow, dust. Black does nothing Overlay Adds contrast and tints the midtones. 50% grey does nothing Soft Light A gentler Overlay, good for skin tints and colour variation Add Adds the colours (Photoshop's Linear Dodge); strong highlights Subtract Subtracts the layer's colour Darken / Lighten Keeps the darker / lighter colour, channel by channel Difference The difference between the colours; useful for checking two paint passes against each other"},{"p":"polypaint.html","c":"Polypaint and materials","a":"the-paint-layers-sub-palette","h":"The Paint Layers sub-palette","t":"Open Tool > Paint Layers in the right tray (it sits under the sculpt Layers 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. Click a row to paint on that layer. Double-click it to rename. Right-click for Rename, Duplicate, Merge down, Clear and Delete. The eye shows or hides the layer; the lock protects it from painting, fills, clears and merges. Under the list: the active layer's blend mode and Opacity slider. The opacity previews live while you drag and is one undo step when you let go. New adds a transparent layer above the active one. Duplicate copies the active layer (Base becomes an opaque layer). Delete removes the active layer. The arrows move the active layer up or down. Merge down merges it into the layer below (into Base for the lowest layer). Flatten bakes every visible layer into Base and removes the layers; hidden layers are discarded. Clear layer makes the active layer transparent again (Base: white). Fill layer fills it with the current colour, like Fill in the Color palette. Hold Ctrl over any control for its description. Every action is undoable with Ctrl+Z. Tip: 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":"polypaint.html","c":"Polypaint and materials","a":"paint-layers-and-sculpt-layers","h":"Paint layers and sculpt layers","t":"They are separate stacks. Tool > Layers holds sculpt layers: shape changes exported as blend shapes. Tool > Paint Layers holds colour. Selecting a sculpt layer doesn't change the paint layer you paint on, and the other way round, so a stroke with Rgb on can sculpt into the \"Smile\" layer and paint into the \"Blush\" layer at once."},{"p":"polypaint.html","c":"Polypaint and materials","a":"files-subtools-and-geometry","h":"Files, SubTools and geometry","t":"Paint layers are saved in projects (.sfproj) with their names, blend modes, opacity, visibility, lock and the active layer. Older versions of SculptForge open these projects with the paint flattened. Exports (OBJ, PLY, glTF/GLB, USD, GoZ) write the composited colours, exactly what the viewport shows. Duplicating a SubTool copies its layers, and Split keeps them on each piece. Subdividing and decimating keep them too. Merging SubTools, a voxel remesh and other rebuilds keep the look but flatten the layers into Base. ZBrush and Mudbox: ZBrush's polypaint layers only have opacity. Here every layer also has a blend mode, its own coverage and a lock, like the paint layers in Mudbox and Photoshop."},{"p":"polypaint.html","c":"Polypaint and materials","a":"materials-matcaps","h":"Materials (MatCaps)","t":"Materials change only how the model is shaded in the viewport. They aren't exported and don't change polypaint. Material Look Sculpt The default, 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 Red Wax Glossy deep red wax, the classic sculpting look Clay Matte grey-brown clay Skin Warm, soft skin tones Chrome Mirror-like metal, good for checking surface flow White Neutral off-white for judging forms Bronze Polished bronze Studio Softer clay shading with studio lighting (the default in earlier versions). Its colour is Base colour in the Material palette To choose one: Press M for the material picker under the cursor, or click the Material tile on the left shelf. Point at a material to preview it on the model, click to keep it. Esc or clicking away puts the previous material back. Open the Material palette, or the Material tab of the LightBox. The material picker with the seven MatCaps and Studio Polypaint 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. Tip: Sculpt is the material to judge strokes with. The prettier ones (Skin, Red Wax) soften small detail; switch to them for presenting. Not yet: loading your own MatCap images, and physically based materials or BPR-style renders."},{"p":"polypaint.html","c":"Polypaint and materials","a":"scripting","h":"Scripting","t":"Command What it does set_color color=#c08060 Set the paint colour: rrggbb, #rrggbb (quote it in scripts), r,g,b or a name such as white, skin, bone paint_fill area=unmasked Fill; area is unmasked (default), masked or all; strength 0-1 paint_from_cavity color=#202020 strength=0.7 smoothing=2 Cavity paint (defaults: dark brown, 0.7, 2 blur passes) paint_clear Remove all polypaint, paint layers included paint_layer_add name=Dirt blend=multiply opacity=0.8 Add a paint layer above the active one and paint on it paint_layer_set index=0 opacity=0.5 blend=overlay visible=false locked=true name=Grime Change a layer (layer=Dirt picks it by name; default: the active layer) paint_layer_select layer=Base Paint on another layer (index=-1 is Base, 0 the first layer above it) paint_layer_duplicate, paint_layer_delete, paint_layer_clear Copy, delete or clear the active (or given) layer paint_layer_move direction=up Move a layer up or down the stack paint_layer_merge / paint_layer_flatten Merge down / bake every visible layer into Base paint_layer_list List the layers, top first (* marks the active one) set_material name=Chrome Viewport material: a MatCap name (Sculpt is the default) or studio (desktop app only) 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"},{"p":"polypaint.html","c":"Polypaint and materials","a":"see-also","h":"See also","t":"Masking: protect areas from painting Sculpt layers and blend shapes: the shape counterpart of paint layers Sculpting and brushes: Draw Size, Focal Shift, strokes and alphas also apply to painting Exporting: which formats carry vertex colours"},{"p":"texture-painting.html","c":"Texture painting","a":"","h":"Texture painting","t":"Texture painting puts the colour into an image laid over the model's UVs, instead of on its vertices. The detail you can paint then comes from the texture's resolution, not from how dense the mesh is: a 4K texture on a light, game-ready mesh holds pores, freckles and sharp decals that polypaint could only show on millions of polygons. Everything you know from polypaint still applies: the same Paint brush, colours, fills, symmetry, mask and paint layers with blend modes. Texture painting: a sharp texture stroke above a soft polypaint stroke, with the UV view in Tool > Texture Map"},{"p":"texture-painting.html","c":"Texture painting","a":"start-in-one-click","h":"Start in one click","t":"Press P for the Paint brush (or turn on Rgb). While the SubTool has no texture, New Texture appears on the top shelf and in the Color palette. Click it: if the model has no UVs, SculptForge runs Auto UV first (in the background; the status bar shows its progress), then gives it a white texture (2K, or the size chosen in Tool > Texture Map) and switches painting to Texture. Paint away. The steps below do the same thing by hand, with more choices."},{"p":"texture-painting.html","c":"Texture painting","a":"paint-a-texture-in-four-steps","h":"Paint a texture in four steps","t":"Open Tool > Texture Map in the right tray. If the SubTool has no UVs (the sub-palette says \"No UVs\"), click Auto UV. SculptForge cuts the model into UV islands and packs them into the texture square. It works in the background with a progress bar; on a few hundred thousand triangles it takes seconds, on millions it can take a minute or more. Models imported with UVs (from ZBrush, Maya, Blender...) already have them: skip this step. Choose a size (1K, 2K, 4K or 8K; 2K is the default) and click New Texture. The model now carries a white texture, and painting goes into it: Texture lights up next to Vertex on the top shelf. Press P and paint. Draw Size, RGB Intensity, pen pressure, the stroke type, the alpha, symmetry and the mask work as they do for polypaint. Click Show UVs to see the texture with the UV layout drawn over it, below the buttons. Paint on the model and watch the texture fill in."},{"p":"texture-painting.html","c":"Texture painting","a":"vertex-or-texture","h":"Vertex or Texture","t":"When a SubTool has a texture, Vertex and Texture appear on the top shelf next to Rgb (and in the Color, Paint Layers and Texture Map palettes). They choose where paint goes: Texture: the Paint brush, Rgb while sculpting, Fill, Fill masked, Cavity, Clear and the Paint Layers palette work on the texture. Vertex: they work on the polypaint, exactly as before. The model shows both: the polypaint multiplied by the texture, over the material. If paint looks as coarse as the mesh's polygons, it is going into the vertices: check that Texture is lit, and that the SubTool carries no old polypaint (Tool > Paint Layers, or Polypaint > Texture to move it into the texture). Texture paint itself is as sharp as the texture: a hard alpha gives the same texels on a two-triangle plane as on a dense mesh. Each SubTool keeps its own choice, saved in the project. Show texture (Texture Map, or the Color palette) hides the texture in the viewport without deleting it."},{"p":"texture-painting.html","c":"Texture painting","a":"how-texture-painting-works","h":"How texture painting works","t":"Each texel under the brush gets its 3D position on the surface, so the falloff, the alpha and the brush size are the same as for polypaint, and a stroke looks the same whatever the UV layout. Front faces only: the brush never paints through a thin part onto its far side, and never on surfaces facing away from you. The mask keeps masked areas as they are, and hidden faces are never painted. Symmetry paints the mirrored side too, even where the two sides have different UV islands. Around every UV island the paint runs on a few texels into the empty space (padding), so seams don't show as thin lines when the texture is filtered or mipmapped. One stroke is one undo step. SculptForge stores only the 64x64-texel tiles the stroke touched, so undo stays light even on an 8K texture. Layer edits (new layer, fill, clear, merge, flatten, delete) also keep only the tiles they changed, and an empty or single-colour tile costs almost nothing. Only an edit that changes a whole painted layer at once, like clearing a fully painted Base, stores the full layer. Alt paints back towards white on Base, and erases on a paint layer, as with polypaint. C over the model picks the texture's colour under the cursor. Tip: Painting stays fast with big textures on big meshes: only the triangles under the brush are visited, the texels are painted on every core, and only the changed 64x64 tiles of the texture are sent to the graphics card. A big brush on a 4K texture takes a few milliseconds per dab. Memory is the limit: a 4K texture takes 64 MB per layer, an 8K texture 256 MB."},{"p":"texture-painting.html","c":"Texture painting","a":"paint-layers-on-a-texture","h":"Paint layers on a texture","t":"Tool > Paint Layers works on the texture's own stack while painting goes into the texture: new layers, blend modes, opacity, visibility, lock, Merge down, Flatten, Clear and Fill layer behave exactly as described in Paint layers. Switch to Vertex and the palette shows the polypaint layers again; the two stacks are separate."},{"p":"texture-painting.html","c":"Texture painting","a":"convert-between-polypaint-and-texture","h":"Convert between polypaint and texture","t":"Button What it does Polypaint > Texture Bakes the polypaint (all its layers, as shown) into the active texture layer. Makes a 2K texture if there is none Texture > Polypaint Sets the polypaint of every vertex to the texture's colour under it. Detail finer than the mesh is lost; vertices on a UV seam take the average of both sides Both are undoable. Polypaint > Texture is a quick way to move an existing polypainted sculpt onto a game mesh's texture after giving it UVs."},{"p":"texture-painting.html","c":"Texture painting","a":"import-and-export","h":"Import and export","t":"Export Texture... saves the texture (every visible layer composited) as a PNG. Import Texture... loads a PNG, JPEG, TGA, BMP or PSD as the SubTool's texture (it replaces the texture's layers; undoable). The image is laid on the UVs as it is, so a texture made for these UVs in another app lines up. Projects (.sfproj) save the texture with all its layers, blend modes and settings. Exporting the model writes the texture next to it as a PNG and references it, so other apps pick it up: OBJ writes a .mtl material with map_Kd; glTF/GLB embeds it as the base colour texture; USD binds a preview material that reads it; FBX and GoZ export write the PNG beside the file. See Exporting. Delete Texture removes it (undoable); painting goes back to the vertices."},{"p":"texture-painting.html","c":"Texture painting","a":"uvs-and-geometry","h":"UVs and geometry","t":"Auto UV replaces any existing UVs. If the SubTool already has a painted texture, the paint moves with it: every texel of the new layout takes the colour of the same point of the surface from the old one, for the Base and every texture layer (with their blend modes, opacity and names), and the islands get a padded border. It is one undo step: undo brings back the old UVs and the old texture exactly. Moving a 4K texture takes a fraction of a second on a million triangles (the unwrap itself takes longer; see below). The paint is resampled once, so very fine detail softens slightly (well under one texel). Subdividing, decimating, splitting and duplicating keep the UVs, so the texture stays on. Decimate leaves the vertices on UV seams in place, so the texture stays exact across seams. Keep Texture (on by default, shown under Tool > Remesh and Tool > Geometry > QRemesh when the SubTool has a texture): a voxel remesh or QRemesh builds a new surface without UVs, so SculptForge unwraps the result with Auto UV and projects the texture onto it from the old surface (each new texel takes the colour of the closest point of the old one), keeping every layer. It is part of the same undo step. It adds the time of an Auto UV of the result, so a voxel remesh of a painted SubTool runs in the background with a progress bar and Cancel. Turn it off to drop the texture instead (the status line says so). Paint finer than the new surface's detail is kept, since it lives in the texture. Merging SubTools keeps their textures: the merged SubTool gets Auto UVs and one texture (the size of the largest) holding each part's paint, with the texture layers flattened. Parts without a texture come out white. Auto UV on dense meshes: the islands are kept to about 4,000 triangles each, so a million-triangle sculpt unwraps in a quarter of a minute or so and gets a few hundred islands. UVs outside the 0-1 square (tiles, UDIMs) aren't painted. ZBrush: ZBrush paints polypaint and converts it to a texture afterwards (Texture Map > New From Polypaint). SculptForge can do both: paint the texture directly, or bake polypaint with Polypaint > Texture. Auto UV plays the part of UV Master's Unwrap."},{"p":"texture-painting.html","c":"Texture painting","a":"scripting","h":"Scripting","t":"Command What it does uv_auto Unwrap the active SubTool (xatlas); resolution=4096 packs the islands for that texture size. A painted texture moves onto the new UVs (keep_texture=false leaves it as it was) texture_create size=2048 Give the SubTool a texture (1024, 2048, 4096, 8192 or 1k...8k) and paint into it; from_polypaint=true starts from the polypaint paint_target target=texture Where painting goes: vertex or texture texture_from_polypaint Bake the polypaint into the active texture layer polypaint_from_texture Copy the texture into the polypaint texture_export path=skin.png Save the texture as a PNG texture_import path=skin.png Load an image as the texture texture_delete Remove the texture remesh, qremesh, subtool_merge_down and subtool_merge_visible keep a texture unless you add keep_texture=false. paint_fill, paint_from_cavity, paint_clear and every paint_layer_* command work on the texture while paint_target is texture. See Scripting and automation."},{"p":"layers.html","c":"Sculpt layers and blend shapes","a":"","h":"Sculpt layers and blend shapes","t":"Sculpt layers hold changes on top of the base mesh, each with its own weight: a smile, a blink, a corrective shape or a variation you want to dial in and out. Because a layer is a set of per-vertex offsets, it exports straight to game engines and DCC tools as a blend shape (morph target). This chapter covers creating, sculpting into, weighting, playing and exporting layers."},{"p":"layers.html","c":"Sculpt layers and blend shapes","a":"how-layers-work","h":"How layers work","t":"Each layer stores how far every vertex moves from the base. The shape you see is the base plus every layer times its weight. New strokes go into the active layer, or into the base mesh when Base mesh is selected. Layers belong to a SubTool: each SubTool has its own list of layers. A weight of 0 turns a layer off, 1 shows it as sculpted. Scripts can also set negative weights or weights above 1 to exaggerate a shape. Layers work on every subdivision level, like ZBrush's 3D Layers: see Layers and subdivision levels. Layers survive subdividing, decimating and LOD chains. A voxel remesh bakes them into the surface (the layers are gone afterwards). Note: Sculpt layers are not the Layer brush. The Layer brush raises the surface to a fixed height; sculpt layers are the blend-shape stack described here."},{"p":"layers.html","c":"Sculpt layers and blend shapes","a":"the-layers-sub-palette","h":"The Layers sub-palette","t":"Open Tool > Layers in the right tray. The Layers sub-palette with a base mesh and two blend shapes From top to bottom: Base mesh: select it to sculpt the base shape. One block per layer: a radio button with the layer's name (select it to sculpt into that layer), Play, X (delete) and a weight slider from 0 to 1. A name field and + Add at the bottom. The title strip shows the active layer (Layer Smile, or Layer Base)."},{"p":"layers.html","c":"Sculpt layers and blend shapes","a":"add-a-layer-and-sculpt-into-it","h":"Add a layer and sculpt into it","t":"Type a name in the field at the bottom of Tool > Layers, for example Smile or BlinkL. Click + Add (or press Enter in the field). The new layer becomes the active one. Sculpt. Every stroke goes into the layer until you select another layer or Base mesh. A layer whose weight is 0 can't be sculpted into: SculptForge tells you to raise the weight first. Tip: Name layers the way your engine or rig expects (jawOpen, BlinkL): the names become the blend shape and morph target names in exported files. For a face, Tool > Facial Shapes makes all 52 ARKit shapes for you: see Facial shapes and live face."},{"p":"layers.html","c":"Sculpt layers and blend shapes","a":"adjust-and-preview-weights","h":"Adjust and preview weights","t":"Drag a layer's weight slider to blend it in and out. Play animates the layer from 0 to 1 and back, over and over, so you can judge the motion. Click Stop to end it; the weight returns to 1. Starting a stroke also stops playback. Weights are saved with the project and used by exports that keep weights (USD writes the current weights)."},{"p":"layers.html","c":"Sculpt layers and blend shapes","a":"delete-a-layer","h":"Delete a layer","t":"Click X next to the layer. Its offsets are removed from the mesh and the base mesh becomes the active target. Deleting a layer is undoable."},{"p":"layers.html","c":"Sculpt layers and blend shapes","a":"layers-and-subdivision-levels","h":"Layers and subdivision levels","t":"With subdivision levels a layer works the way ZBrush's 3D Layers do: record it at the top level for the fine detail of an expression, and it stays with the SubTool whatever level you work on. Each layer has its own detail on every level. Step down with Lower Res (Shift+D) and a lower level shows the broad part of the layer, exactly as it would show the same strokes made in the base. Step back up and the layer is there as you recorded it, to the last vertex. Weights are shared by all levels. Turn a layer off (weight 0) or blend it at a low level and the top shows the same when you go back up; the slider and Play work at every level. Sculpt into a layer at any level. At a low level a stroke into a layer makes a broad change that the higher levels follow smoothly; the detail recorded above it stays. A layer added at a low level shows on every level above it too. Reshape the base at a low level (or turn it with the Gizmo 3D) and each layer's detail rides on the new shape: its offsets turn with the surface instead of pointing the old way. Divide carries the layers to the new level. Reconstruct Subdiv keeps them, exact at the top. Del Lower and Del Higher keep the current level's layers as they are. Deleting a layer removes it from every level. Undo steps back through strokes, level changes and divisions with their layers. Projects keep every level's layers. Exports write the current level with its layers as blend shapes, so export from the top for the game mesh; subdiv_export path=face_low.glb level=1 writes the base cage with its blend shapes instead. The tools that rebuild the mesh (Voxel Remesh, QRemesh, Decimate, Subdivide) work on the current level and drop the levels, as described in Subdivision levels; Voxel Remesh and QRemesh bake the layers into the surface."},{"p":"layers.html","c":"Sculpt layers and blend shapes","a":"export-blend-shapes","h":"Export blend shapes","t":"Format What layers become glTF / GLB (File > Export GLB..., Ctrl+E) Morph targets FBX Blend shapes USD / USDZ UsdSkel blend shapes, with their current weights Send to Unreal / Export FBX for Unreal A skeletal mesh with morph targets LOD chain Blend shapes are kept on every LOD Project (.sfproj) Everything: layers, weights and the active layer OBJ, PLY, STL The current blended shape only Importing works the other way: glTF morph targets and FBX or USD blend shapes open as sculpt layers. See Exporting. ZBrush: Layers here are close to ZBrush's 3D Layers with the slider used as a morph, and they follow subdivision levels the same way. Selecting a layer is its REC; a weight of 0 is its eye. There are no layer folders and no per-layer mask yet."},{"p":"layers.html","c":"Sculpt layers and blend shapes","a":"scripting","h":"Scripting","t":"Command What it does layer_add name=Smile Add a layer and make it active layer_set_active index=0 Choose the layer strokes go into (-1 = base mesh) layer_set_weight index=0 weight=0.5 Set a layer's weight (negative or above 1 exaggerates) layer_remove index=0 Delete a layer Layers are addressed by index, starting at 0 for the top layer. layer_add name=jawOpen; stroke points=\"0,-0.3,1 0,-0.5,1\" brush=Inflate; export_glb path=head.glb"},{"p":"layers.html","c":"Sculpt layers and blend shapes","a":"see-also","h":"See also","t":"SubTools Subdivide, remesh, decimate and LODs Exporting: glTF morph targets, FBX blend shapes, Send to Unreal"},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"","h":"Facial shapes and live face","t":"Generate Facial Shapes gives a sculpted head the 52 blend shapes Apple ARKit and Google's MediaPipe use for face capture (eyeBlinkLeft, jawOpen, mouthSmileRight and the rest), fitted to that head's own proportions. They are ordinary sculpt layers: you fix any of them by sculpting, test them with expression presets, export them as morph targets to a rig, a game engine or Blender, and drive them live, so the character makes your expressions. Tool > Facial Shapes, with the template head smiling"},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"what-you-need","h":"What you need","t":"A humanoid head (human or stylised) as the active SubTool, its face pointing at the front view (+Z) with Y up, as SculptForge's front view shows it. A bust with shoulders is fine. Separate SubTools for the eyes, teeth and tongue, if the sculpt has them (see SubTools). Nothing to download: the template head the shapes come from is built into SculptForge. To try it on a ready-made head, type new_head in the console (`): a life-size human head with a mouth and eye sockets, and its eyes as a second SubTool."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"generate-the-shapes","h":"Generate the shapes","t":"Select the head SubTool and open Tool > Facial Shapes. Click Generate Facial Shapes. It takes a second or two (more on millions of vertices). The status line says how well the template fitted: the fit error (as a share of the head's height; under 1% is good) and how much of the template's face found the sculpt. Tool > Layers now lists the 52 shapes, all at weight 0, so the sculpt looks unchanged. Generating again replaces the 52 layers (other layers stay). Undo brings back the previous ones, together with any fixes you had sculpted into them."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"options","h":"Options","t":"Symmetry: Auto makes each Left / Right pair exact mirror images when the sculpt is symmetric about X = 0; On always mirrors (a slightly asymmetric sculpt gets the average); Off keeps each side as fitted. SubTools too: also give the other SubTools the shapes they need (below)."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"how-it-works","h":"How it works","t":"SculptForge carries a template head with all 52 shapes: the ICT Face Model Light from ICT-FaceKit by the USC Institute for Creative Technologies, under the MIT licence (free for commercial work: studios can ship what it makes). Generating: Finds the face. Without landmarks it looks for the nose tip (the most forward point near the middle) and the head's height, then lines the template's face up with the sculpt's (rotation, scale and position). Wraps the template around the sculpt (non-rigid registration): the template is pulled onto the closest points of the sculpt, stiffly at first and then more and more loosely, so it takes the sculpt's shape without tearing. Transfers each shape with deformation transfer: each small piece of the template's surface moves in the shape the way it moves on the template, rebuilt on the fitted template. A wide face gets a wide smile, a long jaw a long jaw drop. Binds the sculpt to the fitted template: every vertex near the face follows the closest point of the template, so your sculpted detail (wrinkles, pores) rides along. Vertices away from the face (the back of a bust, the shoulders) don't move. Left and Right are the character's own: eyeBlinkLeft closes the character's left eye, which is on your right in the front view. That is what ARKit and MediaPipe mean."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"landmarks","h":"Landmarks","t":"If the fit goes wrong (a strongly stylised face, a head turned a lot, a bust whose shoulders stick out further than the nose), guide it with landmarks: Landmarks found on the marble bust: eye corners, nose tip, mouth corners Click Auto Landmarks to see where the automatic fit puts the eye corners, the nose tip, the mouth corners and the chin. Click Place Landmarks. The canvas asks for each landmark in turn (right eye outer corner, right eye inner corner, left eye inner, left eye outer, nose tip, right mouth corner, left mouth corner, chin): click it on the sculpt. To move one, click its dot, then its new place. Click Generate Facial Shapes. With 3 or more landmarks the fit starts from them and pulls the template's landmarks onto yours; all 8 fit best. Clear removes them (the fit is automatic again). Landmarks aren't saved with the project."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"subtools","h":"SubTools","t":"With SubTools too on, the other visible SubTools get shapes by their names: SubTool name contains It gets eye (not lash, brow or lid) the 8 eyeLook... shapes: each eye turns about its own centre (about 30 degrees sideways, 25 up or down). One SubTool may hold both eyes. teeth, tooth, gum or jaw the jaw shapes (jawOpen, jawLeft, jawRight, jawForward, tongueOut): the part below the bite moves with the lower jaw, the upper teeth stay. tongue the jaw shapes, and tongueOut pushes it out past the lips. anything else that sits on the face (brows, lashes, a beard, a moustache) the shapes that move the skin under it. SubTools that aren't on the face get none. The eyes' shapes are rotations stored as blend shapes, so halfway (weight 0.5) an eye is a little smaller than a true rotation would leave it, as with any blend-shape eye. Rigs that turn eyes with bones can ignore those shapes."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"mouth-and-eyes-what-to-expect","h":"Mouth and eyes: what to expect","t":"An open or slit mouth (the lips separate surfaces, ideally with a mouth bag behind them) opens cleanly: jawOpen drops the lower lip and the chin, mouthFunnel and mouthPucker shape the lips. A closed mouth sculpted as one continuous surface can't open: the shapes that part the lips move the lower lip and stretch the skin between the lips like a membrane. Cut the mouth first (sculpt a slit, or start from new_head, which has a mouth bag), or sculpt the fix into jawOpen. Eyelids close over the eyeballs in eyeBlinkLeft / eyeBlinkRight when the eyes are a separate SubTool. Eyes sculpted into the head's own surface (one mesh) would be pulled along by the lids: split them into their own SubTool first (Split parts). mouthClose is meant to be used with jawOpen: it closes the lips while the jaw is open (the ARKit convention). On its own it pushes the lips through each other. tongueOut: the template has no tongue shape, so on the head it opens the jaw a little; a tongue SubTool moves out."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"fix-a-shape-by-sculpting","h":"Fix a shape by sculpting","t":"The shapes are a starting point, like a rigger's first pass. To fix one: In Tool > Layers, select its layer (the radio button with its name). Set its weight to 1 (its slider here or in Tool > Layers) and the other shapes to 0 (Neutral below). Sculpt: every stroke goes into that shape. Use X symmetry for a centre shape; for a Left / Right pair, fix one and regenerate with Symmetry on only if you haven't fixed the other side yet."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"face-test","h":"Face test","t":"Under Face test: Presets show common expressions built from the shapes: Neutral, Smile, Grin, Surprise, Anger, Sad, Disgust, Fear, Blink, Wink, Kiss, Aah, Ooh, Puff, Look left, Tongue out. Preset amount sets how strongly. Eyes, Brows, Jaw, Mouth, Cheeks & nose, Tongue open a slider per shape. A slider drives the shape of that name on every SubTool (the eyes turn with eyeLookUpLeft). Neither creates undo steps. The weights are saved with the project and written to exports (as the default pose)."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"all-52-shapes","h":"All 52 shapes","t":"Each shape at weight 1 on the template head (new_head) and on a real sculpture, \"Marble Bust 01\" by Rico Cilliers (Poly Haven, CC0), straight out of Generate Facial Shapes, without any fixes: Every ARKit shape on the template head Every ARKit shape on the marble bust"},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"live-face","h":"Live face","t":"face_weights sets shape weights from a JSON object, fast enough for a live feed (30 or more calls a second): face_weights json={\"jawOpen\":0.4,\"eyeBlinkLeft\":1,\"mouthSmileRight\":0.6} It changes only the vertices those shapes move, re-uploads only those to the graphics card, makes no undo step and doesn't mark the project as changed. Names not given keep their weight; unknown names are reported. The whole face message from a phone, {\"type\":\"face\",\"t\":...,\"weights\":{...},\"head\":[...]}, works as the JSON too. On a 700,000 vertex head whose every vertex is face, a frame that changes all 52 weights takes about 9 ms on an M1 Pro (most of it updating normals); heads with a body or shoulders change only the face. The phone link points your phone's camera at your face and sends this feed, so the character makes your expressions (see the phone link's own chapter). Anything else that produces ARKit or MediaPipe blendshape weights can drive it too: a script (Scripting and automation), the MCP server or the Python module."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"takes","h":"Takes","t":"A take is a recorded face feed: the phone link saves one as JSON frames, or write your own. Load Take... plays a take on the shapes, looping (Loop), with Play / Pause. Accepted: a JSON array of face messages, an object with a \"frames\" array, or JSON Lines (one message per line); \"t\" is in milliseconds. MediaPipe's \"blendshapes\": [{\"categoryName\": ..., \"score\": ...}] works too. Bake Take turns the loaded take into keyframes at 30 frames a second, kept in the project. Exports then carry the animation: GLB as a glTF animation of the morph target weights (Blender, three.js, Unity, Godot and Unreal play it), USD as time samples of the blend shape weights (Omniverse, Maya, Houdini, Blender). FBX exports the shapes but not the animation yet. Clear Baked Take removes it. From the console: face_take_play path=take.json, face_take_stop, face_take_bake path=take.json fps=30, face_take_clear."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"export-the-shapes","h":"Export the shapes","t":"The ARKit names are kept exactly in every format: Export The shapes become Animation (baked take) GLB (File > Export) morph targets, named in extras.targetNames glTF animation of the weights USD / USDZ UsdSkel blend shapes time samples on the SkelAnimation FBX (and Send to Unreal) blend shape channels; Unreal: morph targets on a skeletal mesh not yet Blender bridge (File > Blender > Send to Blender) shape keys, at their weights, on every object not yet Each SubTool exports as its own object with its own shapes (the eyes with their eyeLook shapes, the teeth with the jaw's). Apple's ARKit, Unreal's Live Link Face and most face-capture tools drive meshes by these names directly."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"commands","h":"Commands","t":"Command What it does face_shapes_generate [landmarks=] [symmetry=auto/on/off] [subtools=true] [level=N] Generate Facial Shapes on the active SubTool face_landmarks_detect the automatic landmarks, as the JSON landmarks= takes face_weights json= set shape weights (live) face_preset name=Smile [amount=1] show a preset face_take_play path= / face_take_stop play a take in the viewport (the app only) face_take_bake path= [fps=30] / face_take_clear bake a take for export / remove it new_head a new scene with the template head and its eyes"},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"subdivision-levels","h":"Subdivision levels","t":"On a SubTool with subdivision levels the shapes are made on the lowest level with at least 20,000 vertices (level= picks another), and the levels carry them up: at the top level the shapes bend your high-level detail along instead of flattening it."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"memory","h":"Memory","t":"Each shape is a full sculpt layer: 52 shapes add about 620 bytes per vertex (on top of what the mesh itself uses), so about 620 MB on a million-vertex head. Generate on a level of a million vertices or less and let the levels carry the shapes up."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"limits","h":"Limits","t":"The fit expects a humanoid head with the face pointing at the front view. Animals and creatures (the lion bust) fit poorly or not at all; landmarks help with stylised humans. Hair sculpted as part of the head moves with the brows and forehead; keep hair in its own SubTool. Landmarks are placed by hand or found by the fit itself; there is no image-based face detector."},{"p":"subdivision-levels.html","c":"Subdivision levels","a":"","h":"Subdivision levels","t":"Subdivision levels let you sculpt one model at several resolutions, as with ZBrush's SDiv: block in the big forms on a light version of the mesh, add pores and wrinkles on a dense one, and go back down to change the silhouette without losing the detail. Every SubTool has its own levels. A cube cage, a middle level and the top level of the same sculpt Everything is in Tool > Geometry: Control Shortcut What it does Divide Ctrl+D Adds a level above the highest one and steps to it Smt Smooths the next Divide (on by default) Lower Res Shift+D Steps one level down Higher Res D Steps one level up SDiv slider Steps to any level (1 is the base cage) Del Lower Deletes the levels below the current one Del Higher Deletes the levels above the current one Reconstruct Subdiv Finds a lower level for a mesh that was subdivided elsewhere Under the buttons the palette says where you are (\"SDiv 3 of 5\") and how many triangles the base and the top have. The SubTool list shows the level of every SubTool that has them (\"SDiv 3/5\")."},{"p":"subdivision-levels.html","c":"Subdivision levels","a":"divide","h":"Divide","t":"Divide (Ctrl+D) adds a level with four times the polygons. The lower levels stay, so you can step back down at any time. Quads stay quads. A mesh with quads is divided with Catmull-Clark subdivision: each quad becomes four quads, and a triangle among them becomes three quads. A mesh of triangles only (a sphere from New Sphere, a scan) is divided with Loop subdivision: each triangle becomes four. Smt (next to Divide) smooths the new level, rounding off the shape the way ZBrush does. Turn it off to divide flat: the new level keeps the hard edges and flat faces of the one below, for hard-surface pieces. Divide always adds the level on top. If you are at a lower level it steps to the highest first. Mask, polypaint, paint layers and UVs are interpolated onto the new level; polygroups and hidden faces carry over; sculpt layers are divided with the shape. How far you can divide depends on your computer's memory: about 160 million triangles with 32 GB (each triangle of a divided model takes about 90 bytes, plus some room while dividing). Divide says so when the next level wouldn't fit. Tip: Start from a light mesh. A cube of 108 triangles divided five times is a smooth 110,000-triangle head-sized blob; a 25,000-triangle base divided four times is already 6.5 million."},{"p":"subdivision-levels.html","c":"Subdivision levels","a":"stepping-between-levels","h":"Stepping between levels","t":"Press Shift+D to step down and D to step up, or drag the SDiv slider. Each step is instant once you have visited a level; the first visit after a big edit lower down takes a moment on millions of triangles. What happens to your sculpting when you change level: Detail survives. Each level stores its detail as a small offset from the smoothed shape of the level below, measured along that surface (its normal and tangents). Stepping up and down without sculpting gives back exactly the same mesh. Big changes low, detail follows. Sculpt, move or inflate at a low level and step up: the higher levels follow the new shape and the wrinkles, pores and scales you sculpted on them ride along on top. Detail edits show up below. Sculpt at a high level and step down: the lower levels take on a softened version of the change, so the silhouette stays honest whichever level you look at. Fine detail is too small for a low level and only shows as a gentle swelling there."},{"p":"subdivision-levels.html","c":"Subdivision levels","a":"what-follows-the-levels","h":"What follows the levels","t":" When you change it at one level Shape Carried up as detail, softened down (see above) Sculpt layers Each layer has its own detail on every level, kept relative to the surface like the shape's: rotate or reshape a low level and a layer's wrinkles turn and bend with it. Weights apply to all levels. See Layers and subdivision levels Mask Copied down to the vertices below, interpolated up where it changed Polypaint and paint layers As the mask: paint at a low level for broad colour, at a high level for detail. Painting low only changes the higher levels where you painted Polygroups, hidden faces Copied down to the parent faces, inherited up by the faces they contain UVs Copied down and interpolated up Texture Shared by every level (it lives on the UVs) Clearing the mask, removing a layer or deleting the paint layers does it on every level."},{"p":"subdivision-levels.html","c":"Subdivision levels","a":"del-lower-and-del-higher","h":"Del Lower and Del Higher","t":"Del Lower deletes the levels below the current one: the current level becomes the new base cage (SDiv 1). Del Higher deletes the levels above, and the detail sculpted on them. Both are undoable. Deleting down to a single level leaves an ordinary mesh."},{"p":"subdivision-levels.html","c":"Subdivision levels","a":"reconstruct-subdiv","h":"Reconstruct Subdiv","t":"A model that was subdivided in another application (or exported from SculptForge at its top level) comes in as one dense mesh. Reconstruct Subdiv finds the mesh it was subdivided from and adds it as a new lowest level, keeping the dense mesh exactly as it was. Press it again for more levels. It works at the lowest level (SDiv 1). The mesh must be a regular subdivision: all quads from Catmull-Clark subdivision (Blender's Subdivision Surface, Maya's Smooth, ZBrush's Divide), or all triangles from Loop subdivision. Otherwise it says so and leaves the mesh alone. The vertices of the new lower level sit on the dense mesh's corner vertices, as in ZBrush. Tip: The Cube from Tool > SubTool > Append is a regular quad grid, so Reconstruct Subdiv takes it down to a 3 x 3 cube in four steps."},{"p":"subdivision-levels.html","c":"Subdivision levels","a":"undo-projects-and-exporting","h":"Undo, projects and exporting","t":"Undo (Ctrl+Z) is one step per stroke at any level, and one step per level change, so undo walks back through your strokes and level changes in the order you made them. Divide, Del Lower, Del Higher and Reconstruct are single undo steps. Steps share the levels they didn't change, so they cost little memory. Projects (.sfproj) save every level of every SubTool and open at the level you saved at. They use project format 5 (sculpt-layer detail relative to the surface), so older SculptForge versions ask you to update before opening them. Projects saved with format 4 open as before and are converted as they load. Exports and GoZ write the current level. To write another one, step to it first, or use the subdiv_export command (subdiv_export path=base.obj level=1 writes the base cage of every visible SubTool, in any export format). LODs and Send to Unreal start from the current level too. Tools that rebuild the mesh (Voxel Remesh, Decimate, QRemesh, Subdivide, Delete hidden, merging and splitting SubTools) work on the level you are on, including what you just sculpted there, and make a new mesh without levels: that level becomes the new base. The status line says so, e.g. Subdivision levels removed: SDiv 3 of 5 kept as the new base (undo restores them). Ctrl+Z brings every level back, at the level you were on. Merging and splitting SubTools can't be undone (as in ZBrush), so step to the level you want to keep first, or save before. Note: Subdivide (in Tool > Geometry, below Divide) is still there: it replaces the mesh with a denser one and keeps no levels. Use Divide unless you want exactly that."},{"p":"subdivision-levels.html","c":"Subdivision levels","a":"commands","h":"Commands","t":"Every control is a command you can run in the console, from a script or over MCP (see Scripting): Command What it does subdiv_divide smooth=true Divide; smooth=false divides flat (Smt off) subdiv_level level=2 Step to a level (1 = base) subdiv_lower, subdiv_higher Lower Res, Higher Res subdiv_delete_lower, subdiv_delete_higher Del Lower, Del Higher subdiv_reconstruct Reconstruct Subdiv subdiv_info List the levels and their triangle counts subdiv_export path=base.obj level=1 Export the visible SubTools at a level"},{"p":"subdivision-levels.html","c":"Subdivision levels","a":"speed-and-memory","h":"Speed and memory","t":"Measured on an Apple M1 Pro (Asahi Linux), a cube divided four times to 6.5 million triangles: 1.6M triangles at the top 6.5M triangles at the top Divide to the top level 0.4 s 4.3 s Step down / up between visited levels 1-4 ms 0.1-45 ms Step down right after sculpting the top 0.05-0.13 s 0.2-0.6 s Step up after reshaping the base 0.05-0.15 s 0.6 s Memory for all levels 120 MB 480 MB SculptForge keeps the two levels you visited last ready to show, so going back and forth between a low and a high level (the usual rhythm) is instant. Only the active SubTool keeps them: selecting another SubTool frees that memory (50-170 MB for a SubTool with 1.8 million triangles at the top), and the first level change after you come back takes a moment longer (about 0.1 s at that size) while the level is prepared again. ZBrush: Divide, Smt, Lower Res, Higher Res, SDiv, Del Lower, Del Higher and Reconstruct Subdiv work as in ZBrush. Not yet: Freeze SubDivision Levels, Cage, Rstr, Suv (UV smoothing on divide) and creased edges."},{"p":"dynamic-topology.html","c":"Dynamic topology","a":"","h":"Dynamic topology","t":"With Dynamic on, the brush adds triangles where it needs detail and removes them where it doesn't, as ZBrush's Sculptris Pro and Blender's Dyntopo do. Pull a sphere out into horns, ears or fingers and the new shapes get triangles of their own instead of stretched ones; block in a creature from a ball without remeshing first. A sphere with horns pulled out by Snake Hook with Dynamic on, in Polyframe and shaded"},{"p":"dynamic-topology.html","c":"Dynamic topology","a":"turn-it-on","h":"Turn it on","t":"Control Where What it does Dynamic Top shelf, Draw palette Turns dynamic topology on or off (ZBrush's Sculptris Pro button) Detail Top shelf (while Dynamic is on), Draw palette How small the triangles get: 0 coarse, 100 fine (default 50) Constant detail Draw palette Off: the size follows the brush. On: one size for the whole mesh Then sculpt as usual. Every brush works with it except Move (it drags the surface without remeshing), the mask and paint brushes, and the stamping strokes DragRect and DragDot (so VDM stamps don't remesh either). Smooth remeshes towards larger triangles, so smoothing also simplifies, as in ZBrush. Tip: Turn on PolyF (Shift+F) to see the triangles appear under the brush."},{"p":"dynamic-topology.html","c":"Dynamic topology","a":"how-big-the-triangles-get","h":"How big the triangles get","t":"By default the triangle size follows the brush size on screen, as in Sculptris Pro: zoom in or make the brush smaller for finer triangles, zoom out or make it bigger for coarser ones. At Detail 50 an edge is about an eighth of the brush radius; Detail 100 makes them about three times smaller, Detail 0 three times bigger. With Constant detail on, every stroke aims for the same size whatever the zoom and brush, set by Detail relative to the size of the mesh (at 50, about a hundredth of its bounding box diagonal). Use it to bring a whole model to an even density, or to keep the density while you change brush sizes. It is a preference: Store Config (Ctrl+Shift+I) keeps it. Under the brush, edges longer than the target are split, edges much shorter are merged away, and the new triangles are evened out. Outside the brush nothing changes, so you can have big triangles on the back of a head and fine ones around the eyes."},{"p":"dynamic-topology.html","c":"Dynamic topology","a":"what-it-keeps-and-what-it-doesnt","h":"What it keeps and what it doesn't","t":"Symmetry. With X (or Y, Z) symmetry on, both sides are remeshed together and get mirrored triangles, not just mirrored shapes. Mask and visibility. Fully masked and hidden parts are left alone. Partly masked areas are remeshed but move less, as usual. Borders. Open edges and the borders between polygroups stay where they are; their vertices only slide along them. New triangles take the polygroup of the triangle they came from. Polypaint, mask values and sculpt layers are carried onto new vertices (blended between their neighbours). Quads under the brush become triangles. The rest of the mesh keeps its quads. UVs are dropped the first time a stroke remeshes a SubTool (the status bar says so), since the new triangles have none. Undo brings them back. Unwrap again with Auto UV when you are done."},{"p":"dynamic-topology.html","c":"Dynamic topology","a":"subdivision-levels","h":"Subdivision levels","t":"Dynamic topology works on meshes without subdivision levels, as in ZBrush. On a SubTool with levels, Dynamic stays off and the status bar says why: go to the level you want to keep and use Del Lower and Del Higher in Tool > Geometry first. If you turn it on and then pick a SubTool that has levels, strokes sculpt it without remeshing. A good workflow: block in with Dynamic, then QRemesh or Voxel Remesh for an even base, Divide for levels, and sculpt the fine detail on them."},{"p":"dynamic-topology.html","c":"Dynamic topology","a":"undo-and-speed","h":"Undo and speed","t":"Each stroke is one undo step. Undo puts every triangle back exactly, and it only keeps the part of the mesh the stroke changed, so it costs little memory even on millions of triangles (a few megabytes per stroke). Dynamic topology is fastest on meshes of up to a few million triangles. On the benchmark computer (an M1 Pro), a dab with a medium brush on a one-million-triangle sphere takes 9 to 13 milliseconds including the screen update; undoing a stroke on such a mesh takes about a tenth of a second. A very big brush over very small triangles merges them over several dabs rather than all at once, to keep the brush responsive. See Performance and big meshes."},{"p":"dynamic-topology.html","c":"Dynamic topology","a":"from-a-script","h":"From a script","t":"dyntopo enabled=true detail=60 stroke points=\"0.3,0.6,1 0.5,0.4,1\" brush=SnakeHook radius=0.2 symmetry=x dyntopo enabled=false dyntopo without arguments reports the settings; constant=true switches to a constant detail size. It works the same from the console, sculptforge-cli, MCP and Python. See Scripting and automation."},{"p":"dynamic-topology.html","c":"Dynamic topology","a":"see-also","h":"See also","t":"Sculpting and brushes Subdivision levels Subdivide, remesh, decimate and LODs Coming from ZBrush"},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"","h":"Moving, rotating and posing (Gizmo 3D)","t":"The Gizmo 3D moves, rotates and scales a whole SubTool, or only the part of it you haven't masked. Use it to place parts (an eye in its socket, a sword in a hand), to fix proportions, and to pose: mask the body, put the pivot at the shoulder and swing the arm. It works like ZBrush's Gizmo 3D, with the same keys. The Gizmo 3D's Move, Scale and Rotate modes; the handle under the cursor turns yellow"},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"the-three-modes","h":"The three modes","t":"Press a key, or click the button on the top shelf (they're also in the Transform palette): Key Mode What you drag W Move An arrow moves along that axis. A square moves in its plane. The ring in the centre moves freely in the view plane E Scale A box stretches along that axis. The disc in the centre scales evenly: drag right or up to grow, left or down to shrink R Rotate A ring turns about that axis. The outer white ring turns about the view direction Q Draw Back to sculpting: brushes work again and the gizmo goes away Pressing the same key again also goes back to Draw. X is red, Y green and Z blue; the handle under the cursor turns yellow. While the gizmo is on, dragging anywhere off its handles still turns, pans and zooms the view, and Ctrl still paints the mask, so you can mask and move without leaving the gizmo. While you drag, the amount shows beside the gizmo (the distance, the angle or the percentage), and a rotation draws the swept angle as a slice. Each drag is one undo step (Ctrl+Z), and the gizmo goes back with it."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"snapping","h":"Snapping","t":"Hold Shift while dragging to snap: Rotate: 15 degree steps. Move: whole steps of the grid, a round number about a twentieth of the model's size (0.1, 0.2, 0.5, 1...). Scale: 10% steps. You can press and release Shift during the drag."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"moving-only-part-of-a-subtool","h":"Moving only part of a SubTool","t":"The gizmo respects the mask: masked parts stay where they are, partly masked parts move partly, and hidden parts never move. To move only the head of a figure, mask everything else (or paint the mask on the head and invert it with Ctrl+click on the background), then drag. Turn Mask off in the Gizmo 3D panel to move the whole SubTool whatever the mask."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"posing-a-limb","h":"Posing a limb","t":"Mask what should stay: for an arm, everything but the arm (Ctrl+paint, or MaskLasso). Press R. The gizmo jumps to the centre of the unmasked arm. Put the pivot at the joint: hold Alt and click the model at the shoulder or elbow. (Or click To Surface, then click the model.) Raise Falloff in the Gizmo 3D panel, for example to 15%. The turn then eases in over that distance from the mask's edge, so the joint bends smoothly instead of creasing along the mask line. Drag a ring. Release, then drag again to refine; each drag is its own undo step. Posing: upper arm masked, pivot at the elbow (left); the forearm turning with a 29% falloff (right) Falloff only ever eases in on the unmasked side: the masked part stays exactly where it was. It is measured along the surface, as a share of the SubTool's size, so it bends the same way on a rough model and on one with millions of polygons."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"symmetry","h":"Symmetry","t":"With X, Y or Z symmetry on (top shelf), a masked transform is mirrored: the unmasked part on the other side of the symmetry plane takes the mirror image of the move, so both arms rise together. This needs a mask and a pivot off the plane; a SubTool moved as a whole just moves."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"the-pivot","h":"The pivot","t":"The pivot is the point rotation and scaling turn about, and where the gizmo sits. It starts at the centre of what will move (the SubTool, or its unmasked part) and follows it when you change the mask or pick another SubTool. To Do this Move the gizmo without moving the model Alt+drag any Move handle Turn the gizmo's axes without turning the model Alt+drag a Rotate ring (the axes switch to Surface) Put the pivot on the surface Alt+click the model, or To Surface then click the model Type the pivot The three numbers under the mode buttons in the Gizmo 3D panel Go back to the centre, with world axes Reset After a drag the gizmo moves (and with Surface axes, turns) with what it moved."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"world-or-surface-axes","h":"World or Surface axes","t":"World keeps the gizmo's arrows and rings on the world's X, Y and Z. Surface lines them up with the surface where you put the pivot (Y along the surface normal) and turns them with your rotations, which is handy for sliding a part along itself, or for twisting a forearm about its own length."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"typing-exact-values","h":"Typing exact values","t":"The Gizmo 3D panel opens in the corner of the canvas while the gizmo is on. Under the options it has Move (X, Y, Z), Rotate (degrees about X, then Y, then Z) and Scale (percent). Type the amounts and click Apply: the model moves, turns and scales by them about the pivot, along the gizmo's axes, in one undo step. Clear sets them back to 0 and 100%. The values stay after Apply, so clicking Apply again repeats the step (rotate by 15 degrees, again, again)."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"all-subtools","h":"All SubTools","t":"Turn on All SubTools in the panel to move every visible SubTool together (ZBrush's Transpose All), for example to turn a whole character with its eyes, teeth and clothes. The pivot is the centre of all of them. Each SubTool gets its own undo step: undo goes back in the active SubTool, and selecting another SubTool undoes its part."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"what-a-transform-keeps","h":"What a transform keeps","t":"A transform only changes where the vertices are. Polygroups, quads, UVs, polypaint, textures, the mask and the topology stay as they are. Sculpt layers move with the surface: the base and every layer's offsets are transformed together, so a layer you sculpted on a forearm stays on it after posing, and layer sliders keep working. With subdivision levels you can pose at a low level: the detail of the higher levels, sculpt layers included, turns with it when you step back up. Projects save the result, and the gizmo's pivot and options too."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"scripting","h":"Scripting","t":"Every gizmo drag appears in the console as the transform command that repeats it, so Copy session as script replays your posing. You can also type it, or use it in scripts and sculptforge-cli: transform translate=0,0.5,0 transform rotate=0,0,45 pivot=1.2,0.4,0 falloff=0.15 transform scale=2 all=true Parameter Meaning translate Movement x,y,z in world units rotate Degrees about X, then Y, then Z (of orient) scale One number, or x,y,z along the axes of orient (above 0) pivot center (default: the centre of what moves), origin, or x,y,z orient world (default), or the axes as x,y,z Euler degrees masked true (default) leaves masked parts; false moves everything falloff Soft joint width as a share of the size, 0-1 (default 0) symmetry Mirror a masked transform across these planes, e.g. x all Every visible SubTool (Transpose All)"},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"speed","h":"Speed","t":"The gizmo recomputes every frame from where the drag started, touching only the vertices that move, and sends only the changed range to the graphics card. On a 1.3 million triangle model a drag frame takes about 2 ms to transform plus about 7 ms to upload, and the release about 20 to 40 ms; undo is as fast."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo 3D)","a":"see-also","h":"See also","t":"Masking SubTools Sculpt layers and blend shapes Keyboard and mouse"},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"","h":"Subdivide, remesh, decimate and LODs","t":"These tools change the topology of the active SubTool: add resolution for detail, rebuild an even surface, reduce the triangle count, or make a chain of levels of detail for a game engine. This chapter explains what each one does to your mesh and its attributes, and when to use it. All of them work on the active SubTool and, except the LOD preview, are undoable with Ctrl+Z."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"at-a-glance","h":"At a glance","t":"Tool Where Triangles Quads Keeps sculpt layers Keeps mask and polypaint Keeps polygroups, hidden faces, UVs Divide (levels) Tool > Geometry > Divide, Ctrl+D x4 per level, lower levels kept Each quad becomes four (Catmull-Clark) Yes Yes (interpolated) Yes Subdivide Tool > Geometry > Subdivide x4 per level Each quad becomes four Yes Yes (interpolated) Yes Voxel Remesh Tool > Remesh > Voxel Remesh Set by resolution All quads (new ones) Baked in Yes (transferred) No (reset); a texture is kept on new UVs with Keep Texture QRemesh Tool > Geometry > QRemesh Set by Target Polygons All quads, with edge loops Baked in Yes (transferred) Polygroups with Keep Groups; no hidden faces; a texture is kept on new UVs with Keep Texture Decimate Tool > Geometry > Decimate Reduced No, all triangles Yes Yes Yes LOD chain Tool > Export One level per ratio step LOD0 keeps them; lower levels are triangles Yes, on every level Yes Yes"},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"quads-and-triangles","h":"Quads and triangles","t":"SculptForge sculpts on triangles, but it remembers which pairs of triangles were one quad. A model you open from ZBrush (GoZ), Blender or Maya (OBJ, FBX, PLY, USD) keeps its quads: PolyF draws them as quads, without the diagonal, and OBJ, FBX, PLY, USD and GoZ exports write them back as quads, corner for corner. Polygons with more than four sides are split into triangles. The new Plane and Cube are made of quads, and so is the result of a voxel remesh. Sculpting, masking, polypaint, sculpt layers, undo, SubTools and project files all keep the quads. Subdivide turns every quad into four quads. Two things turn quads into triangles: Decimate (and the lower levels of a LOD chain) collapses edges, so its result is all triangles. When the two halves of a quad end up in different polygroups, or one half is deleted, they show and export as two triangles. glTF (.glb) and STL only hold triangles, so those exports always write triangles. ZBrush: Besides keeping the quads you bring in, SculptForge can make new ones from any mesh: QRemesh (like ZRemesher) builds quads with flowing edge loops. See Quad retopology."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"subdivide","h":"Subdivide","t":"For sculpting at several resolutions use Divide (Ctrl+D), which keeps the lower levels to step back to: see Subdivision levels. Subdivide is the one-way version. Tool > Geometry > Subdivide smooths the mesh with Loop subdivision. Each level multiplies the triangle count by four and rounds off the shape slightly, like ZBrush's Divide with Smt on. Sculpt layers are subdivided with the mesh, so blend shapes keep working. Mask, polypaint and UVs are interpolated; polygroups and hidden faces carry over. Each quad becomes four quads; triangles become four triangles. SculptForge refuses to subdivide past 50 million triangles. Note: Subdivide replaces the mesh with a denser one and drops any subdivision levels: it subdivides the level you are on, which becomes the new base, and the status line says so (undo brings the levels back). Voxel Remesh, Decimate and QRemesh do the same. To add triangles only where you sculpt, use Dynamic topology. Tip: The title strip shows the vertex and triangle counts of the whole scene. A few million triangles sculpt smoothly on a recent GPU; go up a level only when you need finer detail."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"voxel-remesh","h":"Voxel remesh","t":"Tool > Remesh > Voxel Remesh rebuilds the active SubTool as an even, watertight surface, like ZBrush's DynaMesh. Use it to: fuse overlapping pieces into one surface (append a sphere, overlap it, merge, remesh); even out stretched triangles after heavy Move or Snake Hook work; clean up scans, splat conversions and AI-generated models before sculpting. The Resolution slider next to the button sets how many voxels span the longest side of the model (64 to 400 in the palette, default 200). Higher keeps more detail and makes more triangles. Wireframe of a model before and after a voxel remesh What happens to your data: Sculpt layers are baked into the surface: the result has no layers. Mask and polypaint are transferred from the nearest original vertex. Polygroups, hidden faces and UVs are reset (everything becomes visible, one polygroup). Hidden parts are remeshed too. A painted texture is kept with Keep Texture (on by default, shown next to the button when the SubTool has a texture): the result gets Auto UVs and the texture is projected onto it, every layer included, in the same undo step. This runs in the background (Auto UV of a few hundred thousand triangles takes several seconds) with a progress bar and Cancel. Off: the texture is dropped. See Texture painting. Separate pieces that don't touch stay separate pieces; overlapping ones are merged. The new surface is made of even quads (the original's quads are rebuilt, not kept). To remesh several SubTools into one, first combine them with Merge visible... or Merge down... in SubTools. ZBrush: There is no Project option, Groups-aware remesh or Blur slider yet. Like DynaMesh, the remesh produces an even grid of quads, not flowing edge loops. For quads with edge loops that follow the forms, use QRemesh (like ZRemesher), and ProjectAll to get the detail back."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"qremesh","h":"QRemesh","t":"Tool > Geometry > QRemesh is automatic quad retopology, like ZBrush's ZRemesher: it rebuilds the SubTool as clean quads whose edge loops follow the forms, close to a target polygon count, with Keep Groups, Adaptive Size, polypaint density and symmetry. ProjectAll (Tool > SubTool > Project) brings the sculpted detail back onto the new topology after you divide it. Both have their own chapter: Quad retopology and detail projection."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"decimate","h":"Decimate","t":"Tool > Geometry > Decimate reduces the triangle count while keeping the shape, using quadric edge collapse (the same family of algorithm as ZBrush's Decimation Master). The Keep slider next to the button sets the fraction of triangles to keep (0.05 to 0.95, default 0.50). Decimation keeps open borders in place, and because it only removes vertices, every remaining vertex keeps its exact sculpt layer offsets, mask and polypaint. Polygroups, hidden flags and UVs survive on the remaining triangles. The result is all triangles: quads are not kept. Use it to make a lighter version of a finished sculpt for export, 3D printing or a review, or to bring a dense scan down to something you can work with. Tip: Decimate a duplicate SubTool (Tool > SubTool > Duplicate) when you want to keep the full-resolution sculpt in the same project."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"lod-chains","h":"LOD chains","t":"A level-of-detail chain is a series of lighter copies of the model for game engines: LOD0 is the full sculpt, and each level after it has a fixed fraction of the triangles of the one before. Open Tool > Export. Set LODs (2 to 6 levels, including LOD0) and Reduction (the triangle ratio from one level to the next, 0.1 to 0.9, default 0.50). Click Generate LOD chain. The Export sub-palette with a generated LOD chain A table lists each level with its triangle count and its budget as a percentage of LOD0. Click a level to preview it on the canvas (wireframe turns on and sculpting pauses); click Sculpt in the table to go back to the editable mesh. The next stroke, or a change to LODs or Reduction, clears the chain; click Generate LOD chain again to rebuild it. Blend shapes (sculpt layers) are kept on every level, so morph targets work at every LOD. To write the chain to disk: LOD chain (GLB per level) in the same sub-palette, or File > Export LOD Chain..., writes one GLB per level named _LOD0.glb, _LOD1.glb and so on. Send to Unreal and Export FBX for Unreal... pack the LODs into one FBX for Unreal's automatic LOD import. See Exporting for these exports and their options. Note: The preview in Tool > Export is of the active SubTool. The exports themselves build a chain for every visible SubTool."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"undo-and-safety","h":"Undo and safety","t":"Subdivide, remesh, QRemesh, decimate and delete hidden are single undo steps on the active SubTool. They can use a lot of memory on dense meshes, and undo keeps a full copy of the previous mesh for each of them. Before a big change on a heavy sculpt: QuickSave (title strip) keeps a timestamped copy of the scene without touching your project file; see Projects. Duplicate the SubTool to keep the old version side by side."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"scripting","h":"Scripting","t":"Command Options subdivide levels 1-4 (default 1) remesh resolution 32-512 voxels across the longest side (default 200); keep_texture (default true) decimate ratio 0.01-1 of the triangles to keep (default 0.5), or triangles for an exact target qremesh target quads (default 5000), adaptive, keep_groups, detect_edges, use_polypaint, symmetry, keep_original, keep_texture; see Quad retopology export_lods path (base name), levels 1-8 including LOD0 (default 4), ratio 0.1-0.9 (default 0.5) sculptforge-cli -c 'open path=scan.obj; remesh resolution=256; decimate triangles=200000; export_lods path=out/rock.glb levels=4 ratio=0.5' The command line accepts a wider remesh range (32-512) than the palette slider."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"see-also","h":"See also","t":"Quad retopology and detail projection: QRemesh and ProjectAll SubTools: merge pieces before a remesh, duplicate before a decimate Sculpt layers and blend shapes Exporting: LOD chains, FBX for Unreal, Send to Unreal Image and text to 3D: generated models are voxel-remeshed for sculpting"},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"","h":"Quad retopology and detail projection","t":"QRemesh rebuilds a sculpt as clean, all-quad topology whose edge loops follow the forms, like ZBrush's ZRemesher. ProjectAll then moves a mesh onto the surface of other SubTools, so the detail of the original sculpt comes back onto the new topology, like ZBrush's Project All. Together they turn a dense, messy sculpt (a voxel remesh, a scan, an AI-generated model) into a light quad mesh you can divide, sculpt on, unwrap and animate. A lion bust after QRemesh: 5,000 quads whose loops follow the mane, shown with PolyF"},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"the-usual-workflow","h":"The usual workflow","t":"Select the sculpt and open Tool > Geometry. Under QRemesh, turn on Keep Original. Set Target Polygons (for example 5000) and click QRemesh. It runs in the background: a progress bar replaces the button, and Cancel stops it. The result replaces the SubTool, and the sculpt as it was is kept as a hidden SubTool called \"name Original\" right below it. Divide the new mesh two or three times (Tool > Geometry > Subdivide, Ctrl+D). Show the original again (the eye in Tool > SubTool) and click ProjectAll under Tool > SubTool > Project. The divided quads snap onto the sculpt and take its polypaint. Hide or delete the original. You now have the same sculpt on clean quads. Left: the retopology of a sculpted sphere. Right: divided twice and projected, the ridges and the crease are back Both steps are single undo steps (Ctrl+Z)."},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"qremesh","h":"QRemesh","t":"Tool > Geometry > QRemesh works on the active SubTool. Control What it does QRemesh Starts the retopology. The status line reports the result, e.g. \"QRemesh: 4987 quads from 47214 triangles (100% quads) in 1.0 s\" Target Polygons About how many quads to make (100 to 200,000 on the slider, more from scripts). The result is usually within 5% of it Half / Same / Double Set the target to half, the same as or twice the SubTool's current polygon count Adaptive Size 0 makes quads all about the same size. Higher values make smaller quads where the surface curves and bigger ones on flat areas, for the same total Keep Groups Edge loops run exactly along the polygroup borders, and the result keeps the polygroups Detect Edges Hard edges, where faces meet at more than 50 degrees, get an edge loop, so boxes and bevels stay crisp (on by default) Use Polypaint Paint where you want density: red areas get up to four times the quads, blue areas down to a quarter, white areas are unchanged Symmetry Remesh one half and mirror it, welded on the seam, for exactly symmetric topology (on by default). It mirrors on the axis chosen in the Transform palette (X if none), across the model's own middle plane: the world's centre plane when the model is symmetric about it, otherwise the plane through the model's middle, so a model moved away from the centre works too. A model that isn't mirror-symmetric is remeshed whole instead, and the status line says \"Symmetry off: the model isn't mirror-symmetric\"; one that is nearly symmetric (a bump on one side) gets mirrored topology that follows each side's own surface Keep Original Keep the SubTool as it was, hidden, below the new one, ready for ProjectAll. Off: the SubTool is replaced, as in ZBrush (undo brings it back) Keep Texture Shown when the SubTool has a painted texture (on by default): Auto UV the result and project the texture onto it. Off: the texture is dropped QRemesh Guides Picks the guides brush: draw curves on the model for the edge loops to follow. See QRemesh Guides Delete Last / Clear Delete the last guide curve drawn (with its mirror copies), or all of them Curves Strength How far around each guide the edge flow follows it: 0 = only the loop on the curve, 100 = about six quads to each side (default 50) What happens to your data: The result is all quads (stored as pairs of triangles, so PolyF draws quads and OBJ, FBX, PLY, USD and GoZ export them as quads), closed wherever the sculpt is closed. Open edges of the sculpt stay open, along the same outline. Sculpt layers are baked into the surface: the result has no layers. Mask and polypaint are interpolated from the closest point of the sculpt (polypaint is blurred to the new resolution until you project it back onto a divided copy). Polygroups are kept with Keep Groups; otherwise the result is one polygroup. The old UVs are dropped. A painted texture is kept with Keep Texture (on by default): the result gets Auto UVs and the texture, every layer of it, is projected onto them from the old surface, in the same undo step. See Texture painting. Hidden parts are remeshed too. Separate pieces stay separate and none is dropped: small ones (eyes, teeth, rivets, anything that would get fewer than about 100 quads) are remeshed on their own with at least 32 quads, more for small round pieces with Adaptive Size. A piece the grid can't cover at all is kept as it was (as triangles). Thin parts (a blade, a fin, a slab thinner than a quad) keep both their sides, and with Detect Edges their hard edges keep a loop each and their corners stay put. Their corners can still be cut a little when the part is much thinner than a quad: raise the target, or use polypaint density there."},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"guiding-the-edge-flow","h":"Guiding the edge flow","t":"QRemesh Guides put an edge loop exactly where you draw: around the eyes, the mouth, a joint. See below. Polygroups are as strong a guide. Paint a group around an eye, the mouth or a muscle, turn on Keep Groups, and loops will circle it. See Polygroups. Polypaint sets the density with Use Polypaint: paint the face red and the back of the head blue to spend the quads where they matter. Adaptive Size around 0.5 gives detailed areas more quads without your help; use 0 for an even mesh, for example before more sculpting."},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"how-it-works","h":"How it works","t":"QRemesh is a field-aligned method after Instant Field-Aligned Meshes (Jakob, Tarini, Panozzo and Sorkine-Hornung, 2015). It smooths a cross field (the directions the quad edges should take) over the surface from coarse to fine, places a grid of the wanted size along it, extracts the polygons where neighbouring grid corners meet, splits every polygon into quads and relaxes them back onto the sculpt. It is fast: about 2 seconds for a 1.3-million-triangle sculpt to 5,000 quads, and 6 seconds to 100,000 quads, on a 10-core desktop. ZBrush: QRemesh Guides are ZBrush's ZRemesher Guides brush, and Curves Strength its slider of that name. Keep Groups, Use Polypaint, Adaptive Size, Half / Same / Double and symmetry work as you know them. There is no Freeze Border / Freeze Groups yet, and the mask doesn't steer QRemesh: use polypaint for density."},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"qremesh-guides","h":"QRemesh Guides","t":"Draw curves on the sculpt and QRemesh puts an edge loop along each one, and turns the flow around it to follow, like ZBrush's ZRemesher Guides brush. Use them where the topology has to work for animation: rings around the eyes and the mouth, loops around the shoulders, elbows and knees, a line down the middle of a muscle. Left: QRemesh on its own. Middle: loops drawn round the eyes and the mouth with QRemesh Guides. Right: QRemesh again, with an edge loop on every curve and rings around them Click QRemesh Guides under Tool > Geometry > QRemesh (or pick it in the brush picker, B). The cursor becomes a small ring. Drag on the model to draw a curve. It is drawn on the surface and snapped to it. A curve that ends near where it started is closed into a loop: draw round an eye and let go where you began. With symmetry on (X in the top shelf), each curve is mirrored to the other side as you draw. A curve that is its own mirror image, a loop round the mouth across the middle, is kept once. Click QRemesh. The status line says how many guides it followed. Editing the curves: Alt+click a curve to delete it (it turns red under the cursor while Alt is held), with its mirror copy. Delete Last removes the last curve drawn; Clear removes them all. Ctrl still masks and Shift still smooths while the guides brush is picked, and dragging the background still turns the view. Pick any brush to sculpt again. The guides belong to the SubTool: each SubTool has its own, they are saved in the project, and Keep Original gives the kept original a copy, so you can change them and remesh again. They show over the model, solid while the guides brush is picked and thin otherwise, so you can see the loop QRemesh put on them. Drawing and deleting guides isn't part of undo (Ctrl+Z undoes your sculpting as before). Good to know: QRemesh snaps the guides onto the sculpt as it is when you run it, so sculpting after drawing them is fine. A guide left far from the surface, for example after moving the SubTool with the Gizmo, is ignored and the status line says so: draw it again. A loop gets an even number of quads around it, so it closes cleanly. Two guides closer together than about a quad compete for the same loop; draw them further apart or raise Target Polygons. A very small loop, about 25 quads round or fewer, may not close, and the edges just outside it bend to fit the extra quads the next ring needs: raise Target Polygons. Curves Strength doesn't change the loop on the curve, only how far around it the other edges turn to follow. Lower it when guides are close to each other or to the symmetry plane."},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"how-the-guides-work","h":"How the guides work","t":"Each curve constrains QRemesh's cross field (the directions the edges take) to run along it, falling off over a few quads (Curves Strength), and adds a lattice line on the curve, so one edge loop lies on it. Along a closed curve the lattice corners are placed at even steps, an even number of them (a ring of quads round a disk always has an even number of sides), so the loop meets itself without a kink. With symmetry QRemesh remeshes one half, so a loop across the middle is cut there: its corners start on the seam, where it meets its mirror image. QRemesh then checks the loops and the quads near the guides; if a loop came out broken or a fan of seven or more edges sits by a guide, it tries again with a different start for the field and keeps the best. Measured on a sphere with a circular guide around an \"eye\", the edges near the curve are within about 2 to 8 degrees of its direction (about 22 degrees without the guide), and the loop closes."},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"projectall","h":"ProjectAll","t":"Tool > SubTool > Project > ProjectAll projects every other visible SubTool onto the active one. Each vertex looks along its normal, both ways, and moves to the nearest surface it finds within Dist; if there is none straight along the normal, it takes the closest point within Dist. Control What it does ProjectAll Projects the visible SubTools onto the active one (one undo step) Dist How far to search, as a fraction of the SubTool's size (bounding-box diagonal). Default 0.02. Raise it if parts don't pick up the detail; lower it where two surfaces are close together (lips, eyelids, fingers) PA Blur Smooths the projected result this many times, to soften noise from the source Mean Where there is surface on both sides of a vertex, settle halfway between them instead of on the nearest Geometry Project the shape (into the active sculpt layer, if you have layers) Polypaint Project the polypaint (into the active paint layer) when a source has any The mask protects: fully masked vertices don't move; partly masked ones move part of the way. Mask the areas you have already fixed and project again with a different Dist. Hidden faces of the source are ignored, and hidden parts of the target don't move. ProjectAll is fast enough to use on dense meshes: about 0.6 seconds to project 1.25 million vertices from a 1.3-million-triangle sculpt. Tip: Project after each division, not only at the end: divide once, ProjectAll, divide again, ProjectAll. Each pass starts closer to the sculpt, so a small Dist is enough and thin parts don't jump to the wrong surface."},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"scripting","h":"Scripting","t":"Command Options qremesh target (16 to 2,000,000, default 5000), adaptive (0-1, default 0.5), keep_groups, detect_edges (default true), use_polypaint, symmetry (x, y or z; off by default in scripts; the mirror plane is found from the model), symmetry_center (use this plane instead, e.g. 0 for the world's centre), keep_original, smooth (relaxation passes, default 6), seed, keep_texture (default true), guides (follow the SubTool's QRemesh Guides, default true), curves_strength (0-100, default 50) qremesh_guide points (the curve, \"x,y,z x,y,z ...\"), view (project the points onto the surface along this direction, as a stroke from the camera; default: each point to the closest surface point), symmetry (x, xz...; mirror the curve) qremesh_guide_delete_last, qremesh_guides_clear, qremesh_guides_info Delete the last curve, delete all, list them project_all distance (0.001-1, default 0.02), mean, blur (0-20), geometry (default true), polypaint (default true), source (one SubTool's name instead of all visible ones) sculptforge-cli -c 'open path=scan.glb; qremesh target=8000 adaptive=0.3 keep_original=true; subdivide levels=2; subtool_visibility index=1 visible=true; project_all distance=0.02; export_fbx path=retopo.fbx' sculptforge-cli -c 'open path=head.glb; qremesh_guide points=\"0.2,0.3,2 0.3,0.4,2 0.4,0.3,2 0.3,0.2,2 0.2,0.3,2\" view=0,0,-1 symmetry=x; qremesh target=4000 symmetry=x curves_strength=70' From scripts qremesh runs straight away (it doesn't return until it's done); in the app the button runs it in the background."},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"see-also","h":"See also","t":"Subdivide, remesh, decimate and LODs: voxel remesh first to fuse pieces, subdivide after QRemesh SubTools: show, hide and duplicate the original Polygroups and visibility: guides for Keep Groups Projects: QRemesh Guides are saved with each SubTool Texture painting: Auto UV on the new topology"},{"p":"generate-3d.html","c":"Image and text to 3D","a":"","h":"Image and text to 3D","t":"SculptForge can turn a picture or a written description into a full 3D model that you can sculpt straight away. This chapter covers the Generate 3D window, the services it can use (free Hugging Face models, your own ComfyUI server, paid fal.ai or Meshy, your own command line, or an offline blockout) and the offline image tools: relief, inflate and stamp. The Generate 3D window with a sketch loaded and the Hugging Face service selected"},{"p":"generate-3d.html","c":"Image and text to 3D","a":"how-it-works","h":"How it works","t":"You give SculptForge an image (a sketch, concept art, a photo of a figurine) or a short description. The service you picked reconstructs a complete mesh: front, back, limbs and all. SculptForge opens the result as a new scene and, unless you turn it off, voxel-remeshes it into one even, watertight surface, so the brushes behave the same as on any other sculpt. Nothing leaves your computer until you choose a hosted service and press Generate 3D model. For exactly what is sent where, see AI services and privacy below. ZBrush: ZBrush has no built-in image-to-3D. The closest workflow is blocking out a base mesh by hand with DynaMesh or ZSpheres; here you get a starting shape in seconds and refine it with the usual brushes."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"open-the-generate-3d-window","h":"Open the Generate 3D window","t":"Any of these opens it: Drop an image file (PNG, JPG, BMP, TGA, PSD or GIF) onto the SculptForge window. The image is loaded as the picture for the From image tab and the window opens. Open the Generate palette and click Generate 3D. Press F3, type generate and press Enter. The window has two tabs, From image and From text. Warning: A generated model replaces the current scene without asking, and arrives as a new, untitled scene. Save your work (Ctrl+S) before you generate."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"generate-from-an-image","h":"Generate from an image","t":"On the From image tab, click Choose image... (or drop a file onto the window). A preview and the image size appear. Pick a service in the drop-down under Full 3D model (AI reconstruction). The default is Hugging Face free models. Set the service's options (model, token or key, see below). Leave Remesh for sculpting on and set its Resolution (96 to 400, default 256). Higher keeps more detail and makes more triangles. Click Generate 3D model. A progress bar shows the queue position and progress; Cancel stops the job. When it finishes, the status line reports the triangle count before and after remeshing, for example \"Generated model imported (412000 tris, remeshed to 180000) - ready to sculpt\"."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"pictures-that-work-well","h":"Pictures that work well","t":"One character or object per image. A plain or transparent background. SculptForge crops the subject out of a transparent background, centres it on a square and scales it to at most 1024 pixels before sending it. The whole subject in frame, seen from the front or a three-quarter view. A clean concept turnaround pose works better than a busy illustration with scenery."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"generate-from-text","h":"Generate from text","t":"On the From text tab, type one object into the box, for example \"a stylised dragon head with curled horns\" or \"a cartoon fox sitting\". Pick Hugging Face - free models, fal.ai, Meshy or ComfyUI - your server. Text to 3D does not work with My generator command or Offline blockout. Click Generate 3D model. Which model runs depends on the service: Service Text-to-3D model Hugging Face Hunyuan3D 2 mini Turbo (Tencent), or Hunyuan3D 2 if you chose it in Model. Any other choice uses Turbo fal.ai Hunyuan3D 3.1 Rapid (Tencent) Meshy Meshy's own text-to-3D model ComfyUI The text workflow you choose (the bundled text-to-3d uses FLUX.1 schnell and Hunyuan3D 2.1)"},{"p":"generate-3d.html","c":"Image and text to 3D","a":"services","h":"Services","t":"Service Cost and setup Good for Hugging Face - free models Free, no account. A free token raises the daily allowance Trying things out, personal work fal.ai - paid, your key Paid per generation, needs a fal.ai key Reliable capacity, newer models Meshy - paid, your key Paid, needs a Meshy key Meshy's own models ComfyUI - your server Free, runs on your own GPU or a studio server Privacy, custom workflows, studios My generator command Free, any program you run locally Your own model or a studio service Offline blockout (inflate silhouette) Free and instant, no network Simple shapes, a quick start"},{"p":"generate-3d.html","c":"Image and text to 3D","a":"hugging-face-free","h":"Hugging Face (free)","t":"This runs each model author's own public demo on Hugging Face's shared ZeroGPU hardware. Pick a Model: Model Notes Hunyuan3D 2.1 (Tencent) The default. Detailed shapes, about 20 seconds TRELLIS.2 (Microsoft) The most detail. Needs a Hugging Face token Hunyuan3D 2 mini Turbo (Tencent) The fastest, about 6 seconds Hunyuan3D 2 (Tencent) Stable Fast 3D (Stability AI) Quick and simple, removes the background itself GPU time is rationed per person per day, there can be a queue at busy times, and a demo can be paused or changed by its owner. To raise the allowance, create a free token with read access at huggingface.co/settings/tokens and paste it into HF token (or set the HF_TOKEN environment variable). When the allowance runs out you see \"Hugging Face's free GPU time is used up for now\"; add a token, wait for it to refill, or pick another model. Warning: The Hunyuan3D models are under the Tencent Hunyuan Community License, which does not cover use in the European Union, the United Kingdom or South Korea. If you work there, choose TRELLIS.2, Stable Fast 3D or a paid service. Each model has its own licence; read it before using results commercially."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"falai-and-meshy-paid","h":"fal.ai and Meshy (paid)","t":"fal.ai: choose a Model (TRELLIS.2, Hunyuan3D 3.1 Pro, Hunyuan3D 3.1 Rapid or Meshy 6) or type any fal model id into Model id. Paste your key from fal.ai/dashboard/keys into API key, or set FAL_KEY. Meshy: paste your key from meshy.ai (API settings) into API key, or set MESHY_API_KEY. Generations are billed to your account with that service. Errors such as \"The API key was rejected\", \"Out of credits on this account\" or \"Rate limited\" come from the service."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"comfyui-your-own-server","h":"ComfyUI (your own server)","t":"Runs any ComfyUI workflow on your own computer or a studio GPU server, with whatever models it has. Nothing is sent anywhere else. Start ComfyUI. It listens on http://127.0.0.1:8188 by default. If SculptForge runs on another computer, start ComfyUI with --listen (only on a network you trust: ComfyUI has no login). Install the models your workflow needs. The bundled Hunyuan3D 2.1 workflow needs hunyuan_3d_v2.1.safetensors in ComfyUI/models/checkpoints. In Generate 3D, pick ComfyUI - your server, enter the Server address and click Test connection. A good answer looks like \"Connected: ComfyUI 0.42.0 - NVIDIA GeForce RTX 4090 (24.0 GB)\". Choose a Workflow: a bundled one, or Other file (API format)... for your own. Click Generate 3D model. The progress bar shows your place in ComfyUI's queue. Bundled workflows: Workflow Tab Needs hunyuan3d-image-to-3d From image The Hunyuan3D 2.1 checkpoint (7.4 GB) and a GPU with about 10 GB of memory text-to-3d From text FLUX.1 schnell, BiRefNet and Hunyuan3D 2.1 (about 25 GB of downloads) and a GPU sculptforge-inflate From image The ComfyUI-SculptForge node pack; no GPU. A quick blockout to check your setup Your own workflows must be saved in ComfyUI's API format (in ComfyUI: Workflow > Export (API)). To tell SculptForge where the inputs go, give nodes these titles: Node title What SculptForge does sf_image Puts the uploaded picture into this Load Image node. Without one, the first Load Image node is used sf_prompt Puts your description into this node's text, prompt or string input. Without one, the first CLIP Text Encode not titled \"negative\" is used sf_seed Sets the seed. Inputs named seed or noise_seed get it too SculptForge imports the first mesh file the workflow saves (Save GLB, Preview 3D and most 3D node packs work). For error messages and their fixes, see Troubleshooting."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"my-generator-command","h":"My generator command","t":"Runs any command line on your computer: a local open-source model, a studio service, or a script that calls a cloud API. Type the command into the box. It must contain {input} (replaced with the image path) and {output} (replaced with the path to write, ending in .glb). Both are quoted for you, so don't add quotes. The command must write a GLB file to {output} and exit with status 0. The box starts with a command that runs SculptForge's own silhouette inflation, which is a quick way to check that the pipeline works: sculptforge-cli --set input={input} --set output={output} -c 'image_inflate path=$input subdivisions=2; export_glb path=$output' A wrapper for your own model can be as small as this: # my_generator.py {input} {output} import sys image_path, output_path = sys.argv[1], sys.argv[2] # load your model, run it on image_path, write a .glb to output_path Keep API keys in environment variables that your script reads, not in the command line."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"offline-blockout","h":"Offline blockout","t":"Offline blockout (inflate silhouette) inflates the outline of the picture into a rounded, closed mesh. It is instant and needs no network, but it is a puffy blockout, not a reconstruction: fine for simple shapes, not for characters."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"save-your-settings","h":"Save your settings","t":"Save settings (the small button under Generate 3D model) stores the service, model, keys, token, ComfyUI address and generator command in your ai.json settings file, so they are set the next time you start SculptForge. Keys in ai.json are readable only by your user account. See where settings live."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"quick-shapes-from-an-image-offline","h":"Quick shapes from an image (offline)","t":"The From image tab also has three offline tools under Quick shapes (offline). They need no network and run instantly. The same tools are in the Generate palette as Relief, Inflate and Stamp. Tool What it makes Settings Silhouette blockout > Inflate A rounded, closed base mesh from the outline. Replaces the scene Thickness (0.2 to 2, lower is flatter), Detail (64 to 384) Relief > Make relief A height-field relief: light areas rise. For logos, coins, emblems, height maps and texture photos. Replaces the scene Depth (0.01 to 0.5 of the width), Detail (64 to 1024), Dark is high Stamp onto model > Stamp from this view Projects the image onto the current model from the current view as surface detail, into the active sculpt layer Depth (0.001 to 0.1 of the model size), Dark is high Tip: Stamp writes into the active sculpt layer, so add a layer first (Tool > Layers) if you want to dial the detail in and out afterwards. See Layers and blend shapes."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"after-generating","h":"After generating","t":"Generated meshes are a starting point. A typical next pass: Check the size of the remeshed result in the title strip (Verts, Tris). If the detail is too soft, generate again with a higher Resolution, or run Tool > Remesh > Voxel Remesh at a higher value on the result. Turn on X symmetry if the subject is symmetrical, and sculpt the forms with Clay Buildup, Move and Dam Standard (Sculpting and brushes). Save a project (Ctrl+S): generated scenes start untitled."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"from-scripts-and-agents","h":"From scripts and agents","t":"The same services are available as commands, in the console, sculptforge-cli, Python and MCP agents: # free (Hunyuan3D 2.1 on Hugging Face) sculptforge-cli -c 'image_to_3d path=hero.png; export_glb path=hero.glb' # TRELLIS.2 with a Hugging Face token HF_TOKEN=hf_... sculptforge-cli -c 'image_to_3d path=hero.png model=trellis-2; export_glb path=hero.glb' # fal.ai, keeping the raw (not remeshed) result FAL_KEY=... sculptforge-cli -c 'image_to_3d path=hero.png service=fal model=fal-ai/trellis-2 remesh=false; export_glb path=hero.glb' # text to 3D on your own ComfyUI, repeatable with a seed sculptforge-cli -c 'text_to_3d prompt=\"a carved stone owl\" service=comfyui url=http://gpu-box:8188 seed=42; export_usd path=owl.usdz' # is the ComfyUI server up? sculptforge-cli -c 'comfyui_check' # offline tools sculptforge-cli -c 'image_relief path=logo.png depth=0.08; export_stl path=logo.stl' sculptforge-cli -c 'image_inflate path=sketch.png thickness=0.7; save_project path=blockout.sfproj' Command Key parameters image_to_3d path (required), service (huggingface, fal, meshy, comfyui, command, inflate), model, workflow, url, seed, remesh (default true), resolution (64 to 512, default 256) text_to_3d prompt (required), service (huggingface, fal, meshy, comfyui), model, workflow, url, seed, remesh, resolution image_relief path (required), depth (default 0.12), resolution (default 384), invert image_inflate path (required), thickness (default 1), resolution (default 160), subdivisions (default 1) image_project path (required), depth (default 0.03), invert. Projects from the front (+Z) comfyui_check url Without service=, commands use the settings you saved in the app. See Scripting and automation."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"privacy-and-model-licences","h":"Privacy and model licences","t":"SculptForge has no servers of its own and no telemetry. A hosted service receives only the prepared image (or your text) and your key or token, if any. The free Hugging Face option runs the model authors' own demos; SculptForge does not host or bundle any model. Each model has its own licence: TRELLIS.2 is MIT; Hunyuan3D models use the Tencent Hunyuan Community License (not for use in the EU, UK or South Korea); Stable Fast 3D uses the Stability AI Community License (free under US $1M annual revenue). Read the licence before commercial use. With ComfyUI, the picture goes only to the server address you entered. The full table of what is sent where is in docs/ai-services.md in the SculptForge repository."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"see-also","h":"See also","t":"Sculpting and brushes: refine the generated model Subdivide, Remesh, Decimate and LODs: voxel remesh in detail Gaussian splats: start from a phone capture instead of a picture Scripting and automation: batch generation from the command line Troubleshooting: quota and connection messages"},{"p":"splats.html","c":"Gaussian splats","a":"","h":"Gaussian splats","t":"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. A splat capture loaded next to the sculpt, with the Splats palette in the right tray To make a splat yourself from a phone video or photos, see Scan an object into a splat."},{"p":"splats.html","c":"Gaussian splats","a":"supported-files","h":"Supported files","t":"Format Open Save PLY (standard 3D Gaussian Splatting layout, spherical harmonics up to degree 3) Yes Yes .splat (compact web-viewer format) Yes Yes glTF / GLB with KHR_gaussian_splatting Yes Yes OpenUSD .usda / .usdz with a ParticleField3DGaussianSplat prim Yes Yes A PLY file can hold either a mesh or splats; SculptForge tells them apart by their contents."},{"p":"splats.html","c":"Gaussian splats","a":"load-a-capture-as-a-reference","h":"Load a capture as a reference","t":"Open the capture with File > Open... (Ctrl+O), drop it onto the window, or double-click it in the LightBox Splats tab. The splats load next to your sculpt: the current mesh stays, and the capture is drawn around it as a reference. The Splats palette moves into the right tray by itself, and a Splats button appears on the right shelf to show or hide the capture. Most captures arrive upside down, off-centre and at an arbitrary scale. Use the buttons in the Splats palette to place them: Button What it does Flip Turns the capture upside down (180 degrees about X). Most captures need this Turn 90 Turns it 90 degrees about the vertical axis Fit Centres it at the origin and scales it to the size of a new sphere Clean floaters Removes faint splats and stray outliers around the subject The palette also shows the number of splats and their spherical-harmonic degree (for example \"1250000 splats (SH 3)\"), and has: Show and Show mesh to show or hide the capture and the sculpt. An opacity slider (0.05 to 1) to see the sculpt through the capture. Tip: To sculpt a character over a scan, lower the opacity to about 0.4, turn on X symmetry and block in the forms on a sphere or a converted mesh with Clay Buildup and Move."},{"p":"splats.html","c":"Gaussian splats","a":"make-a-capture-sculptable","h":"Make a capture sculptable","t":"Make sculptable (under From scan in the Splats palette) turns the capture into a clean SubTool 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's colours. The splats stay, hidden. It has its own chapter: From scan to sculptable mesh."},{"p":"splats.html","c":"Gaussian splats","a":"turn-a-sculpt-into-splats","h":"Turn a sculpt into splats","t":"Sculpt to splats (in the Splats palette when no splats are loaded, or from the command palette) covers the visible SubTools 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. From a script you can choose the number of splats and whether to bake shading: sculptforge-cli -c 'open path=bust.glb; mesh_to_splats count=500000 shading=true; splat_save path=bust.ply'"},{"p":"splats.html","c":"Gaussian splats","a":"save-splats","h":"Save splats","t":"Click Save splats... in the Splats palette, or File > Save Splats.... Choose the format by the file type: PLY (for SuperSplat, Postshot and most tools), glTF (.glb with KHR_gaussian_splatting) or OpenUSD (.usda / .usdz). The splat_save command also writes .splat. Placement you made with Flip, Turn 90 and Fit 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. When you export USD (File > Export USD / USDZ...) with splats loaded, they are included in the same file as a ParticleField3DGaussianSplat prim next to the meshes. Projects (.sfproj) keep loaded splats and their placement. Clear in the Splats palette removes the capture."},{"p":"splats.html","c":"Gaussian splats","a":"from-scripts","h":"From scripts","t":"Command What it does Key parameters open Loads a capture as a reference next to the sculpt path splat_info Reports the loaded splats splat_transform Rotates and places the capture rotate_x, rotate_y, rotate_z (degrees), fit, reset splat_clean Removes faint splats and floaters min_opacity (default 0.05), keep (0.5 to 1, default 0.98) splat_to_mesh Make sculptable: a new SubTool with quads, face loops and colour (details) detail (default 256), preset (game, film, sculpt), color (polypaint, texture, none), crop, face_guides splat_test_capture Loads a built-in test capture (a head or a mug) kind mesh_to_splats Turns the visible SubTools into splats count (default 250000), shading (default true) splat_save Saves .ply, .splat, .glb, .usda or .usdz path splat_clear Removes the splats A complete phone-capture-to-game-asset pipeline: sculptforge-cli -c 'open path=scan.ply; splat_transform rotate_x=180 fit=true; splat_to_mesh preset=game color=texture; export_glb path=asset.glb' To render only the splats headless, use sculptforge scan.ply --render scan.png --hide-mesh (see Scripting and automation)."},{"p":"splats.html","c":"Gaussian splats","a":"see-also","h":"See also","t":"From scan to sculptable mesh: Make sculptable in detail Image and text to 3D: another way to get a base mesh Subdivide, Remesh, Decimate and LODs: clean up a converted mesh Exporting: USD and glTF exports that carry splats"},{"p":"scan-to-splat.html","c":"Scan an object into a splat","a":"","h":"Scan an object into a splat","t":"Walk around a clay maquette, a prop or a toy with your phone, and SculptForge turns the video or photos into a Gaussian splat in the viewport. You watch it sharpen while it trains, and you can orbit around it the whole time. From there you can sculpt against it, make it sculptable, or save it for a splat viewer or a game engine. Nothing is uploaded: everything runs on your own computer."},{"p":"scan-to-splat.html","c":"Scan an object into a splat","a":"what-you-need","h":"What you need","t":"A phone or a camera. Any phone that films 1080p or better works. You don't need a special app. A graphics card. Training runs on the GPU: NVIDIA, AMD or Intel on Windows and Linux, or an Apple silicon Mac. No CUDA is needed. A gaming GPU trains a Fast preview in a few minutes. Three free tools, which SculptForge runs as separate programs: Tool What it does How you get it Brush (Apache-2.0) Trains the splat SculptForge offers to download it the first time (about 45 MB on Linux and macOS, 160 MB on Windows) COLMAP (BSD) Works out where each photo was taken Windows: offered as a download (128 MB). Linux: your distribution's colmap package. macOS: brew install colmap ffmpeg Reads frames from a video Usually installed already; Linux: the ffmpeg package, macOS: brew install ffmpeg Captures from the SculptForge phone link that carry the phone's own camera positions, and COLMAP or nerfstudio datasets, don't need COLMAP. Photo folders don't need ffmpeg."},{"p":"scan-to-splat.html","c":"Scan an object into a splat","a":"capture-tips","h":"Capture tips","t":"The capture decides the quality far more than the settings do. Pick a matte object. Clay, wood, stone, painted plastic and fabric scan well. Shiny metal, glass, mirrors, water and see-through plastic don't: the trainer can't tell reflections from surface. Avoid thin and fuzzy parts such as hair, fur, wire, antennas and leaves, or expect them to come out soft. Use even, soft light. An overcast day, a room with daylight from several windows, or two lamps bounced off the walls. Avoid hard shadows, and don't move the lights or let your own shadow fall on the object. Give it texture. A plain white object on a plain white table is hard to place; put it on a patterned cloth or a newspaper. Walk all the way around. Keep the object in the middle, filling about half the frame. Go round once at eye level and once a little higher, looking down. Every part of the object should be seen from several sides. Move slowly and smoothly. Each view should overlap the last by about two thirds. Blurred frames are dropped automatically, but a capture that is blurred everywhere can't be fixed. Keep the object still, and don't use a turntable: the background would not turn with it. Length: a 20 to 60 second video, or 40 to 150 photos."},{"p":"scan-to-splat.html","c":"Scan an object into a splat","a":"train-a-splat","h":"Train a splat","t":"Open the Splats palette (the Splats menu, or press F3 and type \"train\"). Under Train from capture, pick a preset: Fast preview or Quality. Click Video... and pick the video, or Photos Folder... and pick the folder of photos. You can also drop a video file onto the window. Captures sent from the phone link start by themselves. The first time, a window asks to download Brush. It says what it downloads, from where and how big it is; nothing is downloaded until you click Download Brush. The download is checked against its SHA-256 checksum before it is used. If you already have Brush, click Choose Brush... instead. Training then runs in the background, in three stages: Stage What happens Frames A video is read at 5 frames a second and the sharpest frame of each moment is kept (80 for Fast preview, 200 for Quality). Photos are used as they are Camera positions COLMAP finds where each photo was taken (skipped when the capture already knows) Training Brush trains the splat. Every few hundred steps the viewport shows the latest result The panel over the viewport shows the step, the quality so far, how long it has run and roughly how long is left: PSNR compares the splat with photos it was not trained on, in decibels. Under 18 is rough, 22 to 26 is good and over 26 is sharp. A PSNR that stops rising means more training won't help much. Good enough - stop ends training and keeps what it has learned so far as the result. Cancel ends training and saves nothing. You can orbit, pan and zoom while it trains. While the splat trains, the sculpt is hidden so the splat isn't inside it; tick Show mesh in the Splats palette to bring it back."},{"p":"scan-to-splat.html","c":"Scan an object into a splat","a":"presets","h":"Presets","t":"Preset Steps Image size Frames from a video Colour Fast preview 5,000 up to 1024 px 80 simple view-dependent colour (SH 1) Quality 30,000 up to 1920 px 200 full view-dependent colour (SH 3) Start with Fast preview to check the capture, then train Quality from the same capture."},{"p":"scan-to-splat.html","c":"Scan an object into a splat","a":"where-the-result-goes","h":"Where the result goes","t":"The finished splat is saved as a PLY next to the capture: for a folder: /splat/.ply for a video: -splat/.ply beside the video A copy goes into the Splats tab of the LightBox, so you can open it again later. The work folder beside the result holds the frames, the camera positions and the logs (brush.log, colmap.log); you can delete it. The splat comes in centred and upright: SculptForge uses the camera positions to put the object at the middle of the scene with the cameras' \"up\" pointing up. Use Flip, Turn 90 and Fit in the Splats palette if it still needs a turn. Then: Make it sculptable. Lower the opacity and sculpt against it as a reference. Save splats... to .ply, .splat, .glb or .usdz for other apps."},{"p":"scan-to-splat.html","c":"Scan an object into a splat","a":"tools-and-settings","h":"Tools and settings","t":"The Tools section of Train from capture shows which tools were found. SculptForge looks for each one in this order: An environment variable: SCULPTFORGE_BRUSH, SCULPTFORGE_COLMAP or SCULPTFORGE_FFMPEG (the full path of the program). Studios can point every workstation at a shared, approved build this way. The program chosen with Choose Brush... or Choose COLMAP.... A download made by SculptForge, in the tools folder of SculptForge's settings folder. brush_app, colmap and ffmpeg on the PATH. There is no ready-made Brush for Linux on ARM (for example Asahi Linux on an Apple silicon Mac) or for Intel Macs. Build it from its source with Rust (cargo build --release in a Brush checkout) and choose the brush_app it builds."},{"p":"scan-to-splat.html","c":"Scan an object into a splat","a":"from-the-command-line","h":"From the command line","t":"splat_train works in scripts, sculptforge-cli, Python and the MCP server. There it waits until training has finished, then loads the result: sculptforge-cli -c \"splat_train source=walkaround.mp4 preset=fast; splat_save path=walkaround.glb\" Parameter Meaning source A video, a folder of photos, a phone-link capture folder, or a COLMAP / nerfstudio dataset out Where to put the result and the work files (default: next to the capture) preset fast or quality In the app, splat_train starts training in the background and splat_train_cancel stops it (splat_train_cancel finish=true is Good enough - stop)."},{"p":"scan-to-splat.html","c":"Scan an object into a splat","a":"captures-with-camera-positions","h":"Captures with camera positions","t":"A capture folder can say where every photo was taken, which skips COLMAP. The phone link writes this in its capture.json; other tools can too: {\"kind\": \"splat\", \"device\": \"...\", \"files\": [\"IMG_0000.jpg\", \"...\"], \"fl_x\": 1450, \"w\": 1920, \"h\": 1440, \"frames\": [{\"file\": \"IMG_0000.jpg\", \"transform_matrix\": [[...], [...], [...], [0, 0, 0, 1]]}]} transform_matrix is the camera-to-world transform, row by row, with the camera looking down its -Z axis and +Y up (the OpenGL and nerfstudio convention, the same as ARKit and WebXR). fl_x, fl_y, cx, cy, w and h are in pixels and can also be given per frame. Folders that already contain a COLMAP model (images and sparse/0) or a nerfstudio transforms.json are trained as they are."},{"p":"scan-to-splat.html","c":"Scan an object into a splat","a":"if-it-goes-wrong","h":"If it goes wrong","t":"\"COLMAP could not place the cameras\": too few views overlap, the photos are blurred, or the object is shiny or plain. Capture again more slowly, with more texture around the object. The details are in work/colmap.log. \"Brush stopped with an error\": often the graphics card ran out of memory. Try Fast preview, close other GPU-heavy programs, or update the graphics driver. The details are in work/brush.log. The splat is cloudy or full of floaters: train Quality, then use Clean floaters. Shiny and see-through parts stay cloudy whatever you do. Only part of the object came out: the other side wasn't seen from enough angles. Walk around again."},{"p":"scan-to-sculptable.html","c":"From scan to sculptable mesh","a":"","h":"From scan to sculptable mesh","t":"A Gaussian-splat capture looks great but you can't sculpt, rig or animate it. Make sculptable turns it into a clean SubTool you can: a watertight surface with the floaters and background gone, quad topology at the polygon budget you choose, edge loops round the eyes and mouth when the capture is a head, and the capture's colours as polypaint or a texture. One click, in the background, with the splats kept next to the result. A test head capture, the review of its face landmarks and loops, and the finished quads with its colours"},{"p":"scan-to-sculptable.html","c":"From scan to sculptable mesh","a":"one-click","h":"One click","t":"Load a capture (see Gaussian splats): File > Open... or drop a .ply, .splat, .glb or .usdz onto the window. Place it with Flip, Turn 90 and Fit if it arrives upside down. For a head, turn the view so you look at the face, roughly from the front (within about 40 degrees is enough). The face is looked for from the current view. In the Splats palette, under From scan, click Make sculptable. A progress bar and Cancel show while it works. When it's done: a new SubTool named after the capture holds the sculptable mesh, and is active; a hidden \" Scan\" SubTool keeps the dense voxel surface it was made from (turn off Keep scan if you don't want it); the splats are hidden, not deleted (Show in the Splats palette brings them back); an untouched starting sphere is hidden too. No capture at hand? Try a test head in the Splats palette (shown while no splats are loaded) loads a built-in one: a stylised head as 200,000 coloured splats with a few floaters and the hidden inside splats real captures have. splat_test_capture kind=object loads a mug with a thin handle instead. The From scan section of the Splats palette"},{"p":"scan-to-sculptable.html","c":"From scan to sculptable mesh","a":"the-options","h":"The options","t":"Control What it does Detail How finely the surface follows the capture, in voxels across the subject (96 to 512, default 256). Higher keeps thinner parts and more detail and takes longer Game / Film / Sculpt The polygon budget. Game: about 4,000 quads, for real-time characters and props. Film: about 12,000 quads, for close-ups and smooth deformation. Sculpt: a 2,000-quad base with two subdivision levels, the scan's detail projected onto the top level, so you sculpt with levels straight away Face loops When the capture is a head: find the eyes, nose, mouth and chin and give QRemesh edge loops round the eyes and mouth and along the nasolabial folds, mirrored across the face (see below) Review Stop after the scan to check the face landmarks and the loops before remeshing Polypaint / Texture Where the capture's colours go: the vertices (polypaint), or a 2K texture on automatic UVs (sharp colour on a light mesh, for games and exports) Keep scan Keep the dense voxel surface as a hidden \" Scan\" SubTool, to ProjectAll more detail from later Crop Box Only the splats inside the box count (see below) More > Min Opacity Splats fainter than this are ignored (haze and floaters are usually faint). Default 0.2 More > Close Gaps Seal gaps up to this many voxels between splats. Default 2 More > Fill holes Fill big holes such as the open bottom of a subject that stood on a table. Turn it off for open cavities like a cup More > All pieces Keep every solid piece instead of only the largest (the floaters come back too) Hold Ctrl and point at any of them for help; F3 finds Make sculptable, Finish, Place by hand and Crop Box by name."},{"p":"scan-to-sculptable.html","c":"From scan to sculptable mesh","a":"face-loops-animation-topology-for-heads","h":"Face loops: animation topology for heads","t":"Faces deform around the eyes and the mouth, so animation topology has rings of edges there and a loop from the nose down past the mouth corners (the nasolabial fold), the same on both sides. With Face loops on, Make sculptable looks for a face on the scan as seen from the current view: a depth and colour picture of it, the middle line where it is mirror-symmetric, the nose as the strongest bump on that line, the eyes as a matching pair of hollows (and darker spots) above it, the line between the lips below it, then the chin. From those eight landmarks (the corners of both eyes, the nose tip, the mouth corners, the chin) it draws QRemesh Guides for QRemesh to follow: a ring round each eye, and a bigger one round the eye socket when the polygon budget is high enough for it; a ring round the lips; the nasolabial loop: from each side of the nose down the fold past the mouth corner and under the lower lip; all of them mirrored across the face, and QRemesh's symmetry on, so both halves get the same edge flow. The guides stay on the result SubTool, so you can QRemesh it again at another density (Geometry > QRemesh) and the loops come back. Small loops are left out at low budgets, where they couldn't come out as clean rings. If no face is found (the status bar says why), the result is remeshed without face loops. Turn the view to face the head and run it again, or use Review and place the landmarks by hand."},{"p":"scan-to-sculptable.html","c":"From scan to sculptable mesh","a":"review-and-nudge-the-landmarks","h":"Review and nudge the landmarks","t":"With Review on, Make sculptable stops after the scan: the \" Scan\" SubTool shows with the landmarks as blue dots and the guide loops as orange lines. Drag a dot to move a landmark onto the right spot. Its partner on the other side follows (mirrored), and the loops are rebuilt when you let go. Place by hand asks for the eight landmarks one click at a time (the panel and the cursor say which is next): the outer and inner corner of the eye on the left of the screen, the inner and outer corner of the other eye, the nose tip, the left and right mouth corners, the chin. Find again looks for the face again from the current view. Finish remeshes the scan along the loops and colours it; Back leaves the review and keeps the scan."},{"p":"scan-to-sculptable.html","c":"From scan to sculptable mesh","a":"the-crop-box","h":"The crop box","t":"Captures usually include the ground, a table or the room. Make sculptable keeps only the largest solid piece, which drops floaters, but a table the subject stands on is joined to it. Click Crop Box: a yellow box appears round the capture with a handle on each face. Drag a handle to move that face (drag the bottom one up to cut the table away), then Make sculptable: only the splats inside the box count. The box shows while the splats are shown; click Crop Box again to turn it off."},{"p":"scan-to-sculptable.html","c":"From scan to sculptable mesh","a":"what-happens-inside","h":"What happens inside","t":"Surface. Every Gaussian adds its opacity-weighted density to a voxel grid (in parallel, with the same result on any number of threads). Where the density is high enough is the shell of the subject; small gaps close, small separate pieces of shell (floaters) are dropped, and space boxed in by the shell on five of six sides counts as inside, which seals big holes such as an open bottom. The outside is flooded from the edges, the largest solid piece is kept, and a smooth watertight surface is made from it. Colour. Each vertex (or texel) takes the colour of the splats around it, weighted by their opacity and distance. Splats behind the surface, inside the subject, are faded out: trained captures fill the inside with splats of any colour. Topology. QRemesh rebuilds the scan as quads at the budget's polygon count, along the face guides, with symmetry. Sculpt then divides it twice and projects the scan onto the top level (as ProjectAll does)."},{"p":"scan-to-sculptable.html","c":"From scan to sculptable mesh","a":"speed","h":"Speed","t":"Measured on an M1 Pro laptop (10 cores, 2021) with the built-in test head at Film density, from click to the finished SubTool: Splats Detail 256 Detail 384 Detail 512 Peak memory (512) 1 million 3.4 s (surface 1.3 s) 5.5 s (surface 2.6 s) 8.8 s (surface 5.1 s) 1.0 GB 5 million 7.2 s (surface 4.2 s) 9.1 s (surface 5.6 s) 13.2 s (surface 8.0 s) 1.2 GB The rest of the time is QRemesh and colour. Everything runs on the CPU, so a studio PC with more cores is faster; no GPU or CUDA is needed."},{"p":"scan-to-sculptable.html","c":"From scan to sculptable mesh","a":"how-good-is-it","h":"How good is it?","t":"What works well: Watertight, manifold surfaces every time (no holes, no non-manifold edges), with floaters and stray background pieces dropped and open bottoms sealed. Faithful colour: on test captures with known colours the transferred polypaint is within a few percent of the original, and the wrongly coloured splats inside the subject don't bleed through. Clean quads (97% or more) with symmetric rings round the eyes and mouth on faces it finds. Thin parts survive down to a few voxels across (a mug handle at Detail 160 stays a handle, its hole open). What to expect: The scan has a fine ripple (voxel-scale, a little like orange peel) where the capture's splats are sparse; the quad result smooths it out, but the Sculpt preset projects it onto the top level, where the Smooth brush takes it away. The surface sits about a voxel outside the splats (the shell's thickness). Raise Detail to make that smaller. The face finder works from geometry and colour, not a trained model: it is reliable on clear faces seen from the front (busts, maquettes, game heads) and can miss on heavily stylised faces, closed-eye or beard-covered ones, profiles, or a head that isn't upright in the view. Then use Review and Place by hand. Fill holes also fills deep open cavities (the inside of a cup, an open mouth); turn it off for those. Hair and fur become a solid shell, as with any surface reconstruction. Splat captures carry view-dependent colour; Make sculptable uses the base colour of each splat (no reflections or highlights baked in), which is what you want for a sculpt."},{"p":"scan-to-sculptable.html","c":"From scan to sculptable mesh","a":"from-scripts","h":"From scripts","t":"The same pipeline runs from the console, sculptforge-cli, MCP and Python: Command What it does Key parameters splat_to_mesh Make sculptable detail (32 to 768, default 256; resolution is the same), preset (game, film or sculpt), target (quads; 0 keeps the voxel surface), levels, face_guides (auto or off), landmarks (JSON, instead of finding them), front, up (the face's directions, default \"0 0 1\" and \"0 1 0\"), color (polypaint, texture or none), texture_size, crop (\"minx miny minz maxx maxy maxz\"), min_opacity, keep, close, fill_holes, keep_parts, smooth, symmetry, keep_scan, stage (all, scan or finish), seed face_guides Finds a face on the active SubTool (or takes landmarks) and replaces its QRemesh Guides with the face loops; the message ends with the landmarks as JSON landmarks, front, up, target splat_test_capture Loads the built-in test head or mug capture kind (head or object), count, floaters, open_bottom # A scan to a textured game asset, in one go. sculptforge-cli -c 'open path=bust.ply; splat_transform rotate_x=180 fit=true; splat_to_mesh preset=game color=texture; export_glb path=bust.glb' # The app's review in two steps: the scan with its face guides (the message lists the landmarks found), then the # quads along those guides. sculptforge-cli -c 'open path=head.ply; splat_to_mesh stage=scan preset=film; splat_to_mesh stage=finish preset=film; export_glb path=head.glb' To correct the landmarks from a script, run face_guides between the two stages with landmarks= set to the JSON the scan stage printed, edited: {\"eye_outer_l\": [x, y, z], \"eye_inner_l\": [...], \"eye_inner_r\": [...], \"eye_outer_r\": [...], \"nose_tip\": [...], \"mouth_l\": [...], \"mouth_r\": [...], \"chin\": [...]} (l is the side on the left of the screen when looking at the face). Each run in the app is echoed to the console as a splat_to_mesh line (with the landmarks when you reviewed them), so you can copy it into a batch script."},{"p":"scan-to-sculptable.html","c":"From scan to sculptable mesh","a":"see-also","h":"See also","t":"Gaussian splats: loading, placing and saving captures Quad retopology and detail projection: QRemesh, QRemesh Guides and ProjectAll Subdivision levels: sculpting the Sculpt preset's levels Texture painting: painting on the Texture result"},{"p":"phone-capture.html","c":"Phone capture and AR","a":"","h":"Phone capture and AR","t":"Your phone becomes SculptForge's camera and second screen. Scan an object by walking around it, send a photo to turn into a model, bring in a splat from a scanning app, look at your sculpt standing on your real desk in AR, and drive a character's face with your own. There is no app to install and no account: the phone's browser talks to SculptForge over your Wi-Fi."},{"p":"phone-capture.html","c":"Phone capture and AR","a":"pair-your-phone","h":"Pair your phone","t":"Choose File > Capture from phone (or the phone button in the LightBox's header). A window opens with a QR code. Point the phone's camera at the QR code and tap the link it shows. The capture page opens, already paired with this window: the badge at its top shows your computer's name. The phone and the computer must be on the same Wi-Fi. If the phone has no QR scanner, open the address shown under the code in its browser and type the 6-digit pairing code. The link works only while the window is open: closing it stops SculptForge listening, and the next time you open it there is a new code. A code nobody uses expires after 10 minutes. Tip: The phone can't open the page? Check that it isn't on a guest network or mobile data, turn off VPNs on both devices, and allow SculptForge through the firewall (Windows asks the first time; choose private networks). If the computer has several networks, pick the Wi-Fi one under Network in the window."},{"p":"phone-capture.html","c":"Phone capture and AR","a":"this-site-cant-be-reached-on-android","h":"\"This site can't be reached\" on Android","t":"Recent versions of Chrome on Android can refuse to open any address on your home network, even your router's, and show This site can't be reached (under Details: ERR_TOO_MANY_RETRIES). Until SculptForge's capture page moves to the website, the simplest fix is to use Firefox on the phone: install it from the Play Store, open the address shown under the QR code (for example http://10.0.0.117:8765), allow it to reach devices on your local network when it asks, and type the 6-digit code. Firefox can also be set as the phone's default browser so the camera's QR links open there."},{"p":"phone-capture.html","c":"Phone capture and AR","a":"linux-firewall","h":"Linux firewall","t":"Many Linux desktops (Omarchy, Ubuntu with ufw enabled, Fedora with firewalld) block incoming connections, so the phone's request never arrives. Allow SculptForge's port from your home network only, for example with ufw: sudo ufw allow from 10.0.0.0/24 to any port 8765 proto tcp comment 'SculptForge phone capture' Use your own network's range (the first three numbers of the address under the QR code, then .0/24). With firewalld: sudo firewall-cmd --add-port=8765/tcp (add --permanent to keep it)."},{"p":"phone-capture.html","c":"Phone capture and AR","a":"scan-an-object","h":"Scan an object","t":"Tap Scan an object, read the tips, and tap Record a video. Walk slowly all the way round the object, then once more a little lower, for 20 to 60 seconds: slow and steady, no quick turns; soft, even light, without hard shadows or shiny reflections; the whole object in the middle of the screen, at about the same distance all the way (don't zoom). You can also send a video you already took, or 20 to 200 photos (Choose photos). The page warns you when a video is very short or very long. Tap Send to SculptForge: the upload shows its progress on the phone and in SculptForge's window. Big videos over shaky Wi-Fi are fine: the page sends them in pieces and carries on where it stopped if the connection drops. Keep the page open and the screen on until it says Sent. What arrives is saved in your library's Captures folder (see below) and handed to splat training, which turns it into a Gaussian splat that sharpens in the viewport while it trains. See Gaussian splats."},{"p":"phone-capture.html","c":"Phone capture and AR","a":"one-photo-to-3d","h":"One photo to 3D","t":"Tap One photo to 3D and take a photo (or choose one). One object, the whole of it in the picture, on a plain background works best. SculptForge loads it into Generate > Image to 3D and starts generating with the service chosen there (free Hugging Face models by default). Turn off Generate from a photo at once in the window to check the photo first and press Generate yourself. See Image and text to 3D. The phone sends large photos at about 2048 pixels, which is plenty and much faster."},{"p":"phone-capture.html","c":"Phone capture and AR","a":"send-a-splat-file","h":"Send a splat file","t":"Already scanned it with Scaniverse, Polycam or Luma? Export a Gaussian splat .ply from the app, tap Send a splat file and choose it. It opens next to your sculpt as a splat. A .ply that is a plain mesh becomes a new SubTool instead, so it never replaces your work."},{"p":"phone-capture.html","c":"Phone capture and AR","a":"view-in-ar","h":"View in AR","t":"Tap View in AR, choose what to show (the Active SubTool or the Whole scene) and how big it should be on the desk (10 cm to 1 m), then Get the model. SculptForge prepares a phone-friendly copy: reduced to about 80,000 triangles, its polypaint or texture baked into one texture, standing on its base. When it is ready, tap View in AR and point the phone at a desk or the floor. iPhone and iPad open it in AR Quick Look (a USDZ file). Android opens it in Google's Scene Viewer (a GLB file; needs Google Play Services for AR). Download the model saves the file instead. Keep sculpting: while the phone is looking, every few seconds after a stroke SculptForge exports the model again and the page says Updated from your sculpt. Tap View in AR again to see the change. Turn off Update after each stroke in the window to stop that."},{"p":"phone-capture.html","c":"Phone capture and AR","a":"face-capture","h":"Face capture","t":"Tap Face capture, then Start face capture. Your phone's front camera tracks your face with MediaPipe Face Landmarker, which runs on the phone: the video never leaves it. About 30 times a second only the 52 expression weights (the ARKit set: jawOpen, eyeBlinkLeft, mouthSmileRight...) and the head's rotation go to SculptForge. Prop the phone up at eye level, about an arm's length away, with light on your face. The window's Face section shows a little face following yours and the frame rate. The weights drive the character's facial shapes on the active SubTool (made with Generate facial shapes). If the character winks with the wrong eye, tick Mirror left and right. Record face take records the feed until you press it again. Each take is saved in the Captures folder as take.jsonl: one line per frame with the 52 weights, the head rotation and the time, ready to play back or export. Note: The camera only works on secure (HTTPS) pages, so the face page lives on the SculptForge website. The address it opens carries the connection details after a #, which browsers never send to the website. To set up the connection the phone sends one encrypted message through SculptForge's relay (or ntfy.sh, a free public relay, if ours can't be reached); neither can read it. Without internet, tap Connect without internet on the face page. After that the face data goes straight over your Wi-Fi."},{"p":"phone-capture.html","c":"Phone capture and AR","a":"the-captures-folder","h":"The Captures folder","t":"Everything the phone sends is saved in your library (the folder the LightBox shows, normally Documents/SculptForge), under Captures, one folder per capture: Captures/2026-10-26_195803-splat/scan.mov Captures/2026-10-26_195803-splat/capture.json Captures/2026-10-26_201544-photo/IMG_0412.jpg Captures/2026-10-26_203012-face/take.jsonl capture.json records the kind (splat, photo, ply or face), the device, the files and the times. The window's Received list opens a capture's folder."},{"p":"phone-capture.html","c":"Phone capture and AR","a":"privacy-and-security","h":"Privacy and security","t":"Only devices on your local network can connect, and only while the window is open. Every request needs the session's secret token (it is in the QR code) or the pairing code. Uploads have size limits (4 GB a file, 8 GB a capture), file names are cleaned, and files are written only inside the Captures folder. Nothing you capture is uploaded anywhere except to your computer. A photo goes on to the image-to-3D service you chose in SculptForge, as it does when you pick it yourself."},{"p":"baking.html","c":"Baking normal and displacement maps","a":"","h":"Baking normal and displacement maps","t":"Game engines and renderers want light meshes. Baking captures the detail of your high-poly sculpt as images laid over the UVs of a low-poly version: a normal map makes the low-poly shade as if it had every crease and pore, a displacement map stores how far the surface moves, and ambient occlusion, cavity and colour maps feed materials. Tool > Bake makes all of them in one go, in the background, and shows the normal map on the low-poly right away so you can compare it with the sculpt. A 330,000-triangle sculpt (left) next to its 2,000-triangle low-poly wearing the baked normal map (right), with Tool > Bake open"},{"p":"baking.html","c":"Baking normal and displacement maps","a":"what-you-need","h":"What you need","t":"A high-poly source: one or more SubTools with the detail. They stay as they are. A low-poly SubTool with UVs, in the same place as the high-poly. It can come from another app (import it with Tool > SubTool > Append; models with UVs keep them), or you make it in SculptForge: Duplicate the sculpt, Tool > Geometry > Decimate it, then Tool > Texture Map > Auto UV. The maps go onto the active SubTool, so select the low-poly before baking."},{"p":"baking.html","c":"Baking normal and displacement maps","a":"bake-in-five-steps","h":"Bake in five steps","t":"Select the low-poly SubTool and open Tool > Bake in the right tray. The first line says which SubTool the maps go onto, or \"No UVs\" if it needs Auto UV first. Source: leave All visible SubTools to bake from everything that is shown (except the low-poly), or pick one SubTool. Tick the maps you want, and choose the size (1K, 2K, 4K or 8K). Click Bake. A progress bar shows while it works on every processor core; you can keep working, or click Cancel Bake. When it is done, the status line reports what was baked and where the files went, and the low-poly shows its normal map. Hide the high-poly (Tool > SubTool, the eye) to compare, or untick Preview Normal Map to see the bare low-poly."},{"p":"baking.html","c":"Baking normal and displacement maps","a":"the-maps","h":"The maps","t":"Map File What it holds Normal (tangent) _normal.png The high-poly's surface direction relative to the low-poly, in tangent space. The map for game engines Normal (object) _normal_object.png The high-poly's normals in model space. For tools that want object-space maps Displacement _displacement.png and .exr The distance from the low-poly to the high-poly along the low-poly's normal Ambient Occlusion _ao.png How much of the sky each point sees: darker in creases, folds and cavities Cavity _cavity.png The fine surface curvature: mid-grey where the surface is smooth, dark in cracks, light on ridges Colour _color.png The source's polypaint, or its painted texture is the low-poly SubTool's name. Colour is skipped when the source has neither polypaint nor a texture."},{"p":"baking.html","c":"Baking normal and displacement maps","a":"tangent-space-normal-maps-that-look-right-everywhere","h":"Tangent-space normal maps that look right everywhere","t":"SculptForge computes tangents with MikkTSpace, the same method Blender, Unreal Engine, Unity, Godot, Substance and xNormal use. A map baked here shows correctly in all of them, as long as the low-poly is exported with its normals and UVs (every SculptForge export keeps them). Choose the green channel convention under the map settings: OpenGL (Y+): Blender, Unity, Godot, Substance, three.js. The default. DirectX (Y-): Unreal Engine's native convention. Send to Unreal flips an OpenGL map on import (see below), so you only need DirectX when you import into Unreal by hand."},{"p":"baking.html","c":"Baking normal and displacement maps","a":"displacement-mid-grey-is-zero","h":"Displacement: mid-grey is zero","t":"The 16-bit PNG stores zero displacement as mid-grey, the high-poly outside the low-poly as lighter and inside as darker. White means +scale and black -scale in world units; the scale is the largest distance found, shown under the Bake button (\"Displacement: mid-grey = 0, white = +0.0143\") and in the status line. Use it as the displacement strength in your renderer (with a midlevel of 0.5). With EXR displacement ticked, a 32-bit float OpenEXR holds the real distances in world units, with no scale to set."},{"p":"baking.html","c":"Baking normal and displacement maps","a":"settings","h":"Settings","t":"Setting What it does Source The high-poly: one SubTool, or every visible SubTool except the active one. Hidden faces of the source are ignored Size 1K, 2K (default), 4K or 8K square AA Anti-aliasing: 1 to 4 means 1, 4, 9 or 16 rays per texel, averaged. 2 (the default) gives clean edges Auto distance Measure how far the high-poly lies in front of and behind the low-poly, and cast rays just that far. After a bake, Front and Rear show what it measured Front / Rear With Auto off: how far in front of the low-poly rays start, and how far behind it they look, as a percentage of the model's size (its bounding-box diagonal). ZBrush and Substance call these the max frontal and rear distances Padding Texels around each UV island filled with the island's edge colours, so seams don't show once an engine mipmaps the map. 8 suits 2K; use 16 for 4K and 8K OpenGL / DirectX The normal map's green channel convention (see above) AO rays, AO reach Ambient occlusion quality, and how far away geometry still darkens a point (a percentage of the model's size) Output folder Where the files go. Empty: beside your last export, else the project's folder, else Bakes in your library folder. Open Folder shows it after a bake EXR displacement Also write the displacement as a 32-bit float EXR"},{"p":"baking.html","c":"Baking normal and displacement maps","a":"how-the-bake-works","h":"How the bake works","t":"For every texel of the low-poly's UVs, SculptForge finds the matching point on the low-poly and casts a ray along its smoothed normal, from Front outside the surface to Rear inside it (a \"cage\"), and keeps the high-poly hit nearest to the low-poly. The normal, distance, occlusion and colour found there go into the maps. Rays follow the smoothed normals, so hard edges of the low-poly don't leave gaps. Missing detail (\"x% of texels found no surface\" in red under the Bake button): rays didn't reach the high-poly. Turn off Auto distance and raise Front and Rear. Detail from the wrong place (for example the inside of an ear showing on its back): the rays reach too far. Lower Rear (or Front), or bake the parts from separate SubTools with Source. The bake works on copies, so you can keep sculpting meanwhile. If the low-poly's triangles or UVs change afterwards, the normal map preview turns off because it no longer fits (undo brings it back). Tip: Bake time grows with the map area and the number of rays. On a 10-core Apple M1 Pro, from a 1.3-million-triangle sculpt: a 4K tangent normal map plus displacement (AA 2) takes about 4 seconds, the same at 8K about 11 seconds. Ambient occlusion costs the most: adding it at 4K with 48 rays per texel brings the bake to about 30 seconds. Try settings at 1K, then bake the final maps at 4K."},{"p":"baking.html","c":"Baking normal and displacement maps","a":"send-to-unreal-with-the-normal-map","h":"Send to Unreal with the normal map","t":"When the last bake made a normal map, its low-poly SubTool is shown and still fits the map, Send to Unreal (Tool > Export) imports the map too, as T__N next to the mesh, set up as a normal map (linear, normal map compression), with Unreal's Flip Green Channel set for an OpenGL map. This works with an Unreal Editor on the same computer; for one on another computer, import the PNG by hand. See Exporting, Unreal and ZBrush."},{"p":"baking.html","c":"Baking normal and displacement maps","a":"commands","h":"Commands","t":"Command What it does bake Bake onto the active SubTool and write the maps. Options: source=all or a SubTool name, maps=normal,object_normal,displacement,ao,cavity,color (or all), size=2048 (512 to 8192, or 1k...8k), out=folder, name=prefix, front=0.02 and rear=0.02 (fractions of the model's size, or auto), samples=2, padding=8, ao_rays=48, ao_distance=0.05, green=opengl or directx, displacement_scale= (world units at white), exr=true For example, from the console or sculptforge-cli: subtool_select name=Body_low; bake source=Body maps=normal,ao,displacement size=4096 out=maps The command runs in the foreground (scripts wait for it); the Bake button runs the same bake in the background. See Scripting and automation."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"","h":"Exporting, Unreal and ZBrush","t":"This chapter covers getting your sculpt out of SculptForge: the export formats and what each one keeps, LOD chains for games, sending a mesh straight into a running Unreal Editor, and exchanging models with ZBrush through GoZ. To keep everything (SubTools, layers, mask, polypaint, brushes) use a project file instead; see Projects, autosave and QuickSave."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"export-formats-at-a-glance","h":"Export formats at a glance","t":"Exports write every visible SubTool. Hidden SubTools are left out. Exporting doesn't rename the document or mark it saved, so your next Ctrl+S still saves the project. Format Where in the app Keeps Use it for glTF binary (.glb) File > Export GLB... (Ctrl+E) One node per SubTool, sculpt layers as morph targets, polypaint as vertex colour, UVs and the painted texture (embedded) Games, Blender, three.js, web viewers LOD chain (.glb per level) File > Export LOD Chain... As GLB, one file per level, blend shapes on every level Game engines OpenUSD (.usda, .usdz) File > Export USD / USDZ... One Mesh prim per SubTool, quads, layers as UsdSkel blend shapes, polypaint as displayColor, UVs (primvars:st) and the painted texture through a preview material (inside a USDZ), loaded splats Film pipelines, Omniverse, Apple AR Quick Look FBX for Unreal (.fbx) File > Export FBX for Unreal... Unreal naming and scale, quads, UVs, LOD group, layers as blend shapes, the painted texture as a PNG beside it Unreal Engine (by hand) Wavefront OBJ (.obj) File > Export OBJ... One o object per SubTool, quads, polygroups as g groups, polypaint as vertex colour, UVs, the painted texture through a .mtl (map_Kd) and a PNG beside it. Layers are baked into the current blend Any 3D app, ZBrush ZBrush GoZ (.GoZ) File > ZBrush (GoZ) > Export GoZ... Quads, polygroups, mask, polypaint, UVs, the painted texture as a PNG beside it ZBrush STL (.stl) File > ZBrush (GoZ) > Export STL... Geometry only (triangles), visible SubTools merged, in millimetres with Z up 3D printing PLY (.ply) export_ply command Geometry, quads and polypaint, visible SubTools merged Scan tools, MeshLab, Blender FBX (general) export_fbx command One model per SubTool, quads, UVs, blend shapes, optional LOD groups, the painted texture Other FBX pipelines The GLB, LOD chain and FBX for Unreal exports are also in the Tool palette under Export, together with the LOD and Unreal settings. \"Quads\" means the quads the model came in with (or got from Plane, Cube, Subdivide or Voxel Remesh) are written as quads, the rest as triangles; see Quads and triangles. glTF and STL can only hold triangles. The Tool > Export sub-palette with a generated LOD chain and the Unreal Engine settings UVs are kept through OBJ, FBX, USD, glTF and GoZ, in and out. A SubTool with a painted texture is exported with it: the PNG is written next to the file as _color.png (__color.png with several SubTools) and referenced by the model, or embedded in GLB and USDZ files. Spaces in the file name become _ in the names of the files written beside it (my scene.obj gets my_scene.mtl and my_scene_color.png), because OBJ and MTL separate file names with spaces. Tool > Texture Map > Auto UV gives any sculpt UVs before export. Normal, displacement and other maps come from Tool > Bake as separate image files. Textured exports are checked against other tools, not only read back by SculptForge: GLB files pass the Khronos glTF validator with no errors or warnings; USD and USDZ files pass OpenUSD's validators (the USDZ files are uncompressed, 64-byte aligned and have the root layer first); FBX files load in ufbx's strict mode with their textures connected; and in all four formats plus OBJ, the texture is sampled the right way up (each format's UV convention), checked colour by colour against SculptForge's own sampling. The scripts are in tools/export_check/ in the source tree."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"scale-and-axes","h":"Scale and axes","t":"glTF, USD and OBJ are written Y-up with 1 unit = 1 metre, the same space you sculpt in. FBX uses centimetres: export_fbx multiplies positions by 100 by default (scale=), so 1 unit = 1 m. STL is written in millimetres with Z up, as slicers expect: a 0.3 m sculpt prints 300 mm tall, standing upright. export_stl height_mm=80 scales it to a print height instead (see 3D printing). Opening an STL converts back, so a downloaded print model comes in upright and at its real size. STL files from SculptForge 0.5 and earlier (metres, Y up) are recognised and open as they were saved. PLY keeps positions as they are (no unit conversion). For Unreal, Height sets the real-world size directly (see below)."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"export-a-model","h":"Export a model","t":"Show the SubTools you want to export and hide the others (the eye icon in Tool > SubTool). Choose the export in the File palette and pick a file name. The status line confirms the export (\"Exported ...\"). A SubTool with subdivision levels is exported at the level you are on. To write the base cage (or any other level) without stepping to it, use subdiv_export path=base.obj level=1. From a script, each format is one command: sculptforge-cli -c 'open path=bust.sfproj; export_glb path=bust.glb' sculptforge-cli -c 'open path=bust.sfproj; export_usd path=bust.usdz' sculptforge-cli -c 'open path=bust.sfproj; save_obj path=bust.obj' sculptforge-cli -c 'open path=bust.sfproj; export_fbx path=bust.fbx lods=3 ratio=0.5' sculptforge-cli -c 'open path=bust.sfproj; export_stl path=bust.stl; export_ply path=bust.ply'"},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"3d-printing","h":"3D printing","t":"File > ZBrush (GoZ) > Export STL... writes every visible SubTool as one binary STL, ready for a slicer (PrusaSlicer, Cura, Bambu Studio, OrcaSlicer ...). The status line gives the printed size, for example \"Exported lion.stl (47214 triangles, 320.8 x 206.6 x 436.4 mm)\": width, depth and height as the slicer shows them. Size: 1 unit in SculptForge is 1 m, so 1 unit becomes 1000 mm. To print at a given height, use export_stl path=lion.stl height_mm=80, or scale the model in the slicer. One solid: overlapping SubTools go into the file as they are, which some slicers and print services reject. Merge visible them (SubTools) and Remesh to turn them into one closed surface first. Detail: printers resolve about 0.05-0.1 mm, so millions of triangles rarely help. Decimate makes the file smaller without visible loss. sculptforge-cli -c 'open path=bust.sfproj; export_stl path=bust.stl height_mm=120' sculptforge-cli -c 'open path=bust.sfproj; export_stl path=bust.stl scale=1 z_up=false' # sculpt space as it is"},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"lod-chains-for-games","h":"LOD chains for games","t":"A LOD (level of detail) chain is the same model at decreasing triangle counts, so an engine can draw distant objects cheaply. SculptForge builds it with quadric decimation, keeping blend shapes on every level. Open Tool > Export. Set LODs (2 to 6 levels, including LOD0) and Reduction (0.1 to 0.9: the triangle ratio from one level to the next, default 0.5). Click Generate LOD chain. A table lists each level with its triangle count and its share of LOD0. Click a level (LOD0, LOD1 ...) to inspect it in the viewport; the wireframe turns on. Click Sculpt to go back to the editable mesh. Export with LOD chain (GLB per level), or send it to Unreal (below). Changing the sliders clears the preview; click Generate LOD chain to build it again. The LOD chain export writes _LOD0.glb, _LOD1.glb and so on next to the path you choose. With several visible SubTools, each SubTool is decimated on its own. sculptforge-cli -c 'open path=rock.obj; export_lods path=out/rock.glb levels=4 ratio=0.5' To reduce the sculpt itself instead of exporting copies, use Tool > Geometry > Decimate; see Subdivide, Remesh, Decimate and LODs."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"send-to-unreal","h":"Send to Unreal","t":"Send to Unreal exports an Unreal-ready FBX and imports it into a running Unreal Editor (5.x) on this computer or another one on your network. Nothing is installed into your project: it uses Unreal's built-in Python remote execution. Your sculpt What arrives in Unreal No sculpt layers A static mesh SM_ with the LOD chain from Tool > Export Sculpt layers A skeletal mesh SK_ with one morph target per layer (Unreal adds a single root bone) Several visible SubTools One FBX model per SubTool, combined into one asset on import Any A material slot M_Clay, and the real-world size from Height A baked normal map (Tool > Bake) The texture T__N, set up as a normal map (Unreal on this computer only) Sending the same asset again updates it in place (same name and folder), so references in your levels stay intact."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"one-time-setup-in-unreal","h":"One-time setup in Unreal","t":"Edit > Plugins: enable Python Editor Script Plugin, then restart the editor. Edit > Project Settings > Plugins > Python: tick Enable Remote Execution?. That's all when Unreal runs on the same computer."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"send","h":"Send","t":"Open Tool > Export and find the Unreal Engine section. Set Folder (the content folder, default /Game/SculptForge) and Height (the model's height in Unreal, in centimetres; it starts at the model's current height with 1 unit = 1 m). For a static mesh, set LODs and Reduction above (default 4 levels). Click Send to Unreal, or press Ctrl+U. The status line reports the result. The line under the buttons tells you what will be sent: \"Static mesh with 4 LODs\" or \"Skeletal mesh with 2 morph targets\"."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"unreal-on-another-computer","h":"Unreal on another computer","t":"On the Unreal machine, in Project Settings > Plugins > Python, open Advanced and set Multicast Time-To-Live to 1 and Multicast Bind Address to 0.0.0.0. In SculptForge, tick Unreal is on another computer. Both computers must be on the same network, and the SculptForge computer's firewall must allow incoming connections from the Unreal machine: the editor connects back to SculptForge to fetch the file."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"import-by-hand","h":"Import by hand","t":"Export FBX for Unreal... (in the File palette and in Tool > Export) writes the same file. The file name becomes the asset name. Drag it into the Content Browser: static meshes pick up their LODs from the file's LOD group; for skeletal meshes choose Skeletal Mesh and tick Import Morph Targets."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"from-scripts","h":"From scripts","t":"sculptforge-cli -c 'open path=statue.obj; unreal_send destination=/Game/Props height_cm=200 lods=4' sculptforge-cli -c 'unreal_editors network=true' # list editors on the network sculptforge-cli -c 'open path=statue.obj; export_unreal folder=out height_cm=200' unreal_send also takes name=, project= (pick one editor when several are open) and network=true. Note: Layered sculpts are sent as skeletal meshes without the LOD chain, because Unreal's morph targets need a skeletal mesh (Unreal can generate skeletal LODs itself). The Unreal link has been tested against a stand-in editor that speaks the same protocol but not yet against every Unreal version. If an import fails, Unreal's Output Log shows the importer's messages."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"exchange-models-with-zbrush-goz","h":"Exchange models with ZBrush (GoZ)","t":"SculptForge reads and writes ZBrush's GoZ format and can talk to a running ZBrush through the GoZ bridge on Windows and macOS. The commands are in File > ZBrush (GoZ): Item What it does Send to ZBrush Writes every visible SubTool to the shared GoZ folder and tells ZBrush (starting it if needed). Each SubTool arrives as its own ZBrush SubTool. Turns on Receive automatically Receive from ZBrush Loads what ZBrush last sent with GoZ. Each object updates the SubTool it was sent from (one undo step), or becomes a new SubTool Receive automatically Checks once a second for a new GoZ send from ZBrush and receives it Custom GoZ folder Use another GoZ folder, for example inside a Wine prefix Import GoZ... Opens a .GoZ file, replacing the scene Export GoZ... Writes a .GoZ file. With several visible SubTools, one file per SubTool next to the path Export STL... Writes a binary STL of the visible SubTools The default GoZ folder is C:\\Users\\Public\\Pixologic on Windows and /Users/Shared/Pixologic on macOS. ZBrush doesn't run on Linux, so there the bridge needs a custom folder; GoZ files still import and export."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"a-round-trip","h":"A round trip","t":"In SculptForge, choose File > ZBrush (GoZ) > Send to ZBrush. ZBrush starts or comes forward with the SubTools. If ZBrush was not running and does not import them, press GoZ in ZBrush. Work in ZBrush, then press GoZ there to send the model back. SculptForge receives it automatically and updates the matching SubTools. Each update is an undo step on that SubTool. GoZ keeps polygroups, mask, polypaint and UVs. Quads from ZBrush stay quads: PolyF shows them as quads, and they go back to ZBrush as the same quads. GoZ has no hidden-face flag, so hidden faces are sent like any others. ZBrush: SculptForge can't read ZBrush's own .ZTL and .ZPR files (they are proprietary and undocumented). Bring models over with GoZ, export OBJ or FBX from ZBrush, or convert your ZTools once with the SculptForge ZTool Export plug-in for ZBrush, after which SculptForge opens the .ZTL itself (see Coming from ZBrush). Subdivision levels don't come across: SculptForge receives the mesh at the level you sent. Note: The GoZ bridge follows the format of the open-source Blender GoZ add-on (GoB) and is tested with files, but has not yet been tested against a live ZBrush. If a send does not arrive, export a .GoZ file and import it in ZBrush by hand, and please report it (Help > Report a problem). From scripts: goz_export path=, goz_import path=, goz_send, goz_receive and export_stl path= (see 3D printing for its options)."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"blender","h":"Blender","t":"To sculpt Blender objects in SculptForge and send them back into the same objects, use the SculptForge Bridge add-on and File > Blender: see Working with Blender. For a one-off exchange, OBJ, FBX and glTF all carry SubTools, UVs and quads both ways."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"see-also","h":"See also","t":"Working with Blender: the Blender add-on Projects, autosave and QuickSave: save everything, not just the mesh SubTools: which SubTools are exported Layers and blend shapes: what becomes morph targets Subdivide, Remesh, Decimate and LODs: decimate before exporting Gaussian splats: saving splats For studios: formats in a pipeline"},{"p":"blender.html","c":"Working with Blender","a":"","h":"Working with Blender","t":"Keep Blender for the scene, rigging, shading and animation, and sculpt in SculptForge: the SculptForge Bridge add-on sends the selected objects from Blender to SculptForge with one click, and one click in SculptForge sends them back. The objects update in place in Blender: their transform, materials and modifiers stay as they were. It works like GoZ between ZBrush and other apps, on Linux, Windows and macOS, with Blender 4.2 or newer."},{"p":"blender.html","c":"Working with Blender","a":"install-the-add-on","h":"Install the add-on","t":"Download sculptforge_bridge.zip from the latest release (or the SculptForge website). In Blender choose Edit > Preferences > Get Extensions, open the menu at the top right and choose Install from Disk..., then pick the zip. (You can also drag the zip into Blender's window.) The SculptForge tab appears in the 3D View's sidebar (press N). Send and Receive are also in the Object menu and in File > Import / Export. Start SculptForge once after installing it: it records where it is installed, so the add-on can start it for you. If the add-on still can't find it (for example an AppImage you keep somewhere unusual), set its path in the add-on's preferences (Edit > Preferences > Add-ons > SculptForge Bridge). Tip: Older Blender versions or a classic add-on install: sculptforge_bridge--legacy.zip installs through Edit > Preferences > Add-ons > Install from Disk. The add-on needs Blender 4.2 or newer either way."},{"p":"blender.html","c":"Working with Blender","a":"a-round-trip","h":"A round trip","t":"In Blender, select one or more mesh objects and click Send to SculptForge in the SculptForge tab. SculptForge starts, or, if it's already open, loads them within a second. Each object becomes a SubTool with the object's name, placed as it is in the Blender scene. Sculpt, paint, mask, divide, remesh: anything SculptForge does. In SculptForge choose File > Blender > Send to Blender. Every visible SubTool goes back. Blender picks it up by itself within a second (or click Receive from SculptForge). Each object that came from Blender is updated; a SubTool you added in SculptForge becomes a new object. Sending again from Blender updates the same SubTools: each update is one undo step on that SubTool in SculptForge, and each receive in Blender is one undo step there. File > Blender in SculptForge"},{"p":"blender.html","c":"Working with Blender","a":"what-comes-across","h":"What comes across","t":" Blender SculptForge Shape The object's mesh, in its own space The SubTool, placed in the scene with the object's transform Faces Triangles and quads; n-gons as triangle fans Triangles and quads (PolyF shows the quads) UVs The active UV map UVs Colour The active colour attribute (point or face corner) Polypaint Mask The sculpt mask Mask Face sets Sculpt mode face sets Polygroups Name Object name SubTool name Blender is Z-up and SculptForge Y-up, both in metres; the add-on and SculptForge convert between them, so the model stands the same way in both and a round trip changes nothing. Objects with a negative scale (mirrored) come across the right way out. When the topology doesn't change (you only sculpted, painted or masked), Blender's mesh keeps everything it had: its n-gons, edges, seams, creases, custom attributes and the other UV maps; only the positions, the active UV map, colour, mask and face sets are updated. When the topology changes (Divide, a remesh, QRemesh, Subdivide...), the object's mesh is rebuilt from what SculptForge sent. The object keeps its transform, materials, modifiers and the names of its active UV map and colour attribute; things tied to the old faces (material per face, seams, other UV maps, shape keys) can't follow and are reset."},{"p":"blender.html","c":"Working with Blender","a":"modifiers","h":"Modifiers","t":"The Modifiers setting in the SculptForge tab chooses what an object with modifiers sends: Keep live (the default): the mesh under the modifiers. They keep working in Blender on the sculpted mesh, for example a Mirror or a Subdivision Surface. Apply: what you see, with the modifiers applied. When it comes back, the mesh holds their result, so the add-on turns those modifiers off (they stay on the object, switched off, if you want them again)."},{"p":"blender.html","c":"Working with Blender","a":"settings","h":"Settings","t":"In the SculptForge tab: Receive automatically: after a send, load what SculptForge sends back as soon as it arrives (on by default). Off: click Receive from SculptForge yourself. In SculptForge's File > Blender: Receive automatically: load what Blender sends as soon as it arrives (on by default). The add-on's preferences add the path of SculptForge and the exchange folder (below)."},{"p":"blender.html","c":"Working with Blender","a":"zbrush-style-keys-in-sculpt-mode","h":"ZBrush-style keys in Sculpt Mode","t":"Sculpting in Blender too? Turn on ZBrush-style keys in Sculpt Mode in the add-on's preferences (Edit > Preferences > Add-ons > SculptForge Bridge) and Blender's Sculpt Mode answers to ZBrush's keys where Blender has the same thing. Turning it off removes them again, and Blender's own keys are back; so does disabling the add-on. The preferences list every key while it's on. ZBrush key In Blender's Sculpt Mode S / U / O Draw Size / Z Intensity (Strength) / Focal Shift (Hardness), dragged at the cursor Space Blender's Sculpt quick menu at the cursor (brush, size, strength) B The brush list by ZBrush name (Standard, DamStandard, Clay, ClayBuildup, Move, SnakeHook...): type a few letters, Enter picks Alt+drag Zsub: the brush digs in Ctrl+drag / Ctrl+Alt+drag Mask / unmask, drawn as a lasso Ctrl+Shift+drag / Ctrl+Shift+Alt+drag Show only what's inside / hide what's inside Ctrl+W Group the masked part as a face set and clear the mask (with nothing masked: the visible part) Ctrl+D / D / Shift+D Divide (a Multires level) / SDiv up / SDiv down (never adds a level) X Symmetry X Shift+F PolyFrame (the wireframe overlay) F / P Frame the model / perspective on and off L LazyMouse (Blender: Stabilize Stroke) W / E / R Move / Scale / Rotate Shift+drag Smooth (Blender already does this) The ZBrush brushes map to Blender's closest: Standard = Draw, DamStandard = Draw Sharp, ClayBuildup = Clay Strips, Move = Grab, Move Elastic = Elastic Grab, TrimDynamic = Trim (Scrape in Blender 4.2), Crease = Crease Sharp, MaskPen = Mask. What Blender has no key for, or can't do the ZBrush way: I (RGB Intensity): Blender's sculpt brushes don't paint. Ctrl+drag on the model doesn't paint the mask with a round brush: Blender can't switch to the Mask brush for one stroke, so it draws a mask lasso (pick the Mask brush with B to paint it). Dragging on the empty background doesn't rotate: a keymap can't tell the model from the background. Use the middle mouse button, or Blender's Emulate 3 Button Mouse. Ctrl+click on the background (invert or clear the mask) and Ctrl+Shift+click (show all): use Ctrl+I, Alt+M and Alt+H. B then two letters: a Blender menu takes one key at a time, so B opens the list and the letters filter it. Alt+click a SubTool: Blender's objects aren't SubTools (Alt+Q switches the object you sculpt). Stroke types (DragRect, Spray...): each Blender brush sets its stroke method in its Stroke panel. These keys take Blender's place while they're on: F no longer sets the radius (that's S), B no longer draws a box mask, Ctrl+drag no longer inverts the brush (that's Alt), and Space no longer plays the animation in Sculpt Mode."},{"p":"blender.html","c":"Working with Blender","a":"vector-displacement-maps","h":"Vector displacement maps","t":"SculptForge's VDM brushes and Blender's use the same maps (see Vector displacement brushes): From Blender: a map baked with Blender's VDM Brush Baker loads with Brush > Vector Displacement > Load VDM... as it is. To Blender: Export EXR... writes the VDM brush's map. In Blender, in Sculpt Mode with a Draw brush: in the brush's Texture panel add a new image texture and open the EXR (set its Color Space to Non-Color), set Mapping to Area Plane, turn on Vector Displacement, then set the stroke method to Anchored and Strength to 1. Drag on the model to stamp it."},{"p":"blender.html","c":"Working with Blender","a":"how-it-works","h":"How it works","t":"The two programs share a folder in your user data: ~/.local/share/SculptForge/SculptForge/blender on Linux, %APPDATA%\\SculptForge\\SculptForge\\blender on Windows, ~/Library/Application Support/SculptForge/SculptForge/blender on macOS. Each side writes its meshes there as .GoZ files (the format SculptForge also uses with ZBrush) with a small list of the objects, and checks the other side's list once a second. Nothing goes over the network. To use another folder, set it in the add-on's preferences and start SculptForge with the environment variable SCULPTFORGE_BLENDER_EXCHANGE set to the same folder. From scripts and the MCP server: blender_send and blender_receive (both take folder=). Starting SculptForge with --blender loads what Blender last sent."},{"p":"blender.html","c":"Working with Blender","a":"limits-and-troubleshooting","h":"Limits and troubleshooting","t":"Blender as a Flatpak or Snap sees a different user data folder and may not be allowed to start other programs. Set the add-on's exchange folder to a folder both can reach, start SculptForge yourself with SCULPTFORGE_BLENDER_EXCHANGE set to it, and send. Linked duplicates (objects sharing one mesh) all show the last one received. Shape keys: the Basis and the keys named like SculptForge's layers are updated; other keys keep their shapes. Subdivision levels don't go to Blender: it receives the level you're on (like GoZ). Sculpt layers arrive as shape keys (Basis plus one key per layer, with its name and weight), so the 52 facial shapes keep their ARKit names. Shape keys don't come back from Blender, and textures stay in SculptForge. Nothing arrives in SculptForge? Check File > Blender > Receive automatically, or choose Receive from Blender. Nothing arrives in Blender? Click Receive from SculptForge; automatic receiving starts after the first send from that Blender session. Objects in Edit Mode or Sculpt Mode are updated too: the add-on switches to Object Mode for the update and back."},{"p":"blender.html","c":"Working with Blender","a":"see-also","h":"See also","t":"Exporting, Unreal and ZBrush: files, game engines and GoZ SubTools: each Blender object is a SubTool Polygroups and visibility: Blender's face sets"},{"p":"projects.html","c":"Projects, autosave and QuickSave","a":"","h":"Projects, autosave and QuickSave","t":"A SculptForge project (.sfproj) saves your whole scene in one file, so you can close the app and carry on exactly where you stopped. This chapter covers saving and opening projects, the unsaved-changes prompt, recent files, autosave and crash recovery, QuickSave, and the LightBox tabs that show your work."},{"p":"projects.html","c":"Projects, autosave and QuickSave","a":"what-a-project-keeps","h":"What a project keeps","t":"A .sfproj file holds everything SculptForge knows about the scene: every SubTool, with its name, visibility, mesh, mask, polypaint, polygroups, hidden faces and UVs; every sculpt layer with its weight, and the active layer of each SubTool; each SubTool's QRemesh Guides, the curves QRemesh's edge loops follow; loaded Gaussian splats and their placement; your custom brushes, so a project opened on another computer still has them; the camera, the material and display settings, the brush, Draw Size, Z Intensity (and Smooth's), RGB Intensity, Focal Shift, paint colour and symmetry; a thumbnail, shown in the LightBox. Undo history isn't saved: an opened project starts with a clean history. Model formats such as OBJ, GLB or FBX can't hold all of this (masks, hidden faces, splats, brushes), so writing them is an export, not a save. See Exporting. ZBrush: A .sfproj is the equivalent of a ZBrush project (.ZPR), and saving a single SubTool scene is close to saving a .ZTL. SculptForge can't read .ZPR files, and opens a .ZTL only after the ZTool Export plug-in converted it in ZBrush; otherwise bring models over with GoZ or as OBJ, FBX or GLB."},{"p":"projects.html","c":"Projects, autosave and QuickSave","a":"save-a-project","h":"Save a project","t":"File > Save (Ctrl+S) saves to the current project. The first time, it asks for a file name. File > Save As... (Ctrl+Shift+S) saves under a new name. Clicking the document name in the title strip also saves. The title strip shows the document name with * after it while there are unsaved changes, and the window title starts with *. Any edit in any SubTool counts, as do splat edits and layer weight changes. If you opened a model file (an OBJ, say) rather than a project, Save asks where to save a new .sfproj; the original model file is left alone."},{"p":"projects.html","c":"Projects, autosave and QuickSave","a":"open-a-project-or-model","h":"Open a project or model","t":"File > Open... (Ctrl+O) opens a project, a model or a splat capture. Opening a project or model replaces the scene. File > Open Recent lists the last 10 files you opened or saved. Files that no longer exist are dropped from the list. Clear Recent empties it. Drop a file onto the window to open it. In the LightBox, double-click a project or model. File > New Sphere (Ctrl+N) and File > New Plane start a fresh scene. When you open a project, its saved camera, material and brush settings come back too."},{"p":"projects.html","c":"Projects, autosave and QuickSave","a":"the-unsaved-changes-prompt","h":"The unsaved-changes prompt","t":"When the scene has unsaved changes, New Sphere, New Plane, Open..., Open Recent, dropping a model or project, Quit (Ctrl+Q) and closing the window first ask: Save saves the project (asking for a name if it has none), then carries on; Don't Save discards the changes and carries on; Cancel goes back to your work. Dropping an image or a .sfbrush file never asks, because it doesn't replace the scene."},{"p":"projects.html","c":"Projects, autosave and QuickSave","a":"autosave-and-crash-recovery","h":"Autosave and crash recovery","t":"While the scene has unsaved changes, SculptForge writes a recovery copy every few minutes (every 5 minutes by default; it waits until you finish a stroke). Change the interval, or turn it off with 0, in Preferences > Autosave or with the Autosave (min) slider in the File palette (0 to 60 minutes). The recovery copy is autosave.sfproj in the SculptForge settings folder (see Troubleshooting for where that is on your system). It is deleted once your work is saved or you discard the changes. If SculptForge didn't close normally (a crash or power cut), the next start asks Restore Autosave?: Restore opens the autosaved scene as an untitled, unsaved document. Save it to keep it. Discard deletes the recovery copy. The autosave also appears first in the LightBox QuickSave tab while it exists. Note: Autosave is a safety net, not a substitute for saving. It keeps only the latest copy and is removed as soon as you save."},{"p":"projects.html","c":"Projects, autosave and QuickSave","a":"quicksave","h":"QuickSave","t":"QuickSave in the title strip saves a timestamped copy of the whole scene, like ZBrush's QuickSave. Your project file, its name and its unsaved state are not changed, so QuickSave is safe to press before any risky step. Copies go to the QuickSave folder of your library (by default Documents/SculptForge/QuickSave), named like QuickSave 2026-10-21 23-15-04.sfproj. The last 10 QuickSaves are kept; older ones are deleted. They appear in the LightBox QuickSave tab, newest first, labelled with their date and time. Double-click one to open it. The tab also has a Save now button. QuickSave has no default shortcut. To give it one, hold Ctrl+Alt, click the QuickSave button and press a key (see The interface)."},{"p":"projects.html","c":"Projects, autosave and QuickSave","a":"your-library-folder-and-the-lightbox","h":"Your library folder and the LightBox","t":"SculptForge keeps a library folder for your work, by default SculptForge in your Documents folder. It is created on first use with these sub-folders: Folder LightBox tab What goes there Projects Project Your .sfproj files Tools Tool Models to open or append as SubTools Brushes Brush .sfbrush files Alphas Alpha Grayscale images for brush alphas Images Image Sketches and concept art for Generate 3D Splats Splats Gaussian splat captures QuickSave QuickSave QuickSave copies Change it in Preferences > LightBox > Library folder, then Store Config (Ctrl+Shift+I) to keep the setting. Press , (comma) to show the LightBox. The tabs that matter for projects: Project: the projects in your Projects folder, plus any recent project saved elsewhere. Each shows the thumbnail saved with it. QuickSave: the autosave (when there is one) and your QuickSaves, newest first. Recent: everything in Open Recent, of every kind. Double-click a tile to open it (you are asked about unsaved changes first). In the Tool tab, Shift+double-click a model to append it as a SubTool instead. The LightBox showing project thumbnails"},{"p":"projects.html","c":"Projects, autosave and QuickSave","a":"scripting","h":"Scripting","t":"Command What it does save_project path=work/dragon.sfproj Save the project (without path, to the current project) open_project path=work/dragon.sfproj Open a project (open also recognises .sfproj) open path=scan.obj Open a model, splat capture or project new_sphere subdivisions=6 / new_plane resolution=128 Start a new scene Projects saved by sculptforge-cli or Python open in the app too. For the file layout, see docs/project-format.md."},{"p":"projects.html","c":"Projects, autosave and QuickSave","a":"see-also","h":"See also","t":"The interface: LightBox, shortcuts and Store Config SubTools Exporting: formats for other applications Troubleshooting: where settings and the autosave live"},{"p":"scripting.html","c":"Scripting and automation","a":"","h":"Scripting and automation","t":"Every operation in SculptForge is a named command with parameters. The same commands run from the console inside the app, from script files, from the sculptforge-cli tool on a build farm, from Python, and from AI agents through the Model Context Protocol (MCP). This chapter explains the script language, the console, both command-line programs, the Python module and MCP setup. ZBrush: The console plays the role of ZBrush's ZScript window, and Copy session as script is a macro recorder. The language is much simpler than ZScript: one command per statement, with named parameters."},{"p":"scripting.html","c":"Scripting and automation","a":"the-script-language","h":"The script language","t":"A script is a list of statements. Each statement is a command name followed by name=value parameters: new_sphere subdivisions=5 subdivide levels=1 remesh resolution=256; decimate ratio=0.5 # two statements on one line export_glb path=\"My Sculpts/bust.glb\" The rules: Statements are separated by new lines or by ;. # starts a comment that runs to the end of the line (outside quotes). Parameters are name=value with no spaces around =. true and false are booleans; numbers are numbers; anything else is text. Put text in double quotes when it contains spaces, ;, # or \", or when it must stay text even though it looks like a number. Inside quotes only \\\" and \\\\ are escapes, so Windows paths such as \"C:\\Users\\me\\head.obj\" work as written. Colours with a # must be quoted: set_color color=\"#d9a07a\". Paths are UTF-8. Relative paths are relative to the current folder of the program running the script. Scripts stop at the first command that fails."},{"p":"scripting.html","c":"Scripting and automation","a":"the-console","h":"The console","t":"Press the backtick key (left of 1), or choose Script > Console, to open the console strip above the bottom shelf. Drag its top edge to resize it. The console showing commands run from the interface and typed by hand Every command you run appears in the console as a script line, whether it came from a button, a shortcut, the command palette or the console itself, followed by its result. Failures show in red with the reason. Type a statement and press Enter to run it. Several statements separated by ; run in order and stop at the first failure. Tab completes command names, then parameter names. Press Tab again to list the candidates. Up and Down walk through the last 200 lines you typed. The history is kept between sessions. help (or ?) lists every command; help remesh explains one command and its parameters. clear empties the log. The console buttons (also in the Script palette): Button What it does Run script file... Runs a text file of statements (.sfscript or .txt), stopping at the first failure Copy session as script Puts every command run this session on the clipboard as a script you can save and run again Clear console Empties the log. The session script is kept Tip: To record a macro, work normally, then click Copy session as script, paste it into a text file and edit out what you don't need. Run it later with Run script file... or sculptforge-cli -f."},{"p":"scripting.html","c":"Scripting and automation","a":"the-command-palette","h":"The command palette","t":"Press F3 (or Ctrl+Shift+P, or click Search in the title strip) to search every command, brush and setting by name. Enter runs the highlighted entry; Shift+Enter opens it in the console so you can add parameters first. Commands that need parameters always open in the console. With an empty search, the palette lists what you used recently. See The interface. The command palette searching for a command Tip: Hold Ctrl+Alt and point at a button to see the scripting parameters of the command behind it."},{"p":"scripting.html","c":"Scripting and automation","a":"commonly-used-commands","h":"Commonly used commands","t":"sculptforge-cli --list (or help in the console) prints every command with all its parameters. These are the ones you will use most: Area Command Key parameters Scene new_sphere subdivisions (0 to 8, default 6) Scene new_plane resolution (cells per side, default 128) Files open path: models, projects, splats, GoZ Files save_project path (default: the current project) Files open_project path Geometry subdivide levels (1 to 4, default 1) Geometry remesh resolution (32 to 512, default 200) Geometry decimate ratio (default 0.5) or triangles Geometry qremesh target (default 5000), adaptive, keep_groups, detect_edges, use_polypaint, symmetry, keep_original SubTools project_all distance (default 0.02), mean, blur, geometry, polypaint, source Geometry mesh_info Sculpting stroke points (required), brush, radius, strength, invert, symmetry Brushes brush_set_alpha name (round, square, noise) or path, invert Brushes brush_ai prompt (required), provider, model, endpoint Brushes brush_install path, code or json Brushes brush_save path (required), name Layers layer_add name Layers layer_set_weight index, weight (both required) Masking mask_by_cavity strength, threshold Masking mask_invert, mask_clear, mask_blur, mask_grow iterations where it applies Polygroups polygroup_auto_by_normals angle (default 30) Visibility isolate_polygroup, hide_polygroup group (required) Visibility show_all, delete_hidden Transform transform translate, rotate, scale, pivot, orient, masked, falloff, symmetry, all (Gizmo 3D) SubTools subtool_append type (sphere, cube, plane) or path, name, size SubTools subtool_select index or name Polypaint set_color, paint_fill color, area (unmasked, masked, all) Polypaint paint_from_cavity color, strength, smoothing AI image_to_3d path (required), service, model, remesh, resolution AI text_to_3d prompt (required), service, model Export export_glb, export_usd, export_stl, export_ply path (required); export_stl also height_mm, scale, z_up Export export_fbx path (required), lods, ratio, scale Export export_lods path (required), levels, ratio Unreal unreal_send destination, height_cm, lods, network Splats splat_to_mesh (Make sculptable) detail, preset, color, crop, face_guides, stage Splats face_guides landmarks, front, up, target Edit undo, redo A few commands exist only inside the app, because they change the view rather than the model: set_material (name= a MatCap such as Sculpt, or Studio) and new_cube."},{"p":"scripting.html","c":"Scripting and automation","a":"sculptforge-cli","h":"sculptforge-cli","t":"sculptforge-cli runs commands without a window: on a server, a render farm node or in a build pipeline. It keeps one scene for the whole run, loads your brush library (and studio brushes), and uses the same ai.json settings as the app. sculptforge-cli [options] -c, --command \"<script>\" Run commands, separated by ';' (can be given several times) -f, --file <script.txt> Run commands from a file ('-' reads standard input) --set NAME=VALUE Define a variable; script values written $NAME are replaced -l, --list List every command and its parameters --schema Print the commands as LLM tool definitions (JSON) --mcp Run as an MCP server on standard input and output -q, --quiet Only print errors -h, --help Show this help Each command prints its result on one line (export_glb: Exported out/rock.glb). The exit status is 0 when everything succeeded, 1 for a usage or script syntax error, and 2 when a command failed (the error names the line and the command). Variables make one script reusable. A value written $NAME (the whole value) is replaced with the --set value, so paths with spaces stay intact: cat > lods.sfscript <<'EOF' open path=$in remesh resolution=256 export_lods path=$out levels=4 ratio=0.5 EOF for f in rocks/*.obj; do sculptforge-cli --set in=\"$f\" --set out=\"lods/$(basename \"$f\" .obj).glb\" -f lods.sfscript done More examples: # Concept art -> sculptable model -> USDZ (free, via Hugging Face) sculptforge-cli -c 'image_to_3d path=hero.png; export_usd path=hero.usdz' # Design a brush (free, no key) and save it for the team sculptforge-cli -c 'brush_ai prompt=\"weathered stone edges\"; brush_save path=stone.sfbrush' # Cavity dirt on a sculpt, then a coloured PLY sculptforge-cli -c 'open path=bust.sfproj; paint_from_cavity color=\"#3a2a20\" strength=0.8; export_ply path=bust.ply' Warning: Without the quotes, #3a2a20 would start a comment. In a shell, put the whole script in single quotes so the double quotes reach SculptForge."},{"p":"scripting.html","c":"Scripting and automation","a":"the-sculptforge-app-on-the-command-line","h":"The SculptForge app on the command line","t":"The desktop app takes a few options too, for renders and start-up scripts: Option What it does sculptforge FILE Opens a model, project, splat capture or image at start-up --run \"\" Runs commands at start-up --render out.png Renders the scene to an image and exits --turntable N With --render: N frames around the model (out_000.png ...) --size WxH Render size (default 1024x1024) --view YAW,PITCH Camera angles in degrees (default -30,-15) --zoom F Move the camera F times closer than the framed view --wireframe, --polygroups Render with the wireframe or polygroup colours --hide-mesh Render only the Gaussian splats --fullscreen Start filling the screen (F11 toggles) --demo NAME, --record out.mp4 Play a scripted demo, and record it to a video (needs ffmpeg) --ui-test FILE.sfui, --ui-out DIR Run an interface test script (for developers) A review sheet for a model, eight frames around it: sculptforge model.glb --render review/model.png --turntable 8 --size 1024x1024 Rendering needs an OpenGL 3.3 capable GPU or software renderer and a display. On a headless Linux node, run it under a virtual display such as Xvfb (xvfb-run sculptforge ...)."},{"p":"scripting.html","c":"Scripting and automation","a":"python","h":"Python","t":"SculptForge has a Python module, sculptforge, with the same commands plus NumPy access to the mesh. It is included in the VFX Reference Platform builds and the Rez package (see For studios); when building from source, configure CMake with -DSCULPTFORGE_BUILD_PYTHON=ON. import sculptforge as sf doc = sf.Document() # loads your brush library, like the app sf.run(doc, \"open\", path=\"/show/troll/troll_base.fbx\") sf.run(doc, \"remesh\", resolution=320) sf.run_script(doc, \"decimate ratio=0.25; export_lods path=/out/troll.glb levels=4\") verts, tris = doc.vertices, doc.triangles # NumPy (N, 3) float32 and (M, 3) uint32 doc.set_mesh(verts * 1.1, tris) # bring in a mesh from your own tools (clears undo) print(doc.subtools) # [{'name': ..., 'visible': ..., 'triangles': ...}] doc.active_subtool = \"Helmet\" # select by index or name for name, weight in doc.layers: # sculpt layers (blend shapes) print(name, weight) print([c[\"name\"] for c in sf.commands()]) # every command with its parameters Function or property What it does sf.run(doc, command, **params) Runs one command and returns its message sf.run_script(doc, script) Runs a script in the syntax above and returns the messages sf.commands() Lists every command with its parameters sf.tool_schema() The commands as LLM tool definitions (JSON) doc.vertices, doc.base_vertices, doc.normals, doc.triangles Mesh arrays of the active SubTool (copies) doc.mask, doc.colors, doc.polygroups, doc.hidden Attribute arrays you can read and assign (None if absent) doc.layers, doc.layer_delta(i) Sculpt layers as (name, weight) and their per-vertex offsets doc.subtools, doc.active_subtool The SubTool list and the active SubTool doc.splat_count Number of loaded Gaussian splats Failures raise sculptforge.CommandError. Long operations release the GIL, so you can run them on worker threads."},{"p":"scripting.html","c":"Scripting and automation","a":"ai-agents-mcp","h":"AI agents (MCP)","t":"sculptforge-cli --mcp runs SculptForge as an MCP server. An AI agent (Claude Code, Claude Desktop or any MCP client) gets every command as a tool and works on one scene for the session: it can open files, generate models, sculpt strokes, remesh, paint and export. Claude Code: claude mcp add sculptforge -- /path/to/sculptforge-cli --mcp Claude Desktop or another client: add a stdio server whose command is the full path to sculptforge-cli and whose argument is --mcp. For Claude Desktop that is an entry in its configuration file like this: { \"mcpServers\": { \"sculptforge\": { \"command\": \"/path/to/sculptforge-cli\", \"args\": [\"--mcp\"] } } } Then ask for something like \"make a sphere, remesh it at 128 and export it to ~/Desktop/ball.glb\". File paths are on your machine. The agent works headless; to see the result, open the exported file in SculptForge. sculptforge-cli --schema prints the same tool definitions as JSON, for wiring SculptForge into your own agent."},{"p":"scripting.html","c":"Scripting and automation","a":"see-also","h":"See also","t":"The interface: the command palette and Ctrl-hover help For studios: Rez, the VFX builds and farm rendering Image and text to 3D and Exporting: the commands in context Keyboard and mouse reference"},{"p":"studios.html","c":"SculptForge for studios","a":"","h":"SculptForge for studios","t":"SculptForge is built to drop into animation, VFX and game studios that run their own pipelines: native on Linux, scriptable, standards-based, with no licence server and nothing that phones home. This chapter is for pipeline TDs and IT: the VFX Reference Platform builds, Rez deployment, shared brush libraries, environment variables, headless use and licensing."},{"p":"studios.html","c":"SculptForge for studios","a":"vfx-reference-platform-builds","h":"VFX Reference Platform builds","t":"SculptForge tracks the VFX Reference Platform. Every commit is built and tested in the platform's reference environments: CY2026 CY2027 SculptForge Linux compiler GCC 14.2 GCC 14.2 Built and tested with gcc-toolset-14 glibc 2.28 (EL8) 2.34 (EL9) Rocky Linux 8 and 9 builds; CI checks that no newer glibc symbols are used C++ C++20 C++20 C++20 Python 3.13 3.13 The sculptforge module is built and tested against 3.13 Windows VS 2022 17.6+ VS build tools 14.44+ Visual Studio 2022 macOS minimum 14.0 14.0 Universal binary with deployment target 11.0 FBX 2020.x 2020.x Writes FBX 7.4 binary, which FBX SDK 2020 reads SculptForge doesn't depend on Qt, OpenEXR, Boost, TBB or other platform libraries, so it can't conflict with the versions your other tools load. Its few dependencies (SDL3, Dear ImGui, GLM, ufbx) are linked into the binaries. Each release includes SculptForge--linux--vfx2026.tar.gz (Rocky 8, glibc 2.28) and ...-vfx2027.tar.gz (Rocky 9, glibc 2.34), for x86_64 and ARM64, with the Python module under lib/sculptforge/python."},{"p":"studios.html","c":"SculptForge for studios","a":"deploy-with-rez","h":"Deploy with Rez","t":"packaging/rez/package.py in the source tree builds and installs a Rez package: cd packaging/rez SCULPTFORGE_PYTHON=$(which python3.13) rez-build --install # or --release for your release repository rez-env sculptforge -- sculptforge # the app rez-env sculptforge -- sculptforge-cli --list # every pipeline command rez-env sculptforge python-3.13 -- python -c \"import sculptforge\" The package puts bin/ on PATH and the Python module on PYTHONPATH, and sets SCULPTFORGE_ROOT. The Python module is built for the first python3 found unless SCULPTFORGE_PYTHON names an interpreter."},{"p":"studios.html","c":"SculptForge for studios","a":"studio-brush-libraries","h":"Studio brush libraries","t":"Each artist's own brushes live in their user brush library, one .sfbrush file per brush (see Brush Lab and sharing brushes). To give a whole team the same brushes, put .sfbrush files on a share and list it in SCULPTFORGE_BRUSH_PATH: export SCULPTFORGE_BRUSH_PATH=/studio/brushes:/show/troll/brushes # ';' between folders on Windows sculptforge-cli -c 'brush_library' # every brush, where it comes from and its file, plus the folders The app, sculptforge-cli and the Python module load these folders at start-up, read-only: SculptForge never writes into them, so the share can be mounted read-only. Studio brushes show a studio tag in the Custom brushes list. When brushes share a name, the artist's own wins over a studio one, which wins over a built-in. Among studio folders, the first one listed wins. Refining a studio brush in Brush Lab saves the artist's own version (tagged yours) without touching the share. Deleting that version brings the studio brush back. To publish a brush, copy its .sfbrush file into the share: right-click it in the Custom brushes list > Save .sfbrush..., or take it from an artist's user library. With Rez, set the share once for everyone: when SCULPTFORGE_STUDIO_BRUSHES is set as the package resolves (in a site package, your rezconfig or the launcher), it is appended to SCULPTFORGE_BRUSH_PATH. export SCULPTFORGE_STUDIO_BRUSHES=/studio/brushes rez-env sculptforge -- sculptforge"},{"p":"studios.html","c":"SculptForge for studios","a":"environment-variables","h":"Environment variables","t":"Variable Effect SCULPTFORGE_BRUSH_PATH Read-only studio brush folders (:-separated, ; on Windows) SCULPTFORGE_STUDIO_BRUSHES With the Rez package: appended to SCULPTFORGE_BRUSH_PATH SCULPTFORGE_BRUSH_GALLERY Use another community brush gallery index (a URL or a folder), for example an in-house mirror HF_TOKEN (or HUGGING_FACE_HUB_TOKEN) Hugging Face token for the free image-to-3D models FAL_KEY, MESHY_API_KEY Keys for the paid generation services ANTHROPIC_API_KEY, OPENAI_API_KEY Keys for Brush Lab providers XDG_DATA_HOME (Linux), APPDATA (Windows) Move the settings folder (see where settings live) Keys from the environment are used when none is saved in the app, so a launcher can supply them without writing them to each artist's settings."},{"p":"studios.html","c":"SculptForge for studios","a":"headless-and-farm-use","h":"Headless and farm use","t":"sculptforge-cli runs every editing operation without a display: imports, remeshing, decimation, LOD chains, FBX, USD and glTF export, splat conversion and AI generation. See Scripting and automation. sculptforge --render out.png --turntable 8 renders review images and turntables offscreen. It needs an OpenGL 3.3 context; on a headless Linux node, run it under Xvfb. sculptforge-cli --mcp exposes the same operations to AI agents through the Model Context Protocol. import sculptforge gives Python the same commands plus NumPy arrays of the mesh, for your own tools. A typical farm job turns incoming scans into game-ready assets: sculptforge-cli --set in=/ingest/scan_042.ply --set usd=/assets/scan_042.usda --set glb=/assets/scan_042.glb -c ' open path=$in splat_transform rotate_x=180 fit=true splat_clean splat_to_mesh detail=320 preset=game color=texture export_usd path=$usd export_lods path=$glb levels=4 ratio=0.5 ' A --set variable replaces a whole value, so pass complete paths (with their extensions) as variables."},{"p":"studios.html","c":"SculptForge for studios","a":"formats-in-a-pipeline","h":"Formats in a pipeline","t":"Format Read Write Notes OpenUSD (.usda, .usdz) Yes Yes Meshes, xform ops, Z-up stages, UsdSkel blend shapes, ParticleField Gaussian splats, textures; checked with OpenUSD's validators FBX Yes (any version) Yes (7.4 binary) LOD groups, blend shapes, centimetre units, textures; checked with ufbx's strict mode glTF / GLB Yes Yes Morph targets, vertex colours, KHR_gaussian_splatting, embedded textures; checked with the Khronos validator OBJ Yes Yes Objects as SubTools, groups as polygroups, vertex colours, textures through .mtl PLY Yes Yes Meshes with vertex colours, Gaussian splats STL Yes (binary and ASCII) Yes (binary) ZBrush GoZ Yes Yes Polygroups, mask, polypaint, UVs SculptForge project (.sfproj) Yes Yes Everything; a documented ZIP of JSON and binary arrays Binary .usdc files and USD references or payloads aren't read yet; convert with usdcat in.usd -o out.usda. The project format is described in docs/project-format.md in the source tree, so pipeline tools can read it without SculptForge."},{"p":"studios.html","c":"SculptForge for studios","a":"licensing","h":"Licensing","t":"SculptForge is free software under the GNU General Public License, version 3 or later. In practice: Using it is unrestricted, commercially or otherwise, on any number of machines. There are no seats, licence servers or accounts. Your artwork belongs to you. The GPL covers the program, not the models you make with it. You can modify it in-house. The GPL only requires you to share source if you distribute the modified program outside your organisation. Internal use, including across your own facilities and farm, is generally not considered distribution. (This is the common reading of the GPL, not legal advice; check with your counsel.) SculptForge has no telemetry and no servers of its own. AI features are optional and talk only to the service each artist chooses, or to your own ComfyUI server."},{"p":"studios.html","c":"SculptForge for studios","a":"not-yet","h":"Not yet","t":"Planned pipeline features, roughly in order: OpenColorIO viewport display, Alembic export, fuller USD authoring (layers, variants, references, .usdc), UVs and texture baking, multiresolution sculpting. Pipeline requests are welcome as issues on the project's GitHub page."},{"p":"studios.html","c":"SculptForge for studios","a":"see-also","h":"See also","t":"Scripting and automation Exporting, Send to Unreal and GoZ Brush Lab and sharing brushes Image and text to 3D: running models on your own ComfyUI server Troubleshooting"},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"","h":"Keyboard and mouse","t":"This chapter is the reference for every default keyboard shortcut and mouse gesture in SculptForge. Inside the app, F1 opens the same list as the Controls window, showing your own keys if you've changed any."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"changing-shortcuts","h":"Changing shortcuts","t":"Every key below can be reassigned: hold Ctrl+Alt and click a button, then press the new key, or use Preferences > Hotkeys. Press Ctrl+Shift+I (Store Config) to keep your changes. See Customizing the interface. On macOS, Cmd works wherever a shortcut says Ctrl. Single-letter shortcuts don't fire while you type in a text field."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"keyboard-shortcuts","h":"Keyboard shortcuts","t":"The table lists the default shortcut of every action, grouped by palette. It is generated from SculptForge's action registry, the same source as the Controls window."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"brush","h":"Brush","t":"Action Keys What it does Brush picker B Pop up every brush under the cursor. Type the first letter of a brush, then the orange letter on its tile (B S T = Standard). Paste brush Ctrl+V Add the brush on the clipboard: a brush code someone shared, or the text of a .sfbrush file."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"color","h":"Color","t":"Action Keys What it does Pick colour C Take the paint colour from the model under the cursor. Switch Color V Swap the main and the secondary colour."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"draw","h":"Draw","t":"Action Keys What it does Draw Size at cursor S A Draw Size slider under the cursor: drag it, or type a number and press Enter. Focal Shift at cursor O A Focal Shift slider under the cursor: below 0 a broad, hard brush tip, above 0 a soft point (-100..100). The inner ring of the brush cursor shows it. Larger brush ] Make the brush 10% larger (hold to repeat). Paint P Paint colour without sculpting (ZBrush Rgb on, Zadd off). Alt paints back to white, Shift still smooths. RGB Intensity at cursor I An RGB Intensity slider under the cursor: how strongly painting colours the surface (1-100). Smaller brush [ Make the brush 10% smaller (hold to repeat). Z Intensity at cursor U A Z Intensity slider under the cursor: drag it, or type a number (1-100) and press Enter. Hold Shift (or pick Smooth) to set Smooth's own Z Intensity."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"edit","h":"Edit","t":"Action Keys What it does Redo Ctrl+Shift+Z or Ctrl+Y Redo the last undone action. Undo Ctrl+Z Undo the last action."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"file","h":"File","t":"Action Keys What it does Export GLB... Ctrl+E Export the model as glTF binary, with sculpt layers as blend shapes (morph targets). New Sphere Ctrl+N Replace the scene with a new sphere ready for sculpting. Open... Ctrl+O Open a project (.sfproj), a model (.obj, .glb, .fbx, .stl, .ply, .usd ...) or splats. Quit Ctrl+Q Close SculptForge (asks to save changes first). Save Ctrl+S Save the project (.sfproj: every SubTool, layer, brush and setting). Asks for a name the first time. Save As... Ctrl+Shift+S Save the project under a new name. Send to Unreal Ctrl+U Export a game-ready FBX and import it into the running Unreal Editor (Python remote execution)."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"help","h":"Help","t":"Action Keys What it does Command palette F3 or Ctrl+Shift+P Search every command, brush and setting by name and run it. Commands that need parameters open in the console. Controls F1 Every shortcut and mouse gesture, generated from the commands themselves. QuickMenu Space ZBrush's QuickMenu under the cursor: brush, stroke, alpha, material, colour, Draw Size, Focal Shift and the intensities. Hold Space and let go to close it, or tap Space to keep it open. User Guide Shift+F1 The SculptForge user guide: every tool explained, with search. Hold Ctrl over a control and press F1 to open the chapter about it."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"lightbox","h":"LightBox","t":"Action Keys What it does LightBox , Show or hide the LightBox: thumbnails of your projects, models, brushes, alphas, materials, images, splats and QuickSaves along the top of the canvas. Double-click to load."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"material","h":"Material","t":"Action Keys What it does Material picker M Pop up the materials under the cursor. Hover one to preview it on the model; click to keep it."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"preferences","h":"Preferences","t":"Action Keys What it does Load UI... Ctrl+L Load a layout file someone shared (or you saved with Save UI). Save UI... Ctrl+Alt+Shift+I Save the layout, shortcuts and interface preferences to a file you can share. Shelves Tab Hide or show the shelves and trays around the canvas. Store Config Ctrl+Shift+I Keep the current layout, shortcuts and interface preferences for future sessions. Like ZBrush, SculptForge never saves them on its own."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"render","h":"Render","t":"Action Keys What it does Fullscreen F11 Fill the screen with SculptForge (again: back to a window). Mask Ctrl+H Darken masked areas. Wireframe Shift+F Show the mesh's polygons (quads and triangles) over the surface (ZBrush PolyFrame)."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"script","h":"Script","t":"Action Keys What it does Console ` The script console: every command you run appears as a script line, and you can type commands yourself."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"stroke","h":"Stroke","t":"Action Keys What it does LazyMouse L LazyMouse on or off: the brush trails the cursor on a string, for steady lines."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"tool","h":"Tool","t":"Action Keys What it does Clear Mask Ctrl+Shift+A Unmask everything (also: Ctrl+drag on the background). Divide Ctrl+D Add a subdivision level: four times the polygons, and the lower levels are kept, so you can step down to shape big forms and back up to the detail. Quads stay quads (Catmull-Clark). Smt off divides without smoothing. Group Masked Ctrl+W Turn the masked part into a new polygroup and clear the mask (ZBrush Ctrl+W). With nothing masked, everything visible becomes one group. Higher Res D Step one subdivision level up (more polygons, for detail). Edits made below carry the detail along. Invert Mask Ctrl+I Mask what is unmasked and unmask what is masked (also: Ctrl+click the background). Lower Res Shift+D Step one subdivision level down (fewer polygons, for big forms). The detail of the higher levels is kept. Mask All Ctrl+A Mask the whole visible SubTool."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"transform","h":"Transform","t":"Action Keys What it does Draw Q Draw mode: brushes sculpt and paint (leaves the Gizmo 3D). Frame F Fit the whole model in the view. Move W Gizmo 3D, Move: drag an arrow to move along an axis, a square to move in a plane, the centre to move in the view. Masked parts stay; Shift snaps to the grid; Alt+drag moves only the gizmo. W again: back to Draw. Rotate R Gizmo 3D, Rotate: drag a ring to turn about that axis, the outer ring to turn in the view. Mask the body and put the pivot at a joint to pose a limb. Shift snaps to 15 degrees. R again: back to Draw. Scale E Gizmo 3D, Scale: drag a box to stretch along an axis or the centre to scale evenly (right or up: bigger). Shift snaps to 10% steps. E again: back to Draw. X X Mirror strokes across X (left and right)."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"mouse-and-pen-gestures","h":"Mouse and pen gestures","t":"Action Gesture Sculpt Left-drag on the model Invert the brush (subtract) Hold Alt while sculpting Smooth Hold Shift while sculpting (works with any brush, and with Paint) Straight line Press Shift after a stroke has started (45 degree steps) Roll the view Shift+click the background, let go of Shift, drag Rotate Left-drag on the background, or right-drag; hold Shift to snap to an axis view Pan Alt+left-drag on the background, Alt+right-drag, or middle-drag Zoom Mouse wheel; Alt+drag on the background then release Alt; Ctrl+right-drag; Ctrl+middle-drag; with the SculptForge input style also Ctrl+left-drag on the background (when nothing is masked) Paint the mask Hold Ctrl while stroking on the model Erase the mask Hold Ctrl+Alt while stroking on the model Blur / sharpen the mask Ctrl+click / Ctrl+Alt+click the model Invert the mask Ctrl+click the background Clear the mask Ctrl+drag on the background (with MaskPen), or Ctrl+Shift+A Mask inside a lasso or rectangle Ctrl+drag with MaskLasso or MaskRect picked in Tool > Masking (add Alt: unmask) Isolate a polygroup Ctrl+Shift+click it (again: invert the visibility; with something hidden already: hide it) Hide a polygroup Ctrl+Shift+Alt+click it Show everything Ctrl+Shift+click the background Hide outside a rectangle or lasso Ctrl+Shift+drag (add Alt: hide inside); SelectRect or SelectLasso in Tool > Visibility Select a SubTool Alt+click it in the view (Shift+Alt+click: select and frame it) Move, scale or rotate with the Gizmo 3D W, E or R, then drag a handle; hold Shift to snap (15 degrees, the grid, 10%) Move the gizmo only Alt+drag a gizmo handle Put the gizmo's pivot on the model Alt+click the model in Move, Scale or Rotate mode Pan, zoom or orbit with a button Drag on Move, Zoom or Rotate on the right shelf Help on any control Hold Ctrl and point at it (Ctrl+Alt: scripting parameters) Assign a shortcut Ctrl+Alt+click any button, then press the key Move or remove shelf items Ctrl+Alt+drag (with Enable Customize on) Tablet pressure Used automatically when a pen is detected (Pressure > Strength / Pressure > Size) Open files Drop a model (.obj, .glb ...), project, brush (.sfbrush), splat capture or image onto the window"},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"keys-inside-pop-ups-and-panels","h":"Keys inside pop-ups and panels","t":"Some keys only mean something while a pop-up or panel has the keyboard."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"brush-picker-b","h":"Brush picker (B)","t":"Key Action A letter Keep the brushes whose names start with the letters typed so far The orange letter on a tile Pick that brush (B S T = Standard) Backspace Take back one letter Enter Pick the first match Esc Close"},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"sliders-at-the-cursor-s-u-i-o","h":"Sliders at the cursor (S, U, I, O)","t":"Key Action Digits and . Type a value Enter Apply the typed value and close Esc Close without applying a typed value"},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"command-palette-f3","h":"Command palette (F3)","t":"Key Action Up / Down, Page Up / Page Down Choose a row Enter Run it Shift+Enter Open a command with parameters in the console to edit them Esc Close"},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"console-","h":"Console (`)","t":"Key Action Enter Run the line (statements separated by ;) Tab Complete a command or parameter name; press again to list the candidates Up / Down Walk through earlier lines (the last 200 are remembered between sessions)"},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"shortcut-capture-ctrlaltclick","h":"Shortcut capture (Ctrl+Alt+click)","t":"Key Action Any key or chord Becomes the new shortcut (taken from another action if it had it) Backspace or Delete Remove the shortcut Esc Cancel"},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"zbrush-keys-that-work-differently","h":"ZBrush keys that work differently","t":"ZBrush's keys and gestures work in SculptForge (with Preferences > Input > Style on ZBrush, the default). The few that differ, because the feature works differently or doesn't exist yet: ZBrush SculptForge P (perspective) P is the Paint brush; the view is always in perspective T (Edit mode) Always in Edit mode: there is no 2.5D canvas W / E / R (Transpose line) The Gizmo 3D (see Gizmo 3D) 1, 2, 3 (replay and record strokes) Not yet N (list the SubTools) Tool > SubTool in the right tray F1 to F6 (pop-ups) F1 is the Controls window, F3 the command palette; B, M and the left-shelf tiles pop up brushes, strokes, alphas and materials Ctrl+E (edge loop), Ctrl+U (reload ZScript) Export GLB and Send to Unreal H (hide the ZScript window) ` toggles the console See Coming from ZBrush for the whole list."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"see-also","h":"See also","t":"The interface Navigating the view Masking Polygroups and visibility"},{"p":"performance.html","c":"Performance and big meshes","a":"","h":"Performance and big meshes","t":"SculptForge is built to sculpt tens of millions of polygons. Brushes, normal updates and the picking structure run on every core of your processor, a stroke sends the graphics card only the part of the mesh it changed, and undo stores only the vertices a stroke touched, so it stays quick however big the model is. This chapter explains what to expect, the settings in Preferences > Performance, and how to get the most out of a big sculpt. Preferences > Performance after a stroke: antialiasing, Fast Navigation, multithreading, what the stroke cost per dab, and memory"},{"p":"performance.html","c":"Performance and big meshes","a":"what-to-expect","h":"What to expect","t":"On a 2021 laptop (Apple M1 Pro, 10 cores, integrated GPU), with X symmetry on and a medium Draw Size: Mesh One dab of a medium brush Turning the view 4 million triangles about 2 ms about 350 frames a second 16 million triangles about 4.5 ms about 170 frames a second 33 million triangles about 7.5 ms about 110 (4x antialiasing), 270 with Fast Navigation Turning the view stays smooth at 100 million triangles: about 50 frames a second with 4x antialiasing, 100 with Fast Navigation. These figures are for closed models (no holes); see \"Closed meshes draw faster\" below. A dab is one step of the brush along the stroke; the app draws several per frame when you move fast. Under 16 ms per dab a stroke keeps up with a 60 Hz display. Very large brushes cost more, since they move more vertices: a brush covering a tenth of a 33 million triangle sphere (about a million vertices per dab with symmetry) takes about 45 ms per dab with Standard, 21 ms with Smooth and 15 ms with Move, of which sending the change to the graphics card is about a third. Performance figures has the full measurements, and how to run the same benchmark on your own machine."},{"p":"performance.html","c":"Performance and big meshes","a":"preferences--performance","h":"Preferences > Performance","t":"Open Preferences and click Performance. Control What it does Antialiasing (Off, 2x, 4x, 8x) How many samples per pixel the 3D view uses to smooth edges. 4x is the default. More samples look smoother and cost more on huge meshes. If the graphics card can't make room for them, the view quietly uses fewer and the panel says so Fast Navigation While you rotate, pan or zoom a scene of 10 million triangles or more, draw it without antialiasing and draw big meshes as a lighter version with about a fifth of their triangles, so the view keeps up. The full mesh, smooth again, is back as soon as the view stops. On by default Multithreading Run brushes, normal and picking updates and project saving on every core (the number of threads is shown beside it). The results are exactly the same with it off; turn it off only to compare speeds or rule it out when something goes wrong Last stroke What your last stroke cost per dab: Brush (finding and moving the vertices), Normals (shading), BVH (the structure that finds the surface under the cursor), and the GPU upload per frame Memory What the scene holds: the meshes, the BVHs, the subdivision levels kept for stepping between them, the undo history (up to 1 GB; the oldest steps are dropped beyond that) and, roughly, the graphics card's buffers Like the other preferences, these last until you quit; Preferences > Config > Store Config keeps them. Every setting is also in the F3 command palette (type \"antialiasing\", \"fast navigation\" or \"multithreading\")."},{"p":"performance.html","c":"Performance and big meshes","a":"working-with-big-meshes","h":"Working with big meshes","t":"Sculpt at the lowest level that holds the detail. With subdivision levels you can shape the forms a few levels down and only go to the top for fine detail. Each level down is four times lighter. Hide what you're not working on. Hidden SubTools aren't drawn and hidden parts of a SubTool aren't sculpted (Tool > Visibility). A hidden SubTool costs no drawing time at all. Memory. A divided model takes about 85 bytes per triangle: about 37 for the sculpting mesh, 17 for its BVH and 29 for its subdivision levels. A 33 million triangle sculpt with levels needs about 3.4 GB of memory, a 100 million one about 9 GB (and a little more while dividing). Opening a project needs only a little more than the model itself. A mesh without levels (an import, a remesh) takes about 60 bytes per triangle for the mesh. Project files over 4 GB are saved in the ZIP64 format. How far Divide goes depends on the memory: about 160 million triangles on a computer with 32 GB. The graphics card. A mesh needs about 15 bytes per triangle on the graphics card (polypaint and a mask add about 3; the wireframe, while it is on, about 4; the lighter version Fast Navigation draws, once you move the view, about 1.5). If a SubTool doesn't fit, SculptForge doesn't draw it and says so in the status bar instead of failing: hide other SubTools or step down a subdivision level. Closed meshes draw faster. Parts of a mesh that face away from you are skipped when the mesh is closed (no holes or hidden parts) and you look at it from outside. A mesh with holes, hidden polygons, or a view from inside it draws everything, which can take about twice as long on huge meshes. Undo keeps only what each stroke changed, so a stroke on a 33 million triangle mesh undoes in a few tens of milliseconds, and the history holds many such strokes within its 1 GB."},{"p":"performance.html","c":"Performance and big meshes","a":"dynamic-topology","h":"Dynamic topology","t":"Dynamic topology only works where the brush is, so its speed depends on how many triangles the brush covers rather than on the size of the mesh: on an M1 Pro a medium dab takes 9 to 13 milliseconds on a one-million-triangle sphere. It gets slower when a big brush (or a low Detail) has to merge many small triangles at once; it then spreads the work over several dabs. Undoing a stroke rebuilds the mesh's connections, which takes about a tenth of a second per million triangles. sculptforge --bench --bench-dyntopo measures it on your machine."},{"p":"performance.html","c":"Performance and big meshes","a":"measuring-your-own-machine","h":"Measuring your own machine","t":"sculptforge --bench builds a sphere at 4, 16 and 32 million triangles and measures every brush, undo, stepping subdivision levels, saving and opening a project, and turning the view, then prints a report. sculptforge-cli --bench measures the same without the graphics card. Options: Option What it does --bench-sizes 4,16,32 The sizes, in millions of triangles --bench-dabs 40 Dabs per test stroke --bench-brushes large Only the brushes whose name contains the text (here the large-radius ones) --bench-no-project Skip saving and opening the project (which needs twice the memory) --bench-view Measure only what the view costs: uploading to the graphics card, a few strokes, and turning the view --bench-out report.md Write the report to a file The perf_info command (also in the Console) prints the threads in use and the memory the scene holds; set_multithreading enabled=false turns multithreading off from a script."},{"p":"performance.html","c":"Performance and big meshes","a":"see-also","h":"See also","t":"Subdivision levels Troubleshooting and FAQ Glossary"},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"","h":"Troubleshooting and FAQ","t":"This chapter collects fixes for common problems: start-up and graphics errors, tablets, AI service messages, ComfyUI errors, the camera notch, first-launch warnings on macOS and Windows, where SculptForge keeps its settings, how to reset the interface, and how to report a bug."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"sculptforge-doesnt-start","h":"SculptForge doesn't start","t":"SculptForge draws with OpenGL 3.3 (core profile). Almost every GPU from the last decade supports it, but an old driver, a remote desktop session or a virtual machine without 3D acceleration may not. Update your graphics driver from the GPU maker (NVIDIA, AMD, Intel) or your Linux distribution. Virtual machines: turn on 3D acceleration in the VM settings. Remote desktop: some remote sessions only offer an older OpenGL. Run SculptForge locally, or use a remote tool that forwards the GPU. Linux: on a machine without a working GPU driver, Mesa's software renderer works (slowly): LIBGL_ALWAYS_SOFTWARE=1 sculptforge. To see why it stopped, start it from a terminal and read the messages. It prints the OpenGL version and GPU it found at start-up (for example OpenGL 4.6 (Core Profile) Mesa 26.1.8 on ...), or the error, such as OpenGL 3.3 context creation failed or Missing OpenGL function: .... Linux: run sculptforge in a terminal. macOS: run /Applications/SculptForge.app/Contents/MacOS/SculptForge in Terminal. Windows: the release build has no console window; if it closes straight away, update the driver first."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"first-launch-warnings-on-macos-and-windows","h":"First launch warnings on macOS and Windows","t":"The release builds aren't code-signed yet, so the operating system warns the first time. macOS (Gatekeeper): \"SculptForge can't be opened because it is from an unidentified developer\". In Finder, right-click (or Ctrl+click) SculptForge in Applications and choose Open, then Open again. macOS remembers the choice. On recent macOS versions you may instead need System Settings Privacy & Security > Open Anyway. Windows (SmartScreen): \"Windows protected your PC\". Click More info, then Run anyway. Download SculptForge only from the official releases page on GitHub (the website that Help > Website & documentation opens links to it)."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"the-viewport-is-slow","h":"The viewport is slow","t":"Check the triangle count in the title strip (Tris). Millions of triangles on a laptop GPU are heavy; Tool > Geometry > Decimate or a lower Voxel Remesh resolution brings it down. See Subdivide, Remesh, Decimate and LODs. Turn off Wireframe (Shift+F) on dense meshes. Hide SubTools you aren't working on, or Solo the active one. A large Gaussian splat capture costs GPU time too: lower the count with Clean floaters, or untick Show in the Splats palette while you sculpt. On laptops with two GPUs, make sure SculptForge runs on the dedicated one (in the GPU maker's control panel or the operating system's graphics settings). Preferences > Performance: lower Antialiasing (or turn it off), keep Fast Navigation on, and look at Last stroke to see whether brushes or the graphics card take the time. Step down a subdivision level for big changes. See Performance and big meshes. A SubTool missing from the view with \"Not enough GPU memory\" in the status bar didn't fit on the graphics card: hide other SubTools or step down a level."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"pen-tablets","h":"Pen tablets","t":"SculptForge reads pen pressure through the operating system's standard pen input, so most Wacom, XP-Pen, Huion and similar tablets, and pen displays, work without settings. Open the Draw palette. Under Tablet it shows \"Pen pressure: 0.42\" once the pen has come near the tablet, or \"No pen detected\". Pressure > strength (on by default) and Pressure > size choose what pressure controls. They are also on the top shelf. A custom brush can also set its own pressure response (pressureCurve in its recipe, see Brush Lab and sharing brushes). If no pen is detected or pressure doesn't change: Install or update the tablet maker's driver, then restart SculptForge. Windows: most drivers have a Windows Ink option. If pressure doesn't reach SculptForge, try switching it (on or off) in the tablet driver's settings for SculptForge or for all applications, then restart SculptForge. Linux: check that the system sees the pen as a tablet (for example in your desktop's tablet settings). If the cursor moves but strokes have no pressure, test in another application to see whether the driver reports pressure at all."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"hugging-face-free-image-and-text-to-3d","h":"Hugging Face (free image and text to 3D)","t":"Message What to do Hugging Face's free GPU time is used up for now The anonymous daily allowance ran out. Add a free token (huggingface.co/settings/tokens, read access) in HF token in the Generate 3D window, or set HF_TOKEN; or wait for it to refill (about a day); or pick another model The Hugging Face Space is asleep or restarting The model's demo is starting up. Try again in a minute, or pick another model Waiting in the queue for a long time The demos are shared. Try a faster model (Hunyuan3D 2 mini Turbo, Stable Fast 3D) or another time of day TRELLIS.2 fails without a token TRELLIS.2 needs a Hugging Face token"},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"falai-and-meshy","h":"fal.ai and Meshy","t":"Message What to do The API key was rejected Check the key in the Generate 3D window, or the FAL_KEY / MESHY_API_KEY variable Out of credits on this account Top up your account with that service Model or endpoint not found Check the fal model id Rate limited Wait a moment and try again"},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"brush-lab","h":"Brush Lab","t":"The default Free provider uses a hosted open model with no account. If it is unreachable and Ollama runs on your computer, SculptForge uses your local model instead. \"Rate limited by the provider\" means too many requests in a short time: wait a few seconds. For setup of local models, see Brush Lab and sharing brushes."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"no-connection-at-all","h":"No connection at all","t":"AI features need internet access (except a local Ollama, LM Studio or ComfyUI). Behind a company proxy or firewall, ask IT to allow the service you use: huggingface.co (and *.hf.space), fal.ai, meshy.ai, or the Pollinations.ai text endpoint for the free Brush Lab model."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"comfyui-errors","h":"ComfyUI errors","t":"Message What to do Nothing is answering at http://... ComfyUI isn't running at that address, or a firewall blocks it. Check the address and port (8188 by default). For another computer, start ComfyUI with --listen ...answered, but not like ComfyUI Something else uses that port, or a proxy is in the way. Use the address ComfyUI prints when it starts This workflow was saved in ComfyUI's editor format Export it again in ComfyUI with Workflow > Export (API) This ComfyUI does not have the node ... or ...is missing the nodes ... Install the custom nodes the workflow uses (ComfyUI Manager > Install Missing Custom Nodes) and restart ComfyUI ...names a model file this server doesn't have Download the model into the right subfolder of ComfyUI's models folder, for example models/checkpoints ComfyUI rejected the workflow: node N ... An input is out of range. Open the workflow in ComfyUI: it shows the same error on that node The workflow finished but saved no mesh file End the workflow with Save GLB or another node that saves a mesh ...the GPU ran out of memory The GPU ran out of memory. Lower the resolution or octree size, or use a smaller model The job disappeared from ComfyUI's queue Someone cleared the queue or ComfyUI restarted. Generate again The workflow has no Load Image node You chose a text workflow on the From image tab. Use it from From text See Image and text to 3D for setup."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"the-top-of-the-window-is-hidden-behind-the-camera-notch","h":"The top of the window is hidden behind the camera notch","t":"On MacBooks with a camera notch, SculptForge keeps the interface below the notch when it fills the screen. If the title strip or palette bar is still covered, or a plain band appears where you don't want one, change Preferences > Interface > Camera notch: Automatic (asks the system on macOS, recognises notched MacBook displays on Linux), Always reserve, or Off. F11 switches between fullscreen and a window."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"text-and-buttons-are-too-small-or-too-large","h":"Text and buttons are too small or too large","t":"Preferences > Interface > UI scale sets the size (Automatic, 100% to 200%). It takes effect the next time SculptForge starts, and only if you press Store Config (Ctrl+Shift+I)."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"my-layout-or-shortcuts-are-gone-after-a-restart","h":"My layout or shortcuts are gone after a restart","t":"Like ZBrush, SculptForge never saves the layout on its own. Press Store Config (Ctrl+Shift+I) to keep the current layout, shortcuts and interface preferences. See The interface."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"reset-the-interface","h":"Reset the interface","t":"Preferences > Config > Restore Standard UI returns to the built-in layout and default shortcuts. Press Store Config afterwards to make it stick. Restore Custom UI goes back to what the last Store Config saved. To start completely fresh, quit SculptForge and delete ui.json (layout, shortcuts, interface preferences) and imgui.ini (positions of floating windows such as Brush Lab) from the settings folder below."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"a-key-does-nothing","h":"A key does nothing","t":"Shortcuts don't fire while you type in a text field: click the canvas first. Check the key in Help > Controls (F1), which shows every shortcut as currently assigned; a key you reassigned shows in orange in Preferences > Hotkeys, where Default shortcuts undoes every change."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"where-settings-live","h":"Where settings live","t":"SculptForge keeps its settings in one folder per user: System Settings folder Linux ~/.local/share/SculptForge/SculptForge/ (or $XDG_DATA_HOME/SculptForge/SculptForge/) macOS ~/Library/Application Support/SculptForge/SculptForge/ Windows %APPDATA%\\SculptForge\\SculptForge\\ (usually C:\\Users\\\\AppData\\Roaming\\SculptForge\\SculptForge\\) File or folder What it holds ui.json Layout, shortcut changes and interface preferences, written by Store Config imgui.ini Positions and sizes of floating windows ai.json AI settings: providers, models, keys, ComfyUI address (readable only by your account) project.json Recent files and the autosave interval autosave.sfproj The autosaved copy of unsaved work (removed once you save) clean_exit Marks a normal exit; without it, the autosave is offered for restore console_history.txt The console's command history recent_actions.txt Recently used entries of the command palette brushes/ Your brush library, one .sfbrush file per brush brush-gallery-cache/, brush-gallery.json Community brush gallery cache and its address thumbs/ Cached LightBox and picker thumbnails (safe to delete) Your library folder (projects, tools, alphas, images, splats and QuickSaves shown in the LightBox) is separate: Documents/SculptForge by default, changeable in Preferences > LightBox > Library folder. Tip: To move settings to another computer, copy ui.json, ai.json and the brushes folder. For a shared layout, use Preferences > Config > Save UI... and Load UI... instead."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"recovering-work-after-a-crash","h":"Recovering work after a crash","t":"SculptForge autosaves unsaved work every 5 minutes by default (Preferences > Autosave, 0 turns it off). After a crash, the next start asks \"SculptForge did not close normally last time. Restore the autosaved work?\". Restore opens it as unsaved work (save it under a name); Discard deletes it. See Projects, autosave and QuickSave."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"frequently-asked-questions","h":"Frequently asked questions","t":"Can SculptForge open ZBrush files (.ZTL, .ZPR)? Not directly: they are proprietary and undocumented. Convert ZTools once in ZBrush with the free SculptForge ZTool Export plug-in, then open the .ZTL in SculptForge (see Coming from ZBrush). Or use GoZ, or export OBJ or FBX from ZBrush (see Exporting, Send to Unreal and GoZ). .ZPR projects can't be converted; open their ZTools instead. Does it have subdivision levels, DynaMesh, ZRemesher or UVs? Voxel remesh works like DynaMesh, QRemesh like ZRemesher (with ProjectAll to bring the detail back; see Quad retopology), Auto UV unwraps any model, and Divide adds subdivision levels you can step up and down (see Subdivision levels). Dynamic on the top shelf is dynamic topology, like Sculptris Pro (see Dynamic topology). Is it really free? Can I sell what I make? Yes and yes. SculptForge is GPL-3.0-or-later free software; the licence covers the program, not your models. The AI models have their own licences (see Image and text to 3D). Does SculptForge send anything about me anywhere? No. There is no telemetry and no account. AI features talk only to the service you choose, when you use them. Does it work offline? Yes. Everything except the hosted AI services works offline, and Brush Lab and image-to-3D can run on local models (Ollama, LM Studio, your own ComfyUI or generator command). Where are my brushes? In the brushes folder in the settings folder above. Brush Lab saves every brush you make or refine there."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"report-a-problem","h":"Report a problem","t":"Choose Help > Report a problem to open the issue tracker on GitHub (you need a free GitHub account). A good report includes: The SculptForge version (Help > About SculptForge) and your operating system. Your GPU and driver: the OpenGL ... on ... line SculptForge prints at start-up (see SculptForge doesn't start), or the GPU name from your system settings. Steps to reproduce: what you did, what you expected and what happened instead. The commands you ran: open the console (the backtick key, left of 1), click Copy session as script and paste it into the report. It often reproduces the problem exactly. A file if the problem is with a particular model (a small .sfproj or the original file), and a screenshot for display problems. For a security problem, don't open a public issue; follow SECURITY.md in the repository instead."},{"p":"troubleshooting.html","c":"Troubleshooting and FAQ","a":"see-also","h":"See also","t":"Installing SculptForge The interface Glossary"},{"p":"glossary.html","c":"Glossary","a":"","h":"Glossary","t":"This chapter maps ZBrush terms to their SculptForge equivalents, so you can find a familiar tool quickly, and explains the terms that only SculptForge uses. \"Not yet\" means SculptForge doesn't have it today; see the roadmap for what is planned."},{"p":"glossary.html","c":"Glossary","a":"zbrush-terms-in-sculptforge","h":"ZBrush terms in SculptForge","t":"ZBrush SculptForge Alpha Alpha: built-in round, square and noise, or any grayscale image. Left shelf, Alpha palette. See Sculpting Auto Groups Tool > Polygroups > By pieces (polygroup_by_connectivity) BPR render Not yet as a renderer. Headless renders and turntables with sculptforge --render (Scripting) Brush pop-up (B) Brush picker, B, then type letters (B S T = Standard) Clip brushes Not yet. The Trim brush shaves to a plane Curve brushes, IMM, ZModeler, ZSpheres Not yet Decimation Master Tool > Geometry > Decimate (decimate). See Geometry Del Hidden Tool > Visibility > Delete hidden (delete_hidden) Del Lower, Del Higher Tool > Geometry > Del Lower / Del Higher (subdiv_delete_lower, subdiv_delete_higher). See Subdivision levels Divide (Ctrl+D), Smt Tool > Geometry > Divide, Ctrl+D, with Smt beside it (subdiv_divide). See Subdivision levels Document, 2.5D canvas, pixols Not planned: SculptForge is a 3D sculpting app only Draw Size Draw Size (top shelf, S, [ / ]) DynaMesh Voxel Remesh (Tool > Remesh, remesh). See Geometry Focal Shift No slider for the built-in brushes. Custom brushes have Hardness and Tip sharpness in their recipe Ghost, Transp Not yet. Inactive SubTools are drawn slightly dimmed GoZ GoZ: .GoZ import and export and the GoZ bridge (File > ZBrush (GoZ)). See Exporting Group Masked Tool > Polygroups > From mask (polygroup_from_mask) Group Visible Tool > Polygroups > Merge visible (polygroup_merge_visible) Groups By Normals Tool > Polygroups > By normals with an angle (polygroup_auto_by_normals) Bake, Multi Map Exporter (normal / displacement / AO maps) Tool > Bake (bake): tangent and object-space normal, displacement, AO, cavity and colour maps from a high-poly SubTool onto a low-poly's UVs. See Baking Layers (sculpt layers) Tool > Layers: sculpt layers with weights, exported as blend shapes. See Layers LazyMouse LazyMouse stroke type (Stroke palette) LightBox LightBox, , (comma) Live Boolean Not yet Local symmetry, radial symmetry Not yet. Symmetry is X, Y and Z across the world axes Mask by Cavity Tool > Masking > By cavity (mask_by_cavity) Masking (Ctrl) Hold Ctrl to paint the mask, Ctrl+Alt to erase. See Masking MaskLasso, MaskRect Tool > Masking: pick the shape, then Ctrl+drag (add Alt to unmask). See Masking MatCap Material: seven MatCaps, Sculpt the default, plus Studio (M). Custom MatCap images not yet. See Polypaint Morph target A sculpt layer; exported as glTF morph targets and FBX/USD blend shapes Mrgb, M (material channel) Not yet: there is no per-vertex material channel Polyframe (PolyF, Shift+F) PolyF on the right shelf, or Shift+F Polygroups Polygroups: same idea, same Ctrl+Shift gestures. See Polygroups and visibility Polypaint Polypaint: Paint brush (P), Rgb, fills, cavity paint. See Polypaint Polypaint layers Tool > Paint Layers: Photoshop-style colour layers with blend modes. See Paint layers Project All (ProjectAll) Tool > SubTool > Project > ProjectAll (project_all), with Dist, Mean and PA Blur; respects the mask. See Quad retopology Projection Master Not yet. Generate > Stamp projects an image onto the model from the view QuickSave QuickSave in the title strip; the last 10 are kept. See Projects Rgb Rgb on the top shelf (paint while sculpting) Rgb Intensity, Z Intensity, Focal Shift Same names and keys: RGB Intensity (I), Z Intensity (U), Focal Shift (O) in the Draw palette and the QuickMenu Sculptris Pro, dynamic topology Dynamic on the top shelf, with Detail (dyntopo). See Dynamic topology Reconstruct Subdiv Tool > Geometry > Reconstruct Subdiv (subdiv_reconstruct) SDiv, Lower Res / Higher Res (Shift+D / D) Tool > Geometry: the SDiv slider, Lower Res Shift+D, Higher Res D (subdiv_level). See Subdivision levels SelectLasso, SelectRect Tool > Visibility: pick the shape, then Ctrl+Shift+drag (add Alt to hide). See Polygroups Solo Solo on the right shelf or in Tool > SubTool Spotlight Not yet Preferences > Performance, Preferences > Mem Preferences > Performance: Antialiasing, Fast Navigation,"},{"p":"glossary.html","c":"Glossary","a":"sculptforge-terms","h":"SculptForge terms","t":"Term Meaning Brush Lab The AI brush creator: describe a brush in words and it builds a recipe you can tweak. Opens from AI Brush. See Brush Lab Brush code One line of text (sfbrush1:...) that holds a whole brush, for sharing in chat or a forum. Paste with Ctrl+V Brush library Your saved custom brushes, loaded at every start Brush recipe The data that defines a custom brush (direction, depth, plane, pinch, pattern and so on): values, never code .sfbrush A file holding one brush recipe .sfproj A SculptForge project file: the whole scene. See Projects Cross field The directions QRemesh wants quad edges to follow at every point of the surface, smoothed over the whole model. Singularities (where three or five quads meet) appear where the field must turn Command palette F3: search every command, brush and setting by name and run it Community gallery Shared CC0 brushes you can install in one click (Community brushes) Console The script console (backtick key): every action appears as a script line Ctrl help Hold Ctrl and point at a control to see what it does, its shortcut and its command Gaussian splat A 3D capture made of soft coloured blobs (from phone scanning apps). Load one as a reference, make it a sculptable mesh, or turn a sculpt into splats. See Gaussian splats and From scan to sculptable mesh Falloff (Gizmo 3D) How far a gizmo move eases in from the mask's edge, as a share of the SubTool's size: a soft joint when posing. See Gizmo 3D Generate 3D Turn an image or a description into a sculptable model. See Image and text to 3D Gizmo 3D The Move / Scale / Rotate handles (W E R) for placing and posing a SubTool or its unmasked part. See Gizmo 3D LOD chain A series of lighter copies of a model (LOD0, LOD1...) for game engines. See Geometry MCP Model Context Protocol: sculptforge-cli --mcp lets AI agents such as Claude run SculptForge commands Pivot The point the Gizmo 3D turns and scales about. Alt+click the model to put it there. See The pivot Subdivide One-way subdivision without levels (Tool > Geometry > Subdivide, subdivide); Divide keeps the levels Send to Unreal Export and import a model into a running Unreal Editor in one step (Ctrl+U) Shelves, palettes, trays The interface around the canvas: shelves hold the most-used controls, palettes hold everything, trays hold pinned palettes. See The interface Studio brush folder A shared, read-only brush folder for a team (SCULPTFORGE_BRUSH_PATH). See For studios Paint target (Vertex / Texture) Where painting goes on a SubTool that has a texture: its vertices (polypaint) or its texture. Top shelf, next to Rgb. See Texture painting QRemesh SculptForge's automatic quad retopology (ZBrush's ZRemesher), in Tool > Geometry. See Quad retopology Mirror plane (QRemesh) The plane QRemesh's Symmetry mirrors across: the model's own middle (the world's centre plane when the model is symmetric about it), found from the model. Like ZBrush's local symmetry. See Quad retopology Padding (gutter) The few texels around each UV island that texture painting and baking also fill, so seams don't show. See Texture painting and Baking Bake Capture a high-poly's detail as images (maps) on a low-poly's UVs. See Baking Cage (front / rear distance) How far in front of and behind the low-poly the bake's rays look for the high-poly. See Baking Displacement map A map of how far the high-poly lies from the low-poly along its normal; mid-grey = 0. See Baking Keep Texture Remesh option (Voxel Remesh, QRemesh): give the new surface Auto UVs and project the painted texture onto it, so the paint survives. See Texture painting MikkTSpace The standard way of computing tangents that game engines share, so tangent-space normal maps look the same everywhere. See Baking Normal map A map of surface directions that makes a low-poly shade like the high-poly. Tangent-space maps are relative to the surface (for engines), object-space maps to the model. See Baking Texel One pixel of a texture. Texture painting paints texels; their"},{"p":"glossary.html","c":"Glossary","a":"see-also","h":"See also","t":"Welcome to SculptForge The interface Keyboard and mouse reference"}];