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
Monthly challenge: submissions close on the 27th, vote until the end of the month
islandmede4e4bacd985d
diff --git a/.github/workflows/monthly-challenge.yml b/.github/workflows/monthly-challenge.ymlindex e5887ec4..a05db8fe 100644--- a/.github/workflows/monthly-challenge.yml+++ b/.github/workflows/monthly-challenge.yml@@ -1,23 +1,12 @@-# Monthly sculpt challenge on the community Discord: on the 1st it announces the month's theme (next line of-# .github/challenges.txt), on the 24th a one-week reminder, on the last day "submissions closed, winner picked-# tomorrow". The team picks last month's winner by hand on the 1st (most π₯ votes, ties picked by the team).-# Posts go through a channel webhook stored in the DISCORD_CHALLENGE_WEBHOOK secret; without the secret the job-# skips. No checkout of untrusted code, no other secrets; the message text comes only from this repository.+# Monthly sculpt challenge: .github/challenges.txt is the theme list. The schedule itself (theme on the 1st, reminder on+# the 20th, Discord event for the 27th, gallery + poll on the 28th, winner on the 1st) runs from ~/Work/.sf/challenge.py+# on the sf-challenge.timer, which reads the themes from this repository. This workflow is only a manual fallback that+# posts the current month's theme through the DISCORD_CHALLENGE_WEBHOOK secret (the runtime recognises that post and+# won't post it again); without the secret it skips. No checkout of untrusted code, no other secrets.name: Monthly challengeon:- schedule:- - cron: "0 16 1 * *" # theme announcement- - cron: "0 16 24 * *" # one week left- - cron: "0 16 28-31 * *" # closes on the last day of the month (the script checks)workflow_dispatch:- inputs:- kind:- description: "Post now: announce, reminder or close"- required: true- default: announce- type: choice- options: [announce, reminder, close]permissions:contents: read@@ -34,9 +23,6 @@ jobs:- name: Post to Discordenv:WEBHOOK: ${{ secrets.DISCORD_CHALLENGE_WEBHOOK }}- KIND: ${{ inputs.kind }}- EVENT: ${{ github.event_name }}- SCHEDULE: ${{ github.event.schedule }}run: |python3 - <<'EOF'import datetime, json, os, sys, urllib.request@@ -44,15 +30,6 @@ jobs:if not hook:print("DISCORD_CHALLENGE_WEBHOOK is not set; nothing to post."); sys.exit(0)today = datetime.date.today()- kind = os.environ.get("KIND") or ""- if os.environ["EVENT"] == "schedule":- sched = os.environ["SCHEDULE"]- if sched.startswith("0 16 1 "): kind = "announce"- elif sched.startswith("0 16 24 "): kind = "reminder"- else:- if (today + datetime.timedelta(days=1)).month == today.month:- print("Not the last day of the month."); sys.exit(0)- kind = "close"themes = [l.strip() for l in open(".github/challenges.txt", encoding="utf-8")if l.strip() and not l.lstrip().startswith("#")]start = (2026, 11) # November 2026 uses the first theme@@ -60,22 +37,15 @@ jobs:name, _, prompt = themes[idx].partition("|")name, prompt = name.strip(), prompt.strip()month = today.strftime("%B")- if kind == "announce":- text = (f"# π {month} challenge: **{name}**\n{prompt}\n\n"- "Post your entry in this channel any time this month (WIPs welcome in #wip-and-feedback). "- "Entries close on the last day of the month, and the winner is picked on the 1st of next month: "- "most π₯ votes wins, ties are picked by the team. Vote with π₯ on your favourites! The winner "- "gets **Featured Artist** and a spot on sculptforge.app. Any app is fine, but we'd love to see "- "what you make in SculptForge!")- elif kind == "reminder":- text = f"β° One week left for the {month} challenge: **{name}**. Get those entries in!"- else:- text = (f"π Submissions for the {month} challenge (**{name}**) are closed. Last chance to vote with π₯. "- "Winner picked tomorrow, together with next month's theme!")+ text = (f"# π {month} challenge: **{name}**\n{prompt}\n\n"+ "Post your entry in this channel as an image (WIPs welcome in #wip-and-feedback). Submissions close on "+ f"the 27th of {month} at 23:59 (server time), then everyone votes in a poll here until the end of the "+ "month. Your latest image counts as your entry. The winner gets **Featured Artist** and a spot on "+ "sculptforge.app. Any app is fine, but we'd love to see what you make in SculptForge!")body = json.dumps({"content": text, "username": "SculptForge Challenges","allowed_mentions": {"parse": []}}).encode()req = urllib.request.Request(hook, data=body, headers={"Content-Type": "application/json","User-Agent": "SculptForge-challenge"})with urllib.request.urlopen(req, timeout=30) as r:- print(kind, name, r.status)+ print("announce", name, r.status)EOFdiff --git a/changes/feat-challenge-schedule.md b/changes/feat-challenge-schedule.mdnew file mode 100644index 00000000..5e864cc8--- /dev/null+++ b/changes/feat-challenge-schedule.md@@ -0,0 +1,7 @@+---+changed: **Monthly challenge** on Discord: submissions close on the 27th at 23:59, then everyone votes in a Discord+ poll until the end of the month; the winner (Featured Artist and a spot on sculptforge.app) is announced on the 1st.+ The website and the guide's Discord page say so.+---+Runtime: ~/Work/.sf/challenge.py on sf-challenge.timer (theme, reminder on the 20th, event, gallery + poll, winner).+The GitHub workflow keeps only a manual theme fallback; .github/challenges.txt stays the theme list.diff --git a/docs/guide/discord.md b/docs/guide/discord.mdindex 44a9d4ae..87e78bdf 100644--- a/docs/guide/discord.md+++ b/docs/guide/discord.md@@ -12,7 +12,8 @@ its icon and how long you've been at it. It's off until you switch it on.Two extras, both off until you check them:- **Show the monthly challenge** adds a line "Monthly challenge: *theme*", with the theme you type in the box under- it (64 characters at most). Handy while you work on the community's monthly challenge.+ it (64 characters at most). Handy while you work on the community's monthly challenge (a new theme on the 1st;+ submissions close on the 27th, vote until the end of the month).- **Show the file name** adds the name of the file you have open, for example `kraken.sfproj`. Only the name, neverthe folder it's in.diff --git a/docs/releasing.md b/docs/releasing.mdindex 6ba8ef98..dcec80ec 100644--- a/docs/releasing.md+++ b/docs/releasing.md@@ -235,7 +235,8 @@ automatically.100: give them the Discord role, `taken` + 1, and their name in `names` only if they want it listed. The website'scounter and Members page read it live; the app compiles it in (Help > About, and the membership card's foundingnote, which stops once `taken` reaches `limit`).-- **Monthly challenge results:** on the 1st, when the winner is picked (most π₯, ties by the team), add+- **Monthly challenge results:** on the 1st, when the winner is announced (submissions close on the 27th, vote until the end of the+ month in a Discord poll; `~/Work/.sf/challenge.py` on sf-challenge.timer runs it, ties go to the coordinator), add`"challenge": {"id": "YYYY-MM", "title": "<theme>"}` to `website/latest.json` (push main; the site deploys). Theapp's daily update check reads it once per id: the small membership card's challenge moment ("The <theme>challenge results are in, on Discord").diff --git a/website/guide/discord.html b/website/guide/discord.htmlindex d538e931..a94ca243 100644--- a/website/guide/discord.html+++ b/website/guide/discord.html@@ -68,7 +68,7 @@ Keep the Discord desktop app running on the same computer. Your status appears w<p>Two extras, both off until you check them:</p><ul><li>-<strong>Show the monthly challenge</strong> adds a line "Monthly challenge: <em>theme</em>", with the theme you type in the box under it (64 characters at most). Handy while you work on the community's monthly challenge.+<strong>Show the monthly challenge</strong> adds a line "Monthly challenge: <em>theme</em>", with the theme you type in the box under it (64 characters at most). Handy while you work on the community's monthly challenge (a new theme on the 1st; submissions close on the 27th, vote until the end of the month).</li><li><strong>Show the file name</strong> adds the name of the file you have open, for example <code>kraken.sfproj</code>. Only the name, never the folder it's in.diff --git a/website/guide/search-index.js b/website/guide/search-index.jsindex 53644928..acd2f5e5 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 Parts, how to generate models with AI, and how to get your work into a game engine, a film pipeline, Blender or another sculpting app. It is updated with every release; What's new lists what changed. Read it inside SculptForge (Help > User Guide, or Shift+F1) or on the SculptForge website."},{"p":"index.html","c":"SculptForge User Guide","a":"start-here","h":"Start here","t":"You want to Read Install it Install SculptForge: downloads for Windows, macOS and Linux Set it up on Windows The Windows notes: SmartScreen, pen tablets (Windows Ink, Mouse mode), screen scaling Make your first sculpt Your first sculpt in 10 minutes: a cute owl head from the default sphere Start from a head or body Starter meshes: base meshes with clean quads, File > New from Starter Mesh Find your way around The interface: the menus File, Edit, Sculpt, Paint, Mesh, View, Render, Help, the shelves and the Tool panel; Navigating the view Learn the brushes Sculpting and brushes Switch from another sculpting app Quick tour for experienced sculptors (the Classic layout and keys) and the Glossary Switch from Blender Blender keys, and Working with Blender for the bridge add-on Fix a problem Troubleshooting 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 Your first sculpt in 10 minutes What's new Quick tour for experienced sculptors Install SculptForge on Windows, macOS and Linux 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 Brush packs: sixty built-in brushes Masking Face Groups and visibility Selection sets and morph targets Parts Linked Duplicates Forge Spheres Tube: draw in 3D space Vertex Paint and materials Texture painting UV Editor Material painting (PBR) Fill layers, Mesh Maps and Material Recipes Sculpt layers and blend shapes Facial shapes and live face Subdivision levels Micro levels: hundreds of millions of polygons Dynamic topology Sculpt Timeline and timelapse Moving, rotating and posing (Gizmo) Subdivide, remesh, decimate and LODs Cut: line, lasso, rectangle and polyline 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 Bridge Export presets Working with Blender Working with Maya Projects, autosave and Snapshots Scripting and automation Packs and macros SculptForge for studios Security overview for IT reviews"},{"p":"index.html","c":"SculptForge User Guide","a":"reference","h":"Reference","t":"Keyboard and mouse Performance and big meshes Troubleshooting: tablets, display, crashes and FAQ Glossary Show SculptForge on Discord"},{"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 experienced sculptors already know. Its menus are grouped by task (File, Edit, Sculpt, Paint, Mesh, View, Render, Help), with shelves around the canvas, a Library of thumbnails and pop-up pickers; a Classic layout with alphabetical palettes is one click away. It runs natively on Windows, macOS and Linux, starts in a moment, works offline and costs nothing. The Classic sculpting keys and gestures are one choice away: answer Classic sculpting keys when the first start asks what you are coming from, or pick Classic in Edit > Preferences > Input. See Quick tour for experienced sculptors. 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. SculptForge stays free and works the same for everyone; nothing is ever paywalled. A membership adds betas and early builds (from SculptForge 1.0, each release about two weeks early), a vote on what gets built, Member Requests (ask for a brush, alpha or material) and your name in the credits (every release stays free for everyone; bug-fix and security releases go out to everyone the same day): Help > Support SculptForge... opens sculptforge.app/support.html in your browser, where you can become a member. That is all it does: the app has no payment code, no account and no licence check. Members are thanked by name in Help > About; the small heart at the right of the top bar opens the membership page too (members see a small badge there instead). The first start shows the memberships once (Edit > Preferences > Support > Show the memberships shows them again). After that, a small card along the bottom of the canvas may come at a good moment: about 20 minutes of sculpting, a Save Render, the first start after an update, the monthly challenge results, or a milestone (your 10th start, 10 hours of sculpting, your 100th save, counted on your computer only and never sent). It comes at most once a week and never mid-stroke. Not now waits a week; after the third, a month; after the sixth, it only comes with an update. I'm already a member signs in with GitHub (as member builds do) and hides it for good."},{"p":"welcome.html","c":"Welcome to SculptForge","a":"what-you-can-do-with-it","h":"What you can do with it","t":"Sculpt with more than twenty built-in brushes (Standard, Clay, Clay Block, Sharp Crease, Move, Smooth, Inflate, Pinch, Flatten, Crease, Trim, Tendril, Layer, Nudge, VDM, the Kelvinlet brushes and more), 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: Ctrl to paint a mask, Ctrl+Shift to isolate a face group. See Masking and Face Groups and visibility. Keep separate meshes as Parts (body, eyes, teeth, armour), each with its own undo history. See Parts. Paint colour on the surface (vertex paint) and look at the model through the built-in Lit Sphere materials or your own. See Vertex Paint 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 voxel remesh), 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 another sculpting app through the Bridge. See Exporting, Unreal and Bridge. 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.10; see What's new). Some things experienced sculptors rely on are still on the roadmap: Painting across UDIM tiles (the UV Editor lays them out; painting covers tile 1001). Booleans and stencils. Others are not on the roadmap: poly modeling, the 2.5D canvas, and reading other sculpting apps' own project files directly. Not yet: where a chapter describes a 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":"quick-tour-for-experienced-sculptors","h":"Quick tour for experienced sculptors","t":"Most habits carry over, and Edit > Preferences > Interface > Look > Layout > Classic brings back the alphabetical palette bar. 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 Parts, Masking and Face Groups sub-palettes, B opens the brush pop-up with the same letter keys (B, S, T picks Standard), , opens the Library, your preferences save themselves, and S U I O, Space, Ctrl+W and the mask keys do what your hands expect with the Classic sculpting keys on (Edit > Preferences > Input). Quick tour for experienced sculptors lists what is the same, what differs and every shortcut side by side; the Glossary explains SculptForge's terms."},{"p":"welcome.html","c":"Welcome to SculptForge","a":"how-this-guide-is-organised","h":"How this guide is organised","t":"Getting started: installing (with Windows notes), the interface, navigating the view and troubleshooting. Sculpting: brushes, Brush Lab, masking, face groups, Parts, vertex paint, 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). The form asks for your hardware: operating system, CPU and RAM, graphics card and driver, and your tablet and its driver if you use one. Add what you did just before the problem; see Troubleshooting and FAQ for what else helps. Help > Website & documentation opens the SculptForge website. For questions, tips and showing your work, Help > Join the Discord... opens the invite to the official SculptForge Discord in your browser. Bugs still go to the issue tracker, so they can be tracked and fixed."},{"p":"welcome.html","c":"Welcome to SculptForge","a":"see-also","h":"See also","t":"Installing SculptForge The interface Glossary"},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"","h":"Your first sculpt in 10 minutes","t":"Never sculpted before? In about ten minutes this lesson turns the default sphere into a cute owl head: ear tufts, a heart-shaped face, big amber eyes under stern brows and a little orange beak. It ends with a render you can share. You only need the built-in brushes, a mouse (a pen tablet is nicer, but not required) and these twelve steps. The finished owl The lesson uses the default look: the SculptForge layout, with the menus File, Edit, Sculpt, Paint, Mesh, View, Render, Help along the top, a tool shelf under them, the brushes along the bottom and the Tool panel on the right. If you switched to the Classic layout, the Classic layout notes say where things are there; Preferences, for one, has its own name in the palette bar there instead of sitting under Edit (where Preferences is). Every step can be undone with Ctrl+Z, so experiment freely. Each brush remembers its own size. To set it, hold the cursor over the canvas, press S, type the number the step gives and press Enter (or drag the slider that appears). [ and ] make it smaller and bigger. Tip: Help > Your first sculpt (10 min) opens this lesson inside SculptForge any time; Shift+F1 hides it and shows it again where you left off."},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"1-start-with-a-sphere","h":"1. Start with a sphere","t":"Goal: a fresh sphere, seen from the front. Press Ctrl+N (File > New Sphere). Press F to frame it. To look around: drag on the empty background to rotate, Alt + drag on the background to move the view, scroll to zoom. Press F again whenever you lose it. Check that X is lit on the tool shelf: symmetry is on, so everything you do on one side happens on the other. The default sphere in the SculptForge layout Tip: right-drag anywhere rotates the view too, even over the model. See Navigating the view."},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"2-pull-up-the-ear-tufts","h":"2. Pull up the ear tufts","t":"Goal: two pointed tufts on top of the head. Pick Move: press 4, or click Move on the bottom shelf. Set its size to 110. Start on the top of the sphere, a little left of the middle, and drag up and out. Symmetry pulls the right tuft. Two ear tufts pulled up with Move Tip: if the view turns instead, you started on the background. Undo and start the drag a little further inside the sphere."},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"3-dig-the-face","h":"3. Dig the face","t":"Goal: two round hollows, the owl's face discs. Pick Clay: press 2. Set its size to 120. Hold Alt and click four times where the left eye goes, a little left of the middle and halfway down. With Alt, Clay digs in instead of building up. Two face discs dug with Alt+Clay Tip: a click is one dab of the brush. Several clicks in one place build up (or dig) more."},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"4-shape-the-beak","h":"4. Shape the beak","t":"Goal: a small pointed beak between the eyes. Pick Inflate: press 5. Set its size to 30 and click three times on the middle line, just below the face discs: a bump. Pick Move (4), size 30. Drag from the bump a short way down: it points. Pick Smooth (3), size 24, and drag once down the beak to tidy it. The beak Tip: hold Shift and drag to smooth with any brush, whenever a stroke leaves a lump."},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"5-divide-three-times","h":"5. Divide three times","t":"Goal: enough polygons for crisp eyes and colours. Press Ctrl+D three times (Tool > Geometry > Divide). Each Divide makes four polygons out of every one and smooths the shape: about 5 million triangles now. Divided three times: the same shape, smoother Tip: sculptors block out the big shapes on a light mesh, then divide for details. Shift+D and D step down and up the levels. See Subdivision levels."},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"6-add-the-eyes","h":"6. Add the eyes","t":"Goal: big round eyeballs in the face discs. Pick Inflate (5), size 52. Click three times in the middle of the left face disc. Symmetry adds the right eye. Eyes inflated in the face discs Tip: Inflate swells the surface along its normals, so dabs make round, even bulges."},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"7-give-it-brows","h":"7. Give it brows","t":"Goal: a V of brows that gives the owl its look. Pick Clay (2), size 30. Drag twice from between the eyes up and out over the left eye. Brows built up with Clay Tip: the angle of the brows sets the mood: up and out for a stern owl, flatter for a sleepy one."},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"8-colour-it-brown","h":"8. Colour it brown","t":"Goal: warm brown feathers everywhere. Open Paint. In Vertex Paint & Color, pick a warm brown in the colour wheel and click Fill. The owl filled brown"},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"9-paint-the-face","h":"9. Paint the face","t":"Goal: soft cream face discs. Press P (or click Paint on the tool shelf): the brush now paints colour without changing the shape. Set its size to 100. Make the edge soft: with the cursor over the canvas press O (Falloff), type 0 and press Enter. Pick a cream colour and click twice on the left face disc. Cream face discs Tip: a soft edge blends one colour into the next, like feathers."},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"10-paint-the-eyes","h":"10. Paint the eyes","t":"Goal: amber eyes with black pupils and a glint. Give the brush a hard edge: O, type -100, Enter. Size 44, amber: click once in the middle of the left eye. Size 24, black: click once in the same spot for the pupil. Size 8, white: click once at the top left of the pupil for the glint. Amber eyes, pupils and glints Tip: C over the model picks up the colour under the cursor, and Alt paints back towards white. See Vertex Paint."},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"11-paint-the-beak-and-tufts","h":"11. Paint the beak and tufts","t":"Goal: an orange beak and darker tuft tips. Size 16, orange: drag down the beak, twice. Soft edge again (O, 0, Enter), size 70, dark brown: click twice on the tip of the left tuft. Press P again to go back to sculpting. Beak and tufts painted"},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"12-shade-it-and-save-a-render","h":"12. Shade it and save a render","t":"Goal: a picture of your sculpt to share. Press M over the canvas and click White: a clean material that shows your colours. Open Render > Materials and click PBR under Viewport Shading: soft studio light with gentle reflections. Turn the view to a three-quarter angle, a little from above, and press F. Click Save Render at the bottom of Render > Materials. The status bar names the picture (twice the size of the view); find it under Library > Image. Size and the shape buttons (1:1, 16:9, 9:16, 4:3) below it make a bigger or differently shaped picture, as a PNG or a JPG. Light, above it, turns the light around the model. Press Ctrl+S to save the project. Render > Materials with PBR shading and Save Render Well done: that's a sculpt, painted and rendered."},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"whats-next","h":"What's next","t":"Share it in #show-your-sculpts on the SculptForge Discord. We'd love to see it. Try every brush and the keys that change them: Sculpting and brushes. Masks by brush, lasso, rectangle and cavity: Masking. Paint layers, cavity paint and Lit Sphere materials: Vertex Paint and materials. Find your way around the menus and shelves: The interface."},{"p":"whats-new.html","c":"What's new","a":"","h":"What's new","t":"What changed in each version of SculptForge, newest first. The first time you start a new version, a window shows its main features, each with a Try it button; Help > What's New opens it again. Below are the last three versions in full, then the older ones in groups. Every detail is in the changelog."},{"p":"whats-new.html","c":"What's new","a":"version-01115","h":"Version 0.11.15","t":"Tube: draw clay tubes in the air like a 3D pen. Tool > Tube > Draw Tube, then drag anywhere: on the model, off it, or out of it. Pen pressure thins the tube; drag its points afterwards to reshape it, then Bake to sculpt it, or draw straight into the active Part with Merge (even edges, ready for dynamic topology). Thanks to GABO on Discord for the idea. Hardware tiers and Turbo: SculptForge sorts your computer into a tier (Essential, Standard, High, Extreme) and switches on what it can carry: more Focus Detail memory, 16K textures. A card on first launch says what it found; the tier sits in the top bar. The new bolt (View > Turbo, Ctrl+Alt+T) trades antialiasing and detail while you sculpt and orbit for speed, and puts everything back the moment you stop. Split > Hidden / Masked / Unmasked (Tool > Parts): move the hidden, masked or unmasked triangles of a Part into a new Part just below it, in one undo step. Asked for by foirgairwolf on Discord. Delete masked (Tool > Visibility) deletes what is masked, as Delete hidden does for what is hidden. Undoable. Smooth or flat per Part, right in the list: click the mark left of a Part's eye to go from the scene's shading to Smooth to Flat. Merge by Distance (Tool > Geometry): merge points closer than a distance, with a live count and the points shown on the model before you click. For unwelded imports. Asked for by foirgairwolf on Discord. Check Mesh (Tool > Geometry): counts non-manifold edges, holes, duplicate, degenerate, zero-area and flipped triangles and isolated points, with a Fix per row and Fix all. Checking never changes the mesh. Recent colours: the last eight colours you painted with sit under the colour picker on the left shelf; click one to paint with it again. Thanks Oslen on Discord. Frame (F) fits the model into the part of the canvas the open Library and the Sculpt Timeline leave free, and the left shelf's brush tiles and colour picker shrink to fit short screens. Pen view speed: Preferences > Tablet > View speed sets how fast the pen turns, pans and zooms the view, apart from the mouse. Turn it down if the view spins too fast with a tablet. Thanks to GonzaloHernandez3D on Reddit."},{"p":"whats-new.html","c":"What's new","a":"version-01114","h":"Version 0.11.14","t":"Deformation stack (requested by foirgairwolf on Discord): Tool > Deformation > Stack bends, twists, tapers, shears, turns, moves, scales, squashes, rounds, boxes, flattens, sags or puts depth on the whole Part, along any of X, Y and Z, with a live preview. Stack steps up, switch them on and off, repeat one, then Apply (one undo step), Apply Selected or Reset. Every step is a command too: deform_stack ops=\"bend 45 y soft; twist 90 y\". Exact size (requested by foirgairwolf on Discord): Tool > Deformation > Size shows the Part's width, height and depth in scene units; drag one or type an exact value to resize it, with Uniform keeping its proportions. Membership moments: the small membership card can now also come at a milestone (your 10th start, 10 hours of sculpting, your 100th save; counted on your computer only, never sent) and says the true number. After a third Not now it waits a month, after a sixth it only comes with an update. A quiet heart at the right of the top bar opens Help > Support SculptForge...; members see a small badge there instead. Requested by a member: changes members asked for through Member Requests are marked in What's New. Slimmer Library and timeline: the Library strip and the Sculpt Timeline under it take about a third less of the viewport's height. The timeline is one thin row (the full strip is one click away, or Edit > Preferences > Interface > Compact timeline), and you can drag the Library's edge to size its thumbnails. Thanks factoberplay on YouTube."},{"p":"whats-new.html","c":"What's new","a":"version-01113","h":"Version 0.11.13","t":"Remove flat background: Image to 3D drops the flat plane a picture's background often turns into (a wall behind or a ground under the subject) before the model lands. On by default in Generate 3D; Undo brings a removed plane back. Thanks fenix on Discord. Linked Duplicates: Tool > Parts > Linked Duplicate makes a copy that shares the Part's mesh but sits in its own place. Sculpt, paint or mask any of them and all change; move, turn or scale each with the Gizmo. Make Unique gives one its own mesh again. Hundreds of copies cost about one mesh. Orbit lock: View > Orbit lock turns the view about one axis only: Free, Y (turntable), X or Z (Alt+Shift+F / Y / X / Z). The axis gizmo shows which axis is locked. Thanks foirgairwolf on Discord for the idea. Version at a glance: the window title and the top bar show the SculptForge version, so a screenshot says which one you run. A beta's tag shows in the accent colour. Reconstruct Subdiv keeps UVs on the lower levels of a high-poly that was unwrapped on its own: no more faces stretched across UDIM tiles, even with overlapping islands. Timelapse videos of dense sculpts no longer flicker (Edit > Export timelapse...). The membership card now shows the Studio membership's flat price for any number of artists."},{"p":"whats-new.html","c":"What's new","a":"version-01112","h":"Version 0.11.12","t":"Names you type in Chinese, Japanese or Korean (Parts, folders, layers, brush sets, files, Library items) draw with your system's fonts instead of ?, in any interface language. After Restart to update on Linux, the previous version quits instead of staying hidden in the background (it kept showing SculptForge on Discord). Discord shows the outline cube icon."},{"p":"whats-new.html","c":"What's new","a":"version-01111","h":"Version 0.11.11","t":"Brush sets: save the bottom shelf and its brushes' keys as a named set (Wood, Metal, Stone...) and swap both in one step from Sculpt > Brush > Brush set, the shelf's right-click menu or F3. Asked for by @NicTanghe. Creature bones: Append > Insert on the model > Creature bones is a built-in set of original fantasy creature bones (skull, jaw, teeth, horns, spine, ribs, limb and wing bones, claws, tail): pick one and drag it onto your model, no file needed. Thanks @kenttumanda123-netizen (#154). Floor grid: View > Floor grid draws a faint grid on the floor the model stands on, for grounding, perspective and lining up Parts. Off by default. Maya Live: turn on File > Maya > Live (and Live on the Maya shelf) and each app sends what you change by itself, 300 ms after a stroke or edit, only the Parts that changed. Thanks @tristratos (#42). Maya Live link: File > Maya > Live link... connects SculptForge and Maya on this computer so Maya follows your stroke while you draw it. It asks every time, is off at every start, and the ember Live link on chip in the top bar turns it off. Package managers: the install guide lists where SculptForge is today: Homebrew available, winget and Omarchy in review, the AUR package ready to publish, apt and dnf repositories on the way. Thanks @NicTanghe (#149). Stencil: lay an image over the view and sculpt or paint through it (Sculpt > Alpha > Stencil). Move, scale and turn it on the canvas with Adjust, stroke over it, turn the model and repeat. Sculpt brushes take its brightness, Vertex Paint its colours; Tile repeats it across the view. Dynamic topology no longer shows a long spike and a patch of broken faces after zooming in and sculpting (only the display was wrong: Undo or the next strokes put it right) (thanks @editordenis4-collab, #153). Big brushes on big meshes follow the pen closer on 4-core machines and settle sooner after pen-up."},{"p":"whats-new.html","c":"What's new","a":"version-01110","h":"Version 0.11.10","t":"Insert sets: Parts > Append > Insert on the model > Insert set from file... or from folder... loads a kitbash set (a file with several objects, or a folder of meshes); pick one in its thumbnail window and drag it onto the model, [ and ] step through the set. Sculpt the Part under the cursor: point at another Part and press Alt+Q (as in Blender, in every input style): it becomes the Part you sculpt, and the view stays where it is. Real-world size: parts for 3D printing keep their size through every export. Pick the unit sizes show in (mm, cm, m, in) in Edit > Preferences > Interface > Units; Tool shows the Part's size and File the size exports write. OBJ and PLY files can be read in mm, cm, m or in (OBJ/PLY in). Asked for by @Swar55. Spanish, Traditional Chinese and Simplified Chinese now cover the whole interface: Generate 3D (tabs, services, hints, Quad Remesh, Generate 3D model, Quick shapes), the About box, Proof mode, the phone link, the brush gallery, Brush Lab, splat training and about 400 other labels that stayed in English. Fewer shards when sculpting rough micro-level surfaces (Clay strokes ending where hair or strands meet skin). Clay over rough strands can still leave small steps; a fuller fix is coming. Paint with alphas: vertex paint now follows the brush alpha with every stroke (Drag Stamp, Dots, Spray), so a Cracks stamp paints cracks instead of a soft round spot. Thanks @fxrtst. Full detail after a new paint layer: on dense meshes, adding a paint layer no longer leaves the top subdivision level looking unsubdivided until a restart. SpaceMouse with a pen: turning the cap while the pen hovers or rests on the model should no longer move the cursor or the model; tell us if it does. Thanks @fenixpoints. Smoother view on big models: the processor prepares the next frame while the graphics card draws this one, so turning the view and sculpting on large meshes run at up to twice the frame rate on some computers."},{"p":"whats-new.html","c":"What's new","a":"version-0119","h":"Version 0.11.9","t":"Line Gradient: Color > Line Gradient, then drag across the model: the paint colour runs into a second colour (or fades out) along the line; drag its ends to adjust it. Thanks @Devon0209 (#99). Part folders: in Tool > Parts, group Parts in folders (drag them in and out), fold, rename, hide or move a whole folder at once. Hyper3D Rodin, direct: Generate 3D > Hyper3D Rodin (direct) runs Rodin Gen-2.5 on Hyper3D's own service with your own Hyper3D key, from an image or a description, in five tiers from Extreme Low to Extreme High. It stays off until you add your key, which is kept in the system keychain; your image or description goes to Hyper3D only, and generations are billed to your Hyper3D account. Rodin through fal.ai stays as it was. Paint stays while the view moves: on dense meshes, vertex paint, paint layers and the mask no longer vanish while you orbit or paint and pop back at rest. Input style keys after a restart: the Blender, Classic and Maya styles keep every key when SculptForge starts again (F for the Size slider in the Blender style, 9 for a Snapshot with the Classic keys). Auto UV never freezes the app: the uv_auto command from the console, a script or an AI tool now unwraps in the background like the Tool > Texture Map > Auto UV button, which gains a Cancel button beside its progress. Faster Pack: UV Editor > Pack across a UDIM grid takes well under a second on most models (it could freeze the app for half a minute), runs in the background with a progress bar and Cancel, and lays islands out tighter. Unwrap runs in the background too."},{"p":"whats-new.html","c":"What's new","a":"version-0118","h":"Version 0.11.8","t":"Edit > Preferences... in the Classic layout too: Preferences is its own palette there, and now Edit also opens it. The guide says where Preferences is in each layout (also Ctrl+, or F3 > Preferences). New app icon: an orange cube is the app icon in the taskbar, dock and title bar; it stays sharp at small sizes. The bust and anvil stays the SculptForge brand. Library: one click uses a brush, alpha or material. Double-click still works. Maya bridge, fewer clicks: what Maya sends loads by itself, Send to Maya is one click in the top bar, and the Maya shelf's new Auto loads what SculptForge sends. Thanks @tristratos. Easier to read view axes: the corner axes now show X, Y and Z in filled circles, with smaller rings for the opposite ends; the ends pointing away are smaller and fainter, on a soft disc that reads on dark and light backgrounds. Click an end for that view, click it again for the opposite view, drag on the disc to orbit; an exact view's name (\"Front view\", \"Top view\"...) shows under it. Reconstruct Subdiv works on open meshes such as UV-tiled panels, and the lower level keeps each face's UVs. Drag Stamp with a pen: a stamp (a vector displacement or any brush) dragged to size keeps its strength when you lift the pen, instead of going weak or vanishing."},{"p":"whats-new.html","c":"What's new","a":"version-0117","h":"Version 0.11.7","t":"Smoother view on very dense meshes: a scan or import with more triangles than your computer draws comfortably now draws a lighter version of itself while you turn the view, and the real detail as soon as the view rests. Parts you sculpt always show in full detail. Orbiting a 28-million-triangle scan on an entry-level machine is about twice as smooth: its slowest frames go from 24 to 12 ms."},{"p":"whats-new.html","c":"What's new","a":"version-0116","h":"Version 0.11.6","t":"Empty shelves hide: a shelf you empty is hidden outside Customize Shelves and the canvas takes its room; it comes back while customizing so you can drop buttons onto it again. Studio controls: IT can deploy a policy file that locks AI, network features, AI providers, AI tools and updates (Managed by your studio shows on locked settings), keep an audit log of every AI action, and sign artists in with the studio account (the guide's \"SculptForge for studios\" page, IT deployment). AI providers: Edit > Preferences > AI > Provider has presets for Anthropic, OpenAI, Ollama, LM Studio, vLLM, llama.cpp, a LiteLLM studio gateway and OpenRouter. Keys now live in your system keychain."},{"p":"whats-new.html","c":"What's new","a":"version-0115","h":"Version 0.11.5","t":"Help > Connect an AI tool is now the one guide to working with an AI tool, on one screen: pick your tool and copy its command, turn on Let AI tools control this window right there, see what happens next (the 6-digit code, the AI connected badge, AI: steps in Undo, what asks you first), and copy an example prompt. The AI blocks out a starting point; you do the art. The brush ring shows the new size while you set it: with the S pop-up open, dragging or typing a size draws the ring at that size on the model, where you pressed S; O shows the Falloff ring the same way. Simplified Chinese: Preferences > Interface > Language has a Simplified Chinese button, with mainland terms and glyph shapes. Paint menu: no longer jitters on short screens (1280x720 fullscreen); a menu taller than the screen scrolls smoothly."},{"p":"whats-new.html","c":"What's new","a":"version-0113","h":"Version 0.11.3","t":"The app icon is now the orange SF mark, as on the website; it reads at task bar size. Help > Connect an AI tool: use SculptForge from Claude, ChatGPT (Codex CLI), Gemini (Antigravity CLI), Grok (Grok Build), Cursor, VS Code and more. Pick your subscription; the window shows the exact command or settings for your install, with Copy buttons. Claude Desktop installs it from a bundle on each release. Remeshing an open Part stays solid: Quick Remesh and Tool > Remesh > Voxel Remesh cap open borders (the Stylised Head's neck, a cut) before remeshing, so the result is one closed surface, not a shell full of holes. A Part that can't be made solid stays as it is, and the status bar says why. UV Editor at large UI scales: the toolbar wraps on a 4K screen at 240 %, so On model: Colours / Checker and Frame are all visible and each takes its own click. Dynamic on a subdivided model: turning on Dynamic on a Part with subdivision levels now offers Freeze Levels and Turn On Dynamic: the level you see becomes one plain mesh (Ctrl+Z brings the levels back). Saved views: View > Views has Front, Back, Left, Right, Top and Bottom (Numpad 1, 3, 7; Ctrl for the other side) and Save View for your own named camera angles; Numpad 0 goes back to the last one. They are saved with the project. A readable mask: masked areas show a soft, dark tint instead of near-black, with Mask darkness in Preferences > Interface and Tool > Masking. Dense wireframes no longer turn into a dark moire. Easier to see: options that are on stand out in every colour scheme, and Quad Remesh guide curves draw smooth with an outline. Safer levels: in Tool > Geometry, Divide (keeps levels) and Subdivide (removes levels) no longer sit together, Micro has its own group, and Subdivide, Delete Lower and Delete Higher ask before removing levels (with Don't ask again for Subdivide)."},{"p":"whats-new.html","c":"What's new","a":"version-0112","h":"Version 0.11.2","t":"Faster pen-up on dense scans: with a micro level, a big brush stroke on a dense scan finishes sooner after you lift the pen. Smoother orbit after big strokes: orbiting a dense scan with a micro level right after big strokes is smoother on slower computers; the shading catches up while the view moves and finishes when it stops. Transforms into a sculpt layer: with a layer active in Tool > Layers, Move, Scale and Rotate (the Transform gizmo, masked or not) record into that layer like a stroke: the base mesh stays, the layer's weight dials the move in and out. With Base mesh active they move the base and every layer, as before. Thanks Devon0209 (#133). Rotation for VDM stamps: with the VDM brush, Brush > Vector Displacement > Stamp rotation has Follow stroke direction, Angle and Angle jitter (a random turn per stamp), kept per brush. Brush files keep the alpha's Angle and Angle jitter too, so shared brushes turn their alpha the same way. Thanks DonnieAlex (#136). Maya style view keys: hold Alt, then add Ctrl, and a left drag rolls the view; Alt+F frames the active Part and Alt+H resets the view. Edit > Preferences > Input > Wheel zooms toward the pointer keeps the point under the pointer in place (on with the Maya style, a checkbox in the others). Thanks RodTDai (#134). UDIMs in Columns x Rows: UV Editor > Pack has Columns and Rows (1-10 each) instead of a tile count, so a 10 x 2 layout fills 1001-1020 and 4 x 3 stays four tiles wide. Thanks RodTDai (#135). Benchmark on slower computers: Help > Benchmark no longer stops at \"settling\" when the scene takes a few seconds to open. New icon and logo. Spanish and Traditional Chinese, complete: every menu, panel, tooltip and Ctrl-help text is now translated in both languages (UV Editor, Quick Remesh, Preferences > Input, Packs, Bake and the rest). Record a performance trace (Help menu, #127): turn it on, do what feels slow, turn it off and attach sculptforge-trace.log (Help > Open log folder) to your report. Traditional Chinese: Preferences > Interface > Language has Traditional Chinese: it puts the menus, palettes, shelves and messages in Traditional Chinese (thanks yoyomaimai). Brush and tool names stay in English. Clean creases on micro levels: Sharp Crease, Crease and Pinch at full strength no longer leave random noise on a micro level. The title bar counts the micro triangles beside the triangles, and Wire shows the level below the micro level on the micro surface. AI off means off in the menus too: with Edit > Preferences > AI > Enable AI features off, the Mesh menu's section is From Image (Relief, Inflate, Stamp) instead of Generate 3D. Voxel Remesh up to 512: the Tool > Remesh Resolution slider now goes from 32 to 512, as the remesh command does. A pen resting on the tablet no longer blocks the mouse or trackpad: lay the pen down and the cursor, the shelf buttons (the mirror's X too) and the menus answer the mouse at once."},{"p":"whats-new.html","c":"What's new","a":"version-0111","h":"Version 0.11.1","t":"Organise your Lit Spheres: right-click one of your own in the material picker, Render > Materials or the Library and choose Rename... or Move to folder; sub-folders of the Lit Spheres folder show as headings. Drop an image onto the Library's Material tab to load it. Search for \"material capture\" finds them too. Founding Members and Member Requests: the first 100 members are Founding Members for good (a badge, their name in the credits, their price locked for as long as they stay), and each month every member can ask for a brush, an alpha or a material in #member-requests on Discord: we make it, credited to them. A small membership card shows now and then at a good moment (never mid-stroke, at most once a week); members sign in once with I'm already a member and it never shows again. Membership, simplified: two memberships instead of four. Member ($5 a month or $48 a year) gets betas and early builds, the monthly feature vote, Member Requests, #members and a name in the credits; Studio ($150 a month) covers up to 10 artists, with priority support and a private channel. Help > Support SculptForge... shows both. Every release stays free for everyone. One-click update: on the Linux AppImage and on Windows (installer or portable zip) the update banner has an Update button: it downloads the new version in the background, checks its signature and checksum, and installs it on Restart now or when you quit (Later). The old version is kept until the new one has started, and put back if it doesn't. Package-manager installs show what to run instead. Member builds in the app: members sign in with GitHub in Edit > Preferences > Updates > Member builds (a code to enter on github.com/login/device) and get the early builds through the same Update button. Big meshes are faster: a one-time tip: the first time you open a scene over about 20 million triangles, a note along the bottom of the view says what got faster and names the two settings that help most on big meshes (Preferences > Performance > Background Preview and View resolution), with a button that opens them. It shows once and never again. Pen pressure per brush: Brush > Pen pressure sets Size and Strength to Use global, On or Off for the brush you hold (also in Brush Lab and Edit > Preferences > Tablet). Grab brushes start with Size off. Quick Remesh: turn it on in Tool > Remesh, then press Shift+R, or hold N and drag on the background, to remesh the active Part in the background while you keep sculpting. Remesh after each stroke does it by itself when a stroke stretched the surface. Rodin 2.5 in Generate 3D: Generate 3D > fal.ai > Model now offers Hyper3D Rodin 2.5 and Rodin 2.5 Fast, from an image or a description, with your fal.ai key. Studio mode for studio builds: no outside connections, updates only from the studio's own channel. Touch and trackpad navigation: two fingers pinch to zoom and twist to roll the view; the SpaceMouse holds still while you sculpt. Preferences save themselves: key style, shortcuts, tablet, interface, performance and radial menus are kept a moment after every change, with nothing to press. The layout (shelves, trays) is kept with Edit > Preferences > Config > Save Layout. Thanks fenixpoints (#117). I is Falloff with SculptForge keys (U stays Intensity); the Classic sculpting keys are unchanged."},{"p":"whats-new.html","c":"What's new","a":"version-0110","h":"Version 0.11.0","t":"Fast Big Brushes (Experimental): a new way to place big brushes on dense meshes, off by default. Try it on a heavy model with a big Clay or Standard brush and tell us how it feels: Preferences > Performance > Fast Big Brushes (Experimental). Brush packs: sixty new built-in brushes in six packs (Clay & Form, Hard Surface, Organic & Skin, Cloth & Folds, Damage & Wear, Ornament), each with its own alpha and a one-line description; see Brush packs. A-Z everywhere: brushes, alphas, materials and the Library list A-Z; Sort switches to the most recently used first or (brushes, alphas) by pack. Alphas get a filter field. Masking panel: Tool > Masking is one panel of buttons with pictures: the Shapes, Mask by (cavity, peaks, face group, colour, facing, border) and Adjust (grow, shrink, sharpen, blur, invert, clear, all). Quick tour: Help > Quick tour (or Sculpted before? Take the quick tour in the welcome) shows in ten short slides where remeshing, dynamic topology, quad retopology, levels, masking, cut, brushes and baking are, each with a Show me button that opens the panel. The guide has it too: Quick tour for experienced sculptors. Live Move (experimental): Preferences > Performance > Live Move. The graphics card draws the Move brush's drag from where the surface started, so it keeps up with the pen on any mesh size, and the move is applied once, exactly, when you lift the pen (Performance). Background Preview (experimental): Preferences > Performance > Background Preview. On dense meshes, the dabs a big brush is still working out show as a preview under the pen, so the stroke no longer trails behind it. The finished sculpt is the same either way. Fast Upload (experimental): Preferences > Performance > Fast Upload. Sculpted changes reach the graphics card through shared memory and a copy on the card, instead of a copy by the driver during the frame. Pattern brushes on micro levels: Dragon Scales, Skin Pores, Stone Carve and the other pattern brushes keep their pattern on a micro level, and carving ones (Wrinkle) carve. Cmd+, opens Preferences (Ctrl+, on Windows and Linux). Show SculptForge on Discord: Edit > Preferences > Integrations lets your Discord friends see you're sculpting, with the elapsed time and, if you like, the monthly challenge's theme or the file name. Off by default."},{"p":"whats-new.html","c":"What's new","a":"version-01011","h":"Version 0.10.11","t":"Update channel: Preferences > Updates > Update channel picks Stable (finished releases, the default) or Preview (betas), which also offers the betas of the next version, a couple of weeks before it ships. A beta says so in the title bar and About (\"0.11.0 Beta 1\"). Problems in a beta go to the Discord's #bug-reports. High-DPI laptops: on a Windows laptop at 150-200 % scaling the window opens inside the screen at a size the interface fits, and nothing runs past its edges. Right tray in every look: Forge Terminal, Phosphor and Blueprint open the right tray on 1280 px screens, as Classic does. QuickMenu: square thumbnails and the look's own colours. Faster Voxel Remesh: Tool > Remesh > Voxel Remesh is about 3-4 times faster (a 500,000-triangle sculpt at the default resolution in about a third of a second) and runs in the background with a progress bar and Cancel, so the app never freezes while it works. Our own names, everywhere: the keymap is now Classic sculpting keys with the Classic layout, the exchange menu is File > Bridge (Send, Receive, Import / Export Bridge file), and the brushes are stored as Sharp Crease, Clay Block and Tendril. Older projects, brush files, hotkeys, shelves and radial menus load as before."},{"p":"whats-new.html","c":"What's new","a":"version-01010","h":"Version 0.10.10","t":"Shapes in the stroke popup: press G and pick Mask Pen, Lasso or Rect, or Cut Line, Lasso, Rect or Polyline. A plain drag then masks or cuts with that shape, no Ctrl or Ctrl+Shift held (with a mask shape on, Ctrl unmasks). Pick it again to turn it off. Background jobs keep your Part: a Quad Remesh, Voxel Remesh, Auto UV or Unwrap that finishes after you picked another Part puts its result on its own Part; the Part you picked stays active. SpaceMouse detection (#104): more 3Dconnexion devices are recognised (by name, also over Bluetooth), and Edit Preferences > Input > SpaceMouse lists every controller SculptForge sees, says when another program (3DxWare, spacenavd) holds the device, and has Copy device report for bug reports. Also new since 0.10.9 (missing from its notes): the brush ring is a true circle lying on the surface, symmetry copies show as dots, the crosshair stays while you turn the view, and Preferences > Cursor > Hide ring while stroking leaves only the dot while you sculpt (#88); drag empty panel space, or middle-drag anywhere in a panel, to scroll it with a pen (#100); Neutral is the default look for new installs; Look > Outlines (#98); the Strokes ring on J. Close Holes: Tool > Geometry > Close Holes caps every open boundary of a Part with a patch that follows the curve of the surface around it. Clip: Tool > Cut > Clip presses everything on one side of a line, or outside a lasso or rectangle, flat onto the shape. Nothing is removed. Use it for hard-surface planes and clean silhouettes. X-Ray: the X-Ray button next to Solo shows the active Part through the others. It is also in View. Light: Render > Materials > Light turns the light around the model with a small pad, and sets its intensity and ambient light. View resolution: View or Preferences > Performance draws the 3D view at 75% or 50% for slow GPUs. Save Render sizes (up to 4096 px), shapes (1:1, 16:9, 9:16, 4:3) and JPG. Membership card: a cleaner look, with a calm warm light instead of the sculpt picture, and the perks now say it plainly: members vote on what we build next (#feature-vote on Discord; anyone can suggest in #ideas)."},{"p":"whats-new.html","c":"What's new","a":"version-0109","h":"Version 0.10.9","t":"Each brush keeps its own settings: Size, Intensity, Falloff, Colour intensity, stroke and alpha follow the brush, custom and Community brushes included. Brush > Save Brush Settings keeps them for the next start, Reset Brush to Default puts back the shipped values, and Preferences > Input > Share size and intensity across brushes keeps the old way (#78). See Sculpting. Alpha options (Alpha palette): Follow stroke direction turns the alpha along the stroke, smoothed as Blender's Rake does; Angle and Angle jitter turn it by a fixed or a random amount; Tile repeats it inside the brush. They work with custom and Community brushes too, and each brush keeps its own (#76). See Alpha options. Blender style: Alt+drag masks on the model and Ctrl+Alt+drag unmasks, as in Blender 5.1 and later; beside the model Alt+drag still turns the view. Preferences > Input > Emulate 3 Button Mouse makes Alt+drag turn the view everywhere. Shift+F now sets the brush's Intensity, not Smooth's (#77). View > Lock camera (Shift+L): drags that start beside the model sculpt instead of turning the view, and the status bar shows CAMERA LOCKED while it is on (#62). Tablets: plug a tablet in while SculptForge runs and it just works (\"Tablet connected\" in the status bar), also through Wacom Bridge. On Windows, pressure works with the Wacom driver's Use Windows Ink on or off. Preferences > Input shows whether pressure is detected, with a troubleshooting link. The view no longer jumps when the pen comes back into range, and the active Part changes only with Alt+click on the keyboard; the status bar names the new Part. See Troubleshooting. Smaller (or larger) corner axes: Draw > Camera > Gizmo size sets Small, Medium or Large (Navigation). View Figure: turn it on beside Axes for a small head in the corner that turns with the view; click it to snap to the nearest side. Starter meshes: start a sculpt from a human head with eye and mouth loops, a bust, a full body in A-pose, a hand, a foot, an ear, an eye, a stylised head, a creature head, a torso, or a bevelled box, cylinder, capsule or ring, all clean quads at life size with subdivision levels ready. File > New from Starter Mesh, the Library's Tool > Starter meshes, or Start from a head in the welcome. See Projects. Your first sculpt in 10 minutes: a step-by-step lesson for people who have never sculpted. Turn the default sphere into a cute owl head with ear tufts, big amber eyes and a little beak, using Move, Clay, Inflate and Smooth, Vertex Paint and PBR shading, and save a render to share. Start it from the welcome's Start the 10-minute lesson button or Help > Your first sculpt (10 min). See Your first sculpt. Save Render (Render > Materials): the view without the interface, at twice its size, as a PNG in your Library (Library > Image). A new What's New: after an update, a window shows the main features as cards with a picture, one line and a Try it button that opens the feature (switch the look, select the brush, open the membership card...). Help > What's New opens it again; Esc closes it. This chapter shows the last three versions in full and folds the older ones into short groups, on the website too. Image to 3D with no setup: the free default is now Hunyuan3D 2.1, which needs no token. TRELLIS.2 (\"Best detail\") still needs a free Hugging Face token (Preferences > AI); without one, Hunyuan3D 2.1 runs instead and the status line tells you. Your own model choice is kept. See Image and text to 3D. Generated models arrive as clean quads: Quad Remesh is now the default, with one subdivision level holding the detail, so you can sculpt and subdivide straight away. Voxel remesh and Off are still in Remesh. Calm, clear hover: buttons, menus and shelves brighten a little as you point at them, tiles lift a little, sliders show their exact value, and the keyboard focus gets a ring as strong as your Outlines setting. Prefer less movement? Turn on Preferences > Interface > Reduce motion (Interface). Picker thumbnails on top: "},{"p":"whats-new.html","c":"What's new","a":"version-0108","h":"Version 0.10.8","t":"Tablets in mouse mode work again: on some Windows tablets with Mouse mode on (Preferences > Tablet) the brush stopped following the pen in 0.10.7. When the system can't say where its cursor is, the pen now moves the brush by how far it moves, from where it was (#72)."},{"p":"whats-new.html","c":"What's new","a":"version-0107","h":"Version 0.10.7","t":"A clearer membership card: the three memberships side by side with what each one gets you, in your look's colours. Maybe later now hides it for 30 days. New memberships: Supporters get the credits (in the app and on the website), the monthly pack and a vote; Insiders also get daily drops and preview builds about a week early; Studio covers the whole company with a custom studio build (Founding Studio: the first 10 studios lock in $150 a month). Every release stays free for everyone; bug-fix and security releases go out to everyone the same day. Full alphas on custom brushes: at Falloff -100, Clay Slab and the other custom and Community brushes now show the whole alpha to its corners, as the built-in brushes do (#75). A new look: new installs start in Forge Terminal with the Tokyo Night colours and the SculptForge layout: menus by task (File, Edit, Sculpt, Paint, Mesh, View, Render, Help) holding every palette, a status bar and a one-row tool shelf. If you are updating, nothing changes until you say so: a card offers Try it or Keep my layout. Experienced sculptor? Preferences > Interface > Look > Classic layout (or the button in the welcome) brings back the palette bar and the two-row shelf. Six more colour schemes, Match my desktop theme, Phosphor, Blueprint and the Classic look are there too. See The interface. Native Wayland on Linux: every Linux package opens without XWayland, stays sharp at fractional scales and reads pen pressure through tablet-v2. The RHEL and Rocky builds now include libdecor (title bars on GNOME Wayland). See Wayland and X11. Benchmark your machine (Help > Benchmark, or sculptforge --benchmark standard-15m): a procedural 15 or 33 million triangle head sculpted with Clay at 25, 60 and 120 px, Move, Smooth and a 240 px brush, reporting frame times (p50, p95, p99), stroke lag, the worst stall and memory. See Performance."},{"p":"whats-new.html","c":"What's new","a":"version-0106","h":"Version 0.10.6","t":"PBR viewport (Material > Viewport Shading > PBR): see the texture's material as a game engine shows it, lit by an environment: Studio, Photo Studio, Small Studio or Outdoor Sky, with exposure, rotation, the environment behind the model and a choice of tone map. Painted height and normals catch the light. It stays as fast as Lit Sphere on a 20-million-triangle Part. See Material painting. Fill layers (Tool > Paint Layers > + Fill Layer): lay a material over the whole Part through a mask of effects (edge wear, dirt, gradient, thickness, light direction, 3D noise, a painted mask, levels, blur) instead of painting it by hand. Change it any time. See Fill layers. Wear that follows the sculpt: Fill layers read the Part's Mesh Maps (occlusion, curvature, thickness and more), and after each stroke only the part of the maps near the stroke is baked again in the background, so chipped paint and dirt move with the form while you sculpt. Material Recipes: Worn Metal, Painted Edges, Dirt and Dust and Rusted Iron in one click, and your own saved as small files. Packs and macros (File > Install Pack..., Library > Packs): install a .sfpack of brushes, alphas, Lit Spheres, Material Recipes, VDMs, keymaps, pie menus and macros after a review that shows exactly what's inside, its license and its author. Switch packs off, remove them, or make your own with New Pack. Record the commands you run as a macro, edit it as plain text, and run it from F3, a key or a pie menu as one undo step. Packs are data only and macros only run SculptForge's own commands; --no-packs starts without any pack. See Packs and macros. More maps from Tool > Bake: curvature, thickness, position and ID; bake a Part's top subdivision level (or micro level) onto its lowest level without a second Part; UDIM tiles bake as one set of files per tile. See Baking. Forge Spheres with the pointer alone (#8): Drag places child (or Ctrl while you drag) moves a new sphere away from its parent in one drag; Delete Selected, Insert Between and Set as Root work on the sphere you last clicked, and a right click on a sphere opens a menu with the same. See Forge Spheres. Maya zoom (#32): in the Maya input style Alt+right drag now zooms with a sideways drag, as Maya's own dolly (right zooms in). To keep zooming up and down as before, choose Preferences > Input > Zoom drag > Up and down. Invert zoom turns any zoom drag around; Ctrl+Alt+Shift erases the mask. See Maya keys. Move along the normal (from the discussions): Move, Tendril, Elastic Tendril and KelvinGrab started with Alt held pull the surface straight out of itself (or push it straight in) instead of across the screen. See Sculpting. Polish, Relax, Smooth and Balloon (from the discussions): Tool > Deformation works on the whole Part by an amount: Polish flattens fine noise and keeps edges, Relax evens out the spacing, Smooth can keep the volume, and Balloon fills the form out. The mask holds what it covers; one undo step each. See Sculpting. Smooth without remeshing (from the discussions): Smooth remesh in Draw > Dynamic topology sets how much Shift-smoothing changes the topology, down to Smooth only. See Dynamic topology. Connected only and View falloff (from the discussions): brush options that keep a stroke to the piece under the cursor (the other leg, the next finger stay put) or reach through the model along the view, as Blender's proportional editing. See Sculpting. The SculptForge Discord (Help > Join the Discord...): the official community, for questions, tips and work in progress. It is also on the support card, in the welcome note and on the website. Bugs still go to Help > Report a problem (GitHub issues). Backface culling (#68, Tool > Display): don't draw the back faces of the model, for speed on open meshes and to see through their openings. Brushes then work only on what you see. Off by default. A crosshair over the view (#73): the pointer is a crosshair where brushes act and the arrow over the panels. Preferences > Interfac"},{"p":"whats-new.html","c":"What's new","a":"version-0105","h":"Version 0.10.5","t":"Selection sets (Tool > Selection Sets): store as many named snapshots of a Part's mask, face groups, visibility, vertex paint, UVs and shape as you like, and restore them at any subdivision level, not only the one they were stored at. Combine two sets (union, intersect, subtract), restore one onto the current mask or visibility the same way, or take a quick set from the visible faces. Every step is one undo step, and the sets are saved with the project. See Selection sets. Morph brush and Morph to Set: a set with its shape is a morph target. The new Morph brush pulls the surface back toward it (Alt pushes away), and Morph to Set blends the whole Part toward it by any amount, within the mask, at any subdivision level. Sets for pipelines: selection_set_* commands for scripts, sculptforge-cli and the AI assistant, doc.selection_set() / doc.set_selection_set() in Python, .sfsets files to move sets between Parts and scenes, and USD exports that carry them as GeomSubsets and primvars (read back on import). UV Editor (Tool > Texture Map > UV Editor, Alt+U): the Part's UVs flat over the UDIM tiles, drawn by the graphics card so a million triangles stay smooth. Draw seams on the model with the Seam Tool (or take them from face groups, island borders or sharp edges), then Unwrap: Least Stretch, Conformal, By Face Groups, Planar, Unfold Islands or Auto Seams, with closed and tangled pieces cut for you. Pack into one tile or across UDIM tiles, Set and Match texel density, lay islands into trim sheet strips, and select vertices, edges, faces or islands (in the view or on the model) to move, rotate, scale, pin, weld, split, straighten and flip them. The model shows stretch, texel density, islands and a checker live while you edit, and a painted texture moves with every change so the model keeps its look. Every step is one undo step and a uv_* command for scripts. See UV Editor. Fixed: the viewport on some Windows PCs (#29): on displays whose window uses another colour format (seen with NVIDIA and high-resolution screens) the model never appeared and the cursor left trails. The view now reaches the window on every format, and falls back to drawing directly if a driver still refuses. Features use SculptForge's own names (Parts, Forge Spheres, Vertex Paint, Face Groups, Library, Lit Spheres, Quad Remesh, Bridge, Snapshot...); the command palette finds them by what they do. See Quick tour for experienced sculptors. New installs start with the SculptForge keys, and the first start asks what you are coming from to pick the key style. Your saved style is kept; the Classic sculpting keys are Classic in Preferences > Input. See Keyboard and mouse."},{"p":"whats-new.html","c":"What's new","a":"from-your-requests-on-github","h":"From your requests on GitHub","t":"Start strokes off the model (#62): an option in Preferences > Input, off by default, and Shift+L to turn it on and off. With it on, a left-drag that starts on the background sculpts once it reaches the model instead of turning the view. See Navigation. Radial and local symmetry (#63): R in Transform > Symmetry (and on the top shelf) repeats every stroke around the X, Y or Z axis, 2 to 64 times (Radial Copies), together with the X / Y / Z mirrors. Every brush, mask, vertex paint and texture stroke, the mask and select shapes, Dynamic Topology and Insert follow it, and the brush cursor shows on every copy. Local puts the planes and the axis through the active Part's centre. Saved with the project and scriptable (radial, radial_axis, local). See Sculpting. The Sculpt Timeline is at the top of the viewport (#63), away from the brushes on the bottom shelf. Preferences > Interface > Timeline position puts it back at the bottom; saved automatically. See Sculpt Timeline."},{"p":"whats-new.html","c":"What's new","a":"from-your-requests-on-github-1","h":"From your requests on GitHub","t":"Insert your own mesh (#34): Append > Insert on the model now takes a copy of another Part or an .obj, .ply or .glb file, placed, sized and turned by the drag like the shapes. See Parts. Keep Masked for Voxel Remesh, Decimate and Quad Remesh (#43): the masked part keeps its triangles and detail exactly; only the rest is rebuilt and joined to it. See Geometry. Hold Space and drag to move the camera (#43): an option in Preferences > Input, off by default. See Navigation. Triple-click another Part in the viewport to select and frame it (#43). Twelve new alphas (Pores, Cracks, Scales, Rivets, Stitches, Fabric Weave, Bark, Rock Strata, Wrinkles, Skin Folds, Hair Strands, Dot Grid) and six new VDM brushes (Rivet, Stitches, Skin Fold, Wrinkle Line, Crack, Rock Ledge), with thumbnails in the Library (#43). See Sculpting. Mask from the mesh border (#61): Tool > Masking > By border masks open edges (and face group borders), so sculpting leaves them in place. See Masking. SculptForge in Spanish (#44): Preferences > Interface > Language > EspaΓ±ol. Maya bridge (#42): File > Maya and a SculptForge shelf for Maya swap meshes through a folder you pick: no connections, nothing run. See Working with Maya. Radial (pie) menus (#45): hold T (brushes) or Y (masking), flick and let go; make your own in Preferences > Input > Radial Menus. See Sculpting. Falloff works with alphas (#60): -100 shows the whole alpha, 0 rounds it off, +100 leaves a soft point (alpha brushes are softer at the default 0 than before; set -100 for the old crisp look). Select Rectangle and Select Lasso follow X / Y / Z symmetry, like the mask versions (#51)."},{"p":"whats-new.html","c":"What's new","a":"become-an-insider","h":"Become an Insider","t":"SculptForge stays free for everyone. Every release stays free for everyone; bug-fix and security releases go out to everyone the same day. Help > Support SculptForge opens the page to join. When SculptForge starts for the first time, after an update, and otherwise at most once a week, a card shows the ways to support it: Supporter, Insider and Studio memberships and the one-time Supporter, each opening its checkout page in your browser. Maybe later, Esc or a click outside closes it; I'm already a supporter hides it for good, and Preferences > Support turns it off. It never shows while you work, and nothing about you is sent anywhere."},{"p":"whats-new.html","c":"What's new","a":"from-your-requests-on-github-2","h":"From your requests on GitHub","t":"Alternate smooth (#40): start smoothing with Shift held, then let go of Shift while still pressing, and the rest of the stroke smooths without shrinking the form. Brush > Smooth keeps volume makes it the default. See Sculpting. Masking (#48, #51): Ctrl+drag on the background draws a mask rectangle; Lasso and Rectangle masks follow symmetry; a Ctrl+click with them blurs the mask. See Masking. Pen tablets in mouse mode (#54): Preferences > Tablet > Mouse mode (relative) stops the cursor jumping back when you lift the pen. Axis gizmo: click X, Y or Z to snap to that view (#43). Undo and Redo on the right shelf, Continuous in the stroke picker, Part thumbnails, and Insert on the model follows symmetry. See Navigation and Parts. macOS (#41): reopening in full screen keeps the menu bar and window buttons reachable."},{"p":"whats-new.html","c":"What's new","a":"support-sculptforge","h":"Support SculptForge","t":"SculptForge stays free for everyone. Help > Support SculptForge opens the page where you can become a member. Every release stays free for everyone; bug-fix and security releases go out to everyone the same day."},{"p":"whats-new.html","c":"What's new","a":"quad-remesh-2","h":"Quad Remesh 2","t":"A new quad remesher is now the default in Tool > Remesh and Tool > Geometry: two to fifty times fewer poles than before at the same accuracy, edge loops that follow the forms (round the mouth and nose), exact symmetry, and a quality report after each run. The previous method is still there as Legacy, and pieces with closed guide loops use it for now. See Quad retopology."},{"p":"whats-new.html","c":"What's new","a":"kelvinlet-brushes-and-capture-from-view","h":"Kelvinlet brushes and Capture from view","t":"KelvinGrab, KelvinTwist, KelvinScale and Elastic Tendril move the surface like elastic clay, with a Squash slider from rubber to firm clay; they're at their best below about 10 million triangles for now. Capture from view (Ctrl+Alt+C) turns any detail into an alpha or a vector displacement brush, and Detail Clone stamps it along a stroke. See Sculpting."},{"p":"whats-new.html","c":"What's new","a":"also","h":"Also","t":"Insert on the model (#34): the drag's direction also turns the shape about the surface. Security: video exports (timelapse, Benchmark) no longer pass the file name to ffmpeg in a way a crafted name could abuse. Update if you use them. The local API added in 0.10.1 is removed; SculptForge doesn't listen for other programs."},{"p":"whats-new.html","c":"What's new","a":"from-your-feedback-on-github","h":"From your feedback on GitHub","t":"Maya navigation (#32): Preferences > Input > Maya. Alt+left orbits, Alt+middle pans, Alt+right zooms. Focal length (#26): Draw > Camera, 15-300 mm with 35 / 50 / 85 / 135 presets, saved with the project. More primitives (#31): Cylinder, Cone, Torus, Capsule, Icosphere and Quad Sphere in Tool > Parts > Append, plus Insert on the model (#34): choose a shape, then drag on the surface to add it. Continuous in the Stroke palette keeps the brush working while you hold it still, and an X / Y / Z gizmo shows the view's direction (#31). Local API (#36): other programs on your computer (symmetry tools, scripts) can run commands in the open app. Off by default; see Scripting. The window opens where and how big you left it (#35), and a drawing problem on some graphics drivers that left trails in the viewport is fixed (#29)."},{"p":"whats-new.html","c":"What's new","a":"micro-levels-hundreds-of-millions-of-polygons","h":"Micro levels: hundreds of millions of polygons","t":"Tool > Geometry > Micro adds a micro-displacement level above your top subdivision level: up to about a billion sculptable triangles in under 2 GB of memory, drawn at the detail your screen can show. Move reshapes the base and the detail rides along. Bake it down or export displacement maps. See Micro levels."},{"p":"whats-new.html","c":"What's new","a":"material-painting-pbr","h":"Material painting (PBR)","t":"Paint roughness, metallic, normal, height, AO, emissive and opacity alongside colour, per paint layer, and export packed maps with presets for Unreal, Unity, glTF, Godot, Blender and USD. Texture brushes are much faster on dense meshes. See Material painting and Export presets."},{"p":"whats-new.html","c":"What's new","a":"sculpt-timeline-and-proof-mode","h":"Sculpt Timeline and proof mode","t":"Scrub back through every stroke, branch from any point, retune an old stroke's strength, and export a timelapse turntable. Help > Benchmark runs a scripted stroke on 5M to 33M triangles with a live readout and records a video and a report you can share. See Sculpt Timeline and Performance."},{"p":"whats-new.html","c":"What's new","a":"hardware-profile","h":"Hardware profile","t":"On first start SculptForge measures your computer for a second and picks settings for it (Laptop, Workstation or a safe mode); on battery it saves power. See Preferences > Performance."},{"p":"whats-new.html","c":"What's new","a":"also-new","h":"Also new","t":"The brush ring lies on the surface and follows its shape (#25). Preferences > Input > Cursor follows surface turns it off. Faster normals on big meshes. Predictive strokes (a GPU preview of each dab ahead of the solver) are in Preferences > Performance as an experiment. The status bar shows only the file name of what you open."},{"p":"whats-new.html","c":"What's new","a":"faster-big-brushes-on-dense-meshes","h":"Faster big brushes on dense meshes","t":"A large brush on a model of 20 million triangles or more keeps up much better: on a 21-million-triangle sphere with a 200-pixel brush, the brush now trails the pointer by half as far, a frame takes a third less time, the first dab appears in half the time, and lifting the pen no longer pauses for up to a second while waiting dabs are placed. See Performance."},{"p":"whats-new.html","c":"What's new","a":"right-click-for-the-quick-menu","h":"Right click for the Quick Menu","t":"A right click on the canvas opens the Quick Menu under the cursor (Space still does too). A right drag turns the view as before, and Preferences > Input > Right click opens the Quick Menu turns it off. See The Quick Menu."},{"p":"whats-new.html","c":"What's new","a":"fixes","h":"Fixes","t":"The orthographic view (Numpad 5) shades like the perspective one: Lit Spheres and the lights no longer look inside out. Dynamic topology with symmetry now adds detail on the mirrored side too when the model's two sides aren't built from mirrored polygons (a QRemeshed head, say): before, only the side under the brush got the new triangles. See Dynamic topology."},{"p":"whats-new.html","c":"What's new","a":"extract","h":"Extract","t":"Mask part of a Part and Tool > Parts > Extract turns it into a shell that fits the surface exactly: a helmet, a strap, a piece of armour. Set Thick, E Smt and Double while the preview shows, then Accept keeps it as a new Part (and Ctrl+Z takes it away again). TCorne and TBorder give the rim triangles instead of quads. See Extract a shell."},{"p":"whats-new.html","c":"What's new","a":"mirror-and-weld","h":"Mirror And Weld","t":"Tool > Geometry > Modify Topology > Mirror And Weld mirrors one side of a model onto the other across X, Y or Z and welds the seam into one watertight mesh, keeping face groups and vertex paint. Tool > Deformation > Mirror flips a Part. See Mirror And Weld."},{"p":"whats-new.html","c":"What's new","a":"a-flat-background","h":"A flat background","t":"Preferences > Display > Background (also in the Render palette) switches the view from the gradient to a flat colour you pick. Saved automatically; projects keep their own. See The background."},{"p":"whats-new.html","c":"What's new","a":"flatpak","h":"Flatpak","t":"SculptForge comes as a Flatpak for x86_64 and ARM64 Linux: one file on the releases page that runs in Flatpak's sandbox on any distribution, installed with flatpak install --user ./SculptForge-linux-x86_64.flatpak. It can open projects and models anywhere in your home folder, works with pen tablets and a SpaceMouse, and the Blender bridge finds it by itself. See Installing SculptForge."},{"p":"whats-new.html","c":"What's new","a":"fixes-1","h":"Fixes","t":"Fast strokes on very dense meshes keep their curve. When one dab cost more than a frame, a quick arc came out as a straight line; now the dabs wait in a queue the app works through between frames, so it keeps reading the pointer. Based on a patch by @bribblej-web. See Performance. The AppImage has a PNG icon at its root, so AppImage managers (AppManager, Gear Lever) show SculptForge's icon when they add it to your menu. Divide (Ctrl+D) no longer crashes on models with a point where many polygons meet, such as a Blender cylinder with Triangle Fan caps of 22 or more sides or a UV sphere's poles. Generating with a ComfyUI workflow and a fixed seed could crash at random; fixed. SculptForge now keeps a log file, sculptforge.log, in its settings folder (Help > Open log folder). After a crash it says what crashed and what you did last; attach it when you report a problem. See The log file."},{"p":"whats-new.html","c":"What's new","a":"forge-spheres","h":"Forge Spheres","t":"Block out a body, creature or plant from connected spheres: Tool > Forge Spheres > New Forge Sphere, drag on a sphere to grow a limb, Move and Scale it into proportion, Alt+click to delete, with Symmetry mirroring every edit. Preview (A) shows the skin, and Make Mesh turns it into a sculptable, all-quad Part with a face group per limb, keeping the Forge Spheres to change later. See Forge Spheres."},{"p":"whats-new.html","c":"What's new","a":"blender-keys","h":"Blender keys","t":"Preferences > Input > Style > Blender brings Blender's navigation and Sculpt Mode keys: middle-drag to orbit (Alt+drag with a pen), the numpad views, F / Shift+F, V S P I G C K for brushes, M for the mask. You can also import a keymap you exported from Blender. See Blender keys."},{"p":"whats-new.html","c":"What's new","a":"flat-shading","h":"Flat shading","t":"Material > Shading > Flat shows every polygon as its own facet, to read a low-poly blockout's planes and check exactly what a brush did; This Part keeps one Part smooth or flat whatever the scene says. See Vertex Paint and materials."},{"p":"whats-new.html","c":"What's new","a":"spacemouse-experimental","h":"SpaceMouse (experimental)","t":"A 3Dconnexion SpaceMouse now moves the view: twist, tilt and push the cap to turn, pan and zoom around the model with one hand while the other holds the pen, in every input style and even mid-stroke. The two side buttons frame the model and show the front. Preferences > Input > SpaceMouse sets the speed, the dead zone, turntable rotation, a dominant-axis mode, inverts any axis, and maps the buttons. It reads the device directly, without 3Dconnexion's driver, and hasn't been tried on real hardware yet: see SpaceMouse if yours doesn't show up."},{"p":"whats-new.html","c":"What's new","a":"your-own-lit-spheres","h":"Your own Lit Spheres","t":"Material > Load Lit Sphere... turns any image (PNG, JPG or EXR) into a material, and images you put in Documents/SculptForge/Lit Spheres show up in the material list, even while SculptForge is running. Right-click one and choose Remove to send it to the trash. Projects carry the Lit Sphere they use, so they look the same on any computer. See Your own Lit Spheres."},{"p":"whats-new.html","c":"What's new","a":"fixes-2","h":"Fixes","t":"Pens whose drivers send stray mouse events (a Ugee M708 on Linux) can rotate, pan and zoom on the background again instead of shaking the view. The S / U / I / O slider opens with its knob under the cursor and stays open while you drag it. The Blender Bridge add-on installs again: its zip was missing a file. Pens on Windows (Wacom Intuos Pro and others through Windows Ink): taps on menus and buttons land, and Alt+pen drag, the Move button and the S / U / O slider follow the pen instead of jumping. Idle, SculptForge no longer keeps your graphics card busy: it draws a new frame only when something changes (before, 60 or more a second all the time)."},{"p":"whats-new.html","c":"What's new","a":"fixes-and-packaging","h":"Fixes and packaging","t":"Exports without a material of their own (FBX, USD) and splats made from an unpainted sculpt use the Soft Clay grey instead of the old peach. Linux AppImages are now named SculptForge-0.9.4-x86_64.AppImage (and -aarch64) and carry update information for AppImageUpdate. On macOS you can install with Homebrew: brew install --cask islandmed/tap/sculptforge."},{"p":"whats-new.html","c":"What's new","a":"a-cleaner-look","h":"A cleaner look","t":"The default material is now Soft Clay: matte, with a clear light and shadow side, so sculpted detail reads at a glance. Orange marks only the current tool; options that are on are a lighter grey with a thin orange line. Every brush icon is drawn the same way, with a mark that shows what the brush does. A material you picked before is kept: choose Soft Clay in the Material menu to see the new look. See The interface."},{"p":"whats-new.html","c":"What's new","a":"bigger-brush-tiles-your-size","h":"Bigger brush tiles, your size","t":"The brush tiles on the bottom shelf are bigger. Right-click any brush on the shelf and choose Tile size: Small, Medium or Large (also in Preferences > Interface > Shelf tiles)."},{"p":"whats-new.html","c":"What's new","a":"export-stl-from-the-file-menu","h":"Export STL from the File menu","t":"File > Export STL... is its own menu item, for 3D printing."},{"p":"whats-new.html","c":"What's new","a":"view-in-ar-on-android","h":"View in AR on Android","t":"On Android, View in AR used to just download a file. It now opens an AR page in Chrome: your sculpt comes to it encrypted through SculptForge's relay, so it works even when Chrome can't reach your computer, and it updates as you sculpt. Show it with Chrome's AR or with Google's AR viewer. If the capture page is open in Firefox, tap Open in Chrome. See Phone capture and AR."},{"p":"whats-new.html","c":"What's new","a":"one-port-for-the-phone-link","h":"One port for the phone link","t":"Face capture and AR now use the same network port as the capture page. On Linux with a firewall, allow that port for both TCP and UDP from your home network."},{"p":"whats-new.html","c":"What's new","a":"version-091","h":"Version 0.9.1","t":"Fixes from the first day of 0.9."},{"p":"whats-new.html","c":"What's new","a":"phone-capture-when-the-phone-cant-open-the-page","h":"Phone capture: when the phone can't open the page","t":"Recent versions of Chrome on Android can refuse to open any address on your home network and just say This site can't be reached. The Capture from phone window now says so and suggests Firefox, and its The phone can't open the page? list covers Linux firewalls too. See Phone capture and AR."},{"p":"whats-new.html","c":"What's new","a":"easier-to-read","h":"Easier to read","t":"This guide, including What's New, and the update banner now use larger text."},{"p":"whats-new.html","c":"What's new","a":"baking","h":"Baking","t":"Cancel now stops small bakes too."},{"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 Parts 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 Part 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 vertex paint 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 professional sculptor's testing, and a way to bring a library over."},{"p":"whats-new.html","c":"What's new","a":"more-classic","h":"More classic","t":"Classic zoom direction. With the Classic input style, dragging up zooms out on every zoom drag. 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 Mask Pen, Lasso Mask or Rectangle Mask. Ctrl+Shift does the same for Select Rectangle and Select Lasso. See Masking. Group by UVs. One face group per UV island, in Tool > Face Groups. See Face Groups 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 Part 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-a-library-over","h":"Bring a library over","t":"A folder of numbered Bridge files opens as one scene, every Part with its face groups, vertex paint, mask and UVs."},{"p":"whats-new.html","c":"What's new","a":"version-08","h":"Version 0.8","t":"Dynamic topology, vector displacement brushes, Quad Remesh Guides, and sculpt layers on every subdivision level."},{"p":"whats-new.html","c":"What's new","a":"dynamic-topology","h":"Dynamic topology","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 Slide Stamp stroke slides a stamp into place. See Vector displacement brushes."},{"p":"whats-new.html","c":"What's new","a":"classic-sculpting-keys-in-blenders-sculpt-mode","h":"Classic sculpting keys in Blender's Sculpt Mode","t":"The Blender add-on has a new preference, The Classic sculpting keys in Sculpt Mode: S, U and O for Size, Strength and Falloff, B for the brushes by name, 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":"Quad Remesh Guides work: draw curves on the sculpt, around the eyes, the mouth or a joint, and Quad Remesh 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 Part and saved in the project. See Quad Remesh 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: 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":"The Classic sculpting 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-hands-just-work","h":"Your hands just work","t":"SculptForge now follows the Classic sculpting keys and gestures by default. A professional sculptor tried an earlier version and put it down because it didn't feel; this release goes through every habit of the first hour. Quick tour for experienced sculptors lists what's the same, what's different and every shortcut side by side. S, U, I, O open Size, Intensity, Colour intensity and Falloff under the cursor, and Space opens the Quick Menu with all of them plus the brush, stroke, alpha and material. Falloff shapes the brush falloff, shown as the cursor's inner ring. Colour intensity gives painting a strength of its own, and Smooth keeps its own Intensity, so a gentle brush still smooths properly. brush letters: B C B Clay Block, B D S Sharp Crease, 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 from mask) work. 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 Part; L toggles Lazy Stroke and V swaps colours. Visibility: Ctrl+Shift+click on a partly hidden mesh hides the group. Prefer the old keys? Preferences > Input > Style > SculptForge brings back the number keys for brushes, I for 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 (face groups) 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 sculpting workflow core: subdivision levels, quad retopology, map baking, the Gizmo, 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: 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 Level / Higher Level (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, vertex paint, paint layers, face groups, hidden faces, UVs and sculpt layers follow the levels. Delete Lower, Delete 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 Parts 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-move-scale-rotate-and-pose","h":"Gizmo: move, scale, rotate and pose","t":"Transform gizmo, 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 panel, All Parts (move, rotate and scale all Parts together), 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 or Wire 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 (vertex paint 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. The Classic sculpting keys: source Part, 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":"Quad Remesh (Tool > Geometry, like quad remesh) 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 Vertex Paint, Symmetry and Half / Same / Double work. Project Detail (Tool > Parts > Project) puts the sculpted detail and vertex paint back onto the divided quads, with Dist, Mean and 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 vertex paint 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 Part 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 Part moves the texture and its layers onto the new UVs. Voxel Remesh and Quad Remesh have a Keep Texture option (on by default) that unwraps the new surface and projects the texture onto it, and merging Parts 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, Quad Remesh, 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 Parts you aren't working on no longer hold cached levels in memory. Quad Remesh 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, Quad Remesh 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 Part 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 Part. 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, Bridge files). 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 experienced sculptors. It was shaped by feedback from a working professional modeler and by what sculptors say on sculpting forums."},{"p":"whats-new.html","c":"What's new","a":"classic-navigation","h":"Classic navigation","t":"Free rotation. Dragging turns the model the way the cursor moves and can roll it right over the top, . 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. Classic 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":"Lasso Mask and Rectangle Mask. 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. Select Lasso. In Tool > Visibility, pick Select Lasso next to Select Rectangle, 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 Face Groups 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 Vertex Paint and materials."},{"p":"whats-new.html","c":"What's new","a":"quads-stay-quads","h":"Quads stay quads","t":"Models you bring in from the other app (Bridge) or as OBJ, FBX, PLY or USD keep their quads: Wire 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 voxel remesh), 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":"Vertex Paint now has layers, like Photoshop: each Part 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. 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":"Parts: several separate meshes in one scene. Append, duplicate, split, merge, solo, and Alt+click to select. See Parts. A classic interface: shelves around the canvas, alphabetical palettes, the Library (,), 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, face groups and visibility, and vertex paint with Lit Spheres. New brushes: Sharp Crease, Clay Block, Tendril, Trim, Layer and Nudge, with strokes and alphas. Project files with autosave, recent files and snapshots, and exchange with the other app (Bridge)."},{"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":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"","h":"Quick tour for experienced sculptors","t":"You know how to sculpt; you just need to know where SculptForge keeps things. This chapter is the same ten stops as the in-app tour: Help > Quick tour, or Sculpted before? Take the quick tour in the welcome. Each slide there has a Show me button that opens the panel it talks about and flashes it, while the tour waits in a small bar at the bottom of the view (Back to the tour brings it back). The pictures are SculptForge in its default look and layout."},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"where-things-are","h":"Where things are","t":"The command search finding Quad Remesh by the word \"retopo\" The menus along the top are sorted by task: Sculpt (brushes, strokes, alphas, symmetry), Paint, Mesh, View and Render. The right tray holds the Tool palette: Parts, Geometry, Remesh, Masking, Cut, Bake and more. The shelves around the view hold the brush, its size and strength, and the brush, stroke, alpha and material tiles. See The interface. Lost? Press F3 and type what you are after in your own words. The search knows the usual sculpting words too, and says which one it matched: Type Finds remesh, voxel, block out Voxel Remesh retopo, retopology, quads Quad Remesh subdivide, multires, levels Divide, Lower Level, Higher Level groups Face Groups clip, trim, slice Tool > Cut folders, objects Tool > Parts insert, kitbash Append (a mesh as a new Part) vertex color Vertex Paint armature Forge Spheres"},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"voxel-remesh","h":"Voxel Remesh","t":"Tool > Remesh open in the right tray A fast remesh for blocking out. Pull shapes far out or merge pieces, then rebuild one even surface: open Tool > Remesh in the right tray, set Resolution and click Voxel Remesh. A higher resolution keeps more detail. The mask and vertex paint carry over, so you can keep going. See Geometry."},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"dynamic-topology","h":"Dynamic topology","t":"Sculpt > Draw & Tablet with the Dynamic topology controls Dynamic topology adds detail where you sculpt. Turn on Dynamic on the top shelf and the brush adds triangles where it needs them and removes them where it doesn't; Detail sets how small they get. Pull horns, ears or fingers out of a ball without remeshing. Wire (Shift+F) shows the new triangles. See Dynamic topology."},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"quad-remesh","h":"Quad Remesh","t":"Tool > Remesh with Quad Remesh at its top Automatic quad retopology: Tool > Remesh > Quad Remesh rebuilds a sculpt as clean quads whose edge loops follow the forms. Set Target Polygons and leave Keep Original on. Divide the result, then Project Detail (Tool > Parts) brings the detail back. Draw Quad Remesh Guides to steer the loops. See Quad retopology."},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"levels-parts-and-face-groups","h":"Levels, Parts and Face Groups","t":"Tool > Geometry with the subdivision levels Ctrl+D divides and keeps the lower levels: Shift+D steps down, D steps up, and you can sculpt at any level (Tool > Geometry). A scene holds several Parts (Tool > Parts); Alt+click one in the view to work on it. Face Groups split a Part into coloured regions to hide, isolate or mask (Tool > Face Groups). See Subdivision levels."},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"masking","h":"Masking","t":"Tool > Masking with By cavity and By face group Hold Ctrl and paint to mask, Ctrl+Alt to unmask. Tool > Masking inverts, blurs and grows the mask, and builds one By cavity, By face group or along the border. Press G for the stroke popup: its Shapes row picks Mask Pen, Lasso Mask or Rectangle Mask for the next Ctrl stroke. See Masking."},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"cut-clip-and-close-holes","h":"Cut, Clip and Close Holes","t":"Tool > Cut with its shapes and modes Pick a shape in Tool > Cut and draw it with Ctrl+Shift: a line, lasso, rectangle or polyline goes straight through the whole Part, and a closed Part stays closed. Cut it away, cut in, add, or Clip: press everything outside the shape flat onto its outline. Close Holes (Tool > Geometry) caps every open boundary. See Cut and Close Holes."},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"brushes-alphas-and-the-library","h":"Brushes, alphas and the Library","t":"The Library's Brush tab B opens the brush picker; type the first letters of a name to pick one. The Alpha tile picks the stamp shape. The Library (,) holds starter meshes, brushes, alphas, Lit Spheres and snapshots. A pack (.sfpack) brings brushes, alphas and Lit Spheres in one file; File > Install Pack shows what is inside before anything is installed. See Sculpting and brushes and Packs and macros."},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"baking-and-texturing","h":"Baking and texturing","t":"Tool > Bake with its maps Tool > Bake makes normal, displacement, ambient occlusion, cavity and colour maps from your sculpt onto a low-poly Part with UVs, in the background. P picks the Paint brush for vertex paint; New Texture on the top shelf paints into a texture instead (Auto UV runs first), with paint layers and material channels. See Baking, Texture painting and Material painting."},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"sculptforge-stays-free","h":"SculptForge stays free","t":"Everything in this tour is free, and stays free. If SculptForge helps your work, a membership keeps it moving: members get betas and early builds, vote on what we build next and ask for the brushes and alphas they want. See sculptforge.app/support.html. Maybe later on the tour's last slide closes it, and it doesn't come back by itself."},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"keys","h":"Keys","t":"Edit > Preferences > Input > Style picks the keys: SculptForge (the default), Classic sculpting keys, Blender or Maya. Picking the Classic sculpting keys offers this tour once. See Keyboard and mouse. Classic layout: Preferences is not under Edit there but its own Preferences palette in the palette bar (Edit > Preferences... opens it too). In both layouts Ctrl+, (Cmd+, on macOS) or F3 > Preferences opens it."},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"see-also","h":"See also","t":"Your first sculpt in 10 minutes The interface Glossary"},{"p":"installing.html","c":"Install SculptForge on Windows, macOS and Linux","a":"","h":"Install SculptForge on Windows, macOS and Linux","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":"Install SculptForge on Windows, macOS and Linux","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":"Install SculptForge on Windows, macOS and Linux","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 macOS with Homebrew brew install --cask islandmed/tap/sculptforge Updates with brew upgrade 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 Any Linux, sandboxed Flatpak for x86_64 or ARM64 flatpak install --user ./SculptForge-linux-x86_64.flatpak, or install from FlatPark to get updates (see Flatpak) Arch Linux packaging/arch/PKGBUILD in the source makepkg -si in that folder (the AUR package isn't published yet; see Package managers) 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 (it runs on 4, 16 and 64 KiB memory pages). Older versions are on the releases page."},{"p":"installing.html","c":"Install SculptForge on Windows, macOS and Linux","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."},{"p":"installing.html","c":"Install SculptForge on Windows, macOS and Linux","a":"package-managers","h":"Package managers","t":"Where SculptForge is in a package manager today, so it updates with the rest of your system: Package manager Status Command Homebrew (macOS) Available brew install --cask islandmed/tap/sculptforge, then brew upgrade winget (Windows) Submitted, in review at winget-pkgs; not installable yet Use the installer or the one-command install meanwhile AUR (Arch Linux) Ready, not published yet Until then: makepkg -si in packaging/arch Omarchy Submitted, in review at omarchy-pkgs As for Arch meanwhile apt (Debian, Ubuntu) and dnf (Fedora, RHEL) repositories Not yet; being built (#149) Install the .deb or .rpm file; SculptForge tells you when a new version is out FlatPark (Linux) Available (x86_64, ARM64) flatpak --user remote-add --if-not-exists flatpark https://dl.flatpark.org/flatpark.flatpakrepo then flatpak --user install flatpark org.sculptforge.SculptForge (see Flatpak) This table changes as each one goes live. 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":"Install SculptForge on Windows, macOS and Linux","a":"flatpak","h":"Flatpak","t":"The Flatpak runs SculptForge in Flatpak's sandbox and works on any distribution that has Flatpak (most do; see flatpak.org/setup if yours doesn't). The easiest way is from FlatPark, a community Flatpak repository that carries SculptForge's official Linux build unmodified (x86_64 and ARM64): flatpak --user remote-add --if-not-exists flatpark https://dl.flatpark.org/flatpark.flatpakrepo flatpak --user install flatpark org.sculptforge.SculptForge flatpak run org.sculptforge.SculptForge Or install the single file from the release: download it, then flatpak install --user ./SculptForge-linux-x86_64.flatpak (or ...-linux-arm64.flatpak). SculptForge then appears in your application menu. The first install also downloads the freedesktop runtime it runs on (a few hundred MB, shared with other Flatpak apps) from Flathub; both ways add Flathub for that if it isn't set up. SculptForge itself is not on Flathub. Updating: from FlatPark, new versions arrive with flatpak update (or your software center's updates), usually within a day of each release, and SculptForge's new-version notice shows that command. Installed from the file, download the new .flatpak and install it the same way. Your settings are kept either way. Uninstalling: flatpak uninstall org.sculptforge.SculptForge (add --delete-data to remove its settings too). Files: the sandbox can read and write your home folder, so projects, models and the textures beside them open as they would without it. Files elsewhere (another drive under /mnt or /media) open through the file dialog; to let SculptForge see a whole drive, run flatpak override --user --filesystem=/mnt/data org.sculptforge.SculptForge. Settings live in ~/.var/app/org.sculptforge.SculptForge/, not ~/.local/share/SculptForge, so a Flatpak and another install of SculptForge on the same computer keep separate settings and brushes. Your library in Documents/SculptForge is shared. Pen tablets and the SpaceMouse work in the sandbox. Blender bridge: the add-on finds the Flatpak by itself and exchanges models through the usual folder. Not in the sandbox: programs SculptForge starts on your computer, such as ffmpeg for recording demo videos and the splat trainer (Splat > Train), are not visible to it. Use another package for those. Ollama, ComfyUI and other local AI servers work, because SculptForge talks to them over the network. To build the Flatpak yourself from the source, install flatpak and flatpak-builder and run packaging/flatpak/build.sh; it writes SculptForge--.flatpak."},{"p":"installing.html","c":"Install SculptForge on Windows, macOS and Linux","a":"windows","h":"Windows","t":"Windows is where most SculptForge artists work. The notes below cover the first start, pen tablets and screen scaling."},{"p":"installing.html","c":"Install SculptForge on Windows, macOS and Linux","a":"smartscreen","h":"SmartScreen","t":"The builds are not code-signed yet, so the first start may show \"Windows protected your PC\". Click More info. Click Run anyway. To confirm the file is the one we published, compare it with SHA256SUMS.txt on the release page."},{"p":"installing.html","c":"Install SculptForge on Windows, macOS and Linux","a":"pen-tablets-windows-ink-and-wintab","h":"Pen tablets: Windows Ink and Wintab","t":"SculptForge reads the pen through Windows Ink, the pen input built into Windows 10 and 11. When Windows Ink is off in the tablet driver, it takes the pressure from the driver's Wintab instead. Either way works; Windows Ink also gives the eraser end and tilt. Wacom: Wacom Tablet Properties > Mapping > Use Windows Ink. You can set it for SculptForge only by adding it as an application in Wacom Tablet Properties. Huion, XP-Pen, Gaomon, Ugee: Windows Ink (sometimes \"Windows Ink mode\") in the driver's settings. Pen displays and Surface-type pens use Windows Ink already. Check it in Edit > Preferences > Tablet: it shows \"Pressure: on\" once the pen has pressed, or \"Pressure: not detected\". A tablet plugged in while SculptForge runs works straight away. If pressure is missing, switch the driver's Windows Ink option and bring the pen back to the tablet. Mouse mode. Most drivers map the pen to the screen (pen mode): where the pen touches is where the cursor goes. If you set the driver to Mouse (relative) mode, the pen moves the cursor by how far it moves, like a mouse. Turn on Edit > Preferences > Tablet > Mouse mode (relative) to match it, or the cursor jumps when you put the pen down. Pen side buttons work as the driver sets them; a button set to Right click opens the Quick Menu. More in Troubleshooting: pen tablets."},{"p":"installing.html","c":"Install SculptForge on Windows, macOS and Linux","a":"screen-scaling-dpi","h":"Screen scaling (DPI)","t":"SculptForge follows the Scale in Windows' Settings > System > Display, so text and buttons have the same size as in other apps at 125%, 150% or 200%. To make the interface larger or smaller than that, choose a size in Edit > Preferences > Interface > UI scale (Automatic follows Windows)."},{"p":"installing.html","c":"Install SculptForge on Windows, macOS and Linux","a":"where-files-go","h":"Where files go","t":"Settings, brushes and the log: %APPDATA%\\SculptForge\\SculptForge (Help > Open log folder opens it). Your library (projects, snapshots, alphas, Lit Spheres): Documents\\SculptForge. See Where settings live for every file."},{"p":"installing.html","c":"Install SculptForge on Windows, macOS and Linux","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":"Install SculptForge on Windows, macOS and Linux","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":"Install SculptForge on Windows, macOS and Linux","a":"windows-smartscreen","h":"Windows: SmartScreen","t":"Windows may show \"Windows protected your PC\". See Windows below."},{"p":"installing.html","c":"Install SculptForge on Windows, macOS and Linux","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":"Install SculptForge on Windows, macOS and Linux","a":"wayland-and-x11","h":"Wayland and X11","t":"Every Linux package (.deb, .rpm, AppImage, Flatpak, tar.gz) opens as a native Wayland window on a Wayland desktop, without XWayland, and as a normal X11 window on an X11 session. On Wayland the window stays sharp at fractional and HiDPI scales (125%, 150%, 200%), and title bars come from the desktop (or from libdecor on GNOME). To force X11 (for example, a screen recorder or remote-desktop tool that only captures X11 windows), start SculptForge with: SDL_VIDEO_DRIVER=x11 sculptforge Pen tablets work on both. On Wayland, pressure, tilt, the eraser end and side buttons come through the desktop's tablet protocol (tablet-v2), so the tablet must be set up in your desktop's settings rather than through X11 tools such as xsetwacom. If pressure doesn't respond, check Edit > Preferences > Tablet for the live pressure reading."},{"p":"installing.html","c":"Install SculptForge on Windows, macOS and Linux","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 Library 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 Edit > Preferences > Library > Show at startup. The first start also creates your library folder (Documents/SculptForge, with Projects, Tools, Brushes, Alphas, Lit Spheres, Images, Splats and QuickSave (snapshots) sub-folders), which the Library shows as User. The first start also asks what you are Coming from: Classic sculpting keys, Blender, Maya or New to sculpting. Your answer picks the key style: Classic sculpting keys turns on the Classic sculpting keys, Blender and Maya their own styles, and New to sculpting keeps the SculptForge keys (the default). Change it any time in Edit > Preferences > Input > Style (see Keyboard and mouse); if you are updating from an earlier version, your saved style is kept and the question isn't asked. 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":"Install SculptForge on Windows, macOS and Linux","a":"updating-and-uninstalling","h":"Updating and uninstalling","t":"SculptForge tells you when there is a new version. 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 Edit > Preferences > Updates turns the daily check off (and picks the update channel: Stable, or Preview for the betas). One-click update. The Linux AppImage and the Windows installer and portable zip also get an Update button on the banner. It downloads the new version in the background (with a progress bar and Cancel), checks it, and then asks: Restart now installs it and starts the new version; Later installs it when you quit, so the next start is the new version. If you have unsaved changes, Restart now asks first, as quitting does. What the check means: the files come only from SculptForge's own GitHub releases, over a checked secure connection; the release's list of checksums must carry the SculptForge release signature (a key built into the app); and the download must match its checksum. If any of that fails, nothing is changed and nothing downloaded is run: the banner says what went wrong and Download still opens the release page. The current version is kept beside the new one (the AppImage as .AppImage.old, the portable folder as .old) until the new version has started once, then removed; if the new version doesn't start, the old one is put back. The Windows installer asks for permission to change Program Files, as installing does. Member builds. Members get each release early. In Edit > Preferences > Updates > Member builds, click Sign in with GitHub: SculptForge shows a short code; open github.com/login/device, sign in with the GitHub account that accepted the invitation to the member repository, and enter the code. From then on the update check also offers the member builds, and Update installs them exactly like releases, with the same signature check. The sign-in can only read the member repository's releases (nothing else on your GitHub account), it is kept in your system's keychain (Windows Credential Manager, or the Secret Service on Linux such as GNOME Keyring or KWallet; never in SculptForge's settings), and Sign out removes it. Without a keychain the sign-in lasts until you quit. Installs that belong to a package manager are never replaced by the app: the Arch PKGBUILD (and the AUR and Omarchy packages once they are published) builds without the update check, a Homebrew install shows brew upgrade --cask sculptforge, and the Flatpak, .deb and .rpm files say to download the new file and open it (a Flatpak from FlatPark shows flatpak update). The macOS app shows Download for now. To update by hand, download the new release and install it over the old one. Either way 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, flatpak uninstall org.sculptforge.SculptForge for the Flatpak, or delete the AppImage). Delete the settings and library folders as well if you want to remove everything."},{"p":"installing.html","c":"Install SculptForge on Windows, macOS and Linux","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":"Install SculptForge on Windows, macOS and Linux","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 has the 3D view (the canvas) in the middle, shelves of the most-used controls around it, menus along the top that hold every function, and trays at the sides where panels can stay open. It comes in two layouts: the SculptForge layout (the default), with menus by task, and the Classic layout, with a bar of alphabetical palettes. Both hold the same controls; see Looks and layouts to switch. This chapter walks through each region, the pop-up pickers, the Library, the built-in help, and how to rearrange the interface and keep your changes. The pictures show the default look and layout. 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 Menu bar Top edge The menus File, Edit, Sculpt, Paint, Mesh, View, Render, Help; the status message; mode, brush, file name, triangles and frame rate; layout presets 1 2 3; Search Top shelf Under the menu bar Sculpt/Paint, Draw/Move/Scale/Rotate, Add/Sub, Rgb, Size, Intensity, Dynamic, symmetry Left shelf Left of the canvas Brush, Stroke, Alpha and Material tiles, the colour picker, Fill Canvas Centre The 3D view, with the Sculpt Timeline along its top; strokes and navigation start only here Right shelf Right of the canvas Undo and Redo, Frame, Move, Zoom and Rotate, display toggles, Solo Right tray Far right The Tool panel: the active Part, Parts, Layers, Geometry, Masking and more Bottom shelf Below the canvas Your quick brushes Press Tab to hide the shelves and trays for a bigger canvas, and again to bring them back. The menu bar stays, so every function is still one click away. The Classic layout has a title strip and a bar of 16 alphabetical palettes instead of the menu bar, and a two-row top shelf; the rest is the same. See The title strip and Palettes."},{"p":"interface.html","c":"The interface","a":"looks-and-layouts","h":"Looks and layouts","t":"Edit > Preferences > Interface > Look sets how the interface looks and how it is laid out. Neither changes your models, brushes or shortcuts. Classic layout: Preferences is not under Edit there but its own Preferences palette in the palette bar (Edit > Preferences... opens it too). In both layouts Ctrl+, (Cmd+, on macOS) or F3 > Preferences opens it. Layout: SculptForge (the default for new installs): a status bar along the top with the task menus File, Edit, Sculpt, Paint, Mesh, View, Render and Help, the document name and scene statistics; a one-row top shelf (Sculpt/Paint, Draw, Move, Scale, Rotate, Add/Sub, Rgb, Size, Intensity, Dynamic, symmetry). Every palette is a section of one menu: File (File, Script), Edit (Edit, Preferences), Sculpt (Brush, Draw & Tablet, Stroke, Alpha, Symmetry & Gizmo), Paint (Vertex Paint & Color), Mesh (Parts & Geometry, which is the Tool palette, and Generate 3D), View (Display), Render (Materials, Gaussian Splats) and Help. Pin a section to a tray as you would a palette. Brush Lab, Front and the pressure options are under Sculpt, the Library and the console under View > Display, and F3 finds everything. Classic: the alphabetical palette bar under a title strip, and a two-row top shelf (see The title strip and Top shelf). Experienced sculptor? In the welcome shown at the first start, pick the Classic layout card or Coming from: Classic sculpting keys (which also sets the keys). Switching the layout swaps the shelves for that layout's standard ones; the trays and what is in them stay. Look (the colours and style): Forge Terminal (the default): tiles with small gaps and thin borders, JetBrains Mono for labels and numbers. Colours picks the scheme: Neutral (the default since 0.10.9: pure grey panels and the orange accent, so your model's colours read true), Tokyo Night (the default in 0.10.7 and 0.10.8), Catppuccin Mocha, Gruvbox Dark, Nord, RosΓ© Pine, Kanagawa or Everforest. Match my desktop theme uses your Omarchy theme's colours when Omarchy is installed (Linux; the option shows only then). SculptForge never changes the theme; toggle it again after switching themes. Classic: the dark grey interface with the orange accent that SculptForge had before 0.10.7, now exactly neutral grey (red, green and blue equal in every background, panel and frame colour). Phosphor: green or amber on black, monospace, with optional scanlines and glow on the interface (never on the 3D view). Blueprint: deep blue with cyan and white line work. Outlines (Forge Terminal, Phosphor and Blueprint) sets the panels' borders: Subtle (the default: faint borders, and nothing lights up under the pointer), Off (no borders; the gaps alone separate the panels) or On (clear borders, the panel under the pointer a faint step lighter). Outline opacity (0-100%, default 100%) fades the borders further into the panels. Hovering a control only gives that control a faint fill, never a bright border. The first start shows three looks to pick from in the welcome: Neutral, Forge Terminal (Tokyo Night) and Classic layout (Classic with the palette bar). Coming from sets the keys and the layout together: Classic sculpting keys (the keys and the Classic layout), Blender, Maya or New to sculpting (their keys, the SculptForge layout). Help > Welcome shows it again. Choosing Forge Terminal, Phosphor or Blueprint also switches to the SculptForge layout; you can pick the Classic layout again right after. The look and layout are remembered for the next start on their own, like every preference. Updating from an older version keeps the look and layout you had. A card, SculptForge has a new look, shows once: Try it switches to Forge Terminal with the Neutral colours and the SculptForge layout; Keep my layout changes nothing. Either way, Edit > Preferences > Interface > Look changes it later. In scripts: ui_look look=forge scheme=neutral outlines=subtle layout=sculptforge (or look=classic layout=classic)."},{"p":"interface.html","c":"The interface","a":"turning-ai-off","h":"Turning AI off","t":"Your art is never uploaded or used for training. AI features run only when you use them and can be turned off. Edit > Preferences > AI > Enable AI features turns off everything AI: AI Brush (Brush Lab, where you describe a brush in words) and Generate 3D (image or text to a model) leave the shelves, menus and the command palette, their commands leave scripts, sculptforge-cli and the MCP tool list, and SculptForge makes no AI network calls. The offline image tools (Relief, Inflate, Stamp) and the MCP server stay. The first-run welcome asks the same question. The choice is saved at once; turn it back on the same way, or search the command palette for \"Enable AI\". Studios can turn it off for everyone with the environment variable SF_AI=off (or start with --no-ai); the setting is then locked. See Studios."},{"p":"interface.html","c":"The interface","a":"the-menu-bar","h":"The menu bar","t":"From left to right: SculptForge and the task menus File, Edit, Sculpt, Paint, Mesh, View, Render, Help. Click a menu to open it: its sections are listed down the left (for example Sculpt has Brush, Draw & Tablet, Stroke, Alpha and Symmetry & Gizmo) and the chosen one opens beside them. See Menus and palettes. The status message: the result of the last command or action. Errors show in red for a few seconds. Mode (SCULPT, PAINT, MOVE...), the active brush, the file name (* after it means unsaved changes), the triangle count of the scene and the frame rate. On a narrow window the least important of these are left out. 1, 2, 3: the layout presets (see Layout presets). 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":"the-title-strip-classic-layout","h":"The title strip (Classic layout)","t":"In the Classic layout the top edge is a title strip instead, with the palette bar under it. 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 Parts, the active Part and its position (\"Part 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. Snapshot: saves a timestamped copy of the whole scene to your library without touching your project file (see Projects, autosave and snapshots). 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":"menus-and-palettes","h":"Menus and palettes","t":"Every function in SculptForge lives in one of 16 palettes. In the SculptForge layout each palette is a section of one task menu (the table below); in the Classic layout the palettes sit side by side in the palette bar. Either way, click the name and the palette drops down under it. Click another name to switch, or press Esc or click outside to close it. The Sculpt menu open on its Stroke section Menu paths in this guide name what you click in the SculptForge layout: Edit > Preferences > Input is the Edit menu, its Preferences section, then the Input sub-palette. File and Edit have a section of the same name, which paths leave out (File > Save). Paths starting with Tool are in the Tool panel in the right tray, in both layouts (it is also Mesh > Parts & Geometry). In the Classic layout, drop the menu: Edit > Preferences > Input is Input in the palette named Preferences, and Sculpt > Stroke is the palette named Stroke. In the Classic layout, 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 strict A to Z order, turn on Edit > Preferences > Interface > Palettes strictly A-Z (strict order). Palette In the SculptForge layout What's in it File 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), Bridge, Quit Edit Edit Undo and Redo (with the name of the step), Paste brush Alpha Sculpt > Alpha The brush alphas: Round, Square, Noise and twelve patterns (Pores, Cracks, Scales...), images from your library, Load image, Invert loaded image Brush Sculpt > 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 Paint The Paint brush, RGB while sculpting, the paint colour and swatches, Fill, Fill masked, Cavity, Clear, Line Gradient, Show vertex paint Draw Sculpt > Draw & Tablet Size, Intensity, Colour intensity, Falloff, Sculpt/Paint, Add/Sub, Rgb, Front, and the tablet options (Pressure > strength, Pressure > size) with a pen readout Generate Mesh > Generate 3D (Mesh > From Image while Edit > Preferences > AI is off) Generate 3D (image or text to 3D), Relief, Inflate and Stamp from an image, and the AI brush provider settings; with AI off only Relief, Inflate and Stamp Material Render > Materials The Lit Sphere materials (Soft Clay, the default, first), your own (Load Lit Sphere...) and Studio, Base colour, Smooth / Flat shading for the scene and the active Part Preferences Edit > Preferences Config, Interface, Input, Hotkeys, Display, Library, Tablet, Performance, Updates and Autosave sub-palettes (see Customizing the interface) Render View Wireframe, Show Mesh, Show Vertex Paint, Show Mask, Show Face Groups, Floor grid, Show Splats, Background, Frame, Fullscreen Script File > Script Console, Run script file, Copy session as script, Clear console Splats Render > Gaussian Splats Gaussian splat tools: show, flip, turn, fit, clean floaters, Make sculptable, sculpt to splats, save, clear Stroke Sculpt > Stroke The stroke types (Dots, Drag Stamp, Spray, Lazy Stroke) and their settings Tool Mesh > Parts & Geometry, and the right tray The active Part with Open, Save and Import, and the Part, Layers, Paint Layers, Geometry, Remesh, Deformation, Masking, Face Groups, Visibility, Export and Display sub-palettes Transform Sculpt > Symmetry & Gizmo Draw, Move, Scale and Rotate (the Gizmo with its pivot, axes, options and numeric entry), Symmetry X, Y and Z, Frame, Solo, Wire Help Help Controls, User Guide, What's New, Command palette, Website & documentation, Report a problem, Support SculptForge..., 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 (Part, 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 Edit > Preferences > Interface > One sub-palette open."},{"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 its menu (or 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 its menu. 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 a tray icon beside its name in its menu (in the palette bar of the Classic layout, its name in the accent colour). 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, under the Tool panel When a tray holds several palettes, Edit > 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, Render > Gaussian Splats 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":"Sculpt / Paint (P): brushes change the shape, or paint colour without sculpting. Draw, Move, Scale, Rotate (Q W E R): sculpt, or move, scale and rotate the Part with the Gizmo. Add / Sub: 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. Size: the brush radius in screen pixels (2 to 800). Intensity: how strongly each dab changes the surface (1 to 100). While Shift is held it shows Smooth's own value. Dynamic: dynamic topology, with its Detail slider while it is on. X, Y, Z: symmetry across each axis (X toggles X); R is radial symmetry. The Classic layout's top shelf has two rows: Library (,), Sculpt/Paint, Add/Sub, Rgb, Size and Intensity on the first; AI Brush, Front, symmetry, Pressure > Strength and Pressure > Size, and the ActiveTris / TotalTris count on the second. In the SculptForge layout these are in the Sculpt menu (AI Brush, Front, pressure) and View menu (Library). Size and Intensity are sliders with the label inside: 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, Drag Stamp, Spray or Lazy Stroke. Alpha: the brush's stamp shape. Material: how the model is shaded in the view. Under them is the colour picker for vertex paint (a saturation/value square and a hue strip), two swatches and Fill, which fills the unmasked area with the main colour."},{"p":"interface.html","c":"The interface","a":"right-shelf","h":"Right shelf","t":"Undo and Redo (Ctrl+Z, Ctrl+Shift+Z): greyed out when there is nothing to undo or redo. A layout you customised before they were added gets them at the top. Frame (F): fits the model in the view. Move, Zoom, Rotate: drag on these buttons to pan, zoom and orbit the view. Wire (Shift+F): shows the mesh's polygons: quads as quads, triangles as triangles. Groups: colours each face group. Mask (Ctrl+H): shows or hides the mask's darkening (on by default). Hiding it keeps the mask, which still protects the surface. Paint: shows vertex paint colours (on by default). Solo: shows only the active Part (available with two or more Parts). Splats: shows or hides a Gaussian splat capture (only shown while one is loaded). Options that are on are highlighted; a filled button in the accent colour marks only the current tool or mode. 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, Clay Block, Sharp Crease, Move, Smooth, Inflate, Pinch, Flatten, Crease, Trim, Tendril, 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 is outlined in the accent colour. 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. Bigger or smaller tiles: right-click any brush on the shelf and choose Tile size: Small, Medium (the default) or Large. The same setting is in Edit > Preferences > Interface > Shelf tiles. Small leaves the most room for the model on a laptop screen. A key for any brush on the shelf: hold Ctrl+Alt, click its tile, then press the key. Custom and pack brushes show their key in the top-right corner. Brush sets: keep the shelf as it is now, with the keys of its brushes, as a named set (Wood, Metal, Stone...): Sculpt > Brush > Brush set > Save, or right-click the shelf and choose Brush set > Save Shelf as Brush Set.... Pick a set from either menu, or type Brush Set in the command palette (F3), to swap the whole shelf and its keys in one step. The set you switched to comes back the next time you start SculptForge. Sets are saved in your brush library (a sets folder next to your brushes); deleting a set leaves the brushes and the shelf as they are."},{"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 help box: 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: 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, Drag Stamp, Spray and Lazy Stroke, with Scatter for Spray, Steady Stroke (and its radius) and Precision Intensity. See Sculpting and brushes. Alpha (click the Alpha tile): Round, Square, Noise and the twelve built-in patterns (Pores, Cracks, Scales, Rivets, Stitches, Fabric Weave, Bark, Rock Strata, Wrinkles, Skin Folds, Hair Strands, Dot Grid), 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 Lit Spheres 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 Vertex Paint and materials."},{"p":"interface.html","c":"The interface","a":"sliders-at-the-cursor-and-the-quick-menu","h":"Sliders at the cursor and the Quick Menu","t":"Press S for a Size slider under the mouse, U for Intensity, I for Colour intensity or O for Falloff. 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 (or a right click on the canvas) opens the Quick Menu with all of them and the brush, stroke, alpha and material (see The Quick Menu)."},{"p":"interface.html","c":"The interface","a":"the-library","h":"The Library","t":"The Library is a strip of thumbnails across the top of the canvas for browsing everything you can load. Press , (comma) or click Library on the top shelf to show or hide it. It opens on its own at start-up (see Preferences). The Library on the Tool tab Tab Shows Double-click (a click for brushes, alphas and materials) 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, and the VDM brushes (built-in ones too) Select or load the brush (one click) Alpha Round, Square, Noise, the twelve built-in patterns and images in your Alphas folder Use as the brush alpha (one click) Material The Lit Spheres (your own included) and Studio Use the material (one click) 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 Snapshots The autosave and your snapshots, 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 Part 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 (and uses a brush, alpha or material). Drag a tile down out of the Library 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. Drag the strip's edge toward the canvas to make the thumbnails bigger or smaller (48 to 128 px; 64 by default). Open folder... adds a folder of your own to the root of every tab. On the Snapshots tab, Save now takes a snapshot. The x at the right end of the header, or Esc, closes the Library (while you type in Filter, Esc first leaves the field). The x stays on screen on small displays such as 1280x720. Right-click a tile for Open, Append as Part, 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 Edit > Preferences > Library > Library folder."},{"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 (Edit > Preferences > Interface > Tooltip delay). Turn Ctrl-hover help off with Edit > Preferences > Interface > Ctrl+hover help, and make the box more or less see-through with Help box 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 at the top right) 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: 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. File > Script 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. Shortcuts and preferences save themselves; layout changes (shelves, trays) last until you quit unless you keep them with Save Layout."},{"p":"interface.html","c":"The interface","a":"move-add-and-remove-shelf-items","h":"Move, add and remove shelf items","t":"Open Edit > Preferences > Config and turn on Customize Shelves. 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 Customize Shelves off when you're done, and click Save Layout (same palette) to keep the result. Right-clicking a shelf item and choosing Remove from shelf works without Customize mode. A shelf you empty is hidden when Customize Shelves is off, and the canvas takes its room. Turn Customize Shelves back on and the empty shelf returns, outlined, so you can drag buttons onto it again."},{"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 Edit > 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 and the status line says which action lost it."},{"p":"interface.html","c":"The interface","a":"saving-preferences-and-layouts","h":"Saving preferences and layouts","t":"Every preference (key style, shortcuts, tablet, interface, performance, radial menus...) saves itself a moment after you change it; there is nothing to press. The layout is the one thing kept on purpose, with Save Layout. All in Edit > Preferences > Config: Item What it does Save Layout Keeps the current shelves, trays and open palettes for future sessions Revert to Saved Layout Goes back to the layout the last Save Layout kept Reset Layout and Shortcuts Goes back to the built-in layout, shortcuts and radial menus (Save Layout afterwards to keep the layout) Export Interface... Saves the layout, shortcuts and preferences to a .json file you can share Import Interface... (Ctrl+L) Loads such a file (Save Layout afterwards to keep its layout) The command palette (F3) also has Save Preferences Now, which writes them at once; you never need it. The first time you change the layout in a session, the status line reminds you once: \"Layout changed - Edit > Preferences > Config > Save Layout keeps it\". What a session changes by itself (the console and Library being open, the Library tab) doesn't count as a layout change."},{"p":"interface.html","c":"The interface","a":"layout-presets","h":"Layout presets","t":"The 1, 2 and 3 buttons at the top right (also in Edit > Preferences > Config) switch between three arrangements of the current layout: Standard: the Tool panel 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, Library and left-handed setting stay as they are). Save Layout keeps it."},{"p":"interface.html","c":"The interface","a":"interface-preferences","h":"Interface preferences","t":"Classic layout: Preferences is not under Edit there but its own Preferences palette in the palette bar (Edit > Preferences... opens it too). In both layouts Ctrl+, (Cmd+, on macOS) or F3 > Preferences opens it. Edit > Preferences > Interface: Setting Default What it does Look, Outlines and Layout Forge Terminal, Neutral, Subtle, SculptForge See Looks and layouts Language English The interface language: English, EspaΓ±ol, Traditional Chinese or Simplified Chinese (see below) Ctrl+hover help On Ctrl-hover help boxes Help box 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 Reduce motion Off Hover and focus highlights change colour only: no easing, and tiles don't lift 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 (strict order) Off Classic layout: 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%), applied at once; Automatic follows the monitor (see below) Camera notch Automatic Keeps the interface below a laptop's camera notch in fullscreen (see below) Language changes the interface at once, without a restart; saved automatically for the next start. In EspaΓ±ol the menus, the palettes, the shelves, the Library, the command palette and the Ctrl-help titles are in Spanish, while the names of tools and brushes stay in English, as Spanish-speaking sculptors use them (Parts, Quad Remesh, Forge Spheres, Library, Lit Sphere, Clay Block, Add). The command palette finds a command by its Spanish or its English name. Traditional Chinese (the button with its Chinese name; contributed by yoyomaimai) works the same way, with Taiwan usage and the brush and tool names in English; Simplified Chinese (the fourth button) is the same translation in simplified characters with mainland terms, drawn with mainland glyph shapes. Anything not translated yet (most Ctrl-help descriptions, this guide) shows in English. Scripts and sculptforge-cli commands are the same in every language. UI scale also applies at once: text, buttons, shelves and trays resize on the next frame; saved automatically. Automatic uses the scale of the monitor the window is on (Windows: Settings > Display > Scale; macOS and Wayland: the display's scaling; X11: the desktop's font DPI). Drag the window to a monitor at another scale, or change the system setting, and the interface follows. A chosen size (100% to 200%) stays the same on every monitor. Edit > Preferences > Cursor: Setting Default What it does Viewport cursor Crosshair The pointer over the 3D view: a crosshair, or the arrow (#73). The crosshair stays while the view turns, pans or zooms. Panels, menus and popups always show the arrow Cursor follows surface On The brush ring lies on the model: a true circle at the brush's real size, in the plane of the surface (averaged over the brush, so bumps don't bend it), with a short line along the surface's direction. Symmetry and radial copies show as dots where their dabs land. Off: a flat ring on the screen Hide ring while stroking Off While a stroke runs, only the dot where the brush touches (and the symmetry dots) shows, not the ring Edit > Preferences > Hints: Show hints in the viewport (on) and one box per hint (Strokes start off the model, Previewing an LOD, Face landmark steps). Each hint over the 3D view also has its own Don't show again; Show all hints again brings them all back. Saved automatically. Scrolling panels with a pen: on small screens a palette or tray that doesn't fit scrolls with the mouse wheel, and also with a left-drag on empty space in it (between and beside the controls) or a middle-drag anywhere on it, as you would scroll a list with a finger (#100"},{"p":"interface.html","c":"The interface","a":"the-background","h":"The background","t":"Edit > Preferences > Display (and the View menu) sets the view's Background: Gradient, the charcoal radial gradient (the default), or Flat Colour, one solid colour without the gradient. Click the Background colour swatch to pick the colour; picking one switches to Flat Colour. The choice saves itself for the next session, and each project keeps the background it was saved with. From a script: set_background mode=flat, set_background color=60,70,80 or set_background mode=gradient. Edit > Preferences > Library has Show at startup (on by default), the number of Rows, the Thumbnails size, Placement (along the top of the canvas, or at the bottom above the bottom shelf) and the Library folder. Edit > Preferences > Autosave sets how often a recovery copy is saved (see Projects, autosave and snapshots). Edit > Preferences with the Config and Interface sub-palettes"},{"p":"interface.html","c":"The interface","a":"fullscreen-hiding-panels-and-the-camera-notch","h":"Fullscreen, hiding panels and the camera notch","t":"F11 (or View > Fullscreen) fills the screen with SculptForge; press it again to go back to a window. sculptforge --fullscreen starts that way. SculptForge reopens the way you left it; on macOS a window closed in full screen reopens maximised instead, so the menu bar and the window buttons stay reachable (press F11 or the green button to go full screen again). In the Classic layout, 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, the right-shelf buttons or a 3Dconnexion SpaceMouse, 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: 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 Edit > 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."},{"p":"navigation.html","c":"Navigating the view","a":"orbit-lock","h":"Orbit lock","t":"View > Orbit lock picks how a rotation drag turns the view, one key each: Lock Key A rotation drag Free Alt+Shift+F turns about the screen's axes (the default, as above) Y (turntable) Alt+Shift+Y keeps the model upright: the Turntable rotation above X Alt+Shift+X turns about the world X axis only: from the front, an up or down drag tips the model towards you or away, and sideways drags do nothing Z Alt+Shift+Z turns about the world Z axis only: from the front, a drag around the middle of the view turns the model like a wheel; from the side, an up or down drag tips it With X or Z locked, only the part of the drag that moves across the axis on screen counts, so the axis itself never moves: nothing drifts, however long you drag. Shift still snaps to the nearest side view. The axis gizmo shows the lock: the locked axis runs through its disc in its colour, and a small lock with the axis letter sits at the disc's lower right. The lock is the same setting as Edit > Preferences > Interface > Rotation, saved with your preferences; scripts and the console use orbit_lock axis=free|y|x|z. View > Orbit lock: the X lock picked in the View menu, the axis gizmo with X through its disc and the lock badge 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, or orthographic (Numpad 5): no foreshortening, so sizes don't shrink with depth. The front, side and top views (Numpad 1, 3, 7) switch to orthographic until you rotate again, as in Blender. The X / Y / Z gizmo in the top left of the canvas (Sculpt > Draw & Tablet > Camera > Axes) shows the world axes as the camera sees them, on a soft disc that keeps them readable on dark and light backgrounds. The positive ends are filled circles with their letter, the negative ends smaller rings; the ends pointing away from you are smaller and fainter, and the nearest is drawn on top. Click an end to look from that side, as in Blender: X the right view, Y the top, Z the front, and the ring at the other end of each axis the left, bottom or back view. Click the same end again for the opposite view (Front, then Back). These are orthographic like the numpad views. The end under the pointer gets a ring (a negative end shows its letter), and on an exact side view its name shows under the axes. Drag on the disc between the ends to orbit. Sculpt > Draw & Tablet > Camera > Gizmo size makes the axes Small, Medium (the default) or Large; they grow with the UI scale too, and clicking an end works at every size. View Figure (beside Axes, off until you turn it on) adds a small shaded head in the corner that turns with the camera, so you can tell front from back at a glance. Click it to look from the nearest side: the front, back, left, right, top or bottom view, orthographic like the axes. Navigation starts only on the canvas. A drag that begins on a shelf, a tray or a palette never moves the camera. Blender: with Edit > Preferences > Input > Style on Blender, middle-drag rotates, Shift+middle-drag pans and Ctrl+middle-drag zooms. With a pen or a trackpad, Alt+left-drag beside the model does the same (add Shift to pan, anywhere; Ctrl to zoom); on the model it masks, as in Blender 5.1 and later. Turn on Edit > Preferences > Input > Emulate 3 Button Mouse to make Alt+left-drag turn the view everywhere, as that Blender preference does. The numpad views, Numpad . and Home frame as in Blender. See Blender keys."},{"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 (Maya style: hold Alt, add Ctrl, left-drag sideways) Pan Alt+left-drag on the background, Alt+right-drag, or middle-drag Zoom Mouse wheel (toward the middle of the view, or toward the pointer with Edit > Preferences > Input > Wheel zooms toward the pointer, on in the Maya style); Alt+left-drag on the background, then let go of Alt and keep dragging; Ctrl+right-drag; Ctrl+middle-drag; Ctrl+left-drag on the background when nothing is masked (not with the Classic sculpting keys) Frame the model F (Blender style: Home), or Frame on the right shelf Front, right, top view Numpad 1, Numpad 3, Numpad 7; Ctrl for the back, left and bottom Front, side, top or bottom view with the mouse Click an end of the axis gizmo in the canvas corner Orthographic on or off Numpad 5 Turn in 15 degree steps Numpad 4 / Numpad 6 (around), Numpad 8 / Numpad 2 (over); Numpad 9: the other side Frame the active Part Numpad . (Maya style: also Alt+F) Reset the view Maya style: Alt+H (front, upright, everything in view); any style: Reset view in the Controls window (F1), where you can give it a key Frame one Part Shift+Alt+click it, or triple-click another Part (it becomes the active Part) Sculpt from the background Turn on Edit > Preferences > Input > Start strokes off the model, View > Lock camera, or press Shift+L: a left-drag that starts beside the model sculpts once it reaches the surface Move the camera with Space held Turn on Edit > Preferences > Input > Hold Space and drag to move the camera, then hold Space: left-drag rotates, right- or middle-drag pans, Ctrl+drag zooms, anywhere on the canvas (on the model too) Zoom drags: drag up to come closer, down to back away. With the Classic sculpting keys (Edit > Preferences > Input) they go: drag up to zoom out, down to zoom in. Hold Space and drag to move the camera is off by default, because with the Classic sculpting keys Space opens the Quick Menu. With it on, Space no longer opens the Quick Menu (a right click still does), and a space typed in a text field is never taken. Start strokes off the model (also View > Lock camera) is off by default. With it on (a label at the top of the canvas says so, and in the SculptForge layout the status bar shows CAMERA LOCKED), a left-drag on the background no longer rotates: it waits, and the brush starts where the cursor first reaches the model, so strokes that begin at the silhouette never turn the view by accident. Ctrl (mask) and Shift (smooth) strokes start the same way, and a Ctrl+click on the background still inverts the mask. To move the view, right-drag (a pen's lower button is a right click by default), Alt+drag to pan, middle-drag, or hold Space if Hold Space and drag to move the camera is on; with the Blender or Maya style, Alt+left-drag rotates as before. With a pen that has no buttons and the Classic or SculptForge style, press Shift+L to turn it off while you rotate, or turn on Hold Space. Lasso Mask, Rectangle Mask and the Ctrl+Shift hide and show shapes work as before. Floor grid (View > Floor grid, also Tool > Display; off by default, remembered) draws a faint grid on the floor the model stands on: its lowest point, with the up axis (Y) standing on it. It helps judge perspective and tilt and line up Parts; the red line is the X axis, the blue one Z. The floor moves when a stroke or a move ends (not during it). The squares step up by ten as you zoom out, and the grid fades into the distance; it never draws over the model, even seen from below. \"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 "},{"p":"navigation.html","c":"Navigating the view","a":"touch-screens-and-trackpads","h":"Touch screens and trackpads","t":"Two fingers on the model navigate; they never sculpt. Gesture Touch screen Trackpad Spread or pinch two fingers Zoom in or out Zoom in or out Twist two fingers Roll the view with them Roll the view with them Slide two fingers Pan Zoom (as the scroll wheel) One finger Sculpt, as with the mouse Moves the pointer A twist starts rolling once the fingers have turned about 10 degrees, so a pinch doesn't tilt the view by accident. On a touch screen a single finger waits a moment for a second one before it sculpts; if the second finger lands after a stroke has started, the stroke ends there and the fingers take over the view (one undo removes the stroke)."},{"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. 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 View menu and Sculpt > Symmetry & Gizmo."},{"p":"navigation.html","c":"Navigating the view","a":"spacemouse-experimental","h":"SpaceMouse (experimental)","t":"A 3Dconnexion SpaceMouse lets one hand move the view while the other holds the pen. SculptForge reads it directly as a USB device, without 3Dconnexion's driver or SDK, so this is experimental: it has been tested with simulated input only, not yet with a real SpaceMouse. Tell us how it works with yours (GitHub issue #6). Plug it in and it works: Edit > Preferences > Input shows its name under SpaceMouse (experimental), with live bars for its six axes. The model moves the way you move the cap, and turns about the same point the mouse orbits around (the camera's target: Frame sets it to the scene's centre, and panning moves it). Move the cap The view Push left / right Pans left / right Pull up / push down Pans up / down Pull towards you / push away Zooms in / out Twist Turns the model around Tilt towards you / away Tips the model's top towards you / away Roll left / right Rolls the model on screen (not with Lock rotation to turntable) Left side button Frame Right side button Front view The speed is the same whatever the frame rate: holding the cap for a second turns the model just as far on a slow machine as on a fast one. It works in every input style (SculptForge, classic, Blender, Maya) and while a stroke is held: the stroke keeps going, sculpting wherever the pen points on the turned model. Many people stop moving the pen while they turn the view, and that works best, but you don't have to. Edit > Preferences > Input > SpaceMouse: Use SpaceMouse: off ignores it completely, buttons too. Speed: how fast the view moves for the same push. Dead zone: how far the cap must move before anything happens (8% by default), so a hand resting on it doesn't drift the view. The live bars turn orange once an axis is past it. Lock rotation to turntable: the model stays upright; twisting turns it about the world's up axis and rolling the cap does nothing. Hold during strokes (on by default): while you sculpt, paint or mask, the SpaceMouse leaves the view alone and its buttons do nothing, so a hand resting on the cap never moves the model under the pen. Turn it off to turn the view mid-stroke. Dominant axis: only the direction you push the most moves the view, so a twist doesn't also pan a little. Invert: reverse any of the six moves (Pan X, Zoom, Pan Y, Tilt, Roll, Spin). If a direction feels wrong on your model of SpaceMouse, flip it here. Left button, Right button (and Button 3 onwards on models with more): Frame, Frame Part, the axis views, Orthographic, Undo, Redo or Nothing. SpaceMouse defaults puts everything back. These settings save themselves. If SculptForge doesn't see it (Preferences says \"No SpaceMouse found\"): Windows: 3Dconnexion's driver, 3DxWare, can keep the device to itself, and may also move the view on its own as it does in other programs. Quit 3DxWare (its tray icon, or stop the 3DxService service in Task Manager > Services), unplug the SpaceMouse and plug it back in. Without 3DxWare, Windows treats the SpaceMouse as a game controller, which is how SculptForge reads it. If SculptForge sees the SpaceMouse with 3DxWare running, give the buttons a job in only one of the two places, or one press does two things. macOS: the same applies to 3DxWare for Mac: quit it (or uninstall it) and plug the SpaceMouse in again. Suspending it isn't enough: suspended, it can still move the pointer and scroll while you push the cap. Linux: if spacenavd is running, it normally opens the device exclusively. SculptForge may still list the SpaceMouse but get no motion from it. Stop it while you sculpt (sudo systemctl stop spacenavd). SculptForge reads the device through /dev/input as a joystick: that works when the kernel reports the cap's axes as absolute axes, which is how joysticks work. If the kernel reports them as relative motion, as it does for some older models, the SpaceMouse doesn't show up at all. Reading it through spacenavd isn't supported yet. If it shows up but the view doesn't move (the live bars stay still when you push the cap), a"},{"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 Part, 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":"saved-views","h":"Saved views","t":"View > Views has a button for each axis view (Front, Back, Left, Right, Top, Bottom) and your own saved cameras. Type a name (or leave it empty for \"View 1\", \"View 2\" ...) and click Save View (Ctrl+Alt+Numpad 0); saving under a name that exists replaces it. Click a name to go back to that view, or press Numpad 0 for the one used last; x forgets it. Saved views are kept in the project."},{"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 View menu: Wire (Shift+F): shows the polygons of the active Part over the surface as a wireframe. Quads show as quads (see Quads and triangles). Useful for judging mesh density before you subdivide or remesh. Groups: colours each face group. Mask: tints masked areas dark (how dark: Mask darkness in Edit > Preferences > Interface). Paint: shows vertex paint colours (off shows the plain material). Solo: shows only the active Part, to get at parts hidden behind others. Show Mesh (View menu): 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 rotation around the point under the cursor (the camera always orbits its target, which Frame sets to the scene centre) and no floor grid. Pan the target onto the area you're working on to orbit around it, or zoom there with the wheel and Wheel zooms toward the pointer on: that moves the target toward the point under the pointer too."},{"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 Part 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 Part, and only on parts that are visible and not masked. A stroke that started on the model keeps sculpting when it slides past the edge of a form seen in profile, as long as the brush circle still covers the model: the brush holds on to the silhouette (#84)."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"built-in-brushes","h":"Built-in brushes","t":"SculptForge has nineteen 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. Intensity and pen pressure set how fast it builds. 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 Sharp Crease 9 A narrow, deep V-shaped crease with the sides pinched in. A sharp ridge Clay Block 0 Square, flat-topped clay strokes for blocking in forms. Carves flat-bottomed Tendril Pulls the surface out into horns and tendrils that taper as you drag. No change Trim Trim: 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 VDM Stamps a vector displacement map, overhangs and all (see below). Digs the shape in KelvinGrab Elastic move: drags the surface like real clay, with no falloff edge (see Kelvinlet brushes). No change KelvinTwist Press and drag right to turn the surface clockwise around that point, left to turn it back. Turns the other way KelvinScale Press and drag left to pinch the surface toward that point, right to swell it. The other way Elastic Tendril An elastic Tendril: smooth horns and tendrils that taper as they stretch. No change DetailClone Paints copies of a captured detail (the VDM brush's map) along the stroke, each turned to follow it. Digs them in Morph Pulls the surface back toward the morph target, a selection set with its shape (Selection sets). Does nothing until you pick one. Pushes away from it Paint P Paints colour without sculpting. See Vertex Paint and materials. Paints back to white Notes on particular brushes: Move, Tendril and the Kelvinlet brushes (except Detail Clone) 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 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."},{"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 Sculpt > 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 Carve Scrapes hard planes and breaks them up with cracks for rocks and ruins. Skin Pores Sprinkles tiny pores for close-up skin detail. Clay Slab 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 is outlined in the accent colour 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. Sculpt > Brush: 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 Library library that aren't loaded yet; picking one loads it. The brush picker after pressing B, with letter badges The picker works, by typing letters: Press B. Type the first letter of the brush. Only brushes starting with that letter stay, and each shows a highlighted 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)."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"size-intensity-colour-intensity-and-falloff","h":"Size, Intensity, Colour intensity and Falloff","t":"These values control every brush. Size and Intensity are on the top shelf; all four are in Sculpt > Draw & Tablet and the Quick Menu. Setting Range Default How to change it 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. Intensity 1 to 100 50 How strongly each dab changes the surface. U opens a slider at the cursor. Colour 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. Falloff -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 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: the outer one is the Size, the inner one is Falloff (where the brush works at half strength). Masking, painting, Move and Tendril follow Falloff too. Custom brushes made in Brush Lab and Clay Block's square tip keep their own tip shape at 0 and shift it like the others. With an alpha, Falloff works: the alpha is multiplied by the round falloff. At -100 the whole alpha shows, hard to its edges (a Square alpha stamps the full square); at 0 the falloff softens it and rounds a square's corners; at +100 only a soft point in the middle is left. Over the model, the rings lie on the surface: true circles in the plane of the surface under the pointer, at the brush's real size there, with a short line pointing out of the surface. The plane follows the form averaged over the whole brush, so the rings stay round and steady over fine bumps and detail. With symmetry on (mirror or radial), a dot shows where each copy of the brush lands. Off the model the rings are flat circles. Edit > Preferences > Cursor: Cursor follows surface (on by default) switches back to flat rings everywhere, and Hide ring while stroking (off by default) shows only the dot while a stroke runs. The crosshair pointer stays while you turn the view. 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 Falloff). Esc closes the pop-up without typing anything new."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"each-brush-keeps-its-own-settings","h":"Each brush keeps its own settings","t":"Every brush remembers its own Size, Intensity, Falloff, Colour intensity, stroke and alpha. That includes custom and Community brushes. Set up a small, sharp crease brush and a big Clay brush, and each one comes back the way you left it when you switch between them. A brush you haven't used yet in the session starts from the values you have now, so nothing jumps. Sculpt > Brush > Save Brush Settings keeps the current brush's values for every new session (in brush-settings.json, in SculptForge's user data folder). Sculpt > Brush > Reset Brush to Default puts the current brush back to the values SculptForge ships with and forgets what you saved for it. Edit > Preferences > Input > Share size and intensity across brushes (off by default) keeps Size and Intensity the same for every brush, as before 0.10.8. Falloff, Colour intensity, the stroke and the alpha still follow each brush."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"smooths-own-intensity","h":"Smooth's own Intensity","t":"Smooth keeps an Intensity of its own, so a gentle Standard stroke at 10 still smooths at full speed. Hold Shift (or pick the Smooth brush) and the Intensity slider shows Smooth Intensity: change it there, or hold Shift and press U. It starts at 50."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"smooth-that-keeps-the-volume","h":"Smooth that keeps the volume","t":"The plain smooth evens out bumps by pulling each point towards its neighbours, so with every pass the form shrinks a little too: a cheek flattens, a sphere gets smaller. The other smooth keeps the volume: it removes the bumps but leaves the form where it is (a Taubin smooth, one step in and a slightly larger one back out). Alternate smooth: start a stroke with Shift held, then let go of Shift while still pressing. The rest of the stroke uses the other smooth, and the status line says which. Smooth keeps volume in Sculpt > Brush makes the volume-keeping smooth the one Shift and the Smooth brush use; letting go of Shift mid-stroke then switches to the plain one. Saved with the project."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"smooth-face-group-borders","h":"Smooth face group borders","t":"Smooth face group borders only in Sculpt > Brush turns Smooth (and Shift) into a border straightener: only the points on a border between face groups move, each along the surface toward its neighbours on the border, so a jagged edge (a cuff, a collar, the hem of a shirt, a panel line) becomes a clean line while the rest of the model stays where it is. Corners where three or more groups meet stay put. Group the clothing first (for example Group from Mask after masking it), then brush over the edge. Saved with the project (#81). On a micro level (see Micro levels) Smooth is always the plain one for now. On a quad mesh (after Quad Remesh, or an imported quad model) Smooth follows the quads' own edges, never their diagonals, so the quads keep their shape (#69). Sculpt > Draw & Tablet"},{"p":"sculpting.html","c":"Sculpting and brushes","a":"sculpt-paint-add-sub-rgb-and-front","h":"Sculpt, Paint, Add, Sub, Rgb and Front","t":"These toggles sit on the top shelf and in Sculpt > Draw & Tablet: Control What it does Sculpt / Paint Sculpt makes brushes change the shape. Paint (P) paints colour only. Add / Sub Add makes brushes add (the default), Sub makes them subtract. Alt flips the current choice for one stroke. Rgb Sculpt brushes also paint the current colour as they sculpt. Front Front faces only: brushes leave the far side of thin parts alone, such as the back of an ear or a cape. Sculpt > Brush has the same Front and invert settings as the checkboxes Front faces only and Invert (Alt)."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"falloff-options","h":"Falloff options","t":"Two more checkboxes in Sculpt > Brush change what a brush reaches, as Blender's proportional editing does (from the discussions). Both work with every sculpt brush, recipes, VDM stamps, masking and vertex paint, and are saved with the preferences and the project (custom brushes can turn them on for themselves in the Brush Lab): Option What it does Connected only The brush only moves the surface joined to the point under the cursor, within the brush size. Inflate a finger and the next finger stays as it is; Move one leg and the other doesn't follow, however close they are. View falloff The falloff is measured on screen, across the view: everything inside the brush circle is reached, through the model and out the back, as a cylinder along the view. Add Connected only to keep it to the piece under the cursor. Kelvinlet brushes keep their own elastic falloff, and the Gizmo's falloff eases in from the mask's edge rather than from a brush centre, so these options don't apply to them. On a 10-million-vertex Part a dab that moves half a million vertices takes about 10 ms, and about 16 ms with Connected only."},{"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). For Move, Tendril, Elastic Tendril and KelvinGrab, which have nothing to invert, it moves the surface along the normal instead (below). Shift (before the stroke) Smooths with the Smooth brush, whatever brush is active, at Smooth's own 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 face groups. See Face Groups and visibility."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"along-the-normal","h":"Along the normal","t":"Move, Tendril, Elastic Tendril and KelvinGrab normally move the surface across the screen. Hold Alt as you start the stroke (Ctrl in the Blender and Maya styles, where that key inverts) and the surface moves along the average normal under the brush where you pressed instead (from the discussions): drag out and it pulls straight out of the surface, drag back and it pushes straight in, however the view is turned. When the normal points right at you, drag up to pull it out. Edit > Preferences > Input > Along the normal can make it Always (no key needed, handy with a pen) or Never."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"the-quick-menu","h":"The Quick Menu","t":"Press Space for the Quick Menu under the cursor: the Brush, Stroke, Alpha and Material tiles, Size, Falloff, Intensity and Colour intensity, Add / Sub, 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. A right click on the canvas opens it too: press the right button and let go without moving, beside the model or on it, and the Quick Menu stays open at the cursor. A right drag still turns the view (and pans or zooms with Alt or Ctrl), and a pen button set to Right click (Edit > Preferences > Tablet) works the same way. Turn it off with Edit > Preferences > Input > Right click opens the Quick Menu."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"radial-menus","h":"Radial menus","t":"Radial (pie) menus put the tools you use most around the cursor. Hold a menu's key, flick the pointer toward an item and let go: it runs. Let go in the middle and nothing happens. Tap the key instead and the pie stays open: click an item, or click in the middle or press Esc to close it. Three menus are built in: Key Menu Items T Brushes Standard, Clay Block, Move, Sharp Crease, Inflate, Pinch, Flatten, Tendril Y Masking Invert Mask, Lasso Mask, Clear Mask, Rectangle Mask, Mask All, Mask Pen, View Mask, Group from Mask J Strokes Dots, Drag Stamp, Slide Stamp, Spray, Lazy Stroke (see Strokes) All three keys are free in every input style. Installs that stored their radial menus before 0.10.9 get the Strokes menu from Restore default menus in Edit > Preferences > Input > Radial Menus. Make your own in Edit > Preferences > Input > Radial Menus (up to 8 menus of 8 items each): + adds a menu and opens a search for its first item. An item can be anything the command palette (F3) finds: a brush, a tool, a command or a toggle. Click an item to give it your own label and icon, or Change action. The arrows reorder items (the first points up, the rest go clockwise); the cross removes one. Key sets the key that opens the menu (it is an ordinary shortcut, so Edit > Preferences > Hotkeys lists it too). The button next to it can also open the menu while held: the middle, right, back or forward mouse button, or one of the pen's side buttons. That button then stops doing what it did before (a pen button's Edit > Preferences > Tablet mapping, the middle button's pan, the right button's turn). A mouse button opens the menu only with no modifier key held (#74): Alt+middle still pans, Alt+right still zooms in the Maya style, and Shift+right-drag still turns the view, so a menu on the right button never leaves you without a way to turn it (the panel says how). Export... saves the menu as a small .json file to share; Import... loads one. A menu file holds only action names, never anything that runs: names this version doesn't know are left out. Restore default menus brings back Brushes and Masking. Your menus save themselves."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"whole-part-deformations","h":"Whole-Part deformations","t":"Tool > Deformation has four operations that work on the whole active Part at once, each with its amount beside it (from the discussions). The mask holds what it covers (partly masked areas move partly), hidden faces and open borders stay where they are, and each is one undo step: Operation What it does Polish Flattens fine noise and small bumps while flat areas and sharp edges stay sharp: a scan's grain, or the ripples a voxel remesh leaves on a hard-surface piece. Relax Evens out the spacing of the vertices along the surface without changing its shape, for areas a big Move or Tendril stretched. Smooth Smooths everything; with Smooth keeps volume it doesn't shrink the form. Balloon Fills the form out toward a rounder volume, like blowing into it (experienced sculptors: Inflate Balloon). A negative amount lets the air out. They are commands too: deform_polish amount=60, deform_relax, deform_smooth amount=30 keep_volume=true, deform_balloon amount=-20 (add masked=false to ignore the mask). On a 10-million-vertex Part at amount 50, Smooth takes about 0.5 s, Balloon 0.7 s, Relax 0.9 s and Polish 2 s (Apple M1 Pro)."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"size","h":"Size","t":"Tool > Deformation > Size shows the active Part's width (X), height (Y) and depth (Z) in scene units (requested by foirgairwolf on Discord). Drag one, or double-click it and type an exact value: the Part resizes about its centre as one undo step. With Uniform on (the default) the other sides follow in proportion; off, only that side changes. The mask holds what it covers. Command: deform_size x=2.5 (any of x, y, z), or deform_size uniform=10 for the largest side."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"deformation-stack","h":"Deformation stack","t":"Tool > Deformation > Stack shapes the whole Part with a list of steps (requested by foirgairwolf on Discord). Add step picks one; click a step to set its amount, its axes (X Y Z, any mix) and, where it applies, Direction and Soft. With Preview on, the Part follows each change (on very heavy Parts, when you let go of the slider). Group Step What it does along the chosen axis Transform Move Moves the Part by a percent of its half-size. Turn Turns it by degrees about the axis (several axes: X, then Y, then Z). Scale 100 doubles it, -100 halves it, on the chosen axes only. Squash Shorter along the axis and wider across it, keeping the volume (negative: taller and thinner). Bend & Twist Bend Curves it end to end by degrees toward Direction (0 = toward +Y, +X for the Y axis). Twist Turns one end against the other by degrees. Taper The + end wider and the - end narrower (negative: the other way). Shear Leans it toward Direction; 100 is 45 degrees. Shape Round Toward a sphere; with one axis left out, toward a cylinder about it. Box Toward a cube (or a square bar). Flatten Cuts the + side flat by a percent of the depth (negative: the - side). Sag Parts far from the axis droop down it, like a weight on outstretched arms (negative lifts). Depth A perspective: the + end wider, the - end narrower, more toward the ends. Surface Polish, Relax, Smooth, Balloon As above. Soft eases Bend, Twist, Taper and Shear toward the ends (a bend that curves most in the middle) and rounds Flatten's cut. Steps work about the Part's centre, or about the gizmo's pivot when you placed it. The checkbox beside a step switches it off without losing it; Repeat adds the selected step again; Remove takes it out. Apply keeps the result (one undo step) and starts a new stack, Apply Selected keeps only the selected step, and Reset takes the preview back off. The mask holds what it covers and hidden faces stay. For scripts and the AI: deform_stack ops=\"bend 45 y soft; twist 90 y; taper -30 y\", or one step at a time with deform_bend amount=45 axes=y soft=true direction=90."},{"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 Sculpt > Stroke. 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. Drag Stamp Click and drag one stamp: the drag length sets its size and its direction the rotation. Great with alphas. None Slide Stamp Click and drag one stamp of the brush's 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. Lazy Stroke Dots with Steady Stroke on: the brush trails the cursor on a string, for smooth, steady lines. Steady radius (1 to 300 px, default 40): longer is steadier. Scatter appears under the stroke tiles when Spray is selected. Steady Stroke works with every stroke type; see Precision work. Continuous, under the stroke tiles in the stroke picker and in Sculpt > Stroke, keeps the brush working while you hold it still on the model (30 dabs a second), with any stroke type. Notes: With Drag Stamp, 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 Slide Stamp, 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 Drag Stamp or Slide Stamp is selected. Custom brushes set their own dab spacing and can add jitter (see Brush Lab)."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"the-stroke-popup","h":"The stroke popup","t":"Press G (Z in the Blender style) for a grid under the cursor, or click the grid button under the Stroke tile on the left shelf. The top row holds the stroke types, then come the modifiers and the shapes: Modifier What it does Instead of holding Add / Sub Brushes add to or subtract from the surface (the same switch as Add / Sub on the top shelf). Alt Smooth Strokes smooth. Shift Mask Strokes paint the mask (Alt or Ctrl unmasks). Ctrl Select Strokes draw the selection (hide) shape. Ctrl+Shift Shapes pick how Mask and Select draw: Mask Pen, Lasso Mask and Rectangle Mask turn Mask on with that shape, Cut Line, Cut Lasso, Cut Rect and Cut Polyline turn Select on with that Cut shape. A plain drag then masks or cuts with it, no keys held (with a mask shape, Ctrl+drag unmasks; Tool > Cut still sets Away, In, Add or Clip). The label next to the brush cursor names the shape. Pick it again to go back to sculpting. Hold and let go: hold G, move over an item and let go. It opens with your current stroke under the pointer, so letting go without moving changes nothing. A pen hovering over the tablet works the same. Tap and click: tap G and the grid stays open. Click a stroke to pick it (the grid closes); click a modifier to switch it (the grid stays open, so you can set a stroke too). Esc or a click beside the grid closes it. The click never touches the model. Smooth, Mask and Select stay on until you pick the same one again or pick another brush. A small label next to the brush cursor shows which one is on. Dragging beside the model still turns the view. The Strokes radial menu (J, see Radial menus) picks a stroke type too; the popup adds the modifiers and shows every choice at once. Change the key in Edit > Preferences > Hotkeys (Stroke popup), or hold Ctrl+Alt and click the shelf button, then press the new key."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"precision-work","h":"Precision work","t":"Pores, wrinkles, jewellery and hard-surface trims need a brush that goes exactly where you mean, at exactly the size you mean. These tools work with every brush and every stroke type. Steady Stroke (L, or the checkbox in the stroke picker). The brush trails the cursor on a string and only moves once the string is taut, so hand shake never reaches the surface. It works with Dots, Drag Stamp, Slide Stamp and Spray. The viewport draws the string and a faint circle of its length. Steady radius sets the length (longer is steadier). Catch up on release (on by default) finishes the line to where the cursor is when you let go; turn it off to end the line a string's length behind. World Size (Sculpt > Draw & Tablet). Size is normally in screen pixels, so the brush gets smaller on the model as you zoom in. With World Size on, the size is kept in model units instead: a 0.4 mm pore brush stays 0.4 mm whether you are looking at the whole head or one eyelid. Every Size slider shows both numbers, for example Size 12 px 0.40 mm; the mm figure is the brush radius on the surface under the cursor (a model unit is a metre, as when exporting for 3D printing). Finer size control. Do this Change [ / ] 10% smaller / larger Shift+[ / Shift+] 1 px smaller / larger (0.5 px below 2 px) Ctrl+Shift+right-drag Scrub the size finely: 100 px to the right is about 1.5 times larger Size goes down to 0.5 px. Small brushes space their dabs closer together, so a 1 px stroke is still one continuous line, and the cursor adds a small cross so you can see where a tiny brush is. The size, in px and mm, shows next to the cursor for a moment after it changes (all the time with World Size on). Precision drag (Shift+Alt, held while drawing). Start the stroke, then hold Shift+Alt: the brush moves at a quarter of the pen's speed, drawn as a blue ring with a line back to the pen, and works at Precision Intensity (stroke picker, default 10). Let go and the brush glides back under the pen as you keep moving; it never jumps. Hold the keys after the stroke has started: at the press, Shift+Alt still selects and frames a Part, and in the Blender style Alt+click still navigates. The same works in every input style. A pressure curve for each brush. Every brush keeps its own pen pressure curve, applied after the tablet's curve. Edit it in Brush Lab (under the recipe sliders) or in Edit > Preferences > Tablet (under the tablet's curve); both edit the brush you are holding. Drag a point, double-click the curve to add one (up to 5), right-click a point to remove it. The presets are Soft, Linear, Firm and Fine detail: Fine detail keeps light pressure very light and tops out below full strength, for pores and fine lines. Curves are saved as you change them. Accuracy. The brush centre sits exactly under the cursor at any zoom and on HiDPI screens (to a fraction of a pixel), and the surface point under the brush is lightly filtered, so strokes on very dense meshes don't wobble with every tiny bump. A real step in the surface is followed at once."},{"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 Sculpt > Alpha, which also shows a large preview of the current alpha. Falloff fades it: set it to -100 to stamp the whole alpha (a crisp square, or a pattern out to its edges), 0 for a soft round fade, +100 for a soft point. Alphas work on micro levels too, with every stroke type including Drag Stamp. 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. Pores Scattered skin pores of mixed sizes (use with Sub to press them in). Cracks A web of thin cracks, as in dry earth, old paint or stone. Scales Overlapping rounded scales in offset rows, for reptiles and fish. Rivets A three by three grid of round rivet heads, for armour and machines. Stitches A seam with cross stitches along it (drag along the seam with Drag Stamp or a stroke). Fabric Weave Threads woven over and under, for cloth and canvas. Bark Rough vertical ridges and furrows, as on tree bark. Rock Strata Stepped layers of rock, wavy and broken, for cliffs and stone. Wrinkles Fine parallel wrinkle lines, for skin around eyes, knuckles and necks. Skin Folds Soft, broad folds of skin, for bellies, elbows and heavy brows. Hair Strands Long flowing strands, for hair, fur and feathers (drag along the flow). Dot Grid An even grid of soft dots, for studs, textures and patterns. All of them are made by SculptForge itself the first time they're needed (no image files are downloaded or shipped). They show in the alpha picker and in the Library's Alpha tab (brush_set_alpha name=cracks). To use your own image: Click Load image... in the alpha picker or Sculpt > Alpha. 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 Library 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 Drag Stamp it follows the drag direction instead. From a script: brush_set_alpha name=square, or brush_set_alpha path=bark.png invert=true."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"alpha-options","h":"Alpha options","t":"Under the preview in Sculpt > Alpha: Option What it does Follow stroke direction The alpha turns with the stroke, its top pointing the way you draw: scales, stitches and hair line up along the stroke. Small wobbles are smoothed out, as with Blender's Rake: the direction is taken again each time the cursor has gone 20 pixels. Angle Turns the alpha by a fixed angle (-180 to 180 degrees, counter-clockwise), on its own or on top of the stroke's direction. Angle jitter Turns each dab by a random angle, up to this many degrees either way, to break up repeats. Tile across / Tile down Repeats the alpha 1 to 8 times across and down inside the brush; the preview shows the result. They work with every brush, custom and Community brushes included, and each brush keeps its own (see Each brush keeps its own settings). Save Brush Settings on a custom brush also writes Follow stroke direction, Angle and Angle jitter into its brush file, so a brush you share (a brush code, a .sfpack) turns its alpha the same way for everyone. Vector displacement stamps have the same options: see Stamp rotation. From a script: brush_alpha_options follow_stroke=true angle=30 angle_jitter=10 tile_x=2 tile_y=2."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"stencil","h":"Stencil","t":"A Stencil is an image laid over the view that you sculpt and paint through: wherever it covers the model, a stroke takes its detail (the sculpt brushes its brightness, white = full effect, as an alpha; Vertex Paint its colours). Off the image nothing happens. It stays put on the screen while the model turns under it, so you place it, stroke over it, turn the model or move the stencil, and stroke again. A Cobblestone stencil over a sphere, turned and placed with Adjust In Sculpt > Alpha, under Stencil, click Load image... (any PNG, JPG, BMP, TGA, PSD or GIF), or Use alpha to make the brush's alpha (a built-in pattern or one from your Library) the stencil. Turn on Adjust: drag inside the stencil to move it, a corner to scale it, the round handle above it to turn it (Shift: 15 degree steps). The arrow keys move it, - and = scale it, , and . turn it (Shift: finely). Enter or Esc goes back to sculpting. Stroke over it with any brush that takes an alpha: the built-in sculpt brushes, custom and Community brushes and the Paint brush. The brush's own falloff, Intensity, mask and alpha still apply on top. The same sphere with the stencil hidden: four Standard strokes left its stones Option What it does Show Hidden, the stencil is off and brushes work as if it weren't there. Invert Uses the image's negative: black works, white leaves the surface alone. Tile Repeats the image across the whole view, for skin, fabric and other patterns. Paint its colours Vertex Paint lays the image's own colours; off, its brightness masks the paint colour. Hide while navigating Fades the stencil while the view turns, moves or zooms, so you see the model under it. Opacity How strongly the overlay shows. The brushes always take the whole image (use Intensity to go lighter). Size / Angle Its height in percent of the view's, and its turn; Reset placement centres it again. With symmetry on, the mirrored side gets the stencil mirrored, as the stroke is. Stencils work on micro levels too. Move, the Kelvinlet brushes, vector displacement stamps and the mask brush don't use it. Texture painting doesn't take it yet (Vertex Paint does). The stencil isn't saved with the project. From a script: stencil_load path=skin.png, stencil_set x=0.5 y=0.5 size=0.8 angle=30 tile=true, stencil_clear."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"vector-displacement-brushes","h":"Vector displacement brushes","t":"A vector displacement brush 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 Sculpt > Brush > Vector Displacement"},{"p":"sculpting.html","c":"Sculpting and brushes","a":"stamp-a-vdm","h":"Stamp a VDM","t":"Open Sculpt > Brush and its Vector Displacement section, and click a map: Horn, Ear Curl, Scales, Nostril, Rivet (a domed head whose rim overhangs), Stitches (thread bars across a seam, drawing it together), Skin Fold (a roll of skin hanging over a crease), Wrinkle Line (a fine pinched crease), Crack (a jagged split whose sides part) or Rock Ledge (a stepped shelf jutting out over the layer below). They're also in the Library's Brush tab. The VDM brush becomes the brush and the stroke becomes Drag Stamp. (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. Slide Stamp stamps at the brush size instead and slides the stamp under the cursor until you let go. 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."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"stamp-rotation","h":"Stamp rotation","t":"While the VDM brush is the brush, Stamp rotation sits under the map's preview, with the same three options as Alpha options: Option What it does Follow stroke direction On (the default): Drag Stamp turns the stamp with the drag, and a Dots stroke turns it along the stroke. Off: the drag only sets the size, and every stamp keeps Angle's turn (horns that all stand the same way however you drag). Angle A fixed turn, -180 to 180 degrees counter-clockwise, on its own or on top of the drag's direction. Slide Stamp takes it too (it slides the stamp without turning it). Angle jitter Each stamp turns by a random angle, up to this many degrees either way: scattered horns, rivets or scales that don't all face the same way. The VDM brush keeps its own, separate from the alpha brushes'; Save Brush Settings keeps them for next time, and a custom brush saves them in its brush file, so they travel in brush codes and packs. From a script: brush_alpha_options follow_stroke=false angle=45 angle_jitter=20. 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 Sculpt > Brush > Vector Displacement, click New VDM Plane. A flat 2 x 2 grid appears as a new Part, seen from the top, with its border masked (so the stamp blends into any surface); the other Parts are hidden. Plane Res sets how many quads it has (256 by default). Sculpt the shape with any brush: overhangs are welcome (Move, Tendril, 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 Part 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 Drag Stamp 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","h":"Load and export maps","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 Drag Stamp) 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. Maps made in other applications may use other axes. If a map 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\"."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"kelvinlet-brushes","h":"Kelvinlet brushes","t":"KelvinGrab, KelvinTwist, KelvinScale and Elastic Tendril move the surface the way an elastic solid moves when you push, twist or squeeze it. Each is the exact solution of the equations of elasticity for a softened point load (the \"regularized Kelvinlets\" of de Goes and James, SIGGRAPH 2017), so the surface follows your hand like clay: there is no falloff edge to see, the deformation fades smoothly over about twice the brush radius, and the material around it reacts the way real material does. KelvinGrab pulls with symmetry and Squash at 100, and a KelvinTwist in the middle: no falloff edge anywhere KelvinGrab works like Move: press on the model and drag; the point under the cursor goes where the cursor goes and the surface around it follows elastically. KelvinTwist turns the surface around where you pressed, about the view direction. Drag right to turn clockwise, left to turn back; the turn is strongest at the centre and fades out, and every ring keeps its shape (a true rotation), so twisted shapes keep their volume. Good for twisting horns, tentacles, folds of cloth and spiral shells. KelvinScale pinches (drag left) or swells (drag right) the surface toward or away from where you pressed. It never folds the surface through the centre, however hard you pinch. Elastic Tendril pulls horns, tentacles and spikes out along the stroke like Tendril, but its pull narrows as it travels, so shapes taper to a tip by themselves. Their settings are in Sculpt > Brush > Kelvinlet & Capture: Squash (0-100) is how the material keeps its volume (its Poisson's ratio). At 0 it's rubbery: pulling it just stretches it. At 100 it's incompressible clay: pressing in makes the surface bulge up around your thumb and pulling out draws the sides in, as clay does. 50 is the default. Sharpness gives the brush a tighter, more pointed peak at its centre while keeping its soft reach, for pulling out points and tips. Intensity sets how strongly the surface follows (50 and above: the grabbed point follows the cursor exactly), pen pressure scales it, and like every brush they respect symmetry, the mask, hidden parts and sculpt layers, and each stroke is one undo step. They don't remesh with dynamic topology on (like Move). How it stays fast: a Kelvinlet's influence never quite reaches zero, so each move works out how far its effect is still more than 4% of its largest (about twice the brush radius) and only touches the points inside that distance, fading the last part smoothly to nothing. A fast drag between two frames is worked out in small pieces in one pass. Because it reaches further than Move, it costs more: on models of 20 million triangles and up, keep the brush small or step down a subdivision level for big elastic moves (see Performance)."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"capture-an-alpha-or-a-vdm-from-the-model","h":"Capture an alpha or a VDM from the model","t":"Any detail you have sculpted can become a brush in two seconds: Capture from view (Ctrl+Alt+C, or the button in Sculpt > Brush > Kelvinlet & Capture). A horn captured from the sphere (the window: its height alpha and VDM) and cloned along a stroke below it Press Ctrl+Alt+C and drag a square over the detail, corner to corner (hold Shift as you press to drag a circle from its centre instead). Esc cancels. The Capture from view window shows two results, side by side: a height alpha: the surface's height toward you, measured from a plane fitted to the surface and scaled to black-to-white; a vector displacement map: the true 3D offset of every point from a smooth base surface, in that base's own frame, so overhangs and sideways leans come along. Adjust if needed: Base Smoothing decides what counts as detail (0 measures from a flat plane, the whole shape; higher takes more of the broad form away, so a wrinkle captured on a curved forehead stamps flat), Edge Fade blends the border out, Resolution sets the pixels, Fit plane and Invert apply to the alpha. Changes capture again from the same square. Use it: Use as Alpha (it shapes every brush), Use as VDM (the VDM brush stamps it with Drag Stamp), Detail Clone (paint copies along strokes) or Save to Library: the alpha goes to your Library Alphas folder as a PNG and the VDM to your brush library, both with thumbnails (the VDM also shows in the Library Brush tab, the alpha picker and Sculpt > Brush > Vector Displacement). The square is captured along your view, so look at the detail straight on. The capture takes about a tenth of a second for a small detail and a second or so for a large patch of a 20-million-triangle model."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"detail-clone","h":"Detail Clone","t":"DetailClone stamps the VDM brush's map (a captured one or any other) along your stroke, one copy every stamp width, each turned so its top points the way the stroke goes: rows of scales, rivets, stitches or warts that follow a curve. Clone Spacing sets the distance between copies (1 = edge to edge) and Clone follows stroke can keep every copy upright instead. Size sets their size and Intensity their depth; a click without moving stamps one. Each copy is shaped to the surface under it."},{"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 Sculpt > Symmetry & Gizmo. 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: turn on Local (below)."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"radial-symmetry","h":"Radial symmetry","t":"Radial symmetry repeats every stroke around an axis, for wheels, flowers, columns, crowns and other round ornaments. Turn it on with R on the top shelf or in Sculpt > Symmetry & Gizmo > Symmetry, then set: Radial Copies: how many copies, evenly spaced around the axis (2 to 64; 8 to start with). X axis, Y axis or Z axis: the axis the copies turn around (Y, up, by default). Radial symmetry works with the mirror axes: with X on as well, each copy is also mirrored, so 8 radial copies make 16. It applies wherever symmetry does: every brush and stroke type, mask and smooth strokes, vertex paint and texture painting, Rectangle Mask / Lasso Mask and Select Rectangle / Select Lasso, Dynamic Topology (new triangles appear on every copy) and Insert on the model. The brush cursor shows on every copy, so you can see where each one lands."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"local-symmetry","h":"Local symmetry","t":"Local (next to R in Sculpt > Symmetry & Gizmo > Symmetry) puts the mirror planes and the radial axis through the middle of the active Part (the centre of its bounding box) instead of the world origin. Use it for a Part that isn't centred on the origin, such as a button on a jacket or a wheel on a car. The centre follows the Part: it is worked out again when you switch Parts or after an edit. R and Local have no default key; you can assign one (see The interface). Projects save the symmetry settings, radial and local included. Scripts and sculptforge-cli use the same settings: commands that take symmetry (stroke, vdm_stamp, mask_rect, mask_lasso, hide_rect, hide_lasso, insert_primitive, insert_mesh) also take radial (the count), radial_axis (x, y or z) and local (true for the Part's centre), for example stroke points=... symmetry=x radial=8 radial_axis=y."},{"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, Sculpt > Draw & Tablet 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 Sculpt > Draw & Tablet > 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). Move, KelvinGrab, KelvinTwist and KelvinScale always grab with the full size. Each brush can override them. Sculpt > Brush > Pen pressure (and the same switches in Brush Lab and Edit > Preferences > Tablet) sets Size and Strength for the brush you are holding to Use global, On or Off. Use global follows the toggles above; On and Off apply to that brush whatever the toggles say, so you can keep Pressure > Size on for Clay and off for Standard. Grab brushes (Move, KelvinGrab, KelvinTwist, KelvinScale, Tendril and Elastic Tendril) start with Size: Off, every other brush with Use global. The switches are kept per brush like its size and alpha: Sculpt > Brush > Save Brush Settings keeps them for the next start, Reset Brush to Default puts back the brush's default, and a custom brush also keeps them in its .sfbrush file. Brush settings saved before 0.11.1 load as Use global (grab brushes: Size: Off). 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. Edit > 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). A side button can open a radial menu instead (Edit > Preferences > Input > Radial Menus). Mouse mode (relative): the pen moves the cursor by how far it moves, like a mouse, and putting it down elsewhere on the tablet leaves the cursor where it was, with the driver in pen mode or in its own mouse mode. While the pen is in range the arrow is drawn at the brush (the system's is hidden), so brush, arrow and clicks always agree (#72). These settings save themselves. 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, Clay Block, Sharp Crease, Move, Smooth, Inflate, Pinch, Flatten, Crease, Trim, Tendril, 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 Edit > Preferences > Config > Customize Shelves, 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. Edit > Preferences > Config > Save Layout keeps 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 Part, 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 Vertex Paint 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 (dynamic topology) 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 Sculpt > Brush. 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. Not there? AI features are off: turn them on in Edit > Preferences > AI (see Turning AI off)."},{"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 Sculpt > Brush 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. Under the recipe sliders are the brush's pressure curve and Pen pressure: Size and Strength, each Use global, On or Off. Use global (the default) follows Pressure > Size and Pressure > Strength on the top shelf and in Edit > Preferences > Tablet; On and Off override them for this brush only. The choice is saved in the brush's .sfbrush file, so a shared brush keeps it (see Pen pressure and tablets). 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 Mesh > Generate 3D > AI brush provider and Edit > Preferences > AI > Provider) to choose another service. Each choice fills in the address and a model: 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) An Anthropic API key Uses claude-opus-5-5 by default. Effort (low, medium, high) trades speed for more considered brushes. OpenAI An OpenAI API key Click Find models to pick one. Ollama (this computer), LM Studio (this computer) The app running on your computer Private and offline, no key. See below. vLLM server, llama.cpp server A server on your computer or at your studio Change the address to your server's. LiteLLM proxy (studio gateway) Your studio's gateway address One address for every model your studio allows; a key from your studio, or your studio sign-in. See IT deployment. OpenRouter An OpenRouter key Many models through one key. Other OpenAI-compatible server An endpoint, a model name and, for hosted services, a key Any server that speaks the OpenAI chat completions API. You can edit the Endpoint, Model and API key fields. Leave the key empty to use the ANTHROPIC_API_KEY, OPENAI_API_KEY or OPENROUTER_API_KEY environment variable. Click Save settings to keep your choice. Keys are kept in your system's keychain (macOS Keychain, Windows Credential Manager, or the Secret Service on Linux), never in a settings file. Requests go only to the endpoint you set. If your studio manages SculptForge, some providers may be greyed out with Managed by your studio."},{"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 Ollama (this computer) (or LM Studio (this computer)). 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 Sculpt > Brush, 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":"Sculpt > Brush 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 Sculpt > 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 Library library (Documents/SculptForge by default) appear in the Library section of the brush picker and in Library'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 Sculpt > Brush. 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":"brush-packs.html","c":"Brush packs","a":"","h":"Brush packs","t":"SculptForge comes with sixty ready-tuned brushes in six packs, on top of the built-in brushes. Each one is a brush recipe (see Brush Lab) with its own alpha where it needs one, so you can use them as they are, or open one in Brush Lab and make your own version. Every brush, alpha and preview here is made by SculptForge itself: the recipe engine, procedural alphas and the same clay-ball thumbnails as the brush picker."},{"p":"brush-packs.html","c":"Brush packs","a":"find-and-pick-a-pack-brush","h":"Find and pick a pack brush","t":"Sculpt > Brush: the grid shows Built-in, Custom, then Brush packs. Sort: A-Z > Pack shows one section per pack. The filter field finds a brush by name. B opens the brush picker: type the first letters of the name, then the orange key. Custom brushes in Sculpt > Brush lists every pack brush with its pack's name beside it. Scripts and macros: brush_use name=\"Rivet Row\"; brush_list shows every brush with its pack. The first time you pick a pack brush it brings its own alpha (Rivet Row brings Rivets, turned along the stroke); brushes without one go back to the plain round tip. From then on the brush keeps whatever you change, as every brush does (Sculpt > Brush > Save Brush Settings keeps it for good, Reset Brush to Default brings back the pack's). Pack brushes are read-only like the other built-ins: changing one in Brush Lab saves your own copy, which replaces it in the lists until you delete it. Textures (pores, stitches, weave, rivets) need enough polygons to show: subdivide, or turn on Dynamic topology, until the brush's detail is several polygons wide."},{"p":"brush-packs.html","c":"Brush packs","a":"clay--form","h":"Clay & Form","t":"Block in, build up and refine big forms: clay strokes, planes, and smooth blends. The Clay & Form brushes Brush What it does Alpha Block Former Big, flat-topped clay strokes that stack fast, for blocking in primary forms. Square Soft Clay Gentle round clay that builds in thin layers and blends into the surface. Clay Strip Narrow, crisp strips of clay with a hard edge, for muscle fibres and planes. Square Plane Cutter Shaves the surface down to flat planes, for stylised forms and stone. Volume Fill Fills low areas up to the stroke's plane and leaves the high points alone. Level Out Presses hills and valleys onto one plane and softens the result, to calm busy areas. Swell Puffs the surface out along its own normals, for cheeks, bellies and soft volumes. Form Smoother Relaxes lumps while keeping the big shape, for a clean pass after blocking. Clay Drag Smears soft clay along the stroke like a thumb pushing it, for blending transitions. Edge Definer Pinches a crisp edge into the surface where two planes meet. "},{"p":"brush-packs.html","c":"Brush packs","a":"hard-surface","h":"Hard Surface","t":"Crisp planes, panel lines, bevels, rivets and bolts for props, armour and machines. The Hard Surface brushes Brush What it does Alpha Panel Groove Cuts a clean, narrow groove for panel gaps and seams. Flat Plane Presses a perfectly flat face with a hard edge, for machined surfaces. Square Bevel Scrape Scrapes high points into a bevel along an edge, for chamfers. Raised Plate Builds a flat, square-edged plate on the surface, for armour and hull panels. Square Rivet Row Stamps rows of round rivet heads along the stroke. Rivets Bolt Head Stamps a hexagonal bolt on a washer; space the dabs out or click once. Bolt Hex Armour Raises a honeycomb of hexagonal plates, for sci-fi armour and shells. Hex Plates Vent Slots Cuts parallel slots like a vent grille; drag across the slots. Wrinkles Grid Studs An even grid of small studs, for grip textures and tread plates. Dot Grid Hard Cut Cuts the surface flat below the stroke, for sharp silhouettes and clean cuts. Square"},{"p":"brush-packs.html","c":"Brush packs","a":"organic--skin","h":"Organic & Skin","t":"Pores, wrinkles, folds, veins and scales for creatures and portraits. The Organic & Skin brushes Brush What it does Alpha Fine Pores Small, evenly scattered pores for faces and close-ups. Pores Deep Pores Bigger, deeper pores for noses, cheeks and rough skin. Pores Crow's Feet Fine fanned wrinkle lines, for eye corners and knuckles. Wrinkles Skin Fold Soft rolls of heavy skin, for necks, bellies and brows. Skin Folds Crease Line A sharp, deep crease with pinched sides, for eyelids, lips and nasal folds. Vein Raises thin, soft-edged veins along the stroke. Reptile Scales Overlapping rows of rounded scales, for lizards, dragons and fish. Scales Leather Hide Pebbled grain with fine creases, for leather, elephant and rhino skin. Leather Grain Muscle Fibre Long soft ridges along the stroke, for muscle striation and sinew. Hair Strands Flesh Pinch Pulls soft flesh together into a ridge, for lips, knuckles and wrinkles that bunch. "},{"p":"brush-packs.html","c":"Brush packs","a":"cloth--folds","h":"Cloth & Folds","t":"Folds, seams, stitches, weave and knit for clothing and soft goods. The Cloth & Folds brushes Brush What it does Alpha Fold Ridge Raises a rounded fold of cloth with soft sides. Fold Valley Carves the soft valley between two folds. Tension Crease A sharp crease where cloth pulls tight, for armpits, elbows and seams under strain. Seam Stitch A sewn seam with cross stitches; drag along the seam. Stitches Woven Cloth Threads woven over and under, for canvas, denim and sacking. Fabric Weave Knitted Wool Rows of V-shaped loops, for jumpers, scarves and chunky knits. Knit Hem Edge A flat, square-edged band along the stroke, for hems, cuffs and straps. Square Cloth Drape Drags the surface along the stroke so folds flow and hang, for drapery. Wrinkle Bunch Small compressed wrinkles where cloth gathers, at waists and wrists. Padded Quilt Puffs soft panels up between the stroke's edges, for quilting and padding. Square"},{"p":"brush-packs.html","c":"Brush packs","a":"damage--wear","h":"Damage & Wear","t":"Cracks, chips, dents, scratches and erosion for weathered stone, wood and metal. The Damage & Wear brushes Brush What it does Alpha Dry Cracks A web of thin cracks, for dry earth, old paint and stone. Cracks Deep Fissure One deep, jagged split, for broken rock and ice. Edge Chips Knocks angular chips out of edges only; flat areas stay whole. Chips Dents Soft, scattered dents, for beaten metal and hammered surfaces. Scratches Thin, sharp scratches along the stroke, for scuffed metal and wood. Eroded Stone Breaks the surface up with noise, for weathered rock and sandstone. Rock Layers Stepped, broken strata, for cliffs and layered stone. Rock Strata Cobbles Packed rounded stones with grooves between, for paths and old walls. Cobblestone Wood Grain Rough furrows and ridges, for bark and weathered planks; drag along the grain. Bark Worn Edges Softens and rounds only the sharp ridges, as years of handling do. "},{"p":"brush-packs.html","c":"Brush packs","a":"ornament","h":"Ornament","t":"Beads, ropes, filigree, studs and carved patterns for jewellery, trims and decoration. The Ornament brushes Brush What it does Alpha Bead Chain A row of round beads along the stroke, for jewellery and trims. Rope Twist A twisted rope or cord, for borders and rigging. Hair Strands Filigree Line A thin, raised wire line, for filigree and engraved borders. Engrave Cuts a fine, crisp line, for engraving, runes and lettering. Stud Row Rounded studs spaced along the stroke, for belts, doors and armour trims. Raised Band A flat, raised band with clean edges, for bezels, rims and mouldings. Scroll Relief Soft, rounded relief that builds up slowly, for carved scrolls and leaves. Scale Mail Rows of small scales, for armour, roof tiles and feathers. Gem Setting A raised round setting with a crisp rim, for cabochons and gem seats. Dot Texture Fine even dots, for stippling, punched leather and decorative fields. Dot Grid"},{"p":"brush-packs.html","c":"Brush packs","a":"new-alphas","h":"New alphas","t":"Six procedural alphas came with the packs and work with any brush (Sculpt > Alpha): Cobblestone, Leather Grain, Hex Plates, Knit, Bolt and Chips. Sculpt > Alpha lists every alpha A-Z (Round, the plain tip, first), has a filter field, and Sort for the most recently used first or by pack."},{"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 panel for inverting, blurring, growing and building masks from cavities, peaks, face groups, vertex paint, the direction the surface faces or the mesh border. 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 Part: each Part has its own mask. Masks are saved in projects (.sfproj) and in Bridge files, so they survive a round trip through the Bridge. 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. The same toggle is Show mask in Tool > Masking, and Show Mask in the Render palette. Turning it off hides the darkening without clearing the mask: it still protects the surface, the status bar says so, and turning it on again shows the same mask. Clear Mask (Ctrl+Shift+A) is what removes it."},{"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 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 Drag Stamp stroke masks with dabs along the path instead of one stamp. On macOS, Cmd works wherever this guide says Ctrl."},{"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. 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 Mask Pen, Lasso Mask or Rectangle Mask, 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 Mask Pen (default) Paints the mask with the brush, as described above. Lasso Mask Draws a free-hand outline that closes back to where you started. Everything inside is masked. Rectangle Mask Draws a rectangle. Everything inside is masked. With Lasso Mask or Rectangle Mask: 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. With symmetry on (X, Y, Z on the top shelf), the mirror image of what's inside is masked too, as a mask stroke mirrors. A shape that covers none of the model clears the mask instead. 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. Turn on Front faces only (under the shape buttons, shown for Lasso Mask and Rectangle Mask) to mask only what faces you: the far side of the model and folds turned away from you are left as they are. It follows the mirror image too when symmetry is on. The cursor turns into a small cross while Ctrl is held, since the brush size doesn't matter for a selection."},{"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 Draw a mask rectangle (Mask Pen; Lasso Mask draws a lasso): what it covers is masked, mirrored by the symmetry. A shape that covers none of the model clears the mask. Ctrl + drag on the background, with nothing masked Zoom the view in the SculptForge style (the default); with the Classic sculpting keys it draws the mask rectangle above (see Keyboard and mouse) On the model, a Ctrl + click that doesn't drag works on the mask's edges, whichever mask shape is picked: 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 from Mask: the masked part becomes a new face group and the mask is cleared (see Face Groups) A drag starts after the cursor moves a few pixels, so a slightly shaky click still inverts. With Lasso Mask or Rectangle Mask, a Ctrl + drag on the background draws that shape; to clear the mask, draw it away from the model, or use Clear."},{"p":"masking.html","c":"Masking","a":"the-masking-panel","h":"The Masking panel","t":"Open Tool > Masking (the Tool palette is in the right tray by default). It has three rows of buttons, each with a picture of what it does (the masked part dark, as in the viewport); hold Ctrl over a button for its hint. Every button is one undo step. Tool > Masking: Shapes, Mask by and Adjust Shapes: what Ctrl + drag does. Button What it does Command Mask Pen Paint the mask with the brush; Ctrl+Alt erases. Lasso Mask Mask what is inside a free shape you draw. mask_lasso Rectangle Mask Mask what is inside a rectangle. mask_rect Front faces only (lasso and rectangle) masks only what faces you. Mask Strength is how much each stroke, shape or Mask by button masks (0.01 to 1). Mask by: build a whole mask at once. Each one replaces the current mask. Button What it masks Command By cavity Concave areas: creases, folds, pores. mask_by_cavity By peaks Convex areas: ridges, peaks and sharp edges (the opposite of By cavity). mask_by_peaks By face group One face group (the number under Mask by options). mask_by_facegroup By colour Vertex paint close to the main colour (the left shelf's swatch); unpainted clay counts as white. mask_by_color By facing Surface that faces the camera (or up, or down) within an angle: the front of a face, the top of a rock. mask_by_facing By border The open edges of the mesh and the rings of edges inside them, so sculpting keeps the border in place. A closed mesh has no open edges, and the status bar says so. mask_border Adjust: change the mask there is. Button What it does Command Grow / Shrink Expand or contract the masked region by one ring of edges per pass. mask_grow / mask_shrink Sharpen / Blur Tighten or soften the mask's edges. mask_sharpen / mask_blur Invert Masked becomes free and free becomes masked. mask_invert Clear Unmask everything. mask_clear All Mask every visible vertex. mask_all Passes sets how many times Grow, Shrink, Sharpen and Blur run (1 to 20). Mask by options holds the rest: Option For Cavity / peaks threshold How deep a crease (By cavity) or sharp a ridge (By peaks) must be (-0.2 to 0.5, default 0.02). 0 takes anything; higher keeps only the strongest. threshold= Face group The face group id By face group masks. group= Colour tolerance How different a colour may be and still count for By colour (0.01 to 1, default 0.15). tolerance= Faces the camera / up / down and Angle The direction By facing compares with, and how far the surface may turn from it (default 60 degrees). x= y= z= angle= Border rings How wide By border masks, in rings of edges (1 to 20, default 2). rings= Face Group borders By border also masks where face groups meet. facegroups=true Soft By border fades the mask from the border towards the innermost ring. soft=true 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-face-group","h":"Mask a whole face group","t":"The quickest way works without knowing the group's number: Ctrl+Shift + click the group to isolate it (see Face Groups and visibility). Click All: only visible vertices are masked. Ctrl+Shift + click the background to show everything again. The mask stays. By face group 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_face group group=N line. Enter that number in Mask by options > Face group and click By face group."},{"p":"masking.html","c":"Masking","a":"sculpt-without-breaking-the-border","h":"Sculpt without breaking the border","t":"A plane, a cloth panel or a part cut from a larger model has an open border that should stay where it is, for example to keep it lined up with the piece it joins: Set Rings to how wide the protected strip should be. Click By border. The open edges and the rings inside them are masked. Sculpt freely; the border doesn't move. Tick Soft first for a gradual transition into the sculpted area. Tick Face Group borders to also protect the seams between face groups. This is Blender's Mask from mesh boundary (and, with face sets, Mask from face set boundary)."},{"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-face-group","h":"Turn a mask into a face group","t":"Click From mask in Tool > Face Groups: the masked triangles become a new face group. See Face Groups and visibility."},{"p":"masking.html","c":"Masking","a":"masks-and-painting","h":"Masks and painting","t":"Vertex Paint 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 Vertex Paint 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_facegroup group (required), add=true to add to the current mask instead of replacing it mask_border rings (1-20, default 1), facegroups=true to also mask face group borders, soft=true to fade inwards, strength (0-1, default 1), add=true to add to the current mask 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":"Face Groups and visibility: groups, isolating and hiding parts Sculpting and brushes: modifier keys and brush settings Vertex Paint and materials: fills that respect the mask"},{"p":"face-groups.html","c":"Face Groups and visibility","a":"","h":"Face Groups and visibility","t":"Face Groups (experienced sculptors: Face groups) divide a Part's surface into named regions, shown as flat colours when you turn them on. You use them to hide and isolate parts of a model so you can reach what you want to sculpt, to build masks, and to split a model into Parts. This chapter covers creating face groups, the Ctrl+Shift visibility gestures and the Tool > Face Groups and Tool > Visibility controls. Face Groups shown as colours, with the Face Groups sub-palette"},{"p":"face-groups.html","c":"Face Groups and visibility","a":"show-face-groups","h":"Show face groups","t":"Click Groups in the right shelf to colour each face group of the active Part. The same toggle is Show face groups in Tool > Face Groups and Show Face Groups in the View menu. The grouping buttons turn the colours on for you, so you see the result straight away. The number next to Show face groups is how many face groups are visible right now. A mesh without face groups is one group. Face Groups come from: the grouping buttons below; OBJ files: each g group becomes a face group (SculptForge also writes face groups as g groups when it exports OBJ); Bridge files and SculptForge projects, which keep face groups."},{"p":"face-groups.html","c":"Face Groups and visibility","a":"create-face-groups","h":"Create face groups","t":"Open Tool > Face Groups. Grouping works on the visible part of the Part 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. facegroup_auto_by_normals By pieces One group per disconnected piece, such as separate eyes or buttons in one mesh. facegroup_by_connectivity From mask Masked triangles move into a new group. facegroup_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). facegroup_uv Merge visible Everything visible becomes one group. facegroup_merge_visible Clear groups Remove all face groups; the whole Part becomes one group again. facegroup_clear Each button is one undo step."},{"p":"face-groups.html","c":"Face Groups 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 > Face Groups. Ctrl + drag on the background to clear the mask."},{"p":"face-groups.html","c":"Face Groups and visibility","a":"hide-and-show-parts","h":"Hide and show parts","t":"Visibility is the main reason to have face groups: 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 face group, everything shown Isolate it: show only that group. Ctrl+Shift + click a face group, something hidden Hide that group. Ctrl+Shift + click the isolated group again Invert the visibility: show everything else instead. Ctrl+Shift+Alt + click a face group 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 Select Rectangle and Select Lasso at the top of Tool > Visibility (Select Rectangle by default), or, 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 Select Rectangle or Select Lasso. With Select Lasso, 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. With symmetry on (X, Y, Z on the top shelf), the mirror image of the shape counts as inside too, as with the mask selections: keeping the left eye keeps the right one, and hiding one ear hides both (hide_rect / hide_lasso symmetry=x). SculptForge refuses a change that would hide everything. Every visibility change is one undo step, so Ctrl+Z brings back what you just hid."},{"p":"face-groups.html","c":"Face Groups and visibility","a":"the-visibility-sub-palette","h":"The Visibility sub-palette","t":"Open Tool > Visibility: Control What it does Command Select Rectangle / Select Lasso 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 masked Remove the masked triangles (their corners' average mask above 50%). Undoable. Available when something is masked. delete_masked Delete hidden and Delete masked keep every attribute of what remains (mask, vertex paint, face groups, UVs and sculpt layers). Use it to cut away parts of a scan or a generated model, or to remove the inside of a mesh after you isolated the outside."},{"p":"face-groups.html","c":"Face Groups 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":"face-groups.html","c":"Face Groups 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 Select Lasso in Tool > Visibility first and draw around it. Click Delete hidden in Tool > Visibility."},{"p":"face-groups.html","c":"Face Groups and visibility","a":"split-a-model-into-parts","h":"Split a model into Parts","t":"Group the model, then click Split groups in Tool > Parts: each face group becomes its own Part. Split parts does the same by disconnected piece. See Parts."},{"p":"face-groups.html","c":"Face Groups and visibility","a":"face-groups-and-other-tools","h":"Face Groups and other tools","t":"Masking: By face group in Tool > Masking masks one group (see Masking). Brushes and vertex paint skip hidden faces. Projects save face groups and what's hidden; Bridge and OBJ carry face groups in and out. Each Part has its own face groups and visibility. To show and hide whole Parts, use the eye icons and Solo in Tool > Parts."},{"p":"face-groups.html","c":"Face Groups and visibility","a":"face-groups-from-a-script","h":"Face Groups from a script","t":"Command Options facegroup_auto_by_normals angle (1-180 degrees, default 30) facegroup_by_connectivity, facegroup_uv, facegroup_from_mask, facegroup_merge_visible, facegroup_clear isolate_facegroup, hide_facegroup group (required): the face group 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_facegroup group=3, which you can reuse in scripts. sculptforge-cli -c 'open path=robot.obj; face group_by_connectivity; part_split_groups; save_project path=robot.sfproj' Not yet: a face group paint brush, Group Front, face groups from UV islands or Vertex Paint, and face group-based crease edges are not available yet."},{"p":"face-groups.html","c":"Face Groups and visibility","a":"see-also","h":"See also","t":"Masking: build masks from face groups and face groups from masks Parts: split by groups, show, hide and solo whole Parts Keyboard and mouse reference"},{"p":"selection-sets.html","c":"Selection sets and morph targets","a":"","h":"Selection sets and morph targets","t":"A selection set is a named snapshot of a Part's mask, face groups, vertex paint, visibility (which faces are hidden), UVs and shape. Store as many as you like, bring any of them back later, combine them, and use a stored shape as the target of the Morph brush. Sets belong to the Part, travel with the project, and work across its subdivision levels: store at one level, restore at any other."},{"p":"selection-sets.html","c":"Selection sets and morph targets","a":"store-a-set","h":"Store a set","t":"Open Tool > Selection Sets. Type a name in the field next to Store (it suggests \"Set 1\", then \"Set 2\" and so on). Tick the channels the set should hold: Channel What it keeps Command name Mask The mask, soft edges included. mask Groups The face groups. facegroups Visibility Which faces are shown and which are hidden. visibility Vertex Paint The vertex colours. paint UVs The UV layout (only when the Part has UVs). uvs Shape The surface itself, as a morph target. morph Click Store. Storing again under the same name replaces that set. From Visible is the quick way: it stores the faces shown right now as a set called Visible (then Visible 2, ...). Isolate a part with the Ctrl+Shift gestures (Face Groups and visibility), click From Visible, and you can get back to exactly that view whenever you need it. There is no limit on the number of sets. They are kept compactly: masks, vertex paint and visibility store only the parts that differ from an empty mask, white paint and a fully shown Part, and face groups are run-length coded, so a mask on a few million vertices usually costs a few kilobytes. Shapes and UVs are stored as they are."},{"p":"selection-sets.html","c":"Selection sets and morph targets","a":"restore-rename-and-delete","h":"Restore, rename and delete","t":"Select a set in the list (hover it to see its channels and the level it was stored at), then: Restore puts its channels back. The shape is not restored here: Morph to Set does that, so you can keep a set with a shape in it and still restore just its mask. Double-clicking a set restores it too. Rename edits its name; Delete removes it. The menu next to From Visible sets how Restore meets what you have now, for the mask and visibility: Mode Mask Visibility Replace The set's mask. The set's shown faces. Union Masked in either. Shown in either. Intersect Masked in both. Shown in both. Subtract Masked now but not in the set. Shown now but not in the set. Every store, restore, rename, delete and combine is one undo step. A set greyed out in the list no longer fits the Part: its topology changed since (a remesh, Dynamic topology, Delete hidden). Undo the change, or delete the set."},{"p":"selection-sets.html","c":"Selection sets and morph targets","a":"combine-sets","h":"Combine sets","t":"Pick a second set in the menu under Restore, choose Union, Intersect or Subtract above, and click Combine: a new set (\"Head + Arms\", \"Head & Arms\" or \"Head - Arms\") holds the mask and visibility of the two combined that way. Your current mask and visibility are not touched until you restore it."},{"p":"selection-sets.html","c":"Selection sets and morph targets","a":"subdivision-levels","h":"Subdivision levels","t":"A set remembers the level it was stored at, and restores at any level of the same Part: going down, each vertex and face takes the value of the matching one on the level above, as the levels themselves do; going up, masks and vertex paint are interpolated, face groups and visibility are inherited from the face they lie in, and UVs are interpolated across each face; a shape travels as its difference from that level's own surface, so the detail of the levels in between stays where it is. So you can store a mask at SDiv 1, sculpt at SDiv 5 and restore the mask there, or keep a high-resolution face group set and use it at the base cage. Sets survive Divide, Delete Lower, Delete Higher and Reconstruct Subdiv as long as the level they were stored at still exists."},{"p":"selection-sets.html","c":"Selection sets and morph targets","a":"morph-targets","h":"Morph targets","t":"Store a set with Shape ticked to keep the surface as it is now. Then: Morph Target makes it the target of the Morph brush and picks that brush. Strokes pull the surface back toward the stored shape, as much as the brush's strength; Alt pushes away from it. The set's name shows [morph] in the list; Clear Morph Target turns it off. Morph to Set moves the whole surface toward the set's shape by Amount (1 = all the way, 0.5 = halfway, negative values push away), respecting the mask, as one undo step. Both work at any subdivision level, not only the one the shape was stored at, and with sculpt layers (the change goes into the active layer). Use them to undo a sculpting session locally, to blend between two versions of a form, or to keep a neutral pose while you sculpt an expression."},{"p":"selection-sets.html","c":"Selection sets and morph targets","a":"projects-files-and-other-apps","h":"Projects, files and other apps","t":"Sets are saved in the project with each Part (older versions of SculptForge open such projects and leave the sets out). To move them between Parts, scenes or tools, use the commands: selection_sets_export path=head.sfsets # every set of the active Part (name=... for one) selection_sets_import path=head.sfsets # into the active Part A .sfsets file is a ZIP with a JSON manifest and one small binary file per set. Importing a set that was stored on a different mesh keeps it, but it shows greyed out and can't be restored until the Part has a level it fits. USD (export_usd) writes the sets of each Part inside its Mesh prim: the shown faces of each set as a GeomSubset (sculptforge_set0_visible), its face groups as a partition of GeomSubsets (sculptforge_set0_group7), and its mask and vertex paint as vertex primvars (primvars:sculptforge_set0_mask, ..._color), with the names in sculptforge:selectionSets. Houdini, Maya, Blender and Omniverse read these as ordinary face sets and primvars, and SculptForge turns them back into selection sets when it imports the file. UVs and shapes are not written to USD. OBJ, glTF / GLB, FBX, PLY and STL have no place for named selections, so sets are not written to them (OBJ still writes the current face groups as g groups). Export the sets to a .sfsets file alongside the model instead."},{"p":"selection-sets.html","c":"Selection sets and morph targets","a":"scripting","h":"Scripting","t":"Every button is a command, so scripts, sculptforge-cli, the MCP server and the AI assistant can use sets: Command What it does selection_set_store name=Head channels=mask,visibility Store (or replace) a set. channels takes mask, facegroups, paint, visibility, uvs, morph or all. selection_set_restore name=Head mode=union Restore; channels= restores some of them (add morph to restore the shape). selection_set_rename name=Head to=Face Rename. selection_set_delete name=Head Delete. selection_set_list json=true List the sets with their channels and levels. selection_set_combine a=Head b=Ears op=union into=HeadEars Combine two sets into a new one. selection_set_from_visible The quick set from the visible faces. selection_set_morph_target name=Rest Make a set the Morph brush's target (empty name: none). selection_set_morph name=Rest amount=0.5 Morph to Set. selection_sets_export / selection_sets_import .sfsets files. In Python (import sculptforge as sf), push and pull sets as NumPy arrays: doc.set_selection_set(\"Eyes\", mask=eye_mask, hidden=hidden_faces) # store from arrays (one undo step) doc.selection_sets # [{'name': 'Eyes', 'channels': [...], ...}] arrays = doc.selection_set(\"Eyes\") # {'mask': ..., 'hidden': ...} at this level sf.run(doc, \"selection_set_restore\", name=\"Eyes\") See Scripting and automation for running commands."},{"p":"parts.html","c":"Parts","a":"","h":"Parts","t":"A scene in SculptForge can hold several separate meshes, called Parts (experienced sculptors: Parts): a body, eyes, teeth, a helmet and a sword can each live in their own Part. This chapter covers the Parts list, selecting, adding, hiding, reordering, merging and splitting Parts, and how they travel through files."},{"p":"parts.html","c":"Parts","a":"how-parts-work","h":"How Parts work","t":"Only the active Part 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 Part keeps its own mesh, mask, vertex paint, face groups, hidden faces, UVs and sculpt layers. Each Part has its own undo history. Ctrl+Z undoes the last change in the active Part, and switching Parts doesn't lose the history of the others. Adding, deleting, reordering, merging and splitting Parts are not undoable, except Split hidden, Split masked and Split unmasked (one undo step each). Merges and deletes ask for confirmation first. The Parts list highlights the active Part. In the Classic layout the title strip also shows it and its place in the list, for example Part Helmet (2/5)."},{"p":"parts.html","c":"Parts","a":"the-parts-list","h":"The Parts list","t":"The list is in Tool > Parts, which is open in the right tray by default. The Parts sub-palette with several Parts, the active one highlighted Each row shows a small picture of the Part, its name, its triangle count, its shading and an eye. The pictures are drawn from the model the viewport already has on the graphics card, so they cost almost nothing even on very dense Parts, and they catch up a moment after you stop changing a Part (not during a stroke). To Do this Select a Part Click its row, or Alt+click it in the viewport; triple-click another Part in the viewport to select it and frame it Sculpt the Part under the cursor Point at it and press Alt+Q (every input style, as in Blender): it becomes the active Part, the view stays put and each Part keeps its mask 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 Shade it smooth or flat Click the mark left of the eye: it goes from as the scene (dim) to Smooth (a disc) to Flat (a faceted hexagon) and back. Only this Part changes; the scene's own setting is Render > Materials > Shading Duplicate or delete it Right-click the row > Duplicate (Ctrl+Shift+D) or Delete... Make a copy that shares the mesh Right-click the row > Linked Duplicate, or the Linked Duplicate button; see Linked Duplicates 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 Part to a name that is already taken adds a number. Selecting a hidden Part shows it again, because you can't sculpt what you can't see."},{"p":"parts.html","c":"Parts","a":"select-a-part-in-the-viewport","h":"Select a Part in the viewport","t":"Hold Alt and click another Part on the canvas. It becomes the active one and the list scrolls to it. Alt+click only selects when you click a Part other than the active one and release without moving. If you drag instead, Alt keeps its usual meaning: an inverted stroke on the active Part, or a pan when you start off the model."},{"p":"parts.html","c":"Parts","a":"add-a-part","h":"Add a Part","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 Part. Insert on the model: choose a shape, then drag on the active Part's surface to add it there as a new face group (the drag sets its size and turns it). With Symmetry X, Y or Z on, a mirrored copy goes on the other side too, in the same undo step; a shape inserted right on a mirror plane isn't doubled. To insert your own mesh, choose Active Part's copy... and pick another Part (it stays as it is), or From file... and pick an .obj, .ply or .glb file; then drag as with the shapes. The mesh is centred, scaled so its largest side matches the drag, and stood on the surface along its own up (+Y) axis. Esc stops inserting. (Command: insert_mesh part= or insert_mesh file=.) To insert from a kitbash set, choose Insert set from file... (one .obj or .glb with several objects) or Insert set from folder... (its .obj, .ply and .glb files, by name; not its subfolders). The Insert set window shows a thumbnail of each item: click one, then drag on the model as above. While inserting, ] steps to the next item and [ to the previous one (around the set; brush size keys come back once you stop). Esc or the window's close button stops. (Commands: insert_set_items set= lists them; insert_mesh set= index= inserts item n, 0 being the first.) Creature bones, at the end of the same menu, is a set that comes with SculptForge: no file to pick (see below). From file...: a model (.obj, .fbx, .glb, .gltf, .ply, .stl, Bridge files, .usda, .usd, .usdz) or a project (.sfproj). A file with several objects adds one Part per object. The new Part becomes the active one."},{"p":"parts.html","c":"Parts","a":"creature-bones","h":"Creature bones","t":"Append > Insert on the model > Creature bones opens a built-in insert set of original fantasy creature bones to start from: Skull, Jaw, Fang, Blade tooth, Swept horn, Spiral horn, Claw, Vertebra, Tail vertebrae, Rib, Limb bone, Wing bone and Wing finger. Click one in the Insert set window and drag on the model, as with any set; horns, claws and teeth grow from where you drag. With Symmetry X on, a horn or a claw gets its mirrored twin. Each piece is a clean, closed quad mesh of 500 to 4,200 faces, so it takes Divide and sculpting well: insert, then sculpt the joins smooth, or Voxel Remesh to fuse the piece into the model. Drag pieces onto an empty Plane or Sphere Part to build a skeleton of their own Part. The pieces were designed for SculptForge (tools/creature-bones in the source) and come under the app's licence, GPL-3.0. (Commands: insert_set_items set=builtin:creature-bones; insert_mesh set=builtin:creature-bones index=.) You can also add files as Parts from elsewhere: Import in the Tool palette header (or File > Import) adds a model file as a new Part. In the Library Tool tab, Shift+double-click a model, or right-click it and choose Append as Part. Tip: Duplicate (Ctrl+Shift+D, also in the command palette as Duplicate Part) copies the active Part 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. Linked Duplicate instead makes a copy that shares the mesh and changes with it (rivets, legs, columns); see Linked Duplicates."},{"p":"parts.html","c":"Parts","a":"show-hide-and-solo","h":"Show, hide and solo","t":"The eye on each row shows or hides that Part. Solo shows only the active Part. Click it again to bring the others back. The Solo button on the right shelf does the same. X-Ray, next to Solo, shows the active Part through the others: the other Parts turn see-through and only their nearest surface shows. When only the active Part is shown, it is see-through itself. Click X-Ray again to make them solid. View > X-Ray does the same. Unhide all shows every Part. Hidden Parts aren't drawn, can't be selected with Alt+click, and are left out of exports. Note: Part visibility is different from hiding part of a mesh with face groups or a rectangle. That hides faces inside one Part; see Face Groups and visibility."},{"p":"parts.html","c":"Parts","a":"folders","h":"Folders","t":"Folders group Parts in the list, for example the eyes and teeth of a head, so you can hide, show and move them together. To Do this Make a folder Click the folder button under the list: a new folder holds the active Part; type its name and press Enter Put a Part in a folder Drag its row onto the folder's header (or onto a Part already in it), or right-click the row > Folder > the folder's name Take a Part out Drag it onto a Part outside folders, or right-click it > Folder > Out of the folder Fold or open a folder Click its header Rename it Double-click the header (or right-click > Rename) Hide or show all its Parts Click the eye on the header Move, turn or scale it Right-click the header > Move with the gizmo Remove it Right-click the header > Remove folder (keep its Parts) A Part that joins a folder moves to just below the folder's last Part, so a folder's Parts stay together. When the folder holding the active Part is folded, its header shows the accent bar. Move with the gizmo makes one of the folder's Parts active and turns on the gizmo's Folder option, so every visible Part in the folder moves together; see All Parts and Folder. Duplicates and the pieces of a split stay in their Part's folder. Folders are saved in the project; older versions of SculptForge open the file and simply show no folders."},{"p":"parts.html","c":"Parts","a":"reorder-parts","h":"Reorder Parts","t":"The up and down arrow buttons under the list move the active Part one place up or down. The order matters for Merge down and is the order objects are written to files."},{"p":"parts.html","c":"Parts","a":"merge-parts","h":"Merge Parts","t":"Merge down... merges the active Part with the one below it. Merge visible... merges every visible Part into one new Part called Merged. Hidden Parts stay as they are. Merging keeps every attribute, gives each original mesh its own face groups (so you can split them again later) and matches sculpt layers by name. The merged Part starts with an empty undo history. A Part 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 Parts that lost their levels. Painted textures are kept too: the merged Part 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":"parts.html","c":"Parts","a":"split-a-part","h":"Split a Part","t":"Split groups makes one Part per face group. It is available when the active Part has more than one face group. Split parts makes one Part per disconnected piece, largest first. Both replace the active Part with the pieces. Because a merge keeps each original mesh in its own face group, Split groups undoes a merge."},{"p":"parts.html","c":"Parts","a":"split-hidden-masked-or-unmasked","h":"Split hidden, masked or unmasked","t":"The Split row (Hidden, Masked, Unmasked) takes part of the active Part out into a new Part just below it, in the same folder, shown as the source is and shaded the same way. Each is one undo step: Ctrl+Z puts the triangles back and removes the new Part. Button Moves into the new Part Command Split > Hidden the hidden triangles; they are shown in the new Part part_split_hidden Split > Masked the masked triangles; the new Part starts unmasked part_split_masked Split > Unmasked the triangles that are not masked; the masked ones stay part_split_unmasked A triangle counts as masked when the average mask of its three corners is above 50%, so a soft mask edge splits along its middle and a single masked corner doesn't take its neighbours. UVs, face groups, vertex paint and sculpt layers carry over to both sides. Subdivision levels can't be cut: the split is made at the level the Part is on, which becomes its base (undo brings the levels back). To delete instead of split, use Delete hidden or Delete masked in Tool > Visibility."},{"p":"parts.html","c":"Parts","a":"extract-a-shell","h":"Extract a shell","t":"Extract, in Tool > Parts, makes a new Part from the masked part of the active one: a helmet from the top of a head, a strap, a sleeve, a piece of armour that fits the surface exactly. It works: Mask the part (hold Ctrl and paint, or use Rectangle Mask / Lasso Mask; see Masking). Click Extract. The shell appears as a preview, a Part just below the active one. Change Thick, E Smt, Double, TCorne or TBorder and the preview follows. Click Accept to keep it. Setting What it does Thick The shell's thickness as a share of the Part's size: 0.015 (the default) is 1.5%. Negative grows it inward; 0 makes a single-sided surface E Smt Smooths the extracted edge, which otherwise follows the mask's triangles in steps. 0 keeps it as masked Double Grows the shell both inward and outward from the surface TCorne Triangles instead of quads in the rim where the edge turns sharply (over 50 degrees), so tight corners don't get twisted quads TBorder The whole rim is triangles instead of quads A cap extracted from the masked top of a sphere, shown with its face groups: outer, inner and rim The new Part has three face groups, the outer surface, the inner one and the rim between them (a band of quads), so you can mask, hide or split them apart. Vertex Paint comes with it; hidden faces are left out. Accept is one undo step: Ctrl+Z on the source Part takes the extracted one away again, and redo brings it back. A preview you don't accept goes away as soon as you change the source Part or pick another one, and it is never saved."},{"p":"parts.html","c":"Parts","a":"delete-a-part","h":"Delete a Part","t":"Click Delete... (or right-click a row > Delete...) and confirm. The last Part can't be deleted, and a delete can't be undone."},{"p":"parts.html","c":"Parts","a":"parts-in-files","h":"Parts in files","t":"Format What happens to Parts Project (.sfproj) Every Part is saved with its name, visibility, folder, attributes, layers and active layer; linked copies keep their link OBJ Each visible Part is an o object; on import, o objects become Parts and g groups become face groups glTF / GLB One node and mesh per visible Part, both ways FBX One model per visible Part (with LODs, an LOD group each), both ways USD One Mesh prim per visible Part, both ways Bridge Each visible Part is sent as its own object PLY, STL, splat conversion The visible Parts are merged into one mesh Opening a multi-object file replaces the scene with one Part per object. See Exporting for the details of each format."},{"p":"parts.html","c":"Parts","a":"scripting","h":"Scripting","t":"Every Part action is a command, so you can use them in the console, scripts, Python and MCP agents. Parts are addressed by index (0 is the top of the list) or name; without either, the active one is used. Command What it does part_list List the Parts part_select index=1 Make a Part active part_append type=cube Add a primitive (sphere, cube, plane); path= adds a file; size= (0.05-2, default 0.35) part_duplicate Copy a Part part_duplicate_linked / part_make_unique A linked copy sharing the mesh / break the link part_delete name=Helmet Delete a Part part_rename to=Body Rename a Part part_visibility visible=false Show or hide (toggles when visible is left out) part_solo / part_show_all Solo the active Part / show every Part part_move direction=up Move a Part up or down the list part_folder_new folder=Eyes Make a folder holding a Part (empty=true: an empty one) part_set_folder name=EyeL folder=Eyes Put a Part into a folder (folder= empty: out of its folder) part_folder_visibility folder=Eyes Hide or show a folder's Parts (toggles when visible is left out) part_folder_collapse / part_folder_rename / part_folder_delete Fold or open, rename, remove a folder (folder=) transform translate=0,0.1,0 folder=true Transform the visible Parts in the active Part's folder part_merge_down / part_merge_visible Merge part_split_groups / part_split_parts Split part_split_hidden / part_split_masked / part_split_unmasked Split off into a new Part (undoable) part_shading mode=flat Shade a Part default (as the scene), smooth or flat extract thickness=0.02 smooth=5 double=false Preview an Extract shell from the mask; tcorne / tborder for a triangle rim; accept=true keeps it at once extract_accept / extract_cancel Keep or remove the Extract preview part_append type=sphere name=EyeL size=0.12; part_duplicate; part_rename to=EyeR"},{"p":"parts.html","c":"Parts","a":"see-also","h":"See also","t":"Linked Duplicates: copies that share one mesh Face Groups and visibility: hide parts of one Part Sculpt layers and blend shapes: layers belong to each Part Exporting: how Parts reach other applications Projects, autosave and snapshots"},{"p":"linked-duplicates.html","c":"Linked Duplicates","a":"","h":"Linked Duplicates","t":"A Linked Duplicate is a Part that shares its mesh with another Part but sits in its own place: rivets on a belt, the four legs of a table, the teeth of a gear, a row of columns. Sculpt, paint or mask any one of them and every linked copy changes with it; move, turn or scale each one on its own. A hundred linked copies cost about as much memory as one mesh, on the graphics card too. Three linked copies of one sphere, the last one scaled up: a stroke on it shows on all three; the Parts list shows a link and the count on each row"},{"p":"linked-duplicates.html","c":"Linked Duplicates","a":"make-a-linked-copy","h":"Make a linked copy","t":"Select the Part in Tool > Parts. Click Linked Duplicate (or right-click its row > Linked Duplicate). The copy is named link, goes right under the original in the list and appears beside it on +X. It becomes the active Part. Each linked Part shows a link and the number of Parts sharing the mesh at the end of its row; point at the row to see the count in the tooltip too. Making a linked copy is undoable: Ctrl+Z takes it away again."},{"p":"linked-duplicates.html","c":"Linked Duplicates","a":"sculpt-any-of-them","h":"Sculpt any of them","t":"Brushes, masking, Vertex Paint, texture painting, face groups and whole-mesh tools (remesh, subdivide, decimate, layers) work on the shared mesh: every linked copy shows the change at once. Strokes land where you see them on whichever copy is active, even when it is turned or scaled. Symmetry mirrors across the copy's own axes, so a turned copy still sculpts symmetrically. Linked copies share one undo history: undo on any of them steps back the shared mesh. The copies that aren't active are drawn slightly darker, like other Parts. The mask shows on the active one."},{"p":"linked-duplicates.html","c":"Linked Duplicates","a":"move-turn-and-scale-a-copy","h":"Move, turn and scale a copy","t":"Use the Gizmo on the active linked Part: it moves, turns or scales that copy as a whole and leaves the others where they are. Each move is one undo step. Scaling a linked copy is always even (the same along every axis), so it stays a copy of the same shape; uneven scaling takes the mean. With a mask (and the Gizmo's Mask option on), the Gizmo poses the shared mesh instead: the unmasked part moves, in every copy, along the active copy's own axes. transform does the same from the console: transform translate=0,1,0 rotate=0,90,0."},{"p":"linked-duplicates.html","c":"Linked Duplicates","a":"make-unique","h":"Make Unique","t":"Make Unique (in Tool > Parts, or right-click the row) gives the active linked Part its own copy of the mesh. It stays where it is and no longer changes with the others. Its undo history starts fresh. Deleting a linked Part never touches the others: the mesh stays as long as one Part uses it."},{"p":"linked-duplicates.html","c":"Linked Duplicates","a":"linked-copies-in-files","h":"Linked copies in files","t":"Format What happens Project (.sfproj) The links and each copy's place are kept; the mesh is saved once glTF / GLB One mesh, one node per copy with its own matrix USD (.usda, .usdz) The first copy holds the mesh; each other copy is an instanceable prim that references it, with its own transform OBJ, STL, PLY, FBX, Bridge Every copy is written as its own mesh, where it is Merge down and Merge visible put every Part where it is in the scene, so merged linked copies end up as separate pieces of one mesh. Projects with linked copies need SculptForge 0.12 or later to open."},{"p":"linked-duplicates.html","c":"Linked Duplicates","a":"scripting","h":"Scripting","t":"Command What it does part_duplicate_linked A linked copy of the active Part (or index= / name=); offset=x,y,z places it (default: beside it on +X) part_make_unique Give a linked Part its own mesh part_list Linked Parts show linked xN part_duplicate_linked offset=0,0,2; part_duplicate_linked offset=0,0,2; part_duplicate_linked offset=0,0,2"},{"p":"linked-duplicates.html","c":"Linked Duplicates","a":"see-also","h":"See also","t":"Parts: the Parts list, merging and splitting Moving, rotating and posing (Gizmo) Exporting"},{"p":"forge-spheres.html","c":"Forge Spheres","a":"","h":"Forge Spheres","t":"Forge Spheres (experienced sculptors: Forge Spheres) block out an organic base mesh from connected spheres: start from one root sphere, grow a torso, a head, limbs, fingers, a tail or branches from it, set the proportions, look at the skin over them, then turn it into a mesh you sculpt as usual. It is the quickest way to get the structure of a character or creature before any detail."},{"p":"forge-spheres.html","c":"Forge Spheres","a":"make-a-forge-sphere-part","h":"Make a Forge Sphere Part","t":"Tool > Forge Spheres > New Forge Sphere adds a Forge Sphere Part holding one root sphere at the centre and makes it active. It sits in the Parts list like any other Part, so you can block out a creature next to a model you already have. While a Forge Sphere Part is active, dragging on it edits the spheres instead of sculpting. Dragging the background still navigates. The brush ring is hidden; the sphere under the cursor gets an outline instead."},{"p":"forge-spheres.html","c":"Forge Spheres","a":"edit-the-spheres","h":"Edit the spheres","t":"Pick the mode in Tool > Forge Spheres: Mode On a sphere On a link Draw Drag to grow a new sphere from it. It starts on the surface where you pressed; how far you drag sets its size (a click makes one half the size of its parent) Click to add a joint halfway along the link, and drag to place it Move Drag to move it across the screen. The links stretch to follow Moves the sphere at the end of the link Scale Drag up or right to make it bigger, down or left to make it smaller Scales the sphere at the end of the link In every mode, Alt+click a sphere to delete it together with everything that grows from it. The root sphere (orange) always stays. Symmetry (X) mirrors every edit: grow an arm on the right and the left one grows with it, move a leg and its twin moves too. A sphere on the centre line stays on it, and a new sphere placed closer to the centre line than its own radius snaps onto it as one sphere instead of two overlapping twins. Every drag is one step of the Part's undo history, so Ctrl+Z takes back the last sphere you added, moved or scaled. Tip: build the structure first with few spheres (one per joint), set the proportions with Move and Scale, and add joints on links only where a limb needs to bend or swell."},{"p":"forge-spheres.html","c":"Forge Spheres","a":"pointer-only","h":"Pointer only","t":"Everything also works with the pointer alone, without a key held (#8): Drag places child: with it on, a Draw drag on a sphere makes a new sphere half its size and moves it away from its parent as you drag, so one drag places the next joint of a limb. With it off, hold Ctrl while you drag for the same. The selected sphere: the sphere you last clicked or added is outlined in orange. Delete Selected deletes it and everything growing from it, Insert Between adds a joint halfway to the sphere it grows from, and Set as Root makes it the root: the armature keeps its shape and links and grows from there, so the skin doesn't change. Right click a sphere (a click, not a drag: a right drag still turns the view) for a menu with Delete Sphere, Insert Between and Set as Root. Each is one undo step, and Symmetry mirrors Delete and Insert. From a script: forgesphere_set_root index=3."},{"p":"forge-spheres.html","c":"Forge Spheres","a":"preview-the-skin","h":"Preview the skin","t":"Preview (A) shows the skin over the spheres instead of the spheres themselves, so you can judge the volumes. The skin is a smooth union of the spheres and the cones between them, with the joints filled out a little. Turn Preview off to edit the spheres again; while it is on, clicks on the model do nothing."},{"p":"forge-spheres.html","c":"Forge Spheres","a":"make-mesh","h":"Make Mesh","t":"Make Mesh builds the skin as a new Part right below the Forge Sphere Part and makes it active: It is watertight and made of quads, ready for the brushes, Dynamic topology, Divide or Quad Remesh. Each link gets its own face group, so you can isolate or mask a limb straight away. Resolution sets how dense it is: cells across the model's longest side. 128 suits a blockout; raise it for thin fingers or tails that come out too thin or broken. The Forge Sphere Part is hidden and kept. To change the proportions later, show and select it, edit the spheres and Make Mesh again. The armature is saved with the project. Tip: for clean edge flow, run Quad Remesh on the new mesh, then Divide and sculpt."},{"p":"forge-spheres.html","c":"Forge Spheres","a":"scripting","h":"Scripting","t":"The same operations are commands (see Scripting): forgesphere_new, forgesphere_list, forgesphere_add, forgesphere_set, forgesphere_delete, forgesphere_insert, forgesphere_preview and forgesphere_make_mesh. For example, a simple figure: forgesphere_new radius=0.5 forgesphere_add parent=0 position=0,0.8,0 radius=0.3 forgesphere_add parent=0 position=0.9,0.1,0 radius=0.2 symmetry=x forgesphere_make_mesh resolution=160"},{"p":"tube.html","c":"Tube: draw in 3D space","a":"","h":"Tube: draw in 3D space","t":"Tube draws clay tubes freely in the air, like a 3D pen: horns, vines, hair strands, tentacles, cables, piping or the wire of an armature, drawn where you want them instead of pulled out of a surface. Each stroke becomes a smooth curve with a tube swept along it, and its points stay editable until you bake it into a mesh to sculpt. Drawing a tube from the model out into the air, the Tube Part it makes, a point dragged up, and a strap merged into the model"},{"p":"tube.html","c":"Tube: draw in 3D space","a":"draw-a-tube","h":"Draw a tube","t":"Open Tool > Tube and press Draw Tube. Drag anywhere in the view: on the model, off it, or from one into the other. A trail shows the tube as you draw; let go and it is made. Ctrl+Z takes the tube away again. While Draw Tube is on, Alt+drag still moves the view (and so do the right and middle buttons), so you can draw, turn the model, and draw again from another side. The brush ring is replaced by a circle as thick as the tube will be. Tool > Tube with a Tube Part selected Setting What it does Size How thick new tubes are: their radius on screen at the depth you draw at Pressure How much a light touch of the pen thins the tube (0: the same thickness all along). A mouse draws at full size Smoothing How much of the stroke's wobble is smoothed out before the tube is made Depth Where in depth the stroke lies (below) Snap to surfaces Where the pen is over a surface, the tube lies on it, half sunk in, instead of on the drawing plane Ends Rounded or Flat Result New Part: each stroke is a Tube Part you can edit. Merge: the stroke goes into the active Part Symmetry (X) draws the mirror copy across the X plane too, and keeps it as you edit the tube."},{"p":"tube.html","c":"Tube: draw in 3D space","a":"depth-where-the-stroke-lies","h":"Depth: where the stroke lies","t":"A stroke on a flat screen needs a depth. The tube's points lie on a plane facing you: Surface (the default): through the surface under the pen where the stroke starts. A stroke that starts off the model uses the depth where your last stroke ended, or the pivot. So a stroke started on a head and pulled out sideways grows from that spot into the air. Pivot: through the view's pivot, the point the camera turns around. Fixed: at a set Distance from the camera. Orbit and draw again to build up a shape in 3D. Turn Snap to surfaces on to draw along a model: a strap round an arm, a seam, a vein."},{"p":"tube.html","c":"Tube: draw in 3D space","a":"edit-the-points","h":"Edit the points","t":"A Tube Part's control points show as dots joined by a thin line (with Draw Tube on, the dots of every visible Tube Part show, and pressing one selects that Part): Drag a dot to move it across the screen; the tube follows as you drag. Ctrl+drag a dot up or right to make the tube thicker there, down or left to make it thinner. Alt+click a dot to delete it. The dot you last dragged is selected (orange): Radius sets its thickness exactly, Insert Point adds a point halfway to the next one, Delete Point removes it. Rounded and Flat change the ends of the selected tube. Each drag and button is one undo step. A Tube Part isn't sculpted while its points are editable: brushes leave it alone until you bake it. If you move, mirror or otherwise change the Part's mesh, its points no longer fit it and editing them is refused (undo the change, or bake it as it is)."},{"p":"tube.html","c":"Tube: draw in 3D space","a":"bake-and-merge","h":"Bake and Merge","t":"Bake turns the active Tube Part into a plain mesh to sculpt, in quads, with one face group for the body and one for each end. Tick Even edges first to bake it in triangles of one size instead, ready for dynamic topology. Undo brings the points back. Result > Merge skips the Tube Part: each stroke goes straight into the active Part as one undo step, with even edges close to that Part's own edge length, so dynamic topology carries on smoothly across it. A Part with subdivision levels or a micro level can't take a merged tube; draw a new Part and merge it with the Parts list. Tip: for clay-like strands, draw with Merge into a Part with dynamic topology on, then smooth and blend the joins with the brushes."},{"p":"tube.html","c":"Tube: draw in 3D space","a":"from-a-script","h":"From a script","t":"The tube_* commands do the same from the Console, scripts and AI assistants: tube_new points=\"0,0,0 0.5,0.4,0,0.08 1,0.2,0.3\" radius=0.05 caps=round symmetry=x tube_list tube_set_point index=1 position=\"0.5,0.6,0\" radius=0.1 tube_insert_point index=0 tube_delete_point index=2 tube_set caps=flat radius_scale=1.5 tube_bake uniform=true Each point is x,y,z or x,y,z,radius. With smooth=0.5 the points are treated as raw pen samples: smoothed and simplified into control points, as a drawn stroke is. merge=true puts the tube into the active Part."},{"p":"vertex-paint.html","c":"Vertex Paint and materials","a":"","h":"Vertex Paint and materials","t":"Vertex Paint (experienced sculptors: Vertex Paint) stores a colour on every vertex of the mesh, so you can paint a sculpt without UVs or textures. This chapter covers the Paint brush, painting while you sculpt, fills and cavity paint, picking colours, paint layers with blend modes, and the Lit Sphere materials that change how the model is shaded in the viewport."},{"p":"vertex-paint.html","c":"Vertex Paint and materials","a":"how-vertex-paint-works","h":"How vertex paint 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. Vertex Paint is per Part and is saved in projects. It is exported as vertex colours to PLY, glTF/GLB, OBJ, USD (displayColor) and Bridge files. FBX export doesn't include it. A mesh starts without vertex paint. The first paint stroke or fill adds it (white everywhere you haven't painted). Texture painting: to paint finer than the mesh, give the Part a texture and paint into it instead; the Paint brush, fills and paint layers work the same way. Vertex Paint > Texture bakes vertex paint into a texture. See Texture painting."},{"p":"vertex-paint.html","c":"Vertex Paint 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. Size, the stroke type and the alpha work as they do for sculpting; Colour 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. The surface isn't changed. Press P again, or click Sculpt on the top shelf, to go back to sculpting. Vertex Paint on a sculpt with the Paint menu open"},{"p":"vertex-paint.html","c":"Vertex Paint and materials","a":"paint-while-sculpting","h":"Paint while sculpting","t":"Turn on Rgb on the top shelf (or RGB while sculpting in the Paint menu). Every sculpt brush then also paints the current colour along its stroke. The Smooth brush and Shift-smoothing never paint."},{"p":"vertex-paint.html","c":"Vertex Paint 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. Under the two swatches, the recent colours are the last eight you painted with or filled with, newest first. Click one to paint with it again. They are kept when you restart. The Paint menu has a larger hue wheel with a hex value, ten preset swatches (white, near black, red, orange, yellow, green, blue, purple, skin and brown) and the fill buttons. Press C with the cursor over the model to pick the colour under it (the mesh needs vertex paint for this, or a texture while painting into the texture)."},{"p":"vertex-paint.html","c":"Vertex Paint and materials","a":"fill-cavity-paint-and-clear","h":"Fill, cavity paint and clear","t":"The Paint menu 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 vertex paint from the active Part All of them are undoable. Show vertex paint 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":"vertex-paint.html","c":"Vertex Paint and materials","a":"line-gradient","h":"Line Gradient","t":"Line Gradient (under Clear) paints a straight colour ramp across the model as you see it: turn it on, then drag a line over the view. The paint colour at the start of the line runs into the End colour at its end; past the ends the two colours carry on. Tick Clear to fade the paint colour out instead, so the paint underneath shows through towards the end. The swap button swaps the two colours. The line stays on screen with a handle at each end until you keep it: drag a handle, or change a colour, and the gradient is painted again in place of the last one. Enter keeps it (so does turning the view or any other edit), Esc takes it back. Each gradient is one undo step. It respects the mask like Fill, never paints hidden faces, and goes into the texture when the Part paints into one. With it on, Ctrl still masks and Shift still smooths; turn it off with its button or Esc."},{"p":"vertex-paint.html","c":"Vertex Paint and materials","a":"paint-through-a-stencil","h":"Paint through a Stencil","t":"A Stencil (Sculpt > Alpha > Stencil) paints too: load a photo or a pattern, place it over the model, and paint over it with the Paint brush. Where it covers the model the brush lays the image's colours (with your Colour intensity, falloff and mask); everywhere else it paints nothing. Turn off Paint its colours to paint the paint colour through the image's brightness instead (a grayscale pattern as a mask). Turn the model or move the stencil and paint again to cover a whole model."},{"p":"vertex-paint.html","c":"Vertex Paint and materials","a":"paint-layers","h":"Paint layers","t":"Paint layers stack vertex paint 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 Part has its own stack. Tool > Paint Layers: Base, a Multiply dirt layer, a Soft Light tint and an empty Normal layer"},{"p":"vertex-paint.html","c":"Vertex Paint and materials","a":"how-paint-layers-work","h":"How paint layers work","t":"Base is the bottom layer: the Part's vertex paint, always opaque. With only Base, vertex paint works exactly as it did before, and nothing changes in your files. 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 Paint menu 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":"vertex-paint.html","c":"Vertex Paint 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":"vertex-paint.html","c":"Vertex Paint 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 Paint menu. 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":"vertex-paint.html","c":"Vertex Paint 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":"vertex-paint.html","c":"Vertex Paint and materials","a":"files-parts-and-geometry","h":"Files, Parts 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, Bridge) write the composited colours, exactly what the viewport shows. Duplicating a Part copies its layers, and Split keeps them on each piece. Subdividing and decimating keep them too. Merging Parts, a voxel remesh and other rebuilds keep the look but flatten the layers into Base."},{"p":"vertex-paint.html","c":"Vertex Paint and materials","a":"materials-lit-spheres","h":"Materials (Lit Spheres)","t":"The materials are material capture (lit sphere) images: each one is a picture of a lit sphere that shades the whole model. They change only how the model is shaded in the viewport. They aren't exported and don't change vertex paint. Material Look Soft Clay The default: a matte warm light grey with a clear light and shadow side and a soft rim Sculpt 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 Render > Materials 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 Render > Materials, or the Material tab of the Library. The material picker with the built-in Lit Spheres and Studio Vertex Paint multiplies the material, and cavity shading stays on with every material (strongest with Sculpt). The material is saved with the project: projects saved with Studio open with Studio. Colour tints the material (in the Paint menu, on by default): on a Part with no vertex paint yet, the current colour tints its Lit Sphere material, so you can try a skin, stone or bronze tone without painting anything. The colour's hue and saturation tint it; grey (the starting colour) and black leave the material as it is, and the material keeps its own light and shade. Once a Part has vertex paint, the paint shows instead. PBR shading uses the material channels and is not tinted. Saved with the project. Tip: Sculpt is the material to judge strokes with. The prettier ones (Skin, Red Wax) soften small detail; switch to them for presenting."},{"p":"vertex-paint.html","c":"Vertex Paint and materials","a":"your-own-lit-spheres","h":"Your own Lit Spheres","t":"Your own Lit Spheres are material capture (lit sphere) images too (Sloan and others, 2001): the view colours each point of the model with the sphere's colour where its surface faces the same way. Any lit-sphere image works: a square PNG, JPG or EXR with the sphere filling it (a non-square image is cropped to its centre; big ones are scaled to 1024 pixels). Render > Materials > Load Lit Sphere... picks an image. It joins the material list under its file name, the view uses it, and a copy goes into the Lit Spheres folder of your library (Documents/SculptForge/Lit Spheres, or the folder set in Edit > Preferences > Library), so it is there next time. Or put images into that Lit Spheres folder yourself: they show up the next time you open the material picker, Render > Materials or the Library's Material tab, no restart needed. Studios can share a read-only folder by listing it in the SCULPTFORGE_LITSPHERE_PATH environment variable (separated by :, ; on Windows); those load when SculptForge starts. Drop an image onto the Library's Material tab to load it the same way (dropped on the canvas, an image keeps its usual meaning). Rename one: right-click it in the material picker, Render > Materials or the Library's Material tab and choose Rename..., type the name and press Enter. Its file in the Lit Spheres folder is renamed too. A name another Lit Sphere already has is refused, so nothing is overwritten. Projects that use it keep their look: they find it by its pixels, not its name. Organise them in folders: each sub-folder of the Lit Spheres folder (one level) is a heading in the lists. Right-click a Lit Sphere and choose Move to folder for an existing folder, New folder... to make one, or Lit Spheres (no folder) to take it out again. You can also make the folders in your file manager. Lit Spheres from a pack, from a studio folder or carried only by the open project have no file of yours to change: Rename and Move to folder are greyed out, and pointing at them says why. To remove one, right-click it and choose Remove. An image from your Lit Spheres folder goes to the trash (the Recycle Bin on Windows), so you can still get it back. On macOS it is only hidden until you restart, and the message says where its file is so you can delete it yourself. Built-in materials can't be removed. A Lit Sphere loaded from an image (Gold) in Render > Materials Right-click a Lit Sphere for Rename... and Move to folder; the Metals folder is a heading in the list Your Lit Spheres appear in the material picker (M), Render > Materials and the Library, after the built-in ones, those in folders under their folder's name. A project that uses one carries a copy of the image, so it opens with the same look on another computer (or after you delete the file). Loading an image with the same name again replaces it. EXR images are read as linear light, so very bright highlights clip to white."},{"p":"vertex-paint.html","c":"Vertex Paint and materials","a":"smooth-and-flat-shading","h":"Smooth and flat shading","t":"Smooth shading (the default) blends the light across polygons, so the surface reads as one form. Flat shading lights every polygon on its own, so you see the faces: how the mesh is built, where its vertices sit, and exactly what a stroke, crease or pinch did to the geometry, without smooth blending hiding small lumps. It helps most when blocking out forms on a low-poly base mesh. Render > Materials > Shading: Smooth | Flat for the whole scene. The same buttons are in Tool > Display. This Part: Scene (the default) follows the scene's shading; Smooth or Flat keeps the active Part that way whatever the scene says, for example a flat body with smooth eyes. Smooth and Flat shading on the template head, with its eyes kept smooth Shading works with every material, vertex paint, textures and the mask. Like the material, it only changes the view: exports are unaffected. Projects save the scene's shading and each Part's own; projects from before open with your preferred shading. The scene's shading you choose is also the preference for the next session (it saves itself). Smooth and Flat have no default shortcut, so no classic key changes meaning; assign one under Edit > Preferences > Hotkeys if you switch often."},{"p":"vertex-paint.html","c":"Vertex Paint 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_gradient x0=-1 y0=0 x1=1 y1=0 to=clear Line Gradient from the paint colour (or color) at the start to to (a colour, or clear) at the end; the line in -1..1 view coordinates (view_proj, default the front view); area as paint_fill paint_from_cavity color=#202020 strength=0.7 smoothing=2 Cavity paint (defaults: dark brown, 0.7, 2 blur passes) paint_clear Remove all vertex paint, 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 Lit Sphere name (Soft Clay is the default, your own Lit Spheres included) or studio (desktop app only) load_litsphere path=gold.png Load a Lit Sphere image and use it; keep=false doesn't copy it into the Lit Spheres folder (desktop app only) rename_litsphere name=Gold to=\"Old Gold\" Rename one of your Lit Spheres and its image in the Lit Spheres folder; a name in use is refused (desktop app only) move_litsphere name=Gold folder=Metals Move one of your Lit Spheres into a sub-folder of the Lit Spheres folder (made if needed; folder=\"\" moves it back) (desktop app only) remove_litsphere name=Gold Remove one of your Lit Spheres; its image in the Lit Spheres folder goes to the trash (desktop app only) set_background mode=flat color=60,70,80 The view's background: gradient (the default) or flat with a colour (#rrggbb, r,g,b or a name); see The background (desktop app only) set_shading mode=flat The scene's shading: smooth (the default) or flat (desktop app only) part_shading mode=smooth name=Eyes A Part's own shading: default (follow the scene), smooth or flat; index or name picks the Part (default: the active one) 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":"vertex-paint.html","c":"Vertex Paint 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: Size, Falloff, 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 vertex paint could only show on millions of polygons. Everything you know from vertex paint 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 vertex paint stroke, with the UV view in Tool > Texture Map The texture can also carry roughness, metallic, normal, height, AO, emission and opacity, painted in the same strokes: see Material painting (PBR)."},{"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 Part has no texture, New Texture appears on the top shelf and in the Paint menu. 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 Part 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 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. Size, Colour intensity, pen pressure, the stroke type, the alpha, symmetry and the mask work as they do for vertex paint. Click Show UVs to see the texture with the UV layout drawn over it, below the buttons, or open the UV Editor (Alt+U) to cut seams, unwrap, pack and edit the UVs. 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 Part 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 vertex paint, exactly as before. The model shows both: the vertex paint 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 Part carries no old vertex paint (Tool > Paint Layers, or Vertex Paint > 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 Part keeps its own choice, saved in the project. Show texture (Texture Map, or the Paint menu) 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 vertex paint, 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 vertex paint. 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 vertex paint layers again; the two stacks are separate."},{"p":"texture-painting.html","c":"Texture painting","a":"convert-between-vertex-paint-and-texture","h":"Convert between vertex paint and texture","t":"Button What it does Vertex Paint > Texture Bakes the vertex paint (all its layers, as shown) into the active texture layer. Makes a 2K texture if there is none Texture > Vertex Paint Sets the vertex paint 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. Vertex Paint > Texture is a quick way to move an existing vertex-painted 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 Part'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 Bridge 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 Part 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 > Quad Remesh when the Part has a texture): a voxel remesh or Quad Remesh 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 Part 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 Parts keeps their textures: the merged Part 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 (other UDIM tiles) aren't painted yet; the UV Editor lays them out."},{"p":"texture-painting.html","c":"Texture painting","a":"scripting","h":"Scripting","t":"Command What it does uv_auto Unwrap the active Part (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 Part a texture (1024, 2048, 4096, 8192 or 1k...8k) and paint into it; from_vertexpaint=true starts from the vertex paint paint_target target=texture Where painting goes: vertex or texture texture_from_vertexpaint Bake the vertex paint into the active texture layer vertexpaint_from_texture Copy the texture into the vertex paint 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, part_merge_down and part_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":"uv-editor.html","c":"UV Editor","a":"","h":"UV Editor","t":"The UV Editor shows a Part's UVs flat, over the texture's tiles, and gives you everything to make them: seams drawn on the model, unwrapping that keeps the surface's shape, packing into one tile or across UDIM tiles, texel density, trim sheets, and hand editing of vertices, edges, faces and islands. While you work, the model shows the same colours and a checker, so stretch and density show up on the surface the moment they appear, and a painted texture can move with every edit so the model keeps its look. Open it with Tool > Texture Map > UV Editor, or Alt+U. It opens over the right of the canvas with the model moved to the left; drag its title bar or its edges to place it anywhere. The UV Editor: the lion's islands after Unwrap, with island colours and a checker on the model"},{"p":"uv-editor.html","c":"UV Editor","a":"the-window","h":"The window","t":"Select (top left): what clicks pick, Vertex, Edge, Face or Island (1-4 while the pointer is over the view). The selection converts when you switch. Colours: what the faces show, in the view and on the model: Islands (a colour each), Stretch, Density (texel density) or Plain. Image: what's behind the layout: nothing, a Checker, or the Part's painted Texture (tile 1001). On model: Colours shows the same colours on the model, Checker lays a checker on its UVs (a square per 32 texels of the texture, tinted per UDIM tile). Squares that stay square mean no stretch. Frame (F over the view) fits the selection, or the whole layout, in the view; Home shows tile 1001. The status line under the view: islands, what's selected, the mean stretch, the texel density and the UDIM tiles in use. The sections on the right: Unwrap (with the seams), Pack, Texel Density, Trim Sheet, Edit and Display. The view is drawn by the graphics card, so a million-triangle layout pans, zooms and moves as smoothly as a small one. Scroll to zoom (around the pointer); drag with the right or middle button to pan. The UDIM tile numbers are written in each tile's corner."},{"p":"uv-editor.html","c":"UV Editor","a":"selecting","h":"Selecting","t":"Click to select (Shift adds, Ctrl removes); drag on an empty spot for a box. In Island mode the box picks every island it touches; in Face mode the faces inside it. A selects everything, Alt+A nothing, Ctrl+I inverts. Select in 3D (Unwrap section): click or drag over the model to select there, in the current mode; Shift adds, Alt removes. The selection shows orange in both views. Moving a vertex moves all of its corners that are joined in UV space, so islands stay in one piece while you edit them; edges along a seam move each side on its own."},{"p":"uv-editor.html","c":"UV Editor","a":"moving-rotating-and-scaling","h":"Moving, rotating and scaling","t":"The selection has a box with handles: drag inside it to move, a corner to scale, the knob above it to rotate. Or press G (move), R (rotate) or S (scale) over the view, move the mouse, and click (or Enter) to finish; a right click or Esc puts it back. During G and S, X or Y locks to one axis; Ctrl snaps (1/64 of a tile, 15 degrees, tenths of the size). The model's stretch colours and checker follow the drag live. Each drag is one undo step."},{"p":"uv-editor.html","c":"UV Editor","a":"seams","h":"Seams","t":"Seams are the edges Unwrap cuts along. They show in red on the model while the UV Editor is open, and in red in the view. Seam Tool: drag along the model over the edges you want cut. Each stretch follows the shortest edge path from where the last one ended, so you can draw a loop around an arm in a few strokes. Alt+drag clears seams the same way. A ring under the pointer shows the vertex the next stretch starts from. Mark Seam / Clear Seam: the selected edges, or the border of the selected faces. Face Groups: every face group border becomes a seam. Island Borders: the borders of the current UV islands become seams (keeps an imported layout's cuts). Sharp Edges: every edge sharper than the angle beside it (hard-surface models). Clear All. Seams drawn with the Seam Tool across the mane, in red on the model"},{"p":"uv-editor.html","c":"UV Editor","a":"unwrapping","h":"Unwrapping","t":"Pick a method and click Unwrap. With faces selected it says Unwrap Selected: only those are unwrapped, and their new islands are fitted where the old ones were; otherwise the whole Part is unwrapped and packed. Method What it does Least Stretch (the default) Cuts along the marked seams and flattens each piece keeping both angles and lengths (a conformal start, then as-rigid-as-possible steps). The best all-round choice Conformal (LSCM) Keeps angles exactly; big curved pieces get smaller towards their ends By Face Groups Least Stretch, also cut along every face group border: group the model, then unwrap Planar Projects each piece flat along its mean direction: for flat panels and decals Unfold Islands Flattens the current islands again where they are, keeping pinned UVs in place: relax after editing Auto Seams Finds its own seams (as Auto UV does), for models you don't want to cut by hand Refine sets how many least-stretch steps run (more keeps lengths better; 0 is plain conformal). You don't have to cut everything yourself: a piece that is closed (a sphere), a tube or has holes gets the extra cuts it needs automatically, a closed shell split across its middle and a tangled piece cut into charts the way Auto Seams would. Without marked seams, a Part that already has UVs is cut along its current island borders. Unwraps of big meshes run in the background with their progress over the view; a million triangles take a few seconds."},{"p":"uv-editor.html","c":"UV Editor","a":"packing-and-udim-tiles","h":"Packing and UDIM tiles","t":"Pack lays the selected islands (or all) out as large as they fit: each turned to its smallest box, scaled to one texel density (Equal density; off keeps their sizes relative to each other), with Margin texels between them. Rotate also allows quarter turns. SculptForge tries packing by the islands' outlines and by their boxes and keeps whichever holds them larger. Columns and Rows set the grid of UDIM tiles to fill: Columns along u (1001, 1002 and on; ten make a full UDIM row) and Rows up v (1011 sits above 1001). 10 Columns x 2 Rows fills 1001-1020; 4 x 3 fills 1001-1004, 1011-1014 and 1021-1024 and never goes wider. Every island gets the same texel density: more tiles, more texels for everything; the view frames the grid after a pack. When the largest island sets the scale, fewer tiles than the grid holds get islands, and the status line says how many (Pack at Density fills more). Pack at Density instead keeps exactly the target texel density and opens as many tiles as it needs, Columns wide and then the next row up. Projects remember their grid; new ones start from the last one you used. Baking writes one set of maps per tile, rows included (name_normal.1011.png, see Baking). Texture painting still covers tile 1001 only. Packed across UDIM tiles 1001 and 1002"},{"p":"uv-editor.html","c":"UV Editor","a":"texel-density","h":"Texel density","t":"Texel density is how many texels of the texture cover a unit of the surface. The Texel Density section shows the selected islands' density (or the mean) at the texture's size (or the size you choose when there is no texture yet), and the Density colours show it on every face: green is the mean, blue fewer texels, red more. Set: scale the selected islands (or all) to the target density (texels per unit). Match: give them all their mean density, so a detail looks the same size everywhere. Pick: take the target from the selection. Pack at Density: pack at exactly the target (see above). Stretch on the model and in the view while the UVs are edited"},{"p":"uv-editor.html","c":"UV Editor","a":"trim-sheets","h":"Trim sheets","t":"A trim sheet is a texture made of horizontal strips (a moulding, a belt, a seam of rivets), each repeating left to right. In Trim Sheet, describe the strips: a count (4 equal strips), heights from the top (0.5,0.25,0.25) or v ranges (0-0.5;0.5-1); they show over tile 1001 while the section is open. Pick a strip and click Assign to Strip: the selected islands are turned lengthwise, scaled to the strip's height and lined up along it from the left. Fit width squeezes or stretches the row to fill the strip exactly; off, it keeps its proportions and may run past the right edge, which is fine on a trim that repeats. The texture doesn't move for trims: the islands take on the strip's look. An island laid into the second of four trim strips"},{"p":"uv-editor.html","c":"UV Editor","a":"editing","h":"Editing","t":"Button Over the view What it does Pin / Unpin P / Alt+P Pinned UVs (blue dots) stay where they are when you Unwrap or Unfold Weld W Selected vertices that meet across a seam become one UV each, and the seam between them goes Split Y The selected edges, or the border of the selected faces, become seams, so those faces move on their own Straighten The selected vertices (a border, an edge loop) line up on one horizontal or vertical line Rotate 90 A quarter turn of the selection (or everything) Flip U / Flip V Mirror the selected islands left to right or top to bottom A good relax workflow: straighten or move the borders you care about, pin them, then Unfold Islands."},{"p":"uv-editor.html","c":"UV Editor","a":"paint-stays-on-the-model","h":"Paint stays on the model","t":"Paint stays on the model (at the bottom of the sections, on by default): when the Part has a painted texture, every UV edit (unwrap, pack, a drag, density, weld...) moves the paint onto the new layout in the same undo step, every texture layer with it, so the model looks exactly the same. Undo brings back the old UVs and the old texels. Turn it off when you want the UVs to pick a different part of the texture (as trim sheets do); the trim command leaves it off by default."},{"p":"uv-editor.html","c":"UV Editor","a":"undo","h":"Undo","t":"Every UV operation is one undo step (Ctrl+Z), drags included: the UVs, seams and pins, and the texture when it moved with them. Seams and pins are saved with the project."},{"p":"uv-editor.html","c":"UV Editor","a":"scripting","h":"Scripting","t":"Every operation is a command, for scripts, sculptforge-cli, Python (sf.run(doc, \"uv_unwrap\", method=\"isometric\")) and the AI assistant. \"The selection\" is the UV Editor's (set it with uv_select); with nothing selected the commands work on the whole Part. Command What it does uv_unwrap Unwrap: method=isometric (Least Stretch), conformal, facegroups (By Face Groups), planar, unfold or auto; iterations=, selected=, tiles=, columns=, rows=, margin=, rotate=, density=, pack=false (fit in place), keep_texture= uv_pack Pack: margin= (texels), columns= and rows= (the UDIM grid, e.g. columns=10 rows=2 for 1001-1020), tiles= (UDIM tiles, ten per row), first_tile=, rotate=, equal_density=, density= (texels per unit, as many tiles as needed), resolution=, keep_texture= uv_seam Seams: op=mark / clear (the selection), path from= to= (shortest edge path between two vertices; clear=true), facegroups, islands, angle angle=60, clear_all uv_select op=all, none, invert, island face=, face face=, facegroup group=, rect u0= v0= u1= v1=, seams, mode; mode=vertex/edge/face/island, add=true uv_transform move_u=, move_v=, rotate= (degrees), scale=, scale_u=, scale_v= about the selection's centre uv_edit op=pin, unpin, clear_pins, weld, split, straighten, flip_u, flip_v uv_density op=set value=, op=match (match=mean or first), op=info; resolution= uv_trim strip=2 strips=4 (or 0.5,0.25,0.25 or 0-0.5;0.5-1), fit_width=, margin= uv_info Islands, seams, pins, texel density, the UDIM tiles in use and the mean stretch uv_seam op=face groups uv_unwrap method=isometric uv_pack tiles=2 margin=8 uv_density op=match uv_info"},{"p":"uv-editor.html","c":"UV Editor","a":"limits","h":"Limits","t":"Texture painting paints tile 1001 (UVs between 0 and 1); islands in other UDIM tiles are laid out, measured and exported, but painting them comes later. Packing works on islands' outlines when there are enough of them and the mesh isn't huge; otherwise on their boxes (a little less tight). Experienced sculptor? The UV Editor covers UV editing and auto UV: seams on the model, several unwraps, UDIM packing, texel density and trim sheets, plus live stretch and density on the model while you edit and paint that stays put when the UVs change."},{"p":"uv-editor.html","c":"UV Editor","a":"see-also","h":"See also","t":"Texture painting: paint on the UVs Baking: bake maps onto them Exporting: UVs go out with OBJ, glTF, FBX and USD"},{"p":"pbr-painting.html","c":"Material painting (PBR)","a":"","h":"Material painting (PBR)","t":"A painted texture can carry more than colour. Turn on material channels and the Paint brush paints how rough, how metallic, how bumpy and how bright the surface is, all in one stroke, the way game engines and renderers describe materials (physically based rendering, PBR). Every channel lives on the same UVs and paint layers as the colour from Texture painting, and goes out to Unreal, Unity, Godot, Blender, glTF and USD with Export presets. Solo roughness view: a glossy horizontal stroke on Base and a rough vertical stroke on a layer"},{"p":"pbr-painting.html","c":"Material painting (PBR)","a":"the-channels","h":"The channels","t":"Channel What it holds Stored as Base Color The surface colour. Always there. 8-bit sRGB (the texture you already paint) Roughness 0 is mirror-like, 1 fully matte. Starts at 0.65. 8-bit Metallic 0 for paint, stone, skin, plastic; 1 for bare metal. Starts at 0. 8-bit Normal Fine surface direction, a tangent-space normal map (OpenGL, green up). Starts flat. 8-bit RGB Height Painted relief, 0.5 = none. Also adds to the normal (\"height to normal\"). 16-bit Ambient Occlusion How much light reaches crevices, 1 = open. 8-bit Emissive Light the surface gives off, black = none. 8-bit sRGB Opacity 1 = opaque. Exported in the base colour's alpha. 8-bit A channel you turn on costs no memory until you paint it: channels are stored as 64 x 64 tiles, and a tile nobody painted is not stored at all (a tile of one value is stored as that one value). Turning a channel off discards what was painted in it; Undo brings it back."},{"p":"pbr-painting.html","c":"Material painting (PBR)","a":"turn-channels-on","h":"Turn channels on","t":"Give the Part a texture (Texture painting). Open Tool > Texture Map. Under Material Channels, tick the channels you want (for a typical game asset: Roughness, Metallic and Normal; add Height to paint relief, Ambient Occlusion to paint dirt into crevices). Channel memory below the ticks shows what the painted tiles use; the same number, for every Part, is in Edit > Preferences > Performance under Memory."},{"p":"pbr-painting.html","c":"Material painting (PBR)","a":"paint-a-material","h":"Paint a material","t":"Open the Paint menu. With a material texture, a Material section appears under the swatches: Paint > Material: material swatches, and per channel a tick, value swatches and a slider; Material Channels in Tool > Texture Map Material swatches set the colour, roughness and metallic at once (bare metal, gold, copper, rust, gloss paint, rubber, stone, clay) and make the brush paint those channels. One row per channel: the tick says whether the brush paints that channel; the five grey squares pick 0, 25, 50, 75 or 100%; the slider sets any value. Normal has two tilt sliders (0, 0 paints a flat normal). Emissive has a colour. Untick Base Color to paint only roughness (a wet patch, a polished edge) without touching the colour. Every stroke is one undo step for all the channels it painted. The brush's falloff, alpha, pen pressure, symmetry and mask apply to every channel alike; erasing (Alt) paints Base back to each channel's default and makes layers transparent. C over the model picks the whole material: the colour and every channel under the cursor become the brush material, and the brush then paints all of the texture's channels."},{"p":"pbr-painting.html","c":"Material painting (PBR)","a":"layers-and-channels","h":"Layers and channels","t":"Paint layers (Texture painting) hold every channel. In Tool > Paint Layers, each layer row gets a row of channel chips (BC, R, M, N, H, AO, E, Op): Click a chip to turn that channel of the layer on or off. A rust layer can carry colour and roughness but leave metallic alone; a scratches layer can affect only the normal. Right-click a chip for the channel's blend mode and opacity. The ten paint-layer blend modes work per channel (Multiply on roughness halves it where you paint, Screen brightens AO...). The Normal channel adds Normal Combine, which lays the layer's normal detail onto the normals below instead of replacing them. A chip with a * uses a blend mode other than Normal or less than full opacity. The layer's own opacity, visibility and lock apply to all its channels. Merge down and Flatten keep the look of every channel. Duplicate copies a layer with its channels."},{"p":"pbr-painting.html","c":"Material painting (PBR)","a":"the-pbr-viewport","h":"The PBR viewport","t":"Render > Materials > Viewport Shading switches the view between Lit Sphere (the default, made for reading forms while sculpting) and PBR, which lights the material channels the way game engines and renderers do: rough surfaces spread the light, metals reflect the environment in their own colour, painted height and normals catch the light, emissive glows. PBR viewport, Photo Studio: gold metal and a raised rough red stroke Environment: Studio (made by SculptForge), Photo Studio, Small Studio and Outdoor Sky (free CC0 photographs from Poly Haven). HDR images (.hdr, .exr) in the folders listed in the SCULPTFORGE_HDRI_PATH environment variable are added to the list. Exposure in stops, Rotation of the environment, and the Tone map: ACES (filmic contrast), AgX (softer, keeps bright colours from going flat), Reinhard or None. Show environment puts the environment behind the model, with a Blur. Roughness and Metallic apply to Parts without a material texture (their colour comes from vertex paint or the base colour), so you can judge a sculpt as metal or clay too. Cavity darkens the sculpt's creases a little so fine detail reads under even light; 0 is plain PBR. The environment behind the model: Outdoor Sky with the AgX tone map The view stays as fast as Lit Sphere: lighting is precomputed per environment (on a worker thread when you switch), and only the pixels on screen pay for it. A 20.9-million-triangle Part draws in about 8 ms in PBR next to about 6 ms with Lit Sphere on an Apple M1 Pro. The settings are saved with the project (viewport_shading mode=pbr environment=outdoor_sky exposure=0.5 tone_map=agx)."},{"p":"pbr-painting.html","c":"Material painting (PBR)","a":"see-one-channel-on-its-own","h":"See one channel on its own","t":"Tool > Texture Map > Normal view opens a list: pick Solo Roughness (or any enabled channel) and the model shows just that channel, in grey for roughness, metallic, height, AO and opacity, as colours for the normal (with the height's normal in it) and in colour for emissive. Painting updates it live. Pick Normal view to go back. The viewport doesn't yet render the channels together as a lit PBR material; the solo view is how you check them for now."},{"p":"pbr-painting.html","c":"Material painting (PBR)","a":"height-and-normals","h":"Height and normals","t":"Height is stored with 16 bits, so slow ramps don't band. Its slope becomes a normal that is combined onto the Normal channel (Normal Combine) wherever a normal is shown or exported, so painting height also gives the shading detail. texture_channels height_normal_strength=4 sets how steep that normal is (0: height adds no normal)."},{"p":"pbr-painting.html","c":"Material painting (PBR)","a":"carrying-channels-through-geometry-changes","h":"Carrying channels through geometry changes","t":"Auto UV, Voxel Remesh, Quad Remesh and merging Parts move every channel and every layer's channels onto the new UVs, as they do the colour. A part without a channel takes that channel's default when Parts merge."},{"p":"pbr-painting.html","c":"Material painting (PBR)","a":"projects","h":"Projects","t":"Projects with material channels are saved as format 7 (SculptForge 0.10 and later opens them). A project without material channels is still saved as format 6, so older versions keep opening it. Older projects open as they did."},{"p":"pbr-painting.html","c":"Material painting (PBR)","a":"commands","h":"Commands","t":"Command What it does texture_channels enable=roughness,metallic,normal Turn channels on (disable=... off; no arguments lists them) paint_material roughness=0.2 metallic=1 color=c0c0c8 Set the brush material; channels=all / channels=roughness say exactly what it paints texture_layer_channel channel=normal blend=normal_combine A layer's channel settings (enabled, blend, opacity; layer or index) channel_view channel=roughness Solo a channel in the viewport (off to go back) export_maps preset=unreal folder=... Write the maps (Export presets) viewport_shading mode=pbr environment=photo_studio exposure=0.3 The PBR viewport (mode=lit_sphere to go back; rotation, tone_map, background, blur, roughness, metallic, cavity)"},{"p":"pbr-painting.html","c":"Material painting (PBR)","a":"limitations","h":"Limitations","t":"Fill layers, their mask generators, Mesh Maps and Material Recipes have their own chapter: Fill layers, Mesh Maps and Material Recipes. One texture per Part (UDIM tiles bake as files, Baking, but paint goes into one texture). Memory: colour, roughness, metallic, height and AO on Base plus three layers, each with a few big strokes, take about 370 MB at 4K and 1.5 GB at 8K (most of it the colour layers); a layer painted everywhere adds about 200 MB of channels at 4K and 800 MB at 8K. Edit > Preferences > Performance shows the numbers for your scene. Paint at 4K unless you need 8K. Export Maps takes a few seconds at 4K and about ten at 8K (PNG compression)."},{"p":"fill-layers.html","c":"Fill layers, Mesh Maps and Material Recipes","a":"","h":"Fill layers, Mesh Maps and Material Recipes","t":"A Fill layer lays a material over the whole Part, through a mask that you build from effects instead of painting it by hand: worn paint on the edges, dirt in the crevices, dust on the surfaces that face up. The mask reads the Part's Mesh Maps (its ambient occlusion, curvature, thickness and more, baked on its UVs), so the wear lands where the form says it should, and it moves with the form: sculpt a new crease and the paint chips along it a moment later. Material Recipes are ready-made stacks of Fill layers you can lay on any Part. Painted Edges on a sculpted sphere: the paint has chipped away along the creases Fill layers live in Tool > Paint Layers next to your paint layers, on a Part with a texture (Texture painting). Turn on Render > Materials > Viewport Shading > PBR to see the metal, the roughness and the bumps as they will look in a game engine (Material painting)."},{"p":"fill-layers.html","c":"Fill layers, Mesh Maps and Material Recipes","a":"lay-a-material-recipe","h":"Lay a Material Recipe","t":"Give the Part UVs and a texture (Tool > Texture Map > Auto UV, then New Texture). In Tool > Paint Layers, open Material Recipe and pick one: Worn Metal: dull steel, polished bright on the edges, grime in the creases. Painted Edges: painted metal with the paint chipped off its edges. Dirt and Dust: dirt packed in the crevices and pale dust on top, to lay over any material. Rusted Iron: dark iron with rust spreading from the crevices. The recipe adds its Fill layers on top of your layers, turning on the material channels it needs. The first time, the Part's Mesh Maps are baked in the background (a progress bar shows); the layers fill in when they are ready. Every layer of the recipe stays editable, and Undo removes the whole recipe in one step."},{"p":"fill-layers.html","c":"Fill layers, Mesh Maps and Material Recipes","a":"make-a-fill-layer","h":"Make a Fill layer","t":"+ Fill Layer adds a Fill layer in the current colour, covering everything. With it active, the panel shows: Colour and the channels it lays down (BC base colour, R roughness, M metallic, H height), with a slider for each value. Mask: the effects, top to bottom. Each one has a switch, a remove button and its own settings; from the second one on, a blend mode says how it combines with the effects above it (multiply, add, subtract, min, max, screen, replace). Add mask effect adds one at the bottom. The Fill layer panel: colour, channels and the mask effects with their settings"},{"p":"fill-layers.html","c":"Fill layers, Mesh Maps and Material Recipes","a":"mask-effects","h":"Mask effects","t":"Effect What it does Reads Edge Wear Convex edges and ridges, where things get rubbed and chipped Curvature Dirt Crevices, creases and corners, where dirt collects Ambient occlusion, curvature Gradient Along a direction across the Part (e.g. darker toward the bottom) Position Thickness Thin parts: ears, fins, edges of a blade Thickness Light Direction Surfaces facing a direction: dust and snow on top, moss on one side World normal Noise Fractal noise in 3D, so it has no seams at UV island borders Position Paint A mask you paint by hand (below) Levels Input and output range and gamma of the mask so far Blur Softens the mask so far (within UV islands only) Invert Flips the mask so far Fill A constant value The generators (the first five) have the same settings: Level (how much of the surface they cover), Softness (how wide the transition is), Break-up (how much noise roughens the edge of the mask) and Noise size (as a fraction of the Part's size)."},{"p":"fill-layers.html","c":"Fill layers, Mesh Maps and Material Recipes","a":"paint-a-mask","h":"Paint a mask","t":"Add a Paint effect, keep the Fill layer active and paint on the model with the Paint brush: you paint the layer's mask (white adds, Alt removes), and the layer updates as you paint. Strokes undo like any stroke. Combine it with generators: for example Edge Wear, then Paint with Subtract to keep an edge clean by hand."},{"p":"fill-layers.html","c":"Fill layers, Mesh Maps and Material Recipes","a":"mesh-maps","h":"Mesh Maps","t":"Mesh Maps are the Part's own surface, baked on its UVs at its texture's size: ambient occlusion, curvature (convex edges bright, creases dark), thickness, position (16-bit), world normal and ID (a colour per face group). Fill layers read them; you don't have to look at them. The line under the Fill buttons says what is baked. Bake bakes them again in full (after changing the UVs, for example: that happens by itself when a Fill layer needs them). Baking runs on every core in the background. Live (on by default): after each stroke, only the tiles of the texture near what you sculpted are baked again, from the triangles within reach of the change, and the Fill layers re-evaluate those tiles. The result is the same as baking everything again (it is tested texel for texel), in a fraction of the time: on a test Part with 82,000 triangles and 2K maps, a full bake takes about 10 seconds and a local change about half a second. Turn Live off to keep the maps as they are while you sculpt. To bake maps as image files for other programs, use Tool > Bake (Baking): it also bakes from a Part's top subdivision level onto its lowest, and to UDIM tiles."},{"p":"fill-layers.html","c":"Fill layers, Mesh Maps and Material Recipes","a":"save-your-own-recipe","h":"Save your own recipe","t":"A recipe is a small text file (.sfmaterial) listing the Fill layers, their materials and masks. Save the active Part's Fill layers with material_recipe action=save name=\"My Rust\" path=my_rust.sfmaterial and lay it on another Part with material_recipe path=my_rust.sfmaterial. The built-in recipes are files of the same kind in the source code's assets/materials folder."},{"p":"fill-layers.html","c":"Fill layers, Mesh Maps and Material Recipes","a":"projects","h":"Projects","t":"Fill layers are saved with the project (format 7): their settings and painted masks, and their last result, so older versions open the project with the layers showing as ordinary paint layers. Mesh Maps are not saved; they are baked again when a Fill layer needs them."},{"p":"fill-layers.html","c":"Fill layers, Mesh Maps and Material Recipes","a":"commands","h":"Commands","t":"Command What it does material_recipe name=worn_metal Lay a recipe on the active Part (action=list, action=save path=..., path=file) fill_layer generator=edge_wear color=#e0e0e8 metallic=1 level=0.6 Add a Fill layer (action=add is the default) fill_layer action=effect generator=dirt blend=add Add a mask effect to the active Fill layer (effect=1 level=0.4 edits one) fill_layer action=remove_effect effect=1 Remove a mask effect fill_layer action=set roughness=0.3 Change the layer's material mesh_maps Bake the Mesh Maps now (action=info, action=clear, action=live live=false)"},{"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 Part: each Part 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: 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 Layers list highlights the active layer; in the Classic layout the title strip also shows it (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. Moving, scaling and rotating with the Transform gizmo (or the transform command) goes into the layer too, masked or not. 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 3D Layers do: record it at the top level for the fine detail of an expression, and it stays with the Part whatever level you work on. Each layer has its own detail on every level. Step down with Lower Level (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) 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. Delete Lower and Delete 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, Quad Remesh, Decimate, Subdivide) work on the current level and drop the levels, as described in Subdivision levels; Voxel Remesh and Quad Remesh 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."},{"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":"Parts 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 Part, 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 Parts for the eyes, teeth and tongue, if the sculpt has them (see Parts). 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 Part."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"generate-the-shapes","h":"Generate the shapes","t":"Select the head Part 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. Parts too: also give the other Parts 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":"parts","h":"Parts","t":"With Parts too on, the other visible Parts get shapes by their names: Part 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 Part 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. Parts 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 Part. Eyes sculpted into the head's own surface (one mesh) would be pulled along by the lids: split them into their own Part 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 Part 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 Part (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 Part 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] [parts=true] [level=N] Generate Facial Shapes on the active Part 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 Part 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 Part. 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: 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 Part 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 Level Shift+D Steps one level down Higher Level D Steps one level up SDiv slider Steps to any level (1 is the base cage) Delete Lower Deletes the levels below the current one Delete 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 Part list shows the level of every Part 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. 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, vertex paint, paint layers and UVs are interpolated onto the new level; face groups 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 Vertex Paint 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 Face Groups, 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":"delete-lower-and-delete-higher","h":"Delete Lower and Delete Higher","t":"Delete Lower deletes the levels below the current one: the current level becomes the new base cage (SDiv 1). Delete 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, 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. Tip: The Cube from Tool > Parts > 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, Delete Lower, Delete 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 Part 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 Bridge 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 Part, in any export format). LODs and Send to Unreal start from the current level too. Tools that rebuild the mesh (Voxel Remesh, Decimate, Quad Remesh, Subdivide, Delete hidden, merging and splitting Parts) 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 Parts can't be undone, so step to the level you want to keep first, or save before. Note: Subdivide (removes levels) (in Tool > Geometry, under Change the Mesh (no levels), apart from Divide and Micro) replaces the mesh with a denser one and keeps no levels. On a Part with levels it asks first (\"This removes your N subdivision levels\"); Don't ask again turns that off. Delete Lower and Delete Higher ask too. Use Divide (keeps levels) 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 Level, Higher Level subdiv_delete_lower, subdiv_delete_higher Delete Lower, Delete Higher subdiv_reconstruct Reconstruct Subdiv subdiv_info List the levels and their triangle counts subdiv_export path=base.obj level=1 Export the visible Parts 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 Part keeps them: selecting another Part frees that memory (50-170 MB for a Part 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."},{"p":"subdivision-levels.html","c":"Subdivision levels","a":"past-the-highest-level","h":"Past the highest level","t":"For more detail than the computer can hold as a mesh (hundreds of millions of polygons), add a micro level on top of the highest level: see Micro levels."},{"p":"micro-levels.html","c":"Micro levels: hundreds of millions of polygons","a":"","h":"Micro levels: hundreds of millions of polygons","t":"Subdivision levels store every vertex of every level. That is what lets you step down and reshape, but it costs about 90 bytes per triangle: a 300 million triangle model would need 27 GB. Micro levels go past the highest subdivision level without a mesh: each triangle of that level carries a regular grid of heights, one 16-bit number per point, and the micro triangles are worked out on the fly by the brushes and by the graphics card. 300 million micro triangles take about 0.4 GB, sculpt in real time and draw at 60+ frames per second. A sphere with 335 million micro triangles: surface noise, a Clay Block band, Crease and Sharp Crease lines (Micro 4, 420 MB)"},{"p":"micro-levels.html","c":"Micro levels: hundreds of millions of polygons","a":"making-a-micro-level","h":"Making a micro level","t":"Divide the Part to a comfortable highest level (0.3 to 2 million triangles is the sweet spot). In Tool > Geometry, set the Micro slider. Each step is four times the triangles: the label shows the total (Micro 4 on a 1.2 million triangle level is 300 million micro triangles). Click Divide to Micro. The surface stays exactly as smooth as before; the micro level starts flat on it. The micro level sits on the highest subdivision level, so step up to it first. While a micro level exists you can't change subdivision levels (Bake it or delete it first). Micro level Micro triangles per triangle Memory per micro triangle 3 64 1.4 bytes 4 256 1.2 bytes 5 1,024 1.1 bytes 6, 7 4,096, 16,384 1.05 bytes For the smoothest view, prefer a higher micro level on fewer base triangles: 300 million as Micro 5 on 300,000 triangles draws faster than Micro 4 on 1.2 million."},{"p":"micro-levels.html","c":"Micro levels: hundreds of millions of polygons","a":"sculpting","h":"Sculpting","t":"These brushes work on micro levels: Standard, Clay, Clay Block, Smooth, Inflate, Flatten, Trim, Layer, Pinch, Crease, Sharp Crease and Mask (with Ctrl). Symmetry, Falloff, pressure, alphas (Drag Stamp included) and the mask work as usual, and every stroke is one undo step. A micro level stores one height per point, so it moves the surface in and out, never sideways. Pinch, Crease and Sharp Crease pull the height profile together instead of the points (the result looks the same for creases and folds), and stay clean at full strength. Move reshapes the level below the micro level (the base) and the micro detail rides along on it, in its own frame: drag an ear back without smearing the pores. To move the micro surface itself along its normals, tick Move along normals. Big brushes are evaluated on a coarser grid (about 50 points across the brush) and the change is spread smoothly over the points in between, so a brush that covers half the model costs about as much as a small one. The detail under it is kept. Brushes that slide the surface (Tendril, Nudge, VDM stamps) and custom recipe brushes don't apply to micro levels; recipe brushes act as Standard. Vertex Paint, sculpt layers, face group colours and the wireframe aren't shown on micro levels yet."},{"p":"micro-levels.html","c":"Micro levels: hundreds of millions of polygons","a":"baking-down-and-exporting","h":"Baking down and exporting","t":"Bake Micro makes a regular mesh of the micro level in a new Part (the micro level stays). micro_bake level=3 bakes a coarser micro level; replace=true replaces this Part instead. UVs, face groups, hidden faces and the micro mask carry over. Export Displacement writes a 32-bit EXR displacement map over the base UVs (needs UVs) next to the project: the height of the micro surface above the flat base triangles, along the interpolated normal. micro_export_displacement path=detail.png type=vector writes a vector map (object space) or a 16-bit PNG (mid-grey = 0; the message says the scale). Projects keep micro levels (project format 7; projects without one are still written as format 6, so older versions open them). Untouched areas take almost no room in the file."},{"p":"micro-levels.html","c":"Micro levels: hundreds of millions of polygons","a":"very-large-levels-and-laptops","h":"Very large levels and laptops","t":"A micro level larger than the resident cache your hardware profile allows (a quarter of the memory when there is no profile yet) is kept out of core: in a file in the cache folder (~/.cache/sculptforge), of which only the parts you sculpt or look at stay in memory. A billion micro triangles then fit on a 16 GB machine. The status line under the slider says when a level is out of core. SF_MICRO_OUT_OF_CORE=1 forces it (for testing); SF_MICRO_SWAP_DIR picks the folder. How many triangles a frame draws for micro levels follows the machine: the view lowers the detail of far and small areas until a frame fits the budget (2 million on a laptop profile, 8 million on a workstation)."},{"p":"micro-levels.html","c":"Micro levels: hundreds of millions of polygons","a":"scripting","h":"Scripting","t":"Command What it does micro_divide level=4 or micro_divide triangles=300 Add a micro level (by level, or about this many million micro triangles) micro_delete Remove it (undoable) micro_info Level, micro triangles, memory, displacement range micro_bake level=4 replace=false Bake down to a mesh micro_export_displacement path=disp.exr size=4096 type=scalar Displacement map over the base UVs micro_noise amplitude=0.0015 scale=120 Procedural surface noise over the whole micro level sculptforge --bench-micro --bench-sizes 33,100,300 measures memory, brush and frame times on your computer."},{"p":"micro-levels.html","c":"Micro levels: hundreds of millions of polygons","a":"see-also","h":"See also","t":"Subdivision levels Performance Baking normal and displacement maps"},{"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 dynamic topology 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 Tendril with Dynamic on, as wireframe 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, Sculpt > Draw & Tablet Turns dynamic topology on or off Detail Top shelf (while Dynamic is on), Sculpt > Draw & Tablet How small the triangles get: 0 coarse, 100 fine (default 50) Constant detail Sculpt > Draw & Tablet 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 Drag Stamp and Slide Stamp (so VDM stamps don't remesh either). Smooth remeshes towards larger triangles, so smoothing also simplifies. Tip: Turn on Wire (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 dynamic topology: 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 and saves itself. 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":"smooth-remesh","h":"Smooth remesh","t":"Smoothing (Shift) with Dynamic on also simplifies by default: it remeshes toward triangles twice the size, so the smoothed area gets coarser, as in dynamic topology. Smooth remesh under Sculpt > Draw & Tablet > Dynamic topology sets how much (from the discussions): Smooth only (0): Shift only smooths; the triangles stay as they are. Light (50): it remeshes toward triangles one and a half times the size. Simplify (100, the default): as before. It is a preference (saved automatically) and is saved with the project; from a script, dyntopo smooth_remesh=0."},{"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. A model whose sides aren't made of mirrored polygons (after Quad Remesh, or sculpted without symmetry) has no mirrored triangles to keep: each side then gets its own new triangles, as fine as the brush's side. 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 face groups stay where they are; their vertices only slide along them. New triangles take the face group of the triangle they came from. Vertex Paint, 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 Part (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. On a Part with levels, clicking Dynamic offers Freeze Levels and Turn On Dynamic: the level you see becomes one plain mesh and the other levels go (Ctrl+Z brings them back). To keep a different level, go to it first. If you turn Dynamic on and then pick a Part that has levels, strokes sculpt it without remeshing, and the Sculpt > Draw & Tablet palette shows the same Freeze Levels + Dynamic button. A good workflow: block in with Dynamic, then Quad Remesh 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=Tendril 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 Quick tour for experienced sculptors"},{"p":"timeline.html","c":"Sculpt Timeline and timelapse","a":"","h":"Sculpt Timeline and timelapse","t":"Every stroke and operation you make is a step on the Sculpt Timeline, the strip along the top of the canvas (or its bottom: Edit > Preferences > Interface > Timeline position). Drag its scrubber to see the model at any point of the session, click a step to go back there, and keep sculpting from it: the steps you had made after it are not thrown away as with a plain undo, they stay as a branch you can switch back to. You can change how strongly a past stroke shows without redoing the strokes after it, and render the whole history as a turntable timelapse video. The Sculpt Timeline strip (here at the bottom of the canvas): three strokes on the active branch, the scrubber at the last one, and the lane of an earlier continuation above the track"},{"p":"timeline.html","c":"Sculpt Timeline and timelapse","a":"the-strip","h":"The strip","t":"Each step is a tick on the track: sculpt strokes in light grey, masks in blue, vertex paint in pink, visibility and face groups in green, and topology changes (dynamic topology, remeshing, Divide, Part changes) as tall teal ticks. The orange scrubber marks the state the canvas shows; the steps after it are dimmed. A dot above a tick marks a re-tuned stroke. Drag along the track to scrub through the history: the model follows as you drag. Click a tick to go to the state after that step. Point at a tick for what the step was, how many vertices it changed and when. Right-click a stroke to re-tune it (see below). The strip is one thin row: the step you are at on the left (point at it for the step's name and the number of branches), the track, then the buttons. The save icon (Save with project, lit when on) keeps the history with the project, the film icon exports a timelapse, the unfold icon shows the full strip with a header row (Edit > Preferences > Interface > Compact timeline switches it too), and the arrow folds the strip into a small Timeline tab (click the tab to open it again; Sculpt Timeline in the command palette, F3, does the same). Undo and Redo (Ctrl+Z, Ctrl+Shift+Z) move the scrubber one step, as before. Each Part keeps its own timeline, like its own undo history."},{"p":"timeline.html","c":"Sculpt Timeline and timelapse","a":"branches-undo-without-losing-anything","h":"Branches: undo without losing anything","t":"Go back to an earlier step and sculpt: a new branch starts there. The steps you had made after that point stay in the history as a thin lane above the track, starting where the branch splits off. Click the lane to make that branch the active one again; the branch you leave becomes the lane. Nothing is lost by trying an idea and going back."},{"p":"timeline.html","c":"Sculpt Timeline and timelapse","a":"re-tuning-a-past-stroke","h":"Re-tuning a past stroke","t":"Right-click a stroke on the track and drag Strength: 1 is the stroke as you made it, 0 removes it, 2 makes it twice as strong. The model updates at once and the strokes you made after it are kept. How it works: the change to that one stroke's displacement is added to the model as it is now. Where later strokes don't touch the area, the result is exactly what you would have had with the new strength. Where later strokes overlap it, they keep the displacement they made at the time, on top of the re-tuned stroke: they are not sculpted again. So a Smooth you did afterwards over the same spot won't smooth the stronger version, and a later Inflate keeps the direction it pushed in then. For most detail passes that is what you want; for a big change under a lot of later work, check the area afterwards. A stroke can't be re-tuned when a step after it replaced the mesh as a whole (dynamic topology, a remesh, Divide, a sculpt layer change): the menu says which step is in the way. Strokes made on a sculpt layer can't be re-tuned either."},{"p":"timeline.html","c":"Sculpt Timeline and timelapse","a":"big-meshes","h":"Big meshes","t":"Scrubbing reuses what undo already keeps for each stroke, only the vertices it moved. A run of strokes is swapped in one go, with normals and the view updated once for the whole run, and every few steps the timeline keeps a full copy of the shape (a checkpoint) so a jump across the whole history replays only a few strokes from the nearest one. Measured on an Apple M1 Pro after 220 strokes (a third of them big, up to 4.4 million vertices each), while other heavy programs were running: Mesh One step of the scrubber A jump across the history 21 million triangles 5 ms typical, 50 ms for the biggest strokes about 0.4 to 0.5 s 33 million triangles 5 to 14 ms typical, up to 170 ms for the biggest strokes about 0.6 to 1 s See also Performance and big meshes. The history uses memory: undo keeps up to 1 GB (the oldest steps go first, as before), the timeline up to 1.5 GB more for inactive branches and the extra copy of each stroke that makes fast seeking possible, and up to 1 GB of checkpoints (fewer, further apart, on very big models). With those limits a 21 million triangle model keeps about the last 100 strokes of the size above, a 33 million one about 70; small detail strokes cost far less."},{"p":"timeline.html","c":"Sculpt Timeline and timelapse","a":"saving-the-history","h":"Saving the history","t":"Turn on Save with project (the save icon on the strip) and saving a project also writes its history beside it, as name.sfhist next to name.sfproj. Opening the project brings the timeline back, branches and re-tuned strengths included, as long as the project hasn't been changed elsewhere since. Sculpt strokes, masks, vertex paint, visibility and face groups are saved; a topology change (dynamic topology, remesh, Divide, sculpt layers) cuts the saved history there, keeping what came after it."},{"p":"timeline.html","c":"Sculpt Timeline and timelapse","a":"timelapse-video","h":"Timelapse video","t":"Export timelapse (the film icon in the strip, or Export timelapse... in the command palette) renders the history of the active Part, from the start to the step you are at, as a turntable video: the model builds up stroke by stroke while the camera goes once around it, with a short pause at the start and the end. Pick 1080p or 4K, the length, and where to save the MP4. There are no captions or interface in the video. It needs ffmpeg installed. From the command line, for a project saved with its history: sculptforge creature.sfproj --timelapse creature.mp4 --size 3840x2160 --timelapse-seconds 20"},{"p":"timeline.html","c":"Sculpt Timeline and timelapse","a":"scripting","h":"Scripting","t":"The timeline is scriptable: timeline_info list=true lists the steps (with their ids), timeline_seek index=N shows step N of the active branch, timeline_select node=ID switches to the branch through a step, timeline_retune node=ID strength=0.5 re-tunes a stroke, and timeline_save / timeline_load write and read the .sfhist file."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo)","a":"","h":"Moving, rotating and posing (Gizmo)","t":"The Gizmo moves, rotates and scales a whole Part, 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, with the same keys. The Gizmo's Move, Scale and Rotate modes; the handle under the cursor turns yellow"},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo)","a":"the-three-modes","h":"The three modes","t":"Press a key, or click the button on the top shelf (they're also in Sculpt > Symmetry & Gizmo): 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)","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)","a":"moving-only-part-of-a-part","h":"Moving only part of a Part","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 panel to move the whole Part whatever the mask."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo)","a":"posing-a-limb","h":"Posing a limb","t":"Mask what should stay: for an arm, everything but the arm (Ctrl+paint, or Lasso Mask). 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 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 Part'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)","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 Part moved as a whole just moves."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo)","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 Part, or its unmasked part) and follows it when you change the mask or pick another Part. 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 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)","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)","a":"typing-exact-values","h":"Typing exact values","t":"The Gizmo 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)","a":"all-parts","h":"All Parts","t":"Turn on All Parts in the panel to move every visible Part together, for example to turn a whole character with its eyes, teeth and clothes. The pivot is the centre of all of them. Each Part gets its own undo step: undo goes back in the active Part, and selecting another Part undoes its part. Folder, beside it, moves the visible Parts in the active Part's folder together, for example both eyes. Right-click a folder's header in the Parts list > Move with the gizmo turns it on for you."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo)","a":"what-a-transform-keeps","h":"What a transform keeps","t":"A transform only changes where the vertices are. Face Groups, quads, UVs, vertex paint, textures, the mask and the topology stay as they are. With Base mesh active, 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 a sculpt layer active, the transform goes into that layer, like a stroke: the base stays, and the layer's weight dials the move in and out (a pose as a blend shape). A layer whose weight is 0 can't be transformed into. 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)","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 Part, moved, rotated and scaled together"},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo)","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)","a":"see-also","h":"See also","t":"Masking Parts 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 Part: add resolution for detail, rebuild an even surface, reduce the triangle count, make it symmetric, 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 Part 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 vertex paint Keeps face groups, 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 Quad Remesh Tool > Geometry > Quad Remesh Set by Target Polygons All quads, with edge loops Baked in Yes (transferred) Face Groups 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 Mirror And Weld Tool > Geometry > Modify Topology Twice the kept side Yes Yes Yes (mirrored) Yes (mirrored) 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 the Bridge, Blender or Maya (OBJ, FBX, PLY, USD) keeps its quads: Wire draws them as quads, without the diagonal, and OBJ, FBX, PLY, USD and Bridge 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, vertex paint, sculpt layers, undo, Parts 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 face groups, 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."},{"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 (removes levels) is the one-way version; on a Part with levels it asks before removing them. Tool > Geometry > Subdivide smooths the mesh with Loop subdivision. Each level multiplies the triangle count by four and rounds off the shape slightly. Sculpt layers are subdivided with the mesh, so blend shapes keep working. Mask, vertex paint and UVs are interpolated; face groups 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 Quad Remesh do the same. To add triangles only where you sculpt, use Dynamic topology. Tip: The bar along the top shows the triangle count 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 Part as an even, watertight surface. Use it to: fuse overlapping pieces into one surface (append a sphere, overlap it, merge, remesh); even out stretched triangles after heavy Move or Tendril 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 (32 to 512, as the remesh command; default 200). Higher keeps more detail and makes more triangles. 512 is safe on an 8 GB computer: a 28M-triangle scan remeshes at 512 in about 8 s (14 s on 4 cores) into about 760,000 triangles; a round 2M-triangle sculpt, which fills its box, in about 3 s (5 s on 4 cores) into about 2.5 million triangles, with about 2 GB of memory at its peak. 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 vertex paint are transferred from the nearest original vertex. Face Groups, hidden faces and UVs are reset (everything becomes visible, one face group). Hidden parts are remeshed too. A painted texture is kept with Keep Texture (on by default, shown next to the button when the Part 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). Keep Masked (off by default): masked areas keep their triangles exactly, detail included, and only the rest is remeshed. The new surface is joined to the masked area along the mask's edge by a narrow strip of triangles, so the model stays closed. A triangle counts as masked when all three of its corners are at least half masked. A ragged mask edge is tidied by itself (#67): where it touches itself the corner triangles are remeshed, masked spots smaller than the new polygons are remeshed with the rest, and narrow gaps between masked areas are kept; the status line says when it did. If it still can't be joined, the status line says what to change (blur or grow the mask, or unmask where two parts overlap) and nothing changes. Command: remesh keep_masked=true. To remesh several Parts into one, first combine them with Merge visible... or Merge down... in Parts."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"quick-remesh","h":"Quick Remesh","t":"Remesh as you sculpt, without going to the palette (#121). Turn on Tool > Remesh > Quick Remesh, then: press Shift+R, or hold N and click or drag on the background (anywhere off the model; on the model it stays a brush stroke). Either one remeshes the active Part at the Resolution above, with Keep Masked and Keep Texture as set there. It runs in the background with the same progress bar and Cancel, so you can keep sculpting; the status bar says when it's done and how many triangles the Part has now. Each remesh is one undo step. If you sculpt or undo while it runs, it doesn't throw that work away: it remeshes the Part again as it is now. Both keys change in Edit > Preferences > Hotkeys (Quick Remesh and Quick Remesh (hold and drag)). Neither Shift+R nor N is used by any key style, and holding N changes no other drag on the background: without it, a drag there turns, pans or zooms the view, or draws the mask and hide shapes, exactly as your key style says. With Quick Remesh off, the keys only tell you where to turn it on. Remesh after each stroke (off by default) does it for you: when you lift the pen after a stroke that stretched the surface (edges pulled to more than 1.6 times their length, as a long Move or Snake Hook pull does), the active Part is remeshed in the background. Strokes that don't stretch anything, and masking or painting, never remesh. Sculpting never waits for it. It skips Parts with subdivision levels, sculpt layers or a painted texture (Keep Texture), where a remesh would bake or drop them; use the button or Shift+R there."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"quad-remesh","h":"Quad Remesh","t":"Tool > Geometry > Quad Remesh is automatic quad retopology: it rebuilds the Part as clean quads whose edge loops follow the forms, close to a target polygon count, with Keep Groups, Adaptive Size, vertex paint density and symmetry. Project Detail (Tool > Parts > 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":"close-holes","h":"Close Holes","t":"Tool > Geometry > Close Holes caps every open boundary of the active Part, such as a hole, an open bottom or the rim of an extracted shell. The new patch's triangles are sized like the ones around the hole, and the patch follows the curve of the surface around it, so a hole in a sphere closes round, not flat. The rest of the Part is not changed. The patches get a face group of their own, so you can mask or hide them in one click. Close Holes makes an open scan or an extracted part watertight without a remesh. Ctrl+Z brings the holes back."},{"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 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 vertex paint. Face Groups, hidden flags and UVs survive on the remaining triangles. The result is all triangles: quads are not kept. With Keep Masked (under the button, off by default) masked vertices are never removed, so masked areas keep their triangles exactly and only the rest is decimated (decimate keep_masked=true). 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 Part (Tool > Parts > Duplicate) when you want to keep the full-resolution sculpt in the same project."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"mirror-and-weld","h":"Mirror And Weld","t":"Mirror And Weld, in Tool > Geometry > Modify Topology, makes a model symmetric: it keeps the half on the side of the chosen axis (+X is the model's left, your right when you look at its face), mirrors it onto the other side and welds the two halves along the middle into one watertight mesh. Use it after sculpting one side without symmetry, to finish a half model, or to repair a model whose sides have drifted apart. A head with a scar and a brow ridge on one side, then the same head after Mirror And Weld X Pick the axis with X, Y and Z beside the button (X is on by default). With several on, they apply one after the other. The mirror plane goes through the world's origin, the same plane symmetry uses. Polygons that cross it are cut on it, so the seam is clean wherever the model sits. Points on an open edge within 0.1% of the model's size from the plane are welded onto it, which closes a half model whose seam isn't exactly at 0. Face Groups, vertex paint, the mask, UVs, quads and sculpt layers are kept; the mirrored side takes the kept side's. Subdivision levels are removed (undo restores them), as with the other tools on this page. To keep the other side, flip the model first with Tool > Deformation > Mirror, or run mirror_and_weld side=negative."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"mirror","h":"Mirror","t":"Tool > Deformation > Mirror flips the Part across the plane through the origin on the chosen axes, with its surface still facing outward. Face Groups, vertex paint, UVs and layers come along; subdivision levels are removed (undo restores them). mirror pivot=center flips it in place about its own centre instead."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"merge-by-distance","h":"Merge by Distance","t":"Tool > Geometry > Merge by Distance merges the points of the active Part that are closer together than the Distance slider into one. Use it on an import whose triangles don't share their points (an STL, or a model another program split at its seams): until they are merged, every triangle is loose and a brush tears the surface apart. The line under the slider counts the points that will merge, and those points show on the model in orange while the section is open. On meshes with more than 1.5 million points the count updates when you let go of the slider. 0 merges only points exactly on top of each other. The slider goes up to 2% of the Part's size; scripts can use any distance. Points are taken in order: each one within the distance of a point kept before it merges into the nearest of them and takes its position, mask, vertex paint and sculpt layer offsets. Triangles that collapse (two corners on one point) are removed, and so are points no triangle uses. One undo step. Subdivision levels are removed (undo restores them)."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"check-mesh","h":"Check Mesh","t":"Tool > Geometry > Check Mesh looks for what makes a mesh hard to sculpt, remesh, 3D print or export. Check counts the problems; it changes nothing. Each problem found gets a row with its count and a Fix button that changes only what that row names, as one undo step. Row What it is What Fix does Non-manifold edges Edges shared by three or more triangles (a fin, a wall inside the mesh) Each triangle past the first two gets its own copy of the edge, so it comes loose; nothing is deleted Holes Open boundary loops Caps each with a patch, as Close Holes does Duplicate triangles Triangles on the same three points as another, either way round Deletes the copies Degenerate triangles Triangles that use one point twice Deletes them Zero-area triangles Three different points in one line (a sliver) Collapses each one's shortest edge Flipped triangles Triangles wound against their neighbours, or a closed piece that is inside out Turns them to match the rest of their piece, and closed pieces right way out Isolated points Points no triangle uses Removes them Fix all fixes every row except Holes, in one undo step: a mesh can be open on purpose (a cloth panel, a mask, a relief), so holes are only capped when you click their own Fix. After a fix the list checks again."},{"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 Part. The exports themselves build a chain for every visible Part."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"undo-and-safety","h":"Undo and safety","t":"Subdivide, remesh, Quad Remesh, decimate, Mirror And Weld, Mirror, Merge by Distance, every Check Mesh fix and delete hidden are single undo steps on the active Part. 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: Snapshot (File > Save Snapshot) keeps a timestamped copy of the scene without touching your project file; see Projects. Duplicate the Part 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_vertexpaint, symmetry, keep_original, keep_texture; see Quad retopology close_holes max_edges closes only holes with at most that many boundary edges (default 0: all); refine (default true; false: as few triangles as possible); new_group (default true) mirror_and_weld axis x, y, z or several, e.g. xz (default x); side positive (default) or negative mirror axis (default x); pivot origin (default) or center weld_points distance in scene units (0: only exactly coincident points); preview=true only counts them mesh_check Lists the problems, e.g. holes=2 flipped=14 mesh_fix issue non_manifold, holes, duplicate, degenerate, zero_area, flipped, isolated or all (all but holes) 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: Quad Remesh and Project Detail Parts: 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":"cut.html","c":"Cut: line, lasso, rectangle and polyline","a":"","h":"Cut: line, lasso, rectangle and polyline","t":"Cut cuts the active Part with a shape you draw on the screen. The shape is pushed straight into the view, so what you see inside it is what gets cut, front and back. Every cut is one undo step, and a closed Part stays closed (watertight), so you can keep sculpting, remeshing or 3D printing it."},{"p":"cut.html","c":"Cut: line, lasso, rectangle and polyline","a":"pick-a-shape","h":"Pick a shape","t":"Hold Ctrl+Shift and click the brush tile on the shelf (or press B) to pick a Cut shape next to Select Rectangle and Select Lasso, or use the shape buttons at the top of Tool > Cut: Shape How to draw it Cut Line Ctrl+Shift+drag a straight line. The shaded side is cut; hold Alt as you let go to cut the other side. Cut Lasso Ctrl+Shift+drag a free-hand outline. Its inside is cut. A lasso that crosses itself keeps its biggest loop. Cut Rectangle Ctrl+Shift+drag a rectangle. Its inside is cut. Cut Polyline Ctrl+Shift+click point after point. Click the first point again to cut the polygon; double-click or press Enter to cut along the open, bent line (the shaded side; Alt for the other); Esc drops it. While a Cut shape is picked, Ctrl+Shift cuts instead of hiding; pick Select Rectangle or Select Lasso again to hide parts of the model."},{"p":"cut.html","c":"Cut: line, lasso, rectangle and polyline","a":"pick-a-mode","h":"Pick a mode","t":"Tool > Cut has four modes: Mode What it does Away Removes everything the shape covers, through the whole Part, and closes the cut with a flat cap. A line slices the Part in two and keeps one side; a lasso or rectangle drawn inside the outline cuts a hole right through. In Cuts a flat-bottomed pocket where the shape covers the Part. Depth sets how deep, measured from the nearest point under the shape. Add Adds the shape, extruded towards you by Depth and joined to the Part (a boolean union): panels, ridges, buttons, sockets. Clip Removes nothing. A line presses its shaded side flat onto itself. A lasso, rectangle or closed polyline presses everything outside it onto its outline. Points keep their depth, so you get flat planes and clean silhouettes through the whole Part. The mask holds points back. Depth is a share of the Part's size (0.10 = a tenth of its largest side), so it means the same on a small or large model."},{"p":"cut.html","c":"Cut: line, lasso, rectangle and polyline","a":"what-the-cut-keeps","h":"What the cut keeps","t":"The surface outside the cut is kept exactly, with its mask, vertex colours, UVs, face groups and sculpt layers; only the triangles the shape crosses are split. The cap (and the walls of a pocket or added shape) are a face group of their own, so you can select, mask or hide them in one click (Face Groups). The caps are flat with long triangles. To sculpt on them, give the Part even topology first: Tool > Remesh or Dynamic topology (Subdivide, remesh, decimate and LODs). Only the active Part is cut; the other Parts are untouched. Cut each Part on its own, or merge them first. With symmetry on (X, Y, Z or radial on the top shelf), the mirror image of the shape cuts too. An open Part (a plane, a scan with holes) is trimmed without a cap. Add needs a closed Part. Forge Spheres and Parts with a micro level must be made into a plain mesh first."},{"p":"cut.html","c":"Cut: line, lasso, rectangle and polyline","a":"scripting","h":"Scripting","t":"The cut command takes the shape (line, lasso, rect, polyline), its points in normalised screen coordinates, the mode (away, in, add), depth, flip, closed and an optional view_proj matrix; see Scripting."},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"","h":"Quad retopology and detail projection","t":"Quad Remesh rebuilds a sculpt as clean, all-quad topology whose edge loops follow the forms. Project Detail then moves a mesh onto the surface of other Parts, so the detail of the original sculpt comes back onto the new topology. 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 Quad Remesh: 5,000 quads whose loops follow the mane, shown with Wire"},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"the-usual-workflow","h":"The usual workflow","t":"Select the sculpt and open Tool > Remesh (the same Quad Remesh controls are also under Tool > Geometry). Under Quad Remesh, turn on Keep Original. Set Target Polygons (for example 5000) and click Quad Remesh. It runs in the background: a progress bar replaces the button, and Cancel stops it. The result replaces the Part, and the sculpt as it was is kept as a hidden Part 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 > Parts) and click Project Detail under Tool > Parts > Project. The divided quads snap onto the sculpt and take its vertex paint. 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":"quad-remesh","h":"Quad Remesh","t":"Tool > Remesh > Quad Remesh (also under Tool > Geometry) works on the active Part. Control What it does Quad Remesh Starts the retopology. The status line reports the result and its quality, e.g. \"Quad Remesh: 5072 quads from 47214 triangles (100% quads) in 6.5 s. Quality: 260 poles (141 x3, 113 x5, 6 other), corners 8.5 deg off square, distance to the sculpt 0.106% mean / 1.27% max of its size\" Method Quad Remesh 2 (the default): the whole layout is solved at once as an integer grid, so poles appear only where the form needs them and loops run unbroken. Legacy: the method of SculptForge 0.9, kept for comparison and for closed guide loops 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 Part'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 face group borders, and the result keeps the face groups Detect Edges Hard edges get an edge loop, so boxes and bevels stay crisp (on by default). Quad Remesh 2 takes faces meeting at more than about 60 degrees along a line at least a few quads long (a scan's or a sculpt's deep creases are left to the flow); the legacy method any edge over 50 degrees Use Vertex Paint 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 Sculpt > Symmetry & Gizmo (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 Part as it was, hidden, below the new one, ready for Project Detail. Off: the Part is replaced (undo brings it back) Keep Masked Masked areas keep their triangles exactly, as a fixed piece: only the unmasked part is remeshed (the target counts its quads), and it's joined to the masked part along the mask's edge with a strip of triangles, so the model stays closed. If the mask's edge can't be joined up, the status line says so and nothing changes (off by default; qremesh keep_masked=true) Keep Texture Shown when the Part has a painted texture (on by default): Auto UV the result and project the texture onto it. Off: the texture is dropped Quad Remesh Guides Picks the guides brush: draw curves on the model for the edge loops to follow. See Quad Remesh 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) Quality Report Shown after a Quad Remesh of the active Part: the poles (vertices with other than four edges, by how many edges), how far quad corners are from square (mean and worst 1%), and how far the new surface is from the sculpt (mean and maximum, in % of its size) What happens to your data: The result is all quads (stored as pairs of triangles, so Wire draws quads and OBJ, FBX, PLY, USD and Bridge 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 vertex paint are interpolated from the closest point of the sculpt (vertex paint is blurred to the new resolution until you project it back onto a divided"},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"guiding-the-edge-flow","h":"Guiding the edge flow","t":"Quad Remesh Guides put an edge loop exactly where you draw: around the eyes, the mouth, a joint. See below. Face Groups 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 Face Groups. Vertex Paint sets the density with Use Vertex Paint: 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":"Quad Remesh 2 builds the layout the way recent research quad remeshers do (integer-grid maps, as in Mixed-Integer Quadrangulation, Bommes, Zimmer and Kobbelt 2009, and Integer-Grid Maps for Reliable Quad Meshing, Bommes et al. 2013), in its own implementation: A working surface. The sculpt is brought to about three triangle edges per quad edge with even triangles (dense sculpts are first decimated in parallel blocks), keeping open edges, face group borders (Keep Groups) and real hard edges (Detect Edges; creases shorter than two quads or softer than about 55 degrees at the quad scale are sculpt detail, not hard edges) on their exact place. Curvature and directions. The principal curvature directions, smoothed over about one quad, and a smooth cross field (the directions the edges take) solved over the whole surface at once: it follows the curvature where the surface clearly bends one way (limbs, lips, brows, ridges), the feature lines exactly, and is as smooth as possible elsewhere. It is solved on a copy of the surface smoothed at the quad scale, so pores and scratches don't add poles. Vertex Paint density turns it the way a change of density needs. The grid. A seamless parametrization whose integer lines are the edge loops: feature lines and guides lie exactly on grid lines, singularities (the poles) exactly on grid points, and across the seams the grid only turns by quarter turns. Its integer unknowns are rounded nearest-first, each round followed by a re-solve. Extraction of that grid at the target density (not split from a coarser one), every face a quad; the rare places where the grid folds are repaired locally and stay all quads. Loop-aware relaxation: smoothing on the sculpt in which a vertex can slide along a loop that runs over a ridge but not off it, then projection onto the sculpt. With Symmetry one half is remeshed with the mirror plane as a feature line and mirrored, so the field and the result are exactly symmetric. The result is the same every time for the same settings. The lion scan at 5,000 quads. Left: the legacy method, 1,028 poles. Right: Quad Remesh 2, 199 poles, with loops along the mane and round the muzzle and a clean box on the base Compared with the legacy method on the same models and targets, Quad Remesh 2 has a quarter to a fiftieth of the poles at the same distance to the sculpt (poles, then the mean angle of quad corners off 90 degrees, then the mean distance in % of the model's size; legacy first): Model Target Poles Corners off square Distance Lion scan (47k triangles) 2,000 433 to 116 22.7Β° to 7.8Β° 0.295% to 0.290% 5,000 1,028 to 199 18.2Β° to 7.9Β° 0.125% to 0.120% 10,000 1,665 to 398 14.5Β° to 8.3Β° 0.059% to 0.060% ICT head (28k, symmetry) 2,000 269 to 91 12.6Β° to 8.9Β° 0.108% to 0.101% 5,000 511 to 114 8.8Β° to 8.0Β° 0.039% to 0.040% 10,000 727 to 214 6.6Β° to 7.7Β° 0.015% to 0.018% Creature from a sphere (82k, symmetry) 2,000 96 to 22 4.6Β° to 8.5Β° 0.035% to 0.037% 10,000 308 to 37 3.4Β° to 6.8Β° 0.007% to 0.007% Hard-surface part (3 boxes) 2,000 56 to 24 2.0Β° to 0.7Β° 0.082% to 0.000% 10,000 24 to 28 0.3Β° to 0.7Β° 0.000% to 0.000% Sculpted sphere (1.3M) 2,000 84 to 8 4.3Β° to 3.9Β° 0.037% to 0.035% 10,000 401 to 8 4.3Β° to 5.2Β° 0.008% to 0.007% On smooth sculpts with Adaptive Size the corners are a few degrees further from square than the legacy method's: the grid bends to vary the quad size instead of adding poles. Set Adaptive Size to 0 for the squarest grid. A 1.3-million-triangle sculpt takes about 4 seconds to 5,000 quads on a 10-core M1 Pro; denser sculpts are first decimated in parallel blocks to a working resolution: 5.2 million triangles take 7 to 9 seconds (1.3 GB at most) and 21 million about 20 seconds (4.7 GB), at 2,000 to 10,000 quads. The legacy method (Method > Legacy, method=legacy) is the Instant Meshes style field-aligned method of SculptForge 0.9 (Jakob, Tarini, Panozzo and Sorkine-Hornung, 2015): faster on small models but with many more poles, and its result is extracted at twice "},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"quad-remesh-guides","h":"Quad Remesh Guides","t":"Draw curves on the sculpt and Quad Remesh puts an edge loop along each one, and turns the flow around it to follow, like quad remesh Guides brush. With Quad Remesh 2 an open curve is an exact edge loop: the grid line lies on it. Closed loops (round an eye) and loops across the symmetry plane are, for now, done by the legacy method for that piece (the status line says so). 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: Quad Remesh on its own. Middle: loops drawn round the eyes and the mouth with Quad Remesh Guides. Right: Quad Remesh again, with an edge loop on every curve and rings around them Click Quad Remesh Guides under Tool > Geometry > Quad Remesh (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 Quad Remesh. 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 Part: each Part 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 Quad Remesh put on them. Drawing and deleting guides isn't part of undo (Ctrl+Z undoes your sculpting as before). Good to know: Quad Remesh 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 Part 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 Quad Remesh'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 Quad Remesh remeshes one half, so a loop across the middle is cut there: its corners start on the seam, where it meets its mirror image. Quad Remesh 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":"project-detail","h":"Project Detail","t":"Tool > Parts > Project > Project Detail projects every other visible Part 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 Project Detail Projects the visible Parts onto the active one (one undo step) Dist How far to search, as a fraction of the Part'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) 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) Vertex Paint Project the vertex paint (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. Project Detail 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, Project Detail, divide again, Project Detail. 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 method (v2, the default, or legacy), quality (report poles, corner angles and the distance to the sculpt, default true), target (16 to 2,000,000, default 5000), adaptive (0-1, default 0.5), keep_groups, detect_edges (default true), use_vertexpaint, 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 (legacy method only; Quad Remesh 2 has no random start), keep_texture (default true), guides (follow the Part's Quad Remesh 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), vertexpaint (default true), source (one Part'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; part_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 Quad Remesh Parts: show, hide and duplicate the original Face Groups and visibility: guides for Keep Groups Projects: Quad Remesh Guides are saved with each Part 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 choose otherwise, Quad Remeshes it into clean quads with one subdivision level that holds the detail, ready to sculpt and subdivide. 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."},{"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 Mesh > Generate 3D 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). Choose Remesh and its Resolution (96 to 400, default 256; higher keeps more detail): Quad Remesh (the default): clean, all-quad topology of about resolutionΒ² / 2 quads (32768 at 256), then one subdivision level projected onto the model so the detail survives. Generated meshes often have holes and overlapping pieces, so a voxel pass cleans the mesh up first. Step down to the quad cage with Shift+D. Voxel remesh: one even, watertight triangle surface. Faster (about a second). Off (raw mesh): the model exactly as the service made it. Leave Remove flat background on (the default) to drop the flat plane a picture's background often becomes: a thin wall behind or a ground under the subject that covers most of the model's bounds. A relief or a coin on its own is kept. The status line says when a plane was removed; Undo brings it back (with Remesh on, the first Undo steps back to the raw mesh, the second brings the plane back). 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 size before and after remeshing, for example \"Generated model imported (47214 tris, remeshed to 133540 quads (2 subdivision levels)) - ready to sculpt\". Quad Remesh takes about 10 to 25 seconds after the model arrives (a 47,000-triangle Hunyuan3D head took 22 s on a busy 10-core computer); the progress bar shows it and the window stays usable."},{"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 Rodin 2.5 (Hyper3D) when it is the chosen Model (Rodin 2.5 or Rodin 2.5 Fast), otherwise Hunyuan3D 3.1 Rapid (Tencent) Meshy Meshy's own text-to-3D model Hyper3D Rodin (direct) Rodin Gen-2.5 at the chosen Tier 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, no token needed TRELLIS.2 (Microsoft) Best detail, MIT licence. Needs a free 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 If you never picked a model, SculptForge uses the default, so updates that change it reach you; a model you pick (and save) is kept. If you pick TRELLIS.2 without a token, Hunyuan3D 2.1 runs instead and the status line says \"TRELLIS.2 needs a free Hugging Face token (Edit > Preferences > AI); used Hunyuan3D 2.1 instead.\" The Hunyuan3D models' licence doesn't cover use in the European Union, the United Kingdom or South Korea. The first time a Hunyuan3D model runs, a notice says so, and it stays in the Model picker's tooltip. See AI services for each model's licence. 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 Edit > Preferences > AI (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 (free token), 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-meshy-and-hyper3d-paid","h":"fal.ai, Meshy and Hyper3D (paid)","t":"fal.ai: choose a Model (TRELLIS.2, Hunyuan3D 3.1 Pro, Hunyuan3D 3.1 Rapid, Meshy 6, Rodin 2.5 or Rodin 2.5 Fast) or type any fal model id into Model id. Rodin 2.5 (Hyper3D) works from an image or a description; SculptForge asks it for the shape only (GLB, no materials). Rodin 2.5 Fast is cheaper and low poly (up to about 20K triangles), fine as a blockout before remeshing. 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. Hyper3D Rodin (direct): Rodin Gen-2.5 on Hyper3D's own service, from an image or a description. Choose a Tier (Extreme Low is the fastest; Extreme High costs more credits) and paste your key from the API dashboard at hyper3d.ai into API key, then Save settings: the key goes into the system keychain. It stays off until you add a key. Your image or description goes to Hyper3D (api.hyper3d.com) and nowhere else, and SculptForge asks for the shape only (GLB, no materials). Basic API access (Creator plans) covers Extreme Low and Low; the other tiers need Full access. 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 Mesh > Generate 3D 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 bar along the top (the triangle count). If the detail is too soft, divide once more (Ctrl+D), or generate again with a higher Resolution. Tool > Remesh has Quad Remesh (first) and Voxel Remesh for another pass. Turn on X symmetry if the subject is symmetrical, and sculpt the forms with Clay Block, Move and Sharp Crease (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, no token (Hunyuan3D 2.1 on Hugging Face, the default) sculptforge-cli -c 'image_to_3d path=hero.png; export_glb path=hero.glb' # TRELLIS.2, best detail, with a free Hugging Face token (without one, Hunyuan3D 2.1 runs and says so) HF_TOKEN=hf_... sculptforge-cli -c 'image_to_3d path=hero.png model=trellis-2; export_glb path=hero.glb' # keep a flat background plane the service made (removed by default; remove_flat_background does it later) sculptforge-cli -c 'image_to_3d path=hero.png remove_background=false; export_glb path=hero.glb' # voxel remesh instead of the default Quad Remesh sculptforge-cli -c 'image_to_3d path=hero.png remesh=voxel; 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 (quad, the default; voxel; false), resolution (64 to 512, default 256), levels (quad: 0 to 2 subdivision levels, default 1) text_to_3d prompt (required), service (huggingface, fal, meshy, comfyui), model, workflow, url, seed, remesh, resolution, levels 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":"Your art is never uploaded or used for training. AI features run only when you use them and can be turned off. Off (Edit > Preferences > AI, or SF_AI=off) hides Generate 3D; Relief, Inflate and Stamp stay. See Turning AI off. 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: Quad Remesh and 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 Gaussian splat capture made from the lion, with the mesh hidden and the Splats button on the right shelf 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 Library Splats tab. The splats load next to your sculpt: the current mesh stays, and the capture is drawn around it as a reference. Render > Gaussian Splats 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 Block 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 Render > Gaussian Splats) turns the capture into a clean Part you can sculpt and animate: a watertight surface without floaters, quad topology with loops round the eyes and mouth when it is a head, and the capture'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 Render > Gaussian Splats when no splats are loaded, or from the command palette) covers the visible Parts with flat, oriented splats with soft clay shading baked in. Use it to show a sculpt in splat viewers, web scenes or engines that render 3D Gaussian splats. It replaces any loaded splats. 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 Render > Gaussian Splats, 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 Render > Gaussian Splats 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 Part with quads, face loops and colour (details) detail (default 256), preset (game, film, sculpt), color (vertex paint, 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 Parts 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 Render > Gaussian Splats (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 Render > Gaussian Splats 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 Library, 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 Render > Gaussian Splats 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 Part 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 vertex paint 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 Render > Gaussian Splats, under From scan, click Make sculptable. A progress bar and Cancel show while it works. When it's done: a new Part named after the capture holds the sculptable mesh, and is active; a hidden \" Scan\" Part 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 Render > Gaussian Splats brings them back); an untouched starting sphere is hidden too. No capture at hand? Try a test head in Render > Gaussian Splats (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 Render > Gaussian Splats"},{"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 Quad Remesh 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 Vertex Paint / Texture Where the capture's colours go: the vertices (vertex paint), 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\" Part, to Project Detail 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 Quad Remesh Guides for Quad Remesh 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 Quad Remesh's symmetry on, so both halves get the same edge flow. The guides stay on the result Part, so you can Quad Remesh it again at another density (Geometry > Quad Remesh) 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\" Part 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. Quad Remesh 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 Project Detail 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 Part: 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 Quad Remesh 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 vertex paint 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 (vertex paint, 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 Part (or takes landmarks) and replaces its Quad Remesh 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: Quad Remesh, Quad Remesh Guides and Project Detail 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 Library'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, TCP for the page and UDP for the direct link that AR on Android and face capture use, for example with ufw: sudo ufw allow from 10.0.0.0/24 to any port 8765 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-port=8765/udp (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 Mesh > Generate 3D > 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 Part 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 Part 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 vertex paint 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 an AR page on sculptforge.app in Chrome. Your sculpt comes to it encrypted through SculptForge's relay (the key is only in the link; the copy is deleted after 10 minutes), so it works even if Chrome can't reach your computer; without internet it comes straight over Wi-Fi. When your sculpt shows on the page, tap View in your room and then Open Google's AR viewer: this puts a readable copy on the relay (deleted after 10 minutes), because Google's viewer only loads models from the internet. Or tap Place it with Chrome's AR instead. Either way, use a well-lit room and move the phone slowly over a table or the floor until the model appears. AR needs Google Play Services for AR: if even other websites' AR opens and closes at once, update it, or clear its storage and restart the phone. Firefox can't show AR: if the capture page is open in Firefox, the AR page offers Open in Chrome. 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. On iPhone, tap View in AR again to see the change; Android's AR page updates by itself. 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 Part (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 Library 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 Parts with the detail. They stay as they are. A low-poly Part with UVs, in the same place as the high-poly. It can come from another app (import it with Tool > Parts > 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 Part, 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 Part and open Tool > Bake in the right tray. The first line says which Part the maps go onto, or \"No UVs\" if it needs Auto UV first. Source: leave All visible Parts to bake from everything that is shown (except the low-poly), or pick one Part. 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 > Parts, 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 / world) _normal_object.png The high-poly's normals in model space (Parts have no transform of their own, so this is also the world normal). 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 vertex paint, or its painted texture Curvature _curvature.png How the surface bends: mid-grey flat, brighter on convex edges and ridges, darker in creases. A bend of the curvature radius (2% of the model's size by default) is fully bright or dark. Drives edge wear Thickness _thickness.png How far rays travel through the high-poly before leaving it: dark where it is thin (ears, fins, blades). Drives translucency Position _position.png (16-bit) Each point's place in the bounding box, as red, green and blue. Drives gradients and noise without UV seams ID _id.png A flat colour per face group (or per Part, id=parts), to pick areas in other programs is the low-poly Part's name. Colour is skipped when the source has neither vertex paint nor a texture. Tool > Bake with the Part's own top subdivision level as the source and the Mesh Maps ticked"},{"p":"baking.html","c":"Baking normal and displacement maps","a":"bake-from-the-parts-own-levels","h":"Bake from the Part's own levels","t":"A Part with subdivision levels can bake its sculpted detail onto itself: choose Own top subdivision level as the Source, and the top level is baked onto the lowest level's UVs (give the lowest level UVs first). A Part with a micro level offers Own micro level, baked onto its base. No second Part, no matching: the levels share their UVs."},{"p":"baking.html","c":"Baking normal and displacement maps","a":"udim-tiles","h":"UDIM tiles","t":"When the low-poly's UVs go beyond the 0..1 square (UDIM tiles, for example from the UV Editor), every tile bakes as its own set of maps: _normal.1001.png, _normal.1002.png, ... (1001 + u + 10 v, the usual numbering). The same maps, baked on the texture's own UVs, feed Fill layers inside SculptForge."},{"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 Part, or every visible Part 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). Other bakers 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 Parts 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 Part 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 Bridge."},{"p":"baking.html","c":"Baking normal and displacement maps","a":"commands","h":"Commands","t":"Command What it does bake Bake onto the active Part and write the maps. Options: source=all, a Part name, subdivision or micro, maps=normal,object_normal,displacement,ao,cavity,color,curvature,thickness,position,id (or all), udim=true, thickness_rays=24, thickness_distance=0.1, curvature_radius=0.02, id=facegroups or parts, 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: part_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 Bridge","a":"","h":"Exporting, Unreal and Bridge","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 another sculpting application through the Bridge. To keep everything (Parts, layers, mask, vertex paint, brushes) use a project file instead; see Projects, autosave and snapshots."},{"p":"exporting.html","c":"Exporting, Unreal and Bridge","a":"export-formats-at-a-glance","h":"Export formats at a glance","t":"Exports write every visible Part. Hidden Parts 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 Part, sculpt layers as morph targets, vertex paint 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 Part, quads, layers as UsdSkel blend shapes, vertex paint 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 Part, quads, face groups as g groups, vertex paint 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 Bridge file File > Bridge > Export Bridge file... Quads, face groups, mask, vertex paint, UVs, the painted texture as a PNG beside it The Bridge STL (.stl) File > Bridge > Export STL... Geometry only (triangles), visible Parts merged, in millimetres with Z up 3D printing PLY (.ply) export_ply command Geometry, quads and vertex paint, visible Parts merged Scan tools, MeshLab, Blender FBX (general) export_fbx command One model per Part, 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 Bridge files, in and out. A Part with a painted texture is exported with it: the PNG is written next to the file as _color.png (__color.png with several Parts) 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 Bridge","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). USD files in other units (metersPerUnit, e.g. centimetres from Maya or Houdini) open at their real size. For Unreal, Height sets the real-world size directly (see below)."},{"p":"exporting.html","c":"Exporting, Unreal and Bridge","a":"real-world-size-and-units","h":"Real-world size and units","t":"A part keeps the size it was opened with through every export: OBJ, PLY and STL have no units. A scene opened from one of them remembers its unit: exporting OBJ or PLY writes that unit back (an STL opened in millimetres exports a 50 mm OBJ, not 0.05), and an STL written from an STL keeps its numbers. Decimal sizes come back exactly (12.7 stays 12.7). Projects remember the unit. Edit > Preferences > Interface > OBJ/PLY in says what OBJ and PLY numbers mean: m (the default; Blender and game tools), or mm for files made for 3D printing, cm or in. STL is always read as millimetres. From scripts: open path=part.obj unit=mm (open_obj and part_append take unit= too; unit=in reads an inch STL). Edit > Preferences > Interface > Units picks the unit sizes show in: mm, cm, m or in. The active Part's width x height x depth shows under its name in Tool, the size the exports write in File (Import / Export), and the brush size by the brush ring."},{"p":"exporting.html","c":"Exporting, Unreal and Bridge","a":"export-a-model","h":"Export a model","t":"Show the Parts you want to export and hide the others (the eye icon in Tool > Parts). Choose the export in the File palette and pick a file name. The status line confirms the export (\"Exported ...\"). A Part 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 Bridge","a":"3d-printing","h":"3D printing","t":"File > Bridge > Export STL... writes every visible Part 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 Parts go into the file as they are, which some slicers and print services reject. Merge visible them (Parts) 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 Bridge","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 Parts, each Part 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 Bridge","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 Parts One FBX model per Part, 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) A texture with material channels T__BC, T__N (DirectX) and T__ORM (occlusion, roughness, metallic), plus T__E when emissive is painted, and a material M_ built from them and assigned to the mesh (Unreal on this computer only; see Export presets) 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 Bridge","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 Bridge","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 Bridge","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 Bridge","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 Bridge","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 Bridge","a":"exchange-models-through-the-bridge","h":"Exchange models through the Bridge","t":"The Bridge exchanges Parts with another sculpting application through a shared bridge folder, the way that application's own exchange plug-in does, on Windows and macOS. The commands are in File > Bridge: Item What it does Send Writes every visible Part to the bridge folder and tells the other application (starting it if needed). Each Part arrives as its own object. Turns on Receive automatically Receive Loads what the other application last sent. Each object updates the Part it was sent from (one undo step), or becomes a new Part Receive automatically Checks once a second for a new send and receives it Custom bridge folder (optional) Use another bridge folder, for example inside a Wine prefix Import Bridge file... Opens a Bridge file, replacing the scene Export Bridge file... Writes a Bridge file. With several visible Parts, one file per Part next to the path Export STL... Writes a binary STL of the visible Parts On Windows and macOS the Bridge finds the shared exchange folder by itself; nothing to install. On Linux it needs a custom folder; Bridge files still import and export."},{"p":"exporting.html","c":"Exporting, Unreal and Bridge","a":"a-round-trip","h":"A round trip","t":"In SculptForge, choose File > Bridge > Send. The other application starts or comes forward with the Parts. If it was not running and does not import them, use its own import from the bridge. Work there, then send the model back with its exchange plug-in. SculptForge receives it automatically and updates the matching Parts. Each update is an undo step on that Part. The Bridge keeps face groups, mask, vertex paint and UVs. Quads stay quads both ways: Wire shows them as quads. The format has no hidden-face flag, so hidden faces are sent like any others. Note: the Bridge is tested with files, not yet against every version of a live application. If a send does not arrive, export a Bridge file and import it by hand, and please report it (Help > Report a problem). From scripts: bridge_export path=, bridge_import path=, bridge_send, bridge_receive and export_stl path= (see 3D printing for its options)."},{"p":"exporting.html","c":"Exporting, Unreal and Bridge","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 Parts, UVs and quads both ways."},{"p":"exporting.html","c":"Exporting, Unreal and Bridge","a":"maya","h":"Maya","t":"To sculpt Maya meshes in SculptForge and send them back into the same objects, use the SculptForge shelf for Maya and File > Maya: see Working with Maya."},{"p":"exporting.html","c":"Exporting, Unreal and Bridge","a":"see-also","h":"See also","t":"Working with Blender: the Blender add-on Working with Maya: the Maya shelf script Projects, autosave and snapshots: save everything, not just the mesh Parts: which Parts 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":"export-presets.html","c":"Export presets","a":"","h":"Export presets","t":"Export Maps writes a texture's channels (Material painting) as the image files a game engine or DCC expects: which files, what they are called and how channels are packed into them come from an export preset. SculptForge has presets for the common targets, and you can write your own as a small JSON file."},{"p":"export-presets.html","c":"Export presets","a":"export-maps","h":"Export maps","t":"Open Tool > Texture Map. Under Material Channels, choose a preset in the list next to Export Maps... (hover a preset for what it writes). Click Export Maps... and pick a folder. The files are named after the Part. From a script or the console: export_maps preset=unreal folder=/path/to/maps name=Rock. export_maps list=true lists the presets and their maps. Channels you haven't turned on export their default value (roughness 0.65, metallic 0, flat normal, AO 1), so a preset always writes a complete set. Maps marked optional below are written only when one of their channels is on."},{"p":"export-presets.html","c":"Export presets","a":"built-in-presets","h":"Built-in presets","t":"Preset Files (for a Part called Rock) Normal unreal T_Rock_BC (base colour; opacity in alpha when painted), T_Rock_N, T_Rock_ORM (R occlusion, G roughness, B metallic); optional T_Rock_E (emissive), T_Rock_H (16-bit height) DirectX unity_urp Rock_BaseMap, Rock_Normal, Rock_MetallicSmoothness (R metallic, A smoothness = 1 - roughness); optional Rock_Occlusion, Rock_Emission, Rock_Height OpenGL unity_hdrp Rock_BaseMap, Rock_Normal, Rock_MaskMap (R metallic, G occlusion, B detail mask = white, A smoothness); optional Rock_Emission, Rock_Height OpenGL gltf Rock_baseColor, Rock_normal, Rock_occlusionRoughnessMetallic (R, G, B as glTF expects); optional Rock_emissive OpenGL godot Rock_albedo, Rock_normal, Rock_orm; optional Rock_emission, Rock_height OpenGL blender One file per channel: Rock_BaseColor, Rock_Roughness, Rock_Metallic, Rock_Normal; optional Rock_Height (16-bit), Rock_AO, Rock_Emission, Rock_Alpha OpenGL usd One file per UsdPreviewSurface input: Rock_diffuseColor, Rock_roughness, Rock_metallic, Rock_normal; optional Rock_occlusion, Rock_emissiveColor, Rock_opacity, Rock_displacement OpenGL All files are PNG at the texture's size: 8-bit, except height maps, which are 16-bit greyscale. The normal map is the effective normal: the Normal channel with the height's normal combined in. DirectX presets flip green. Send to Unreal (Exporting) uses the unreal preset and then builds a material M_ in Unreal from the maps: BC to Base Color, ORM's R / G / B to Ambient Occlusion, Roughness and Metallic, N to Normal, E to Emissive. It is an ordinary Unreal material you can edit."},{"p":"export-presets.html","c":"Export presets","a":"material-slots-in-model-files","h":"Material slots in model files","t":"You don't need Export Maps to get the material into a model file: when the texture has material channels, exporting a model writes the maps beside it (or inside it) and wires them into its material. Format What the material gets glTF / GLB Base colour (alpha from opacity, alphaMode BLEND), metallicRoughnessTexture and occlusionTexture from one packed map, normalTexture, emissiveTexture USD / USDZ A UsdPreviewSurface whose roughness, metallic, normal, occlusion, emissiveColor and opacity inputs each read their own map (raw colour space; the normal with scale 2, bias -1) OBJ The MTL's PBR keys: map_Pr (roughness), map_Pm (metallic), norm / map_Bump (normal), map_Ke (emission), map_d (opacity) FBX Textures on the material's NormalMap, ShininessExponent (roughness), ReflectionFactor (metallic), EmissiveColor and TransparencyFactor, as Blender reads them A texture without material channels exports exactly as before: just the colour."},{"p":"export-presets.html","c":"Export presets","a":"your-own-presets","h":"Your own presets","t":"A preset is a JSON file. Point export_maps preset= at it: { \"label\": \"Studio packed\", \"file\": \"{name}_{map}\", \"normal\": \"directx\", \"maps\": [ {\"map\": \"albedo\", \"channels\": [\"base_color.r\", \"base_color.g\", \"base_color.b\", \"opacity?\"]}, {\"map\": \"rma\", \"channels\": [\"roughness\", \"metallic\", \"ao\"]}, {\"map\": \"nrm\", \"channels\": [\"normal.r\", \"normal.g\", \"normal.b\"]}, {\"map\": \"disp\", \"channels\": [\"height\"], \"bits\": 16, \"optional\": true} ] } file: the file name pattern; {name} is the object name, {map} the map's name (required). .png is added. normal: opengl (green up, the default) or directx (green down). maps: 1 to 32 maps. Each has a map name (letters, digits, - and _) and 1 (grey), 3 (RGB) or 4 (RGBA) channels. A channel source is a channel name (roughness, metallic, ao, height, opacity), a component (base_color.r, normal.g, emissive.b), smoothness (1 - roughness), a constant (0, 1, 0.5) or 1- in front of any of them to invert it. A ? after a source drops that component when its channel isn't on (an RGBA map becomes RGB). optional: write the map only when one of its channels is on. bits: 8 (default) or 16. A preset with a mistake is refused with a message saying what is wrong."},{"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 through files in a shared folder, 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 Part 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 Part 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 Part you added in SculptForge becomes a new object. Sending again from Blender updates the same Parts: each update is one undo step on that Part 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 Part, placed in the scene with the object's transform Faces Triangles and quads; n-gons as triangle fans Triangles and quads (Wire shows the quads) UVs The active UV map UVs Colour The active colour attribute (point or face corner) Vertex Paint Mask The sculpt mask Mask Face sets Sculpt mode face sets Face Groups Name Object name Part 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, Quad Remesh, 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":"classic-sculpting-keys-in-sculpt-mode","h":"Classic sculpting keys in Sculpt Mode","t":"Sculpting in Blender too? Turn on The Classic sculpting keys in Sculpt Mode in the add-on's preferences (Edit > Preferences > Add-ons > SculptForge Bridge) and Blender's Sculpt Mode answers to the Classic sculpting 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. Classic key In Blender's Sculpt Mode S / U / O Size / Intensity (Strength) / Falloff (Hardness), dragged at the cursor Space Blender's Sculpt quick menu at the cursor (brush, size, strength) B The brush list by name (Standard, Sharp Crease, Clay, Clay Block, Move, Tendril...): type a few letters, Enter picks Alt+drag Sub: 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 Wireframe (the wireframe overlay) F / P Frame the model / perspective on and off L Steady Stroke (Blender: Stabilize Stroke) W / E / R Move / Scale / Rotate Shift+drag Smooth (Blender already does this) brushes map to Blender's closest: Standard = Draw, Sharp Crease = Draw Sharp, Clay Block = Clay Strips, Move = Grab, Move Elastic = Elastic Grab, Plane Trim = Trim (Scrape in Blender 4.2), Crease = Crease Sharp, MaskPen = Mask. What Blender has no key for, or can't do: I (Colour 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 lasso mask (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 Part: Blender's objects aren't Parts (Alt+Q switches the object you sculpt). Stroke types (Drag Stamp, 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 Sculpt > 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 Bridge files 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 Bridge files). 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 Bridge: files, game engines and Bridge Parts: each Blender object is a Part Face Groups and visibility: Blender's face sets"},{"p":"maya.html","c":"Working with Maya","a":"","h":"Working with Maya","t":"Keep Maya for the scene, rigging and animation, and sculpt in SculptForge: the SculptForge shelf for Maya sends the selected meshes to SculptForge, and File > Maya > Send to Maya sends them back, replacing each Maya object's mesh by name. It works through files in a shared folder, on Linux, Windows and macOS. The two apps exchange files through one folder that you choose in both, and nothing else: SculptForge opens no ports or connections for this, reads and writes only inside that folder, and never runs anything it finds there. The bridge is off until you choose the folder. Live keeps the two in step by themselves, still through the folder; the opt-in Live link lets Maya follow a stroke while you draw it."},{"p":"maya.html","c":"Working with Maya","a":"install-the-shelf-in-maya","h":"Install the shelf in Maya","t":"Download sculptforge_maya.zip from the latest release and unzip it. Copy sculptforge_maya.py into your Maya scripts folder: Documents\\maya\\scripts\\ on Windows, ~/Library/Preferences/Autodesk/maya/scripts/ on macOS, ~/maya/scripts/ on Linux. In Maya open the Script Editor, and in a Python tab run import sculptforge_maya and then sculptforge_maya.install_shelf(). A SculptForge shelf appears with Send, Get, Auto, Live, Link and Folder. (Updating from an older shelf: copy the new file and run install_shelf() again.) The script uses plain maya.cmds, Maya's own OBJ exporter and, for Live, maya.api.OpenMaya (all from your own Maya: nothing of Maya's ships with SculptForge); it needs Maya 2022 or newer."},{"p":"maya.html","c":"Working with Maya","a":"choose-the-exchange-folder","h":"Choose the exchange folder","t":"In SculptForge choose File > Maya > Exchange folder... and pick a folder of your own, for example an empty Documents/SculptForge Maya. In Maya click Folder on the SculptForge shelf and pick the same folder. File > Maya shows the folder; Turn the Maya bridge off forgets it (nothing in it is deleted). While the bridge is on, the top bar has a Send to Maya button."},{"p":"maya.html","c":"Working with Maya","a":"a-round-trip","h":"A round trip","t":"In Maya select one or more meshes and click Send on the SculptForge shelf. SculptForge loads them by itself. Each mesh becomes a Part with its Maya name; a Part with that name already there is replaced (one undo step on that Part). Sculpt, paint, divide, remesh: anything SculptForge does. Click Send to Maya in the top bar (or File > Maya > Send to Maya). Every visible Part goes. Maya loads them by itself. Each object that came from Maya gets the new mesh and keeps its transform, parent and shading groups; a Part you added in SculptForge becomes a new object. The whole Get is one undo step in Maya. Both sides pick up a send by checking the other side's manifest every 250 ms (its modification time and size only), and only for sends made after the bridge started: something sent earlier waits for a manual Get. In SculptForge, File > Maya > Get automatically is on once you choose the folder; turn it off to load only with Get from Maya. In Maya, Auto on the shelf is on by default and starts with the first Send, Get or Folder click in a Maya session; click it to switch to Manual, where only Get loads."},{"p":"maya.html","c":"Working with Maya","a":"live","h":"Live","t":"With Live on, you don't click Send at all: each app sends what you change by itself, and the other loads it. In SculptForge, turn on File > Maya > Live. After each stroke (once you pause for 300 ms, never in the middle of one), the Parts that stroke, an undo or any other edit changed go to the folder. Parts you didn't touch stay put, so a big scene with one Part being sculpted sends only that Part. The files are written in the background while you keep sculpting. In Maya, click Live on the shelf (it turns Auto on too). The meshes you sent or got, and the ones selected when you turned it on, are watched; 300 ms after you stop editing one, it goes to SculptForge. Neither app sends back what it just loaded: a Get is never an edit to send, each manifest says which app session wrote it, and SculptForge skips an object that comes back exactly as it went out (no extra undo step). Live is off until you turn it on, on each side, and stays as you left it."},{"p":"maya.html","c":"Working with Maya","a":"live-link","h":"Live link","t":"The Live link goes further: Maya follows your stroke while you draw it. It's a connection between the two apps on this computer, so it is off until you turn it on, asks first every time, and is off again whenever SculptForge starts. In SculptForge choose File > Maya > Live link.... A warning explains what it opens: It opens a connection on this computer. Anything running on this computer that knows the pairing code could send meshes into SculptForge. It carries meshes only: never commands, files or scripts. Other computers and web pages can't reach it. Turn it off when you're not using it: click \"Live link on\" in the top bar. It is off again every time SculptForge starts. Click Turn on. An ember Live link on chip appears in the top bar. Choose File > Maya > Copy pairing code. In Maya click Link on the SculptForge shelf, paste, and click Link. The button says Linked, and SculptForge sends Maya every visible Part, so both start from the same mesh. Now sculpt: about ten times a second, the vertices your stroke moves appear in Maya. When a stroke changes the faces (dynamic topology, remesh, divide), the whole Part goes when the stroke ends. Edit a mesh in Maya and SculptForge gets it as soon as you pause (one undo step there). Updates that arrive in Maya over the link aren't Maya undo steps: undo in SculptForge, and Maya follows. To turn it off, click Live link on in SculptForge's top bar (or File > Maya > Turn the Live link off), or click Linked in Maya. Quitting SculptForge turns it off too. How it is kept safe: No network port. It is a Unix domain socket in a folder only you can open (Linux, macOS) or a named pipe only your Windows account can open, remote clients refused. Web pages, other people on the machine and other computers can't reach it. A pairing code (128 random bits, new each time you turn it on) must open every connection; one Maya at a time. Meshes only. Object names, vertices, faces and UVs, checked strictly on arrival (sizes, ranges, finite numbers, Maya names). Nothing that arrives is run, and it never names a file. Studios can forbid it with \"maya\": {\"link\": \"never\"} in the studio policy."},{"p":"maya.html","c":"Working with Maya","a":"what-comes-across","h":"What comes across","t":" Maya SculptForge Shape The mesh, in world space The Part, as placed in Maya's scene Faces Quads and triangles; n-gons as triangles Triangles and quads (Wire shows the quads) UVs The current UV set UVs Name The transform's name Part name Units Maya's linear unit (cm by default) Taken as they are: 1 cm in Maya is 1 unit here Face Groups, the mask and vertex paint stay in SculptForge. Normals, creases, construction history, deformers and skinning stay in Maya: Get replaces the mesh shape, so send a copy of a skinned or deformed mesh. A Part named \"Body Hi\" arrives in Maya as Body_Hi (Maya names allow letters, digits and _), and comes back to the same Part."},{"p":"maya.html","c":"Working with Maya","a":"the-exchange-folder","h":"The exchange folder","t":"<folder>/maya_to_sculptforge/manifest.json + r<revision>_<k>.obj written by Maya <folder>/sculptforge_to_maya/manifest.json + r<revision>_<k>.obj written by SculptForge Each manifest is a small JSON file: {\"format\": \"sculptforge-maya\", \"version\": 1, \"revision\": 3, \"sender\": \"maya\", \"unit\": \"cm\", \"objects\": [{\"name\": \"pCube1\", \"file\": \"r3_000.obj\"}]}. Both sides check it strictly before reading anything: at most 256 KiB and 256 objects, every field of the right type, and each file must be a plain .obj name in the manifest's own folder (no folders, no .., no absolute paths, no links). Each send removes the files of the previous one; anything else in the folder is left alone. The commands are maya_send folder= and maya_receive folder= (see Scripting and automation)."},{"p":"maya.html","c":"Working with Maya","a":"troubleshooting","h":"Troubleshooting","t":"\"Nothing has been sent from Maya yet\": check that both apps use the same folder (open File > Maya in SculptForge; click Folder in Maya to see or change it). Get in Maya says nothing has been sent: choose File > Maya > Send to Maya in SculptForge first. Maya doesn't load a send by itself: Auto starts with the first click on the shelf in a Maya session; click Get once (or Send), and check that the button says Auto, not Manual. Live doesn't send from Maya: Live watches the meshes you sent or got and the ones selected when you turned it on; send a new mesh once with Send, and it is watched from then on. Link says SculptForge refused the pairing code: the code is new each time the Live link is turned on; copy it again (File > Maya > Copy pairing code). Link says SculptForge isn't offering it: turn on File > Maya > Live link... in SculptForge first (it is off at every start). A mesh came in as a new object instead of replacing one: Get matches the transform's name; renaming the object in Maya or the Part's Maya name breaks the link."},{"p":"projects.html","c":"Projects, autosave and snapshots","a":"","h":"Projects, autosave and snapshots","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, snapshots, and the Library tabs that show your work."},{"p":"projects.html","c":"Projects, autosave and snapshots","a":"what-a-project-keeps","h":"What a project keeps","t":"A .sfproj file holds everything SculptForge knows about the scene: every Part, with its name, visibility, mesh, mask, vertex paint, face groups, hidden faces and UVs; every sculpt layer with its weight, and the active layer of each Part; each Part's Quad Remesh Guides, the curves Quad Remesh'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, Size, Intensity (and Smooth's), Colour intensity, Falloff, paint colour and symmetry; a thumbnail, shown in the Library. 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."},{"p":"projects.html","c":"Projects, autosave and snapshots","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. In the Classic layout, clicking the document name in the title strip also saves. The bar along the top shows the file name with * after it while there are unsaved changes, and so does the window title, which starts with the file name. Any edit in any Part counts, as do splat edits and layer weight changes. The window title and the top bar also show the SculptForge version, so a screenshot says which one you run. 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 snapshots","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 Library, 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 snapshots","a":"start-from-a-starter-mesh","h":"Start from a starter mesh","t":"Instead of a sphere, start from a base mesh with clean, even quads: File > New from Starter Mesh lists them, the Library's Tool tab has a Starter meshes folder with a thumbnail of each, and the welcome's Start from a head opens the human head straight away. Starter mesh What it is Human Head A neutral head and neck with loops round the eyes and mouth, for portraits Bust Head, neck, shoulders and upper chest Full Body A human figure in A-pose, 167 cm tall Hand, Foot, Ear A left hand (raised, palm to the front), a left foot and ankle, a left ear Eye An eyeball 24 mm across, with the cornea and rings of quads round the pupil Stylised Head A cartoon head: big cranium and eyes, small nose and jaw Creature Head A dragon or creature blockout: skull, jaw and two horns, each its own Part Torso A human torso from the neck to the upper thighs Rounded Box, Cylinder, Capsule, Ring Hard-surface primitives with bevelled edges and quad caps Every starter mesh is life size in centimetres, centred, standing on the ground and looking down +Z, and the symmetric ones are exactly symmetric, so X symmetry works from the first stroke. The Hand, Foot, Ear, Head, Bust and Torso are cut from a body, so they have open edges where they were cut. A starter mesh opens with subdivision levels (two, or one for the Full Body): block out the big forms at SDiv 1, the base cage, and step up for the detail (see Geometry). It opens as a new, unsaved scene: Save asks for a name. Double-click a tile to open it; Shift+double-click appends its base cage as a Part, for example an Eye next to a head. The human meshes come from the MakeHuman base mesh, which MakeHuman released into the public domain (CC0); the others are made by SculptForge's own build script. You may use them for anything, including commercial work."},{"p":"projects.html","c":"Projects, autosave and snapshots","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 snapshots","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 Edit > 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 Library Snapshots 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 snapshots","a":"snapshots","h":"Snapshots","t":"File > Save Snapshot (also the Snapshot button in the Classic layout's title strip) saves a timestamped copy of the whole scene (experienced sculptors: QuickSave). Your project file, its name and its unsaved state are not changed, so a snapshot is safe to take before any risky step. Copies go to the QuickSave folder of your library (by default Documents/SculptForge/QuickSave), named like Snapshot 2026-10-21 23-15-04.sfproj (older QuickSave ... files are listed too). The last 10 snapshots are kept; older ones are deleted. They appear in the Library Snapshots tab, newest first, labelled with their date and time. Double-click one to open it. The tab also has a Save now button. With the Classic sculpting keys (Edit > Preferences > Input) 9 takes a snapshot; otherwise it has no default shortcut. To give it one, hold Ctrl+Alt, click the Snapshot button and press a key (see The interface)."},{"p":"projects.html","c":"Projects, autosave and snapshots","a":"your-library-folder-and-the-library","h":"Your library folder and the Library","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 Library tab What goes there Projects Project Your .sfproj files Tools Tool Models to open or append as Parts Brushes Brush .sfbrush files Alphas Alpha Grayscale images for brush alphas LitSpheres Material Lit Sphere images, loaded as materials at start-up Images Image Sketches and concept art for Generate 3D Splats Splats Gaussian splat captures QuickSave Snapshots Snapshots Change it in Edit > Preferences > Library > Library folder; the setting saves itself. Press , (comma) to show the Library. 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. Snapshots: the autosave (when there is one) and your snapshots, 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 Part instead. The Library showing project thumbnails"},{"p":"projects.html","c":"Projects, autosave and snapshots","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 new_starter_mesh name=human-head Start from a starter mesh (levels=0 for the bare base cage) 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 snapshots","a":"see-also","h":"See also","t":"The interface: Library, shortcuts and saving the layout Parts 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 connecting AI tools."},{"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 File > 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 File > Script): 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 at the top right of the window) 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, Bridge files 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_vertexpaint, symmetry, keep_original Parts project_all distance (default 0.02), mean, blur, geometry, vertexpaint, source Geometry mesh_info Sculpting stroke points (required), brush, radius, strength, invert, symmetry, radial, radial_axis, local 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 Face Groups facegroup_auto_by_normals angle (default 30) Visibility isolate_facegroup, hide_facegroup group (required) Visibility show_all, delete_hidden Transform transform translate, rotate, scale, pivot, orient, masked, falloff, symmetry, all (Gizmo) Parts part_append type (sphere, cube, plane) or path, name, size Parts part_select index or name Vertex Paint set_color, paint_fill color, area (unmasked, masked, all) Vertex Paint 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 Lit Sphere 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, --facegroups Render with the wireframe or face group 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.parts) # [{'name': ..., 'visible': ..., 'triangles': ...}] doc.active_part = \"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 Part (copies) doc.mask, doc.colors, doc.facegroups, 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.parts, doc.active_part The Parts list and the active Part 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":"An AI tool (Claude Code, Claude Desktop, Cursor and others) can work in the SculptForge window while you watch. The AI blocks out a starting point and shows you options; you do the art. Help > Connect an AI tool... is the guide in the app, on one screen; it is there while AI features are on (Edit > Preferences > AI). It says what this section says, in the same words."},{"p":"scripting.html","c":"Scripting and automation","a":"connect-an-ai-tool","h":"Connect an AI tool","t":"1. Pick your tool. The window shows the exact command or settings for your install, with Copy. SculptForge is listed as sculptforge-live and started as sculptforge-cli --mcp --attach, so it sits beside a sculptforge entry you may already have (the headless server, below). Claude Code, in a terminal: claude mcp add --scope user sculptforge-live -- /path/to/sculptforge-cli --mcp --attach Claude Desktop: add this to its configuration file (Settings > Developer > Edit Config), then restart Claude Desktop: { \"mcpServers\": { \"sculptforge-live\": { \"command\": \"/path/to/sculptforge-cli\", \"args\": [\"--mcp\", \"--attach\"] } } } Cursor takes the same entry in ~/.cursor/mcp.json. For every other tool, use its setup from the table in Every other tool with the name sculptforge-live and the arguments --mcp --attach; the window writes it out for you. Where sculptforge-cli is on your system: Where sculptforge-cli is. 2. Let it work in this window. Turn on Let AI tools control this window, right there in the window's step 2 (the same switch as in Edit > Preferences > AI). It is off by default, and gone while AI features are off. 3. What happens next. Ask your AI tool for something (examples below). SculptForge shows Let an AI tool control this window? with a 6-digit code: click Approve, or tell the AI the code. Approval lasts until it disconnects. While it works, the AI connected badge sits at the bottom right. Disconnect stops it (also in the command palette: Disconnect AI tool; turning the switch or AI features off disconnects it too). Every step lands in Undo as AI: ..., so you can step back. It asks you first (Allow this AI step?) before files outside the project, scripts and the network: reading or writing files outside the project folder and the files you picked, overwriting a file, saving over the project, deleting library files, running a macro or script, and anything that uses the network (Generate 3D, AI Brush, the brush gallery). Deny and it is told not to retry. Installing or switching packs and the AI switch itself are never offered. It sees the viewport; what it sees goes to that tool's AI service. viewport_image returns the viewport as you see it, view_turntable the model from 4 to 8 sides in one picture, view_set turns and frames your camera, and stroke_screen draws a brush stroke in screen space. With blockout (a Forge Sphere armature in one call), measure and scene_overview it can look, think and correct. Try asking: \"Block out a creature head with horns for me to sculpt.\" \"Look at my model from all sides and tell me what to fix.\" \"Make three rock variations I can refine.\" \"Teach me: walk me through sculpting an ear, step by step.\" The recipes your AI tool lists as prompts (creature head, stylised bust, game-ready, rock variations, teach me) work here too. How it is kept safe: the connection is a Unix socket (owner-only, in your runtime folder) or, on Windows, a named pipe only your user account can open; there is no network port. Only one AI tool can be connected at a time, requests are rate limited, and what the tool sends is data: tool names and values, never code to run."},{"p":"scripting.html","c":"Scripting and automation","a":"without-a-window-the-headless-server","h":"Without a window: the headless server","t":"sculptforge-cli --mcp runs SculptForge as an MCP server with a scene of its own, no window needed: for batch jobs and your own agents. The AI tool gets every command as a tool and works on that scene for the session: it can open files, generate models, sculpt strokes, remesh, paint and export. It starts sculptforge-cli on your computer and talks to it over standard input and output. Nothing listens on the network, and nothing is installed into the AI tool. The setups below use the name sculptforge and --mcp; the Claude Desktop bundle is this server too."},{"p":"scripting.html","c":"Scripting and automation","a":"i-have-a-subscription","h":"I have a subscription","t":"Subscription Use Set up Claude (Pro, Max, Ultra) Claude Desktop or Claude Code Claude Desktop: install the bundle (below). Claude Code: claude mcp add --scope user sculptforge -- /path/to/sculptforge-cli --mcp ChatGPT (Plus, Pro, Business, Edu, Enterprise) Codex CLI codex mcp add sculptforge -- /path/to/sculptforge-cli --mcp, then Sign in with ChatGPT Google (free, Google AI Pro, Google AI Ultra) Antigravity CLI add SculptForge to ~/.gemini/config/mcp_config.json (below), then sign in with Google Grok / xAI Grok Build grok mcp add sculptforge -- /path/to/sculptforge-cli --mcp Claude: Claude Code uses your plan when you sign in with your Claude account; if ANTHROPIC_API_KEY is set it uses that key and API billing instead. Claude on the web and on phones can't start programs on your computer. ChatGPT: the ChatGPT app only connects to remote (HTTPS) MCP servers. SculptForge doesn't run one, on purpose: nothing of yours listens on the network. Use Codex CLI, or the OpenAI Agents SDK or API below. Gemini: since June 2026 personal Google accounts use Antigravity CLI; Gemini CLI is for Gemini Code Assist Standard and Enterprise and for API keys. Grok: the Grok app (web, phone, X) can't reach programs on your computer, only public HTTPS servers. Grok Build signs in with your xAI account in the browser (xAI's documentation doesn't say which plans that includes) or takes an xAI API key. The xAI API's own MCP tool is remote-only too; your own code can use the function calling example below (API usage is billed by xAI)."},{"p":"scripting.html","c":"Scripting and automation","a":"where-sculptforge-cli-is","h":"Where sculptforge-cli is","t":"Install Command Windows C:\\Program Files\\SculptForge\\bin\\sculptforge-cli.exe --mcp macOS /Applications/SculptForge.app/Contents/MacOS/sculptforge-cli --mcp Linux .deb, .rpm, AUR /usr/bin/sculptforge-cli --mcp AppImage /path/to/SculptForge.AppImage --cli --mcp (--cli runs the CLI inside the AppImage) Flatpak flatpak run --command=sculptforge-cli org.sculptforge.SculptForge --mcp In JSON and TOML files a Windows path is written with doubled backslashes (\"C:\\\\Program Files\\\\SculptForge\\\\bin\\\\sculptforge-cli.exe\"). The window does that for you."},{"p":"scripting.html","c":"Scripting and automation","a":"claude-desktop-bundle","h":"Claude Desktop bundle","t":"Download the bundle for your system, then install it in Claude Desktop under Settings > Extensions > Advanced settings (Anthropic's guide): Windows, macOS, Linux x86_64, Linux ARM64. It carries its own copy of sculptforge-cli. Or add SculptForge to claude_desktop_config.json (Windows %APPDATA%\\Claude\\, macOS ~/Library/Application Support/Claude/, Linux ~/.config/Claude/) and restart: { \"mcpServers\": { \"sculptforge\": { \"command\": \"/path/to/sculptforge-cli\", \"args\": [\"--mcp\"] } } }"},{"p":"scripting.html","c":"Scripting and automation","a":"every-other-tool","h":"Every other tool","t":"Most tools take the same mcpServers entry as Claude Desktop above. Each row links the vendor's page the format is from. Tool Set up Cursor the mcpServers entry in ~/.cursor/mcp.json (or .cursor/mcp.json in a project) VS Code (Copilot agent mode) code --add-mcp '{\"name\":\"sculptforge\",\"type\":\"stdio\",\"command\":\"/path/to/sculptforge-cli\",\"args\":[\"--mcp\"]}', or MCP: Open User Configuration and add \"servers\": {\"sculptforge\": {\"type\": \"stdio\", \"command\": \"...\", \"args\": [\"--mcp\"]}} Visual Studio the same servers entry in %USERPROFILE%\\.mcp.json; Copilot Chat in Agent mode JetBrains AI Assistant Settings > Tools > AI Assistant > Model Context Protocol (MCP): Add, STDIO, paste the mcpServers entry Zed in its settings file (zed: open settings file): \"context_servers\": {\"sculptforge\": {\"command\": \"...\", \"args\": [\"--mcp\"]}} Windsurf (Devin Local) devin mcp add -s user sculptforge -- /path/to/sculptforge-cli --mcp, or the mcpServers entry in ~/.config/devin/mcp_config.json (Windows %APPDATA%\\devin\\) Gemini CLI gemini mcp add --scope user sculptforge /path/to/sculptforge-cli --mcp Antigravity CLI the mcpServers entry in ~/.gemini/config/mcp_config.json Codex CLI codex mcp add ... as above, or in ~/.codex/config.toml: [mcp_servers.sculptforge], command = \"/path/to/sculptforge-cli\", args = [\"--mcp\"] Grok Build grok mcp add ... as above, or the same TOML table in ~/.grok/config.toml GitHub Copilot CLI copilot mcp add sculptforge -- /path/to/sculptforge-cli --mcp Cline cline mcp add sculptforge --yes -- /path/to/sculptforge-cli --mcp, or the mcpServers entry under MCP Servers > Configure Continue a file in .continue/mcpServers/ with mcpServers: - name: SculptForge, type: stdio, command: ..., args: [\"--mcp\"] (agent mode) Kiro the mcpServers entry in ~/.kiro/settings/mcp.json Amazon Q Developer CLI q mcp add --name sculptforge --command /path/to/sculptforge-cli --args '[\"--mcp\"]' Warp Settings > Agents > MCP servers > Add, paste the mcpServers entry Goose goose configure > Add Extension > Command-Line Extension, or in ~/.config/goose/config.yaml under extensions: an entry with type: stdio, cmd: ..., args: [\"--mcp\"] opencode in opencode.json: \"mcp\": {\"sculptforge\": {\"type\": \"local\", \"command\": [\"/path/to/sculptforge-cli\", \"--mcp\"]}} Rovo Dev CLI the mcpServers entry plus \"transport\": \"stdio\" in ~/.rovodev/mcp.json (acli rovodev mcp opens it) LM Studio Program tab > Install > Edit mcp.json, paste the mcpServers entry Jan Settings > MCP Servers > +: command /path/to/sculptforge-cli, arguments --mcp Remote only, so not for SculptForge: the ChatGPT app, the Grok app, and Rovo in Atlassian's web apps (public HTTPS servers added by an admin; use Rovo Dev CLI). The OpenAI and xAI APIs' built-in MCP tools also reach only remote servers: use the Agents SDK or plain function calling below."},{"p":"scripting.html","c":"Scripting and automation","a":"using-it","h":"Using it","t":"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 headless server works on its own scene; to see the result, open the exported file in SculptForge (or use live mode, above, to watch it work). viewport_image gives the agent a picture of the scene (a clay-shaded view of the visible Parts, any angle) to check each step by eye. Every tool call is one undo step, so the agent can take back what went wrong. Recipes: the server offers ready-made prompts that walk an agent through a whole job. In Claude Desktop and other tools that show MCP prompts, pick one from the prompt menu: a creature head from a description, a stylised bust from a reference image, a game-ready asset (retopology, UVs, baked maps and LODs for Unreal or Godot), rock variations, and a step-by-step lesson."},{"p":"scripting.html","c":"Scripting and automation","a":"your-own-agent","h":"Your own agent","t":"The OpenAI Agents SDK starts the server itself: import asyncio from agents import Agent, Runner from agents.mcp import MCPServerStdio async def main(): async with MCPServerStdio(name=\"SculptForge\", client_session_timeout_seconds=60, params={\"command\": \"/path/to/sculptforge-cli\", \"args\": [\"--mcp\"]}) as sf: agent = Agent(name=\"Sculptor\", instructions=\"Use SculptForge's tools.\", mcp_servers=[sf]) print((await Runner.run(agent, \"Make a sphere, remesh it at 128 and export ball.glb\")).final_output) asyncio.run(main()) For plain function calling with any model API, sculptforge-cli --schema prints every tool as JSON (name, description, input_schema: the Claude API takes it as it is). APIs limit how many tools one request may carry, so pick the ones the job needs. This helper turns them into function definitions and runs each call in one SculptForge session (through --mcp, so the scene is kept between calls): # sf_tools.py import json, subprocess CLI = \"/path/to/sculptforge-cli\" WANTED = {\"new_sphere\", \"remesh\", \"subdivide\", \"stroke\", \"decimate\", \"mesh_info\", \"export_glb\", \"undo\"} TOOLS = [{\"type\": \"function\", \"name\": t[\"name\"], \"description\": t[\"description\"], \"parameters\": t[\"input_schema\"]} for t in json.loads(subprocess.run([CLI, \"--schema\"], capture_output=True, text=True).stdout) if t[\"name\"] in WANTED] _sf = subprocess.Popen([CLI, \"--mcp\"], stdin=subprocess.PIPE, stdout=subprocess.PIPE, text=True) def call(name, arguments): _sf.stdin.write(json.dumps({\"jsonrpc\": \"2.0\", \"id\": 1, \"method\": \"tools/call\", \"params\": {\"name\": name, \"arguments\": arguments}}) + \"\\n\") _sf.stdin.flush() return json.loads(_sf.stdout.readline())[\"result\"][\"content\"][0][\"text\"] OpenAI API (Responses API). For the xAI API use the same code with OpenAI(api_key=os.environ[\"XAI_API_KEY\"], base_url=\"https://api.x.ai/v1\") and a Grok model: import json from openai import OpenAI from sf_tools import TOOLS, call client = OpenAI() items = [{\"role\": \"user\", \"content\": \"Make a sphere, remesh it at 128 and export it to ball.glb\"}] while True: r = client.responses.create(model=\"gpt-6-astra\", tools=TOOLS, input=items) items += r.output calls = [i for i in r.output if i.type == \"function_call\"] if not calls: break items += [{\"type\": \"function_call_output\", \"call_id\": c.call_id, \"output\": call(c.name, json.loads(c.arguments))} for c in calls] print(r.output_text) Gemini API (the google-genai package): from google import genai from sf_tools import TOOLS, call client = genai.Client() interaction = client.interactions.create(model=\"gemini-3.8-flash\", tools=TOOLS, input=\"Make a sphere, remesh it at 128 and export it to ball.glb\") for step in interaction.steps: if step.type == \"function_call\": print(step.name, call(step.name, step.arguments)) # Send each result back as Google's guide shows to let the model continue. Never point a tool at a web app's session or cookies: use each vendor's own app, CLI or API as above."},{"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":"packs-and-macros.html","c":"Packs and macros","a":"","h":"Packs and macros","t":"A pack is one file (.sfpack) that brings brushes, alphas, Lit Spheres, Material Recipes, VDM brushes, keymaps, pie menus and macros at once. A macro is a list of SculptForge commands you can run with one click, one key or one pie-menu slot. Both are plain data: SculptForge never runs code from a pack or a macro."},{"p":"packs-and-macros.html","c":"Packs and macros","a":"install-a-pack","h":"Install a pack","t":"Use File > Install Pack..., drop a .sfpack file on the window, or click Install Pack... in Library > Packs. Nothing is installed yet: a review shows exactly what is inside first. The review shows Name, version and author As the pack's maker wrote them. Member pack marks a members' pack (Member Requests). License The license name, and the license text from the pack on the right. Contains How many brushes, alphas, Lit Spheres, Material Recipes, VDMs, keymaps, pie menus and macros, with every item listed by name. Replaces the installed version When an older version of the same pack is installed. Click Install to add it, or Cancel to leave everything as it was. When a pack fails a check, the review says which file and why (for example \"../evil.sfbrush\" leaves its folder), and nothing is installed. Installed packs live in SculptForge's own data folder, each in its own folder. A pack never replaces a built-in brush or one of your own: a pack brush called like an existing one shows the pack's name after its own, for example Clay (Member pack)."},{"p":"packs-and-macros.html","c":"Packs and macros","a":"where-pack-items-show-up","h":"Where pack items show up","t":"Item Where Brushes and VDMs The brush lists, the Brush picker and Library > Brush, tagged with the pack's name. Alphas The Alpha picker (a Packs section) and Library > Alpha, as Name (Pack). Lit Spheres Render > Materials and Library > Material, as Name (Pack). Material Recipes The Material Recipe list under Tool > Paint Layers > Fill, as Name (Pack). Keymaps Library > Packs > Details > Apply keymap, and Edit > Preferences > Input > Pack keymaps. Pie menus Library > Packs > Details > Add pie menu (it becomes one of your radial menus). Macros F3, the key editor and the pie menus, as Name (Pack). Keymaps and pie menus change how SculptForge responds, so they are only applied when you click Apply keymap or Add pie menu. The result saves itself."},{"p":"packs-and-macros.html","c":"Packs and macros","a":"library--packs","h":"Library > Packs","t":"Open the Library (,) and click Packs. Each installed pack has a row: The check box turns the pack off or on. Off, its items leave every list; nothing is deleted. Details shows its description, folder, keymaps, pie menus and macros. Remove deletes the pack and everything it brought. Your own files are never touched. Start SculptForge with --no-packs to leave every pack out for one session (safe mode), for example to check whether a problem comes from a pack. sculptforge-cli --no-packs does the same for scripts."},{"p":"packs-and-macros.html","c":"Packs and macros","a":"make-a-pack","h":"Make a pack","t":"Library > Packs > New Pack... lists what you made yourself: brushes in your library, images in your Library's Alphas and Lit Spheres folders, the active Part's Fill layers as a Material Recipe, your VDMs, your pie menus, your changed shortcuts (as a keymap) and your macros. Tick what goes in, fill in the name, author, license and description, and click Save Pack.... The file is checked exactly as an install would check it before it is written. Tick Member pack (insider channel) for a members' pack (Member Requests). It only changes the label shown in the review and the pack list; anyone can install the file. To build a pack from a folder in a script, lay the folder out like a pack (brushes/, alphas/, litspheres/, materials/, vdms/, keymaps/, piemenus/, macros/, plus LICENSE.txt and preview.png) and run: sculptforge-cli -c 'pack_create folder=MyPack path=MyPack.sfpack id=my-pack name=\"My Pack\" author=Me license=CC-BY-4.0' The file format is described in the pack format."},{"p":"packs-and-macros.html","c":"Packs and macros","a":"record-a-macro","h":"Record a macro","t":"In Library > Packs, click Record Macro. A red Recording macro note shows at the top of the window. Work as usual: every command you run from a menu, a button, the console or a script line is kept. Click Stop Recording. The Macro Editor opens with the commands; give the macro a name and click Save. Commands a macro may not run (see below) are left out, and the status line says how many. A file inside the project folder is kept as a path relative to it; any other file becomes ?, which asks for a file when the macro runs."},{"p":"packs-and-macros.html","c":"Packs and macros","a":"write-or-change-a-macro","h":"Write or change a macro","t":"Macro Editor (in Library > Packs, or F3) is a plain text editor. A macro is the command language of the console and sculptforge-cli, one command per line, # for comments: # name: Clean Up Scan # description: Remesh, smooth and export a GLB next to the project remesh resolution=256 mask_clear export_glb path=exports/clean.glb The line under the text checks it as you type: every command must exist, be allowed in a macro and have the values it needs. Save writes it to your macros folder; Run runs it."},{"p":"packs-and-macros.html","c":"Packs and macros","a":"run-a-macro","h":"Run a macro","t":"Every saved macro (yours and those of enabled packs) is an action: F3: type its name and press Enter. Edit > Preferences > Hotkeys: find it with the filter and give it a key, like any other action (see Assign shortcuts). Edit > Preferences > Input > Radial Menus: put it in a pie menu slot. Library > Packs: Run next to your macros, or in a pack's Details. The first time a macro runs, SculptForge shows its whole command list and asks. Click Run to go on; you are not asked again for that macro unless its text changes. A macro's edits on one Part are one undo step (Ctrl+Z takes back the whole macro)."},{"p":"packs-and-macros.html","c":"Packs and macros","a":"what-a-macro-can-do","h":"What a macro can do","t":"A macro only runs SculptForge's own commands, in order. It can't run programs or scripts, and it can't: reach the network (AI services, the brush gallery, Unreal, the phone link) or send to Blender, Maya or the Bridge; install, remove or switch packs, or run another macro; name a file outside the project folder. File values are either a path inside the folder of the saved project (exports/clean.glb) or ?, which opens a file dialog when the macro runs. Absolute paths, .., ~ and drive letters are refused. Save the project first when a macro uses relative paths: they are relative to the project's folder."},{"p":"packs-and-macros.html","c":"Packs and macros","a":"scripts-and-python","h":"Scripts and Python","t":"The same rules apply outside the app: Command What it does pack_install path=Pack.sfpack Checks and installs a pack (the app shows the review first). pack_list Lists the installed packs: id, name, version, author, license, contents, on or off. pack_remove id=my-pack Removes a pack. pack_enable id=... / pack_disable id=... Turns a pack on or off. pack_create folder=... path=... Makes a pack from a folder laid out like one. macro_run name=... or path=... Runs a macro (project= sets the folder its relative paths use). macro_list / macro_check Lists the macros, or checks one without running it. In Python, sculptforge.run(doc, \"pack_install\", path=\"Pack.sfpack\") and the other commands work the same way. A command you type into sculptforge-cli or Python is your own explicit request, so it runs without the confirmation the app shows. AI agents connected through sculptforge-cli --mcp can't install, remove or switch packs."},{"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, licensing and IT deployment (a managed policy, the AI audit log, single sign-on, AI gateways and air-gapped use)."},{"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 SF_AI off: every AI feature off and locked (app, sculptforge-cli, MCP, Python); on: on whatever was saved. --no-ai does the same as off for one start SF_STUDIO_PROFILE A studio profile (studio.json) to start in studio mode with, like --studio (see Your studio build) SF_OFFLINE 1: studio mode with nothing allowed, like --offline SF_POLICY A policy file, when there is no system-wide one (see The policy file) SF_KEYCHAIN none: don't use the OS keychain (render nodes, CI); keys last for the session or come from the environment 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, OPENROUTER_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 (keys saved in the app live in the OS keychain), so a launcher can supply them without storing them for each artist."},{"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 Parts, groups as face groups, vertex colours, textures through .mtl PLY Yes Yes Meshes with vertex colours, Gaussian splats STL Yes (binary and ASCII) Yes (binary) Bridge Yes Yes Face Groups, mask, vertex paint, 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":"studio-membership","h":"Studio membership","t":"SculptForge is free for any number of artists, and nothing in the app is ever paywalled. A Studio membership is a flat $300 a month for the whole studio, any number of artists. The first 10 studios become Founding Studios at a flat $150 a month, locked for as long as they stay subscribed. Each artist gets everything in Member, and the studio gets: Its own build with its brushes, alphas, Lit Spheres, keymaps, macros, preferences, paths and logo built in. Isolation: a private release channel, and no outside connections by default (see Offline deployment). A pinned version: you choose when to move. Security fixes are backported to the current release and one long-term support (LTS) line, and your studio is always on one of those two. An offline signed installer with checksums for IT. Support: a first response within 2 business days (a response, not a fix), up to 3 custom items a month (bigger features are quoted separately), your requests first on the roadmap, and a private Discord channel. Every release stays free for everyone; bug-fix and security releases go out to everyone the same day. Join at sculptforge.app/studios.html or ask on the SculptForge Discord. What stays private, and what doesn't. SculptForge is GPL-3.0, and so is your studio build: its source comes with it and is yours to share. There are no exclusive or secret features. What stays private is yours: the brushes, alphas, settings and files you send are never put in public builds or packs, and your build never reaches out of your network."},{"p":"studios.html","c":"SculptForge for studios","a":"your-studio-build","h":"Your studio build","t":"Your build is SculptForge with a studio profile baked in: one studio.json and a folder beside it. { \"format\": \"sculptforge-studio\", \"version\": 1, \"id\": \"acme\", \"name\": \"Acme Animation\", \"updates\": {\"feed\": \"https://sw.acme.internal/sculptforge/latest.json\", \"mirror\": \"/mnt/sw/sculptforge/latest.json\"}, \"allow\": [], \"localNetwork\": false, \"ai\": false, \"packs\": [\"packs/acme.sfpack\"], \"brushPaths\": [\"/studio/brushes\"], \"preferences\": \"ui.json\", \"branding\": {\"logo\": \"logo.png\", \"title\": \"Acme\"} } Key What it does updates.feed, updates.mirror Where the build looks for updates: your private channel, then your mirror (a URL or a file on a share) allow More URLs the build may reach, such as your own ComfyUI server (empty by default) localNetwork true lets the Unreal link and phone capture use your studio network ai true keeps the AI features; they can still reach only the URLs above packs Your brushes, alphas, Lit Spheres, keymaps and macros as .sfpack files, installed at first start brushPaths Read-only brush shares, as SCULPTFORGE_BRUSH_PATH preferences The first-start interface settings: layout, shortcuts and UI scale (Edit > Preferences > Interface exports them) branding Your logo in Help > About and a word in the title bar Paths are relative to the profile's folder, and the profile is data only: nothing in it runs. An unknown key is an error, so a typo never quietly drops a setting. To request your build, send in one email or a message in your team channel: What to bake in: your exported keymap and layout, brush presets and packs (.sfbrush, .sfpack), and the pipeline defaults you want. References for custom content: images or scans you own, with a line on what each item should do. Where it runs: platforms and, for Linux, the distribution or VFX Reference Platform year. Where updates come from: your channel or mirror URL, or a folder on a share. Who gets access: the GitHub usernames for your private release channel. Files are treated as data only: scripts and executables you send are never run. Your build is made by the same pipeline and tests as public builds and published in your private channel, signed, with its checksums and source. To try a profile on a public build first, start it with sculptforge --studio /path/to/studio.json (or set SF_STUDIO_PROFILE); sculptforge-cli and the Python module take the same profile."},{"p":"studios.html","c":"SculptForge for studios","a":"offline-deployment","h":"Offline deployment","t":"A studio build is in studio mode, whatever happens to its files: No outside connections. No update check against the public website, no AI services, no community brush gallery, no Discord presence; SculptForge has no telemetry. Every request goes through one gate that allows only your update channel, your mirror and your allow list, refuses everything else before it is sent, and never follows a redirect. Network sockets open only on this computer (loopback) unless localNetwork is true. Fails closed. If the profile is missing or broken, a studio build still starts offline, with nothing allowed. Updates on your schedule. The build reads its feed only from your channel or mirror. Copy a new release's latest.json to the mirror when you're ready to move; until then nobody is offered it. To install on machines without internet access: Download the release from your private channel: the installer or archive for each platform, SHA256SUMS.txt and SHA256SUMS.txt.sig. Check the files: sha256sum -c SHA256SUMS.txt --ignore-missing (Windows: Get-FileHash -Algorithm SHA256), and the signature with the public key we send you: openssl pkeyutl -verify -pubin -inkey sculptforge-release.pem -rawin -in SHA256SUMS.txt -sigfile SHA256SUMS.txt.sig. Deploy as usual: the Windows installer or portable zip, the .rpm/.deb, the tar.gz or the Rez package. To test studio mode on any machine, sculptforge --offline turns it on with nothing allowed; SF_OFFLINE=1 does the same for the CLI and Python."},{"p":"studios.html","c":"SculptForge for studios","a":"it-deployment","h":"IT deployment","t":"Everything an IT team needs to roll SculptForge out under its own rules: a policy file that locks settings, an audit log of what AI did, the studio's own AI gateway and single sign-on, and offline use. Nothing here needs a studio build; it works on the public one. For a security review, see the security overview."},{"p":"studios.html","c":"SculptForge for studios","a":"the-policy-file","h":"The policy file","t":"Put a policy.json where only administrators can write it: OS Path Linux /etc/sculptforge/policy.json macOS /Library/Application Support/SculptForge/policy.json Windows C:\\ProgramData\\SculptForge\\policy.json (deploy it with Group Policy, Intune, SCCM or your usual tool) SculptForge reads it at every start (the app, sculptforge-cli, MCP and the Python module). Each setting it locks is greyed out in Edit > Preferences with Managed by your studio next to it. Without a system file, SF_POLICY=/path/policy.json names one, for testing a policy or setting it from a launcher or a Rez package; while the system file exists, SF_POLICY is ignored, so an artist can't loosen it. { \"format\": \"sculptforge-policy\", \"version\": 1, \"organization\": \"Acme Animation\", \"ai\": {\"enabled\": true, \"providers\": [\"litellm\", \"comfyui\"], \"endpoints\": [\"https://llm.acme.internal/\", \"http://comfy.acme.internal:8188/\"], \"requireSignIn\": true}, \"network\": {\"enabled\": false, \"allow\": [\"https://sw.acme.internal/\"], \"localNetwork\": false}, \"mcp\": {\"enabled\": true, \"live\": \"never\", \"categories\": [\"info\", \"edit\", \"files\"]}, \"maya\": {\"link\": \"never\"}, \"audit\": {\"path\": \"//fs01/audit/sculptforge/{user}@{host}.jsonl\", \"maxMB\": 20, \"keep\": 10, \"required\": true}, \"signIn\": {\"issuer\": \"https://acme.okta.com/oauth2/default\", \"clientId\": \"0oa1example\", \"useFor\": [\"https://llm.acme.internal/\"]}, \"telemetry\": \"none\", \"updates\": {\"check\": true, \"channel\": \"stable\", \"feed\": \"https://sw.acme.internal/sculptforge/latest.json\"} } Every key is optional: what the policy leaves out stays the artist's choice. An unknown key or a wrong value is an error, so a typo never quietly drops a lock, and a broken or unreadable policy fails closed: AI, network features and AI tools stay off until it is fixed. sculptforge-cli --policy shows what the policy manages (exit code 2 when it is broken); use it to check a file before you deploy it. Key What it does organization Shown as \"Managed by Acme Animation\" ai.enabled false: every AI feature off and locked (as SF_AI=off). true: on and locked. Left out: the artist's choice ai.providers The only AI providers artists can pick: free, anthropic, openai, ollama, lmstudio, vllm, llamacpp, litellm, openrouter, openai-compatible (Brush Lab) and huggingface, fal, meshy, comfyui, command (Generate 3D) ai.endpoints The only addresses AI requests may go to (URL prefixes, matched at a /) ai.requireSignIn AI works only while the artist is signed in with the studio account (needs signIn) network.enabled false: studio mode (see Offline deployment): no outside connection except network.allow, ai.endpoints, the identity provider and your update feed network.allow More URL prefixes that stay reachable while the network is off network.localNetwork true: the Unreal link and phone capture may use the studio network while the network is off mcp.enabled false: no AI tool can connect (sculptforge-cli --mcp refuses to start, and Help > Connect an AI tool is gone) mcp.live \"never\": AI tools work only on their own scene and can never control an open SculptForge window (the window never listens for them; Let AI tools control this window is locked off) maya.link \"never\": the Maya Live link can't be turned on (the window never listens for Maya; the folder bridge still works) mcp.categories The kinds of command AI tools may use: info (read the scene), edit (change it in memory), files (open, save, export, bridges), scripts (macros), network (brush gallery, Unreal), ai (AI generation). Left out: all audit.path, audit.maxMB, audit.keep Where the audit log goes, when it rotates (10 MB) and how many old files it keeps (5) audit.required true: an AI action whose audit line can't be written (the share is down) is refused signIn.issuer, signIn.clientId Your identity provider and the app registration (see Single sign-on) signIn.clientSecret Only for providers that issue one to installed apps and require it (Google); it isn't secret there, and artists can read the policy signIn.scopes, signIn"},{"p":"studios.html","c":"SculptForge for studios","a":"audit-log","h":"Audit log","t":"Every AI action is one line of JSON in a local file: each command an AI tool (MCP) runs, refused ones included (\"tool\": \"mcp\", or \"mcp-live\" when it controls an open window), and every Brush Lab and Generate 3D request (\"ai\"), from the app, sculptforge-cli and Python. {\"time\":\"2026-11-05T14:03:22.120Z\",\"user\":\"ana\",\"host\":\"ws042\",\"client\":\"mcp:claude-code 2.1.0\",\"tool\":\"mcp\", \"command\":\"export_glb\",\"args\":{\"path\":\"/show/troll/assets/rock.glb\"},\"result\":\"ok\",\"message\":\"Exported\",\"ms\":930} What is never written: artwork (meshes, images, textures), keys and tokens (any argument named like a key, token, password or secret is ), and long text (strings are cut to 120 characters; a long prompt is recorded as its length). File paths are kept: they say what was read or written. Where: audit.path from the policy, with {user}, {host} and {date} filled in, so each machine can write its own file on a share. Without a policy, audit/ai-audit.jsonl in the settings folder. Edit > Preferences > AI shows the path; sculptforge-cli --audit-log prints it. Rotation: past audit.maxMB the file becomes .1, .1 becomes .2, and so on up to audit.keep. Nothing is sent anywhere: collect the files with your own tools (any log shipper reads JSON lines)."},{"p":"studios.html","c":"SculptForge for studios","a":"ai-providers","h":"AI providers","t":"Edit > Preferences > AI > Provider has presets that fill in the address and a model, so artists pick a name instead of typing URLs: Preset Address Key Anthropic (Claude) https://api.anthropic.com/v1/messages The artist's or the studio's API key OpenAI https://api.openai.com/v1/chat/completions API key Ollama http://localhost:11434/v1/chat/completions None LM Studio http://localhost:1234/v1/chat/completions None vLLM server http://localhost:8000/v1/chat/completions (or your GPU server) Optional llama.cpp server http://localhost:8080/v1/chat/completions (or your server) None LiteLLM proxy (studio gateway) http://localhost:4000/v1/chat/completions (change it to your gateway) A virtual key, or the studio sign-in OpenRouter https://openrouter.ai/api/v1/chat/completions API key Amazon Bedrock, Google Vertex AI and Azure OpenAI go through a LiteLLM proxy your studio runs: the proxy holds the cloud credentials, applies your budgets and model list, and SculptForge talks only to it. A minimal proxy configuration: model_list: - model_name: claude litellm_params: {model: \"bedrock/<Bedrock model id>\", aws_region_name: us-west-2} - model_name: gemini litellm_params: {model: \"vertex_ai/<Vertex model id>\", vertex_project: acme-render, vertex_location: us-central1} - model_name: gpt litellm_params: {model: \"azure/<your deployment>\", api_base: \"https://acme.openai.azure.com\", api_version: \"<API version>\"} Point the preset at https://llm.acme.internal/v1/chat/completions, list that prefix in ai.endpoints, allow only litellm in ai.providers, and artists can reach no other AI service. To validate the studio sign-in at the gateway, use LiteLLM's JWT authentication with your identity provider's keys. Keys are kept in the operating system's keychain: macOS Keychain, Windows Credential Manager, or the Secret Service on Linux (GNOME Keyring, KWallet, KeePassXC). They are never written to a settings file; keys from older versions move into the keychain at the first start. Where there is no keychain (SF_KEYCHAIN=none, a render node), a key typed in lasts until SculptForge quits; the environment variables ANTHROPIC_API_KEY, OPENAI_API_KEY, OPENROUTER_API_KEY, HF_TOKEN, FAL_KEY and MESHY_API_KEY work everywhere."},{"p":"studios.html","c":"SculptForge for studios","a":"single-sign-on","h":"Single sign-on","t":"With signIn in the policy, Edit > Preferences > AI > Studio sign-in signs the artist in with the studio account (Okta, Microsoft Entra ID, Google Workspace, Auth0, Keycloak or any OpenID Connect provider). It uses the device authorization grant only: SculptForge shows a short code and opens your provider's page, and the artist signs in there, in their browser, with your usual login and MFA. Nothing on the artist's computer listens for the answer: no local port, no redirect, no embedded browser. sculptforge-cli --sign-in does the same in a terminal. The tokens are kept in the keychain and refreshed when they expire. The access token is sent as Authorization: Bearer only to the addresses in signIn.useFor (default: ai.endpoints), such as your AI gateway; never to anyone else. SculptForge reads the ID token's name and email only to show who is signed in: your services verify the access token. To set it up, register a public client (no client secret) with the device flow turned on: Provider Where Issuer Okta Applications > Create App Integration > OIDC > Native Application; Grant type: Device Authorization https://.okta.com/oauth2/default Microsoft Entra ID App registrations > New registration; Authentication > Allow public client flows: Yes https://login.microsoftonline.com//v2.0 Google Workspace Google Cloud console > Credentials > OAuth client ID > TVs and Limited Input devices https://accounts.google.com (list https://oauth2.googleapis.com/ in network.allow when the network is off) Auth0 Applications > Native; Advanced settings > Grant types: Device Code https://.auth0.com/ (set signIn.audience to your API) Keycloak Clients > Create; Client authentication: Off; OAuth 2.0 Device Authorization Grant: On https:///realms/ Put the client id in signIn.clientId. Google's device flow also wants the client's secret, which Google documents as not confidential for this client type: put it in signIn.clientSecret. Google's access tokens are meant for Google's own APIs, so with Google Workspace have your gateway validate the ID token instead."},{"p":"studios.html","c":"SculptForge for studios","a":"offline-and-air-gapped-use","h":"Offline and air-gapped use","t":"\"network\": {\"enabled\": false} in the policy, or sculptforge --offline / SF_OFFLINE=1, turns on studio mode: every request goes through one gate that refuses anything not allowed before it is sent, follows no redirect, and sockets open only on loopback (see Offline deployment). AI can stay on in an air-gapped facility with local models: allow ollama, lmstudio, vllm, llamacpp or comfyui and list their addresses in ai.endpoints. Updates come from updates.feed / updates.mirror only; copy a release's latest.json there when you are ready. Install from the signed checksums as described under Offline deployment."},{"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, Unreal and Bridge Brush Lab and sharing brushes Image and text to 3D: running models on your own ComfyUI server Troubleshooting Security overview for IT reviews"},{"p":"security.html","c":"Security overview for IT reviews","a":"","h":"Security overview for IT reviews","t":"A one-page summary for a studio's security or IT review. Details and settings are in SculptForge for studios."},{"p":"security.html","c":"Security overview for IT reviews","a":"what-sculptforge-is","h":"What SculptForge is","t":"A desktop sculpting application (GPL-3.0, source on GitHub), a command-line tool (sculptforge-cli) and a Python module. No account, no licence server, no servers of our own. It runs as the signed-in user with no elevated rights and installs no services, drivers or background processes."},{"p":"security.html","c":"Security overview for IT reviews","a":"network","h":"Network","t":" Telemetry, analytics, crash upload None. Crash logs stay on the computer. Listening ports None by default, and never for AI tools or sign-in. Two features listen while the artist uses them: phone capture (on the local network, so the phone can reach it) and the Unreal link. With the network off by policy, they may use only this computer unless network.localNetwork allows the studio network. The Blender and Maya bridges exchange files. The Maya Live link, when the artist turns it on (with a warning each time; off at every start), listens on a per-user socket or pipe on this computer only, never a port; \"maya\": {\"link\": \"never\"} forbids it. Outbound connections Only what the artist uses: the daily update check (a small file from the website, or your own feed), the community brush gallery, and the AI service the artist chose. With \"network\": {\"enabled\": false} in the policy, a single gate refuses everything except the addresses you list, before anything is sent, and follows no redirects. AI features Optional, and lockable off by policy. Only the request goes to the chosen service: a brush description, or the picture or text given to Generate 3D. Sculpts are never uploaded or used for training. Providers and addresses can be limited to your own gateway or local models."},{"p":"security.html","c":"Security overview for IT reviews","a":"ai-tools-mcp","h":"AI tools (MCP)","t":"sculptforge-cli --mcp serves the Model Context Protocol over stdio only: the AI tool starts it as a child process; nothing listens on a port. Each command an AI tool runs is checked against the policy's allowed categories (read, edit, files, scripts, network, AI) and written to the audit log. AI tools can't install, remove or switch packs. Controlling an open SculptForge window can be forbidden outright (\"mcp\": {\"live\": \"never\"}), and MCP can be turned off entirely."},{"p":"security.html","c":"Security overview for IT reviews","a":"data-at-rest","h":"Data at rest","t":" Where Artwork Wherever the artist saves it. SculptForge doesn't copy it elsewhere. Settings The user's settings folder, owner-only permissions. No secrets in them. API keys, sign-in tokens The OS keychain only: macOS Keychain, Windows Credential Manager, Linux Secret Service. Never in files or logs. Audit log JSON lines, local or on a share you choose; no artwork, keys or long text."},{"p":"security.html","c":"Security overview for IT reviews","a":"identity","h":"Identity","t":"Single sign-on uses OpenID Connect with the device authorization grant (RFC 8628) against your identity provider: the artist signs in in their own browser with your MFA, and no local listener or embedded browser is involved. The token is sent only to the addresses your policy names (your AI gateway)."},{"p":"security.html","c":"Security overview for IT reviews","a":"central-control","h":"Central control","t":"A read-only policy file (/etc/sculptforge/policy.json, /Library/Application Support/SculptForge/policy.json, C:\\ProgramData\\SculptForge\\policy.json) locks AI on or off, network features, allowed AI providers and addresses, AI tool access, sign-in, the audit log and updates. A broken policy fails closed. An artist can't override it with environment variables while it is installed."},{"p":"security.html","c":"Security overview for IT reviews","a":"supply-chain","h":"Supply chain","t":" Status Builds Built from the public repository by GitHub Actions, from tagged commits, with every third-party archive pinned by SHA-256 (cmake/Fetch.cmake). Release integrity Every release has SHA256SUMS.txt and an Ed25519 signature of it (SHA256SUMS.txt.sig); the app's own updater checks both. SBOM Each release carries a CycloneDX SBOM (SculptForge--sbom.cdx.json), covered by the signed checksums. Licences: THIRD_PARTY_NOTICES.md. Code signing Not yet. Windows installers are not Authenticode-signed (SmartScreen warns), and the macOS app is ad-hoc signed, not notarized. Verify downloads with the signed checksums until then. Updates Off, or from your own feed or mirror, by policy. A studio build reads only its own channel. Vulnerability reports Private reporting on GitHub (see SECURITY.md); fixes go to the latest release."},{"p":"security.html","c":"Security overview for IT reviews","a":"see-also","h":"See also","t":"SculptForge for studios: IT deployment AI services: privacy and model licences"},{"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. SculptForge has four key styles, chosen in Edit > Preferences > Input > Style (and by the Coming from question the first time SculptForge starts): SculptForge (the default for new installs), Classic, Blender and Maya. The main table shows the SculptForge style; the sections after it list what the classic and Blender styles change. If you used an earlier version, your saved style is kept."},{"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 Edit > Preferences > Hotkeys. Your changes save themselves. 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 in the SculptForge style, 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). Capture from view Ctrl+Alt+C Alpha and VDM from the viewport: drag a square over any sculpted detail (Shift for a circle) and capture it as a grayscale height alpha and as a vector displacement brush, ready to stamp with the VDM brush or along strokes with Detail Clone, and to save in your library. Clay 2 Builds up clay that fills the hollows first. Clay Block 0 Square, flat-topped clay strokes for blocking in forms. Crease 6 Cuts a sharp crease; Alt raises a ridge. Flatten 7 Presses the surface toward a plane. Inflate 5 Swells the surface outward along its normals. Move 4 Grabs the surface under the cursor and pulls it along. Paste brush Ctrl+V Add the brush on the clipboard: a brush code someone shared, or the text of a .sfbrush file. Pinch 8 Pulls the surface toward the stroke to tighten edges. Sharp Crease 9 A sharp V-shaped crease with the sides pinched in. Smooth 3 Relaxes the surface. Hold Shift to smooth with any brush. Standard 1 Raises the surface along the stroke; Alt digs in."},{"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 Falloff at cursor O or I A Falloff 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. Intensity at cursor U An 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 Intensity. Larger brush ] Make the brush 10% larger (hold to repeat; Shift+] steps one pixel). Larger brush by 1 px Shift+] Make the brush one pixel larger (half a pixel below 2 px). Paint P Paint colour without sculpting. Alt paints back to white, Shift still smooths. Size at cursor S A Size slider under the cursor: drag it, or type a number and press Enter. Smaller brush [ Make the brush 10% smaller (hold to repeat; Shift+[ steps one pixel). Smaller brush by 1 px Shift+[ Make the brush one pixel smaller (half a pixel below 2 px), down to 0.5 px."},{"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 Part, 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. Quick Menu Space The Quick Menu under the cursor: brush, stroke, alpha, material, colour, Size, Falloff 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":"library","h":"Library","t":"Action Keys What it does Library , Show or hide the Library: thumbnails of your projects, models, brushes, alphas, materials, images, splats and Snapshots 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":"palettes","h":"Palettes","t":"Action Keys What it does Preferences Ctrl+, Open the Preferences palette (click its tray icon to keep it in a tray)."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"preferences","h":"Preferences","t":"Action Keys What it does Export Interface... Ctrl+Alt+Shift+I Save the layout, shortcuts and interface preferences to a file you can share. Import Interface... Ctrl+L Load a layout and shortcuts file someone shared (or you saved with Export Interface). Radial menu 1: Brushes T Hold the key, flick toward an item and let go to run it; or tap the key and click one. Edit it in Preferences > Input > Radial Menus. Radial menu 2: Masking Y Hold the key, flick toward an item and let go to run it; or tap the key and click one. Edit it in Preferences > Input > Radial Menus. Radial menu 3: Strokes J Hold the key, flick toward an item and let go to run it; or tap the key and click one. Edit it in Preferences > Input > Radial Menus. Shelves Tab Hide or show the shelves and trays around the canvas."},{"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 Show or hide the mask (masked areas drawn darker). Hiding it keeps the mask: masked areas stay protected from brushes until you clear it. Wireframe Shift+F Show the mesh's polygons (quads and triangles) over the surface."},{"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 Steady Stroke L Steady Stroke on or off, with every stroke type (Dots, Drag Stamp, Slide Stamp, Spray): the brush trails the cursor on a string and only moves once the string is taut, for steady lines without hand shake. Stroke popup G A grid at the cursor with the stroke types, the modifiers (Add / Sub, Smooth, Mask, Select) and the mask and Cut shapes. Hold the key, point at one and let go; or tap the key and click. Smooth, Mask, Select and the shapes stay on without holding Shift or Ctrl, until you pick them again or another brush."},{"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, away from the model). Divide (keeps levels) Ctrl+D Non-destructive: 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. Duplicate Part Ctrl+Shift+D Copy the active Part, with its layers and attributes, and make the copy active (also in the Parts list's right-click menu). Group from Mask Ctrl+W Turn the masked part into a new face group and clear the mask. With nothing masked, everything visible becomes one group. Higher Level 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 Level 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 Part. Preview A Show the skin Make Mesh would build instead of the spheres. Turn it off to edit the spheres again. Quick Remesh Shift+R With Tool > Remesh > Quick Remesh on: remesh the active Part at the Voxel Remesh resolution, in the background. Quick Remesh (hold and drag) N With Tool > Remesh > Quick Remesh on: hold this key and click or drag on the background (not on the model) to remesh the active Part. Sculpt the Part under the cursor Alt+Q Make the Part under the pointer the one you sculpt, without moving the view (each Part keeps its mask). The same key as Blender's; Preferences > Hotkeys changes it."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"transform","h":"Transform","t":"Action Keys What it does Back view Ctrl+Numpad 1 Look at the model from behind (orthographic). Bottom view Ctrl+Numpad 7 Look up at the model from below (orthographic). Draw Q Draw mode: brushes sculpt and paint (leaves the Gizmo). Frame F Fit the whole model in the view. Frame Part Numpad . Fit the active Part in the view (Blender: View Selected; Maya keys: Alt+F). Front view Numpad 1 Look at the model from the front (orthographic). Left view Ctrl+Numpad 3 Look at the model's left side (orthographic). Move W Gizmo, 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. Opposite side Numpad 9 Look at the model from the other side. Orbit down Numpad 2 Turn the view 15 degrees down under the model. Orbit left Numpad 4 Turn the view 15 degrees to the left around the model. Orbit right Numpad 6 Turn the view 15 degrees to the right around the model. Orbit up Numpad 8 Turn the view 15 degrees up over the model. Orthographic Numpad 5 Switch between a perspective and an orthographic view (no foreshortening: sizes don't shrink with depth). Restore View Numpad 0 Go back to the view saved or restored last (View > Views). Right view Numpad 3 Look at the model's right side (orthographic). Rotate R Gizmo, 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. Save View Ctrl+Alt+Numpad 0 Remember this camera as a named view (View > Views; the name field names it). Saved with the project. Scale E Gizmo, 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. Top view Numpad 7 Look down on the model (orthographic). X X Mirror strokes across X (left and right). Zoom in Numpad Plus Move the view closer. Zoom out Numpad Minus Move the view back."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"uv-editor","h":"UV Editor","t":"Action Keys What it does UV Editor Alt+U Open the UV Editor: the Part's UV layout in 2D over the UDIM tiles. Select vertices, edges, faces or islands (here or on the model), move, rotate and scale them, mark seams, unwrap, pack, set texel density and lay islands into trim sheet strips. Stretch and texel density show live on the model while you edit."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"view","h":"View","t":"Action Keys What it does Free Alt+Shift+F Rotation drags turn the view about the screen's axes and can roll it over the top (the default). Saved with the preferences. Lock camera Shift+L Lock the camera for left-drags: a drag that starts on the background sculpts once it reaches the model instead of turning the view (Preferences > Input > Start strokes off the model, #62). The status bar shows CAMERA LOCKED while it is on. Right-drag or Alt+drag still move the view. Shift+L turns it on and off. Turbo Ctrl+Alt+T Everything this computer can safely give to sculpting speed, in one click: antialiasing off and a lighter view while you sculpt and orbit (full quality the moment you stop), and the top budgets of the tier this machine carries. It never goes past what the memory holds. Off puts everything back as you set it. Remembered on this computer. X Alt+Shift+X Rotation drags turn the view about the world X axis only (red): from the front, an up or down drag tips the model towards you or away. Shift still snaps to a side view; the axis gizmo shows the lock. Saved with the preferences. Y (turntable) Alt+Shift+Y Rotation drags turn the view like a turntable: the model stays upright and turns about its vertical (Y) axis. Saved with the preferences. Z Alt+Shift+Z Rotation drags turn the view about the world Z axis only (blue): from the front, a drag around the middle turns the model like a wheel. Shift still snaps to a side view; the axis gizmo shows the lock. Saved with the preferences."},{"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 Sculpt from beside the model Turn on Edit > Preferences > Input > Start strokes off the model (or press Shift+L), then left-drag from the background onto the model; the view then turns with a right-drag (see Navigation) 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; Ctrl+left-drag on the background when nothing is masked (not in the classic) 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 something masked (with Mask Pen), or Ctrl+Shift+A Mask inside a lasso or rectangle Ctrl+drag with Lasso Mask or Rectangle Mask picked in Tool > Masking (add Alt: unmask) Isolate a face group Ctrl+Shift+click it (again: invert the visibility; with something hidden already: hide it) Hide a face group 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); Select Rectangle or Select Lasso in Tool > Visibility Select a Part Alt+click it in the view (Shift+Alt+click, or a triple-click on another Part: select and frame it) Sculpt the Part under the cursor Alt+Q (every input style; the view stays put) Move, scale or rotate with the Gizmo 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 Customize Shelves 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 highlighted 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":"classic-sculpting-keys","h":"Classic sculpting keys","t":"With Edit > Preferences > Input > Style on Classic, the keys and gestures work. The choice saves itself. Compared with the table above, these change: To SculptForge style classic Pick one of the first ten brushes 1 to 9, 0 (Standard, Clay, Smooth, Move ...) No key: the number keys are free Save Snapshot No key 9 Slider at the cursor on I Falloff (as O) Colour intensity Ctrl+drag on the background with nothing masked Zooms Draws a mask rectangle (one that misses the model clears the mask) Zoom drags (Ctrl+right-drag, Alt+drag then release) Up zooms in Up zooms out Everything else, from the B brush letters and S / U / O to the Ctrl and Ctrl+Shift gestures, is the same in both styles. The Maya style keeps these the Classic sculpting keys and changes only the view controls (Alt+left, middle and right drags)."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"maya-keys","h":"Maya keys","t":"With Edit > Preferences > Input > Style on Maya (#32), the view works as in Maya, on the model or beside it, as long as Alt is the only key held: To Maya style Rotate Alt+left-drag Pan Alt+middle-drag Zoom Alt+right-drag sideways: right zooms in, left zooms out, as Maya's own dolly; the mouse wheel zooms toward the pointer Roll (turn about the view axis) Hold Alt, then add Ctrl, and left-drag left or right Frame the active Part Alt+F (also Numpad .) Reset the view Alt+H: from the front, upright, in perspective, the whole model in view Invert the brush (subtract) Hold Ctrl while sculpting Paint a mask / erase it Ctrl+Alt+drag / Ctrl+Alt+Shift+drag Smooth Hold Shift while sculpting Visibility gestures Ctrl+Shift, as in the other styles The roll needs Alt first: press Ctrl first (or both together) and Ctrl+Alt masks as before, on the model, and clears the mask beside it. Edit > Preferences > Input > Wheel zooms toward the pointer (#134) keeps the point of the model under the pointer where it is while the wheel zooms; beside the model it zooms toward the pointer at the model's depth. Choosing the Maya style turns it on and the other styles turn it off (they zoom toward the middle of the view); the box changes it in any style. Maya's default dolly follows a sideways drag, so that is the default here too. Edit > Preferences > Input > Zoom drag switches it to Up and down (drag up to zoom in) if you set Maya up that way. Invert zoom, in every style, turns zoom drags around (the mouse wheel stays as it is)."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"blender-keys","h":"Blender keys","t":"With Edit > Preferences > Input > Style on Blender (also at the top of the Controls window, F1), the view and the sculpt keys work as in Blender 4.2 and later, Sculpt Mode (with 5.1's Alt mask). Compared with the table above, these change in the Blender style: To Blender style Rotate Middle-drag, or Alt+left-drag beside the model (everywhere with Edit > Preferences > Input > Emulate 3 Button Mouse, for pens and trackpads), or left-drag beside the model Pan Shift+middle-drag, or Alt+Shift+left-drag Zoom Mouse wheel, Ctrl+middle-drag (up: closer), Alt+Ctrl+left-drag, Numpad Plus / Numpad Minus Invert the brush (subtract) Hold Ctrl while sculpting Mask / unmask Alt+drag / Ctrl+Alt+drag on the model (Blender 5.1 and later), or the Mask brush (M) Smooth Hold Shift while sculpting Front, right, top view Numpad 1, Numpad 3, Numpad 7; with Ctrl: back, left, bottom Orthographic on or off Numpad 5 (the axis views turn it on until you rotate again) Orbit in 15 degree steps, the other side Numpad 4 Numpad 6 Numpad 8 Numpad 2, Numpad 9 Frame the active Part / everything Numpad . / Home Brush radius / strength F / Shift+F (drag, or type a number) Draw, Smooth, Pinch, Inflate, Grab (Move) V, S, P, I, G Clay Strips (Clay Block), Crease, Tendril, Scrape (Flatten) C, Shift+C, K, Shift+T Mask brush M, then drag to mask and Ctrl+drag to unmask; M again goes back to your brush Clear / invert the mask Alt+M / Ctrl+I Hide the face group under the cursor H; Shift+H shows only it (again: everything); Alt+H shows everything Lower / higher subdivision level Alt+1 / Alt+2 (Shift+D / D still work) Swap colours / sample colour X / Shift+X Smooth stroke (Lazy Stroke) Shift+S (or L) Wireframe Shift+Z Choosing the Blender style also sets Rotation to Turntable, as Blender orbits; change it back under Edit > Preferences > Input if you like. Blender's face sets are SculptForge's face groups, and its brushes map to the nearest SculptForge brush. Symmetry X, Paint and the material picker have no key in the Blender style (they are on the shelves); give them one with Ctrl+Alt+click. Laptops without a numpad: turn on Edit > Preferences > Input > Emulate Numpad and the number row works as the numpad. The numpad views (Numpad 1, 3, 7, 5 ...) work in every style."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"your-own-blender-keymap","h":"Your own Blender keymap","t":"If you changed Blender's keys, export them in Blender (Edit > Preferences > Keymap, the Export... button next to the keymap name) and in SculptForge choose Import Blender keymap... under Edit > Preferences > Input or at the top of the Controls window. SculptForge switches to the Blender style and takes, from the file's 3D View and Sculpt keymaps, the keys of every action it has an equivalent for: the views, the brushes above, the radius and strength, the mask, hiding, subdivision levels, undo and redo. Mouse buttons and keys for things SculptForge doesn't have are left alone; the status bar says how many keys it took. The file is read as text and never run. The keys save themselves; Reset Layout and Shortcuts goes back to the defaults."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"classic-sculpting-keys-that-work-differently","h":"Classic sculpting keys that work differently","t":"Most classic sculpting keys and gestures work in SculptForge with the Classic sculpting keys. The few that differ even then, because the feature works differently or doesn't exist yet: Classic key SculptForge P (perspective) P is the Paint brush; Numpad 5 switches to an orthographic view T (Edit mode) Always in Edit mode: there is no 2.5D canvas W / E / R (move, scale and rotate line) The Gizmo (see Gizmo) 1, 2, 3 (replay and record strokes) Not yet N (list the Parts) Tool > Parts 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 script) Export GLB and Send to Unreal H (hide the script window) ` toggles the console See Quick tour for experienced sculptors for the whole list."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"see-also","h":"See also","t":"The interface Navigating the view Masking Face Groups 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 Edit > Preferences > Performance, and how to get the most out of a big sculpt. What we're building next, and how each piece works: Performance: what we're building. Edit > 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 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":"edit--preferences--performance","h":"Edit > 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 View resolution (100%, 75%, 50%) Draws the 3D view at a share of the window's resolution and scales it up: 75% draws about half the pixels and 50% a quarter. Try it on slow or integrated graphics and big screens. Save Render always renders at full resolution. Also in View Fast Navigation While you rotate, pan or zoom a scene bigger than the hardware profile's motion proxy threshold (see below), 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 Predictive Strokes The brush is worked out on its own thread while the view keeps drawing at full speed. The dabs it hasn't finished show at once as a preview on the surface, and the brush cursor and the stroke's head are drawn where the pen is about to be, so on a heavy mesh the surface moves under the pen straight away and lifting the pen never waits. The finished sculpt is exactly the same as with it off. On by default (painting, masking, dynamic topology, Move, Tendril and the drag strokes work as before) Draft Strokes With Predictive Strokes: while you sculpt, the brush only moves the surface, the moved part is shaded from its facets, and the smooth shading, the cavities and the rest are worked out once when you lift the pen. Lighter on laptops and on battery. Inflate and the plane brushes use the surface's direction from the stroke's start, so the result can differ slightly from a full stroke. Off by default Live Move (experimental) The Move brush's drag is drawn by the graphics card from where the surface started, so it follows the pen at the view's frame rate on any mesh size; the move is applied once, exactly, when you lift the pen. Not with masks, hidden parts, sculpt layers, micro levels, Connected Only or View falloff (Move works as before there). Off by default Background Preview (experimental) On meshes of 2 million vertices or more a big brush is worked out on its own thread; with this on, the dabs still being worked out show as a preview under the pen. The finished sculpt is exactly the same either way. Off by default Fast Upload (experimental) While you sculpt, the changed part of the mesh goes to the graphics card through memory both can see and the card copies it into place, instead of the driver copying it during the frame. The sculpt and the view are exactly the same either way. Needs OpenGL 4.4 buffer storage (otherwise it does nothing). Off 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"},{"p":"performance.html","c":"Performance and big meshes","a":"your-hardware-tier","h":"Your hardware tier","t":"On top of the profile below, SculptForge sorts your computer into a tier, so the bigger features switch on by themselves where your machine can carry them, and never where it can't. Every tier sculpts smoothly: the higher ones give more room for detail. Tier For What it adds Essential every computer SculptForge runs on settings tuned for the machine; Focus Detail keeps 512 MB of full-resolution detail close by Standard 16 GB of memory, 6 or more threads and a 4 GB graphics card (or graphics that share the memory) twice the Focus Detail memory, streamed in faster High 32 GB, 8 or more threads and an 8 GB graphics card (or 32 GB shared, such as an Apple Pro or Max) 2 GB of Focus Detail, 16K paint and bake textures Extreme 64 GB, 16 or more threads and a 16 GB graphics card (or 64 GB shared) 4 GB of Focus Detail, the most of everything A graphics card or processor that measures slow keeps a lower tier, whatever its memory says. The first time SculptForge starts (and when you change the graphics card or the memory), a small card in the corner of the 3D view says what it found, for example Your machine: RTX 3060, 12 GB VRAM, 32 GB RAM. Tier: High, and what that turns on. Click Got it; it doesn't show again on this computer. The tier is also in the top bar, next to the bolt: click it to open Edit > Preferences > Performance. There, at the top: Control What it does Tier your machine, its tier, what the next tier would need, and What this turns on Auto / each tier choose the tier yourself. A tier above the detected one is allowed; the memory guard still watches it Turbo the same switch as the bolt (below) Graphics card on a computer with two (a laptop's built-in and gaming graphics, or two cards): which one draws SculptForge. Auto takes the fastest one. It applies the next time SculptForge starts; if that card can't start, SculptForge goes back to the system's choice and says so Compute Auto, CPU or GPU for the heavy work. Each task shows where it runs; the ones that have no graphics card version yet say CPU only for now. Auto uses the graphics card only where it measured faster, and never on the Essential tier Free memory is watched. If your computer runs low on memory while you work (another program, a huge scene), SculptForge steps the tier down one level and says so in the status bar; detail streams in a little later and nothing is lost. When there is room again for a minute, it steps back up."},{"p":"performance.html","c":"Performance and big meshes","a":"turbo","h":"Turbo","t":"The small bolt in the top bar (also View > Turbo, Ctrl+Alt+T) gives everything your computer can safely spare to sculpting speed: while you sculpt or orbit, the view draws without antialiasing and with a lighter version of big scenes, and the tier's top budgets apply. The moment you stop, the view is back at full quality. It turns orange while on, and a line in the status bar says what it changed. Turn it off and every setting is exactly as you left it. SculptForge remembers it on this computer."},{"p":"performance.html","c":"Performance and big meshes","a":"the-hardware-profile","h":"The hardware profile","t":"The first time you start SculptForge, a small window says Getting to know this computer for a second or two: it checks how fast your graphics card draws and receives data, how fast a brush runs and how fast the memory is, and picks settings to match. It does this once, and again only when you change the graphics card, update its driver or install a new version. Press Esc or Skip to skip it; the settings then come from the type of graphics card and the memory sizes. Nothing is sent anywhere: the results stay in your settings folder. There are two main profiles and a safe mode: Profile For What changes Laptop / Budget laptops and most desktops: 8-32 GB of memory, a 2-8 GB graphics card, most Apple Silicon Macs a moderate number of triangles drawn while the view moves; brushes shade continuously on mains power Workstation 64 GB of memory or more, and a graphics card with 16 GB or more or an Apple Silicon Max / Ultra (or another chip whose graphics share the memory) that measures as fast more triangles drawn per frame, larger textures and subdivision limits, shading updated with every dab Software (safe mode) no graphics driver, so the drawing happens on the processor (llvmpipe) the lightest settings, no antialiasing On a laptop running on battery, whatever its profile, SculptForge sends less data to the graphics card per frame and aims for 60 frames a second, and the status bar says so; plugged in again, it goes back. At the top of Edit > Preferences > Performance: Control What it does Detected ... the graphics card, its memory and the profile, and why Measured numbers triangles drawn per second, upload speed, the cost of a brush dab, memory speed, the processor and the system Settings how many triangles the view draws per frame, from what size big scenes use their lighter version while moving, memory and upload budgets, texture and subdivision limits, threads, the target frame rate (60, or 120 / 144 on a fast display) Frame Governor while the view moves, watch how long frames take and draw big scenes' lighter version sooner or later to hold the target frame rate. It only changes what you see while moving, never the model. On by default Re-calibrate measure again (your overrides are kept) Manual overrides choose the profile yourself, or set any of the numbers (empty = automatic); Back to automatic clears them. Overrides are saved at once and kept when you re-calibrate From a shell, sculptforge --calibrate measures and prints the result as JSON. Like the other preferences, these save themselves for the next start. 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 Parts aren't drawn and hidden parts of a Part aren't sculpted (Tool > Visibility). A hidden Part 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 (vertex paint 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 Part doesn't fit, SculptForge doesn't draw it and says so in the status bar instead of failing: hide other Parts 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. Tool > Display > Backface culling (#68, off by default) skips the back faces of any mesh, open or closed, from any view: an open scan seen from behind then draws almost nothing (8M triangles: 3.1 ms down to 0.7 ms a frame), and you see through its openings. Brushes then work only on the faces drawn. 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":"proof-mode-see-it-for-yourself","h":"Proof mode: see it for yourself","t":"Help > Benchmark (or sculptforge --benchmark standard-15m) shows how responsive sculpting is on your own computer, measured the way it feels rather than the way a developer measures it. Its standard scenes are the ones the benchmarks page lists: a procedural head of 15 million (standard-15m) or 33 million (standard-33m) triangles, the same on every computer, sculpted with a fixed stroke set: Clay at 25, 60 and 120 pixels, Move, Smooth and a 240-pixel brush, then a turn of the view (standard runs both sizes). Each reports frame time (p50, p95, p99), how far the stroke trails the pointer in pixels, the worst stall (the longest the screen froze), and peak memory and graphics memory. Without a scene name (sculptforge --benchmark, or Spheres in the dialog) it runs the older size sweep: for each size, 5, 20 and 33 million triangles (and 100 million when there is enough free memory), it builds a sphere with subdivision levels, then plays a scripted pen stroke into the same code your mouse and pen go through, 240 pointer samples a second: a figure eight with a 60-pixel brush, the same with a 240-pixel brush, then a turn of the view. It replaces the scene, so save your work first; Esc stops it. While it runs, a panel in the corner shows: fps and the frame time: the median (p50), and the 95th and 99th percentile, the slow frames you would notice as a hitch. Stroke trails pointer: how far the stroke on screen is behind the pointer, in milliseconds (from the pointer sample the newest drawn dab belongs to until that frame is handed to the display; the display's own refresh comes on top) and in pixels along the path. The memory SculptForge uses. Vertical sync is off during the run so frame times aren't capped at the display's rate (tick Keep vertical sync on to measure with it). At the end a table sums up each mesh and phase, and two files are written: a video of the run with the panel in it (needs ffmpeg; recording costs a millisecond or two per frame) and a JSON file with the results, your processor, graphics card, memory, operating system and the SculptForge version and commit. In the app they go to the benchmarks folder in SculptForge's settings folder (Open folder in the results); from the command line, to the current folder: sculptforge --benchmark standard-15m --benchmark-out mine.json --benchmark-video mine.mp4 sculptforge --benchmark --benchmark-sizes 5,20,33 --benchmark-out spheres.json --benchmark-no-video skips the video, --benchmark-vsync keeps vertical sync on, --benchmark-seconds 6 sets the length of each stroke, and --size 1920x1080 the window (a tiling window manager may choose another size; the result records the one used). Share a result on the benchmarks page as its format description explains."},{"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 When nothing changes, SculptForge draws nothing: the graphics card and processor rest until you move the mouse, press a key, or something finishes in the background. sculptforge --measure-idle 5 sits idle for five seconds (after a short start) and prints the frames drawn and the processor time used. If the view ever stops updating when it should (a driver that misbehaves), start SculptForge with the environment variable SF_CONTINUOUS_REDRAW=1 to draw every frame as versions before 0.9.5 did, and please report it; SF_REDRAW_LOG=1 logs why each frame was drawn. On a very dense mesh a dab can cost more than a frame. The dabs of a stroke then wait in a queue that SculptForge works through for a few milliseconds each frame, reading the pen or mouse in between, so a fast curve stays a curve; once more than about 50 ms of dabs are waiting, every second waiting dab is left out (a wider spacing), so the brush stays close to the pointer and stops soon after you lift the pen. sculptforge --run \"new_sphere\" --measure-stroke 3,200 draws a fast circle for three seconds with a 200-pixel brush and prints how far the dabs strayed from it and the frame times. SF_STROKE_IMMEDIATE=1 places every dab as soon as the pointer moves (versions before 0.9.6), SF_STROKE_BACKLOG=0 never leaves dabs out, and SF_STROKE_LOG=1 logs the queue each frame (with Predictive Strokes, each batch the brush thread places and what packing it for the graphics card cost). SF_PREDICTIVE_STROKE=0 / 1 and SF_DRAFT_STROKE=0 / 1 override the two preferences, and SF_FRAME_LOG=16 logs every frame slower than 16 ms with where its time went. tools/bench_strokes.sh in the source runs the stroke measurement on 5, 21 and 33 million triangle spheres and prints the frame times (mean, 95th and 99th percentile), how far the surface and the preview trail the pointer, press and release, for one build or two side by side. 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: tablets, display, crashes and FAQ","a":"","h":"Troubleshooting: tablets, display, crashes 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. Quick answers: Problem Fix No pen pressure on Windows Switch Windows Ink in the tablet driver and bring the pen back (Pen tablets) The cursor jumps when the pen touches down Edit > Preferences > Tablet > Mouse mode (relative) \"Windows protected your PC\" More info, then Run anyway (First launch warnings) Text and buttons too small or too large Edit > Preferences > Interface > UI scale (details) Menus or shelves look wrong after an update Edit > Preferences > Config > Reset Layout and Shortcuts (Reset the interface) Sculpting feels slow The viewport is slow Lost work after a crash Recovering work after a crash Want the Classic layout back Edit > Preferences > Interface > Look > Layout > Classic"},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes 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. Linux on Apple Silicon (Asahi) and other ARM machines: use the ARM64 download. The x86_64 one runs there only through the FEX emulator, which stops at once with : Unsupported system page size on 16 KiB pages; start it in a 4 KiB-page VM with muvm -- ./SculptForge-linux-x86_64.AppImage if you need it. 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, then read the log file, which holds the same messages."},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes 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: tablets, display, crashes and FAQ","a":"the-viewport-is-slow","h":"The viewport is slow","t":"Check the triangle count in the bar along the top of the window (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 Parts 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 Render > Gaussian Splats 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). Edit > Preferences > Performance: lower Antialiasing (or turn it off), try View resolution 75% or 50%, 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 Part missing from the view with \"Not enough GPU memory\" in the status bar didn't fit on the graphics card: hide other Parts or step down a level."},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes 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 Sculpt > Draw & Tablet. 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). Edit > Preferences > Input and Edit > Preferences > Tablet show \"Pressure: on\" once the pen has pressed, or \"Pressure: not detected\". Without pressure the pen still draws, at full strength. A tablet plugged in while SculptForge runs works straight away; the status bar says \"Tablet connected\" (also through Wacom Bridge). If no pen is detected or pressure doesn't change: Install or update the tablet maker's driver. Windows: SculptForge reads pressure through Windows Ink, and through the driver's Wintab when Windows Ink is off (Wacom Tablet Properties > Mapping > Use Windows Ink). If pressure is still missing, switch that option and bring the pen back to the tablet. See Pen tablets on Windows. 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. The active Part changed by itself: a Part becomes active with Alt+click on it (the keyboard's Alt, a quick click), a triple-click with the mouse or a click in the Parts list; the status bar names it and how. A tablet's ExpressKey set to Alt counts as the keyboard's Alt. The cursor jumps back when you put the pen down elsewhere: the tablet driver is set to mouse (relative) mode. Turn on Edit > Preferences > Tablet > Mouse mode (relative). It also makes the pen relative with the driver in pen mode; the arrow is drawn at the brush while the pen is in range. The pen picks a brush, then stops clicking menus or the canvas until you use the mouse (Huion, display tablets, Wacom; 0.10.8 and earlier): update to 0.10.9 or later. If it still happens, tell us the tablet, its driver version and whether Windows Ink is on. With two screens, the app slows down when the pointer is on the other screen: fixed in 0.10.9; SculptForge now rests only when its window loses focus."},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes 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: tablets, display, crashes 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: tablets, display, crashes and FAQ","a":"hyper3d-rodin-direct","h":"Hyper3D Rodin (direct)","t":"Message What to do Add your Hyper3D API key It stays off until you add your own key (hyper3d.ai > API dashboard) in the Generate 3D window Hyper3D rejected the API key Check the key, or create a new one in the API dashboard Your Hyper3D plan doesn't include this tier Basic API access covers Extreme Low and Low; choose one of those, or upgrade on hyper3d.ai Out of credits on your Hyper3D account Top up on hyper3d.ai Refused the model file The result came from somewhere other than Hyper3D's servers, so SculptForge didn't download it. The model isn't lost: it stays in your Hyper3D account (hyper3d.ai dashboard) under the task id in the message. If it keeps happening, report it"},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes 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: tablets, display, crashes 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, api.hyper3d.com (and Hyper3D's file servers), or the Pollinations.ai text endpoint for the free Brush Lab model."},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes 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: tablets, display, crashes 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 Edit > 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: tablets, display, crashes and FAQ","a":"text-and-buttons-are-too-small-or-too-large","h":"Text and buttons are too small or too large","t":"Edit > Preferences > Interface > UI scale sets the size (Automatic, 100% to 200%) and applies it at once and keeps it for the next start. Automatic uses the scale of the monitor the window is on: on Windows that is Settings > Display > Scale, per monitor, and the interface follows when you drag the window to another monitor. On Linux under X11 it comes from the desktop's font DPI (Xft.dpi); if Automatic looks wrong there, pick a size."},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes and FAQ","a":"my-layout-is-gone-after-a-restart","h":"My layout is gone after a restart","t":"Shortcuts and preferences save themselves; the layout (shelves, trays, open palettes) waits for Edit > Preferences > Config > Save Layout. See The interface."},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes and FAQ","a":"reset-the-interface","h":"Reset the interface","t":"Edit > Preferences > Config > Reset Layout and Shortcuts returns to the built-in layout and default shortcuts. The shortcuts save themselves; press Save Layout afterwards to keep the layout. Revert to Saved Layout goes back to the layout the last Save Layout kept. 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: tablets, display, crashes 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 Edit > Preferences > Hotkeys, where Default shortcuts undoes every change."},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes 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 Shortcut changes and preferences (saved as you change them) and the layout (written by Save Layout) 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 sculptforge.log, sculptforge-previous.log What this session and the last one did, and what crashed (see The log file) 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 Library and picker thumbnails (safe to delete) Your library folder (projects, tools, alphas, images, splats and snapshots shown in the Library) is separate: Documents/SculptForge by default, changeable in Edit > Preferences > Library > Library folder. Tip: To move settings to another computer, copy ui.json, ai.json and the brushes folder. For a shared layout, use Edit > Preferences > Config > Export Interface... and Import Interface... instead."},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes and FAQ","a":"the-log-file","h":"The log file","t":"SculptForge writes what it does to sculptforge.log in its settings folder. Choose Help > Open log folder to open it: System Log file Windows %APPDATA%\\SculptForge\\SculptForge\\sculptforge.log macOS ~/Library/Application Support/SculptForge/SculptForge/sculptforge.log Linux ~/.local/share/SculptForge/SculptForge/sculptforge.log It holds the version, your system and GPU (the OpenGL ... on ... line), warnings and errors, and each command you ran. If SculptForge crashes, it ends with lines starting CRASH: that say what crashed and what was done last. Every start keeps the previous session's log as sculptforge-previous.log beside it, so after a crash attach sculptforge-previous.log to your report (the new sculptforge.log is the session after it). It holds no models and no keys, only command names and messages, which may include file names."},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes and FAQ","a":"a-performance-trace","h":"A performance trace","t":"When SculptForge gets slow, Help > Record a performance trace shows where the time goes. Turn it on, do what feels slow (the stroke, the orbit, the remesh), then choose it again to stop. sculptforge-trace.log beside the log then lists every frame that took longer than 33 ms with its parts (events, dabs, interface, GPU uploads, drawing, GPU time), each stroke's timings, commands that held up the frames, background jobs starting and ending, the mesh size and levels, and on its first line your GPU, driver and CPU. Attach it to your report. It is off by default and costs nothing when off; it stays small (2 MB, then the older lines move to sculptforge-trace-previous.log) and never leaves your computer."},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes and FAQ","a":"recovering-work-after-a-crash","h":"Recovering work after a crash","t":"SculptForge autosaves unsaved work every 5 minutes by default (Edit > 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 snapshots. The dialog also points to the crashed session's log file."},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes and FAQ","a":"frequently-asked-questions","h":"Frequently asked questions","t":"Can SculptForge open another sculpting app's own project files? Not directly: those formats are proprietary and undocumented. Export OBJ or FBX from that app, or use the Bridge. Does it have subdivision levels, voxel remesh, quad remesh or UVs? Yes: Voxel Remesh, Quad Remesh (with Project Detail 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 dynamic topology (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: tablets, display, crashes 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. After a crash, the log: sculptforge-previous.log from Help > Open log folder (see The log file). When it is slow, a performance trace of the slowdown. 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: tablets, display, crashes 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 explains the terms SculptForge uses (Parts, Forge Spheres, Vertex Paint, Library...). The command palette (F3) also finds a feature by what it does: type \"remesh\", \"groups\" or \"folders\". See also the Quick tour for experienced sculptors."},{"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 Quad Remesh 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) How far a gizmo move eases in from the mask's edge, as a share of the Part's size: a soft joint when posing. See Gizmo Generate 3D Turn an image or a description into a sculptable model. See Image and text to 3D Gizmo The Move / Scale / Rotate handles (W E R) for placing and posing a Part or its unmasked part. See Gizmo 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 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 Part that has a texture: its vertices (vertex paint) or its texture. Top shelf, next to Rgb. See Texture painting Quad Remesh SculptForge's automatic quad retopology, in Tool > Geometry. See Quad retopology Mirror plane (Quad Remesh) The plane Quad Remesh'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 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, Quad Remesh): 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 3D position on the model decid"},{"p":"glossary.html","c":"Glossary","a":"see-also","h":"See also","t":"Welcome to SculptForge The interface Keyboard and mouse reference"},{"p":"discord.html","c":"Show SculptForge on Discord","a":"","h":"Show SculptForge on Discord","t":"Let your Discord friends see that you're sculpting. Discord's profile and member list then show SculptForge, its icon and how long you've been at it. It's off until you switch it on."},{"p":"discord.html","c":"Show SculptForge on Discord","a":"switch-it-on","h":"Switch it on","t":"Open Edit > Preferences > Integrations. Check Show SculptForge on Discord. Keep the Discord desktop app running on the same computer. Your status appears within a few seconds. Two extras, both off until you check them: Show the monthly challenge adds a line \"Monthly challenge: theme\", with the theme you type in the box under it (64 characters at most). Handy while you work on the community's monthly challenge. Show the file name adds the name of the file you have open, for example kraken.sfproj. Only the name, never the folder it's in. Uncheck Show SculptForge on Discord and your status is cleared at once. Quitting SculptForge clears it too, and so does a crash. If you quit and restart Discord, your status comes back within a few seconds."},{"p":"discord.html","c":"Show SculptForge on Discord","a":"what-is-sent-and-where","h":"What is sent, and where","t":"Sent When The SculptForge icon (Discord loads it from sculptforge.app) and name while it's on The time you started (Discord shows the elapsed time) while it's on \"Monthly challenge: theme\" only with Show the monthly challenge The file's name (not its folder) only with Show the file name Nothing else: no folders or paths, no user name, no details about your model. SculptForge passes this to the Discord app on your own computer only, through Discord's local connection; it opens no network connection and no port for it, and never asks Discord for anything (no sign-in, no invitations, no account access). Discord then shows your status to your friends and to the servers you share, as it does for games. Note: Discord shows your status only if Display current activity as a status message is on in Discord's User Settings > Activity Privacy."},{"p":"discord.html","c":"Show SculptForge on Discord","a":"if-it-doesnt-show","h":"If it doesn't show","t":"Check that the Discord desktop app is running and you're signed in. The website version of Discord can't show it. Discord in a Flatpak or Snap works; a Discord running as another user (or as administrator on Windows while SculptForge isn't) is ignored on purpose. Started Discord after SculptForge? It connects on its own within a minute."},{"p":"discord.html","c":"Show SculptForge on Discord","a":"see-also","h":"See also","t":"The interface Troubleshooting"}];+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 Parts, how to generate models with AI, and how to get your work into a game engine, a film pipeline, Blender or another sculpting app. It is updated with every release; What's new lists what changed. Read it inside SculptForge (Help > User Guide, or Shift+F1) or on the SculptForge website."},{"p":"index.html","c":"SculptForge User Guide","a":"start-here","h":"Start here","t":"You want to Read Install it Install SculptForge: downloads for Windows, macOS and Linux Set it up on Windows The Windows notes: SmartScreen, pen tablets (Windows Ink, Mouse mode), screen scaling Make your first sculpt Your first sculpt in 10 minutes: a cute owl head from the default sphere Start from a head or body Starter meshes: base meshes with clean quads, File > New from Starter Mesh Find your way around The interface: the menus File, Edit, Sculpt, Paint, Mesh, View, Render, Help, the shelves and the Tool panel; Navigating the view Learn the brushes Sculpting and brushes Switch from another sculpting app Quick tour for experienced sculptors (the Classic layout and keys) and the Glossary Switch from Blender Blender keys, and Working with Blender for the bridge add-on Fix a problem Troubleshooting 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 Your first sculpt in 10 minutes What's new Quick tour for experienced sculptors Install SculptForge on Windows, macOS and Linux 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 Brush packs: sixty built-in brushes Masking Face Groups and visibility Selection sets and morph targets Parts Linked Duplicates Forge Spheres Tube: draw in 3D space Vertex Paint and materials Texture painting UV Editor Material painting (PBR) Fill layers, Mesh Maps and Material Recipes Sculpt layers and blend shapes Facial shapes and live face Subdivision levels Micro levels: hundreds of millions of polygons Dynamic topology Sculpt Timeline and timelapse Moving, rotating and posing (Gizmo) Subdivide, remesh, decimate and LODs Cut: line, lasso, rectangle and polyline 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 Bridge Export presets Working with Blender Working with Maya Projects, autosave and Snapshots Scripting and automation Packs and macros SculptForge for studios Security overview for IT reviews"},{"p":"index.html","c":"SculptForge User Guide","a":"reference","h":"Reference","t":"Keyboard and mouse Performance and big meshes Troubleshooting: tablets, display, crashes and FAQ Glossary Show SculptForge on Discord"},{"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 experienced sculptors already know. Its menus are grouped by task (File, Edit, Sculpt, Paint, Mesh, View, Render, Help), with shelves around the canvas, a Library of thumbnails and pop-up pickers; a Classic layout with alphabetical palettes is one click away. It runs natively on Windows, macOS and Linux, starts in a moment, works offline and costs nothing. The Classic sculpting keys and gestures are one choice away: answer Classic sculpting keys when the first start asks what you are coming from, or pick Classic in Edit > Preferences > Input. See Quick tour for experienced sculptors. 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. SculptForge stays free and works the same for everyone; nothing is ever paywalled. A membership adds betas and early builds (from SculptForge 1.0, each release about two weeks early), a vote on what gets built, Member Requests (ask for a brush, alpha or material) and your name in the credits (every release stays free for everyone; bug-fix and security releases go out to everyone the same day): Help > Support SculptForge... opens sculptforge.app/support.html in your browser, where you can become a member. That is all it does: the app has no payment code, no account and no licence check. Members are thanked by name in Help > About; the small heart at the right of the top bar opens the membership page too (members see a small badge there instead). The first start shows the memberships once (Edit > Preferences > Support > Show the memberships shows them again). After that, a small card along the bottom of the canvas may come at a good moment: about 20 minutes of sculpting, a Save Render, the first start after an update, the monthly challenge results, or a milestone (your 10th start, 10 hours of sculpting, your 100th save, counted on your computer only and never sent). It comes at most once a week and never mid-stroke. Not now waits a week; after the third, a month; after the sixth, it only comes with an update. I'm already a member signs in with GitHub (as member builds do) and hides it for good."},{"p":"welcome.html","c":"Welcome to SculptForge","a":"what-you-can-do-with-it","h":"What you can do with it","t":"Sculpt with more than twenty built-in brushes (Standard, Clay, Clay Block, Sharp Crease, Move, Smooth, Inflate, Pinch, Flatten, Crease, Trim, Tendril, Layer, Nudge, VDM, the Kelvinlet brushes and more), 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: Ctrl to paint a mask, Ctrl+Shift to isolate a face group. See Masking and Face Groups and visibility. Keep separate meshes as Parts (body, eyes, teeth, armour), each with its own undo history. See Parts. Paint colour on the surface (vertex paint) and look at the model through the built-in Lit Sphere materials or your own. See Vertex Paint 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 voxel remesh), 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 another sculpting app through the Bridge. See Exporting, Unreal and Bridge. 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.10; see What's new). Some things experienced sculptors rely on are still on the roadmap: Painting across UDIM tiles (the UV Editor lays them out; painting covers tile 1001). Booleans and stencils. Others are not on the roadmap: poly modeling, the 2.5D canvas, and reading other sculpting apps' own project files directly. Not yet: where a chapter describes a 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":"quick-tour-for-experienced-sculptors","h":"Quick tour for experienced sculptors","t":"Most habits carry over, and Edit > Preferences > Interface > Look > Layout > Classic brings back the alphabetical palette bar. 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 Parts, Masking and Face Groups sub-palettes, B opens the brush pop-up with the same letter keys (B, S, T picks Standard), , opens the Library, your preferences save themselves, and S U I O, Space, Ctrl+W and the mask keys do what your hands expect with the Classic sculpting keys on (Edit > Preferences > Input). Quick tour for experienced sculptors lists what is the same, what differs and every shortcut side by side; the Glossary explains SculptForge's terms."},{"p":"welcome.html","c":"Welcome to SculptForge","a":"how-this-guide-is-organised","h":"How this guide is organised","t":"Getting started: installing (with Windows notes), the interface, navigating the view and troubleshooting. Sculpting: brushes, Brush Lab, masking, face groups, Parts, vertex paint, 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). The form asks for your hardware: operating system, CPU and RAM, graphics card and driver, and your tablet and its driver if you use one. Add what you did just before the problem; see Troubleshooting and FAQ for what else helps. Help > Website & documentation opens the SculptForge website. For questions, tips and showing your work, Help > Join the Discord... opens the invite to the official SculptForge Discord in your browser. Bugs still go to the issue tracker, so they can be tracked and fixed."},{"p":"welcome.html","c":"Welcome to SculptForge","a":"see-also","h":"See also","t":"Installing SculptForge The interface Glossary"},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"","h":"Your first sculpt in 10 minutes","t":"Never sculpted before? In about ten minutes this lesson turns the default sphere into a cute owl head: ear tufts, a heart-shaped face, big amber eyes under stern brows and a little orange beak. It ends with a render you can share. You only need the built-in brushes, a mouse (a pen tablet is nicer, but not required) and these twelve steps. The finished owl The lesson uses the default look: the SculptForge layout, with the menus File, Edit, Sculpt, Paint, Mesh, View, Render, Help along the top, a tool shelf under them, the brushes along the bottom and the Tool panel on the right. If you switched to the Classic layout, the Classic layout notes say where things are there; Preferences, for one, has its own name in the palette bar there instead of sitting under Edit (where Preferences is). Every step can be undone with Ctrl+Z, so experiment freely. Each brush remembers its own size. To set it, hold the cursor over the canvas, press S, type the number the step gives and press Enter (or drag the slider that appears). [ and ] make it smaller and bigger. Tip: Help > Your first sculpt (10 min) opens this lesson inside SculptForge any time; Shift+F1 hides it and shows it again where you left off."},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"1-start-with-a-sphere","h":"1. Start with a sphere","t":"Goal: a fresh sphere, seen from the front. Press Ctrl+N (File > New Sphere). Press F to frame it. To look around: drag on the empty background to rotate, Alt + drag on the background to move the view, scroll to zoom. Press F again whenever you lose it. Check that X is lit on the tool shelf: symmetry is on, so everything you do on one side happens on the other. The default sphere in the SculptForge layout Tip: right-drag anywhere rotates the view too, even over the model. See Navigating the view."},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"2-pull-up-the-ear-tufts","h":"2. Pull up the ear tufts","t":"Goal: two pointed tufts on top of the head. Pick Move: press 4, or click Move on the bottom shelf. Set its size to 110. Start on the top of the sphere, a little left of the middle, and drag up and out. Symmetry pulls the right tuft. Two ear tufts pulled up with Move Tip: if the view turns instead, you started on the background. Undo and start the drag a little further inside the sphere."},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"3-dig-the-face","h":"3. Dig the face","t":"Goal: two round hollows, the owl's face discs. Pick Clay: press 2. Set its size to 120. Hold Alt and click four times where the left eye goes, a little left of the middle and halfway down. With Alt, Clay digs in instead of building up. Two face discs dug with Alt+Clay Tip: a click is one dab of the brush. Several clicks in one place build up (or dig) more."},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"4-shape-the-beak","h":"4. Shape the beak","t":"Goal: a small pointed beak between the eyes. Pick Inflate: press 5. Set its size to 30 and click three times on the middle line, just below the face discs: a bump. Pick Move (4), size 30. Drag from the bump a short way down: it points. Pick Smooth (3), size 24, and drag once down the beak to tidy it. The beak Tip: hold Shift and drag to smooth with any brush, whenever a stroke leaves a lump."},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"5-divide-three-times","h":"5. Divide three times","t":"Goal: enough polygons for crisp eyes and colours. Press Ctrl+D three times (Tool > Geometry > Divide). Each Divide makes four polygons out of every one and smooths the shape: about 5 million triangles now. Divided three times: the same shape, smoother Tip: sculptors block out the big shapes on a light mesh, then divide for details. Shift+D and D step down and up the levels. See Subdivision levels."},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"6-add-the-eyes","h":"6. Add the eyes","t":"Goal: big round eyeballs in the face discs. Pick Inflate (5), size 52. Click three times in the middle of the left face disc. Symmetry adds the right eye. Eyes inflated in the face discs Tip: Inflate swells the surface along its normals, so dabs make round, even bulges."},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"7-give-it-brows","h":"7. Give it brows","t":"Goal: a V of brows that gives the owl its look. Pick Clay (2), size 30. Drag twice from between the eyes up and out over the left eye. Brows built up with Clay Tip: the angle of the brows sets the mood: up and out for a stern owl, flatter for a sleepy one."},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"8-colour-it-brown","h":"8. Colour it brown","t":"Goal: warm brown feathers everywhere. Open Paint. In Vertex Paint & Color, pick a warm brown in the colour wheel and click Fill. The owl filled brown"},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"9-paint-the-face","h":"9. Paint the face","t":"Goal: soft cream face discs. Press P (or click Paint on the tool shelf): the brush now paints colour without changing the shape. Set its size to 100. Make the edge soft: with the cursor over the canvas press O (Falloff), type 0 and press Enter. Pick a cream colour and click twice on the left face disc. Cream face discs Tip: a soft edge blends one colour into the next, like feathers."},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"10-paint-the-eyes","h":"10. Paint the eyes","t":"Goal: amber eyes with black pupils and a glint. Give the brush a hard edge: O, type -100, Enter. Size 44, amber: click once in the middle of the left eye. Size 24, black: click once in the same spot for the pupil. Size 8, white: click once at the top left of the pupil for the glint. Amber eyes, pupils and glints Tip: C over the model picks up the colour under the cursor, and Alt paints back towards white. See Vertex Paint."},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"11-paint-the-beak-and-tufts","h":"11. Paint the beak and tufts","t":"Goal: an orange beak and darker tuft tips. Size 16, orange: drag down the beak, twice. Soft edge again (O, 0, Enter), size 70, dark brown: click twice on the tip of the left tuft. Press P again to go back to sculpting. Beak and tufts painted"},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"12-shade-it-and-save-a-render","h":"12. Shade it and save a render","t":"Goal: a picture of your sculpt to share. Press M over the canvas and click White: a clean material that shows your colours. Open Render > Materials and click PBR under Viewport Shading: soft studio light with gentle reflections. Turn the view to a three-quarter angle, a little from above, and press F. Click Save Render at the bottom of Render > Materials. The status bar names the picture (twice the size of the view); find it under Library > Image. Size and the shape buttons (1:1, 16:9, 9:16, 4:3) below it make a bigger or differently shaped picture, as a PNG or a JPG. Light, above it, turns the light around the model. Press Ctrl+S to save the project. Render > Materials with PBR shading and Save Render Well done: that's a sculpt, painted and rendered."},{"p":"first-sculpt.html","c":"Your first sculpt in 10 minutes","a":"whats-next","h":"What's next","t":"Share it in #show-your-sculpts on the SculptForge Discord. We'd love to see it. Try every brush and the keys that change them: Sculpting and brushes. Masks by brush, lasso, rectangle and cavity: Masking. Paint layers, cavity paint and Lit Sphere materials: Vertex Paint and materials. Find your way around the menus and shelves: The interface."},{"p":"whats-new.html","c":"What's new","a":"","h":"What's new","t":"What changed in each version of SculptForge, newest first. The first time you start a new version, a window shows its main features, each with a Try it button; Help > What's New opens it again. Below are the last three versions in full, then the older ones in groups. Every detail is in the changelog."},{"p":"whats-new.html","c":"What's new","a":"version-01115","h":"Version 0.11.15","t":"Tube: draw clay tubes in the air like a 3D pen. Tool > Tube > Draw Tube, then drag anywhere: on the model, off it, or out of it. Pen pressure thins the tube; drag its points afterwards to reshape it, then Bake to sculpt it, or draw straight into the active Part with Merge (even edges, ready for dynamic topology). Thanks to GABO on Discord for the idea. Hardware tiers and Turbo: SculptForge sorts your computer into a tier (Essential, Standard, High, Extreme) and switches on what it can carry: more Focus Detail memory, 16K textures. A card on first launch says what it found; the tier sits in the top bar. The new bolt (View > Turbo, Ctrl+Alt+T) trades antialiasing and detail while you sculpt and orbit for speed, and puts everything back the moment you stop. Split > Hidden / Masked / Unmasked (Tool > Parts): move the hidden, masked or unmasked triangles of a Part into a new Part just below it, in one undo step. Asked for by foirgairwolf on Discord. Delete masked (Tool > Visibility) deletes what is masked, as Delete hidden does for what is hidden. Undoable. Smooth or flat per Part, right in the list: click the mark left of a Part's eye to go from the scene's shading to Smooth to Flat. Merge by Distance (Tool > Geometry): merge points closer than a distance, with a live count and the points shown on the model before you click. For unwelded imports. Asked for by foirgairwolf on Discord. Check Mesh (Tool > Geometry): counts non-manifold edges, holes, duplicate, degenerate, zero-area and flipped triangles and isolated points, with a Fix per row and Fix all. Checking never changes the mesh. Recent colours: the last eight colours you painted with sit under the colour picker on the left shelf; click one to paint with it again. Thanks Oslen on Discord. Frame (F) fits the model into the part of the canvas the open Library and the Sculpt Timeline leave free, and the left shelf's brush tiles and colour picker shrink to fit short screens. Pen view speed: Preferences > Tablet > View speed sets how fast the pen turns, pans and zooms the view, apart from the mouse. Turn it down if the view spins too fast with a tablet. Thanks to GonzaloHernandez3D on Reddit."},{"p":"whats-new.html","c":"What's new","a":"version-01114","h":"Version 0.11.14","t":"Deformation stack (requested by foirgairwolf on Discord): Tool > Deformation > Stack bends, twists, tapers, shears, turns, moves, scales, squashes, rounds, boxes, flattens, sags or puts depth on the whole Part, along any of X, Y and Z, with a live preview. Stack steps up, switch them on and off, repeat one, then Apply (one undo step), Apply Selected or Reset. Every step is a command too: deform_stack ops=\"bend 45 y soft; twist 90 y\". Exact size (requested by foirgairwolf on Discord): Tool > Deformation > Size shows the Part's width, height and depth in scene units; drag one or type an exact value to resize it, with Uniform keeping its proportions. Membership moments: the small membership card can now also come at a milestone (your 10th start, 10 hours of sculpting, your 100th save; counted on your computer only, never sent) and says the true number. After a third Not now it waits a month, after a sixth it only comes with an update. A quiet heart at the right of the top bar opens Help > Support SculptForge...; members see a small badge there instead. Requested by a member: changes members asked for through Member Requests are marked in What's New. Slimmer Library and timeline: the Library strip and the Sculpt Timeline under it take about a third less of the viewport's height. The timeline is one thin row (the full strip is one click away, or Edit > Preferences > Interface > Compact timeline), and you can drag the Library's edge to size its thumbnails. Thanks factoberplay on YouTube."},{"p":"whats-new.html","c":"What's new","a":"version-01113","h":"Version 0.11.13","t":"Remove flat background: Image to 3D drops the flat plane a picture's background often turns into (a wall behind or a ground under the subject) before the model lands. On by default in Generate 3D; Undo brings a removed plane back. Thanks fenix on Discord. Linked Duplicates: Tool > Parts > Linked Duplicate makes a copy that shares the Part's mesh but sits in its own place. Sculpt, paint or mask any of them and all change; move, turn or scale each with the Gizmo. Make Unique gives one its own mesh again. Hundreds of copies cost about one mesh. Orbit lock: View > Orbit lock turns the view about one axis only: Free, Y (turntable), X or Z (Alt+Shift+F / Y / X / Z). The axis gizmo shows which axis is locked. Thanks foirgairwolf on Discord for the idea. Version at a glance: the window title and the top bar show the SculptForge version, so a screenshot says which one you run. A beta's tag shows in the accent colour. Reconstruct Subdiv keeps UVs on the lower levels of a high-poly that was unwrapped on its own: no more faces stretched across UDIM tiles, even with overlapping islands. Timelapse videos of dense sculpts no longer flicker (Edit > Export timelapse...). The membership card now shows the Studio membership's flat price for any number of artists."},{"p":"whats-new.html","c":"What's new","a":"version-01112","h":"Version 0.11.12","t":"Names you type in Chinese, Japanese or Korean (Parts, folders, layers, brush sets, files, Library items) draw with your system's fonts instead of ?, in any interface language. After Restart to update on Linux, the previous version quits instead of staying hidden in the background (it kept showing SculptForge on Discord). Discord shows the outline cube icon."},{"p":"whats-new.html","c":"What's new","a":"version-01111","h":"Version 0.11.11","t":"Brush sets: save the bottom shelf and its brushes' keys as a named set (Wood, Metal, Stone...) and swap both in one step from Sculpt > Brush > Brush set, the shelf's right-click menu or F3. Asked for by @NicTanghe. Creature bones: Append > Insert on the model > Creature bones is a built-in set of original fantasy creature bones (skull, jaw, teeth, horns, spine, ribs, limb and wing bones, claws, tail): pick one and drag it onto your model, no file needed. Thanks @kenttumanda123-netizen (#154). Floor grid: View > Floor grid draws a faint grid on the floor the model stands on, for grounding, perspective and lining up Parts. Off by default. Maya Live: turn on File > Maya > Live (and Live on the Maya shelf) and each app sends what you change by itself, 300 ms after a stroke or edit, only the Parts that changed. Thanks @tristratos (#42). Maya Live link: File > Maya > Live link... connects SculptForge and Maya on this computer so Maya follows your stroke while you draw it. It asks every time, is off at every start, and the ember Live link on chip in the top bar turns it off. Package managers: the install guide lists where SculptForge is today: Homebrew available, winget and Omarchy in review, the AUR package ready to publish, apt and dnf repositories on the way. Thanks @NicTanghe (#149). Stencil: lay an image over the view and sculpt or paint through it (Sculpt > Alpha > Stencil). Move, scale and turn it on the canvas with Adjust, stroke over it, turn the model and repeat. Sculpt brushes take its brightness, Vertex Paint its colours; Tile repeats it across the view. Dynamic topology no longer shows a long spike and a patch of broken faces after zooming in and sculpting (only the display was wrong: Undo or the next strokes put it right) (thanks @editordenis4-collab, #153). Big brushes on big meshes follow the pen closer on 4-core machines and settle sooner after pen-up."},{"p":"whats-new.html","c":"What's new","a":"version-01110","h":"Version 0.11.10","t":"Insert sets: Parts > Append > Insert on the model > Insert set from file... or from folder... loads a kitbash set (a file with several objects, or a folder of meshes); pick one in its thumbnail window and drag it onto the model, [ and ] step through the set. Sculpt the Part under the cursor: point at another Part and press Alt+Q (as in Blender, in every input style): it becomes the Part you sculpt, and the view stays where it is. Real-world size: parts for 3D printing keep their size through every export. Pick the unit sizes show in (mm, cm, m, in) in Edit > Preferences > Interface > Units; Tool shows the Part's size and File the size exports write. OBJ and PLY files can be read in mm, cm, m or in (OBJ/PLY in). Asked for by @Swar55. Spanish, Traditional Chinese and Simplified Chinese now cover the whole interface: Generate 3D (tabs, services, hints, Quad Remesh, Generate 3D model, Quick shapes), the About box, Proof mode, the phone link, the brush gallery, Brush Lab, splat training and about 400 other labels that stayed in English. Fewer shards when sculpting rough micro-level surfaces (Clay strokes ending where hair or strands meet skin). Clay over rough strands can still leave small steps; a fuller fix is coming. Paint with alphas: vertex paint now follows the brush alpha with every stroke (Drag Stamp, Dots, Spray), so a Cracks stamp paints cracks instead of a soft round spot. Thanks @fxrtst. Full detail after a new paint layer: on dense meshes, adding a paint layer no longer leaves the top subdivision level looking unsubdivided until a restart. SpaceMouse with a pen: turning the cap while the pen hovers or rests on the model should no longer move the cursor or the model; tell us if it does. Thanks @fenixpoints. Smoother view on big models: the processor prepares the next frame while the graphics card draws this one, so turning the view and sculpting on large meshes run at up to twice the frame rate on some computers."},{"p":"whats-new.html","c":"What's new","a":"version-0119","h":"Version 0.11.9","t":"Line Gradient: Color > Line Gradient, then drag across the model: the paint colour runs into a second colour (or fades out) along the line; drag its ends to adjust it. Thanks @Devon0209 (#99). Part folders: in Tool > Parts, group Parts in folders (drag them in and out), fold, rename, hide or move a whole folder at once. Hyper3D Rodin, direct: Generate 3D > Hyper3D Rodin (direct) runs Rodin Gen-2.5 on Hyper3D's own service with your own Hyper3D key, from an image or a description, in five tiers from Extreme Low to Extreme High. It stays off until you add your key, which is kept in the system keychain; your image or description goes to Hyper3D only, and generations are billed to your Hyper3D account. Rodin through fal.ai stays as it was. Paint stays while the view moves: on dense meshes, vertex paint, paint layers and the mask no longer vanish while you orbit or paint and pop back at rest. Input style keys after a restart: the Blender, Classic and Maya styles keep every key when SculptForge starts again (F for the Size slider in the Blender style, 9 for a Snapshot with the Classic keys). Auto UV never freezes the app: the uv_auto command from the console, a script or an AI tool now unwraps in the background like the Tool > Texture Map > Auto UV button, which gains a Cancel button beside its progress. Faster Pack: UV Editor > Pack across a UDIM grid takes well under a second on most models (it could freeze the app for half a minute), runs in the background with a progress bar and Cancel, and lays islands out tighter. Unwrap runs in the background too."},{"p":"whats-new.html","c":"What's new","a":"version-0118","h":"Version 0.11.8","t":"Edit > Preferences... in the Classic layout too: Preferences is its own palette there, and now Edit also opens it. The guide says where Preferences is in each layout (also Ctrl+, or F3 > Preferences). New app icon: an orange cube is the app icon in the taskbar, dock and title bar; it stays sharp at small sizes. The bust and anvil stays the SculptForge brand. Library: one click uses a brush, alpha or material. Double-click still works. Maya bridge, fewer clicks: what Maya sends loads by itself, Send to Maya is one click in the top bar, and the Maya shelf's new Auto loads what SculptForge sends. Thanks @tristratos. Easier to read view axes: the corner axes now show X, Y and Z in filled circles, with smaller rings for the opposite ends; the ends pointing away are smaller and fainter, on a soft disc that reads on dark and light backgrounds. Click an end for that view, click it again for the opposite view, drag on the disc to orbit; an exact view's name (\"Front view\", \"Top view\"...) shows under it. Reconstruct Subdiv works on open meshes such as UV-tiled panels, and the lower level keeps each face's UVs. Drag Stamp with a pen: a stamp (a vector displacement or any brush) dragged to size keeps its strength when you lift the pen, instead of going weak or vanishing."},{"p":"whats-new.html","c":"What's new","a":"version-0117","h":"Version 0.11.7","t":"Smoother view on very dense meshes: a scan or import with more triangles than your computer draws comfortably now draws a lighter version of itself while you turn the view, and the real detail as soon as the view rests. Parts you sculpt always show in full detail. Orbiting a 28-million-triangle scan on an entry-level machine is about twice as smooth: its slowest frames go from 24 to 12 ms."},{"p":"whats-new.html","c":"What's new","a":"version-0116","h":"Version 0.11.6","t":"Empty shelves hide: a shelf you empty is hidden outside Customize Shelves and the canvas takes its room; it comes back while customizing so you can drop buttons onto it again. Studio controls: IT can deploy a policy file that locks AI, network features, AI providers, AI tools and updates (Managed by your studio shows on locked settings), keep an audit log of every AI action, and sign artists in with the studio account (the guide's \"SculptForge for studios\" page, IT deployment). AI providers: Edit > Preferences > AI > Provider has presets for Anthropic, OpenAI, Ollama, LM Studio, vLLM, llama.cpp, a LiteLLM studio gateway and OpenRouter. Keys now live in your system keychain."},{"p":"whats-new.html","c":"What's new","a":"version-0115","h":"Version 0.11.5","t":"Help > Connect an AI tool is now the one guide to working with an AI tool, on one screen: pick your tool and copy its command, turn on Let AI tools control this window right there, see what happens next (the 6-digit code, the AI connected badge, AI: steps in Undo, what asks you first), and copy an example prompt. The AI blocks out a starting point; you do the art. The brush ring shows the new size while you set it: with the S pop-up open, dragging or typing a size draws the ring at that size on the model, where you pressed S; O shows the Falloff ring the same way. Simplified Chinese: Preferences > Interface > Language has a Simplified Chinese button, with mainland terms and glyph shapes. Paint menu: no longer jitters on short screens (1280x720 fullscreen); a menu taller than the screen scrolls smoothly."},{"p":"whats-new.html","c":"What's new","a":"version-0113","h":"Version 0.11.3","t":"The app icon is now the orange SF mark, as on the website; it reads at task bar size. Help > Connect an AI tool: use SculptForge from Claude, ChatGPT (Codex CLI), Gemini (Antigravity CLI), Grok (Grok Build), Cursor, VS Code and more. Pick your subscription; the window shows the exact command or settings for your install, with Copy buttons. Claude Desktop installs it from a bundle on each release. Remeshing an open Part stays solid: Quick Remesh and Tool > Remesh > Voxel Remesh cap open borders (the Stylised Head's neck, a cut) before remeshing, so the result is one closed surface, not a shell full of holes. A Part that can't be made solid stays as it is, and the status bar says why. UV Editor at large UI scales: the toolbar wraps on a 4K screen at 240 %, so On model: Colours / Checker and Frame are all visible and each takes its own click. Dynamic on a subdivided model: turning on Dynamic on a Part with subdivision levels now offers Freeze Levels and Turn On Dynamic: the level you see becomes one plain mesh (Ctrl+Z brings the levels back). Saved views: View > Views has Front, Back, Left, Right, Top and Bottom (Numpad 1, 3, 7; Ctrl for the other side) and Save View for your own named camera angles; Numpad 0 goes back to the last one. They are saved with the project. A readable mask: masked areas show a soft, dark tint instead of near-black, with Mask darkness in Preferences > Interface and Tool > Masking. Dense wireframes no longer turn into a dark moire. Easier to see: options that are on stand out in every colour scheme, and Quad Remesh guide curves draw smooth with an outline. Safer levels: in Tool > Geometry, Divide (keeps levels) and Subdivide (removes levels) no longer sit together, Micro has its own group, and Subdivide, Delete Lower and Delete Higher ask before removing levels (with Don't ask again for Subdivide)."},{"p":"whats-new.html","c":"What's new","a":"version-0112","h":"Version 0.11.2","t":"Faster pen-up on dense scans: with a micro level, a big brush stroke on a dense scan finishes sooner after you lift the pen. Smoother orbit after big strokes: orbiting a dense scan with a micro level right after big strokes is smoother on slower computers; the shading catches up while the view moves and finishes when it stops. Transforms into a sculpt layer: with a layer active in Tool > Layers, Move, Scale and Rotate (the Transform gizmo, masked or not) record into that layer like a stroke: the base mesh stays, the layer's weight dials the move in and out. With Base mesh active they move the base and every layer, as before. Thanks Devon0209 (#133). Rotation for VDM stamps: with the VDM brush, Brush > Vector Displacement > Stamp rotation has Follow stroke direction, Angle and Angle jitter (a random turn per stamp), kept per brush. Brush files keep the alpha's Angle and Angle jitter too, so shared brushes turn their alpha the same way. Thanks DonnieAlex (#136). Maya style view keys: hold Alt, then add Ctrl, and a left drag rolls the view; Alt+F frames the active Part and Alt+H resets the view. Edit > Preferences > Input > Wheel zooms toward the pointer keeps the point under the pointer in place (on with the Maya style, a checkbox in the others). Thanks RodTDai (#134). UDIMs in Columns x Rows: UV Editor > Pack has Columns and Rows (1-10 each) instead of a tile count, so a 10 x 2 layout fills 1001-1020 and 4 x 3 stays four tiles wide. Thanks RodTDai (#135). Benchmark on slower computers: Help > Benchmark no longer stops at \"settling\" when the scene takes a few seconds to open. New icon and logo. Spanish and Traditional Chinese, complete: every menu, panel, tooltip and Ctrl-help text is now translated in both languages (UV Editor, Quick Remesh, Preferences > Input, Packs, Bake and the rest). Record a performance trace (Help menu, #127): turn it on, do what feels slow, turn it off and attach sculptforge-trace.log (Help > Open log folder) to your report. Traditional Chinese: Preferences > Interface > Language has Traditional Chinese: it puts the menus, palettes, shelves and messages in Traditional Chinese (thanks yoyomaimai). Brush and tool names stay in English. Clean creases on micro levels: Sharp Crease, Crease and Pinch at full strength no longer leave random noise on a micro level. The title bar counts the micro triangles beside the triangles, and Wire shows the level below the micro level on the micro surface. AI off means off in the menus too: with Edit > Preferences > AI > Enable AI features off, the Mesh menu's section is From Image (Relief, Inflate, Stamp) instead of Generate 3D. Voxel Remesh up to 512: the Tool > Remesh Resolution slider now goes from 32 to 512, as the remesh command does. A pen resting on the tablet no longer blocks the mouse or trackpad: lay the pen down and the cursor, the shelf buttons (the mirror's X too) and the menus answer the mouse at once."},{"p":"whats-new.html","c":"What's new","a":"version-0111","h":"Version 0.11.1","t":"Organise your Lit Spheres: right-click one of your own in the material picker, Render > Materials or the Library and choose Rename... or Move to folder; sub-folders of the Lit Spheres folder show as headings. Drop an image onto the Library's Material tab to load it. Search for \"material capture\" finds them too. Founding Members and Member Requests: the first 100 members are Founding Members for good (a badge, their name in the credits, their price locked for as long as they stay), and each month every member can ask for a brush, an alpha or a material in #member-requests on Discord: we make it, credited to them. A small membership card shows now and then at a good moment (never mid-stroke, at most once a week); members sign in once with I'm already a member and it never shows again. Membership, simplified: two memberships instead of four. Member ($5 a month or $48 a year) gets betas and early builds, the monthly feature vote, Member Requests, #members and a name in the credits; Studio ($150 a month) covers up to 10 artists, with priority support and a private channel. Help > Support SculptForge... shows both. Every release stays free for everyone. One-click update: on the Linux AppImage and on Windows (installer or portable zip) the update banner has an Update button: it downloads the new version in the background, checks its signature and checksum, and installs it on Restart now or when you quit (Later). The old version is kept until the new one has started, and put back if it doesn't. Package-manager installs show what to run instead. Member builds in the app: members sign in with GitHub in Edit > Preferences > Updates > Member builds (a code to enter on github.com/login/device) and get the early builds through the same Update button. Big meshes are faster: a one-time tip: the first time you open a scene over about 20 million triangles, a note along the bottom of the view says what got faster and names the two settings that help most on big meshes (Preferences > Performance > Background Preview and View resolution), with a button that opens them. It shows once and never again. Pen pressure per brush: Brush > Pen pressure sets Size and Strength to Use global, On or Off for the brush you hold (also in Brush Lab and Edit > Preferences > Tablet). Grab brushes start with Size off. Quick Remesh: turn it on in Tool > Remesh, then press Shift+R, or hold N and drag on the background, to remesh the active Part in the background while you keep sculpting. Remesh after each stroke does it by itself when a stroke stretched the surface. Rodin 2.5 in Generate 3D: Generate 3D > fal.ai > Model now offers Hyper3D Rodin 2.5 and Rodin 2.5 Fast, from an image or a description, with your fal.ai key. Studio mode for studio builds: no outside connections, updates only from the studio's own channel. Touch and trackpad navigation: two fingers pinch to zoom and twist to roll the view; the SpaceMouse holds still while you sculpt. Preferences save themselves: key style, shortcuts, tablet, interface, performance and radial menus are kept a moment after every change, with nothing to press. The layout (shelves, trays) is kept with Edit > Preferences > Config > Save Layout. Thanks fenixpoints (#117). I is Falloff with SculptForge keys (U stays Intensity); the Classic sculpting keys are unchanged."},{"p":"whats-new.html","c":"What's new","a":"version-0110","h":"Version 0.11.0","t":"Fast Big Brushes (Experimental): a new way to place big brushes on dense meshes, off by default. Try it on a heavy model with a big Clay or Standard brush and tell us how it feels: Preferences > Performance > Fast Big Brushes (Experimental). Brush packs: sixty new built-in brushes in six packs (Clay & Form, Hard Surface, Organic & Skin, Cloth & Folds, Damage & Wear, Ornament), each with its own alpha and a one-line description; see Brush packs. A-Z everywhere: brushes, alphas, materials and the Library list A-Z; Sort switches to the most recently used first or (brushes, alphas) by pack. Alphas get a filter field. Masking panel: Tool > Masking is one panel of buttons with pictures: the Shapes, Mask by (cavity, peaks, face group, colour, facing, border) and Adjust (grow, shrink, sharpen, blur, invert, clear, all). Quick tour: Help > Quick tour (or Sculpted before? Take the quick tour in the welcome) shows in ten short slides where remeshing, dynamic topology, quad retopology, levels, masking, cut, brushes and baking are, each with a Show me button that opens the panel. The guide has it too: Quick tour for experienced sculptors. Live Move (experimental): Preferences > Performance > Live Move. The graphics card draws the Move brush's drag from where the surface started, so it keeps up with the pen on any mesh size, and the move is applied once, exactly, when you lift the pen (Performance). Background Preview (experimental): Preferences > Performance > Background Preview. On dense meshes, the dabs a big brush is still working out show as a preview under the pen, so the stroke no longer trails behind it. The finished sculpt is the same either way. Fast Upload (experimental): Preferences > Performance > Fast Upload. Sculpted changes reach the graphics card through shared memory and a copy on the card, instead of a copy by the driver during the frame. Pattern brushes on micro levels: Dragon Scales, Skin Pores, Stone Carve and the other pattern brushes keep their pattern on a micro level, and carving ones (Wrinkle) carve. Cmd+, opens Preferences (Ctrl+, on Windows and Linux). Show SculptForge on Discord: Edit > Preferences > Integrations lets your Discord friends see you're sculpting, with the elapsed time and, if you like, the monthly challenge's theme or the file name. Off by default."},{"p":"whats-new.html","c":"What's new","a":"version-01011","h":"Version 0.10.11","t":"Update channel: Preferences > Updates > Update channel picks Stable (finished releases, the default) or Preview (betas), which also offers the betas of the next version, a couple of weeks before it ships. A beta says so in the title bar and About (\"0.11.0 Beta 1\"). Problems in a beta go to the Discord's #bug-reports. High-DPI laptops: on a Windows laptop at 150-200 % scaling the window opens inside the screen at a size the interface fits, and nothing runs past its edges. Right tray in every look: Forge Terminal, Phosphor and Blueprint open the right tray on 1280 px screens, as Classic does. QuickMenu: square thumbnails and the look's own colours. Faster Voxel Remesh: Tool > Remesh > Voxel Remesh is about 3-4 times faster (a 500,000-triangle sculpt at the default resolution in about a third of a second) and runs in the background with a progress bar and Cancel, so the app never freezes while it works. Our own names, everywhere: the keymap is now Classic sculpting keys with the Classic layout, the exchange menu is File > Bridge (Send, Receive, Import / Export Bridge file), and the brushes are stored as Sharp Crease, Clay Block and Tendril. Older projects, brush files, hotkeys, shelves and radial menus load as before."},{"p":"whats-new.html","c":"What's new","a":"version-01010","h":"Version 0.10.10","t":"Shapes in the stroke popup: press G and pick Mask Pen, Lasso or Rect, or Cut Line, Lasso, Rect or Polyline. A plain drag then masks or cuts with that shape, no Ctrl or Ctrl+Shift held (with a mask shape on, Ctrl unmasks). Pick it again to turn it off. Background jobs keep your Part: a Quad Remesh, Voxel Remesh, Auto UV or Unwrap that finishes after you picked another Part puts its result on its own Part; the Part you picked stays active. SpaceMouse detection (#104): more 3Dconnexion devices are recognised (by name, also over Bluetooth), and Edit Preferences > Input > SpaceMouse lists every controller SculptForge sees, says when another program (3DxWare, spacenavd) holds the device, and has Copy device report for bug reports. Also new since 0.10.9 (missing from its notes): the brush ring is a true circle lying on the surface, symmetry copies show as dots, the crosshair stays while you turn the view, and Preferences > Cursor > Hide ring while stroking leaves only the dot while you sculpt (#88); drag empty panel space, or middle-drag anywhere in a panel, to scroll it with a pen (#100); Neutral is the default look for new installs; Look > Outlines (#98); the Strokes ring on J. Close Holes: Tool > Geometry > Close Holes caps every open boundary of a Part with a patch that follows the curve of the surface around it. Clip: Tool > Cut > Clip presses everything on one side of a line, or outside a lasso or rectangle, flat onto the shape. Nothing is removed. Use it for hard-surface planes and clean silhouettes. X-Ray: the X-Ray button next to Solo shows the active Part through the others. It is also in View. Light: Render > Materials > Light turns the light around the model with a small pad, and sets its intensity and ambient light. View resolution: View or Preferences > Performance draws the 3D view at 75% or 50% for slow GPUs. Save Render sizes (up to 4096 px), shapes (1:1, 16:9, 9:16, 4:3) and JPG. Membership card: a cleaner look, with a calm warm light instead of the sculpt picture, and the perks now say it plainly: members vote on what we build next (#feature-vote on Discord; anyone can suggest in #ideas)."},{"p":"whats-new.html","c":"What's new","a":"version-0109","h":"Version 0.10.9","t":"Each brush keeps its own settings: Size, Intensity, Falloff, Colour intensity, stroke and alpha follow the brush, custom and Community brushes included. Brush > Save Brush Settings keeps them for the next start, Reset Brush to Default puts back the shipped values, and Preferences > Input > Share size and intensity across brushes keeps the old way (#78). See Sculpting. Alpha options (Alpha palette): Follow stroke direction turns the alpha along the stroke, smoothed as Blender's Rake does; Angle and Angle jitter turn it by a fixed or a random amount; Tile repeats it inside the brush. They work with custom and Community brushes too, and each brush keeps its own (#76). See Alpha options. Blender style: Alt+drag masks on the model and Ctrl+Alt+drag unmasks, as in Blender 5.1 and later; beside the model Alt+drag still turns the view. Preferences > Input > Emulate 3 Button Mouse makes Alt+drag turn the view everywhere. Shift+F now sets the brush's Intensity, not Smooth's (#77). View > Lock camera (Shift+L): drags that start beside the model sculpt instead of turning the view, and the status bar shows CAMERA LOCKED while it is on (#62). Tablets: plug a tablet in while SculptForge runs and it just works (\"Tablet connected\" in the status bar), also through Wacom Bridge. On Windows, pressure works with the Wacom driver's Use Windows Ink on or off. Preferences > Input shows whether pressure is detected, with a troubleshooting link. The view no longer jumps when the pen comes back into range, and the active Part changes only with Alt+click on the keyboard; the status bar names the new Part. See Troubleshooting. Smaller (or larger) corner axes: Draw > Camera > Gizmo size sets Small, Medium or Large (Navigation). View Figure: turn it on beside Axes for a small head in the corner that turns with the view; click it to snap to the nearest side. Starter meshes: start a sculpt from a human head with eye and mouth loops, a bust, a full body in A-pose, a hand, a foot, an ear, an eye, a stylised head, a creature head, a torso, or a bevelled box, cylinder, capsule or ring, all clean quads at life size with subdivision levels ready. File > New from Starter Mesh, the Library's Tool > Starter meshes, or Start from a head in the welcome. See Projects. Your first sculpt in 10 minutes: a step-by-step lesson for people who have never sculpted. Turn the default sphere into a cute owl head with ear tufts, big amber eyes and a little beak, using Move, Clay, Inflate and Smooth, Vertex Paint and PBR shading, and save a render to share. Start it from the welcome's Start the 10-minute lesson button or Help > Your first sculpt (10 min). See Your first sculpt. Save Render (Render > Materials): the view without the interface, at twice its size, as a PNG in your Library (Library > Image). A new What's New: after an update, a window shows the main features as cards with a picture, one line and a Try it button that opens the feature (switch the look, select the brush, open the membership card...). Help > What's New opens it again; Esc closes it. This chapter shows the last three versions in full and folds the older ones into short groups, on the website too. Image to 3D with no setup: the free default is now Hunyuan3D 2.1, which needs no token. TRELLIS.2 (\"Best detail\") still needs a free Hugging Face token (Preferences > AI); without one, Hunyuan3D 2.1 runs instead and the status line tells you. Your own model choice is kept. See Image and text to 3D. Generated models arrive as clean quads: Quad Remesh is now the default, with one subdivision level holding the detail, so you can sculpt and subdivide straight away. Voxel remesh and Off are still in Remesh. Calm, clear hover: buttons, menus and shelves brighten a little as you point at them, tiles lift a little, sliders show their exact value, and the keyboard focus gets a ring as strong as your Outlines setting. Prefer less movement? Turn on Preferences > Interface > Reduce motion (Interface). Picker thumbnails on top: "},{"p":"whats-new.html","c":"What's new","a":"version-0108","h":"Version 0.10.8","t":"Tablets in mouse mode work again: on some Windows tablets with Mouse mode on (Preferences > Tablet) the brush stopped following the pen in 0.10.7. When the system can't say where its cursor is, the pen now moves the brush by how far it moves, from where it was (#72)."},{"p":"whats-new.html","c":"What's new","a":"version-0107","h":"Version 0.10.7","t":"A clearer membership card: the three memberships side by side with what each one gets you, in your look's colours. Maybe later now hides it for 30 days. New memberships: Supporters get the credits (in the app and on the website), the monthly pack and a vote; Insiders also get daily drops and preview builds about a week early; Studio covers the whole company with a custom studio build (Founding Studio: the first 10 studios lock in $150 a month). Every release stays free for everyone; bug-fix and security releases go out to everyone the same day. Full alphas on custom brushes: at Falloff -100, Clay Slab and the other custom and Community brushes now show the whole alpha to its corners, as the built-in brushes do (#75). A new look: new installs start in Forge Terminal with the Tokyo Night colours and the SculptForge layout: menus by task (File, Edit, Sculpt, Paint, Mesh, View, Render, Help) holding every palette, a status bar and a one-row tool shelf. If you are updating, nothing changes until you say so: a card offers Try it or Keep my layout. Experienced sculptor? Preferences > Interface > Look > Classic layout (or the button in the welcome) brings back the palette bar and the two-row shelf. Six more colour schemes, Match my desktop theme, Phosphor, Blueprint and the Classic look are there too. See The interface. Native Wayland on Linux: every Linux package opens without XWayland, stays sharp at fractional scales and reads pen pressure through tablet-v2. The RHEL and Rocky builds now include libdecor (title bars on GNOME Wayland). See Wayland and X11. Benchmark your machine (Help > Benchmark, or sculptforge --benchmark standard-15m): a procedural 15 or 33 million triangle head sculpted with Clay at 25, 60 and 120 px, Move, Smooth and a 240 px brush, reporting frame times (p50, p95, p99), stroke lag, the worst stall and memory. See Performance."},{"p":"whats-new.html","c":"What's new","a":"version-0106","h":"Version 0.10.6","t":"PBR viewport (Material > Viewport Shading > PBR): see the texture's material as a game engine shows it, lit by an environment: Studio, Photo Studio, Small Studio or Outdoor Sky, with exposure, rotation, the environment behind the model and a choice of tone map. Painted height and normals catch the light. It stays as fast as Lit Sphere on a 20-million-triangle Part. See Material painting. Fill layers (Tool > Paint Layers > + Fill Layer): lay a material over the whole Part through a mask of effects (edge wear, dirt, gradient, thickness, light direction, 3D noise, a painted mask, levels, blur) instead of painting it by hand. Change it any time. See Fill layers. Wear that follows the sculpt: Fill layers read the Part's Mesh Maps (occlusion, curvature, thickness and more), and after each stroke only the part of the maps near the stroke is baked again in the background, so chipped paint and dirt move with the form while you sculpt. Material Recipes: Worn Metal, Painted Edges, Dirt and Dust and Rusted Iron in one click, and your own saved as small files. Packs and macros (File > Install Pack..., Library > Packs): install a .sfpack of brushes, alphas, Lit Spheres, Material Recipes, VDMs, keymaps, pie menus and macros after a review that shows exactly what's inside, its license and its author. Switch packs off, remove them, or make your own with New Pack. Record the commands you run as a macro, edit it as plain text, and run it from F3, a key or a pie menu as one undo step. Packs are data only and macros only run SculptForge's own commands; --no-packs starts without any pack. See Packs and macros. More maps from Tool > Bake: curvature, thickness, position and ID; bake a Part's top subdivision level (or micro level) onto its lowest level without a second Part; UDIM tiles bake as one set of files per tile. See Baking. Forge Spheres with the pointer alone (#8): Drag places child (or Ctrl while you drag) moves a new sphere away from its parent in one drag; Delete Selected, Insert Between and Set as Root work on the sphere you last clicked, and a right click on a sphere opens a menu with the same. See Forge Spheres. Maya zoom (#32): in the Maya input style Alt+right drag now zooms with a sideways drag, as Maya's own dolly (right zooms in). To keep zooming up and down as before, choose Preferences > Input > Zoom drag > Up and down. Invert zoom turns any zoom drag around; Ctrl+Alt+Shift erases the mask. See Maya keys. Move along the normal (from the discussions): Move, Tendril, Elastic Tendril and KelvinGrab started with Alt held pull the surface straight out of itself (or push it straight in) instead of across the screen. See Sculpting. Polish, Relax, Smooth and Balloon (from the discussions): Tool > Deformation works on the whole Part by an amount: Polish flattens fine noise and keeps edges, Relax evens out the spacing, Smooth can keep the volume, and Balloon fills the form out. The mask holds what it covers; one undo step each. See Sculpting. Smooth without remeshing (from the discussions): Smooth remesh in Draw > Dynamic topology sets how much Shift-smoothing changes the topology, down to Smooth only. See Dynamic topology. Connected only and View falloff (from the discussions): brush options that keep a stroke to the piece under the cursor (the other leg, the next finger stay put) or reach through the model along the view, as Blender's proportional editing. See Sculpting. The SculptForge Discord (Help > Join the Discord...): the official community, for questions, tips and work in progress. It is also on the support card, in the welcome note and on the website. Bugs still go to Help > Report a problem (GitHub issues). Backface culling (#68, Tool > Display): don't draw the back faces of the model, for speed on open meshes and to see through their openings. Brushes then work only on what you see. Off by default. A crosshair over the view (#73): the pointer is a crosshair where brushes act and the arrow over the panels. Preferences > Interfac"},{"p":"whats-new.html","c":"What's new","a":"version-0105","h":"Version 0.10.5","t":"Selection sets (Tool > Selection Sets): store as many named snapshots of a Part's mask, face groups, visibility, vertex paint, UVs and shape as you like, and restore them at any subdivision level, not only the one they were stored at. Combine two sets (union, intersect, subtract), restore one onto the current mask or visibility the same way, or take a quick set from the visible faces. Every step is one undo step, and the sets are saved with the project. See Selection sets. Morph brush and Morph to Set: a set with its shape is a morph target. The new Morph brush pulls the surface back toward it (Alt pushes away), and Morph to Set blends the whole Part toward it by any amount, within the mask, at any subdivision level. Sets for pipelines: selection_set_* commands for scripts, sculptforge-cli and the AI assistant, doc.selection_set() / doc.set_selection_set() in Python, .sfsets files to move sets between Parts and scenes, and USD exports that carry them as GeomSubsets and primvars (read back on import). UV Editor (Tool > Texture Map > UV Editor, Alt+U): the Part's UVs flat over the UDIM tiles, drawn by the graphics card so a million triangles stay smooth. Draw seams on the model with the Seam Tool (or take them from face groups, island borders or sharp edges), then Unwrap: Least Stretch, Conformal, By Face Groups, Planar, Unfold Islands or Auto Seams, with closed and tangled pieces cut for you. Pack into one tile or across UDIM tiles, Set and Match texel density, lay islands into trim sheet strips, and select vertices, edges, faces or islands (in the view or on the model) to move, rotate, scale, pin, weld, split, straighten and flip them. The model shows stretch, texel density, islands and a checker live while you edit, and a painted texture moves with every change so the model keeps its look. Every step is one undo step and a uv_* command for scripts. See UV Editor. Fixed: the viewport on some Windows PCs (#29): on displays whose window uses another colour format (seen with NVIDIA and high-resolution screens) the model never appeared and the cursor left trails. The view now reaches the window on every format, and falls back to drawing directly if a driver still refuses. Features use SculptForge's own names (Parts, Forge Spheres, Vertex Paint, Face Groups, Library, Lit Spheres, Quad Remesh, Bridge, Snapshot...); the command palette finds them by what they do. See Quick tour for experienced sculptors. New installs start with the SculptForge keys, and the first start asks what you are coming from to pick the key style. Your saved style is kept; the Classic sculpting keys are Classic in Preferences > Input. See Keyboard and mouse."},{"p":"whats-new.html","c":"What's new","a":"from-your-requests-on-github","h":"From your requests on GitHub","t":"Start strokes off the model (#62): an option in Preferences > Input, off by default, and Shift+L to turn it on and off. With it on, a left-drag that starts on the background sculpts once it reaches the model instead of turning the view. See Navigation. Radial and local symmetry (#63): R in Transform > Symmetry (and on the top shelf) repeats every stroke around the X, Y or Z axis, 2 to 64 times (Radial Copies), together with the X / Y / Z mirrors. Every brush, mask, vertex paint and texture stroke, the mask and select shapes, Dynamic Topology and Insert follow it, and the brush cursor shows on every copy. Local puts the planes and the axis through the active Part's centre. Saved with the project and scriptable (radial, radial_axis, local). See Sculpting. The Sculpt Timeline is at the top of the viewport (#63), away from the brushes on the bottom shelf. Preferences > Interface > Timeline position puts it back at the bottom; saved automatically. See Sculpt Timeline."},{"p":"whats-new.html","c":"What's new","a":"from-your-requests-on-github-1","h":"From your requests on GitHub","t":"Insert your own mesh (#34): Append > Insert on the model now takes a copy of another Part or an .obj, .ply or .glb file, placed, sized and turned by the drag like the shapes. See Parts. Keep Masked for Voxel Remesh, Decimate and Quad Remesh (#43): the masked part keeps its triangles and detail exactly; only the rest is rebuilt and joined to it. See Geometry. Hold Space and drag to move the camera (#43): an option in Preferences > Input, off by default. See Navigation. Triple-click another Part in the viewport to select and frame it (#43). Twelve new alphas (Pores, Cracks, Scales, Rivets, Stitches, Fabric Weave, Bark, Rock Strata, Wrinkles, Skin Folds, Hair Strands, Dot Grid) and six new VDM brushes (Rivet, Stitches, Skin Fold, Wrinkle Line, Crack, Rock Ledge), with thumbnails in the Library (#43). See Sculpting. Mask from the mesh border (#61): Tool > Masking > By border masks open edges (and face group borders), so sculpting leaves them in place. See Masking. SculptForge in Spanish (#44): Preferences > Interface > Language > EspaΓ±ol. Maya bridge (#42): File > Maya and a SculptForge shelf for Maya swap meshes through a folder you pick: no connections, nothing run. See Working with Maya. Radial (pie) menus (#45): hold T (brushes) or Y (masking), flick and let go; make your own in Preferences > Input > Radial Menus. See Sculpting. Falloff works with alphas (#60): -100 shows the whole alpha, 0 rounds it off, +100 leaves a soft point (alpha brushes are softer at the default 0 than before; set -100 for the old crisp look). Select Rectangle and Select Lasso follow X / Y / Z symmetry, like the mask versions (#51)."},{"p":"whats-new.html","c":"What's new","a":"become-an-insider","h":"Become an Insider","t":"SculptForge stays free for everyone. Every release stays free for everyone; bug-fix and security releases go out to everyone the same day. Help > Support SculptForge opens the page to join. When SculptForge starts for the first time, after an update, and otherwise at most once a week, a card shows the ways to support it: Supporter, Insider and Studio memberships and the one-time Supporter, each opening its checkout page in your browser. Maybe later, Esc or a click outside closes it; I'm already a supporter hides it for good, and Preferences > Support turns it off. It never shows while you work, and nothing about you is sent anywhere."},{"p":"whats-new.html","c":"What's new","a":"from-your-requests-on-github-2","h":"From your requests on GitHub","t":"Alternate smooth (#40): start smoothing with Shift held, then let go of Shift while still pressing, and the rest of the stroke smooths without shrinking the form. Brush > Smooth keeps volume makes it the default. See Sculpting. Masking (#48, #51): Ctrl+drag on the background draws a mask rectangle; Lasso and Rectangle masks follow symmetry; a Ctrl+click with them blurs the mask. See Masking. Pen tablets in mouse mode (#54): Preferences > Tablet > Mouse mode (relative) stops the cursor jumping back when you lift the pen. Axis gizmo: click X, Y or Z to snap to that view (#43). Undo and Redo on the right shelf, Continuous in the stroke picker, Part thumbnails, and Insert on the model follows symmetry. See Navigation and Parts. macOS (#41): reopening in full screen keeps the menu bar and window buttons reachable."},{"p":"whats-new.html","c":"What's new","a":"support-sculptforge","h":"Support SculptForge","t":"SculptForge stays free for everyone. Help > Support SculptForge opens the page where you can become a member. Every release stays free for everyone; bug-fix and security releases go out to everyone the same day."},{"p":"whats-new.html","c":"What's new","a":"quad-remesh-2","h":"Quad Remesh 2","t":"A new quad remesher is now the default in Tool > Remesh and Tool > Geometry: two to fifty times fewer poles than before at the same accuracy, edge loops that follow the forms (round the mouth and nose), exact symmetry, and a quality report after each run. The previous method is still there as Legacy, and pieces with closed guide loops use it for now. See Quad retopology."},{"p":"whats-new.html","c":"What's new","a":"kelvinlet-brushes-and-capture-from-view","h":"Kelvinlet brushes and Capture from view","t":"KelvinGrab, KelvinTwist, KelvinScale and Elastic Tendril move the surface like elastic clay, with a Squash slider from rubber to firm clay; they're at their best below about 10 million triangles for now. Capture from view (Ctrl+Alt+C) turns any detail into an alpha or a vector displacement brush, and Detail Clone stamps it along a stroke. See Sculpting."},{"p":"whats-new.html","c":"What's new","a":"also","h":"Also","t":"Insert on the model (#34): the drag's direction also turns the shape about the surface. Security: video exports (timelapse, Benchmark) no longer pass the file name to ffmpeg in a way a crafted name could abuse. Update if you use them. The local API added in 0.10.1 is removed; SculptForge doesn't listen for other programs."},{"p":"whats-new.html","c":"What's new","a":"from-your-feedback-on-github","h":"From your feedback on GitHub","t":"Maya navigation (#32): Preferences > Input > Maya. Alt+left orbits, Alt+middle pans, Alt+right zooms. Focal length (#26): Draw > Camera, 15-300 mm with 35 / 50 / 85 / 135 presets, saved with the project. More primitives (#31): Cylinder, Cone, Torus, Capsule, Icosphere and Quad Sphere in Tool > Parts > Append, plus Insert on the model (#34): choose a shape, then drag on the surface to add it. Continuous in the Stroke palette keeps the brush working while you hold it still, and an X / Y / Z gizmo shows the view's direction (#31). Local API (#36): other programs on your computer (symmetry tools, scripts) can run commands in the open app. Off by default; see Scripting. The window opens where and how big you left it (#35), and a drawing problem on some graphics drivers that left trails in the viewport is fixed (#29)."},{"p":"whats-new.html","c":"What's new","a":"micro-levels-hundreds-of-millions-of-polygons","h":"Micro levels: hundreds of millions of polygons","t":"Tool > Geometry > Micro adds a micro-displacement level above your top subdivision level: up to about a billion sculptable triangles in under 2 GB of memory, drawn at the detail your screen can show. Move reshapes the base and the detail rides along. Bake it down or export displacement maps. See Micro levels."},{"p":"whats-new.html","c":"What's new","a":"material-painting-pbr","h":"Material painting (PBR)","t":"Paint roughness, metallic, normal, height, AO, emissive and opacity alongside colour, per paint layer, and export packed maps with presets for Unreal, Unity, glTF, Godot, Blender and USD. Texture brushes are much faster on dense meshes. See Material painting and Export presets."},{"p":"whats-new.html","c":"What's new","a":"sculpt-timeline-and-proof-mode","h":"Sculpt Timeline and proof mode","t":"Scrub back through every stroke, branch from any point, retune an old stroke's strength, and export a timelapse turntable. Help > Benchmark runs a scripted stroke on 5M to 33M triangles with a live readout and records a video and a report you can share. See Sculpt Timeline and Performance."},{"p":"whats-new.html","c":"What's new","a":"hardware-profile","h":"Hardware profile","t":"On first start SculptForge measures your computer for a second and picks settings for it (Laptop, Workstation or a safe mode); on battery it saves power. See Preferences > Performance."},{"p":"whats-new.html","c":"What's new","a":"also-new","h":"Also new","t":"The brush ring lies on the surface and follows its shape (#25). Preferences > Input > Cursor follows surface turns it off. Faster normals on big meshes. Predictive strokes (a GPU preview of each dab ahead of the solver) are in Preferences > Performance as an experiment. The status bar shows only the file name of what you open."},{"p":"whats-new.html","c":"What's new","a":"faster-big-brushes-on-dense-meshes","h":"Faster big brushes on dense meshes","t":"A large brush on a model of 20 million triangles or more keeps up much better: on a 21-million-triangle sphere with a 200-pixel brush, the brush now trails the pointer by half as far, a frame takes a third less time, the first dab appears in half the time, and lifting the pen no longer pauses for up to a second while waiting dabs are placed. See Performance."},{"p":"whats-new.html","c":"What's new","a":"right-click-for-the-quick-menu","h":"Right click for the Quick Menu","t":"A right click on the canvas opens the Quick Menu under the cursor (Space still does too). A right drag turns the view as before, and Preferences > Input > Right click opens the Quick Menu turns it off. See The Quick Menu."},{"p":"whats-new.html","c":"What's new","a":"fixes","h":"Fixes","t":"The orthographic view (Numpad 5) shades like the perspective one: Lit Spheres and the lights no longer look inside out. Dynamic topology with symmetry now adds detail on the mirrored side too when the model's two sides aren't built from mirrored polygons (a QRemeshed head, say): before, only the side under the brush got the new triangles. See Dynamic topology."},{"p":"whats-new.html","c":"What's new","a":"extract","h":"Extract","t":"Mask part of a Part and Tool > Parts > Extract turns it into a shell that fits the surface exactly: a helmet, a strap, a piece of armour. Set Thick, E Smt and Double while the preview shows, then Accept keeps it as a new Part (and Ctrl+Z takes it away again). TCorne and TBorder give the rim triangles instead of quads. See Extract a shell."},{"p":"whats-new.html","c":"What's new","a":"mirror-and-weld","h":"Mirror And Weld","t":"Tool > Geometry > Modify Topology > Mirror And Weld mirrors one side of a model onto the other across X, Y or Z and welds the seam into one watertight mesh, keeping face groups and vertex paint. Tool > Deformation > Mirror flips a Part. See Mirror And Weld."},{"p":"whats-new.html","c":"What's new","a":"a-flat-background","h":"A flat background","t":"Preferences > Display > Background (also in the Render palette) switches the view from the gradient to a flat colour you pick. Saved automatically; projects keep their own. See The background."},{"p":"whats-new.html","c":"What's new","a":"flatpak","h":"Flatpak","t":"SculptForge comes as a Flatpak for x86_64 and ARM64 Linux: one file on the releases page that runs in Flatpak's sandbox on any distribution, installed with flatpak install --user ./SculptForge-linux-x86_64.flatpak. It can open projects and models anywhere in your home folder, works with pen tablets and a SpaceMouse, and the Blender bridge finds it by itself. See Installing SculptForge."},{"p":"whats-new.html","c":"What's new","a":"fixes-1","h":"Fixes","t":"Fast strokes on very dense meshes keep their curve. When one dab cost more than a frame, a quick arc came out as a straight line; now the dabs wait in a queue the app works through between frames, so it keeps reading the pointer. Based on a patch by @bribblej-web. See Performance. The AppImage has a PNG icon at its root, so AppImage managers (AppManager, Gear Lever) show SculptForge's icon when they add it to your menu. Divide (Ctrl+D) no longer crashes on models with a point where many polygons meet, such as a Blender cylinder with Triangle Fan caps of 22 or more sides or a UV sphere's poles. Generating with a ComfyUI workflow and a fixed seed could crash at random; fixed. SculptForge now keeps a log file, sculptforge.log, in its settings folder (Help > Open log folder). After a crash it says what crashed and what you did last; attach it when you report a problem. See The log file."},{"p":"whats-new.html","c":"What's new","a":"forge-spheres","h":"Forge Spheres","t":"Block out a body, creature or plant from connected spheres: Tool > Forge Spheres > New Forge Sphere, drag on a sphere to grow a limb, Move and Scale it into proportion, Alt+click to delete, with Symmetry mirroring every edit. Preview (A) shows the skin, and Make Mesh turns it into a sculptable, all-quad Part with a face group per limb, keeping the Forge Spheres to change later. See Forge Spheres."},{"p":"whats-new.html","c":"What's new","a":"blender-keys","h":"Blender keys","t":"Preferences > Input > Style > Blender brings Blender's navigation and Sculpt Mode keys: middle-drag to orbit (Alt+drag with a pen), the numpad views, F / Shift+F, V S P I G C K for brushes, M for the mask. You can also import a keymap you exported from Blender. See Blender keys."},{"p":"whats-new.html","c":"What's new","a":"flat-shading","h":"Flat shading","t":"Material > Shading > Flat shows every polygon as its own facet, to read a low-poly blockout's planes and check exactly what a brush did; This Part keeps one Part smooth or flat whatever the scene says. See Vertex Paint and materials."},{"p":"whats-new.html","c":"What's new","a":"spacemouse-experimental","h":"SpaceMouse (experimental)","t":"A 3Dconnexion SpaceMouse now moves the view: twist, tilt and push the cap to turn, pan and zoom around the model with one hand while the other holds the pen, in every input style and even mid-stroke. The two side buttons frame the model and show the front. Preferences > Input > SpaceMouse sets the speed, the dead zone, turntable rotation, a dominant-axis mode, inverts any axis, and maps the buttons. It reads the device directly, without 3Dconnexion's driver, and hasn't been tried on real hardware yet: see SpaceMouse if yours doesn't show up."},{"p":"whats-new.html","c":"What's new","a":"your-own-lit-spheres","h":"Your own Lit Spheres","t":"Material > Load Lit Sphere... turns any image (PNG, JPG or EXR) into a material, and images you put in Documents/SculptForge/Lit Spheres show up in the material list, even while SculptForge is running. Right-click one and choose Remove to send it to the trash. Projects carry the Lit Sphere they use, so they look the same on any computer. See Your own Lit Spheres."},{"p":"whats-new.html","c":"What's new","a":"fixes-2","h":"Fixes","t":"Pens whose drivers send stray mouse events (a Ugee M708 on Linux) can rotate, pan and zoom on the background again instead of shaking the view. The S / U / I / O slider opens with its knob under the cursor and stays open while you drag it. The Blender Bridge add-on installs again: its zip was missing a file. Pens on Windows (Wacom Intuos Pro and others through Windows Ink): taps on menus and buttons land, and Alt+pen drag, the Move button and the S / U / O slider follow the pen instead of jumping. Idle, SculptForge no longer keeps your graphics card busy: it draws a new frame only when something changes (before, 60 or more a second all the time)."},{"p":"whats-new.html","c":"What's new","a":"fixes-and-packaging","h":"Fixes and packaging","t":"Exports without a material of their own (FBX, USD) and splats made from an unpainted sculpt use the Soft Clay grey instead of the old peach. Linux AppImages are now named SculptForge-0.9.4-x86_64.AppImage (and -aarch64) and carry update information for AppImageUpdate. On macOS you can install with Homebrew: brew install --cask islandmed/tap/sculptforge."},{"p":"whats-new.html","c":"What's new","a":"a-cleaner-look","h":"A cleaner look","t":"The default material is now Soft Clay: matte, with a clear light and shadow side, so sculpted detail reads at a glance. Orange marks only the current tool; options that are on are a lighter grey with a thin orange line. Every brush icon is drawn the same way, with a mark that shows what the brush does. A material you picked before is kept: choose Soft Clay in the Material menu to see the new look. See The interface."},{"p":"whats-new.html","c":"What's new","a":"bigger-brush-tiles-your-size","h":"Bigger brush tiles, your size","t":"The brush tiles on the bottom shelf are bigger. Right-click any brush on the shelf and choose Tile size: Small, Medium or Large (also in Preferences > Interface > Shelf tiles)."},{"p":"whats-new.html","c":"What's new","a":"export-stl-from-the-file-menu","h":"Export STL from the File menu","t":"File > Export STL... is its own menu item, for 3D printing."},{"p":"whats-new.html","c":"What's new","a":"view-in-ar-on-android","h":"View in AR on Android","t":"On Android, View in AR used to just download a file. It now opens an AR page in Chrome: your sculpt comes to it encrypted through SculptForge's relay, so it works even when Chrome can't reach your computer, and it updates as you sculpt. Show it with Chrome's AR or with Google's AR viewer. If the capture page is open in Firefox, tap Open in Chrome. See Phone capture and AR."},{"p":"whats-new.html","c":"What's new","a":"one-port-for-the-phone-link","h":"One port for the phone link","t":"Face capture and AR now use the same network port as the capture page. On Linux with a firewall, allow that port for both TCP and UDP from your home network."},{"p":"whats-new.html","c":"What's new","a":"version-091","h":"Version 0.9.1","t":"Fixes from the first day of 0.9."},{"p":"whats-new.html","c":"What's new","a":"phone-capture-when-the-phone-cant-open-the-page","h":"Phone capture: when the phone can't open the page","t":"Recent versions of Chrome on Android can refuse to open any address on your home network and just say This site can't be reached. The Capture from phone window now says so and suggests Firefox, and its The phone can't open the page? list covers Linux firewalls too. See Phone capture and AR."},{"p":"whats-new.html","c":"What's new","a":"easier-to-read","h":"Easier to read","t":"This guide, including What's New, and the update banner now use larger text."},{"p":"whats-new.html","c":"What's new","a":"baking","h":"Baking","t":"Cancel now stops small bakes too."},{"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 Parts 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 Part 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 vertex paint 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 professional sculptor's testing, and a way to bring a library over."},{"p":"whats-new.html","c":"What's new","a":"more-classic","h":"More classic","t":"Classic zoom direction. With the Classic input style, dragging up zooms out on every zoom drag. 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 Mask Pen, Lasso Mask or Rectangle Mask. Ctrl+Shift does the same for Select Rectangle and Select Lasso. See Masking. Group by UVs. One face group per UV island, in Tool > Face Groups. See Face Groups 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 Part 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-a-library-over","h":"Bring a library over","t":"A folder of numbered Bridge files opens as one scene, every Part with its face groups, vertex paint, mask and UVs."},{"p":"whats-new.html","c":"What's new","a":"version-08","h":"Version 0.8","t":"Dynamic topology, vector displacement brushes, Quad Remesh Guides, and sculpt layers on every subdivision level."},{"p":"whats-new.html","c":"What's new","a":"dynamic-topology","h":"Dynamic topology","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 Slide Stamp stroke slides a stamp into place. See Vector displacement brushes."},{"p":"whats-new.html","c":"What's new","a":"classic-sculpting-keys-in-blenders-sculpt-mode","h":"Classic sculpting keys in Blender's Sculpt Mode","t":"The Blender add-on has a new preference, The Classic sculpting keys in Sculpt Mode: S, U and O for Size, Strength and Falloff, B for the brushes by name, 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":"Quad Remesh Guides work: draw curves on the sculpt, around the eyes, the mouth or a joint, and Quad Remesh 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 Part and saved in the project. See Quad Remesh 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: 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":"The Classic sculpting 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-hands-just-work","h":"Your hands just work","t":"SculptForge now follows the Classic sculpting keys and gestures by default. A professional sculptor tried an earlier version and put it down because it didn't feel; this release goes through every habit of the first hour. Quick tour for experienced sculptors lists what's the same, what's different and every shortcut side by side. S, U, I, O open Size, Intensity, Colour intensity and Falloff under the cursor, and Space opens the Quick Menu with all of them plus the brush, stroke, alpha and material. Falloff shapes the brush falloff, shown as the cursor's inner ring. Colour intensity gives painting a strength of its own, and Smooth keeps its own Intensity, so a gentle brush still smooths properly. brush letters: B C B Clay Block, B D S Sharp Crease, 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 from mask) work. 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 Part; L toggles Lazy Stroke and V swaps colours. Visibility: Ctrl+Shift+click on a partly hidden mesh hides the group. Prefer the old keys? Preferences > Input > Style > SculptForge brings back the number keys for brushes, I for 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 (face groups) 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 sculpting workflow core: subdivision levels, quad retopology, map baking, the Gizmo, 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: 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 Level / Higher Level (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, vertex paint, paint layers, face groups, hidden faces, UVs and sculpt layers follow the levels. Delete Lower, Delete 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 Parts 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-move-scale-rotate-and-pose","h":"Gizmo: move, scale, rotate and pose","t":"Transform gizmo, 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 panel, All Parts (move, rotate and scale all Parts together), 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 or Wire 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 (vertex paint 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. The Classic sculpting keys: source Part, 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":"Quad Remesh (Tool > Geometry, like quad remesh) 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 Vertex Paint, Symmetry and Half / Same / Double work. Project Detail (Tool > Parts > Project) puts the sculpted detail and vertex paint back onto the divided quads, with Dist, Mean and 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 vertex paint 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 Part 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 Part moves the texture and its layers onto the new UVs. Voxel Remesh and Quad Remesh have a Keep Texture option (on by default) that unwraps the new surface and projects the texture onto it, and merging Parts 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, Quad Remesh, 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 Parts you aren't working on no longer hold cached levels in memory. Quad Remesh 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, Quad Remesh 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 Part 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 Part. 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, Bridge files). 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 experienced sculptors. It was shaped by feedback from a working professional modeler and by what sculptors say on sculpting forums."},{"p":"whats-new.html","c":"What's new","a":"classic-navigation","h":"Classic navigation","t":"Free rotation. Dragging turns the model the way the cursor moves and can roll it right over the top, . 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. Classic 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":"Lasso Mask and Rectangle Mask. 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. Select Lasso. In Tool > Visibility, pick Select Lasso next to Select Rectangle, 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 Face Groups 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 Vertex Paint and materials."},{"p":"whats-new.html","c":"What's new","a":"quads-stay-quads","h":"Quads stay quads","t":"Models you bring in from the other app (Bridge) or as OBJ, FBX, PLY or USD keep their quads: Wire 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 voxel remesh), 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":"Vertex Paint now has layers, like Photoshop: each Part 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. 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":"Parts: several separate meshes in one scene. Append, duplicate, split, merge, solo, and Alt+click to select. See Parts. A classic interface: shelves around the canvas, alphabetical palettes, the Library (,), 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, face groups and visibility, and vertex paint with Lit Spheres. New brushes: Sharp Crease, Clay Block, Tendril, Trim, Layer and Nudge, with strokes and alphas. Project files with autosave, recent files and snapshots, and exchange with the other app (Bridge)."},{"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":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"","h":"Quick tour for experienced sculptors","t":"You know how to sculpt; you just need to know where SculptForge keeps things. This chapter is the same ten stops as the in-app tour: Help > Quick tour, or Sculpted before? Take the quick tour in the welcome. Each slide there has a Show me button that opens the panel it talks about and flashes it, while the tour waits in a small bar at the bottom of the view (Back to the tour brings it back). The pictures are SculptForge in its default look and layout."},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"where-things-are","h":"Where things are","t":"The command search finding Quad Remesh by the word \"retopo\" The menus along the top are sorted by task: Sculpt (brushes, strokes, alphas, symmetry), Paint, Mesh, View and Render. The right tray holds the Tool palette: Parts, Geometry, Remesh, Masking, Cut, Bake and more. The shelves around the view hold the brush, its size and strength, and the brush, stroke, alpha and material tiles. See The interface. Lost? Press F3 and type what you are after in your own words. The search knows the usual sculpting words too, and says which one it matched: Type Finds remesh, voxel, block out Voxel Remesh retopo, retopology, quads Quad Remesh subdivide, multires, levels Divide, Lower Level, Higher Level groups Face Groups clip, trim, slice Tool > Cut folders, objects Tool > Parts insert, kitbash Append (a mesh as a new Part) vertex color Vertex Paint armature Forge Spheres"},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"voxel-remesh","h":"Voxel Remesh","t":"Tool > Remesh open in the right tray A fast remesh for blocking out. Pull shapes far out or merge pieces, then rebuild one even surface: open Tool > Remesh in the right tray, set Resolution and click Voxel Remesh. A higher resolution keeps more detail. The mask and vertex paint carry over, so you can keep going. See Geometry."},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"dynamic-topology","h":"Dynamic topology","t":"Sculpt > Draw & Tablet with the Dynamic topology controls Dynamic topology adds detail where you sculpt. Turn on Dynamic on the top shelf and the brush adds triangles where it needs them and removes them where it doesn't; Detail sets how small they get. Pull horns, ears or fingers out of a ball without remeshing. Wire (Shift+F) shows the new triangles. See Dynamic topology."},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"quad-remesh","h":"Quad Remesh","t":"Tool > Remesh with Quad Remesh at its top Automatic quad retopology: Tool > Remesh > Quad Remesh rebuilds a sculpt as clean quads whose edge loops follow the forms. Set Target Polygons and leave Keep Original on. Divide the result, then Project Detail (Tool > Parts) brings the detail back. Draw Quad Remesh Guides to steer the loops. See Quad retopology."},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"levels-parts-and-face-groups","h":"Levels, Parts and Face Groups","t":"Tool > Geometry with the subdivision levels Ctrl+D divides and keeps the lower levels: Shift+D steps down, D steps up, and you can sculpt at any level (Tool > Geometry). A scene holds several Parts (Tool > Parts); Alt+click one in the view to work on it. Face Groups split a Part into coloured regions to hide, isolate or mask (Tool > Face Groups). See Subdivision levels."},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"masking","h":"Masking","t":"Tool > Masking with By cavity and By face group Hold Ctrl and paint to mask, Ctrl+Alt to unmask. Tool > Masking inverts, blurs and grows the mask, and builds one By cavity, By face group or along the border. Press G for the stroke popup: its Shapes row picks Mask Pen, Lasso Mask or Rectangle Mask for the next Ctrl stroke. See Masking."},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"cut-clip-and-close-holes","h":"Cut, Clip and Close Holes","t":"Tool > Cut with its shapes and modes Pick a shape in Tool > Cut and draw it with Ctrl+Shift: a line, lasso, rectangle or polyline goes straight through the whole Part, and a closed Part stays closed. Cut it away, cut in, add, or Clip: press everything outside the shape flat onto its outline. Close Holes (Tool > Geometry) caps every open boundary. See Cut and Close Holes."},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"brushes-alphas-and-the-library","h":"Brushes, alphas and the Library","t":"The Library's Brush tab B opens the brush picker; type the first letters of a name to pick one. The Alpha tile picks the stamp shape. The Library (,) holds starter meshes, brushes, alphas, Lit Spheres and snapshots. A pack (.sfpack) brings brushes, alphas and Lit Spheres in one file; File > Install Pack shows what is inside before anything is installed. See Sculpting and brushes and Packs and macros."},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"baking-and-texturing","h":"Baking and texturing","t":"Tool > Bake with its maps Tool > Bake makes normal, displacement, ambient occlusion, cavity and colour maps from your sculpt onto a low-poly Part with UVs, in the background. P picks the Paint brush for vertex paint; New Texture on the top shelf paints into a texture instead (Auto UV runs first), with paint layers and material channels. See Baking, Texture painting and Material painting."},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"sculptforge-stays-free","h":"SculptForge stays free","t":"Everything in this tour is free, and stays free. If SculptForge helps your work, a membership keeps it moving: members get betas and early builds, vote on what we build next and ask for the brushes and alphas they want. See sculptforge.app/support.html. Maybe later on the tour's last slide closes it, and it doesn't come back by itself."},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"keys","h":"Keys","t":"Edit > Preferences > Input > Style picks the keys: SculptForge (the default), Classic sculpting keys, Blender or Maya. Picking the Classic sculpting keys offers this tour once. See Keyboard and mouse. Classic layout: Preferences is not under Edit there but its own Preferences palette in the palette bar (Edit > Preferences... opens it too). In both layouts Ctrl+, (Cmd+, on macOS) or F3 > Preferences opens it."},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"see-also","h":"See also","t":"Your first sculpt in 10 minutes The interface Glossary"},{"p":"installing.html","c":"Install SculptForge on Windows, macOS and Linux","a":"","h":"Install SculptForge on Windows, macOS and Linux","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":"Install SculptForge on Windows, macOS and Linux","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":"Install SculptForge on Windows, macOS and Linux","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 macOS with Homebrew brew install --cask islandmed/tap/sculptforge Updates with brew upgrade 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 Any Linux, sandboxed Flatpak for x86_64 or ARM64 flatpak install --user ./SculptForge-linux-x86_64.flatpak, or install from FlatPark to get updates (see Flatpak) Arch Linux packaging/arch/PKGBUILD in the source makepkg -si in that folder (the AUR package isn't published yet; see Package managers) 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 (it runs on 4, 16 and 64 KiB memory pages). Older versions are on the releases page."},{"p":"installing.html","c":"Install SculptForge on Windows, macOS and Linux","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."},{"p":"installing.html","c":"Install SculptForge on Windows, macOS and Linux","a":"package-managers","h":"Package managers","t":"Where SculptForge is in a package manager today, so it updates with the rest of your system: Package manager Status Command Homebrew (macOS) Available brew install --cask islandmed/tap/sculptforge, then brew upgrade winget (Windows) Submitted, in review at winget-pkgs; not installable yet Use the installer or the one-command install meanwhile AUR (Arch Linux) Ready, not published yet Until then: makepkg -si in packaging/arch Omarchy Submitted, in review at omarchy-pkgs As for Arch meanwhile apt (Debian, Ubuntu) and dnf (Fedora, RHEL) repositories Not yet; being built (#149) Install the .deb or .rpm file; SculptForge tells you when a new version is out FlatPark (Linux) Available (x86_64, ARM64) flatpak --user remote-add --if-not-exists flatpark https://dl.flatpark.org/flatpark.flatpakrepo then flatpak --user install flatpark org.sculptforge.SculptForge (see Flatpak) This table changes as each one goes live. 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":"Install SculptForge on Windows, macOS and Linux","a":"flatpak","h":"Flatpak","t":"The Flatpak runs SculptForge in Flatpak's sandbox and works on any distribution that has Flatpak (most do; see flatpak.org/setup if yours doesn't). The easiest way is from FlatPark, a community Flatpak repository that carries SculptForge's official Linux build unmodified (x86_64 and ARM64): flatpak --user remote-add --if-not-exists flatpark https://dl.flatpark.org/flatpark.flatpakrepo flatpak --user install flatpark org.sculptforge.SculptForge flatpak run org.sculptforge.SculptForge Or install the single file from the release: download it, then flatpak install --user ./SculptForge-linux-x86_64.flatpak (or ...-linux-arm64.flatpak). SculptForge then appears in your application menu. The first install also downloads the freedesktop runtime it runs on (a few hundred MB, shared with other Flatpak apps) from Flathub; both ways add Flathub for that if it isn't set up. SculptForge itself is not on Flathub. Updating: from FlatPark, new versions arrive with flatpak update (or your software center's updates), usually within a day of each release, and SculptForge's new-version notice shows that command. Installed from the file, download the new .flatpak and install it the same way. Your settings are kept either way. Uninstalling: flatpak uninstall org.sculptforge.SculptForge (add --delete-data to remove its settings too). Files: the sandbox can read and write your home folder, so projects, models and the textures beside them open as they would without it. Files elsewhere (another drive under /mnt or /media) open through the file dialog; to let SculptForge see a whole drive, run flatpak override --user --filesystem=/mnt/data org.sculptforge.SculptForge. Settings live in ~/.var/app/org.sculptforge.SculptForge/, not ~/.local/share/SculptForge, so a Flatpak and another install of SculptForge on the same computer keep separate settings and brushes. Your library in Documents/SculptForge is shared. Pen tablets and the SpaceMouse work in the sandbox. Blender bridge: the add-on finds the Flatpak by itself and exchanges models through the usual folder. Not in the sandbox: programs SculptForge starts on your computer, such as ffmpeg for recording demo videos and the splat trainer (Splat > Train), are not visible to it. Use another package for those. Ollama, ComfyUI and other local AI servers work, because SculptForge talks to them over the network. To build the Flatpak yourself from the source, install flatpak and flatpak-builder and run packaging/flatpak/build.sh; it writes SculptForge--.flatpak."},{"p":"installing.html","c":"Install SculptForge on Windows, macOS and Linux","a":"windows","h":"Windows","t":"Windows is where most SculptForge artists work. The notes below cover the first start, pen tablets and screen scaling."},{"p":"installing.html","c":"Install SculptForge on Windows, macOS and Linux","a":"smartscreen","h":"SmartScreen","t":"The builds are not code-signed yet, so the first start may show \"Windows protected your PC\". Click More info. Click Run anyway. To confirm the file is the one we published, compare it with SHA256SUMS.txt on the release page."},{"p":"installing.html","c":"Install SculptForge on Windows, macOS and Linux","a":"pen-tablets-windows-ink-and-wintab","h":"Pen tablets: Windows Ink and Wintab","t":"SculptForge reads the pen through Windows Ink, the pen input built into Windows 10 and 11. When Windows Ink is off in the tablet driver, it takes the pressure from the driver's Wintab instead. Either way works; Windows Ink also gives the eraser end and tilt. Wacom: Wacom Tablet Properties > Mapping > Use Windows Ink. You can set it for SculptForge only by adding it as an application in Wacom Tablet Properties. Huion, XP-Pen, Gaomon, Ugee: Windows Ink (sometimes \"Windows Ink mode\") in the driver's settings. Pen displays and Surface-type pens use Windows Ink already. Check it in Edit > Preferences > Tablet: it shows \"Pressure: on\" once the pen has pressed, or \"Pressure: not detected\". A tablet plugged in while SculptForge runs works straight away. If pressure is missing, switch the driver's Windows Ink option and bring the pen back to the tablet. Mouse mode. Most drivers map the pen to the screen (pen mode): where the pen touches is where the cursor goes. If you set the driver to Mouse (relative) mode, the pen moves the cursor by how far it moves, like a mouse. Turn on Edit > Preferences > Tablet > Mouse mode (relative) to match it, or the cursor jumps when you put the pen down. Pen side buttons work as the driver sets them; a button set to Right click opens the Quick Menu. More in Troubleshooting: pen tablets."},{"p":"installing.html","c":"Install SculptForge on Windows, macOS and Linux","a":"screen-scaling-dpi","h":"Screen scaling (DPI)","t":"SculptForge follows the Scale in Windows' Settings > System > Display, so text and buttons have the same size as in other apps at 125%, 150% or 200%. To make the interface larger or smaller than that, choose a size in Edit > Preferences > Interface > UI scale (Automatic follows Windows)."},{"p":"installing.html","c":"Install SculptForge on Windows, macOS and Linux","a":"where-files-go","h":"Where files go","t":"Settings, brushes and the log: %APPDATA%\\SculptForge\\SculptForge (Help > Open log folder opens it). Your library (projects, snapshots, alphas, Lit Spheres): Documents\\SculptForge. See Where settings live for every file."},{"p":"installing.html","c":"Install SculptForge on Windows, macOS and Linux","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":"Install SculptForge on Windows, macOS and Linux","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":"Install SculptForge on Windows, macOS and Linux","a":"windows-smartscreen","h":"Windows: SmartScreen","t":"Windows may show \"Windows protected your PC\". See Windows below."},{"p":"installing.html","c":"Install SculptForge on Windows, macOS and Linux","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":"Install SculptForge on Windows, macOS and Linux","a":"wayland-and-x11","h":"Wayland and X11","t":"Every Linux package (.deb, .rpm, AppImage, Flatpak, tar.gz) opens as a native Wayland window on a Wayland desktop, without XWayland, and as a normal X11 window on an X11 session. On Wayland the window stays sharp at fractional and HiDPI scales (125%, 150%, 200%), and title bars come from the desktop (or from libdecor on GNOME). To force X11 (for example, a screen recorder or remote-desktop tool that only captures X11 windows), start SculptForge with: SDL_VIDEO_DRIVER=x11 sculptforge Pen tablets work on both. On Wayland, pressure, tilt, the eraser end and side buttons come through the desktop's tablet protocol (tablet-v2), so the tablet must be set up in your desktop's settings rather than through X11 tools such as xsetwacom. If pressure doesn't respond, check Edit > Preferences > Tablet for the live pressure reading."},{"p":"installing.html","c":"Install SculptForge on Windows, macOS and Linux","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 Library 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 Edit > Preferences > Library > Show at startup. The first start also creates your library folder (Documents/SculptForge, with Projects, Tools, Brushes, Alphas, Lit Spheres, Images, Splats and QuickSave (snapshots) sub-folders), which the Library shows as User. The first start also asks what you are Coming from: Classic sculpting keys, Blender, Maya or New to sculpting. Your answer picks the key style: Classic sculpting keys turns on the Classic sculpting keys, Blender and Maya their own styles, and New to sculpting keeps the SculptForge keys (the default). Change it any time in Edit > Preferences > Input > Style (see Keyboard and mouse); if you are updating from an earlier version, your saved style is kept and the question isn't asked. 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":"Install SculptForge on Windows, macOS and Linux","a":"updating-and-uninstalling","h":"Updating and uninstalling","t":"SculptForge tells you when there is a new version. 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 Edit > Preferences > Updates turns the daily check off (and picks the update channel: Stable, or Preview for the betas). One-click update. The Linux AppImage and the Windows installer and portable zip also get an Update button on the banner. It downloads the new version in the background (with a progress bar and Cancel), checks it, and then asks: Restart now installs it and starts the new version; Later installs it when you quit, so the next start is the new version. If you have unsaved changes, Restart now asks first, as quitting does. What the check means: the files come only from SculptForge's own GitHub releases, over a checked secure connection; the release's list of checksums must carry the SculptForge release signature (a key built into the app); and the download must match its checksum. If any of that fails, nothing is changed and nothing downloaded is run: the banner says what went wrong and Download still opens the release page. The current version is kept beside the new one (the AppImage as .AppImage.old, the portable folder as .old) until the new version has started once, then removed; if the new version doesn't start, the old one is put back. The Windows installer asks for permission to change Program Files, as installing does. Member builds. Members get each release early. In Edit > Preferences > Updates > Member builds, click Sign in with GitHub: SculptForge shows a short code; open github.com/login/device, sign in with the GitHub account that accepted the invitation to the member repository, and enter the code. From then on the update check also offers the member builds, and Update installs them exactly like releases, with the same signature check. The sign-in can only read the member repository's releases (nothing else on your GitHub account), it is kept in your system's keychain (Windows Credential Manager, or the Secret Service on Linux such as GNOME Keyring or KWallet; never in SculptForge's settings), and Sign out removes it. Without a keychain the sign-in lasts until you quit. Installs that belong to a package manager are never replaced by the app: the Arch PKGBUILD (and the AUR and Omarchy packages once they are published) builds without the update check, a Homebrew install shows brew upgrade --cask sculptforge, and the Flatpak, .deb and .rpm files say to download the new file and open it (a Flatpak from FlatPark shows flatpak update). The macOS app shows Download for now. To update by hand, download the new release and install it over the old one. Either way 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, flatpak uninstall org.sculptforge.SculptForge for the Flatpak, or delete the AppImage). Delete the settings and library folders as well if you want to remove everything."},{"p":"installing.html","c":"Install SculptForge on Windows, macOS and Linux","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":"Install SculptForge on Windows, macOS and Linux","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 has the 3D view (the canvas) in the middle, shelves of the most-used controls around it, menus along the top that hold every function, and trays at the sides where panels can stay open. It comes in two layouts: the SculptForge layout (the default), with menus by task, and the Classic layout, with a bar of alphabetical palettes. Both hold the same controls; see Looks and layouts to switch. This chapter walks through each region, the pop-up pickers, the Library, the built-in help, and how to rearrange the interface and keep your changes. The pictures show the default look and layout. 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 Menu bar Top edge The menus File, Edit, Sculpt, Paint, Mesh, View, Render, Help; the status message; mode, brush, file name, triangles and frame rate; layout presets 1 2 3; Search Top shelf Under the menu bar Sculpt/Paint, Draw/Move/Scale/Rotate, Add/Sub, Rgb, Size, Intensity, Dynamic, symmetry Left shelf Left of the canvas Brush, Stroke, Alpha and Material tiles, the colour picker, Fill Canvas Centre The 3D view, with the Sculpt Timeline along its top; strokes and navigation start only here Right shelf Right of the canvas Undo and Redo, Frame, Move, Zoom and Rotate, display toggles, Solo Right tray Far right The Tool panel: the active Part, Parts, Layers, Geometry, Masking and more Bottom shelf Below the canvas Your quick brushes Press Tab to hide the shelves and trays for a bigger canvas, and again to bring them back. The menu bar stays, so every function is still one click away. The Classic layout has a title strip and a bar of 16 alphabetical palettes instead of the menu bar, and a two-row top shelf; the rest is the same. See The title strip and Palettes."},{"p":"interface.html","c":"The interface","a":"looks-and-layouts","h":"Looks and layouts","t":"Edit > Preferences > Interface > Look sets how the interface looks and how it is laid out. Neither changes your models, brushes or shortcuts. Classic layout: Preferences is not under Edit there but its own Preferences palette in the palette bar (Edit > Preferences... opens it too). In both layouts Ctrl+, (Cmd+, on macOS) or F3 > Preferences opens it. Layout: SculptForge (the default for new installs): a status bar along the top with the task menus File, Edit, Sculpt, Paint, Mesh, View, Render and Help, the document name and scene statistics; a one-row top shelf (Sculpt/Paint, Draw, Move, Scale, Rotate, Add/Sub, Rgb, Size, Intensity, Dynamic, symmetry). Every palette is a section of one menu: File (File, Script), Edit (Edit, Preferences), Sculpt (Brush, Draw & Tablet, Stroke, Alpha, Symmetry & Gizmo), Paint (Vertex Paint & Color), Mesh (Parts & Geometry, which is the Tool palette, and Generate 3D), View (Display), Render (Materials, Gaussian Splats) and Help. Pin a section to a tray as you would a palette. Brush Lab, Front and the pressure options are under Sculpt, the Library and the console under View > Display, and F3 finds everything. Classic: the alphabetical palette bar under a title strip, and a two-row top shelf (see The title strip and Top shelf). Experienced sculptor? In the welcome shown at the first start, pick the Classic layout card or Coming from: Classic sculpting keys (which also sets the keys). Switching the layout swaps the shelves for that layout's standard ones; the trays and what is in them stay. Look (the colours and style): Forge Terminal (the default): tiles with small gaps and thin borders, JetBrains Mono for labels and numbers. Colours picks the scheme: Neutral (the default since 0.10.9: pure grey panels and the orange accent, so your model's colours read true), Tokyo Night (the default in 0.10.7 and 0.10.8), Catppuccin Mocha, Gruvbox Dark, Nord, RosΓ© Pine, Kanagawa or Everforest. Match my desktop theme uses your Omarchy theme's colours when Omarchy is installed (Linux; the option shows only then). SculptForge never changes the theme; toggle it again after switching themes. Classic: the dark grey interface with the orange accent that SculptForge had before 0.10.7, now exactly neutral grey (red, green and blue equal in every background, panel and frame colour). Phosphor: green or amber on black, monospace, with optional scanlines and glow on the interface (never on the 3D view). Blueprint: deep blue with cyan and white line work. Outlines (Forge Terminal, Phosphor and Blueprint) sets the panels' borders: Subtle (the default: faint borders, and nothing lights up under the pointer), Off (no borders; the gaps alone separate the panels) or On (clear borders, the panel under the pointer a faint step lighter). Outline opacity (0-100%, default 100%) fades the borders further into the panels. Hovering a control only gives that control a faint fill, never a bright border. The first start shows three looks to pick from in the welcome: Neutral, Forge Terminal (Tokyo Night) and Classic layout (Classic with the palette bar). Coming from sets the keys and the layout together: Classic sculpting keys (the keys and the Classic layout), Blender, Maya or New to sculpting (their keys, the SculptForge layout). Help > Welcome shows it again. Choosing Forge Terminal, Phosphor or Blueprint also switches to the SculptForge layout; you can pick the Classic layout again right after. The look and layout are remembered for the next start on their own, like every preference. Updating from an older version keeps the look and layout you had. A card, SculptForge has a new look, shows once: Try it switches to Forge Terminal with the Neutral colours and the SculptForge layout; Keep my layout changes nothing. Either way, Edit > Preferences > Interface > Look changes it later. In scripts: ui_look look=forge scheme=neutral outlines=subtle layout=sculptforge (or look=classic layout=classic)."},{"p":"interface.html","c":"The interface","a":"turning-ai-off","h":"Turning AI off","t":"Your art is never uploaded or used for training. AI features run only when you use them and can be turned off. Edit > Preferences > AI > Enable AI features turns off everything AI: AI Brush (Brush Lab, where you describe a brush in words) and Generate 3D (image or text to a model) leave the shelves, menus and the command palette, their commands leave scripts, sculptforge-cli and the MCP tool list, and SculptForge makes no AI network calls. The offline image tools (Relief, Inflate, Stamp) and the MCP server stay. The first-run welcome asks the same question. The choice is saved at once; turn it back on the same way, or search the command palette for \"Enable AI\". Studios can turn it off for everyone with the environment variable SF_AI=off (or start with --no-ai); the setting is then locked. See Studios."},{"p":"interface.html","c":"The interface","a":"the-menu-bar","h":"The menu bar","t":"From left to right: SculptForge and the task menus File, Edit, Sculpt, Paint, Mesh, View, Render, Help. Click a menu to open it: its sections are listed down the left (for example Sculpt has Brush, Draw & Tablet, Stroke, Alpha and Symmetry & Gizmo) and the chosen one opens beside them. See Menus and palettes. The status message: the result of the last command or action. Errors show in red for a few seconds. Mode (SCULPT, PAINT, MOVE...), the active brush, the file name (* after it means unsaved changes), the triangle count of the scene and the frame rate. On a narrow window the least important of these are left out. 1, 2, 3: the layout presets (see Layout presets). 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":"the-title-strip-classic-layout","h":"The title strip (Classic layout)","t":"In the Classic layout the top edge is a title strip instead, with the palette bar under it. 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 Parts, the active Part and its position (\"Part 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. Snapshot: saves a timestamped copy of the whole scene to your library without touching your project file (see Projects, autosave and snapshots). 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":"menus-and-palettes","h":"Menus and palettes","t":"Every function in SculptForge lives in one of 16 palettes. In the SculptForge layout each palette is a section of one task menu (the table below); in the Classic layout the palettes sit side by side in the palette bar. Either way, click the name and the palette drops down under it. Click another name to switch, or press Esc or click outside to close it. The Sculpt menu open on its Stroke section Menu paths in this guide name what you click in the SculptForge layout: Edit > Preferences > Input is the Edit menu, its Preferences section, then the Input sub-palette. File and Edit have a section of the same name, which paths leave out (File > Save). Paths starting with Tool are in the Tool panel in the right tray, in both layouts (it is also Mesh > Parts & Geometry). In the Classic layout, drop the menu: Edit > Preferences > Input is Input in the palette named Preferences, and Sculpt > Stroke is the palette named Stroke. In the Classic layout, 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 strict A to Z order, turn on Edit > Preferences > Interface > Palettes strictly A-Z (strict order). Palette In the SculptForge layout What's in it File 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), Bridge, Quit Edit Edit Undo and Redo (with the name of the step), Paste brush Alpha Sculpt > Alpha The brush alphas: Round, Square, Noise and twelve patterns (Pores, Cracks, Scales...), images from your library, Load image, Invert loaded image Brush Sculpt > 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 Paint The Paint brush, RGB while sculpting, the paint colour and swatches, Fill, Fill masked, Cavity, Clear, Line Gradient, Show vertex paint Draw Sculpt > Draw & Tablet Size, Intensity, Colour intensity, Falloff, Sculpt/Paint, Add/Sub, Rgb, Front, and the tablet options (Pressure > strength, Pressure > size) with a pen readout Generate Mesh > Generate 3D (Mesh > From Image while Edit > Preferences > AI is off) Generate 3D (image or text to 3D), Relief, Inflate and Stamp from an image, and the AI brush provider settings; with AI off only Relief, Inflate and Stamp Material Render > Materials The Lit Sphere materials (Soft Clay, the default, first), your own (Load Lit Sphere...) and Studio, Base colour, Smooth / Flat shading for the scene and the active Part Preferences Edit > Preferences Config, Interface, Input, Hotkeys, Display, Library, Tablet, Performance, Updates and Autosave sub-palettes (see Customizing the interface) Render View Wireframe, Show Mesh, Show Vertex Paint, Show Mask, Show Face Groups, Floor grid, Show Splats, Background, Frame, Fullscreen Script File > Script Console, Run script file, Copy session as script, Clear console Splats Render > Gaussian Splats Gaussian splat tools: show, flip, turn, fit, clean floaters, Make sculptable, sculpt to splats, save, clear Stroke Sculpt > Stroke The stroke types (Dots, Drag Stamp, Spray, Lazy Stroke) and their settings Tool Mesh > Parts & Geometry, and the right tray The active Part with Open, Save and Import, and the Part, Layers, Paint Layers, Geometry, Remesh, Deformation, Masking, Face Groups, Visibility, Export and Display sub-palettes Transform Sculpt > Symmetry & Gizmo Draw, Move, Scale and Rotate (the Gizmo with its pivot, axes, options and numeric entry), Symmetry X, Y and Z, Frame, Solo, Wire Help Help Controls, User Guide, What's New, Command palette, Website & documentation, Report a problem, Support SculptForge..., 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 (Part, 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 Edit > Preferences > Interface > One sub-palette open."},{"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 its menu (or 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 its menu. 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 a tray icon beside its name in its menu (in the palette bar of the Classic layout, its name in the accent colour). 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, under the Tool panel When a tray holds several palettes, Edit > 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, Render > Gaussian Splats 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":"Sculpt / Paint (P): brushes change the shape, or paint colour without sculpting. Draw, Move, Scale, Rotate (Q W E R): sculpt, or move, scale and rotate the Part with the Gizmo. Add / Sub: 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. Size: the brush radius in screen pixels (2 to 800). Intensity: how strongly each dab changes the surface (1 to 100). While Shift is held it shows Smooth's own value. Dynamic: dynamic topology, with its Detail slider while it is on. X, Y, Z: symmetry across each axis (X toggles X); R is radial symmetry. The Classic layout's top shelf has two rows: Library (,), Sculpt/Paint, Add/Sub, Rgb, Size and Intensity on the first; AI Brush, Front, symmetry, Pressure > Strength and Pressure > Size, and the ActiveTris / TotalTris count on the second. In the SculptForge layout these are in the Sculpt menu (AI Brush, Front, pressure) and View menu (Library). Size and Intensity are sliders with the label inside: 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, Drag Stamp, Spray or Lazy Stroke. Alpha: the brush's stamp shape. Material: how the model is shaded in the view. Under them is the colour picker for vertex paint (a saturation/value square and a hue strip), two swatches and Fill, which fills the unmasked area with the main colour."},{"p":"interface.html","c":"The interface","a":"right-shelf","h":"Right shelf","t":"Undo and Redo (Ctrl+Z, Ctrl+Shift+Z): greyed out when there is nothing to undo or redo. A layout you customised before they were added gets them at the top. Frame (F): fits the model in the view. Move, Zoom, Rotate: drag on these buttons to pan, zoom and orbit the view. Wire (Shift+F): shows the mesh's polygons: quads as quads, triangles as triangles. Groups: colours each face group. Mask (Ctrl+H): shows or hides the mask's darkening (on by default). Hiding it keeps the mask, which still protects the surface. Paint: shows vertex paint colours (on by default). Solo: shows only the active Part (available with two or more Parts). Splats: shows or hides a Gaussian splat capture (only shown while one is loaded). Options that are on are highlighted; a filled button in the accent colour marks only the current tool or mode. 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, Clay Block, Sharp Crease, Move, Smooth, Inflate, Pinch, Flatten, Crease, Trim, Tendril, 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 is outlined in the accent colour. 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. Bigger or smaller tiles: right-click any brush on the shelf and choose Tile size: Small, Medium (the default) or Large. The same setting is in Edit > Preferences > Interface > Shelf tiles. Small leaves the most room for the model on a laptop screen. A key for any brush on the shelf: hold Ctrl+Alt, click its tile, then press the key. Custom and pack brushes show their key in the top-right corner. Brush sets: keep the shelf as it is now, with the keys of its brushes, as a named set (Wood, Metal, Stone...): Sculpt > Brush > Brush set > Save, or right-click the shelf and choose Brush set > Save Shelf as Brush Set.... Pick a set from either menu, or type Brush Set in the command palette (F3), to swap the whole shelf and its keys in one step. The set you switched to comes back the next time you start SculptForge. Sets are saved in your brush library (a sets folder next to your brushes); deleting a set leaves the brushes and the shelf as they are."},{"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 help box: 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: 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, Drag Stamp, Spray and Lazy Stroke, with Scatter for Spray, Steady Stroke (and its radius) and Precision Intensity. See Sculpting and brushes. Alpha (click the Alpha tile): Round, Square, Noise and the twelve built-in patterns (Pores, Cracks, Scales, Rivets, Stitches, Fabric Weave, Bark, Rock Strata, Wrinkles, Skin Folds, Hair Strands, Dot Grid), 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 Lit Spheres 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 Vertex Paint and materials."},{"p":"interface.html","c":"The interface","a":"sliders-at-the-cursor-and-the-quick-menu","h":"Sliders at the cursor and the Quick Menu","t":"Press S for a Size slider under the mouse, U for Intensity, I for Colour intensity or O for Falloff. 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 (or a right click on the canvas) opens the Quick Menu with all of them and the brush, stroke, alpha and material (see The Quick Menu)."},{"p":"interface.html","c":"The interface","a":"the-library","h":"The Library","t":"The Library is a strip of thumbnails across the top of the canvas for browsing everything you can load. Press , (comma) or click Library on the top shelf to show or hide it. It opens on its own at start-up (see Preferences). The Library on the Tool tab Tab Shows Double-click (a click for brushes, alphas and materials) 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, and the VDM brushes (built-in ones too) Select or load the brush (one click) Alpha Round, Square, Noise, the twelve built-in patterns and images in your Alphas folder Use as the brush alpha (one click) Material The Lit Spheres (your own included) and Studio Use the material (one click) 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 Snapshots The autosave and your snapshots, 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 Part 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 (and uses a brush, alpha or material). Drag a tile down out of the Library 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. Drag the strip's edge toward the canvas to make the thumbnails bigger or smaller (48 to 128 px; 64 by default). Open folder... adds a folder of your own to the root of every tab. On the Snapshots tab, Save now takes a snapshot. The x at the right end of the header, or Esc, closes the Library (while you type in Filter, Esc first leaves the field). The x stays on screen on small displays such as 1280x720. Right-click a tile for Open, Append as Part, 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 Edit > Preferences > Library > Library folder."},{"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 (Edit > Preferences > Interface > Tooltip delay). Turn Ctrl-hover help off with Edit > Preferences > Interface > Ctrl+hover help, and make the box more or less see-through with Help box 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 at the top right) 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: 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. File > Script 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. Shortcuts and preferences save themselves; layout changes (shelves, trays) last until you quit unless you keep them with Save Layout."},{"p":"interface.html","c":"The interface","a":"move-add-and-remove-shelf-items","h":"Move, add and remove shelf items","t":"Open Edit > Preferences > Config and turn on Customize Shelves. 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 Customize Shelves off when you're done, and click Save Layout (same palette) to keep the result. Right-clicking a shelf item and choosing Remove from shelf works without Customize mode. A shelf you empty is hidden when Customize Shelves is off, and the canvas takes its room. Turn Customize Shelves back on and the empty shelf returns, outlined, so you can drag buttons onto it again."},{"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 Edit > 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 and the status line says which action lost it."},{"p":"interface.html","c":"The interface","a":"saving-preferences-and-layouts","h":"Saving preferences and layouts","t":"Every preference (key style, shortcuts, tablet, interface, performance, radial menus...) saves itself a moment after you change it; there is nothing to press. The layout is the one thing kept on purpose, with Save Layout. All in Edit > Preferences > Config: Item What it does Save Layout Keeps the current shelves, trays and open palettes for future sessions Revert to Saved Layout Goes back to the layout the last Save Layout kept Reset Layout and Shortcuts Goes back to the built-in layout, shortcuts and radial menus (Save Layout afterwards to keep the layout) Export Interface... Saves the layout, shortcuts and preferences to a .json file you can share Import Interface... (Ctrl+L) Loads such a file (Save Layout afterwards to keep its layout) The command palette (F3) also has Save Preferences Now, which writes them at once; you never need it. The first time you change the layout in a session, the status line reminds you once: \"Layout changed - Edit > Preferences > Config > Save Layout keeps it\". What a session changes by itself (the console and Library being open, the Library tab) doesn't count as a layout change."},{"p":"interface.html","c":"The interface","a":"layout-presets","h":"Layout presets","t":"The 1, 2 and 3 buttons at the top right (also in Edit > Preferences > Config) switch between three arrangements of the current layout: Standard: the Tool panel 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, Library and left-handed setting stay as they are). Save Layout keeps it."},{"p":"interface.html","c":"The interface","a":"interface-preferences","h":"Interface preferences","t":"Classic layout: Preferences is not under Edit there but its own Preferences palette in the palette bar (Edit > Preferences... opens it too). In both layouts Ctrl+, (Cmd+, on macOS) or F3 > Preferences opens it. Edit > Preferences > Interface: Setting Default What it does Look, Outlines and Layout Forge Terminal, Neutral, Subtle, SculptForge See Looks and layouts Language English The interface language: English, EspaΓ±ol, Traditional Chinese or Simplified Chinese (see below) Ctrl+hover help On Ctrl-hover help boxes Help box 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 Reduce motion Off Hover and focus highlights change colour only: no easing, and tiles don't lift 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 (strict order) Off Classic layout: 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%), applied at once; Automatic follows the monitor (see below) Camera notch Automatic Keeps the interface below a laptop's camera notch in fullscreen (see below) Language changes the interface at once, without a restart; saved automatically for the next start. In EspaΓ±ol the menus, the palettes, the shelves, the Library, the command palette and the Ctrl-help titles are in Spanish, while the names of tools and brushes stay in English, as Spanish-speaking sculptors use them (Parts, Quad Remesh, Forge Spheres, Library, Lit Sphere, Clay Block, Add). The command palette finds a command by its Spanish or its English name. Traditional Chinese (the button with its Chinese name; contributed by yoyomaimai) works the same way, with Taiwan usage and the brush and tool names in English; Simplified Chinese (the fourth button) is the same translation in simplified characters with mainland terms, drawn with mainland glyph shapes. Anything not translated yet (most Ctrl-help descriptions, this guide) shows in English. Scripts and sculptforge-cli commands are the same in every language. UI scale also applies at once: text, buttons, shelves and trays resize on the next frame; saved automatically. Automatic uses the scale of the monitor the window is on (Windows: Settings > Display > Scale; macOS and Wayland: the display's scaling; X11: the desktop's font DPI). Drag the window to a monitor at another scale, or change the system setting, and the interface follows. A chosen size (100% to 200%) stays the same on every monitor. Edit > Preferences > Cursor: Setting Default What it does Viewport cursor Crosshair The pointer over the 3D view: a crosshair, or the arrow (#73). The crosshair stays while the view turns, pans or zooms. Panels, menus and popups always show the arrow Cursor follows surface On The brush ring lies on the model: a true circle at the brush's real size, in the plane of the surface (averaged over the brush, so bumps don't bend it), with a short line along the surface's direction. Symmetry and radial copies show as dots where their dabs land. Off: a flat ring on the screen Hide ring while stroking Off While a stroke runs, only the dot where the brush touches (and the symmetry dots) shows, not the ring Edit > Preferences > Hints: Show hints in the viewport (on) and one box per hint (Strokes start off the model, Previewing an LOD, Face landmark steps). Each hint over the 3D view also has its own Don't show again; Show all hints again brings them all back. Saved automatically. Scrolling panels with a pen: on small screens a palette or tray that doesn't fit scrolls with the mouse wheel, and also with a left-drag on empty space in it (between and beside the controls) or a middle-drag anywhere on it, as you would scroll a list with a finger (#100"},{"p":"interface.html","c":"The interface","a":"the-background","h":"The background","t":"Edit > Preferences > Display (and the View menu) sets the view's Background: Gradient, the charcoal radial gradient (the default), or Flat Colour, one solid colour without the gradient. Click the Background colour swatch to pick the colour; picking one switches to Flat Colour. The choice saves itself for the next session, and each project keeps the background it was saved with. From a script: set_background mode=flat, set_background color=60,70,80 or set_background mode=gradient. Edit > Preferences > Library has Show at startup (on by default), the number of Rows, the Thumbnails size, Placement (along the top of the canvas, or at the bottom above the bottom shelf) and the Library folder. Edit > Preferences > Autosave sets how often a recovery copy is saved (see Projects, autosave and snapshots). Edit > Preferences with the Config and Interface sub-palettes"},{"p":"interface.html","c":"The interface","a":"fullscreen-hiding-panels-and-the-camera-notch","h":"Fullscreen, hiding panels and the camera notch","t":"F11 (or View > Fullscreen) fills the screen with SculptForge; press it again to go back to a window. sculptforge --fullscreen starts that way. SculptForge reopens the way you left it; on macOS a window closed in full screen reopens maximised instead, so the menu bar and the window buttons stay reachable (press F11 or the green button to go full screen again). In the Classic layout, 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, the right-shelf buttons or a 3Dconnexion SpaceMouse, 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: 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 Edit > 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."},{"p":"navigation.html","c":"Navigating the view","a":"orbit-lock","h":"Orbit lock","t":"View > Orbit lock picks how a rotation drag turns the view, one key each: Lock Key A rotation drag Free Alt+Shift+F turns about the screen's axes (the default, as above) Y (turntable) Alt+Shift+Y keeps the model upright: the Turntable rotation above X Alt+Shift+X turns about the world X axis only: from the front, an up or down drag tips the model towards you or away, and sideways drags do nothing Z Alt+Shift+Z turns about the world Z axis only: from the front, a drag around the middle of the view turns the model like a wheel; from the side, an up or down drag tips it With X or Z locked, only the part of the drag that moves across the axis on screen counts, so the axis itself never moves: nothing drifts, however long you drag. Shift still snaps to the nearest side view. The axis gizmo shows the lock: the locked axis runs through its disc in its colour, and a small lock with the axis letter sits at the disc's lower right. The lock is the same setting as Edit > Preferences > Interface > Rotation, saved with your preferences; scripts and the console use orbit_lock axis=free|y|x|z. View > Orbit lock: the X lock picked in the View menu, the axis gizmo with X through its disc and the lock badge 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, or orthographic (Numpad 5): no foreshortening, so sizes don't shrink with depth. The front, side and top views (Numpad 1, 3, 7) switch to orthographic until you rotate again, as in Blender. The X / Y / Z gizmo in the top left of the canvas (Sculpt > Draw & Tablet > Camera > Axes) shows the world axes as the camera sees them, on a soft disc that keeps them readable on dark and light backgrounds. The positive ends are filled circles with their letter, the negative ends smaller rings; the ends pointing away from you are smaller and fainter, and the nearest is drawn on top. Click an end to look from that side, as in Blender: X the right view, Y the top, Z the front, and the ring at the other end of each axis the left, bottom or back view. Click the same end again for the opposite view (Front, then Back). These are orthographic like the numpad views. The end under the pointer gets a ring (a negative end shows its letter), and on an exact side view its name shows under the axes. Drag on the disc between the ends to orbit. Sculpt > Draw & Tablet > Camera > Gizmo size makes the axes Small, Medium (the default) or Large; they grow with the UI scale too, and clicking an end works at every size. View Figure (beside Axes, off until you turn it on) adds a small shaded head in the corner that turns with the camera, so you can tell front from back at a glance. Click it to look from the nearest side: the front, back, left, right, top or bottom view, orthographic like the axes. Navigation starts only on the canvas. A drag that begins on a shelf, a tray or a palette never moves the camera. Blender: with Edit > Preferences > Input > Style on Blender, middle-drag rotates, Shift+middle-drag pans and Ctrl+middle-drag zooms. With a pen or a trackpad, Alt+left-drag beside the model does the same (add Shift to pan, anywhere; Ctrl to zoom); on the model it masks, as in Blender 5.1 and later. Turn on Edit > Preferences > Input > Emulate 3 Button Mouse to make Alt+left-drag turn the view everywhere, as that Blender preference does. The numpad views, Numpad . and Home frame as in Blender. See Blender keys."},{"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 (Maya style: hold Alt, add Ctrl, left-drag sideways) Pan Alt+left-drag on the background, Alt+right-drag, or middle-drag Zoom Mouse wheel (toward the middle of the view, or toward the pointer with Edit > Preferences > Input > Wheel zooms toward the pointer, on in the Maya style); Alt+left-drag on the background, then let go of Alt and keep dragging; Ctrl+right-drag; Ctrl+middle-drag; Ctrl+left-drag on the background when nothing is masked (not with the Classic sculpting keys) Frame the model F (Blender style: Home), or Frame on the right shelf Front, right, top view Numpad 1, Numpad 3, Numpad 7; Ctrl for the back, left and bottom Front, side, top or bottom view with the mouse Click an end of the axis gizmo in the canvas corner Orthographic on or off Numpad 5 Turn in 15 degree steps Numpad 4 / Numpad 6 (around), Numpad 8 / Numpad 2 (over); Numpad 9: the other side Frame the active Part Numpad . (Maya style: also Alt+F) Reset the view Maya style: Alt+H (front, upright, everything in view); any style: Reset view in the Controls window (F1), where you can give it a key Frame one Part Shift+Alt+click it, or triple-click another Part (it becomes the active Part) Sculpt from the background Turn on Edit > Preferences > Input > Start strokes off the model, View > Lock camera, or press Shift+L: a left-drag that starts beside the model sculpts once it reaches the surface Move the camera with Space held Turn on Edit > Preferences > Input > Hold Space and drag to move the camera, then hold Space: left-drag rotates, right- or middle-drag pans, Ctrl+drag zooms, anywhere on the canvas (on the model too) Zoom drags: drag up to come closer, down to back away. With the Classic sculpting keys (Edit > Preferences > Input) they go: drag up to zoom out, down to zoom in. Hold Space and drag to move the camera is off by default, because with the Classic sculpting keys Space opens the Quick Menu. With it on, Space no longer opens the Quick Menu (a right click still does), and a space typed in a text field is never taken. Start strokes off the model (also View > Lock camera) is off by default. With it on (a label at the top of the canvas says so, and in the SculptForge layout the status bar shows CAMERA LOCKED), a left-drag on the background no longer rotates: it waits, and the brush starts where the cursor first reaches the model, so strokes that begin at the silhouette never turn the view by accident. Ctrl (mask) and Shift (smooth) strokes start the same way, and a Ctrl+click on the background still inverts the mask. To move the view, right-drag (a pen's lower button is a right click by default), Alt+drag to pan, middle-drag, or hold Space if Hold Space and drag to move the camera is on; with the Blender or Maya style, Alt+left-drag rotates as before. With a pen that has no buttons and the Classic or SculptForge style, press Shift+L to turn it off while you rotate, or turn on Hold Space. Lasso Mask, Rectangle Mask and the Ctrl+Shift hide and show shapes work as before. Floor grid (View > Floor grid, also Tool > Display; off by default, remembered) draws a faint grid on the floor the model stands on: its lowest point, with the up axis (Y) standing on it. It helps judge perspective and tilt and line up Parts; the red line is the X axis, the blue one Z. The floor moves when a stroke or a move ends (not during it). The squares step up by ten as you zoom out, and the grid fades into the distance; it never draws over the model, even seen from below. \"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 "},{"p":"navigation.html","c":"Navigating the view","a":"touch-screens-and-trackpads","h":"Touch screens and trackpads","t":"Two fingers on the model navigate; they never sculpt. Gesture Touch screen Trackpad Spread or pinch two fingers Zoom in or out Zoom in or out Twist two fingers Roll the view with them Roll the view with them Slide two fingers Pan Zoom (as the scroll wheel) One finger Sculpt, as with the mouse Moves the pointer A twist starts rolling once the fingers have turned about 10 degrees, so a pinch doesn't tilt the view by accident. On a touch screen a single finger waits a moment for a second one before it sculpts; if the second finger lands after a stroke has started, the stroke ends there and the fingers take over the view (one undo removes the stroke)."},{"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. 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 View menu and Sculpt > Symmetry & Gizmo."},{"p":"navigation.html","c":"Navigating the view","a":"spacemouse-experimental","h":"SpaceMouse (experimental)","t":"A 3Dconnexion SpaceMouse lets one hand move the view while the other holds the pen. SculptForge reads it directly as a USB device, without 3Dconnexion's driver or SDK, so this is experimental: it has been tested with simulated input only, not yet with a real SpaceMouse. Tell us how it works with yours (GitHub issue #6). Plug it in and it works: Edit > Preferences > Input shows its name under SpaceMouse (experimental), with live bars for its six axes. The model moves the way you move the cap, and turns about the same point the mouse orbits around (the camera's target: Frame sets it to the scene's centre, and panning moves it). Move the cap The view Push left / right Pans left / right Pull up / push down Pans up / down Pull towards you / push away Zooms in / out Twist Turns the model around Tilt towards you / away Tips the model's top towards you / away Roll left / right Rolls the model on screen (not with Lock rotation to turntable) Left side button Frame Right side button Front view The speed is the same whatever the frame rate: holding the cap for a second turns the model just as far on a slow machine as on a fast one. It works in every input style (SculptForge, classic, Blender, Maya) and while a stroke is held: the stroke keeps going, sculpting wherever the pen points on the turned model. Many people stop moving the pen while they turn the view, and that works best, but you don't have to. Edit > Preferences > Input > SpaceMouse: Use SpaceMouse: off ignores it completely, buttons too. Speed: how fast the view moves for the same push. Dead zone: how far the cap must move before anything happens (8% by default), so a hand resting on it doesn't drift the view. The live bars turn orange once an axis is past it. Lock rotation to turntable: the model stays upright; twisting turns it about the world's up axis and rolling the cap does nothing. Hold during strokes (on by default): while you sculpt, paint or mask, the SpaceMouse leaves the view alone and its buttons do nothing, so a hand resting on the cap never moves the model under the pen. Turn it off to turn the view mid-stroke. Dominant axis: only the direction you push the most moves the view, so a twist doesn't also pan a little. Invert: reverse any of the six moves (Pan X, Zoom, Pan Y, Tilt, Roll, Spin). If a direction feels wrong on your model of SpaceMouse, flip it here. Left button, Right button (and Button 3 onwards on models with more): Frame, Frame Part, the axis views, Orthographic, Undo, Redo or Nothing. SpaceMouse defaults puts everything back. These settings save themselves. If SculptForge doesn't see it (Preferences says \"No SpaceMouse found\"): Windows: 3Dconnexion's driver, 3DxWare, can keep the device to itself, and may also move the view on its own as it does in other programs. Quit 3DxWare (its tray icon, or stop the 3DxService service in Task Manager > Services), unplug the SpaceMouse and plug it back in. Without 3DxWare, Windows treats the SpaceMouse as a game controller, which is how SculptForge reads it. If SculptForge sees the SpaceMouse with 3DxWare running, give the buttons a job in only one of the two places, or one press does two things. macOS: the same applies to 3DxWare for Mac: quit it (or uninstall it) and plug the SpaceMouse in again. Suspending it isn't enough: suspended, it can still move the pointer and scroll while you push the cap. Linux: if spacenavd is running, it normally opens the device exclusively. SculptForge may still list the SpaceMouse but get no motion from it. Stop it while you sculpt (sudo systemctl stop spacenavd). SculptForge reads the device through /dev/input as a joystick: that works when the kernel reports the cap's axes as absolute axes, which is how joysticks work. If the kernel reports them as relative motion, as it does for some older models, the SpaceMouse doesn't show up at all. Reading it through spacenavd isn't supported yet. If it shows up but the view doesn't move (the live bars stay still when you push the cap), a"},{"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 Part, 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":"saved-views","h":"Saved views","t":"View > Views has a button for each axis view (Front, Back, Left, Right, Top, Bottom) and your own saved cameras. Type a name (or leave it empty for \"View 1\", \"View 2\" ...) and click Save View (Ctrl+Alt+Numpad 0); saving under a name that exists replaces it. Click a name to go back to that view, or press Numpad 0 for the one used last; x forgets it. Saved views are kept in the project."},{"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 View menu: Wire (Shift+F): shows the polygons of the active Part over the surface as a wireframe. Quads show as quads (see Quads and triangles). Useful for judging mesh density before you subdivide or remesh. Groups: colours each face group. Mask: tints masked areas dark (how dark: Mask darkness in Edit > Preferences > Interface). Paint: shows vertex paint colours (off shows the plain material). Solo: shows only the active Part, to get at parts hidden behind others. Show Mesh (View menu): 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 rotation around the point under the cursor (the camera always orbits its target, which Frame sets to the scene centre) and no floor grid. Pan the target onto the area you're working on to orbit around it, or zoom there with the wheel and Wheel zooms toward the pointer on: that moves the target toward the point under the pointer too."},{"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 Part 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 Part, and only on parts that are visible and not masked. A stroke that started on the model keeps sculpting when it slides past the edge of a form seen in profile, as long as the brush circle still covers the model: the brush holds on to the silhouette (#84)."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"built-in-brushes","h":"Built-in brushes","t":"SculptForge has nineteen 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. Intensity and pen pressure set how fast it builds. 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 Sharp Crease 9 A narrow, deep V-shaped crease with the sides pinched in. A sharp ridge Clay Block 0 Square, flat-topped clay strokes for blocking in forms. Carves flat-bottomed Tendril Pulls the surface out into horns and tendrils that taper as you drag. No change Trim Trim: 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 VDM Stamps a vector displacement map, overhangs and all (see below). Digs the shape in KelvinGrab Elastic move: drags the surface like real clay, with no falloff edge (see Kelvinlet brushes). No change KelvinTwist Press and drag right to turn the surface clockwise around that point, left to turn it back. Turns the other way KelvinScale Press and drag left to pinch the surface toward that point, right to swell it. The other way Elastic Tendril An elastic Tendril: smooth horns and tendrils that taper as they stretch. No change DetailClone Paints copies of a captured detail (the VDM brush's map) along the stroke, each turned to follow it. Digs them in Morph Pulls the surface back toward the morph target, a selection set with its shape (Selection sets). Does nothing until you pick one. Pushes away from it Paint P Paints colour without sculpting. See Vertex Paint and materials. Paints back to white Notes on particular brushes: Move, Tendril and the Kelvinlet brushes (except Detail Clone) 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 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."},{"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 Sculpt > 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 Carve Scrapes hard planes and breaks them up with cracks for rocks and ruins. Skin Pores Sprinkles tiny pores for close-up skin detail. Clay Slab 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 is outlined in the accent colour 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. Sculpt > Brush: 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 Library library that aren't loaded yet; picking one loads it. The brush picker after pressing B, with letter badges The picker works, by typing letters: Press B. Type the first letter of the brush. Only brushes starting with that letter stay, and each shows a highlighted 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)."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"size-intensity-colour-intensity-and-falloff","h":"Size, Intensity, Colour intensity and Falloff","t":"These values control every brush. Size and Intensity are on the top shelf; all four are in Sculpt > Draw & Tablet and the Quick Menu. Setting Range Default How to change it 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. Intensity 1 to 100 50 How strongly each dab changes the surface. U opens a slider at the cursor. Colour 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. Falloff -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 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: the outer one is the Size, the inner one is Falloff (where the brush works at half strength). Masking, painting, Move and Tendril follow Falloff too. Custom brushes made in Brush Lab and Clay Block's square tip keep their own tip shape at 0 and shift it like the others. With an alpha, Falloff works: the alpha is multiplied by the round falloff. At -100 the whole alpha shows, hard to its edges (a Square alpha stamps the full square); at 0 the falloff softens it and rounds a square's corners; at +100 only a soft point in the middle is left. Over the model, the rings lie on the surface: true circles in the plane of the surface under the pointer, at the brush's real size there, with a short line pointing out of the surface. The plane follows the form averaged over the whole brush, so the rings stay round and steady over fine bumps and detail. With symmetry on (mirror or radial), a dot shows where each copy of the brush lands. Off the model the rings are flat circles. Edit > Preferences > Cursor: Cursor follows surface (on by default) switches back to flat rings everywhere, and Hide ring while stroking (off by default) shows only the dot while a stroke runs. The crosshair pointer stays while you turn the view. 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 Falloff). Esc closes the pop-up without typing anything new."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"each-brush-keeps-its-own-settings","h":"Each brush keeps its own settings","t":"Every brush remembers its own Size, Intensity, Falloff, Colour intensity, stroke and alpha. That includes custom and Community brushes. Set up a small, sharp crease brush and a big Clay brush, and each one comes back the way you left it when you switch between them. A brush you haven't used yet in the session starts from the values you have now, so nothing jumps. Sculpt > Brush > Save Brush Settings keeps the current brush's values for every new session (in brush-settings.json, in SculptForge's user data folder). Sculpt > Brush > Reset Brush to Default puts the current brush back to the values SculptForge ships with and forgets what you saved for it. Edit > Preferences > Input > Share size and intensity across brushes (off by default) keeps Size and Intensity the same for every brush, as before 0.10.8. Falloff, Colour intensity, the stroke and the alpha still follow each brush."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"smooths-own-intensity","h":"Smooth's own Intensity","t":"Smooth keeps an Intensity of its own, so a gentle Standard stroke at 10 still smooths at full speed. Hold Shift (or pick the Smooth brush) and the Intensity slider shows Smooth Intensity: change it there, or hold Shift and press U. It starts at 50."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"smooth-that-keeps-the-volume","h":"Smooth that keeps the volume","t":"The plain smooth evens out bumps by pulling each point towards its neighbours, so with every pass the form shrinks a little too: a cheek flattens, a sphere gets smaller. The other smooth keeps the volume: it removes the bumps but leaves the form where it is (a Taubin smooth, one step in and a slightly larger one back out). Alternate smooth: start a stroke with Shift held, then let go of Shift while still pressing. The rest of the stroke uses the other smooth, and the status line says which. Smooth keeps volume in Sculpt > Brush makes the volume-keeping smooth the one Shift and the Smooth brush use; letting go of Shift mid-stroke then switches to the plain one. Saved with the project."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"smooth-face-group-borders","h":"Smooth face group borders","t":"Smooth face group borders only in Sculpt > Brush turns Smooth (and Shift) into a border straightener: only the points on a border between face groups move, each along the surface toward its neighbours on the border, so a jagged edge (a cuff, a collar, the hem of a shirt, a panel line) becomes a clean line while the rest of the model stays where it is. Corners where three or more groups meet stay put. Group the clothing first (for example Group from Mask after masking it), then brush over the edge. Saved with the project (#81). On a micro level (see Micro levels) Smooth is always the plain one for now. On a quad mesh (after Quad Remesh, or an imported quad model) Smooth follows the quads' own edges, never their diagonals, so the quads keep their shape (#69). Sculpt > Draw & Tablet"},{"p":"sculpting.html","c":"Sculpting and brushes","a":"sculpt-paint-add-sub-rgb-and-front","h":"Sculpt, Paint, Add, Sub, Rgb and Front","t":"These toggles sit on the top shelf and in Sculpt > Draw & Tablet: Control What it does Sculpt / Paint Sculpt makes brushes change the shape. Paint (P) paints colour only. Add / Sub Add makes brushes add (the default), Sub makes them subtract. Alt flips the current choice for one stroke. Rgb Sculpt brushes also paint the current colour as they sculpt. Front Front faces only: brushes leave the far side of thin parts alone, such as the back of an ear or a cape. Sculpt > Brush has the same Front and invert settings as the checkboxes Front faces only and Invert (Alt)."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"falloff-options","h":"Falloff options","t":"Two more checkboxes in Sculpt > Brush change what a brush reaches, as Blender's proportional editing does (from the discussions). Both work with every sculpt brush, recipes, VDM stamps, masking and vertex paint, and are saved with the preferences and the project (custom brushes can turn them on for themselves in the Brush Lab): Option What it does Connected only The brush only moves the surface joined to the point under the cursor, within the brush size. Inflate a finger and the next finger stays as it is; Move one leg and the other doesn't follow, however close they are. View falloff The falloff is measured on screen, across the view: everything inside the brush circle is reached, through the model and out the back, as a cylinder along the view. Add Connected only to keep it to the piece under the cursor. Kelvinlet brushes keep their own elastic falloff, and the Gizmo's falloff eases in from the mask's edge rather than from a brush centre, so these options don't apply to them. On a 10-million-vertex Part a dab that moves half a million vertices takes about 10 ms, and about 16 ms with Connected only."},{"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). For Move, Tendril, Elastic Tendril and KelvinGrab, which have nothing to invert, it moves the surface along the normal instead (below). Shift (before the stroke) Smooths with the Smooth brush, whatever brush is active, at Smooth's own 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 face groups. See Face Groups and visibility."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"along-the-normal","h":"Along the normal","t":"Move, Tendril, Elastic Tendril and KelvinGrab normally move the surface across the screen. Hold Alt as you start the stroke (Ctrl in the Blender and Maya styles, where that key inverts) and the surface moves along the average normal under the brush where you pressed instead (from the discussions): drag out and it pulls straight out of the surface, drag back and it pushes straight in, however the view is turned. When the normal points right at you, drag up to pull it out. Edit > Preferences > Input > Along the normal can make it Always (no key needed, handy with a pen) or Never."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"the-quick-menu","h":"The Quick Menu","t":"Press Space for the Quick Menu under the cursor: the Brush, Stroke, Alpha and Material tiles, Size, Falloff, Intensity and Colour intensity, Add / Sub, 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. A right click on the canvas opens it too: press the right button and let go without moving, beside the model or on it, and the Quick Menu stays open at the cursor. A right drag still turns the view (and pans or zooms with Alt or Ctrl), and a pen button set to Right click (Edit > Preferences > Tablet) works the same way. Turn it off with Edit > Preferences > Input > Right click opens the Quick Menu."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"radial-menus","h":"Radial menus","t":"Radial (pie) menus put the tools you use most around the cursor. Hold a menu's key, flick the pointer toward an item and let go: it runs. Let go in the middle and nothing happens. Tap the key instead and the pie stays open: click an item, or click in the middle or press Esc to close it. Three menus are built in: Key Menu Items T Brushes Standard, Clay Block, Move, Sharp Crease, Inflate, Pinch, Flatten, Tendril Y Masking Invert Mask, Lasso Mask, Clear Mask, Rectangle Mask, Mask All, Mask Pen, View Mask, Group from Mask J Strokes Dots, Drag Stamp, Slide Stamp, Spray, Lazy Stroke (see Strokes) All three keys are free in every input style. Installs that stored their radial menus before 0.10.9 get the Strokes menu from Restore default menus in Edit > Preferences > Input > Radial Menus. Make your own in Edit > Preferences > Input > Radial Menus (up to 8 menus of 8 items each): + adds a menu and opens a search for its first item. An item can be anything the command palette (F3) finds: a brush, a tool, a command or a toggle. Click an item to give it your own label and icon, or Change action. The arrows reorder items (the first points up, the rest go clockwise); the cross removes one. Key sets the key that opens the menu (it is an ordinary shortcut, so Edit > Preferences > Hotkeys lists it too). The button next to it can also open the menu while held: the middle, right, back or forward mouse button, or one of the pen's side buttons. That button then stops doing what it did before (a pen button's Edit > Preferences > Tablet mapping, the middle button's pan, the right button's turn). A mouse button opens the menu only with no modifier key held (#74): Alt+middle still pans, Alt+right still zooms in the Maya style, and Shift+right-drag still turns the view, so a menu on the right button never leaves you without a way to turn it (the panel says how). Export... saves the menu as a small .json file to share; Import... loads one. A menu file holds only action names, never anything that runs: names this version doesn't know are left out. Restore default menus brings back Brushes and Masking. Your menus save themselves."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"whole-part-deformations","h":"Whole-Part deformations","t":"Tool > Deformation has four operations that work on the whole active Part at once, each with its amount beside it (from the discussions). The mask holds what it covers (partly masked areas move partly), hidden faces and open borders stay where they are, and each is one undo step: Operation What it does Polish Flattens fine noise and small bumps while flat areas and sharp edges stay sharp: a scan's grain, or the ripples a voxel remesh leaves on a hard-surface piece. Relax Evens out the spacing of the vertices along the surface without changing its shape, for areas a big Move or Tendril stretched. Smooth Smooths everything; with Smooth keeps volume it doesn't shrink the form. Balloon Fills the form out toward a rounder volume, like blowing into it (experienced sculptors: Inflate Balloon). A negative amount lets the air out. They are commands too: deform_polish amount=60, deform_relax, deform_smooth amount=30 keep_volume=true, deform_balloon amount=-20 (add masked=false to ignore the mask). On a 10-million-vertex Part at amount 50, Smooth takes about 0.5 s, Balloon 0.7 s, Relax 0.9 s and Polish 2 s (Apple M1 Pro)."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"size","h":"Size","t":"Tool > Deformation > Size shows the active Part's width (X), height (Y) and depth (Z) in scene units (requested by foirgairwolf on Discord). Drag one, or double-click it and type an exact value: the Part resizes about its centre as one undo step. With Uniform on (the default) the other sides follow in proportion; off, only that side changes. The mask holds what it covers. Command: deform_size x=2.5 (any of x, y, z), or deform_size uniform=10 for the largest side."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"deformation-stack","h":"Deformation stack","t":"Tool > Deformation > Stack shapes the whole Part with a list of steps (requested by foirgairwolf on Discord). Add step picks one; click a step to set its amount, its axes (X Y Z, any mix) and, where it applies, Direction and Soft. With Preview on, the Part follows each change (on very heavy Parts, when you let go of the slider). Group Step What it does along the chosen axis Transform Move Moves the Part by a percent of its half-size. Turn Turns it by degrees about the axis (several axes: X, then Y, then Z). Scale 100 doubles it, -100 halves it, on the chosen axes only. Squash Shorter along the axis and wider across it, keeping the volume (negative: taller and thinner). Bend & Twist Bend Curves it end to end by degrees toward Direction (0 = toward +Y, +X for the Y axis). Twist Turns one end against the other by degrees. Taper The + end wider and the - end narrower (negative: the other way). Shear Leans it toward Direction; 100 is 45 degrees. Shape Round Toward a sphere; with one axis left out, toward a cylinder about it. Box Toward a cube (or a square bar). Flatten Cuts the + side flat by a percent of the depth (negative: the - side). Sag Parts far from the axis droop down it, like a weight on outstretched arms (negative lifts). Depth A perspective: the + end wider, the - end narrower, more toward the ends. Surface Polish, Relax, Smooth, Balloon As above. Soft eases Bend, Twist, Taper and Shear toward the ends (a bend that curves most in the middle) and rounds Flatten's cut. Steps work about the Part's centre, or about the gizmo's pivot when you placed it. The checkbox beside a step switches it off without losing it; Repeat adds the selected step again; Remove takes it out. Apply keeps the result (one undo step) and starts a new stack, Apply Selected keeps only the selected step, and Reset takes the preview back off. The mask holds what it covers and hidden faces stay. For scripts and the AI: deform_stack ops=\"bend 45 y soft; twist 90 y; taper -30 y\", or one step at a time with deform_bend amount=45 axes=y soft=true direction=90."},{"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 Sculpt > Stroke. 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. Drag Stamp Click and drag one stamp: the drag length sets its size and its direction the rotation. Great with alphas. None Slide Stamp Click and drag one stamp of the brush's 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. Lazy Stroke Dots with Steady Stroke on: the brush trails the cursor on a string, for smooth, steady lines. Steady radius (1 to 300 px, default 40): longer is steadier. Scatter appears under the stroke tiles when Spray is selected. Steady Stroke works with every stroke type; see Precision work. Continuous, under the stroke tiles in the stroke picker and in Sculpt > Stroke, keeps the brush working while you hold it still on the model (30 dabs a second), with any stroke type. Notes: With Drag Stamp, 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 Slide Stamp, 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 Drag Stamp or Slide Stamp is selected. Custom brushes set their own dab spacing and can add jitter (see Brush Lab)."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"the-stroke-popup","h":"The stroke popup","t":"Press G (Z in the Blender style) for a grid under the cursor, or click the grid button under the Stroke tile on the left shelf. The top row holds the stroke types, then come the modifiers and the shapes: Modifier What it does Instead of holding Add / Sub Brushes add to or subtract from the surface (the same switch as Add / Sub on the top shelf). Alt Smooth Strokes smooth. Shift Mask Strokes paint the mask (Alt or Ctrl unmasks). Ctrl Select Strokes draw the selection (hide) shape. Ctrl+Shift Shapes pick how Mask and Select draw: Mask Pen, Lasso Mask and Rectangle Mask turn Mask on with that shape, Cut Line, Cut Lasso, Cut Rect and Cut Polyline turn Select on with that Cut shape. A plain drag then masks or cuts with it, no keys held (with a mask shape, Ctrl+drag unmasks; Tool > Cut still sets Away, In, Add or Clip). The label next to the brush cursor names the shape. Pick it again to go back to sculpting. Hold and let go: hold G, move over an item and let go. It opens with your current stroke under the pointer, so letting go without moving changes nothing. A pen hovering over the tablet works the same. Tap and click: tap G and the grid stays open. Click a stroke to pick it (the grid closes); click a modifier to switch it (the grid stays open, so you can set a stroke too). Esc or a click beside the grid closes it. The click never touches the model. Smooth, Mask and Select stay on until you pick the same one again or pick another brush. A small label next to the brush cursor shows which one is on. Dragging beside the model still turns the view. The Strokes radial menu (J, see Radial menus) picks a stroke type too; the popup adds the modifiers and shows every choice at once. Change the key in Edit > Preferences > Hotkeys (Stroke popup), or hold Ctrl+Alt and click the shelf button, then press the new key."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"precision-work","h":"Precision work","t":"Pores, wrinkles, jewellery and hard-surface trims need a brush that goes exactly where you mean, at exactly the size you mean. These tools work with every brush and every stroke type. Steady Stroke (L, or the checkbox in the stroke picker). The brush trails the cursor on a string and only moves once the string is taut, so hand shake never reaches the surface. It works with Dots, Drag Stamp, Slide Stamp and Spray. The viewport draws the string and a faint circle of its length. Steady radius sets the length (longer is steadier). Catch up on release (on by default) finishes the line to where the cursor is when you let go; turn it off to end the line a string's length behind. World Size (Sculpt > Draw & Tablet). Size is normally in screen pixels, so the brush gets smaller on the model as you zoom in. With World Size on, the size is kept in model units instead: a 0.4 mm pore brush stays 0.4 mm whether you are looking at the whole head or one eyelid. Every Size slider shows both numbers, for example Size 12 px 0.40 mm; the mm figure is the brush radius on the surface under the cursor (a model unit is a metre, as when exporting for 3D printing). Finer size control. Do this Change [ / ] 10% smaller / larger Shift+[ / Shift+] 1 px smaller / larger (0.5 px below 2 px) Ctrl+Shift+right-drag Scrub the size finely: 100 px to the right is about 1.5 times larger Size goes down to 0.5 px. Small brushes space their dabs closer together, so a 1 px stroke is still one continuous line, and the cursor adds a small cross so you can see where a tiny brush is. The size, in px and mm, shows next to the cursor for a moment after it changes (all the time with World Size on). Precision drag (Shift+Alt, held while drawing). Start the stroke, then hold Shift+Alt: the brush moves at a quarter of the pen's speed, drawn as a blue ring with a line back to the pen, and works at Precision Intensity (stroke picker, default 10). Let go and the brush glides back under the pen as you keep moving; it never jumps. Hold the keys after the stroke has started: at the press, Shift+Alt still selects and frames a Part, and in the Blender style Alt+click still navigates. The same works in every input style. A pressure curve for each brush. Every brush keeps its own pen pressure curve, applied after the tablet's curve. Edit it in Brush Lab (under the recipe sliders) or in Edit > Preferences > Tablet (under the tablet's curve); both edit the brush you are holding. Drag a point, double-click the curve to add one (up to 5), right-click a point to remove it. The presets are Soft, Linear, Firm and Fine detail: Fine detail keeps light pressure very light and tops out below full strength, for pores and fine lines. Curves are saved as you change them. Accuracy. The brush centre sits exactly under the cursor at any zoom and on HiDPI screens (to a fraction of a pixel), and the surface point under the brush is lightly filtered, so strokes on very dense meshes don't wobble with every tiny bump. A real step in the surface is followed at once."},{"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 Sculpt > Alpha, which also shows a large preview of the current alpha. Falloff fades it: set it to -100 to stamp the whole alpha (a crisp square, or a pattern out to its edges), 0 for a soft round fade, +100 for a soft point. Alphas work on micro levels too, with every stroke type including Drag Stamp. 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. Pores Scattered skin pores of mixed sizes (use with Sub to press them in). Cracks A web of thin cracks, as in dry earth, old paint or stone. Scales Overlapping rounded scales in offset rows, for reptiles and fish. Rivets A three by three grid of round rivet heads, for armour and machines. Stitches A seam with cross stitches along it (drag along the seam with Drag Stamp or a stroke). Fabric Weave Threads woven over and under, for cloth and canvas. Bark Rough vertical ridges and furrows, as on tree bark. Rock Strata Stepped layers of rock, wavy and broken, for cliffs and stone. Wrinkles Fine parallel wrinkle lines, for skin around eyes, knuckles and necks. Skin Folds Soft, broad folds of skin, for bellies, elbows and heavy brows. Hair Strands Long flowing strands, for hair, fur and feathers (drag along the flow). Dot Grid An even grid of soft dots, for studs, textures and patterns. All of them are made by SculptForge itself the first time they're needed (no image files are downloaded or shipped). They show in the alpha picker and in the Library's Alpha tab (brush_set_alpha name=cracks). To use your own image: Click Load image... in the alpha picker or Sculpt > Alpha. 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 Library 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 Drag Stamp it follows the drag direction instead. From a script: brush_set_alpha name=square, or brush_set_alpha path=bark.png invert=true."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"alpha-options","h":"Alpha options","t":"Under the preview in Sculpt > Alpha: Option What it does Follow stroke direction The alpha turns with the stroke, its top pointing the way you draw: scales, stitches and hair line up along the stroke. Small wobbles are smoothed out, as with Blender's Rake: the direction is taken again each time the cursor has gone 20 pixels. Angle Turns the alpha by a fixed angle (-180 to 180 degrees, counter-clockwise), on its own or on top of the stroke's direction. Angle jitter Turns each dab by a random angle, up to this many degrees either way, to break up repeats. Tile across / Tile down Repeats the alpha 1 to 8 times across and down inside the brush; the preview shows the result. They work with every brush, custom and Community brushes included, and each brush keeps its own (see Each brush keeps its own settings). Save Brush Settings on a custom brush also writes Follow stroke direction, Angle and Angle jitter into its brush file, so a brush you share (a brush code, a .sfpack) turns its alpha the same way for everyone. Vector displacement stamps have the same options: see Stamp rotation. From a script: brush_alpha_options follow_stroke=true angle=30 angle_jitter=10 tile_x=2 tile_y=2."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"stencil","h":"Stencil","t":"A Stencil is an image laid over the view that you sculpt and paint through: wherever it covers the model, a stroke takes its detail (the sculpt brushes its brightness, white = full effect, as an alpha; Vertex Paint its colours). Off the image nothing happens. It stays put on the screen while the model turns under it, so you place it, stroke over it, turn the model or move the stencil, and stroke again. A Cobblestone stencil over a sphere, turned and placed with Adjust In Sculpt > Alpha, under Stencil, click Load image... (any PNG, JPG, BMP, TGA, PSD or GIF), or Use alpha to make the brush's alpha (a built-in pattern or one from your Library) the stencil. Turn on Adjust: drag inside the stencil to move it, a corner to scale it, the round handle above it to turn it (Shift: 15 degree steps). The arrow keys move it, - and = scale it, , and . turn it (Shift: finely). Enter or Esc goes back to sculpting. Stroke over it with any brush that takes an alpha: the built-in sculpt brushes, custom and Community brushes and the Paint brush. The brush's own falloff, Intensity, mask and alpha still apply on top. The same sphere with the stencil hidden: four Standard strokes left its stones Option What it does Show Hidden, the stencil is off and brushes work as if it weren't there. Invert Uses the image's negative: black works, white leaves the surface alone. Tile Repeats the image across the whole view, for skin, fabric and other patterns. Paint its colours Vertex Paint lays the image's own colours; off, its brightness masks the paint colour. Hide while navigating Fades the stencil while the view turns, moves or zooms, so you see the model under it. Opacity How strongly the overlay shows. The brushes always take the whole image (use Intensity to go lighter). Size / Angle Its height in percent of the view's, and its turn; Reset placement centres it again. With symmetry on, the mirrored side gets the stencil mirrored, as the stroke is. Stencils work on micro levels too. Move, the Kelvinlet brushes, vector displacement stamps and the mask brush don't use it. Texture painting doesn't take it yet (Vertex Paint does). The stencil isn't saved with the project. From a script: stencil_load path=skin.png, stencil_set x=0.5 y=0.5 size=0.8 angle=30 tile=true, stencil_clear."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"vector-displacement-brushes","h":"Vector displacement brushes","t":"A vector displacement brush 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 Sculpt > Brush > Vector Displacement"},{"p":"sculpting.html","c":"Sculpting and brushes","a":"stamp-a-vdm","h":"Stamp a VDM","t":"Open Sculpt > Brush and its Vector Displacement section, and click a map: Horn, Ear Curl, Scales, Nostril, Rivet (a domed head whose rim overhangs), Stitches (thread bars across a seam, drawing it together), Skin Fold (a roll of skin hanging over a crease), Wrinkle Line (a fine pinched crease), Crack (a jagged split whose sides part) or Rock Ledge (a stepped shelf jutting out over the layer below). They're also in the Library's Brush tab. The VDM brush becomes the brush and the stroke becomes Drag Stamp. (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. Slide Stamp stamps at the brush size instead and slides the stamp under the cursor until you let go. 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."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"stamp-rotation","h":"Stamp rotation","t":"While the VDM brush is the brush, Stamp rotation sits under the map's preview, with the same three options as Alpha options: Option What it does Follow stroke direction On (the default): Drag Stamp turns the stamp with the drag, and a Dots stroke turns it along the stroke. Off: the drag only sets the size, and every stamp keeps Angle's turn (horns that all stand the same way however you drag). Angle A fixed turn, -180 to 180 degrees counter-clockwise, on its own or on top of the drag's direction. Slide Stamp takes it too (it slides the stamp without turning it). Angle jitter Each stamp turns by a random angle, up to this many degrees either way: scattered horns, rivets or scales that don't all face the same way. The VDM brush keeps its own, separate from the alpha brushes'; Save Brush Settings keeps them for next time, and a custom brush saves them in its brush file, so they travel in brush codes and packs. From a script: brush_alpha_options follow_stroke=false angle=45 angle_jitter=20. 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 Sculpt > Brush > Vector Displacement, click New VDM Plane. A flat 2 x 2 grid appears as a new Part, seen from the top, with its border masked (so the stamp blends into any surface); the other Parts are hidden. Plane Res sets how many quads it has (256 by default). Sculpt the shape with any brush: overhangs are welcome (Move, Tendril, 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 Part 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 Drag Stamp 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","h":"Load and export maps","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 Drag Stamp) 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. Maps made in other applications may use other axes. If a map 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\"."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"kelvinlet-brushes","h":"Kelvinlet brushes","t":"KelvinGrab, KelvinTwist, KelvinScale and Elastic Tendril move the surface the way an elastic solid moves when you push, twist or squeeze it. Each is the exact solution of the equations of elasticity for a softened point load (the \"regularized Kelvinlets\" of de Goes and James, SIGGRAPH 2017), so the surface follows your hand like clay: there is no falloff edge to see, the deformation fades smoothly over about twice the brush radius, and the material around it reacts the way real material does. KelvinGrab pulls with symmetry and Squash at 100, and a KelvinTwist in the middle: no falloff edge anywhere KelvinGrab works like Move: press on the model and drag; the point under the cursor goes where the cursor goes and the surface around it follows elastically. KelvinTwist turns the surface around where you pressed, about the view direction. Drag right to turn clockwise, left to turn back; the turn is strongest at the centre and fades out, and every ring keeps its shape (a true rotation), so twisted shapes keep their volume. Good for twisting horns, tentacles, folds of cloth and spiral shells. KelvinScale pinches (drag left) or swells (drag right) the surface toward or away from where you pressed. It never folds the surface through the centre, however hard you pinch. Elastic Tendril pulls horns, tentacles and spikes out along the stroke like Tendril, but its pull narrows as it travels, so shapes taper to a tip by themselves. Their settings are in Sculpt > Brush > Kelvinlet & Capture: Squash (0-100) is how the material keeps its volume (its Poisson's ratio). At 0 it's rubbery: pulling it just stretches it. At 100 it's incompressible clay: pressing in makes the surface bulge up around your thumb and pulling out draws the sides in, as clay does. 50 is the default. Sharpness gives the brush a tighter, more pointed peak at its centre while keeping its soft reach, for pulling out points and tips. Intensity sets how strongly the surface follows (50 and above: the grabbed point follows the cursor exactly), pen pressure scales it, and like every brush they respect symmetry, the mask, hidden parts and sculpt layers, and each stroke is one undo step. They don't remesh with dynamic topology on (like Move). How it stays fast: a Kelvinlet's influence never quite reaches zero, so each move works out how far its effect is still more than 4% of its largest (about twice the brush radius) and only touches the points inside that distance, fading the last part smoothly to nothing. A fast drag between two frames is worked out in small pieces in one pass. Because it reaches further than Move, it costs more: on models of 20 million triangles and up, keep the brush small or step down a subdivision level for big elastic moves (see Performance)."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"capture-an-alpha-or-a-vdm-from-the-model","h":"Capture an alpha or a VDM from the model","t":"Any detail you have sculpted can become a brush in two seconds: Capture from view (Ctrl+Alt+C, or the button in Sculpt > Brush > Kelvinlet & Capture). A horn captured from the sphere (the window: its height alpha and VDM) and cloned along a stroke below it Press Ctrl+Alt+C and drag a square over the detail, corner to corner (hold Shift as you press to drag a circle from its centre instead). Esc cancels. The Capture from view window shows two results, side by side: a height alpha: the surface's height toward you, measured from a plane fitted to the surface and scaled to black-to-white; a vector displacement map: the true 3D offset of every point from a smooth base surface, in that base's own frame, so overhangs and sideways leans come along. Adjust if needed: Base Smoothing decides what counts as detail (0 measures from a flat plane, the whole shape; higher takes more of the broad form away, so a wrinkle captured on a curved forehead stamps flat), Edge Fade blends the border out, Resolution sets the pixels, Fit plane and Invert apply to the alpha. Changes capture again from the same square. Use it: Use as Alpha (it shapes every brush), Use as VDM (the VDM brush stamps it with Drag Stamp), Detail Clone (paint copies along strokes) or Save to Library: the alpha goes to your Library Alphas folder as a PNG and the VDM to your brush library, both with thumbnails (the VDM also shows in the Library Brush tab, the alpha picker and Sculpt > Brush > Vector Displacement). The square is captured along your view, so look at the detail straight on. The capture takes about a tenth of a second for a small detail and a second or so for a large patch of a 20-million-triangle model."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"detail-clone","h":"Detail Clone","t":"DetailClone stamps the VDM brush's map (a captured one or any other) along your stroke, one copy every stamp width, each turned so its top points the way the stroke goes: rows of scales, rivets, stitches or warts that follow a curve. Clone Spacing sets the distance between copies (1 = edge to edge) and Clone follows stroke can keep every copy upright instead. Size sets their size and Intensity their depth; a click without moving stamps one. Each copy is shaped to the surface under it."},{"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 Sculpt > Symmetry & Gizmo. 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: turn on Local (below)."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"radial-symmetry","h":"Radial symmetry","t":"Radial symmetry repeats every stroke around an axis, for wheels, flowers, columns, crowns and other round ornaments. Turn it on with R on the top shelf or in Sculpt > Symmetry & Gizmo > Symmetry, then set: Radial Copies: how many copies, evenly spaced around the axis (2 to 64; 8 to start with). X axis, Y axis or Z axis: the axis the copies turn around (Y, up, by default). Radial symmetry works with the mirror axes: with X on as well, each copy is also mirrored, so 8 radial copies make 16. It applies wherever symmetry does: every brush and stroke type, mask and smooth strokes, vertex paint and texture painting, Rectangle Mask / Lasso Mask and Select Rectangle / Select Lasso, Dynamic Topology (new triangles appear on every copy) and Insert on the model. The brush cursor shows on every copy, so you can see where each one lands."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"local-symmetry","h":"Local symmetry","t":"Local (next to R in Sculpt > Symmetry & Gizmo > Symmetry) puts the mirror planes and the radial axis through the middle of the active Part (the centre of its bounding box) instead of the world origin. Use it for a Part that isn't centred on the origin, such as a button on a jacket or a wheel on a car. The centre follows the Part: it is worked out again when you switch Parts or after an edit. R and Local have no default key; you can assign one (see The interface). Projects save the symmetry settings, radial and local included. Scripts and sculptforge-cli use the same settings: commands that take symmetry (stroke, vdm_stamp, mask_rect, mask_lasso, hide_rect, hide_lasso, insert_primitive, insert_mesh) also take radial (the count), radial_axis (x, y or z) and local (true for the Part's centre), for example stroke points=... symmetry=x radial=8 radial_axis=y."},{"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, Sculpt > Draw & Tablet 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 Sculpt > Draw & Tablet > 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). Move, KelvinGrab, KelvinTwist and KelvinScale always grab with the full size. Each brush can override them. Sculpt > Brush > Pen pressure (and the same switches in Brush Lab and Edit > Preferences > Tablet) sets Size and Strength for the brush you are holding to Use global, On or Off. Use global follows the toggles above; On and Off apply to that brush whatever the toggles say, so you can keep Pressure > Size on for Clay and off for Standard. Grab brushes (Move, KelvinGrab, KelvinTwist, KelvinScale, Tendril and Elastic Tendril) start with Size: Off, every other brush with Use global. The switches are kept per brush like its size and alpha: Sculpt > Brush > Save Brush Settings keeps them for the next start, Reset Brush to Default puts back the brush's default, and a custom brush also keeps them in its .sfbrush file. Brush settings saved before 0.11.1 load as Use global (grab brushes: Size: Off). 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. Edit > 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). A side button can open a radial menu instead (Edit > Preferences > Input > Radial Menus). Mouse mode (relative): the pen moves the cursor by how far it moves, like a mouse, and putting it down elsewhere on the tablet leaves the cursor where it was, with the driver in pen mode or in its own mouse mode. While the pen is in range the arrow is drawn at the brush (the system's is hidden), so brush, arrow and clicks always agree (#72). These settings save themselves. 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, Clay Block, Sharp Crease, Move, Smooth, Inflate, Pinch, Flatten, Crease, Trim, Tendril, 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 Edit > Preferences > Config > Customize Shelves, 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. Edit > Preferences > Config > Save Layout keeps 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 Part, 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 Vertex Paint 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 (dynamic topology) 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 Sculpt > Brush. 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. Not there? AI features are off: turn them on in Edit > Preferences > AI (see Turning AI off)."},{"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 Sculpt > Brush 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. Under the recipe sliders are the brush's pressure curve and Pen pressure: Size and Strength, each Use global, On or Off. Use global (the default) follows Pressure > Size and Pressure > Strength on the top shelf and in Edit > Preferences > Tablet; On and Off override them for this brush only. The choice is saved in the brush's .sfbrush file, so a shared brush keeps it (see Pen pressure and tablets). 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 Mesh > Generate 3D > AI brush provider and Edit > Preferences > AI > Provider) to choose another service. Each choice fills in the address and a model: 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) An Anthropic API key Uses claude-opus-5-5 by default. Effort (low, medium, high) trades speed for more considered brushes. OpenAI An OpenAI API key Click Find models to pick one. Ollama (this computer), LM Studio (this computer) The app running on your computer Private and offline, no key. See below. vLLM server, llama.cpp server A server on your computer or at your studio Change the address to your server's. LiteLLM proxy (studio gateway) Your studio's gateway address One address for every model your studio allows; a key from your studio, or your studio sign-in. See IT deployment. OpenRouter An OpenRouter key Many models through one key. Other OpenAI-compatible server An endpoint, a model name and, for hosted services, a key Any server that speaks the OpenAI chat completions API. You can edit the Endpoint, Model and API key fields. Leave the key empty to use the ANTHROPIC_API_KEY, OPENAI_API_KEY or OPENROUTER_API_KEY environment variable. Click Save settings to keep your choice. Keys are kept in your system's keychain (macOS Keychain, Windows Credential Manager, or the Secret Service on Linux), never in a settings file. Requests go only to the endpoint you set. If your studio manages SculptForge, some providers may be greyed out with Managed by your studio."},{"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 Ollama (this computer) (or LM Studio (this computer)). 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 Sculpt > Brush, 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":"Sculpt > Brush 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 Sculpt > 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 Library library (Documents/SculptForge by default) appear in the Library section of the brush picker and in Library'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 Sculpt > Brush. 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":"brush-packs.html","c":"Brush packs","a":"","h":"Brush packs","t":"SculptForge comes with sixty ready-tuned brushes in six packs, on top of the built-in brushes. Each one is a brush recipe (see Brush Lab) with its own alpha where it needs one, so you can use them as they are, or open one in Brush Lab and make your own version. Every brush, alpha and preview here is made by SculptForge itself: the recipe engine, procedural alphas and the same clay-ball thumbnails as the brush picker."},{"p":"brush-packs.html","c":"Brush packs","a":"find-and-pick-a-pack-brush","h":"Find and pick a pack brush","t":"Sculpt > Brush: the grid shows Built-in, Custom, then Brush packs. Sort: A-Z > Pack shows one section per pack. The filter field finds a brush by name. B opens the brush picker: type the first letters of the name, then the orange key. Custom brushes in Sculpt > Brush lists every pack brush with its pack's name beside it. Scripts and macros: brush_use name=\"Rivet Row\"; brush_list shows every brush with its pack. The first time you pick a pack brush it brings its own alpha (Rivet Row brings Rivets, turned along the stroke); brushes without one go back to the plain round tip. From then on the brush keeps whatever you change, as every brush does (Sculpt > Brush > Save Brush Settings keeps it for good, Reset Brush to Default brings back the pack's). Pack brushes are read-only like the other built-ins: changing one in Brush Lab saves your own copy, which replaces it in the lists until you delete it. Textures (pores, stitches, weave, rivets) need enough polygons to show: subdivide, or turn on Dynamic topology, until the brush's detail is several polygons wide."},{"p":"brush-packs.html","c":"Brush packs","a":"clay--form","h":"Clay & Form","t":"Block in, build up and refine big forms: clay strokes, planes, and smooth blends. The Clay & Form brushes Brush What it does Alpha Block Former Big, flat-topped clay strokes that stack fast, for blocking in primary forms. Square Soft Clay Gentle round clay that builds in thin layers and blends into the surface. Clay Strip Narrow, crisp strips of clay with a hard edge, for muscle fibres and planes. Square Plane Cutter Shaves the surface down to flat planes, for stylised forms and stone. Volume Fill Fills low areas up to the stroke's plane and leaves the high points alone. Level Out Presses hills and valleys onto one plane and softens the result, to calm busy areas. Swell Puffs the surface out along its own normals, for cheeks, bellies and soft volumes. Form Smoother Relaxes lumps while keeping the big shape, for a clean pass after blocking. Clay Drag Smears soft clay along the stroke like a thumb pushing it, for blending transitions. Edge Definer Pinches a crisp edge into the surface where two planes meet. "},{"p":"brush-packs.html","c":"Brush packs","a":"hard-surface","h":"Hard Surface","t":"Crisp planes, panel lines, bevels, rivets and bolts for props, armour and machines. The Hard Surface brushes Brush What it does Alpha Panel Groove Cuts a clean, narrow groove for panel gaps and seams. Flat Plane Presses a perfectly flat face with a hard edge, for machined surfaces. Square Bevel Scrape Scrapes high points into a bevel along an edge, for chamfers. Raised Plate Builds a flat, square-edged plate on the surface, for armour and hull panels. Square Rivet Row Stamps rows of round rivet heads along the stroke. Rivets Bolt Head Stamps a hexagonal bolt on a washer; space the dabs out or click once. Bolt Hex Armour Raises a honeycomb of hexagonal plates, for sci-fi armour and shells. Hex Plates Vent Slots Cuts parallel slots like a vent grille; drag across the slots. Wrinkles Grid Studs An even grid of small studs, for grip textures and tread plates. Dot Grid Hard Cut Cuts the surface flat below the stroke, for sharp silhouettes and clean cuts. Square"},{"p":"brush-packs.html","c":"Brush packs","a":"organic--skin","h":"Organic & Skin","t":"Pores, wrinkles, folds, veins and scales for creatures and portraits. The Organic & Skin brushes Brush What it does Alpha Fine Pores Small, evenly scattered pores for faces and close-ups. Pores Deep Pores Bigger, deeper pores for noses, cheeks and rough skin. Pores Crow's Feet Fine fanned wrinkle lines, for eye corners and knuckles. Wrinkles Skin Fold Soft rolls of heavy skin, for necks, bellies and brows. Skin Folds Crease Line A sharp, deep crease with pinched sides, for eyelids, lips and nasal folds. Vein Raises thin, soft-edged veins along the stroke. Reptile Scales Overlapping rows of rounded scales, for lizards, dragons and fish. Scales Leather Hide Pebbled grain with fine creases, for leather, elephant and rhino skin. Leather Grain Muscle Fibre Long soft ridges along the stroke, for muscle striation and sinew. Hair Strands Flesh Pinch Pulls soft flesh together into a ridge, for lips, knuckles and wrinkles that bunch. "},{"p":"brush-packs.html","c":"Brush packs","a":"cloth--folds","h":"Cloth & Folds","t":"Folds, seams, stitches, weave and knit for clothing and soft goods. The Cloth & Folds brushes Brush What it does Alpha Fold Ridge Raises a rounded fold of cloth with soft sides. Fold Valley Carves the soft valley between two folds. Tension Crease A sharp crease where cloth pulls tight, for armpits, elbows and seams under strain. Seam Stitch A sewn seam with cross stitches; drag along the seam. Stitches Woven Cloth Threads woven over and under, for canvas, denim and sacking. Fabric Weave Knitted Wool Rows of V-shaped loops, for jumpers, scarves and chunky knits. Knit Hem Edge A flat, square-edged band along the stroke, for hems, cuffs and straps. Square Cloth Drape Drags the surface along the stroke so folds flow and hang, for drapery. Wrinkle Bunch Small compressed wrinkles where cloth gathers, at waists and wrists. Padded Quilt Puffs soft panels up between the stroke's edges, for quilting and padding. Square"},{"p":"brush-packs.html","c":"Brush packs","a":"damage--wear","h":"Damage & Wear","t":"Cracks, chips, dents, scratches and erosion for weathered stone, wood and metal. The Damage & Wear brushes Brush What it does Alpha Dry Cracks A web of thin cracks, for dry earth, old paint and stone. Cracks Deep Fissure One deep, jagged split, for broken rock and ice. Edge Chips Knocks angular chips out of edges only; flat areas stay whole. Chips Dents Soft, scattered dents, for beaten metal and hammered surfaces. Scratches Thin, sharp scratches along the stroke, for scuffed metal and wood. Eroded Stone Breaks the surface up with noise, for weathered rock and sandstone. Rock Layers Stepped, broken strata, for cliffs and layered stone. Rock Strata Cobbles Packed rounded stones with grooves between, for paths and old walls. Cobblestone Wood Grain Rough furrows and ridges, for bark and weathered planks; drag along the grain. Bark Worn Edges Softens and rounds only the sharp ridges, as years of handling do. "},{"p":"brush-packs.html","c":"Brush packs","a":"ornament","h":"Ornament","t":"Beads, ropes, filigree, studs and carved patterns for jewellery, trims and decoration. The Ornament brushes Brush What it does Alpha Bead Chain A row of round beads along the stroke, for jewellery and trims. Rope Twist A twisted rope or cord, for borders and rigging. Hair Strands Filigree Line A thin, raised wire line, for filigree and engraved borders. Engrave Cuts a fine, crisp line, for engraving, runes and lettering. Stud Row Rounded studs spaced along the stroke, for belts, doors and armour trims. Raised Band A flat, raised band with clean edges, for bezels, rims and mouldings. Scroll Relief Soft, rounded relief that builds up slowly, for carved scrolls and leaves. Scale Mail Rows of small scales, for armour, roof tiles and feathers. Gem Setting A raised round setting with a crisp rim, for cabochons and gem seats. Dot Texture Fine even dots, for stippling, punched leather and decorative fields. Dot Grid"},{"p":"brush-packs.html","c":"Brush packs","a":"new-alphas","h":"New alphas","t":"Six procedural alphas came with the packs and work with any brush (Sculpt > Alpha): Cobblestone, Leather Grain, Hex Plates, Knit, Bolt and Chips. Sculpt > Alpha lists every alpha A-Z (Round, the plain tip, first), has a filter field, and Sort for the most recently used first or by pack."},{"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 panel for inverting, blurring, growing and building masks from cavities, peaks, face groups, vertex paint, the direction the surface faces or the mesh border. 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 Part: each Part has its own mask. Masks are saved in projects (.sfproj) and in Bridge files, so they survive a round trip through the Bridge. 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. The same toggle is Show mask in Tool > Masking, and Show Mask in the Render palette. Turning it off hides the darkening without clearing the mask: it still protects the surface, the status bar says so, and turning it on again shows the same mask. Clear Mask (Ctrl+Shift+A) is what removes it."},{"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 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 Drag Stamp stroke masks with dabs along the path instead of one stamp. On macOS, Cmd works wherever this guide says Ctrl."},{"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. 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 Mask Pen, Lasso Mask or Rectangle Mask, 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 Mask Pen (default) Paints the mask with the brush, as described above. Lasso Mask Draws a free-hand outline that closes back to where you started. Everything inside is masked. Rectangle Mask Draws a rectangle. Everything inside is masked. With Lasso Mask or Rectangle Mask: 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. With symmetry on (X, Y, Z on the top shelf), the mirror image of what's inside is masked too, as a mask stroke mirrors. A shape that covers none of the model clears the mask instead. 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. Turn on Front faces only (under the shape buttons, shown for Lasso Mask and Rectangle Mask) to mask only what faces you: the far side of the model and folds turned away from you are left as they are. It follows the mirror image too when symmetry is on. The cursor turns into a small cross while Ctrl is held, since the brush size doesn't matter for a selection."},{"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 Draw a mask rectangle (Mask Pen; Lasso Mask draws a lasso): what it covers is masked, mirrored by the symmetry. A shape that covers none of the model clears the mask. Ctrl + drag on the background, with nothing masked Zoom the view in the SculptForge style (the default); with the Classic sculpting keys it draws the mask rectangle above (see Keyboard and mouse) On the model, a Ctrl + click that doesn't drag works on the mask's edges, whichever mask shape is picked: 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 from Mask: the masked part becomes a new face group and the mask is cleared (see Face Groups) A drag starts after the cursor moves a few pixels, so a slightly shaky click still inverts. With Lasso Mask or Rectangle Mask, a Ctrl + drag on the background draws that shape; to clear the mask, draw it away from the model, or use Clear."},{"p":"masking.html","c":"Masking","a":"the-masking-panel","h":"The Masking panel","t":"Open Tool > Masking (the Tool palette is in the right tray by default). It has three rows of buttons, each with a picture of what it does (the masked part dark, as in the viewport); hold Ctrl over a button for its hint. Every button is one undo step. Tool > Masking: Shapes, Mask by and Adjust Shapes: what Ctrl + drag does. Button What it does Command Mask Pen Paint the mask with the brush; Ctrl+Alt erases. Lasso Mask Mask what is inside a free shape you draw. mask_lasso Rectangle Mask Mask what is inside a rectangle. mask_rect Front faces only (lasso and rectangle) masks only what faces you. Mask Strength is how much each stroke, shape or Mask by button masks (0.01 to 1). Mask by: build a whole mask at once. Each one replaces the current mask. Button What it masks Command By cavity Concave areas: creases, folds, pores. mask_by_cavity By peaks Convex areas: ridges, peaks and sharp edges (the opposite of By cavity). mask_by_peaks By face group One face group (the number under Mask by options). mask_by_facegroup By colour Vertex paint close to the main colour (the left shelf's swatch); unpainted clay counts as white. mask_by_color By facing Surface that faces the camera (or up, or down) within an angle: the front of a face, the top of a rock. mask_by_facing By border The open edges of the mesh and the rings of edges inside them, so sculpting keeps the border in place. A closed mesh has no open edges, and the status bar says so. mask_border Adjust: change the mask there is. Button What it does Command Grow / Shrink Expand or contract the masked region by one ring of edges per pass. mask_grow / mask_shrink Sharpen / Blur Tighten or soften the mask's edges. mask_sharpen / mask_blur Invert Masked becomes free and free becomes masked. mask_invert Clear Unmask everything. mask_clear All Mask every visible vertex. mask_all Passes sets how many times Grow, Shrink, Sharpen and Blur run (1 to 20). Mask by options holds the rest: Option For Cavity / peaks threshold How deep a crease (By cavity) or sharp a ridge (By peaks) must be (-0.2 to 0.5, default 0.02). 0 takes anything; higher keeps only the strongest. threshold= Face group The face group id By face group masks. group= Colour tolerance How different a colour may be and still count for By colour (0.01 to 1, default 0.15). tolerance= Faces the camera / up / down and Angle The direction By facing compares with, and how far the surface may turn from it (default 60 degrees). x= y= z= angle= Border rings How wide By border masks, in rings of edges (1 to 20, default 2). rings= Face Group borders By border also masks where face groups meet. facegroups=true Soft By border fades the mask from the border towards the innermost ring. soft=true 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-face-group","h":"Mask a whole face group","t":"The quickest way works without knowing the group's number: Ctrl+Shift + click the group to isolate it (see Face Groups and visibility). Click All: only visible vertices are masked. Ctrl+Shift + click the background to show everything again. The mask stays. By face group 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_face group group=N line. Enter that number in Mask by options > Face group and click By face group."},{"p":"masking.html","c":"Masking","a":"sculpt-without-breaking-the-border","h":"Sculpt without breaking the border","t":"A plane, a cloth panel or a part cut from a larger model has an open border that should stay where it is, for example to keep it lined up with the piece it joins: Set Rings to how wide the protected strip should be. Click By border. The open edges and the rings inside them are masked. Sculpt freely; the border doesn't move. Tick Soft first for a gradual transition into the sculpted area. Tick Face Group borders to also protect the seams between face groups. This is Blender's Mask from mesh boundary (and, with face sets, Mask from face set boundary)."},{"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-face-group","h":"Turn a mask into a face group","t":"Click From mask in Tool > Face Groups: the masked triangles become a new face group. See Face Groups and visibility."},{"p":"masking.html","c":"Masking","a":"masks-and-painting","h":"Masks and painting","t":"Vertex Paint 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 Vertex Paint 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_facegroup group (required), add=true to add to the current mask instead of replacing it mask_border rings (1-20, default 1), facegroups=true to also mask face group borders, soft=true to fade inwards, strength (0-1, default 1), add=true to add to the current mask 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":"Face Groups and visibility: groups, isolating and hiding parts Sculpting and brushes: modifier keys and brush settings Vertex Paint and materials: fills that respect the mask"},{"p":"face-groups.html","c":"Face Groups and visibility","a":"","h":"Face Groups and visibility","t":"Face Groups (experienced sculptors: Face groups) divide a Part's surface into named regions, shown as flat colours when you turn them on. You use them to hide and isolate parts of a model so you can reach what you want to sculpt, to build masks, and to split a model into Parts. This chapter covers creating face groups, the Ctrl+Shift visibility gestures and the Tool > Face Groups and Tool > Visibility controls. Face Groups shown as colours, with the Face Groups sub-palette"},{"p":"face-groups.html","c":"Face Groups and visibility","a":"show-face-groups","h":"Show face groups","t":"Click Groups in the right shelf to colour each face group of the active Part. The same toggle is Show face groups in Tool > Face Groups and Show Face Groups in the View menu. The grouping buttons turn the colours on for you, so you see the result straight away. The number next to Show face groups is how many face groups are visible right now. A mesh without face groups is one group. Face Groups come from: the grouping buttons below; OBJ files: each g group becomes a face group (SculptForge also writes face groups as g groups when it exports OBJ); Bridge files and SculptForge projects, which keep face groups."},{"p":"face-groups.html","c":"Face Groups and visibility","a":"create-face-groups","h":"Create face groups","t":"Open Tool > Face Groups. Grouping works on the visible part of the Part 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. facegroup_auto_by_normals By pieces One group per disconnected piece, such as separate eyes or buttons in one mesh. facegroup_by_connectivity From mask Masked triangles move into a new group. facegroup_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). facegroup_uv Merge visible Everything visible becomes one group. facegroup_merge_visible Clear groups Remove all face groups; the whole Part becomes one group again. facegroup_clear Each button is one undo step."},{"p":"face-groups.html","c":"Face Groups 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 > Face Groups. Ctrl + drag on the background to clear the mask."},{"p":"face-groups.html","c":"Face Groups and visibility","a":"hide-and-show-parts","h":"Hide and show parts","t":"Visibility is the main reason to have face groups: 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 face group, everything shown Isolate it: show only that group. Ctrl+Shift + click a face group, something hidden Hide that group. Ctrl+Shift + click the isolated group again Invert the visibility: show everything else instead. Ctrl+Shift+Alt + click a face group 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 Select Rectangle and Select Lasso at the top of Tool > Visibility (Select Rectangle by default), or, 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 Select Rectangle or Select Lasso. With Select Lasso, 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. With symmetry on (X, Y, Z on the top shelf), the mirror image of the shape counts as inside too, as with the mask selections: keeping the left eye keeps the right one, and hiding one ear hides both (hide_rect / hide_lasso symmetry=x). SculptForge refuses a change that would hide everything. Every visibility change is one undo step, so Ctrl+Z brings back what you just hid."},{"p":"face-groups.html","c":"Face Groups and visibility","a":"the-visibility-sub-palette","h":"The Visibility sub-palette","t":"Open Tool > Visibility: Control What it does Command Select Rectangle / Select Lasso 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 masked Remove the masked triangles (their corners' average mask above 50%). Undoable. Available when something is masked. delete_masked Delete hidden and Delete masked keep every attribute of what remains (mask, vertex paint, face groups, UVs and sculpt layers). Use it to cut away parts of a scan or a generated model, or to remove the inside of a mesh after you isolated the outside."},{"p":"face-groups.html","c":"Face Groups 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":"face-groups.html","c":"Face Groups 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 Select Lasso in Tool > Visibility first and draw around it. Click Delete hidden in Tool > Visibility."},{"p":"face-groups.html","c":"Face Groups and visibility","a":"split-a-model-into-parts","h":"Split a model into Parts","t":"Group the model, then click Split groups in Tool > Parts: each face group becomes its own Part. Split parts does the same by disconnected piece. See Parts."},{"p":"face-groups.html","c":"Face Groups and visibility","a":"face-groups-and-other-tools","h":"Face Groups and other tools","t":"Masking: By face group in Tool > Masking masks one group (see Masking). Brushes and vertex paint skip hidden faces. Projects save face groups and what's hidden; Bridge and OBJ carry face groups in and out. Each Part has its own face groups and visibility. To show and hide whole Parts, use the eye icons and Solo in Tool > Parts."},{"p":"face-groups.html","c":"Face Groups and visibility","a":"face-groups-from-a-script","h":"Face Groups from a script","t":"Command Options facegroup_auto_by_normals angle (1-180 degrees, default 30) facegroup_by_connectivity, facegroup_uv, facegroup_from_mask, facegroup_merge_visible, facegroup_clear isolate_facegroup, hide_facegroup group (required): the face group 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_facegroup group=3, which you can reuse in scripts. sculptforge-cli -c 'open path=robot.obj; face group_by_connectivity; part_split_groups; save_project path=robot.sfproj' Not yet: a face group paint brush, Group Front, face groups from UV islands or Vertex Paint, and face group-based crease edges are not available yet."},{"p":"face-groups.html","c":"Face Groups and visibility","a":"see-also","h":"See also","t":"Masking: build masks from face groups and face groups from masks Parts: split by groups, show, hide and solo whole Parts Keyboard and mouse reference"},{"p":"selection-sets.html","c":"Selection sets and morph targets","a":"","h":"Selection sets and morph targets","t":"A selection set is a named snapshot of a Part's mask, face groups, vertex paint, visibility (which faces are hidden), UVs and shape. Store as many as you like, bring any of them back later, combine them, and use a stored shape as the target of the Morph brush. Sets belong to the Part, travel with the project, and work across its subdivision levels: store at one level, restore at any other."},{"p":"selection-sets.html","c":"Selection sets and morph targets","a":"store-a-set","h":"Store a set","t":"Open Tool > Selection Sets. Type a name in the field next to Store (it suggests \"Set 1\", then \"Set 2\" and so on). Tick the channels the set should hold: Channel What it keeps Command name Mask The mask, soft edges included. mask Groups The face groups. facegroups Visibility Which faces are shown and which are hidden. visibility Vertex Paint The vertex colours. paint UVs The UV layout (only when the Part has UVs). uvs Shape The surface itself, as a morph target. morph Click Store. Storing again under the same name replaces that set. From Visible is the quick way: it stores the faces shown right now as a set called Visible (then Visible 2, ...). Isolate a part with the Ctrl+Shift gestures (Face Groups and visibility), click From Visible, and you can get back to exactly that view whenever you need it. There is no limit on the number of sets. They are kept compactly: masks, vertex paint and visibility store only the parts that differ from an empty mask, white paint and a fully shown Part, and face groups are run-length coded, so a mask on a few million vertices usually costs a few kilobytes. Shapes and UVs are stored as they are."},{"p":"selection-sets.html","c":"Selection sets and morph targets","a":"restore-rename-and-delete","h":"Restore, rename and delete","t":"Select a set in the list (hover it to see its channels and the level it was stored at), then: Restore puts its channels back. The shape is not restored here: Morph to Set does that, so you can keep a set with a shape in it and still restore just its mask. Double-clicking a set restores it too. Rename edits its name; Delete removes it. The menu next to From Visible sets how Restore meets what you have now, for the mask and visibility: Mode Mask Visibility Replace The set's mask. The set's shown faces. Union Masked in either. Shown in either. Intersect Masked in both. Shown in both. Subtract Masked now but not in the set. Shown now but not in the set. Every store, restore, rename, delete and combine is one undo step. A set greyed out in the list no longer fits the Part: its topology changed since (a remesh, Dynamic topology, Delete hidden). Undo the change, or delete the set."},{"p":"selection-sets.html","c":"Selection sets and morph targets","a":"combine-sets","h":"Combine sets","t":"Pick a second set in the menu under Restore, choose Union, Intersect or Subtract above, and click Combine: a new set (\"Head + Arms\", \"Head & Arms\" or \"Head - Arms\") holds the mask and visibility of the two combined that way. Your current mask and visibility are not touched until you restore it."},{"p":"selection-sets.html","c":"Selection sets and morph targets","a":"subdivision-levels","h":"Subdivision levels","t":"A set remembers the level it was stored at, and restores at any level of the same Part: going down, each vertex and face takes the value of the matching one on the level above, as the levels themselves do; going up, masks and vertex paint are interpolated, face groups and visibility are inherited from the face they lie in, and UVs are interpolated across each face; a shape travels as its difference from that level's own surface, so the detail of the levels in between stays where it is. So you can store a mask at SDiv 1, sculpt at SDiv 5 and restore the mask there, or keep a high-resolution face group set and use it at the base cage. Sets survive Divide, Delete Lower, Delete Higher and Reconstruct Subdiv as long as the level they were stored at still exists."},{"p":"selection-sets.html","c":"Selection sets and morph targets","a":"morph-targets","h":"Morph targets","t":"Store a set with Shape ticked to keep the surface as it is now. Then: Morph Target makes it the target of the Morph brush and picks that brush. Strokes pull the surface back toward the stored shape, as much as the brush's strength; Alt pushes away from it. The set's name shows [morph] in the list; Clear Morph Target turns it off. Morph to Set moves the whole surface toward the set's shape by Amount (1 = all the way, 0.5 = halfway, negative values push away), respecting the mask, as one undo step. Both work at any subdivision level, not only the one the shape was stored at, and with sculpt layers (the change goes into the active layer). Use them to undo a sculpting session locally, to blend between two versions of a form, or to keep a neutral pose while you sculpt an expression."},{"p":"selection-sets.html","c":"Selection sets and morph targets","a":"projects-files-and-other-apps","h":"Projects, files and other apps","t":"Sets are saved in the project with each Part (older versions of SculptForge open such projects and leave the sets out). To move them between Parts, scenes or tools, use the commands: selection_sets_export path=head.sfsets # every set of the active Part (name=... for one) selection_sets_import path=head.sfsets # into the active Part A .sfsets file is a ZIP with a JSON manifest and one small binary file per set. Importing a set that was stored on a different mesh keeps it, but it shows greyed out and can't be restored until the Part has a level it fits. USD (export_usd) writes the sets of each Part inside its Mesh prim: the shown faces of each set as a GeomSubset (sculptforge_set0_visible), its face groups as a partition of GeomSubsets (sculptforge_set0_group7), and its mask and vertex paint as vertex primvars (primvars:sculptforge_set0_mask, ..._color), with the names in sculptforge:selectionSets. Houdini, Maya, Blender and Omniverse read these as ordinary face sets and primvars, and SculptForge turns them back into selection sets when it imports the file. UVs and shapes are not written to USD. OBJ, glTF / GLB, FBX, PLY and STL have no place for named selections, so sets are not written to them (OBJ still writes the current face groups as g groups). Export the sets to a .sfsets file alongside the model instead."},{"p":"selection-sets.html","c":"Selection sets and morph targets","a":"scripting","h":"Scripting","t":"Every button is a command, so scripts, sculptforge-cli, the MCP server and the AI assistant can use sets: Command What it does selection_set_store name=Head channels=mask,visibility Store (or replace) a set. channels takes mask, facegroups, paint, visibility, uvs, morph or all. selection_set_restore name=Head mode=union Restore; channels= restores some of them (add morph to restore the shape). selection_set_rename name=Head to=Face Rename. selection_set_delete name=Head Delete. selection_set_list json=true List the sets with their channels and levels. selection_set_combine a=Head b=Ears op=union into=HeadEars Combine two sets into a new one. selection_set_from_visible The quick set from the visible faces. selection_set_morph_target name=Rest Make a set the Morph brush's target (empty name: none). selection_set_morph name=Rest amount=0.5 Morph to Set. selection_sets_export / selection_sets_import .sfsets files. In Python (import sculptforge as sf), push and pull sets as NumPy arrays: doc.set_selection_set(\"Eyes\", mask=eye_mask, hidden=hidden_faces) # store from arrays (one undo step) doc.selection_sets # [{'name': 'Eyes', 'channels': [...], ...}] arrays = doc.selection_set(\"Eyes\") # {'mask': ..., 'hidden': ...} at this level sf.run(doc, \"selection_set_restore\", name=\"Eyes\") See Scripting and automation for running commands."},{"p":"parts.html","c":"Parts","a":"","h":"Parts","t":"A scene in SculptForge can hold several separate meshes, called Parts (experienced sculptors: Parts): a body, eyes, teeth, a helmet and a sword can each live in their own Part. This chapter covers the Parts list, selecting, adding, hiding, reordering, merging and splitting Parts, and how they travel through files."},{"p":"parts.html","c":"Parts","a":"how-parts-work","h":"How Parts work","t":"Only the active Part 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 Part keeps its own mesh, mask, vertex paint, face groups, hidden faces, UVs and sculpt layers. Each Part has its own undo history. Ctrl+Z undoes the last change in the active Part, and switching Parts doesn't lose the history of the others. Adding, deleting, reordering, merging and splitting Parts are not undoable, except Split hidden, Split masked and Split unmasked (one undo step each). Merges and deletes ask for confirmation first. The Parts list highlights the active Part. In the Classic layout the title strip also shows it and its place in the list, for example Part Helmet (2/5)."},{"p":"parts.html","c":"Parts","a":"the-parts-list","h":"The Parts list","t":"The list is in Tool > Parts, which is open in the right tray by default. The Parts sub-palette with several Parts, the active one highlighted Each row shows a small picture of the Part, its name, its triangle count, its shading and an eye. The pictures are drawn from the model the viewport already has on the graphics card, so they cost almost nothing even on very dense Parts, and they catch up a moment after you stop changing a Part (not during a stroke). To Do this Select a Part Click its row, or Alt+click it in the viewport; triple-click another Part in the viewport to select it and frame it Sculpt the Part under the cursor Point at it and press Alt+Q (every input style, as in Blender): it becomes the active Part, the view stays put and each Part keeps its mask 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 Shade it smooth or flat Click the mark left of the eye: it goes from as the scene (dim) to Smooth (a disc) to Flat (a faceted hexagon) and back. Only this Part changes; the scene's own setting is Render > Materials > Shading Duplicate or delete it Right-click the row > Duplicate (Ctrl+Shift+D) or Delete... Make a copy that shares the mesh Right-click the row > Linked Duplicate, or the Linked Duplicate button; see Linked Duplicates 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 Part to a name that is already taken adds a number. Selecting a hidden Part shows it again, because you can't sculpt what you can't see."},{"p":"parts.html","c":"Parts","a":"select-a-part-in-the-viewport","h":"Select a Part in the viewport","t":"Hold Alt and click another Part on the canvas. It becomes the active one and the list scrolls to it. Alt+click only selects when you click a Part other than the active one and release without moving. If you drag instead, Alt keeps its usual meaning: an inverted stroke on the active Part, or a pan when you start off the model."},{"p":"parts.html","c":"Parts","a":"add-a-part","h":"Add a Part","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 Part. Insert on the model: choose a shape, then drag on the active Part's surface to add it there as a new face group (the drag sets its size and turns it). With Symmetry X, Y or Z on, a mirrored copy goes on the other side too, in the same undo step; a shape inserted right on a mirror plane isn't doubled. To insert your own mesh, choose Active Part's copy... and pick another Part (it stays as it is), or From file... and pick an .obj, .ply or .glb file; then drag as with the shapes. The mesh is centred, scaled so its largest side matches the drag, and stood on the surface along its own up (+Y) axis. Esc stops inserting. (Command: insert_mesh part= or insert_mesh file=.) To insert from a kitbash set, choose Insert set from file... (one .obj or .glb with several objects) or Insert set from folder... (its .obj, .ply and .glb files, by name; not its subfolders). The Insert set window shows a thumbnail of each item: click one, then drag on the model as above. While inserting, ] steps to the next item and [ to the previous one (around the set; brush size keys come back once you stop). Esc or the window's close button stops. (Commands: insert_set_items set= lists them; insert_mesh set= index= inserts item n, 0 being the first.) Creature bones, at the end of the same menu, is a set that comes with SculptForge: no file to pick (see below). From file...: a model (.obj, .fbx, .glb, .gltf, .ply, .stl, Bridge files, .usda, .usd, .usdz) or a project (.sfproj). A file with several objects adds one Part per object. The new Part becomes the active one."},{"p":"parts.html","c":"Parts","a":"creature-bones","h":"Creature bones","t":"Append > Insert on the model > Creature bones opens a built-in insert set of original fantasy creature bones to start from: Skull, Jaw, Fang, Blade tooth, Swept horn, Spiral horn, Claw, Vertebra, Tail vertebrae, Rib, Limb bone, Wing bone and Wing finger. Click one in the Insert set window and drag on the model, as with any set; horns, claws and teeth grow from where you drag. With Symmetry X on, a horn or a claw gets its mirrored twin. Each piece is a clean, closed quad mesh of 500 to 4,200 faces, so it takes Divide and sculpting well: insert, then sculpt the joins smooth, or Voxel Remesh to fuse the piece into the model. Drag pieces onto an empty Plane or Sphere Part to build a skeleton of their own Part. The pieces were designed for SculptForge (tools/creature-bones in the source) and come under the app's licence, GPL-3.0. (Commands: insert_set_items set=builtin:creature-bones; insert_mesh set=builtin:creature-bones index=.) You can also add files as Parts from elsewhere: Import in the Tool palette header (or File > Import) adds a model file as a new Part. In the Library Tool tab, Shift+double-click a model, or right-click it and choose Append as Part. Tip: Duplicate (Ctrl+Shift+D, also in the command palette as Duplicate Part) copies the active Part 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. Linked Duplicate instead makes a copy that shares the mesh and changes with it (rivets, legs, columns); see Linked Duplicates."},{"p":"parts.html","c":"Parts","a":"show-hide-and-solo","h":"Show, hide and solo","t":"The eye on each row shows or hides that Part. Solo shows only the active Part. Click it again to bring the others back. The Solo button on the right shelf does the same. X-Ray, next to Solo, shows the active Part through the others: the other Parts turn see-through and only their nearest surface shows. When only the active Part is shown, it is see-through itself. Click X-Ray again to make them solid. View > X-Ray does the same. Unhide all shows every Part. Hidden Parts aren't drawn, can't be selected with Alt+click, and are left out of exports. Note: Part visibility is different from hiding part of a mesh with face groups or a rectangle. That hides faces inside one Part; see Face Groups and visibility."},{"p":"parts.html","c":"Parts","a":"folders","h":"Folders","t":"Folders group Parts in the list, for example the eyes and teeth of a head, so you can hide, show and move them together. To Do this Make a folder Click the folder button under the list: a new folder holds the active Part; type its name and press Enter Put a Part in a folder Drag its row onto the folder's header (or onto a Part already in it), or right-click the row > Folder > the folder's name Take a Part out Drag it onto a Part outside folders, or right-click it > Folder > Out of the folder Fold or open a folder Click its header Rename it Double-click the header (or right-click > Rename) Hide or show all its Parts Click the eye on the header Move, turn or scale it Right-click the header > Move with the gizmo Remove it Right-click the header > Remove folder (keep its Parts) A Part that joins a folder moves to just below the folder's last Part, so a folder's Parts stay together. When the folder holding the active Part is folded, its header shows the accent bar. Move with the gizmo makes one of the folder's Parts active and turns on the gizmo's Folder option, so every visible Part in the folder moves together; see All Parts and Folder. Duplicates and the pieces of a split stay in their Part's folder. Folders are saved in the project; older versions of SculptForge open the file and simply show no folders."},{"p":"parts.html","c":"Parts","a":"reorder-parts","h":"Reorder Parts","t":"The up and down arrow buttons under the list move the active Part one place up or down. The order matters for Merge down and is the order objects are written to files."},{"p":"parts.html","c":"Parts","a":"merge-parts","h":"Merge Parts","t":"Merge down... merges the active Part with the one below it. Merge visible... merges every visible Part into one new Part called Merged. Hidden Parts stay as they are. Merging keeps every attribute, gives each original mesh its own face groups (so you can split them again later) and matches sculpt layers by name. The merged Part starts with an empty undo history. A Part 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 Parts that lost their levels. Painted textures are kept too: the merged Part 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":"parts.html","c":"Parts","a":"split-a-part","h":"Split a Part","t":"Split groups makes one Part per face group. It is available when the active Part has more than one face group. Split parts makes one Part per disconnected piece, largest first. Both replace the active Part with the pieces. Because a merge keeps each original mesh in its own face group, Split groups undoes a merge."},{"p":"parts.html","c":"Parts","a":"split-hidden-masked-or-unmasked","h":"Split hidden, masked or unmasked","t":"The Split row (Hidden, Masked, Unmasked) takes part of the active Part out into a new Part just below it, in the same folder, shown as the source is and shaded the same way. Each is one undo step: Ctrl+Z puts the triangles back and removes the new Part. Button Moves into the new Part Command Split > Hidden the hidden triangles; they are shown in the new Part part_split_hidden Split > Masked the masked triangles; the new Part starts unmasked part_split_masked Split > Unmasked the triangles that are not masked; the masked ones stay part_split_unmasked A triangle counts as masked when the average mask of its three corners is above 50%, so a soft mask edge splits along its middle and a single masked corner doesn't take its neighbours. UVs, face groups, vertex paint and sculpt layers carry over to both sides. Subdivision levels can't be cut: the split is made at the level the Part is on, which becomes its base (undo brings the levels back). To delete instead of split, use Delete hidden or Delete masked in Tool > Visibility."},{"p":"parts.html","c":"Parts","a":"extract-a-shell","h":"Extract a shell","t":"Extract, in Tool > Parts, makes a new Part from the masked part of the active one: a helmet from the top of a head, a strap, a sleeve, a piece of armour that fits the surface exactly. It works: Mask the part (hold Ctrl and paint, or use Rectangle Mask / Lasso Mask; see Masking). Click Extract. The shell appears as a preview, a Part just below the active one. Change Thick, E Smt, Double, TCorne or TBorder and the preview follows. Click Accept to keep it. Setting What it does Thick The shell's thickness as a share of the Part's size: 0.015 (the default) is 1.5%. Negative grows it inward; 0 makes a single-sided surface E Smt Smooths the extracted edge, which otherwise follows the mask's triangles in steps. 0 keeps it as masked Double Grows the shell both inward and outward from the surface TCorne Triangles instead of quads in the rim where the edge turns sharply (over 50 degrees), so tight corners don't get twisted quads TBorder The whole rim is triangles instead of quads A cap extracted from the masked top of a sphere, shown with its face groups: outer, inner and rim The new Part has three face groups, the outer surface, the inner one and the rim between them (a band of quads), so you can mask, hide or split them apart. Vertex Paint comes with it; hidden faces are left out. Accept is one undo step: Ctrl+Z on the source Part takes the extracted one away again, and redo brings it back. A preview you don't accept goes away as soon as you change the source Part or pick another one, and it is never saved."},{"p":"parts.html","c":"Parts","a":"delete-a-part","h":"Delete a Part","t":"Click Delete... (or right-click a row > Delete...) and confirm. The last Part can't be deleted, and a delete can't be undone."},{"p":"parts.html","c":"Parts","a":"parts-in-files","h":"Parts in files","t":"Format What happens to Parts Project (.sfproj) Every Part is saved with its name, visibility, folder, attributes, layers and active layer; linked copies keep their link OBJ Each visible Part is an o object; on import, o objects become Parts and g groups become face groups glTF / GLB One node and mesh per visible Part, both ways FBX One model per visible Part (with LODs, an LOD group each), both ways USD One Mesh prim per visible Part, both ways Bridge Each visible Part is sent as its own object PLY, STL, splat conversion The visible Parts are merged into one mesh Opening a multi-object file replaces the scene with one Part per object. See Exporting for the details of each format."},{"p":"parts.html","c":"Parts","a":"scripting","h":"Scripting","t":"Every Part action is a command, so you can use them in the console, scripts, Python and MCP agents. Parts are addressed by index (0 is the top of the list) or name; without either, the active one is used. Command What it does part_list List the Parts part_select index=1 Make a Part active part_append type=cube Add a primitive (sphere, cube, plane); path= adds a file; size= (0.05-2, default 0.35) part_duplicate Copy a Part part_duplicate_linked / part_make_unique A linked copy sharing the mesh / break the link part_delete name=Helmet Delete a Part part_rename to=Body Rename a Part part_visibility visible=false Show or hide (toggles when visible is left out) part_solo / part_show_all Solo the active Part / show every Part part_move direction=up Move a Part up or down the list part_folder_new folder=Eyes Make a folder holding a Part (empty=true: an empty one) part_set_folder name=EyeL folder=Eyes Put a Part into a folder (folder= empty: out of its folder) part_folder_visibility folder=Eyes Hide or show a folder's Parts (toggles when visible is left out) part_folder_collapse / part_folder_rename / part_folder_delete Fold or open, rename, remove a folder (folder=) transform translate=0,0.1,0 folder=true Transform the visible Parts in the active Part's folder part_merge_down / part_merge_visible Merge part_split_groups / part_split_parts Split part_split_hidden / part_split_masked / part_split_unmasked Split off into a new Part (undoable) part_shading mode=flat Shade a Part default (as the scene), smooth or flat extract thickness=0.02 smooth=5 double=false Preview an Extract shell from the mask; tcorne / tborder for a triangle rim; accept=true keeps it at once extract_accept / extract_cancel Keep or remove the Extract preview part_append type=sphere name=EyeL size=0.12; part_duplicate; part_rename to=EyeR"},{"p":"parts.html","c":"Parts","a":"see-also","h":"See also","t":"Linked Duplicates: copies that share one mesh Face Groups and visibility: hide parts of one Part Sculpt layers and blend shapes: layers belong to each Part Exporting: how Parts reach other applications Projects, autosave and snapshots"},{"p":"linked-duplicates.html","c":"Linked Duplicates","a":"","h":"Linked Duplicates","t":"A Linked Duplicate is a Part that shares its mesh with another Part but sits in its own place: rivets on a belt, the four legs of a table, the teeth of a gear, a row of columns. Sculpt, paint or mask any one of them and every linked copy changes with it; move, turn or scale each one on its own. A hundred linked copies cost about as much memory as one mesh, on the graphics card too. Three linked copies of one sphere, the last one scaled up: a stroke on it shows on all three; the Parts list shows a link and the count on each row"},{"p":"linked-duplicates.html","c":"Linked Duplicates","a":"make-a-linked-copy","h":"Make a linked copy","t":"Select the Part in Tool > Parts. Click Linked Duplicate (or right-click its row > Linked Duplicate). The copy is named link, goes right under the original in the list and appears beside it on +X. It becomes the active Part. Each linked Part shows a link and the number of Parts sharing the mesh at the end of its row; point at the row to see the count in the tooltip too. Making a linked copy is undoable: Ctrl+Z takes it away again."},{"p":"linked-duplicates.html","c":"Linked Duplicates","a":"sculpt-any-of-them","h":"Sculpt any of them","t":"Brushes, masking, Vertex Paint, texture painting, face groups and whole-mesh tools (remesh, subdivide, decimate, layers) work on the shared mesh: every linked copy shows the change at once. Strokes land where you see them on whichever copy is active, even when it is turned or scaled. Symmetry mirrors across the copy's own axes, so a turned copy still sculpts symmetrically. Linked copies share one undo history: undo on any of them steps back the shared mesh. The copies that aren't active are drawn slightly darker, like other Parts. The mask shows on the active one."},{"p":"linked-duplicates.html","c":"Linked Duplicates","a":"move-turn-and-scale-a-copy","h":"Move, turn and scale a copy","t":"Use the Gizmo on the active linked Part: it moves, turns or scales that copy as a whole and leaves the others where they are. Each move is one undo step. Scaling a linked copy is always even (the same along every axis), so it stays a copy of the same shape; uneven scaling takes the mean. With a mask (and the Gizmo's Mask option on), the Gizmo poses the shared mesh instead: the unmasked part moves, in every copy, along the active copy's own axes. transform does the same from the console: transform translate=0,1,0 rotate=0,90,0."},{"p":"linked-duplicates.html","c":"Linked Duplicates","a":"make-unique","h":"Make Unique","t":"Make Unique (in Tool > Parts, or right-click the row) gives the active linked Part its own copy of the mesh. It stays where it is and no longer changes with the others. Its undo history starts fresh. Deleting a linked Part never touches the others: the mesh stays as long as one Part uses it."},{"p":"linked-duplicates.html","c":"Linked Duplicates","a":"linked-copies-in-files","h":"Linked copies in files","t":"Format What happens Project (.sfproj) The links and each copy's place are kept; the mesh is saved once glTF / GLB One mesh, one node per copy with its own matrix USD (.usda, .usdz) The first copy holds the mesh; each other copy is an instanceable prim that references it, with its own transform OBJ, STL, PLY, FBX, Bridge Every copy is written as its own mesh, where it is Merge down and Merge visible put every Part where it is in the scene, so merged linked copies end up as separate pieces of one mesh. Projects with linked copies need SculptForge 0.12 or later to open."},{"p":"linked-duplicates.html","c":"Linked Duplicates","a":"scripting","h":"Scripting","t":"Command What it does part_duplicate_linked A linked copy of the active Part (or index= / name=); offset=x,y,z places it (default: beside it on +X) part_make_unique Give a linked Part its own mesh part_list Linked Parts show linked xN part_duplicate_linked offset=0,0,2; part_duplicate_linked offset=0,0,2; part_duplicate_linked offset=0,0,2"},{"p":"linked-duplicates.html","c":"Linked Duplicates","a":"see-also","h":"See also","t":"Parts: the Parts list, merging and splitting Moving, rotating and posing (Gizmo) Exporting"},{"p":"forge-spheres.html","c":"Forge Spheres","a":"","h":"Forge Spheres","t":"Forge Spheres (experienced sculptors: Forge Spheres) block out an organic base mesh from connected spheres: start from one root sphere, grow a torso, a head, limbs, fingers, a tail or branches from it, set the proportions, look at the skin over them, then turn it into a mesh you sculpt as usual. It is the quickest way to get the structure of a character or creature before any detail."},{"p":"forge-spheres.html","c":"Forge Spheres","a":"make-a-forge-sphere-part","h":"Make a Forge Sphere Part","t":"Tool > Forge Spheres > New Forge Sphere adds a Forge Sphere Part holding one root sphere at the centre and makes it active. It sits in the Parts list like any other Part, so you can block out a creature next to a model you already have. While a Forge Sphere Part is active, dragging on it edits the spheres instead of sculpting. Dragging the background still navigates. The brush ring is hidden; the sphere under the cursor gets an outline instead."},{"p":"forge-spheres.html","c":"Forge Spheres","a":"edit-the-spheres","h":"Edit the spheres","t":"Pick the mode in Tool > Forge Spheres: Mode On a sphere On a link Draw Drag to grow a new sphere from it. It starts on the surface where you pressed; how far you drag sets its size (a click makes one half the size of its parent) Click to add a joint halfway along the link, and drag to place it Move Drag to move it across the screen. The links stretch to follow Moves the sphere at the end of the link Scale Drag up or right to make it bigger, down or left to make it smaller Scales the sphere at the end of the link In every mode, Alt+click a sphere to delete it together with everything that grows from it. The root sphere (orange) always stays. Symmetry (X) mirrors every edit: grow an arm on the right and the left one grows with it, move a leg and its twin moves too. A sphere on the centre line stays on it, and a new sphere placed closer to the centre line than its own radius snaps onto it as one sphere instead of two overlapping twins. Every drag is one step of the Part's undo history, so Ctrl+Z takes back the last sphere you added, moved or scaled. Tip: build the structure first with few spheres (one per joint), set the proportions with Move and Scale, and add joints on links only where a limb needs to bend or swell."},{"p":"forge-spheres.html","c":"Forge Spheres","a":"pointer-only","h":"Pointer only","t":"Everything also works with the pointer alone, without a key held (#8): Drag places child: with it on, a Draw drag on a sphere makes a new sphere half its size and moves it away from its parent as you drag, so one drag places the next joint of a limb. With it off, hold Ctrl while you drag for the same. The selected sphere: the sphere you last clicked or added is outlined in orange. Delete Selected deletes it and everything growing from it, Insert Between adds a joint halfway to the sphere it grows from, and Set as Root makes it the root: the armature keeps its shape and links and grows from there, so the skin doesn't change. Right click a sphere (a click, not a drag: a right drag still turns the view) for a menu with Delete Sphere, Insert Between and Set as Root. Each is one undo step, and Symmetry mirrors Delete and Insert. From a script: forgesphere_set_root index=3."},{"p":"forge-spheres.html","c":"Forge Spheres","a":"preview-the-skin","h":"Preview the skin","t":"Preview (A) shows the skin over the spheres instead of the spheres themselves, so you can judge the volumes. The skin is a smooth union of the spheres and the cones between them, with the joints filled out a little. Turn Preview off to edit the spheres again; while it is on, clicks on the model do nothing."},{"p":"forge-spheres.html","c":"Forge Spheres","a":"make-mesh","h":"Make Mesh","t":"Make Mesh builds the skin as a new Part right below the Forge Sphere Part and makes it active: It is watertight and made of quads, ready for the brushes, Dynamic topology, Divide or Quad Remesh. Each link gets its own face group, so you can isolate or mask a limb straight away. Resolution sets how dense it is: cells across the model's longest side. 128 suits a blockout; raise it for thin fingers or tails that come out too thin or broken. The Forge Sphere Part is hidden and kept. To change the proportions later, show and select it, edit the spheres and Make Mesh again. The armature is saved with the project. Tip: for clean edge flow, run Quad Remesh on the new mesh, then Divide and sculpt."},{"p":"forge-spheres.html","c":"Forge Spheres","a":"scripting","h":"Scripting","t":"The same operations are commands (see Scripting): forgesphere_new, forgesphere_list, forgesphere_add, forgesphere_set, forgesphere_delete, forgesphere_insert, forgesphere_preview and forgesphere_make_mesh. For example, a simple figure: forgesphere_new radius=0.5 forgesphere_add parent=0 position=0,0.8,0 radius=0.3 forgesphere_add parent=0 position=0.9,0.1,0 radius=0.2 symmetry=x forgesphere_make_mesh resolution=160"},{"p":"tube.html","c":"Tube: draw in 3D space","a":"","h":"Tube: draw in 3D space","t":"Tube draws clay tubes freely in the air, like a 3D pen: horns, vines, hair strands, tentacles, cables, piping or the wire of an armature, drawn where you want them instead of pulled out of a surface. Each stroke becomes a smooth curve with a tube swept along it, and its points stay editable until you bake it into a mesh to sculpt. Drawing a tube from the model out into the air, the Tube Part it makes, a point dragged up, and a strap merged into the model"},{"p":"tube.html","c":"Tube: draw in 3D space","a":"draw-a-tube","h":"Draw a tube","t":"Open Tool > Tube and press Draw Tube. Drag anywhere in the view: on the model, off it, or from one into the other. A trail shows the tube as you draw; let go and it is made. Ctrl+Z takes the tube away again. While Draw Tube is on, Alt+drag still moves the view (and so do the right and middle buttons), so you can draw, turn the model, and draw again from another side. The brush ring is replaced by a circle as thick as the tube will be. Tool > Tube with a Tube Part selected Setting What it does Size How thick new tubes are: their radius on screen at the depth you draw at Pressure How much a light touch of the pen thins the tube (0: the same thickness all along). A mouse draws at full size Smoothing How much of the stroke's wobble is smoothed out before the tube is made Depth Where in depth the stroke lies (below) Snap to surfaces Where the pen is over a surface, the tube lies on it, half sunk in, instead of on the drawing plane Ends Rounded or Flat Result New Part: each stroke is a Tube Part you can edit. Merge: the stroke goes into the active Part Symmetry (X) draws the mirror copy across the X plane too, and keeps it as you edit the tube."},{"p":"tube.html","c":"Tube: draw in 3D space","a":"depth-where-the-stroke-lies","h":"Depth: where the stroke lies","t":"A stroke on a flat screen needs a depth. The tube's points lie on a plane facing you: Surface (the default): through the surface under the pen where the stroke starts. A stroke that starts off the model uses the depth where your last stroke ended, or the pivot. So a stroke started on a head and pulled out sideways grows from that spot into the air. Pivot: through the view's pivot, the point the camera turns around. Fixed: at a set Distance from the camera. Orbit and draw again to build up a shape in 3D. Turn Snap to surfaces on to draw along a model: a strap round an arm, a seam, a vein."},{"p":"tube.html","c":"Tube: draw in 3D space","a":"edit-the-points","h":"Edit the points","t":"A Tube Part's control points show as dots joined by a thin line (with Draw Tube on, the dots of every visible Tube Part show, and pressing one selects that Part): Drag a dot to move it across the screen; the tube follows as you drag. Ctrl+drag a dot up or right to make the tube thicker there, down or left to make it thinner. Alt+click a dot to delete it. The dot you last dragged is selected (orange): Radius sets its thickness exactly, Insert Point adds a point halfway to the next one, Delete Point removes it. Rounded and Flat change the ends of the selected tube. Each drag and button is one undo step. A Tube Part isn't sculpted while its points are editable: brushes leave it alone until you bake it. If you move, mirror or otherwise change the Part's mesh, its points no longer fit it and editing them is refused (undo the change, or bake it as it is)."},{"p":"tube.html","c":"Tube: draw in 3D space","a":"bake-and-merge","h":"Bake and Merge","t":"Bake turns the active Tube Part into a plain mesh to sculpt, in quads, with one face group for the body and one for each end. Tick Even edges first to bake it in triangles of one size instead, ready for dynamic topology. Undo brings the points back. Result > Merge skips the Tube Part: each stroke goes straight into the active Part as one undo step, with even edges close to that Part's own edge length, so dynamic topology carries on smoothly across it. A Part with subdivision levels or a micro level can't take a merged tube; draw a new Part and merge it with the Parts list. Tip: for clay-like strands, draw with Merge into a Part with dynamic topology on, then smooth and blend the joins with the brushes."},{"p":"tube.html","c":"Tube: draw in 3D space","a":"from-a-script","h":"From a script","t":"The tube_* commands do the same from the Console, scripts and AI assistants: tube_new points=\"0,0,0 0.5,0.4,0,0.08 1,0.2,0.3\" radius=0.05 caps=round symmetry=x tube_list tube_set_point index=1 position=\"0.5,0.6,0\" radius=0.1 tube_insert_point index=0 tube_delete_point index=2 tube_set caps=flat radius_scale=1.5 tube_bake uniform=true Each point is x,y,z or x,y,z,radius. With smooth=0.5 the points are treated as raw pen samples: smoothed and simplified into control points, as a drawn stroke is. merge=true puts the tube into the active Part."},{"p":"vertex-paint.html","c":"Vertex Paint and materials","a":"","h":"Vertex Paint and materials","t":"Vertex Paint (experienced sculptors: Vertex Paint) stores a colour on every vertex of the mesh, so you can paint a sculpt without UVs or textures. This chapter covers the Paint brush, painting while you sculpt, fills and cavity paint, picking colours, paint layers with blend modes, and the Lit Sphere materials that change how the model is shaded in the viewport."},{"p":"vertex-paint.html","c":"Vertex Paint and materials","a":"how-vertex-paint-works","h":"How vertex paint 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. Vertex Paint is per Part and is saved in projects. It is exported as vertex colours to PLY, glTF/GLB, OBJ, USD (displayColor) and Bridge files. FBX export doesn't include it. A mesh starts without vertex paint. The first paint stroke or fill adds it (white everywhere you haven't painted). Texture painting: to paint finer than the mesh, give the Part a texture and paint into it instead; the Paint brush, fills and paint layers work the same way. Vertex Paint > Texture bakes vertex paint into a texture. See Texture painting."},{"p":"vertex-paint.html","c":"Vertex Paint 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. Size, the stroke type and the alpha work as they do for sculpting; Colour 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. The surface isn't changed. Press P again, or click Sculpt on the top shelf, to go back to sculpting. Vertex Paint on a sculpt with the Paint menu open"},{"p":"vertex-paint.html","c":"Vertex Paint and materials","a":"paint-while-sculpting","h":"Paint while sculpting","t":"Turn on Rgb on the top shelf (or RGB while sculpting in the Paint menu). Every sculpt brush then also paints the current colour along its stroke. The Smooth brush and Shift-smoothing never paint."},{"p":"vertex-paint.html","c":"Vertex Paint 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. Under the two swatches, the recent colours are the last eight you painted with or filled with, newest first. Click one to paint with it again. They are kept when you restart. The Paint menu has a larger hue wheel with a hex value, ten preset swatches (white, near black, red, orange, yellow, green, blue, purple, skin and brown) and the fill buttons. Press C with the cursor over the model to pick the colour under it (the mesh needs vertex paint for this, or a texture while painting into the texture)."},{"p":"vertex-paint.html","c":"Vertex Paint and materials","a":"fill-cavity-paint-and-clear","h":"Fill, cavity paint and clear","t":"The Paint menu 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 vertex paint from the active Part All of them are undoable. Show vertex paint 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":"vertex-paint.html","c":"Vertex Paint and materials","a":"line-gradient","h":"Line Gradient","t":"Line Gradient (under Clear) paints a straight colour ramp across the model as you see it: turn it on, then drag a line over the view. The paint colour at the start of the line runs into the End colour at its end; past the ends the two colours carry on. Tick Clear to fade the paint colour out instead, so the paint underneath shows through towards the end. The swap button swaps the two colours. The line stays on screen with a handle at each end until you keep it: drag a handle, or change a colour, and the gradient is painted again in place of the last one. Enter keeps it (so does turning the view or any other edit), Esc takes it back. Each gradient is one undo step. It respects the mask like Fill, never paints hidden faces, and goes into the texture when the Part paints into one. With it on, Ctrl still masks and Shift still smooths; turn it off with its button or Esc."},{"p":"vertex-paint.html","c":"Vertex Paint and materials","a":"paint-through-a-stencil","h":"Paint through a Stencil","t":"A Stencil (Sculpt > Alpha > Stencil) paints too: load a photo or a pattern, place it over the model, and paint over it with the Paint brush. Where it covers the model the brush lays the image's colours (with your Colour intensity, falloff and mask); everywhere else it paints nothing. Turn off Paint its colours to paint the paint colour through the image's brightness instead (a grayscale pattern as a mask). Turn the model or move the stencil and paint again to cover a whole model."},{"p":"vertex-paint.html","c":"Vertex Paint and materials","a":"paint-layers","h":"Paint layers","t":"Paint layers stack vertex paint 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 Part has its own stack. Tool > Paint Layers: Base, a Multiply dirt layer, a Soft Light tint and an empty Normal layer"},{"p":"vertex-paint.html","c":"Vertex Paint and materials","a":"how-paint-layers-work","h":"How paint layers work","t":"Base is the bottom layer: the Part's vertex paint, always opaque. With only Base, vertex paint works exactly as it did before, and nothing changes in your files. 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 Paint menu 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":"vertex-paint.html","c":"Vertex Paint 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":"vertex-paint.html","c":"Vertex Paint 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 Paint menu. 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":"vertex-paint.html","c":"Vertex Paint 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":"vertex-paint.html","c":"Vertex Paint and materials","a":"files-parts-and-geometry","h":"Files, Parts 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, Bridge) write the composited colours, exactly what the viewport shows. Duplicating a Part copies its layers, and Split keeps them on each piece. Subdividing and decimating keep them too. Merging Parts, a voxel remesh and other rebuilds keep the look but flatten the layers into Base."},{"p":"vertex-paint.html","c":"Vertex Paint and materials","a":"materials-lit-spheres","h":"Materials (Lit Spheres)","t":"The materials are material capture (lit sphere) images: each one is a picture of a lit sphere that shades the whole model. They change only how the model is shaded in the viewport. They aren't exported and don't change vertex paint. Material Look Soft Clay The default: a matte warm light grey with a clear light and shadow side and a soft rim Sculpt 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 Render > Materials 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 Render > Materials, or the Material tab of the Library. The material picker with the built-in Lit Spheres and Studio Vertex Paint multiplies the material, and cavity shading stays on with every material (strongest with Sculpt). The material is saved with the project: projects saved with Studio open with Studio. Colour tints the material (in the Paint menu, on by default): on a Part with no vertex paint yet, the current colour tints its Lit Sphere material, so you can try a skin, stone or bronze tone without painting anything. The colour's hue and saturation tint it; grey (the starting colour) and black leave the material as it is, and the material keeps its own light and shade. Once a Part has vertex paint, the paint shows instead. PBR shading uses the material channels and is not tinted. Saved with the project. Tip: Sculpt is the material to judge strokes with. The prettier ones (Skin, Red Wax) soften small detail; switch to them for presenting."},{"p":"vertex-paint.html","c":"Vertex Paint and materials","a":"your-own-lit-spheres","h":"Your own Lit Spheres","t":"Your own Lit Spheres are material capture (lit sphere) images too (Sloan and others, 2001): the view colours each point of the model with the sphere's colour where its surface faces the same way. Any lit-sphere image works: a square PNG, JPG or EXR with the sphere filling it (a non-square image is cropped to its centre; big ones are scaled to 1024 pixels). Render > Materials > Load Lit Sphere... picks an image. It joins the material list under its file name, the view uses it, and a copy goes into the Lit Spheres folder of your library (Documents/SculptForge/Lit Spheres, or the folder set in Edit > Preferences > Library), so it is there next time. Or put images into that Lit Spheres folder yourself: they show up the next time you open the material picker, Render > Materials or the Library's Material tab, no restart needed. Studios can share a read-only folder by listing it in the SCULPTFORGE_LITSPHERE_PATH environment variable (separated by :, ; on Windows); those load when SculptForge starts. Drop an image onto the Library's Material tab to load it the same way (dropped on the canvas, an image keeps its usual meaning). Rename one: right-click it in the material picker, Render > Materials or the Library's Material tab and choose Rename..., type the name and press Enter. Its file in the Lit Spheres folder is renamed too. A name another Lit Sphere already has is refused, so nothing is overwritten. Projects that use it keep their look: they find it by its pixels, not its name. Organise them in folders: each sub-folder of the Lit Spheres folder (one level) is a heading in the lists. Right-click a Lit Sphere and choose Move to folder for an existing folder, New folder... to make one, or Lit Spheres (no folder) to take it out again. You can also make the folders in your file manager. Lit Spheres from a pack, from a studio folder or carried only by the open project have no file of yours to change: Rename and Move to folder are greyed out, and pointing at them says why. To remove one, right-click it and choose Remove. An image from your Lit Spheres folder goes to the trash (the Recycle Bin on Windows), so you can still get it back. On macOS it is only hidden until you restart, and the message says where its file is so you can delete it yourself. Built-in materials can't be removed. A Lit Sphere loaded from an image (Gold) in Render > Materials Right-click a Lit Sphere for Rename... and Move to folder; the Metals folder is a heading in the list Your Lit Spheres appear in the material picker (M), Render > Materials and the Library, after the built-in ones, those in folders under their folder's name. A project that uses one carries a copy of the image, so it opens with the same look on another computer (or after you delete the file). Loading an image with the same name again replaces it. EXR images are read as linear light, so very bright highlights clip to white."},{"p":"vertex-paint.html","c":"Vertex Paint and materials","a":"smooth-and-flat-shading","h":"Smooth and flat shading","t":"Smooth shading (the default) blends the light across polygons, so the surface reads as one form. Flat shading lights every polygon on its own, so you see the faces: how the mesh is built, where its vertices sit, and exactly what a stroke, crease or pinch did to the geometry, without smooth blending hiding small lumps. It helps most when blocking out forms on a low-poly base mesh. Render > Materials > Shading: Smooth | Flat for the whole scene. The same buttons are in Tool > Display. This Part: Scene (the default) follows the scene's shading; Smooth or Flat keeps the active Part that way whatever the scene says, for example a flat body with smooth eyes. Smooth and Flat shading on the template head, with its eyes kept smooth Shading works with every material, vertex paint, textures and the mask. Like the material, it only changes the view: exports are unaffected. Projects save the scene's shading and each Part's own; projects from before open with your preferred shading. The scene's shading you choose is also the preference for the next session (it saves itself). Smooth and Flat have no default shortcut, so no classic key changes meaning; assign one under Edit > Preferences > Hotkeys if you switch often."},{"p":"vertex-paint.html","c":"Vertex Paint 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_gradient x0=-1 y0=0 x1=1 y1=0 to=clear Line Gradient from the paint colour (or color) at the start to to (a colour, or clear) at the end; the line in -1..1 view coordinates (view_proj, default the front view); area as paint_fill paint_from_cavity color=#202020 strength=0.7 smoothing=2 Cavity paint (defaults: dark brown, 0.7, 2 blur passes) paint_clear Remove all vertex paint, 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 Lit Sphere name (Soft Clay is the default, your own Lit Spheres included) or studio (desktop app only) load_litsphere path=gold.png Load a Lit Sphere image and use it; keep=false doesn't copy it into the Lit Spheres folder (desktop app only) rename_litsphere name=Gold to=\"Old Gold\" Rename one of your Lit Spheres and its image in the Lit Spheres folder; a name in use is refused (desktop app only) move_litsphere name=Gold folder=Metals Move one of your Lit Spheres into a sub-folder of the Lit Spheres folder (made if needed; folder=\"\" moves it back) (desktop app only) remove_litsphere name=Gold Remove one of your Lit Spheres; its image in the Lit Spheres folder goes to the trash (desktop app only) set_background mode=flat color=60,70,80 The view's background: gradient (the default) or flat with a colour (#rrggbb, r,g,b or a name); see The background (desktop app only) set_shading mode=flat The scene's shading: smooth (the default) or flat (desktop app only) part_shading mode=smooth name=Eyes A Part's own shading: default (follow the scene), smooth or flat; index or name picks the Part (default: the active one) 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":"vertex-paint.html","c":"Vertex Paint 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: Size, Falloff, 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 vertex paint could only show on millions of polygons. Everything you know from vertex paint 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 vertex paint stroke, with the UV view in Tool > Texture Map The texture can also carry roughness, metallic, normal, height, AO, emission and opacity, painted in the same strokes: see Material painting (PBR)."},{"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 Part has no texture, New Texture appears on the top shelf and in the Paint menu. 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 Part 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 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. Size, Colour intensity, pen pressure, the stroke type, the alpha, symmetry and the mask work as they do for vertex paint. Click Show UVs to see the texture with the UV layout drawn over it, below the buttons, or open the UV Editor (Alt+U) to cut seams, unwrap, pack and edit the UVs. 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 Part 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 vertex paint, exactly as before. The model shows both: the vertex paint 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 Part carries no old vertex paint (Tool > Paint Layers, or Vertex Paint > 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 Part keeps its own choice, saved in the project. Show texture (Texture Map, or the Paint menu) 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 vertex paint, 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 vertex paint. 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 vertex paint layers again; the two stacks are separate."},{"p":"texture-painting.html","c":"Texture painting","a":"convert-between-vertex-paint-and-texture","h":"Convert between vertex paint and texture","t":"Button What it does Vertex Paint > Texture Bakes the vertex paint (all its layers, as shown) into the active texture layer. Makes a 2K texture if there is none Texture > Vertex Paint Sets the vertex paint 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. Vertex Paint > Texture is a quick way to move an existing vertex-painted 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 Part'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 Bridge 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 Part 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 > Quad Remesh when the Part has a texture): a voxel remesh or Quad Remesh 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 Part 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 Parts keeps their textures: the merged Part 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 (other UDIM tiles) aren't painted yet; the UV Editor lays them out."},{"p":"texture-painting.html","c":"Texture painting","a":"scripting","h":"Scripting","t":"Command What it does uv_auto Unwrap the active Part (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 Part a texture (1024, 2048, 4096, 8192 or 1k...8k) and paint into it; from_vertexpaint=true starts from the vertex paint paint_target target=texture Where painting goes: vertex or texture texture_from_vertexpaint Bake the vertex paint into the active texture layer vertexpaint_from_texture Copy the texture into the vertex paint 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, part_merge_down and part_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":"uv-editor.html","c":"UV Editor","a":"","h":"UV Editor","t":"The UV Editor shows a Part's UVs flat, over the texture's tiles, and gives you everything to make them: seams drawn on the model, unwrapping that keeps the surface's shape, packing into one tile or across UDIM tiles, texel density, trim sheets, and hand editing of vertices, edges, faces and islands. While you work, the model shows the same colours and a checker, so stretch and density show up on the surface the moment they appear, and a painted texture can move with every edit so the model keeps its look. Open it with Tool > Texture Map > UV Editor, or Alt+U. It opens over the right of the canvas with the model moved to the left; drag its title bar or its edges to place it anywhere. The UV Editor: the lion's islands after Unwrap, with island colours and a checker on the model"},{"p":"uv-editor.html","c":"UV Editor","a":"the-window","h":"The window","t":"Select (top left): what clicks pick, Vertex, Edge, Face or Island (1-4 while the pointer is over the view). The selection converts when you switch. Colours: what the faces show, in the view and on the model: Islands (a colour each), Stretch, Density (texel density) or Plain. Image: what's behind the layout: nothing, a Checker, or the Part's painted Texture (tile 1001). On model: Colours shows the same colours on the model, Checker lays a checker on its UVs (a square per 32 texels of the texture, tinted per UDIM tile). Squares that stay square mean no stretch. Frame (F over the view) fits the selection, or the whole layout, in the view; Home shows tile 1001. The status line under the view: islands, what's selected, the mean stretch, the texel density and the UDIM tiles in use. The sections on the right: Unwrap (with the seams), Pack, Texel Density, Trim Sheet, Edit and Display. The view is drawn by the graphics card, so a million-triangle layout pans, zooms and moves as smoothly as a small one. Scroll to zoom (around the pointer); drag with the right or middle button to pan. The UDIM tile numbers are written in each tile's corner."},{"p":"uv-editor.html","c":"UV Editor","a":"selecting","h":"Selecting","t":"Click to select (Shift adds, Ctrl removes); drag on an empty spot for a box. In Island mode the box picks every island it touches; in Face mode the faces inside it. A selects everything, Alt+A nothing, Ctrl+I inverts. Select in 3D (Unwrap section): click or drag over the model to select there, in the current mode; Shift adds, Alt removes. The selection shows orange in both views. Moving a vertex moves all of its corners that are joined in UV space, so islands stay in one piece while you edit them; edges along a seam move each side on its own."},{"p":"uv-editor.html","c":"UV Editor","a":"moving-rotating-and-scaling","h":"Moving, rotating and scaling","t":"The selection has a box with handles: drag inside it to move, a corner to scale, the knob above it to rotate. Or press G (move), R (rotate) or S (scale) over the view, move the mouse, and click (or Enter) to finish; a right click or Esc puts it back. During G and S, X or Y locks to one axis; Ctrl snaps (1/64 of a tile, 15 degrees, tenths of the size). The model's stretch colours and checker follow the drag live. Each drag is one undo step."},{"p":"uv-editor.html","c":"UV Editor","a":"seams","h":"Seams","t":"Seams are the edges Unwrap cuts along. They show in red on the model while the UV Editor is open, and in red in the view. Seam Tool: drag along the model over the edges you want cut. Each stretch follows the shortest edge path from where the last one ended, so you can draw a loop around an arm in a few strokes. Alt+drag clears seams the same way. A ring under the pointer shows the vertex the next stretch starts from. Mark Seam / Clear Seam: the selected edges, or the border of the selected faces. Face Groups: every face group border becomes a seam. Island Borders: the borders of the current UV islands become seams (keeps an imported layout's cuts). Sharp Edges: every edge sharper than the angle beside it (hard-surface models). Clear All. Seams drawn with the Seam Tool across the mane, in red on the model"},{"p":"uv-editor.html","c":"UV Editor","a":"unwrapping","h":"Unwrapping","t":"Pick a method and click Unwrap. With faces selected it says Unwrap Selected: only those are unwrapped, and their new islands are fitted where the old ones were; otherwise the whole Part is unwrapped and packed. Method What it does Least Stretch (the default) Cuts along the marked seams and flattens each piece keeping both angles and lengths (a conformal start, then as-rigid-as-possible steps). The best all-round choice Conformal (LSCM) Keeps angles exactly; big curved pieces get smaller towards their ends By Face Groups Least Stretch, also cut along every face group border: group the model, then unwrap Planar Projects each piece flat along its mean direction: for flat panels and decals Unfold Islands Flattens the current islands again where they are, keeping pinned UVs in place: relax after editing Auto Seams Finds its own seams (as Auto UV does), for models you don't want to cut by hand Refine sets how many least-stretch steps run (more keeps lengths better; 0 is plain conformal). You don't have to cut everything yourself: a piece that is closed (a sphere), a tube or has holes gets the extra cuts it needs automatically, a closed shell split across its middle and a tangled piece cut into charts the way Auto Seams would. Without marked seams, a Part that already has UVs is cut along its current island borders. Unwraps of big meshes run in the background with their progress over the view; a million triangles take a few seconds."},{"p":"uv-editor.html","c":"UV Editor","a":"packing-and-udim-tiles","h":"Packing and UDIM tiles","t":"Pack lays the selected islands (or all) out as large as they fit: each turned to its smallest box, scaled to one texel density (Equal density; off keeps their sizes relative to each other), with Margin texels between them. Rotate also allows quarter turns. SculptForge tries packing by the islands' outlines and by their boxes and keeps whichever holds them larger. Columns and Rows set the grid of UDIM tiles to fill: Columns along u (1001, 1002 and on; ten make a full UDIM row) and Rows up v (1011 sits above 1001). 10 Columns x 2 Rows fills 1001-1020; 4 x 3 fills 1001-1004, 1011-1014 and 1021-1024 and never goes wider. Every island gets the same texel density: more tiles, more texels for everything; the view frames the grid after a pack. When the largest island sets the scale, fewer tiles than the grid holds get islands, and the status line says how many (Pack at Density fills more). Pack at Density instead keeps exactly the target texel density and opens as many tiles as it needs, Columns wide and then the next row up. Projects remember their grid; new ones start from the last one you used. Baking writes one set of maps per tile, rows included (name_normal.1011.png, see Baking). Texture painting still covers tile 1001 only. Packed across UDIM tiles 1001 and 1002"},{"p":"uv-editor.html","c":"UV Editor","a":"texel-density","h":"Texel density","t":"Texel density is how many texels of the texture cover a unit of the surface. The Texel Density section shows the selected islands' density (or the mean) at the texture's size (or the size you choose when there is no texture yet), and the Density colours show it on every face: green is the mean, blue fewer texels, red more. Set: scale the selected islands (or all) to the target density (texels per unit). Match: give them all their mean density, so a detail looks the same size everywhere. Pick: take the target from the selection. Pack at Density: pack at exactly the target (see above). Stretch on the model and in the view while the UVs are edited"},{"p":"uv-editor.html","c":"UV Editor","a":"trim-sheets","h":"Trim sheets","t":"A trim sheet is a texture made of horizontal strips (a moulding, a belt, a seam of rivets), each repeating left to right. In Trim Sheet, describe the strips: a count (4 equal strips), heights from the top (0.5,0.25,0.25) or v ranges (0-0.5;0.5-1); they show over tile 1001 while the section is open. Pick a strip and click Assign to Strip: the selected islands are turned lengthwise, scaled to the strip's height and lined up along it from the left. Fit width squeezes or stretches the row to fill the strip exactly; off, it keeps its proportions and may run past the right edge, which is fine on a trim that repeats. The texture doesn't move for trims: the islands take on the strip's look. An island laid into the second of four trim strips"},{"p":"uv-editor.html","c":"UV Editor","a":"editing","h":"Editing","t":"Button Over the view What it does Pin / Unpin P / Alt+P Pinned UVs (blue dots) stay where they are when you Unwrap or Unfold Weld W Selected vertices that meet across a seam become one UV each, and the seam between them goes Split Y The selected edges, or the border of the selected faces, become seams, so those faces move on their own Straighten The selected vertices (a border, an edge loop) line up on one horizontal or vertical line Rotate 90 A quarter turn of the selection (or everything) Flip U / Flip V Mirror the selected islands left to right or top to bottom A good relax workflow: straighten or move the borders you care about, pin them, then Unfold Islands."},{"p":"uv-editor.html","c":"UV Editor","a":"paint-stays-on-the-model","h":"Paint stays on the model","t":"Paint stays on the model (at the bottom of the sections, on by default): when the Part has a painted texture, every UV edit (unwrap, pack, a drag, density, weld...) moves the paint onto the new layout in the same undo step, every texture layer with it, so the model looks exactly the same. Undo brings back the old UVs and the old texels. Turn it off when you want the UVs to pick a different part of the texture (as trim sheets do); the trim command leaves it off by default."},{"p":"uv-editor.html","c":"UV Editor","a":"undo","h":"Undo","t":"Every UV operation is one undo step (Ctrl+Z), drags included: the UVs, seams and pins, and the texture when it moved with them. Seams and pins are saved with the project."},{"p":"uv-editor.html","c":"UV Editor","a":"scripting","h":"Scripting","t":"Every operation is a command, for scripts, sculptforge-cli, Python (sf.run(doc, \"uv_unwrap\", method=\"isometric\")) and the AI assistant. \"The selection\" is the UV Editor's (set it with uv_select); with nothing selected the commands work on the whole Part. Command What it does uv_unwrap Unwrap: method=isometric (Least Stretch), conformal, facegroups (By Face Groups), planar, unfold or auto; iterations=, selected=, tiles=, columns=, rows=, margin=, rotate=, density=, pack=false (fit in place), keep_texture= uv_pack Pack: margin= (texels), columns= and rows= (the UDIM grid, e.g. columns=10 rows=2 for 1001-1020), tiles= (UDIM tiles, ten per row), first_tile=, rotate=, equal_density=, density= (texels per unit, as many tiles as needed), resolution=, keep_texture= uv_seam Seams: op=mark / clear (the selection), path from= to= (shortest edge path between two vertices; clear=true), facegroups, islands, angle angle=60, clear_all uv_select op=all, none, invert, island face=, face face=, facegroup group=, rect u0= v0= u1= v1=, seams, mode; mode=vertex/edge/face/island, add=true uv_transform move_u=, move_v=, rotate= (degrees), scale=, scale_u=, scale_v= about the selection's centre uv_edit op=pin, unpin, clear_pins, weld, split, straighten, flip_u, flip_v uv_density op=set value=, op=match (match=mean or first), op=info; resolution= uv_trim strip=2 strips=4 (or 0.5,0.25,0.25 or 0-0.5;0.5-1), fit_width=, margin= uv_info Islands, seams, pins, texel density, the UDIM tiles in use and the mean stretch uv_seam op=face groups uv_unwrap method=isometric uv_pack tiles=2 margin=8 uv_density op=match uv_info"},{"p":"uv-editor.html","c":"UV Editor","a":"limits","h":"Limits","t":"Texture painting paints tile 1001 (UVs between 0 and 1); islands in other UDIM tiles are laid out, measured and exported, but painting them comes later. Packing works on islands' outlines when there are enough of them and the mesh isn't huge; otherwise on their boxes (a little less tight). Experienced sculptor? The UV Editor covers UV editing and auto UV: seams on the model, several unwraps, UDIM packing, texel density and trim sheets, plus live stretch and density on the model while you edit and paint that stays put when the UVs change."},{"p":"uv-editor.html","c":"UV Editor","a":"see-also","h":"See also","t":"Texture painting: paint on the UVs Baking: bake maps onto them Exporting: UVs go out with OBJ, glTF, FBX and USD"},{"p":"pbr-painting.html","c":"Material painting (PBR)","a":"","h":"Material painting (PBR)","t":"A painted texture can carry more than colour. Turn on material channels and the Paint brush paints how rough, how metallic, how bumpy and how bright the surface is, all in one stroke, the way game engines and renderers describe materials (physically based rendering, PBR). Every channel lives on the same UVs and paint layers as the colour from Texture painting, and goes out to Unreal, Unity, Godot, Blender, glTF and USD with Export presets. Solo roughness view: a glossy horizontal stroke on Base and a rough vertical stroke on a layer"},{"p":"pbr-painting.html","c":"Material painting (PBR)","a":"the-channels","h":"The channels","t":"Channel What it holds Stored as Base Color The surface colour. Always there. 8-bit sRGB (the texture you already paint) Roughness 0 is mirror-like, 1 fully matte. Starts at 0.65. 8-bit Metallic 0 for paint, stone, skin, plastic; 1 for bare metal. Starts at 0. 8-bit Normal Fine surface direction, a tangent-space normal map (OpenGL, green up). Starts flat. 8-bit RGB Height Painted relief, 0.5 = none. Also adds to the normal (\"height to normal\"). 16-bit Ambient Occlusion How much light reaches crevices, 1 = open. 8-bit Emissive Light the surface gives off, black = none. 8-bit sRGB Opacity 1 = opaque. Exported in the base colour's alpha. 8-bit A channel you turn on costs no memory until you paint it: channels are stored as 64 x 64 tiles, and a tile nobody painted is not stored at all (a tile of one value is stored as that one value). Turning a channel off discards what was painted in it; Undo brings it back."},{"p":"pbr-painting.html","c":"Material painting (PBR)","a":"turn-channels-on","h":"Turn channels on","t":"Give the Part a texture (Texture painting). Open Tool > Texture Map. Under Material Channels, tick the channels you want (for a typical game asset: Roughness, Metallic and Normal; add Height to paint relief, Ambient Occlusion to paint dirt into crevices). Channel memory below the ticks shows what the painted tiles use; the same number, for every Part, is in Edit > Preferences > Performance under Memory."},{"p":"pbr-painting.html","c":"Material painting (PBR)","a":"paint-a-material","h":"Paint a material","t":"Open the Paint menu. With a material texture, a Material section appears under the swatches: Paint > Material: material swatches, and per channel a tick, value swatches and a slider; Material Channels in Tool > Texture Map Material swatches set the colour, roughness and metallic at once (bare metal, gold, copper, rust, gloss paint, rubber, stone, clay) and make the brush paint those channels. One row per channel: the tick says whether the brush paints that channel; the five grey squares pick 0, 25, 50, 75 or 100%; the slider sets any value. Normal has two tilt sliders (0, 0 paints a flat normal). Emissive has a colour. Untick Base Color to paint only roughness (a wet patch, a polished edge) without touching the colour. Every stroke is one undo step for all the channels it painted. The brush's falloff, alpha, pen pressure, symmetry and mask apply to every channel alike; erasing (Alt) paints Base back to each channel's default and makes layers transparent. C over the model picks the whole material: the colour and every channel under the cursor become the brush material, and the brush then paints all of the texture's channels."},{"p":"pbr-painting.html","c":"Material painting (PBR)","a":"layers-and-channels","h":"Layers and channels","t":"Paint layers (Texture painting) hold every channel. In Tool > Paint Layers, each layer row gets a row of channel chips (BC, R, M, N, H, AO, E, Op): Click a chip to turn that channel of the layer on or off. A rust layer can carry colour and roughness but leave metallic alone; a scratches layer can affect only the normal. Right-click a chip for the channel's blend mode and opacity. The ten paint-layer blend modes work per channel (Multiply on roughness halves it where you paint, Screen brightens AO...). The Normal channel adds Normal Combine, which lays the layer's normal detail onto the normals below instead of replacing them. A chip with a * uses a blend mode other than Normal or less than full opacity. The layer's own opacity, visibility and lock apply to all its channels. Merge down and Flatten keep the look of every channel. Duplicate copies a layer with its channels."},{"p":"pbr-painting.html","c":"Material painting (PBR)","a":"the-pbr-viewport","h":"The PBR viewport","t":"Render > Materials > Viewport Shading switches the view between Lit Sphere (the default, made for reading forms while sculpting) and PBR, which lights the material channels the way game engines and renderers do: rough surfaces spread the light, metals reflect the environment in their own colour, painted height and normals catch the light, emissive glows. PBR viewport, Photo Studio: gold metal and a raised rough red stroke Environment: Studio (made by SculptForge), Photo Studio, Small Studio and Outdoor Sky (free CC0 photographs from Poly Haven). HDR images (.hdr, .exr) in the folders listed in the SCULPTFORGE_HDRI_PATH environment variable are added to the list. Exposure in stops, Rotation of the environment, and the Tone map: ACES (filmic contrast), AgX (softer, keeps bright colours from going flat), Reinhard or None. Show environment puts the environment behind the model, with a Blur. Roughness and Metallic apply to Parts without a material texture (their colour comes from vertex paint or the base colour), so you can judge a sculpt as metal or clay too. Cavity darkens the sculpt's creases a little so fine detail reads under even light; 0 is plain PBR. The environment behind the model: Outdoor Sky with the AgX tone map The view stays as fast as Lit Sphere: lighting is precomputed per environment (on a worker thread when you switch), and only the pixels on screen pay for it. A 20.9-million-triangle Part draws in about 8 ms in PBR next to about 6 ms with Lit Sphere on an Apple M1 Pro. The settings are saved with the project (viewport_shading mode=pbr environment=outdoor_sky exposure=0.5 tone_map=agx)."},{"p":"pbr-painting.html","c":"Material painting (PBR)","a":"see-one-channel-on-its-own","h":"See one channel on its own","t":"Tool > Texture Map > Normal view opens a list: pick Solo Roughness (or any enabled channel) and the model shows just that channel, in grey for roughness, metallic, height, AO and opacity, as colours for the normal (with the height's normal in it) and in colour for emissive. Painting updates it live. Pick Normal view to go back. The viewport doesn't yet render the channels together as a lit PBR material; the solo view is how you check them for now."},{"p":"pbr-painting.html","c":"Material painting (PBR)","a":"height-and-normals","h":"Height and normals","t":"Height is stored with 16 bits, so slow ramps don't band. Its slope becomes a normal that is combined onto the Normal channel (Normal Combine) wherever a normal is shown or exported, so painting height also gives the shading detail. texture_channels height_normal_strength=4 sets how steep that normal is (0: height adds no normal)."},{"p":"pbr-painting.html","c":"Material painting (PBR)","a":"carrying-channels-through-geometry-changes","h":"Carrying channels through geometry changes","t":"Auto UV, Voxel Remesh, Quad Remesh and merging Parts move every channel and every layer's channels onto the new UVs, as they do the colour. A part without a channel takes that channel's default when Parts merge."},{"p":"pbr-painting.html","c":"Material painting (PBR)","a":"projects","h":"Projects","t":"Projects with material channels are saved as format 7 (SculptForge 0.10 and later opens them). A project without material channels is still saved as format 6, so older versions keep opening it. Older projects open as they did."},{"p":"pbr-painting.html","c":"Material painting (PBR)","a":"commands","h":"Commands","t":"Command What it does texture_channels enable=roughness,metallic,normal Turn channels on (disable=... off; no arguments lists them) paint_material roughness=0.2 metallic=1 color=c0c0c8 Set the brush material; channels=all / channels=roughness say exactly what it paints texture_layer_channel channel=normal blend=normal_combine A layer's channel settings (enabled, blend, opacity; layer or index) channel_view channel=roughness Solo a channel in the viewport (off to go back) export_maps preset=unreal folder=... Write the maps (Export presets) viewport_shading mode=pbr environment=photo_studio exposure=0.3 The PBR viewport (mode=lit_sphere to go back; rotation, tone_map, background, blur, roughness, metallic, cavity)"},{"p":"pbr-painting.html","c":"Material painting (PBR)","a":"limitations","h":"Limitations","t":"Fill layers, their mask generators, Mesh Maps and Material Recipes have their own chapter: Fill layers, Mesh Maps and Material Recipes. One texture per Part (UDIM tiles bake as files, Baking, but paint goes into one texture). Memory: colour, roughness, metallic, height and AO on Base plus three layers, each with a few big strokes, take about 370 MB at 4K and 1.5 GB at 8K (most of it the colour layers); a layer painted everywhere adds about 200 MB of channels at 4K and 800 MB at 8K. Edit > Preferences > Performance shows the numbers for your scene. Paint at 4K unless you need 8K. Export Maps takes a few seconds at 4K and about ten at 8K (PNG compression)."},{"p":"fill-layers.html","c":"Fill layers, Mesh Maps and Material Recipes","a":"","h":"Fill layers, Mesh Maps and Material Recipes","t":"A Fill layer lays a material over the whole Part, through a mask that you build from effects instead of painting it by hand: worn paint on the edges, dirt in the crevices, dust on the surfaces that face up. The mask reads the Part's Mesh Maps (its ambient occlusion, curvature, thickness and more, baked on its UVs), so the wear lands where the form says it should, and it moves with the form: sculpt a new crease and the paint chips along it a moment later. Material Recipes are ready-made stacks of Fill layers you can lay on any Part. Painted Edges on a sculpted sphere: the paint has chipped away along the creases Fill layers live in Tool > Paint Layers next to your paint layers, on a Part with a texture (Texture painting). Turn on Render > Materials > Viewport Shading > PBR to see the metal, the roughness and the bumps as they will look in a game engine (Material painting)."},{"p":"fill-layers.html","c":"Fill layers, Mesh Maps and Material Recipes","a":"lay-a-material-recipe","h":"Lay a Material Recipe","t":"Give the Part UVs and a texture (Tool > Texture Map > Auto UV, then New Texture). In Tool > Paint Layers, open Material Recipe and pick one: Worn Metal: dull steel, polished bright on the edges, grime in the creases. Painted Edges: painted metal with the paint chipped off its edges. Dirt and Dust: dirt packed in the crevices and pale dust on top, to lay over any material. Rusted Iron: dark iron with rust spreading from the crevices. The recipe adds its Fill layers on top of your layers, turning on the material channels it needs. The first time, the Part's Mesh Maps are baked in the background (a progress bar shows); the layers fill in when they are ready. Every layer of the recipe stays editable, and Undo removes the whole recipe in one step."},{"p":"fill-layers.html","c":"Fill layers, Mesh Maps and Material Recipes","a":"make-a-fill-layer","h":"Make a Fill layer","t":"+ Fill Layer adds a Fill layer in the current colour, covering everything. With it active, the panel shows: Colour and the channels it lays down (BC base colour, R roughness, M metallic, H height), with a slider for each value. Mask: the effects, top to bottom. Each one has a switch, a remove button and its own settings; from the second one on, a blend mode says how it combines with the effects above it (multiply, add, subtract, min, max, screen, replace). Add mask effect adds one at the bottom. The Fill layer panel: colour, channels and the mask effects with their settings"},{"p":"fill-layers.html","c":"Fill layers, Mesh Maps and Material Recipes","a":"mask-effects","h":"Mask effects","t":"Effect What it does Reads Edge Wear Convex edges and ridges, where things get rubbed and chipped Curvature Dirt Crevices, creases and corners, where dirt collects Ambient occlusion, curvature Gradient Along a direction across the Part (e.g. darker toward the bottom) Position Thickness Thin parts: ears, fins, edges of a blade Thickness Light Direction Surfaces facing a direction: dust and snow on top, moss on one side World normal Noise Fractal noise in 3D, so it has no seams at UV island borders Position Paint A mask you paint by hand (below) Levels Input and output range and gamma of the mask so far Blur Softens the mask so far (within UV islands only) Invert Flips the mask so far Fill A constant value The generators (the first five) have the same settings: Level (how much of the surface they cover), Softness (how wide the transition is), Break-up (how much noise roughens the edge of the mask) and Noise size (as a fraction of the Part's size)."},{"p":"fill-layers.html","c":"Fill layers, Mesh Maps and Material Recipes","a":"paint-a-mask","h":"Paint a mask","t":"Add a Paint effect, keep the Fill layer active and paint on the model with the Paint brush: you paint the layer's mask (white adds, Alt removes), and the layer updates as you paint. Strokes undo like any stroke. Combine it with generators: for example Edge Wear, then Paint with Subtract to keep an edge clean by hand."},{"p":"fill-layers.html","c":"Fill layers, Mesh Maps and Material Recipes","a":"mesh-maps","h":"Mesh Maps","t":"Mesh Maps are the Part's own surface, baked on its UVs at its texture's size: ambient occlusion, curvature (convex edges bright, creases dark), thickness, position (16-bit), world normal and ID (a colour per face group). Fill layers read them; you don't have to look at them. The line under the Fill buttons says what is baked. Bake bakes them again in full (after changing the UVs, for example: that happens by itself when a Fill layer needs them). Baking runs on every core in the background. Live (on by default): after each stroke, only the tiles of the texture near what you sculpted are baked again, from the triangles within reach of the change, and the Fill layers re-evaluate those tiles. The result is the same as baking everything again (it is tested texel for texel), in a fraction of the time: on a test Part with 82,000 triangles and 2K maps, a full bake takes about 10 seconds and a local change about half a second. Turn Live off to keep the maps as they are while you sculpt. To bake maps as image files for other programs, use Tool > Bake (Baking): it also bakes from a Part's top subdivision level onto its lowest, and to UDIM tiles."},{"p":"fill-layers.html","c":"Fill layers, Mesh Maps and Material Recipes","a":"save-your-own-recipe","h":"Save your own recipe","t":"A recipe is a small text file (.sfmaterial) listing the Fill layers, their materials and masks. Save the active Part's Fill layers with material_recipe action=save name=\"My Rust\" path=my_rust.sfmaterial and lay it on another Part with material_recipe path=my_rust.sfmaterial. The built-in recipes are files of the same kind in the source code's assets/materials folder."},{"p":"fill-layers.html","c":"Fill layers, Mesh Maps and Material Recipes","a":"projects","h":"Projects","t":"Fill layers are saved with the project (format 7): their settings and painted masks, and their last result, so older versions open the project with the layers showing as ordinary paint layers. Mesh Maps are not saved; they are baked again when a Fill layer needs them."},{"p":"fill-layers.html","c":"Fill layers, Mesh Maps and Material Recipes","a":"commands","h":"Commands","t":"Command What it does material_recipe name=worn_metal Lay a recipe on the active Part (action=list, action=save path=..., path=file) fill_layer generator=edge_wear color=#e0e0e8 metallic=1 level=0.6 Add a Fill layer (action=add is the default) fill_layer action=effect generator=dirt blend=add Add a mask effect to the active Fill layer (effect=1 level=0.4 edits one) fill_layer action=remove_effect effect=1 Remove a mask effect fill_layer action=set roughness=0.3 Change the layer's material mesh_maps Bake the Mesh Maps now (action=info, action=clear, action=live live=false)"},{"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 Part: each Part 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: 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 Layers list highlights the active layer; in the Classic layout the title strip also shows it (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. Moving, scaling and rotating with the Transform gizmo (or the transform command) goes into the layer too, masked or not. 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 3D Layers do: record it at the top level for the fine detail of an expression, and it stays with the Part whatever level you work on. Each layer has its own detail on every level. Step down with Lower Level (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) 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. Delete Lower and Delete 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, Quad Remesh, Decimate, Subdivide) work on the current level and drop the levels, as described in Subdivision levels; Voxel Remesh and Quad Remesh 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."},{"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":"Parts 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 Part, 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 Parts for the eyes, teeth and tongue, if the sculpt has them (see Parts). 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 Part."},{"p":"facial-shapes.html","c":"Facial shapes and live face","a":"generate-the-shapes","h":"Generate the shapes","t":"Select the head Part 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. Parts too: also give the other Parts 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":"parts","h":"Parts","t":"With Parts too on, the other visible Parts get shapes by their names: Part 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 Part 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. Parts 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 Part. Eyes sculpted into the head's own surface (one mesh) would be pulled along by the lids: split them into their own Part 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 Part 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 Part (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 Part 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] [parts=true] [level=N] Generate Facial Shapes on the active Part 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 Part 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 Part. 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: 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 Part 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 Level Shift+D Steps one level down Higher Level D Steps one level up SDiv slider Steps to any level (1 is the base cage) Delete Lower Deletes the levels below the current one Delete 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 Part list shows the level of every Part 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. 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, vertex paint, paint layers and UVs are interpolated onto the new level; face groups 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 Vertex Paint 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 Face Groups, 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":"delete-lower-and-delete-higher","h":"Delete Lower and Delete Higher","t":"Delete Lower deletes the levels below the current one: the current level becomes the new base cage (SDiv 1). Delete 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, 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. Tip: The Cube from Tool > Parts > 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, Delete Lower, Delete 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 Part 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 Bridge 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 Part, in any export format). LODs and Send to Unreal start from the current level too. Tools that rebuild the mesh (Voxel Remesh, Decimate, Quad Remesh, Subdivide, Delete hidden, merging and splitting Parts) 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 Parts can't be undone, so step to the level you want to keep first, or save before. Note: Subdivide (removes levels) (in Tool > Geometry, under Change the Mesh (no levels), apart from Divide and Micro) replaces the mesh with a denser one and keeps no levels. On a Part with levels it asks first (\"This removes your N subdivision levels\"); Don't ask again turns that off. Delete Lower and Delete Higher ask too. Use Divide (keeps levels) 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 Level, Higher Level subdiv_delete_lower, subdiv_delete_higher Delete Lower, Delete Higher subdiv_reconstruct Reconstruct Subdiv subdiv_info List the levels and their triangle counts subdiv_export path=base.obj level=1 Export the visible Parts 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 Part keeps them: selecting another Part frees that memory (50-170 MB for a Part 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."},{"p":"subdivision-levels.html","c":"Subdivision levels","a":"past-the-highest-level","h":"Past the highest level","t":"For more detail than the computer can hold as a mesh (hundreds of millions of polygons), add a micro level on top of the highest level: see Micro levels."},{"p":"micro-levels.html","c":"Micro levels: hundreds of millions of polygons","a":"","h":"Micro levels: hundreds of millions of polygons","t":"Subdivision levels store every vertex of every level. That is what lets you step down and reshape, but it costs about 90 bytes per triangle: a 300 million triangle model would need 27 GB. Micro levels go past the highest subdivision level without a mesh: each triangle of that level carries a regular grid of heights, one 16-bit number per point, and the micro triangles are worked out on the fly by the brushes and by the graphics card. 300 million micro triangles take about 0.4 GB, sculpt in real time and draw at 60+ frames per second. A sphere with 335 million micro triangles: surface noise, a Clay Block band, Crease and Sharp Crease lines (Micro 4, 420 MB)"},{"p":"micro-levels.html","c":"Micro levels: hundreds of millions of polygons","a":"making-a-micro-level","h":"Making a micro level","t":"Divide the Part to a comfortable highest level (0.3 to 2 million triangles is the sweet spot). In Tool > Geometry, set the Micro slider. Each step is four times the triangles: the label shows the total (Micro 4 on a 1.2 million triangle level is 300 million micro triangles). Click Divide to Micro. The surface stays exactly as smooth as before; the micro level starts flat on it. The micro level sits on the highest subdivision level, so step up to it first. While a micro level exists you can't change subdivision levels (Bake it or delete it first). Micro level Micro triangles per triangle Memory per micro triangle 3 64 1.4 bytes 4 256 1.2 bytes 5 1,024 1.1 bytes 6, 7 4,096, 16,384 1.05 bytes For the smoothest view, prefer a higher micro level on fewer base triangles: 300 million as Micro 5 on 300,000 triangles draws faster than Micro 4 on 1.2 million."},{"p":"micro-levels.html","c":"Micro levels: hundreds of millions of polygons","a":"sculpting","h":"Sculpting","t":"These brushes work on micro levels: Standard, Clay, Clay Block, Smooth, Inflate, Flatten, Trim, Layer, Pinch, Crease, Sharp Crease and Mask (with Ctrl). Symmetry, Falloff, pressure, alphas (Drag Stamp included) and the mask work as usual, and every stroke is one undo step. A micro level stores one height per point, so it moves the surface in and out, never sideways. Pinch, Crease and Sharp Crease pull the height profile together instead of the points (the result looks the same for creases and folds), and stay clean at full strength. Move reshapes the level below the micro level (the base) and the micro detail rides along on it, in its own frame: drag an ear back without smearing the pores. To move the micro surface itself along its normals, tick Move along normals. Big brushes are evaluated on a coarser grid (about 50 points across the brush) and the change is spread smoothly over the points in between, so a brush that covers half the model costs about as much as a small one. The detail under it is kept. Brushes that slide the surface (Tendril, Nudge, VDM stamps) and custom recipe brushes don't apply to micro levels; recipe brushes act as Standard. Vertex Paint, sculpt layers, face group colours and the wireframe aren't shown on micro levels yet."},{"p":"micro-levels.html","c":"Micro levels: hundreds of millions of polygons","a":"baking-down-and-exporting","h":"Baking down and exporting","t":"Bake Micro makes a regular mesh of the micro level in a new Part (the micro level stays). micro_bake level=3 bakes a coarser micro level; replace=true replaces this Part instead. UVs, face groups, hidden faces and the micro mask carry over. Export Displacement writes a 32-bit EXR displacement map over the base UVs (needs UVs) next to the project: the height of the micro surface above the flat base triangles, along the interpolated normal. micro_export_displacement path=detail.png type=vector writes a vector map (object space) or a 16-bit PNG (mid-grey = 0; the message says the scale). Projects keep micro levels (project format 7; projects without one are still written as format 6, so older versions open them). Untouched areas take almost no room in the file."},{"p":"micro-levels.html","c":"Micro levels: hundreds of millions of polygons","a":"very-large-levels-and-laptops","h":"Very large levels and laptops","t":"A micro level larger than the resident cache your hardware profile allows (a quarter of the memory when there is no profile yet) is kept out of core: in a file in the cache folder (~/.cache/sculptforge), of which only the parts you sculpt or look at stay in memory. A billion micro triangles then fit on a 16 GB machine. The status line under the slider says when a level is out of core. SF_MICRO_OUT_OF_CORE=1 forces it (for testing); SF_MICRO_SWAP_DIR picks the folder. How many triangles a frame draws for micro levels follows the machine: the view lowers the detail of far and small areas until a frame fits the budget (2 million on a laptop profile, 8 million on a workstation)."},{"p":"micro-levels.html","c":"Micro levels: hundreds of millions of polygons","a":"scripting","h":"Scripting","t":"Command What it does micro_divide level=4 or micro_divide triangles=300 Add a micro level (by level, or about this many million micro triangles) micro_delete Remove it (undoable) micro_info Level, micro triangles, memory, displacement range micro_bake level=4 replace=false Bake down to a mesh micro_export_displacement path=disp.exr size=4096 type=scalar Displacement map over the base UVs micro_noise amplitude=0.0015 scale=120 Procedural surface noise over the whole micro level sculptforge --bench-micro --bench-sizes 33,100,300 measures memory, brush and frame times on your computer."},{"p":"micro-levels.html","c":"Micro levels: hundreds of millions of polygons","a":"see-also","h":"See also","t":"Subdivision levels Performance Baking normal and displacement maps"},{"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 dynamic topology 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 Tendril with Dynamic on, as wireframe 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, Sculpt > Draw & Tablet Turns dynamic topology on or off Detail Top shelf (while Dynamic is on), Sculpt > Draw & Tablet How small the triangles get: 0 coarse, 100 fine (default 50) Constant detail Sculpt > Draw & Tablet 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 Drag Stamp and Slide Stamp (so VDM stamps don't remesh either). Smooth remeshes towards larger triangles, so smoothing also simplifies. Tip: Turn on Wire (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 dynamic topology: 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 and saves itself. 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":"smooth-remesh","h":"Smooth remesh","t":"Smoothing (Shift) with Dynamic on also simplifies by default: it remeshes toward triangles twice the size, so the smoothed area gets coarser, as in dynamic topology. Smooth remesh under Sculpt > Draw & Tablet > Dynamic topology sets how much (from the discussions): Smooth only (0): Shift only smooths; the triangles stay as they are. Light (50): it remeshes toward triangles one and a half times the size. Simplify (100, the default): as before. It is a preference (saved automatically) and is saved with the project; from a script, dyntopo smooth_remesh=0."},{"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. A model whose sides aren't made of mirrored polygons (after Quad Remesh, or sculpted without symmetry) has no mirrored triangles to keep: each side then gets its own new triangles, as fine as the brush's side. 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 face groups stay where they are; their vertices only slide along them. New triangles take the face group of the triangle they came from. Vertex Paint, 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 Part (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. On a Part with levels, clicking Dynamic offers Freeze Levels and Turn On Dynamic: the level you see becomes one plain mesh and the other levels go (Ctrl+Z brings them back). To keep a different level, go to it first. If you turn Dynamic on and then pick a Part that has levels, strokes sculpt it without remeshing, and the Sculpt > Draw & Tablet palette shows the same Freeze Levels + Dynamic button. A good workflow: block in with Dynamic, then Quad Remesh 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=Tendril 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 Quick tour for experienced sculptors"},{"p":"timeline.html","c":"Sculpt Timeline and timelapse","a":"","h":"Sculpt Timeline and timelapse","t":"Every stroke and operation you make is a step on the Sculpt Timeline, the strip along the top of the canvas (or its bottom: Edit > Preferences > Interface > Timeline position). Drag its scrubber to see the model at any point of the session, click a step to go back there, and keep sculpting from it: the steps you had made after it are not thrown away as with a plain undo, they stay as a branch you can switch back to. You can change how strongly a past stroke shows without redoing the strokes after it, and render the whole history as a turntable timelapse video. The Sculpt Timeline strip (here at the bottom of the canvas): three strokes on the active branch, the scrubber at the last one, and the lane of an earlier continuation above the track"},{"p":"timeline.html","c":"Sculpt Timeline and timelapse","a":"the-strip","h":"The strip","t":"Each step is a tick on the track: sculpt strokes in light grey, masks in blue, vertex paint in pink, visibility and face groups in green, and topology changes (dynamic topology, remeshing, Divide, Part changes) as tall teal ticks. The orange scrubber marks the state the canvas shows; the steps after it are dimmed. A dot above a tick marks a re-tuned stroke. Drag along the track to scrub through the history: the model follows as you drag. Click a tick to go to the state after that step. Point at a tick for what the step was, how many vertices it changed and when. Right-click a stroke to re-tune it (see below). The strip is one thin row: the step you are at on the left (point at it for the step's name and the number of branches), the track, then the buttons. The save icon (Save with project, lit when on) keeps the history with the project, the film icon exports a timelapse, the unfold icon shows the full strip with a header row (Edit > Preferences > Interface > Compact timeline switches it too), and the arrow folds the strip into a small Timeline tab (click the tab to open it again; Sculpt Timeline in the command palette, F3, does the same). Undo and Redo (Ctrl+Z, Ctrl+Shift+Z) move the scrubber one step, as before. Each Part keeps its own timeline, like its own undo history."},{"p":"timeline.html","c":"Sculpt Timeline and timelapse","a":"branches-undo-without-losing-anything","h":"Branches: undo without losing anything","t":"Go back to an earlier step and sculpt: a new branch starts there. The steps you had made after that point stay in the history as a thin lane above the track, starting where the branch splits off. Click the lane to make that branch the active one again; the branch you leave becomes the lane. Nothing is lost by trying an idea and going back."},{"p":"timeline.html","c":"Sculpt Timeline and timelapse","a":"re-tuning-a-past-stroke","h":"Re-tuning a past stroke","t":"Right-click a stroke on the track and drag Strength: 1 is the stroke as you made it, 0 removes it, 2 makes it twice as strong. The model updates at once and the strokes you made after it are kept. How it works: the change to that one stroke's displacement is added to the model as it is now. Where later strokes don't touch the area, the result is exactly what you would have had with the new strength. Where later strokes overlap it, they keep the displacement they made at the time, on top of the re-tuned stroke: they are not sculpted again. So a Smooth you did afterwards over the same spot won't smooth the stronger version, and a later Inflate keeps the direction it pushed in then. For most detail passes that is what you want; for a big change under a lot of later work, check the area afterwards. A stroke can't be re-tuned when a step after it replaced the mesh as a whole (dynamic topology, a remesh, Divide, a sculpt layer change): the menu says which step is in the way. Strokes made on a sculpt layer can't be re-tuned either."},{"p":"timeline.html","c":"Sculpt Timeline and timelapse","a":"big-meshes","h":"Big meshes","t":"Scrubbing reuses what undo already keeps for each stroke, only the vertices it moved. A run of strokes is swapped in one go, with normals and the view updated once for the whole run, and every few steps the timeline keeps a full copy of the shape (a checkpoint) so a jump across the whole history replays only a few strokes from the nearest one. Measured on an Apple M1 Pro after 220 strokes (a third of them big, up to 4.4 million vertices each), while other heavy programs were running: Mesh One step of the scrubber A jump across the history 21 million triangles 5 ms typical, 50 ms for the biggest strokes about 0.4 to 0.5 s 33 million triangles 5 to 14 ms typical, up to 170 ms for the biggest strokes about 0.6 to 1 s See also Performance and big meshes. The history uses memory: undo keeps up to 1 GB (the oldest steps go first, as before), the timeline up to 1.5 GB more for inactive branches and the extra copy of each stroke that makes fast seeking possible, and up to 1 GB of checkpoints (fewer, further apart, on very big models). With those limits a 21 million triangle model keeps about the last 100 strokes of the size above, a 33 million one about 70; small detail strokes cost far less."},{"p":"timeline.html","c":"Sculpt Timeline and timelapse","a":"saving-the-history","h":"Saving the history","t":"Turn on Save with project (the save icon on the strip) and saving a project also writes its history beside it, as name.sfhist next to name.sfproj. Opening the project brings the timeline back, branches and re-tuned strengths included, as long as the project hasn't been changed elsewhere since. Sculpt strokes, masks, vertex paint, visibility and face groups are saved; a topology change (dynamic topology, remesh, Divide, sculpt layers) cuts the saved history there, keeping what came after it."},{"p":"timeline.html","c":"Sculpt Timeline and timelapse","a":"timelapse-video","h":"Timelapse video","t":"Export timelapse (the film icon in the strip, or Export timelapse... in the command palette) renders the history of the active Part, from the start to the step you are at, as a turntable video: the model builds up stroke by stroke while the camera goes once around it, with a short pause at the start and the end. Pick 1080p or 4K, the length, and where to save the MP4. There are no captions or interface in the video. It needs ffmpeg installed. From the command line, for a project saved with its history: sculptforge creature.sfproj --timelapse creature.mp4 --size 3840x2160 --timelapse-seconds 20"},{"p":"timeline.html","c":"Sculpt Timeline and timelapse","a":"scripting","h":"Scripting","t":"The timeline is scriptable: timeline_info list=true lists the steps (with their ids), timeline_seek index=N shows step N of the active branch, timeline_select node=ID switches to the branch through a step, timeline_retune node=ID strength=0.5 re-tunes a stroke, and timeline_save / timeline_load write and read the .sfhist file."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo)","a":"","h":"Moving, rotating and posing (Gizmo)","t":"The Gizmo moves, rotates and scales a whole Part, 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, with the same keys. The Gizmo's Move, Scale and Rotate modes; the handle under the cursor turns yellow"},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo)","a":"the-three-modes","h":"The three modes","t":"Press a key, or click the button on the top shelf (they're also in Sculpt > Symmetry & Gizmo): 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)","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)","a":"moving-only-part-of-a-part","h":"Moving only part of a Part","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 panel to move the whole Part whatever the mask."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo)","a":"posing-a-limb","h":"Posing a limb","t":"Mask what should stay: for an arm, everything but the arm (Ctrl+paint, or Lasso Mask). 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 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 Part'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)","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 Part moved as a whole just moves."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo)","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 Part, or its unmasked part) and follows it when you change the mask or pick another Part. 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 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)","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)","a":"typing-exact-values","h":"Typing exact values","t":"The Gizmo 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)","a":"all-parts","h":"All Parts","t":"Turn on All Parts in the panel to move every visible Part together, for example to turn a whole character with its eyes, teeth and clothes. The pivot is the centre of all of them. Each Part gets its own undo step: undo goes back in the active Part, and selecting another Part undoes its part. Folder, beside it, moves the visible Parts in the active Part's folder together, for example both eyes. Right-click a folder's header in the Parts list > Move with the gizmo turns it on for you."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo)","a":"what-a-transform-keeps","h":"What a transform keeps","t":"A transform only changes where the vertices are. Face Groups, quads, UVs, vertex paint, textures, the mask and the topology stay as they are. With Base mesh active, 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 a sculpt layer active, the transform goes into that layer, like a stroke: the base stays, and the layer's weight dials the move in and out (a pose as a blend shape). A layer whose weight is 0 can't be transformed into. 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)","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 Part, moved, rotated and scaled together"},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo)","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)","a":"see-also","h":"See also","t":"Masking Parts 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 Part: add resolution for detail, rebuild an even surface, reduce the triangle count, make it symmetric, 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 Part 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 vertex paint Keeps face groups, 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 Quad Remesh Tool > Geometry > Quad Remesh Set by Target Polygons All quads, with edge loops Baked in Yes (transferred) Face Groups 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 Mirror And Weld Tool > Geometry > Modify Topology Twice the kept side Yes Yes Yes (mirrored) Yes (mirrored) 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 the Bridge, Blender or Maya (OBJ, FBX, PLY, USD) keeps its quads: Wire draws them as quads, without the diagonal, and OBJ, FBX, PLY, USD and Bridge 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, vertex paint, sculpt layers, undo, Parts 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 face groups, 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."},{"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 (removes levels) is the one-way version; on a Part with levels it asks before removing them. Tool > Geometry > Subdivide smooths the mesh with Loop subdivision. Each level multiplies the triangle count by four and rounds off the shape slightly. Sculpt layers are subdivided with the mesh, so blend shapes keep working. Mask, vertex paint and UVs are interpolated; face groups 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 Quad Remesh do the same. To add triangles only where you sculpt, use Dynamic topology. Tip: The bar along the top shows the triangle count 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 Part as an even, watertight surface. Use it to: fuse overlapping pieces into one surface (append a sphere, overlap it, merge, remesh); even out stretched triangles after heavy Move or Tendril 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 (32 to 512, as the remesh command; default 200). Higher keeps more detail and makes more triangles. 512 is safe on an 8 GB computer: a 28M-triangle scan remeshes at 512 in about 8 s (14 s on 4 cores) into about 760,000 triangles; a round 2M-triangle sculpt, which fills its box, in about 3 s (5 s on 4 cores) into about 2.5 million triangles, with about 2 GB of memory at its peak. 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 vertex paint are transferred from the nearest original vertex. Face Groups, hidden faces and UVs are reset (everything becomes visible, one face group). Hidden parts are remeshed too. A painted texture is kept with Keep Texture (on by default, shown next to the button when the Part 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). Keep Masked (off by default): masked areas keep their triangles exactly, detail included, and only the rest is remeshed. The new surface is joined to the masked area along the mask's edge by a narrow strip of triangles, so the model stays closed. A triangle counts as masked when all three of its corners are at least half masked. A ragged mask edge is tidied by itself (#67): where it touches itself the corner triangles are remeshed, masked spots smaller than the new polygons are remeshed with the rest, and narrow gaps between masked areas are kept; the status line says when it did. If it still can't be joined, the status line says what to change (blur or grow the mask, or unmask where two parts overlap) and nothing changes. Command: remesh keep_masked=true. To remesh several Parts into one, first combine them with Merge visible... or Merge down... in Parts."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"quick-remesh","h":"Quick Remesh","t":"Remesh as you sculpt, without going to the palette (#121). Turn on Tool > Remesh > Quick Remesh, then: press Shift+R, or hold N and click or drag on the background (anywhere off the model; on the model it stays a brush stroke). Either one remeshes the active Part at the Resolution above, with Keep Masked and Keep Texture as set there. It runs in the background with the same progress bar and Cancel, so you can keep sculpting; the status bar says when it's done and how many triangles the Part has now. Each remesh is one undo step. If you sculpt or undo while it runs, it doesn't throw that work away: it remeshes the Part again as it is now. Both keys change in Edit > Preferences > Hotkeys (Quick Remesh and Quick Remesh (hold and drag)). Neither Shift+R nor N is used by any key style, and holding N changes no other drag on the background: without it, a drag there turns, pans or zooms the view, or draws the mask and hide shapes, exactly as your key style says. With Quick Remesh off, the keys only tell you where to turn it on. Remesh after each stroke (off by default) does it for you: when you lift the pen after a stroke that stretched the surface (edges pulled to more than 1.6 times their length, as a long Move or Snake Hook pull does), the active Part is remeshed in the background. Strokes that don't stretch anything, and masking or painting, never remesh. Sculpting never waits for it. It skips Parts with subdivision levels, sculpt layers or a painted texture (Keep Texture), where a remesh would bake or drop them; use the button or Shift+R there."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"quad-remesh","h":"Quad Remesh","t":"Tool > Geometry > Quad Remesh is automatic quad retopology: it rebuilds the Part as clean quads whose edge loops follow the forms, close to a target polygon count, with Keep Groups, Adaptive Size, vertex paint density and symmetry. Project Detail (Tool > Parts > 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":"close-holes","h":"Close Holes","t":"Tool > Geometry > Close Holes caps every open boundary of the active Part, such as a hole, an open bottom or the rim of an extracted shell. The new patch's triangles are sized like the ones around the hole, and the patch follows the curve of the surface around it, so a hole in a sphere closes round, not flat. The rest of the Part is not changed. The patches get a face group of their own, so you can mask or hide them in one click. Close Holes makes an open scan or an extracted part watertight without a remesh. Ctrl+Z brings the holes back."},{"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 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 vertex paint. Face Groups, hidden flags and UVs survive on the remaining triangles. The result is all triangles: quads are not kept. With Keep Masked (under the button, off by default) masked vertices are never removed, so masked areas keep their triangles exactly and only the rest is decimated (decimate keep_masked=true). 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 Part (Tool > Parts > Duplicate) when you want to keep the full-resolution sculpt in the same project."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"mirror-and-weld","h":"Mirror And Weld","t":"Mirror And Weld, in Tool > Geometry > Modify Topology, makes a model symmetric: it keeps the half on the side of the chosen axis (+X is the model's left, your right when you look at its face), mirrors it onto the other side and welds the two halves along the middle into one watertight mesh. Use it after sculpting one side without symmetry, to finish a half model, or to repair a model whose sides have drifted apart. A head with a scar and a brow ridge on one side, then the same head after Mirror And Weld X Pick the axis with X, Y and Z beside the button (X is on by default). With several on, they apply one after the other. The mirror plane goes through the world's origin, the same plane symmetry uses. Polygons that cross it are cut on it, so the seam is clean wherever the model sits. Points on an open edge within 0.1% of the model's size from the plane are welded onto it, which closes a half model whose seam isn't exactly at 0. Face Groups, vertex paint, the mask, UVs, quads and sculpt layers are kept; the mirrored side takes the kept side's. Subdivision levels are removed (undo restores them), as with the other tools on this page. To keep the other side, flip the model first with Tool > Deformation > Mirror, or run mirror_and_weld side=negative."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"mirror","h":"Mirror","t":"Tool > Deformation > Mirror flips the Part across the plane through the origin on the chosen axes, with its surface still facing outward. Face Groups, vertex paint, UVs and layers come along; subdivision levels are removed (undo restores them). mirror pivot=center flips it in place about its own centre instead."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"merge-by-distance","h":"Merge by Distance","t":"Tool > Geometry > Merge by Distance merges the points of the active Part that are closer together than the Distance slider into one. Use it on an import whose triangles don't share their points (an STL, or a model another program split at its seams): until they are merged, every triangle is loose and a brush tears the surface apart. The line under the slider counts the points that will merge, and those points show on the model in orange while the section is open. On meshes with more than 1.5 million points the count updates when you let go of the slider. 0 merges only points exactly on top of each other. The slider goes up to 2% of the Part's size; scripts can use any distance. Points are taken in order: each one within the distance of a point kept before it merges into the nearest of them and takes its position, mask, vertex paint and sculpt layer offsets. Triangles that collapse (two corners on one point) are removed, and so are points no triangle uses. One undo step. Subdivision levels are removed (undo restores them)."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"check-mesh","h":"Check Mesh","t":"Tool > Geometry > Check Mesh looks for what makes a mesh hard to sculpt, remesh, 3D print or export. Check counts the problems; it changes nothing. Each problem found gets a row with its count and a Fix button that changes only what that row names, as one undo step. Row What it is What Fix does Non-manifold edges Edges shared by three or more triangles (a fin, a wall inside the mesh) Each triangle past the first two gets its own copy of the edge, so it comes loose; nothing is deleted Holes Open boundary loops Caps each with a patch, as Close Holes does Duplicate triangles Triangles on the same three points as another, either way round Deletes the copies Degenerate triangles Triangles that use one point twice Deletes them Zero-area triangles Three different points in one line (a sliver) Collapses each one's shortest edge Flipped triangles Triangles wound against their neighbours, or a closed piece that is inside out Turns them to match the rest of their piece, and closed pieces right way out Isolated points Points no triangle uses Removes them Fix all fixes every row except Holes, in one undo step: a mesh can be open on purpose (a cloth panel, a mask, a relief), so holes are only capped when you click their own Fix. After a fix the list checks again."},{"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 Part. The exports themselves build a chain for every visible Part."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"undo-and-safety","h":"Undo and safety","t":"Subdivide, remesh, Quad Remesh, decimate, Mirror And Weld, Mirror, Merge by Distance, every Check Mesh fix and delete hidden are single undo steps on the active Part. 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: Snapshot (File > Save Snapshot) keeps a timestamped copy of the scene without touching your project file; see Projects. Duplicate the Part 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_vertexpaint, symmetry, keep_original, keep_texture; see Quad retopology close_holes max_edges closes only holes with at most that many boundary edges (default 0: all); refine (default true; false: as few triangles as possible); new_group (default true) mirror_and_weld axis x, y, z or several, e.g. xz (default x); side positive (default) or negative mirror axis (default x); pivot origin (default) or center weld_points distance in scene units (0: only exactly coincident points); preview=true only counts them mesh_check Lists the problems, e.g. holes=2 flipped=14 mesh_fix issue non_manifold, holes, duplicate, degenerate, zero_area, flipped, isolated or all (all but holes) 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: Quad Remesh and Project Detail Parts: 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":"cut.html","c":"Cut: line, lasso, rectangle and polyline","a":"","h":"Cut: line, lasso, rectangle and polyline","t":"Cut cuts the active Part with a shape you draw on the screen. The shape is pushed straight into the view, so what you see inside it is what gets cut, front and back. Every cut is one undo step, and a closed Part stays closed (watertight), so you can keep sculpting, remeshing or 3D printing it."},{"p":"cut.html","c":"Cut: line, lasso, rectangle and polyline","a":"pick-a-shape","h":"Pick a shape","t":"Hold Ctrl+Shift and click the brush tile on the shelf (or press B) to pick a Cut shape next to Select Rectangle and Select Lasso, or use the shape buttons at the top of Tool > Cut: Shape How to draw it Cut Line Ctrl+Shift+drag a straight line. The shaded side is cut; hold Alt as you let go to cut the other side. Cut Lasso Ctrl+Shift+drag a free-hand outline. Its inside is cut. A lasso that crosses itself keeps its biggest loop. Cut Rectangle Ctrl+Shift+drag a rectangle. Its inside is cut. Cut Polyline Ctrl+Shift+click point after point. Click the first point again to cut the polygon; double-click or press Enter to cut along the open, bent line (the shaded side; Alt for the other); Esc drops it. While a Cut shape is picked, Ctrl+Shift cuts instead of hiding; pick Select Rectangle or Select Lasso again to hide parts of the model."},{"p":"cut.html","c":"Cut: line, lasso, rectangle and polyline","a":"pick-a-mode","h":"Pick a mode","t":"Tool > Cut has four modes: Mode What it does Away Removes everything the shape covers, through the whole Part, and closes the cut with a flat cap. A line slices the Part in two and keeps one side; a lasso or rectangle drawn inside the outline cuts a hole right through. In Cuts a flat-bottomed pocket where the shape covers the Part. Depth sets how deep, measured from the nearest point under the shape. Add Adds the shape, extruded towards you by Depth and joined to the Part (a boolean union): panels, ridges, buttons, sockets. Clip Removes nothing. A line presses its shaded side flat onto itself. A lasso, rectangle or closed polyline presses everything outside it onto its outline. Points keep their depth, so you get flat planes and clean silhouettes through the whole Part. The mask holds points back. Depth is a share of the Part's size (0.10 = a tenth of its largest side), so it means the same on a small or large model."},{"p":"cut.html","c":"Cut: line, lasso, rectangle and polyline","a":"what-the-cut-keeps","h":"What the cut keeps","t":"The surface outside the cut is kept exactly, with its mask, vertex colours, UVs, face groups and sculpt layers; only the triangles the shape crosses are split. The cap (and the walls of a pocket or added shape) are a face group of their own, so you can select, mask or hide them in one click (Face Groups). The caps are flat with long triangles. To sculpt on them, give the Part even topology first: Tool > Remesh or Dynamic topology (Subdivide, remesh, decimate and LODs). Only the active Part is cut; the other Parts are untouched. Cut each Part on its own, or merge them first. With symmetry on (X, Y, Z or radial on the top shelf), the mirror image of the shape cuts too. An open Part (a plane, a scan with holes) is trimmed without a cap. Add needs a closed Part. Forge Spheres and Parts with a micro level must be made into a plain mesh first."},{"p":"cut.html","c":"Cut: line, lasso, rectangle and polyline","a":"scripting","h":"Scripting","t":"The cut command takes the shape (line, lasso, rect, polyline), its points in normalised screen coordinates, the mode (away, in, add), depth, flip, closed and an optional view_proj matrix; see Scripting."},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"","h":"Quad retopology and detail projection","t":"Quad Remesh rebuilds a sculpt as clean, all-quad topology whose edge loops follow the forms. Project Detail then moves a mesh onto the surface of other Parts, so the detail of the original sculpt comes back onto the new topology. 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 Quad Remesh: 5,000 quads whose loops follow the mane, shown with Wire"},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"the-usual-workflow","h":"The usual workflow","t":"Select the sculpt and open Tool > Remesh (the same Quad Remesh controls are also under Tool > Geometry). Under Quad Remesh, turn on Keep Original. Set Target Polygons (for example 5000) and click Quad Remesh. It runs in the background: a progress bar replaces the button, and Cancel stops it. The result replaces the Part, and the sculpt as it was is kept as a hidden Part 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 > Parts) and click Project Detail under Tool > Parts > Project. The divided quads snap onto the sculpt and take its vertex paint. 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":"quad-remesh","h":"Quad Remesh","t":"Tool > Remesh > Quad Remesh (also under Tool > Geometry) works on the active Part. Control What it does Quad Remesh Starts the retopology. The status line reports the result and its quality, e.g. \"Quad Remesh: 5072 quads from 47214 triangles (100% quads) in 6.5 s. Quality: 260 poles (141 x3, 113 x5, 6 other), corners 8.5 deg off square, distance to the sculpt 0.106% mean / 1.27% max of its size\" Method Quad Remesh 2 (the default): the whole layout is solved at once as an integer grid, so poles appear only where the form needs them and loops run unbroken. Legacy: the method of SculptForge 0.9, kept for comparison and for closed guide loops 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 Part'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 face group borders, and the result keeps the face groups Detect Edges Hard edges get an edge loop, so boxes and bevels stay crisp (on by default). Quad Remesh 2 takes faces meeting at more than about 60 degrees along a line at least a few quads long (a scan's or a sculpt's deep creases are left to the flow); the legacy method any edge over 50 degrees Use Vertex Paint 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 Sculpt > Symmetry & Gizmo (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 Part as it was, hidden, below the new one, ready for Project Detail. Off: the Part is replaced (undo brings it back) Keep Masked Masked areas keep their triangles exactly, as a fixed piece: only the unmasked part is remeshed (the target counts its quads), and it's joined to the masked part along the mask's edge with a strip of triangles, so the model stays closed. If the mask's edge can't be joined up, the status line says so and nothing changes (off by default; qremesh keep_masked=true) Keep Texture Shown when the Part has a painted texture (on by default): Auto UV the result and project the texture onto it. Off: the texture is dropped Quad Remesh Guides Picks the guides brush: draw curves on the model for the edge loops to follow. See Quad Remesh 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) Quality Report Shown after a Quad Remesh of the active Part: the poles (vertices with other than four edges, by how many edges), how far quad corners are from square (mean and worst 1%), and how far the new surface is from the sculpt (mean and maximum, in % of its size) What happens to your data: The result is all quads (stored as pairs of triangles, so Wire draws quads and OBJ, FBX, PLY, USD and Bridge 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 vertex paint are interpolated from the closest point of the sculpt (vertex paint is blurred to the new resolution until you project it back onto a divided"},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"guiding-the-edge-flow","h":"Guiding the edge flow","t":"Quad Remesh Guides put an edge loop exactly where you draw: around the eyes, the mouth, a joint. See below. Face Groups 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 Face Groups. Vertex Paint sets the density with Use Vertex Paint: 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":"Quad Remesh 2 builds the layout the way recent research quad remeshers do (integer-grid maps, as in Mixed-Integer Quadrangulation, Bommes, Zimmer and Kobbelt 2009, and Integer-Grid Maps for Reliable Quad Meshing, Bommes et al. 2013), in its own implementation: A working surface. The sculpt is brought to about three triangle edges per quad edge with even triangles (dense sculpts are first decimated in parallel blocks), keeping open edges, face group borders (Keep Groups) and real hard edges (Detect Edges; creases shorter than two quads or softer than about 55 degrees at the quad scale are sculpt detail, not hard edges) on their exact place. Curvature and directions. The principal curvature directions, smoothed over about one quad, and a smooth cross field (the directions the edges take) solved over the whole surface at once: it follows the curvature where the surface clearly bends one way (limbs, lips, brows, ridges), the feature lines exactly, and is as smooth as possible elsewhere. It is solved on a copy of the surface smoothed at the quad scale, so pores and scratches don't add poles. Vertex Paint density turns it the way a change of density needs. The grid. A seamless parametrization whose integer lines are the edge loops: feature lines and guides lie exactly on grid lines, singularities (the poles) exactly on grid points, and across the seams the grid only turns by quarter turns. Its integer unknowns are rounded nearest-first, each round followed by a re-solve. Extraction of that grid at the target density (not split from a coarser one), every face a quad; the rare places where the grid folds are repaired locally and stay all quads. Loop-aware relaxation: smoothing on the sculpt in which a vertex can slide along a loop that runs over a ridge but not off it, then projection onto the sculpt. With Symmetry one half is remeshed with the mirror plane as a feature line and mirrored, so the field and the result are exactly symmetric. The result is the same every time for the same settings. The lion scan at 5,000 quads. Left: the legacy method, 1,028 poles. Right: Quad Remesh 2, 199 poles, with loops along the mane and round the muzzle and a clean box on the base Compared with the legacy method on the same models and targets, Quad Remesh 2 has a quarter to a fiftieth of the poles at the same distance to the sculpt (poles, then the mean angle of quad corners off 90 degrees, then the mean distance in % of the model's size; legacy first): Model Target Poles Corners off square Distance Lion scan (47k triangles) 2,000 433 to 116 22.7Β° to 7.8Β° 0.295% to 0.290% 5,000 1,028 to 199 18.2Β° to 7.9Β° 0.125% to 0.120% 10,000 1,665 to 398 14.5Β° to 8.3Β° 0.059% to 0.060% ICT head (28k, symmetry) 2,000 269 to 91 12.6Β° to 8.9Β° 0.108% to 0.101% 5,000 511 to 114 8.8Β° to 8.0Β° 0.039% to 0.040% 10,000 727 to 214 6.6Β° to 7.7Β° 0.015% to 0.018% Creature from a sphere (82k, symmetry) 2,000 96 to 22 4.6Β° to 8.5Β° 0.035% to 0.037% 10,000 308 to 37 3.4Β° to 6.8Β° 0.007% to 0.007% Hard-surface part (3 boxes) 2,000 56 to 24 2.0Β° to 0.7Β° 0.082% to 0.000% 10,000 24 to 28 0.3Β° to 0.7Β° 0.000% to 0.000% Sculpted sphere (1.3M) 2,000 84 to 8 4.3Β° to 3.9Β° 0.037% to 0.035% 10,000 401 to 8 4.3Β° to 5.2Β° 0.008% to 0.007% On smooth sculpts with Adaptive Size the corners are a few degrees further from square than the legacy method's: the grid bends to vary the quad size instead of adding poles. Set Adaptive Size to 0 for the squarest grid. A 1.3-million-triangle sculpt takes about 4 seconds to 5,000 quads on a 10-core M1 Pro; denser sculpts are first decimated in parallel blocks to a working resolution: 5.2 million triangles take 7 to 9 seconds (1.3 GB at most) and 21 million about 20 seconds (4.7 GB), at 2,000 to 10,000 quads. The legacy method (Method > Legacy, method=legacy) is the Instant Meshes style field-aligned method of SculptForge 0.9 (Jakob, Tarini, Panozzo and Sorkine-Hornung, 2015): faster on small models but with many more poles, and its result is extracted at twice "},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"quad-remesh-guides","h":"Quad Remesh Guides","t":"Draw curves on the sculpt and Quad Remesh puts an edge loop along each one, and turns the flow around it to follow, like quad remesh Guides brush. With Quad Remesh 2 an open curve is an exact edge loop: the grid line lies on it. Closed loops (round an eye) and loops across the symmetry plane are, for now, done by the legacy method for that piece (the status line says so). 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: Quad Remesh on its own. Middle: loops drawn round the eyes and the mouth with Quad Remesh Guides. Right: Quad Remesh again, with an edge loop on every curve and rings around them Click Quad Remesh Guides under Tool > Geometry > Quad Remesh (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 Quad Remesh. 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 Part: each Part 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 Quad Remesh put on them. Drawing and deleting guides isn't part of undo (Ctrl+Z undoes your sculpting as before). Good to know: Quad Remesh 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 Part 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 Quad Remesh'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 Quad Remesh remeshes one half, so a loop across the middle is cut there: its corners start on the seam, where it meets its mirror image. Quad Remesh 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":"project-detail","h":"Project Detail","t":"Tool > Parts > Project > Project Detail projects every other visible Part 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 Project Detail Projects the visible Parts onto the active one (one undo step) Dist How far to search, as a fraction of the Part'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) 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) Vertex Paint Project the vertex paint (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. Project Detail 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, Project Detail, divide again, Project Detail. 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 method (v2, the default, or legacy), quality (report poles, corner angles and the distance to the sculpt, default true), target (16 to 2,000,000, default 5000), adaptive (0-1, default 0.5), keep_groups, detect_edges (default true), use_vertexpaint, 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 (legacy method only; Quad Remesh 2 has no random start), keep_texture (default true), guides (follow the Part's Quad Remesh 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), vertexpaint (default true), source (one Part'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; part_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 Quad Remesh Parts: show, hide and duplicate the original Face Groups and visibility: guides for Keep Groups Projects: Quad Remesh Guides are saved with each Part 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 choose otherwise, Quad Remeshes it into clean quads with one subdivision level that holds the detail, ready to sculpt and subdivide. 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."},{"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 Mesh > Generate 3D 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). Choose Remesh and its Resolution (96 to 400, default 256; higher keeps more detail): Quad Remesh (the default): clean, all-quad topology of about resolutionΒ² / 2 quads (32768 at 256), then one subdivision level projected onto the model so the detail survives. Generated meshes often have holes and overlapping pieces, so a voxel pass cleans the mesh up first. Step down to the quad cage with Shift+D. Voxel remesh: one even, watertight triangle surface. Faster (about a second). Off (raw mesh): the model exactly as the service made it. Leave Remove flat background on (the default) to drop the flat plane a picture's background often becomes: a thin wall behind or a ground under the subject that covers most of the model's bounds. A relief or a coin on its own is kept. The status line says when a plane was removed; Undo brings it back (with Remesh on, the first Undo steps back to the raw mesh, the second brings the plane back). 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 size before and after remeshing, for example \"Generated model imported (47214 tris, remeshed to 133540 quads (2 subdivision levels)) - ready to sculpt\". Quad Remesh takes about 10 to 25 seconds after the model arrives (a 47,000-triangle Hunyuan3D head took 22 s on a busy 10-core computer); the progress bar shows it and the window stays usable."},{"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 Rodin 2.5 (Hyper3D) when it is the chosen Model (Rodin 2.5 or Rodin 2.5 Fast), otherwise Hunyuan3D 3.1 Rapid (Tencent) Meshy Meshy's own text-to-3D model Hyper3D Rodin (direct) Rodin Gen-2.5 at the chosen Tier 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, no token needed TRELLIS.2 (Microsoft) Best detail, MIT licence. Needs a free 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 If you never picked a model, SculptForge uses the default, so updates that change it reach you; a model you pick (and save) is kept. If you pick TRELLIS.2 without a token, Hunyuan3D 2.1 runs instead and the status line says \"TRELLIS.2 needs a free Hugging Face token (Edit > Preferences > AI); used Hunyuan3D 2.1 instead.\" The Hunyuan3D models' licence doesn't cover use in the European Union, the United Kingdom or South Korea. The first time a Hunyuan3D model runs, a notice says so, and it stays in the Model picker's tooltip. See AI services for each model's licence. 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 Edit > Preferences > AI (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 (free token), 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-meshy-and-hyper3d-paid","h":"fal.ai, Meshy and Hyper3D (paid)","t":"fal.ai: choose a Model (TRELLIS.2, Hunyuan3D 3.1 Pro, Hunyuan3D 3.1 Rapid, Meshy 6, Rodin 2.5 or Rodin 2.5 Fast) or type any fal model id into Model id. Rodin 2.5 (Hyper3D) works from an image or a description; SculptForge asks it for the shape only (GLB, no materials). Rodin 2.5 Fast is cheaper and low poly (up to about 20K triangles), fine as a blockout before remeshing. 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. Hyper3D Rodin (direct): Rodin Gen-2.5 on Hyper3D's own service, from an image or a description. Choose a Tier (Extreme Low is the fastest; Extreme High costs more credits) and paste your key from the API dashboard at hyper3d.ai into API key, then Save settings: the key goes into the system keychain. It stays off until you add a key. Your image or description goes to Hyper3D (api.hyper3d.com) and nowhere else, and SculptForge asks for the shape only (GLB, no materials). Basic API access (Creator plans) covers Extreme Low and Low; the other tiers need Full access. 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 Mesh > Generate 3D 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 bar along the top (the triangle count). If the detail is too soft, divide once more (Ctrl+D), or generate again with a higher Resolution. Tool > Remesh has Quad Remesh (first) and Voxel Remesh for another pass. Turn on X symmetry if the subject is symmetrical, and sculpt the forms with Clay Block, Move and Sharp Crease (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, no token (Hunyuan3D 2.1 on Hugging Face, the default) sculptforge-cli -c 'image_to_3d path=hero.png; export_glb path=hero.glb' # TRELLIS.2, best detail, with a free Hugging Face token (without one, Hunyuan3D 2.1 runs and says so) HF_TOKEN=hf_... sculptforge-cli -c 'image_to_3d path=hero.png model=trellis-2; export_glb path=hero.glb' # keep a flat background plane the service made (removed by default; remove_flat_background does it later) sculptforge-cli -c 'image_to_3d path=hero.png remove_background=false; export_glb path=hero.glb' # voxel remesh instead of the default Quad Remesh sculptforge-cli -c 'image_to_3d path=hero.png remesh=voxel; 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 (quad, the default; voxel; false), resolution (64 to 512, default 256), levels (quad: 0 to 2 subdivision levels, default 1) text_to_3d prompt (required), service (huggingface, fal, meshy, comfyui), model, workflow, url, seed, remesh, resolution, levels 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":"Your art is never uploaded or used for training. AI features run only when you use them and can be turned off. Off (Edit > Preferences > AI, or SF_AI=off) hides Generate 3D; Relief, Inflate and Stamp stay. See Turning AI off. 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: Quad Remesh and 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 Gaussian splat capture made from the lion, with the mesh hidden and the Splats button on the right shelf 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 Library Splats tab. The splats load next to your sculpt: the current mesh stays, and the capture is drawn around it as a reference. Render > Gaussian Splats 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 Block 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 Render > Gaussian Splats) turns the capture into a clean Part you can sculpt and animate: a watertight surface without floaters, quad topology with loops round the eyes and mouth when it is a head, and the capture'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 Render > Gaussian Splats when no splats are loaded, or from the command palette) covers the visible Parts with flat, oriented splats with soft clay shading baked in. Use it to show a sculpt in splat viewers, web scenes or engines that render 3D Gaussian splats. It replaces any loaded splats. 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 Render > Gaussian Splats, 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 Render > Gaussian Splats 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 Part with quads, face loops and colour (details) detail (default 256), preset (game, film, sculpt), color (vertex paint, 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 Parts 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 Render > Gaussian Splats (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 Render > Gaussian Splats 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 Library, 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 Render > Gaussian Splats 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 Part 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 vertex paint 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 Render > Gaussian Splats, under From scan, click Make sculptable. A progress bar and Cancel show while it works. When it's done: a new Part named after the capture holds the sculptable mesh, and is active; a hidden \" Scan\" Part 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 Render > Gaussian Splats brings them back); an untouched starting sphere is hidden too. No capture at hand? Try a test head in Render > Gaussian Splats (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 Render > Gaussian Splats"},{"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 Quad Remesh 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 Vertex Paint / Texture Where the capture's colours go: the vertices (vertex paint), 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\" Part, to Project Detail 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 Quad Remesh Guides for Quad Remesh 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 Quad Remesh's symmetry on, so both halves get the same edge flow. The guides stay on the result Part, so you can Quad Remesh it again at another density (Geometry > Quad Remesh) 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\" Part 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. Quad Remesh 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 Project Detail 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 Part: 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 Quad Remesh 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 vertex paint 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 (vertex paint, 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 Part (or takes landmarks) and replaces its Quad Remesh 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: Quad Remesh, Quad Remesh Guides and Project Detail 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 Library'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, TCP for the page and UDP for the direct link that AR on Android and face capture use, for example with ufw: sudo ufw allow from 10.0.0.0/24 to any port 8765 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-port=8765/udp (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 Mesh > Generate 3D > 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 Part 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 Part 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 vertex paint 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 an AR page on sculptforge.app in Chrome. Your sculpt comes to it encrypted through SculptForge's relay (the key is only in the link; the copy is deleted after 10 minutes), so it works even if Chrome can't reach your computer; without internet it comes straight over Wi-Fi. When your sculpt shows on the page, tap View in your room and then Open Google's AR viewer: this puts a readable copy on the relay (deleted after 10 minutes), because Google's viewer only loads models from the internet. Or tap Place it with Chrome's AR instead. Either way, use a well-lit room and move the phone slowly over a table or the floor until the model appears. AR needs Google Play Services for AR: if even other websites' AR opens and closes at once, update it, or clear its storage and restart the phone. Firefox can't show AR: if the capture page is open in Firefox, the AR page offers Open in Chrome. 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. On iPhone, tap View in AR again to see the change; Android's AR page updates by itself. 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 Part (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 Library 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 Parts with the detail. They stay as they are. A low-poly Part with UVs, in the same place as the high-poly. It can come from another app (import it with Tool > Parts > 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 Part, 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 Part and open Tool > Bake in the right tray. The first line says which Part the maps go onto, or \"No UVs\" if it needs Auto UV first. Source: leave All visible Parts to bake from everything that is shown (except the low-poly), or pick one Part. 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 > Parts, 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 / world) _normal_object.png The high-poly's normals in model space (Parts have no transform of their own, so this is also the world normal). 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 vertex paint, or its painted texture Curvature _curvature.png How the surface bends: mid-grey flat, brighter on convex edges and ridges, darker in creases. A bend of the curvature radius (2% of the model's size by default) is fully bright or dark. Drives edge wear Thickness _thickness.png How far rays travel through the high-poly before leaving it: dark where it is thin (ears, fins, blades). Drives translucency Position _position.png (16-bit) Each point's place in the bounding box, as red, green and blue. Drives gradients and noise without UV seams ID _id.png A flat colour per face group (or per Part, id=parts), to pick areas in other programs is the low-poly Part's name. Colour is skipped when the source has neither vertex paint nor a texture. Tool > Bake with the Part's own top subdivision level as the source and the Mesh Maps ticked"},{"p":"baking.html","c":"Baking normal and displacement maps","a":"bake-from-the-parts-own-levels","h":"Bake from the Part's own levels","t":"A Part with subdivision levels can bake its sculpted detail onto itself: choose Own top subdivision level as the Source, and the top level is baked onto the lowest level's UVs (give the lowest level UVs first). A Part with a micro level offers Own micro level, baked onto its base. No second Part, no matching: the levels share their UVs."},{"p":"baking.html","c":"Baking normal and displacement maps","a":"udim-tiles","h":"UDIM tiles","t":"When the low-poly's UVs go beyond the 0..1 square (UDIM tiles, for example from the UV Editor), every tile bakes as its own set of maps: _normal.1001.png, _normal.1002.png, ... (1001 + u + 10 v, the usual numbering). The same maps, baked on the texture's own UVs, feed Fill layers inside SculptForge."},{"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 Part, or every visible Part 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). Other bakers 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 Parts 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 Part 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 Bridge."},{"p":"baking.html","c":"Baking normal and displacement maps","a":"commands","h":"Commands","t":"Command What it does bake Bake onto the active Part and write the maps. Options: source=all, a Part name, subdivision or micro, maps=normal,object_normal,displacement,ao,cavity,color,curvature,thickness,position,id (or all), udim=true, thickness_rays=24, thickness_distance=0.1, curvature_radius=0.02, id=facegroups or parts, 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: part_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 Bridge","a":"","h":"Exporting, Unreal and Bridge","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 another sculpting application through the Bridge. To keep everything (Parts, layers, mask, vertex paint, brushes) use a project file instead; see Projects, autosave and snapshots."},{"p":"exporting.html","c":"Exporting, Unreal and Bridge","a":"export-formats-at-a-glance","h":"Export formats at a glance","t":"Exports write every visible Part. Hidden Parts 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 Part, sculpt layers as morph targets, vertex paint 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 Part, quads, layers as UsdSkel blend shapes, vertex paint 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 Part, quads, face groups as g groups, vertex paint 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 Bridge file File > Bridge > Export Bridge file... Quads, face groups, mask, vertex paint, UVs, the painted texture as a PNG beside it The Bridge STL (.stl) File > Bridge > Export STL... Geometry only (triangles), visible Parts merged, in millimetres with Z up 3D printing PLY (.ply) export_ply command Geometry, quads and vertex paint, visible Parts merged Scan tools, MeshLab, Blender FBX (general) export_fbx command One model per Part, 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 Bridge files, in and out. A Part with a painted texture is exported with it: the PNG is written next to the file as _color.png (__color.png with several Parts) 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 Bridge","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). USD files in other units (metersPerUnit, e.g. centimetres from Maya or Houdini) open at their real size. For Unreal, Height sets the real-world size directly (see below)."},{"p":"exporting.html","c":"Exporting, Unreal and Bridge","a":"real-world-size-and-units","h":"Real-world size and units","t":"A part keeps the size it was opened with through every export: OBJ, PLY and STL have no units. A scene opened from one of them remembers its unit: exporting OBJ or PLY writes that unit back (an STL opened in millimetres exports a 50 mm OBJ, not 0.05), and an STL written from an STL keeps its numbers. Decimal sizes come back exactly (12.7 stays 12.7). Projects remember the unit. Edit > Preferences > Interface > OBJ/PLY in says what OBJ and PLY numbers mean: m (the default; Blender and game tools), or mm for files made for 3D printing, cm or in. STL is always read as millimetres. From scripts: open path=part.obj unit=mm (open_obj and part_append take unit= too; unit=in reads an inch STL). Edit > Preferences > Interface > Units picks the unit sizes show in: mm, cm, m or in. The active Part's width x height x depth shows under its name in Tool, the size the exports write in File (Import / Export), and the brush size by the brush ring."},{"p":"exporting.html","c":"Exporting, Unreal and Bridge","a":"export-a-model","h":"Export a model","t":"Show the Parts you want to export and hide the others (the eye icon in Tool > Parts). Choose the export in the File palette and pick a file name. The status line confirms the export (\"Exported ...\"). A Part 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 Bridge","a":"3d-printing","h":"3D printing","t":"File > Bridge > Export STL... writes every visible Part 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 Parts go into the file as they are, which some slicers and print services reject. Merge visible them (Parts) 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 Bridge","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 Parts, each Part 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 Bridge","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 Parts One FBX model per Part, 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) A texture with material channels T__BC, T__N (DirectX) and T__ORM (occlusion, roughness, metallic), plus T__E when emissive is painted, and a material M_ built from them and assigned to the mesh (Unreal on this computer only; see Export presets) 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 Bridge","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 Bridge","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 Bridge","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 Bridge","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 Bridge","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 Bridge","a":"exchange-models-through-the-bridge","h":"Exchange models through the Bridge","t":"The Bridge exchanges Parts with another sculpting application through a shared bridge folder, the way that application's own exchange plug-in does, on Windows and macOS. The commands are in File > Bridge: Item What it does Send Writes every visible Part to the bridge folder and tells the other application (starting it if needed). Each Part arrives as its own object. Turns on Receive automatically Receive Loads what the other application last sent. Each object updates the Part it was sent from (one undo step), or becomes a new Part Receive automatically Checks once a second for a new send and receives it Custom bridge folder (optional) Use another bridge folder, for example inside a Wine prefix Import Bridge file... Opens a Bridge file, replacing the scene Export Bridge file... Writes a Bridge file. With several visible Parts, one file per Part next to the path Export STL... Writes a binary STL of the visible Parts On Windows and macOS the Bridge finds the shared exchange folder by itself; nothing to install. On Linux it needs a custom folder; Bridge files still import and export."},{"p":"exporting.html","c":"Exporting, Unreal and Bridge","a":"a-round-trip","h":"A round trip","t":"In SculptForge, choose File > Bridge > Send. The other application starts or comes forward with the Parts. If it was not running and does not import them, use its own import from the bridge. Work there, then send the model back with its exchange plug-in. SculptForge receives it automatically and updates the matching Parts. Each update is an undo step on that Part. The Bridge keeps face groups, mask, vertex paint and UVs. Quads stay quads both ways: Wire shows them as quads. The format has no hidden-face flag, so hidden faces are sent like any others. Note: the Bridge is tested with files, not yet against every version of a live application. If a send does not arrive, export a Bridge file and import it by hand, and please report it (Help > Report a problem). From scripts: bridge_export path=, bridge_import path=, bridge_send, bridge_receive and export_stl path= (see 3D printing for its options)."},{"p":"exporting.html","c":"Exporting, Unreal and Bridge","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 Parts, UVs and quads both ways."},{"p":"exporting.html","c":"Exporting, Unreal and Bridge","a":"maya","h":"Maya","t":"To sculpt Maya meshes in SculptForge and send them back into the same objects, use the SculptForge shelf for Maya and File > Maya: see Working with Maya."},{"p":"exporting.html","c":"Exporting, Unreal and Bridge","a":"see-also","h":"See also","t":"Working with Blender: the Blender add-on Working with Maya: the Maya shelf script Projects, autosave and snapshots: save everything, not just the mesh Parts: which Parts 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":"export-presets.html","c":"Export presets","a":"","h":"Export presets","t":"Export Maps writes a texture's channels (Material painting) as the image files a game engine or DCC expects: which files, what they are called and how channels are packed into them come from an export preset. SculptForge has presets for the common targets, and you can write your own as a small JSON file."},{"p":"export-presets.html","c":"Export presets","a":"export-maps","h":"Export maps","t":"Open Tool > Texture Map. Under Material Channels, choose a preset in the list next to Export Maps... (hover a preset for what it writes). Click Export Maps... and pick a folder. The files are named after the Part. From a script or the console: export_maps preset=unreal folder=/path/to/maps name=Rock. export_maps list=true lists the presets and their maps. Channels you haven't turned on export their default value (roughness 0.65, metallic 0, flat normal, AO 1), so a preset always writes a complete set. Maps marked optional below are written only when one of their channels is on."},{"p":"export-presets.html","c":"Export presets","a":"built-in-presets","h":"Built-in presets","t":"Preset Files (for a Part called Rock) Normal unreal T_Rock_BC (base colour; opacity in alpha when painted), T_Rock_N, T_Rock_ORM (R occlusion, G roughness, B metallic); optional T_Rock_E (emissive), T_Rock_H (16-bit height) DirectX unity_urp Rock_BaseMap, Rock_Normal, Rock_MetallicSmoothness (R metallic, A smoothness = 1 - roughness); optional Rock_Occlusion, Rock_Emission, Rock_Height OpenGL unity_hdrp Rock_BaseMap, Rock_Normal, Rock_MaskMap (R metallic, G occlusion, B detail mask = white, A smoothness); optional Rock_Emission, Rock_Height OpenGL gltf Rock_baseColor, Rock_normal, Rock_occlusionRoughnessMetallic (R, G, B as glTF expects); optional Rock_emissive OpenGL godot Rock_albedo, Rock_normal, Rock_orm; optional Rock_emission, Rock_height OpenGL blender One file per channel: Rock_BaseColor, Rock_Roughness, Rock_Metallic, Rock_Normal; optional Rock_Height (16-bit), Rock_AO, Rock_Emission, Rock_Alpha OpenGL usd One file per UsdPreviewSurface input: Rock_diffuseColor, Rock_roughness, Rock_metallic, Rock_normal; optional Rock_occlusion, Rock_emissiveColor, Rock_opacity, Rock_displacement OpenGL All files are PNG at the texture's size: 8-bit, except height maps, which are 16-bit greyscale. The normal map is the effective normal: the Normal channel with the height's normal combined in. DirectX presets flip green. Send to Unreal (Exporting) uses the unreal preset and then builds a material M_ in Unreal from the maps: BC to Base Color, ORM's R / G / B to Ambient Occlusion, Roughness and Metallic, N to Normal, E to Emissive. It is an ordinary Unreal material you can edit."},{"p":"export-presets.html","c":"Export presets","a":"material-slots-in-model-files","h":"Material slots in model files","t":"You don't need Export Maps to get the material into a model file: when the texture has material channels, exporting a model writes the maps beside it (or inside it) and wires them into its material. Format What the material gets glTF / GLB Base colour (alpha from opacity, alphaMode BLEND), metallicRoughnessTexture and occlusionTexture from one packed map, normalTexture, emissiveTexture USD / USDZ A UsdPreviewSurface whose roughness, metallic, normal, occlusion, emissiveColor and opacity inputs each read their own map (raw colour space; the normal with scale 2, bias -1) OBJ The MTL's PBR keys: map_Pr (roughness), map_Pm (metallic), norm / map_Bump (normal), map_Ke (emission), map_d (opacity) FBX Textures on the material's NormalMap, ShininessExponent (roughness), ReflectionFactor (metallic), EmissiveColor and TransparencyFactor, as Blender reads them A texture without material channels exports exactly as before: just the colour."},{"p":"export-presets.html","c":"Export presets","a":"your-own-presets","h":"Your own presets","t":"A preset is a JSON file. Point export_maps preset= at it: { \"label\": \"Studio packed\", \"file\": \"{name}_{map}\", \"normal\": \"directx\", \"maps\": [ {\"map\": \"albedo\", \"channels\": [\"base_color.r\", \"base_color.g\", \"base_color.b\", \"opacity?\"]}, {\"map\": \"rma\", \"channels\": [\"roughness\", \"metallic\", \"ao\"]}, {\"map\": \"nrm\", \"channels\": [\"normal.r\", \"normal.g\", \"normal.b\"]}, {\"map\": \"disp\", \"channels\": [\"height\"], \"bits\": 16, \"optional\": true} ] } file: the file name pattern; {name} is the object name, {map} the map's name (required). .png is added. normal: opengl (green up, the default) or directx (green down). maps: 1 to 32 maps. Each has a map name (letters, digits, - and _) and 1 (grey), 3 (RGB) or 4 (RGBA) channels. A channel source is a channel name (roughness, metallic, ao, height, opacity), a component (base_color.r, normal.g, emissive.b), smoothness (1 - roughness), a constant (0, 1, 0.5) or 1- in front of any of them to invert it. A ? after a source drops that component when its channel isn't on (an RGBA map becomes RGB). optional: write the map only when one of its channels is on. bits: 8 (default) or 16. A preset with a mistake is refused with a message saying what is wrong."},{"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 through files in a shared folder, 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 Part 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 Part 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 Part you added in SculptForge becomes a new object. Sending again from Blender updates the same Parts: each update is one undo step on that Part 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 Part, placed in the scene with the object's transform Faces Triangles and quads; n-gons as triangle fans Triangles and quads (Wire shows the quads) UVs The active UV map UVs Colour The active colour attribute (point or face corner) Vertex Paint Mask The sculpt mask Mask Face sets Sculpt mode face sets Face Groups Name Object name Part 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, Quad Remesh, 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":"classic-sculpting-keys-in-sculpt-mode","h":"Classic sculpting keys in Sculpt Mode","t":"Sculpting in Blender too? Turn on The Classic sculpting keys in Sculpt Mode in the add-on's preferences (Edit > Preferences > Add-ons > SculptForge Bridge) and Blender's Sculpt Mode answers to the Classic sculpting 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. Classic key In Blender's Sculpt Mode S / U / O Size / Intensity (Strength) / Falloff (Hardness), dragged at the cursor Space Blender's Sculpt quick menu at the cursor (brush, size, strength) B The brush list by name (Standard, Sharp Crease, Clay, Clay Block, Move, Tendril...): type a few letters, Enter picks Alt+drag Sub: 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 Wireframe (the wireframe overlay) F / P Frame the model / perspective on and off L Steady Stroke (Blender: Stabilize Stroke) W / E / R Move / Scale / Rotate Shift+drag Smooth (Blender already does this) brushes map to Blender's closest: Standard = Draw, Sharp Crease = Draw Sharp, Clay Block = Clay Strips, Move = Grab, Move Elastic = Elastic Grab, Plane Trim = Trim (Scrape in Blender 4.2), Crease = Crease Sharp, MaskPen = Mask. What Blender has no key for, or can't do: I (Colour 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 lasso mask (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 Part: Blender's objects aren't Parts (Alt+Q switches the object you sculpt). Stroke types (Drag Stamp, 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 Sculpt > 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 Bridge files 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 Bridge files). 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 Bridge: files, game engines and Bridge Parts: each Blender object is a Part Face Groups and visibility: Blender's face sets"},{"p":"maya.html","c":"Working with Maya","a":"","h":"Working with Maya","t":"Keep Maya for the scene, rigging and animation, and sculpt in SculptForge: the SculptForge shelf for Maya sends the selected meshes to SculptForge, and File > Maya > Send to Maya sends them back, replacing each Maya object's mesh by name. It works through files in a shared folder, on Linux, Windows and macOS. The two apps exchange files through one folder that you choose in both, and nothing else: SculptForge opens no ports or connections for this, reads and writes only inside that folder, and never runs anything it finds there. The bridge is off until you choose the folder. Live keeps the two in step by themselves, still through the folder; the opt-in Live link lets Maya follow a stroke while you draw it."},{"p":"maya.html","c":"Working with Maya","a":"install-the-shelf-in-maya","h":"Install the shelf in Maya","t":"Download sculptforge_maya.zip from the latest release and unzip it. Copy sculptforge_maya.py into your Maya scripts folder: Documents\\maya\\scripts\\ on Windows, ~/Library/Preferences/Autodesk/maya/scripts/ on macOS, ~/maya/scripts/ on Linux. In Maya open the Script Editor, and in a Python tab run import sculptforge_maya and then sculptforge_maya.install_shelf(). A SculptForge shelf appears with Send, Get, Auto, Live, Link and Folder. (Updating from an older shelf: copy the new file and run install_shelf() again.) The script uses plain maya.cmds, Maya's own OBJ exporter and, for Live, maya.api.OpenMaya (all from your own Maya: nothing of Maya's ships with SculptForge); it needs Maya 2022 or newer."},{"p":"maya.html","c":"Working with Maya","a":"choose-the-exchange-folder","h":"Choose the exchange folder","t":"In SculptForge choose File > Maya > Exchange folder... and pick a folder of your own, for example an empty Documents/SculptForge Maya. In Maya click Folder on the SculptForge shelf and pick the same folder. File > Maya shows the folder; Turn the Maya bridge off forgets it (nothing in it is deleted). While the bridge is on, the top bar has a Send to Maya button."},{"p":"maya.html","c":"Working with Maya","a":"a-round-trip","h":"A round trip","t":"In Maya select one or more meshes and click Send on the SculptForge shelf. SculptForge loads them by itself. Each mesh becomes a Part with its Maya name; a Part with that name already there is replaced (one undo step on that Part). Sculpt, paint, divide, remesh: anything SculptForge does. Click Send to Maya in the top bar (or File > Maya > Send to Maya). Every visible Part goes. Maya loads them by itself. Each object that came from Maya gets the new mesh and keeps its transform, parent and shading groups; a Part you added in SculptForge becomes a new object. The whole Get is one undo step in Maya. Both sides pick up a send by checking the other side's manifest every 250 ms (its modification time and size only), and only for sends made after the bridge started: something sent earlier waits for a manual Get. In SculptForge, File > Maya > Get automatically is on once you choose the folder; turn it off to load only with Get from Maya. In Maya, Auto on the shelf is on by default and starts with the first Send, Get or Folder click in a Maya session; click it to switch to Manual, where only Get loads."},{"p":"maya.html","c":"Working with Maya","a":"live","h":"Live","t":"With Live on, you don't click Send at all: each app sends what you change by itself, and the other loads it. In SculptForge, turn on File > Maya > Live. After each stroke (once you pause for 300 ms, never in the middle of one), the Parts that stroke, an undo or any other edit changed go to the folder. Parts you didn't touch stay put, so a big scene with one Part being sculpted sends only that Part. The files are written in the background while you keep sculpting. In Maya, click Live on the shelf (it turns Auto on too). The meshes you sent or got, and the ones selected when you turned it on, are watched; 300 ms after you stop editing one, it goes to SculptForge. Neither app sends back what it just loaded: a Get is never an edit to send, each manifest says which app session wrote it, and SculptForge skips an object that comes back exactly as it went out (no extra undo step). Live is off until you turn it on, on each side, and stays as you left it."},{"p":"maya.html","c":"Working with Maya","a":"live-link","h":"Live link","t":"The Live link goes further: Maya follows your stroke while you draw it. It's a connection between the two apps on this computer, so it is off until you turn it on, asks first every time, and is off again whenever SculptForge starts. In SculptForge choose File > Maya > Live link.... A warning explains what it opens: It opens a connection on this computer. Anything running on this computer that knows the pairing code could send meshes into SculptForge. It carries meshes only: never commands, files or scripts. Other computers and web pages can't reach it. Turn it off when you're not using it: click \"Live link on\" in the top bar. It is off again every time SculptForge starts. Click Turn on. An ember Live link on chip appears in the top bar. Choose File > Maya > Copy pairing code. In Maya click Link on the SculptForge shelf, paste, and click Link. The button says Linked, and SculptForge sends Maya every visible Part, so both start from the same mesh. Now sculpt: about ten times a second, the vertices your stroke moves appear in Maya. When a stroke changes the faces (dynamic topology, remesh, divide), the whole Part goes when the stroke ends. Edit a mesh in Maya and SculptForge gets it as soon as you pause (one undo step there). Updates that arrive in Maya over the link aren't Maya undo steps: undo in SculptForge, and Maya follows. To turn it off, click Live link on in SculptForge's top bar (or File > Maya > Turn the Live link off), or click Linked in Maya. Quitting SculptForge turns it off too. How it is kept safe: No network port. It is a Unix domain socket in a folder only you can open (Linux, macOS) or a named pipe only your Windows account can open, remote clients refused. Web pages, other people on the machine and other computers can't reach it. A pairing code (128 random bits, new each time you turn it on) must open every connection; one Maya at a time. Meshes only. Object names, vertices, faces and UVs, checked strictly on arrival (sizes, ranges, finite numbers, Maya names). Nothing that arrives is run, and it never names a file. Studios can forbid it with \"maya\": {\"link\": \"never\"} in the studio policy."},{"p":"maya.html","c":"Working with Maya","a":"what-comes-across","h":"What comes across","t":" Maya SculptForge Shape The mesh, in world space The Part, as placed in Maya's scene Faces Quads and triangles; n-gons as triangles Triangles and quads (Wire shows the quads) UVs The current UV set UVs Name The transform's name Part name Units Maya's linear unit (cm by default) Taken as they are: 1 cm in Maya is 1 unit here Face Groups, the mask and vertex paint stay in SculptForge. Normals, creases, construction history, deformers and skinning stay in Maya: Get replaces the mesh shape, so send a copy of a skinned or deformed mesh. A Part named \"Body Hi\" arrives in Maya as Body_Hi (Maya names allow letters, digits and _), and comes back to the same Part."},{"p":"maya.html","c":"Working with Maya","a":"the-exchange-folder","h":"The exchange folder","t":"<folder>/maya_to_sculptforge/manifest.json + r<revision>_<k>.obj written by Maya <folder>/sculptforge_to_maya/manifest.json + r<revision>_<k>.obj written by SculptForge Each manifest is a small JSON file: {\"format\": \"sculptforge-maya\", \"version\": 1, \"revision\": 3, \"sender\": \"maya\", \"unit\": \"cm\", \"objects\": [{\"name\": \"pCube1\", \"file\": \"r3_000.obj\"}]}. Both sides check it strictly before reading anything: at most 256 KiB and 256 objects, every field of the right type, and each file must be a plain .obj name in the manifest's own folder (no folders, no .., no absolute paths, no links). Each send removes the files of the previous one; anything else in the folder is left alone. The commands are maya_send folder= and maya_receive folder= (see Scripting and automation)."},{"p":"maya.html","c":"Working with Maya","a":"troubleshooting","h":"Troubleshooting","t":"\"Nothing has been sent from Maya yet\": check that both apps use the same folder (open File > Maya in SculptForge; click Folder in Maya to see or change it). Get in Maya says nothing has been sent: choose File > Maya > Send to Maya in SculptForge first. Maya doesn't load a send by itself: Auto starts with the first click on the shelf in a Maya session; click Get once (or Send), and check that the button says Auto, not Manual. Live doesn't send from Maya: Live watches the meshes you sent or got and the ones selected when you turned it on; send a new mesh once with Send, and it is watched from then on. Link says SculptForge refused the pairing code: the code is new each time the Live link is turned on; copy it again (File > Maya > Copy pairing code). Link says SculptForge isn't offering it: turn on File > Maya > Live link... in SculptForge first (it is off at every start). A mesh came in as a new object instead of replacing one: Get matches the transform's name; renaming the object in Maya or the Part's Maya name breaks the link."},{"p":"projects.html","c":"Projects, autosave and snapshots","a":"","h":"Projects, autosave and snapshots","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, snapshots, and the Library tabs that show your work."},{"p":"projects.html","c":"Projects, autosave and snapshots","a":"what-a-project-keeps","h":"What a project keeps","t":"A .sfproj file holds everything SculptForge knows about the scene: every Part, with its name, visibility, mesh, mask, vertex paint, face groups, hidden faces and UVs; every sculpt layer with its weight, and the active layer of each Part; each Part's Quad Remesh Guides, the curves Quad Remesh'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, Size, Intensity (and Smooth's), Colour intensity, Falloff, paint colour and symmetry; a thumbnail, shown in the Library. 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."},{"p":"projects.html","c":"Projects, autosave and snapshots","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. In the Classic layout, clicking the document name in the title strip also saves. The bar along the top shows the file name with * after it while there are unsaved changes, and so does the window title, which starts with the file name. Any edit in any Part counts, as do splat edits and layer weight changes. The window title and the top bar also show the SculptForge version, so a screenshot says which one you run. 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 snapshots","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 Library, 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 snapshots","a":"start-from-a-starter-mesh","h":"Start from a starter mesh","t":"Instead of a sphere, start from a base mesh with clean, even quads: File > New from Starter Mesh lists them, the Library's Tool tab has a Starter meshes folder with a thumbnail of each, and the welcome's Start from a head opens the human head straight away. Starter mesh What it is Human Head A neutral head and neck with loops round the eyes and mouth, for portraits Bust Head, neck, shoulders and upper chest Full Body A human figure in A-pose, 167 cm tall Hand, Foot, Ear A left hand (raised, palm to the front), a left foot and ankle, a left ear Eye An eyeball 24 mm across, with the cornea and rings of quads round the pupil Stylised Head A cartoon head: big cranium and eyes, small nose and jaw Creature Head A dragon or creature blockout: skull, jaw and two horns, each its own Part Torso A human torso from the neck to the upper thighs Rounded Box, Cylinder, Capsule, Ring Hard-surface primitives with bevelled edges and quad caps Every starter mesh is life size in centimetres, centred, standing on the ground and looking down +Z, and the symmetric ones are exactly symmetric, so X symmetry works from the first stroke. The Hand, Foot, Ear, Head, Bust and Torso are cut from a body, so they have open edges where they were cut. A starter mesh opens with subdivision levels (two, or one for the Full Body): block out the big forms at SDiv 1, the base cage, and step up for the detail (see Geometry). It opens as a new, unsaved scene: Save asks for a name. Double-click a tile to open it; Shift+double-click appends its base cage as a Part, for example an Eye next to a head. The human meshes come from the MakeHuman base mesh, which MakeHuman released into the public domain (CC0); the others are made by SculptForge's own build script. You may use them for anything, including commercial work."},{"p":"projects.html","c":"Projects, autosave and snapshots","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 snapshots","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 Edit > 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 Library Snapshots 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 snapshots","a":"snapshots","h":"Snapshots","t":"File > Save Snapshot (also the Snapshot button in the Classic layout's title strip) saves a timestamped copy of the whole scene (experienced sculptors: QuickSave). Your project file, its name and its unsaved state are not changed, so a snapshot is safe to take before any risky step. Copies go to the QuickSave folder of your library (by default Documents/SculptForge/QuickSave), named like Snapshot 2026-10-21 23-15-04.sfproj (older QuickSave ... files are listed too). The last 10 snapshots are kept; older ones are deleted. They appear in the Library Snapshots tab, newest first, labelled with their date and time. Double-click one to open it. The tab also has a Save now button. With the Classic sculpting keys (Edit > Preferences > Input) 9 takes a snapshot; otherwise it has no default shortcut. To give it one, hold Ctrl+Alt, click the Snapshot button and press a key (see The interface)."},{"p":"projects.html","c":"Projects, autosave and snapshots","a":"your-library-folder-and-the-library","h":"Your library folder and the Library","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 Library tab What goes there Projects Project Your .sfproj files Tools Tool Models to open or append as Parts Brushes Brush .sfbrush files Alphas Alpha Grayscale images for brush alphas LitSpheres Material Lit Sphere images, loaded as materials at start-up Images Image Sketches and concept art for Generate 3D Splats Splats Gaussian splat captures QuickSave Snapshots Snapshots Change it in Edit > Preferences > Library > Library folder; the setting saves itself. Press , (comma) to show the Library. 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. Snapshots: the autosave (when there is one) and your snapshots, 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 Part instead. The Library showing project thumbnails"},{"p":"projects.html","c":"Projects, autosave and snapshots","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 new_starter_mesh name=human-head Start from a starter mesh (levels=0 for the bare base cage) 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 snapshots","a":"see-also","h":"See also","t":"The interface: Library, shortcuts and saving the layout Parts 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 connecting AI tools."},{"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 File > 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 File > Script): 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 at the top right of the window) 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, Bridge files 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_vertexpaint, symmetry, keep_original Parts project_all distance (default 0.02), mean, blur, geometry, vertexpaint, source Geometry mesh_info Sculpting stroke points (required), brush, radius, strength, invert, symmetry, radial, radial_axis, local 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 Face Groups facegroup_auto_by_normals angle (default 30) Visibility isolate_facegroup, hide_facegroup group (required) Visibility show_all, delete_hidden Transform transform translate, rotate, scale, pivot, orient, masked, falloff, symmetry, all (Gizmo) Parts part_append type (sphere, cube, plane) or path, name, size Parts part_select index or name Vertex Paint set_color, paint_fill color, area (unmasked, masked, all) Vertex Paint 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 Lit Sphere 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, --facegroups Render with the wireframe or face group 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.parts) # [{'name': ..., 'visible': ..., 'triangles': ...}] doc.active_part = \"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 Part (copies) doc.mask, doc.colors, doc.facegroups, 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.parts, doc.active_part The Parts list and the active Part 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":"An AI tool (Claude Code, Claude Desktop, Cursor and others) can work in the SculptForge window while you watch. The AI blocks out a starting point and shows you options; you do the art. Help > Connect an AI tool... is the guide in the app, on one screen; it is there while AI features are on (Edit > Preferences > AI). It says what this section says, in the same words."},{"p":"scripting.html","c":"Scripting and automation","a":"connect-an-ai-tool","h":"Connect an AI tool","t":"1. Pick your tool. The window shows the exact command or settings for your install, with Copy. SculptForge is listed as sculptforge-live and started as sculptforge-cli --mcp --attach, so it sits beside a sculptforge entry you may already have (the headless server, below). Claude Code, in a terminal: claude mcp add --scope user sculptforge-live -- /path/to/sculptforge-cli --mcp --attach Claude Desktop: add this to its configuration file (Settings > Developer > Edit Config), then restart Claude Desktop: { \"mcpServers\": { \"sculptforge-live\": { \"command\": \"/path/to/sculptforge-cli\", \"args\": [\"--mcp\", \"--attach\"] } } } Cursor takes the same entry in ~/.cursor/mcp.json. For every other tool, use its setup from the table in Every other tool with the name sculptforge-live and the arguments --mcp --attach; the window writes it out for you. Where sculptforge-cli is on your system: Where sculptforge-cli is. 2. Let it work in this window. Turn on Let AI tools control this window, right there in the window's step 2 (the same switch as in Edit > Preferences > AI). It is off by default, and gone while AI features are off. 3. What happens next. Ask your AI tool for something (examples below). SculptForge shows Let an AI tool control this window? with a 6-digit code: click Approve, or tell the AI the code. Approval lasts until it disconnects. While it works, the AI connected badge sits at the bottom right. Disconnect stops it (also in the command palette: Disconnect AI tool; turning the switch or AI features off disconnects it too). Every step lands in Undo as AI: ..., so you can step back. It asks you first (Allow this AI step?) before files outside the project, scripts and the network: reading or writing files outside the project folder and the files you picked, overwriting a file, saving over the project, deleting library files, running a macro or script, and anything that uses the network (Generate 3D, AI Brush, the brush gallery). Deny and it is told not to retry. Installing or switching packs and the AI switch itself are never offered. It sees the viewport; what it sees goes to that tool's AI service. viewport_image returns the viewport as you see it, view_turntable the model from 4 to 8 sides in one picture, view_set turns and frames your camera, and stroke_screen draws a brush stroke in screen space. With blockout (a Forge Sphere armature in one call), measure and scene_overview it can look, think and correct. Try asking: \"Block out a creature head with horns for me to sculpt.\" \"Look at my model from all sides and tell me what to fix.\" \"Make three rock variations I can refine.\" \"Teach me: walk me through sculpting an ear, step by step.\" The recipes your AI tool lists as prompts (creature head, stylised bust, game-ready, rock variations, teach me) work here too. How it is kept safe: the connection is a Unix socket (owner-only, in your runtime folder) or, on Windows, a named pipe only your user account can open; there is no network port. Only one AI tool can be connected at a time, requests are rate limited, and what the tool sends is data: tool names and values, never code to run."},{"p":"scripting.html","c":"Scripting and automation","a":"without-a-window-the-headless-server","h":"Without a window: the headless server","t":"sculptforge-cli --mcp runs SculptForge as an MCP server with a scene of its own, no window needed: for batch jobs and your own agents. The AI tool gets every command as a tool and works on that scene for the session: it can open files, generate models, sculpt strokes, remesh, paint and export. It starts sculptforge-cli on your computer and talks to it over standard input and output. Nothing listens on the network, and nothing is installed into the AI tool. The setups below use the name sculptforge and --mcp; the Claude Desktop bundle is this server too."},{"p":"scripting.html","c":"Scripting and automation","a":"i-have-a-subscription","h":"I have a subscription","t":"Subscription Use Set up Claude (Pro, Max, Ultra) Claude Desktop or Claude Code Claude Desktop: install the bundle (below). Claude Code: claude mcp add --scope user sculptforge -- /path/to/sculptforge-cli --mcp ChatGPT (Plus, Pro, Business, Edu, Enterprise) Codex CLI codex mcp add sculptforge -- /path/to/sculptforge-cli --mcp, then Sign in with ChatGPT Google (free, Google AI Pro, Google AI Ultra) Antigravity CLI add SculptForge to ~/.gemini/config/mcp_config.json (below), then sign in with Google Grok / xAI Grok Build grok mcp add sculptforge -- /path/to/sculptforge-cli --mcp Claude: Claude Code uses your plan when you sign in with your Claude account; if ANTHROPIC_API_KEY is set it uses that key and API billing instead. Claude on the web and on phones can't start programs on your computer. ChatGPT: the ChatGPT app only connects to remote (HTTPS) MCP servers. SculptForge doesn't run one, on purpose: nothing of yours listens on the network. Use Codex CLI, or the OpenAI Agents SDK or API below. Gemini: since June 2026 personal Google accounts use Antigravity CLI; Gemini CLI is for Gemini Code Assist Standard and Enterprise and for API keys. Grok: the Grok app (web, phone, X) can't reach programs on your computer, only public HTTPS servers. Grok Build signs in with your xAI account in the browser (xAI's documentation doesn't say which plans that includes) or takes an xAI API key. The xAI API's own MCP tool is remote-only too; your own code can use the function calling example below (API usage is billed by xAI)."},{"p":"scripting.html","c":"Scripting and automation","a":"where-sculptforge-cli-is","h":"Where sculptforge-cli is","t":"Install Command Windows C:\\Program Files\\SculptForge\\bin\\sculptforge-cli.exe --mcp macOS /Applications/SculptForge.app/Contents/MacOS/sculptforge-cli --mcp Linux .deb, .rpm, AUR /usr/bin/sculptforge-cli --mcp AppImage /path/to/SculptForge.AppImage --cli --mcp (--cli runs the CLI inside the AppImage) Flatpak flatpak run --command=sculptforge-cli org.sculptforge.SculptForge --mcp In JSON and TOML files a Windows path is written with doubled backslashes (\"C:\\\\Program Files\\\\SculptForge\\\\bin\\\\sculptforge-cli.exe\"). The window does that for you."},{"p":"scripting.html","c":"Scripting and automation","a":"claude-desktop-bundle","h":"Claude Desktop bundle","t":"Download the bundle for your system, then install it in Claude Desktop under Settings > Extensions > Advanced settings (Anthropic's guide): Windows, macOS, Linux x86_64, Linux ARM64. It carries its own copy of sculptforge-cli. Or add SculptForge to claude_desktop_config.json (Windows %APPDATA%\\Claude\\, macOS ~/Library/Application Support/Claude/, Linux ~/.config/Claude/) and restart: { \"mcpServers\": { \"sculptforge\": { \"command\": \"/path/to/sculptforge-cli\", \"args\": [\"--mcp\"] } } }"},{"p":"scripting.html","c":"Scripting and automation","a":"every-other-tool","h":"Every other tool","t":"Most tools take the same mcpServers entry as Claude Desktop above. Each row links the vendor's page the format is from. Tool Set up Cursor the mcpServers entry in ~/.cursor/mcp.json (or .cursor/mcp.json in a project) VS Code (Copilot agent mode) code --add-mcp '{\"name\":\"sculptforge\",\"type\":\"stdio\",\"command\":\"/path/to/sculptforge-cli\",\"args\":[\"--mcp\"]}', or MCP: Open User Configuration and add \"servers\": {\"sculptforge\": {\"type\": \"stdio\", \"command\": \"...\", \"args\": [\"--mcp\"]}} Visual Studio the same servers entry in %USERPROFILE%\\.mcp.json; Copilot Chat in Agent mode JetBrains AI Assistant Settings > Tools > AI Assistant > Model Context Protocol (MCP): Add, STDIO, paste the mcpServers entry Zed in its settings file (zed: open settings file): \"context_servers\": {\"sculptforge\": {\"command\": \"...\", \"args\": [\"--mcp\"]}} Windsurf (Devin Local) devin mcp add -s user sculptforge -- /path/to/sculptforge-cli --mcp, or the mcpServers entry in ~/.config/devin/mcp_config.json (Windows %APPDATA%\\devin\\) Gemini CLI gemini mcp add --scope user sculptforge /path/to/sculptforge-cli --mcp Antigravity CLI the mcpServers entry in ~/.gemini/config/mcp_config.json Codex CLI codex mcp add ... as above, or in ~/.codex/config.toml: [mcp_servers.sculptforge], command = \"/path/to/sculptforge-cli\", args = [\"--mcp\"] Grok Build grok mcp add ... as above, or the same TOML table in ~/.grok/config.toml GitHub Copilot CLI copilot mcp add sculptforge -- /path/to/sculptforge-cli --mcp Cline cline mcp add sculptforge --yes -- /path/to/sculptforge-cli --mcp, or the mcpServers entry under MCP Servers > Configure Continue a file in .continue/mcpServers/ with mcpServers: - name: SculptForge, type: stdio, command: ..., args: [\"--mcp\"] (agent mode) Kiro the mcpServers entry in ~/.kiro/settings/mcp.json Amazon Q Developer CLI q mcp add --name sculptforge --command /path/to/sculptforge-cli --args '[\"--mcp\"]' Warp Settings > Agents > MCP servers > Add, paste the mcpServers entry Goose goose configure > Add Extension > Command-Line Extension, or in ~/.config/goose/config.yaml under extensions: an entry with type: stdio, cmd: ..., args: [\"--mcp\"] opencode in opencode.json: \"mcp\": {\"sculptforge\": {\"type\": \"local\", \"command\": [\"/path/to/sculptforge-cli\", \"--mcp\"]}} Rovo Dev CLI the mcpServers entry plus \"transport\": \"stdio\" in ~/.rovodev/mcp.json (acli rovodev mcp opens it) LM Studio Program tab > Install > Edit mcp.json, paste the mcpServers entry Jan Settings > MCP Servers > +: command /path/to/sculptforge-cli, arguments --mcp Remote only, so not for SculptForge: the ChatGPT app, the Grok app, and Rovo in Atlassian's web apps (public HTTPS servers added by an admin; use Rovo Dev CLI). The OpenAI and xAI APIs' built-in MCP tools also reach only remote servers: use the Agents SDK or plain function calling below."},{"p":"scripting.html","c":"Scripting and automation","a":"using-it","h":"Using it","t":"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 headless server works on its own scene; to see the result, open the exported file in SculptForge (or use live mode, above, to watch it work). viewport_image gives the agent a picture of the scene (a clay-shaded view of the visible Parts, any angle) to check each step by eye. Every tool call is one undo step, so the agent can take back what went wrong. Recipes: the server offers ready-made prompts that walk an agent through a whole job. In Claude Desktop and other tools that show MCP prompts, pick one from the prompt menu: a creature head from a description, a stylised bust from a reference image, a game-ready asset (retopology, UVs, baked maps and LODs for Unreal or Godot), rock variations, and a step-by-step lesson."},{"p":"scripting.html","c":"Scripting and automation","a":"your-own-agent","h":"Your own agent","t":"The OpenAI Agents SDK starts the server itself: import asyncio from agents import Agent, Runner from agents.mcp import MCPServerStdio async def main(): async with MCPServerStdio(name=\"SculptForge\", client_session_timeout_seconds=60, params={\"command\": \"/path/to/sculptforge-cli\", \"args\": [\"--mcp\"]}) as sf: agent = Agent(name=\"Sculptor\", instructions=\"Use SculptForge's tools.\", mcp_servers=[sf]) print((await Runner.run(agent, \"Make a sphere, remesh it at 128 and export ball.glb\")).final_output) asyncio.run(main()) For plain function calling with any model API, sculptforge-cli --schema prints every tool as JSON (name, description, input_schema: the Claude API takes it as it is). APIs limit how many tools one request may carry, so pick the ones the job needs. This helper turns them into function definitions and runs each call in one SculptForge session (through --mcp, so the scene is kept between calls): # sf_tools.py import json, subprocess CLI = \"/path/to/sculptforge-cli\" WANTED = {\"new_sphere\", \"remesh\", \"subdivide\", \"stroke\", \"decimate\", \"mesh_info\", \"export_glb\", \"undo\"} TOOLS = [{\"type\": \"function\", \"name\": t[\"name\"], \"description\": t[\"description\"], \"parameters\": t[\"input_schema\"]} for t in json.loads(subprocess.run([CLI, \"--schema\"], capture_output=True, text=True).stdout) if t[\"name\"] in WANTED] _sf = subprocess.Popen([CLI, \"--mcp\"], stdin=subprocess.PIPE, stdout=subprocess.PIPE, text=True) def call(name, arguments): _sf.stdin.write(json.dumps({\"jsonrpc\": \"2.0\", \"id\": 1, \"method\": \"tools/call\", \"params\": {\"name\": name, \"arguments\": arguments}}) + \"\\n\") _sf.stdin.flush() return json.loads(_sf.stdout.readline())[\"result\"][\"content\"][0][\"text\"] OpenAI API (Responses API). For the xAI API use the same code with OpenAI(api_key=os.environ[\"XAI_API_KEY\"], base_url=\"https://api.x.ai/v1\") and a Grok model: import json from openai import OpenAI from sf_tools import TOOLS, call client = OpenAI() items = [{\"role\": \"user\", \"content\": \"Make a sphere, remesh it at 128 and export it to ball.glb\"}] while True: r = client.responses.create(model=\"gpt-6-astra\", tools=TOOLS, input=items) items += r.output calls = [i for i in r.output if i.type == \"function_call\"] if not calls: break items += [{\"type\": \"function_call_output\", \"call_id\": c.call_id, \"output\": call(c.name, json.loads(c.arguments))} for c in calls] print(r.output_text) Gemini API (the google-genai package): from google import genai from sf_tools import TOOLS, call client = genai.Client() interaction = client.interactions.create(model=\"gemini-3.8-flash\", tools=TOOLS, input=\"Make a sphere, remesh it at 128 and export it to ball.glb\") for step in interaction.steps: if step.type == \"function_call\": print(step.name, call(step.name, step.arguments)) # Send each result back as Google's guide shows to let the model continue. Never point a tool at a web app's session or cookies: use each vendor's own app, CLI or API as above."},{"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":"packs-and-macros.html","c":"Packs and macros","a":"","h":"Packs and macros","t":"A pack is one file (.sfpack) that brings brushes, alphas, Lit Spheres, Material Recipes, VDM brushes, keymaps, pie menus and macros at once. A macro is a list of SculptForge commands you can run with one click, one key or one pie-menu slot. Both are plain data: SculptForge never runs code from a pack or a macro."},{"p":"packs-and-macros.html","c":"Packs and macros","a":"install-a-pack","h":"Install a pack","t":"Use File > Install Pack..., drop a .sfpack file on the window, or click Install Pack... in Library > Packs. Nothing is installed yet: a review shows exactly what is inside first. The review shows Name, version and author As the pack's maker wrote them. Member pack marks a members' pack (Member Requests). License The license name, and the license text from the pack on the right. Contains How many brushes, alphas, Lit Spheres, Material Recipes, VDMs, keymaps, pie menus and macros, with every item listed by name. Replaces the installed version When an older version of the same pack is installed. Click Install to add it, or Cancel to leave everything as it was. When a pack fails a check, the review says which file and why (for example \"../evil.sfbrush\" leaves its folder), and nothing is installed. Installed packs live in SculptForge's own data folder, each in its own folder. A pack never replaces a built-in brush or one of your own: a pack brush called like an existing one shows the pack's name after its own, for example Clay (Member pack)."},{"p":"packs-and-macros.html","c":"Packs and macros","a":"where-pack-items-show-up","h":"Where pack items show up","t":"Item Where Brushes and VDMs The brush lists, the Brush picker and Library > Brush, tagged with the pack's name. Alphas The Alpha picker (a Packs section) and Library > Alpha, as Name (Pack). Lit Spheres Render > Materials and Library > Material, as Name (Pack). Material Recipes The Material Recipe list under Tool > Paint Layers > Fill, as Name (Pack). Keymaps Library > Packs > Details > Apply keymap, and Edit > Preferences > Input > Pack keymaps. Pie menus Library > Packs > Details > Add pie menu (it becomes one of your radial menus). Macros F3, the key editor and the pie menus, as Name (Pack). Keymaps and pie menus change how SculptForge responds, so they are only applied when you click Apply keymap or Add pie menu. The result saves itself."},{"p":"packs-and-macros.html","c":"Packs and macros","a":"library--packs","h":"Library > Packs","t":"Open the Library (,) and click Packs. Each installed pack has a row: The check box turns the pack off or on. Off, its items leave every list; nothing is deleted. Details shows its description, folder, keymaps, pie menus and macros. Remove deletes the pack and everything it brought. Your own files are never touched. Start SculptForge with --no-packs to leave every pack out for one session (safe mode), for example to check whether a problem comes from a pack. sculptforge-cli --no-packs does the same for scripts."},{"p":"packs-and-macros.html","c":"Packs and macros","a":"make-a-pack","h":"Make a pack","t":"Library > Packs > New Pack... lists what you made yourself: brushes in your library, images in your Library's Alphas and Lit Spheres folders, the active Part's Fill layers as a Material Recipe, your VDMs, your pie menus, your changed shortcuts (as a keymap) and your macros. Tick what goes in, fill in the name, author, license and description, and click Save Pack.... The file is checked exactly as an install would check it before it is written. Tick Member pack (insider channel) for a members' pack (Member Requests). It only changes the label shown in the review and the pack list; anyone can install the file. To build a pack from a folder in a script, lay the folder out like a pack (brushes/, alphas/, litspheres/, materials/, vdms/, keymaps/, piemenus/, macros/, plus LICENSE.txt and preview.png) and run: sculptforge-cli -c 'pack_create folder=MyPack path=MyPack.sfpack id=my-pack name=\"My Pack\" author=Me license=CC-BY-4.0' The file format is described in the pack format."},{"p":"packs-and-macros.html","c":"Packs and macros","a":"record-a-macro","h":"Record a macro","t":"In Library > Packs, click Record Macro. A red Recording macro note shows at the top of the window. Work as usual: every command you run from a menu, a button, the console or a script line is kept. Click Stop Recording. The Macro Editor opens with the commands; give the macro a name and click Save. Commands a macro may not run (see below) are left out, and the status line says how many. A file inside the project folder is kept as a path relative to it; any other file becomes ?, which asks for a file when the macro runs."},{"p":"packs-and-macros.html","c":"Packs and macros","a":"write-or-change-a-macro","h":"Write or change a macro","t":"Macro Editor (in Library > Packs, or F3) is a plain text editor. A macro is the command language of the console and sculptforge-cli, one command per line, # for comments: # name: Clean Up Scan # description: Remesh, smooth and export a GLB next to the project remesh resolution=256 mask_clear export_glb path=exports/clean.glb The line under the text checks it as you type: every command must exist, be allowed in a macro and have the values it needs. Save writes it to your macros folder; Run runs it."},{"p":"packs-and-macros.html","c":"Packs and macros","a":"run-a-macro","h":"Run a macro","t":"Every saved macro (yours and those of enabled packs) is an action: F3: type its name and press Enter. Edit > Preferences > Hotkeys: find it with the filter and give it a key, like any other action (see Assign shortcuts). Edit > Preferences > Input > Radial Menus: put it in a pie menu slot. Library > Packs: Run next to your macros, or in a pack's Details. The first time a macro runs, SculptForge shows its whole command list and asks. Click Run to go on; you are not asked again for that macro unless its text changes. A macro's edits on one Part are one undo step (Ctrl+Z takes back the whole macro)."},{"p":"packs-and-macros.html","c":"Packs and macros","a":"what-a-macro-can-do","h":"What a macro can do","t":"A macro only runs SculptForge's own commands, in order. It can't run programs or scripts, and it can't: reach the network (AI services, the brush gallery, Unreal, the phone link) or send to Blender, Maya or the Bridge; install, remove or switch packs, or run another macro; name a file outside the project folder. File values are either a path inside the folder of the saved project (exports/clean.glb) or ?, which opens a file dialog when the macro runs. Absolute paths, .., ~ and drive letters are refused. Save the project first when a macro uses relative paths: they are relative to the project's folder."},{"p":"packs-and-macros.html","c":"Packs and macros","a":"scripts-and-python","h":"Scripts and Python","t":"The same rules apply outside the app: Command What it does pack_install path=Pack.sfpack Checks and installs a pack (the app shows the review first). pack_list Lists the installed packs: id, name, version, author, license, contents, on or off. pack_remove id=my-pack Removes a pack. pack_enable id=... / pack_disable id=... Turns a pack on or off. pack_create folder=... path=... Makes a pack from a folder laid out like one. macro_run name=... or path=... Runs a macro (project= sets the folder its relative paths use). macro_list / macro_check Lists the macros, or checks one without running it. In Python, sculptforge.run(doc, \"pack_install\", path=\"Pack.sfpack\") and the other commands work the same way. A command you type into sculptforge-cli or Python is your own explicit request, so it runs without the confirmation the app shows. AI agents connected through sculptforge-cli --mcp can't install, remove or switch packs."},{"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, licensing and IT deployment (a managed policy, the AI audit log, single sign-on, AI gateways and air-gapped use)."},{"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 SF_AI off: every AI feature off and locked (app, sculptforge-cli, MCP, Python); on: on whatever was saved. --no-ai does the same as off for one start SF_STUDIO_PROFILE A studio profile (studio.json) to start in studio mode with, like --studio (see Your studio build) SF_OFFLINE 1: studio mode with nothing allowed, like --offline SF_POLICY A policy file, when there is no system-wide one (see The policy file) SF_KEYCHAIN none: don't use the OS keychain (render nodes, CI); keys last for the session or come from the environment 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, OPENROUTER_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 (keys saved in the app live in the OS keychain), so a launcher can supply them without storing them for each artist."},{"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 Parts, groups as face groups, vertex colours, textures through .mtl PLY Yes Yes Meshes with vertex colours, Gaussian splats STL Yes (binary and ASCII) Yes (binary) Bridge Yes Yes Face Groups, mask, vertex paint, 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":"studio-membership","h":"Studio membership","t":"SculptForge is free for any number of artists, and nothing in the app is ever paywalled. A Studio membership is a flat $300 a month for the whole studio, any number of artists. The first 10 studios become Founding Studios at a flat $150 a month, locked for as long as they stay subscribed. Each artist gets everything in Member, and the studio gets: Its own build with its brushes, alphas, Lit Spheres, keymaps, macros, preferences, paths and logo built in. Isolation: a private release channel, and no outside connections by default (see Offline deployment). A pinned version: you choose when to move. Security fixes are backported to the current release and one long-term support (LTS) line, and your studio is always on one of those two. An offline signed installer with checksums for IT. Support: a first response within 2 business days (a response, not a fix), up to 3 custom items a month (bigger features are quoted separately), your requests first on the roadmap, and a private Discord channel. Every release stays free for everyone; bug-fix and security releases go out to everyone the same day. Join at sculptforge.app/studios.html or ask on the SculptForge Discord. What stays private, and what doesn't. SculptForge is GPL-3.0, and so is your studio build: its source comes with it and is yours to share. There are no exclusive or secret features. What stays private is yours: the brushes, alphas, settings and files you send are never put in public builds or packs, and your build never reaches out of your network."},{"p":"studios.html","c":"SculptForge for studios","a":"your-studio-build","h":"Your studio build","t":"Your build is SculptForge with a studio profile baked in: one studio.json and a folder beside it. { \"format\": \"sculptforge-studio\", \"version\": 1, \"id\": \"acme\", \"name\": \"Acme Animation\", \"updates\": {\"feed\": \"https://sw.acme.internal/sculptforge/latest.json\", \"mirror\": \"/mnt/sw/sculptforge/latest.json\"}, \"allow\": [], \"localNetwork\": false, \"ai\": false, \"packs\": [\"packs/acme.sfpack\"], \"brushPaths\": [\"/studio/brushes\"], \"preferences\": \"ui.json\", \"branding\": {\"logo\": \"logo.png\", \"title\": \"Acme\"} } Key What it does updates.feed, updates.mirror Where the build looks for updates: your private channel, then your mirror (a URL or a file on a share) allow More URLs the build may reach, such as your own ComfyUI server (empty by default) localNetwork true lets the Unreal link and phone capture use your studio network ai true keeps the AI features; they can still reach only the URLs above packs Your brushes, alphas, Lit Spheres, keymaps and macros as .sfpack files, installed at first start brushPaths Read-only brush shares, as SCULPTFORGE_BRUSH_PATH preferences The first-start interface settings: layout, shortcuts and UI scale (Edit > Preferences > Interface exports them) branding Your logo in Help > About and a word in the title bar Paths are relative to the profile's folder, and the profile is data only: nothing in it runs. An unknown key is an error, so a typo never quietly drops a setting. To request your build, send in one email or a message in your team channel: What to bake in: your exported keymap and layout, brush presets and packs (.sfbrush, .sfpack), and the pipeline defaults you want. References for custom content: images or scans you own, with a line on what each item should do. Where it runs: platforms and, for Linux, the distribution or VFX Reference Platform year. Where updates come from: your channel or mirror URL, or a folder on a share. Who gets access: the GitHub usernames for your private release channel. Files are treated as data only: scripts and executables you send are never run. Your build is made by the same pipeline and tests as public builds and published in your private channel, signed, with its checksums and source. To try a profile on a public build first, start it with sculptforge --studio /path/to/studio.json (or set SF_STUDIO_PROFILE); sculptforge-cli and the Python module take the same profile."},{"p":"studios.html","c":"SculptForge for studios","a":"offline-deployment","h":"Offline deployment","t":"A studio build is in studio mode, whatever happens to its files: No outside connections. No update check against the public website, no AI services, no community brush gallery, no Discord presence; SculptForge has no telemetry. Every request goes through one gate that allows only your update channel, your mirror and your allow list, refuses everything else before it is sent, and never follows a redirect. Network sockets open only on this computer (loopback) unless localNetwork is true. Fails closed. If the profile is missing or broken, a studio build still starts offline, with nothing allowed. Updates on your schedule. The build reads its feed only from your channel or mirror. Copy a new release's latest.json to the mirror when you're ready to move; until then nobody is offered it. To install on machines without internet access: Download the release from your private channel: the installer or archive for each platform, SHA256SUMS.txt and SHA256SUMS.txt.sig. Check the files: sha256sum -c SHA256SUMS.txt --ignore-missing (Windows: Get-FileHash -Algorithm SHA256), and the signature with the public key we send you: openssl pkeyutl -verify -pubin -inkey sculptforge-release.pem -rawin -in SHA256SUMS.txt -sigfile SHA256SUMS.txt.sig. Deploy as usual: the Windows installer or portable zip, the .rpm/.deb, the tar.gz or the Rez package. To test studio mode on any machine, sculptforge --offline turns it on with nothing allowed; SF_OFFLINE=1 does the same for the CLI and Python."},{"p":"studios.html","c":"SculptForge for studios","a":"it-deployment","h":"IT deployment","t":"Everything an IT team needs to roll SculptForge out under its own rules: a policy file that locks settings, an audit log of what AI did, the studio's own AI gateway and single sign-on, and offline use. Nothing here needs a studio build; it works on the public one. For a security review, see the security overview."},{"p":"studios.html","c":"SculptForge for studios","a":"the-policy-file","h":"The policy file","t":"Put a policy.json where only administrators can write it: OS Path Linux /etc/sculptforge/policy.json macOS /Library/Application Support/SculptForge/policy.json Windows C:\\ProgramData\\SculptForge\\policy.json (deploy it with Group Policy, Intune, SCCM or your usual tool) SculptForge reads it at every start (the app, sculptforge-cli, MCP and the Python module). Each setting it locks is greyed out in Edit > Preferences with Managed by your studio next to it. Without a system file, SF_POLICY=/path/policy.json names one, for testing a policy or setting it from a launcher or a Rez package; while the system file exists, SF_POLICY is ignored, so an artist can't loosen it. { \"format\": \"sculptforge-policy\", \"version\": 1, \"organization\": \"Acme Animation\", \"ai\": {\"enabled\": true, \"providers\": [\"litellm\", \"comfyui\"], \"endpoints\": [\"https://llm.acme.internal/\", \"http://comfy.acme.internal:8188/\"], \"requireSignIn\": true}, \"network\": {\"enabled\": false, \"allow\": [\"https://sw.acme.internal/\"], \"localNetwork\": false}, \"mcp\": {\"enabled\": true, \"live\": \"never\", \"categories\": [\"info\", \"edit\", \"files\"]}, \"maya\": {\"link\": \"never\"}, \"audit\": {\"path\": \"//fs01/audit/sculptforge/{user}@{host}.jsonl\", \"maxMB\": 20, \"keep\": 10, \"required\": true}, \"signIn\": {\"issuer\": \"https://acme.okta.com/oauth2/default\", \"clientId\": \"0oa1example\", \"useFor\": [\"https://llm.acme.internal/\"]}, \"telemetry\": \"none\", \"updates\": {\"check\": true, \"channel\": \"stable\", \"feed\": \"https://sw.acme.internal/sculptforge/latest.json\"} } Every key is optional: what the policy leaves out stays the artist's choice. An unknown key or a wrong value is an error, so a typo never quietly drops a lock, and a broken or unreadable policy fails closed: AI, network features and AI tools stay off until it is fixed. sculptforge-cli --policy shows what the policy manages (exit code 2 when it is broken); use it to check a file before you deploy it. Key What it does organization Shown as \"Managed by Acme Animation\" ai.enabled false: every AI feature off and locked (as SF_AI=off). true: on and locked. Left out: the artist's choice ai.providers The only AI providers artists can pick: free, anthropic, openai, ollama, lmstudio, vllm, llamacpp, litellm, openrouter, openai-compatible (Brush Lab) and huggingface, fal, meshy, comfyui, command (Generate 3D) ai.endpoints The only addresses AI requests may go to (URL prefixes, matched at a /) ai.requireSignIn AI works only while the artist is signed in with the studio account (needs signIn) network.enabled false: studio mode (see Offline deployment): no outside connection except network.allow, ai.endpoints, the identity provider and your update feed network.allow More URL prefixes that stay reachable while the network is off network.localNetwork true: the Unreal link and phone capture may use the studio network while the network is off mcp.enabled false: no AI tool can connect (sculptforge-cli --mcp refuses to start, and Help > Connect an AI tool is gone) mcp.live \"never\": AI tools work only on their own scene and can never control an open SculptForge window (the window never listens for them; Let AI tools control this window is locked off) maya.link \"never\": the Maya Live link can't be turned on (the window never listens for Maya; the folder bridge still works) mcp.categories The kinds of command AI tools may use: info (read the scene), edit (change it in memory), files (open, save, export, bridges), scripts (macros), network (brush gallery, Unreal), ai (AI generation). Left out: all audit.path, audit.maxMB, audit.keep Where the audit log goes, when it rotates (10 MB) and how many old files it keeps (5) audit.required true: an AI action whose audit line can't be written (the share is down) is refused signIn.issuer, signIn.clientId Your identity provider and the app registration (see Single sign-on) signIn.clientSecret Only for providers that issue one to installed apps and require it (Google); it isn't secret there, and artists can read the policy signIn.scopes, signIn"},{"p":"studios.html","c":"SculptForge for studios","a":"audit-log","h":"Audit log","t":"Every AI action is one line of JSON in a local file: each command an AI tool (MCP) runs, refused ones included (\"tool\": \"mcp\", or \"mcp-live\" when it controls an open window), and every Brush Lab and Generate 3D request (\"ai\"), from the app, sculptforge-cli and Python. {\"time\":\"2026-11-05T14:03:22.120Z\",\"user\":\"ana\",\"host\":\"ws042\",\"client\":\"mcp:claude-code 2.1.0\",\"tool\":\"mcp\", \"command\":\"export_glb\",\"args\":{\"path\":\"/show/troll/assets/rock.glb\"},\"result\":\"ok\",\"message\":\"Exported\",\"ms\":930} What is never written: artwork (meshes, images, textures), keys and tokens (any argument named like a key, token, password or secret is ), and long text (strings are cut to 120 characters; a long prompt is recorded as its length). File paths are kept: they say what was read or written. Where: audit.path from the policy, with {user}, {host} and {date} filled in, so each machine can write its own file on a share. Without a policy, audit/ai-audit.jsonl in the settings folder. Edit > Preferences > AI shows the path; sculptforge-cli --audit-log prints it. Rotation: past audit.maxMB the file becomes .1, .1 becomes .2, and so on up to audit.keep. Nothing is sent anywhere: collect the files with your own tools (any log shipper reads JSON lines)."},{"p":"studios.html","c":"SculptForge for studios","a":"ai-providers","h":"AI providers","t":"Edit > Preferences > AI > Provider has presets that fill in the address and a model, so artists pick a name instead of typing URLs: Preset Address Key Anthropic (Claude) https://api.anthropic.com/v1/messages The artist's or the studio's API key OpenAI https://api.openai.com/v1/chat/completions API key Ollama http://localhost:11434/v1/chat/completions None LM Studio http://localhost:1234/v1/chat/completions None vLLM server http://localhost:8000/v1/chat/completions (or your GPU server) Optional llama.cpp server http://localhost:8080/v1/chat/completions (or your server) None LiteLLM proxy (studio gateway) http://localhost:4000/v1/chat/completions (change it to your gateway) A virtual key, or the studio sign-in OpenRouter https://openrouter.ai/api/v1/chat/completions API key Amazon Bedrock, Google Vertex AI and Azure OpenAI go through a LiteLLM proxy your studio runs: the proxy holds the cloud credentials, applies your budgets and model list, and SculptForge talks only to it. A minimal proxy configuration: model_list: - model_name: claude litellm_params: {model: \"bedrock/<Bedrock model id>\", aws_region_name: us-west-2} - model_name: gemini litellm_params: {model: \"vertex_ai/<Vertex model id>\", vertex_project: acme-render, vertex_location: us-central1} - model_name: gpt litellm_params: {model: \"azure/<your deployment>\", api_base: \"https://acme.openai.azure.com\", api_version: \"<API version>\"} Point the preset at https://llm.acme.internal/v1/chat/completions, list that prefix in ai.endpoints, allow only litellm in ai.providers, and artists can reach no other AI service. To validate the studio sign-in at the gateway, use LiteLLM's JWT authentication with your identity provider's keys. Keys are kept in the operating system's keychain: macOS Keychain, Windows Credential Manager, or the Secret Service on Linux (GNOME Keyring, KWallet, KeePassXC). They are never written to a settings file; keys from older versions move into the keychain at the first start. Where there is no keychain (SF_KEYCHAIN=none, a render node), a key typed in lasts until SculptForge quits; the environment variables ANTHROPIC_API_KEY, OPENAI_API_KEY, OPENROUTER_API_KEY, HF_TOKEN, FAL_KEY and MESHY_API_KEY work everywhere."},{"p":"studios.html","c":"SculptForge for studios","a":"single-sign-on","h":"Single sign-on","t":"With signIn in the policy, Edit > Preferences > AI > Studio sign-in signs the artist in with the studio account (Okta, Microsoft Entra ID, Google Workspace, Auth0, Keycloak or any OpenID Connect provider). It uses the device authorization grant only: SculptForge shows a short code and opens your provider's page, and the artist signs in there, in their browser, with your usual login and MFA. Nothing on the artist's computer listens for the answer: no local port, no redirect, no embedded browser. sculptforge-cli --sign-in does the same in a terminal. The tokens are kept in the keychain and refreshed when they expire. The access token is sent as Authorization: Bearer only to the addresses in signIn.useFor (default: ai.endpoints), such as your AI gateway; never to anyone else. SculptForge reads the ID token's name and email only to show who is signed in: your services verify the access token. To set it up, register a public client (no client secret) with the device flow turned on: Provider Where Issuer Okta Applications > Create App Integration > OIDC > Native Application; Grant type: Device Authorization https://.okta.com/oauth2/default Microsoft Entra ID App registrations > New registration; Authentication > Allow public client flows: Yes https://login.microsoftonline.com//v2.0 Google Workspace Google Cloud console > Credentials > OAuth client ID > TVs and Limited Input devices https://accounts.google.com (list https://oauth2.googleapis.com/ in network.allow when the network is off) Auth0 Applications > Native; Advanced settings > Grant types: Device Code https://.auth0.com/ (set signIn.audience to your API) Keycloak Clients > Create; Client authentication: Off; OAuth 2.0 Device Authorization Grant: On https:///realms/ Put the client id in signIn.clientId. Google's device flow also wants the client's secret, which Google documents as not confidential for this client type: put it in signIn.clientSecret. Google's access tokens are meant for Google's own APIs, so with Google Workspace have your gateway validate the ID token instead."},{"p":"studios.html","c":"SculptForge for studios","a":"offline-and-air-gapped-use","h":"Offline and air-gapped use","t":"\"network\": {\"enabled\": false} in the policy, or sculptforge --offline / SF_OFFLINE=1, turns on studio mode: every request goes through one gate that refuses anything not allowed before it is sent, follows no redirect, and sockets open only on loopback (see Offline deployment). AI can stay on in an air-gapped facility with local models: allow ollama, lmstudio, vllm, llamacpp or comfyui and list their addresses in ai.endpoints. Updates come from updates.feed / updates.mirror only; copy a release's latest.json there when you are ready. Install from the signed checksums as described under Offline deployment."},{"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, Unreal and Bridge Brush Lab and sharing brushes Image and text to 3D: running models on your own ComfyUI server Troubleshooting Security overview for IT reviews"},{"p":"security.html","c":"Security overview for IT reviews","a":"","h":"Security overview for IT reviews","t":"A one-page summary for a studio's security or IT review. Details and settings are in SculptForge for studios."},{"p":"security.html","c":"Security overview for IT reviews","a":"what-sculptforge-is","h":"What SculptForge is","t":"A desktop sculpting application (GPL-3.0, source on GitHub), a command-line tool (sculptforge-cli) and a Python module. No account, no licence server, no servers of our own. It runs as the signed-in user with no elevated rights and installs no services, drivers or background processes."},{"p":"security.html","c":"Security overview for IT reviews","a":"network","h":"Network","t":" Telemetry, analytics, crash upload None. Crash logs stay on the computer. Listening ports None by default, and never for AI tools or sign-in. Two features listen while the artist uses them: phone capture (on the local network, so the phone can reach it) and the Unreal link. With the network off by policy, they may use only this computer unless network.localNetwork allows the studio network. The Blender and Maya bridges exchange files. The Maya Live link, when the artist turns it on (with a warning each time; off at every start), listens on a per-user socket or pipe on this computer only, never a port; \"maya\": {\"link\": \"never\"} forbids it. Outbound connections Only what the artist uses: the daily update check (a small file from the website, or your own feed), the community brush gallery, and the AI service the artist chose. With \"network\": {\"enabled\": false} in the policy, a single gate refuses everything except the addresses you list, before anything is sent, and follows no redirects. AI features Optional, and lockable off by policy. Only the request goes to the chosen service: a brush description, or the picture or text given to Generate 3D. Sculpts are never uploaded or used for training. Providers and addresses can be limited to your own gateway or local models."},{"p":"security.html","c":"Security overview for IT reviews","a":"ai-tools-mcp","h":"AI tools (MCP)","t":"sculptforge-cli --mcp serves the Model Context Protocol over stdio only: the AI tool starts it as a child process; nothing listens on a port. Each command an AI tool runs is checked against the policy's allowed categories (read, edit, files, scripts, network, AI) and written to the audit log. AI tools can't install, remove or switch packs. Controlling an open SculptForge window can be forbidden outright (\"mcp\": {\"live\": \"never\"}), and MCP can be turned off entirely."},{"p":"security.html","c":"Security overview for IT reviews","a":"data-at-rest","h":"Data at rest","t":" Where Artwork Wherever the artist saves it. SculptForge doesn't copy it elsewhere. Settings The user's settings folder, owner-only permissions. No secrets in them. API keys, sign-in tokens The OS keychain only: macOS Keychain, Windows Credential Manager, Linux Secret Service. Never in files or logs. Audit log JSON lines, local or on a share you choose; no artwork, keys or long text."},{"p":"security.html","c":"Security overview for IT reviews","a":"identity","h":"Identity","t":"Single sign-on uses OpenID Connect with the device authorization grant (RFC 8628) against your identity provider: the artist signs in in their own browser with your MFA, and no local listener or embedded browser is involved. The token is sent only to the addresses your policy names (your AI gateway)."},{"p":"security.html","c":"Security overview for IT reviews","a":"central-control","h":"Central control","t":"A read-only policy file (/etc/sculptforge/policy.json, /Library/Application Support/SculptForge/policy.json, C:\\ProgramData\\SculptForge\\policy.json) locks AI on or off, network features, allowed AI providers and addresses, AI tool access, sign-in, the audit log and updates. A broken policy fails closed. An artist can't override it with environment variables while it is installed."},{"p":"security.html","c":"Security overview for IT reviews","a":"supply-chain","h":"Supply chain","t":" Status Builds Built from the public repository by GitHub Actions, from tagged commits, with every third-party archive pinned by SHA-256 (cmake/Fetch.cmake). Release integrity Every release has SHA256SUMS.txt and an Ed25519 signature of it (SHA256SUMS.txt.sig); the app's own updater checks both. SBOM Each release carries a CycloneDX SBOM (SculptForge--sbom.cdx.json), covered by the signed checksums. Licences: THIRD_PARTY_NOTICES.md. Code signing Not yet. Windows installers are not Authenticode-signed (SmartScreen warns), and the macOS app is ad-hoc signed, not notarized. Verify downloads with the signed checksums until then. Updates Off, or from your own feed or mirror, by policy. A studio build reads only its own channel. Vulnerability reports Private reporting on GitHub (see SECURITY.md); fixes go to the latest release."},{"p":"security.html","c":"Security overview for IT reviews","a":"see-also","h":"See also","t":"SculptForge for studios: IT deployment AI services: privacy and model licences"},{"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. SculptForge has four key styles, chosen in Edit > Preferences > Input > Style (and by the Coming from question the first time SculptForge starts): SculptForge (the default for new installs), Classic, Blender and Maya. The main table shows the SculptForge style; the sections after it list what the classic and Blender styles change. If you used an earlier version, your saved style is kept."},{"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 Edit > Preferences > Hotkeys. Your changes save themselves. 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 in the SculptForge style, 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). Capture from view Ctrl+Alt+C Alpha and VDM from the viewport: drag a square over any sculpted detail (Shift for a circle) and capture it as a grayscale height alpha and as a vector displacement brush, ready to stamp with the VDM brush or along strokes with Detail Clone, and to save in your library. Clay 2 Builds up clay that fills the hollows first. Clay Block 0 Square, flat-topped clay strokes for blocking in forms. Crease 6 Cuts a sharp crease; Alt raises a ridge. Flatten 7 Presses the surface toward a plane. Inflate 5 Swells the surface outward along its normals. Move 4 Grabs the surface under the cursor and pulls it along. Paste brush Ctrl+V Add the brush on the clipboard: a brush code someone shared, or the text of a .sfbrush file. Pinch 8 Pulls the surface toward the stroke to tighten edges. Sharp Crease 9 A sharp V-shaped crease with the sides pinched in. Smooth 3 Relaxes the surface. Hold Shift to smooth with any brush. Standard 1 Raises the surface along the stroke; Alt digs in."},{"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 Falloff at cursor O or I A Falloff 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. Intensity at cursor U An 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 Intensity. Larger brush ] Make the brush 10% larger (hold to repeat; Shift+] steps one pixel). Larger brush by 1 px Shift+] Make the brush one pixel larger (half a pixel below 2 px). Paint P Paint colour without sculpting. Alt paints back to white, Shift still smooths. Size at cursor S A Size slider under the cursor: drag it, or type a number and press Enter. Smaller brush [ Make the brush 10% smaller (hold to repeat; Shift+[ steps one pixel). Smaller brush by 1 px Shift+[ Make the brush one pixel smaller (half a pixel below 2 px), down to 0.5 px."},{"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 Part, 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. Quick Menu Space The Quick Menu under the cursor: brush, stroke, alpha, material, colour, Size, Falloff 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":"library","h":"Library","t":"Action Keys What it does Library , Show or hide the Library: thumbnails of your projects, models, brushes, alphas, materials, images, splats and Snapshots 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":"palettes","h":"Palettes","t":"Action Keys What it does Preferences Ctrl+, Open the Preferences palette (click its tray icon to keep it in a tray)."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"preferences","h":"Preferences","t":"Action Keys What it does Export Interface... Ctrl+Alt+Shift+I Save the layout, shortcuts and interface preferences to a file you can share. Import Interface... Ctrl+L Load a layout and shortcuts file someone shared (or you saved with Export Interface). Radial menu 1: Brushes T Hold the key, flick toward an item and let go to run it; or tap the key and click one. Edit it in Preferences > Input > Radial Menus. Radial menu 2: Masking Y Hold the key, flick toward an item and let go to run it; or tap the key and click one. Edit it in Preferences > Input > Radial Menus. Radial menu 3: Strokes J Hold the key, flick toward an item and let go to run it; or tap the key and click one. Edit it in Preferences > Input > Radial Menus. Shelves Tab Hide or show the shelves and trays around the canvas."},{"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 Show or hide the mask (masked areas drawn darker). Hiding it keeps the mask: masked areas stay protected from brushes until you clear it. Wireframe Shift+F Show the mesh's polygons (quads and triangles) over the surface."},{"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 Steady Stroke L Steady Stroke on or off, with every stroke type (Dots, Drag Stamp, Slide Stamp, Spray): the brush trails the cursor on a string and only moves once the string is taut, for steady lines without hand shake. Stroke popup G A grid at the cursor with the stroke types, the modifiers (Add / Sub, Smooth, Mask, Select) and the mask and Cut shapes. Hold the key, point at one and let go; or tap the key and click. Smooth, Mask, Select and the shapes stay on without holding Shift or Ctrl, until you pick them again or another brush."},{"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, away from the model). Divide (keeps levels) Ctrl+D Non-destructive: 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. Duplicate Part Ctrl+Shift+D Copy the active Part, with its layers and attributes, and make the copy active (also in the Parts list's right-click menu). Group from Mask Ctrl+W Turn the masked part into a new face group and clear the mask. With nothing masked, everything visible becomes one group. Higher Level 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 Level 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 Part. Preview A Show the skin Make Mesh would build instead of the spheres. Turn it off to edit the spheres again. Quick Remesh Shift+R With Tool > Remesh > Quick Remesh on: remesh the active Part at the Voxel Remesh resolution, in the background. Quick Remesh (hold and drag) N With Tool > Remesh > Quick Remesh on: hold this key and click or drag on the background (not on the model) to remesh the active Part. Sculpt the Part under the cursor Alt+Q Make the Part under the pointer the one you sculpt, without moving the view (each Part keeps its mask). The same key as Blender's; Preferences > Hotkeys changes it."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"transform","h":"Transform","t":"Action Keys What it does Back view Ctrl+Numpad 1 Look at the model from behind (orthographic). Bottom view Ctrl+Numpad 7 Look up at the model from below (orthographic). Draw Q Draw mode: brushes sculpt and paint (leaves the Gizmo). Frame F Fit the whole model in the view. Frame Part Numpad . Fit the active Part in the view (Blender: View Selected; Maya keys: Alt+F). Front view Numpad 1 Look at the model from the front (orthographic). Left view Ctrl+Numpad 3 Look at the model's left side (orthographic). Move W Gizmo, 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. Opposite side Numpad 9 Look at the model from the other side. Orbit down Numpad 2 Turn the view 15 degrees down under the model. Orbit left Numpad 4 Turn the view 15 degrees to the left around the model. Orbit right Numpad 6 Turn the view 15 degrees to the right around the model. Orbit up Numpad 8 Turn the view 15 degrees up over the model. Orthographic Numpad 5 Switch between a perspective and an orthographic view (no foreshortening: sizes don't shrink with depth). Restore View Numpad 0 Go back to the view saved or restored last (View > Views). Right view Numpad 3 Look at the model's right side (orthographic). Rotate R Gizmo, 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. Save View Ctrl+Alt+Numpad 0 Remember this camera as a named view (View > Views; the name field names it). Saved with the project. Scale E Gizmo, 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. Top view Numpad 7 Look down on the model (orthographic). X X Mirror strokes across X (left and right). Zoom in Numpad Plus Move the view closer. Zoom out Numpad Minus Move the view back."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"uv-editor","h":"UV Editor","t":"Action Keys What it does UV Editor Alt+U Open the UV Editor: the Part's UV layout in 2D over the UDIM tiles. Select vertices, edges, faces or islands (here or on the model), move, rotate and scale them, mark seams, unwrap, pack, set texel density and lay islands into trim sheet strips. Stretch and texel density show live on the model while you edit."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"view","h":"View","t":"Action Keys What it does Free Alt+Shift+F Rotation drags turn the view about the screen's axes and can roll it over the top (the default). Saved with the preferences. Lock camera Shift+L Lock the camera for left-drags: a drag that starts on the background sculpts once it reaches the model instead of turning the view (Preferences > Input > Start strokes off the model, #62). The status bar shows CAMERA LOCKED while it is on. Right-drag or Alt+drag still move the view. Shift+L turns it on and off. Turbo Ctrl+Alt+T Everything this computer can safely give to sculpting speed, in one click: antialiasing off and a lighter view while you sculpt and orbit (full quality the moment you stop), and the top budgets of the tier this machine carries. It never goes past what the memory holds. Off puts everything back as you set it. Remembered on this computer. X Alt+Shift+X Rotation drags turn the view about the world X axis only (red): from the front, an up or down drag tips the model towards you or away. Shift still snaps to a side view; the axis gizmo shows the lock. Saved with the preferences. Y (turntable) Alt+Shift+Y Rotation drags turn the view like a turntable: the model stays upright and turns about its vertical (Y) axis. Saved with the preferences. Z Alt+Shift+Z Rotation drags turn the view about the world Z axis only (blue): from the front, a drag around the middle turns the model like a wheel. Shift still snaps to a side view; the axis gizmo shows the lock. Saved with the preferences."},{"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 Sculpt from beside the model Turn on Edit > Preferences > Input > Start strokes off the model (or press Shift+L), then left-drag from the background onto the model; the view then turns with a right-drag (see Navigation) 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; Ctrl+left-drag on the background when nothing is masked (not in the classic) 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 something masked (with Mask Pen), or Ctrl+Shift+A Mask inside a lasso or rectangle Ctrl+drag with Lasso Mask or Rectangle Mask picked in Tool > Masking (add Alt: unmask) Isolate a face group Ctrl+Shift+click it (again: invert the visibility; with something hidden already: hide it) Hide a face group 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); Select Rectangle or Select Lasso in Tool > Visibility Select a Part Alt+click it in the view (Shift+Alt+click, or a triple-click on another Part: select and frame it) Sculpt the Part under the cursor Alt+Q (every input style; the view stays put) Move, scale or rotate with the Gizmo 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 Customize Shelves 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 highlighted 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":"classic-sculpting-keys","h":"Classic sculpting keys","t":"With Edit > Preferences > Input > Style on Classic, the keys and gestures work. The choice saves itself. Compared with the table above, these change: To SculptForge style classic Pick one of the first ten brushes 1 to 9, 0 (Standard, Clay, Smooth, Move ...) No key: the number keys are free Save Snapshot No key 9 Slider at the cursor on I Falloff (as O) Colour intensity Ctrl+drag on the background with nothing masked Zooms Draws a mask rectangle (one that misses the model clears the mask) Zoom drags (Ctrl+right-drag, Alt+drag then release) Up zooms in Up zooms out Everything else, from the B brush letters and S / U / O to the Ctrl and Ctrl+Shift gestures, is the same in both styles. The Maya style keeps these the Classic sculpting keys and changes only the view controls (Alt+left, middle and right drags)."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"maya-keys","h":"Maya keys","t":"With Edit > Preferences > Input > Style on Maya (#32), the view works as in Maya, on the model or beside it, as long as Alt is the only key held: To Maya style Rotate Alt+left-drag Pan Alt+middle-drag Zoom Alt+right-drag sideways: right zooms in, left zooms out, as Maya's own dolly; the mouse wheel zooms toward the pointer Roll (turn about the view axis) Hold Alt, then add Ctrl, and left-drag left or right Frame the active Part Alt+F (also Numpad .) Reset the view Alt+H: from the front, upright, in perspective, the whole model in view Invert the brush (subtract) Hold Ctrl while sculpting Paint a mask / erase it Ctrl+Alt+drag / Ctrl+Alt+Shift+drag Smooth Hold Shift while sculpting Visibility gestures Ctrl+Shift, as in the other styles The roll needs Alt first: press Ctrl first (or both together) and Ctrl+Alt masks as before, on the model, and clears the mask beside it. Edit > Preferences > Input > Wheel zooms toward the pointer (#134) keeps the point of the model under the pointer where it is while the wheel zooms; beside the model it zooms toward the pointer at the model's depth. Choosing the Maya style turns it on and the other styles turn it off (they zoom toward the middle of the view); the box changes it in any style. Maya's default dolly follows a sideways drag, so that is the default here too. Edit > Preferences > Input > Zoom drag switches it to Up and down (drag up to zoom in) if you set Maya up that way. Invert zoom, in every style, turns zoom drags around (the mouse wheel stays as it is)."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"blender-keys","h":"Blender keys","t":"With Edit > Preferences > Input > Style on Blender (also at the top of the Controls window, F1), the view and the sculpt keys work as in Blender 4.2 and later, Sculpt Mode (with 5.1's Alt mask). Compared with the table above, these change in the Blender style: To Blender style Rotate Middle-drag, or Alt+left-drag beside the model (everywhere with Edit > Preferences > Input > Emulate 3 Button Mouse, for pens and trackpads), or left-drag beside the model Pan Shift+middle-drag, or Alt+Shift+left-drag Zoom Mouse wheel, Ctrl+middle-drag (up: closer), Alt+Ctrl+left-drag, Numpad Plus / Numpad Minus Invert the brush (subtract) Hold Ctrl while sculpting Mask / unmask Alt+drag / Ctrl+Alt+drag on the model (Blender 5.1 and later), or the Mask brush (M) Smooth Hold Shift while sculpting Front, right, top view Numpad 1, Numpad 3, Numpad 7; with Ctrl: back, left, bottom Orthographic on or off Numpad 5 (the axis views turn it on until you rotate again) Orbit in 15 degree steps, the other side Numpad 4 Numpad 6 Numpad 8 Numpad 2, Numpad 9 Frame the active Part / everything Numpad . / Home Brush radius / strength F / Shift+F (drag, or type a number) Draw, Smooth, Pinch, Inflate, Grab (Move) V, S, P, I, G Clay Strips (Clay Block), Crease, Tendril, Scrape (Flatten) C, Shift+C, K, Shift+T Mask brush M, then drag to mask and Ctrl+drag to unmask; M again goes back to your brush Clear / invert the mask Alt+M / Ctrl+I Hide the face group under the cursor H; Shift+H shows only it (again: everything); Alt+H shows everything Lower / higher subdivision level Alt+1 / Alt+2 (Shift+D / D still work) Swap colours / sample colour X / Shift+X Smooth stroke (Lazy Stroke) Shift+S (or L) Wireframe Shift+Z Choosing the Blender style also sets Rotation to Turntable, as Blender orbits; change it back under Edit > Preferences > Input if you like. Blender's face sets are SculptForge's face groups, and its brushes map to the nearest SculptForge brush. Symmetry X, Paint and the material picker have no key in the Blender style (they are on the shelves); give them one with Ctrl+Alt+click. Laptops without a numpad: turn on Edit > Preferences > Input > Emulate Numpad and the number row works as the numpad. The numpad views (Numpad 1, 3, 7, 5 ...) work in every style."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"your-own-blender-keymap","h":"Your own Blender keymap","t":"If you changed Blender's keys, export them in Blender (Edit > Preferences > Keymap, the Export... button next to the keymap name) and in SculptForge choose Import Blender keymap... under Edit > Preferences > Input or at the top of the Controls window. SculptForge switches to the Blender style and takes, from the file's 3D View and Sculpt keymaps, the keys of every action it has an equivalent for: the views, the brushes above, the radius and strength, the mask, hiding, subdivision levels, undo and redo. Mouse buttons and keys for things SculptForge doesn't have are left alone; the status bar says how many keys it took. The file is read as text and never run. The keys save themselves; Reset Layout and Shortcuts goes back to the defaults."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"classic-sculpting-keys-that-work-differently","h":"Classic sculpting keys that work differently","t":"Most classic sculpting keys and gestures work in SculptForge with the Classic sculpting keys. The few that differ even then, because the feature works differently or doesn't exist yet: Classic key SculptForge P (perspective) P is the Paint brush; Numpad 5 switches to an orthographic view T (Edit mode) Always in Edit mode: there is no 2.5D canvas W / E / R (move, scale and rotate line) The Gizmo (see Gizmo) 1, 2, 3 (replay and record strokes) Not yet N (list the Parts) Tool > Parts 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 script) Export GLB and Send to Unreal H (hide the script window) ` toggles the console See Quick tour for experienced sculptors for the whole list."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"see-also","h":"See also","t":"The interface Navigating the view Masking Face Groups 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 Edit > Preferences > Performance, and how to get the most out of a big sculpt. What we're building next, and how each piece works: Performance: what we're building. Edit > 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 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":"edit--preferences--performance","h":"Edit > 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 View resolution (100%, 75%, 50%) Draws the 3D view at a share of the window's resolution and scales it up: 75% draws about half the pixels and 50% a quarter. Try it on slow or integrated graphics and big screens. Save Render always renders at full resolution. Also in View Fast Navigation While you rotate, pan or zoom a scene bigger than the hardware profile's motion proxy threshold (see below), 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 Predictive Strokes The brush is worked out on its own thread while the view keeps drawing at full speed. The dabs it hasn't finished show at once as a preview on the surface, and the brush cursor and the stroke's head are drawn where the pen is about to be, so on a heavy mesh the surface moves under the pen straight away and lifting the pen never waits. The finished sculpt is exactly the same as with it off. On by default (painting, masking, dynamic topology, Move, Tendril and the drag strokes work as before) Draft Strokes With Predictive Strokes: while you sculpt, the brush only moves the surface, the moved part is shaded from its facets, and the smooth shading, the cavities and the rest are worked out once when you lift the pen. Lighter on laptops and on battery. Inflate and the plane brushes use the surface's direction from the stroke's start, so the result can differ slightly from a full stroke. Off by default Live Move (experimental) The Move brush's drag is drawn by the graphics card from where the surface started, so it follows the pen at the view's frame rate on any mesh size; the move is applied once, exactly, when you lift the pen. Not with masks, hidden parts, sculpt layers, micro levels, Connected Only or View falloff (Move works as before there). Off by default Background Preview (experimental) On meshes of 2 million vertices or more a big brush is worked out on its own thread; with this on, the dabs still being worked out show as a preview under the pen. The finished sculpt is exactly the same either way. Off by default Fast Upload (experimental) While you sculpt, the changed part of the mesh goes to the graphics card through memory both can see and the card copies it into place, instead of the driver copying it during the frame. The sculpt and the view are exactly the same either way. Needs OpenGL 4.4 buffer storage (otherwise it does nothing). Off 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"},{"p":"performance.html","c":"Performance and big meshes","a":"your-hardware-tier","h":"Your hardware tier","t":"On top of the profile below, SculptForge sorts your computer into a tier, so the bigger features switch on by themselves where your machine can carry them, and never where it can't. Every tier sculpts smoothly: the higher ones give more room for detail. Tier For What it adds Essential every computer SculptForge runs on settings tuned for the machine; Focus Detail keeps 512 MB of full-resolution detail close by Standard 16 GB of memory, 6 or more threads and a 4 GB graphics card (or graphics that share the memory) twice the Focus Detail memory, streamed in faster High 32 GB, 8 or more threads and an 8 GB graphics card (or 32 GB shared, such as an Apple Pro or Max) 2 GB of Focus Detail, 16K paint and bake textures Extreme 64 GB, 16 or more threads and a 16 GB graphics card (or 64 GB shared) 4 GB of Focus Detail, the most of everything A graphics card or processor that measures slow keeps a lower tier, whatever its memory says. The first time SculptForge starts (and when you change the graphics card or the memory), a small card in the corner of the 3D view says what it found, for example Your machine: RTX 3060, 12 GB VRAM, 32 GB RAM. Tier: High, and what that turns on. Click Got it; it doesn't show again on this computer. The tier is also in the top bar, next to the bolt: click it to open Edit > Preferences > Performance. There, at the top: Control What it does Tier your machine, its tier, what the next tier would need, and What this turns on Auto / each tier choose the tier yourself. A tier above the detected one is allowed; the memory guard still watches it Turbo the same switch as the bolt (below) Graphics card on a computer with two (a laptop's built-in and gaming graphics, or two cards): which one draws SculptForge. Auto takes the fastest one. It applies the next time SculptForge starts; if that card can't start, SculptForge goes back to the system's choice and says so Compute Auto, CPU or GPU for the heavy work. Each task shows where it runs; the ones that have no graphics card version yet say CPU only for now. Auto uses the graphics card only where it measured faster, and never on the Essential tier Free memory is watched. If your computer runs low on memory while you work (another program, a huge scene), SculptForge steps the tier down one level and says so in the status bar; detail streams in a little later and nothing is lost. When there is room again for a minute, it steps back up."},{"p":"performance.html","c":"Performance and big meshes","a":"turbo","h":"Turbo","t":"The small bolt in the top bar (also View > Turbo, Ctrl+Alt+T) gives everything your computer can safely spare to sculpting speed: while you sculpt or orbit, the view draws without antialiasing and with a lighter version of big scenes, and the tier's top budgets apply. The moment you stop, the view is back at full quality. It turns orange while on, and a line in the status bar says what it changed. Turn it off and every setting is exactly as you left it. SculptForge remembers it on this computer."},{"p":"performance.html","c":"Performance and big meshes","a":"the-hardware-profile","h":"The hardware profile","t":"The first time you start SculptForge, a small window says Getting to know this computer for a second or two: it checks how fast your graphics card draws and receives data, how fast a brush runs and how fast the memory is, and picks settings to match. It does this once, and again only when you change the graphics card, update its driver or install a new version. Press Esc or Skip to skip it; the settings then come from the type of graphics card and the memory sizes. Nothing is sent anywhere: the results stay in your settings folder. There are two main profiles and a safe mode: Profile For What changes Laptop / Budget laptops and most desktops: 8-32 GB of memory, a 2-8 GB graphics card, most Apple Silicon Macs a moderate number of triangles drawn while the view moves; brushes shade continuously on mains power Workstation 64 GB of memory or more, and a graphics card with 16 GB or more or an Apple Silicon Max / Ultra (or another chip whose graphics share the memory) that measures as fast more triangles drawn per frame, larger textures and subdivision limits, shading updated with every dab Software (safe mode) no graphics driver, so the drawing happens on the processor (llvmpipe) the lightest settings, no antialiasing On a laptop running on battery, whatever its profile, SculptForge sends less data to the graphics card per frame and aims for 60 frames a second, and the status bar says so; plugged in again, it goes back. At the top of Edit > Preferences > Performance: Control What it does Detected ... the graphics card, its memory and the profile, and why Measured numbers triangles drawn per second, upload speed, the cost of a brush dab, memory speed, the processor and the system Settings how many triangles the view draws per frame, from what size big scenes use their lighter version while moving, memory and upload budgets, texture and subdivision limits, threads, the target frame rate (60, or 120 / 144 on a fast display) Frame Governor while the view moves, watch how long frames take and draw big scenes' lighter version sooner or later to hold the target frame rate. It only changes what you see while moving, never the model. On by default Re-calibrate measure again (your overrides are kept) Manual overrides choose the profile yourself, or set any of the numbers (empty = automatic); Back to automatic clears them. Overrides are saved at once and kept when you re-calibrate From a shell, sculptforge --calibrate measures and prints the result as JSON. Like the other preferences, these save themselves for the next start. 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 Parts aren't drawn and hidden parts of a Part aren't sculpted (Tool > Visibility). A hidden Part 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 (vertex paint 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 Part doesn't fit, SculptForge doesn't draw it and says so in the status bar instead of failing: hide other Parts 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. Tool > Display > Backface culling (#68, off by default) skips the back faces of any mesh, open or closed, from any view: an open scan seen from behind then draws almost nothing (8M triangles: 3.1 ms down to 0.7 ms a frame), and you see through its openings. Brushes then work only on the faces drawn. 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":"proof-mode-see-it-for-yourself","h":"Proof mode: see it for yourself","t":"Help > Benchmark (or sculptforge --benchmark standard-15m) shows how responsive sculpting is on your own computer, measured the way it feels rather than the way a developer measures it. Its standard scenes are the ones the benchmarks page lists: a procedural head of 15 million (standard-15m) or 33 million (standard-33m) triangles, the same on every computer, sculpted with a fixed stroke set: Clay at 25, 60 and 120 pixels, Move, Smooth and a 240-pixel brush, then a turn of the view (standard runs both sizes). Each reports frame time (p50, p95, p99), how far the stroke trails the pointer in pixels, the worst stall (the longest the screen froze), and peak memory and graphics memory. Without a scene name (sculptforge --benchmark, or Spheres in the dialog) it runs the older size sweep: for each size, 5, 20 and 33 million triangles (and 100 million when there is enough free memory), it builds a sphere with subdivision levels, then plays a scripted pen stroke into the same code your mouse and pen go through, 240 pointer samples a second: a figure eight with a 60-pixel brush, the same with a 240-pixel brush, then a turn of the view. It replaces the scene, so save your work first; Esc stops it. While it runs, a panel in the corner shows: fps and the frame time: the median (p50), and the 95th and 99th percentile, the slow frames you would notice as a hitch. Stroke trails pointer: how far the stroke on screen is behind the pointer, in milliseconds (from the pointer sample the newest drawn dab belongs to until that frame is handed to the display; the display's own refresh comes on top) and in pixels along the path. The memory SculptForge uses. Vertical sync is off during the run so frame times aren't capped at the display's rate (tick Keep vertical sync on to measure with it). At the end a table sums up each mesh and phase, and two files are written: a video of the run with the panel in it (needs ffmpeg; recording costs a millisecond or two per frame) and a JSON file with the results, your processor, graphics card, memory, operating system and the SculptForge version and commit. In the app they go to the benchmarks folder in SculptForge's settings folder (Open folder in the results); from the command line, to the current folder: sculptforge --benchmark standard-15m --benchmark-out mine.json --benchmark-video mine.mp4 sculptforge --benchmark --benchmark-sizes 5,20,33 --benchmark-out spheres.json --benchmark-no-video skips the video, --benchmark-vsync keeps vertical sync on, --benchmark-seconds 6 sets the length of each stroke, and --size 1920x1080 the window (a tiling window manager may choose another size; the result records the one used). Share a result on the benchmarks page as its format description explains."},{"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 When nothing changes, SculptForge draws nothing: the graphics card and processor rest until you move the mouse, press a key, or something finishes in the background. sculptforge --measure-idle 5 sits idle for five seconds (after a short start) and prints the frames drawn and the processor time used. If the view ever stops updating when it should (a driver that misbehaves), start SculptForge with the environment variable SF_CONTINUOUS_REDRAW=1 to draw every frame as versions before 0.9.5 did, and please report it; SF_REDRAW_LOG=1 logs why each frame was drawn. On a very dense mesh a dab can cost more than a frame. The dabs of a stroke then wait in a queue that SculptForge works through for a few milliseconds each frame, reading the pen or mouse in between, so a fast curve stays a curve; once more than about 50 ms of dabs are waiting, every second waiting dab is left out (a wider spacing), so the brush stays close to the pointer and stops soon after you lift the pen. sculptforge --run \"new_sphere\" --measure-stroke 3,200 draws a fast circle for three seconds with a 200-pixel brush and prints how far the dabs strayed from it and the frame times. SF_STROKE_IMMEDIATE=1 places every dab as soon as the pointer moves (versions before 0.9.6), SF_STROKE_BACKLOG=0 never leaves dabs out, and SF_STROKE_LOG=1 logs the queue each frame (with Predictive Strokes, each batch the brush thread places and what packing it for the graphics card cost). SF_PREDICTIVE_STROKE=0 / 1 and SF_DRAFT_STROKE=0 / 1 override the two preferences, and SF_FRAME_LOG=16 logs every frame slower than 16 ms with where its time went. tools/bench_strokes.sh in the source runs the stroke measurement on 5, 21 and 33 million triangle spheres and prints the frame times (mean, 95th and 99th percentile), how far the surface and the preview trail the pointer, press and release, for one build or two side by side. 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: tablets, display, crashes and FAQ","a":"","h":"Troubleshooting: tablets, display, crashes 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. Quick answers: Problem Fix No pen pressure on Windows Switch Windows Ink in the tablet driver and bring the pen back (Pen tablets) The cursor jumps when the pen touches down Edit > Preferences > Tablet > Mouse mode (relative) \"Windows protected your PC\" More info, then Run anyway (First launch warnings) Text and buttons too small or too large Edit > Preferences > Interface > UI scale (details) Menus or shelves look wrong after an update Edit > Preferences > Config > Reset Layout and Shortcuts (Reset the interface) Sculpting feels slow The viewport is slow Lost work after a crash Recovering work after a crash Want the Classic layout back Edit > Preferences > Interface > Look > Layout > Classic"},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes 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. Linux on Apple Silicon (Asahi) and other ARM machines: use the ARM64 download. The x86_64 one runs there only through the FEX emulator, which stops at once with : Unsupported system page size on 16 KiB pages; start it in a 4 KiB-page VM with muvm -- ./SculptForge-linux-x86_64.AppImage if you need it. 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, then read the log file, which holds the same messages."},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes 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: tablets, display, crashes and FAQ","a":"the-viewport-is-slow","h":"The viewport is slow","t":"Check the triangle count in the bar along the top of the window (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 Parts 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 Render > Gaussian Splats 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). Edit > Preferences > Performance: lower Antialiasing (or turn it off), try View resolution 75% or 50%, 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 Part missing from the view with \"Not enough GPU memory\" in the status bar didn't fit on the graphics card: hide other Parts or step down a level."},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes 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 Sculpt > Draw & Tablet. 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). Edit > Preferences > Input and Edit > Preferences > Tablet show \"Pressure: on\" once the pen has pressed, or \"Pressure: not detected\". Without pressure the pen still draws, at full strength. A tablet plugged in while SculptForge runs works straight away; the status bar says \"Tablet connected\" (also through Wacom Bridge). If no pen is detected or pressure doesn't change: Install or update the tablet maker's driver. Windows: SculptForge reads pressure through Windows Ink, and through the driver's Wintab when Windows Ink is off (Wacom Tablet Properties > Mapping > Use Windows Ink). If pressure is still missing, switch that option and bring the pen back to the tablet. See Pen tablets on Windows. 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. The active Part changed by itself: a Part becomes active with Alt+click on it (the keyboard's Alt, a quick click), a triple-click with the mouse or a click in the Parts list; the status bar names it and how. A tablet's ExpressKey set to Alt counts as the keyboard's Alt. The cursor jumps back when you put the pen down elsewhere: the tablet driver is set to mouse (relative) mode. Turn on Edit > Preferences > Tablet > Mouse mode (relative). It also makes the pen relative with the driver in pen mode; the arrow is drawn at the brush while the pen is in range. The pen picks a brush, then stops clicking menus or the canvas until you use the mouse (Huion, display tablets, Wacom; 0.10.8 and earlier): update to 0.10.9 or later. If it still happens, tell us the tablet, its driver version and whether Windows Ink is on. With two screens, the app slows down when the pointer is on the other screen: fixed in 0.10.9; SculptForge now rests only when its window loses focus."},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes 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: tablets, display, crashes 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: tablets, display, crashes and FAQ","a":"hyper3d-rodin-direct","h":"Hyper3D Rodin (direct)","t":"Message What to do Add your Hyper3D API key It stays off until you add your own key (hyper3d.ai > API dashboard) in the Generate 3D window Hyper3D rejected the API key Check the key, or create a new one in the API dashboard Your Hyper3D plan doesn't include this tier Basic API access covers Extreme Low and Low; choose one of those, or upgrade on hyper3d.ai Out of credits on your Hyper3D account Top up on hyper3d.ai Refused the model file The result came from somewhere other than Hyper3D's servers, so SculptForge didn't download it. The model isn't lost: it stays in your Hyper3D account (hyper3d.ai dashboard) under the task id in the message. If it keeps happening, report it"},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes 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: tablets, display, crashes 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, api.hyper3d.com (and Hyper3D's file servers), or the Pollinations.ai text endpoint for the free Brush Lab model."},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes 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: tablets, display, crashes 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 Edit > 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: tablets, display, crashes and FAQ","a":"text-and-buttons-are-too-small-or-too-large","h":"Text and buttons are too small or too large","t":"Edit > Preferences > Interface > UI scale sets the size (Automatic, 100% to 200%) and applies it at once and keeps it for the next start. Automatic uses the scale of the monitor the window is on: on Windows that is Settings > Display > Scale, per monitor, and the interface follows when you drag the window to another monitor. On Linux under X11 it comes from the desktop's font DPI (Xft.dpi); if Automatic looks wrong there, pick a size."},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes and FAQ","a":"my-layout-is-gone-after-a-restart","h":"My layout is gone after a restart","t":"Shortcuts and preferences save themselves; the layout (shelves, trays, open palettes) waits for Edit > Preferences > Config > Save Layout. See The interface."},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes and FAQ","a":"reset-the-interface","h":"Reset the interface","t":"Edit > Preferences > Config > Reset Layout and Shortcuts returns to the built-in layout and default shortcuts. The shortcuts save themselves; press Save Layout afterwards to keep the layout. Revert to Saved Layout goes back to the layout the last Save Layout kept. 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: tablets, display, crashes 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 Edit > Preferences > Hotkeys, where Default shortcuts undoes every change."},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes 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 Shortcut changes and preferences (saved as you change them) and the layout (written by Save Layout) 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 sculptforge.log, sculptforge-previous.log What this session and the last one did, and what crashed (see The log file) 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 Library and picker thumbnails (safe to delete) Your library folder (projects, tools, alphas, images, splats and snapshots shown in the Library) is separate: Documents/SculptForge by default, changeable in Edit > Preferences > Library > Library folder. Tip: To move settings to another computer, copy ui.json, ai.json and the brushes folder. For a shared layout, use Edit > Preferences > Config > Export Interface... and Import Interface... instead."},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes and FAQ","a":"the-log-file","h":"The log file","t":"SculptForge writes what it does to sculptforge.log in its settings folder. Choose Help > Open log folder to open it: System Log file Windows %APPDATA%\\SculptForge\\SculptForge\\sculptforge.log macOS ~/Library/Application Support/SculptForge/SculptForge/sculptforge.log Linux ~/.local/share/SculptForge/SculptForge/sculptforge.log It holds the version, your system and GPU (the OpenGL ... on ... line), warnings and errors, and each command you ran. If SculptForge crashes, it ends with lines starting CRASH: that say what crashed and what was done last. Every start keeps the previous session's log as sculptforge-previous.log beside it, so after a crash attach sculptforge-previous.log to your report (the new sculptforge.log is the session after it). It holds no models and no keys, only command names and messages, which may include file names."},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes and FAQ","a":"a-performance-trace","h":"A performance trace","t":"When SculptForge gets slow, Help > Record a performance trace shows where the time goes. Turn it on, do what feels slow (the stroke, the orbit, the remesh), then choose it again to stop. sculptforge-trace.log beside the log then lists every frame that took longer than 33 ms with its parts (events, dabs, interface, GPU uploads, drawing, GPU time), each stroke's timings, commands that held up the frames, background jobs starting and ending, the mesh size and levels, and on its first line your GPU, driver and CPU. Attach it to your report. It is off by default and costs nothing when off; it stays small (2 MB, then the older lines move to sculptforge-trace-previous.log) and never leaves your computer."},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes and FAQ","a":"recovering-work-after-a-crash","h":"Recovering work after a crash","t":"SculptForge autosaves unsaved work every 5 minutes by default (Edit > 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 snapshots. The dialog also points to the crashed session's log file."},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes and FAQ","a":"frequently-asked-questions","h":"Frequently asked questions","t":"Can SculptForge open another sculpting app's own project files? Not directly: those formats are proprietary and undocumented. Export OBJ or FBX from that app, or use the Bridge. Does it have subdivision levels, voxel remesh, quad remesh or UVs? Yes: Voxel Remesh, Quad Remesh (with Project Detail 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 dynamic topology (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: tablets, display, crashes 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. After a crash, the log: sculptforge-previous.log from Help > Open log folder (see The log file). When it is slow, a performance trace of the slowdown. 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: tablets, display, crashes 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 explains the terms SculptForge uses (Parts, Forge Spheres, Vertex Paint, Library...). The command palette (F3) also finds a feature by what it does: type \"remesh\", \"groups\" or \"folders\". See also the Quick tour for experienced sculptors."},{"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 Quad Remesh 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) How far a gizmo move eases in from the mask's edge, as a share of the Part's size: a soft joint when posing. See Gizmo Generate 3D Turn an image or a description into a sculptable model. See Image and text to 3D Gizmo The Move / Scale / Rotate handles (W E R) for placing and posing a Part or its unmasked part. See Gizmo 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 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 Part that has a texture: its vertices (vertex paint) or its texture. Top shelf, next to Rgb. See Texture painting Quad Remesh SculptForge's automatic quad retopology, in Tool > Geometry. See Quad retopology Mirror plane (Quad Remesh) The plane Quad Remesh'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 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, Quad Remesh): 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 3D position on the model decid"},{"p":"glossary.html","c":"Glossary","a":"see-also","h":"See also","t":"Welcome to SculptForge The interface Keyboard and mouse reference"},{"p":"discord.html","c":"Show SculptForge on Discord","a":"","h":"Show SculptForge on Discord","t":"Let your Discord friends see that you're sculpting. Discord's profile and member list then show SculptForge, its icon and how long you've been at it. It's off until you switch it on."},{"p":"discord.html","c":"Show SculptForge on Discord","a":"switch-it-on","h":"Switch it on","t":"Open Edit > Preferences > Integrations. Check Show SculptForge on Discord. Keep the Discord desktop app running on the same computer. Your status appears within a few seconds. Two extras, both off until you check them: Show the monthly challenge adds a line \"Monthly challenge: theme\", with the theme you type in the box under it (64 characters at most). Handy while you work on the community's monthly challenge (a new theme on the 1st; submissions close on the 27th, vote until the end of the month). Show the file name adds the name of the file you have open, for example kraken.sfproj. Only the name, never the folder it's in. Uncheck Show SculptForge on Discord and your status is cleared at once. Quitting SculptForge clears it too, and so does a crash. If you quit and restart Discord, your status comes back within a few seconds."},{"p":"discord.html","c":"Show SculptForge on Discord","a":"what-is-sent-and-where","h":"What is sent, and where","t":"Sent When The SculptForge icon (Discord loads it from sculptforge.app) and name while it's on The time you started (Discord shows the elapsed time) while it's on \"Monthly challenge: theme\" only with Show the monthly challenge The file's name (not its folder) only with Show the file name Nothing else: no folders or paths, no user name, no details about your model. SculptForge passes this to the Discord app on your own computer only, through Discord's local connection; it opens no network connection and no port for it, and never asks Discord for anything (no sign-in, no invitations, no account access). Discord then shows your status to your friends and to the servers you share, as it does for games. Note: Discord shows your status only if Display current activity as a status message is on in Discord's User Settings > Activity Privacy."},{"p":"discord.html","c":"Show SculptForge on Discord","a":"if-it-doesnt-show","h":"If it doesn't show","t":"Check that the Discord desktop app is running and you're signed in. The website version of Discord can't show it. Discord in a Flatpak or Snap works; a Discord running as another user (or as administrator on Windows while SculptForge isn't) is ignored on purpose. Started Discord after SculptForge? It connects on its own within a minute."},{"p":"discord.html","c":"Show SculptForge on Discord","a":"see-also","h":"See also","t":"The interface Troubleshooting"}];diff --git a/website/index.html b/website/index.htmlindex 1ec3169a..ec49b5dc 100644--- a/website/index.html+++ b/website/index.html@@ -122,7 +122,8 @@</article><article class="card"><h3>A monthly challenge</h3>- <p>A new theme on Discord each month, and SculptForge can show it in your Discord status while you work on it.</p>+ <p>A new theme on Discord each month: submissions close on the 27th, vote until the end of the month, and the+ winner is featured on sculptforge.app. SculptForge can show the theme in your Discord status while you work on it.</p></article><article class="card"><h3>Testers and reporters credited</h3>