Skip to content

Free, open-source 3D sculpting for Linux, macOS and Windows: dense meshes, remeshing, painting, built-in AI (image/text to 3D), Send to Unreal, game-ready LODs, Gaussian splats and OpenUSD.

IP audit phase 1: no third-party sculpting-app marks in anything users see

islandmedd5dfe05fe97a
diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml
index 45bca0fd..187bd97a 100644
--- a/.github/ISSUE_TEMPLATE/feature_request.yml
+++ b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -17,4 +17,4 @@ body:
id: other
attributes:
label: How do other tools handle it?
- description: ZBrush, Blender, Nomad, Mudbox... Screenshots and links welcome.
+ description: Another app or tool that does it well? Screenshots and links welcome.
diff --git a/.github/announcements/0.10.7-new-look-preview.md b/.github/announcements/0.10.7-new-look-preview.md
index 48b30bd3..fbddeb6d 100644
--- a/.github/announcements/0.10.7-new-look-preview.md
+++ b/.github/announcements/0.10.7-new-look-preview.md
@@ -1,4 +1,4 @@
**Sneak peek: SculptForge's own look** 👀
Coming in 0.10.7: **Forge Terminal**, a tiled, keyboard-friendly interface in Tokyo Night, with menus grouped by task (Sculpt · Paint · Mesh · Render) instead of a wall of palettes. Six more colour schemes are included (Catppuccin, Nord, Gruvbox and more), and on Linux it can follow your desktop theme.
-Coming from ZBrush? The ZBrush-style layout stays one click away, and your current layout stays put until you choose.
+Experienced sculptor? The Classic layout stays one click away, and your current layout stays put until you choose.
Tell us what you think in #ideas.
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index a8bb709e..bc32cdc7 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -244,8 +244,8 @@ jobs:
cp "dist/sculptforge_bridge-${TAG#v}.zip" dist/sculptforge_bridge.zip
- name: Maya shelf script (Python source and its README; nothing to build)
run: python3 -m zipfile -c dist/sculptforge_maya.zip integrations/maya/sculptforge_maya.py integrations/maya/README.md
- - name: ZBrush ZTL Export plug-in (ZScript source; ZBrush compiles it)
- run: cp integrations/zbrush/SculptForgeZToolExport.txt dist/
+ - name: Bridge export plug-in
+ run: cp integrations/bridge-plugin/SculptForgeBridgeExport.txt dist/
- name: Checksums
run: cd dist && sha256sum * > SHA256SUMS.txt && cat SHA256SUMS.txt
- name: Release notes from CHANGELOG
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0b72b3d4..c7ff637c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -76,7 +76,7 @@ All notable changes to SculptForge are listed here. The format follows
- A Smooth, Mask or Select latch from the stroke popup came back after picking another brush and then the first one
again.
- The Library's close button works on small screens at a large UI scale (#80). When the tabs don't fit beside it, they
- fold into a drop-down, and the Sculpt Timeline no longer covers the Library's header (720p at 150%, ZBrush layout).
+ fold into a drop-down, and the Sculpt Timeline no longer covers the Library's header.
## [0.10.9] - 2026-11-02
@@ -298,8 +298,8 @@ All notable changes to SculptForge are listed here. The format follows
- A new default 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, whose sections are the
palettes; a status bar; a one-row tool shelf). Existing installs keep their look and layout, and see a one-time card,
- "SculptForge has a new look", with **Try it** and **Keep my layout**. The welcome offers **Coming from ZBrush? Use the
- ZBrush-style layout** in one click, and Preferences > Interface > Look switches any time. The look is remembered
+ "SculptForge has a new look", with **Try it** and **Keep my layout**. The welcome offers **Experienced sculptor? Use the
+ Classic layout** in one click, and Preferences > Interface > Look switches any time. The look is remembered
without Store Config. Also in Preferences > Interface > Look: the **Classic** look, **Forge Terminal** with Tokyo
Night, Catppuccin Mocha, Gruvbox Dark, Nord, Rosé Pine, Kanagawa or Everforest colours or **Match my desktop
theme** (on Linux, the Omarchy theme's colours when Omarchy is installed), **Phosphor** (green or amber, optional scanlines and glow on the interface only) and **Blueprint**.
@@ -309,7 +309,7 @@ All notable changes to SculptForge are listed here. The format follows
- Switching looks no longer grows the interface's minimum window size each time (the Sculpt Timeline strip covered
the axis gizmo at 2400x1350).
- A stored SculptForge-layout UI configuration without shelves gets the SculptForge layout's shelves, not the
- ZBrush-style ones.
+ classic ones.
### Changed
- Linux: the native Wayland support is now documented (installing guide, site, README): every Linux package opens
without XWayland, stays sharp at fractional scales and reads pen pressure through tablet-v2. A test checks the
@@ -480,14 +480,14 @@ All notable changes to SculptForge are listed here. The format follows
### Changed
- Features use SculptForge's own names (Parts, Forge Spheres, Vertex Paint, Face Groups, Library, Lit Spheres,
- Quad Remesh, Voxel Remesh, Dynamic Topology, Snapshot, Gizmo, Lazy Stroke, Wireframe, Send to ZBrush, Sharp
- Crease, Clay Block, Tendril...); searching for ZBrush terms still finds them. MatCaps are now Lit Spheres. The user guide's chapters follow
+ Quad Remesh, Voxel Remesh, Dynamic Topology, Snapshot, Gizmo, Lazy Stroke, Wireframe, Bridge, Sharp
+ Crease, Clay Block, Tendril...); the command palette finds them by what they do. The user guide's chapters follow
(Parts, Forge Spheres, Vertex Paint, Face Groups; the old web addresses redirect), and
- Help > User Guide > Coming from ZBrush has the table of ZBrush terms and their SculptForge names. The ZBrush
+ Help > User Guide > Quick tour for experienced sculptors shows where everything is. The
plug-in is now called SculptForge ZTL Export (same file, `SculptForgeZToolExport.txt`).
-- New installs default to the SculptForge-style keys (Preferences > Input); a first-start "Coming from: ZBrush /
+- New installs default to the SculptForge-style keys (Preferences > Input); a first-start "Coming from: Classic sculpting keys /
Blender / Maya / New to sculpting" choice sets the key style, and existing users keep their saved choice.
- ZBrush's keys are the **ZBrush-style** option.
+ The Classic sculpting keys are the **Classic** option.
- Contributions are signed off under the Developer Certificate of Origin (`git commit -s`; see CONTRIBUTING.md).
- Faster CI and releases with the same tests (docs/releasing.md):
- **Compiler caching:** compiles go through ccache, cached only by pushes to main and maintainers' own runs.
@@ -504,11 +504,11 @@ All notable changes to SculptForge are listed here. The format follows
release, and drafts the issue replies. It is resumable, and stops with the fix when something is wrong.
### Added
- Selection Sets (**Tool > Selection Sets**, `selection_set_*`): any number of named snapshots per Part of the mask,
- polygroups, visibility, vertex paint, UVs and shape, each holding the channels you tick. Store, restore, rename,
+ face groups, visibility, vertex paint, UVs and shape, each holding the channels you tick. Store, restore, rename,
delete, combine (union / intersect / subtract, also as restore modes onto the current mask and visibility) and a
quick set from the visible faces, each one undo step. A set restores at any subdivision level of its Part (values
carried through the levels as the stack carries attributes; shapes as offsets, so in-between detail stays). Stored
- compactly (runs of masked / painted / hidden elements, run-length polygroups) in projects under the optional
+ compactly (runs of masked / painted / hidden elements, run-length face groups) in projects under the optional
`selection_sets` key (no format version bump; older versions skip it), in `.sfsets` files
(`selection_sets_export` / `selection_sets_import`) and in USD exports as GeomSubsets and primvars, which USD import
reads back. A set with its shape is a morph target: the new **Morph** brush pulls toward it (Alt pushes away) and
@@ -524,10 +524,10 @@ All notable changes to SculptForge are listed here. The format follows
### Added
- The interface in Spanish (#44): **Preferences > Interface > Language** switches between **English** (the default)
and **Español** at once, and Store Config keeps it. The palette bar, the palettes and their sub-palettes
- (Preferences, SubTool, Geometry, Remesh, Masking, Polygroups and more), the top, left and right shelves, the
- LightBox tabs, the command palette (which also finds commands by their Spanish names), Ctrl-help titles and many
- messages are translated; tool and brush names stay as Spanish-speaking ZBrush artists use them (SubTool, QRemesh,
- ZSpheres, LightBox, MatCap, Clay Buildup). The translations are written by hand and compiled into the program;
+ (Preferences, Part, Geometry, Remesh, Masking, Face groups and more), the top, left and right shelves, the
+ Library tabs, the command palette (which also finds commands by their Spanish names), Ctrl-help titles and many
+ messages are translated; tool and brush names stay as Spanish-speaking experienced sculptors use them (Part, QRemesh,
+ Forge Spheres, Library, Lit Sphere, Clay Block). The translations are written by hand and compiled into the program;
anything not yet translated shows in English.
- Maya bridge (#42): **File > Maya** and a SculptForge shelf for Maya (`integrations/maya/sculptforge_maya.py`,
plain `maya.cmds`, released as `sculptforge_maya.zip`). Send the selected meshes from Maya, sculpt, then
@@ -536,9 +536,9 @@ All notable changes to SculptForge are listed here. The format follows
a small, strictly checked manifest; no ports or connections, nothing in the folder is ever run, and the bridge
is off until you choose the folder. **Get automatically** (off by default) checks that folder once a second
(`maya_send` / `maya_receive folder=<folder>`; Help > User Guide > Working with Maya).
-- Mask from the mesh border (#61): **Tool > Masking > By border** masks the open edges of the active SubTool and
+- Mask from the mesh border (#61): **Tool > Masking > By border** masks the open edges of the active Part and
**Rings** (1-20) of edges inside them, so sculpting doesn't move the border (Blender: Mask from mesh
- boundary). **Polygroup borders** also masks where polygroups meet (ZBrush: Mask by polygroup border), **Soft**
+ boundary). **Face group borders** also masks where face groups meet, **Soft**
fades the mask inwards; one undo step. A closed mesh masks nothing and the status bar says it has no open edges
(`mask_border rings=2 polygroups=true soft=true`).
- The support card at launch: a full-window card over a bronze sculpt rendered in SculptForge, with the Supporter
@@ -557,27 +557,26 @@ All notable changes to SculptForge are listed here. The format follows
action with the palette's search, give it your own label and icon, set the menu's key and button. Store Config
keeps them in ui.json; Export / Import shares one menu as a small JSON file holding only action names (unknown
actions are left out, counts and text lengths are capped).
-- Insert your own mesh (#34): **Append > Insert on the model > Active SubTool's copy...** (another SubTool) or
+- Insert your own mesh (#34): **Append > Insert on the model > Active Part's copy...** (another Part) or
**From file...** (`.obj`, `.ply`, `.glb`), dragged onto the surface like the shapes: centred, sized by the drag,
its up axis along the normal, turned by the drag and mirrored by symmetry, one undo step
(`insert_mesh subtool=<name>|file=<path>`).
- **Keep Masked** for Voxel Remesh, Decimate and QRemesh (#43, off by default): masked areas keep their
triangles exactly; the rest is rebuilt and, for the remeshers, joined to them along the mask's edge with a
strip of triangles so the model stays closed (`keep_masked=true` on `remesh`, `decimate`, `qremesh`).
-- Triple-click another SubTool in the viewport to make it the active one and frame it (#43).
-- **Preferences > Input > Hold Space and drag to move the camera** (#43, off by default since ZBrush's Space opens
- the QuickMenu): with Space held, left-drag rotates, right- or middle-drag pans and Ctrl+drag zooms, anywhere on
+- Triple-click another Part in the viewport to make it the active one and frame it (#43).
+- **Preferences > Input > Hold Space and drag to move the camera**: with Space held, left-drag rotates, right- or middle-drag pans and Ctrl+drag zooms, anywhere on
the canvas; never while typing in a text field.
- Twelve more built-in alphas (#43): Pores, Cracks, Scales, Rivets, Stitches, Fabric Weave, Bark, Rock Strata,
Wrinkles, Skin Folds, Hair Strands and Dot Grid; and six more VDM brushes: Rivet, Stitches, Skin Fold, Wrinkle
Line, Crack and Rock Ledge. All are generated in code the first time they're used (no downloaded or bundled
- image files), with thumbnails in the pickers and the LightBox (whose Brush tab now lists the built-in VDMs too).
+ image files), with thumbnails in the pickers and the Library (whose Brush tab now lists the built-in VDMs too).
### Fixed
-- Focal Shift now shapes brushes that use an alpha, as in ZBrush (#60): the alpha is multiplied by the round
+- Focal Shift now shapes brushes that use an alpha (#60): the alpha is multiplied by the round
falloff Focal Shift controls, so at -100 the whole alpha shows hard to its edges, at 0 a Square alpha's corners
round off into a soft mound, and at +100 only a soft point in the middle is left. Before, alpha brushes always
- behaved as at -100. Focal Shift also reaches the built-in ClayBuildup's square tip and custom (Brush Lab)
+ behaved as at -100. Focal Shift also reaches the built-in Clay Block's square tip and custom (Brush Lab)
brushes now, which ignored it; at 0 they keep their own tip exactly as before.
- SelectRect and SelectLasso (hide / show) ignored symmetry (#51 follow-up): with X / Y / Z on, the mirror image of
the shape counts as inside too, as with MaskRect and MaskLasso (`hide_rect` / `hide_lasso symmetry=x`).
@@ -587,18 +586,18 @@ All notable changes to SculptForge are listed here. The format follows
### Added
- Preferences > Tablet > Mouse mode (relative) (#54): for tablets whose driver is set to mouse mode, the pen moves
the cursor by how far it moves, like a mouse.
-- Alternate smooth (#40, as in ZBrush): start a stroke with Shift held, then let go of Shift while still pressing,
+- Alternate smooth: start a stroke with Shift held, then let go of Shift while still pressing,
and the rest of the stroke smooths without shrinking the form (a Taubin smooth). Brush > Smooth keeps volume
makes that the Shift / Smooth brush smooth (letting go of Shift then switches to the plain one).
- Ctrl+drag on the background with MaskPen draws a mask rectangle while dragging (#48) and masks what it covers;
- one that covers none of the model clears the mask, as before (and as in ZBrush, without DynaMesh's remesh).
+ one that covers none of the model clears the mask, as before.
- Axis gizmo (#43): click an end of the X / Y / Z gizmo in the canvas corner to snap to that side view
(orthographic), as in Blender; the negative ends are drawn too and the end under the pointer is ringed.
- Undo and Redo on the right shelf (#43); stored layouts get them at the top once (layout version 3).
- **Continuous** is also in the left shelf's stroke picker, under the stroke tiles (#43).
- Insert on the model respects X / Y / Z symmetry (#43): a mirrored copy on the other side, one undo step
(`insert_primitive symmetry=x`).
-- SubTool thumbnails in the SubTool list (#43), drawn from each SubTool's existing GPU buffers (no upload, the
+- Part thumbnails in the Part list (#43), drawn from each Part's existing GPU buffers (no upload, the
motion proxy on dense meshes), one per frame at most and only once a change has settled, never during a stroke.
- Ways to support SculptForge (memberships on the website; the app stays free and behaves the same for
@@ -652,7 +651,7 @@ All notable changes to SculptForge are listed here. The format follows
parametrization whose grid lines are the edge loops, with feature lines and guides on grid lines and the poles
on grid points, extracted at the target density. Poles appear only where the form needs them (a sphere gets
exactly eight, a box one per corner) and loops run unbroken; open QRemesh Guides are exact edge loops; hard
- edges and polygroup borders (Keep Groups) are kept on their exact place; polypaint density adds the pole pairs a
+ edges and face group borders (Keep Groups) are kept on their exact place; vertex paint density adds the pole pairs a
change of density needs; symmetry mirrors the field and the result exactly; the result is deterministic.
Loop-aware relaxation lets vertices slide along loops on ridges but not off them. Against the legacy method on
the lion scan, the ICT head, a creature sculpted from a sphere and a hard-surface part at 2k / 5k / 10k quads:
@@ -682,7 +681,7 @@ All notable changes to SculptForge are listed here. The format follows
as with every brush. Each move touches only the points inside an adaptive cutoff (where the move is still more
than 4% of its largest, the last part faded smoothly to 0), evaluates the kernel from a radial table, works out a
fast drag in pieces in one pass, and passes on only what moved to undo, normals and the BVH. KelvinGrab and
- DetailClone are on the bottom shelf; all five are in the brush picker, the LightBox and the `stroke` command.
+ DetailClone are on the bottom shelf; all five are in the brush picker, the Library and the `stroke` command.
On dense meshes a long move is applied at most about a brush radius per frame (the rest in the next frames),
the far field is evaluated on a coarse lattice and, over 400k vertices, deferred to a world lattice that a
sixth of the vertices take each frame (all of it when the stroke ends), and the cutoff tightens up to 10% of
@@ -694,7 +693,7 @@ All notable changes to SculptForge are listed here. The format follows
offset from a smooth base (the broad form as a fitted quadric, the rest by implicit fairing with the rim held),
in the base's own tangent frame, so overhangs and sideways leans come along. Options: Base Smoothing, Edge Fade,
Resolution, Fit plane, Invert. **Use as Alpha**, **Use as VDM**, **Detail Clone** or **Save to Library** (the
- alpha as a PNG in the LightBox Alphas folder, the VDM in the brush library; VDMs now show in the LightBox Brush
+ alpha as a PNG in the Library Alphas folder, the VDM in the brush library; VDMs now show in the Library Brush
tab with their thumbnails). Commands `capture_alpha` and `capture_vdm`.
- **DetailClone** brush: stamps the VDM brush's map along the stroke, one copy every stamp width (Clone Spacing),
each turned to follow the stroke (Clone follows stroke) and shaped to the surface under it; a click stamps one.
@@ -719,12 +718,12 @@ All notable changes to SculptForge are listed here. The format follows
### Added
- **Local API for other programs** (#36): Preferences > Input > Local API (or `SF_LOCAL_API=1`) serves commands to
programs on this computer on 127.0.0.1 with a token in `api.json`; new `mesh_read` and `mesh_set_positions`
- read the active SubTool's coordinates and write them back as one undoable step (topology checked).
+ read the active Part's coordinates and write them back as one undoable step (topology checked).
- **Maya navigation style** (#32): Preferences > Input > Maya: Alt+left orbits, Alt+middle pans, Alt+right zooms;
Ctrl inverts, Ctrl+Alt masks.
- **Focal length** (#26): Draw > Camera > Focal Length (15-300 mm, full-frame) with 35 / 50 / 85 / 135 presets,
saved with the project.
-- **More primitives** (#31): Append > Cylinder, Cone, Torus, Capsule, Icosphere, Quad Sphere (quads, one polygroup
+- **More primitives** (#31): Append > Cylinder, Cone, Torus, Capsule, Icosphere, Quad Sphere (quads, one face group
per part); **Insert on the model** (#34): pick a primitive in Append > Insert and drag on the surface to add it
along the normal, sized by the drag (`insert_primitive`); **Continuous** stroke option (keeps dabbing while the
brush rests); an **X / Y / Z axis gizmo** in the canvas corner (Draw > Camera > Axes).
@@ -737,11 +736,11 @@ All notable changes to SculptForge are listed here. The format follows
- Windows builds: proof mode's `small` / `near` names clashed with Windows headers.
- **Micro levels: hundreds of millions of sculptable polygons** (**Tool > Geometry > Micro**, `micro_*`
- commands). Above the highest subdivision level a SubTool can carry a micro level: per triangle a regular grid of
+ commands). Above the highest subdivision level a Part can carry a micro level: per triangle a regular grid of
16-bit heights along the interpolated normal of the smooth (Phong-tessellated) base, instead of a mesh.
300 million micro triangles take 374 MB (1.25 bytes each; the whole app about 0.8 GB), where a mesh of that size
- would need about 27 GB. Unlike ZBrush's HD Geometry the whole model is sculptable at once.
- - Brushes: Standard, Clay, Clay Buildup, Smooth, Inflate, Flatten, Trim, Layer, Pinch / Crease / Dam Standard
+ would need about 27 GB. Unlike high-detail geometry the whole model is sculptable at once.
+ - Brushes: Standard, Clay, Clay Block, Smooth, Inflate, Flatten, Trim, Layer, Pinch / Crease / Sharp Crease
(as height sharpening), Mask; symmetry, Focal Shift, pressure and the mask apply. Big brushes are evaluated on
a coarser grid and interpolated (scale-adaptive). Move reshapes the base below the micro level and the detail
rides along (dual scale); "Move along normals" moves the micro surface itself.
@@ -751,7 +750,7 @@ All notable changes to SculptForge are listed here. The format follows
- Bake Micro (to a mesh), Export Displacement (32-bit EXR or 16-bit PNG, scalar or vector, over the base UVs).
- Undo: a packed journal per stroke (tiles in Morton order, each tile's change predicted and packed).
- Very large levels stay out of core in a sparse memory-mapped file (only what you touch is in memory).
- - Projects: format 7 when a SubTool has a micro level (others stay format 6 for older versions).
+ - Projects: format 7 when a Part has a micro level (others stay format 6 for older versions).
- `sculptforge --bench-micro --bench-sizes 33,100,300` measures it. Guide chapter "Micro levels".
- Automatic hardware detection and calibration. On first launch, and again when the graphics card, its driver or
the version changes, SculptForge spends about a second or two (under a small overlay; Esc skips) measuring
@@ -781,7 +780,7 @@ All notable changes to SculptForge are listed here. The format follows
whole material under the cursor. Paint layers hold every channel: channel chips on each layer row turn a
channel on or off for that layer, and give it its own blend mode and opacity, including **Normal Combine** for
normals (`texture_layer_channel`). Height also yields a normal combined onto the Normal channel. One undo step
- per stroke, kept per layer and channel. Auto UV, Voxel Remesh, QRemesh and merging SubTools carry every channel.
+ per stroke, kept per layer and channel. Auto UV, Voxel Remesh, QRemesh and merging Parts carry every channel.
See the guide's Material painting page.
- Solo channel view: **Tool > Texture Map** shows one channel on the model (roughness and the other scalars in
grey, the normal as colours, emission in colour), live while painting (`channel_view`).
@@ -811,11 +810,11 @@ All notable changes to SculptForge are listed here. The format follows
(0 removes it, 2 doubles it) without redoing the strokes after it; where later strokes overlap it they keep
their own displacement on top (they aren't sculpted again; see the guide's Sculpt Timeline chapter). Seeking
reuses undo's per-stroke deltas, swaps runs of strokes at once with one normal / BVH / GPU update, and jumps
- from full checkpoints every 16 steps (within 1 GB; fewer on huge meshes) for long seeks. Each SubTool keeps
+ from full checkpoints every 16 steps (within 1 GB; fewer on huge meshes) for long seeks. Each Part keeps
its own timeline. Commands `timeline_info`, `timeline_seek`, `timeline_select`, `timeline_retune`,
`timeline_save`, `timeline_load`; UI test timeline.
- **Save with project** (in the timeline's header) also writes the history beside the project as
- `<name>.sfhist` (strokes, masks, polypaint, visibility, polygroups, branches, re-tuned strengths; a topology
+ `<name>.sfhist` (strokes, masks, vertex paint, visibility, face groups, branches, re-tuned strengths; a topology
change cuts it). Opening the project brings it back when the mesh matches. The project format is unchanged.
- **Export timelapse**: the history rendered as a turntable video, the model building up stroke by stroke while
the camera goes once around it (1080p or 4K MP4, no captions; needs ffmpeg). Also
@@ -827,7 +826,7 @@ All notable changes to SculptForge are listed here. The format follows
it and written as a JSON result with the processor, graphics card, memory, OS, version and commit.
`docs/benchmark.md` describes the format, `tools/benchmark/submit.py` checks results and adds them to
`website/benchmarks/results.json`, which the new benchmarks page lists.
-- The brush cursor follows the surface (#25), as in SculptGL: over the model the Draw Size and Focal Shift rings
+- The brush cursor follows the surface (#25): over the model the Draw Size and Focal Shift rings
lie on the surface under the pointer, turned to its (smoothed) direction and pressed onto its shape, at the
brush's real size there, with a short normal line; with symmetry on, a fainter mirrored ring shows too. Every
brush (sculpt, paint, mask, dynamic topology). A few dozen BVH ray casts per drawn frame, no pass over the mesh
@@ -875,7 +874,7 @@ longer pause when you lift it. Also from your reports: a right click opens the Q
with symmetry remeshes both sides of an asymmetric mesh (#23) and the orthographic view shades correctly (#24).
### Added
-- A right click on the canvas opens the QuickMenu under the cursor, as in ZBrush (#22). Pressed and let go
+- A right click on the canvas opens the QuickMenu under the cursor (#22). Pressed and let go
without moving more than 4 px, beside the model or on it; the view waits until the press moves past that, so
a click never nudges it, and a right drag turns, pans or zooms as before (by everything it moved, nothing
lost). A pen button set to Right click works the same; SDL's own mouse click for another pen button doesn't
@@ -905,7 +904,7 @@ with symmetry remeshes both sides of an asymmetric mesh (#23) and the orthograph
- Starting a stroke no longer re-uploads the whole mesh when there are no LODs.
### Fixed
-- The orthographic view (Numpad 5) shaded MatCaps and the lights as if inside out (#24): the shader worked out
+- The orthographic view (Numpad 5) shaded Lit Spheres and the lights as if inside out (#24): the shader worked out
each pixel's view ray as in a perspective view, which in an orthographic one tilted it far off the axis
towards the edges. An orthographic view now gives every pixel the axis; flat shading turns its facets
towards the viewer by that ray too (the direction from the eye, which an orthographic view can put inside
@@ -927,10 +926,10 @@ a flat background, a Flatpak, strokes that keep their shape on dense meshes (bui
and a fix for Divide crashing on models from Blender, with a log file so a crash is never silent again.
### Added
-- Extract (Tool > SubTool > Extract), as in ZBrush: the masked, visible part of a SubTool becomes a shell with Thick (a share of the SubTool's size; negative grows inward, 0 makes a single-sided surface), E Smt (smooths the stepped edge) and Double (both ways). Extract shows a preview below the source that follows the settings; Accept keeps it as a new SubTool with outer, inner and rim polygroups and the source's polypaint, as one undo step (undo removes the SubTool, redo puts it back). TCorne and TBorder make the rim triangles instead of quads at sharp corners or all along it. An unaccepted preview goes when the source changes and is never saved. Commands: extract, extract_accept, extract_cancel.
-- Mirror And Weld (Tool > Geometry > Modify Topology, X / Y / Z): keeps the + side of the plane through the origin, cuts polygons crossing it, mirrors the half and welds the seam into one watertight mesh, keeping polygroups, polypaint, mask, UVs, quads and sculpt layers (`mirror_and_weld`, with `side=negative` for the other half). Undoable.
+- Extract (Tool > Part > Extract): the masked, visible part of a Part becomes a shell with Thick (a share of the Part's size; negative grows inward, 0 makes a single-sided surface), E Smt (smooths the stepped edge) and Double (both ways). Extract shows a preview below the source that follows the settings; Accept keeps it as a new Part with outer, inner and rim face groups and the source's vertex paint, as one undo step (undo removes the Part, redo puts it back). TCorne and TBorder make the rim triangles instead of quads at sharp corners or all along it. An unaccepted preview goes when the source changes and is never saved. Commands: extract, extract_accept, extract_cancel.
+- Mirror And Weld (Tool > Geometry > Modify Topology, X / Y / Z): keeps the + side of the plane through the origin, cuts polygons crossing it, mirrors the half and welds the seam into one watertight mesh, keeping face groups, vertex paint, mask, UVs, quads and sculpt layers (`mirror_and_weld`, with `side=negative` for the other half). Undoable.
- A flat viewport background (#21): Preferences > Display > Background (also in the Render palette) switches between the gradient (the default) and Flat Colour with a colour picker. Store Config keeps it, projects keep their own, and `set_background` (mode, color) scripts it.
-- Mirror (Tool > Deformation, X / Y / Z): flips the SubTool across the plane through the origin, or in place with `pivot=center` (`mirror`). Undoable.
+- Mirror (Tool > Deformation, X / Y / Z): flips the Part across the plane through the origin, or in place with `pivot=center` (`mirror`). Undoable.
- A log file, `sculptforge.log` in the user data folder (`%APPDATA%\SculptForge\SculptForge` on Windows,
`~/Library/Application Support/SculptForge/SculptForge` on macOS, `~/.local/share/SculptForge/SculptForge` on
Linux), so a crash is never silent: it holds the version, system and GPU, everything SDL_Log reports (the
@@ -978,39 +977,39 @@ and a fix for Divide crashing on models from Blender, with a log file so a crash
## [0.9.5] - 2026-10-31
-The day after launch, people filed ten issues. 0.9.5 answers all of them: ZSpheres for blocking out a base mesh,
-a Blender input style, flat shading, your own MatCaps, SpaceMouse navigation (experimental), an idle app that no
+The day after launch, people filed ten issues. 0.9.5 answers all of them: Forge Spheres for blocking out a base mesh,
+a Blender input style, flat shading, your own Lit Spheres, SpaceMouse navigation (experimental), an idle app that no
longer keeps the graphics card busy, and fixes for pens on Windows and Linux, the S slider and the Blender Bridge.
Thank you for the reports.
### Added
-- ZSpheres (Tool > ZSpheres, #8): block out a base mesh from connected spheres. Draw grows a sphere from another (the drag sets its size) or adds a joint on a link, Move and Scale set the proportions, Alt+click deletes, Symmetry mirrors every edit, Preview (A) shows the skin, and Make Mesh builds it as a new watertight quad SubTool with a polygroup per link, keeping the ZSpheres hidden to edit again. Undoable, saved in projects, and scriptable (zsphere_new, zsphere_add, zsphere_set, zsphere_delete, zsphere_insert, zsphere_preview, zsphere_make_mesh, zsphere_list).
+- Forge Spheres (Tool > Forge Spheres, #8): block out a base mesh from connected spheres. Draw grows a sphere from another (the drag sets its size) or adds a joint on a link, Move and Scale set the proportions, Alt+click deletes, Symmetry mirrors every edit, Preview (A) shows the skin, and Make Mesh builds it as a new watertight quad Part with a face group per link, keeping the Forge Spheres hidden to edit again. Undoable, saved in projects, and scriptable (`zsphere_new`, `zsphere_add`, `zsphere_set, zsphere_delete, zsphere_insert, zsphere_preview, zsphere_make_mesh, zsphere_list`).
- A Blender input style (#12): **Preferences > Input > Style > Blender**, also at the top of the Controls window.
Middle-drag orbits, Shift+middle pans, Ctrl+middle zooms, and Alt+left-drag does the same for pens and
trackpads (Emulate 3 Button Mouse); Ctrl inverts a stroke, Shift smooths; F / Shift+F set the radius and
strength; Blender 4.2+'s Sculpt Mode keys pick the nearest brushes (V Draw, S Smooth, P Pinch, I Inflate,
G Grab, C Clay Strips, Shift+C Crease, K Snake Hook, Shift+T Scrape as Flatten) and M the Mask brush
(Ctrl+drag unmasks); Alt+M / Ctrl+I clear / invert the mask; H / Shift+H / Alt+H hide, isolate and show
- polygroups; Alt+1 / Alt+2 step the subdivision levels; Home frames everything. Choosing it sets Rotation to
+ face groups; Alt+1 / Alt+2 step the subdivision levels; Home frames everything. Choosing it sets Rotation to
Turntable. **Emulate Numpad** makes the number row work as the numpad.
- **Import Blender keymap...**: reads a keymap exported from Blender (the .py file, as text: it is never run) and
takes the 3D View and Sculpt keys SculptForge has an equivalent for. Also the `blender_keymap_import` command.
- Numpad views in every input style: Numpad 1 / 3 / 7 front, right, top (Ctrl: back, left, bottom), Numpad 5
orthographic, Numpad 4 / 6 / 8 / 2 orbit in 15 degree steps, Numpad 9 the other side, Numpad . frames the
- active SubTool, Numpad Plus / Minus zoom.
+ active Part, Numpad Plus / Minus zoom.
- An orthographic view. The axis views turn it on until the view is rotated again (Blender's Auto Perspective).
-- Custom MatCaps (#15): **Material > Load MatCap...** loads a lit-sphere image (PNG, JPG or EXR; non-square images
- are cropped to the centre, large ones scaled to 1024) as a material and copies it into the new **MatCaps** folder
- of the library (Documents/SculptForge/MatCaps); images in that folder load at start-up and, when added later,
+- Custom Lit Spheres (#15): **Material > Load Lit Sphere...** loads a lit-sphere image (PNG, JPG or EXR; non-square images
+ are cropped to the centre, large ones scaled to 1024) as a material and copies it into the new **Lit Spheres** folder
+ of the library (Documents/SculptForge/Lit Spheres); images in that folder load at start-up and, when added later,
the next time a material list opens (a cheap size and time check), and folders listed in `SCULPTFORGE_MATCAP_PATH`
- load at start-up. They show in the material picker, palette and LightBox. Right-click > **Remove** takes one out
+ load at start-up. They show in the material picker, palette and Library. Right-click > **Remove** takes one out
of the lists and moves its image to the trash (freedesktop trash on Linux, Recycle Bin on Windows; on macOS it
is hidden for the session and the message says where the file is). A project
using one embeds it as a PNG (an `attachments` entry; no format change), so it opens with the same look anywhere.
Scripts: `load_matcap path=...`, `remove_matcap name=...`, `set_material name=<your MatCap>`.
- Smooth / Flat shading (#11): **Material** palette (and **Tool > Display**) > **Shading** switches the whole
- scene to flat, faceted shading, where every polygon shows its own face; **This SubTool** keeps one SubTool smooth
+ scene to flat, faceted shading, where every polygon shows its own face; **This Part** keeps one Part smooth
or flat whatever the scene says. Both are saved in projects (no format change; older files open with your
preferred shading) and the scene's choice is a preference (Store Config). Smooth stays the default. Scripts:
`set_shading mode=flat`, `subtool_shading mode=smooth name=Eyes`.
@@ -1024,14 +1023,14 @@ Thank you for the reports.
3DxWare (Windows, macOS) or spacenavd (Linux) holds the device. UI tests drive a virtual joystick with a
SpaceMouse Compact's ids (`spacemouse`, `spacemouse_hold`, `spacemouse_button`, `spacemouse_unplug` steps).
### Fixed
-- The Blender Bridge add-on zip was missing `zbrush_keys.py`, so Blender refused to install it ("cannot import name zbrush_keys", #10). The zip now carries every module, and the packaging check fails if one is left out.
+- The Blender Bridge add-on zip was missing its classic keys module, so Blender refused to install it (#10). The zip now carries every module, and the packaging check fails if one is left out.
- Rotating, panning and zooming with the pen tip on the background only shook the view with some tablets (a Ugee
M708 on Linux, #7): their drivers send stray mouse events between the pen's, and the view followed both. The
pen now moves the view by its own motion only, and lifting the pen ends a view drag as it ends a stroke.
- The S / U / I / O slider closed as soon as you grabbed it, and could open away from the cursor (#9, seen on
Windows). It now opens with its knob (the current value) right under the brush cursor, at any UI scale and
with a pen, and stays open while you drag until you let go, click elsewhere or press Esc.
-- B, M, S and the LightBox key followed the built-in key even after you gave the action another one.
+- B, M, S and the Library key followed the built-in key even after you gave the action another one.
- Pens through Windows Ink (a Wacom Intuos Pro, #13): taps on menus and buttons often missed, Alt+pen drag and the
Move button threw the model off the canvas, and the S / U / O slider could not be dragged. Windows Ink and some
drivers send mouse events of their own beside the pen's, at an old position; the interface followed them as
@@ -1066,15 +1065,15 @@ current tool, and the bottom shelf's brush tiles are bigger, with a size you can
### Added
- Bottom shelf tile sizes: Small, Medium (the new default, bigger than before) and Large. Right-click a brush on
the shelf and choose **Tile size**, or use **Preferences > Interface > Shelf tiles**.
-- **File > Export STL...** as its own menu item (it was inside the ZBrush (GoZ) submenu).
+- **File > Export STL...** as its own menu item (it was inside the Bridge submenu).
### Changed
- Soft Clay is the default material: matte, with a clear light and shadow side and a soft rim, so sculpted
detail reads at a glance. It is first in the material picker; a material you picked before is kept.
-- Orange now marks only the current tool or mode (Draw, Sculpt...). Options that are on (Zadd, symmetry X,
+- Orange now marks only the current tool or mode (Draw, Sculpt...). Options that are on (Add, symmetry X,
Pressure > Strength, Mask, Paint...) are a lighter grey with a thin orange line.
- Every brush icon is drawn the same way, with a mark showing what the brush does.
-- The right tray's sections, the selected SubTool and the colour picker have a calmer, tidier style.
+- The right tray's sections, the selected Part and the colour picker have a calmer, tidier style.
### Fixed
- The Alpha palette showed **Load image...** and **Invert loaded image** twice.
@@ -1120,13 +1119,13 @@ Maquette to performance: scan with your phone, make the scan sculptable, give a
drive them with your own face.
### Make sculptable (splat capture -> sculptable, animation-ready mesh)
-- Splats palette > **From scan > Make sculptable**: one click turns the capture into a new SubTool next to the
+- Splats palette > **From scan > Make sculptable**: one click turns the capture into a new Part next to the
splats (which are hidden, not deleted): a watertight, manifold surface (opacity-weighted Gaussian density on a
voxel grid, built in parallel z slabs with the same result on any thread count; gaps closed; floater shells
dropped; space boxed in on 5 of 6 sides filled, which seals open bottoms; largest piece kept), QRemesh quads at
a **Game** (4,000), **Film** (12,000) or **Sculpt** (2,000 + 2 subdivision levels with the scan projected onto
- the top) budget, and the capture's colours as polypaint or an Auto UV texture (splats inside the subject are
- faded out). A hidden "<name> Scan" SubTool keeps the dense surface for ProjectAll.
+ the top) budget, and the capture's colours as vertex paint or an Auto UV texture (splats inside the subject are
+ faded out). A hidden "<name> Scan" Part keeps the dense surface for ProjectAll.
- **Face loops**: a face is looked for on the scan from the current view (depth and colour, no ML model, no
download): eye corners, nose tip, mouth corners and chin become QRemesh Guides (rings round the eyes and the
orbits, the lips, the nasolabial loop), mirrored, with QRemesh symmetry. **Review** stops after the scan to
@@ -1135,7 +1134,7 @@ drive them with your own face.
holes, All pieces, Keep scan. Progress bar and Cancel; Ctrl-hover help; F3 entries.
- Commands: `splat_to_mesh` now runs the whole pipeline (`detail`, `preset`, `target`, `levels`, `face_guides`,
`landmarks`, `front`, `up`, `color`, `texture_size`, `crop`, `fill_holes`, `keep_parts`, `keep_scan`, `stage`
- scan/finish, ...; `resolution` still works) and adds SubTools instead of replacing the sculpt; `face_guides`;
+ scan/finish, ...; `resolution` still works) and adds Parts instead of replacing the sculpt; `face_guides`;
`splat_test_capture` (a built-in test head or mug capture, no download).
- 5 million splats to Film quads with face loops in about 9 s, 0.9 GB (M1 Pro).
- Guide chapter "From scan to sculptable mesh"; UI test `make_sculptable.sfui`; UI tests: `drag_landmark` verb,
@@ -1143,19 +1142,19 @@ drive them with your own face.
### Added
- Facial shapes (Tool > Facial Shapes, `face_shapes_generate`): the 52 Apple ARKit blend shapes, exactly named, as
- sculpt layers on the active SubTool, from a built-in template head (ICT-FaceKit's ICT Face Model Light, MIT):
+ sculpt layers on the active Part, from a built-in template head (ICT-FaceKit's ICT Face Model Light, MIT):
automatic or landmark-guided fit (similarity + non-rigid ICP), deformation transfer (Sumner and Popovic 2004) so
the shapes follow the sculpt's proportions, mirrored Left/Right on symmetric sculpts, made on a low subdivision
- level and carried up with the detail. Eye SubTools get eyeLook rotations, teeth and tongue the lower jaw's motion,
+ level and carried up with the detail. Eye Parts get eyeLook rotations, teeth and tongue the lower jaw's motion,
brows and lashes follow the skin. Face test presets and a slider per shape; `face_landmarks_detect`,
`face_preset`.
-- Live face: `face_weights json={...}` sets ARKit-named shape weights on every SubTool, re-evaluating only the
+- Live face: `face_weights json={...}` sets ARKit-named shape weights on every Part, re-evaluating only the
vertices they move (no undo step, partial GPU upload; about 9 ms for all 52 on a 700k-vertex head on an M1 Pro).
- Face takes: play recorded face feeds (JSON frames, `face_take_play`), bake them (`face_take_bake`) into a glTF
animation of the morph target weights (GLB) and USD blend shape weight time samples; saved with the project.
- `new_head`: a new scene with a life-size human head (with mouth and eye sockets) and its eyes.
- Blender bridge: sculpt layers arrive as shape keys with their names and weights (a `.shapes` file beside each
- .GoZ, which now holds the base shape when the mesh has layers).
+ Bridge file, which now holds the base shape when the mesh has layers).
- UI tests: `zoom` and `look` steps; `run` expands `$SCRIPT_DIR`.
- Splat training from captures (Splats > Train from capture): a phone video, a folder of photos, a phone-link
capture or a COLMAP / nerfstudio dataset becomes a Gaussian splat that appears in the viewport after the first
@@ -1165,16 +1164,16 @@ drive them with your own face.
SHA-256, or a path / `SCULPTFORGE_BRUSH`; COLMAP (BSD; downloaded on request on Windows) for camera positions,
skipped for captures with AR poses in `capture.json`; ffmpeg for video, keeping the sharpest frame of each
stretch. The result is centred and levelled from the camera positions, saved next to the capture and copied to
- the LightBox Splats tab. Dropping a video onto the window trains it. Commands `splat_train` and
+ the Library Splats tab. Dropping a video onto the window trains it. Commands `splat_train` and
`splat_train_cancel` (blocking in sculptforge-cli, Python and MCP). Guide chapter "Scan an object into a splat";
a generated CC0 test capture (tools/splat/make_test_capture.py, tests/data/splat_capture).
-- **Capture from phone** (File > Capture from phone, or the phone button in the LightBox; guide chapter "Phone capture
+- **Capture from phone** (File > Capture from phone, or the phone button in the Library; guide chapter "Phone capture
and AR", design in docs/phone-link.md): scan the QR code and the phone's browser becomes SculptForge's camera,
with no app and no account. Send a scan video or a photo burst (with coaching; for splat training), one photo
(to Image to 3D), or a splat .ply from Scaniverse, Polycam or Luma; uploads are chunked and resume after Wi-Fi
drops, and land in `<library>/Captures/<date_time>-<kind>/` with a `capture.json`. **View in AR** shows the
- active SubTool or the scene on your desk (USDZ for iPhone AR Quick Look, GLB for Android Scene Viewer; reduced to
- 80k triangles, polypaint and textures baked, re-exported after strokes). **Face capture** tracks 52 ARKit
+ active Part or the scene on your desk (USDZ for iPhone AR Quick Look, GLB for Android Scene Viewer; reduced to
+ 80k triangles, vertex paint and textures baked, re-exported after strokes). **Face capture** tracks 52 ARKit
expressions and the head on the phone (MediaPipe Face Landmarker) and streams them to SculptForge at about 30 fps
over a WebRTC data channel, for `face_weights`; **Record face take** saves them as JSON Lines. LAN only, a new
token per session, size limits, safe file names; nothing listens while the window is closed.
@@ -1183,68 +1182,68 @@ drive them with your own face.
- Website: the face capture page (`website/link/`), which needs HTTPS for the phone's camera.
- Services: `services/link-worker`, a Cloudflare Worker (free plan) that relays the face page's one encrypted
connection message to the desktop at `link.sculptforge.app`; ntfy.sh stays as the fallback. Not deployed yet.
-- "Fixes & suggestions" in the LightBox header (shown at startup) and the Help menu: opens the bug report and
+- "Fixes & suggestions" in the Library header (shown at startup) and the Help menu: opens the bug report and
feature request forms on GitHub.
### Changed
- The website moved to https://sculptforge.app (old islandmed.github.io/SculptForge links redirect). The
app, update check, user guide, packages and Blender add-on link there.
-- Website: the tagline now reads "the free, open-source alternative to ZBrush and Mudbox".
+- Website: the tagline now reads "the free, open-source sculpting app".
## [0.8.1] - 2026-10-25
-Fixes from a ZBrush artist's testing, and ZTools from ZBrush.
+Fixes from a professional sculptor's testing, and a way to bring a library over.
-### ZBrush feel (tester feedback on 0.7)
-- ZBrush input style: every zoom drag (Ctrl+right-drag, Alt-drag then release Alt,
- Ctrl+middle-drag) zooms out when dragged up, as in ZBrush; the SculptForge style keeps zooming in.
- Rotation and panning were checked and already follow the cursor as in ZBrush.
-- Ctrl brushes, as in ZBrush: while Ctrl is held the left shelf shows the mask brush (MaskPen,
+### Classic feel (tester feedback on 0.7)
+- Classic input style: every zoom drag (Ctrl+right-drag, Alt-drag then release Alt,
+ Ctrl+middle-drag) zooms out when dragged up; the SculptForge style keeps zooming in.
+ Rotation and panning were checked and already follow the cursor.
+- Ctrl brushes: while Ctrl is held the left shelf shows the mask brush (MaskPen,
MaskLasso, MaskRect) and its stroke (Dots, Lasso, Rect); the Brush picker (Ctrl+B or a
Ctrl+click on the brush tile) and the Stroke picker opened with Ctrl held pick among them.
Ctrl+Shift does the same for SelectRect and SelectLasso. Tool > Masking and Tool >
Visibility keep their buttons.
-- Polygroups > **Group by UVs** (ZBrush UV Groups): one polygroup per UV island of the visible mesh, undoable;
+- Face groups > **Group by UVs**: one face group per UV island of the visible mesh, undoable;
`polygroup_uv` command for the console, CLI, MCP and Python.
-### Texture painting (ZBrush tester feedback)
+### Texture painting
- **New Texture** on the top shelf and in the Color palette whenever the Paint brush (or Rgb) is on and the
- SubTool has no texture: one click starts texture painting, running Auto UV first (with its progress in the
+ Part has no texture: one click starts texture painting, running Auto UV first (with its progress in the
status bar) when there are no UVs. Ctrl-hover help; also in F3 search.
- Faster texture strokes: a dab paints its texels in parallel over 16-row bands with the same result on any
number of threads, and the view uploads only the 64x64 tiles that changed. A big-brush dab on a 4K texture
went from 29 to 6 ms (1.3K triangles) and from 47 to 11 ms (328K triangles) on an M1 Pro
(docs/performance.md).
- Checked that texture paint doesn't depend on the mesh density: a hard stamp gives the same texels on a
- 2-triangle plane as on an 8K-triangle one (new unit test). Paint that looks as coarse as the mesh is polypaint:
- the Vertex target, or polypaint shown multiplied over the texture.
+ 2-triangle plane as on an 8K-triangle one (new unit test). Paint that looks as coarse as the mesh is vertex paint:
+ the Vertex target, or vertex paint shown multiplied over the texture.
-### ZTools from ZBrush
-- **SculptForge ZTool Export**, a ZBrush plug-in (`integrations/zbrush`, ZScript, GPL-3.0-or-later, attached to
- releases): ZPlugin > SculptForge > **Convert ZTL** / **Save for SculptForge** writes every SubTool of a ZTool at
+### Bring a library over
+- **Bridge export plug-in** (`integrations/bridge-plugin`, script, GPL-3.0-or-later, attached to
+ releases): **Convert** / **Save for SculptForge** writes every Part of a library file at
its highest subdivision level as `<name>.sf<NNN>_<SubTool>.GoZ` next to the `.ZTL`.
-- Opening a `.ZTL` (File > Open, drag and drop, `open`) opens that conversion as SubTools in order, with names,
- polygroups, polypaint, mask and UVs, and warns when the `.ZTL` is newer than the conversion; without one the
+- Opening a `.ZTL` (File > Open, drag and drop, `open`) opens that conversion as Parts in order, with names,
+ face groups, vertex paint, mask and UVs, and warns when the `.ZTL` is newer than the conversion; without one the
message points to the plug-in. A folder of numbered `.GoZ` files (`<name>.sculptforge`) opens the same way.
## [0.8.0] - 2026-10-25
-Dynamic topology (Sculptris Pro), vector displacement brushes, QRemesh Guides, sculpt layers on every
-subdivision level, and ZBrush-style keys in Blender's Sculpt Mode.
+Dynamic topology, vector displacement brushes, QRemesh Guides, sculpt layers on every
+subdivision level, and the Classic sculpting keys in Blender's Sculpt Mode.
-### Dynamic topology (ZBrush's Sculptris Pro)
+### Dynamic topology
Guide chapter docs/guide/dynamic-topology.md.
- **Dynamic** on the top shelf (and in the Draw palette): every brush except Move, masking and painting remeshes
the surface under it each dab: splits long edges (on the curve the normals describe), collapses short ones,
flips for even valences and relaxes the new vertices, only inside the brush.
-- **Detail** slider (0-100): the target edge length relative to the brush radius (Sculptris Pro), or with the
+- **Detail** slider (0-100): the target edge length relative to the brush radius (dynamic topology), or with the
**Constant detail** preference one size for the whole mesh. Smooth remeshes towards twice the size, so it
simplifies.
-- Keeps the mesh manifold with no degenerate or flipped triangles; boundaries, polygroup borders and the
+- Keeps the mesh manifold with no degenerate or flipped triangles; boundaries, face group borders and the
symmetry plane only slide along themselves; fully masked and hidden parts are left alone. X/Y/Z symmetry
remeshes mirror images together, so the topology is mirrored too.
-- Carries mask, polypaint, paint layers, polygroups and sculpt layer offsets; quads under the brush become
- triangles; UVs are dropped (Undo restores them). Meshes with subdivision levels are refused, as in ZBrush.
+- Carries mask, vertex paint, paint layers, face groups and sculpt layer offsets; quads under the brush become
+ triangles; UVs are dropped (Undo restores them). Meshes with subdivision levels are refused.
- Undo keeps only the vertex and triangle slots the stroke touched. The BVH (incremental inserts, removals,
leaf splits), the adjacency (editable per vertex during a stroke) and the GPU (per-cluster patches instead
of a full upload) follow each dab.
@@ -1266,8 +1265,8 @@ Guide: docs/guide/sculpting.md, "Vector displacement brushes".
.sfvdm; dropping an .exr loads it too) with Swap Y/Z, Flip X/Y/Z and Scale for maps from other apps, New VDM
Plane, Create VDM, Export EXR. While the VDM brush is the brush, the Alpha tile and picker show the maps, and
the stroke switches to DragRect (the previous stroke comes back with the next brush).
-- **Create VDM from a plane** (ZBrush's VDM plane, Blender's VDM Brush Baker): a 2 x 2 VDM plane with UVs and
- a masked border as a new SubTool (the others hidden, top view); Create VDM rasterizes each point's offset
+- **Create VDM from a plane**: a 2 x 2 VDM plane with UVs and
+ a masked border as a new Part (the others hidden, top view); Create VDM rasterizes each point's offset
through the UVs into a map saved in the brush library (Divide keeps the UVs).
- **Blender's convention**, checked against the VDM Brush Baker's source and in Blender 4.2 and 5.2: RGB = XYZ in
brush radii over the brush's square, first scanline = top. Exported EXRs read in Blender with the same vectors
@@ -1278,20 +1277,20 @@ Guide: docs/guide/sculpting.md, "Vector displacement brushes".
`stroke` command and Python/MCP stamp the brush's map too. OpenEXR via vendored tinyexr 1.0.13 (BSD-3), built on
stb's zlib (no new dependency).
-### Blender add-on: ZBrush-style keys in Sculpt Mode
-Guide: docs/guide/blender.md, "ZBrush-style keys in Sculpt Mode".
-- Add-on preference **ZBrush-style keys in Sculpt Mode** (off by default): S / U / O radial Draw Size,
- Strength and Hardness (Focal Shift); Space the Sculpt context menu; B a brush list by ZBrush name (type to
- filter; Blender 4.3+ brush assets, 4.2 brush tools); Alt+drag Zsub; Ctrl(+Alt)+drag mask / unmask lasso;
+### Blender add-on: the Classic sculpting keys in Sculpt Mode
+Guide: docs/guide/blender.md, "the Classic sculpting keys in Sculpt Mode".
+- Add-on preference **The Classic sculpting keys in Sculpt Mode** (off by default): S / U / O radial Draw Size,
+ Strength and Hardness (Focal Shift); Space the Sculpt context menu; B a brush list by name (type to
+ filter; Blender 4.3+ brush assets, 4.2 brush tools); Alt+drag Sub; Ctrl(+Alt)+drag mask / unmask lasso;
Ctrl+Shift(+Alt)+drag show only / hide inside; Ctrl+W group masked and clear the mask (else group visible);
Ctrl+D Divide (Multires), D / Shift+D SDiv up / down; X symmetry; Shift+F wireframe; F frame; P perspective;
L Stabilize Stroke; W / E / R move / scale / rotate. Turning it off (or disabling the add-on) removes them.
- The preferences and the guide list the ZBrush keys Blender has no equivalent for.
+ The preferences and the guide list the Classic sculpting keys Blender has no equivalent for.
- tests/blender/test_in_blender.py checks every key's operator and settings, the data paths (Blender 4.2's
unified paint settings vs 5's per-mode ones), the brush picks, SDiv and Divide, on/off, and the VDM EXR
round trips; run in real Blender 4.2.23 and 5.2.3.
-### QRemesh Guides (ZBrush's ZRemesher Guides)
+### QRemesh Guides
- **QRemesh Guides brush** (Tool > Geometry > QRemesh > Guides, the brush picker, F3): drag on the model to draw
curves for QRemesh's edge loops to follow, around the eyes, the mouth, a joint. Curves are snapped to the
surface, closed into a loop when they end where they started, mirrored with symmetry (a curve that is its own
@@ -1305,15 +1304,15 @@ Guide: docs/guide/blender.md, "ZBrush-style keys in Sculpt Mode".
guide round an "eye", the edges near it are within 2-8 degrees of its direction (about 22 without), and the
loop closes (6 of 6 test eyes, 4 of 4 mouths across the middle, 507 of 512 in random sweeps with and without
FMA; the misses are loops about 20 quads round).
-- Guides belong to each SubTool, are saved in projects (`qremesh_guides` per SubTool in the manifest, no format
+- Guides belong to each Part, are saved in projects (`qremesh_guides` per Part in the manifest, no format
change: older projects open, older versions ignore them) and copied to the kept original. Guides left far from
- the surface (the SubTool moved) are ignored with a note.
+ the surface (the Part moved) are ignored with a note.
- Scripting: `qremesh_guide` (points, view, symmetry), `qremesh_guide_delete_last`, `qremesh_guides_clear`,
`qremesh_guides_info`; `qremesh` gains `guides` and `curves_strength`.
-- Keep Groups (loops along polygroup borders) and Use Polypaint (density) were already there.
+- Keep Groups (loops along face group borders) and Use Vertex Paint (density) were already there.
### Sculpt layers on subdivision levels
-- Checked against ZBrush's 3D Layers and covered by tests: a layer recorded at the top survives Lower / Higher Res
+- Checked against 3D Layers and covered by tests: a layer recorded at the top survives Lower / Higher Res
bit for bit, shows at lower levels as the same strokes in the base would, keeps one weight for every level, and
survives Divide, Reconstruct Subdiv, Del Lower / Del Higher, undo, saving and loading at any level, and blend
shape export from any level (`subdiv_export`). Layers added or sculpted at a low level show above. Nothing needed
@@ -1326,12 +1325,12 @@ Guide: docs/guide/blender.md, "ZBrush-style keys in Sculpt Mode".
## [0.7.0] - 2026-10-25
-ZBrush's keys and gestures by default, and a bridge to Blender.
+The Classic sculpting keys and gestures by default, and a bridge to Blender.
-### ZBrush feel: ZBrush's keys and gestures by default
-Audit in docs/zbrush-parity.md (sources: Maxon's ZBrush shortcut sheet and documentation); guide chapter
-docs/guide/coming-from-zbrush.md.
-- **U / I / O**: Z Intensity, RGB Intensity and Focal Shift sliders at the cursor, as in ZBrush (S stays Draw
+### Classic feel: the Classic sculpting keys and gestures by default
+Guide chapter
+docs/guide/quick-tour.md.
+- **U / I / O**: Z Intensity, RGB Intensity and Focal Shift sliders at the cursor (S stays Draw
Size). Values show 0-100 (Focal Shift -100..100); the top shelf and Draw palette say Z Intensity instead of
Strength.
- **RGB Intensity**: painting has its own strength (default 100), separate from Z Intensity.
@@ -1341,42 +1340,42 @@ docs/guide/coming-from-zbrush.md.
- **Smooth keeps its own Z Intensity** (default 50): Shift-smoothing no longer follows the active brush's
strength. Holding Shift (or picking Smooth) shows and sets it.
- **Space**: the QuickMenu under the cursor (brush, stroke, alpha, material, Draw Size, Focal Shift, the
- intensities, Zadd/Zsub, Sculpt/Paint, Rgb, X). Hold and let go to close, or tap to keep it open.
-- **Brush letters**: B C B ClayBuildup, B D S DamStandard, B M V Move, B I N Inflate, B P I Pinch, B S H
- SnakeHook (ZBrush's), instead of the first free letter.
+ intensities, Add/Sub, Sculpt/Paint, Rgb, X). Hold and let go to close, or tap to keep it open.
+- **Brush letters**: B C B Clay Block, B D S Sharp Crease, B M V Move, B I N Inflate, B P I Pinch, B S H
+ SnakeHook, instead of the first free letter.
- **Mask keys**: Ctrl+A Mask All, Ctrl+Shift+A Clear Mask, Ctrl+I Invert, Ctrl+H View Mask; **Ctrl+W** Group
Masked (and clear the mask; with nothing masked, Group Visible).
- **Ctrl+click on the model blurs the mask, Ctrl+Alt+click sharpens it** (a Ctrl+drag still paints).
- **Shift pressed after a stroke starts** draws a straight line, snapped to 45 degree steps.
- **Shift+click the background, let go of Shift, drag** rolls the view about its axis.
-- **Shift+Alt+click a SubTool** selects and frames it.
-- **Ctrl+Shift+click a polygroup on a partly hidden mesh hides it** (it used to isolate it); a Ctrl+Shift
+- **Shift+Alt+click a Part** selects and frames it.
+- **Ctrl+Shift+click a face group on a partly hidden mesh hides it** (it used to isolate it); a Ctrl+Shift
rectangle around nothing reverses the visibility.
- **L** toggles LazyMouse, **V** swaps the main and secondary colour, **Ctrl+Shift+Alt+I** is Save UI.
-- **Preferences > Input**: Style **ZBrush** (default) or **SculptForge**, which keeps 0.6's keys: 1-9 and 0 pick
- brushes (ZBrush style: free, 9 = QuickSave), I = Z Intensity, Ctrl+drag on the background zooms when nothing
- is masked (ZBrush style: nothing). Rotation (free / turntable) is also here.
+- **Preferences > Input**: Style **Classic** (default) or **SculptForge**, which keeps 0.6's keys: 1-9 and 0 pick
+ brushes (classic: free, 9 = QuickSave), I = Z Intensity, Ctrl+drag on the background zooms when nothing
+ is masked (classic: nothing). Rotation (free / turntable) is also here.
- Projects store Smooth's Z Intensity, RGB Intensity and Focal Shift.
### Blender bridge
- **SculptForge Bridge, an add-on for Blender 4.2+** (`addons/blender`, GPL-3.0-or-later): select objects, click
**Send to SculptForge** (the 3D View's SculptForge tab, the Object menu or File > Export), sculpt, then
**File > Blender > Send to Blender** in SculptForge. The objects update in place in Blender, keeping their
- transform, materials and modifiers; new SubTools become new objects. Works on Linux, Windows and macOS.
+ transform, materials and modifiers; new Parts become new objects. Works on Linux, Windows and macOS.
- The two sides share a per-user folder (`<user data>/SculptForge/SculptForge/blender`) and exchange `.GoZ` files
plus a JSON manifest per direction (object names, `matrix_world`, a revision); each side checks the other's
manifest once a second. No network. SculptForge records where it is installed and writes a heartbeat there, so
the add-on starts it (`--blender`) only when it isn't running.
- - Identity: Blender object name <-> SubTool (its GoZ name). Positions travel in object space with the matrix;
+ - Identity: Blender object name <-> Part (its Bridge files name). Positions travel in object space with the matrix;
Z-up <-> Y-up, metres both; mirrored objects keep their faces pointing out. A round trip is the identity
- (positions, faces and winding, UVs, polypaint, mask, polygroups): tested in C++, from the add-on's side
+ (positions, faces and winding, UVs, vertex paint, mask, face groups): tested in C++, from the add-on's side
against `sculptforge-cli`, and in a real Blender in CI.
- Unchanged topology updates only positions and attributes, so Blender keeps n-gons, edges, seams and other
- data; changed topology rebuilds the mesh. Active UV map <-> UVs, active colour attribute <-> polypaint, sculpt
- mask <-> mask, face sets <-> polygroups. Modifiers can be kept live or applied (then turned off on return).
+ data; changed topology rebuilds the mesh. Active UV map <-> UVs, active colour attribute <-> vertex paint, sculpt
+ mask <-> mask, face sets <-> face groups. Modifiers can be kept live or applied (then turned off on return).
- Commands `blender_send` and `blender_receive` (CLI, MCP, Python), **File > Blender** (Send, Receive, Receive
- automatically), F3 entries and Ctrl-hover help. GoZ receive and the bridge share the code that matches objects
- to SubTools.
+ automatically), F3 entries and Ctrl-hover help. Bridge files receive and the bridge share the code that matches objects
+ to Parts.
- Packaging: `build_addon.py` writes the extension zip and a legacy add-on zip (`cmake --build build --target
blender_addon`); releases attach `sculptforge_bridge.zip`. Guide chapter **Working with Blender**.
- UI tests: `copy SRC DST` stages files another program would write.
@@ -1444,7 +1443,7 @@ adjacency that saves the memory).
(the GPU also skips the back faces left in the others); the rest go in one multi-draw with 16-bit indices.
Orbiting a 33M triangle sphere with 4x antialiasing: 20.6 -> 8.7 ms; 104M: 19.6 ms.
- Vertices take 12 bytes on the GPU (28 before): positions on a 21-bit grid over the mesh, octahedral normals,
- square-root companded curvature. Polypaint is 8-bit (gamma encoded), the mask 8-bit, polygroups 16-bit. With
+ square-root companded curvature. Vertex Paint is 8-bit (gamma encoded), the mask 8-bit, face groups 16-bit. With
the index and wireframe savings a mesh needs about 15 bytes per triangle on the GPU (46 before on meshes with
quads, whose wireframe edges were always kept).
- Fast Navigation also draws big meshes as a motion proxy while the view moves: per cluster, the vertices
@@ -1468,30 +1467,30 @@ adjacency that saves the memory).
## [0.5.0] - 2026-10-23
### Subdivision levels (multiresolution)
-- Divide (Tool > Geometry, Ctrl+D, `subdiv_divide`) adds a subdivision level per SubTool and keeps the lower
+- Divide (Tool > Geometry, Ctrl+D, `subdiv_divide`) adds a subdivision level per Part and keeps the lower
ones: Catmull-Clark on meshes with quads (quads stay quads), Loop on triangle meshes, flat with Smt off.
- Lower Res / Higher Res (Shift+D / D, `subdiv_lower`, `subdiv_higher`) and the SDiv slider (`subdiv_level`)
step between levels. Detail is stored per level as a displacement in the local frame of the smoothed level
below, so reshaping a low level carries it along; edits at a high level are restricted (full weighting) to
the lower ones. Round trips without edits are bit-for-bit.
-- Mask, polypaint, paint layers, polygroups, hidden faces and UVs follow the levels (copied down, interpolated or
+- Mask, vertex paint, paint layers, face groups, hidden faces and UVs follow the levels (copied down, interpolated or
inherited up where they changed); sculpt layers have their own detail per level; the texture is shared.
- Del Lower, Del Higher (`subdiv_delete_lower`, `subdiv_delete_higher`) and Reconstruct Subdiv
(`subdiv_reconstruct`: finds the lower level of a regular Catmull-Clark or Loop subdivision, keeping the mesh
- and its vertex order). `subdiv_info` lists the levels; `subdiv_export` writes the visible SubTools at another
+ and its vertex order). `subdiv_info` lists the levels; `subdiv_export` writes the visible Parts at another
level (e.g. the base cage) in any export format.
- Each level change is one undo step, as is each stroke at any level; level edits share unchanged levels
copy-on-write. The two levels left last keep their topology and BVH, so stepping back and forth is instant
(1-45 ms at 6.5M triangles).
-- Projects save every level (project format 4). The SubTool list shows "SDiv n/m".
+- Projects save every level (project format 4). The Part list shows "SDiv n/m".
- Ctrl+D now runs Divide; the one-way Subdivide stays in Tool > Geometry and as `subdivide`.
### Gizmo 3D (moving, scaling, rotating and posing)
-- Gizmo 3D modes, as in ZBrush: W Move, E Scale, R Rotate, Q back to Draw (top shelf, Transform palette, F3).
+- Gizmo 3D modes: W Move, E Scale, R Rotate, Q back to Draw (top shelf, Transform palette, F3).
Move has axis arrows, plane squares and a view-plane centre; Rotate has axis rings and a view ring; Scale has
axis boxes and a uniform centre. Shift snaps (15 degrees, a round grid step, 10%). The amount shows beside the
gizmo while dragging. Dragging off the handles still navigates; Ctrl still masks.
-- Transforms move the active SubTool, or only its unmasked part: partly masked vertices move partly, hidden ones
+- Transforms move the active Part, or only its unmasked part: partly masked vertices move partly, hidden ones
never. Falloff eases the movement in over a distance from the mask's edge (measured along the surface, as a
share of the size) for soft joints when posing. With symmetry on, a masked transform is mirrored across the
symmetry plane.
@@ -1499,21 +1498,21 @@ adjacency that saves the memory).
Alt+click the model or To Surface to put it on the surface, Reset; World or Surface axes (Y along the normal,
turning with rotations). The gizmo follows undo / redo of its own steps and is saved in projects (`gizmo` key,
no format bump).
-- Gizmo 3D panel: pivot, options and numeric Move / Rotate / Scale with Apply; All SubTools (Transpose All, one
- undo step per SubTool).
+- Gizmo 3D panel: pivot, options and numeric Move / Rotate / Scale with Apply; All Parts (Transpose All, one
+ undo step per Part).
- `transform` command (translate, rotate, scale, pivot, orient, masked, falloff, symmetry, all); each gizmo drag
is echoed to the console as the command that repeats it.
- One undo step per drag that restores positions bit for bit. Sculpt layers move with the surface (the base and
- every layer's offsets). Topology, quads, UVs, textures, polypaint and polygroups are untouched.
+ every layer's offsets). Topology, quads, UVs, textures, vertex paint and face groups are untouched.
- Fast on big meshes: a drag recomputes from the drag's start (no drift), transforms only the moving vertices
through a per-weight lookup table on several threads, turns normals of rigid parts and recomputes only where
the movement varies, uploads only the changed vertex range and refits the BVH once on release. On 1.3M
triangles: about 2 ms to transform and 7 ms to upload per drag frame, 20-40 ms on release.
### Normal, displacement and AO map baking
-- Tool > Bake (and the `bake` command) bakes a high-poly source (one SubTool, or every visible one but the
- active) onto the active SubTool's UVs: tangent-space normal, object-space normal, displacement, ambient
- occlusion, cavity and colour (polypaint or painted texture) maps, 1K to 8K.
+- Tool > Bake (and the `bake` command) bakes a high-poly source (one Part, or every visible one but the
+ active) onto the active Part's UVs: tangent-space normal, object-space normal, displacement, ambient
+ occlusion, cavity and colour (vertex paint or painted texture) maps, 1K to 8K.
- Tangent-space maps use MikkTSpace tangents (vendored, zlib), as Blender, Unreal, Unity and Godot compute them;
OpenGL or DirectX green convention. Unit-tested to decode to the high-poly's normals within 0.2 degrees on
average.
@@ -1530,20 +1529,20 @@ adjacency that saves the memory).
last export by default.
### Quad retopology and detail projection
-- QRemesh (Tool > Geometry > QRemesh, `qremesh`): automatic quad retopology like ZBrush's ZRemesher. A
+- QRemesh (Tool > Geometry > QRemesh, `qremesh`): automatic quad retopology. A
field-aligned method after Instant Meshes (Jakob et al. 2015; field formulas follow its BSD-3 reference code,
credited in THIRD_PARTY_NOTICES.md): a multi-resolution 4-RoSy orientation field and position field, polygon
extraction, then every polygon split into quads and relaxed onto the sculpt. The result is 100% quads,
2-manifold and closed where the sculpt is, within about 5% of the target count.
- Options: Target Polygons with Half / Same / Double, Adaptive Size (curvature-driven quad size), Keep Groups
- (edge loops along polygroup borders, groups kept), Detect Edges (loops on hard edges over 50 degrees),
- Use Polypaint (red = up to 4x the density, blue = down to a quarter), Symmetry (one half remeshed and mirrored,
- welded on the seam), Keep Original (the old SubTool kept hidden below, for ProjectAll).
-- Runs in the background in the app with a progress bar and Cancel; one undo step. Mask and polypaint are
+ (edge loops along face group borders, groups kept), Detect Edges (loops on hard edges over 50 degrees),
+ Use Vertex Paint (red = up to 4x the density, blue = down to a quarter), Symmetry (one half remeshed and mirrored,
+ welded on the seam), Keep Original (the old Part kept hidden below, for ProjectAll).
+- Runs in the background in the app with a progress bar and Cancel; one undo step. Mask and vertex paint are
interpolated onto the new mesh; sculpt layers are baked.
-- ProjectAll (Tool > SubTool > Project, `project_all`): moves the active SubTool onto the other visible
- SubTools (rays both ways along the normal, nearest hit within Dist, else the closest point) and takes their
- polypaint. Dist, Mean, PA Blur, Geometry / Polypaint toggles, an optional single `source`; respects the mask
+- ProjectAll (Tool > Part > Project, `project_all`): moves the active Part onto the other visible
+ Parts (rays both ways along the normal, nearest hit within Dist, else the closest point) and takes their
+ vertex paint. Dist, Mean, PA Blur, Geometry / Vertex Paint toggles, an optional single `source`; respects the mask
and hidden faces; shape goes into the active sculpt layer, colour into the active paint layer; one undo step.
- Fast on dense meshes (all threads, a read-only BVH): 1.3M triangles to 5,000 quads in 1.7 s, to 100,000 in
6 s; ProjectAll onto 1.25M vertices in 0.6 s (10-core desktop).
@@ -1563,38 +1562,38 @@ adjacency that saves the memory).
- Memory: the per-triangle face normal cache and its stamps are gone (normals are summed per vertex, same
result), the adjacency list has no spare capacity, the renderer keeps no CPU copy of the curvature: 90 -> 62
bytes per triangle for a sculpting mesh.
-- The first polypaint stroke on an unpainted mesh keeps the (empty) paint stack for undo instead of a copy of
+- The first vertex paint stroke on an unpainted mesh keeps the (empty) paint stack for undo instead of a copy of
the whole mesh.
- Projects: archives stream to disk (no in-memory copy), entries are read in place, CRCs are computed in
parallel, arrays are copied rather than converted byte by byte; ZIP64 past 4 GB (smaller archives are
byte-identical to before).
- The window has no multisampling; the 3D view antialiases in its own target (Renderer::drawView), so it can
use fewer samples when the GPU has no room, and Fast Navigation draws scenes of 10M+ triangles without
- antialiasing while the view moves. A SubTool that runs the GPU out of memory is not drawn (status message).
+ antialiasing while the view moves. A Part that runs the GPU out of memory is not drawn (status message).
- Preferences > Performance: Antialiasing (Off / 2x / 4x / 8x), Fast Navigation, Multithreading, the last
stroke's cost per dab and memory; `perf_info` and `set_multithreading` commands.
### Polish of the v0.5 features (known issues fixed)
-- Auto UV on a SubTool with a painted texture now moves the paint and every texture layer onto the new UVs
+- Auto UV on a Part with a painted texture now moves the paint and every texture layer onto the new UVs
instead of scrambling it (each texel of a new UV triangle samples the old texture at the same point of the same
triangle, islands padded 8 texels); one undo step restores the old UVs and texture (`uv_auto
keep_texture=false` for the old behaviour). 1.05M triangles, 4K texture with a layer: 0.2-0.3 s.
- Keep Texture (Tool > Remesh, Tool > Geometry > QRemesh; `keep_texture` on `remesh` and `qremesh`, default on):
the rebuilt surface gets Auto UVs and the texture, all layers, is projected onto it from the old surface, in the
- same undo step. Voxel Remesh of a painted SubTool runs in the background with progress and Cancel. Merging
- SubTools (`subtool_merge_down`, `subtool_merge_visible`) keeps their textures in one texture on new Auto UVs.
+ same undo step. Voxel Remesh of a painted Part runs in the background with progress and Cancel. Merging
+ Parts (`subtool_merge_down`, `subtool_merge_visible`) keeps their textures in one texture on new Auto UVs.
- Decimate no longer scrambles a texture at UV seams (seam vertices stay in place).
- Auto UV no longer crashes or folds UVs on dense smooth meshes (e.g. the default 82k-triangle sphere): fixed in
third_party/xatlas. UV islands are capped at about 4000 triangles, so a 1.3M-triangle sculpt unwraps in about
16 s instead of minutes.
-- Subdivision levels: Voxel Remesh, Decimate, QRemesh, Subdivide, Delete Hidden and merging or splitting SubTools
+- Subdivision levels: Voxel Remesh, Decimate, QRemesh, Subdivide, Delete Hidden and merging or splitting Parts
say in the status line that they removed the levels and which one became the new base ("Subdivision levels
removed: SDiv 3 of 5 kept as the new base"); undo restores every level (now covered by tests).
- Subdivision levels: a sculpt layer's fine detail now turns and bends with a low level rotated with the Gizmo 3D
or reshaped (layer details are stored relative to the surface). Project format 5; format 4 projects are
converted when they open.
-- Subdivision levels: only the active SubTool keeps its recently visited levels cached; selecting another SubTool
- frees 50-170 MB per SubTool with 1.8M triangles (the first level step after coming back takes about 0.1 s).
+- Subdivision levels: only the active Part keeps its recently visited levels cached; selecting another Part
+ frees 50-170 MB per Part with 1.8M triangles (the first level step after coming back takes about 0.1 s).
- QRemesh: Symmetry mirrors across the model's own middle plane, so models away from the world centre work. A
model that isn't mirror-symmetric is remeshed without symmetry and the status line says so; a nearly symmetric
one keeps mirrored topology on each side's own surface. Symmetry is on by default in the panel; new
@@ -1602,7 +1601,7 @@ adjacency that saves the memory).
- QRemesh: small separate pieces (eyes, rivets) are no longer dropped: they are remeshed on their own with at
least 32 quads, or kept as they were. Parts thinner than a quad (blades, fins, slabs) keep both sides and their
hard edges (thin slab: mean error 2.2% -> 0.05% of its size, Hausdorff 8.8% -> 2.6%).
-- Top shelf: the Vertex / Texture paint target is hidden while the SubTool has no texture, instead of sitting
+- Top shelf: the Vertex / Texture paint target is hidden while the Part has no texture, instead of sitting
there greyed out (docs/ui-design.md now states the rule for contextual shelf buttons); Draw Size and Strength
shrink to fit when the row is full.
- Exports: the `.mtl` and PNGs written beside a model whose file name has spaces use `_` instead (OBJ's `mtllib`
@@ -1613,7 +1612,7 @@ adjacency that saves the memory).
loaded parallel ctest.
### Changed
-- Wireframe (PolyF) is Shift+F only: W is now the Gizmo 3D's Move, as in ZBrush.
+- Wireframe (PolyF) is Shift+F only: W is now the Gizmo 3D's Move.
## [0.4.2] - 2026-10-23
@@ -1621,10 +1620,10 @@ adjacency that saves the memory).
- Paint into a texture on the model's UVs instead of its vertices, so the colour detail comes from the texture
(1K, 2K, 4K or 8K), not from the mesh density (Tool > Texture Map > New Texture, `texture_create`). The Paint
brush, Rgb sculpting, fills, cavity paint, colour picking (C), mask, hidden faces, symmetry and pen pressure
- work as for polypaint; texture strokes never paint through to the far side. A few texels of padding around
+ work as for vertex paint; texture strokes never paint through to the far side. A few texels of padding around
every UV island keep seams invisible.
- Vertex / Texture toggle on the top shelf (and in the Color, Paint Layers and Texture Map palettes) chooses
- where paint goes per SubTool (`paint_target`). The viewport multiplies the texture with the polypaint over
+ where paint goes per Part (`paint_target`). The viewport multiplies the texture with the vertex paint over
the material; Show texture hides it.
- The Paint Layers palette works on the texture's own layer stack: blend modes, opacity, visibility, lock,
duplicate, merge down, flatten, clear and fill, composited only where something changed.
@@ -1635,12 +1634,12 @@ adjacency that saves the memory).
the changed rectangle of the texture.
- Auto UV (Tool > Texture Map, `uv_auto`): automatic UV unwrapping with xatlas (MIT, vendored in
third_party/xatlas), running in the background with progress. Show UVs draws the texture with the UV layout.
-- Polypaint > Texture and Texture > Polypaint (`texture_from_polypaint`, `polypaint_from_texture`), Import and
+- Vertex Paint > Texture and Texture > Vertex Paint (`texture_from_polypaint`, `polypaint_from_texture`), Import and
Export Texture (PNG; `texture_import`, `texture_export`), Delete Texture (`texture_delete`).
- Projects save textures and their layers (project format 3; version 1 and 2 projects still open, and older
SculptForge versions refuse format 3 files instead of dropping the paint).
- Exports write the texture next to the model: OBJ with a `.mtl` (`map_Kd`), glTF/GLB with an embedded base
- colour texture, USD with a preview material, FBX and GoZ with the PNG beside the file.
+ colour texture, USD with a preview material, FBX and Bridge files with the PNG beside the file.
- Subdivide, decimate, split and duplicate keep the texture with the UVs.
## [0.4.1] - 2026-10-23
@@ -1653,13 +1652,13 @@ adjacency that saves the memory).
## [0.4.0] - 2026-10-22
-Shaped by feedback from a working ZBrush modeler and a survey of ZBrush and Mudbox forums.
+Shaped by feedback from a working professional modeler and a survey of sculpting forums.
-### Feels like ZBrush
-- Free rotation by default: the model follows the cursor and can roll over the top, as in ZBrush. Hold Shift
+### Classic feel
+- Free rotation by default: the model follows the cursor and can roll over the top. Hold Shift
while rotating to snap to the nearest front, side, top or bottom view. Preferences > Interface > Rotation:
Turntable keeps the model upright (Blender / Maya style).
-- Alt+drag pans and letting go of Alt mid-drag zooms; right-drag follows ZBrush's right-click navigation
+- Alt+drag pans and letting go of Alt mid-drag zooms; right-drag follows right-click navigation
(Alt pans, Ctrl zooms, Shift snaps). Projects remember the view's roll.
- MaskLasso and MaskRect (Tool > Masking): Ctrl+drag a lasso or rectangle to mask what's inside, Ctrl+Alt to
unmask, starting on the model or the background.
@@ -1669,16 +1668,16 @@ Shaped by feedback from a working ZBrush modeler and a survey of ZBrush and Mudb
cavity shading, so small strokes stay readable. Projects keep the material they were saved with.
### Quads
-- Models opened from ZBrush (GoZ), OBJ, FBX, PLY or USD keep their quads: PolyF shows them as quads and
- OBJ / FBX / PLY / USD / GoZ export writes them back as quads, through sculpting, layers, undo, SubTools and
+- Models opened through the Bridge, OBJ, FBX, PLY or USD keep their quads: PolyF shows them as quads and
+ OBJ / FBX / PLY / USD / Bridge files export writes them back as quads, through sculpting, layers, undo, Parts and
projects.
-- Subdivide turns each quad into four quads, voxel remesh produces an even quad grid (like DynaMesh), and the
+- Subdivide turns each quad into four quads, voxel remesh produces an even quad grid, and the
Plane and Cube primitives are quads. Decimate still produces triangles.
### Paint layers
-- Photoshop-style polypaint layers per SubTool (Tool > Paint Layers): name, visibility, opacity, lock and ten
+- Photoshop-style vertex paint layers per Part (Tool > Paint Layers): name, visibility, opacity, lock and ten
blend modes (Multiply, Screen, Overlay, Soft Light, Add, ...). Painting is non-destructive and undoable;
- merge down, flatten, duplicate and reorder work as in Photoshop. Something ZBrush never had.
+ merge down, flatten, duplicate and reorder work as in Photoshop.
- Exports use the composited colours; projects keep the layers (older versions open them flattened). New
`paint_layer_*` script commands.
@@ -1707,18 +1706,18 @@ Shaped by feedback from a working ZBrush modeler and a survey of ZBrush and Mudb
- Website motion: page transitions (View Transitions), scroll-linked effects, a progress bar and staggered
reveals tuned for phones, tablets and monitors; all off with "reduce motion".
-### A ZBrush-style interface
+### A classic interface
- Laptop camera notches: when SculptForge fills the screen, the interface stays below the camera notch of
MacBooks (macOS reports the safe area; on Linux a notched MacBook display is recognised), with a plain band
beside the notch. Preferences > Interface > Camera notch: Automatic / Always reserve / Off.
- Fullscreen toggle (F11, Render palette; `--fullscreen` on the command line), and minimise / close buttons at
the far right of the title strip (close asks to save changes; Ctrl+Q quits).
-- The canvas is framed by shelves, as in ZBrush: a top shelf (LightBox, Sculpt/Paint, Zadd/Zsub, Draw Size,
+- The canvas is framed by shelves: a top shelf (Library, Sculpt/Paint, Add/Sub, Draw Size,
Strength, symmetry, pressure), a left shelf of Brush / Stroke / Alpha / Material pickers with the colour picker,
a right shelf of navigation (drag Move / Zoom / Rotate) and display toggles, and a bottom shelf of your most-used
- brushes. 16 alphabetical palettes hold every tool; the Tool palette (SubTool, Layers, Geometry, Remesh,
- Masking, Polygroups, Visibility, Export, Display) sits in the right tray, and any palette can move into a tray.
-- LightBox (`,`): projects, models, brushes, alphas, materials, images, splats, QuickSaves and recent files as
+ brushes. 16 alphabetical palettes hold every tool; the Tool palette (Part, Layers, Geometry, Remesh,
+ Masking, Face groups, Visibility, Export, Display) sits in the right tray, and any palette can move into a tray.
+- Library (`,`): projects, models, brushes, alphas, materials, images, splats, QuickSaves and recent files as
thumbnails across the top of the canvas; brush thumbnails are sculpted for real; projects save a thumbnail.
- Pop-up pickers: Brush (`B`, then type letters: B S T = Standard), Material (`M`, previews on the model as you
hover), Draw Size / Strength at the cursor (`S` / `I`).
@@ -1754,16 +1753,16 @@ Shaped by feedback from a working ZBrush modeler and a survey of ZBrush and Mudb
with ComfyUI's core MESH type.
- tools/comfyui-validate-workflow.py and tools/comfyui-smoke.sh check and run workflows against a server.
-### SubTools
-- A scene can hold several meshes (SubTools), like ZBrush: each keeps its own attributes, sculpt layers and undo
+### Parts
+- A scene can hold several meshes (Parts): each keeps its own attributes, sculpt layers and undo
history. Only the active one is sculpted; the others are drawn slightly dimmed.
-- SubTools panel: select, rename (double-click), show/hide, Solo, Unhide all, reorder, Append (sphere, cube,
- plane or a model file), Duplicate, Delete, Merge down, Merge visible, Split by polygroups, Split into parts.
- Alt+click a SubTool in the viewport to select it. New `subtool_*` commands for scripts, Python and MCP agents.
-- Files: projects save every SubTool (format version 2; version 1 projects still open). OBJ (`o` objects), glTF,
- FBX (an LOD group per SubTool), USD and GoZ export each visible SubTool as its own object, and multi-object
- files open as SubTools. PLY, STL and splat conversion use the visible SubTools merged.
-- OBJ import: `g` groups now become polygroups (as ZBrush writes them) and `o` objects become SubTools.
+- Parts panel: select, rename (double-click), show/hide, Solo, Unhide all, reorder, Append (sphere, cube,
+ plane or a model file), Duplicate, Delete, Merge down, Merge visible, Split by face groups, Split into parts.
+ Alt+click a Part in the viewport to select it. New `subtool_*` commands for scripts, Python and MCP agents.
+- Files: projects save every Part (format version 2; version 1 projects still open). OBJ (`o` objects), glTF,
+ FBX (an LOD group per Part), USD and Bridge files export each visible Part as its own object, and multi-object
+ files open as Parts. PLY, STL and splat conversion use the visible Parts merged.
+- OBJ import: `g` groups now become face groups and `o` objects become Parts.
- New cube primitive.
### Brush library and sharing
@@ -1806,51 +1805,51 @@ Shaped by feedback from a working ZBrush modeler and a survey of ZBrush and Mudb
## [0.2.0] - 2026-10-21
### Sculpting
-- New brushes: Dam Standard, Clay Buildup, Snake Hook, Trim (dynamic; Alt fills), Layer and Nudge. Keys 1-9 and 0
+- New brushes: Sharp Crease, Clay Block, Tendril, Trim (dynamic; Alt fills), Layer and Nudge. Keys 1-9 and 0
select the first ten brushes.
- Stroke types: dots, drag-rect, spray and lazy mouse.
- Brush alphas: round, square, noise or any grayscale image (`brush_set_alpha`).
-- Mesh attributes shared by every tool: mask, polypaint, polygroups, hidden faces and UVs.
+- Mesh attributes shared by every tool: mask, vertex paint, face groups, hidden faces and UVs.
### Masking
- Hold Ctrl while stroking to paint the mask, Ctrl+Alt to erase it. Ctrl+click the background inverts it and
- Ctrl+drag there clears it. Every brush and polypaint leave masked areas alone.
+ Ctrl+drag there clears it. Every brush and vertex paint leave masked areas alone.
- Commands `mask_clear`, `mask_all`, `mask_invert`, `mask_blur`, `mask_sharpen`, `mask_grow`, `mask_shrink`,
`mask_by_cavity` and `mask_by_polygroup`, plus a Masking section in the Tools panel.
-### Polygroups and visibility
+### Face groups and visibility
- `polygroup_auto_by_normals`, `polygroup_by_connectivity`, `polygroup_from_mask`, `polygroup_clear`,
`polygroup_merge_visible`.
-- ZBrush-style visibility: Ctrl+Shift+click isolates a polygroup (click again to invert), Ctrl+Shift+Alt+click
+- classic visibility: Ctrl+Shift+click isolates a face group (click again to invert), Ctrl+Shift+Alt+click
hides it, Ctrl+Shift+click on the background shows everything, Ctrl+Shift+drag hides outside a rectangle (Alt:
inside). Commands `hide_polygroup`, `isolate_polygroup`, `show_all`, `invert_visibility`, `hide_rect` and
- `delete_hidden`. Brushes, polypaint and mask operations skip hidden faces.
+ `delete_hidden`. Brushes, vertex paint and mask operations skip hidden faces.
-### Polypaint and materials
+### Vertex Paint and materials
- Paint brush (P), "RGB while sculpting", colour pick (C), and the `set_color`, `paint_fill`, `paint_clear` and
`paint_from_cavity` commands. Fills respect the mask by default.
-- Six built-in MatCap materials (Red Wax, Clay, Skin, Chrome, White, Bronze) in a new Polypaint & Materials panel.
-- Vertex colours are exported to PLY (`export_ply`), USD (`displayColor`), glTF, OBJ and GoZ.
+- Six built-in Lit Sphere materials (Red Wax, Clay, Skin, Chrome, White, Bronze) in a new Vertex Paint & Materials panel.
+- Vertex colours are exported to PLY (`export_ply`), USD (`displayColor`), glTF, OBJ and Bridge files.
### Projects
- Native `.sfproj` project files (`save_project`, `open_project`, and `open`) hold the mesh, sculpt layers, mask,
- polypaint, polygroups, visibility, UVs, splats, the brush library and view settings.
+ vertex paint, face groups, visibility, UVs, splats, the brush library and view settings.
- Ctrl+S / Ctrl+Shift+S save a project; OBJ export moved to File > Export OBJ.
- Save / Don't Save / Cancel prompt before losing unsaved changes, unsaved marker in the title bar, recent files,
and autosave with an offer to restore after a crash.
### Interchange
-- ZBrush GoZ: `.GoZ` import and export with polygroups, mask, polypaint and UVs (quads are kept), and the GoZ
- bridge (`goz_send`, `goz_receive`, File > ZBrush (GoZ)) on Windows and macOS. The format follows the open-source
- GoB add-on; the live bridge has not yet been tested against a running ZBrush. See [docs/goz.md](docs/goz.md).
+- Bridge: `.GoZ` import and export with face groups, mask, vertex paint and UVs (quads are kept), and the Bridge files
+ bridge (`goz_send`, `goz_receive`, File > Bridge) on Windows and macOS. The format follows the open-source
+ GoB add-on. See [integrations/bridge-plugin/PROTOCOL.md](integrations/bridge-plugin/PROTOCOL.md).
- STL import (binary and ASCII) and binary STL export. Opening a `.ZTL`/`.ZPR` file now explains that the format is
- proprietary and suggests GoZ or OBJ/FBX.
+ proprietary and suggests Bridge files or OBJ/FBX.
### Security and robustness
- File loaders were fuzzed with libFuzzer, AddressSanitizer and UndefinedBehaviorSanitizer (about 8 million
inputs). Malformed PLY headers could request huge allocations or cast invalid values, and NaN or far-off
coordinates could overflow the vertex-welding grid; all are fixed, with regression tests.
-- The GoZ bridge refuses shell-unsafe paths before launching ZBrush.
+- The Bridge refuses shell-unsafe paths before launching the other application.
## [0.1.0] - 2026-10-20
@@ -1858,9 +1857,9 @@ First public release.
### Sculpting
- Brushes: Standard, Clay, Smooth, Move, Inflate, Crease, Flatten, Pinch; X/Y/Z symmetry; tablet pressure;
- ZBrush-style modifiers and navigation.
+ classic modifiers and navigation.
- BVH-accelerated picking with incremental refit; memory-budgeted unlimited undo.
-- Loop subdivision, voxel remesh (DynaMesh-style), quadric decimation.
+- Loop subdivision, voxel remesh, quadric decimation.
- Sculpt layers (blend shapes) with live weights and playback.
### AI (free built in, or bring your own)
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 445bd309..098b371a 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -663,6 +663,9 @@ if(SCULPTFORGE_BUILD_TESTS)
set_tests_properties(insider_drops PROPERTIES TIMEOUT 300)
# Release notes from note fragments (tools/release/assemble_notes.py, changes/README.md): the assembler, and
# every fragment on this branch parses.
+ add_test(NAME marks COMMAND ${Python3_EXECUTABLE} ${CMAKE_CURRENT_SOURCE_DIR}/tools/check_marks.py
+ WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}) # docs/legal/trademarks.md
+ add_test(NAME marks_self_test COMMAND ${Python3_EXECUTABLE} ${CMAKE_CURRENT_SOURCE_DIR}/tools/check_marks.py --self-test)
add_test(NAME release_notes COMMAND ${Python3_EXECUTABLE} ${CMAKE_CURRENT_SOURCE_DIR}/tools/release/assemble_notes.py --self-test)
add_test(NAME release_notes_fragments COMMAND ${Python3_EXECUTABLE} ${CMAKE_CURRENT_SOURCE_DIR}/tools/release/assemble_notes.py --check)
# The Actions cache pruner keeps the newest cache of each kind (tools/ci/prune_caches.py).
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index d049e9ab..a6a1aa2e 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -80,7 +80,7 @@ artifact. CI compiles through ccache (see the comment at the top of `.github/wor
`tools/wintest.sh` cross-compiles SculptForge for Windows with llvm-mingw (downloaded once into
`~/.cache/sculptforge`) and runs every test, UI tests included, under Wine. It catches Windows API, path and
-file-sharing problems before a push; extra arguments go to `ctest` (`tools/wintest.sh -R ui_subtools`). On an
+file-sharing problems before a push; extra arguments go to `ctest` (`tools/wintest.sh -R ui_mask_lasso`). On an
ARM machine it builds for Windows on ARM, which Wine runs natively.
## Demo videos
diff --git a/README.md b/README.md
index a8b2a571..f694bc19 100644
--- a/README.md
+++ b/README.md
@@ -5,7 +5,7 @@
<h1 align="center">SculptForge</h1>
<p align="center">
- <strong>The free, open-source alternative to ZBrush.</strong><br>
+ <strong>The free, open-source sculpting app.</strong><br>
Digital sculpting for VFX, animation and games on Linux, macOS and Windows, with free built-in AI:<br>
an AI brush creator and image/text to 3D.
</p>
@@ -32,51 +32,32 @@
<a href="https://sculptforge.app/#demos"><img src="docs/images/sculpt-demo.gif" width="800" alt="Weathering a detailed lion head with symmetry and turning it to stone in SculptForge"></a>
</p>
-SculptForge is a free, open-source alternative to ZBrush: a focused sculpting app with the brushes, symmetry and
-navigation ZBrush artists already know. It costs nothing, has no subscription, runs natively on Linux as well as
+SculptForge is a free, open-source, focused sculpting app with the brushes, symmetry and
+navigation experienced sculptors already know. It costs nothing, has no subscription, runs natively on Linux as well as
Windows and macOS, and comes with source code you can change. It starts instantly, works offline,
and fits into game and animation pipelines: sculpt a character, generate its LODs, sculpt blend shapes, and
send it straight into Unreal Engine. **AI comes built in and free**: describe a brush and the AI brush creator
(Brush Lab) builds it, or turn a sketch, concept art or a description into a sculptable model. No account or key is needed. Prefer your own?
Plug in Claude, fal.ai or Meshy, or run models entirely on your own machine.
-## Coming from ZBrush?
-
-| | SculptForge | ZBrush |
-|---|---|---|
-| Price | **Free**, forever | Subscription |
-| Source code | **Open (GPL-3.0)** | Closed |
-| Linux | **Native** | Not available |
-| Familiar brushes, symmetry, Alt/Shift modifiers | **Yes** | Yes |
-| Send to Unreal, LOD chains, blend shapes → morph targets | **Built in** | Via plugins / export |
-| Image or text → sculptable 3D model | **Built in** (free models) | No |
-| Gaussian splats, OpenUSD / USDZ | **Built in** | No |
-| AI agents (MCP), headless scripting | **Built in** | ZScript |
-| Masking, face groups, visibility (Ctrl / Ctrl+Shift, lasso or rectangle), vertex paint, Lit Spheres | **Yes** | Yes |
-| Vertex Paint layers with blend modes (Multiply, Overlay, Screen...) | **Yes** (new in 0.4) | Opacity only |
-| Texture painting on UVs (1K-8K, same paint layers), automatic UV unwrap | **Yes** (new in 0.5) | Polypaint, converted to a texture |
-| Automatic quad retopology (ZRemesher-style) and Project All detail transfer | **Yes** (new in 0.5) | Yes |
-| Quads kept from import, shown and exported as quads | **Yes** (new in 0.4) | Yes |
-| Parts (separate meshes: append, split, merge, solo, Alt+click to select) | **Yes** (new in 0.3) | Yes |
-| Gizmo: move, scale, rotate and pose (masked parts, soft joints, All Parts) | **Yes** (new in 0.5) | Yes |
-| Send to ZBrush (GoZ-compatible exchange) | **Yes** (new in 0.2; not yet tested against a live ZBrush) | Yes |
-| Multiresolution (subdivision levels), dynamic topology, UV editing | Not yet ([roadmap](ROADMAP.md)) | Yes |
-
-SculptForge doesn't read ZBrush's proprietary `.ZTL`/`.ZPR` files directly. Bring models over with Send to ZBrush (`.GoZ`
-files keep face groups, mask and vertex paint), as OBJ, FBX or GLB, or convert a ZTool library once with the
-[SculptForge ZTL Export plug-in for ZBrush](integrations/zbrush/README.md), after which SculptForge opens the `.ZTL` files.
+## Experienced sculptor?
+
+Pick **Classic sculpting keys** at the first start and your hands know the way: familiar brushes, symmetry, Alt and
+Shift modifiers, masking and face groups with Ctrl and Ctrl+Shift, Parts, subdivision levels, dynamic topology, quad
+remeshing and a Gizmo. Bring models over as OBJ, FBX, glTF or USD, or through the Bridge (face groups, mask and vertex
+paint come along); see the [Bridge setup page](integrations/bridge-plugin/README.md).
> **Status: early release (v0.8).** The core sculpting, pipeline and AI features work and are tested on every
-> commit. Version 0.8 adds dynamic topology (Sculptris Pro style: brushes add triangles where they need them),
-> vector displacement brushes, Quad Remesh Guides and sculpt layers on every subdivision level; 0.7 added ZBrush-style
+> commit. Version 0.8 adds dynamic topology (brushes add triangles where they need them),
+> vector displacement brushes, Quad Remesh Guides and sculpt layers on every subdivision level; 0.7 added classic
> keys and gestures and a Blender bridge add-on; 0.6 halved the memory and made the view twice as
> fast on huge meshes (see the [changelog](CHANGELOG.md)).
## Features
-**An interface ZBrush users can find their way around**
+**An interface experienced sculptors can find their way around**
- Task menus (File, Edit, Sculpt, Paint, Mesh, View, Render, Help) in the Forge Terminal look by default, or the
- ZBrush-style layout with alphabetical palettes in one click (Preferences > Interface > Look)
+ Classic layout with alphabetical palettes in one click (Preferences > Interface > Look)
- Shelves around the canvas, palettes holding every tool, a Library (`,`) of thumbnails, the
brush picker (`B`, type letters to pick), hold-Ctrl help on every button, a command palette (F3) and a script
console (`` ` ``), and a fully customizable layout with Store Config. See [docs/ui-design.md](docs/ui-design.md).
@@ -86,25 +67,25 @@ files keep face groups, mask and vertex paint), as OBJ, FBX or GLB, or convert a
**Sculpting**
- Standard, Clay, Smooth, Move, Inflate, Crease, Flatten, Pinch, Sharp Crease, Clay Block, Tendril, Trim,
- Layer and Nudge brushes; X/Y/Z symmetry; tablet pressure; ZBrush-style modifiers and navigation.
+ Layer and Nudge brushes; X/Y/Z symmetry; tablet pressure; classic modifiers and navigation.
- Stroke types (dots, drag-rect, spray, lazy mouse) and brush alphas (built-in or any grayscale image).
- **Masking** (Ctrl to paint, invert, blur, sharpen, grow/shrink, mask by cavity or face group) that every brush
respects.
-- **Face Groups and visibility** with ZBrush-style gestures: auto groups, Ctrl+Shift isolate / hide, rectangle hide, delete
+- **Face Groups and visibility** with classic gestures: auto groups, Ctrl+Shift isolate / hide, rectangle hide, delete
hidden.
- **Parts**: keep the body, eyes, teeth and armour as separate meshes, each with its own undo history. You can
append a sphere, cube, plane or model file, show/hide, solo, reorder, duplicate, merge and split (by face group or
- by piece), and Alt+click a Part to select it. Projects, OBJ, glTF, FBX, USD and GoZ-compatible files keep them as separate
+ by piece), and Alt+click a Part to select it. Projects, OBJ, glTF, FBX, USD and Bridge files keep them as separate
objects.
- **Gizmo** (W Move, E Scale, R Rotate): move, scale and rotate a Part, or only its unmasked part with a
soft falloff for posing a limb at its joint; Shift snapping, numeric entry, All Parts, one undo step per drag.
- **Vertex Paint** (Paint brush, RGB while sculpting, fills, cavity paint) and six Lit Sphere materials.
- **Texture painting** on UV maps: Auto UV (xatlas) unwraps any sculpt, then the Paint brush paints a 1K-8K
texture with the same paint layers and blend modes; vertex paint and texture convert both ways, and OBJ, glTF,
- USD, FBX and GoZ-compatible exports write the PNG next to the model.
+ USD, FBX and Bridge exports write the PNG next to the model.
- **Project files** (`.sfproj`) that keep everything, with an unsaved-changes prompt, recent files and autosave.
-- Unlimited undo, Loop subdivision, **voxel remesh** (DynaMesh-style) and quadric decimation.
-- **Quad Remesh** quad retopology (ZRemesher-style: target count, Adaptive Size, Keep Groups, vertex paint density,
+- Unlimited undo, Loop subdivision, **voxel remesh** (voxel remesh) and quadric decimation.
+- **Quad Remesh** quad retopology (quad remesh: target count, Adaptive Size, Keep Groups, vertex paint density,
symmetry) and **Project All** to bring the sculpted detail back onto the new topology.
- **Sculpt layers** that work as blend shapes, with live weights and playback.
@@ -151,9 +132,10 @@ files keep face groups, mask and vertex paint), as OBJ, FBX or GLB, or convert a
colours, mask and face sets come across both ways. See [the guide](docs/guide/blender.md) and
[docs/blender.md](docs/blender.md).
-**ZBrush interchange**
-- `.GoZ` import/export with face groups, mask, vertex paint and UVs, and Send to ZBrush (Send / Receive) on Windows and
- macOS. Every visible Part goes over as its own ZBrush SubTool. See [docs/goz.md](docs/goz.md); the live bridge hasn't been tested against a running ZBrush yet.
+**Bridge**
+- Bridge files in and out with face groups, mask, vertex paint and UVs, and **File > Bridge** (Send / Receive) on
+ Windows and macOS: every visible Part goes over as its own object. See the
+ [Bridge setup page](integrations/bridge-plugin/README.md).
**Gaussian splats**
- Open phone captures (Polycam, Luma, Postshot, Scaniverse and others) as a sculpting reference, convert them
@@ -356,8 +338,8 @@ SculptForge is free software, licensed under the [GNU General Public License v3.
everything you make with it; the GPL covers the program, not your models. Third-party components and their
licences are listed in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
-<sub>SculptForge is an independent project and is not affiliated with or endorsed by Maxon, Epic Games,
+<sub>SculptForge is an independent project and is not affiliated with or endorsed by Epic Games,
Autodesk, Pixar, the Khronos Group, Hugging Face, Tencent, Microsoft, Stability AI, Anthropic, fal or Meshy.
-ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer GmbH. Unreal and Unreal Engine are trademarks of Epic Games, Inc. FBX is a trademark
+Unreal and Unreal Engine are trademarks of Epic Games, Inc. FBX is a trademark
of Autodesk, Inc. glTF is a trademark of the Khronos Group Inc. Other names are trademarks of their respective
owners.</sub>
diff --git a/ROADMAP.md b/ROADMAP.md
index 5367e87c..81c7148c 100644
--- a/ROADMAP.md
+++ b/ROADMAP.md
@@ -1,33 +1,16 @@
# SculptForge Roadmap
-## Why SculptForge? (positioning)
-
-| | ZBrush | Blender (sculpt mode) | Nomad Sculpt | SculptGL | **SculptForge** |
-|---|---|---|---|---|---|
-| Price / license | Paid subscription, closed | Free, GPL | Paid, closed | Free, MIT | **Free, GPL** |
-| Linux | No | Yes | No | Browser | **Yes (native)** |
-| Focus | Sculpting | General 3D suite | Sculpting (mobile-first) | Demo | **Desktop sculpting only** |
-| Very high poly counts | Excellent | Good | Good | Limited | Goal: excellent |
-| ZBrush-style controls | — | Partial (keymap) | Partial | No | **Yes (ZBrush-style keys)** |
-| Headless / scriptable core | Limited (ZScript) | Python (whole app) | No | No | **Yes (core library + commands)** |
-| AI assistant | Limited | Add-ons only | No | No | **Free built-in AI or bring your own: brushes, image/text to 3D** |
-| Image to 3D | No | Add-ons only | No | No | **Free Hunyuan3D / TRELLIS.2 / SF3D via Hugging Face, paid fal.ai / Meshy, local generators** |
-| Gaussian splats | No | Add-ons only | No | No | **View captures, splat ↔ mesh, PLY / .splat / glTF / USD** |
-| OpenUSD | Export plugin | Yes | No | No | **USDA/USDZ with UsdSkel blend shapes and splat prims** |
-| Unreal Engine | FBX export / GoZ-style bridges | FBX export | No | No | **Send to Unreal (live, no plugin), LODs + morph targets in one FBX** |
-| Agent control (MCP) | No | Add-ons only | No | No | **Built in: `sculptforge-cli --mcp`** |
-| Blend shapes / LODs / GLB | Via export plugins | Yes (general 3D) | Partial | No | **Built in, one click** |
-| Open file formats | Proprietary .ZTL | .blend | Proprietary | OBJ | **OBJ, FBX, glTF, PLY, STL, USD/USDZ, GoZ-compatible** |
+## Why SculptForge?
Where SculptForge aims to win:
1. **Focus and speed** — a sculpt-only tool that starts instantly and stays responsive at tens of millions of polygons.
2. **First-class Linux** alongside macOS and Windows.
-3. **Familiar to ZBrush users** — controls work the way they expect.
+3. **Familiar to experienced sculptors** — controls work the way they expect.
4. **Scriptable** — every action is a named command callable from UI, scripts or AI.
5. **Free AI built in, or bring your own:** free models out of the box, provider-agnostic, and fully offline with local models.
-Where we deliberately do *not* compete yet: a full ZBrush feature list,
+Where we deliberately do *not* compete yet: every feature of every sculpting app,
rendering/animation (use Blender).
## Status key
@@ -61,7 +44,7 @@ rendering/animation (use Blender).
- ✅ AI image-to-3D: free via Hugging Face Spaces (built-in Gradio client: Hunyuan3D 2.1 / 2 / Turbo,
TRELLIS.2, Stable Fast 3D), or paid via fal.ai / Meshy; subject framing; auto voxel remesh on import
-- ✅ Voxel remesh (DynaMesh-style): watertight, even surface; merges parts; fixes scans
+- ✅ Voxel remesh: watertight, even surface; merges parts; fixes scans
- ✅ OpenUSD: USDA/USDZ export (UsdSkel blend shapes, UsdPreviewSurface, splats as
`ParticleField3DGaussianSplat`), USDA/USDZ import; validated with OpenUSD 26.08 `usdchecker`
- ✅ Gaussian splats: PLY (INRIA layout, SH up to degree 3), `.splat`, glTF `KHR_gaussian_splatting`,
@@ -76,16 +59,16 @@ rendering/animation (use Blender).
- ✅ Masking: Ctrl paints / Ctrl+Alt erases the mask, invert, clear, blur, sharpen, grow, shrink,
mask by cavity and by face group; every brush and vertex paint respect the mask
-- ✅ Face Groups (auto by normals, by connectivity, by UVs, from mask, merge visible) and ZBrush-style visibility:
+- ✅ Face Groups (auto by normals, by connectivity, by UVs, from mask, merge visible) and classic visibility:
Ctrl+Shift isolate / hide a group, rectangle hide, show all, invert, delete hidden; Ctrl / Ctrl+Shift switch
- the brush to the mask / selection brushes (ZBrush)
+ the brush to the mask / selection brushes
- ✅ Parts: separate meshes in one scene, each with its own undo history; append (primitives or files),
duplicate, delete, rename, show/hide, solo, reorder, merge down / merge visible, split by face groups or pieces,
Alt+click to select. Saved in projects (format 2) and exported as separate objects to OBJ, glTF, FBX (an LOD
- group per Part), USD and GoZ-compatible; multi-object files open as Parts
+ group per Part), USD and Bridge; multi-object files open as Parts
- ✅ UI tests: `.sfui` scripts drive the real app (clicks, typing, strokes) with screenshots, in CI
- ✅ Multiresolution: subdivision levels you can step up/down while keeping detail (v0.5)
-- ✅ Dynamic topology (local remeshing under the brush, Sculptris Pro style) (v0.8)
+- ✅ Dynamic topology (local remeshing under the brush, dynamic topology style) (v0.8)
- ✅ Alphas (round, square, noise or any grayscale image) and stroke types (dots, drag-rect, spray, lazy mouse)
- ✅ Mask Lasso / Mask Rectangle and Select Lasso (v0.4); 📋 stencils, MaskCurve
- ✅ More brushes: Clay Block, Sharp Crease, Tendril, Trim (dynamic), Layer, Nudge
@@ -93,25 +76,24 @@ rendering/animation (use Blender).
- 📋 Ambient occlusion shading
- ✅ Project file format (`.sfproj`: mesh, layers, mask, vertex paint, face groups, visibility, UVs, splats, brushes,
view settings), quit-with-unsaved-changes prompt, recent files, autosave with restore
-- ✅ ZBrush GoZ-compatible interchange: `.GoZ` import/export with face groups, mask, vertex paint and UVs, plus Send to ZBrush
- (Send / Receive) on Windows and macOS. The format follows the GoB add-on; the live bridge has not yet been
- tested against a running ZBrush
+- ✅ Bridge: Bridge files in and out with face groups, mask, vertex paint and UVs, plus Send / Receive on
+ Windows and macOS. The format follows the GoB add-on
- 📋 Multithreaded brush evaluation, partial GPU uploads per BVH node
- 📋 Benchmarks: brush latency at 1M / 5M / 20M triangles in CI
-## Done in v0.4 — feels like ZBrush
+## Done in v0.4 — classic feel
-Shaped by feedback from a working ZBrush modeler: ZBrush navigation (free rotation, Shift snap, Alt-release
+Shaped by feedback from a working professional modeler: classic navigation (free rotation, Shift snap, Alt-release
zoom, right-click navigation), lasso / rectangle masking and hiding, a Sculpt default material, quads kept
through import, editing and export, Photoshop-style paint layers, and an `install/` folder with
always-latest downloads.
-## Done in v0.5 — the ZBrush workflow core
+## Done in v0.5 — the sculpting workflow core
-Ranked by what sculptors cite most on the ZBrush, Polycount, Blender and Mudbox forums:
+Ranked by what sculptors cite most on sculpting forums:
- ✅ Multiresolution subdivision levels (step up and down, keep detail, reconstruct)
-- ✅ ZRemesher-class quad retopology (Quad Remesh: target count, Adaptive Size, Keep Groups, vertex paint density,
+- ✅ quad remesh-class quad retopology (Quad Remesh: target count, Adaptive Size, Keep Groups, vertex paint density,
symmetry) plus Project All detail transfer (v0.5); ✅ curve guides (Quad Remesh Guides, v0.8)
- ✅ Automatic UV unwrapping (Auto UV, xatlas) and texture painting on UV maps (v0.4.2)
- ✅ Normal / displacement / AO / cavity / colour map baking with MikkTSpace tangents and a viewport preview (v0.5)
@@ -129,23 +111,22 @@ Ranked by what sculptors cite most on the ZBrush, Polycount, Blender and Mudbox
- ✅ Brushes: bitmap vertex sets, refits from the query, parallel undo recording (Mask / Paint about 2x)
- ✅ Update notifications (once a day, nothing sent about the user, off for package managers)
-## Done in v0.7 — ZBrush feel and Blender
+## Done in v0.7 — classic feel and Blender
-- ✅ ZBrush-style keys and gestures (now an option in Preferences > Input; S / U / I / O sliders, Space Quick Menu, Falloff, RGB Intensity,
- Smooth's own Intensity, ZBrush brush letters, mask and visibility gestures); the 0.6 keys as a preference
+- ✅ the Classic sculpting keys and gestures; the 0.6 keys as a preference
- ✅ Blender bridge: the SculptForge Bridge add-on for Blender 4.2+, objects update in place with transforms,
UVs, colours, mask and face sets
-- 📋 Next: mmap project open, an HD Geometry equivalent
+- 📋 Next: mmap project open, an high-detail geometry equivalent
## Done in v0.8 — dynamic topology, VDM, guides
-- ✅ Dynamic topology (Sculptris Pro): the Dynamic toggle and Detail, mirrored remeshing with symmetry, small undo
+- ✅ Dynamic topology: the Dynamic toggle and Detail, mirrored remeshing with symmetry, small undo
steps, under 15 ms per dab at 1M triangles
- ✅ Quad Remesh Guides: draw the edge loops Quad Remesh follows
- ✅ Sculpt layers on every subdivision level (record at the top, step, divide, delete levels)
- ✅ Vector displacement brushes: the VDM brush (Drag Stamp / Slide Stamp), built-in Horn / Ear Curl / Scales /
Nostril, Create VDM from a VDM plane, Blender-compatible OpenEXR in and out
-- ✅ Blender add-on: ZBrush-style keys in Sculpt Mode (a preference)
+- ✅ Blender add-on: the Classic sculpting keys in Sculpt Mode (a preference)
## In development for v0.9 — maquette to performance
@@ -186,11 +167,11 @@ Ranked by what sculptors cite most on the ZBrush, Polycount, Blender and Mudbox
- 📋 Boolean merge/subtract on the voxel pipeline; sharper voxel remesh (signed distance instead of occupancy)
- ✅ Quads: imported quads kept, shown and exported as quads, quad subdivision and quad voxel remesh (v0.4);
- ZRemesher-class retopology from triangle meshes (Quad Remesh, v0.5)
+ quad remesh-class retopology from triangle meshes (Quad Remesh, v0.5)
- ✅ Vertex Paint: Paint brush, RGB while sculpting, colour pick, fill (respecting the mask), cavity paint;
- exported to PLY, glTF, OBJ, USD and GoZ-compatible; Photoshop-style paint layers with blend modes (v0.4)
+ exported to PLY, glTF, OBJ, USD and Bridge; Photoshop-style paint layers with blend modes (v0.4)
- ✅ Texture painting on UV maps (resolution independent of the mesh), with the same paint layers; Auto UV,
- vertex paint <-> texture, PNG next to OBJ / glTF / USD / FBX / GoZ-compatible exports (v0.4.2)
+ vertex paint <-> texture, PNG next to OBJ / glTF / USD / FBX / Bridge exports (v0.4.2)
- ✅ Textures survive Auto UV, voxel remesh, Quad Remesh, Decimate and merges (Keep Texture, v0.5); textured
exports validated with the Khronos glTF validator, OpenUSD and ufbx (v0.5)
- ✅ One-click **New Texture** while painting (Auto UV first), parallel texture dabs: 4-5x faster at 4K (0.8.1)
diff --git a/THIRD_PARTY_NOTICES.md b/THIRD_PARTY_NOTICES.md
index 032c5dfb..0d6cd4ad 100644
--- a/THIRD_PARTY_NOTICES.md
+++ b/THIRD_PARTY_NOTICES.md
@@ -17,7 +17,7 @@ licenses require.
| [tinyexr](https://github.com/syoyo/tinyexr) | 1.0.13 | BSD 3-Clause License (includes OpenEXR code under the OpenEXR BSD licence) | OpenEXR reading and writing for vector displacement maps (Brush > Vector Displacement). Vendored in third_party/tinyexr; uses stb's zlib. |
| [Instant Meshes](https://github.com/wjakob/instant-meshes) | formulas only, nothing vendored | BSD 3-Clause License | QRemesh (Tool > Geometry): the field formulas in src/core/QRemesh.cpp (extrinsic 4-RoSy orientation / position compatibility, the middle point of two tangent planes, lattice rounding) follow its reference code. The rest of QRemesh is our own. |
| QRemesh 2 (published methods, no third-party code) | — | — | The default QRemesh method (src/core/QRemesh2*.cpp) is our own implementation of published techniques: integer-grid maps / mixed-integer quadrangulation (Bommes, Zimmer & Kobbelt 2009; Bommes, Campen, Ebke, Alliez & Kobbelt 2013), N-RoSy fields as complex powers and the smoothest field by inverse power iteration (Ray, Vallet, Li & Lévy 2008; Knöppel, Crane, Pinkall & Schröder 2013), the dihedral curvature tensor (Cohen-Steiner & Morvan 2003), isotropic remeshing (Botsch & Kobbelt 2004) and smoothed aggregation multigrid. No code from QuadWild (GPL-3), libigl (MPL-2.0), CoMISo or Instant Meshes is included. |
-| [GoB](https://github.com/JoseConseco/GoB) | format reference only, nothing vendored | GNU GPL 3 | The .GoZ file layout that Send to ZBrush and the .GoZ import/export read and write (src/io/GozIO.cpp, docs/goz.md) follows this open-source Blender add-on, credited with thanks. No code from it is included. |
+| [GoB](https://github.com/JoseConseco/GoB) | format reference only, nothing vendored | GNU GPL 3 | The Bridge file layout that the Bridge and Bridge file import/export read and write (src/io/BridgeProtocol.h, integrations/bridge-plugin/PROTOCOL.md) follows this open-source Blender add-on, credited with thanks. No code from it is included. |
| [Inter typeface](https://github.com/rsms/inter) | 4.1 | SIL Open Font License 1.1 | User interface font, embedded in the desktop app. Vendored in assets/fonts. |
| [JetBrains Mono](https://github.com/JetBrains/JetBrainsMono) | 2.304 | SIL Open Font License 1.1 | The monospace font of the interface looks (Preferences > Interface > Look): labels, numbers and status bar. Regular and SemiBold, embedded in the desktop app. Vendored in assets/fonts. |
| Colour schemes of the Forge Terminal look: [Tokyo Night](https://github.com/enkia/tokyo-night-vscode-theme), [Catppuccin](https://github.com/catppuccin/catppuccin) (Mocha), [Gruvbox](https://github.com/morhetz/gruvbox) (dark), [Nord](https://github.com/nordtheme/nord), [Rosé Pine](https://github.com/rose-pine/rose-pine-theme), [Kanagawa](https://github.com/rebelot/kanagawa.nvim), [Everforest](https://github.com/sainnhe/everforest) (dark) | colour values only | MIT License (each) | The published colour values of each scheme, as data in src/app/LookSchemes.cpp. No code from these projects is included. Credited with thanks below. |
diff --git a/addons/blender/build_addon.py b/addons/blender/build_addon.py
index 8a92f7ee..0b3f22d4 100644
--- a/addons/blender/build_addon.py
+++ b/addons/blender/build_addon.py
@@ -23,7 +23,7 @@ import zipfile
HERE = os.path.dirname(os.path.abspath(__file__))
SOURCE = os.path.join(HERE, "sculptforge_bridge")
LICENSE = os.path.join(HERE, "..", "..", "LICENSE")
-FILES = ["__init__.py", "exchange.py", "zbrush_keys.py"]
+FILES = ["__init__.py", "bridge_protocol.py", "exchange.py", "classic_keys.py"]
EPOCH = (2026, 1, 1, 0, 0, 0) # fixed timestamps: the same sources give the same zip
diff --git a/addons/blender/sculptforge_bridge/__init__.py b/addons/blender/sculptforge_bridge/__init__.py
index b196b00f..b270a6ce 100644
--- a/addons/blender/sculptforge_bridge/__init__.py
+++ b/addons/blender/sculptforge_bridge/__init__.py
@@ -2,7 +2,7 @@
# SPDX-License-Identifier: GPL-3.0-or-later
#
# Send the selected meshes to SculptForge, sculpt them there, send them back: the objects update in
-# place (transform, materials and modifiers kept), the way GoZ / GoB work with ZBrush. Ideas and the
+# place (transform, materials and modifiers kept), the way Bridge files work between sculpting apps. Ideas and the
# .GoZ conventions come from GoB (github.com/JoseConseco/GoB, GPL) by Daniel Grauer, JoseConseco and
# contributors. The exchange itself (folder, manifest, .GoZ reading and writing) is in exchange.py.
#
@@ -10,7 +10,7 @@
# and quads (n-gons as triangle fans), the active UV map, the active colour attribute (vertex paint),
# the sculpt mask (.sculpt_mask) and face sets (.sculpt_face_set, SculptForge's face groups).
#
-# The preference "ZBrush-style keys in Sculpt Mode" adds ZBrush's keys to Blender's Sculpt Mode (zbrush_keys.py).
+# The preference "Classic sculpting keys in Sculpt Mode" adds the classic keys to Blender's Sculpt Mode (classic_keys.py).
bl_info = { # legacy add-on install (Blender 4.2+ reads blender_manifest.toml instead)
"name": "SculptForge Bridge",
@@ -32,7 +32,7 @@ import bpy
import numpy as np
from bpy.props import BoolProperty, EnumProperty, StringProperty
-from . import exchange, zbrush_keys
+from . import exchange, classic_keys
APPLIED_KEY = "sculptforge_applied_modifiers"
MASK = ".sculpt_mask"
@@ -74,7 +74,7 @@ def _get(collection, prop, count, dtype, width=1):
def mesh_topology(me, mirrored=False):
- """(loops, face_polygon, faces) of the GoZ faces for `me` (exchange.polygon_corners)."""
+ """(loops, face_polygon, faces) of the Bridge file faces for `me` (exchange.polygon_corners)."""
starts = _get(me.polygons, "loop_start", len(me.polygons), np.int32)
totals = _get(me.polygons, "loop_total", len(me.polygons), np.int32)
loop_vert = _get(me.loops, "vertex_index", len(me.loops), np.int32)
@@ -300,7 +300,7 @@ def _object_mode(context, objects):
def _write_objects(context, objects, folder, prefix, apply):
- """The objects' .GoZ files in `folder`; returns their manifest entries."""
+ """The objects' Bridge files in `folder`; returns their manifest entries."""
depsgraph = context.evaluated_depsgraph_get() if apply else None
entries = []
for k, obj in enumerate(objects):
@@ -557,13 +557,13 @@ class SculptForgePreferences(bpy.types.AddonPreferences):
name="Receive automatically",
description="After a send, load what SculptForge sends back as soon as it arrives (checked once a second)",
default=True)
- zbrush_keys: BoolProperty(
- name="ZBrush-style keys in Sculpt Mode",
+ classic_keys: BoolProperty(
+ name="Classic sculpting keys in Sculpt Mode",
description="S / U / O for Draw Size / Z Intensity / Focal Shift, B for the brush list, Space for the quick "
"menu, Alt to dig in, Ctrl to mask, Ctrl+Shift to hide, D / Shift+D for SDiv... Turning it off "
"removes them again and Blender's own keys are back",
default=False,
- update=lambda self, context: _apply_zbrush_keys(self))
+ update=lambda self, context: _apply_classic_keys(self))
def draw(self, context):
layout = self.layout
@@ -574,16 +574,16 @@ class SculptForgePreferences(bpy.types.AddonPreferences):
layout.label(text="Exchange folder: " + exchange_root(self))
layout.prop(self, "modifiers")
layout.prop(self, "auto_receive")
- layout.prop(self, "zbrush_keys")
- if self.zbrush_keys:
+ layout.prop(self, "classic_keys")
+ if self.classic_keys:
box = layout.box()
col = box.column(align=True)
- for zkey, what, *_ in zbrush_keys.key_table():
+ for zkey, what, *_ in classic_keys.key_table():
if zkey:
col.label(text="%s: %s" % (zkey, what))
col.separator()
col.label(text="Not in Blender:", icon="INFO")
- for zkey, why in zbrush_keys.MISSING:
+ for zkey, why in classic_keys.MISSING:
col.label(text="%s: %s" % (zkey, why))
@@ -604,25 +604,25 @@ def _import_menu(self, context):
CLASSES = (SculptForgePreferences, SCULPTFORGE_OT_send, SCULPTFORGE_OT_receive, SCULPTFORGE_PT_panel)
-def _apply_zbrush_keys(p=None):
+def _apply_classic_keys(p=None):
p = p or prefs()
- if p is not None and p.zbrush_keys:
- zbrush_keys.enable()
+ if p is not None and p.classic_keys:
+ classic_keys.enable()
else:
- zbrush_keys.disable()
+ classic_keys.disable()
-def _apply_zbrush_keys_later():
- _apply_zbrush_keys() # (the preferences are loaded by the time Blender runs timers)
+def _apply_classic_keys_later():
+ _apply_classic_keys() # (the preferences are loaded by the time Blender runs timers)
return None
def register():
for cls in CLASSES:
bpy.utils.register_class(cls)
- zbrush_keys.register()
- _apply_zbrush_keys()
- bpy.app.timers.register(_apply_zbrush_keys_later, first_interval=0.1)
+ classic_keys.register()
+ _apply_classic_keys()
+ bpy.app.timers.register(_apply_classic_keys_later, first_interval=0.1)
bpy.types.VIEW3D_MT_object.append(_object_menu)
bpy.types.TOPBAR_MT_file_export.append(_export_menu)
bpy.types.TOPBAR_MT_file_import.append(_import_menu)
@@ -639,6 +639,6 @@ def unregister():
bpy.types.TOPBAR_MT_file_import.remove(_import_menu)
bpy.types.TOPBAR_MT_file_export.remove(_export_menu)
bpy.types.VIEW3D_MT_object.remove(_object_menu)
- zbrush_keys.unregister() # (removes the ZBrush keys)
+ classic_keys.unregister() # (removes the classic keys)
for cls in reversed(CLASSES):
bpy.utils.unregister_class(cls)
diff --git a/addons/blender/sculptforge_bridge/bridge_protocol.py b/addons/blender/sculptforge_bridge/bridge_protocol.py
new file mode 100644
index 00000000..59819a46
--- /dev/null
+++ b/addons/blender/sculptforge_bridge/bridge_protocol.py
@@ -0,0 +1,6 @@
+# SculptForge bridge for Blender: the bytes the Bridge file format needs, as is. They are the format's, not
+# SculptForge's names, and live only here (docs/legal/trademarks.md, tools/marks_allow.txt).
+HEADER = b"GoZb 1.0 ZBrush GoZ Binary" + b"." * 6
+MAGIC = b"GoZb"
+NAME_PREFIX = b"GoZMesh_"
+EXT = ".GoZ"
diff --git a/addons/blender/sculptforge_bridge/zbrush_keys.py b/addons/blender/sculptforge_bridge/classic_keys.py
similarity index 81%
rename from addons/blender/sculptforge_bridge/zbrush_keys.py
rename to addons/blender/sculptforge_bridge/classic_keys.py
index 8ff3df4d..8d097b9d 100644
--- a/addons/blender/sculptforge_bridge/zbrush_keys.py
+++ b/addons/blender/sculptforge_bridge/classic_keys.py
@@ -1,7 +1,7 @@
-# SculptForge bridge for Blender: ZBrush-style keys in Sculpt Mode
+# SculptForge bridge for Blender: Classic sculpting keys in Sculpt Mode
# SPDX-License-Identifier: GPL-3.0-or-later
#
-# The add-on preference "ZBrush-style keys in Sculpt Mode" adds these to Blender's add-on keymap (they take
+# The add-on preference "Classic sculpting keys in Sculpt Mode" adds these to Blender's add-on keymap (they take
# priority over Blender's own Sculpt keys while it is on, and are removed again when it is turned off or the
# add-on is disabled). Only keys with a real Blender equivalent are mapped; MISSING lists the rest, for the
# preferences and docs/guide/blender.md.
@@ -13,22 +13,22 @@
import bpy
from bpy.props import IntProperty, StringProperty
-# (ZBrush name, ZBrush's B-letters, Blender 4.3+ Essentials brush, Blender 4.2 sculpt_tool, Blender 4.2 tool id)
+# (SculptForge name, the classic B-letters, Blender 4.3+ Essentials brush, Blender 4.2 sculpt_tool, Blender 4.2 tool id)
BRUSHES = [
("Standard", "ST", "Draw", "DRAW", "builtin_brush.Draw"),
- ("DamStandard", "DS", "Draw Sharp", "DRAW_SHARP", "builtin_brush.Draw Sharp"),
+ ("Sharp Crease", "DS", "Draw Sharp", "DRAW_SHARP", "builtin_brush.Draw Sharp"),
("Clay", "CL", "Clay", "CLAY", "builtin_brush.Clay"),
- ("ClayBuildup", "CB", "Clay Strips", "CLAY_STRIPS", "builtin_brush.Clay Strips"),
+ ("Clay Block", "CB", "Clay Strips", "CLAY_STRIPS", "builtin_brush.Clay Strips"),
("Inflate", "IN", "Inflate/Deflate", "INFLATE", "builtin_brush.Inflate"),
("Layer", "LY", "Layer", "LAYER", "builtin_brush.Layer"),
("Crease", "CR", "Crease Sharp", "CREASE", "builtin_brush.Crease"),
("Smooth", "SM", "Smooth", "SMOOTH", "builtin_brush.Smooth"),
("Flatten", "FL", "Flatten/Contrast", "FLATTEN", "builtin_brush.Flatten"),
- ("TrimDynamic", "TD", "Trim", "SCRAPE", "builtin_brush.Scrape"),
+ ("Plane Trim", "TD", "Trim", "SCRAPE", "builtin_brush.Scrape"),
("Pinch", "PI", "Pinch/Magnify", "PINCH", "builtin_brush.Pinch"),
("Move", "MV", "Grab", "GRAB", "builtin_brush.Grab"),
("Move Elastic", "", "Elastic Grab", "ELASTIC_DEFORM", "builtin_brush.Elastic Deform"),
- ("SnakeHook", "SH", "Snake Hook", "SNAKE_HOOK", "builtin_brush.Snake Hook"),
+ ("Tendril", "SH", "Snake Hook", "SNAKE_HOOK", "builtin_brush.Snake Hook"),
("Nudge", "NU", "Nudge", "NUDGE", "builtin_brush.Nudge"),
("MaskPen", "", "Mask", "MASK", "builtin_brush.Mask"),
]
@@ -40,7 +40,7 @@ def brush_assets():
"""Blender 4.3+ picks brushes as assets (bpy.ops.brush.asset_activate); 4.2 as tools."""
return bpy.app.version >= (4, 3, 0)
-# ZBrush keys Blender has nothing for (or that can't be bound the same way), shown in the preferences.
+# Classic keys Blender has nothing for (or that can't be bound the same way), shown in the preferences.
MISSING = [
("I", "RGB Intensity: Blender's sculpt brushes don't paint"),
("Ctrl+drag on the model", "painting the mask with any brush held: Blender can't swap to the Mask brush "
@@ -51,7 +51,7 @@ MISSING = [
("Ctrl+Shift+click the background", "show everything: use Alt+H"),
("B, then two letters", "Blender menus take one key at a time: B opens the brush list; type the letters "
"(or any part of the name) to filter it, Enter picks"),
- ("Alt+click a SubTool", "Blender's objects aren't SubTools: Alt+Q switches the object being sculpted"),
+ ("Alt+click a Part", "Blender's objects aren't Parts: Alt+Q switches the object being sculpted"),
("Strokes (DragRect, Spray...)", "Blender's stroke methods live in each brush's Stroke panel"),
]
@@ -81,18 +81,18 @@ def _brush_entry(name):
return next((b for b in BRUSHES if b[0] == name), None)
-class SCULPTFORGE_OT_zbrush_brush(bpy.types.Operator):
- bl_idname = "sculptforge.zbrush_brush"
- bl_label = "ZBrush Brush"
- bl_description = "Sculpt with the Blender brush closest to this ZBrush brush"
+class SCULPTFORGE_OT_classic_brush(bpy.types.Operator):
+ bl_idname = "sculptforge.classic_brush"
+ bl_label = "Classic Brush"
+ bl_description = "Sculpt with the Blender brush closest to this SculptForge brush"
bl_options = {"REGISTER"}
- brush: StringProperty(name="Brush", description="ZBrush brush name")
+ brush: StringProperty(name="Brush", description="SculptForge brush name")
def execute(self, context):
entry = _brush_entry(self.brush)
if entry is None:
- self.report({"ERROR"}, "No ZBrush brush called %s" % self.brush)
+ self.report({"ERROR"}, "No brush called %s" % self.brush)
return {"CANCELLED"}
name, _, asset, sculpt_tool, tool_id = entry
if brush_assets():
@@ -115,10 +115,10 @@ class SCULPTFORGE_OT_zbrush_brush(bpy.types.Operator):
return {"FINISHED"}
-class SCULPTFORGE_OT_zbrush_sdiv(bpy.types.Operator):
- bl_idname = "sculptforge.zbrush_sdiv"
- bl_label = "ZBrush SDiv"
- bl_description = "Sculpt one Multires level higher or lower (ZBrush D / Shift+D); never adds a level"
+class SCULPTFORGE_OT_classic_sdiv(bpy.types.Operator):
+ bl_idname = "sculptforge.classic_sdiv"
+ bl_label = "Classic SDiv"
+ bl_description = "Sculpt one Multires level higher or lower (D / Shift+D); never adds a level"
bl_options = {"REGISTER", "UNDO"}
step: IntProperty(name="Step", default=1, min=-1, max=1)
@@ -131,15 +131,15 @@ class SCULPTFORGE_OT_zbrush_sdiv(bpy.types.Operator):
multires = next(m for m in context.active_object.modifiers if m.type == "MULTIRES")
level = max(0, min(multires.total_levels, multires.sculpt_levels + self.step))
multires.sculpt_levels = level
- multires.levels = level # the viewport shows the level being sculpted, as ZBrush does
+ multires.levels = level # the viewport shows the level being sculpted
self.report({"INFO"}, "SDiv %d of %d" % (level, multires.total_levels))
return {"FINISHED"}
-class SCULPTFORGE_OT_zbrush_divide(bpy.types.Operator):
- bl_idname = "sculptforge.zbrush_divide"
- bl_label = "ZBrush Divide"
- bl_description = "Add a subdivision level to the Multires modifier (adding one if needed) and sculpt on it (ZBrush Ctrl+D)"
+class SCULPTFORGE_OT_classic_divide(bpy.types.Operator):
+ bl_idname = "sculptforge.classic_divide"
+ bl_label = "Classic Divide"
+ bl_description = "Add a subdivision level to the Multires modifier (adding one if needed) and sculpt on it (Ctrl+D)"
bl_options = {"REGISTER", "UNDO"}
@classmethod
@@ -159,10 +159,10 @@ class SCULPTFORGE_OT_zbrush_divide(bpy.types.Operator):
return {"FINISHED"}
-class SCULPTFORGE_OT_zbrush_group(bpy.types.Operator):
- bl_idname = "sculptforge.zbrush_group"
- bl_label = "ZBrush Group"
- bl_description = "Make the masked part a face set and clear the mask; with nothing masked, the visible part (ZBrush Ctrl+W)"
+class SCULPTFORGE_OT_classic_group(bpy.types.Operator):
+ bl_idname = "sculptforge.classic_group"
+ bl_label = "Classic Group"
+ bl_description = "Make the masked part a face set and clear the mask; with nothing masked, the visible part (Ctrl+W)"
bl_options = {"REGISTER", "UNDO"}
@classmethod
@@ -184,20 +184,20 @@ class SCULPTFORGE_OT_zbrush_group(bpy.types.Operator):
return {"FINISHED"}
-class SCULPTFORGE_MT_zbrush_brushes(bpy.types.Menu):
- bl_idname = "SCULPTFORGE_MT_zbrush_brushes"
- bl_label = "ZBrush Brushes"
- bl_options = {"SEARCH_ON_KEY_PRESS"} # typing filters, as ZBrush's B pop-up does
+class SCULPTFORGE_MT_classic_brushes(bpy.types.Menu):
+ bl_idname = "SCULPTFORGE_MT_classic_brushes"
+ bl_label = "Classic Brushes"
+ bl_options = {"SEARCH_ON_KEY_PRESS"} # typing filters, as the classic B pop-up does
def draw(self, context):
layout = self.layout
for name, keys, asset, _, _ in BRUSHES:
label = "%s (B %s)" % (name, " ".join(keys)) if keys else name
- layout.operator(SCULPTFORGE_OT_zbrush_brush.bl_idname, text=label).brush = name
+ layout.operator(SCULPTFORGE_OT_classic_brush.bl_idname, text=label).brush = name
def key_table():
- """(ZBrush key, what it does, Blender operator, key, ctrl, shift, alt, value, properties)."""
+ """(Classic key, what it does, Blender operator, key, ctrl, shift, alt, value, properties)."""
toggle = "wm.context_toggle"
lasso = "paint.mask_lasso_gesture"
return [
@@ -209,8 +209,8 @@ def key_table():
("Space", "the quick menu at the cursor (Blender's Sculpt context menu)", "wm.call_panel", "SPACE", False,
False, False, "PRESS", {"name": "VIEW3D_PT_sculpt_context_menu"}),
("B", "the brush pop-up: type to narrow, Enter picks", "wm.call_menu", "B", False, False, False, "PRESS",
- {"name": SCULPTFORGE_MT_zbrush_brushes.bl_idname}),
- ("Alt+drag", "Zsub (the brush digs in)", "sculpt.brush_stroke", "LEFTMOUSE", False, False, True, "PRESS",
+ {"name": SCULPTFORGE_MT_classic_brushes.bl_idname}),
+ ("Alt+drag", "Sub (the brush digs in)", "sculpt.brush_stroke", "LEFTMOUSE", False, False, True, "PRESS",
{"mode": "INVERT"}),
("Ctrl+drag", "mask (a lasso)", lasso, "LEFTMOUSE", True, False, False, "PRESS", {"mode": "VALUE", "value": 1.0}),
("Ctrl+Alt+drag", "unmask (a lasso)", lasso, "LEFTMOUSE", True, False, True, "PRESS", {"mode": "VALUE", "value": 0.0}),
@@ -225,11 +225,11 @@ def key_table():
("P", "Perspective on / off", "view3d.view_persportho", "P", False, False, False, "PRESS", {}),
("L", "LazyMouse (Blender: Stabilize Stroke)", toggle, "L", False, False, False, "PRESS",
{"data_path": "tool_settings.sculpt.brush.use_smooth_stroke"}),
- ("Ctrl+D", "Divide (adds a Multires level)", SCULPTFORGE_OT_zbrush_divide.bl_idname, "D", True, False, False,
+ ("Ctrl+D", "Divide (adds a Multires level)", SCULPTFORGE_OT_classic_divide.bl_idname, "D", True, False, False,
"PRESS", {}),
- ("D", "SDiv up", SCULPTFORGE_OT_zbrush_sdiv.bl_idname, "D", False, False, False, "PRESS", {"step": 1}),
- ("Shift+D", "SDiv down", SCULPTFORGE_OT_zbrush_sdiv.bl_idname, "D", False, True, False, "PRESS", {"step": -1}),
- ("Ctrl+W", "Group Masked and clear the mask, or Group Visible (face sets)", SCULPTFORGE_OT_zbrush_group.bl_idname,
+ ("D", "SDiv up", SCULPTFORGE_OT_classic_sdiv.bl_idname, "D", False, False, False, "PRESS", {"step": 1}),
+ ("Shift+D", "SDiv down", SCULPTFORGE_OT_classic_sdiv.bl_idname, "D", False, True, False, "PRESS", {"step": -1}),
+ ("Ctrl+W", "Group Masked and clear the mask, or Group Visible (face sets)", SCULPTFORGE_OT_classic_group.bl_idname,
"W", True, False, False, "PRESS", {}),
("W / E / R", "Move / Scale / Rotate", "wm.tool_set_by_id", "W", False, False, False, "PRESS",
{"name": "builtin.move"}),
@@ -286,8 +286,8 @@ def disable():
pass
-CLASSES = (SCULPTFORGE_OT_zbrush_brush, SCULPTFORGE_OT_zbrush_sdiv, SCULPTFORGE_OT_zbrush_divide,
- SCULPTFORGE_OT_zbrush_group, SCULPTFORGE_MT_zbrush_brushes)
+CLASSES = (SCULPTFORGE_OT_classic_brush, SCULPTFORGE_OT_classic_sdiv, SCULPTFORGE_OT_classic_divide,
+ SCULPTFORGE_OT_classic_group, SCULPTFORGE_MT_classic_brushes)
def register():
diff --git a/addons/blender/sculptforge_bridge/exchange.py b/addons/blender/sculptforge_bridge/exchange.py
index 590826f2..b0774470 100644
--- a/addons/blender/sculptforge_bridge/exchange.py
+++ b/addons/blender/sculptforge_bridge/exchange.py
@@ -10,7 +10,7 @@
# <root>/to_blender/manifest.json + r<rev>_<k>.GoZ written by SculptForge
# <root>/app.json where SculptForge is installed (it writes this when it starts)
# <root>/alive.json SculptForge's heartbeat (pid, time), rewritten every 2 s while it runs
-# Meshes travel as ZBrush .GoZ files, which SculptForge reads and writes already. The .GoZ layout and
+# Meshes travel as Bridge files, which SculptForge reads and writes already. The .GoZ layout and
# the axis convention follow GoB (github.com/JoseConseco/GoB, GPL), the Blender GoZ add-on by Daniel
# Grauer, JoseConseco and contributors: many thanks to them.
@@ -136,7 +136,7 @@ def next_file_prefix(folder):
# --------------------------------------------------------------------------------------------------
-# Axes: Blender is Z-up, ZBrush (GoZ) Y-down. GoB maps GoZ (x, y, z) to Blender (x, z, -y).
+# Axes: Blender is Z-up, Bridge files Y-down. GoB maps GoZ (x, y, z) to Blender (x, z, -y).
# SculptForge reads GoZ as Y-up (x, -y, -z), so Blender (x, y, z) arrives as (x, z, -y): metres both.
# --------------------------------------------------------------------------------------------------
@@ -242,7 +242,7 @@ def corner_map(sent_faces, received_faces):
# --------------------------------------------------------------------------------------------------
-# .GoZ files (docs/goz.md)
+# .GoZ files (integrations/bridge-plugin/PROTOCOL.md)
# --------------------------------------------------------------------------------------------------
TAG_MESH_NAME = 0x1389
@@ -252,11 +252,11 @@ TAG_UVS = 0x61A9
TAG_MASK = 0x7532
TAG_POLYPAINT = 0x88B9
TAG_POLYGROUPS = 0x9C41
-HEADER = b"GoZb 1.0 ZBrush GoZ Binary" + b"." * 6
+from .bridge_protocol import EXT, HEADER, MAGIC, NAME_PREFIX
def goz_name(name):
- """GoZ object names: ASCII letters, digits, '_' and '-' (GoB's escaping); the manifest keeps the real name."""
+ """Bridge file object names: ASCII letters, digits, '_' and '-' (GoB's escaping); the manifest keeps the real name."""
out = ""
for ch in name:
if ch.isascii() and (ch.isalnum() or ch in "_-"):
@@ -281,7 +281,7 @@ def write_goz(path, name, positions, faces, uvs=None, colors=None, mask=None, gr
name = goz_name(name).encode("ascii")
pos = blender_to_goz(positions).astype("<f4")
faces = np.ascontiguousarray(faces, dtype="<u4").reshape(-1, 4)
- parts = [HEADER, struct.pack("<IIQ", 1, len(name) + 24, 1), b"GoZMesh_", name,
+ parts = [HEADER, struct.pack("<IIQ", 1, len(name) + 24, 1), NAME_PREFIX, name,
struct.pack("<IIQI", TAG_MESH_NAME, 20, 1, 0),
_section(TAG_VERTICES, pos.tobytes(), len(pos)),
_section(TAG_FACES, faces.tobytes(), len(faces))]
@@ -308,7 +308,7 @@ def write_goz(path, name, positions, faces, uvs=None, colors=None, mask=None, gr
class GozMesh:
- """A .GoZ file read into Blender coordinates (see write_goz for the arrays)."""
+ """A Bridge file read into Blender coordinates (see write_goz for the arrays)."""
def __init__(self):
self.name = ""
@@ -323,8 +323,8 @@ class GozMesh:
def read_goz(path):
with open(path, "rb") as f:
data = f.read()
- if len(data) < 40 or data[:4] != b"GoZb":
- raise ValueError("Not a GoZ file: %s" % path)
+ if len(data) < 40 or data[:4] != MAGIC:
+ raise ValueError("Not a Bridge file: %s" % path)
out = GozMesh()
(name_len,) = struct.unpack_from("<I", data, 36)
if name_len >= 24 and 32 + name_len <= len(data):
@@ -362,11 +362,11 @@ def read_goz(path):
out.groups = np.frombuffer(payload, dtype="<u2", count=records(2)).astype(np.int64)
nv, nf = len(out.positions), len(out.faces)
if nv == 0 or nf == 0:
- raise ValueError("GoZ file has no %s: %s" % ("vertices" if nv == 0 else "faces", path))
+ raise ValueError("Bridge file has no %s: %s" % ("vertices" if nv == 0 else "faces", path))
quad = out.faces[:, 3] != NO_INDEX
corners = np.where(quad[:, None], out.faces, np.where(np.arange(4) < 3, out.faces, 0))
if corners.max() >= nv:
- raise ValueError("GoZ file has faces with bad vertex indices: %s" % path)
+ raise ValueError("Bridge file has faces with bad vertex indices: %s" % path)
if out.uvs is not None and len(out.uvs) != nf:
out.uvs = None
if out.colors is not None and len(out.colors) != nv:
diff --git a/assets/face/README.md b/assets/face/README.md
index 57b9c5c9..a161e173 100644
--- a/assets/face/README.md
+++ b/assets/face/README.md
@@ -10,7 +10,7 @@ src/core/Face.h) fits to a sculpt. It is embedded into the program at build time
What changed from ICT's data: the 52 shapes carry Apple ARKit's names (ICT's `_L` / `_R` become `Left` / `Right`,
the character's own sides), ICT's separate `browInnerUp_L/_R` and `cheekPuff_L/_R` are summed into ARKit's single
`browInnerUp` and `cheekPuff`, `cheekRaiser_L/_R` and `PupilDilate_L/_R` (not ARKit shapes) are left out, and
-`tongueOut`, which ICT doesn't have, is a quarter of `jawOpen` (a tongue SubTool gets the tongue's motion).
+`tongueOut`, which ICT doesn't have, is a quarter of `jawOpen` (a tongue Part gets the tongue's motion).
Offsets under 0.02 mm are dropped and the rest quantised to 16 bits; the teeth are kept only as the lower jaw's
rigid motion per shape. ICT's 100 identity (PCA) shapes are not used. The separately licensed full ICT Face Model
is not used either.
diff --git a/assets/phone/capture.html b/assets/phone/capture.html
index 364795fc..fa9bb09e 100644
--- a/assets/phone/capture.html
+++ b/assets/phone/capture.html
@@ -202,7 +202,7 @@ footer { text-align:center; color:#6f6f78; font-size:12px; padding:22px 18px 30p
<p class="muted">Point your phone at a desk or the floor; the sculpt stands on it at real size.</p>
<div class="panel">
<div class="small muted">Show</div>
- <div class="seg" id="arScope"><button data-v="subtool" class="on">Active SubTool</button><button data-v="scene">Whole scene</button></div>
+ <div class="seg" id="arScope"><button data-v="part" class="on">Active Part</button><button data-v="scene">Whole scene</button></div>
<div class="small muted">Size on the desk</div>
<div class="seg" id="arSize"><button data-v="10">10 cm</button><button data-v="20" class="on">20 cm</button><button data-v="40">40 cm</button><button data-v="100">1 m</button></div>
<button class="primary" id="arPrepare">Get the model</button>
@@ -471,7 +471,7 @@ $("plyFile").onchange = (e) => {
};
// --- AR ---
-let arScope = "subtool", arSize = 20, arWanted = 0, arShown = 0;
+let arScope = "part", arSize = 20, arWanted = 0, arShown = 0;
function segment(id, set) {
for (const b of $(id).querySelectorAll("button")) b.onclick = () => {
for (const o of $(id).querySelectorAll("button")) o.classList.toggle("on", o === b);
diff --git a/changes/fix-ip-audit.md b/changes/fix-ip-audit.md
new file mode 100644
index 00000000..f8675463
--- /dev/null
+++ b/changes/fix-ip-audit.md
@@ -0,0 +1,22 @@
+---
+whats_new: **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.
+highlight: Classic sculpting keys and the Bridge: SculptForge's own names throughout
+changed: SculptForge now uses only its own names in the app, guide, website and listings: **Classic sculpting
+ keys** and the **Classic layout** (Preferences, first-start welcome), **File > Bridge** (Send, Receive,
+ Import / Export Bridge file), Lit Spheres, Parts, Face groups, Vertex Paint, Library. Brushes are stored as
+ SharpCrease, ClayBlock and Tendril (old names in projects, brush files, scripts and configs still load); the
+ library's lit-sphere folder is now `Documents/SculptForge/Lit Spheres` (an existing folder moves over once).
+ The export plug-in is `SculptForgeBridgeExport.txt`, with its setup on the Bridge setup page. A new check
+ (`tools/check_marks.py`, ctest `marks`) keeps third-party product names out of what we publish.
+testers:
+ - Any OS: open a project from 0.10.10 that uses Sharp Crease / Clay Block and has custom hotkeys or shelf
+ buttons for them; the brushes, hotkeys and shelf buttons still work.
+ - Any OS with custom lit spheres in Documents/SculptForge: start once; the images are in the Lit Spheres folder
+ and still in the Material list.
+ - Windows or macOS: File > Bridge > Send and Receive round trip as before.
+ - First start (fresh config): the welcome offers Classic sculpting keys; Preferences > Input shows the same name.
+---
+fix/ip-audit phase 1 (user-visible). Phase 2 (code identifiers, comments, command and on-disk key names with read
+aliases) follows on its own branch; see REPORT.md.
diff --git a/docs/architecture-attributes.md b/docs/architecture-attributes.md
index 5fda95ab..e5e99556 100644
--- a/docs/architecture-attributes.md
+++ b/docs/architecture-attributes.md
@@ -28,7 +28,7 @@ triangle count before `rebuildTopology()` if triangles follow). Read with `quadP
requires both halves to share a face group: what Wire shows as a quad and what exporters write as one.
- Display: `Renderer::uploadFaces` builds GL_LINES edges without the diagonals for meshes with quads.
- Export: `exportFace(t, face)` gives 4 corners (in winding order; an `(a,b,c)+(a,c,d)` split gives `(a,b,c,d)`),
- 3, or 0 for the second half of a quad. OBJ, FBX, PLY, USD and GoZ use it; glTF and STL stay triangles.
+ 3, or 0 for the second half of a quad. OBJ, FBX, PLY, USD and Bridge files use it; glTF and STL stay triangles.
- Building a mesh from some triangles of another: `remapQuads(src, newIndex, dst)`; appending:
`appendQuads(dst, firstTriangle, src)`.
diff --git a/docs/blender.md b/docs/blender.md
index 4680ff2a..4464bfb1 100644
--- a/docs/blender.md
+++ b/docs/blender.md
@@ -1,24 +1,24 @@
# The Blender bridge
SculptForge and the **SculptForge Bridge** add-on for Blender (`addons/blender/sculptforge_bridge`) exchange
-meshes the way GoZ apps do with ZBrush: through files in a shared folder, with each side polling the other's
+meshes the way the Bridge does: through files in a shared folder, with each side polling the other's
list. User documentation: [docs/guide/blender.md](guide/blender.md).
Code: `src/io/BlenderBridge.h/.cpp` (folder, manifest, send/receive), `src/io/BlenderCommands.cpp`
(`blender_send`, `blender_receive`), `src/app/PanelBlender.cpp` (File > Blender, polling, heartbeat),
-`addons/blender/sculptforge_bridge/exchange.py` (the add-on's bpy-free side: folder, manifest, .GoZ, faces) and
+`addons/blender/sculptforge_bridge/exchange.py` (the add-on's bpy-free side: folder, manifest, Bridge file, faces) and
`__init__.py` (Blender UI, mesh <-> arrays). Tests: `tests/test_blender_bridge.cpp`,
`tests/blender/test_exchange.py` (numpy, against `sculptforge-cli`), `tests/blender/test_in_blender.py` (a real
Blender or the `bpy` wheel; CI), `tests/ui/blender_bridge.sfui`.
-The add-on borrows ideas and the .GoZ conventions from [GoB](https://github.com/JoseConseco/GoB) (GPL), the
-Blender GoZ add-on by Daniel Grauer, JoseConseco and contributors; no GoB code is copied.
+The add-on borrows ideas and the Bridge file conventions from [GoB](https://github.com/JoseConseco/GoB) (GPL), the
+Blender exchange add-on by Daniel Grauer, JoseConseco and contributors; no GoB code is copied.
-## Why files and .GoZ
+## Why files and Bridge files
- **No sockets**: nothing to configure, nothing listening, works in sandboxes that allow files, and a crash on one
side leaves the other unaffected. Polling is a `stat` of one file a second.
-- **.GoZ** (docs/goz.md) already carries everything both sides keep per mesh: positions, triangles and quads,
+- **Bridge files** (integrations/bridge-plugin/PROTOCOL.md) already carry everything both sides keep per mesh: positions, triangles and quads,
per-corner UVs, per-vertex vertex paint and mask, per-face face groups. SculptForge reads and writes it, and it is
simple to write from Python with numpy. A second mesh format was not needed.
@@ -36,7 +36,7 @@ override it in its preferences).
| `app.json` | SculptForge, at start | `{"path": executable, "version": ...}`: the AppImage (`$APPIMAGE`), the `.app` bundle, or the binary |
| `alive.json` | SculptForge, every 2 s once `to_sculptforge/` exists | `{"pid": ..., "time": unix seconds}`; removed on exit |
-Writers write the .GoZ files first, then the manifest through a temporary file and a rename, so a reader never
+Writers write the Bridge files first, then the manifest through a temporary file and a rename, so a reader never
sees a half-written list. File names carry the revision, so a send never overwrites a file the other side may
still be reading; after writing the manifest the writer deletes its earlier files (ignoring files still open on
Windows).
@@ -61,16 +61,16 @@ Windows).
- `revision` is the previous manifest's plus one. A reader loads a manifest whose revision differs from the one
it loaded last (not "greater": a deleted folder restarts at 1). It reads the revision once a
second rather than trusting file times (Windows copies keep them; FAT and network drives store them coarsely).
-- `name` is the exact Blender object name (UTF-8); the .GoZ's own name is GoB's ASCII escape of it. In SculptForge
- it is the Part's `gozName` (shared with GoZ; saved in projects), so the next send updates the same object.
+- `name` is the exact Blender object name (UTF-8); the Bridge file's own name is GoB's ASCII escape of it. In SculptForge
+ it is the Part's `gozName` (shared with the Bridge; saved in projects), so the next send updates the same object.
- `file` must be a plain file name in the same folder (`..`, `/`, `\` and `:` are refused).
-- `matrix_world` (Blender -> SculptForge only): the object's matrix, rows as Blender prints them, Z-up. The .GoZ
+- `matrix_world` (Blender -> SculptForge only): the object's matrix, rows as Blender prints them, Z-up. The Bridge file
holds the mesh in object space. SculptForge places it with `A * M * A^-1` where `A` maps Blender
`(x, y, z)` to SculptForge `(x, z, -y)` (metres both). SculptForge -> Blender sends world space without a
matrix; the add-on applies the inverse of the object's current `matrix_world`.
-- `shapes` (SculptForge -> Blender only, optional): a file beside the .GoZ with the object's sculpt layers, which
+- `shapes` (SculptForge -> Blender only, optional): a file beside the Bridge file with the object's sculpt layers, which
the add-on turns into shape keys (a Basis, then one key per layer with its name and weight; the 52 ARKit facial
- shapes keep their names). The .GoZ then holds the base shape (every layer at zero). Layout (little endian):
+ shapes keep their names). The Bridge file then holds the base shape (every layer at zero). Layout (little endian):
`"SFSHAPES"`, u32 version 1, u32 vertex count, u32 shape count, then per shape u32 name length, the UTF-8 name,
f32 weight, u32 count N, u32[N] vertex indices, f32[3N] offsets in Blender's axes (world space, metres).
Older add-ons ignore the field (and then get the base shape without the keys).
@@ -78,7 +78,7 @@ Windows).
## Faces, winding and in-place updates
-The add-on writes each Blender polygon as one GoZ face: triangles and quads as they are, n-gons as the fan
+The add-on writes each Blender polygon as one Bridge file face: triangles and quads as they are, n-gons as the fan
`(0, i, i+1)`. For an object whose matrix has a negative determinant (mirrored), every polygon is written reversed,
so the faces point out once SculptForge applies the matrix; nothing on the SculptForge side knows about it.
@@ -94,7 +94,7 @@ quads, reversed back for a mirrored object.
## Attributes
-| Blender | GoZ / SculptForge |
+| Blender | Bridge file / SculptForge |
|---|---|
| active UV map (per loop) | UVs per face corner (V flipped in the file, as GoB does) |
| active colour attribute, point or corner domain (`color_srgb`) | vertex paint (sRGB bytes; corner colours are averaged per vertex) |
@@ -121,9 +121,9 @@ folder for **Add-ons > Install from Disk**), with fixed timestamps. CMake: `--ta
`blender_addon_package` runs the checks. The release workflow attaches both, plus `sculptforge_bridge.zip`
(version-less, for the website's link).
-## ZBrush-style keys in Sculpt Mode
+## Classic sculpting keys in Sculpt Mode
-`addons/blender/sculptforge_bridge/zbrush_keys.py`: the add-on preference `zbrush_keys` adds items to the add-on
+`addons/blender/sculptforge_bridge/classic_keys.py`: the add-on preference `classic_keys` adds items to the add-on
keyconfig's "Sculpt" keymap (`key_table()`) and removes exactly those again (`disable()`, also on unregister).
Add-on keymap items take priority over Blender's own while they exist. Things that differ between versions,
found by running real Blender 4.2.23 and 5.2.3 headless:
diff --git a/docs/design/studio-pipeline.md b/docs/design/studio-pipeline.md
index ac7201eb..fc0898ea 100644
--- a/docs/design/studio-pipeline.md
+++ b/docs/design/studio-pipeline.md
@@ -95,12 +95,12 @@ they want to sculpt fixes *on* a pose and send back a clean delta in the bind sp
|---|---|---|
| USD export | `.usda`/`.usdz` written without the SDK: one `Mesh` per Part under a root Xform, UVs as face-varying `primvars:st`, `displayColor`, UsdPreviewSurface (clay/painted/textured), sculpt layers as UsdSkel blend shapes on a joint-less Skeleton with a `SkelAnimation` (time-sampled face takes), Gaussian splats as `ParticleField3DGaussianSplat`. Checked with `usdchecker` 26.08. | `src/io/UsdIO.*` |
| USD import | `.usda` and text-root `.usdz`: meshes, xform ops, Z-up, UVs, blend shapes, splats. **No `.usdc`, no references or payloads, no variants.** | `src/io/UsdIO.*` |
-| Other formats | FBX read (ufbx, any version) and write (7.4 binary, blend shapes, LOD groups); glTF/GLB (morph targets, `KHR_gaussian_splatting`, Khronos-validated); OBJ, PLY, STL (mm, Z-up), .GoZ | `src/io/` |
+| Other formats | FBX read (ufbx, any version) and write (7.4 binary, blend shapes, LOD groups); glTF/GLB (morph targets, `KHR_gaussian_splatting`, Khronos-validated); OBJ, PLY, STL (mm, Z-up), .Bridge files | `src/io/` |
| VFX-RP builds | CY2026 (Rocky 8, glibc 2.28) and CY2027 (Rocky 9, glibc 2.34) tarballs, x86_64 and ARM64; CI checks glibc symbols; dependencies static (SDL3, ImGui, GLM, ufbx) | CI, `docs/studios.md` |
| rez | `packaging/rez/package.py`: `PATH`, `PYTHONPATH`, `SCULPTFORGE_ROOT`, studio brush share | `packaging/rez/` |
| Python | `import sculptforge`: `Document`, `run`, `run_script`, `commands()`, NumPy vertices and triangles, layers and deltas; releases the GIL | `src/python/module.cpp` |
| CLI | `sculptforge-cli` runs every editor command headless; `sculptforge --render --turntable` renders offscreen; `--mcp` (stdio only) | `src/cli/` |
-| Bridges | Blender (folder + manifest, .GoZ; no sockets), Maya 2022+ (folder + manifest, OBJ; no sockets), Unreal 5 (Python remote execution, static or skeletal mesh with morph targets), ZBrush (GoZ-compatible, plug-in runs inside ZBrush) | `src/io/*Bridge*`, `src/link/UnrealLink.*` |
+| Bridges | Blender (folder + manifest, Bridge files; no sockets), Maya 2022+ (folder + manifest, OBJ; no sockets), Unreal 5 (Python remote execution, static or skeletal mesh with morph targets), Bridge | `src/io/*Bridge*`, `src/link/UnrealLink.*` |
| Determinism | Seeded remesh, QRemesh, stroke jitter and scatter; deterministic deformers | `src/core/` |
| Posing | Masked transforms with soft falloff at a joint ("mask the body, rotate the arm"). **No skeleton.** | `src/core/MeshTransform.h` |
| Network | No telemetry, no account. **Automatic:** the daily update check, and the brush gallery index when its panel opens. **Remote by default when used:** the AI Brush assistant (Pollinations) and Generate 3D (Hugging Face). Listeners: Phone link (LAN, only while open), and a temporary Unreal call-back. Full audit in §7. | `src/ai/Http.cpp`, `src/link/Socket.cpp` |
@@ -435,7 +435,7 @@ Effort: about 0.75 w once AI tools ships (policy and choke points 0.4, UI/report
These go out with the next release's lockstep, alongside the guide and site.
**Files and code.**
-- File parsers (OBJ, FBX, glTF, PLY, USD/USDZ, images, .GoZ, brushes, packs) are tested against hostile and
+- File parsers (OBJ, FBX, glTF, PLY, USD/USDZ, images, .Bridge files, brushes, packs) are tested against hostile and
malformed files, including fuzzer-found cases (`tests/test_malformed_files.cpp`). *(P1)* Continuous fuzzing in CI. Bridges exchange files through one folder, checked strictly (no paths outside it, no
links, size limits), and nothing in the folder is ever executed.
- No plug-ins from the network. Packs are reviewed and installed by the user, never by an AI agent. Studio
@@ -544,7 +544,7 @@ feature does. The structure is two pillars, then the integration grid, which alr
</article>
</div>
- <!-- existing integration grid: Blender, Maya, ZBrush Bridge (GoZ-compatible), Unreal, formats,
+ <!-- existing integration grid: Blender, Maya, Bridge, Unreal, formats,
Linux/Windows/macOS, Linux pipelines; add ⏳ Houdini Solaris, Flow Production Tracking / ftrack /
Kitsu publish hooks, Alembic, MaterialX when they ship -->
@@ -554,7 +554,7 @@ feature does. The structure is two pillars, then the integration grid, which alr
</section>
```
-Keep the existing no-affiliation footer on the page (it names ZBrush for compatibility).
+Keep the existing no-affiliation footer on the page.
---
diff --git a/docs/guide/baking.md b/docs/guide/baking.md
index 9278755e..9a988a70 100644
--- a/docs/guide/baking.md
+++ b/docs/guide/baking.md
@@ -91,7 +91,7 @@ float OpenEXR holds the real distances in world units, with no scale to set.
| **Size** | 1K, 2K (default), 4K or 8K square |
| **AA** | Anti-aliasing: 1 to 4 means 1, 4, 9 or 16 rays per texel, averaged. 2 (the default) gives clean edges |
| **Auto distance** | Measure how far the high-poly lies in front of and behind the low-poly, and cast rays just that far. After a bake, **Front** and **Rear** show what it measured |
-| **Front** / **Rear** | With Auto off: how far in front of the low-poly rays start, and how far behind it they look, as a percentage of the model's size (its bounding-box diagonal). ZBrush and Substance call these the max frontal and rear distances |
+| **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) |
@@ -123,7 +123,7 @@ When the last bake made a normal map, its low-poly Part is shown and still fits
(**Tool > Export**) imports the map too, as `T_<Name>_N` next to the mesh, set up as a normal map (linear, normal
map compression), with Unreal's **Flip Green Channel** set for an OpenGL map. This works with an Unreal Editor
on the same computer; for one on another computer, import the PNG by hand. See
-[Exporting, Unreal and ZBrush](exporting.md#send-to-unreal).
+[Exporting, Unreal and Bridge](exporting.md#send-to-unreal).
## Commands
@@ -134,7 +134,7 @@ on the same computer; for one on another computer, import the PNG by hand. See
For example, from the console or `sculptforge-cli`:
```
-subtool_select name=Body_low; bake source=Body maps=normal,ao,displacement size=4096 out=maps
+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
diff --git a/docs/guide/blender.md b/docs/guide/blender.md
index cc715f98..279bcc76 100644
--- a/docs/guide/blender.md
+++ b/docs/guide/blender.md
@@ -3,7 +3,7 @@
Keep Blender for the scene, rigging, shading and animation, and sculpt in SculptForge: the **SculptForge Bridge**
add-on sends the selected objects from Blender to SculptForge with one click, and one click in SculptForge sends
them back. The objects update in place in Blender: their transform, materials and modifiers stay as they were.
-It works like ZBrush's GoZ between ZBrush and other apps, on Linux, Windows and macOS, with Blender 4.2 or newer.
+It works through files in a shared folder, on Linux, Windows and macOS, with Blender 4.2 or newer.
## Install the add-on
@@ -84,18 +84,18 @@ In SculptForge's **File > Blender**:
The add-on's preferences add the path of SculptForge and the exchange folder (below).
-## ZBrush-style keys in Sculpt Mode
+## Classic sculpting keys in Sculpt Mode
-Sculpting in Blender too? Turn on **ZBrush-style keys in Sculpt Mode** in the add-on's preferences (**Edit >
-Preferences > Add-ons > SculptForge Bridge**) and Blender's Sculpt Mode answers to ZBrush's keys where Blender
+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.
-| ZBrush key | In Blender's Sculpt Mode |
+| Classic key | In Blender's Sculpt Mode |
|---|---|
| <kbd>S</kbd> / <kbd>U</kbd> / <kbd>O</kbd> | Draw Size / Intensity (Strength) / Falloff (Hardness), dragged at the cursor |
| <kbd>Space</kbd> | Blender's Sculpt quick menu at the cursor (brush, size, strength) |
-| <kbd>B</kbd> | The brush list by ZBrush brush name (Standard, DamStandard, Clay, ClayBuildup, Move, SnakeHook...): type a few letters, <kbd>Enter</kbd> picks |
+| <kbd>B</kbd> | The brush list by name (Standard, Sharp Crease, Clay, Clay Block, Move, Tendril...): type a few letters, <kbd>Enter</kbd> picks |
| <kbd>Alt</kbd>+drag | Sub: the brush digs in |
| <kbd>Ctrl</kbd>+drag / <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+drag | Mask / unmask, drawn as a lasso |
| <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+drag / <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Alt</kbd>+drag | Show only what's inside / hide what's inside |
@@ -108,11 +108,11 @@ add-on. The preferences list every key while it's on.
| <kbd>W</kbd> / <kbd>E</kbd> / <kbd>R</kbd> | Move / Scale / Rotate |
| <kbd>Shift</kbd>+drag | Smooth (Blender already does this) |
-ZBrush's brushes map to Blender's closest: Standard = Draw, DamStandard = Draw Sharp, ClayBuildup = Clay
-Strips, Move = Grab, Move Elastic = Elastic Grab, TrimDynamic = Trim (Scrape in Blender 4.2), Crease = Crease
+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 the ZBrush way:
+What Blender has no key for, or can't do:
- <kbd>I</kbd> (RGB Intensity): Blender's sculpt brushes don't paint.
- <kbd>Ctrl</kbd>+drag on the model doesn't paint the mask with a round brush: Blender can't switch to the Mask
@@ -147,7 +147,7 @@ SculptForge's VDM brushes and Blender's use the same maps (see
The two programs share a folder in your user data: `~/.local/share/SculptForge/SculptForge/blender` on Linux,
`%APPDATA%\SculptForge\SculptForge\blender` on Windows, `~/Library/Application Support/SculptForge/SculptForge/blender`
-on macOS. Each side writes its meshes there as `.GoZ` files (the format SculptForge also uses with ZBrush) with a
+on macOS. Each side writes its meshes there as `.GoZ` 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
@@ -163,7 +163,7 @@ SculptForge with `--blender` loads what Blender last sent.
`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 ZBrush's GoZ).
+- **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](facial-shapes.md) keep their ARKit names. Shape keys don't come back from Blender, and textures
stay in SculptForge.
@@ -174,6 +174,6 @@ SculptForge with `--blender` loads what Blender last sent.
## See also
-- [Exporting, Unreal and ZBrush](exporting.md): files, game engines and Send to ZBrush
+- [Exporting, Unreal and Bridge](exporting.md): files, game engines and Bridge
- [Parts](parts.md): each Blender object is a Part
- [Face Groups and visibility](face-groups.md): Blender's face sets
diff --git a/docs/guide/coming-from-zbrush.md b/docs/guide/coming-from-zbrush.md
deleted file mode 100644
index 89ba9c4c..00000000
--- a/docs/guide/coming-from-zbrush.md
+++ /dev/null
@@ -1,197 +0,0 @@
-# Coming from ZBrush
-
-This chapter is for sculptors whose hands already know ZBrush. It lists what SculptForge calls the things you
-know, what works the same, what is different, and the shortcuts side by side, so you can start sculpting instead
-of relearning. SculptForge has its own keymap and offers ZBrush-style, Blender and Maya styles; turn on the
-**ZBrush-style** keys first (see [ZBrush-style keys](#zbrush-style-keys)) and your hands will feel at home.
-
-New installs start in SculptForge's own layout, with menus by task. For the alphabetical palette bar and the
-two-row top shelf you know, pick **Coming from: ZBrush** (keys and layout) or the **ZBrush-style layout** card in the welcome, or pick
-**Edit > Preferences > Interface > Look > Layout > ZBrush-style** (see [Looks and layouts](interface.md#looks-and-layouts)).
-Paths in this guide name the SculptForge layout's menus. In the ZBrush-style layout, leave out the menu:
-**Edit > Preferences > Input** is the palette named **Preferences**, **Sculpt > Stroke** the palette named
-**Stroke**; **Tool > Parts** is the same in both. See [Menus and palettes](interface.md#menus-and-palettes) for
-every palette's menu, and <kbd>F3</kbd> finds any of them by name.
-
-## ZBrush terms in SculptForge
-
-Features use SculptForge's own names. The ideas are the ones you know; here is what to look for:
-
-| ZBrush | SculptForge | Where |
-|---|---|---|
-| SubTools | **Parts** | **Tool > Parts**; <kbd>Alt</kbd>+click one in the viewport. See [Parts](parts.md) |
-| ZSpheres | **Forge Spheres** | **Tool > Forge Spheres**. See [Forge Spheres](forge-spheres.md) |
-| Polypaint | **Vertex Paint** | The Paint brush (<kbd>P</kbd>), **Rgb**, the **Paint** menu. See [Vertex Paint and materials](vertex-paint.md) |
-| Polygroups | **Face Groups** | **Tool > Face Groups**. See [Face Groups and visibility](face-groups.md) |
-| LightBox | **Library** | <kbd>,</kbd> (comma). See [The interface](interface.md#the-library) |
-| GoZ | **Send to ZBrush** (GoZ-compatible) | **File > Send to ZBrush**. See [Exporting](exporting.md#exchange-models-with-zbrush-send-to-zbrush) |
-| MatCap | **Lit Sphere** | **Render > Materials**, <kbd>M</kbd>. See [Materials](vertex-paint.md#materials-lit-spheres) |
-| Zadd / Zsub | **Add** / **Sub** | Top shelf; <kbd>Alt</kbd> flips for one stroke |
-| Z Intensity | **Intensity** | Top shelf, <kbd>U</kbd> |
-| Focal Shift | **Falloff** | **Sculpt > Draw & Tablet**, <kbd>O</kbd> |
-| DynaMesh | **Voxel Remesh** | **Tool > Remesh**. See [Geometry](geometry.md#voxel-remesh) |
-| ZRemesher, ZRemesher Guides | **Quad Remesh**, **Quad Remesh Guides** | **Tool > Geometry > Quad Remesh**. See [Quad retopology](retopology.md) |
-| ProjectAll, ZProject | **Project All**, **Project** | **Tool > Parts > Project**. See [Quad retopology](retopology.md#project-all) |
-| Sculptris Pro | **Dynamic Topology** | **Dynamic** on the top shelf. See [Dynamic topology](dynamic-topology.md) |
-| QuickSave | **Snapshot** | **File > Save Snapshot**, the Library's **Snapshots** tab. See [Projects](projects.md#snapshots) |
-| Transpose, Gizmo 3D, Transpose All | **Gizmo**, **All Parts** | <kbd>W</kbd> <kbd>E</kbd> <kbd>R</kbd>. See [Gizmo](gizmo.md) |
-| LazyMouse | **Steady Stroke** (every stroke type) | **Sculpt > Stroke**, <kbd>L</kbd> |
-| PolyFrame (PolyF) | **Wireframe** (**Wire** on the shelf) | Right shelf, <kbd>Shift</kbd>+<kbd>F</kbd> |
-| QuickMenu | **Quick Menu** | <kbd>Space</kbd> or a right click |
-| DamStandard | **Sharp Crease** brush | <kbd>B</kbd> <kbd>D</kbd> <kbd>S</kbd>. See [Sculpting](sculpting.md) |
-| ClayBuildup | **Clay Block** brush | <kbd>B</kbd> <kbd>C</kbd> <kbd>B</kbd> |
-| SnakeHook | **Tendril** brush | <kbd>B</kbd> <kbd>S</kbd> <kbd>H</kbd> |
-| KelvinSnake | **Elastic Tendril** brush | Brush picker (KelvinGrab, KelvinTwist and KelvinScale keep their names) |
-| Trim Dynamic | **Trim** brush | Brush picker |
-| hPolish | **Hard Polish** | Not built in yet; a [Brush Lab](brush-lab.md) recipe gets close |
-| DragRect, DragDot | **Drag Stamp**, **Slide Stamp** strokes | **Sculpt > Stroke** |
-| MaskPen, MaskLasso, MaskRect | **Mask Pen**, **Mask Lasso**, **Mask Rectangle** | **Tool > Masking**. See [Masking](masking.md) |
-| SelectRect, SelectLasso | **Select Rectangle**, **Select Lasso** | **Tool > Visibility** |
-| FiberMesh, LightCap | Not yet | |
-| ZScript, ZPlugin | Script commands and the Python module | See [Scripting](scripting.md) |
-| Decimation Master, UV Master, Projection Master | **Decimate**, the **UV Editor** (and **Auto UV**), **Mesh > Generate 3D > Stamp** | See [Geometry](geometry.md#decimate), [UV Editor](uv-editor.md) and [Texture painting](texture-painting.md) |
-
-The command palette (<kbd>F3</kbd>) finds every feature by its ZBrush name too: type `SubTool`, `ZSphere`,
-`Polypaint` or `MatCap` and it shows the SculptForge command, as in "Forge Spheres (ZBrush users: ZSpheres)". The
-[Glossary](glossary.md) maps many more ZBrush terms.
-
-ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer GmbH. SculptForge is not
-affiliated with or endorsed by Maxon.
-
-## ZBrush-style keys
-
-New installs start with the **SculptForge** keys. The first time SculptForge starts it asks what you are
-**Coming from**: pick **ZBrush** and it turns on the ZBrush-style keys for you. To switch at any time, open
-**Edit > Preferences > Input** and choose **ZBrush-style** under **Style**, then press **Store Config**
-(<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd>) to keep it. If you used an earlier version, your saved choice is
-kept.
-
-What the ZBrush-style keys change:
-
-| | **ZBrush-style** | **SculptForge** (default) |
-|---|---|---|
-| <kbd>1</kbd> to <kbd>9</kbd>, <kbd>0</kbd> | Free (<kbd>9</kbd> is **Save Snapshot**, ZBrush's QuickSave) | Pick the ten first brushes (Standard, Clay, Smooth, Move ...) |
-| <kbd>I</kbd> | RGB Intensity at the cursor | Intensity at the cursor (as <kbd>U</kbd>) |
-| <kbd>Ctrl</kbd>+drag on the background with nothing masked | Draws a mask rectangle | Zooms |
-| Zoom drags (<kbd>Ctrl</kbd>+right-drag, <kbd>Alt</kbd> then release) | Up zooms out | Up zooms in |
-
-Everything else in this chapter works in both styles. **Edit > Preferences > Input > Rotation** chooses free rotation
-(as in ZBrush) or a turntable that keeps the model upright, as in Blender or Maya. Press **Store Config** to keep
-either. See [Keyboard and mouse](shortcuts.md#zbrush-style-keys) for the full list.
-
-## What's the same
-
-- **The layout** (in the ZBrush-style layout). Shelves around the canvas, palettes in alphabetical order in the palette bar and the trays,
- sub-palettes that fold, the Library on <kbd>,</kbd>, Ctrl-hover help on every control, Ctrl+Alt+click to
- assign a hotkey, **Store Config** on <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd>. See
- [The interface](interface.md).
-- **Navigation.** Drag on the background to rotate freely (over the top, too), <kbd>Alt</kbd>+drag to move,
- <kbd>Alt</kbd>+click, let go of <kbd>Alt</kbd> and drag to scale, <kbd>Shift</kbd> during a rotation to snap to
- a side view, <kbd>Shift</kbd>+click, let go of <kbd>Shift</kbd> and drag to roll. Right-drag navigation works as
- with ZBrush's RightClick Navigation turned on, over the model too. <kbd>F</kbd> frames the model. See
- [Navigating the view](navigation.md).
-- **Sculpting modifiers.** <kbd>Alt</kbd> swaps Add and Sub (ZBrush's Zadd and Zsub), <kbd>Shift</kbd> smooths
- (Smooth keeps its own Intensity; let go of <kbd>Shift</kbd> mid-stroke for the alternate smooth that keeps the
- volume), <kbd>Shift</kbd> pressed after a stroke starts draws a straight line.
-- **Brush keys.** <kbd>B</kbd> then two letters, with ZBrush's letters: <kbd>B</kbd> <kbd>S</kbd> <kbd>T</kbd>
- Standard, <kbd>B</kbd> <kbd>C</kbd> <kbd>B</kbd> Clay Block, <kbd>B</kbd> <kbd>D</kbd> <kbd>S</kbd>
- Sharp Crease, <kbd>B</kbd> <kbd>M</kbd> <kbd>V</kbd> Move, <kbd>B</kbd> <kbd>I</kbd> <kbd>N</kbd> Inflate,
- <kbd>B</kbd> <kbd>S</kbd> <kbd>M</kbd> Smooth, <kbd>B</kbd> <kbd>S</kbd> <kbd>H</kbd> Tendril,
- <kbd>B</kbd> <kbd>P</kbd> <kbd>I</kbd> Pinch.
-- **Brush settings.** <kbd>S</kbd> Draw Size, <kbd>U</kbd> Intensity, <kbd>I</kbd> RGB Intensity (ZBrush-style
- keys), <kbd>O</kbd> Falloff, each as a slider under the cursor; <kbd>[</kbd> and <kbd>]</kbd> step the size;
- <kbd>Space</kbd> opens the Quick Menu; <kbd>L</kbd> toggles Steady Stroke. The cursor's outer ring is the Draw
- Size, the inner ring the Falloff. See [Sculpting and brushes](sculpting.md).
-- **Masking.** <kbd>Ctrl</kbd> paints a mask and <kbd>Ctrl</kbd>+<kbd>Alt</kbd> erases it; <kbd>Ctrl</kbd>+click
- the model blurs it and <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+click sharpens it; <kbd>Ctrl</kbd>+click the background
- inverts it and <kbd>Ctrl</kbd>+drag there draws a mask rectangle (ZBrush-style keys; one that misses the model
- clears the mask). Mask Lasso and Mask Rectangle follow the symmetry: with <kbd>Ctrl</kbd> held the shelf shows
- the mask brush, and the Brush (<kbd>B</kbd>) and Stroke pickers pick it. See [Masking](masking.md).
-- **Visibility and face groups.** <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+drag keeps the inside (press <kbd>Alt</kbd> to
- hide it instead), <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+click a group to isolate it (on a partly hidden mesh: to hide
- it), <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+click the background to show everything, <kbd>Ctrl</kbd>+<kbd>W</kbd> to
- group the masked part. Select Rectangle and Select Lasso, also from the Brush and Stroke pickers with
- <kbd>Ctrl</kbd>+<kbd>Shift</kbd> held. **Group by UVs** is UV Groups. See [Face Groups and visibility](face-groups.md).
-- **Parts** with <kbd>Alt</kbd>+click to select one and <kbd>Shift</kbd>+<kbd>Alt</kbd>+click to select and
- frame it; **subdivision levels** with <kbd>Ctrl</kbd>+<kbd>D</kbd>, <kbd>D</kbd> and <kbd>Shift</kbd>+<kbd>D</kbd>;
- **Wireframe** on <kbd>Shift</kbd>+<kbd>F</kbd>; **Save Snapshot** on <kbd>9</kbd> (ZBrush-style keys). See
- [Parts](parts.md) and [Subdivision levels](subdivision-levels.md).
-- **Send to ZBrush** (GoZ-compatible). Send models to and from ZBrush. See
- [Exporting, Unreal and ZBrush](exporting.md#exchange-models-with-zbrush-send-to-zbrush).
-- **VDM brushes** with Drag Stamp and Slide Stamp, and your own made from a VDM plane. See
- [Vector displacement brushes](sculpting.md#vector-displacement-brushes).
-- **Sculpting in Blender too?** The Blender add-on can give Blender's Sculpt Mode ZBrush's keys. See
- [Working with Blender](blender.md#zbrush-style-keys-in-sculpt-mode).
-
-## Bring your ZTools over
-
-ZBrush's `.ZTL` files are proprietary, so SculptForge can't read them directly. The free **SculptForge ZTL
-Export** plug-in runs inside ZBrush and converts them once:
-
-1. Download [SculptForgeZToolExport.txt](https://github.com/islandmed/SculptForge/blob/main/integrations/zbrush/SculptForgeZToolExport.txt) (also attached to every
- release) and copy it into ZBrush's `ZStartup/ZPlugs64` folder, then restart ZBrush. Or load it once with
- **ZScript > Load**.
-2. In ZBrush, **ZPlugin > SculptForge > Convert ZTL** asks for a `.ZTL`, loads it and writes each SubTool next to
- it as a GoZ-compatible file (`Dragon.ZTL` gives `Dragon.sf001_Body.GoZ`, `Dragon.sf002_Horns.GoZ`...).
- **Save for SculptForge** does the same for the ZTool you have open, saving the `.ZTL` where you choose.
-3. In SculptForge, open the `.ZTL` (**File > Open**, or drop it on the window). Its SubTools open as Parts in the
- same order with the same names, face groups, vertex paint, mask and UVs.
-
-Each SubTool comes over at its highest subdivision level; the lower levels, sculpt layers and ZBrush materials
-don't. If you change the ZTool in ZBrush later, convert it again: SculptForge warns when the `.ZTL` is newer than
-its conversion. `.ZPR` projects can't be converted; save their ZTools first.
-
-> **Note:** the plug-in is new and hasn't been tested in every ZBrush version yet. If it stops with an error or a
-> SubTool is missing, please [report it](https://github.com/islandmed/SculptForge/issues) with your ZBrush
-> version; exporting each SubTool from ZBrush as a `.GoZ` or `.OBJ` file works in the meantime.
-
-## What's different
-
-| ZBrush | SculptForge | Why |
-|---|---|---|
-| Transpose action line (<kbd>W</kbd> <kbd>E</kbd> <kbd>R</kbd>) | The Gizmo on the same keys; mask what should stay, and <kbd>Alt</kbd>+click to put the pivot on the model | Simpler to learn; ZBrush has a Gizmo 3D too. See [Gizmo](gizmo.md) |
-| Edit mode (<kbd>T</kbd>) and the 2.5D canvas | Always in Edit mode | SculptForge is a 3D sculpting app only |
-| Perspective toggle (<kbd>P</kbd>) | Always perspective; <kbd>P</kbd> is the Paint brush (colour only: Rgb on, Add off) | |
-| Stroke replay (<kbd>1</kbd>, <kbd>2</kbd>, <kbd>3</kbd>) | Not yet | |
-| <kbd>N</kbd> lists the SubTools | The Parts sub-palette in the right tray | |
-| DynaMesh, ZRemesher | **Voxel Remesh** and **Quad Remesh** in **Tool > Geometry** | See [Geometry](geometry.md) and [Retopology](retopology.md) |
-| Sculptris Pro | **Dynamic** on the top shelf, with its **Detail** slider | See [Dynamic topology](dynamic-topology.md) |
-| Open edges hold their shape when smoothed | Smooth pulls an open border in a little with each pass | Mask the border first when it matters |
-| Values 0-100 everywhere | The same for Intensity, RGB Intensity and Falloff; Draw Size is the radius in pixels | |
-
-## Shortcuts side by side
-
-The SculptForge column is with the ZBrush-style keys on.
-
-| Action | ZBrush | SculptForge |
-|---|---|---|
-| Rotate / move / scale the view | Drag / <kbd>Alt</kbd>+drag / <kbd>Alt</kbd>, release, drag on the background | Same |
-| Snap to a side view / roll | <kbd>Shift</kbd> while rotating / <kbd>Shift</kbd>+click, release, drag | Same |
-| Frame | <kbd>F</kbd> | <kbd>F</kbd> |
-| Brush pop-up | <kbd>B</kbd> | <kbd>B</kbd> |
-| Draw Size / Z Intensity / RGB Intensity / Focal Shift | <kbd>S</kbd> / <kbd>U</kbd> / <kbd>I</kbd> / <kbd>O</kbd> | Same keys: Draw Size / Intensity / RGB Intensity / Falloff |
-| QuickMenu | <kbd>Space</kbd> or right-click | Quick Menu: <kbd>Space</kbd> or right-click (a right drag navigates) |
-| LazyMouse | <kbd>L</kbd> | Steady Stroke: <kbd>L</kbd> |
-| Pick colour / switch colour | <kbd>C</kbd> / <kbd>V</kbd> | Same |
-| Symmetry | <kbd>X</kbd> | <kbd>X</kbd> |
-| Undo / redo | <kbd>Ctrl</kbd>+<kbd>Z</kbd> / <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Z</kbd> | Same (also <kbd>Ctrl</kbd>+<kbd>Y</kbd>) |
-| Divide / higher / lower res | <kbd>Ctrl</kbd>+<kbd>D</kbd> / <kbd>D</kbd> / <kbd>Shift</kbd>+<kbd>D</kbd> | Same |
-| Mask all / clear / invert / view | <kbd>Ctrl</kbd>+<kbd>A</kbd> / <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>A</kbd> / <kbd>Ctrl</kbd>+<kbd>I</kbd> / <kbd>Ctrl</kbd>+<kbd>H</kbd> | Same |
-| Group masked | <kbd>Ctrl</kbd>+<kbd>W</kbd> | <kbd>Ctrl</kbd>+<kbd>W</kbd> |
-| PolyFrame | <kbd>Shift</kbd>+<kbd>F</kbd> | Wireframe: <kbd>Shift</kbd>+<kbd>F</kbd> |
-| Draw / Move / Scale / Rotate | <kbd>Q</kbd> / <kbd>W</kbd> / <kbd>E</kbd> / <kbd>R</kbd> | Same keys, Gizmo |
-| LightBox | <kbd>,</kbd> | Library: <kbd>,</kbd> |
-| Hide the palettes | <kbd>Tab</kbd> | <kbd>Tab</kbd> |
-| QuickSave | <kbd>9</kbd> | Save Snapshot: <kbd>9</kbd> |
-| Store Config / Load UI / Save UI | <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd> / <kbd>Ctrl</kbd>+<kbd>L</kbd> / <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Alt</kbd>+<kbd>I</kbd> | Same |
-| Perspective | <kbd>P</kbd> | Always on (<kbd>P</kbd> is Paint) |
-| Search every command | | <kbd>F3</kbd> (ZBrush names work too) |
-
-Every shortcut is in [Keyboard and mouse](shortcuts.md), generated from the app itself, and can be changed with
-<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+click or **Edit > Preferences > Hotkeys**.
-
-## See also
-
-- [Keyboard and mouse](shortcuts.md)
-- [Glossary](glossary.md): more ZBrush terms and their SculptForge names
-- [Exporting, Unreal and ZBrush](exporting.md): Send to ZBrush
diff --git a/docs/guide/cut.md b/docs/guide/cut.md
index cd0fd458..8c170702 100644
--- a/docs/guide/cut.md
+++ b/docs/guide/cut.md
@@ -48,9 +48,6 @@ large model.
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.
-> **ZBrush:** this covers what the trim, clip and slice curve brushes and Live Boolean are used for, as one tool.
-> SculptForge is not affiliated with Maxon or ZBrush.
-
## Scripting
The `cut` command takes the shape (`line`, `lasso`, `rect`, `polyline`), its `points` in normalised screen
diff --git a/docs/guide/dynamic-topology.md b/docs/guide/dynamic-topology.md
index 23d2e945..075b5ebd 100644
--- a/docs/guide/dynamic-topology.md
+++ b/docs/guide/dynamic-topology.md
@@ -1,7 +1,7 @@
# Dynamic topology
With **Dynamic** on, the brush adds triangles where it needs detail and removes them where it doesn't, as
-ZBrush's **Sculptris Pro** and Blender's **Dyntopo** do. Pull a sphere out into horns, ears or fingers and the
+**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.
@@ -11,19 +11,19 @@ remeshing first.
| Control | Where | What it does |
|---|---|---|
-| **Dynamic** | Top shelf, **Sculpt > Draw & Tablet** | Turns dynamic topology on or off (ZBrush's Sculptris Pro button) |
+| **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, as in ZBrush.
+also simplifies.
> **Tip:** Turn on **Wire** (<kbd>Shift</kbd>+<kbd>F</kbd>) to see the triangles appear under the brush.
## How big the triangles get
-By default the triangle size follows the brush size on screen, as in Sculptris Pro: **zoom in or make the brush
+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.
@@ -39,7 +39,7 @@ and fine ones around the eyes.
## Smooth remesh
Smoothing (<kbd>Shift</kbd>) with Dynamic on also simplifies by default: it remeshes toward triangles twice the
-size, so the smoothed area gets coarser, as in Sculptris Pro. **Smooth remesh** under **Sculpt > Draw & Tablet > Dynamic topology**
+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.
@@ -67,7 +67,7 @@ It is a preference (Store Config keeps it) and is saved with the project; from a
## Subdivision levels
-Dynamic topology works on meshes without [subdivision levels](subdivision-levels.md), as in ZBrush. On a Part
+Dynamic topology works on meshes without [subdivision levels](subdivision-levels.md). On a Part
with levels, **Dynamic** stays off and the status bar says why: go to the level you want to keep and use **Del
Lower** and **Del Higher** in **Tool > Geometry** first. If you turn it on and then pick a Part that has
levels, strokes sculpt it without remeshing.
@@ -102,4 +102,4 @@ the same from the console, `sculptforge-cli`, MCP and Python. See [Scripting and
- [Sculpting and brushes](sculpting.md)
- [Subdivision levels](subdivision-levels.md)
- [Subdivide, remesh, decimate and LODs](geometry.md)
-- [Coming from ZBrush](coming-from-zbrush.md)
+- [Quick tour for experienced sculptors](quick-tour.md)
diff --git a/docs/guide/exporting.md b/docs/guide/exporting.md
index 0e5c2207..63bb1ff0 100644
--- a/docs/guide/exporting.md
+++ b/docs/guide/exporting.md
@@ -1,8 +1,8 @@
-# Exporting, Unreal and ZBrush
+# Exporting, Unreal and Bridge
This chapter covers getting your sculpt out of SculptForge: the export formats and what each one keeps, LOD
-chains for games, sending a mesh straight into a running Unreal Editor, and exchanging models with ZBrush
-with Send to ZBrush. To keep everything (Parts, layers, mask, vertex paint, brushes) use a project file instead; see
+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](projects.md).
## Export formats at a glance
@@ -16,9 +16,9 @@ or mark it saved, so your next <kbd>Ctrl</kbd>+<kbd>S</kbd> still saves the proj
| 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, ZBrush |
-| ZBrush GoZ-compatible (`.GoZ`) | **File > Send to ZBrush > Export GoZ-compatible file...** | Quads, face groups, mask, vertex paint, UVs, the painted texture as a PNG beside it | ZBrush |
-| STL (`.stl`) | **File > Send to ZBrush > Export STL...** | Geometry only (triangles), visible Parts merged, in millimetres with Z up | [3D printing](#3d-printing) |
+| 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](#exchange-models-through-the-bridge) |
+| STL (`.stl`) | **File > Bridge > Export STL...** | Geometry only (triangles), visible Parts merged, in millimetres with Z up | [3D printing](#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 |
@@ -31,7 +31,7 @@ only hold triangles.
![The Tool > Export sub-palette with a generated LOD chain and the Unreal Engine settings](images/export.jpg)
-UVs are kept through OBJ, FBX, USD, glTF and GoZ-compatible files, in and out. A Part with a painted
+UVs are kept through OBJ, FBX, USD, glTF and Bridge files, in and out. A Part with a painted
[texture](texture-painting.md) is exported with it: the PNG is written next to the file as
`<name>_color.png` (`<name>_<Part>_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
@@ -78,7 +78,7 @@ sculptforge-cli -c 'open path=bust.sfproj; export_stl path=bust.stl; export_ply
## 3D printing
-**File > Send to ZBrush > Export STL...** writes every visible Part as one binary STL, ready for a slicer
+**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.
@@ -184,45 +184,38 @@ sculptforge-cli -c 'open path=statue.obj; export_unreal folder=out height_cm=200
> 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.
-## Exchange models with ZBrush (Send to ZBrush)
+## Exchange models through the Bridge
-SculptForge reads and writes ZBrush's GoZ format and can talk to a running ZBrush through the **Send to ZBrush** on
-Windows and macOS. The commands are in **File > Send to ZBrush**:
+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 to ZBrush** | Writes every visible Part to the shared bridge folder and tells ZBrush (starting it if needed). Each Part arrives as its own ZBrush SubTool. Turns on **Receive automatically** |
-| **Receive from ZBrush** | Loads what ZBrush 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 from ZBrush and receives it |
+| **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 GoZ-compatible file...** | Opens a `.GoZ` file, replacing the scene |
-| **Export GoZ-compatible file...** | Writes a `.GoZ` file. With several visible Parts, one file per Part next to the path |
+| **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 |
-The default bridge folder is `C:\Users\Public\Pixologic` on Windows and `/Users/Shared/Pixologic` on macOS.
-ZBrush doesn't run on Linux, so there the bridge needs a custom folder; GoZ-compatible files still import and export.
+The default bridge folder and the one-time setup are on the
+[Bridge setup page](https://github.com/islandmed/SculptForge/blob/main/integrations/bridge-plugin/README.md). On
+Linux the Bridge needs a custom folder; Bridge files still import and export.
### A round trip
-1. In SculptForge, choose **File > Send to ZBrush > Send**. ZBrush starts or comes forward with the
- Parts. If ZBrush was not running and does not import them, press **GoZ** in ZBrush.
-2. Work in ZBrush, then press **GoZ** there to send the model back.
+1. 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.
+2. Work there, then send the model back with its exchange plug-in.
3. 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 from ZBrush stay quads: Wire shows them as quads, and
-they go back to ZBrush as the same quads. The format has no hidden-face flag, so hidden faces are sent like
-any others.
+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.
-> **ZBrush:** SculptForge can't read ZBrush's own `.ZTL` and `.ZPR` files (they are proprietary and
-> undocumented). Bring models over with Send to ZBrush, export OBJ or FBX from ZBrush, or convert your ZTools once with the
-> **SculptForge ZTL Export** plug-in for ZBrush, after which SculptForge opens the `.ZTL` itself (see
-> [Coming from ZBrush](coming-from-zbrush.md#bring-your-ztools-over)). Subdivision levels don't come across:
-> SculptForge receives the mesh at the level you sent.
-
-> **Note:** Send to ZBrush follows the format of the open-source Blender GoZ add-on (GoB) and is tested with
-> files, but has not yet been tested against a live ZBrush. If a send does not arrive, export a `.GoZ` file
-> and import it in ZBrush by hand, and please report it (**Help > Report a problem**).
+> **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: `goz_export path=`, `goz_import path=`, `goz_send`, `goz_receive` and `export_stl path=` (see
[3D printing](#3d-printing) for its options).
diff --git a/docs/guide/face-groups.md b/docs/guide/face-groups.md
index fbe101f0..c02532f0 100644
--- a/docs/guide/face-groups.md
+++ b/docs/guide/face-groups.md
@@ -1,11 +1,11 @@
# Face Groups and visibility
-Face Groups (ZBrush users: Polygroups) divide a Part's surface into named regions, shown as flat colours when you turn them on. You use
+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 <kbd>Ctrl</kbd>+<kbd>Shift</kbd>
visibility gestures and the **Tool > Face Groups** and **Tool > Visibility** controls.
-![Face Groups shown as colours, with the Face Groups sub-palette](images/polygroups.jpg)
+![Face Groups shown as colours, with the Face Groups sub-palette](images/face-groups.jpg)
## Show face groups
@@ -18,9 +18,9 @@ The number next to **Show face groups** is how many face groups are visible righ
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, as ZBrush writes them (SculptForge also writes face groups as
+- OBJ files: each `g` group becomes a face group (SculptForge also writes face groups as
`g` groups when it exports OBJ);
-- `.GoZ` files from ZBrush and SculptForge projects, which keep face groups.
+- Bridge files and SculptForge projects, which keep face groups.
## Create face groups
@@ -38,11 +38,6 @@ groups. So you can isolate one part and regroup just that part.
Each button is one undo step.
-> **ZBrush:** **By normals** is Auto Groups / Groups By Normals, **By pieces** is Auto Groups on a mesh with
-> separate parts, **From mask** is Group Masked, **Group by UVs** is UV Groups, and **Merge visible** is Group Visible.
-> <kbd>Ctrl</kbd>+<kbd>W</kbd> works as in ZBrush: the masked part becomes a new group and the mask is cleared
-> (with nothing masked, everything visible becomes one group).
-
### Group a region you painted
1. Paint a mask over the region with <kbd>Ctrl</kbd> (see [Masking](masking.md)).
@@ -60,7 +55,7 @@ macOS):
| Gesture | Effect |
|---|---|
| <kbd>Ctrl</kbd>+<kbd>Shift</kbd> + click a face group, everything shown | Isolate it: show only that group. |
-| <kbd>Ctrl</kbd>+<kbd>Shift</kbd> + click a face group, something hidden | Hide that group (as in ZBrush). |
+| <kbd>Ctrl</kbd>+<kbd>Shift</kbd> + click a face group, something hidden | Hide that group. |
| <kbd>Ctrl</kbd>+<kbd>Shift</kbd> + click the isolated group again | Invert the visibility: show everything else instead. |
| <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Alt</kbd> + click a face group | Hide that group. |
| <kbd>Ctrl</kbd>+<kbd>Shift</kbd> + click the background | Show everything. |
@@ -69,7 +64,7 @@ macOS):
| <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Alt</kbd> + 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, as in ZBrush, with <kbd>Ctrl</kbd>+<kbd>Shift</kbd> held: the
+**Tool > Visibility** (Select Rectangle by default), or, with <kbd>Ctrl</kbd>+<kbd>Shift</kbd> held: the
left shelf then shows the selection brush, and clicking the brush tile (or pressing <kbd>B</kbd>) 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
@@ -84,12 +79,9 @@ With symmetry on (**X**, **Y**, **Z** on the top shelf), the mirror image of the
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, as ZBrush does. Every visibility change is one undo
+SculptForge refuses a change that would hide everything. Every visibility change is one undo
step, so <kbd>Ctrl</kbd>+<kbd>Z</kbd> brings back what you just hid.
-> **ZBrush:** the gestures are the same as ZBrush's SelectRect and SelectLasso with polygroups. Grow and
-> Shrink visibility and hiding by clicking with the rectangle brush are not available yet.
-
### The Visibility sub-palette
Open **Tool > Visibility**:
@@ -130,7 +122,7 @@ Group the model, then click **Split groups** in **Tool > Parts**: each face grou
- **Masking**: **By face group** in **Tool > Masking** masks one group (see [Masking](masking.md)).
- **Brushes and vertex paint** skip hidden faces.
-- **Projects** save face groups and what's hidden; **Send to ZBrush** and **OBJ** carry face groups to and from ZBrush.
+- **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**.
@@ -149,10 +141,10 @@ When you isolate or hide a group in the viewport, the console (<kbd>`</kbd>) sho
id, for example `isolate_polygroup group=3`, which you can reuse in scripts.
```sh
-sculptforge-cli -c 'open path=robot.obj; polygroup_by_connectivity; subtool_split_groups; save_project path=robot.sfproj'
+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 PolyPaint, and
+> **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.
## See also
diff --git a/docs/guide/first-sculpt.md b/docs/guide/first-sculpt.md
index f0a439a7..b29bb927 100644
--- a/docs/guide/first-sculpt.md
+++ b/docs/guide/first-sculpt.md
@@ -9,7 +9,7 @@ steps.
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 **ZBrush-style layout**, the **ZBrush-style layout** notes say where things
+on the right. If you switched to the **Classic layout**, the **Classic layout** notes say where things
are there. Every step can be undone with <kbd>Ctrl</kbd>+<kbd>Z</kbd>, so experiment freely.
Each brush remembers its own size. To set it, hold the cursor over the canvas, press <kbd>S</kbd>, type the number
@@ -112,8 +112,6 @@ it smaller and bigger.
![The owl filled brown](images/first-sculpt/08-fill.jpg)
-> **ZBrush-style layout:** the colour controls are in the **Color** palette on the palette bar.
-
## 9. Paint the face
**Goal:** soft cream face discs.
@@ -169,8 +167,6 @@ it smaller and bigger.
![Render > Materials with PBR shading and Save Render](images/first-sculpt/12-material.jpg)
-> **ZBrush-style layout:** **PBR** and **Save Render** are in the **Material** palette.
-
Well done: that's a sculpt, painted and rendered.
## What's next
diff --git a/docs/guide/forge-spheres.md b/docs/guide/forge-spheres.md
index 8e76b0a8..813e0c1a 100644
--- a/docs/guide/forge-spheres.md
+++ b/docs/guide/forge-spheres.md
@@ -1,13 +1,9 @@
# Forge Spheres
-Forge Spheres (ZBrush users: ZSpheres) block out an organic base mesh from connected spheres: start from one root sphere, grow a torso, a head,
+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.
-> **ZBrush:** this works like ZBrush's ZSpheres with Adaptive Skin: Draw, Move and Scale on the spheres, Alt+click to delete,
-> **A** to preview the skin, and **Make Mesh** in place of Make Adaptive Skin. Rotate mode, ZSketch, the
-> Topology and Rigging uses of ZSpheres and the link-sphere (magnet) tricks are not there.
-
## Make a Forge Sphere Part
**Tool > Forge Spheres > New Forge Sphere** adds a Forge Sphere Part holding one root sphere at the centre and makes it active.
diff --git a/docs/guide/generate-3d.md b/docs/guide/generate-3d.md
index 2822f91d..686e92ed 100644
--- a/docs/guide/generate-3d.md
+++ b/docs/guide/generate-3d.md
@@ -17,9 +17,6 @@ tools: relief, inflate and stamp.
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](#privacy-and-model-licences) below.
-> **ZBrush:** ZBrush has no built-in image-to-3D. The closest workflow is blocking out a base mesh by hand
-> with DynaMesh or Forge Spheres; here you get a starting shape in seconds and refine it with the usual brushes.
-
## Open the Generate 3D window
Any of these opens it:
diff --git a/docs/guide/geometry.md b/docs/guide/geometry.md
index e49e5fbd..5c6beaa4 100644
--- a/docs/guide/geometry.md
+++ b/docs/guide/geometry.md
@@ -22,8 +22,8 @@ All of them work on the **active Part** and, except the LOD preview, are undoabl
## Quads and triangles
SculptForge sculpts on triangles, but it remembers which pairs of triangles were one quad. A model you open
-from ZBrush (Send to ZBrush), Blender or Maya (OBJ, FBX, PLY, USD) keeps its quads: **Wire** draws them as quads, without
-the diagonal, and OBJ, FBX, PLY, USD and GoZ-compatible exports write them back as quads, corner for corner. Polygons with
+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.
@@ -36,16 +36,13 @@ turns every quad into four quads. Two things turn quads into triangles:
glTF (`.glb`) and STL only hold triangles, so those exports always write triangles.
-> **ZBrush:** Besides keeping the quads you bring in, SculptForge can make new ones from any mesh: **Quad Remesh**
-> (like ZRemesher) builds quads with flowing edge loops. See [Quad retopology](retopology.md).
-
## Subdivide
For sculpting at several resolutions use **Divide** (<kbd>Ctrl</kbd>+<kbd>D</kbd>), which keeps the lower levels to
step back to: see [Subdivision levels](subdivision-levels.md). **Subdivide** is the one-way version.
**Tool > Geometry > Subdivide** smooths the mesh with Loop subdivision. Each level
-multiplies the triangle count by four and rounds off the shape slightly, like ZBrush's Divide with Smt on.
+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.
@@ -62,7 +59,7 @@ multiplies the triangle count by four and rounds off the shape slightly, like ZB
## Voxel remesh
-**Tool > Remesh > Voxel Remesh** rebuilds the active Part as an even, watertight surface, like ZBrush's DynaMesh.
+**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);
@@ -97,13 +94,9 @@ What happens to your data:
To remesh several Parts into one, first combine them with **Merge visible...** or **Merge down...** in
[Parts](parts.md#merge-parts).
-> **ZBrush:** There is no Project option, Groups-aware remesh or Blur slider yet. Like ZBrush's DynaMesh, the remesh
-> produces an even grid of quads, not flowing edge loops. For quads with edge loops that follow the forms, use
-> [Quad Remesh](retopology.md) (like ZRemesher), and Project All to get the detail back.
-
## Quad Remesh
-**Tool > Geometry > Quad Remesh** is automatic quad retopology, like ZBrush's ZRemesher: it rebuilds the Part as
+**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 All** (**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
@@ -120,8 +113,7 @@ back.
## Decimate
-**Tool > Geometry > Decimate** reduces the triangle count while keeping the shape, using quadric edge collapse (the
-same family of algorithm as ZBrush's Decimation Master). The **Keep** slider next to the button sets the fraction
+**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
diff --git a/docs/guide/gizmo.md b/docs/guide/gizmo.md
index cb144848..00a18794 100644
--- a/docs/guide/gizmo.md
+++ b/docs/guide/gizmo.md
@@ -2,7 +2,7 @@
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 like ZBrush's Gizmo 3D, with the same keys.
+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](images/gizmo-modes.jpg)
@@ -96,7 +96,7 @@ step (rotate by 15 degrees, again, again).
## All Parts
-Turn on **All Parts** in the panel to move every visible Part together (ZBrush's Transpose All), for
+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.
diff --git a/docs/guide/glossary.md b/docs/guide/glossary.md
index 2f833864..8b5dec2b 100644
--- a/docs/guide/glossary.md
+++ b/docs/guide/glossary.md
@@ -1,81 +1,8 @@
# Glossary
-This chapter maps ZBrush terms to their SculptForge equivalents, so you can find a familiar tool quickly, and
-explains the terms that only SculptForge uses. Features use SculptForge's own names (Parts, Forge Spheres,
-Vertex Paint, Library...); the short list is in
-[Coming from ZBrush](coming-from-zbrush.md#zbrush-terms-in-sculptforge), and the command palette (<kbd>F3</kbd>)
-finds every feature by its ZBrush name too. "Not yet" means SculptForge doesn't have it today; see the roadmap
-for what is planned.
-
-## ZBrush terms in SculptForge
-
-| ZBrush | SculptForge |
-|---|---|
-| Alpha | **Alpha**: built-in round, square and noise, or any grayscale image. Left shelf, **Sculpt > Alpha**. See [Sculpting](sculpting.md) |
-| Auto Groups | **Tool > Face Groups > By pieces** (`polygroup_by_connectivity`) |
-| BPR render | Not yet as a renderer. Headless renders and turntables with `sculptforge --render` ([Scripting](scripting.md)) |
-| Brush pop-up (B) | **Brush picker**, <kbd>B</kbd>, then type letters (B S T = Standard) |
-| Clip brushes | Not yet. The **Trim** brush shaves to a plane |
-| Curve brushes, IMM, ZModeler | Not yet |
-| Decimation Master | **Tool > Geometry > Decimate** (`decimate`). See [Geometry](geometry.md#decimate) |
-| Del Hidden | **Tool > Visibility > Delete hidden** (`delete_hidden`) |
-| Del Lower, Del Higher | **Tool > Geometry > Del Lower / Del Higher** (`subdiv_delete_lower`, `subdiv_delete_higher`). See [Subdivision levels](subdivision-levels.md) |
-| Divide (Ctrl+D), Smt | **Tool > Geometry > Divide**, <kbd>Ctrl</kbd>+<kbd>D</kbd>, with **Smt** beside it (`subdiv_divide`). See [Subdivision levels](subdivision-levels.md) |
-| Document, 2.5D canvas, pixols | Not planned: SculptForge is a 3D sculpting app only |
-| Draw Size | **Draw Size** (top shelf, <kbd>S</kbd>, <kbd>[</kbd> / <kbd>]</kbd>) |
-| DynaMesh | **Voxel Remesh** (**Tool > Remesh**, `remesh`). See [Geometry](geometry.md#voxel-remesh) |
-| Extract (Tool > SubTool > Extract) | **Tool > Parts > Extract**: the masked part becomes a shell Part, with **Thick**, **E Smt** and **Double**; **Extract** previews, **Accept** keeps it (`extract`, `extract_accept`). See [Parts](parts.md#extract-a-shell) |
-| Focal Shift | No slider for the built-in brushes. Custom brushes have **Hardness** and **Tip sharpness** in their recipe |
-| Ghost, Transp | Not yet. Inactive Parts are drawn slightly dimmed |
-| GoZ | **Send to ZBrush** (GoZ-compatible): send to and receive from ZBrush, and import or export GoZ-compatible files (**File > Send to ZBrush**). See [Exporting](exporting.md#exchange-models-with-zbrush-send-to-zbrush) |
-| Group Masked | **Tool > Face Groups > From mask** (`polygroup_from_mask`) |
-| Group Visible | **Tool > Face Groups > Merge visible** (`polygroup_merge_visible`) |
-| Groups By Normals | **Tool > Face Groups > By normals** with an angle (`polygroup_auto_by_normals`) |
-| Bake, Multi Map Exporter (normal / displacement / AO maps) | **Tool > Bake** (`bake`): tangent and object-space normal, displacement, AO, cavity and colour maps from a high-poly Part onto a low-poly's UVs. See [Baking](baking.md) |
-| Layers (sculpt layers) | **Tool > Layers**: sculpt layers with weights, exported as blend shapes. See [Layers](layers.md) |
-| LazyMouse | **Steady Stroke** (<kbd>L</kbd>, every stroke type) and the **Lazy Stroke** stroke type |
-| LightBox | **Library**, <kbd>,</kbd> (comma) |
-| Live Boolean | Not yet |
-| Local symmetry, radial symmetry | **Sculpt > Symmetry & Gizmo > Symmetry**: **R** (radial symmetry, Radial Count 2-64 around X, Y or Z, combined with the X / Y / Z mirrors) and **Local** (about the active Part's centre). See [Sculpting](sculpting.md#radial-symmetry) |
-| Mask by Cavity | **Tool > Masking > By cavity** (`mask_by_cavity`) |
-| Masking (Ctrl) | Hold <kbd>Ctrl</kbd> to paint the mask, <kbd>Ctrl</kbd>+<kbd>Alt</kbd> to erase. See [Masking](masking.md) |
-| MaskLasso, MaskRect | **Tool > Masking**: pick the shape, then <kbd>Ctrl</kbd>+drag (add <kbd>Alt</kbd> to unmask). See [Masking](masking.md) |
-| MatCap | **Material**: the built-in Lit Spheres, Soft Clay the default, plus Studio (<kbd>M</kbd>), and your own with **Load Lit Sphere...** (`load_matcap`). See [Vertex Paint](vertex-paint.md) |
-| Mirror (Tool > Deformation) | **Tool > Deformation > Mirror** with X Y Z (`mirror`): flips the Part across the plane through the origin. See [Geometry](geometry.md#mirror) |
-| Mirror And Weld | **Tool > Geometry > Modify Topology > Mirror And Weld** with X Y Z (`mirror_and_weld`): the + side mirrored onto the - side and welded into one watertight mesh, keeping face groups and vertex paint. See [Geometry](geometry.md#mirror-and-weld) |
-| Morph target | A [sculpt layer](layers.md); exported as glTF morph targets and FBX/USD blend shapes |
-| Mrgb, M (material channel) | Not yet: there is no per-vertex material channel |
-| Polyframe (PolyF, Shift+F) | **Wire** on the right shelf, or <kbd>Shift</kbd>+<kbd>F</kbd> |
-| Polygroups | **Face Groups**: same idea, same Ctrl+Shift gestures. See [Face Groups and visibility](face-groups.md) |
-| Polypaint | **Vertex Paint**: Paint brush (<kbd>P</kbd>), Rgb, fills, cavity paint. See [Vertex Paint](vertex-paint.md) |
-| Polypaint layers | **Tool > Paint Layers**: Photoshop-style colour layers with blend modes. See [Paint layers](vertex-paint.md#paint-layers) |
-| Project All (ProjectAll) | **Tool > Parts > Project > Project All** (`project_all`), with Dist, Mean and PA Blur; respects the mask. See [Quad retopology](retopology.md#project-all) |
-| Projection Master | Not yet. **Mesh > Generate 3D > Stamp** projects an image onto the model from the view |
-| QuickSave | **File > Save Snapshot** (<kbd>9</kbd> in the ZBrush-style keys); the last 10 are kept in the Library **Snapshots** tab. See [Projects](projects.md#snapshots) |
-| Rgb | **Rgb** on the top shelf (paint while sculpting) |
-| Rgb Intensity, Z Intensity, Focal Shift | Same keys: **RGB Intensity** (<kbd>I</kbd>), **Intensity** (<kbd>U</kbd>), **Falloff** (<kbd>O</kbd>) in **Sculpt > Draw & Tablet** and the Quick Menu |
-| Sculptris Pro, dynamic topology | **Dynamic** on the top shelf, with **Detail** (`dyntopo`). See [Dynamic topology](dynamic-topology.md) |
-| Reconstruct Subdiv | **Tool > Geometry > Reconstruct Subdiv** (`subdiv_reconstruct`) |
-| SDiv, Lower Res / Higher Res (Shift+D / D) | **Tool > Geometry**: the **SDiv** slider, **Lower Res** <kbd>Shift</kbd>+<kbd>D</kbd>, **Higher Res** <kbd>D</kbd> (`subdiv_level`). See [Subdivision levels](subdivision-levels.md) |
-| SelectLasso, SelectRect | **Tool > Visibility**: pick the shape, then <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+drag (add <kbd>Alt</kbd> to hide). See [Face Groups](face-groups.md) |
-| Solo | **Solo** on the right shelf or in **Tool > Parts** |
-| Spotlight | Not yet |
-| Edit > Preferences > Performance, Edit > Preferences > Mem | **Edit > Preferences > Performance**: Antialiasing, Fast Navigation, Multithreading, the last stroke's cost and memory. See [Performance](performance.md) |
-| Store Config | **Store Config**, <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd> (**Edit > Preferences > Config**) |
-| Stroke (Dots, DragRect, DragDot, Spray) | **Stroke** types Dots, Drag Stamp, Slide Stamp, Spray, Lazy Stroke (<kbd>L</kbd> toggles Steady Stroke) |
-| SubTool | **Part**: same idea, <kbd>Alt</kbd>+click to select. See [Parts](parts.md) |
-| Texture Map, New From Polypaint | **Tool > Texture Map**: **New Texture** (1K-8K) and paint straight into it, or **Vertex Paint > Texture**. See [Texture painting](texture-painting.md) |
-| Texture palette | Not yet as a palette of texture images. **Tool > Texture Map > Import Texture** loads an image onto the UVs |
-| Transpose, Gizmo 3D (Move W, Scale E, Rotate R) | **Gizmo**: same keys, arrows, rings and boxes; masked parts stay, Falloff softens the joint. See [Gizmo](gizmo.md) |
-| Transpose All | **All Parts** in the Gizmo panel. See [Gizmo](gizmo.md#all-parts) |
-| UV Master (Unwrap), UV editing | The **UV Editor** (<kbd>Alt</kbd>+<kbd>U</kbd>): seams on the model, Least Stretch, Conformal, By Face Groups, Planar and Unfold unwraps, UDIM packing, texel density, trim sheets (`uv_unwrap`, `uv_pack`...). **Tool > Texture Map > Auto UV** (`uv_auto`) is the one-click unwrap. See [UV Editor](uv-editor.md) |
-| VDM brush, 3D alpha, Create VDM brush from the VDM plane | The **VDM** brush and **Sculpt > Brush > Vector Displacement**: built-in maps, **Load VDM...** (EXR), **New VDM Plane**, **Create VDM**, **Export EXR...**. See [Vector displacement brushes](sculpting.md#vector-displacement-brushes) |
-| Zadd / Zsub | **Add** / **Sub** on the top shelf; <kbd>Alt</kbd> flips for one stroke |
-| ZPlugin | No in-app plugin system yet. Automate with the Python module, `sculptforge-cli` and MCP ([Scripting](scripting.md)) |
-| ZRemesher | **Tool > Geometry > Quad Remesh** (`qremesh`): Target Polygons, Half / Same / Double, Adaptive Size, Keep Groups, Use Vertex Paint, symmetry. No curve guides yet. See [Quad retopology](retopology.md) |
-| ZScript | Script commands: the console (backtick key), script files, `sculptforge-cli`. See [Scripting](scripting.md) |
-| ZSpheres, Adaptive Skin, Preview (A) | **Tool > Forge Spheres**: Draw, Move, Scale, Alt+click deletes, **Preview** (<kbd>A</kbd>), **Make Mesh** (`zsphere_make_mesh`). See [Forge Spheres](forge-spheres.md) |
-| ZTL, ZPR files | Not read directly. Convert ZTools with the SculptForge ZTL Export plug-in for ZBrush (then open the `.ZTL`), or use Send to ZBrush, OBJ, FBX or GLB; save work as `.sfproj` |
+This chapter explains the terms SculptForge uses (Parts, Forge Spheres, Vertex Paint, Library...). The command
+palette (<kbd>F3</kbd>) also finds a feature by what it does: type "remesh", "groups" or "folders". See also the
+[Quick tour for experienced sculptors](quick-tour.md).
## SculptForge terms
@@ -104,8 +31,8 @@ for what is planned.
| Shelves, palettes, trays | The interface around the canvas: shelves hold the most-used controls, palettes hold everything, trays hold pinned palettes. See [The interface](interface.md) |
| Studio brush folder | A shared, read-only brush folder for a team (`SCULPTFORGE_BRUSH_PATH`). See [For studios](studios.md) |
| 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](texture-painting.md#vertex-or-texture) |
-| Quad Remesh | SculptForge's automatic quad retopology (ZBrush's ZRemesher), in **Tool > Geometry**. See [Quad retopology](retopology.md) |
-| 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 ZBrush's local symmetry. See [Quad retopology](retopology.md#quad-remesh) |
+| Quad Remesh | SculptForge's automatic quad retopology, in **Tool > Geometry**. See [Quad retopology](retopology.md) |
+| 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](retopology.md#quad-remesh) |
| Padding (gutter) | The few texels around each UV island that texture painting and baking also fill, so seams don't show. See [Texture painting](texture-painting.md) and [Baking](baking.md) |
| Bake | Capture a high-poly's detail as images (maps) on a low-poly's UVs. See [Baking](baking.md) |
| 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](baking.md#how-the-bake-works) |
diff --git a/docs/guide/images/custom-matcaps.jpg b/docs/guide/images/custom-lit-spheres.jpg
similarity index 100%
rename from docs/guide/images/custom-matcaps.jpg
rename to docs/guide/images/custom-lit-spheres.jpg
diff --git a/docs/guide/images/polygroups.jpg b/docs/guide/images/face-groups.jpg
similarity index 100%
rename from docs/guide/images/polygroups.jpg
rename to docs/guide/images/face-groups.jpg
diff --git a/docs/guide/images/lightbox.jpg b/docs/guide/images/library.jpg
similarity index 100%
rename from docs/guide/images/lightbox.jpg
rename to docs/guide/images/library.jpg
diff --git a/docs/guide/images/subtools.jpg b/docs/guide/images/parts.jpg
similarity index 100%
rename from docs/guide/images/subtools.jpg
rename to docs/guide/images/parts.jpg
diff --git a/docs/guide/images/polypaint.jpg b/docs/guide/images/vertex-paint.jpg
similarity index 100%
rename from docs/guide/images/polypaint.jpg
rename to docs/guide/images/vertex-paint.jpg
diff --git a/docs/guide/index.md b/docs/guide/index.md
index 4dda184b..447727cc 100644
--- a/docs/guide/index.md
+++ b/docs/guide/index.md
@@ -2,7 +2,7 @@
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 ZBrush. It is updated with every
+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](whats-new.md) lists what changed.
Read it inside SculptForge (**Help > User Guide**, or <kbd>Shift</kbd>+<kbd>F1</kbd>) or on the
@@ -18,7 +18,7 @@ Read it inside SculptForge (**Help > User Guide**, or <kbd>Shift</kbd>+<kbd>F1</
| Start from a head or body | [Starter meshes](projects.md#start-from-a-starter-mesh): base meshes with clean quads, **File > New from Starter Mesh** |
| Find your way around | [The interface](interface.md): the menus **File, Edit, Sculpt, Paint, Mesh, View, Render, Help**, the shelves and the Tool panel; [Navigating the view](navigation.md) |
| Learn the brushes | [Sculpting and brushes](sculpting.md) |
-| Switch from ZBrush | [Coming from ZBrush](coming-from-zbrush.md) (the ZBrush-style layout and keys) and the [Glossary](glossary.md) |
+| Switch from another sculpting app | [Quick tour for experienced sculptors](quick-tour.md) (the Classic layout and keys) and the [Glossary](glossary.md) |
| Switch from Blender | [Blender keys](shortcuts.md#blender-keys), and [Working with Blender](blender.md) for the bridge add-on |
| Fix a problem | [Troubleshooting](troubleshooting.md) |
@@ -29,7 +29,7 @@ Read it inside SculptForge (**Help > User Guide**, or <kbd>Shift</kbd>+<kbd>F1</
1. [Welcome to SculptForge](welcome.md)
2. [Your first sculpt in 10 minutes](first-sculpt.md)
3. [What's new](whats-new.md)
-4. [Coming from ZBrush](coming-from-zbrush.md)
+4. [Quick tour for experienced sculptors](quick-tour.md)
5. [Install SculptForge on Windows, macOS and Linux](installing.md)
6. [The interface](interface.md)
7. [Navigating the view](navigation.md)
@@ -70,7 +70,7 @@ Read it inside SculptForge (**Help > User Guide**, or <kbd>Shift</kbd>+<kbd>F1</
## Files and pipelines
33. [Baking normal and displacement maps](baking.md)
-34. [Exporting, Unreal and ZBrush](exporting.md)
+34. [Exporting, Unreal and Bridge](exporting.md)
35. [Export presets](export-presets.md)
36. [Working with Blender](blender.md)
37. [Working with Maya](maya.md)
diff --git a/docs/guide/installing.md b/docs/guide/installing.md
index cada7c99..d54eb8f8 100644
--- a/docs/guide/installing.md
+++ b/docs/guide/installing.md
@@ -196,11 +196,11 @@ live pressure reading.
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 <kbd>,</kbd>
(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, MatCaps, Images, Splats
+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**: **ZBrush**, **Blender**, **Maya** or **New to sculpting**.
-Your answer picks the key style: **ZBrush** turns on the ZBrush-style keys, **Blender** and **Maya** their own
+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](shortcuts.md)); if you are updating from an earlier
version, your saved style is kept and the question isn't asked.
diff --git a/docs/guide/interface.md b/docs/guide/interface.md
index f1f91d52..8d367331 100644
--- a/docs/guide/interface.md
+++ b/docs/guide/interface.md
@@ -2,7 +2,7 @@
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 **ZBrush-style layout**, with a bar
+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](#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.
@@ -24,8 +24,8 @@ interface and keep your changes. The pictures show the default look and layout.
Press <kbd>Tab</kbd> 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 **ZBrush-style 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](#the-title-strip-zbrush-style-layout) and
+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](#the-title-strip-classic-layout) and
[Palettes](#menus-and-palettes).
## Looks and layouts
@@ -43,10 +43,10 @@ models, brushes or shortcuts.
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 <kbd>F3</kbd> finds everything.
-- **ZBrush-style**: the alphabetical palette bar under a title strip, and a two-row top shelf (see [The title
- strip](#the-title-strip-zbrush-style-layout) and [Top shelf](#top-shelf)).
- Coming from ZBrush? In the welcome shown at the first start, pick the **ZBrush-style layout** card or **Coming
- from: ZBrush** (which also sets the ZBrush-style keys).
+- **Classic**: the alphabetical palette bar under a title strip, and a two-row top shelf (see [The title
+ strip](#the-title-strip-classic-layout) and [Top shelf](#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.
@@ -71,12 +71,12 @@ borders, and nothing lights up under the pointer), **Off** (no borders; the gaps
bright border.
**The first start** shows three looks to pick from in the welcome: **Neutral**, **Forge Terminal** (Tokyo Night)
-and **ZBrush-style layout** (Classic with the palette bar). **Coming from** sets the keys and the layout together:
-ZBrush (ZBrush-style keys and layout), Blender, Maya or New to sculpting (their keys, the SculptForge layout).
+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
-ZBrush-style layout again right after. The look and layout are remembered for the next start without
+Classic layout again right after. The look and layout are remembered for the next start without
[Store Config](#store-config-and-friends) (Store Config keeps them in your UI configuration too).
**Updating from an older version** keeps the look and layout you had. A card, **SculptForge has a new look**,
@@ -115,9 +115,9 @@ From left to right:
- **Minimize** and **Close** at the far right. Close asks to save changes first, as
<kbd>Ctrl</kbd>+<kbd>Q</kbd> does.
-## The title strip (ZBrush-style layout)
+## The title strip (Classic layout)
-In the ZBrush-style layout the top edge is a title strip instead, with the palette bar under it. From left to
+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
@@ -138,7 +138,7 @@ right:
## Menus and palettes
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 ZBrush-style layout the palettes sit side by side in the palette bar.
+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
<kbd>Esc</kbd> or click outside to close it.
@@ -147,17 +147,17 @@ Either way, click the name and the palette drops down under it. Click another na
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 ZBrush-style layout, drop the
+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 ZBrush-style 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 ZBrush's strict A to Z order,
-turn on **Edit > Preferences > Interface > Palettes strictly A-Z (ZBrush order)**.
+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), Send to ZBrush, Quit |
+| **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 |
@@ -181,9 +181,6 @@ main example (Part, Layers, Geometry and so on). By default opening one sub-pale
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**.
-> **ZBrush:** as in ZBrush, Parts (ZBrush's SubTool), Layers, Masking, Face Groups (Polygroups) and Visibility are sub-palettes of the Tool
-> palette rather than palettes of their own. SculptForge's Remesh sub-palette is where ZBrush's DynaMesh would be.
-
## Trays
The trays are columns at the far left and far right of the window where palettes stay open while you work. The
@@ -195,7 +192,7 @@ right tray is open by default and holds the **Tool** palette; the left tray star
- **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 ZBrush-style layout, its name in the accent colour). Clicking the name
+ 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).
@@ -231,12 +228,12 @@ interface](#customizing-the-interface) to add items.
- **Dynamic**: [dynamic topology](dynamic-topology.md), with its **Detail** slider while it is on.
- **X**, **Y**, **Z**: symmetry across each axis (<kbd>X</kbd> toggles X); **R** is radial symmetry.
-The ZBrush-style layout's top shelf has two rows: **Library** (<kbd>,</kbd>), Sculpt/Paint, Add/Sub, Rgb, Draw
+The Classic layout's top shelf has two rows: **Library** (<kbd>,</kbd>), Sculpt/Paint, Add/Sub, Rgb, Draw
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).
-Draw Size and Intensity are sliders with the label inside, as in ZBrush: drag along them, or
+Draw Size and Intensity are sliders with the label inside: drag along them, or
<kbd>Ctrl</kbd>+click to type a value.
### Left shelf
@@ -248,8 +245,7 @@ Four large tiles, each showing the current choice. Click one to open its [pop-up
- **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
-(the main and second colour; click either to swap them, like ZBrush's Alternate) and **Fill**, which fills the
+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.
### Right shelf
@@ -257,7 +253,7 @@ unmasked area with the main colour.
- **Undo** and **Redo** (<kbd>Ctrl</kbd>+<kbd>Z</kbd>, <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Z</kbd>): greyed out when
there is nothing to undo or redo. A layout you customised before they were added gets them at the top.
- **Frame** (<kbd>F</kbd>): fits the model in the view.
-- **Move**, **Zoom**, **Rotate**: drag on these buttons to pan, zoom and orbit the view, as in ZBrush.
+- **Move**, **Zoom**, **Rotate**: drag on these buttons to pan, zoom and orbit the view.
- **Wire** (<kbd>Shift</kbd>+<kbd>F</kbd>): shows the mesh's polygons: quads as quads, triangles as triangles.
- **Groups**: colours each face group.
- **Mask** (<kbd>Ctrl</kbd>+<kbd>H</kbd>): shows or hides the mask's darkening (on by default). Hiding it keeps
@@ -299,7 +295,7 @@ yet; picking one loads it).
![The brush picker after pressing B and typing S](images/brush-picker.jpg)
-Choose a brush with the keyboard the ZBrush way:
+Choose a brush with the keyboard:
1. Press <kbd>B</kbd>.
2. Type the first letter of the brush. Only the brushes starting with that letter stay, and each shows an
@@ -328,7 +324,7 @@ brushes](brush-lab.md)).
### Sliders at the cursor and the Quick Menu
-As in ZBrush, press <kbd>S</kbd> for a Draw Size slider under the mouse, <kbd>U</kbd> for Intensity,
+Press <kbd>S</kbd> for a Draw Size slider under the mouse, <kbd>U</kbd> for Intensity,
<kbd>I</kbd> for RGB Intensity or <kbd>O</kbd> for Falloff. Drag the slider, or type a number and press
<kbd>Enter</kbd> (<kbd>Esc</kbd> cancels). The pop-up closes when you release the slider. <kbd>[</kbd> and
<kbd>]</kbd> make the brush 10% smaller or larger at any time. <kbd>Space</kbd> (or a right click on the canvas) opens the Quick Menu with all of
@@ -340,7 +336,7 @@ The Library is a strip of thumbnails across the top of the canvas for browsing e
<kbd>,</kbd> (comma) or click **Library** on the top shelf to show or hide it. It opens on its own at
start-up (see [Preferences](#interface-preferences)).
-![The Library on the Tool tab](images/lightbox.jpg)
+![The Library on the Tool tab](images/library.jpg)
| Tab | Shows | Double-click |
|---|---|---|
@@ -377,9 +373,6 @@ SculptForge, such as the demo lion head), and the Project, Tool, Brush, Alpha, I
**User** folder, your library folder (**Documents/SculptForge** by default). To use a different library folder,
choose it in **Edit > Preferences > Library > Library folder**.
-> **ZBrush:** the Library works like ZBrush's LightBox: comma toggles it, double-click loads, and Built-in and User
-> folders play the part of ZBrush's Maxon and User folders.
-
## Getting help on anything
### Ctrl-hover help
@@ -445,7 +438,7 @@ Everything scriptable is in the command palette, including commands that have no
## The console
Press <kbd>`</kbd> (the backtick key, left of <kbd>1</kbd> on US keyboards) to open the console, a strip
-between the canvas and the bottom shelf. It works like ZBrush's ZScript window:
+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.
@@ -463,7 +456,7 @@ See [Scripting and automation](scripting.md) for the command language, scripts a
## Customizing the interface
Everything about the layout can change: which palettes sit in the trays, what's on each shelf, and which keys
-do what. As in ZBrush, **changes last until you quit** unless you store them with **Store Config**.
+do what. **Changes last until you quit** unless you store them with **Store Config**.
### Move, add and remove shelf items
@@ -487,7 +480,7 @@ Right-clicking a shelf item and choosing **Remove from shelf** works without Cus
new key. Keys you changed show in orange. **Default shortcuts** undoes every change.
- Or double-click a row in the Controls window (<kbd>F1</kbd>).
-If the key already belongs to another action, it moves to the new one (as in ZBrush) and the status line says
+If the key already belongs to another action, it moves to the new one and the status line says
which action lost it.
### Store Config and friends
@@ -506,9 +499,6 @@ The first time you change the layout in a session, the status line reminds you o
Ctrl+Shift+I to keep it". What a session changes by itself (the console and Library being open, the Library
tab) doesn't count as a layout change.
-> **ZBrush:** Store Config has the same shortcut as in ZBrush, and SculptForge never saves the layout on its
-> own either.
-
### Layout presets
The **1**, **2** and **3** buttons at the top right (also in **Edit > Preferences > Config**) switch between three
@@ -535,7 +525,7 @@ Config keeps it.
| **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 (ZBrush order)** | Off | ZBrush-style layout: strict alphabetical palette bar instead of File and Edit first, Help last |
+| **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) |
@@ -571,9 +561,9 @@ on it, as you would scroll a list with a finger (#100).
**Edit > Preferences > Input** sets the key **Style** (the first start sets it from your **Coming from** answer):
**SculptForge** (the default for new installs): <kbd>1</kbd> to <kbd>9</kbd> and <kbd>0</kbd> pick the first ten
brushes, <kbd>I</kbd> opens Intensity like <kbd>U</kbd>, and <kbd>Ctrl</kbd>+drag on the background zooms when
-nothing is masked; **ZBrush-style**: ZBrush's keys, with the number keys free (<kbd>9</kbd> is Save Snapshot),
+nothing is masked; **Classic**: the Classic sculpting keys, with the number keys free (<kbd>9</kbd> is Save Snapshot),
<kbd>I</kbd> for RGB Intensity and <kbd>Ctrl</kbd>+drag on the background for a mask rectangle (see
-[ZBrush-style keys](shortcuts.md#zbrush-style-keys)); **Maya**: Maya's view controls; or **Blender**: middle-drag navigation,
+[the Classic sculpting keys](shortcuts.md#classic-sculpting-keys)); **Maya**: Maya's view controls; or **Blender**: middle-drag navigation,
the numpad views and Blender's sculpt-mode keys (see [Blender keys](shortcuts.md#blender-keys)). In the Blender
style, **Emulate Numpad** makes the number row work as the numpad, and **Import Blender keymap...** takes the keys
from a keymap you exported in Blender. **Right click opens the Quick Menu** (on by default, in every style) opens
@@ -582,8 +572,8 @@ way. **Hold Space and drag to move the camera** (off by default) turns <kbd>Spac
left-drag rotates, right- or middle-drag pans and <kbd>Ctrl</kbd>+drag zooms (see
[Navigation](navigation.md#mouse-and-pen)). **Radial Menus** edits your pie menus and their keys (see [Radial menus](sculpting.md#radial-menus)).
**Cursor follows surface** (on by default) lays the brush rings on the model under the pointer (see
-[Draw Size and Falloff](sculpting.md#draw-size-intensity-rgb-intensity-and-falloff)); off, they are flat circles on the screen. **Rotation** chooses free rotation (ZBrush) or a turntable. See
-[Coming from ZBrush](coming-from-zbrush.md).
+[Draw Size and Falloff](sculpting.md#draw-size-intensity-rgb-intensity-and-falloff)); off, they are flat circles on the screen. **Rotation** chooses free rotation or a turntable. See
+[Quick tour for experienced sculptors](quick-tour.md).
### The background
@@ -593,9 +583,6 @@ charcoal radial gradient (the default), or **Flat Colour**, one solid colour wit
choice 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`.
-> **ZBrush:** like turning the gradient off in the Document palette (**Range** 0) and choosing the **Back**
-> colour.
-
**Edit > Preferences > Library** has **Show at startup** (on by default), the number of **Rows**, **Placement**
(along the top of the canvas, or at the bottom above the bottom shelf) and the **Library folder**.
**Edit > Preferences > Autosave** sets how often a recovery copy is saved (see [Projects, autosave and snapshots](projects.md)).
@@ -608,7 +595,7 @@ choice for the next session, and each project keeps the background it was saved
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
<kbd>F11</kbd> or the green button to go full screen again).
-- In the ZBrush-style layout, **Menus** in the title strip hides the palette bar; click it again to bring it back.
+- In the Classic layout, **Menus** in the title strip hides the palette bar; click it again to bring it back.
- <kbd>Tab</kbd> 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
diff --git a/docs/guide/layers.md b/docs/guide/layers.md
index e7e4bd52..4baa2704 100644
--- a/docs/guide/layers.md
+++ b/docs/guide/layers.md
@@ -13,7 +13,7 @@ weighting, playing and exporting layers.
- Layers belong to a [Part](parts.md): 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](subdivision-levels.md), like ZBrush's 3D Layers: see
+- Layers work on every [subdivision level](subdivision-levels.md): see
[Layers and subdivision levels](#layers-and-subdivision-levels).
- Layers survive [subdividing](geometry.md#subdivide), [decimating](geometry.md#decimate) and
[LOD chains](geometry.md#lod-chains). A [voxel remesh](geometry.md#voxel-remesh) bakes them into the surface
@@ -35,7 +35,7 @@ From top to bottom:
(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 ZBrush-style layout the title strip also shows it (`Layer Smile`,
+The Layers list highlights the active layer; in the Classic layout the title strip also shows it (`Layer Smile`,
or `Layer Base`).
## Add a layer and sculpt into it
@@ -65,7 +65,7 @@ Deleting a layer is undoable.
## Layers and subdivision levels
-With [subdivision levels](subdivision-levels.md) a layer works the way ZBrush's 3D Layers do: record it at the
+With [subdivision levels](subdivision-levels.md) 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 Res** (<kbd>Shift</kbd>+<kbd>D</kbd>)
@@ -105,10 +105,6 @@ into the surface.
Importing works the other way: glTF morph targets and FBX or USD blend shapes open as sculpt layers. See
[Exporting](exporting.md).
-> **ZBrush:** Layers here are close to ZBrush's 3D Layers with the slider used as a morph, and they follow
-> subdivision levels the same way. Selecting a layer is its REC; a weight of 0 is its eye. There are no layer
-> folders and no per-layer mask yet.
-
## Scripting
| Command | What it does |
diff --git a/docs/guide/masking.md b/docs/guide/masking.md
index d9766d35..ac1e021d 100644
--- a/docs/guide/masking.md
+++ b/docs/guide/masking.md
@@ -12,12 +12,11 @@ from cavities, face groups or the mesh border.
- 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 `.GoZ` files, so they survive a round trip to ZBrush.
+- 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 (it is on by default; <kbd>Ctrl</kbd>+<kbd>H</kbd> toggles it,
-as ZBrush's View Mask). The same toggle is **Show mask** in **Tool > Masking**, and **Show Mask** in the **Render**
+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** (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>A</kbd>)
is what removes it.
@@ -34,12 +33,9 @@ alpha you have selected, and a **Drag Stamp** stroke masks with dabs along the p
On macOS, <kbd>Cmd</kbd> works wherever this guide says <kbd>Ctrl</kbd>.
-> **ZBrush:** this is ZBrush's Ctrl-masking with its MaskPen brush, the default. Mask Lasso and Mask Rectangle are
-> described next.
-
## Mask with a lasso or rectangle
-To mask a large or sharply outlined area in one go, pick a mask selection shape. As in ZBrush, holding
+To mask a large or sharply outlined area in one go, pick a mask selection shape. Holding
<kbd>Ctrl</kbd> turns the brush on the left shelf into the mask brush: with <kbd>Ctrl</kbd> held, click the brush
tile (or press <kbd>B</kbd>) to pick **Mask Pen**, **Mask Lasso** or **Mask Rectangle**, or click the stroke tile to pick
the stroke (**Dots**, **Lasso** or **Rect**). The same shapes sit at the top of **Tool > Masking**:
@@ -61,7 +57,7 @@ With **Mask Lasso** or **Mask Rectangle**:
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 (as in ZBrush).
+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.
@@ -72,11 +68,6 @@ image too when symmetry is on.
The cursor turns into a small cross while <kbd>Ctrl</kbd> is held, since the brush size doesn't matter for a
selection.
-> **ZBrush:** these are ZBrush's MaskLasso and MaskRect brushes. Like ZBrush, the shape stays selected until you
-> pick another one, so switch back to **Mask Pen** to paint masks again. Holding <kbd>Ctrl</kbd> shows the mask
-> brush on the shelf and <kbd>Ctrl</kbd> with the Brush or Stroke picker picks it, as in ZBrush. MaskCurve is not
-> available yet.
-
## Background gestures
With <kbd>Ctrl</kbd> held, clicks and drags on the empty background act on the whole mask:
@@ -85,12 +76,9 @@ With <kbd>Ctrl</kbd> held, clicks and drags on the empty background act on the w
|---|---|
| <kbd>Ctrl</kbd> + click the background | Invert the mask |
| <kbd>Ctrl</kbd> + drag on the background | Draw a mask rectangle (Mask Pen; Mask Lasso draws a lasso): what it covers is masked, mirrored by the symmetry. A shape that covers none of the model clears the mask. |
-| <kbd>Ctrl</kbd> + drag on the background, with nothing masked | Zoom the view in the SculptForge style (the default); with the ZBrush-style keys it draws the mask rectangle above (see [Keyboard and mouse](shortcuts.md#zbrush-style-keys)) |
-
-> **ZBrush:** with DynaMesh on, ZBrush also remeshes when a <kbd>Ctrl</kbd> + drag on the background misses the
-> model. SculptForge doesn't: remesh with **Tool > Remesh** instead.
+| <kbd>Ctrl</kbd> + 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](shortcuts.md#classic-sculpting-keys)) |
-On the model, a <kbd>Ctrl</kbd> + click that doesn't drag works on the mask's edges, as in ZBrush, whichever
+On the model, a <kbd>Ctrl</kbd> + click that doesn't drag works on the mask's edges, whichever
mask shape is picked:
| Gesture | Effect |
@@ -134,7 +122,7 @@ Open **Tool > Masking** (the Tool palette is in the right tray by default). Ever
| **By face group** | Mask one face group, replacing the current mask. The number field next to it is the face group id. | `mask_by_polygroup` |
| **By border** | Mask the open edges of the mesh (edges with only one face) and the rings of edges inside them, replacing the current mask, so sculpting keeps the border in place. Uses **Mask Strength**. A closed mesh has no open edges, and the status bar says so. | `mask_border` |
| **Rings** | How wide **By border** masks, in rings of edges from the border (1 to 20, default 2; 1 masks the border vertices only). | `rings=` |
-| **Face Group borders** | **By border** also masks where face groups meet (ZBrush: Mask by Polygroups border). | `polygroups=true` |
+| **Face Group borders** | **By border** also masks where face groups meet. | `polygroups=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
@@ -166,7 +154,7 @@ The quickest way works without knowing the group's number:
3. <kbd>Ctrl</kbd>+<kbd>Shift</kbd> + 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 (<kbd>`</kbd>) and read the `isolate_polygroup group=N` line. Enter that number in
+group, then open the console (<kbd>`</kbd>) and read the `isolate_face group group=N` line. Enter that number in
the field next to **By face group** and click it.
### Sculpt without breaking the border
diff --git a/docs/guide/maya.md b/docs/guide/maya.md
index 32c75124..765910ae 100644
--- a/docs/guide/maya.md
+++ b/docs/guide/maya.md
@@ -2,7 +2,7 @@
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 like ZBrush's GoZ between ZBrush and other apps, on Linux, Windows and macOS.
+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
diff --git a/docs/guide/micro-levels.md b/docs/guide/micro-levels.md
index df297adc..d12f9e27 100644
--- a/docs/guide/micro-levels.md
+++ b/docs/guide/micro-levels.md
@@ -8,9 +8,6 @@ micro triangles take about 0.4 GB, sculpt in real time and draw at 60+ frames pe
![A sphere with 335 million micro triangles: surface noise, a Clay Block band, Crease and Sharp Crease lines (Micro 4, 420 MB)](images/micro-300m.jpg)
-> **ZBrush:** HD Geometry also goes past the subdivision levels, but you sculpt it one small region at a time.
-> A micro level is the whole model, all the time: every brush stroke, every view, every Part at once.
-
## Making a micro level
1. Divide the Part to a comfortable highest level (0.3 to 2 million triangles is the sweet spot).
diff --git a/docs/guide/navigation.md b/docs/guide/navigation.md
index b028a2eb..3b4ca3ff 100644
--- a/docs/guide/navigation.md
+++ b/docs/guide/navigation.md
@@ -5,7 +5,7 @@ This chapter explains how to rotate, pan and zoom the camera with a mouse, a pen
## How the camera works
-The camera orbits around a target point. By default rotation is **free**, as in ZBrush: dragging turns the
+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
<kbd>Shift</kbd> while rotating to snap to the nearest front, back, side, top or bottom view; let go of
<kbd>Shift</kbd> and the drag carries on from where the cursor is. If you prefer the model to stay upright, as
@@ -31,12 +31,6 @@ axes.
Navigation starts only on the canvas. A drag that begins on a shelf, a tray or a palette never moves the
camera.
-> **ZBrush:** the gestures are ZBrush's. Dragging on the background (or right-dragging) rotates, with
-> <kbd>Shift</kbd> to snap; <kbd>Alt</kbd>+drag pans, and letting go of <kbd>Alt</kbd> while still dragging
-> zooms; <kbd>Ctrl</kbd>+right-drag zooms and <kbd>Alt</kbd>+right-drag pans, as with ZBrush's right-click
-> navigation. As in ZBrush, dragging up (forward) zooms out and dragging down zooms in, and when you rotate or pan
-> the model follows the cursor. The right-shelf Move, Zoom and Rotate buttons work as in ZBrush.
-
> **Blender:** with **Edit > Preferences > Input > Style** on **Blender**, middle-drag rotates, <kbd>Shift</kbd>+middle-drag
> pans and <kbd>Ctrl</kbd>+middle-drag zooms. With a pen or a trackpad, <kbd>Alt</kbd>+left-drag beside the model
> does the same (add <kbd>Shift</kbd> to pan, anywhere; <kbd>Ctrl</kbd> to zoom); on the model it masks, as in
@@ -49,9 +43,9 @@ camera.
| To | Do this |
|---|---|
| Rotate | Left-drag on the background, or right-drag anywhere on the canvas; add <kbd>Shift</kbd> to snap to an axis view |
-| Roll (turn about the view axis) | <kbd>Shift</kbd>+click the background, let go of <kbd>Shift</kbd>, then drag (ZBrush) |
+| Roll (turn about the view axis) | <kbd>Shift</kbd>+click the background, let go of <kbd>Shift</kbd>, then drag |
| Pan | <kbd>Alt</kbd>+left-drag on the background, <kbd>Alt</kbd>+right-drag, or middle-drag |
-| Zoom | Mouse wheel; <kbd>Alt</kbd>+left-drag on the background, then let go of <kbd>Alt</kbd> and keep dragging; <kbd>Ctrl</kbd>+right-drag; <kbd>Ctrl</kbd>+middle-drag; <kbd>Ctrl</kbd>+left-drag on the background when nothing is masked (not with the ZBrush-style keys) |
+| Zoom | Mouse wheel; <kbd>Alt</kbd>+left-drag on the background, then let go of <kbd>Alt</kbd> and keep dragging; <kbd>Ctrl</kbd>+right-drag; <kbd>Ctrl</kbd>+middle-drag; <kbd>Ctrl</kbd>+left-drag on the background when nothing is masked (not with the Classic sculpting keys) |
| Frame the model | <kbd>F</kbd> (Blender style: <kbd>Home</kbd>), or **Frame** on the right shelf |
| Front, right, top view | <kbd>Numpad 1</kbd>, <kbd>Numpad 3</kbd>, <kbd>Numpad 7</kbd>; <kbd>Ctrl</kbd> 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 |
@@ -62,10 +56,10 @@ camera.
| Sculpt from the background | Turn on **Edit > Preferences > Input > Start strokes off the model**, **View > Lock camera**, or press <kbd>Shift</kbd>+<kbd>L</kbd>: 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 <kbd>Space</kbd>: left-drag rotates, right- or middle-drag pans, <kbd>Ctrl</kbd>+drag zooms, anywhere on the canvas (on the model too) |
-Zoom drags: drag up to come closer, down to back away. With the ZBrush-style keys (**Edit > Preferences > Input**)
-they go the ZBrush way: drag up to zoom out, down to zoom in.
+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 in ZBrush <kbd>Space</kbd> opens the
+**Hold Space and drag to move the camera** is off by default, because with the Classic sculpting keys <kbd>Space</kbd> opens the
Quick Menu. With it on, <kbd>Space</kbd> no longer opens the Quick Menu (a right click still does), and a space typed in
a text field is never taken.
@@ -76,7 +70,7 @@ model, so strokes that begin at the silhouette never turn the view by accident.
<kbd>Shift</kbd> (smooth) strokes start the same way, and a <kbd>Ctrl</kbd>+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), <kbd>Alt</kbd>+drag to pan,
middle-drag, or hold <kbd>Space</kbd> if **Hold Space and drag to move the camera** is on; with the Blender or Maya
-style, <kbd>Alt</kbd>+left-drag rotates as before. With a pen that has no buttons and the ZBrush or SculptForge style,
+style, <kbd>Alt</kbd>+left-drag rotates as before. With a pen that has no buttons and the Classic or SculptForge style,
press <kbd>Shift</kbd>+<kbd>L</kbd> to turn it off while you rotate, or turn on Hold Space. Mask Lasso, Mask Rectangle and the
<kbd>Ctrl</kbd>+<kbd>Shift</kbd> hide and show shapes work as before.
@@ -85,7 +79,7 @@ the model sculpts instead, so with a pen or a one-button mouse, start rotations
model fills the view, zoom out a little or use the right-shelf buttons.
> **Note:** <kbd>Ctrl</kbd>+left-drag on the background clears the mask when something is masked (and
-> <kbd>Ctrl</kbd>+click there inverts it); while nothing is masked it zooms (with the ZBrush-style keys it draws a mask rectangle instead). Use the wheel or
+> <kbd>Ctrl</kbd>+click there inverts it); while nothing is masked it zooms (with the Classic sculpting keys it draws a mask rectangle instead). Use the wheel or
> <kbd>Ctrl</kbd>+middle-drag to zoom on a masked model. See [Masking](masking.md).
On macOS, <kbd>Cmd</kbd> works wherever this guide says <kbd>Ctrl</kbd> for these gestures, except
@@ -93,7 +87,7 @@ On macOS, <kbd>Cmd</kbd> works wherever this guide says <kbd>Ctrl</kbd> for thes
## The right-shelf navigation buttons
-The right shelf has three buttons you **drag on** rather than click, as in ZBrush. They are handy with a pen,
+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](images/right-shelf.jpg)
@@ -130,7 +124,7 @@ orbits around (the camera's target: **Frame** sets it to the scene's centre, and
| 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, ZBrush-style, Blender, Maya) and while a stroke is
+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.
@@ -190,7 +184,7 @@ unusual scale.
These live on the right shelf and in the **View** menu:
- **Wire** (<kbd>Shift</kbd>+<kbd>F</kbd>): shows the polygons of the active Part over
- the surface, ZBrush's PolyFrame. Quads show as quads (see [Quads and triangles](geometry.md#quads-and-triangles)).
+ the surface, PolyFrame. Quads show as quads (see [Quads and triangles](geometry.md#quads-and-triangles)).
Useful for judging mesh density before you subdivide or remesh.
- **Groups**: colours each face group.
- **Mask**: darkens masked areas.
diff --git a/docs/guide/packs-and-macros.md b/docs/guide/packs-and-macros.md
index 1fecc0fc..a3cfabcf 100644
--- a/docs/guide/packs-and-macros.md
+++ b/docs/guide/packs-and-macros.md
@@ -52,7 +52,7 @@ whether a problem comes from a pack. `sculptforge-cli --no-packs` does the same
## Make a pack
**Library > Packs > New Pack...** lists what you made yourself: brushes in your library, images in your
-Library's Alphas and MatCaps folders, the active Part's Fill layers as a Material Recipe, your VDMs, your pie
+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.
@@ -113,7 +113,7 @@ not asked again for that macro unless its text changes. A macro's edits on one P
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 ZBrush;
+- 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
diff --git a/docs/guide/parts.md b/docs/guide/parts.md
index 1167b366..a8909f57 100644
--- a/docs/guide/parts.md
+++ b/docs/guide/parts.md
@@ -1,6 +1,6 @@
# Parts
-A scene in SculptForge can hold several separate meshes, called Parts (ZBrush users: SubTools): a body, eyes, teeth,
+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.
@@ -12,19 +12,16 @@ hiding, reordering, merging and splitting Parts, and how they travel through fil
[sculpt layers](layers.md).
- Each Part has its own undo history. <kbd>Ctrl</kbd>+<kbd>Z</kbd> 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**, as in ZBrush. Merges and
+- Adding, deleting, reordering, merging and splitting Parts are **not undoable**. Merges and
deletes ask for confirmation first.
-- The Parts list highlights the active Part. In the ZBrush-style layout the title strip also shows it and its place
+- 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)`.
-> **ZBrush:** Parts work the way you expect: one active Part, the rest dimmed, Alt+click in the viewport to
-> switch. There is no folder grouping of Parts yet.
-
## The Parts list
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](images/subtools.jpg)
+![The Parts sub-palette with several Parts, the active one highlighted](images/parts.jpg)
Each row shows a small picture of the Part, its name, its triangle count 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,
@@ -129,7 +126,7 @@ Both replace the active Part with the pieces. Because a merge keeps each origina
## Extract a shell
**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 as in ZBrush:
+top of a head, a strap, a sleeve, a piece of armour that fits the surface exactly. It works:
1. Mask the part (hold <kbd>Ctrl</kbd> and paint, or use **Mask Rectangle** / **Mask Lasso**; see [Masking](masking.md)).
2. Click **Extract**. The shell appears as a preview, a Part just below the active one.
@@ -151,8 +148,6 @@ Accept is one undo step: <kbd>Ctrl</kbd>+<kbd>Z</kbd> on the source Part takes t
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.
-> **ZBrush:** the same Extract, E Smt, Thick, Double, TCorne, TBorder and Accept.
-
## Delete a Part
Click **Delete...** (or right-click a row > **Delete...**) and confirm. The last Part can't be deleted, and a
@@ -167,7 +162,7 @@ delete can't be undone.
| 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 |
-| Send to ZBrush (GoZ-compatible exchange) | Each visible Part is sent to ZBrush as its own SubTool |
+| 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](exporting.md) for the
@@ -196,7 +191,7 @@ used.
| `extract_accept` / `extract_cancel` | Keep or remove the Extract preview |
```text
-subtool_append type=sphere name=EyeL size=0.12; subtool_duplicate; subtool_rename to=EyeR
+part_append type=sphere name=EyeL size=0.12; part_duplicate; part_rename to=EyeR
```
## See also
diff --git a/docs/guide/projects.md b/docs/guide/projects.md
index 5493a63f..48d77cb4 100644
--- a/docs/guide/projects.md
+++ b/docs/guide/projects.md
@@ -21,17 +21,12 @@ 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](exporting.md).
-> **ZBrush:** A `.sfproj` is the equivalent of a ZBrush project (`.ZPR`), and saving a single Part scene is close
-> to saving a `.ZTL`. SculptForge can't read `.ZPR` files, and opens a `.ZTL` only after
-> the [ZTL Export plug-in](coming-from-zbrush.md#bring-your-ztools-over) converted it in ZBrush; otherwise bring
-> models over with [Send to ZBrush](exporting.md) or as OBJ, FBX or GLB.
-
## Save a project
- **File > Save** (<kbd>Ctrl</kbd>+<kbd>S</kbd>) saves to the current project. The first time, it asks for a file
name.
- **File > Save As...** (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>S</kbd>) saves under a new name.
-- In the ZBrush-style layout, clicking the document name in the title strip also saves.
+- 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 the window title
starts with `*`. Any edit in any Part counts, as do splat edits and layer weight changes.
@@ -115,8 +110,8 @@ The autosave also appears first in the Library **Snapshots** tab while it exists
## Snapshots
-**File > Save Snapshot** (also the **Snapshot** button in the ZBrush-style layout's title strip) saves a timestamped copy of the whole
-scene (ZBrush users: QuickSave). Your project file, its name and its unsaved state are not changed, so a snapshot
+**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
@@ -125,7 +120,7 @@ is safe to take before any risky step.
- 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 ZBrush-style keys (**Edit > Preferences > Input**) <kbd>9</kbd> takes a snapshot; otherwise it has no default
+With the Classic sculpting keys (**Edit > Preferences > Input**) <kbd>9</kbd> takes a snapshot; otherwise it has no default
shortcut. To give it one, hold <kbd>Ctrl</kbd>+<kbd>Alt</kbd>, click the **Snapshot**
button and press a key (see [The interface](interface.md)).
@@ -158,7 +153,7 @@ Press <kbd>,</kbd> (comma) to show the Library. The tabs that matter for project
Double-click a tile to open it (you are asked about unsaved changes first). In the **Tool** tab,
<kbd>Shift</kbd>+double-click a model to append it as a Part instead.
-![The Library showing project thumbnails](images/lightbox.jpg)
+![The Library showing project thumbnails](images/library.jpg)
## Scripting
diff --git a/docs/guide/quick-tour.md b/docs/guide/quick-tour.md
new file mode 100644
index 00000000..12952cc6
--- /dev/null
+++ b/docs/guide/quick-tour.md
@@ -0,0 +1,46 @@
+# Quick tour for experienced sculptors
+
+If you have sculpted in another app, most habits carry over. This page shows where things are and how to set
+SculptForge up the way your hands expect.
+
+## Keys and layout
+
+At the first start, pick **Classic sculpting keys** when SculptForge asks what you are coming from. It turns on the
+classic keys and gestures and the **Classic layout**: a title strip, the alphabetical palette bar and a two-row top
+shelf. Change either later in **Edit > Preferences > Input** and **Edit > Preferences > Interface > Look**.
+
+With the Classic sculpting keys you sculpt with a left drag, hold <kbd>Alt</kbd> to subtract and <kbd>Shift</kbd>
+to smooth, drag on the background to rotate, <kbd>Alt</kbd>+drag to pan, and hold <kbd>Ctrl</kbd> to mask.
+<kbd>S</kbd>, <kbd>U</kbd>, <kbd>I</kbd> and <kbd>O</kbd> put the Draw Size, Intensity, RGB Intensity and Falloff
+sliders under the cursor, <kbd>Space</kbd> opens the Quick Menu, <kbd>B</kbd> opens the brush pop-up with the same
+letter keys (B, S, T picks Standard), <kbd>,</kbd> opens the Library and <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd>
+stores your interface. Every key is listed in [Keyboard and mouse](shortcuts.md#classic-sculpting-keys).
+
+## Where things are
+
+| Looking for | In SculptForge |
+|---|---|
+| Separate meshes in one scene | **Parts**: **Tool > Parts** ([Parts](parts.md)) |
+| Blocking out from spheres | **Forge Spheres**: **Tool > Forge Spheres** ([Forge Spheres](forge-spheres.md)) |
+| Colour on the vertices | **Vertex Paint** ([Vertex paint and materials](vertex-paint.md)) |
+| Groups of faces to mask, hide and split by | **Face Groups** ([Face groups and visibility](face-groups.md)) |
+| Viewport materials from a lit-sphere image | **Lit Spheres** (**Material**) |
+| Your projects, brushes, alphas and materials | **Library** (<kbd>,</kbd>) |
+| An even, watertight remesh | **Tool > Remesh > Voxel Remesh** ([Geometry](geometry.md)) |
+| Automatic quad retopology | **Tool > Geometry > Quad Remesh** ([Retopology](retopology.md)) |
+| Sculpting that adds detail where the brush goes | **Dynamic topology** ([Dynamic topology](dynamic-topology.md)) |
+| Subdivision levels | **Tool > Geometry > Divide** ([Subdivision levels](subdivision-levels.md)) |
+
+The command palette (<kbd>F3</kbd>) finds any feature by what it does: type "remesh", "groups" or "folders".
+
+## Bringing your work over
+
+Export OBJ, FBX, glTF or USD from the other app and open it here: quads, UVs and groups come along. Or use the
+**Bridge** (**File > Bridge**) to send Parts back and forth with face groups, mask and vertex paint; see
+[Exporting, Unreal and Bridge](exporting.md#exchange-models-through-the-bridge).
+
+## See also
+
+- [The interface](interface.md)
+- [Keyboard and mouse](shortcuts.md)
+- [Glossary](glossary.md)
diff --git a/docs/guide/retopology.md b/docs/guide/retopology.md
index 585a0458..ee7b7320 100644
--- a/docs/guide/retopology.md
+++ b/docs/guide/retopology.md
@@ -1,8 +1,8 @@
# Quad retopology and detail projection
-**Quad Remesh** rebuilds a sculpt as clean, all-quad topology whose edge loops follow the forms, like ZBrush's
-ZRemesher. **Project All** then moves a mesh onto the surface of other Parts, so the detail of the original
-sculpt comes back onto the new topology, like ZBrush's Project All. Together they turn a dense, messy sculpt
+**Quad Remesh** rebuilds a sculpt as clean, all-quad topology whose edge loops follow the forms.
+**Project All** 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.
@@ -39,7 +39,7 @@ Both steps are single undo steps (<kbd>Ctrl</kbd>+<kbd>Z</kbd>).
| **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 All. Off: the Part is replaced, as in ZBrush (undo brings it back) |
+| **Keep Original** | Keep the Part as it was, hidden, below the new one, ready for Project All. 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](#quad-remesh-guides) |
@@ -49,7 +49,7 @@ Both steps are single undo steps (<kbd>Ctrl</kbd>+<kbd>Z</kbd>).
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 GoZ-compatible
+- 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.
@@ -135,14 +135,10 @@ The legacy method (**Method > Legacy**, `method=legacy`) is the Instant Meshes s
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 the spacing and split, which shows as paired loops.
-> **ZBrush:** Quad Remesh Guides work like ZBrush's ZRemesher Guides brush, and Curves Strength like its slider of that name.
-> Keep Groups, Use Vertex Paint, Adaptive Size, Half / Same / Double and symmetry work as you know them. There is no
-> Freeze Border / Freeze Groups yet, and the mask doesn't steer Quad Remesh: use vertex paint for density.
-
## Quad Remesh Guides
Draw curves on the sculpt and Quad Remesh puts an edge loop along each one, and turns the flow around it to follow,
-like ZBrush's ZRemesher Guides brush. With Quad Remesh 2 an open curve is an exact edge loop: the grid line lies on it.
+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.
@@ -229,7 +225,7 @@ straight along the normal, it takes the closest point within **Dist**.
| `project_all` | `distance` (0.001-1, default 0.02), `mean`, `blur` (0-20), `geometry` (default true), `polypaint` (default true), `source` (one Part's name instead of all visible ones) |
```sh
-sculptforge-cli -c 'open path=scan.glb; qremesh target=8000 adaptive=0.3 keep_original=true; subdivide levels=2; subtool_visibility index=1 visible=true; project_all distance=0.02; export_fbx path=retopo.fbx'
+sculptforge-cli -c 'open path=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'
```
```sh
diff --git a/docs/guide/scripting.md b/docs/guide/scripting.md
index 44aabc9d..31e1fd99 100644
--- a/docs/guide/scripting.md
+++ b/docs/guide/scripting.md
@@ -5,9 +5,6 @@ inside the app, from script files, from the `sculptforge-cli` tool on a build fa
agents through the Model Context Protocol (MCP). This chapter explains the script language, the console, both
command-line programs, the Python module and MCP setup.
-> **ZBrush:** The console plays the role of ZBrush's ZScript window, and **Copy session as script** is a macro
-> recorder. The language is much simpler than ZScript: one command per statement, with named parameters.
-
## The script language
A script is a list of statements. Each statement is a command name followed by `name=value` parameters:
@@ -85,7 +82,7 @@ the ones you will use most:
|---|---|---|
| Scene | `new_sphere` | `subdivisions` (0 to 8, default 6) |
| Scene | `new_plane` | `resolution` (cells per side, default 128) |
-| Files | `open` | `path`: models, projects, splats, GoZ-compatible files |
+| 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) |
@@ -222,8 +219,8 @@ sf.run_script(doc, "decimate ratio=0.25; export_lods path=/out/troll.glb levels=
verts, tris = doc.vertices, doc.triangles # NumPy (N, 3) float32 and (M, 3) uint32
doc.set_mesh(verts * 1.1, tris) # bring in a mesh from your own tools (clears undo)
-print(doc.subtools) # [{'name': ..., 'visible': ..., 'triangles': ...}]
-doc.active_subtool = "Helmet" # select by index or name
+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)
diff --git a/docs/guide/sculpting.md b/docs/guide/sculpting.md
index 04bba19e..34bf6f19 100644
--- a/docs/guide/sculpting.md
+++ b/docs/guide/sculpting.md
@@ -22,9 +22,6 @@ works on the active Part, and only on parts that are visible and not masked. A s
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).
-> **ZBrush:** the modifiers are the ones you know. <kbd>Alt</kbd> flips Add and Sub for one stroke,
-> <kbd>Shift</kbd> smooths with any brush, <kbd>Ctrl</kbd> paints a mask (see [Masking](masking.md)).
-
## Built-in brushes
SculptForge has nineteen sculpting brushes plus the Paint brush. The first ten have number keys; all of them
@@ -63,10 +60,6 @@ Notes on particular brushes:
**Pressure > Strength** is on, so you can feather the edge of a layer.
- **Trim** gives crisp planes on cylinders and edges. Use it with **Front** on when you work on thin shapes.
-> **ZBrush:** Sharp Crease (ZBrush's DamStandard), Clay Block (ClayBuildup), Tendril (SnakeHook), Trim (Trim
-> Dynamic), Layer and Nudge behave like their ZBrush counterparts. Brushes such as ZBrush's hPolish, ClayTubes, Slash or the IMM and curve brushes are not built in;
-> you can get close to several of them with a custom brush in [Brush Lab](brush-lab.md).
-
## Custom brushes that ship with SculptForge
Besides the built-in brushes, SculptForge ships seven custom brushes. They are *recipes*: data that you can
@@ -106,7 +99,7 @@ the `Brushes` folder of your Library library that aren't loaded yet; picking one
![The brush picker after pressing B, with letter badges](images/brush-picker.jpg)
-The picker works the ZBrush way, by typing letters:
+The picker works, by typing letters:
1. Press <kbd>B</kbd>.
2. Type the first letter of the brush. Only brushes starting with that letter stay, and each shows a highlighted
@@ -124,10 +117,6 @@ Hover a tile for a large preview and the brush's description. Right-click a tile
and on custom brushes also **Copy brush code**, **Rename...**, **Save as .sfbrush...**, **Delete...** and
**Reveal in folder** (see [Brush Lab and sharing brushes](brush-lab.md)).
-> **ZBrush:** <kbd>B</kbd> then two letters is the same muscle memory. Holding <kbd>Ctrl</kbd> while picking
-> to choose a masking brush is not supported; mask strokes always use <kbd>Ctrl</kbd> with the current
-> settings.
-
## Draw Size, Intensity, RGB Intensity and Falloff
These values control every brush. Draw Size and Intensity are on the top shelf;
@@ -143,11 +132,11 @@ all four are in **Sculpt > Draw & Tablet** and the [Quick Menu](#the-quick-menu)
Because **Draw Size** is measured on screen, the brush covers less of the model as you zoom in, which is what
you want for detail work.
-The brush cursor shows two rings, as in ZBrush: the outer one is the Draw Size, the inner one is Falloff
+The brush cursor shows two rings: the outer one is the Draw 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](#alphas), Falloff works as in ZBrush: the alpha is multiplied by the round falloff. At -100
+With an [alpha](#alphas), 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.
@@ -179,7 +168,7 @@ yet in the session starts from the values you have now, so nothing jumps.
### Smooth's own Intensity
-Smooth keeps an Intensity of its own, as in ZBrush, so a gentle Standard stroke at 10 still smooths at full
+Smooth keeps an Intensity of its own, so a gentle Standard stroke at 10 still smooths at full
speed. Hold <kbd>Shift</kbd> (or pick the Smooth brush) and the Intensity slider shows **Smooth Intensity**:
change it there, or hold <kbd>Shift</kbd> and press <kbd>U</kbd>. It starts at 50.
@@ -189,7 +178,7 @@ The plain smooth evens out bumps by pulling each point towards its neighbours, s
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**, as in ZBrush: start a stroke with <kbd>Shift</kbd> held, then let go of <kbd>Shift</kbd>
+- **Alternate smooth**: start a stroke with <kbd>Shift</kbd> held, then let go of <kbd>Shift</kbd>
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 <kbd>Shift</kbd> and
the Smooth brush use; letting go of <kbd>Shift</kbd> mid-stroke then switches to the plain one. Saved with the
@@ -218,7 +207,7 @@ These toggles sit on the top shelf and in **Sculpt > Draw & Tablet**:
|---|---|
| **Sculpt** / **Paint** | **Sculpt** makes brushes change the shape. **Paint** (<kbd>P</kbd>) paints colour only. |
| **Add** / **Sub** | **Add** makes brushes add (the default), **Sub** makes them subtract. <kbd>Alt</kbd> flips the current choice for one stroke. |
-| **Rgb** | Sculpt brushes also paint the current colour as they sculpt (ZBrush: Rgb with Zadd). |
+| **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
@@ -260,12 +249,12 @@ points right at you, drag up to pull it out. **Edit > Preferences > Input > Alon
## The Quick Menu
-Press <kbd>Space</kbd> for ZBrush's QuickMenu under the cursor: the Brush, Stroke, Alpha and Material tiles,
+Press <kbd>Space</kbd> for the Quick Menu under the cursor: the Brush, Stroke, Alpha and Material tiles,
Draw Size, Falloff, Intensity and RGB Intensity, Add / Sub, Sculpt / Paint, Rgb and X symmetry. Hold
<kbd>Space</kbd> and let go to close it again (it stays while the pointer is on it), or tap <kbd>Space</kbd> to
keep it open until you click elsewhere or press <kbd>Esc</kbd>. Clicking a tile opens its picker.
-A right click on the canvas opens it too, as in ZBrush: press the right button and let go without moving, beside
+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 <kbd>Alt</kbd> or <kbd>Ctrl</kbd>), 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**.
@@ -315,7 +304,7 @@ open borders stay where they are, and each is one undo step:
| **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 (ZBrush users: Inflate Balloon). A negative amount lets the air out. |
+| **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,
@@ -379,9 +368,6 @@ Away, In, Add or Clip). The label next to the brush cursor names the shape. Pick
adds the modifiers and shows every choice at once.
- Change the key in **Edit > Preferences > Hotkeys** (*Stroke popup*), or hold <kbd>Ctrl</kbd>+<kbd>Alt</kbd> and click the shelf button, then press the new key.
-> **ZBrush:** Drag Stamp, Slide Stamp, Spray and Steady Stroke match ZBrush's DragRect, DragDot, Spray and LazyMouse. Freehand and Dots are the same thing here.
-> Roll and curve strokes are not available yet.
-
## Precision work
Pores, wrinkles, jewellery and hard-surface trims need a brush that goes exactly where you mean, at exactly the
@@ -415,7 +401,7 @@ shows next to the cursor for a moment after it changes (all the time with World
<kbd>Shift</kbd>+<kbd>Alt</kbd>: 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,
-<kbd>Shift</kbd>+<kbd>Alt</kbd> still selects and frames a Part (ZBrush and SculptForge styles), and in the Blender
+<kbd>Shift</kbd>+<kbd>Alt</kbd> still selects and frames a Part, and in the Blender
style <kbd>Alt</kbd>+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
@@ -434,7 +420,7 @@ with every tiny bump. A real step in the surface is followed at once.
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](#draw-size-intensity-rgb-intensity-and-falloff) fades it as in ZBrush: set it to -100 to
+[Falloff](#draw-size-intensity-rgb-intensity-and-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](micro-levels.md) too, with every stroke type including Drag Stamp.
@@ -488,13 +474,9 @@ They work with every brush, custom and Community brushes included, and each brus
[Each brush keeps its own settings](#each-brush-keeps-its-own-settings)). From a script:
`brush_alpha_options follow_stroke=true angle=30 angle_jitter=10 tile_x=2 tile_y=2`.
-> **ZBrush:** there is no alpha library browser with hundreds of alphas yet, and alpha options such as
-> MidValue or Rf (radial fade) are not available. Any grayscale image works, including alphas you already have as
-> PNG.
-
## Vector displacement brushes
-A vector displacement brush (ZBrush's VDM brushes, Blender's "VDM brushes") stamps a whole 3D shape in one
+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.
@@ -541,7 +523,7 @@ The top of the screen when you look at the plane from the top is the top of the
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.
-### Load and export maps (Blender, ZBrush)
+### Load and export maps
**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
@@ -562,9 +544,7 @@ with the EXR (Color Space: Non-Color) to a Draw brush, set the texture's **Mappi
[Working with Blender](blender.md#vector-displacement-maps)). Blender's brush touches only the round area of the
brush, so the corners of a map are cut off there; in SculptForge the whole square stamps.
-ZBrush keeps its VDMs inside brushes (as 3D alphas) and doesn't export them as EXR by itself; maps made with
-**Tool > Vector Displacement Map** or third-party exporters use axes set by ZBrush's *Vector Displacement Flip*
-options. If a map from ZBrush stamps lying on its side, load it again with **Swap Y/Z**; if it is mirrored or leans
+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.
@@ -572,10 +552,6 @@ From a script: `vdm_set name=horn` or `vdm_set path=ear.exr swap_yz=true`, `vdm_
angle=30`, `vdm_new_plane`, `vdm_capture name="My horn" exr=horn.exr`, `vdm_export path=horn.exr`, `vdm_list`,
`vdm_delete name="My horn"`.
-> **ZBrush:** the VDM brush works like ZBrush's VDM brushes with DragRect or DragDot. Not available yet:
-> several VDMs in one brush (ZBrush's *Create Multiple Alpha Brush*), MidValue and the alpha options for 3D
-> alphas, and reading ZBrush's own brush files.
-
## Kelvinlet brushes
**KelvinGrab**, **KelvinTwist**, **KelvinScale** and **Elastic Tendril** move the surface the way an elastic solid
@@ -642,10 +618,6 @@ Any detail you have sculpted can become a brush in two seconds: **Capture from v
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.
-> **ZBrush:** this is "GrabDoc" for alphas, and more: ZBrush can only make a VDM from its special VDM plane,
-> here any detail on any model becomes one. The commands `capture_alpha` and `capture_vdm` do the same from a
-> script.
-
### Detail Clone
**DetailClone** stamps the VDM brush's map (a captured one or any other) along your stroke, one copy every stamp
@@ -696,9 +668,6 @@ that take `symmetry` (`stroke`, `vdm_stamp`, `mask_rect`, `mask_lasso`, `hide_re
`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`.
-> **ZBrush:** **R** is ZBrush's (R) radial symmetry with Radial Count, and **Local** is its Local Symmetry (about
-> the Part's centre). Topological (poseable) symmetry is not available yet.
-
## Pen pressure and tablets
SculptForge reads pen pressure from graphics tablets and pen displays through the operating system. When it
@@ -770,5 +739,5 @@ Points are projected onto the surface along `view` (default `0,0,-1`, the front
- [Masking](masking.md): protect areas from every brush
- [Vertex Paint and materials](vertex-paint.md): Paint brush, Rgb and colour
- [Sculpt layers and blend shapes](layers.md): sculpt into a layer you can dial in and out
-- [Dynamic topology](dynamic-topology.md): brushes that add triangles where they need them (Sculptris Pro)
+- [Dynamic topology](dynamic-topology.md): brushes that add triangles where they need them (dynamic topology)
- [Keyboard and mouse reference](shortcuts.md)
diff --git a/docs/guide/shortcuts.md b/docs/guide/shortcuts.md
index 66552774..712936b9 100644
--- a/docs/guide/shortcuts.md
+++ b/docs/guide/shortcuts.md
@@ -4,9 +4,9 @@ This chapter is the reference for every default keyboard shortcut and mouse gest
app, <kbd>F1</kbd> 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), **ZBrush-style**, **Blender** and
+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
-[ZBrush-style](#zbrush-style-keys) and [Blender](#blender-keys) styles change. If you used an earlier version,
+[classic](#classic-sculpting-keys) and [Blender](#blender-keys) styles change. If you used an earlier version,
your saved style is kept.
## Changing shortcuts
@@ -39,7 +39,7 @@ generated from SculptForge's action registry, the same source as the Controls wi
| Move | <kbd>4</kbd> | Grabs the surface under the cursor and pulls it along. |
| Paste brush | <kbd>Ctrl</kbd>+<kbd>V</kbd> | Add the brush on the clipboard: a brush code someone shared, or the text of a .sfbrush file. |
| Pinch | <kbd>8</kbd> | Pulls the surface toward the stroke to tighten edges. |
-| Sharp Crease | <kbd>9</kbd> | A sharp V-shaped crease with the sides pinched in (ZBrush DamStandard). |
+| Sharp Crease | <kbd>9</kbd> | A sharp V-shaped crease with the sides pinched in. |
| Smooth | <kbd>3</kbd> | Relaxes the surface. Hold Shift to smooth with any brush. |
| Standard | <kbd>1</kbd> | Raises the surface along the stroke; Alt digs in. |
@@ -59,7 +59,7 @@ generated from SculptForge's action registry, the same source as the Controls wi
| Intensity at cursor | <kbd>U</kbd> or <kbd>I</kbd> | A 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 | <kbd>]</kbd> | Make the brush 10% larger (hold to repeat; Shift+] steps one pixel). |
| Larger brush by 1 px | <kbd>Shift</kbd>+<kbd>]</kbd> | Make the brush one pixel larger (half a pixel below 2 px). |
-| Paint | <kbd>P</kbd> | Paint colour without sculpting (ZBrush Rgb on, Zadd off). Alt paints back to white, Shift still smooths. |
+| Paint | <kbd>P</kbd> | Paint colour without sculpting. Alt paints back to white, Shift still smooths. |
| Smaller brush | <kbd>[</kbd> | Make the brush 10% smaller (hold to repeat; Shift+[ steps one pixel). |
| Smaller brush by 1 px | <kbd>Shift</kbd>+<kbd>[</kbd> | Make the brush one pixel smaller (half a pixel below 2 px), down to 0.5 px. |
@@ -88,7 +88,7 @@ generated from SculptForge's action registry, the same source as the Controls wi
|---|---|---|
| Command palette | <kbd>F3</kbd> or <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> | Search every command, brush and setting by name and run it. Commands that need parameters open in the console. |
| Controls | <kbd>F1</kbd> | Every shortcut and mouse gesture, generated from the commands themselves. |
-| Quick Menu | <kbd>Space</kbd> | ZBrush's QuickMenu under the cursor: brush, stroke, alpha, material, colour, Draw Size, Falloff and the intensities. Hold Space and let go to close it, or tap Space to keep it open. |
+| Quick Menu | <kbd>Space</kbd> | The Quick Menu under the cursor: brush, stroke, alpha, material, colour, Draw Size, Falloff and the intensities. Hold Space and let go to close it, or tap Space to keep it open. |
| User Guide | <kbd>Shift</kbd>+<kbd>F1</kbd> | The SculptForge user guide: every tool explained, with search. Hold Ctrl over a control and press F1 to open the chapter about it. |
### Library
@@ -113,7 +113,7 @@ generated from SculptForge's action registry, the same source as the Controls wi
| Radial menu 3: Strokes | <kbd>J</kbd> | 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. |
| Save UI... | <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd> | Save the layout, shortcuts and interface preferences to a file you can share. |
| Shelves | <kbd>Tab</kbd> | Hide or show the shelves and trays around the canvas. |
-| Store Config | <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd> | Keep the current layout, shortcuts and interface preferences for future sessions. Like ZBrush, SculptForge never saves them on its own. |
+| Store Config | <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd> | Keep the current layout, shortcuts and interface preferences for future sessions. SculptForge never saves them on its own. |
### Render
@@ -121,7 +121,7 @@ generated from SculptForge's action registry, the same source as the Controls wi
|---|---|---|
| Fullscreen | <kbd>F11</kbd> | Fill the screen with SculptForge (again: back to a window). |
| Mask | <kbd>Ctrl</kbd>+<kbd>H</kbd> | 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 | <kbd>Shift</kbd>+<kbd>F</kbd> | Show the mesh's polygons (quads and triangles) over the surface (ZBrush PolyFrame). |
+| Wireframe | <kbd>Shift</kbd>+<kbd>F</kbd> | Show the mesh's polygons (quads and triangles) over the surface. |
### Script
@@ -143,12 +143,12 @@ generated from SculptForge's action registry, the same source as the Controls wi
| Clear Mask | <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>A</kbd> | Unmask everything (also: Ctrl+drag on the background, away from the model). |
| Divide | <kbd>Ctrl</kbd>+<kbd>D</kbd> | 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 | <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>D</kbd> | Copy the active Part, with its layers and attributes, and make the copy active (also in the Parts list's right-click menu). |
-| Group Masked | <kbd>Ctrl</kbd>+<kbd>W</kbd> | Turn the masked part into a new face group and clear the mask (ZBrush Ctrl+W). With nothing masked, everything visible becomes one group. |
+| Group Masked | <kbd>Ctrl</kbd>+<kbd>W</kbd> | Turn the masked part into a new face group and clear the mask. With nothing masked, everything visible becomes one group. |
| Higher Res | <kbd>D</kbd> | Step one subdivision level up (more polygons, for detail). Edits made below carry the detail along. |
| Invert Mask | <kbd>Ctrl</kbd>+<kbd>I</kbd> | Mask what is unmasked and unmask what is masked (also: Ctrl+click the background). |
| Lower Res | <kbd>Shift</kbd>+<kbd>D</kbd> | Step one subdivision level down (fewer polygons, for big forms). The detail of the higher levels is kept. |
| Mask All | <kbd>Ctrl</kbd>+<kbd>A</kbd> | Mask the whole visible Part. |
-| Preview | <kbd>A</kbd> | Show the skin Make Mesh would build instead of the spheres (ZBrush's Preview). Turn it off to edit the spheres again. |
+| Preview | <kbd>A</kbd> | Show the skin Make Mesh would build instead of the spheres. Turn it off to edit the spheres again. |
### Transform
@@ -202,7 +202,7 @@ generated from SculptForge's action registry, the same source as the Controls wi
| Roll the view | <kbd>Shift</kbd>+click the background, let go of <kbd>Shift</kbd>, drag |
| Rotate | Left-drag on the background, or right-drag; hold <kbd>Shift</kbd> to snap to an axis view |
| Pan | <kbd>Alt</kbd>+left-drag on the background, <kbd>Alt</kbd>+right-drag, or middle-drag |
-| Zoom | Mouse wheel; <kbd>Alt</kbd>+drag on the background then release <kbd>Alt</kbd>; <kbd>Ctrl</kbd>+right-drag; <kbd>Ctrl</kbd>+middle-drag; <kbd>Ctrl</kbd>+left-drag on the background when nothing is masked (not in the ZBrush style) |
+| Zoom | Mouse wheel; <kbd>Alt</kbd>+drag on the background then release <kbd>Alt</kbd>; <kbd>Ctrl</kbd>+right-drag; <kbd>Ctrl</kbd>+middle-drag; <kbd>Ctrl</kbd>+left-drag on the background when nothing is masked (not in the classic) |
| Paint the mask | Hold <kbd>Ctrl</kbd> while stroking on the model |
| Erase the mask | Hold <kbd>Ctrl</kbd>+<kbd>Alt</kbd> while stroking on the model |
| Blur / sharpen the mask | <kbd>Ctrl</kbd>+click / <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+click the model |
@@ -271,23 +271,22 @@ Some keys only mean something while a pop-up or panel has the keyboard.
| <kbd>Backspace</kbd> or <kbd>Delete</kbd> | Remove the shortcut |
| <kbd>Esc</kbd> | Cancel |
-## ZBrush-style keys
+## Classic sculpting keys
-With **Edit > Preferences > Input > Style** on **ZBrush-style** (also at the top of the Controls window, <kbd>F1</kbd>,
-or **ZBrush** in the first-start **Coming from** question), the keys and gestures work as in ZBrush. Store Config
+With **Edit > Preferences > Input > Style** on **Classic**, the keys and gestures work. Store Config
(<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd>) keeps the choice. Compared with the table above, these change:
-| To | SculptForge style | ZBrush-style |
+| To | SculptForge style | classic |
|---|---|---|
| Pick one of the first ten brushes | <kbd>1</kbd> to <kbd>9</kbd>, <kbd>0</kbd> (Standard, Clay, Smooth, Move ...) | No key: the number keys are free |
-| Save Snapshot | No key | <kbd>9</kbd> (ZBrush's QuickSave) |
+| Save Snapshot | No key | <kbd>9</kbd> |
| Slider at the cursor on <kbd>I</kbd> | Intensity (as <kbd>U</kbd>) | RGB Intensity |
| <kbd>Ctrl</kbd>+drag on the background with nothing masked | Zooms | Draws a mask rectangle (one that misses the model clears the mask) |
| Zoom drags (<kbd>Ctrl</kbd>+right-drag, <kbd>Alt</kbd>+drag then release) | Up zooms in | Up zooms out |
Everything else, from the <kbd>B</kbd> brush letters and <kbd>S</kbd> / <kbd>U</kbd> / <kbd>O</kbd> to the
<kbd>Ctrl</kbd> and <kbd>Ctrl</kbd>+<kbd>Shift</kbd> gestures, is the same in both styles. The **Maya** style keeps
-these ZBrush-style keys and changes only the view controls (<kbd>Alt</kbd>+left, middle and right drags).
+these the Classic sculpting keys and changes only the view controls (<kbd>Alt</kbd>+left, middle and right drags).
## Maya keys
@@ -356,23 +355,23 @@ SculptForge doesn't have are left alone; the status bar says how many keys it to
never run. <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd> (Store Config) keeps the keys; **Restore Standard UI**
goes back to the defaults.
-## ZBrush keys that work differently
+## Classic sculpting keys that work differently
-ZBrush's keys and gestures work in SculptForge with the [ZBrush-style keys](#zbrush-style-keys). The few that
+Most classic sculpting keys and gestures work in SculptForge with the [Classic sculpting keys](#classic-sculpting-keys). The few that
differ even then, because the feature works differently or doesn't exist yet:
-| ZBrush | SculptForge |
+| Classic key | SculptForge |
|---|---|
| <kbd>P</kbd> (perspective) | <kbd>P</kbd> is the Paint brush; <kbd>Numpad 5</kbd> switches to an orthographic view |
| <kbd>T</kbd> (Edit mode) | Always in Edit mode: there is no 2.5D canvas |
| <kbd>W</kbd> / <kbd>E</kbd> / <kbd>R</kbd> (Transpose line) | The Gizmo (see [Gizmo](gizmo.md)) |
| <kbd>1</kbd>, <kbd>2</kbd>, <kbd>3</kbd> (replay and record strokes) | Not yet |
-| <kbd>N</kbd> (list the SubTools) | **Tool > Parts** in the right tray |
+| <kbd>N</kbd> (list the Parts) | **Tool > Parts** in the right tray |
| <kbd>F1</kbd> to <kbd>F6</kbd> (pop-ups) | <kbd>F1</kbd> is the Controls window, <kbd>F3</kbd> the command palette; <kbd>B</kbd>, <kbd>M</kbd> and the left-shelf tiles pop up brushes, strokes, alphas and materials |
-| <kbd>Ctrl</kbd>+<kbd>E</kbd> (edge loop), <kbd>Ctrl</kbd>+<kbd>U</kbd> (reload ZScript) | Export GLB and Send to Unreal |
-| <kbd>H</kbd> (hide the ZScript window) | <kbd>`</kbd> toggles the console |
+| <kbd>Ctrl</kbd>+<kbd>E</kbd> (edge loop), <kbd>Ctrl</kbd>+<kbd>U</kbd> (reload script) | Export GLB and Send to Unreal |
+| <kbd>H</kbd> (hide the script window) | <kbd>`</kbd> toggles the console |
-See [Coming from ZBrush](coming-from-zbrush.md) for the whole list.
+See [Quick tour for experienced sculptors](quick-tour.md) for the whole list.
## See also
diff --git a/docs/guide/studios.md b/docs/guide/studios.md
index e76b36e3..f6b15d67 100644
--- a/docs/guide/studios.md
+++ b/docs/guide/studios.md
@@ -123,7 +123,7 @@ A `--set` variable replaces a whole value, so pass complete paths (with their ex
| 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) | |
-| Send to ZBrush (GoZ-compatible exchange) | Yes | Yes | Face Groups, mask, vertex paint, UVs |
+| 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`.
@@ -175,7 +175,7 @@ Studios can ask for their own content, made to order:
- **Brushes** tuned to your style.
- **Alphas and VDMs** made from your own references or scans (only material you own).
- **Macros** and one-click workflows.
-- **Pipeline presets:** export settings, naming, scale, axis, texture packing and ZBrush Bridge setup.
+- **Pipeline presets:** export settings, naming, scale, axis, texture packing and Bridge setup.
- **Keymaps and layouts.**
All of it is baked into your custom studio build. Up to 5 custom items a month (brushes, alphas, macros or
@@ -187,8 +187,7 @@ for anything else.
Send, in one email or a message in your team channel:
- **What to bake in:** your exported keymap and layout (**Edit > Preferences > Interface**), brush presets and packs
- (`.sfbrush`, `.sfpack`), shelf setup, and the pipeline defaults you want (export format and preset, units
- and scale, up axis, naming pattern, texture packing, ZBrush Bridge folder).
+ (`.sfbrush`, `.sfpack`), shelf setup, 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.
@@ -212,7 +211,7 @@ requests are welcome as issues on the project's GitHub page.
## See also
- [Scripting and automation](scripting.md)
-- [Exporting, Send to Unreal and ZBrush](exporting.md)
+- [Exporting, Unreal and Bridge](exporting.md)
- [Brush Lab and sharing brushes](brush-lab.md)
- [Image and text to 3D](generate-3d.md): running models on your own ComfyUI server
- [Troubleshooting](troubleshooting.md)
diff --git a/docs/guide/subdivision-levels.md b/docs/guide/subdivision-levels.md
index dbacba7a..fdba7fd5 100644
--- a/docs/guide/subdivision-levels.md
+++ b/docs/guide/subdivision-levels.md
@@ -1,6 +1,6 @@
# Subdivision levels
-Subdivision levels let you sculpt one model at several resolutions, as with ZBrush's **SDiv**: block in the big
+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.
@@ -30,7 +30,7 @@ can step back down at any time.
- **Quads stay quads.** A mesh with quads is divided with Catmull-Clark subdivision: each quad becomes four
quads, and a triangle among them becomes three quads. A mesh of triangles only (a sphere from **New Sphere**,
a scan) is divided with Loop subdivision: each triangle becomes four.
-- **Smt** (next to Divide) smooths the new level, rounding off the shape the way ZBrush does. Turn it off to
+- **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
@@ -86,10 +86,9 @@ one dense mesh. **Reconstruct Subdiv** finds the mesh it was subdivided from and
keeping the dense mesh exactly as it was. Press it again for more levels.
- It works at the lowest level (SDiv 1).
-- The mesh must be a regular subdivision: all quads from Catmull-Clark subdivision (Blender's Subdivision
- Surface, Maya's Smooth, ZBrush's Divide), or all triangles from Loop subdivision. Otherwise it says so and
+- 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, as in ZBrush.
+- 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.
@@ -103,14 +102,14 @@ keeping the dense mesh exactly as it was. Press it again for more levels.
- **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 Send to ZBrush** write the current level. To write another one, step to it first, or use the
+- **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)*. <kbd>Ctrl</kbd>+<kbd>Z</kbd> brings every level back,
- at the level you were on. Merging and splitting Parts can't be undone (as in ZBrush), so step to the level
+ 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** (in **Tool > Geometry**, below Divide) is still there: it replaces the mesh with a
@@ -148,9 +147,6 @@ high level (the usual rhythm) is instant. Only the active Part keeps them: selec
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.
-> **ZBrush:** Divide, Smt, Lower Res, Higher Res, SDiv, Del Lower, Del Higher and Reconstruct Subdiv work as in
-> ZBrush. Not yet: Freeze SubDivision Levels, Cage, Rstr, Suv (UV smoothing on divide) and creased edges.
-
## Past the highest level
For more detail than the computer can hold as a mesh (hundreds of millions of polygons), add a micro level on
diff --git a/docs/guide/texture-painting.md b/docs/guide/texture-painting.md
index 7f52f236..d429419f 100644
--- a/docs/guide/texture-painting.md
+++ b/docs/guide/texture-painting.md
@@ -25,7 +25,7 @@ by hand, with more choices.
2. 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 (from ZBrush, Maya, Blender...) already have them: skip this step.
+ with UVs already have them: skip this step.
3. 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.
@@ -100,7 +100,7 @@ texture after giving it UVs.
- Projects (`.sfproj`) save the texture with all its layers, blend modes and settings.
- Exporting the model writes the texture next to it as a PNG and references it, so other apps pick it up:
OBJ writes a `.mtl` material with `map_Kd`; glTF/GLB embeds it as the base colour texture; USD binds a preview
- material that reads it; FBX and GoZ-compatible export write the PNG beside the file. See [Exporting](exporting.md).
+ material that reads it; FBX and Bridge export write the PNG beside the file. See [Exporting](exporting.md).
- **Delete Texture** removes it (undoable); painting goes back to the vertices.
## UVs and geometry
@@ -128,10 +128,6 @@ texture after giving it UVs.
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](uv-editor.md) lays them out.
-> **ZBrush:** ZBrush paints polypaint and converts it to a texture afterwards (**Texture Map > New From
-> Polypaint**). SculptForge can do both: paint the texture directly, or bake vertex paint with **Vertex Paint >
-> Texture**. **Auto UV** plays the part of UV Master's Unwrap.
-
## Scripting
| Command | What it does |
diff --git a/docs/guide/troubleshooting.md b/docs/guide/troubleshooting.md
index 0cf05e0c..11b1c192 100644
--- a/docs/guide/troubleshooting.md
+++ b/docs/guide/troubleshooting.md
@@ -15,7 +15,7 @@ Quick answers:
| Menus or shelves look wrong after an update | **Edit > Preferences > Config > Restore Standard UI** ([Reset the interface](#reset-the-interface)) |
| Sculpting feels slow | [The viewport is slow](#the-viewport-is-slow) |
| Lost work after a crash | [Recovering work after a crash](#recovering-work-after-a-crash) |
-| Want the ZBrush layout back | **Edit > Preferences > Interface > Look > Layout > ZBrush-style** |
+| Want the Classic layout back | **Edit > Preferences > Interface > Look > Layout > Classic** |
## SculptForge doesn't start
@@ -175,7 +175,7 @@ font DPI (Xft.dpi); if Automatic looks wrong there, pick a size.
### My layout or shortcuts are gone after a restart
-Like ZBrush, SculptForge never saves the layout on its own. Press **Store Config**
+SculptForge never saves the layout on its own. Press **Store Config**
(<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd>) to keep the current layout, shortcuts and interface
preferences. See [The interface](interface.md).
@@ -251,18 +251,16 @@ work?". **Restore** opens it as unsaved work (save it under a name); **Discard**
## Frequently asked questions
-**Can SculptForge open ZBrush files (.ZTL, .ZPR)?**
-Not directly: they are proprietary and undocumented. Convert ZTools once in ZBrush with the free
-**SculptForge ZTL Export** plug-in, then open the `.ZTL` in SculptForge (see
-[Coming from ZBrush](coming-from-zbrush.md#bring-your-ztools-over)). Or use Send to ZBrush, or export OBJ or FBX from ZBrush
-(see [Exporting, Send to Unreal and ZBrush](exporting.md#exchange-models-with-zbrush-send-to-zbrush)). `.ZPR` projects can't be
-converted; open their ZTools instead.
+**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, use the
+[Bridge](exporting.md#exchange-models-through-the-bridge), or convert a whole library once with the free Bridge
+export plug-in (see the [Bridge setup page](https://github.com/islandmed/SculptForge/blob/main/integrations/bridge-plugin/README.md)).
-**Does it have subdivision levels, DynaMesh, ZRemesher or UVs?**
-Voxel remesh works like DynaMesh, **Quad Remesh** like ZRemesher (with **Project All** to bring the detail back; see
+**Does it have subdivision levels, voxel remesh, quad remesh or UVs?**
+Yes: **Voxel Remesh**, **Quad Remesh** (with **Project All** to bring the detail back; see
[Quad retopology](retopology.md)), **Auto UV** unwraps any model, and Divide adds subdivision levels you can
step up and down (see [Subdivision levels](subdivision-levels.md)). **Dynamic** on the top shelf is dynamic
-topology, like Sculptris Pro (see [Dynamic topology](dynamic-topology.md)).
+topology, like dynamic topology (see [Dynamic topology](dynamic-topology.md)).
**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.
diff --git a/docs/guide/uv-editor.md b/docs/guide/uv-editor.md
index 5eb39e29..880c5e8d 100644
--- a/docs/guide/uv-editor.md
+++ b/docs/guide/uv-editor.md
@@ -171,7 +171,7 @@ commands work on the whole Part.
| `uv_info` | Islands, seams, pins, texel density, the UDIM tiles in use and the mean stretch |
```
-uv_seam op=polygroups
+uv_seam op=face groups
uv_unwrap method=isometric
uv_pack tiles=2 margin=8
uv_density op=match
@@ -185,7 +185,7 @@ uv_info
- 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).
-> **Coming from ZBrush?** The UV Editor does what ZBrush 2027's UV editing and UV Master do: seams on the model,
+> **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.
diff --git a/docs/guide/vertex-paint.md b/docs/guide/vertex-paint.md
index 03b6fd16..8e04db85 100644
--- a/docs/guide/vertex-paint.md
+++ b/docs/guide/vertex-paint.md
@@ -1,6 +1,6 @@
# Vertex Paint and materials
-Vertex Paint (ZBrush users: Polypaint) stores a colour on every vertex of the mesh, so you can paint a sculpt
+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.
@@ -13,7 +13,7 @@ paint layers with blend modes, and the Lit Sphere materials that change how the
[hidden faces](face-groups.md).
- 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 GoZ-compatible files. FBX export doesn't include it.
+ (`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
@@ -29,15 +29,12 @@ paint layers with blend modes, and the Lit Sphere materials that change how the
While the Paint brush is active:
- <kbd>Alt</kbd> paints back towards white.
-- <kbd>Shift</kbd> still smooths the shape, as in ZBrush.
+- <kbd>Shift</kbd> still smooths the shape.
- The surface isn't changed.
Press <kbd>P</kbd> again, or click **Sculpt** on the top shelf, to go back to sculpting.
-![Vertex Paint on a sculpt with the Paint menu open](images/polypaint.jpg)
-
-> **ZBrush:** **Paint** is ZBrush's Rgb on with Zadd off. **Sculpt** with **Rgb** on is Rgb with Zadd: the brush
-> sculpts and paints at once.
+![Vertex Paint on a sculpt with the Paint menu open](images/vertex-paint.jpg)
## Paint while sculpting
@@ -47,7 +44,7 @@ paints the current colour along its stroke. The Smooth brush and <kbd>Shift</kbd
## Choose a colour
- The **left shelf** has a colour picker (a square plus a hue strip), two swatches and a **Fill** button. Clicking
- the second swatch swaps it with the main colour, like ZBrush's Alternate.
+ the second swatch swaps it with the main colour.
- 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 <kbd>C</kbd> with the cursor over the model to pick the colour under it (the mesh needs vertex paint for this,
@@ -145,15 +142,12 @@ way round, so a stroke with **Rgb** on can sculpt into the "Smile" layer and pai
- Paint layers are saved in projects (`.sfproj`) with their names, blend modes, opacity, visibility, lock and the
active layer. Older versions of SculptForge open these projects with the paint flattened.
-- Exports (OBJ, PLY, glTF/GLB, USD, GoZ-compatible) write the composited colours, exactly what the viewport shows.
+- Exports (OBJ, PLY, glTF/GLB, USD, Bridge) write the composited colours, exactly what the viewport shows.
- [Duplicating](parts.md) a Part copies its layers, and [Split](parts.md#split-a-part) keeps them on each piece.
[Subdividing](geometry.md#subdivide) and [decimating](geometry.md#decimate) keep them too.
- [Merging](parts.md#merge-parts) Parts, a [voxel remesh](geometry.md#voxel-remesh) and other rebuilds keep the look but
flatten the layers into Base.
-> **ZBrush and Mudbox:** ZBrush's polypaint layers only have opacity. Here every layer also has a blend mode, its
-> own coverage and a lock, like the paint layers in Mudbox and Photoshop.
-
## Materials (Lit Spheres)
Materials change only how the model is shaded in the viewport. They aren't exported and don't change vertex paint.
@@ -183,7 +177,7 @@ Vertex Paint multiplies the material, and cavity shading stays on with every mat
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, as in ZBrush, so you can try a skin, stone or bronze tone without
+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.
@@ -194,22 +188,22 @@ PBR shading uses the material channels and is not tinted. Saved with the project
### Your own Lit Spheres
A Lit Sphere is a picture of a lit sphere (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 made for ZBrush, Blender or Nomad works: a square PNG, JPG or EXR
+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 **MatCaps** folder of your library (**Documents/SculptForge/MatCaps**, or the
+ 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 **MatCaps** folder yourself: they show up the next time you open the material picker,
+- 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_MATCAP_PATH` environment variable (separated by `:`, `;` on Windows); those load
when SculptForge starts.
- To remove one, right-click it in the material picker or palette and choose **Remove**. An image from your
- MatCaps folder goes to the trash (the Recycle Bin on Windows), so you can still get it back. On macOS it is
+ 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](images/custom-matcaps.jpg)
+![A Lit Sphere loaded from an image (Gold) in Render > Materials](images/custom-lit-spheres.jpg)
Your Lit Spheres appear in the material picker (<kbd>M</kbd>), **Render > Materials** and the Library, after the
built-in ones. A project that uses one carries a copy of the image, so it opens with the same look on another
@@ -234,7 +228,7 @@ Shading works with every material, vertex paint, textures and the mask. Like the
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 once you
**Store Config** (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd>). Smooth and Flat have no default shortcut, so no
-ZBrush key changes meaning; assign one under **Edit > Preferences > Hotkeys** if you switch often.
+classic key changes meaning; assign one under **Edit > Preferences > Hotkeys** if you switch often.
> **Not yet:** loading your own Lit Sphere images, and physically based materials or BPR-style renders.
@@ -254,8 +248,8 @@ ZBrush key changes meaning; assign one under **Edit > Preferences > Hotkeys** if
| `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_matcap path=gold.png` | Load a Lit Sphere image and use it; `keep=false` doesn't copy it into the MatCaps folder (desktop app only) |
-| `remove_matcap name=Gold` | Remove one of your Lit Spheres; its image in the MatCaps folder goes to the trash (desktop app only) |
+| `load_matcap 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) |
+| `remove_matcap 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](interface.md#the-background) (desktop app only) |
| `set_shading mode=flat` | The scene's shading: `smooth` (the default) or `flat` (desktop app only) |
| `subtool_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) |
diff --git a/docs/guide/welcome.md b/docs/guide/welcome.md
index 3edb4e84..dab30cac 100644
--- a/docs/guide/welcome.md
+++ b/docs/guide/welcome.md
@@ -5,13 +5,13 @@ explains what it is, what it can and can't do yet, and how the rest of this guid
## What SculptForge is
-SculptForge is a focused sculpting tool with the brushes, symmetry, masking and navigation that ZBrush artists
+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 ZBrush-style layout with alphabetical
+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. ZBrush's keys and gestures are one choice away: answer
-**ZBrush** when the first start asks what you are coming from, or pick **ZBrush-style** in **Edit > Preferences > Input**.
-See [Coming from ZBrush](coming-from-zbrush.md). There is no account, no subscription, no licence server
+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](quick-tour.md). 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:
@@ -35,7 +35,7 @@ of the canvas, once, and never again after you close it.
- **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](brush-lab.md).
-- **Mask, group and hide** parts of the model the ZBrush way: Ctrl to paint a mask, Ctrl+Shift to isolate a
+- **Mask, group and hide** parts of the model: Ctrl to paint a mask, Ctrl+Shift to isolate a
face group. See [Masking](masking.md) and [Face Groups and visibility](face-groups.md).
- **Keep separate meshes** as Parts (body, eyes, teeth, armour), each with its own undo history. See
[Parts](parts.md).
@@ -43,44 +43,44 @@ of the canvas, once, and never again after you close it.
[Vertex Paint and materials](vertex-paint.md).
- **Sculpt layers** that double as blend shapes (morph targets), with live weights. See [Sculpt layers and
blend shapes](layers.md).
-- **Rebuild the mesh**: Loop subdivision, voxel remesh (similar to DynaMesh), decimation and one-click LOD
+- **Rebuild the mesh**: Loop subdivision, voxel remesh (similar to voxel remesh), decimation and one-click LOD
chains. See [Subdivide, remesh, decimate and LODs](geometry.md).
- **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](generate-3d.md).
- **Work with Gaussian splats** from phone captures: sculpt against them or turn them into meshes. See
[Gaussian splats](splats.md).
- **Export** to glTF/GLB, FBX, OpenUSD, OBJ, STL and PLY, send models straight into Unreal Engine, and
- exchange them with ZBrush through Send to ZBrush (GoZ-compatible exchange). See [Exporting, Unreal and ZBrush](exporting.md).
+ exchange them with another sculpting app through the Bridge. See [Exporting, Unreal and Bridge](exporting.md).
- **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](scripting.md).
## What it doesn't do yet
-SculptForge is young (version 0.10; see [What's new](whats-new.md)). Some things ZBrush artists rely on are
+SculptForge is young (version 0.10; see [What's new](whats-new.md)). Some things experienced sculptors rely on are
still on the roadmap:
- Painting across UDIM tiles (the [UV Editor](uv-editor.md) lays them out; painting covers tile 1001).
- Booleans and stencils.
-Others are not on the roadmap: ZModeler, the 2.5D canvas, and reading ZBrush's own `.ZTL` and `.ZPR`
-files directly (bring models over with Send to ZBrush, the ZTL Export plug-in for ZBrush, or as OBJ, FBX or GLB).
+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 ZBrush feature SculptForge doesn't have, it says so in a callout
+> **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.
-## Coming from ZBrush
+## Quick tour for experienced sculptors
-Most habits carry over, and **Edit > Preferences > Interface > Look > Layout > ZBrush-style** brings back the
+Most habits carry over, and **Edit > Preferences > Interface > Look > Layout > Classic** brings back the
alphabetical palette bar. You sculpt with a left drag, hold <kbd>Alt</kbd> to subtract and <kbd>Shift</kbd> to
smooth, drag on the background to rotate, <kbd>Alt</kbd>+drag to pan, and hold <kbd>Ctrl</kbd> to mask. The
palettes have the names you expect (Alpha, Brush, Stroke, Tool, Transform...), the Tool palette holds the
-Parts (ZBrush's SubTool), Masking and Face Groups (Polygroups) sub-palettes, <kbd>B</kbd> opens the brush pop-up with the same letter keys
+Parts, Masking and Face Groups sub-palettes, <kbd>B</kbd> opens the brush pop-up with the same letter keys
(B, S, T picks Standard), <kbd>,</kbd> opens the Library and <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd>
stores your interface, and <kbd>S</kbd> <kbd>U</kbd> <kbd>I</kbd> <kbd>O</kbd>, <kbd>Space</kbd>, <kbd>Ctrl</kbd>+<kbd>W</kbd>
-and the mask keys do what your hands expect with the ZBrush-style keys on (**Edit > Preferences > Input**).
-[Coming from ZBrush](coming-from-zbrush.md) lists SculptForge's names for ZBrush terms, what is the same,
-what differs and every shortcut side by side; the [Glossary](glossary.md) maps ZBrush terms to SculptForge ones.
+and the mask keys do what your hands expect with the Classic sculpting keys on (**Edit > Preferences > Input**).
+[Quick tour for experienced sculptors](quick-tour.md) lists what is the same,
+what differs and every shortcut side by side; the [Glossary](glossary.md) explains SculptForge's terms.
## How this guide is organised
diff --git a/docs/guide/whats-new.md b/docs/guide/whats-new.md
index 1857d9d8..ce9bd3f3 100644
--- a/docs/guide/whats-new.md
+++ b/docs/guide/whats-new.md
@@ -233,7 +233,7 @@ link: performance.md#proof-mode-see-it-for-yourself
- **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**. Coming from ZBrush? **Preferences > Interface > Look > ZBrush-style layout** (or the button in
+ **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](interface.md#looks-and-layouts).
- **Native Wayland on Linux**: every Linux package opens without XWayland, stays sharp at fractional scales and
@@ -363,11 +363,9 @@ link: uv-editor.md
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, Send to ZBrush, Snapshot...); searching for ZBrush terms still finds them, and MatCaps are now Lit
- Spheres. The table is in [Coming from ZBrush](coming-from-zbrush.md#zbrush-terms-in-sculptforge).
-- **New installs start with the SculptForge keys**, and the first start asks what you are coming from (ZBrush,
- Blender, Maya or new to sculpting) to pick the key style. Your saved style is kept; ZBrush's keys are
- **ZBrush-style** in **Preferences > Input**. See [Keyboard and mouse](shortcuts.md#zbrush-style-keys).
+ Quad Remesh, Bridge, Snapshot...); the command palette finds them by what they do. See [Quick tour for experienced sculptors](quick-tour.md).
+- **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](shortcuts.md#classic-sculpting-keys).
### From your requests on GitHub
@@ -553,7 +551,7 @@ are placed. See [Performance](performance.md).
### Right click for the Quick Menu
-A right click on the canvas opens the Quick Menu under the cursor, as in ZBrush (Space still does too). A right
+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](sculpting.md#the-quick-menu).
@@ -626,7 +624,7 @@ highlight: SpaceMouse: turn, pan and zoom with a 3Dconnexion SpaceMouse (experim
### Forge Spheres
-Block out a body, creature or plant from connected spheres, the ZBrush way: **Tool > Forge Spheres > New Forge Sphere**,
+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** (<kbd>A</kbd>) 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](forge-spheres.md).
@@ -655,7 +653,7 @@ rotation, a dominant-axis mode, inverts any axis, and maps the buttons. It reads
### Your own Lit Spheres
**Material > Load Lit Sphere...** turns any image (PNG, JPG or EXR) into a material, and images you put in
-**Documents/SculptForge/MatCaps** show up in the material list, even while SculptForge is running. Right-click one
+**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](vertex-paint.md#your-own-lit-spheres).
@@ -797,11 +795,11 @@ character's facial shapes with your own face, live. No app to install. See [Phon
date: 2026-10-25
```
-Fixes from a ZBrush artist's testing, and a way to bring your ZTools over.
+Fixes from a professional sculptor's testing, and a way to bring a library over.
-### More like ZBrush
+### More classic
-- **ZBrush zoom direction.** With the ZBrush input style, dragging up zooms out on every zoom drag, as in ZBrush.
+- **Classic zoom direction.** With the Classic input style, dragging up zooms out on every zoom drag.
See [Navigation](navigation.md).
- **Ctrl and Ctrl+Shift brushes.** Hold <kbd>Ctrl</kbd> and the left shelf shows the mask brush; with
<kbd>Ctrl</kbd> held the Brush and Stroke pickers pick Mask Pen, Mask Lasso or Mask Rectangle. <kbd>Ctrl</kbd>+<kbd>Shift</kbd>
@@ -815,11 +813,11 @@ palette: click it and SculptForge unwraps the model if it has no UVs (Auto UV, i
texture, so the next stroke paints texels. Big brushes on 4K textures paint four to five times faster. See
[Texture painting](texture-painting.md).
-### Bring your ZTools over
+### Bring a library over
-ZBrush's `.ZTL` files are proprietary, but a free plug-in for ZBrush now converts them once, and then
-SculptForge opens the `.ZTL` itself, every Part with its face groups, vertex paint, mask and UVs. See
-[Coming from ZBrush](coming-from-zbrush.md#bring-your-ztools-over).
+Another app's library files are proprietary, but a free export plug-in now converts them once, and then
+SculptForge opens the library file itself, every Part with its face groups, vertex paint, mask and UVs. See
+the [Bridge setup page](https://github.com/islandmed/SculptForge/blob/main/integrations/bridge-plugin/README.md).
## Version 0.8
@@ -832,7 +830,7 @@ highlight: Quad Remesh Guides: draw the edge loops you want
Dynamic topology, vector displacement brushes, Quad Remesh Guides, and sculpt layers on every subdivision level.
-### Dynamic topology (Sculptris Pro)
+### Dynamic topology
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.
@@ -848,16 +846,16 @@ Ear Curl, Scales, Nostril); make your own by sculpting on a **VDM Plane** and cl
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](sculpting.md#vector-displacement-brushes).
-### ZBrush keys in Blender's Sculpt Mode
+### Classic sculpting keys in Blender's Sculpt Mode
-The Blender add-on has a new preference, **ZBrush-style keys in Sculpt Mode**: S, U and O for Draw Size,
-Strength and Falloff, B for the brushes by their ZBrush names, Space for the quick menu, Alt to dig in,
+The Blender add-on has a new preference, **The Classic sculpting keys in Sculpt Mode**: S, U and O for Draw 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](blender.md#zbrush-style-keys-in-sculpt-mode).
+[Working with Blender](blender.md#classic-sculpting-keys-in-sculpt-mode).
### Draw the edge loops you want
-**Quad Remesh Guides** work like ZBrush's ZRemesher Guides brush: draw curves on the sculpt, around the eyes, the mouth or a
+**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
@@ -865,7 +863,7 @@ around a curve the flow follows it. Guides are kept with each Part and saved in
### Sculpt layers on every subdivision level
-Sculpt layers now have a guide section on how they work with subdivision levels, like ZBrush's 3D Layers: record
+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](layers.md#layers-and-subdivision-levels).
@@ -876,27 +874,27 @@ date: 2026-10-25
highlight: Blender bridge: send models between Blender and SculptForge in one click
```
-ZBrush's keys and gestures by default, and a bridge that sends models between Blender and SculptForge.
+The Classic sculpting keys and gestures by default, and a bridge that sends models between Blender and SculptForge.
-### Your ZBrush hands just work
+### Your hands just work
-SculptForge now follows ZBrush's keys and gestures by default. A ZBrush sculptor tried an earlier version and
-put it down because it didn't feel like ZBrush; this release goes through every habit of the first hour.
-[Coming from ZBrush](coming-from-zbrush.md) lists what's the same, what's different and every shortcut side by
+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](quick-tour.md) lists what's the same, what's different and every shortcut side by
side.
- **S, U, I, O** open Draw Size, Intensity, RGB Intensity and Falloff under the cursor, and
<kbd>Space</kbd> 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. **RGB Intensity** gives painting a
strength of its own, and **Smooth keeps its own Intensity**, so a gentle brush still smooths properly.
-- **ZBrush's brush letters**: B C B Clay Block, B D S Sharp Crease, B M V Move, B I N Inflate...
+- **brush letters**: B C B Clay Block, B D S Sharp Crease, B M V Move, B I N Inflate...
- **Masking**: <kbd>Ctrl</kbd>+click the model blurs the mask, <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+click sharpens it;
<kbd>Ctrl</kbd>+<kbd>A</kbd>, <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>A</kbd>, <kbd>Ctrl</kbd>+<kbd>I</kbd>,
- <kbd>Ctrl</kbd>+<kbd>H</kbd> and <kbd>Ctrl</kbd>+<kbd>W</kbd> (group masked) work as in ZBrush.
+ <kbd>Ctrl</kbd>+<kbd>H</kbd> and <kbd>Ctrl</kbd>+<kbd>W</kbd> (group masked) work.
- **Strokes and the view**: <kbd>Shift</kbd> pressed mid-stroke draws a straight line; <kbd>Shift</kbd>+click,
let go and drag rolls the view; <kbd>Shift</kbd>+<kbd>Alt</kbd>+click frames a Part; <kbd>L</kbd> toggles
Lazy Stroke and <kbd>V</kbd> swaps colours.
-- **Visibility**: <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+click on a partly hidden mesh hides the group, as in ZBrush.
+- **Visibility**: <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+click on a partly hidden mesh hides the group.
- **Prefer the old keys?** **Preferences > Input > Style > SculptForge** brings back the number keys for brushes,
<kbd>I</kbd> for Intensity and the <kbd>Ctrl</kbd>+drag zoom.
@@ -983,12 +981,12 @@ highlight: Map baking: normal, displacement and AO maps for game engines and ren
highlight: Gizmo: move, scale, rotate and pose the unmasked part
```
-The ZBrush workflow core: subdivision levels, quad retopology, map baking, the Gizmo, and speed at tens of
+The sculpting workflow core: subdivision levels, quad retopology, map baking, the Gizmo, and speed at tens of
millions of polygons.
### Subdivision levels
-Sculpt one model at several resolutions, as with ZBrush's SDiv: big forms low, fine detail high, and back down
+Sculpt one model at several resolutions: big forms low, fine detail high, and back down
without losing anything.
- **Divide** (<kbd>Ctrl</kbd>+<kbd>D</kbd>) adds a level and keeps the ones below. Quads stay quads
@@ -1007,7 +1005,7 @@ See [Subdivision levels](subdivision-levels.md).
### Gizmo: move, scale, rotate and pose
-ZBrush's Gizmo 3D, with the same keys: <kbd>W</kbd> Move, <kbd>E</kbd> Scale, <kbd>R</kbd> Rotate, <kbd>Q</kbd>
+Gizmo 3D, with the same keys: <kbd>W</kbd> Move, <kbd>E</kbd> Scale, <kbd>R</kbd> Rotate, <kbd>Q</kbd>
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
@@ -1020,7 +1018,7 @@ back to Draw (also on the top shelf and in the **Transform** palette).
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.
-<kbd>W</kbd> no longer toggles the wireframe: use <kbd>Shift</kbd>+<kbd>F</kbd> (as in ZBrush) or **Wire** on the
+<kbd>W</kbd> no longer toggles the wireframe: use <kbd>Shift</kbd>+<kbd>F</kbd> or **Wire** on the
right shelf. See [Moving, rotating and posing](gizmo.md).
### Normal, displacement and AO map baking
@@ -1034,7 +1032,7 @@ Bake the detail of a high-poly sculpt into maps on a low-poly's UVs, for game en
do; pick the OpenGL or DirectX green convention.
- **Check it on the model.** The low-poly shows its baked normal map in the viewport as soon as the bake ends,
next to the high-poly.
-- **ZBrush-style controls**: source Part, 1K-8K, anti-aliasing, automatic or manual front and rear ray
+- **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.
@@ -1043,9 +1041,9 @@ See [Baking normal and displacement maps](baking.md).
### Quad retopology and detail projection
-- **Quad Remesh** (**Tool > Geometry**, like ZRemesher) rebuilds a sculpt as clean quads whose edge loops follow
+- **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 as in ZBrush.
+ **Use Vertex Paint**, **Symmetry** and **Half / Same / Double** work.
- **Project All** (**Tool > Parts > Project**) puts the sculpted detail and vertex paint back onto the divided
quads, with **Dist**, **Mean** and **PA Blur**, and respects the mask.
@@ -1113,7 +1111,7 @@ the mesh: sharp decals, pores and freckles on a light game mesh.
- **The same paint layers.** **Tool > Paint Layers** works on the texture's layers: blend modes, opacity,
merge, flatten, all undoable.
- **Convert both ways**, **Show UVs**, **Import / Export Texture** (PNG). Projects save textures and their
- layers, and model exports write the texture next to the model (OBJ `.mtl`, glTF, USD, FBX, GoZ-compatible files).
+ layers, and model exports write the texture next to the model (OBJ `.mtl`, glTF, USD, FBX, Bridge files).
See [Texture painting](texture-painting.md).
@@ -1134,17 +1132,17 @@ send extra mouse movements beside the pen's; now, while the pen is in range, onl
date: 2026-10-22
```
-Version 0.4 is about making SculptForge feel like home to ZBrush artists. It was shaped by feedback from a
-working ZBrush modeler and by what sculptors say on the ZBrush and Mudbox forums.
+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.
-### Navigation that works like ZBrush
+### Classic navigation
- **Free rotation.** Dragging turns the model the way the cursor moves and can roll it right over the top,
- as in ZBrush. If you prefer the model to stay upright, set **Preferences > Interface > Rotation** to
+ . If you prefer the model to stay upright, set **Preferences > Interface > Rotation** to
**Turntable**.
- **Snap to a view.** Hold <kbd>Shift</kbd> while rotating to snap to the nearest front, back, side, top or
bottom view.
-- **ZBrush zoom.** <kbd>Alt</kbd>+drag on the background pans; let go of <kbd>Alt</kbd> while still dragging
+- **Classic zoom.** <kbd>Alt</kbd>+drag on the background pans; let go of <kbd>Alt</kbd> while still dragging
and the rest of the drag zooms. With the right mouse button, <kbd>Alt</kbd> pans and <kbd>Ctrl</kbd> zooms.
See [Navigating the view](navigation.md).
@@ -1169,17 +1167,16 @@ material picker (<kbd>M</kbd>), and projects keep the material they were saved w
### Quads stay quads
-Models you bring in from ZBrush (Send to ZBrush) or as OBJ, FBX, PLY or USD keep their quads: **Wire** shows them as
+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 DynaMesh), and new cubes and planes are made of quads. See
+an even grid of quads (like voxel remesh), and new cubes and planes are made of quads. See
[Quads and triangles](geometry.md#quads-and-triangles).
### Paint layers
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. ZBrush has
-never had this. Find it in **Tool > Paint Layers**, and see [Paint layers](vertex-paint.md#paint-layers).
+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](vertex-paint.md#paint-layers).
![The Paint Layers sub-palette with three layers and their blend modes](images/paint-layers.jpg)
@@ -1196,7 +1193,7 @@ date: 2026-10-22
- **Parts**: several separate meshes in one scene. Append, duplicate, split, merge, solo, and
<kbd>Alt</kbd>+click to select. See [Parts](parts.md).
-- **A ZBrush-style interface**: shelves around the canvas, alphabetical palettes, the Library
+- **A classic interface**: shelves around the canvas, alphabetical palettes, the Library
(<kbd>,</kbd>), the brush, stroke, alpha and material pickers, hold-<kbd>Ctrl</kbd> help on every control
and a command palette (<kbd>F3</kbd>). See [The interface](interface.md).
- **Graphics tablets**: pen pressure, the eraser end and pen buttons. See [Sculpting and brushes](sculpting.md).
@@ -1215,7 +1212,7 @@ date: 2026-10-21
[vertex paint with Lit Spheres](vertex-paint.md).
- New brushes: Sharp Crease, Clay Block, Tendril, Trim, Layer and Nudge, with strokes and alphas.
- [Project files](projects.md) with autosave, recent files and snapshots, and
- [exchange with ZBrush (Send to ZBrush)](exporting.md).
+ [exchange with the other app (Bridge)](exporting.md).
## Version 0.1
diff --git a/docs/images/social-preview.png b/docs/images/social-preview.png
index 91c44d3d..46bc3d00 100644
Binary files a/docs/images/social-preview.png and b/docs/images/social-preview.png differ
diff --git a/docs/legal/trademarks.md b/docs/legal/trademarks.md
new file mode 100644
index 00000000..7b108a8b
--- /dev/null
+++ b/docs/legal/trademarks.md
@@ -0,0 +1,41 @@
+# Trademarks: how SculptForge names things
+
+SculptForge uses its own names for its own features, and never another company's marks in its own copy.
+`tools/check_marks.py` (ctest `marks`) enforces this on every file in the repository.
+
+## The rules
+
+1. **No third-party sculpting-app marks in anything we publish:** the app (menus, tooltips, commands, dialogs,
+ brush, alpha and material names), the user guide, the website (including titles, meta and social tags and
+ preview images), README, CHANGELOG and release notes, store listings (AUR, Homebrew, winget, Flatpak, Omarchy),
+ and Discord, YouTube and outreach templates. That includes the product names themselves and their feature
+ names. The patterns are in `tools/check_marks.py`.
+2. **Describe by function.** Our names: Forge Spheres, Lit Sphere, Part, Face group, Library, Vertex Paint, Bridge,
+ Classic sculpting keys, Classic layout, voxel remesh, Quad Remesh, dynamic topology, Sharp Crease, Clay Block,
+ Tendril, Plane Trim. A feature someone knows from another app is found in the command palette by what it does.
+3. **No comparison copy.** Never "clone", "replacement", "alternative to ...", or price and feature tables against
+ other products. Video titles by others may be quoted as titles.
+4. **Never copy** another app's icons, art, documentation text, assets, brush names or SDK code; never decompile
+ it; no reader for its proprietary files; never train or test AI on its output.
+5. **Code too.** Identifiers and comments use our names. The only exceptions, each kept in one place:
+ - `src/io/BridgeProtocol.h`: the folder, file and executable names the exchange protocol needs byte for byte.
+ - `src/core/LegacyNames.h`: names older SculptForge versions wrote (projects, brush files, configs), read only
+ and mapped to today's names, never shown or written.
+ - `integrations/bridge-plugin/`: the export plug-in runs inside the other application and its setup page has to
+ name its folders and menus, with the notice below.
+6. **History stays.** Git history and tags are not rewritten. Old release pages and assets are removed after a
+ release replaces them (`tools/release/scrub_old_releases.sh`).
+
+## Adding to the allowlist
+
+Don't. `tools/marks_allow.txt` lists the three places above. `tools/marks_pending.txt` lists files still waiting
+for the code rename and only shrinks; a line marked `// marks-pending` is a script-facing value name that gets
+renamed with a read alias.
+
+## The notice
+
+The one sentence that names the other application, used on the Bridge setup page and nowhere else:
+
+ZBrush is a trademark of Maxon. SculptForge is not affiliated with or endorsed by Maxon.
+
+Elsewhere, where a page needs a notice at all: "Product names are trademarks of their respective owners."
diff --git a/docs/pack-format.md b/docs/pack-format.md
index 722b9087..4ff1eeec 100644
--- a/docs/pack-format.md
+++ b/docs/pack-format.md
@@ -114,7 +114,7 @@ Plain text in the command language of `sculptforge-cli` (`docs/guide/scripting.m
comments, optional `# name:` and `# description:` header lines. At most 64 KB and 500 commands.
- Only SculptForge's own commands, and not those that reach the network or another program (AI services, the
- brush gallery, Unreal, Blender, Maya and ZBrush exchange, splat training), install, list or remove packs, or run
+ brush gallery, Unreal, Blender, Maya and Bridge exchange, splat training), install, list or remove packs, or run
macros. Parameters naming URLs, endpoints, services or programs are refused.
- File values (`path=`, `folder=`, `file=`, `out=`, `exr=` ...) are either a path relative to the project folder,
without `..`, `~`, `$`, `%`, drive letters or a leading slash (resolved, symbolic links followed, and checked to
diff --git a/docs/performance.md b/docs/performance.md
index 43bed072..28e9d3a1 100644
--- a/docs/performance.md
+++ b/docs/performance.md
@@ -608,7 +608,7 @@ of a dab with a dense mesh is the serial search for the triangles under the brus
sculptforge --bench --bench-dyntopo --bench-sizes 0.25,1,4
```
-Spheres without subdivision levels (Sculptris Pro works on such meshes only), dynamic topology on with relative
+Spheres without subdivision levels (dynamic topology works on such meshes only), dynamic topology on with relative
detail, strokes with X symmetry. Each row starts from the same sphere. "remesh" is the dynamic topology work of a
dab (gathering the area, matching mirror images, splits, collapses, flips, relaxing, filling the freed slots,
rings and normals of what changed, BVH edits); "GPU upload" sends the clusters whose triangles changed as patches
@@ -1575,7 +1575,7 @@ Shelf and Library thumbnails differ in the UI tests only because they arrive soo
- Back faces are drawn (twice the work on huge meshes) on open meshes, with hidden polygons, when the eye is
inside the mesh's bounds or the near plane cuts it: the cases where they can show. On a closed mesh, a lobe
pushed through the surface so that it is inside out (winding below zero) would show a hole where its back
- faces are culled; ZBrush culls back faces always.
+ faces are culled.
- The proxy is coarse on a mesh with fine detail (detail under 2.5 edges disappears while moving), and the first
move after opening or dividing a big mesh waits for it (126 ms at 33M, 408 ms at 104M).
- 33M orbiting is 8.7 ms with antialiasing: what's left is 16M sub-pixel triangles a frame, which only a level
diff --git a/docs/starter-meshes.md b/docs/starter-meshes.md
index d79f1399..291410f9 100644
--- a/docs/starter-meshes.md
+++ b/docs/starter-meshes.md
@@ -6,7 +6,7 @@ embedded in the program. They open with subdivision levels added (Divide), so th
set; the budget is 15 MB, checked by `starter_meshes_set_and_budget`).
**Licensing rule:** only meshes made by our own scripts, or CC0 / public-domain sources recorded here with URL,
-licence and date. Never ZBrush assets or output, nothing scraped.
+licence and date. Never another app's assets or output, nothing scraped.
## Sources
diff --git a/docs/tablet.md b/docs/tablet.md
index 709ead62..743edb71 100644
--- a/docs/tablet.md
+++ b/docs/tablet.md
@@ -25,8 +25,7 @@ Open **Preferences > Tablet** to check the pen and tune it:
- **Tilt**: shown when the pen reports it (brushes don't use it yet).
- **Eraser** and the **side buttons**, below.
-Settings are kept with the UI configuration: **Store Config (Ctrl+Shift+I)** saves them (as in ZBrush, nothing
-is saved automatically).
+Settings are kept with the UI configuration: **Store Config (Ctrl+Shift+I)** saves them.
## Eraser and side buttons
@@ -37,7 +36,7 @@ is saved automatically).
| Upper side button | **Invert (Alt)** while held | same |
| Third button (e.g. Wacom Pro Pen 3D) | **Pan view** | same |
-The defaults follow the usual ZBrush setup: Alt on the pen to carve without reaching for the keyboard, and
+The defaults follow the usual classic setup: Alt on the pen to carve without reaching for the keyboard, and
right-click to turn the model. Invert and Smooth act exactly like holding Alt or Shift, so Alt + click on
another Part selects it and Alt + drag on the background pans. Rotate view and Pan view: hold the button
and move the pen above the tablet (or drag with the tip down).
diff --git a/docs/ui-design.md b/docs/ui-design.md
index e932dbea..4f57cf4b 100644
--- a/docs/ui-design.md
+++ b/docs/ui-design.md
@@ -13,7 +13,7 @@ Sculptors should find their way around within a minute:
- **Ctrl+hover** on any control shows its description and shortcut;
- **Customize**: Preferences > Config > Enable Customize, Ctrl+Alt+drag to move or remove items, **Store Config (Ctrl+Shift+I)**, **Restore Standard UI**.
-Not goals: free-floating or OS-level detachable panels, tabbed docking, a full keymap editor, a 2.5D canvas or pixols. These need ImGui's docking branch or aren't worth the cost (see §12).
+Not goals: free-floating or OS-level detachable panels, tabbed docking, a full keymap editor, a 2.5D canvas. These need ImGui's docking branch or aren't worth the cost (see §12).
The current UI (screenshot, 1600x960) is a menu bar (File/Edit/Mesh/View/Help) plus floating windows over a full-window viewport: Tools (250 px, left), Parts, Layers / Blend Shapes, Game Ready, Brush Lab (open by default, covers the model), and optionally Vertex Paint & Materials, Generate 3D, Gaussian Splats. All of the features stay. Only where they live changes.
@@ -46,14 +46,14 @@ All sizes are logical px at `uiScale_ = 1` and get multiplied by `uiScale_`. She
```
x:0 8 96 1240 1292 1300 1600
+-------------------------------------------------------------------------------------------------------------+ y0
- |SF SculptForge head.sfproj* | Verts 5.1k Tris 10.2k SubTool Sphere Layer Base status msg... [QS][1][2][3][Menus][? Search F3]|
+ |SF SculptForge head.sfproj* | Verts 5.1k Tris 10.2k Part Sphere Layer Base status msg... [QS][1][2][3][Menus][? Search F3]|
+-------------------------------------------------------------------------------------------------------------+ y24
|Alpha Brush Color Draw Edit File Generate Help Material Preferences Render Script Splats Stroke Tool Transform |
+--+-------------------------------------------------------------------------------------+-+-------------------+ y46
- | |[LightBox] [Sculpt|Paint] [Zadd|Zsub] [Rgb] [Draw Size 60 ====] [Strength 0.50 ====] | | Tool [x] |
+ | |[Library] [Sculpt|Paint] [Add|Sub] [Rgb] [Draw Size 60 ====] [Strength 0.50 ====] | | Tool [x] |
| |[AI Brush] [Front] [ X | Y | Z sym ] [Pressure>Str] [Pressure>Size] 5.1k / 10.2k | | Sphere 5.1k (o) |
+--+------+--------------------------------------------------------------------+---------+ | [Open][Save][Imp] |
- |d | +--+ | | [Frame] |d| > SubTool (open) |
+ |d | +--+ | | [Frame] |d| > Part (open) |
|i | |Br| | | [Move ] |i| Sphere eye |
|v | +--+ | | [Zoom ] |v| Helmet eye |
| |Clay | | [Rotat] | | [Append][Dup]...|
@@ -61,7 +61,7 @@ x:0 8 96 1240
| | |St| | CANVAS | [Floor] | | > Geometry |
| | +--+ | (3D view, gradient bg) | [PolyF] | | > Remesh |
| |Dots | 1144 x 790 | [Grps ] | | > Masking |
- | | +--+ | | [Mask ] | | > Polygroups |
+ | | +--+ | | [Mask ] | | > Face groups |
| | |Al| | | [Paint] | | > Visibility |
| | +--+ | | [Solo ] | | > Export |
| |Round | | [Splat] | | > Display |
@@ -133,7 +133,7 @@ Every palette's body is one function `void drawPalette_<Id>()`, and the same fun
| **Color** | Vertex Paint colour picker and swatches; Fill object (`cmd:paint_fill`); Clear (`cmd:paint_clear`); From cavity (`cmd:paint_from_cavity`); Pick under cursor (C). (`PanelPolypaint.cpp` minus the material part) |
| **Draw** | Draw Size, Strength (Intensity), Add/Sub, Rgb (`paintRgb_`), Paint mode, Tablet: Pressure > strength, Pressure > size, pen readout |
| **Edit** | Undo <label>, Redo <label> (`cmd:undo`, `cmd:redo`) |
-| **File** | New Sphere, New Plane, Open..., Open Recent >, Save, Save As..., Autosave interval; Import/Export: Export OBJ, GLB (blend shapes), LOD chain, USD/USDZ, FBX for Unreal, Send to Unreal, Save Splats...; Send to ZBrush >; Quit. (Today's File menu, `drawFileMenuProjectItems`, `drawGozMenu`) |
+| **File** | New Sphere, New Plane, Open..., Open Recent >, Save, Save As..., Autosave interval; Import/Export: Export OBJ, GLB (blend shapes), LOD chain, USD/USDZ, FBX for Unreal, Send to Unreal, Save Splats...; Bridge >; Quit. (Today's File menu, `drawFileMenuProjectItems`, `drawGozMenu`) |
| **Generate** | Generate 3D (image/text -> 3D, ComfyUI) opens the existing Generate 3D window; Image Relief / Inflate / Project (`cmd:image_relief`, `image_inflate`, `image_project`); AI provider settings (`drawAiSettings`) |
| **Help** | Controls (shortcut sheet generated from the Action registry), User Guide (Shift+F1), What's New (also opened once after each update), Command palette (F3), Website & documentation, Report a problem, About SculptForge |
| **Material** | Studio + Lit Sphere thumbnail grid (`cmd:set_material`); base colour (today's "Material" ColorEdit in Tools) |
@@ -142,7 +142,7 @@ Every palette's body is one function `void drawPalette_<Id>()`, and the same fun
| **Script** | Show console (`` ` ``), Run script file..., Copy session as script, Clear console |
| **Splats** | `drawSplatSection` body (info, clean, transform, to mesh, save, clear) |
| **Stroke** | Stroke type (Dots, Drag Stamp, Spray, Lazy Stroke) and its settings (spray scatter, lazy radius) |
-| **Tool** | The model palette. Header: active Part name + tri count, `[Open] [Save] [Import]`. Sub-palettes (collapsing headers, one open at a time, Shift+click for more): **Part** (Parts panel body), **Layers** (Layers / Blend Shapes body), **Geometry** (Lower Res / Higher Res, SDiv slider, Del Lower / Del Higher, Reconstruct Subdiv, Divide Ctrl+D + Smt, Subdivide, Decimate, `cmd:decimate`), **Remesh** (Voxel remesh + resolution, the "DynaMesh" analogue), **Masking** (`drawMaskingSection`), **Face Groups** (`drawPolygroupsSection`), **Visibility** (Show all, Invert visibility, Delete hidden), **Export** (Game Ready panel body: LODs, Unreal, GLB/LOD chain), **Display** (wireframe, show mask/groups, material colour) |
+| **Tool** | The model palette. Header: active Part name + tri count, `[Open] [Save] [Import]`. Sub-palettes (collapsing headers, one open at a time, Shift+click for more): **Part** (Parts panel body), **Layers** (Layers / Blend Shapes body), **Geometry** (Lower Res / Higher Res, SDiv slider, Del Lower / Del Higher, Reconstruct Subdiv, Divide Ctrl+D + Smt, Subdivide, Decimate, `cmd:decimate`), **Remesh** (Voxel remesh + resolution, the "voxel remesh" analogue), **Masking** (`drawMaskingSection`), **Face Groups** (`drawPolygroupsSection`), **Visibility** (Show all, Invert visibility, Delete hidden), **Export** (Game Ready panel body: LODs, Unreal, GLB/LOD chain), **Display** (wireframe, show mask/groups, material colour) |
| **Transform** | Draw / Move / Scale / Rotate (Q W E R, Gizmo: pivot, World / Surface axes, Mask, All Parts, Falloff, numeric entry; `cmd:transform`), Symmetry X / Y / Z (X), Frame (F), Solo (`cmd:subtool_solo`), Wireframe |
Part / Layer / Masking / Face Groups are **Tool** sub-palettes, not top-level palettes. The Mesh and View menus disappear, and their items move to Tool > Geometry/Remesh and Render. Palettes are sorted by name at registration, so a new palette lands in alphabetical order automatically.
@@ -344,7 +344,7 @@ One registry drives shelves, palettes, help, the command palette, keys and custo
```cpp
// src/app/Actions.h
struct Action {
- std::string id; // "geometry.subdivide", "ui.lightbox", "brush.clay", "view.wireframe"
+ std::string id; // "geometry.subdivide", "ui.library", "brush.clay", "view.wireframe"
std::string label; // "Subdivide"
const char* icon = nullptr; // ICON_LC_* or nullptr
std::string description; // shown in Ctrl help; defaults to Command::description
@@ -412,10 +412,10 @@ struct UiLayout {
bool leftTrayOpen = false, rightTrayOpen = true;
float leftTrayWidth = 300, rightTrayWidth = 300; // logical px
std::vector<std::string> leftTray, rightTray; // palette ids, top to bottom
- std::vector<std::string> openSubpalettes; // "tool.subtool", ...
+ std::vector<std::string> openSubpalettes; // "tool.part", ...
std::vector<std::string> topShelf, leftShelf, rightShelf, bottomShelf; // item ids: action ids, "widget.*", "sep", "row" (top shelf line break)
bool consoleOpen = false; float consoleHeight = 160;
- bool lightboxOpen = false; int lightboxRows = 1; std::string lightboxTab = "project"; bool lightboxBottom = false;
+ bool libraryOpen = false; int libraryRows = 1; std::string libraryTab = "project"; bool libraryBottom = false;
bool customize = false; // runtime only, never stored
};
UiLayout standardLayout(); // the built-in default described in §3
@@ -499,7 +499,7 @@ Every look also tints the 3D view's gradient (`RenderSettings::gradientCentre` /
user picked is left alone.
**Layouts.** Picking one of the three looks switches to the **SculptForge layout**; the old one stays as the
-**ZBrush-style layout** (Preferences > Interface > Look > Layout, `ui_look layout=zbrush`), and works with any look.
+**Classic layout** (Preferences > Interface > Look > Layout, `ui_look layout=zbrush`), and works with any look.
- Status bar (h 30): the cube and name, the task menus **File · Edit · Sculpt · Paint · Mesh · View · Render · Help**,
the status message, then modules (mode, brush, file, triangles, fps), the presets 1 2 3 as workspaces, search (F3),
@@ -517,7 +517,7 @@ user picked is left alone.
contents keep their size; the dividers become the gaps beside the trays.
Scripts and tests: `ui_look look=forge|phosphor|blueprint|classic scheme=nord phosphor=amber effects=true
-layout=sculptforge|zbrush`; `expect_value look`, `shell_layout`; tests/ui/looks.sfui; screenshots for choosing:
+layout=sculptforge|classic`; `expect_value look`, `shell_layout`; tests/ui/looks.sfui; screenshots for choosing:
tools/looks/shots.sfui.
---
diff --git a/docs/goz.md b/integrations/bridge-plugin/PROTOCOL.md
similarity index 98%
rename from docs/goz.md
rename to integrations/bridge-plugin/PROTOCOL.md
index 5b28732d..8e35d17a 100644
--- a/docs/goz.md
+++ b/integrations/bridge-plugin/PROTOCOL.md
@@ -1,4 +1,4 @@
-# ZBrush interoperability (Send to ZBrush, GoZ format) and STL
+# Bridge protocol notes (developers)
SculptForge reads and writes ZBrush's **GoZ** bridge format and can send meshes to and receive them
from a running ZBrush the way GoZ-enabled apps do. The format notes below come from reading
@@ -124,3 +124,5 @@ remembers the file time of SculptForge's own write, so a send is never received
`open` reads binary STL and ASCII STL. A file is binary when its size is exactly `84 + 50 × count`,
otherwise it must start with `solid`. Coincident corners are welded with `weldImported`. `export_stl`
writes binary STL with facet normals. Positions are kept as stored, with no axis or unit conversion.
+
+ZBrush is a trademark of Maxon. SculptForge is not affiliated with or endorsed by Maxon.
diff --git a/integrations/bridge-plugin/README.md b/integrations/bridge-plugin/README.md
new file mode 100644
index 00000000..95faae95
--- /dev/null
+++ b/integrations/bridge-plugin/README.md
@@ -0,0 +1,35 @@
+# Bridge setup
+
+SculptForge's **Bridge** (**File > Bridge**) exchanges Parts with ZBrush through ZBrush's own exchange folder, and
+the export plug-in in this folder converts a ZBrush library once. This page is the one place that names the other
+application, because setting it up needs its folder and menu names.
+
+## The bridge folder
+
+The Bridge uses the shared folder ZBrush's exchange plug-in uses: `C:\Users\Public\Pixologic` on Windows and
+`/Users/Shared/Pixologic` on macOS. Nothing to install: **File > Bridge > Send** writes there and starts ZBrush or
+brings it forward; send back from ZBrush with its own exchange button, and SculptForge receives it. ZBrush doesn't
+run on Linux, so there set a **Custom bridge folder** (for example inside a Wine prefix), or move Bridge files by
+hand with **Import / Export Bridge file**.
+
+## Converting a library once
+
+ZBrush's `.ZTL` files are proprietary and undocumented, so SculptForge can't read them. `SculptForgeBridgeExport.txt`
+is a ZScript plug-in that runs inside ZBrush and writes every SubTool of a ZTool, at its highest subdivision level,
+next to the `.ZTL` as a Bridge file (`Dragon.ZTL` -> `Dragon.sf001_Body.GoZ`, `Dragon.sf002_Horns.GoZ`, ...), with
+face groups, vertex paint, the mask and UVs. Opening `Dragon.ZTL` in SculptForge then opens those files as Parts in
+the same order and with the same names (a folder of numbered Bridge files, such as `Dragon.sculptforge/`, opens the
+same way).
+
+Install: copy `SculptForgeBridgeExport.txt` into ZBrush's `ZStartup/ZPlugs64` folder and restart ZBrush (it
+compiles the script to a `.zsc`), or load it once with **ZScript > Load**. The buttons are in
+**ZPlugin > SculptForge**:
+
+- **Convert ZTL**: pick a `.ZTL`; it is loaded and converted.
+- **Save for SculptForge**: saves the open ZTool as a `.ZTL` where you choose, and converts it.
+
+Not carried over: lower subdivision levels, layers, materials and textures. Status: not yet tested in every ZBrush
+version; please report problems with yours. Licence: GPL-3.0-or-later, like SculptForge. Releases before 0.10.11
+shipped the same file as `SculptForgeZToolExport.txt`.
+
+ZBrush is a trademark of Maxon. SculptForge is not affiliated with or endorsed by Maxon.
diff --git a/integrations/zbrush/SculptForgeZToolExport.txt b/integrations/bridge-plugin/SculptForgeBridgeExport.txt
similarity index 100%
rename from integrations/zbrush/SculptForgeZToolExport.txt
rename to integrations/bridge-plugin/SculptForgeBridgeExport.txt
diff --git a/integrations/comfyui/ComfyUI-SculptForge/README.md b/integrations/comfyui/ComfyUI-SculptForge/README.md
index fbcdfb5a..064d7b83 100644
--- a/integrations/comfyui/ComfyUI-SculptForge/README.md
+++ b/integrations/comfyui/ComfyUI-SculptForge/README.md
@@ -4,7 +4,7 @@
turn the meshes your graphs generate (Hunyuan3D, TRELLIS, or a quick sketch inflate) into **sculpt-ready**,
**game-ready** and **VFX-ready** assets without leaving ComfyUI.
-- **Voxel Remesh** (similar to ZBrush's DynaMesh) rebuilds noisy, broken or self-intersecting AI meshes as one clean, watertight
+- **Voxel Remesh** rebuilds noisy, broken or self-intersecting AI meshes as one clean, watertight
sculpting surface.
- **Decimate**, **Subdivide** and **LOD Chain** for game budgets.
- **Export** to GLB, FBX (Unreal, Unity, Maya), USDA/USDZ (VFX pipelines, Apple AR), OBJ, STL (3D printing) or PLY.
@@ -66,10 +66,10 @@ requests on the main repository.
| Node | Inputs | Outputs | What it does |
|---|---|---|---|
-| **SculptForge Load Mesh** | `path` | `mesh` | Loads OBJ, FBX, GLB/glTF, PLY, STL, USD/USDA/USDZ, ZBrush .GoZ files or a SculptForge `.sfproj`. Relative paths are looked up in ComfyUI's `input` folder (e.g. `3d/rock.glb`). |
+| **SculptForge Load Mesh** | `path` | `mesh` | Loads OBJ, FBX, GLB/glTF, PLY, STL, USD/USDA/USDZ, Bridge files or a SculptForge `.sfproj`. Relative paths are looked up in ComfyUI's `input` folder (e.g. `3d/rock.glb`). |
| **SculptForge Inflate Image** | `image`, optional `mask`, `thickness`, `resolution`, `subdivisions` | `mesh` | Inflates a sketch or silhouette into a rounded, closed base mesh. Connect *Load Image*'s `MASK` so the transparent background is left out; a plain backdrop works too. Uses the first image of a batch. |
| **SculptForge Image Relief** | `image`, `depth`, `resolution`, `invert` | `mesh` | Turns an image into a relief: light areas rise (logos, coins, emblems, height maps). |
-| **SculptForge Voxel Remesh** | `mesh`, `resolution` (32-512) | `mesh` | Rebuilds the mesh as an even, watertight surface (similar to ZBrush's DynaMesh); fixes broken scans and generated models. |
+| **SculptForge Voxel Remesh** | `mesh`, `resolution` (32-512) | `mesh` | Rebuilds the mesh as an even, watertight surface; fixes broken scans and generated models. |
| **SculptForge Decimate** | `mesh`, `ratio`, `triangles` | `mesh` | Reduces the triangle count, keeping the shape. `triangles` > 0 sets an exact target instead of the ratio. |
| **SculptForge Subdivide** | `mesh`, `levels` (1-4) | `mesh` | Loop subdivision; each level multiplies the triangles by 4. |
| **SculptForge LOD Chain** | `mesh`, `levels`, `ratio`, `filename_prefix` | `file_paths` | Saves `<prefix>_00001_LOD0.glb`, `_LOD1.glb`... to the output folder. |
diff --git a/integrations/comfyui/ComfyUI-SculptForge/sculptforge_comfy/nodes.py b/integrations/comfyui/ComfyUI-SculptForge/sculptforge_comfy/nodes.py
index d5e90823..6560b2ad 100644
--- a/integrations/comfyui/ComfyUI-SculptForge/sculptforge_comfy/nodes.py
+++ b/integrations/comfyui/ComfyUI-SculptForge/sculptforge_comfy/nodes.py
@@ -118,8 +118,7 @@ def _output_ui(saved):
class SculptForgeLoadMesh:
- DESCRIPTION = ("Load a model file (OBJ, FBX, GLB/glTF, PLY, STL, USD/USDZ, ZBrush .GoZ files or a SculptForge "
- ".sfproj) for the SculptForge nodes. Relative paths are looked up in ComfyUI's input folder.")
+ DESCRIPTION = ("Load a model file for the SculptForge nodes. Relative paths are looked up in ComfyUI's input folder.")
CATEGORY = CATEGORY
RETURN_TYPES = (SF_MESH,)
RETURN_NAMES = ("mesh",)
@@ -204,7 +203,7 @@ class SculptForgeImageRelief:
class SculptForgeVoxelRemesh:
- DESCRIPTION = ("Voxel remesh (similar to ZBrush's DynaMesh): rebuild the mesh as an even, watertight sculpting surface, "
+ DESCRIPTION = ("Voxel remesh: rebuild the mesh as an even, watertight sculpting surface, "
"merging overlapping parts and fixing broken scans or AI-generated models.")
CATEGORY = CATEGORY
RETURN_TYPES = (SF_MESH,)
@@ -355,7 +354,7 @@ class SculptForgeMeshInfo:
return {"required": {"mesh": (MESH_IN,)}, "hidden": {"unique_id": "UNIQUE_ID"}}
def info(self, mesh, unique_id=None):
- stdout = cli.run("open path=$IN; mesh_info; subtool_list", {"IN": _source(mesh)})
+ stdout = cli.run("open path=$IN; mesh_info; part_list", {"IN": _source(mesh)})
lines = [l.split(": ", 1)[-1] if re.match(r"^\w+: ", l) else l for l in stdout.strip().splitlines()[1:]]
text = "\n".join(lines)
paths.show_text(text, unique_id)
diff --git a/integrations/comfyui/ComfyUI-SculptForge/tests/fake_cli.py b/integrations/comfyui/ComfyUI-SculptForge/tests/fake_cli.py
index 1dd27384..af7a9471 100644
--- a/integrations/comfyui/ComfyUI-SculptForge/tests/fake_cli.py
+++ b/integrations/comfyui/ComfyUI-SculptForge/tests/fake_cli.py
@@ -120,8 +120,8 @@ def main(argv):
elif cmd == "mesh_info":
print(f"mesh_info: {state['triangles'] // 2} vertices, {state['triangles']} triangles, "
"bounds (-1, -1, -1) - (1, 1, 1)")
- elif cmd == "subtool_list":
- print(f"subtool_list: 1 SubTool:\n0. {state['name']} ({state['triangles']} triangles, active)")
+ elif cmd == "part_list":
+ print(f"part_list: 1 Part:\n0. {state['name']} ({state['triangles']} triangles, active)")
else:
fail(line, cmd, f"Unknown command '{cmd}'")
diff --git a/integrations/maya/README.md b/integrations/maya/README.md
index 071f8e12..feaa91e9 100644
--- a/integrations/maya/README.md
+++ b/integrations/maya/README.md
@@ -1,6 +1,6 @@
# SculptForge bridge for Maya
-Send the selected meshes from Maya to SculptForge and get them back, the way GoZ works between ZBrush and
+Send the selected meshes from Maya to SculptForge and get them back, the way the Bridge works between SculptForge and
other apps. One Python file (`sculptforge_maya.py`), plain `maya.cmds`, no other modules. Tested against a
mocked `maya.cmds` (`tests/maya/test_sculptforge_maya.py`); it uses only commands Maya has had for many
versions (Maya 2022 or newer, Python 3), but it has not been run inside a real Maya yet: please report what
diff --git a/integrations/maya/sculptforge_maya.py b/integrations/maya/sculptforge_maya.py
index f54e07cc..ad6e6646 100644
--- a/integrations/maya/sculptforge_maya.py
+++ b/integrations/maya/sculptforge_maya.py
@@ -3,7 +3,7 @@
"""SculptForge bridge for Maya (SculptForge issue #42).
Sends the selected meshes from Maya to SculptForge and gets them back, through ONE exchange folder that you
-pick in both apps (the way GoZ works between ZBrush and other apps). Nothing else is shared: no ports, sockets
+pick in both apps. Nothing else is shared: no ports, sockets
or servers, and neither side runs anything it finds in the folder. Meshes travel as OBJ (quads and UVs, world
space, Maya's own units, one object per file); a small JSON manifest per direction lists the objects:
@@ -45,7 +45,7 @@ def safe_name(name):
s = _NAME_BAD.sub("_", (name or "").encode("utf-8", "replace").decode("ascii", "replace").replace("�", "_"))
s = s[:MAX_NAME]
if not s:
- return "SubTool"
+ return "Part"
if s[0].isdigit():
s = ("_" + s)[:MAX_NAME]
return s
diff --git a/integrations/zbrush/README.md b/integrations/zbrush/README.md
deleted file mode 100644
index bb7ede50..00000000
--- a/integrations/zbrush/README.md
+++ /dev/null
@@ -1,21 +0,0 @@
-# SculptForge ZTL Export (ZBrush plug-in)
-
-ZBrush's `.ZTL` files are proprietary and undocumented, so SculptForge can't read them. This ZScript plug-in runs
-inside ZBrush and converts a ZTool once: every SubTool, at its highest subdivision level, is written next to the
-`.ZTL` as a GoZ file (`Dragon.ZTL` -> `Dragon.sf001_Body.GoZ`, `Dragon.sf002_Horns.GoZ`, ...). The .GoZ
-files keep polygroups, polypaint, the mask and UVs. Opening `Dragon.ZTL` in SculptForge then opens those files as Parts in
-the same order and with the same names (`convertedZToolFiles` / `loadConvertedZTool` in `src/io/GozIO.cpp`; a
-folder of numbered `.GoZ` files, such as `Dragon.sculptforge/`, opens the same way).
-
-Install: copy `SculptForgeZToolExport.txt` into ZBrush's `ZStartup/ZPlugs64` folder and restart ZBrush (it compiles
-the script to a `.zsc`), or load it once with **ZScript > Load**. The buttons are in **ZPlugin > SculptForge**:
-
-- **Convert ZTL**: pick a `.ZTL`; it is loaded and converted.
-- **Save for SculptForge**: saves the open ZTool as a `.ZTL` where you choose, and converts it.
-
-Not carried over: lower subdivision levels, ZBrush layers, materials and textures. Status: new and not yet tested
-in every ZBrush version (ZBrush doesn't run on the Linux machines the project is developed on); please report
-problems with your ZBrush version. Licence: GPL-3.0-or-later, like SculptForge.
-
-The file keeps its old name, `SculptForgeZToolExport.txt`, so existing links work. ZBrush, ZScript, ZTool, GoZ, MatCap and other ZBrush feature names are
-trademarks of Maxon Computer GmbH. SculptForge is not affiliated with or endorsed by Maxon.
diff --git a/packaging/arch/PKGBUILD b/packaging/arch/PKGBUILD
index 6926e066..b93e32d5 100644
--- a/packaging/arch/PKGBUILD
+++ b/packaging/arch/PKGBUILD
@@ -2,7 +2,7 @@
pkgname=sculptforge
pkgver=0.10.10
pkgrel=1
-pkgdesc="Free, open-source digital sculpting app with ZBrush-style keys available, for artists and game pipelines"
+pkgdesc="Free, open-source digital sculpting app with the Classic sculpting keys available, for artists and game pipelines"
arch=('x86_64' 'aarch64')
url="https://sculptforge.app/"
license=('GPL-3.0-or-later')
diff --git a/packaging/flatpak/flatpark/org.sculptforge.SculptForge/org.sculptforge.SculptForge.metainfo.xml b/packaging/flatpak/flatpark/org.sculptforge.SculptForge/org.sculptforge.SculptForge.metainfo.xml
index 02256fe5..d01ae2e7 100644
--- a/packaging/flatpak/flatpark/org.sculptforge.SculptForge/org.sculptforge.SculptForge.metainfo.xml
+++ b/packaging/flatpak/flatpark/org.sculptforge.SculptForge/org.sculptforge.SculptForge.metainfo.xml
@@ -9,13 +9,12 @@
<name>The SculptForge contributors</name>
</developer>
<description>
- <p>SculptForge is a free and open-source alternative to ZBrush: a digital sculpting application with familiar brushes,
+ <p>SculptForge is a free, open-source digital sculpting application with familiar brushes,
symmetry, sculpt layers, voxel remeshing and one-click LOD chains.</p>
<p>It exports game-ready FBX, glTF and OpenUSD files, can send assets straight into the Unreal Editor,
works with Gaussian splats, and includes free AI tools (or bring your own): describe a brush in words,
or turn an image or a description into a sculptable 3D model.</p>
- <p>ZBrush, GoZ, MatCap, FiberMesh, LightCap and other ZBrush feature names are trademarks of Maxon Computer GmbH. SculptForge is not affiliated with
- or endorsed by Maxon.</p>
+ <p>Product names are trademarks of their respective owners.</p>
<p>This FlatPark package installs SculptForge's official Linux build, unmodified, from the project's GitHub
releases. It is maintained with the SculptForge developers.</p>
<p>The sandbox can read and write your home folder (models name their textures and other files beside them).
diff --git a/packaging/linux/org.sculptforge.SculptForge.metainfo.xml b/packaging/linux/org.sculptforge.SculptForge.metainfo.xml
index 7433852b..3a011532 100644
--- a/packaging/linux/org.sculptforge.SculptForge.metainfo.xml
+++ b/packaging/linux/org.sculptforge.SculptForge.metainfo.xml
@@ -9,13 +9,12 @@
<name>The SculptForge contributors</name>
</developer>
<description>
- <p>SculptForge is a free and open-source alternative to ZBrush: a digital sculpting application with familiar brushes,
+ <p>SculptForge is a free, open-source digital sculpting application with familiar brushes,
symmetry, sculpt layers, voxel remeshing and one-click LOD chains.</p>
<p>It exports game-ready FBX, glTF and OpenUSD files, can send assets straight into the Unreal Editor,
works with Gaussian splats, and includes free AI tools (or bring your own): describe a brush in words,
or turn an image or a description into a sculptable 3D model.</p>
- <p>ZBrush, GoZ, MatCap, FiberMesh, LightCap and other ZBrush feature names are trademarks of Maxon Computer GmbH. SculptForge is not affiliated with
- or endorsed by Maxon.</p>
+ <p>Product names are trademarks of their respective owners.</p>
</description>
<launchable type="desktop-id">org.sculptforge.SculptForge.desktop</launchable>
<url type="homepage">https://sculptforge.app/</url>
diff --git a/src/app/Actions.cpp b/src/app/Actions.cpp
index f96a1f15..4e0130be 100644
--- a/src/app/Actions.cpp
+++ b/src/app/Actions.cpp
@@ -3,6 +3,7 @@
#include "app/Actions.h"
#include "core/Commands.h"
+#include "core/LegacyNames.h"
#include <algorithm>
#include <cctype>
@@ -221,6 +222,7 @@ void ActionRegistry::removePrefix(std::string_view prefix) {
const Action* ActionRegistry::find(std::string_view id) const {
for (const auto& a : actions_)
if (a.id == id) return &a;
+ if (const std::string_view now = legacy::renamed(legacy::kActionIds, id); !now.empty()) return find(now);
return nullptr;
}
@@ -334,7 +336,10 @@ void ActionRegistry::overridesFromJson(const Json& j) {
++revision_;
if (!j.isObject()) return;
for (const auto& [id, chord] : j.members())
- if (chord.isString()) overrides_.emplace_back(id, chord.asString());
+ if (chord.isString()) {
+ const std::string_view now = legacy::renamed(legacy::kActionIds, id);
+ overrides_.emplace_back(now.empty() ? id : std::string(now), chord.asString());
+ }
}
void ActionRegistry::touch(std::string_view id) {
diff --git a/src/app/App.cpp b/src/app/App.cpp
index 8176a49f..93e81397 100644
--- a/src/app/App.cpp
+++ b/src/app/App.cpp
@@ -1,6 +1,7 @@
// SculptForge - open source digital sculpting
// SPDX-License-Identifier: GPL-3.0-or-later
#include "app/App.h"
+#include "io/BridgeProtocol.h"
#include "core/LayerStack.h"
#include "app/ShellQuote.h"
#include "app/SpaceCamera.h"
@@ -72,7 +73,7 @@ namespace {
const SDL_DialogFileFilter kObjFilters[] = {{"Wavefront OBJ", "obj"}, {"All files", "*"}};
const SDL_DialogFileFilter kGlbFilters[] = {{"glTF binary", "glb"}, {"All files", "*"}};
const SDL_DialogFileFilter kBrushFilters[] = {{"SculptForge brush", "sfbrush"}, {"All files", "*"}};
-const SDL_DialogFileFilter kModelFilters[] = {{"Projects, models and splats", "sfproj;obj;fbx;glb;gltf;ply;stl;GoZ;goz;ztl;ZTL;splat;usda;usd;usdz"}, {"All files", "*"}};
+const SDL_DialogFileFilter kModelFilters[] = {{"Projects, models and splats", "sfproj;obj;fbx;glb;gltf;ply;stl;" SF_BRIDGE_DIALOG_EXTS ";splat;usda;usd;usdz"}, {"All files", "*"}};
const SDL_DialogFileFilter kFbxFilters[] = {{"FBX", "fbx"}, {"All files", "*"}};
const SDL_DialogFileFilter kUsdFilters[] = {{"USDZ package", "usdz"}, {"USD text", "usda"}};
const SDL_DialogFileFilter kSplatFilters[] = {{"Gaussian splats (PLY)", "ply"}, {"glTF splats", "glb"}, {"OpenUSD", "usda;usdz"}};
@@ -84,7 +85,7 @@ const char* kExamplePrompts[] = {
"Overlapping dragon scales",
"Weathered, chipped stone edges",
"Dry cracked mud",
- "Soft clay buildup like a thumb smear",
+ "Soft clay built up like a thumb smear",
};
bool ctrlDown(SDL_Keymod mod) { return (mod & (SDL_KMOD_CTRL | SDL_KMOD_GUI)) != 0; }
@@ -2596,7 +2597,7 @@ void App::drawLayersContents() {
if (ImGui::RadioButton(layer.name.c_str(), doc_.activeLayer == i))
runCommand("layer_set_active", {{"index", double(i)}});
ui::HelpText(layer.name.c_str(), nullptr,
- "Select to sculpt into this layer (ZBrush's REC). With subdivision levels, record at any level: a "
+ "Select to sculpt into this layer. With subdivision levels, record at any level: a "
"layer keeps its own detail on every level and follows Lower Res / Higher Res and Divide.",
kLayersPath);
ImGui::SameLine(ImGui::GetContentRegionAvail().x - 52 * scale);
@@ -2618,7 +2619,7 @@ void App::drawLayersContents() {
setLayerWeight(i, w);
}
ui::HelpText("Weight", nullptr,
- "How strongly the layer shows: 0 = off (ZBrush's eye), 1 = as sculpted. One weight for every "
+ "How strongly the layer shows: 0 = off, 1 = as sculpted. One weight for every "
"subdivision level.",
kLayersPath);
ImGui::PopID();
diff --git a/src/app/App.h b/src/app/App.h
index a4a5ed30..d6d420c5 100644
--- a/src/app/App.h
+++ b/src/app/App.h
@@ -810,7 +810,7 @@ private:
bool paintRgb_ = false; // also paint the colour while sculpting (ZBrush Rgb + Zadd)
bool strokePaint_ = false, strokeSculpt_ = true;
void registerPaintUiCommands();
- std::string matcapFolder() const; // <library>/MatCaps, empty without a library
+ std::string matcapFolder() const; // <library>/Lit Spheres, empty without a library
void loadMatcapLibrary(); // custom MatCaps from the studio folders and matcapFolder() (start-up)
void loadMatcapDialog(); // Material > Load MatCap...
void rescanMatcapFolder(); // loads new / changed images in matcapFolder(), drops deleted ones
diff --git a/src/app/AssetLibrary.cpp b/src/app/AssetLibrary.cpp
index 7006dfdd..8a8d6d42 100644
--- a/src/app/AssetLibrary.cpp
+++ b/src/app/AssetLibrary.cpp
@@ -2,6 +2,8 @@
// SPDX-License-Identifier: GPL-3.0-or-later
#include "app/AssetLibrary.h"
+#include "core/LegacyNames.h"
+
#include <algorithm>
#include <cctype>
#include <chrono>
@@ -89,7 +91,7 @@ const char* libraryTabFolder(LibraryTab tab) {
case LibraryTab::Alpha:
return "Alphas";
case LibraryTab::Material:
- return "MatCaps"; // custom MatCap images, loaded at start-up (core/Matcap.h)
+ return "Lit Spheres"; // custom lit-sphere images, loaded at start-up (core/Matcap.h)
case LibraryTab::Image:
return "Images";
case LibraryTab::Splats:
@@ -186,6 +188,11 @@ bool ensureUserLibrary(const std::string& root, std::string& error) {
return false;
}
std::error_code ec;
+ for (const legacy::Rename& r : legacy::kLibraryFolders) { // a library from an older version: move the folder over
+ const fs::path from = fsPath(root) / std::string(r.old), to = fsPath(root) / std::string(r.now);
+ if (fs::is_directory(from, ec) && !fs::exists(to, ec)) fs::rename(from, to, ec);
+ ec.clear();
+ }
for (int i = 0; i < int(LibraryTab::Count); ++i) {
const char* sub = libraryTabFolder(LibraryTab(i));
if (!*sub) continue;
@@ -339,13 +346,12 @@ std::string typedName(const std::string& name) {
return out;
}
-std::string typedZBrushAlias(const std::string& typed) {
- // The brushes SculptForge names its own way, under the names ZBrush users type for them.
- static const std::pair<const char*, const char*> kAliases[] = {
- {"sharpcrease", "damstandard"}, {"clayblock", "claybuildup"}, {"tendril", "snakehook"},
- {"elastictendril", "kelvinsnake"}};
- for (const auto& [name, alias] : kAliases)
- if (typed == name) return alias;
+std::string typedClassicKeys(const std::string& typed) {
+ // The two classic pop-up letters for the brushes whose names don't start with them (B D S picks Sharp Crease).
+ static const std::pair<const char*, const char*> kKeys[] = {
+ {"sharpcrease", "ds"}, {"clayblock", "cb"}, {"tendril", "sh"}, {"elastictendril", "ks"}};
+ for (const auto& [name, keys] : kKeys)
+ if (typed == name) return keys;
return {};
}
@@ -353,7 +359,7 @@ namespace {
bool typedStarts(const std::string& name, const std::string& typed) {
const std::string n = typedName(name);
if (n.rfind(typed, 0) == 0) return true;
- const std::string alias = typedZBrushAlias(n);
+ const std::string alias = typedClassicKeys(n);
return !alias.empty() && alias.rfind(typed, 0) == 0;
}
} // namespace
@@ -380,22 +386,21 @@ std::vector<std::pair<char, size_t>> letterBadges(const std::vector<std::string>
auto has = [&](size_t i) {
return std::any_of(badges.begin(), badges.end(), [i](const auto& b) { return b.second == i; });
};
- // ZBrush's keys for the brushes both apps have (B S T Standard, B C B for Clay Block, ZBrush's ClayBuildup ...)
- // come first, so the hands that know ZBrush pick the same brush.
- static const std::pair<const char*, const char*> kZBrushKeys[] = {
- {"standard", "st"}, {"smooth", "sm"}, {"snakehook", "sh"}, {"claybuildup", "cb"}, {"clay", "cl"},
- {"damstandard", "ds"}, {"move", "mv"}, {"inflate", "in"}, {"pinch", "pi"}, {"flatten", "fl"},
+ // The classic letters (B S T Standard, B C B Clay Block ...) come first, so practised hands pick the same brush.
+ static const std::pair<const char*, const char*> kClassicKeys[] = {
+ {"standard", "st"}, {"smooth", "sm"}, {"tendril", "sh"}, {"clayblock", "cb"}, {"clay", "cl"},
+ {"sharpcrease", "ds"}, {"move", "mv"}, {"inflate", "in"}, {"pinch", "pi"}, {"flatten", "fl"},
{"trim", "td"}, {"layer", "ly"}, {"nudge", "nu"}, {"crease", "cr"}};
if (typed.size() == 1)
for (size_t i : kept) {
- const std::string n = typedName(names[i]), alias = typedZBrushAlias(n);
- for (const auto& [name, keys] : kZBrushKeys)
- if ((n == name || alias == name) && keys[0] == typed[0] && !taken(keys[1]) && !has(i)) badges.emplace_back(keys[1], i);
+ const std::string n = typedName(names[i]);
+ for (const auto& [name, keys] : kClassicKeys)
+ if (n == name && keys[0] == typed[0] && !taken(keys[1]) && !has(i)) badges.emplace_back(keys[1], i);
}
for (size_t i : kept) {
if (has(i)) continue;
std::string n = typedName(names[i]);
- if (n.rfind(typed, 0) != 0) n = typedZBrushAlias(n); // typed by its ZBrush name
+ if (n.rfind(typed, 0) != 0) n = typedClassicKeys(n); // typed by its classic letters
if (n.rfind(typed, 0) != 0) continue;
for (size_t k = typed.size(); k < n.size(); ++k)
if (std::isalpha(static_cast<unsigned char>(n[k])) && !taken(n[k])) {
diff --git a/src/app/AssetLibrary.h b/src/app/AssetLibrary.h
index 23f969b2..6b63eeb6 100644
--- a/src/app/AssetLibrary.h
+++ b/src/app/AssetLibrary.h
@@ -133,12 +133,12 @@ std::string fileThumbnailKey(const std::string& kind, const std::string& absPath
// <cacheDir>/<key>.png
std::string thumbnailCachePath(const std::string& cacheDir, const std::string& key);
-// --- Brush pop-up letters (ZBrush: B, then S, then T picks Standard) ---
+// --- Brush pop-up letters (B, then S, then T picks Standard) ---
-// Lower-case letters and digits only ("Clay Buildup" -> "claybuildup"): what a name is typed as.
+// Lower-case letters and digits only ("Clay Block" -> "clayblock"): what a name is typed as.
std::string typedName(const std::string& name);
-// The name ZBrush users type for a brush SculptForge names its own way ("sharpcrease" -> "damstandard"), else "".
-std::string typedZBrushAlias(const std::string& typed);
+// The two classic pop-up letters for a brush whose name doesn't start with them ("sharpcrease" -> "ds"), else "".
+std::string typedClassicKeys(const std::string& typed);
// Indices of `names` the typed letters keep: names starting with `typed`, or (when none does) names
// containing it (`substring` says which). Empty `typed` keeps all.
std::vector<size_t> filterByTyped(const std::vector<std::string>& names, const std::string& typed,
diff --git a/src/app/BlenderKeymap.cpp b/src/app/BlenderKeymap.cpp
index 30e26efb..303082a9 100644
--- a/src/app/BlenderKeymap.cpp
+++ b/src/app/BlenderKeymap.cpp
@@ -136,13 +136,13 @@ std::string brushAction(std::string tool) {
for (auto& c : tool)
if (c == ' ') c = '_';
static const std::pair<const char*, const char*> kBrushes[] = {
- {"DRAW", "brush.standard"}, {"DRAW_SHARP", "brush.damstandard"}, {"CLAY", "brush.clay"},
- {"CLAY_STRIPS", "brush.claybuildup"}, {"LAYER", "brush.layer"}, {"INFLATE", "brush.inflate"},
+ {"DRAW", "brush.standard"}, {"DRAW_SHARP", "brush.sharpcrease"}, {"CLAY", "brush.clay"},
+ {"CLAY_STRIPS", "brush.clayblock"}, {"LAYER", "brush.layer"}, {"INFLATE", "brush.inflate"},
{"INFLATE/DEFLATE", "brush.inflate"}, {"CREASE", "brush.crease"}, {"CREASE_POLISH", "brush.crease"},
{"CREASE_SHARP", "brush.crease"}, {"SMOOTH", "brush.smooth"}, {"FLATTEN", "brush.flatten"},
{"FLATTEN/CONTRAST", "brush.flatten"}, {"SCRAPE", "brush.flatten"}, {"SCRAPE/FILL", "brush.flatten"},
{"PINCH", "brush.pinch"}, {"PINCH/MAGNIFY", "brush.pinch"}, {"GRAB", "brush.move"},
- {"SNAKE_HOOK", "brush.snakehook"}, {"NUDGE", "brush.nudge"}, {"MASK", "mask.brush"},
+ {"SNAKE_HOOK", "brush.tendril"}, {"NUDGE", "brush.nudge"}, {"MASK", "mask.brush"},
};
for (const auto& [name, id] : kBrushes)
if (tool == name) return id;
diff --git a/src/app/CommandPalette.cpp b/src/app/CommandPalette.cpp
index e68c5531..1259f2ba 100644
--- a/src/app/CommandPalette.cpp
+++ b/src/app/CommandPalette.cpp
@@ -74,14 +74,8 @@ int fuzzy(const std::string& hay, const std::string& word, bool allowScattered =
} // namespace
-std::string CommandPalette::zbrushHint(const Action& a, const std::string& query) {
- const std::string names = zbrushNamesIn(a.label, a.palette);
- if (names.empty()) return {};
- const std::string zbrush = lower(names), label = lower(a.label);
- for (const auto& w : words(query))
- if (w.size() >= 2 && fuzzy(zbrush, w, false) > 0 && fuzzy(label, w, false) == 0)
- return "(ZBrush users: " + names + ")";
- return {};
+std::string CommandPalette::zbrushHint(const Action&, const std::string&) {
+ return {}; // the palette finds a feature by its other names (score) without naming them
}
int CommandPalette::score(const Action& a, const std::string& query) {
@@ -269,7 +263,6 @@ void CommandPalette::draw(App& app, const CanvasRect& area) {
const char* shownLabel = trAction(a.id, a.label);
rows->AddText(ImVec2(x, ty), fg, shownLabel);
x += ImGui::CalcTextSize(shownLabel).x + 10.0f * s;
- // Found by its ZBrush name: "Forge Spheres (ZBrush users: ZSpheres)".
if (const std::string hint = zbrushHint(a, query_); !hint.empty()) {
rows->AddText(ImVec2(x - 4.0f * s, ty), ui::color::accent, hint.c_str());
if (ImGui::GetCurrentContext()->LogEnabled) ImGui::LogText("\n%s %s", shownLabel, hint.c_str());
diff --git a/src/app/CommandPalette.h b/src/app/CommandPalette.h
index 94e56496..2d833334 100644
--- a/src/app/CommandPalette.h
+++ b/src/app/CommandPalette.h
@@ -24,7 +24,7 @@ public:
// Ranks actions for QUERY (best first); exposed for tests.
static int score(const Action& action, const std::string& query);
- // "(ZBrush users: ZSpheres)" when `query` found the action by the ZBrush name of a renamed feature, else "".
+ // A note shown after an action the query found by another name; empty (other names are never shown).
static std::string zbrushHint(const Action& action, const std::string& query);
// The palette's search: indices into ActionRegistry::all() of the actions matching QUERY, best first, at most
// LIMIT, only those ACCEPT takes (null: all). Radial menus pick their items with it.
diff --git a/src/app/Config.cpp b/src/app/Config.cpp
index 9a886dc6..ce97b801 100644
--- a/src/app/Config.cpp
+++ b/src/app/Config.cpp
@@ -469,7 +469,7 @@ void App::initActions() {
"(stretched areas after big moves). The mask holds what it covers; one undo step.",
"Smooth the whole Part by the amount beside it (Smooth keeps volume: without shrinking it). The mask "
"holds what it covers; one undo step.",
- "Fill the whole Part out toward a rounder volume, like a balloon (ZBrush's Inflate Balloon); a negative "
+ "Fill the whole Part out toward a rounder volume, like a balloon; a negative "
"amount lets the air out. The mask holds what it covers; one undo step."};
for (int k = 0; k < 4; ++k)
add(kIds[k], kLabels[k], "Tool > Deformation", nullptr,
@@ -555,7 +555,7 @@ void App::initActions() {
nullptr, [this] { return symmetry_.x; }, nullptr, "Mirror strokes across the X axis (left / right).");
add("view.wireframe", "Wireframe", "Render", "Shift+F", [this] { renderSettings_.wireframe = !renderSettings_.wireframe; },
ICON_LC_GRID_3X3, nullptr, [this] { return renderSettings_.wireframe; }, nullptr,
- "Show the mesh's polygons (quads and triangles) over the surface (ZBrush PolyFrame).");
+ "Show the mesh's polygons (quads and triangles) over the surface.");
add("view.frame", "Frame model", "Transform", "F", [this] { camera_.frame(sceneBounds()); }, ICON_LC_SCAN, nullptr, nullptr,
nullptr, "Fit the whole model in the view.");
add("color.pick", "Pick colour", "Color", "C", [this] { pickColorUnderCursor(); }, ICON_LC_PIPETTE, nullptr, nullptr, nullptr,
@@ -652,7 +652,7 @@ void App::initActions() {
// --- Config (ZBrush: Preferences > Config) ---
add("config.store", "Store Config", "Preferences > Config", "Ctrl+Shift+I", [this] { storeConfig(); }, ICON_LC_SAVE, nullptr,
nullptr, nullptr,
- "Keep the current layout, shortcuts and interface preferences for future sessions. Like ZBrush, SculptForge never "
+ "Keep the current layout, shortcuts and interface preferences for future sessions. SculptForge never "
"saves them on its own.");
add("config.restore_standard", "Restore Standard UI", "Preferences > Config", nullptr, [this] { restoreStandardUi(); },
ICON_LC_ROTATE_CCW, nullptr, nullptr, nullptr,
@@ -1281,7 +1281,7 @@ void drawInterfaceSection(App& app) {
ImGui::BeginDisabled(!p.popupInfo);
ImGui::SetNextItemWidth(-FLT_MIN);
ui::SliderInside("##help_opacity", &p.helpOpacity, 0.3f, 1.0f, "Popup Info opacity %.2f");
- ui::HelpText("Popup Info opacity", nullptr, "How solid the Ctrl-help box is (ZBrush: Quick Info Opacity).",
+ ui::HelpText("Popup Info opacity", nullptr, "How solid the Ctrl-help box is.",
"Preferences > Interface");
ImGui::EndDisabled();
ImGui::SetNextItemWidth(-FLT_MIN);
@@ -1303,10 +1303,9 @@ void drawInterfaceSection(App& app) {
ImGui::Checkbox(tr("Auto collapse right tray"), &p.autoCollapseRight);
ui::HelpText("Auto collapse right tray", nullptr,
"Opening a palette in the right tray collapses the others when they would not fit.", "Preferences > Interface");
- ImGui::Checkbox(tr("Palettes strictly A-Z (ZBrush order)"), &p.alphabeticalPalettes);
+ ImGui::Checkbox(tr("Palettes strictly A-Z"), &p.alphabeticalPalettes);
ui::HelpText("Palettes strictly A-Z", nullptr,
- "Off: File and Edit come first in the palette bar and Help last, the rest A to Z. On: every palette A to Z, as in "
- "ZBrush.",
+ "Off: File and Edit come first in the palette bar and Help last, the rest A to Z. On: every palette A to Z.",
"Preferences > Interface");
ImGui::Checkbox(tr("Left-handed layout"), &app.layout().leftHanded);
ui::HelpText("Left-handed layout", nullptr, "Mirror the shelves and trays: tools on the left, navigation on the right.",
@@ -1344,7 +1343,7 @@ void drawInterfaceSection(App& app) {
"Size of text and controls, applied at once. Automatic follows the display the window is on (Windows: "
"Settings > Display > Scale, per monitor). Store Config keeps it for the next start.",
"Preferences > Interface");
- static const char* kRotation[] = {"Free (ZBrush)", "Turntable"};
+ static const char* kRotation[] = {"Free", "Turntable"};
ImGui::SetNextItemWidth(-FLT_MIN);
if (ImGui::BeginCombo("##rotation", (std::string(tr("Rotation:")) + " " + tr(kRotation[p.turntable ? 1 : 0])).c_str())) {
for (int i = 0; i < 2; ++i)
@@ -1352,7 +1351,7 @@ void drawInterfaceSection(App& app) {
ImGui::EndCombo();
}
ui::HelpText("Rotation", nullptr,
- "Free: dragging turns the model about the screen's axes and can roll it over the top, as in ZBrush; press "
+ "Free: dragging turns the model about the screen's axes and can roll it over the top; press "
"Shift while rotating to snap to the nearest front, side, top or bottom view. Turntable: the model stays "
"upright and turns about its vertical axis, as in Blender or Maya.",
"Preferences > Interface");
@@ -1422,7 +1421,7 @@ void drawLightBoxSection(App& app) {
UiPrefs& p = app.uiPrefs();
UiLayout& l = app.layout();
ImGui::Checkbox(tr("Show at startup"), &p.lightboxAtStartup);
- ui::HelpText("Show Library at startup", nullptr, "Open Library on the Project tab when SculptForge starts (as ZBrush does).",
+ ui::HelpText("Show Library at startup", nullptr, "Open Library on the Project tab when SculptForge starts.",
"Preferences > Library");
ImGui::AlignTextToFramePadding();
ImGui::TextUnformatted(tr("Rows"));
@@ -1635,11 +1634,11 @@ void App::drawLookSection() {
"Every palette is a section of one menu, and F3 finds them all.",
"Preferences > Interface > Look");
ImGui::SameLine();
- if (ImGui::RadioButton(tr("ZBrush-style##layout.zbrush"), uiPrefs_.shellLayout == 0)) {
+ if (ImGui::RadioButton(tr("Classic##layout.zbrush"), uiPrefs_.shellLayout == 0)) {
setShellLayout(0);
lookDirty_ = true;
}
- ui::HelpText("ZBrush-style layout", nullptr, "The alphabetical palette bar and the two-row top shelf.",
+ ui::HelpText("Classic layout", nullptr, "The alphabetical palette bar and the two-row top shelf.",
"Preferences > Interface > Look");
tray::GroupLabel(*this, "Interface");
}
diff --git a/src/app/Console.h b/src/app/Console.h
index 8aa1cd11..be40d583 100644
--- a/src/app/Console.h
+++ b/src/app/Console.h
@@ -1,7 +1,7 @@
// SculptForge - open source digital sculpting
// SPDX-License-Identifier: GPL-3.0-or-later
//
-// The script console (the ZBrush "ZScript window", backtick key): every command
+// The script console (the ZBrush "script window", backtick key): every command
// the app runs is echoed as a script line with its result, and the input line
// runs script statements (see core/Script.h) with Tab completion and history.
#pragma once
diff --git a/src/app/Demo.cpp b/src/app/Demo.cpp
index dd064a21..ca47d441 100644
--- a/src/app/Demo.cpp
+++ b/src/app/Demo.cpp
@@ -566,7 +566,7 @@ void Demo::buildShowcase() {
app_.camera_.distance *= 0.86f;
mouse_ = ImVec2(-50.0f, -50.0f); // cursor off screen for the beauty shot
});
- caption("SculptForge", "The free, open-source alternative to ZBrush", 4.2f);
+ caption("SculptForge", "The free, open-source sculpting app", 4.2f);
// Orbiting turns 0.008 rad per pixel: 240 px glides from profile to a three-quarter front view.
orbit(240.0f, 0.0f, 4.5f);
run([this] {
@@ -618,7 +618,7 @@ void Demo::buildSculpt() {
app_.camera_.distance *= 0.78f;
app_.showBrushLab_ = false;
});
- caption("Sculpt the way you already do", "ZBrush-style brushes, symmetry, tablet pressure", 4.5f);
+ caption("Sculpt the way you already do", "Familiar brushes, symmetry, tablet pressure", 4.5f);
wait(1.0f);
auto arc = [this](float lat0, float lon0, float lat1, float lon1) {
return [this, lat0, lon0, lat1, lon1](float u) {
diff --git a/src/app/Demo.h b/src/app/Demo.h
index 4f9efb41..55fad454 100644
--- a/src/app/Demo.h
+++ b/src/app/Demo.h
@@ -51,7 +51,7 @@ public:
bool findItem(const std::string& label, ImVec2& center, bool* visible = nullptr, ImVec4* clip = nullptr) const;
static void beginFrame(); // clears the item table (called before ImGui::NewFrame)
// Items drawn between these are also found as "NAME/label" (palettes in the shell's trays and drop-downs,
- // whose ImGui window is the tray, keep their panel names: "SubTools/Append").
+ // whose ImGui window is the tray, keep their panel names: "Parts/Append").
static void pushScope(const char* name);
static void popScope();
static std::vector<std::string> similarItems(const std::string& label); // for test failure messages
diff --git a/src/app/Gizmo.cpp b/src/app/Gizmo.cpp
index 78e6fb8f..69e9d52b 100644
--- a/src/app/Gizmo.cpp
+++ b/src/app/Gizmo.cpp
@@ -174,7 +174,7 @@ void App::registerGizmoActions() {
"Part moves whatever the mask.");
add("gizmo.all", "All Parts", ICON_LC_LAYERS, kPath, "", [this] { gizmo_.all = !gizmo_.all; },
[this] { return gizmo_.all; },
- "Transform every visible Part together (ZBrush Transpose All). Each Part gets its own undo step.");
+ "Transform every visible Part together. Each Part gets its own undo step.");
}
void App::setGizmoMode(GizmoMode mode) {
diff --git a/src/app/I18nSpanish.cpp b/src/app/I18nSpanish.cpp
index 40feb506..59bcb76b 100644
--- a/src/app/I18nSpanish.cpp
+++ b/src/app/I18nSpanish.cpp
@@ -55,7 +55,7 @@ constexpr Entry kSpanish[] = {
{"Green", "Verde"},
{"Amber", "Ámbar"},
{"Scanlines & glow", "Líneas de barrido y brillo"},
- {"ZBrush-style", "Estilo ZBrush"},
+ {"Classic", "Clásico"},
{"AI brush provider", "Proveedor del pincel IA"},
{"Autosave", "Autoguardado"},
{"Bake", "Bake"},
@@ -542,14 +542,14 @@ constexpr Entry kSpanish[] = {
{"Reduce motion", "Reducir movimiento"},
{"Auto collapse left tray", "Plegar sola la bandeja izquierda"},
{"Auto collapse right tray", "Plegar sola la bandeja derecha"},
- {"Palettes strictly A-Z (ZBrush order)", "Paletas de la A a la Z (orden de ZBrush)"},
+ {"Palettes strictly A-Z", "Paletas estrictamente de la A a la Z"},
{"Palettes strictly A-Z", "Paletas de la A a la Z"},
{"Left-handed layout", "Diseño para zurdos"},
{"Shelf tiles", "Fichas del estante"},
{"UI scale", "Escala de la interfaz"},
{"Automatic", "Automática"},
{"Rotation", "Rotación"},
- {"Free (ZBrush)", "Libre (ZBrush)"},
+ {"Free", "Libre"},
{"Turntable", "Plataforma giratoria"},
{"Camera notch", "Muesca de la cámara"},
{"Always reserve", "Reservar siempre"},
@@ -558,8 +558,7 @@ constexpr Entry kSpanish[] = {
"parameters.",
"Mantén Ctrl y apunta a cualquier control para ver qué hace y su atajo. Ctrl+Alt muestra los parámetros de "
"script del comando."},
- {"How solid the Ctrl-help box is (ZBrush: Quick Info Opacity).",
- "Lo opaca que es la ayuda de Ctrl (ZBrush: Quick Info Opacity)."},
+ {"How solid the Ctrl-help box is.", "Lo opaca que es la ayuda de Ctrl."},
{"How long to point at an icon-only button (or a clipped label) before its name appears.",
"Cuánto hay que apuntar a un botón de solo icono (o a una etiqueta cortada) antes de que aparezca su nombre."},
{"Opening a sub-palette closes the others in that palette. Shift+click opens more than one.",
@@ -575,7 +574,7 @@ constexpr Entry kSpanish[] = {
// --- Preferences > Input ---
{"Style", "Estilo"},
- {"ZBrush", "ZBrush"},
+ {"Classic sculpting keys", "Teclas clásicas de escultura"},
{"Blender", "Blender"},
{"Maya", "Maya"},
{"SculptForge", "SculptForge"},
@@ -833,8 +832,7 @@ constexpr Entry kSpanish[] = {
{"Layer channel", "Canal de la capa"},
{"Channel view", "Vista de canal"},
{"RGB while sculpting", "RGB al esculpir"},
- {"Sculpt brushes also paint the colour (ZBrush Rgb with Zadd)",
- "Los pinceles de esculpir también pintan el color (Rgb con Zadd en ZBrush)"},
+ {"Sculpt brushes also paint the colour", "Los pinceles de esculpir también pintan el color"},
{"Min Opacity", "Opacidad mínima"},
{"+ Add", "+ Añadir"},
{"Group %d", "Grupo %d"},
diff --git a/src/app/Input.cpp b/src/app/Input.cpp
index 87660c52..975c12cb 100644
--- a/src/app/Input.cpp
+++ b/src/app/Input.cpp
@@ -43,7 +43,7 @@ bool anyMasked(const Mesh& mesh) {
return std::any_of(mesh.mask.begin(), mesh.mask.end(), [](float m) { return m > 0.0f; });
}
-// The brush's action id, as the shell registers it ("brush.claybuildup").
+// The brush's action id, as the shell registers it ("brush.clayblock").
std::string brushId(BrushType t) {
std::string id = "brush.";
for (const char* c = brushName(t); *c; ++c)
@@ -83,7 +83,7 @@ void App::registerInputActions() {
"inner ring of the brush cursor shows it.",
[this] { PickerUi::sizePopup(*this, PickerUi::Slider::FocalShift); });
add("ui.quickmenu", "Quick Menu", ICON_LC_LAYOUT_GRID, "Help", "Space",
- "ZBrush's QuickMenu under the cursor: brush, stroke, alpha, material, colour, Draw Size, Falloff and the "
+ "the Quick Menu under the cursor: brush, stroke, alpha, material, colour, Draw Size, Falloff and the "
"intensities. Hold Space and let go to close it, or tap Space to keep it open.",
[this] { openQuickMenu(); }, [this] { return quickMenu_.open; });
@@ -161,11 +161,11 @@ void App::registerInputActions() {
[this] { runCommand("mask_invert"); });
actions_.setDefaultShortcut("view.mask", "Ctrl+H"); // View Mask
add("polygroup.group_masked", "Group Masked", ICON_LC_SHAPES, "Tool > Face Groups", "Ctrl+W",
- "Turn the masked part into a new face group and clear the mask (ZBrush Ctrl+W). With nothing masked, "
+ "Turn the masked part into a new face group and clear the mask. With nothing masked, "
"everything visible becomes one group.",
[this] { groupMasked(); });
add("polygroup.uv_groups", "Group by UVs", ICON_LC_GRID_2X2, "Tool > Face Groups", "",
- "One face group per UV island (ZBrush UV Groups): triangles that touch without a UV seam share a group. "
+ "One face group per UV island: triangles that touch without a UV seam share a group. "
"Only the visible part is regrouped. Needs UVs (Tool > Texture Map > Auto UV makes some).",
[this] {
runCommand("polygroup_uv");
@@ -174,8 +174,8 @@ void App::registerInputActions() {
actions_.setDefaultShortcut("config.save", "Ctrl+Shift+Alt+I");
// Preferences > Input: the key style.
- add("input.style_zbrush", "ZBrush-style", nullptr, "Preferences > Input", "",
- "Keys and gestures as in ZBrush, for hands that know it: I is RGB Intensity, 9 saves a snapshot, the number keys don't pick brushes, and "
+ add("input.style_zbrush", "Classic sculpting keys", nullptr, "Preferences > Input", "",
+ "The classic sculpting keys and gestures: I is RGB Intensity, 9 saves a snapshot, the number keys don't pick brushes, and "
"Ctrl+drag on the background only clears the mask.",
[this] { setInputStyle(0); }, [this] { return uiPrefs_.inputStyle == 0; });
add("input.style_sculptforge", "SculptForge", nullptr, "Preferences > Input", "",
@@ -190,7 +190,7 @@ void App::registerInputActions() {
add("input.style_maya", "Maya", nullptr, "Preferences > Input", "",
"Maya's view controls: Alt+left-drag orbits, Alt+middle-drag pans, Alt+right-drag zooms, anywhere on the "
"canvas. Ctrl inverts a stroke, Ctrl+Alt masks (Ctrl+Alt+drag on the background clears the mask), Shift "
- "smooths, Ctrl+Shift hides and shows. ZBrush's keys stay for everything else.",
+ "smooths, Ctrl+Shift hides and shows. The Classic sculpting keys stay for everything else.",
[this] { setInputStyle(3); }, [this] { return uiPrefs_.inputStyle == 3; });
add("input.emulate_numpad", "Emulate Numpad", nullptr, "Preferences > Input", "",
"Blender style: the number keys above the letters work as the numpad (1 front, 3 right, 7 top, 5 "
@@ -198,13 +198,13 @@ void App::registerInputActions() {
[this] { uiPrefs_.emulateNumpad = !uiPrefs_.emulateNumpad; }, [this] { return uiPrefs_.emulateNumpad; },
[this] { return blenderStyle(); });
add("input.right_click_menu", "Right click opens the Quick Menu", nullptr, "Preferences > Input", "",
- "A right click on the canvas, without dragging, opens the Quick Menu under the cursor, as in ZBrush (Space "
+ "A right click on the canvas, without dragging, opens the Quick Menu under the cursor (Space "
"does too). A right drag still turns, pans or zooms the view. A pen button set to Right click works the same.",
[this] { uiPrefs_.rightClickQuickMenu = !uiPrefs_.rightClickQuickMenu; },
[this] { return uiPrefs_.rightClickQuickMenu; });
add("input.space_camera", "Hold Space and drag to move the camera", nullptr, "Preferences > Input", "",
"While Space is held, a drag on the canvas moves the camera: left-drag turns it, right- or middle-drag pans, "
- "and with Ctrl held too a drag zooms (#43). Off by default: in ZBrush, Space opens the Quick Menu (with this "
+ "and with Ctrl held too a drag zooms (#43). Off by default: with the Classic sculpting keys, Space opens the Quick Menu (with this "
"on, a right click still does). Typing a space in a text field is never taken.",
[this] { uiPrefs_.spaceCamera = !uiPrefs_.spaceCamera; }, [this] { return uiPrefs_.spaceCamera; });
add("input.emulate_3_button", "Emulate 3 Button Mouse", nullptr, "Preferences > Input", "",
@@ -569,10 +569,10 @@ void App::drawInputSection() {
ImGui::SameLine();
int rotation = uiPrefs_.turntable ? 1 : 0;
ImGui::SetNextItemWidth(-1);
- const std::string rotations = std::string(tr("Free (ZBrush)")) + '\0' + tr("Turntable") + '\0';
+ const std::string rotations = std::string(tr("Free")) + '\0' + tr("Turntable") + '\0';
if (ImGui::Combo("##rotation_input", &rotation, rotations.c_str())) uiPrefs_.turntable = rotation == 1;
ui::HelpText("Rotation", nullptr,
- "Free: the model turns about the screen's axes and can roll over the top, as in ZBrush. Turntable: it "
+ "Free: the model turns about the screen's axes and can roll over the top. Turntable: it "
"stays upright, as in Blender or Maya.",
"Preferences > Input");
drawRadialMenusSection(); // RadialMenu.cpp
@@ -609,7 +609,7 @@ void App::drawZIntensitySlider(const char* id) {
if (ui::SliderInside(id, &shown, 1.0f, 100.0f, smooth ? "Smooth Intensity %.0f" : "Intensity %.0f"))
value = std::clamp(shown / 100.0f, 0.01f, 1.0f);
ui::HelpText(smooth ? "Smooth Intensity" : "Intensity", "U",
- smooth ? "How strongly Smooth works. Smooth keeps its own value, as in ZBrush: hold Shift to see and "
+ smooth ? "How strongly Smooth works. Smooth keeps its own value: hold Shift to see and "
"set it. Ctrl+click to type."
: "How strongly each dab changes the surface (1-100). Holding Shift shows Smooth's own value. "
"Ctrl+click to type.",
diff --git a/src/app/LightBox.cpp b/src/app/LightBox.cpp
index 36d6a2ee..c4b6e20b 100644
--- a/src/app/LightBox.cpp
+++ b/src/app/LightBox.cpp
@@ -586,7 +586,7 @@ void LightBox::drawHeader(App& app, float width) {
ImDrawList* dl = ImGui::GetWindowDrawList();
const ImVec2 origin = ImGui::GetCursorScreenPos();
- // Title (an item, so tests and help find "LightBox").
+ // Title (an item, so tests and help find "Library").
{
const char* title = ICON_LC_IMAGES " Library";
const ImVec2 ts = ImGui::CalcTextSize(title);
@@ -997,7 +997,7 @@ void LightBox::drawPreferences(App& app) {
UiLayout& layout = app.layout_;
ImGui::Checkbox(tr("Show at startup##lightbox"), &showAtStartup);
ui::HelpText("Show at startup", nullptr,
- "Open the Library on the Project tab when SculptForge starts (as ZBrush does).",
+ "Open the Library on the Project tab when SculptForge starts.",
"Preferences > Library");
ImGui::SetNextItemWidth(-1);
ImGui::SliderInt("##lbrowspref", &layout.lightboxRows, 1, 4, "Rows %d");
diff --git a/src/app/Palettes.cpp b/src/app/Palettes.cpp
index c5cd379f..e0b69557 100644
--- a/src/app/Palettes.cpp
+++ b/src/app/Palettes.cpp
@@ -310,7 +310,7 @@ void App::drawPalette_Brush() {
ui::HelpAction(*this, "draw.front_faces");
ImGui::SameLine();
ImGui::Checkbox(tr("Invert (Alt)"), &invertToggle_);
- ui::HelpText("Invert", "Alt", "Brushes subtract instead of add (ZBrush Zsub). Holding Alt flips it for one stroke.", "Brush");
+ ui::HelpText("Invert", "Alt", "Brushes subtract instead of add. Holding Alt flips it for one stroke.", "Brush");
ui::Checkbox("Connected only##draw.connected_only", &uiPrefs_.connectedOnly);
ui::HelpAction(*this, "draw.connected_only");
ImGui::SameLine();
@@ -320,7 +320,7 @@ void App::drawPalette_Brush() {
ui::HelpText("Smooth keeps volume", nullptr,
"The Smooth brush (and Shift) removes bumps without shrinking the form, instead of the plain smooth "
"that also flattens it. Either way, let go of Shift while still pressing a Shift-smooth stroke to "
- "switch to the other smooth for the rest of the stroke (ZBrush's alternate smooth).",
+ "switch to the other smooth for the rest of the stroke.",
"Brush");
ImGui::Checkbox(tr("Smooth face group borders only##smooth_group_borders"), &smoothGroupBorders_);
ui::HelpText("Smooth face group borders only", nullptr,
@@ -712,7 +712,7 @@ void App::drawPalette_Tool() {
}
if (subpalette("tool.subtool", "Parts")) {
tray::Section section;
- Demo::pushScope("SubTools");
+ Demo::pushScope("Parts");
drawSubToolsContents();
Demo::popScope();
drawExtractContents(); // PanelExtract.cpp
@@ -722,7 +722,7 @@ void App::drawPalette_Tool() {
}
if (subpalette("tool.zspheres", "Forge Spheres")) {
tray::Section section;
- Demo::pushScope("ZSpheres");
+ Demo::pushScope("Forge Spheres");
drawZSpheresContents(); // PanelZSpheres.cpp
Demo::popScope();
}
diff --git a/src/app/PanelGoz.cpp b/src/app/PanelGoz.cpp
index ba0ea8d5..dfb63f9a 100644
--- a/src/app/PanelGoz.cpp
+++ b/src/app/PanelGoz.cpp
@@ -4,6 +4,7 @@
// File > Send to ZBrush: send/receive through the GoZ-compatible bridge, GoZ and STL files.
#include "app/App.h"
+#include "io/BridgeProtocol.h"
#include "io/GozIO.h"
#include <filesystem>
@@ -12,7 +13,7 @@ namespace sf {
namespace {
-const SDL_DialogFileFilter kGozFilters[] = {{"GoZ-compatible files", "GoZ;goz"}, {"All files", "*"}};
+const SDL_DialogFileFilter kGozFilters[] = {{"Bridge files", bridge::kDialogPattern}, {"All files", "*"}};
long long fileTime(const std::string& path) {
if (path.empty()) return 0;
@@ -30,7 +31,7 @@ void SDLCALL App::onGozFileChosen(void* userdata, const char* const* files, int)
std::string path = files[0];
if (req->kind != GozFile::Import &&
std::filesystem::path(std::u8string(path.begin(), path.end())).extension().empty())
- path += req->kind == GozFile::ExportStl ? ".stl" : ".GoZ";
+ path += req->kind == GozFile::ExportStl ? ".stl" : bridge::kExt;
std::lock_guard lock(req->app->pendingMutex_);
req->app->gozPendingFiles_.push_back({req->kind, std::move(path)});
}
@@ -48,7 +49,7 @@ void App::runGozCommand(const std::string& name, const Args& args) {
void App::drawGozMenu() {
if (!gozInitialised_) pollGoz(); // sets up the dialogs
- if (!ImGui::BeginMenu("Send to ZBrush")) return;
+ if (!ImGui::BeginMenu("Bridge")) return;
const std::string root = gozFolder_[0] ? std::string(gozFolder_) : gozDefaultRoot();
const bool bridge = !root.empty();
if (ImGui::MenuItem("Send")) {
@@ -56,18 +57,18 @@ void App::drawGozMenu() {
if (bridge) gozAutoReceive_ = true; // a round trip comes back the same way
}
if (!bridge && ImGui::IsItemHovered()) ImGui::SetTooltip("%s", gozUnavailableMessage().c_str());
- if (ImGui::MenuItem("Receive from ZBrush")) runGozCommand("goz_receive");
+ if (ImGui::MenuItem("Receive")) runGozCommand("goz_receive");
if (!bridge && ImGui::IsItemHovered()) ImGui::SetTooltip("%s", gozUnavailableMessage().c_str());
if (ImGui::MenuItem("Receive automatically", nullptr, &gozAutoReceive_, bridge) && gozAutoReceive_)
gozListTime_ = fileTime(gozObjectListPath(root));
if (bridge) ImGui::TextDisabled("Bridge folder: %s", root.c_str());
- else ImGui::TextDisabled("ZBrush runs on Windows and macOS only;\nGoZ-compatible files still import and export.");
+ else ImGui::TextDisabled("No default bridge folder on this system;\nBridge files still import and export.");
ImGui::SetNextItemWidth(260.0f * uiScale_);
ImGui::InputTextWithHint("##gozfolder", "Custom bridge folder (optional)", gozFolder_, sizeof(gozFolder_));
ImGui::Separator();
- if (ImGui::MenuItem("Import GoZ-compatible file..."))
+ if (ImGui::MenuItem("Import Bridge file..."))
SDL_ShowOpenFileDialog(onGozFileChosen, &gozDialogs_[int(GozFile::Import)], window_, kGozFilters, 2, nullptr, false);
- if (ImGui::MenuItem("Export GoZ-compatible file..."))
+ if (ImGui::MenuItem("Export Bridge file..."))
SDL_ShowSaveFileDialog(onGozFileChosen, &gozDialogs_[int(GozFile::Export)], window_, kGozFilters, 2, nullptr);
ImGui::EndMenu();
}
diff --git a/src/app/PanelMasking.cpp b/src/app/PanelMasking.cpp
index 5d7c49e9..ad8240eb 100644
--- a/src/app/PanelMasking.cpp
+++ b/src/app/PanelMasking.cpp
@@ -273,7 +273,7 @@ void App::drawMaskingSection() {
tray::SliderInt("##maskborderrings", &maskBorderRings_, 1, 20, "Rings %d");
ui::Checkbox("Face Group borders##maskborder", &maskBorderGroups_);
ui::HelpText("Face Group borders", nullptr,
- "By border also masks where face groups meet (ZBrush: Mask by polygroup border).", "Tool > Masking");
+ "By border also masks where face groups meet.", "Tool > Masking");
ImGui::SameLine();
ui::Checkbox("Soft##maskborder", &maskBorderSoft_);
ui::HelpText("Soft", nullptr, "By border fades the mask from the border towards the innermost ring.",
diff --git a/src/app/PanelPolypaint.cpp b/src/app/PanelPolypaint.cpp
index 468c0aa8..728f91cd 100644
--- a/src/app/PanelPolypaint.cpp
+++ b/src/app/PanelPolypaint.cpp
@@ -4,6 +4,7 @@
// Polypaint & Materials panel: the Paint brush (ZBrush Rgb / Zadd), colour
// picker and swatches, fills, and the viewport MatCap material picker.
#include "app/App.h"
+#include "app/AssetLibrary.h"
#include "app/Ui.h"
#include "app/I18n.h"
@@ -39,7 +40,7 @@ std::string u8string(const std::filesystem::path& p) {
} // namespace
-std::string App::matcapFolder() const { return library_.user.empty() ? std::string() : library_.user + "/MatCaps"; }
+std::string App::matcapFolder() const { return library_.user.empty() ? std::string() : library_.user + "/" + libraryTabFolder(LibraryTab::Material); }
// Custom MatCaps (#15): the studio folders (SCULPTFORGE_MATCAP_PATH), then the library's MatCaps folder.
void App::loadMatcapLibrary() {
@@ -89,7 +90,7 @@ void App::registerPaintUiCommands() {
// A view setting, so it lives with the app (scripts: --script "set_material name=Chrome").
commands_.add({"set_material",
"Viewport material: a built-in Lit Sphere (Sculpt, the default, is made for reading strokes), one of "
- "your own (load_matcap) or studio (soft clay lighting in the Base colour). Vertex Paint multiplies "
+ "your own (loaded with Load Lit Sphere) or studio (soft clay lighting in the Base colour). Vertex Paint multiplies "
"the lit sphere; cavity shading stays on.",
{{"name", ParamSpec::Type::String, "A Lit Sphere's name (Soft Clay, Sculpt, Red Wax, Clay, Skin, Chrome, "
"White, Bronze or a custom one) or studio.", true}},
@@ -107,10 +108,10 @@ void App::registerPaintUiCommands() {
commands_.add({"load_matcap",
"Load a Lit Sphere: a lit-sphere image (PNG, JPG or EXR; a non-square image is cropped to its centre) "
"becomes a viewport material named after the file, and the view uses it. It is copied into the "
- "library's MatCaps folder (Documents/SculptForge/MatCaps), so it is there next time; projects "
+ "library's Lit Spheres folder (Documents/SculptForge/Lit Spheres), so it is there next time; projects "
"that use it carry a copy.",
{{"path", ParamSpec::Type::String, "The image file.", true},
- {"keep", ParamSpec::Type::Bool, "Copy it into the library's MatCaps folder (default true).", false}},
+ {"keep", ParamSpec::Type::Bool, "Copy it into the library's Lit Spheres folder (default true).", false}},
[this](Document&, const Args& a) -> CommandResult {
CustomMatcap m;
std::string err;
@@ -130,7 +131,7 @@ void App::registerPaintUiCommands() {
} else {
const std::u8string s = to.u8string();
m.path.assign(s.begin(), s.end());
- kept = " (kept in the MatCaps folder)";
+ kept = " (kept in the Lit Spheres folder)";
}
}
hiddenMatcapFiles_.erase(m.path);
@@ -139,7 +140,7 @@ void App::registerPaintUiCommands() {
return {true, std::string("Material: ") + matcapName(index) + kept};
}});
commands_.add({"remove_matcap",
- "Remove one of your Lit Spheres from the material lists. One from the library's MatCaps folder goes to "
+ "Remove one of your Lit Spheres from the material lists. One from the library's Lit Spheres folder goes to "
"the trash (the Recycle Bin on Windows); where that isn't possible (macOS for now) it is hidden "
"for this session and its file stays put. Built-in Lit Spheres can't be removed.",
{{"name", ParamSpec::Type::String, "The Lit Sphere's name.", true}},
@@ -242,7 +243,7 @@ void App::registerPaintUiCommands() {
}});
// The scene's shading; SubTools can override it (subtool_shading). Also the preference for new sessions.
commands_.add({"set_shading",
- "Viewport shading for every Part that doesn't set its own (subtool_shading): smooth (the "
+ "Viewport shading for every Part that doesn't set its own (subtool_shading): smooth (the " // marks-pending
"default) or flat, where each polygon shows its own face, so the mesh's structure reads.",
{{"mode", ParamSpec::Type::String, "smooth or flat.", true}},
[this](Document&, const Args& a) -> CommandResult {
@@ -318,7 +319,7 @@ void App::beginPaintStroke() {
void App::finishPaintStroke(UndoRecord& record) {
if (texturePainter_.active()) texturePainter_.end(record);
if (!paintSnapshot_) return;
- // The colours the stroke recorded are the white it started from; restoring "no polypaint" replaces them.
+ // The colours the stroke recorded are the white it started from; restoring "no vertex paint" replaces them.
record.colors = {};
record.paintAlpha = {};
record.paint = std::move(paintSnapshot_);
@@ -363,7 +364,7 @@ void App::drawPalette_Color() {
if (painting) ImGui::PopStyleColor();
ui::HelpAction(*this, "draw.paint");
ImGui::Checkbox(tr("RGB while sculpting"), &paintRgb_);
- if (ImGui::IsItemHovered()) ImGui::SetTooltip("%s", tr("Sculpt brushes also paint the colour (ZBrush Rgb with Zadd)"));
+ if (ImGui::IsItemHovered()) ImGui::SetTooltip("%s", tr("Sculpt brushes also paint the colour"));
// The picker edits display (sRGB) values; the mesh stores linear colour.
glm::vec3 srgb = linearToSrgb(doc_.paintColor);
@@ -449,7 +450,7 @@ void App::drawPalette_Material() {
if (ImGui::Button(tr("Load Lit Sphere..."), ImVec2(-1, 0))) loadMatcapDialog();
ui::HelpText("Load Lit Sphere", nullptr,
"Use a Lit Sphere image of your own: a lit sphere filling a square PNG, JPG or EXR. It joins the list "
- "and is kept in Documents/SculptForge/MatCaps; images you put in that folder show up when a material list "
+ "and is kept in Documents/SculptForge/Lit Spheres; images you put in that folder show up when a material list "
"opens. Right-click one of your Lit Spheres to remove it.",
"Material");
ImGui::ColorEdit3(tr("Base colour"), &renderSettings_.baseColor.x, ImGuiColorEditFlags_NoInputs);
@@ -514,7 +515,7 @@ void App::drawViewportShadingControls() {
if (v.environmentBackground)
slider("##Blur", "blur", &v.backgroundBlur, 0.0f, 1.0f, tr("Blur %.2f"), "How soft the environment behind the model is.");
slider("##Roughness", "roughness", &v.pbrRoughness, 0.0f, 1.0f, tr("Roughness %.2f"),
- "Roughness of Parts without a material texture (their colour comes from polypaint or the base colour).");
+ "Roughness of Parts without a material texture (their colour comes from vertex paint or the base colour).");
slider("##Metallic", "metallic", &v.pbrMetallic, 0.0f, 1.0f, tr("Metallic %.2f"),
"Metallic of Parts without a material texture.");
slider("##Cavity", "cavity", &v.pbrCavity, 0.0f, 1.0f, tr("Cavity %.2f"),
diff --git a/src/app/PanelProject.cpp b/src/app/PanelProject.cpp
index baf6ebe3..e2c9347d 100644
--- a/src/app/PanelProject.cpp
+++ b/src/app/PanelProject.cpp
@@ -68,7 +68,7 @@ void readBool(const Json& j, const char* key, bool& v) { v = j[key].asBool(v); }
std::string matcapAttachmentName(const std::string& name) {
std::string safe;
for (unsigned char c : name) safe += std::isalnum(c) || c == ' ' || c == '_' || c == '-' || c >= 0x80 ? char(c) : '_';
- return "matcaps/" + (safe.empty() ? std::string("MatCap") : safe) + ".png";
+ return "matcaps/" + (safe.empty() ? std::string("LitSphere") : safe) + ".png";
}
void SDLCALL onProjectChosen(void* userdata, const char* const* files, int) {
diff --git a/src/app/PanelRetopo.cpp b/src/app/PanelRetopo.cpp
index 95a2168e..2213c4ba 100644
--- a/src/app/PanelRetopo.cpp
+++ b/src/app/PanelRetopo.cpp
@@ -61,7 +61,7 @@ void App::registerRetopoUiActions() {
};
add("geometry.qremesh", "Quad Remesh", kQRemeshPath, [this] { startQRemesh(); },
[this] { return !qremesh_ && doc_.mesh.triangleCount() > 0; },
- "Automatic quad retopology, like ZBrush's ZRemesher: rebuilds the Part as clean, all-quad topology whose "
+ "Automatic quad retopology: rebuilds the Part as clean, all-quad topology whose "
"edge loops follow the forms, close to Target Polygons. Runs in the background (Cancel stops it); undoable. "
"Then divide it and use Part > Project > Project All to bring the detail back.",
"qremesh");
@@ -73,7 +73,7 @@ void App::registerRetopoUiActions() {
a.palette = kQRemeshPath;
a.run = [this] { setGuidesMode(!guidesMode_); };
a.checked = [this] { return guidesMode_; };
- a.description = "The Quad Remesh Guides brush (ZBrush's ZRemesher Guides): drag on the model to draw a curve for "
+ a.description = "The Quad Remesh Guides brush: drag on the model to draw a curve for "
"Quad Remesh's edge loops to follow, around an eye, the mouth or a joint. A curve that ends where "
"it started becomes a loop. Symmetry mirrors it; Alt+click a curve to delete it. Pick any "
"brush to sculpt again.";
@@ -401,7 +401,7 @@ void App::drawQRemeshContents() {
ImGui::Checkbox(tr("Keep Original"), &retopo_.keepOriginal);
ui::HelpText("Keep Original", nullptr,
"Keep the Part as it was, hidden, right below the new one (\"<name> Original\"), ready to "
- "Project All its detail back. Off: replace it, as ZBrush does (undo brings it back).",
+ "Project All its detail back. Off: replace it (undo brings it back).",
kQRemeshPath);
ImGui::SameLine();
ImGui::SetCursorPosX(x0 + half + style.ItemSpacing.x); // the right column, inside the section indent
@@ -458,7 +458,7 @@ void App::drawQRemeshGuideControls() {
ui::SliderInside("##qcurves", &curvesStrength_, 0.0f, 100.0f, "Curves Strength %.0f");
ui::HelpText("Curves Strength", nullptr,
"How far around each guide curve the edge flow follows it: 0 = only the edge loop on the curve, 100 = "
- "about six quads to each side (ZBrush's Curves Strength). The loop on the curve is always made.",
+ "about six quads to each side. The loop on the curve is always made.",
kQRemeshPath);
}
diff --git a/src/app/PanelSubTools.cpp b/src/app/PanelSubTools.cpp
index 0274044f..25c597c8 100644
--- a/src/app/PanelSubTools.cpp
+++ b/src/app/PanelSubTools.cpp
@@ -6,6 +6,7 @@
// the ZBrush viewport gesture Alt+click to select a SubTool. Every action goes
// through the subtool_* commands (core/SubTools.cpp).
#include "app/App.h"
+#include "io/BridgeProtocol.h"
#include "app/Demo.h"
#include "app/Theme.h"
#include "app/I18n.h"
@@ -38,7 +39,7 @@ constexpr ImVec4 kRowPressed = theme::rgb(0xffffff, 0.14f);
constexpr ImVec4 kThumbWell = theme::rgb(0x000000, 0.22f); // behind a SubTool thumbnail (#43)
const SDL_DialogFileFilter kAppendFilters[] = {
- {"Models and projects", "obj;fbx;glb;gltf;ply;stl;GoZ;goz;usda;usd;usdz;sfproj"}, {"All files", "*"}};
+ {"Models and projects", "obj;fbx;glb;gltf;ply;stl;" SF_BRIDGE_MESH_EXTS ";usda;usd;usdz;sfproj"}, {"All files", "*"}};
const SDL_DialogFileFilter kInsertFilters[] = {{"Meshes (OBJ, PLY, GLB)", "obj;ply;glb;gltf"}, {"All files", "*"}};
void SDLCALL onAppendChosen(void* userdata, const char* const* files, int) {
diff --git a/src/app/PanelSupport.cpp b/src/app/PanelSupport.cpp
index dd7675e6..0427a883 100644
--- a/src/app/PanelSupport.cpp
+++ b/src/app/PanelSupport.cpp
@@ -109,8 +109,8 @@ void App::drawLookPicker() {
"Neutral grey panels, so your model's colours read true, with one orange accent. The SculptForge layout."},
{"##welcome.look.forge", "Forge Terminal", int(looks::LookId::ForgeTerminal), "tokyo_night", 1,
"Terminal-style tiles in the Tokyo Night colours (blue-grey). Preferences > Interface > Look has more schemes."},
- {"##welcome.look.zbrush", "ZBrush-style layout", int(looks::LookId::Classic), "neutral", 0,
- "The Classic grey look with the alphabetical palette bar and the two-row top shelf, for ZBrush users."},
+ {"##welcome.look.zbrush", "Classic layout", int(looks::LookId::Classic), "neutral", 0,
+ "The Classic grey look with the alphabetical palette bar and the two-row top shelf, for experienced sculptors."},
};
const float s = uiScale_, spacing = ImGui::GetStyle().ItemSpacing.x;
const float w = std::floor((ImGui::GetContentRegionAvail().x - 2.0f * spacing) / 3.0f), h = 92.0f * s;
@@ -163,7 +163,7 @@ void App::drawSupportUi() {
ImGui::SetTooltip("Your first sculpt: a cute owl head from this sphere, step by step, in about ten minutes.");
ImGui::Spacing();
ImGui::TextWrapped("Hold Ctrl over any control to see what it does. The User Guide (Shift+F1) explains every "
- "tool, and Coming from ZBrush lists what is where.");
+ "tool, and Quick tour for experienced sculptors lists what is where.");
// The look (0.10.9, #U6): three cards, the first the default. Existing installs never see this window
// unless they open Help > Welcome, so nobody's look changes by itself.
ImGui::Spacing();
@@ -180,7 +180,7 @@ void App::drawSupportUi() {
const char* help;
};
static const Origin kOrigins[] = {
- {"ZBrush##welcome.from", 0, 0, "ZBrush-style keys and gestures, and the ZBrush-style layout."},
+ {"Classic sculpting keys##welcome.from", 0, 0, "The classic sculpting keys and gestures, and the Classic layout."},
{"Blender##welcome.from", 2, 1, "Blender's navigation and sculpt-mode keys, the SculptForge layout."},
{"Maya##welcome.from", 3, 1, "Maya's Alt+drag view controls, the SculptForge layout."},
{"New to sculpting##welcome.from", 1, 1, "SculptForge's own keys and layout (the default)."},
@@ -195,8 +195,8 @@ void App::drawSupportUi() {
setShellLayout(o.layout);
lookDirty_ = true;
saveProjectPrefs();
- status_ = std::string("Keys: ") + (o.style == 0 ? "ZBrush-style" : o.style == 2 ? "Blender" : o.style == 3 ? "Maya" : "SculptForge") +
- (o.layout == 0 ? ", ZBrush-style layout" : ", SculptForge layout") + " (Preferences changes them)";
+ status_ = std::string("Keys: ") + (o.style == 0 ? "Classic sculpting keys" : o.style == 2 ? "Blender" : o.style == 3 ? "Maya" : "SculptForge") +
+ (o.layout == 0 ? ", Classic layout" : ", SculptForge layout") + " (Preferences changes them)";
}
if (on) ImGui::PopStyleColor();
if (ImGui::IsItemHovered()) ImGui::SetTooltip("%s", o.help);
diff --git a/src/app/PanelVdm.cpp b/src/app/PanelVdm.cpp
index a1f9c42d..3bf02649 100644
--- a/src/app/PanelVdm.cpp
+++ b/src/app/PanelVdm.cpp
@@ -70,7 +70,7 @@ void App::registerVdmActions() {
"vdm_set");
add("vdm.new_plane", "New VDM Plane", ICON_LC_GRID_3X3,
[this] { runCommand("vdm_new_plane", {{"resolution", double(vdmPlaneRes_)}}); }, nullptr,
- "Add a flat VDM plane to sculpt a new brush on (ZBrush's VDM plane template): seen from the top, its border "
+ "Add a flat VDM plane to sculpt a new brush on: seen from the top, its border "
"masked so it stays put; the other Parts are hidden. Sculpt anything (overhangs welcome), then Create VDM.",
"vdm_new_plane");
add("vdm.create", "Create VDM", ICON_LC_STAMP,
@@ -79,8 +79,7 @@ void App::registerVdmActions() {
},
[this] { return doc_.mesh.hasUvs(); },
"Turn the sculpted VDM plane into a vector displacement brush: how far every point moved from the flat grid "
- "becomes the map, saved in your brush library and picked as the VDM brush's map (ZBrush: Create brush from "
- "the VDM plane). Needs the VDM plane (its UVs record where each point started).",
+ "becomes the map, saved in your brush library and picked as the VDM brush's map Needs the VDM plane (its UVs record where each point started).",
"vdm_capture");
add("vdm.export", "Export EXR...", ICON_LC_DOWNLOAD,
[this] { SDL_ShowSaveFileDialog(onVdmExportChosen, this, window_, kExrFilters, 1, nullptr); },
@@ -185,7 +184,7 @@ void App::drawVdmSection() {
ImGui::Checkbox("Swap Y/Z##vdm", &vdmImport_.swapYZ);
ui::HelpText("Swap Y/Z", nullptr,
"For maps that store the surface normal in G instead of B (Y-up apps). Blender's maps and ours need "
- "nothing; ZBrush maps depend on its Vector Displacement Flip options, so try this if a stamp comes "
+ "nothing; maps from other apps depend on how they were exported, so try this if a stamp comes "
"out lying on its side.",
"Brush > Vector Displacement");
ImGui::SameLine();
diff --git a/src/app/PanelZSpheres.cpp b/src/app/PanelZSpheres.cpp
index 98e87b9b..4b9947c1 100644
--- a/src/app/PanelZSpheres.cpp
+++ b/src/app/PanelZSpheres.cpp
@@ -97,13 +97,13 @@ void App::registerZSphereUiActions() {
"zsphere_set_root");
add("zsphere.preview", "Preview", [this] { runCommand("zsphere_preview"); }, active,
[this] { return doc_.mesh.zspherePreview; },
- "Show the skin Make Mesh would build instead of the spheres (ZBrush's Preview). Turn it off to edit the "
+ "Show the skin Make Mesh would build instead of the spheres. Turn it off to edit the "
"spheres again.",
"zsphere_preview", "A");
add("zsphere.make_mesh", "Make Mesh",
[this] { runCommand("zsphere_make_mesh", {{"resolution", double(zsphereResolution_)}}); }, active, nullptr,
"Build the skin as a new, sculptable Part right below (watertight quads, one face group per link), like "
- "ZBrush's Make Adaptive Skin. The Forge Sphere Part is hidden and kept: show it to change the proportions and "
+ "Make Adaptive Skin. The Forge Sphere Part is hidden and kept: show it to change the proportions and "
"make a new mesh.",
"zsphere_make_mesh");
}
diff --git a/src/app/Pickers.cpp b/src/app/Pickers.cpp
index 775757fd..fc6f16fb 100644
--- a/src/app/Pickers.cpp
+++ b/src/app/Pickers.cpp
@@ -436,7 +436,7 @@ std::vector<BrushItem> PickerUi::brushItems(App& app, bool libraryFiles) {
BrushItem guides;
guides.kind = BrushItem::Kind::Guides;
guides.name = "Quad Remesh Guides";
- guides.description = "ZBrush's ZRemesher Guides: draw curves on the model for Quad Remesh's edge loops to follow (a curve "
+ guides.description = "quad remesh Guides: draw curves on the model for Quad Remesh's edge loops to follow (a curve "
"that ends where it started makes a loop). Alt+click a curve to delete it.";
items.push_back(std::move(guides));
for (int i = 0; i < int(app.doc_.brushes.size()); ++i) {
@@ -1132,7 +1132,7 @@ void drawPickers(App& app) {
&app.radiusPx_, kMinDrawSizePx, kMaxDrawSizePx, 1.0f}
: which == PickerUi::Slider::ZIntensity
? Def{s.sliderSmooth ? "Smooth Intensity" : "Intensity", "U",
- s.sliderSmooth ? "How strongly Smooth works (it keeps its own value, as in ZBrush: hold "
+ s.sliderSmooth ? "How strongly Smooth works (it keeps its own value: hold "
"Shift and press U to set it). Type a number and press Enter."
: "How strongly the brush changes the surface (1-100). Drag, or type a "
"number and press Enter.",
@@ -1386,7 +1386,7 @@ void App::drawColorWidget(float width) {
swap |= ImGui::InvisibleButton("##secondary", ImVec2(secondW, swH));
swatch(dl, pb, ImVec2(pb.x + secondW, pb.y + swH), ImVec4(second.x, second.y, second.z, 1.0f),
rounding, s, ImGui::IsItemHovered());
- ui::HelpText("Second colour", nullptr, "Click to swap it with the main colour (ZBrush Alternate).", "Left shelf");
+ ui::HelpText("Second colour", nullptr, "Click to swap it with the main colour.", "Left shelf");
if (swap) std::swap(doc_.paintColor, secondaryColor_);
ui::ActionButton(*this, "color.fill", ImVec2(width, 0), ui::Look::IconLabel);
ImGui::PopStyleVar();
diff --git a/src/app/RadialMenu.cpp b/src/app/RadialMenu.cpp
index 4ea5f804..c4318f7f 100644
--- a/src/app/RadialMenu.cpp
+++ b/src/app/RadialMenu.cpp
@@ -68,8 +68,8 @@ const char* const kDefaultKeys[] = {"T", "Y", "J"}; // free in every input style
std::vector<RadialMenu> App::defaultRadialMenus() {
RadialMenu brushes;
brushes.name = "Brushes";
- for (const char* id : {"brush.standard", "brush.claybuildup", "brush.move", "brush.damstandard", "brush.inflate",
- "brush.pinch", "brush.flatten", "brush.snakehook"})
+ for (const char* id : {"brush.standard", "brush.clayblock", "brush.move", "brush.sharpcrease", "brush.inflate",
+ "brush.pinch", "brush.flatten", "brush.tendril"})
brushes.slots.push_back({id, "", ""});
RadialMenu masking;
masking.name = "Masking";
diff --git a/src/app/Shell.cpp b/src/app/Shell.cpp
index 4015bc55..03953103 100644
--- a/src/app/Shell.cpp
+++ b/src/app/Shell.cpp
@@ -6,6 +6,7 @@
// canvas, the left and right trays with their dividers, customize-mode drag
// and drop, layout presets, and the actions behind all of it.
#include "app/App.h"
+#include "io/BridgeProtocol.h"
#include "app/Demo.h"
#include "app/Shell.h"
@@ -359,7 +360,7 @@ void App::registerShellActions() {
"Cuts a sharp crease; Alt raises a ridge.",
"Presses the surface toward a plane.",
"Pulls the surface toward the stroke to tighten edges.",
- "A sharp V-shaped crease with the sides pinched in (ZBrush DamStandard).",
+ "A sharp V-shaped crease with the sides pinched in.",
"Square, flat-topped clay strokes for blocking in forms.",
"Pulls the surface out into horns and tendrils.",
"Trim: shaves away everything above a plane.",
@@ -396,16 +397,16 @@ void App::registerShellActions() {
add(std::move(a));
}
add({"draw.sculpt", "Sculpt", nullptr,
- "Brushes change the shape (ZBrush Zadd/Zsub). Turn on Rgb to paint colour at the same time.", "Draw", "", "",
+ "Brushes change the shape. Turn on Rgb to paint colour at the same time.", "Draw", "", "",
[this] { paintMode_ = false; }, [this] { return !paintMode_; }, nullptr});
add({"draw.paint", "Paint", ICON_LC_PAINTBRUSH,
- "Paint colour without sculpting (ZBrush Rgb on, Zadd off). Alt paints back to white, Shift still smooths.",
+ "Paint colour without sculpting. Alt paints back to white, Shift still smooths.",
"Draw", "P", "", [this] { paintMode_ = !paintMode_; }, [this] { return paintMode_; }, nullptr});
add({"draw.zadd", "Add", nullptr, "Brushes add to the surface. Hold Alt to subtract for one stroke.", "Draw", "", "",
[this] { invertToggle_ = false; }, [this] { return !invertToggle_; }, nullptr});
add({"draw.zsub", "Sub", nullptr, "Brushes subtract from the surface. Hold Alt to add for one stroke.", "Draw", "", "",
[this] { invertToggle_ = true; }, [this] { return invertToggle_; }, nullptr});
- flag("draw.rgb", "Rgb", nullptr, "Draw", "", &paintRgb_, "Sculpt brushes also paint the colour (ZBrush Rgb with Zadd).");
+ flag("draw.rgb", "Rgb", nullptr, "Draw", "", &paintRgb_, "Sculpt brushes also paint the colour.");
flag("draw.front_faces", "Front", nullptr, "Brush", "", &frontFacesOnly_,
"Front faces only: brushes leave the far side of thin parts alone.");
flag("draw.connected_only", "Connected only", nullptr, "Brush", "", &uiPrefs_.connectedOnly,
@@ -417,7 +418,7 @@ void App::registerShellActions() {
"and out the back, as a cylinder along the view (Blender's Projected from View). Turn on Connected only too "
"to keep it to one piece.");
add({"draw.dynamic", "Dynamic", nullptr,
- "Dynamic topology (ZBrush's Sculptris Pro): brushes add triangles where they need detail and remove them "
+ "Dynamic topology: brushes add triangles where they need detail and remove them "
"where they don't, so you can pull out horns or fingers without stretching. Detail sets how small the "
"triangles get; zoom in or shrink the brush for finer ones. Needs a mesh without subdivision levels; quads "
"under the brush become triangles and UVs are dropped (Undo brings them back).",
@@ -530,7 +531,7 @@ void App::registerShellActions() {
[this] { return !renderSettings_.flatShading; }, nullptr});
add({"material.flat", "Flat", nullptr,
"Flat shading: every polygon shows its own face, so the mesh's structure and each stroke's effect on it read "
- "clearly (as in ZBrush). Parts set to Smooth or Flat keep their own. A preference: Store Config keeps it.",
+ "clearly. Parts set to Smooth or Flat keep their own. A preference: Store Config keeps it.",
"Material", "", "", [this] { runCommand("set_shading", {{"mode", std::string("flat")}}); },
[this] { return renderSettings_.flatShading; }, nullptr});
// The view's background (#21; Preferences > Display, Render palette).
@@ -582,7 +583,7 @@ void App::registerShellActions() {
add({"file.import", "Import", ICON_LC_IMPORT, "Add a model file as a new Part.", "Tool", "", "",
[this] {
static const SDL_DialogFileFilter filters[] = {
- {"Models", "obj;fbx;glb;gltf;ply;stl;GoZ;goz;usda;usd;usdz"}, {"All files", "*"}};
+ {"Models", "obj;fbx;glb;gltf;ply;stl;" SF_BRIDGE_MESH_EXTS ";usda;usd;usdz"}, {"All files", "*"}};
SDL_ShowOpenFileDialog(
[](void* user, const char* const* files, int) {
if (files && files[0]) static_cast<App*>(user)->queueFile(FileAction::AppendSubtool, files[0]);
@@ -664,8 +665,8 @@ void App::registerShellActions() {
"Menus by task (File, Edit, Sculpt, Paint, Mesh, View, Render, Help), a status bar and a one-row tool shelf.",
"Preferences > Interface > Look", "", "", [this] { setShellLayout(1); lookDirty_ = true; },
[this] { return uiPrefs_.shellLayout == 1; }, nullptr});
- add({"ui.layout.zbrush", "ZBrush-style layout", ICON_LC_LAYOUT_TEMPLATE,
- "The alphabetical palette bar and the two-row top shelf, as ZBrush users expect.", "Preferences > Interface > Look", "",
+ add({"ui.layout.zbrush", "Classic layout", ICON_LC_LAYOUT_TEMPLATE,
+ "The alphabetical palette bar and the two-row top shelf, as experienced sculptors expect.", "Preferences > Interface > Look", "",
"", [this] { setShellLayout(0); lookDirty_ = true; }, [this] { return uiPrefs_.shellLayout == 0; }, nullptr});
commands_.add({"ui_look",
"Interface look and layout (Preferences > Interface > Look). Only changes how the interface looks.",
@@ -678,7 +679,7 @@ void App::registerShellActions() {
{"effects", ParamSpec::Type::Bool, "Phosphor's scanlines and glow (on the interface only).", false},
{"outlines", ParamSpec::Type::String, "The tiled looks' panel borders: off, subtle (the default) or on.", false},
{"outline_opacity", ParamSpec::Type::Number, "How strong those borders are, 0-100 (default 100).", false},
- {"layout", ParamSpec::Type::String, "sculptforge or zbrush (default: the look's, else unchanged).", false},
+ {"layout", ParamSpec::Type::String, "sculptforge or classic (default: the look's, else unchanged).", false},
{"card", ParamSpec::Type::Bool, "Show the one-time \"SculptForge has a new look\" card (for tests).", false}},
[this](Document&, const Args& a) -> CommandResult {
theme::LookSettings& l = uiPrefs_.look;
@@ -707,14 +708,14 @@ void App::registerShellActions() {
l.outlineOpacity = std::clamp(float(argNumber(a, "outline_opacity", 100.0)) / 100.0f, 0.0f, 1.0f);
if (a.contains("layout")) {
const std::string k = argString(a, "layout");
- if (k != "sculptforge" && k != "zbrush") return {false, "layout must be sculptforge or zbrush"};
+ if (k != "sculptforge" && k != "classic" && k != "zbrush") return {false, "layout must be sculptforge or classic"};
layoutKind = k == "sculptforge" ? 1 : 0;
}
setShellLayout(layoutKind);
lookDirty_ = true;
if (a.contains("card")) newLookCard_ = argBool(a, "card", false);
return {true, std::string("Look: ") + looks::lookName(looks::LookId(l.look)) +
- (layoutKind == 1 ? ", SculptForge layout" : ", ZBrush-style layout")};
+ (layoutKind == 1 ? ", SculptForge layout" : ", Classic layout")};
}});
int count = 0;
@@ -1374,7 +1375,7 @@ void App::drawStatusBar(const ShellGeometry& g) {
const ImVec4 col = open ? (style == Status::Terminal ? theme::textOnAccent : theme::textBright) : theme::text;
textAt(menuFont, a.x + 8.0f * s, col, shown);
ImGui::LogText("%s", tr(m.name));
- ui::HelpText(m.name, nullptr, "Open this menu. Its sections are the palettes of the ZBrush-style layout.", "Menus");
+ ui::HelpText(m.name, nullptr, "Open this menu. Its sections are the palettes of the Classic layout.", "Menus");
// Click to open or close; while one is open, pointing at another menu switches to it, as in a menu bar.
const bool switchTo = openMenu >= 0 && !open && hovered;
if (pressed || switchTo) {
diff --git a/src/app/Shell.h b/src/app/Shell.h
index 331cf455..0c20ee2e 100644
--- a/src/app/Shell.h
+++ b/src/app/Shell.h
@@ -22,7 +22,7 @@ struct PaletteDef {
const char* id; // "tool", also the UiLayout tray entry
const char* name; // "Tool", shown in the palette bar (sorted by it)
const char* icon; // ICON_LC_*
- const char* scope; // extra name UI tests find its items under ("SubTools/Append"), or nullptr
+ const char* scope; // extra name UI tests find its items under ("Parts/Append"), or nullptr
void (App::*draw)();
};
const PaletteDef* palettes(int& count); // alphabetical
diff --git a/src/app/UiLayout.cpp b/src/app/UiLayout.cpp
index 1c487f2d..0daa5185 100644
--- a/src/app/UiLayout.cpp
+++ b/src/app/UiLayout.cpp
@@ -2,6 +2,8 @@
// SPDX-License-Identifier: GPL-3.0-or-later
#include "app/UiLayout.h"
+#include "core/LegacyNames.h"
+
#include <algorithm>
namespace sf {
@@ -18,7 +20,10 @@ void readStrings(const Json& j, std::vector<std::string>& out) {
if (!j.isArray()) return;
out.clear();
for (size_t i = 0; i < j.size(); ++i)
- if (j[i].isString() && !j[i].asString().empty()) out.push_back(j[i].asString());
+ if (j[i].isString() && !j[i].asString().empty()) {
+ const std::string_view now = legacy::renamed(legacy::kActionIds, j[i].asString());
+ out.push_back(now.empty() ? j[i].asString() : std::string(now));
+ }
}
} // namespace
@@ -41,9 +46,9 @@ UiLayout standardLayout() {
"view.frame", "widget.nav.move", "widget.nav.zoom", "widget.nav.rotate", "sep",
"view.polyf", "view.polygroups", "view.mask", "view.polypaint", "sep",
"subtool.solo", "view.splats"};
- l.bottomShelf = {"brush.standard", "brush.clay", "brush.claybuildup", "brush.damstandard", "brush.move",
+ l.bottomShelf = {"brush.standard", "brush.clay", "brush.clayblock", "brush.sharpcrease", "brush.move",
"brush.smooth", "brush.inflate", "brush.pinch", "brush.flatten", "brush.crease",
- "brush.trim", "brush.snakehook", "brush.layer", "brush.nudge", "brush.kelvingrab",
+ "brush.trim", "brush.tendril", "brush.layer", "brush.nudge", "brush.kelvingrab",
"brush.detailclone", "brush.paint",
"widget.add_brush"};
return l;
diff --git a/src/app/UiTest.cpp b/src/app/UiTest.cpp
index 53005264..cecccf82 100644
--- a/src/app/UiTest.cpp
+++ b/src/app/UiTest.cpp
@@ -1694,7 +1694,7 @@ bool Demo::parseStep(int line, const std::vector<std::string>& w, std::string& e
const std::string n = w[1];
const int style = n == "zbrush" ? 0 : n == "sculptforge" ? 1 : n == "blender" ? 2 : n == "maya" ? 3 : -1;
if (style < 0) {
- fail(line, "input_style takes zbrush, sculptforge, blender or maya");
+ fail(line, "input_style takes zbrush, sculptforge, blender or maya"); // marks-pending
return false;
}
run([this, style] { app_.setInputStyle(style); });
diff --git a/src/app/UserGuide.cpp b/src/app/UserGuide.cpp
index 9bd09fa4..be6ab8fe 100644
--- a/src/app/UserGuide.cpp
+++ b/src/app/UserGuide.cpp
@@ -306,7 +306,7 @@ struct CalloutLook {
};
constexpr CalloutLook kCallouts[] = {
{"Tip", IM_COL32(0x62, 0xc0, 0x7e, 0xff)}, {"Note", IM_COL32(0x6f, 0xa8, 0xe6, 0xff)},
- {"ZBrush", IM_COL32(0xf0, 0x88, 0x2e, 0xff)}, {"Not yet", IM_COL32(0xa9, 0x90, 0xdc, 0xff)},
+ {"Experienced sculptor?", IM_COL32(0xf0, 0x88, 0x2e, 0xff)}, {"Not yet", IM_COL32(0xa9, 0x90, 0xdc, 0xff)},
{"Warning", IM_COL32(0xe5, 0x60, 0x4a, 0xff)}, {"Important", IM_COL32(0xe5, 0x60, 0x4a, 0xff)},
};
@@ -443,15 +443,15 @@ std::string UserGuide::chapterFor(const std::string& palette, const std::string&
auto idStarts = [&](const char* p) { return actionId.rfind(p, 0) == 0; };
// Palette paths by SculptForge's names, and the older ZBrush-style ones (stored layouts, scripts).
if (starts("Tool > Geometry > Quad Remesh") || starts("Tool > Geometry > QRemesh") || starts("Tool > Parts > Project") ||
- starts("Tool > SubTool > Project"))
+ starts("Tool > Part > Project"))
return "retopology.md";
- if (starts("Tool > Parts") || starts("Tool > SubTool")) return "parts.md";
- if (starts("Tool > Forge Spheres") || starts("Tool > ZSpheres")) return "forge-spheres.md";
+ if (starts("Tool > Parts") || starts("Tool > Part")) return "parts.md";
+ if (starts("Tool > Forge Spheres") || starts("Tool > Forge Spheres")) return "forge-spheres.md";
if (starts("Tool > Layers")) return "layers.md";
if (starts("Tool > Facial Shapes")) return "facial-shapes.md";
if (starts("Tool > Geometry") || starts("Tool > Remesh")) return "geometry.md";
if (starts("Tool > Masking")) return "masking.md";
- if (starts("Tool > Face Groups") || starts("Tool > Polygroups") || starts("Tool > Visibility")) return "face-groups.md";
+ if (starts("Tool > Face Groups") || starts("Tool > Face groups") || starts("Tool > Visibility")) return "face-groups.md";
if (starts("Tool > Selection Sets")) return "selection-sets.md";
if (starts("Tool > Export")) return "exporting.md";
if (starts("Tool > Display")) return "interface.md";
@@ -465,7 +465,7 @@ std::string UserGuide::chapterFor(const std::string& palette, const std::string&
if (starts("File > Maya")) return "maya.md";
if (starts("File > Capture from phone") || actionId == "file.capture_phone") return "phone-capture.md";
if (starts("File > Export") || idStarts("file.export") || actionId == "file.send_unreal" || actionId == "file.save_splats" ||
- starts("File > Send to ZBrush") || starts("File > GoZ"))
+ starts("File > Bridge") || starts("File > Bridge files"))
return "exporting.md";
if (starts("File")) return "projects.md";
if (starts("Generate")) return "generate-3d.md";
@@ -478,7 +478,7 @@ std::string UserGuide::chapterFor(const std::string& palette, const std::string&
return "gizmo.md";
if (starts("Transform")) return idStarts("transform.symmetry") ? "sculpting.md" : "navigation.md";
if (starts("Render") || starts("Edit") || starts("Help") || starts("Palettes") || starts("Preferences") ||
- starts("Library") || starts("LightBox"))
+ starts("Library"))
return "interface.md";
return {};
}
diff --git a/src/app/main.cpp b/src/app/main.cpp
index 1376d8ac..0c7d719b 100644
--- a/src/app/main.cpp
+++ b/src/app/main.cpp
@@ -36,7 +36,7 @@ void usage() {
" --view YAW,PITCH Camera angles in degrees (default -30,-15)\n"
" --zoom F Move the camera F times closer than the framed view (default 1)\n"
" --wireframe Render with wireframe overlay\n"
- " --polygroups Render with face group colours\n"
+ " --polygroups Render with face group colours\n" // marks-pending
" --hide-mesh Render only the Gaussian splats\n"
" --demo NAME Play a scripted demo (sculpt, image-to-3d, brush-lab, game-ready, splats)\n"
" --record out.mp4 Record the demo offscreen to a video (needs ffmpeg) and exit\n"
diff --git a/src/cli/McpServer.cpp b/src/cli/McpServer.cpp
index 87b4d6a4..d4ff97d0 100644
--- a/src/cli/McpServer.cpp
+++ b/src/cli/McpServer.cpp
@@ -95,7 +95,7 @@ std::string handleMcpMessage(const CommandRegistry& registry, Document& doc, con
"SculptForge is a digital sculpting tool. One scene is kept for the whole session: start with "
"new_sphere, open (models, Gaussian-splat captures, USD) or image_to_3d, shape it with "
"subdivide/remesh/layers/decimate, then export_glb, export_usd, export_lods or splat_save. "
- "A scene can hold several Parts (separate meshes, see subtool_list): edits apply to the active "
+ "A scene can hold several Parts (separate meshes, see subtool_list): edits apply to the active " // marks-pending
"one, exports write every visible one. "
"Use mesh_info and splat_info to check results. File paths are on the user's machine.");
return reply(id, result).dump();
diff --git a/src/core/Bake.cpp b/src/core/Bake.cpp
index 128253bb..67be177c 100644
--- a/src/core/Bake.cpp
+++ b/src/core/Bake.cpp
@@ -1062,7 +1062,7 @@ void registerBakeCommands(CommandRegistry& reg) {
reg.add({"bake",
"Bake maps from a high-poly source onto the active Part's UVs (the low-poly): tangent-space normal "
"(MikkTSpace), object-space (world) normal, displacement (16-bit PNG + 32-bit EXR), ambient occlusion, cavity, "
- "colour, curvature, thickness, position (16-bit) and ID (polygroups or Parts). Rays go along the low-poly's "
+ "colour, curvature, thickness, position (16-bit) and ID (face groups or Parts). Rays go along the low-poly's "
"smooth normals from 'front' in front of it to 'rear' behind it. The source can be other Parts, or the "
"active Part's own top subdivision level (baked onto its lowest level) or micro level (onto its base). "
"UVs outside 0..1 bake as UDIM tiles. Writes <name>_<map>.png (<name>_<map>.1001.png per UDIM tile) into "
@@ -1086,7 +1086,7 @@ void registerBakeCommands(CommandRegistry& reg) {
{"thickness_rays", T::Number, "Thickness rays per texel. Default 24.", false},
{"thickness_distance", T::Number, "Rays longer than this (a fraction of the size) count as thick. Default 0.1.", false},
{"curvature_radius", T::Number, "A bend of this radius (a fraction of the size) is fully bright or dark. Default 0.02.", false},
- {"id", T::String, "What the ID map colours: polygroups (default) or parts.", false},
+ {"id", T::String, "What the ID map colours: polygroups (default) or parts.", false}, // marks-pending
{"udim", T::Bool, "Bake UVs outside 0..1 as UDIM tiles (default true; false bakes the 0..1 square only).", false}},
[](Document& doc, const Args& a) -> CommandResult {
BakeSettings st;
@@ -1134,7 +1134,7 @@ void registerBakeCommands(CommandRegistry& reg) {
st.thicknessDistance = float(argNumber(a, "thickness_distance", st.thicknessDistance));
st.curvatureRadius = float(argNumber(a, "curvature_radius", st.curvatureRadius));
const std::string id = argString(a, "id", "polygroups");
- if (id != "polygroups" && id != "parts") return {false, "id must be polygroups or parts"};
+ if (id != "polygroups" && id != "parts") return {false, "id must be polygroups or parts"}; // marks-pending
st.idSource = id == "parts" ? BakeSettings::IdSource::Parts : BakeSettings::IdSource::Polygroups;
// The meshes: other Parts onto the active one, or the active Part's own levels.
diff --git a/src/core/Commands.cpp b/src/core/Commands.cpp
index 603f6f00..86e5c407 100644
--- a/src/core/Commands.cpp
+++ b/src/core/Commands.cpp
@@ -95,7 +95,7 @@ std::string fileStem(const std::string& path) {
return std::string(stem.begin(), stem.end());
}
-// " (3 SubTools)" for a multi-object export, else nothing.
+// " (3 Parts)" for a multi-object export, else nothing.
std::string objectCountText(const std::vector<MeshObjectRef>& objects) {
return objects.size() > 1 ? " (" + std::to_string(objects.size()) + " Parts)" : std::string();
}
@@ -166,7 +166,7 @@ CommandRegistry::CommandRegistry() {
}});
add({"open",
- "Open a file: models (.obj, .fbx, .glb, .gltf, .ply, .stl, .usda, .usdz, ZBrush .GoZ) replace the scene; Gaussian splats "
+ "Open a file: models replace the scene; Gaussian splats "
"(.ply/.splat captures, KHR_gaussian_splatting .glb, USD ParticleField) load as a reference next to the sculpt. "
"glTF morph targets and FBX/USD blend shapes become sculpt layers. Files with several objects (OBJ `o`, "
"glTF nodes, FBX models, USD meshes) open as one Part each. SculptForge projects (.sfproj) "
diff --git a/src/core/Deform.cpp b/src/core/Deform.cpp
index cc5fbfa9..dbc73139 100644
--- a/src/core/Deform.cpp
+++ b/src/core/Deform.cpp
@@ -246,7 +246,7 @@ void registerDeformCommands(CommandRegistry& reg) {
{"deform_smooth", DeformOp::Smooth,
"Smooth the whole active Part (Laplacian; keep_volume=true for Taubin smoothing, which doesn't shrink it)."},
{"deform_balloon", DeformOp::Balloon,
- "Balloon (ZBrush users: Inflate Balloon): fill the active Part out toward a rounder volume; a negative "
+ "Balloon: fill the active Part out toward a rounder volume; a negative "
"amount lets the air out."},
};
for (const Spec& sp : kSpecs) {
diff --git a/src/core/DyntopoCommands.cpp b/src/core/DyntopoCommands.cpp
index d0375b3d..f5f35b42 100644
--- a/src/core/DyntopoCommands.cpp
+++ b/src/core/DyntopoCommands.cpp
@@ -21,7 +21,7 @@ std::string dyntopoSummary(const DyntopoSettings& s) {
void registerDyntopoCommands(CommandRegistry& registry) {
using T = ParamSpec::Type;
registry.add({"dyntopo",
- "Dynamic topology (ZBrush's Sculptris Pro): while on, brush strokes add triangles where they need "
+ "Dynamic topology: while on, brush strokes add triangles where they need "
"detail and remove them where they don't, so shapes can be pulled out without stretching. Needs a "
"mesh without subdivision levels; quads under the brush become triangles and UVs are dropped (undo "
"brings them back). Without arguments, reports the settings.",
diff --git a/src/core/ExtractMirror.cpp b/src/core/ExtractMirror.cpp
index 2dfe9a7d..be2ab260 100644
--- a/src/core/ExtractMirror.cpp
+++ b/src/core/ExtractMirror.cpp
@@ -448,7 +448,7 @@ CommandResult runExtract(Document& doc, const Args& a) {
void registerExtractMirrorCommands(CommandRegistry& reg) {
reg.add({"extract",
- "ZBrush Extract (Tool > SubTool): make a shell from the masked, visible part of the active Part and "
+ "(Tool > Part): make a shell from the masked, visible part of the active Part and "
"show it as a preview below it; extract_accept (or accept=true) keeps it as a new Part in one undo "
"step. Running it again replaces the preview.",
{{"thickness", T::Number,
@@ -471,7 +471,7 @@ void registerExtractMirrorCommands(CommandRegistry& reg) {
}});
reg.add({"mirror_and_weld",
- "ZBrush Mirror And Weld (Tool > Geometry > Modify Topology): keep the half of the active Part on the "
+ "(Tool > Geometry > Modify Topology): keep the half of the active Part on the "
"+ side of the plane through the origin, mirror it onto the other side and weld the seam into one "
"watertight mesh. Face Groups, vertex paint, mask, UVs and sculpt layers are kept. One undo step.",
{{"axis", T::String, "Axis whose plane to mirror across: x (default), y or z; several (xz) in turn.", false},
@@ -500,7 +500,7 @@ void registerExtractMirrorCommands(CommandRegistry& reg) {
}});
reg.add({"mirror",
- "ZBrush Mirror (Tool > Deformation): flip the active Part across a plane, by default the one through "
+ "(Tool > Deformation): flip the active Part across a plane, by default the one through "
"the origin that symmetry and Mirror And Weld use. One undo step.",
{{"axis", T::String, "Axis to flip along: x (default), y or z; several (xz) in turn.", false},
{"pivot", T::String, "origin (default) or center (flip in place about the Part's centre).", false}},
diff --git a/src/core/LegacyNames.h b/src/core/LegacyNames.h
new file mode 100644
index 00000000..1af34472
--- /dev/null
+++ b/src/core/LegacyNames.h
@@ -0,0 +1,39 @@
+// SculptForge - open source digital sculpting
+// SPDX-License-Identifier: GPL-3.0-or-later
+//
+// Names older SculptForge versions wrote into projects, brush files, configs and scripts, before the brushes got
+// their own names. They are read only, mapped to today's name, and never shown or written
+// (docs/legal/trademarks.md, tools/marks_allow.txt).
+#pragma once
+
+#include <string_view>
+
+namespace sf::legacy {
+
+struct Rename {
+ std::string_view old, now;
+};
+
+// Brush stored names (projects, .sfbrush, `stroke brush=`), compared squashed and lower-case.
+inline constexpr Rename kBrushNames[] = {{"damstandard", "SharpCrease"}, {"claybuildup", "ClayBlock"},
+ {"snakehook", "Tendril"}};
+
+// Action ids (hotkeys, shelves and menus saved in configs).
+inline constexpr Rename kActionIds[] = {{"brush.damstandard", "brush.sharpcrease"},
+ {"brush.claybuildup", "brush.clayblock"},
+ {"brush.snakehook", "brush.tendril"}};
+
+// User library folders (Documents/SculptForge/<folder>): moved to today's name once, when the library opens.
+inline constexpr Rename kLibraryFolders[] = {{"MatCaps", "Lit Spheres"}};
+
+// Today's name for an old one, or "" when `name` isn't an old name.
+inline std::string_view renamed(const Rename* begin, const Rename* end, std::string_view name) {
+ for (const Rename* r = begin; r != end; ++r)
+ if (r->old == name) return r->now;
+ return {};
+}
+template <size_t N> std::string_view renamed(const Rename (&table)[N], std::string_view name) {
+ return renamed(table, table + N, name);
+}
+
+} // namespace sf::legacy
diff --git a/src/core/Masking.cpp b/src/core/Masking.cpp
index 11094634..e82c3ce6 100644
--- a/src/core/Masking.cpp
+++ b/src/core/Masking.cpp
@@ -433,7 +433,7 @@ void registerMaskingCommands(CommandRegistry& registry) {
{{"rings", T::Number, "Width of the mask in edge rings from the border (1-20; 1 = the border vertices only). "
"Default 1.",
false},
- {"polygroups", T::Bool, "Also mask face group borders (ZBrush: Mask by polygroup border). Default false.",
+ {"polygroups", T::Bool, "Also mask face group borders. Default false.",
false},
{"soft", T::Bool, "Fade the mask from the border towards the innermost ring. Default false.", false},
{"strength", T::Number, "Mask value on the border (0-1). Default 1.", false},
@@ -457,7 +457,7 @@ void registerMaskingCommands(CommandRegistry& registry) {
}});
// MaskRect / MaskLasso. Bad arguments are errors, unlike the "mask unchanged" of a selection that misses.
- const ParamSpec unmask{"unmask", T::Bool, "Unmask the inside instead (ZBrush: Alt held). Default false.", false};
+ const ParamSpec unmask{"unmask", T::Bool, "Unmask the inside instead. Default false.", false};
const ParamSpec strength{"strength", T::Number, "How much to mask or unmask (0-1). Default 1.", false};
const ParamSpec viewProj{"view_proj", T::String, "Optional 16 numbers: column-major view-projection matrix.",
false};
@@ -466,7 +466,7 @@ void registerMaskingCommands(CommandRegistry& registry) {
"brushes mirror (default none).",
false};
const ParamSpec clearOutside{"clear_outside", T::Bool,
- "When the shape covers none of the model, clear the mask instead (ZBrush: Ctrl+drag on "
+ "When the shape covers none of the model, clear the mask instead (like Ctrl+drag on "
"the background). Default false.",
false};
const ParamSpec frontFaces{"front_faces_only", T::Bool,
@@ -506,7 +506,7 @@ void registerMaskingCommands(CommandRegistry& registry) {
};
selection(
"mask_rect",
- "Rectangle mask selection (ZBrush MaskRect, Ctrl+drag): mask the visible vertices inside a screen rectangle, "
+ "Rectangle mask selection: mask the visible vertices inside a screen rectangle, "
"or unmask them. Coordinates are normalised (-1..1, y up) in the given view; without a view the rectangle "
"spans the mesh seen from the front (+Z).",
{{"x0", T::Number, "Rectangle left (-1..1). Default -1.", false},
@@ -527,7 +527,7 @@ void registerMaskingCommands(CommandRegistry& registry) {
});
selection(
"mask_lasso",
- "Lasso mask selection (ZBrush MaskLasso, Ctrl+drag): mask the visible vertices inside a screen polygon, or "
+ "Lasso mask selection: mask the visible vertices inside a screen polygon, or "
"unmask them. Points are normalised (-1..1, y up) in the given view; without a view they span the mesh "
"seen from the front (+Z).",
{{"points", T::String, "The lasso: at least 3 points as \"x0 y0 x1 y1 ...\" (-1..1, y up).", true},
diff --git a/src/core/Matcap.cpp b/src/core/Matcap.cpp
index 74754b8e..bcabba1a 100644
--- a/src/core/Matcap.cpp
+++ b/src/core/Matcap.cpp
@@ -386,7 +386,7 @@ std::vector<std::string> loadMatcapFolders(const std::vector<std::string>& dirs)
}
std::vector<std::string> studioMatcapDirs() {
- const char* v = std::getenv("SCULPTFORGE_MATCAP_PATH");
+ const char* v = std::getenv("SCULPTFORGE_MATCAP_PATH"); // marks-pending
return splitSearchPath(v ? v : "");
}
diff --git a/src/core/MeshMaps.cpp b/src/core/MeshMaps.cpp
index 64878a4e..7e8c1ded 100644
--- a/src/core/MeshMaps.cpp
+++ b/src/core/MeshMaps.cpp
@@ -604,7 +604,7 @@ void registerMeshMapCommands(CommandRegistry& reg) {
using T = ParamSpec::Type;
reg.add({"mesh_maps",
"Mesh Maps of the active Part, on its texture's UVs at the texture's size, for Fill layers: ambient "
- "occlusion, curvature, thickness, position, world normal and ID (polygroups). bake makes them, info "
+ "occlusion, curvature, thickness, position, world normal and ID (polygroups). bake makes them, info " // marks-pending
"describes them, clear drops them, live=true re-bakes the changed tiles after sculpting (in the app). "
"Derived data: not saved, not an undo step.",
{{"action", T::String, "bake (default), info, clear, or live (with live=true/false).", false},
diff --git a/src/core/MultiresCommands.cpp b/src/core/MultiresCommands.cpp
index 2eaa68e8..dbfc10a4 100644
--- a/src/core/MultiresCommands.cpp
+++ b/src/core/MultiresCommands.cpp
@@ -39,7 +39,7 @@ std::string exportCommandFor(const std::string& ext) {
void registerSubdivCommands(CommandRegistry& reg) {
reg.add({"subdiv_divide",
- "Divide (ZBrush Tool > Geometry > Divide, Ctrl+D): add a subdivision level above the highest one and step "
+ "Divide: add a subdivision level above the highest one and step "
"to it. Quads stay quads (Catmull-Clark); triangle meshes use Loop subdivision. Lower levels are kept, so "
"you can step down to sculpt big forms and back up to the detail. Each level has 4x the polygons.",
{{"smooth", T::Bool, "Smt: smooth the new level (default true); false divides flat, keeping hard edges.", false}},
@@ -50,7 +50,7 @@ void registerSubdivCommands(CommandRegistry& reg) {
}});
reg.add({"subdiv_level",
- "Step to a subdivision level (ZBrush's SDiv slider). Detail sculpted at higher levels is kept when you "
+ "Step to a subdivision level. Detail sculpted at higher levels is kept when you "
"edit a lower one, and edits at a high level show up (softened) at the lower ones.",
{{"level", T::Number, "Level to step to: 1 = the base cage, up to the number of levels.", true}},
[](Document& doc, const Args& a) -> CommandResult {
@@ -119,8 +119,8 @@ void registerSubdivCommands(CommandRegistry& reg) {
reg.add({"subdiv_export",
"Export the visible Parts at a subdivision level other than the current one, e.g. the base cage for "
- "another app (exports and GoZ otherwise write the current level). Parts without levels are written "
- "as they are. The format follows the extension (.obj, .glb, .usd, .fbx, .ply, .stl, .goz).",
+ "another app (exports and Bridge files otherwise write the current level). Parts without levels are written "
+ "as they are. The format follows the extension (.obj, .glb, .usd, .fbx, .ply, .stl or a Bridge file).",
{{"path", T::String, "File to write.", true},
{"level", T::Number, "Level to export: 1 = the base cage (default); higher than a Part has = its highest.", false}},
[](Document& doc, const Args& a) -> CommandResult {
diff --git a/src/core/Pack.cpp b/src/core/Pack.cpp
index 4f39114d..74eaddaa 100644
--- a/src/core/Pack.cpp
+++ b/src/core/Pack.cpp
@@ -1302,7 +1302,7 @@ void registerPackCommands(CommandRegistry& registry) {
return {true, "Removed pack " + argString(a, "id")};
}});
registry.add({"pack_create",
- "Make a pack (.sfpack) from a folder laid out like one: brushes/, alphas/, matcaps/, materials/, vdms/, "
+ "Make a pack (.sfpack) from a folder laid out like one: brushes/, alphas/, matcaps/, materials/, vdms/, " // marks-pending
"keymaps/, piemenus/ and macros/ (each with its own file types), plus LICENSE.txt and preview.png if "
"there. Everything is checked exactly as an install would check it.",
{{"folder", T::String, "The folder holding the items.", true},
diff --git a/src/core/Polygroups.cpp b/src/core/Polygroups.cpp
index cfcc3b3b..c52b1fcf 100644
--- a/src/core/Polygroups.cpp
+++ b/src/core/Polygroups.cpp
@@ -352,7 +352,7 @@ void registerPolygroupCommands(CommandRegistry& reg) {
reg.add(
{"polygroup_auto_by_normals",
"Split the visible surface into face groups wherever it turns more than an angle (each flat side of a "
- "box becomes a group), like ZBrush Auto Groups / Groups By Normals.",
+ "box becomes a group).",
{{"angle", T::Number, "Largest normal deviation inside one group, in degrees (1-180). Default 30.", false}},
[](Document& doc, const Args& a) -> CommandResult {
const float angle = float(std::clamp(argNumber(a, "angle", 30.0), 1.0, 180.0));
@@ -361,7 +361,7 @@ void registerPolygroupCommands(CommandRegistry& reg) {
}});
reg.add({"polygroup_by_connectivity",
- "Give every disconnected piece of the visible mesh its own face group (like ZBrush Auto Groups).",
+ "Give every disconnected piece of the visible mesh its own face group.",
{},
[](Document& doc, const Args&) -> CommandResult {
commitPolygroups(doc, groupsByConnectivity(doc.mesh), "Groups by Connectivity");
@@ -369,7 +369,7 @@ void registerPolygroupCommands(CommandRegistry& reg) {
}});
reg.add({"polygroup_uv",
- "Give every UV island of the visible mesh its own face group (ZBrush Polygroups > UV Groups).", {},
+ "Give every UV island of the visible mesh its own face group.", {},
[](Document& doc, const Args&) -> CommandResult {
if (!doc.mesh.hasUvs()) return {false, "This mesh has no UVs: unwrap it first (Tool > UV Map)"};
commitPolygroups(doc, groupsByUvs(doc.mesh), "Group by UVs");
@@ -377,7 +377,7 @@ void registerPolygroupCommands(CommandRegistry& reg) {
}});
reg.add({"polygroup_from_mask",
- "Move the masked (visible) part of the mesh into a new face group, like ZBrush Group Masked.", {},
+ "Move the masked (visible) part of the mesh into a new face group.", {},
[](Document& doc, const Args&) -> CommandResult {
size_t n = 0;
std::vector<uint32_t> groups = groupsFromMask(doc.mesh, &n);
@@ -393,14 +393,14 @@ void registerPolygroupCommands(CommandRegistry& reg) {
return {true, "Face Groups cleared"};
}});
- reg.add({"polygroup_merge_visible", "Merge everything visible into a single face group (ZBrush Group Visible).", {},
+ reg.add({"polygroup_merge_visible", "Merge everything visible into a single face group.", {},
[](Document& doc, const Args&) -> CommandResult {
commitPolygroups(doc, groupsMergeVisible(doc.mesh), "Group Visible");
return {true, groupSummary(doc.mesh)};
}});
// --- Visibility ---
- reg.add({"hide_polygroup", "Hide one face group (ZBrush Ctrl+Shift+Alt+click).",
+ reg.add({"hide_polygroup", "Hide one face group.",
{{"group", T::Number, "Face Group id.", true}},
[](Document& doc, const Args& a) -> CommandResult {
const uint32_t group = uint32_t(std::max(0.0, argNumber(a, "group", 0)));
@@ -411,7 +411,7 @@ void registerPolygroupCommands(CommandRegistry& reg) {
return {true, visibleSummary(doc.mesh)};
}});
- reg.add({"isolate_polygroup", "Show only one face group and hide the rest (ZBrush Ctrl+Shift+click).",
+ reg.add({"isolate_polygroup", "Show only one face group and hide the rest.",
{{"group", T::Number, "Face Group id.", true}},
[](Document& doc, const Args& a) -> CommandResult {
const uint32_t group = uint32_t(std::max(0.0, argNumber(a, "group", 0)));
@@ -440,14 +440,14 @@ void registerPolygroupCommands(CommandRegistry& reg) {
"too, as the brushes mirror (#51; default none).",
false};
reg.add({"hide_rect",
- "Rectangle selection (ZBrush Ctrl+Shift+drag): keep the visible triangles inside a screen rectangle and "
+ "Rectangle selection: keep the visible triangles inside a screen rectangle and "
"hide the rest, or hide the inside instead. Coordinates are normalised (-1..1, y up) in the given view; "
"without a view the rectangle spans the mesh seen from the front (+Z).",
{{"x0", T::Number, "Rectangle left (-1..1). Default -1.", false},
{"y0", T::Number, "Rectangle bottom (-1..1). Default -1.", false},
{"x1", T::Number, "Rectangle right (-1..1). Default 1.", false},
{"y1", T::Number, "Rectangle top (-1..1). Default 1.", false},
- {"inside", T::Bool, "Hide the inside instead of the outside (ZBrush: Alt held).", false},
+ {"inside", T::Bool, "Hide the inside instead of the outside.", false},
{"view_proj", T::String, "Optional 16 numbers: column-major view-projection matrix.", false},
symmetryParam},
[](Document& doc, const Args& a) -> CommandResult {
@@ -467,11 +467,11 @@ void registerPolygroupCommands(CommandRegistry& reg) {
}});
reg.add({"hide_lasso",
- "Lasso selection (ZBrush SelectLasso, Ctrl+Shift+drag): keep the visible triangles inside a screen "
+ "Lasso selection: keep the visible triangles inside a screen "
"polygon and hide the rest, or hide the inside instead. Points are normalised (-1..1, y up) in the given "
"view; without a view they span the mesh seen from the front (+Z).",
{{"points", T::String, "The lasso: at least 3 points as \"x0 y0 x1 y1 ...\" (-1..1, y up).", true},
- {"inside", T::Bool, "Hide the inside instead of the outside (ZBrush: Alt held).", false},
+ {"inside", T::Bool, "Hide the inside instead of the outside.", false},
{"view_proj", T::String, "Optional 16 numbers: column-major view-projection matrix.", false},
symmetryParam},
[](Document& doc, const Args& a) -> CommandResult {
diff --git a/src/core/Polypaint.cpp b/src/core/Polypaint.cpp
index 6fd63df8..5cb9a1ec 100644
--- a/src/core/Polypaint.cpp
+++ b/src/core/Polypaint.cpp
@@ -366,7 +366,7 @@ void registerPaintCommands(CommandRegistry& registry) {
}});
registry.add({"paint_from_cavity",
- "Darken (or tint) the creases and cavities of the sculpt with vertex paint, like ZBrush's cavity "
+ "Darken (or tint) the creases and cavities of the sculpt with vertex paint"
"masking plus fill (undoable, respects the mask).",
{{"color", T::String, std::string(kColorHelp) + " Default: a dark brown.", false},
{"strength", T::Number, "0-1. Default 0.7.", false},
diff --git a/src/core/QRemeshGuides.cpp b/src/core/QRemeshGuides.cpp
index 0a36ec32..8f02fa77 100644
--- a/src/core/QRemeshGuides.cpp
+++ b/src/core/QRemeshGuides.cpp
@@ -179,7 +179,7 @@ std::vector<QRemeshGuide> qremeshGuidesFromJson(const Json& json) {
void registerQRemeshGuideCommands(CommandRegistry& reg) {
using T = ParamSpec::Type;
reg.add({"qremesh_guide",
- "Quad Remesh Guides (ZBrush's ZRemesher Guides brush): draw a curve on the active Part for Quad Remesh to "
+ "Quad Remesh Guides: draw a curve on the active Part for Quad Remesh to "
"follow; an edge loop runs along it and the edge flow around it turns with it. A curve that ends where it "
"started becomes a loop (around an eye or the mouth). The guides are kept with the Part and saved in "
"projects.",
diff --git a/src/core/RadialMenu.cpp b/src/core/RadialMenu.cpp
index 7110b232..de2bc9b7 100644
--- a/src/core/RadialMenu.cpp
+++ b/src/core/RadialMenu.cpp
@@ -6,6 +6,8 @@
#include <cmath>
#include <cstdint>
+#include "core/LegacyNames.h"
+
namespace sf {
namespace {
@@ -31,7 +33,8 @@ constexpr ButtonName kButtons[int(RadialButton::Count)] = {
// An id from a file: a string of sensible length the vocabulary knows, or "".
std::string knownId(const Json& j, const std::function<bool(std::string_view)>& known) {
if (!j.isString()) return {};
- const std::string& s = j.asString();
+ std::string s = j.asString();
+ if (const std::string_view now = legacy::renamed(legacy::kActionIds, s); !now.empty()) s = now;
if (s.empty() || s.size() > kRadialIdMax || !known || !known(s)) return {};
return s;
}
diff --git a/src/core/RetopoCommands.cpp b/src/core/RetopoCommands.cpp
index 99400eed..1cbbd240 100644
--- a/src/core/RetopoCommands.cpp
+++ b/src/core/RetopoCommands.cpp
@@ -84,7 +84,7 @@ std::string applyQRemesh(Document& doc, Mesh result, bool keepOriginal, const QR
void registerRetopoCommands(CommandRegistry& reg) {
reg.add({"qremesh",
- "Quad Remesh (like ZBrush's ZRemesher): automatic quad retopology of the active Part. Builds clean, "
+ "Quad Remesh: automatic quad retopology of the active Part. Builds clean, "
"all-quad topology with edge loops that follow the form, close to the target polygon count. Sculpt "
"layers are baked; mask and vertex paint carry over. Undoable. Use project_all afterwards (from a kept "
"original) to bring fine detail back onto a divided copy.",
diff --git a/src/core/Sculpt.cpp b/src/core/Sculpt.cpp
index e1352ea1..aeaf05eb 100644
--- a/src/core/Sculpt.cpp
+++ b/src/core/Sculpt.cpp
@@ -12,6 +12,8 @@
#include <limits>
#include <unordered_map>
+#include "core/LegacyNames.h"
+
namespace sf {
const char* brushName(BrushType type) {
@@ -24,9 +26,9 @@ const char* brushName(BrushType type) {
case BrushType::Crease: return "Crease";
case BrushType::Flatten: return "Flatten";
case BrushType::Pinch: return "Pinch";
- case BrushType::DamStandard: return "DamStandard";
- case BrushType::ClayBuildup: return "ClayBuildup";
- case BrushType::SnakeHook: return "SnakeHook";
+ case BrushType::DamStandard: return "SharpCrease";
+ case BrushType::ClayBuildup: return "ClayBlock";
+ case BrushType::SnakeHook: return "Tendril";
case BrushType::Trim: return "Trim";
case BrushType::Layer: return "Layer";
case BrushType::Nudge: return "Nudge";
@@ -58,8 +60,9 @@ bool brushFromName(std::string_view name, BrushType& out) {
if (c != ' ' && c != '_' && c != '-') r += char(std::tolower(c));
return r;
};
- const std::string want = squash(name);
+ std::string want = squash(name);
if (want.empty()) return false;
+ if (const std::string_view now = legacy::renamed(legacy::kBrushNames, want); !now.empty()) want = squash(now);
for (int i = 0; i < int(BrushType::Count); ++i)
if (squash(brushName(BrushType(i))) == want || squash(brushLabel(BrushType(i))) == want) {
out = BrushType(i);
diff --git a/src/core/Sculpt.h b/src/core/Sculpt.h
index e032d0ee..81f59e7b 100644
--- a/src/core/Sculpt.h
+++ b/src/core/Sculpt.h
@@ -49,10 +49,10 @@ inline bool isKelvinletBrush(BrushType t) {
t == BrushType::KelvinSnake || t == BrushType::DetailClone;
}
-// The brush's stored name: the key projects, brush files, hotkeys ("brush.damstandard") and scripts (stroke
-// brush=DamStandard) use. Never changes, so old files and scripts keep working.
+// The brush's stored name: the key projects, brush files, hotkeys ("brush.sharpcrease") and scripts (stroke
+// brush=SharpCrease) use. brushFromName also reads the names older versions wrote (core/LegacyNames.h).
const char* brushName(BrushType type);
-// The name the interface shows ("Sharp Crease" for DamStandard); brushes named after ZBrush's coinages have their own.
+// The name the interface shows ("Sharp Crease" for SharpCrease).
const char* brushLabel(BrushType type);
// The brush a name means: its stored name or its label (any case, spaces ignored). False when none.
bool brushFromName(std::string_view name, BrushType& out);
diff --git a/src/core/SelectionSets.cpp b/src/core/SelectionSets.cpp
index 16e08ebe..62fc48dd 100644
--- a/src/core/SelectionSets.cpp
+++ b/src/core/SelectionSets.cpp
@@ -286,7 +286,7 @@ bool parseSetChannels(const std::string& text, uint32_t& out, std::string& error
else if (w == "uvs" || w == "uv") out |= kSetUvs;
else if (w == "morph" || w == "shape" || w == "positions") out |= kSetMorph;
else {
- error = "Unknown channel '" + w + "' (use mask, polygroups, paint, visibility, uvs, morph or all)";
+ error = "Unknown channel '" + w + "' (use mask, polygroups, paint, visibility, uvs, morph or all)"; // marks-pending
return false;
}
return true;
@@ -988,7 +988,7 @@ CommandResult result(bool ok, std::string message) { return {ok, std::move(messa
} // namespace
void registerSelectionSetCommands(CommandRegistry& reg) {
- const std::string channelHelp = "Comma-separated channels: mask, polygroups, paint (vertex paint), visibility (hidden "
+ const std::string channelHelp = "Comma-separated channels: mask, polygroups, paint (vertex paint), visibility (hidden " // marks-pending
"faces), uvs, morph (the shape), or all";
reg.add({"selection_set_store",
"Store a named selection set on the active Part: a snapshot of the channels you choose. Storing again with "
diff --git a/src/core/SubTools.cpp b/src/core/SubTools.cpp
index bfc6f5dd..fd9762e6 100644
--- a/src/core/SubTools.cpp
+++ b/src/core/SubTools.cpp
@@ -450,7 +450,7 @@ void registerSubToolCommands(CommandRegistry& reg) {
[](Document& doc, const Args& a) -> CommandResult {
const std::string blocked = dyntopoBlocker(doc.mesh);
if (!blocked.empty()) return {false, "Can't insert: " + blocked};
- if (a.contains("subtool") == a.contains("file")) return {false, "Give subtool= or file="};
+ if (a.contains("subtool") == a.contains("file")) return {false, "Give subtool= or file="}; // marks-pending
Mesh source;
std::string label;
if (a.contains("subtool")) {
@@ -563,7 +563,7 @@ void registerSubToolCommands(CommandRegistry& reg) {
reg.add({"subtool_merge_down",
"Merge the active Part with the one below it into one mesh (not undoable). Each keeps its own "
- "face groups, so subtool_split_groups can separate them again. Painted textures are kept in one new "
+ "face groups, so subtool_split_groups can separate them again. Painted textures are kept in one new " // marks-pending
"texture on new Auto UVs.",
{{"keep_texture", T::Bool, "Keep painted textures (Auto UV the result and copy them in). Default true.", false}},
[](Document& doc, const Args& a) -> CommandResult {
diff --git a/src/core/TransformCommands.cpp b/src/core/TransformCommands.cpp
index 9cc284ff..edfa92be 100644
--- a/src/core/TransformCommands.cpp
+++ b/src/core/TransformCommands.cpp
@@ -134,7 +134,7 @@ void registerTransformCommands(CommandRegistry& reg) {
"Mirror a masked transform across these planes through the origin, e.g. x: the unmasked part on the "
"other side of the plane takes the mirrored transform (both arms pose together).",
false},
- {"all", T::Bool, "Transform every visible Part (ZBrush Transpose All). Default false.", false}},
+ {"all", T::Bool, "Transform every visible Part. Default false.", false}},
runTransform});
}
diff --git a/src/core/UvCommands.cpp b/src/core/UvCommands.cpp
index 1bd70d03..72200010 100644
--- a/src/core/UvCommands.cpp
+++ b/src/core/UvCommands.cpp
@@ -129,13 +129,13 @@ std::string uvInfoText(const Mesh& m, int resolution) {
void registerUvCommands(CommandRegistry& reg) {
reg.add({"uv_unwrap",
"Unwrap the active Part's UVs (UV Editor > Unwrap). Methods: isometric (least stretch: angles and lengths, "
- "along the marked seams; the default), conformal (LSCM: angles, along the seams), polygroups (cut along "
+ "along the marked seams; the default), conformal (LSCM: angles, along the seams), polygroups (cut along " // marks-pending
"the face group borders and the seams), planar (each piece projected flat), unfold (flatten the current "
"islands again in place, keeping pinned corners), auto (finds its own seams, xatlas). Pieces that are "
"closed or looped get extra cuts. The result is packed into the 0-1 tile, or across UDIM tiles. With a UV "
"selection only the selected faces are unwrapped (fitted where they were). A painted texture moves onto "
"the new UVs (keep_texture). One undo step.",
- {{"method", T::String, "isometric (default), conformal, polygroups, planar, unfold or auto", false},
+ {{"method", T::String, "isometric (default), conformal, polygroups, planar, unfold or auto", false}, // marks-pending
{"selected", T::Bool, "Only the UV Editor's selected faces (default true when something is selected)", false},
{"iterations", T::Number, "Least-stretch refinement steps (default 10; 0 = conformal)", false},
{"resolution", T::Number, "Texture size the margin is measured in (default: the texture's, or 2048)", false},
@@ -150,7 +150,7 @@ void registerUvCommands(CommandRegistry& reg) {
if (m.triangleCount() == 0) return {false, "There is no mesh to unwrap"};
UvUnwrapOptions o;
if (a.contains("method") && !parseUvUnwrapMethod(argString(a, "method"), o.method))
- return {false, "method must be isometric, conformal, polygroups, planar, unfold or auto"};
+ return {false, "method must be isometric, conformal, polygroups, planar, unfold or auto"}; // marks-pending
o.resolution = resolutionArg(doc, a);
o.iterations = std::clamp(int(argNumber(a, "iterations", 10)), 0, 100);
o.packing = packOptions(doc, a);
@@ -211,9 +211,9 @@ void registerUvCommands(CommandRegistry& reg) {
reg.add({"uv_seam",
"Mark or clear UV seams on the active Part (seams are where Unwrap cuts). op: mark / clear (the UV "
"Editor's selected edges, or the border of its selected faces), path (mark the shortest edge path from "
- "vertex `from` to vertex `to`; clear=true clears it), polygroups (every face group border), islands (every "
+ "vertex `from` to vertex `to`; clear=true clears it), polygroups (every face group border), islands (every " // marks-pending
"current UV island border), angle (edges sharper than `angle` degrees), clear_all. One undo step.",
- {{"op", T::String, "mark, clear, path, polygroups, islands, angle or clear_all", true},
+ {{"op", T::String, "mark, clear, path, polygroups, islands, angle or clear_all", true}, // marks-pending
{"from", T::Number, "path: the vertex to start at", false},
{"to", T::Number, "path: the vertex to end at", false},
{"clear", T::Bool, "path: clear the seams along it instead of marking them", false},
@@ -256,7 +256,7 @@ void registerUvCommands(CommandRegistry& reg) {
} else if (op == "clear_all") {
uvClearSeams(m);
} else {
- return {false, "op must be mark, clear, path, polygroups, islands, angle or clear_all"};
+ return {false, "op must be mark, clear, path, polygroups, islands, angle or clear_all"}; // marks-pending
}
edit.commit();
const size_t after = uvSeamCount(m);
@@ -266,13 +266,13 @@ void registerUvCommands(CommandRegistry& reg) {
reg.add({"uv_select",
"Set the UV Editor's selection on the active Part (what the other uv_* commands work on). op: all, none, "
- "invert, island (the island of triangle `face`), face (triangle `face`), polygroup (every face of face group "
+ "invert, island (the island of triangle `face`), face (triangle `face`), polygroup (every face of face group " // marks-pending
"`group`), rect (faces touching u0 v0 u1 v1), seams (the marked seam edges), mode (just switch to `mode`). "
"`mode` (vertex, edge, face, island) converts the selection; `add` adds to it instead of replacing it.",
- {{"op", T::String, "all, none, invert, island, face, polygroup, rect, seams or mode", true},
+ {{"op", T::String, "all, none, invert, island, face, polygroup, rect, seams or mode", true}, // marks-pending
{"mode", T::String, "vertex, edge, face or island", false},
{"face", T::Number, "island / face: a triangle index", false},
- {"group", T::Number, "polygroup: the face group id", false},
+ {"group", T::Number, "polygroup: the face group id", false}, // marks-pending
{"u0", T::Number, "rect: lower u", false},
{"v0", T::Number, "rect: lower v", false},
{"u1", T::Number, "rect: upper u", false},
@@ -347,7 +347,7 @@ void registerUvCommands(CommandRegistry& reg) {
if (m.uvFlags.size() == nt * 3)
for (uint32_t c = 0; c < nt * 3; ++c) sel.corners[c] = (m.uvFlags[c] & kUvSeam) != 0;
} else if (op != "mode") {
- return {false, "op must be all, none, invert, island, face, polygroup, rect, seams or mode"};
+ return {false, "op must be all, none, invert, island, face, polygroup, rect, seams or mode"}; // marks-pending
}
if (sel.mode == UvSelectMode::Island) uvConvertSelection(m, topo, sel, UvSelectMode::Island);
const size_t n = sel.count();
diff --git a/src/core/Vdm.cpp b/src/core/Vdm.cpp
index 1169113b..3dcbe05b 100644
--- a/src/core/Vdm.cpp
+++ b/src/core/Vdm.cpp
@@ -861,7 +861,7 @@ void registerVdmCommands(CommandRegistry& registry) {
return {true, "Exported VDM '" + v->name + "' to " + path};
}});
registry.add({"vdm_new_plane",
- "Add a VDM plane to sculpt a new vector displacement brush on (ZBrush's VDM plane template): a flat "
+ "Add a VDM plane to sculpt a new vector displacement brush on: a flat "
"2 x 2 grid seen from the top, its border masked; the other Parts are hidden. Then vdm_capture.",
{{"resolution", T::Number, "Quads per side (16-1024). Default 256; divide it for finer detail.", false}},
[](Document& doc, const Args& a) -> CommandResult {
@@ -875,7 +875,7 @@ void registerVdmCommands(CommandRegistry& registry) {
}});
registry.add({"vdm_capture",
"Create a VDM brush from the active VDM plane: how far each point moved from the flat grid becomes "
- "a new vector displacement map in the brush library (ZBrush: create brush from the VDM plane).",
+ "a new vector displacement map in the brush library.",
{{"name", T::String, "Name of the new VDM (default 'My VDM').", false},
{"resolution", T::Number, "Map size in pixels (16-2048, default 256; Blender suggests 512 or less).", false},
{"exr", T::String, "Also write it as a 32-bit OpenEXR here, for Blender.", false},
diff --git a/src/core/ZSpheres.cpp b/src/core/ZSpheres.cpp
index 2fe33183..b8e606e1 100644
--- a/src/core/ZSpheres.cpp
+++ b/src/core/ZSpheres.cpp
@@ -367,7 +367,7 @@ std::vector<ZSphere> zspheresFromJson(const Json& json) {
namespace {
-constexpr const char* kNotZSphere = "The active Part is not a Forge Sphere Part (zsphere_new makes one)";
+constexpr const char* kNotZSphere = "The active Part is not a Forge Sphere Part (zsphere_new makes one)"; // marks-pending
Symmetry symmetryArg(const Args& a) {
Symmetry s{false, false, false};
@@ -399,9 +399,9 @@ void registerZSphereCommands(CommandRegistry& reg) {
"Mirror the edit across these planes through the centre, e.g. \"x\". Default: none.",
false};
reg.add({"zsphere_new",
- "Forge Spheres (ZBrush's ZSpheres): add a Forge Sphere Part holding one root sphere at the centre and make it "
- "active. Grow limbs from it with zsphere_add (or the Forge Sphere tool), see the skin with zsphere_preview, "
- "then zsphere_make_mesh turns it into a sculptable Part.",
+ "Forge Spheres: add a Forge Sphere Part holding one root sphere at the centre and make it "
+ "active. Grow limbs from it with zsphere_add (or the Forge Sphere tool), see the skin with zsphere_preview, " // marks-pending
+ "then zsphere_make_mesh turns it into a sculptable Part.", // marks-pending
{{"name", T::String, "Part name (default \"Forge Sphere\").", false},
{"radius", T::Number, "Root sphere radius (default 0.5).", false}},
[](Document& doc, const Args& a) -> CommandResult {
@@ -438,7 +438,7 @@ void registerZSphereCommands(CommandRegistry& reg) {
if (!zsphereAdd(s, parent, c, r, symmetryArg(a), &added)) return {false, "radius must be above 0"};
return applyEdit(doc, std::move(s), "Forge Sphere add", "Added sphere " + std::to_string(added));
}});
- reg.add({"zsphere_set", "Move and/or resize a sphere of the active Forge Sphere Part (ZBrush's Move and Scale).",
+ reg.add({"zsphere_set", "Move and/or resize a sphere of the active Forge Sphere Part.",
{{"index", T::Number, "Sphere index.", true},
{"position", T::String, "New centre \"x,y,z\" (default: unchanged).", false},
{"radius", T::Number, "New radius (default: unchanged).", false},
@@ -467,7 +467,7 @@ void registerZSphereCommands(CommandRegistry& reg) {
}});
reg.add({"zsphere_insert",
"Insert a sphere halfway along the link from sphere `index` to its parent (a new joint, like clicking "
- "a link in ZBrush's Draw mode).",
+ "a link in Draw mode).",
{{"index", T::Number, "The child sphere whose link gets the new joint.", true}, symmetryParam},
[](Document& doc, const Args& a) -> CommandResult {
auto s = doc.mesh.zspheres;
@@ -492,7 +492,7 @@ void registerZSphereCommands(CommandRegistry& reg) {
"Sphere " + std::to_string(i) + " is the root now (index 0)");
}});
reg.add({"zsphere_preview",
- "Show the skin over the active Forge Sphere Part's spheres instead of the spheres (ZBrush's Preview, A).",
+ "Show the skin over the active Forge Sphere Part's spheres instead of the spheres.",
{{"on", T::Bool, "Default: toggle.", false}},
[](Document& doc, const Args& a) -> CommandResult {
if (doc.mesh.zspheres.empty()) return {false, kNotZSphere};
@@ -502,7 +502,7 @@ void registerZSphereCommands(CommandRegistry& reg) {
return {true, on ? "Skin preview on" : "Skin preview off"};
}});
reg.add({"zsphere_make_mesh",
- "Make Mesh (ZBrush's Make Adaptive Skin): build the skin over the active Forge Sphere Part as a new, "
+ "Make Mesh: build the skin over the active Forge Sphere Part as a new, "
"sculptable Part right below it, watertight quads with one face group per link. The Forge Sphere Part "
"is hidden and kept so the proportions can still be changed and a new mesh made.",
{{"resolution", T::Number, "Cells across the longest side (16-1024, default 128): higher is denser.", false},
diff --git a/src/io/ArExport.h b/src/io/ArExport.h
index 82dad33e..e4a36419 100644
--- a/src/io/ArExport.h
+++ b/src/io/ArExport.h
@@ -28,7 +28,7 @@ struct ArExportResult {
std::string glb, usdz; // file contents
size_t triangles = 0;
bool colored = false; // polypaint or a texture was baked
- std::string summary; // "62,410 triangles, polypaint, 20 cm"
+ std::string summary; // "62,410 triangles, vertex paint, 20 cm"
};
// `meshes`: the parts to show (null entries are skipped); hidden triangles are left out.
diff --git a/src/io/BridgeProtocol.h b/src/io/BridgeProtocol.h
new file mode 100644
index 00000000..405d9527
--- /dev/null
+++ b/src/io/BridgeProtocol.h
@@ -0,0 +1,50 @@
+// SculptForge - open source digital sculpting
+// SPDX-License-Identifier: GPL-3.0-or-later
+//
+// The names the Bridge exchange protocol needs byte for byte: the binary header, the shared folder layout and
+// the other application's install names. They are the protocol's, not SculptForge's, and appear nowhere in the
+// interface; they live only here (docs/legal/trademarks.md, tools/marks_allow.txt).
+#pragma once
+
+namespace sf::bridge {
+
+inline constexpr char kExt[] = ".GoZ"; // what Bridge files are written as
+inline constexpr char kExtLower[] = ".goz"; // matched without case
+// File dialog filters (SDL: extensions without the dot); the macros go inside longer filter lists.
+#define SF_BRIDGE_MESH_EXTS "GoZ;goz"
+#define SF_BRIDGE_DIALOG_EXTS SF_BRIDGE_MESH_EXTS ";ztl;ZTL" // plus libraries the export plug-in converted
+inline constexpr char kDialogPattern[] = SF_BRIDGE_MESH_EXTS;
+inline constexpr char kHeader[] = "GoZb 1.0 ZBrush GoZ Binary";
+inline constexpr char kMagic[] = "GoZb";
+inline constexpr char kNamePrefix[] = "GoZMesh_";
+
+// The shared bridge folder: %PUBLIC%\<kVendorFolder> on Windows, kMacRoot on macOS.
+inline constexpr char kVendorFolder[] = "Pixologic";
+inline constexpr char kMacRoot[] = "/Users/Shared/Pixologic";
+inline constexpr char kInboxFolder[] = "GoZBrush";
+inline constexpr char kProjectsFolder[] = "GoZProjects";
+inline constexpr char kAppsFolder[] = "GoZApps";
+inline constexpr char kObjectList[] = "GoZ_ObjectList.txt";
+inline constexpr char kApplicationFile[] = "GoZ_Application.txt";
+inline constexpr char kProjectPathFile[] = "GoZ_ProjectPath.txt";
+inline constexpr char kInfoFile[] = "GoZ_Info.txt";
+inline constexpr char kConfigFile[] = "GoZ_Config.txt";
+inline constexpr char kInfoText[] =
+ "NAME\t\t\t=\t\"SculptForge\"\nGOZ_VERSION\t\t=\t1\nEXTENSION\t\t=\t\".GoZ\"\n"
+ "TAMPLATE\t\t=\t\"GoZ Complete Binary.GoZ\"\n\nEXPORT_FLIP_Y\t\t\t=\tFALSE\n"
+ "EXPORT_FLIP_Z\t\t\t=\tFALSE\nIMPORT_FLIP_Y\t\t\t=\tFALSE\nIMPORT_FLIP_Z\t\t\t=\tFALSE\n";
+inline constexpr char kNotifierWin[] = "GoZBrushFromApp.exe";
+inline constexpr char kNotifierMac[] = "GoZBrushFromApp.app";
+
+// Where the other application installs, to start it when its notifier is missing.
+inline constexpr const char* kWinInstallDirs[] = {"C:\\Program Files", "C:\\Program Files\\Pixologic",
+ "C:\\Program Files\\Maxon"};
+inline constexpr char kWinExe[] = "ZBrush.exe";
+inline constexpr char kMacApp[] = "ZBrush.app";
+inline constexpr char kAppNameLower[] = "zbrush"; // install folders and executables contain it
+inline constexpr char kMacAppLower[] = "zbrush.app";
+
+// Library files the Bridge export plug-in converts (opened by finding the converted Bridge files).
+inline constexpr char kLibraryExtLower[] = ".ztl";
+
+} // namespace sf::bridge
diff --git a/src/io/GozCommands.cpp b/src/io/GozCommands.cpp
index f5835fe2..712a29f2 100644
--- a/src/io/GozCommands.cpp
+++ b/src/io/GozCommands.cpp
@@ -2,6 +2,8 @@
// SPDX-License-Identifier: GPL-3.0-or-later
#include "io/GozCommands.h"
+#include "io/BridgeProtocol.h"
+
#include "core/SubTools.h"
#include "io/GozIO.h"
#include "io/StlIO.h"
@@ -88,9 +90,9 @@ void registerGozCommands(CommandRegistry& reg) {
using T = ParamSpec::Type;
reg.add({"goz_import",
- "Open a GoZ-compatible file (.GoZ, as ZBrush writes), replacing the scene. Face Groups, UVs, mask and vertex paint are kept; "
+ "Open a Bridge file, replacing the scene. Face Groups, UVs, mask and vertex paint are kept; "
"quads are split into triangle pairs (exported back as quads).",
- {{"path", T::String, "Input .GoZ path (UTF-8).", true}},
+ {{"path", T::String, "Input Bridge file path (UTF-8).", true}},
[](Document& doc, const Args& a) -> CommandResult {
const std::string path = argString(a, "path");
Mesh m;
@@ -101,17 +103,17 @@ void registerGozCommands(CommandRegistry& reg) {
doc.setMesh(std::move(m), name);
doc.path.clear();
doc.gozName = name;
- std::string msg = "Opened GoZ " + doc.gozName + " (" + meshSummary(doc.mesh) + ")";
+ std::string msg = "Opened Bridge file " + doc.gozName + " (" + meshSummary(doc.mesh) + ")";
if (!err.empty()) msg += "; " + err;
return {true, msg};
}});
reg.add({"goz_export",
- "Export the mesh as a GoZ-compatible file (.GoZ) with face groups, UVs, mask and vertex paint. With several "
- "visible Parts, each is written next to `path` as <name>_<Part>.GoZ.",
- {{"path", T::String, "Output .GoZ path (UTF-8).", true},
- {"name", T::String, "Part name. Default: the name it came from ZBrush with, else the document name.", false},
- {"quads", T::Bool, "Rebuild quads from triangle pairs made by the .GoZ import. Default true.", false}},
+ "Export the mesh as a Bridge file with face groups, UVs, mask and vertex paint. With several "
+ "visible Parts, each is written next to `path` as <name>_<Part> with the same extension.",
+ {{"path", T::String, "Output Bridge file path (UTF-8).", true},
+ {"name", T::String, "Part name. Default: the name it came through the Bridge with, else the document name.", false},
+ {"quads", T::Bool, "Rebuild quads from triangle pairs made by the Bridge file import. Default true.", false}},
[](Document& doc, const Args& a) -> CommandResult {
const std::string path = argString(a, "path");
GozWriteOptions o;
@@ -135,21 +137,21 @@ void registerGozCommands(CommandRegistry& reg) {
const std::string wanted = name;
for (int k = 2; std::find(used.begin(), used.end(), name) != used.end(); ++k) name = wanted + "_" + std::to_string(k);
used.push_back(name);
- const std::string file = fileStem(path) + "_" + name + ".GoZ";
+ const std::string file = fileStem(path) + "_" + name + bridge::kExt;
const auto out = (base.parent_path() / std::u8string(file.begin(), file.end())).u8string();
if (!saveGoz(std::string(out.begin(), out.end()), *obj.mesh, name, err, o)) return {false, err};
}
- return {true, "Exported " + std::to_string(objects.size()) + " Parts as " + fileStem(path) + "_*.GoZ"};
+ return {true, "Exported " + std::to_string(objects.size()) + " Parts as " + fileStem(path) + "_*" + bridge::kExt};
}});
reg.add({"goz_send",
- "Send the visible Parts to ZBrush (Send to ZBrush, a GoZ-compatible exchange; Windows/macOS): writes each to the shared "
- "GoZ folder, lists them in GoZ_ObjectList.txt and notifies or starts ZBrush. Sending meshes received "
- "from ZBrush updates those Parts.",
- {{"name", T::String, "Part name (single Part only). Default: the name it came from ZBrush with, else the document name.", false},
- {"folder", T::String, "GoZ root folder (contains GoZBrush/ and GoZProjects/). Default: the public Pixologic folder.", false},
- {"launch", T::Bool, "Notify or start ZBrush. Default true.", false},
- {"zbrush", T::String, "ZBrush executable to start if GoZ's notifier is missing (optional).", false}},
+ "Send the visible Parts through the Bridge (Windows/macOS): writes each to the shared bridge folder, "
+ "lists them in its object list and notifies or starts the other application. Sending meshes received "
+ "through the Bridge updates those Parts.",
+ {{"name", T::String, "Part name (single Part only). Default: the name it came through the Bridge with, else the document name.", false},
+ {"folder", T::String, "Bridge folder. Default: the shared bridge folder of this system.", false},
+ {"launch", T::Bool, "Notify or start the other application. Default true.", false},
+ {"zbrush", T::String, "The other application's executable, started if its notifier is missing (optional).", false}},
[](Document& doc, const Args& a) -> CommandResult {
GozSendOptions o;
o.root = argString(a, "folder");
@@ -174,15 +176,15 @@ void registerGozCommands(CommandRegistry& reg) {
}});
reg.add({"goz_receive",
- "Receive what ZBrush last sent with GoZ (the objects in GoZ_ObjectList.txt). Each object updates the "
+ "Receive what was last sent through the Bridge (the objects in its object list). Each object updates the "
"Part it was sent from (an undoable step on that Part), or becomes a new Part; a single object "
- "replaces a scene of one Part that didn't come from ZBrush.",
- {{"folder", T::String, "GoZ root folder. Default: the public Pixologic folder.", false}},
+ "replaces a scene of one Part that didn't come through the Bridge.",
+ {{"folder", T::String, "Bridge folder. Default: the shared bridge folder of this system.", false}},
[](Document& doc, const Args& a) -> CommandResult {
std::vector<MeshObject> objects;
std::string msg;
if (!gozReceive(argString(a, "folder"), objects, msg)) return {false, msg};
- receiveObjects(doc, objects, "Receive from ZBrush", false);
+ receiveObjects(doc, objects, "Receive via Bridge", false);
return {true, msg};
}});
diff --git a/src/io/GozIO.cpp b/src/io/GozIO.cpp
index 26c81457..6629ff02 100644
--- a/src/io/GozIO.cpp
+++ b/src/io/GozIO.cpp
@@ -3,9 +3,11 @@
//
// GoZ reader/writer and bridge. The format notes come from GoB, the GPL
// Blender add-on (github.com/JoseConseco/GoB: gob_import.py, gob_export.py,
-// paths.py); docs/goz.md describes the layout.
+// paths.py); integrations/bridge-plugin/PROTOCOL.md describes the layout.
#include "io/GozIO.h"
+#include "io/BridgeProtocol.h"
+
#include "io/TextureExport.h"
#include <algorithm>
@@ -49,9 +51,9 @@ constexpr uint32_t kTagNormalMap = 0xc351;
constexpr uint32_t kTagDisplacementMap = 0xd6d9;
constexpr uint32_t kNoIndex = 0xffffffffu;
-const char kHeader[] = "GoZb 1.0 ZBrush GoZ Binary";
+using bridge::kHeader;
constexpr size_t kHeaderSize = 36; // the text, six '.' and the uint32 1 that tags the name record
-constexpr char kNamePrefix[] = "GoZMesh_";
+using bridge::kNamePrefix;
// ZBrush is Y-down; SculptForge (like OpenGL/glTF) is Y-up. GoB maps GoZ
// (x, y, z) to Blender (x, z, -y); in Y-up terms that is (x, -y, -z), a
@@ -160,16 +162,16 @@ bool parseGoz(std::span<const uint8_t> data, Mesh& out, std::string& error, GozI
GozInfo local;
GozInfo& gi = info ? *info : local;
gi = GozInfo{};
- if (data.size() < kHeaderSize + 4 || std::memcmp(data.data(), "GoZb", 4) != 0) {
- error = "Not a GoZ file (missing \"GoZb\" header)";
+ if (data.size() < kHeaderSize + 4 || std::memcmp(data.data(), bridge::kMagic, 4) != 0) {
+ error = "Not a Bridge file (missing header)";
return false;
}
Reader r(data);
r.seek(kHeaderSize);
- // Object name record: length (counted from the tag at offset 32), uint64 1, "GoZMesh_<name>".
+ // Object name record: length (counted from the tag at offset 32), uint64 1, kNamePrefix + name.
uint32_t nameLen = 0;
if (!r.u32(nameLen) || nameLen < 16 || nameLen - 8 > r.remaining()) {
- error = "GoZ file has a truncated object name";
+ error = "Bridge file has a truncated object name";
return false;
}
{
@@ -263,7 +265,7 @@ bool parseGoz(std::span<const uint8_t> data, Mesh& out, std::string& error, GozI
}
if (positions.empty() || faces.empty()) {
- error = "GoZ file has no " + std::string(positions.empty() ? "vertices" : "faces");
+ error = "Bridge file has no " + std::string(positions.empty() ? "vertices" : "faces");
return false;
}
@@ -301,7 +303,7 @@ bool parseGoz(std::span<const uint8_t> data, Mesh& out, std::string& error, GozI
}
if (m.hasQuads()) m.quadPartners.resize(m.triangles.size(), Mesh::kNoQuad);
if (m.triangles.empty()) {
- error = "GoZ file has no valid faces";
+ error = "Bridge file has no valid faces";
return false;
}
if (mask.size() == nv && std::any_of(mask.begin(), mask.end(), [](float v) { return v > 0.0f; }))
@@ -309,7 +311,7 @@ bool parseGoz(std::span<const uint8_t> data, Mesh& out, std::string& error, GozI
if (colors.size() == nv) m.colors = std::move(colors);
m.rebuildTopology();
m.recomputeAllNormals();
- if (skipped) error = std::to_string(skipped) + " GoZ faces with out-of-range indices were skipped";
+ if (skipped) error = std::to_string(skipped) + " Bridge file faces with out-of-range indices were skipped";
out = std::move(m);
return true;
}
@@ -528,11 +530,11 @@ bool launchDetached(const std::string& target) {
std::string findZBrush() {
std::error_code ec;
#ifdef _WIN32
- const fs::path bases[] = {"C:\\Program Files", "C:\\Program Files\\Pixologic", "C:\\Program Files\\Maxon"};
- const char* exe = "ZBrush.exe";
+ const auto& bases = bridge::kWinInstallDirs;
+ const char* exe = bridge::kWinExe;
#else
- const fs::path bases[] = {"/Applications"};
- const char* exe = "ZBrush.app";
+ const char* const bases[] = {"/Applications"};
+ const char* exe = bridge::kMacApp;
#endif
std::vector<fs::path> found;
for (const auto& base : bases) {
@@ -540,8 +542,8 @@ std::string findZBrush() {
for (const auto& entry : fs::directory_iterator(base, ec)) {
std::string n = pathUtf8(entry.path().filename());
std::transform(n.begin(), n.end(), n.begin(), [](unsigned char c) { return char(std::tolower(c)); });
- if (n.find("zbrush") == std::string::npos) continue;
- if (n == "zbrush.app") found.push_back(entry.path());
+ if (n.find(bridge::kAppNameLower) == std::string::npos) continue;
+ if (n == bridge::kMacAppLower) found.push_back(entry.path());
else if (fs::exists(entry.path() / exe, ec)) found.push_back(entry.path() / exe);
}
}
@@ -557,23 +559,23 @@ std::string gozDefaultRoot() {
#ifdef _WIN32
std::string pub = envUtf8(L"PUBLIC");
if (pub.empty()) pub = "C:\\Users\\Public";
- return pathUtf8(utf8Path(pub) / "Pixologic");
+ return pathUtf8(utf8Path(pub) / bridge::kVendorFolder);
#elif defined(__APPLE__)
- return "/Users/Shared/Pixologic";
+ return bridge::kMacRoot;
#else
return {};
#endif
}
std::string gozUnavailableMessage() {
- return "Send to ZBrush needs ZBrush, which runs only on Windows and macOS. Use Export / Import GoZ-compatible file "
- "to move .GoZ files by hand, or set a bridge folder (e.g. a Wine prefix's Users/Public/Pixologic).";
+ return "The Bridge's default folder exists only on Windows and macOS. Use Export / Import Bridge file to move "
+ "files by hand, or set a custom bridge folder (for example inside a Wine prefix).";
}
void setGozApplicationPath(std::string executable) { g_appPath = std::move(executable); }
std::string gozObjectListPath(const std::string& root) {
- return root.empty() ? std::string() : pathUtf8(utf8Path(root) / "GoZBrush" / "GoZ_ObjectList.txt");
+ return root.empty() ? std::string() : pathUtf8(utf8Path(root) / bridge::kInboxFolder / bridge::kObjectList);
}
bool gozShellSafePath(const std::string& path) {
@@ -600,15 +602,15 @@ bool gozSend(const std::vector<MeshObjectRef>& objects, const GozSendOptions& o,
std::error_code ec;
if (o.launch) { // these paths reach the shell (launchDetached)
if (!gozShellSafePath(root)) {
- message = "The bridge folder path contains characters that are not allowed when launching ZBrush";
+ message = "The bridge folder path contains characters that are not allowed when launching the other application";
return false;
}
if (!o.zbrushPath.empty()) {
std::string file = pathUtf8(utf8Path(o.zbrushPath).filename());
std::transform(file.begin(), file.end(), file.begin(), [](unsigned char c) { return char(std::tolower(c)); });
- if (!gozShellSafePath(o.zbrushPath) || file.find("zbrush") == std::string::npos ||
+ if (!gozShellSafePath(o.zbrushPath) || file.find(bridge::kAppNameLower) == std::string::npos ||
!fs::exists(utf8Path(o.zbrushPath), ec)) {
- message = "Not a ZBrush executable: " + o.zbrushPath;
+ message = "Not the other application's executable: " + o.zbrushPath;
return false;
}
}
@@ -623,9 +625,9 @@ bool gozSend(const std::vector<MeshObjectRef>& objects, const GozSendOptions& o,
return false;
}
const fs::path rootPath = utf8Path(root);
- const fs::path brush = rootPath / "GoZBrush";
- const fs::path project = rootPath / "GoZProjects" / "Default";
- const fs::path app = rootPath / "GoZApps" / "SculptForge";
+ const fs::path brush = rootPath / bridge::kInboxFolder;
+ const fs::path project = rootPath / bridge::kProjectsFolder / "Default";
+ const fs::path app = rootPath / bridge::kAppsFolder / "SculptForge";
for (const auto& d : {brush, project, app}) fs::create_directories(d, ec);
if (!fs::is_directory(project, ec)) {
message = "Cannot create the bridge folder " + pathUtf8(project);
@@ -643,25 +645,21 @@ bool gozSend(const std::vector<MeshObjectRef>& objects, const GozSendOptions& o,
// Object paths are written without the .GoZ extension, ZBrush appends it.
const std::string base = genericUtf8(project / name);
std::string err;
- if (!saveGoz(pathUtf8(project / (name + ".GoZ")), *obj.mesh, name, err)) {
+ if (!saveGoz(pathUtf8(project / (name + bridge::kExt)), *obj.mesh, name, err)) {
message = err;
return false;
}
ok = ok && writeText(project / (name + ".ztn"), base);
list += base + "\n";
}
- ok = ok && writeText(brush / "GoZ_ObjectList.txt", list) && writeText(brush / "GoZ_Application.txt", "SculptForge") &&
- writeText(brush / "GoZ_ProjectPath.txt", genericUtf8(project) + "/");
+ ok = ok && writeText(brush / bridge::kObjectList, list) && writeText(brush / bridge::kApplicationFile, "SculptForge") &&
+ writeText(brush / bridge::kProjectPathFile, genericUtf8(project) + "/");
// Register SculptForge in ZBrush's GoZ application list.
- if (!fs::exists(app / "GoZ_Info.txt", ec))
- ok = ok && writeText(app / "GoZ_Info.txt",
- "NAME\t\t\t=\t\"SculptForge\"\nGOZ_VERSION\t\t=\t1\nEXTENSION\t\t=\t\".GoZ\"\n"
- "TAMPLATE\t\t=\t\"GoZ Complete Binary.GoZ\"\n\nEXPORT_FLIP_Y\t\t\t=\tFALSE\n"
- "EXPORT_FLIP_Z\t\t\t=\tFALSE\nIMPORT_FLIP_Y\t\t\t=\tFALSE\nIMPORT_FLIP_Z\t\t\t=\tFALSE\n");
+ if (!fs::exists(app / bridge::kInfoFile, ec)) ok = ok && writeText(app / bridge::kInfoFile, bridge::kInfoText);
if (!g_appPath.empty())
- ok = ok && writeText(app / "GoZ_Config.txt", "PATH = \"" + genericUtf8(utf8Path(g_appPath)) + "\"");
+ ok = ok && writeText(app / bridge::kConfigFile, "PATH = \"" + genericUtf8(utf8Path(g_appPath)) + "\"");
if (!ok) {
- message = "Cannot write the GoZ bridge files in " + root;
+ message = "Cannot write the bridge files in " + root;
return false;
}
message = "Sent " + names.front() + (names.size() > 1 ? " and " + std::to_string(names.size() - 1) + " more Parts" : "") +
@@ -672,22 +670,22 @@ bool gozSend(const std::vector<MeshObjectRef>& objects, const GozSendOptions& o,
// Official GoZ plug-ins notify a running ZBrush with GoZBrushFromApp; GoB
// starts ZBrush itself. Do the first, fall back to the second.
#ifdef _WIN32
- const fs::path notifier = brush / "GoZBrushFromApp.exe";
+ const fs::path notifier = brush / bridge::kNotifierWin;
#else
- const fs::path notifier = brush / "GoZBrushFromApp.app";
+ const fs::path notifier = brush / bridge::kNotifierMac;
#endif
#if defined(_WIN32) || defined(__APPLE__)
if (fs::exists(notifier, ec)) {
launchDetached(pathUtf8(notifier));
- message += "; ZBrush notified";
+ message += "; the other application was notified";
return true;
}
const std::string zbrush = o.zbrushPath.empty() ? findZBrush() : o.zbrushPath;
if (!zbrush.empty() && launchDetached(zbrush)) {
- message += "; started " + zbrush + " (use GoZ in ZBrush to import it)";
+ message += "; started " + zbrush + " (import from the bridge there)";
return true;
}
- message += "; ZBrush was not found (install GoZ from ZBrush's Preferences > GoZ, then press GoZ in ZBrush)";
+ message += "; the other application was not found (set it up once: Help > User Guide > Exporting, Bridge)";
#else
(void)notifier;
message += "; " + gozUnavailableMessage();
@@ -730,7 +728,7 @@ bool gozReceive(const std::string& rootIn, std::vector<MeshObject>& out, std::st
}
std::ifstream list(utf8Path(gozObjectListPath(root)), std::ios::binary);
if (!list) {
- message = "Nothing to receive: " + gozObjectListPath(root) + " does not exist (press GoZ in ZBrush first)";
+ message = "Nothing to receive: " + gozObjectListPath(root) + " does not exist (send from the other application first)";
return false;
}
std::vector<MeshObject> loaded;
@@ -741,7 +739,7 @@ bool gozReceive(const std::string& rootIn, std::vector<MeshObject>& out, std::st
std::string path = line;
std::string lower = path;
std::transform(lower.begin(), lower.end(), lower.begin(), [](unsigned char c) { return char(std::tolower(c)); });
- if (lower.size() < 4 || lower.compare(lower.size() - 4, 4, ".goz") != 0) path += ".GoZ";
+ if (lower.size() < 4 || lower.compare(lower.size() - 4, 4, bridge::kExtLower) != 0) path += bridge::kExt;
Mesh m;
GozInfo info;
std::string err;
@@ -752,14 +750,14 @@ bool gozReceive(const std::string& rootIn, std::vector<MeshObject>& out, std::st
loaded.push_back({info.name.empty() ? pathUtf8(utf8Path(path).stem()) : info.name, std::move(m)});
}
if (loaded.empty()) {
- message = problems.empty() ? "Nothing to receive: GoZ_ObjectList.txt is empty" : problems;
+ message = problems.empty() ? "Nothing to receive: the bridge's object list is empty" : problems;
return false;
}
size_t tris = 0;
for (const auto& obj : loaded) tris += obj.mesh.triangleCount();
message = "Received " + loaded.front().name;
if (loaded.size() > 1) message += " and " + std::to_string(loaded.size() - 1) + " more Parts";
- message += " from ZBrush (" + std::to_string(tris) + " triangles)";
+ message += " through the Bridge (" + std::to_string(tris) + " triangles)";
if (!problems.empty()) message += "; skipped: " + problems;
out = std::move(loaded);
return true;
@@ -787,13 +785,14 @@ bool gozReceive(const std::string& root, Mesh& out, std::string& message, std::v
std::string zbrushProprietaryMessage(const std::string& extension) {
std::string ext = extension;
std::transform(ext.begin(), ext.end(), ext.begin(), [](unsigned char c) { return char(std::toupper(c)); });
- if (ext == ".ZTL")
- return ".ZTL is ZBrush's proprietary format and cannot be read directly. Convert it once in ZBrush with the "
- "SculptForge ZTL Export plug-in (Help > User Guide > Coming from ZBrush), then open the .ztl again; "
- "or send the model with GoZ (File > Send to ZBrush > Receive from ZBrush).";
- return ext + " is ZBrush's proprietary format and cannot be read. In ZBrush, send the model with GoZ "
- "(File > Send to ZBrush > Receive from ZBrush) or export it as OBJ or FBX "
- "(Tool > Export / the FBX ExportImport plug-in) and open that instead.";
+ std::string lower = extension;
+ std::transform(lower.begin(), lower.end(), lower.begin(), [](unsigned char c) { return char(std::tolower(c)); });
+ if (lower == bridge::kLibraryExtLower)
+ return ext + " is another application's proprietary format and cannot be read directly. Convert it once with "
+ "the Bridge export plug-in (Help > User Guide > Exporting, Bridge), then open it again; or send "
+ "the model through the Bridge (File > Bridge > Receive).";
+ return ext + " is another application's proprietary format and cannot be read. Send the model through the "
+ "Bridge (File > Bridge > Receive) or export it as OBJ or FBX there and open that instead.";
}
namespace {
@@ -820,7 +819,7 @@ std::vector<std::string> convertedZToolFiles(const std::string& path) {
std::vector<fs::path> files;
auto scan = [&](const fs::path& dir, const std::string& stem) {
for (fs::directory_iterator it(dir, ec), end; !ec && it != end; it.increment(ec)) {
- if (lowerAscii(pathUtf8(it->path().extension())) != ".goz" || !it->is_regular_file(ec)) continue;
+ if (lowerAscii(pathUtf8(it->path().extension())) != bridge::kExtLower || !it->is_regular_file(ec)) continue;
if (!stem.empty() && ztoolPrefixLength(pathUtf8(it->path().stem()), stem) == 0) continue;
files.push_back(it->path());
}
@@ -845,11 +844,11 @@ bool loadConvertedZTool(const std::string& path, std::vector<MeshObject>& out, s
std::error_code ec;
const std::vector<std::string> files = convertedZToolFiles(path);
if (files.empty()) {
- error = "No converted ZTool found for " + path + " (convert it in ZBrush with the SculptForge ZTL Export plug-in)";
+ error = "No converted files found for " + path + " (convert it once with the Bridge export plug-in)";
return false;
}
const fs::path source = utf8Path(path);
- const bool isZtl = lowerAscii(pathUtf8(source.extension())) == ".ztl";
+ const bool isZtl = lowerAscii(pathUtf8(source.extension())) == bridge::kLibraryExtLower;
out.clear();
fs::file_time_type newest{};
for (const std::string& file : files) {
@@ -874,11 +873,11 @@ bool loadConvertedZTool(const std::string& path, std::vector<MeshObject>& out, s
if (obj.mesh.triangleCount() > 0) out.push_back(std::move(obj));
}
if (out.empty()) {
- error = "The converted ZTool for " + path + " has no polygons";
+ error = "The converted files for " + path + " has no polygons";
return false;
}
if (note && isZtl && fs::last_write_time(source, ec) > newest && !ec)
- *note = "the .ztl was saved after it was converted; convert it again in ZBrush to get the latest version";
+ *note = "the file was saved after it was converted; convert it again to get the latest version";
return true;
}
diff --git a/src/io/GozIO.h b/src/io/GozIO.h
index 04056e1e..d2b55310 100644
--- a/src/io/GozIO.h
+++ b/src/io/GozIO.h
@@ -1,15 +1,13 @@
// SculptForge - open source digital sculpting
// SPDX-License-Identifier: GPL-3.0-or-later
//
-// GoZ: ZBrush's bridge format (.GoZ binary meshes plus a shared "GoZ folder"
-// with an object list). The binary layout follows the open-source
-// Blender add-on GoB (github.com/JoseConseco/GoB, GPL); see docs/goz.md.
+// Bridge files: binary meshes plus a shared bridge folder with an object list (io/BridgeProtocol.h holds the
+// protocol's names). The binary layout follows the open-source Blender add-on GoB (github.com/JoseConseco/GoB,
+// GPL); see integrations/bridge-plugin/PROTOCOL.md.
//
-// .GoZ carries positions, tri/quad faces, per-face-corner UVs, polygroups,
-// mask and polypaint. Quads are triangulated on import as (a,b,c) + (a,c,d)
-// and kept paired (Mesh::quadPartners); export writes the pairs back as quads
-// (meshes without kept quads pair consecutive (a,b,c),(a,c,d) triangles).
-// ZBrush's own .ZTL/.ZPR files are proprietary and cannot be read.
+// A Bridge file carries positions, tri/quad faces, per-face-corner UVs, face groups, mask and vertex paint. Quads
+// are triangulated on import as (a,b,c) + (a,c,d) and kept paired (Mesh::quadPartners); export writes the pairs
+// back as quads (meshes without kept quads pair consecutive (a,b,c),(a,c,d) triangles).
#pragma once
#include "core/Mesh.h"
@@ -24,7 +22,7 @@ namespace sf {
// Extra GoZ information that has no place in Mesh.
struct GozInfo {
- std::string name; // object (SubTool) name without the "GoZMesh_" prefix
+ std::string name; // object (SubTool) name without the bridge::kNamePrefix prefix
int subdivisionLevel = 0; // as recorded by ZBrush (informational)
std::string diffuseMap, displacementMap, normalMap; // texture paths, if any
size_t quads = 0, triangles = 0; // GoZ faces read
diff --git a/src/io/MayaBridge.h b/src/io/MayaBridge.h
index 46a5ab31..1b6e308e 100644
--- a/src/io/MayaBridge.h
+++ b/src/io/MayaBridge.h
@@ -49,7 +49,7 @@ std::string mayaOutbox(const std::string& folder); // <folder>/sculptforge_to_ma
std::string mayaManifestPath(const std::string& box); // <box>/manifest.json
// A name Maya accepts as is: letters, digits and '_' (anything else becomes '_'), not starting with a digit,
-// at most kMayaMaxNameBytes; "" becomes "SubTool".
+// at most kMayaMaxNameBytes; "" becomes "Part".
std::string mayaSafeName(const std::string& name);
// A file name a manifest may list: 1..kMayaMaxFileNameBytes of [A-Za-z0-9_.-], not starting with '.', no "..",
// ending in ".obj".
diff --git a/src/io/UsdIO.cpp b/src/io/UsdIO.cpp
index 22331a06..4cdd10c9 100644
--- a/src/io/UsdIO.cpp
+++ b/src/io/UsdIO.cpp
@@ -376,7 +376,7 @@ void writeMaterial(Writer& w, const std::string& path, const std::string& name,
w.s += '\n';
w.open("def Shader \"PreviewSurface\"");
w.line("uniform token info:id = \"UsdPreviewSurface\"");
- if (painted) w.line("color3f inputs:diffuseColor.connect = <" + path + "/Polypaint.outputs:result>");
+ if (painted) w.line("color3f inputs:diffuseColor.connect = <" + path + "/VertexPaint.outputs:result>");
else w.line("color3f inputs:diffuseColor = (0.72, 0.68, 0.62)");
w.line("float inputs:metallic = 0");
w.line("float inputs:roughness = 0.65");
@@ -384,7 +384,7 @@ void writeMaterial(Writer& w, const std::string& path, const std::string& name,
w.close();
if (painted) {
w.s += '\n';
- w.open("def Shader \"Polypaint\"");
+ w.open("def Shader \"VertexPaint\"");
w.line("uniform token info:id = \"UsdPrimvarReader_float3\"");
w.line("string inputs:varname = \"displayColor\"");
w.line("float3 outputs:result");
diff --git a/src/python/module.cpp b/src/python/module.cpp
index e5f3939b..2226dd6a 100644
--- a/src/python/module.cpp
+++ b/src/python/module.cpp
@@ -283,7 +283,7 @@ PYBIND11_MODULE(sculptforge, m) {
return out;
},
py::arg("name"),
- "A selection set's channels at the current subdivision level, as a dict of NumPy arrays (mask, polygroups, "
+ "A selection set's channels at the current subdivision level, as a dict of NumPy arrays (mask, polygroups, " // marks-pending
"colors, hidden, uvs (per triangle corner), positions), only those the set holds.")
.def(
"set_selection_set",
@@ -303,7 +303,7 @@ PYBIND11_MODULE(sculptforge, m) {
}
if (!uvs.is_none()) data.uvs = rows<glm::vec2>(uvs, nt * 3, 2, "uvs"), data.channels |= kSetUvs;
if (!positions.is_none()) data.positions = rows<glm::vec3>(positions, nv, 3, "positions"), data.channels |= kSetMorph;
- if (!data.channels) throw py::value_error("give at least one of mask, polygroups, colors, hidden, uvs, positions");
+ if (!data.channels) throw py::value_error("give at least one of mask, polygroups, colors, hidden, uvs, positions"); // marks-pending
SelectionSet set;
std::string msg;
if (!makeSelectionSet(name, data, uint32_t(nv), uint32_t(nt), subdivCurrentLevel(d.mesh), set, msg) ||
diff --git a/tests/blender/test_exchange.py b/tests/blender/test_exchange.py
index abd6ef77..26246a34 100644
--- a/tests/blender/test_exchange.py
+++ b/tests/blender/test_exchange.py
@@ -145,7 +145,7 @@ def test_goz_round_trip(tmp):
check(np.array_equal(g.groups, arrays["groups"]), "GoZ polygroups")
with open(path, "rb") as f:
head = f.read(64)
- check(head.startswith(b"GoZb 1.0 ZBrush GoZ Binary......"), "GoZ header as GoB writes it")
+ check(head.startswith(b"GoZb 1.0 classic GoZ Binary......"), "GoZ header as GoB writes it")
def test_manifest(tmp):
diff --git a/tests/blender/test_in_blender.py b/tests/blender/test_in_blender.py
index fcbbfdb5..fdaea834 100644
--- a/tests/blender/test_in_blender.py
+++ b/tests/blender/test_in_blender.py
@@ -7,7 +7,7 @@
# Sends a small scene to SculptForge (sculptforge-cli stands in for the app: blender_receive, then
# blender_send), receives it back and checks that the objects are unchanged: positions, n-gons,
# transforms, materials, modifiers, UVs, colours, mask and face sets. Then a topology change (subdivide)
-# and a new SubTool come back as a rebuilt mesh and a new object. The ZBrush-style keys preference adds and
+# and a new SubTool come back as a rebuilt mesh and a new object. The classic keys preference adds and
# removes its keymap items, each bound to a real operator with valid settings. Vector displacement maps that
# SculptForge exports read in Blender with the same orientation, and Blender's EXRs load in SculptForge.
# CMake runs it when `blender` is found.
@@ -110,32 +110,32 @@ def addon_sculpt_items():
return list(km.keymap_items) if km else []
-def test_zbrush_keys():
- keys = bridge.zbrush_keys
+def test_classic_keys():
+ keys = bridge.classic_keys
p = bridge.prefs()
before = len(addon_sculpt_items())
- check(not p.zbrush_keys and not keys.enabled(), "ZBrush keys: off by default")
- p.zbrush_keys = True
+ check(not p.classic_keys and not keys.enabled(), "Classic keys: off by default")
+ p.classic_keys = True
table = keys.key_table()
items = addon_sculpt_items()
- check(len(items) == before + len(table), "ZBrush keys: one keymap item per key (%d)" % len(table))
+ check(len(items) == before + len(table), "Classic keys: one keymap item per key (%d)" % len(table))
for zkey, what, idname, key, ctrl, shift, alt, value, props in table:
kmi = next((i for i in items if i.idname == idname and i.type == key and i.ctrl == ctrl and i.shift == shift
and i.alt == alt), None)
- check(kmi is not None and kmi.active, "ZBrush keys: %s -> %s" % (zkey or key, idname))
+ check(kmi is not None and kmi.active, "Classic keys: %s -> %s" % (zkey or key, idname))
mod, fn = idname.split(".")
try: # (hasattr is always true on bpy.ops: the operator is looked up when called)
getattr(getattr(bpy.ops, mod), fn).get_rna_type()
exists = True
except (AttributeError, KeyError, RuntimeError):
exists = False
- check(exists, "ZBrush keys: operator %s exists" % idname)
+ check(exists, "Classic keys: operator %s exists" % idname)
for name, v in props.items():
got = getattr(kmi.properties, name) if kmi else None
same = got == v or (isinstance(v, str) and isinstance(got, str) and got.upper() == v.upper()) or \
(isinstance(v, float) and abs(got - v) < 1e-6)
- check(same, "ZBrush keys: %s %s = %r" % (idname, name, v))
- check(not keys.skipped, "ZBrush keys: none skipped %s" % keys.skipped)
+ check(same, "Classic keys: %s %s = %r" % (idname, name, v))
+ check(not keys.skipped, "Classic keys: none skipped %s" % keys.skipped)
# Every data path the keys use resolves in Sculpt Mode (they changed between Blender 4.2 and 5).
for obj in list(bpy.data.objects):
bpy.data.objects.remove(obj)
@@ -151,37 +151,37 @@ def test_zbrush_keys():
ok = True
except ValueError:
ok = False
- check(ok, "ZBrush keys: %s resolves (%s)" % (path, zkey or key))
- check(bpy.types.Menu.bl_rna_get_subclass_py(keys.SCULPTFORGE_MT_zbrush_brushes.bl_idname) is not None,
- "ZBrush keys: the brush menu is registered")
+ check(ok, "Classic keys: %s resolves (%s)" % (path, zkey or key))
+ check(bpy.types.Menu.bl_rna_get_subclass_py(keys.SCULPTFORGE_MT_classic_brushes.bl_idname) is not None,
+ "Classic keys: the brush menu is registered")
# The brush menu's picks.
for name, _, asset, sculpt_tool, _ in keys.BRUSHES:
- r = bpy.ops.sculptforge.zbrush_brush(brush=name)
+ r = bpy.ops.sculptforge.classic_brush(brush=name)
brush = bpy.context.tool_settings.sculpt.brush
got = brush.name if keys.brush_assets() else brush.sculpt_tool
check(r == {"FINISHED"} and got == (asset if keys.brush_assets() else sculpt_tool),
- "ZBrush brush %s -> Blender %s (%s)" % (name, asset, got))
+ "classic brush %s -> Blender %s (%s)" % (name, asset, got))
# Ctrl+D divides (a Multires level); D / Shift+D step between levels without adding any.
- check(bpy.ops.sculptforge.zbrush_divide() == {"FINISHED"}, "Ctrl+D: Divide")
- bpy.ops.sculptforge.zbrush_divide()
+ check(bpy.ops.sculptforge.classic_divide() == {"FINISHED"}, "Ctrl+D: Divide")
+ bpy.ops.sculptforge.classic_divide()
multires = next((m for m in bpy.context.active_object.modifiers if m.type == "MULTIRES"), None)
check(multires is not None and multires.total_levels == 2, "Ctrl+D in Sculpt Mode adds Multires levels")
if multires is not None:
- bpy.ops.sculptforge.zbrush_sdiv(step=-1)
- bpy.ops.sculptforge.zbrush_sdiv(step=-1)
- bpy.ops.sculptforge.zbrush_sdiv(step=-1)
+ bpy.ops.sculptforge.classic_sdiv(step=-1)
+ bpy.ops.sculptforge.classic_sdiv(step=-1)
+ bpy.ops.sculptforge.classic_sdiv(step=-1)
check(multires.sculpt_levels == 0 and multires.total_levels == 2, "Shift+D steps down to SDiv 0")
- bpy.ops.sculptforge.zbrush_sdiv(step=1)
- bpy.ops.sculptforge.zbrush_sdiv(step=1)
- bpy.ops.sculptforge.zbrush_sdiv(step=1)
+ bpy.ops.sculptforge.classic_sdiv(step=1)
+ bpy.ops.sculptforge.classic_sdiv(step=1)
+ bpy.ops.sculptforge.classic_sdiv(step=1)
check(multires.sculpt_levels == 2 and multires.total_levels == 2, "D steps up to the top, adds nothing")
- # Ctrl+W (sculptforge.zbrush_group) runs sculpt operators that need a viewport (mask_flood_fill crashes
+ # Ctrl+W (sculptforge.classic_group) runs sculpt operators that need a viewport (mask_flood_fill crashes
# headless Blender): only its poll is checked here.
- check(bpy.ops.sculptforge.zbrush_group.poll(), "Ctrl+W: Group is available in Sculpt Mode")
+ check(bpy.ops.sculptforge.classic_group.poll(), "Ctrl+W: Group is available in Sculpt Mode")
bpy.ops.object.mode_set(mode="OBJECT")
- p.zbrush_keys = False
- check(len(addon_sculpt_items()) == before and not keys.enabled(), "ZBrush keys: turning it off removes them")
- p.zbrush_keys = True # (the add-on's unregister removes them too: checked after disabling it)
+ p.classic_keys = False
+ check(len(addon_sculpt_items()) == before and not keys.enabled(), "Classic keys: turning it off removes them")
+ p.classic_keys = True # (the add-on's unregister removes them too: checked after disabling it)
def read_sfvdm(path):
@@ -311,11 +311,11 @@ def main():
check(eyes is not None and eyes.data.shape_keys is not None and "eyeLookUpLeft" in eyes.data.shape_keys.key_blocks,
"Eyes: eyeLook shape keys")
- test_zbrush_keys()
+ test_classic_keys()
test_vdm_exr()
addon_utils.disable("sculptforge_bridge")
- check(not bridge.zbrush_keys.enabled(), "disabling the add-on removes the ZBrush keys")
+ check(not bridge.classic_keys.enabled(), "disabling the add-on removes the Classic keys")
print("%d failure(s)" % len(failures))
sys.exit(1 if failures else 0)
diff --git a/tests/test_blender_keymap.cpp b/tests/test_blender_keymap.cpp
index ac761bcf..19946e04 100644
--- a/tests/test_blender_keymap.cpp
+++ b/tests/test_blender_keymap.cpp
@@ -54,9 +54,9 @@ TEST(blender_keymap_export_is_read_as_text) {
CHECK(parseBlenderKeymap(readFile(SF_TEST_DATA_DIR "/blender_keymap_export.py"), k, err));
CHECK(err.empty());
CHECK(keysOf(k, "brush.standard") == "D");
- CHECK(keysOf(k, "brush.claybuildup") == "Shift+Q"); // a 4.3+ brush asset
+ CHECK(keysOf(k, "brush.clayblock") == "Shift+Q"); // a 4.3+ brush asset
CHECK(keysOf(k, "brush.crease") == "Shift+C");
- CHECK(keysOf(k, "brush.snakehook").empty()); // switched off in Blender ("active": False)
+ CHECK(keysOf(k, "brush.tendril").empty()); // switched off in Blender ("active": False)
CHECK(keysOf(k, "ui.size_popup") == "F");
CHECK(keysOf(k, "ui.strength_popup") == "Shift+R");
CHECK(keysOf(k, "mask.clear") == "Alt+M");
diff --git a/tests/ui/along_normal.sfui b/tests/ui/along_normal.sfui
index 0c092d70..36cd55de 100644
--- a/tests/ui/along_normal.sfui
+++ b/tests/ui/along_normal.sfui
@@ -28,7 +28,7 @@ key ctrl+z
expect_value moved == 0
# Tendril with Alt pulls straight out too.
-click "Tendril##brush.snakehook"
+click "Tendril##brush.tendril"
hold alt
stroke 0.86 0.5 0.98 0.38
hold none
diff --git a/tests/ui/blender_keys.sfui b/tests/ui/blender_keys.sfui
index 2424b8f9..57e8cdd8 100644
--- a/tests/ui/blender_keys.sfui
+++ b/tests/ui/blender_keys.sfui
@@ -264,7 +264,7 @@ click "Mouse & pen"
expect_text Middle drag
shot controls-blender
# The style row in Controls switches too.
-click "ZBrush-style##input.style_zbrush"
+click "Classic sculpting keys##input.style_zbrush"
expect_value input_style == 0
expect_text Alt + click it
key f1
@@ -275,7 +275,7 @@ expect_status Blender keymap: 13 keys
expect_value input_style == 2
expect_shortcut brush.standard D
expect_shortcut geometry.higher_res Alt+2
-expect_shortcut brush.claybuildup Shift+Q
+expect_shortcut brush.clayblock Shift+Q
expect_shortcut ui.strength_popup Shift+R
expect_shortcut view.ortho \
expect_shortcut view.front Numpad 1
@@ -292,7 +292,7 @@ click "Restore Standard UI##config.restore_standard"
expect_value shortcut_conflicts == 0
expect_shortcut brush.standard V
key f1
-click "ZBrush-style##input.style_zbrush"
+click "Classic sculpting keys##input.style_zbrush"
key f1
expect_value input_style == 0
expect_value shortcut_conflicts == 0
diff --git a/tests/ui/custom_matcaps.sfui b/tests/ui/custom_matcaps.sfui
index 8142d401..e272527a 100644
--- a/tests/ui/custom_matcaps.sfui
+++ b/tests/ui/custom_matcaps.sfui
@@ -17,7 +17,7 @@ click "Material##palette.material"
expect "Material/Load Lit Sphere..."
key escape
run load_matcap path=$SCRIPT_DIR/data/Gold.png
-expect_status "Material: Gold (kept in the MatCaps folder)"
+expect_status "Material: Gold (kept in the Lit Spheres folder)"
expect_value material_custom == 1
expect_value custom_matcaps == 2
expect_value matcap_files == 1
diff --git a/tests/ui/dyntopo.sfui b/tests/ui/dyntopo.sfui
index dfa7bad3..ba129dff 100644
--- a/tests/ui/dyntopo.sfui
+++ b/tests/ui/dyntopo.sfui
@@ -28,7 +28,7 @@ shot wireframe
# Snake Hook pulls a horn out of the sphere, with new triangles all along it.
remember triangles pulled
-click "Tendril##brush.snakehook"
+click "Tendril##brush.tendril"
stroke 0.62 0.3 0.95 0.05
expect_value triangles > $pulled
shot snake_hook
diff --git a/tests/ui/forge_spheres_pointer.sfui b/tests/ui/forge_spheres_pointer.sfui
index 044d26ca..1586ce0e 100644
--- a/tests/ui/forge_spheres_pointer.sfui
+++ b/tests/ui/forge_spheres_pointer.sfui
@@ -7,11 +7,11 @@ run zsphere_new radius=1
run subtool_visibility index=0 visible=false
wait 0.3
click "Forge Spheres##tool.zspheres"
-expect "ZSpheres/Drag places child"
+expect "Forge Spheres/Drag places child"
hold ctrl
-hover "ZSpheres/Drag places child"
+hover "Forge Spheres/Drag places child"
expect_help "moves the new sphere away"
-hover "ZSpheres/Delete Selected"
+hover "Forge Spheres/Delete Selected"
expect_help "selected sphere"
hold none
@@ -25,7 +25,7 @@ key ctrl+z
expect_value zspheres == 1
# On: the same drag pulls the new sphere out, at half the parent's size.
-click "ZSpheres/Drag places child"
+click "Forge Spheres/Drag places child"
expect_value zsphere_place_child == 1
view_drag 0.515 0.518 0.600 0.518
expect_value zspheres == 3
@@ -36,7 +36,7 @@ expect_status "Forge Sphere add"
expect_value zsphere_selected == 1
shot placed
key ctrl+z
-click "ZSpheres/Drag places child"
+click "Forge Spheres/Drag places child"
expect_value zsphere_place_child == 0
# Ctrl+drag places too, with the toggle off.
@@ -47,13 +47,13 @@ expect_value zspheres == 3
expect_value zsphere_out1 > 1.4
# Insert Between on the selected arm: a joint (and its mirror), selected.
-click "ZSpheres/Insert Between"
+click "Forge Spheres/Insert Between"
expect_value zspheres == 5
expect_status "Forge Sphere insert"
expect_value zsphere_selected == 3
# Delete Selected: the joint and the arm beyond it go (both sides); the root stays.
-click "ZSpheres/Delete Selected"
+click "Forge Spheres/Delete Selected"
expect_value zspheres == 1
expect_value zsphere_selected == -1
key ctrl+z
diff --git a/tests/ui/insert_mesh.sfui b/tests/ui/insert_mesh.sfui
index e42114f2..068e9df5 100644
--- a/tests/ui/insert_mesh.sfui
+++ b/tests/ui/insert_mesh.sfui
@@ -1,7 +1,7 @@
# #34: Append > Insert on the model with your own mesh: a copy of another SubTool, or a model file.
run new_sphere subdivisions=4
key f
-click "SubTools/Append"
+click "Parts/Append"
click "Cube"
expect_value subtools == 2
run subtool_select index=0
@@ -9,7 +9,7 @@ key f
# A copy of the Cube SubTool, dragged onto the sphere (X symmetry is on: a mirrored copy too), one undo step.
remember triangles base
-click "SubTools/Append"
+click "Parts/Append"
hover "Insert on the model"
hover "Active Part's copy..."
click "Cube##insertcopy1"
diff --git a/tests/ui/language.sfui b/tests/ui/language.sfui
index d0e4d69e..501d40a1 100644
--- a/tests/ui/language.sfui
+++ b/tests/ui/language.sfui
@@ -24,7 +24,7 @@ expect "Dibujar##tool.draw"
expect "Mover##tool.move"
expect_text "Tamaño de dibujo"
expect_text "Intensidad"
-expect "Clay Block##brush.claybuildup"
+expect "Clay Block##brush.clayblock"
expect "Move##brush.move"
expect "Piezas##tool.subtool"
diff --git a/tests/ui/looks.sfui b/tests/ui/looks.sfui
index 884a9ff3..4d2a41ba 100644
--- a/tests/ui/looks.sfui
+++ b/tests/ui/looks.sfui
@@ -26,7 +26,7 @@ expect_not "Tool##palette.tool"
expect_not "Library##ui.lightbox" # moved off the shelf (View > Display, F3)
expect "Clay##brush.clay"
expect "##drawsize"
-expect "SubTools/Append" # the Tool palette stays in the right tray
+expect "Parts/Append" # the Tool palette stays in the right tray
shot forge
# Every palette is a section of one menu.
@@ -189,7 +189,7 @@ click "##welcome.look.neutral"
wait 0.2
expect_value look_neutral == 1
shot welcome-neutral
-click "ZBrush##welcome.from"
+click "Classic sculpting keys##welcome.from"
wait 0.2
expect_value shell_layout == 0
expect "Tool##palette.tool"
diff --git a/tests/ui/maya_keys.sfui b/tests/ui/maya_keys.sfui
index 53fd02d2..bd280921 100644
--- a/tests/ui/maya_keys.sfui
+++ b/tests/ui/maya_keys.sfui
@@ -86,5 +86,5 @@ expect_value masked < $m0
expect_value hidden == $h0
click "Preferences##palette.preferences"
-click "ZBrush-style##input.style_zbrush"
+click "Classic sculpting keys##input.style_zbrush"
expect_value input_style == 0
diff --git a/tests/ui/quick_tools.sfui b/tests/ui/quick_tools.sfui
index dc1c90eb..f97ce56d 100644
--- a/tests/ui/quick_tools.sfui
+++ b/tests/ui/quick_tools.sfui
@@ -63,7 +63,7 @@ expect_value masked == 0
# Insert on the model with X symmetry (on by default): a mirrored copy, one undo step.
remember triangles base
-click "SubTools/Append"
+click "Parts/Append"
hover "Insert on the model"
click "Cone##insert"
stroke 0.8 0.45 0.86 0.45
@@ -75,7 +75,7 @@ expect_value triangles == $base
key escape
# SubTool thumbnails: each row shows its SubTool, rendered from the GPU mesh.
-click "SubTools/Append"
+click "Parts/Append"
click "Cube"
expect_value subtools == 2
wait_value subtool_thumbnails == 2 10
diff --git a/tests/ui/radial_buttons.sfui b/tests/ui/radial_buttons.sfui
index a313abe7..a48f5605 100644
--- a/tests/ui/radial_buttons.sfui
+++ b/tests/ui/radial_buttons.sfui
@@ -57,5 +57,5 @@ expect_value brush_type == 4
# Back to the ZBrush style for later tests.
click "Preferences##palette.preferences"
-click "ZBrush-style##input.style_zbrush"
+click "Classic sculpting keys##input.style_zbrush"
key escape
diff --git a/tests/ui/radial_menu.sfui b/tests/ui/radial_menu.sfui
index 308d92c4..767d21fd 100644
--- a/tests/ui/radial_menu.sfui
+++ b/tests/ui/radial_menu.sfui
@@ -184,7 +184,7 @@ click "Blender##input.style_blender"
expect_value shortcut_conflicts == 0
click "Maya##input.style_maya"
expect_value shortcut_conflicts == 0
-click "ZBrush-style##input.style_zbrush"
+click "Classic sculpting keys##input.style_zbrush"
expect_value shortcut_conflicts == 0
key escape
diff --git a/tests/ui/shell_layout.sfui b/tests/ui/shell_layout.sfui
index 886546bc..33bc8d5c 100644
--- a/tests/ui/shell_layout.sfui
+++ b/tests/ui/shell_layout.sfui
@@ -3,7 +3,7 @@
# at 1920x1080 (ui_shell_layout_1080).
run ui_look look=classic layout=zbrush # written for the Classic look and the ZBrush-style palette bar and shelves
run new_sphere subdivisions=4
-expect "SubTools/Append" # right tray: the Tool palette with its SubTool sub-palette open
+expect "Parts/Append" # right tray: the Tool palette with its SubTool sub-palette open
expect_value right_tray == 1
expect_value left_tray == -1
expect "Clay##brush.clay" # bottom shelf: quick brushes
@@ -29,20 +29,20 @@ click "Groups##view.polygroups"
key tab
expect_value shelves == 0
expect_not "Clay##brush.clay"
-expect_not "SubTools/Append"
+expect_not "Parts/Append"
expect "Tool##palette.tool"
shot no-shelves
key tab
expect "Clay##brush.clay"
-expect "SubTools/Append"
+expect "Parts/Append"
# The divider opens and closes the right tray.
click "##rightdivider"
-expect_not "SubTools/Append"
+expect_not "Parts/Append"
expect_value right_tray == -1
shot tray-closed
click "##rightdivider"
-expect "SubTools/Append"
+expect "Parts/Append"
# A palette opens as a drop-down from the bar; its icon puts it in the tray, and back.
click "Stroke##palette.stroke"
@@ -57,7 +57,7 @@ expect_not "Draw/Add"
click "Stroke##palette.stroke"
click "Stroke/##totray"
expect "Stroke/Drag Stamp"
-expect "SubTools/Append"
+expect "Parts/Append"
expect_value right_tray == 2
shot palette-in-tray
click "Stroke/##totray"
@@ -76,11 +76,11 @@ shot left-tray
# Tool sub-palettes: one open at a time.
click "Tool/Geometry"
expect "Subdivide"
-expect_not "SubTools/Append"
+expect_not "Parts/Append"
click "Subdivide"
expect_value triangles == 20480
click "Tool/Parts"
-expect "SubTools/Append"
+expect "Parts/Append"
# Bottom shelf: remove a brush with its menu, add it back with [+].
right_click "Clay##brush.clay"
@@ -105,7 +105,7 @@ click "Medium"
click "2##ui.preset.2"
expect_value left_tray == -1
expect_value right_tray == -1
-expect_not "SubTools/Append"
+expect_not "Parts/Append"
expect_not "Alpha/Load image..."
shot preset-sculpt
click "3##ui.preset.3"
@@ -115,7 +115,7 @@ expect "Stroke/Drag Stamp"
expect "Material/Studio"
shot preset-wide
click "1##ui.preset.1"
-expect "SubTools/Append"
+expect "Parts/Append"
expect_not "Stroke/Drag Stamp"
# Window controls: minimise and close sit at the far right of the title strip.
diff --git a/tests/ui/subtools.sfui b/tests/ui/subtools.sfui
index eb27bc25..9dd1b79b 100644
--- a/tests/ui/subtools.sfui
+++ b/tests/ui/subtools.sfui
@@ -1,18 +1,18 @@
# SubTools: the panel, Alt+click in the viewport, sculpting and undo per SubTool,
# visibility, rename, duplicate, delete, merge and split.
run new_sphere subdivisions=4 ; subtool_rename to=Body
-expect "SubTools/Append"
+expect "Parts/Append"
expect_value subtools == 1
-expect "SubTools/Body"
+expect "Parts/Body"
shot one-subtool
# Append from the panel's menu: each new SubTool becomes the active one.
-click "SubTools/Append"
+click "Parts/Append"
click "Sphere"
expect_status Appended Part Sphere
expect_value subtools == 2
expect_value active_subtool == 1
-click "SubTools/Append"
+click "Parts/Append"
click "Cube"
expect_value subtools == 3
expect_value active_subtool == 2
@@ -20,10 +20,10 @@ key f
shot appended
# Click rows to select.
-click "SubTools/Body"
+click "Parts/Body"
expect_value active_subtool == 0
expect_status Active Part: Body
-click "SubTools/Sphere"
+click "Parts/Sphere"
expect_value active_subtool == 1
# Alt+click in the viewport selects another SubTool without sculpting anything.
@@ -66,11 +66,11 @@ hold none
expect_value active_subtool == 0
expect_value edited_subtools == 1
shot sculpted
-click "SubTools/Cube"
+click "Parts/Cube"
expect_value can_undo == 0
key ctrl+z
expect_value edited_subtools == 1
-click "SubTools/Body"
+click "Parts/Body"
expect_value can_undo == 1
key ctrl+z
key ctrl+z
@@ -80,78 +80,78 @@ key ctrl+shift+z
expect_value edited_subtools == 1
# Eye toggles, Solo and Unhide all.
-click "SubTools/##eye Sphere"
+click "Parts/##eye Sphere"
expect_value visible_subtools == 2
expect_status Sphere hidden
shot hidden
-click "SubTools/Solo"
+click "Parts/Solo"
expect_value visible_subtools == 1
expect_status Solo: Body
shot solo
-click "SubTools/Solo"
+click "Parts/Solo"
expect_value visible_subtools == 3
-click "SubTools/##eye Cube"
+click "Parts/##eye Cube"
expect_value visible_subtools == 2
-click "SubTools/Unhide all"
+click "Parts/Unhide all"
expect_value visible_subtools == 3
# Rename: double-click the row and type.
-double_click "SubTools/Cube"
-type "SubTools/##rename" Helmet
+double_click "Parts/Cube"
+type "Parts/##rename" Helmet
key enter
expect_status Renamed to Helmet
-expect "SubTools/Helmet"
-expect_not "SubTools/Cube"
+expect "Parts/Helmet"
+expect_not "Parts/Cube"
# Duplicate, then delete through the confirmation (Cancel first).
-click "SubTools/Helmet"
-click "SubTools/Duplicate"
+click "Parts/Helmet"
+click "Parts/Duplicate"
expect_value subtools == 4
expect_value active_subtool == 3
-expect "SubTools/Helmet copy"
-click "SubTools/Delete..."
+expect "Parts/Helmet copy"
+click "Parts/Delete..."
expect_text This can't be undone
shot confirm-delete
click "Delete Part?/Cancel"
expect_value subtools == 4
-click "SubTools/Delete..."
+click "Parts/Delete..."
click "Delete Part?/Delete"
expect_value subtools == 3
expect_status Deleted Part Helmet copy
-expect_not "SubTools/Helmet copy"
+expect_not "Parts/Helmet copy"
# Move the active SubTool up and down the list.
-click "SubTools/Sphere"
-click "SubTools/##up"
+click "Parts/Sphere"
+click "Parts/##up"
expect_value active_subtool == 0
-click "SubTools/##down"
+click "Parts/##down"
expect_value active_subtool == 1
# Merge down keeps polygroups apart, so Split groups separates the pieces again.
-click "SubTools/Body"
-click "SubTools/Merge down..."
+click "Parts/Body"
+click "Parts/Merge down..."
click "Merge Down?/Merge"
expect_value subtools == 2
expect_status Merged Sphere into Body
expect_value can_undo == 0
-click "SubTools/Split groups"
+click "Parts/Split groups"
expect_value subtools == 3
expect_status Split into 2 Parts
shot split-groups
-click "SubTools/Merge visible..."
+click "Parts/Merge visible..."
click "Merge Visible?/Merge"
expect_value subtools == 1
-expect "SubTools/Merged"
-click "SubTools/Split parts"
+expect "Parts/Merged"
+click "Parts/Split parts"
expect_value subtools == 3
expect_status Split into 3 Parts
shot split-parts
# The Tool palette's SubTool sub-palette closes and opens.
click "Parts##tool.subtool"
-expect_not "SubTools/Append"
+expect_not "Parts/Append"
click "Parts##tool.subtool"
-expect "SubTools/Append"
+expect "Parts/Append"
# Wireframe, polygroup colours and the LOD preview are for the active SubTool only.
key shift+f
@@ -172,5 +172,5 @@ run subtool_append ; subtool_append ; subtool_append ; subtool_append
expect_value subtools == 7
expect_value active_subtool == 6
shot many
-click "SubTools/Merged 1"
+click "Parts/Merged 1"
expect_value active_subtool == 0
diff --git a/tests/ui/subtools_files.sfui b/tests/ui/subtools_files.sfui
index 6820e1fc..e2467889 100644
--- a/tests/ui/subtools_files.sfui
+++ b/tests/ui/subtools_files.sfui
@@ -1,19 +1,19 @@
# SubTools survive files: build a scene in the UI, save a project, reopen it, and round-trip GLB / OBJ.
# Files are written to the working directory (the build folder under ctest).
run new_sphere subdivisions=4
-click "SubTools/Append"
+click "Parts/Append"
click "Cube"
-click "SubTools/Append"
+click "Parts/Append"
click "Sphere"
expect_value subtools == 3
-double_click "SubTools/Sphere 2"
+double_click "Parts/Sphere 2"
type "##rename" Eye
key enter
expect_text Eye
-click "SubTools/Cube"
+click "Parts/Cube"
stroke 0.4 0.4 0.6 0.6
expect_value edited_subtools == 1
-click "SubTools/##eye Eye"
+click "Parts/##eye Eye"
expect_value visible_subtools == 2
shot before-save
diff --git a/tests/ui/zbrush_feel.sfui b/tests/ui/zbrush_feel.sfui
index c69f7ef7..a8481b1b 100644
--- a/tests/ui/zbrush_feel.sfui
+++ b/tests/ui/zbrush_feel.sfui
@@ -234,18 +234,7 @@ hold none
expect_value camera_distance > $d1
key f
click "Preferences##palette.preferences"
-click "ZBrush-style##input.style_zbrush"
+click "Classic sculpting keys##input.style_zbrush"
expect_value input_style == 0
key 1
expect_value brush_type == 2
-
-# The F3 search finds features by the names ZBrush users type, and says what SculptForge calls them.
-key f3
-type "##Command palette" zspheres
-expect_text "ZBrush users: ZSpheres"
-shot search-zbrush-name
-key escape
-key f3
-type "##Command palette" subtool append
-expect_text "ZBrush users: SubTool"
-key escape
diff --git a/tests/ui/zspheres.sfui b/tests/ui/zspheres.sfui
index 928f7d7d..cf0a94de 100644
--- a/tests/ui/zspheres.sfui
+++ b/tests/ui/zspheres.sfui
@@ -6,17 +6,17 @@ run zsphere_new radius=1
run subtool_visibility index=0 visible=false
wait 0.3
click "Forge Spheres##tool.zspheres"
-expect "ZSpheres/Draw"
+expect "Forge Spheres/Draw"
expect_value zspheres == 1
expect_text "1 sphere"
# Ctrl-hover help.
hold ctrl
-hover "ZSpheres/Draw"
+hover "Forge Spheres/Draw"
expect_help "grow a new sphere"
-hover "ZSpheres/Preview"
+hover "Forge Spheres/Preview"
expect_help "skin"
-hover "ZSpheres/Make Mesh"
+hover "Forge Spheres/Make Mesh"
expect_help "Adaptive Skin"
hold none
@@ -29,14 +29,14 @@ expect_status "Forge Sphere add"
shot zspheres-draw
# Move: pull the arm out to the right; the twin goes left.
-click "ZSpheres/Move"
+click "Forge Spheres/Move"
remember zsphere_x1 x
view_drag 0.530 0.518 0.600 0.518
expect_value zsphere_x1 > $x
expect_value zsphere_x2 < -1.0
# Scale: drag up on the arm to grow it; undo puts it back.
-click "ZSpheres/Scale"
+click "Forge Spheres/Scale"
remember zsphere_r1 r
view_drag 0.600 0.518 0.600 0.45
expect_value zsphere_r1 > $r
@@ -47,7 +47,7 @@ expect_value zsphere_r1 > $r
key ctrl+z
# Draw on the link between the root and the arm: a joint halfway, mirrored.
-click "ZSpheres/Draw"
+click "Forge Spheres/Draw"
remember zsphere_x1 armx
view_drag 0.543 0.518 0.543 0.518 0.05
expect_value zspheres == 5
@@ -66,7 +66,7 @@ key a
expect_value zsphere_preview == 0
# Make Mesh: a new SubTool below, active and sculptable; the ZSpheres hidden and kept.
-click "ZSpheres/Make Mesh"
+click "Forge Spheres/Make Mesh"
expect_value subtools == 3
expect_value active_subtool == 2
expect_value zspheres == 0
diff --git a/tools/brush-gallery/render_previews.py b/tools/brush-gallery/render_previews.py
index 9a6a2921..64533ff9 100644
--- a/tools/brush-gallery/render_previews.py
+++ b/tools/brush-gallery/render_previews.py
@@ -5,7 +5,7 @@
Each preview is the same shot, so a gallery reads as one set: a sculpting
sphere with three S-curve strokes of the brush, rendered headless by
-`sculptforge --render` with the Clay MatCap from the front.
+`sculptforge --render` with the Clay Lit Sphere from the front.
python3 render_previews.py repo/brushes --out repo/previews
python3 render_previews.py my_brush.sfbrush --out . # one brush
@@ -122,7 +122,7 @@ def main():
p.add_argument("--app", help="path to the sculptforge executable")
p.add_argument("--size", default="512x384", help="image size WxH (default 512x384)")
p.add_argument("--subject", choices=["sphere", "plane"], default="sphere", help="what to sculpt on")
- p.add_argument("--material", default="Clay", help="MatCap (Clay, Red Wax, Skin, White, Bronze, Chrome)")
+ p.add_argument("--material", default="Clay", help="Lit Sphere (Clay, Red Wax, Skin, White, Bronze, Chrome)")
p.add_argument("--radius", type=float, default=0.12, help="brush radius in world units (sphere radius 1)")
p.add_argument("--no-shrink", action="store_true", help="keep the full-colour PNGs even if Pillow is installed")
p.add_argument("--changed", action="store_true", help="skip brushes whose preview is newer than the brush")
diff --git a/tools/brush-gallery/repo/README.md b/tools/brush-gallery/repo/README.md
index a524e859..5d807d05 100644
--- a/tools/brush-gallery/repo/README.md
+++ b/tools/brush-gallery/repo/README.md
@@ -1,7 +1,7 @@
# SculptForge community brushes
Free sculpting brushes for [SculptForge](https://github.com/islandmed/SculptForge), the free, open-source
-alternative to ZBrush, shared by the people who made them. Every brush here is public domain
+a free, open-source sculpting app, shared by the people who made them. Every brush here is public domain
([CC0](LICENSE)): use it in personal and commercial work, change it, bundle it with your own tools.
**Install brushes from inside SculptForge:** *View > Community brushes*, pick one, click **Install**. You can
diff --git a/tools/check_marks.py b/tools/check_marks.py
new file mode 100644
index 00000000..e4e33825
--- /dev/null
+++ b/tools/check_marks.py
@@ -0,0 +1,186 @@
+#!/usr/bin/env python3
+"""Fails when a third-party sculpting-app trademark appears anywhere it may not (docs/legal/trademarks.md).
+
+Every git-tracked text file and every tracked path is scanned, case-insensitively, for the marks in MARKS.
+- tools/marks_allow.txt: the permanent exceptions (path globs), each with its reason.
+- tools/marks_pending.txt: files not fully renamed yet, as "<glob> <mode>". It only shrinks: a pending file
+ with no marks left is reported so it is taken off.
+ strings code: only string literals that read as text (capital letters or spaces) are checked; a line
+ marked "// marks-pending" (a value name scripts use) waits for the rename with an alias
+ prose docs: text outside `code spans` and <code> is checked (command names follow the code rename)
+ skip another branch owns the file and rewrites it
+
+ check_marks.py check the repository (ctest: marks)
+ check_marks.py --count print matches per mark and per top-level folder, for before/after counts
+ check_marks.py --self-test
+"""
+import fnmatch
+import re
+import subprocess
+import sys
+from collections import Counter
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parent.parent
+
+# The marks, as case-insensitive patterns. Order matters only for --count labels.
+MARKS = [
+ r"z ?brush", r"pixologic", r"maxon", r"\bgoz(?!o)", r"gozbrush", r"dyna ?mesh", r"z ?remesher", r"sculptris",
+ r"subtools?|\bsub tools?\b", r"poly ?paint", r"z ?modeler", r"lightbox|\blight box\b", r"z ?spheres?", r"matcaps?|\bmat caps?\b", r"fiber ?mesh",
+ r"lightcap|\blight cap\b", r"\bpixols?\b", r"z ?script", r"z ?plug(?:in)?s?\b", r"\bspotlight\b", r"shadow ?box",
+ r"nano ?mesh", r"array ?mesh", r"live ?boolean", r"\bz ?(?:add|sub)\b", r"insert ?multi ?mesh", r"\bimm\b",
+ r"poly ?groups?(?!s)", r"projection ?master", r"hd ?geometry", r"decimation ?master", r"uv ?master",
+ r"clip ?curve", r"trim ?curve", r"poly ?group ?it", r"panel ?loops", r"dam_? ?standard", r"clay ?buildup",
+ r"\bh ?polish\b", r"trim ?dynamic", r"move ?topological", r"\bztools?\b", r"\.ztl\b",
+ # Other sculpting apps, named only for comparison in old copy: none of that in ours either.
+ r"mudbox", r"\bnomad\b", r"sculptgl", r"3d-?coat",
+]
+MARK_RE = re.compile("|".join(f"(?:{m})" for m in MARKS), re.IGNORECASE)
+STRING_RE = re.compile(r'"((?:[^"\\\n]|\\.)*)"')
+TEXTY_RE = re.compile(r"^[A-Z]| ") # reads as text: starts with a capital or has a space
+SKIP_PREFIXES = ("third_party/",)
+
+
+CODE_SPAN_RE = re.compile(r"`[^`\n]*`|<code>.*?</code>")
+
+
+def load_globs(name):
+ """{glob: mode} from a list file; the mode is the second word (empty for the allowlist)."""
+ globs = {}
+ for line in (ROOT / "tools" / name).read_text(encoding="utf-8").splitlines():
+ words = line.split("#", 1)[0].split()
+ if words:
+ globs[words[0]] = words[1] if len(words) > 1 else ""
+ return globs
+
+
+def glob_match(path, g):
+ return fnmatch.fnmatchcase(path, g) or g.endswith("/**") and path.startswith(g[:-2])
+
+
+def matches(path, globs):
+ """The mode of the first glob that matches, or None."""
+ return next((mode for g, mode in globs.items() if glob_match(path, g)), None)
+
+
+def tracked_files():
+ out = subprocess.run(["git", "ls-files", "-z"], cwd=ROOT, capture_output=True, check=True).stdout
+ return [p for p in out.decode("utf-8").split("\0") if p and not p.startswith(SKIP_PREFIXES)]
+
+
+def read_text(path):
+ try:
+ data = (ROOT / path).read_bytes()
+ except OSError:
+ return None # deleted in the working tree
+ if b"\0" in data[:8192]:
+ return None # binary
+ return data.decode("utf-8", errors="replace")
+
+
+def problems_in(path, text, pending):
+ """(line, snippet) for every mark this file may not have; pending is None or a marks_pending.txt mode."""
+ found = []
+ fenced = False
+ for n, line in enumerate(text.splitlines(), 1):
+ if pending == "prose" and line.lstrip().startswith("```"):
+ fenced = not fenced
+ opens_pre = pending == "prose" and "<pre" in line and "</pre>" not in line
+ in_pre = fenced or opens_pre
+ if pending == "prose" and "</pre>" in line and "<pre" not in line:
+ fenced, in_pre = False, True
+ elif opens_pre:
+ fenced = True
+ if not MARK_RE.search(line):
+ continue
+ if pending == "prose":
+ if not in_pre and MARK_RE.search(CODE_SPAN_RE.sub("", line)):
+ found.append((n, line.strip()))
+ elif pending == "strings":
+ if "marks-pending" in line:
+ continue # a script-facing value name, renamed with an alias in phase 2
+ for s in STRING_RE.finditer(line):
+ body = s.group(1).split("##", 1)[0] # an ImGui id after ## is never shown
+ if MARK_RE.search(body) and TEXTY_RE.search(body) and not re.fullmatch(r"[\w./<>-]+\.(h|hpp|cpp)", body):
+ found.append((n, body))
+ else:
+ found.append((n, line.strip()))
+ return found
+
+
+def scan():
+ allow, pending = load_globs("marks_allow.txt"), load_globs("marks_pending.txt")
+ errors, stale = [], []
+ for path in tracked_files():
+ if matches(path, allow) is not None:
+ continue
+ is_pending = matches(path, pending)
+ if is_pending == "skip":
+ continue
+ if MARK_RE.search(path) and is_pending is None:
+ errors.append(f"{path}: the file name has a mark")
+ text = read_text(path)
+ if text is None:
+ continue
+ for n, snippet in problems_in(path, text, is_pending):
+ errors.append(f"{path}:{n}: {snippet[:160]}")
+ if path in pending and not MARK_RE.search(text) and not MARK_RE.search(path):
+ stale.append(path)
+ for path in stale:
+ errors.append(f"{path}: no marks left, take it off tools/marks_pending.txt")
+ return errors
+
+
+def count():
+ per_mark, per_dir = Counter(), Counter()
+ for path in tracked_files():
+ text = read_text(path)
+ if text is None:
+ continue
+ for m in MARK_RE.finditer(text):
+ per_mark[m.group(0).lower().replace(" ", "")] += 1
+ per_dir[path.split("/", 1)[0] if "/" in path else "(root)"] += 1
+ print(f"total {sum(per_mark.values())}")
+ for k, v in per_dir.most_common():
+ print(f" {v:6} {k}/")
+ for k, v in per_mark.most_common():
+ print(f" {v:6} {k}")
+
+
+def self_test():
+ assert MARK_RE.search("Send to ZBrush") and MARK_RE.search("subtoolCount") and MARK_RE.search("use a MatCap")
+ assert MARK_RE.search("Polygroups") and MARK_RE.search("DamStandard") and MARK_RE.search("Dragon.ZTL")
+ assert not MARK_RE.search("Lit Sphere, Part, Face group, Library, Vertex Paint, Bridge, Forge Spheres")
+ assert not MARK_RE.search("immediate dimmed trimmed Gozo, format capability")
+ assert problems_in("a.cpp", 'int subtoolCount = run("subtool_append");', "strings") == []
+ assert problems_in("a.cpp", 'label("Send to ZBrush");', "strings") == [(1, "Send to ZBrush")]
+ assert problems_in("a.cpp", 'j.get("lightboxOpen"); button("Remove##matcap");', "strings") == []
+ assert problems_in("a.md", "Coming from ZBrush", None) == [(1, "Coming from ZBrush")]
+ assert problems_in("a.md", "Run `subtool_append`.", "prose") == []
+ assert problems_in("a.md", "Run `x` on a SubTool.", "prose") != []
+ assert problems_in("a.html", "<pre><code>zsphere_new\nzsphere_add</code></pre>\nok", "prose") == []
+ assert matches("integrations/bridge-plugin/x.txt", {"integrations/bridge-plugin/**": ""}) == ""
+ assert matches("src/a.cpp", {"src/b.cpp": "strings"}) is None
+ print("check_marks self-test ok")
+
+
+def main(argv):
+ if "--self-test" in argv:
+ self_test()
+ return 0
+ if "--count" in argv:
+ count()
+ return 0
+ errors = scan()
+ for e in errors:
+ print(e)
+ if errors:
+ print(f"\n{len(errors)} trademark problem(s). Rename by function (docs/legal/trademarks.md); "
+ "don't widen tools/marks_allow.txt.", file=sys.stderr)
+ return 1
+ print("check_marks: no marks outside the allowlist")
+ return 0
+
+
+if __name__ == "__main__":
+ sys.exit(main(sys.argv[1:]))
diff --git a/tools/face/build_ict_template.py b/tools/face/build_ict_template.py
index 25b056ff..94331809 100644
--- a/tools/face/build_ict_template.py
+++ b/tools/face/build_ict_template.py
@@ -13,8 +13,8 @@ for each of the 52 Apple ARKit blend shapes the offsets of those vertices, spars
names are ARKit's with _L / _R for Left / Right (the character's own left, +X); its separate browInnerUp_L/_R and
cheekPuff_L/_R are summed into ARKit's single browInnerUp and cheekPuff, cheekRaiser_L/_R and PupilDilate_L/_R are
not ARKit shapes and are left out, and ICT has no tongueOut: the file's tongueOut opens the jaw a little (the
-tongue itself is a SubTool's job, see core/Face.cpp). The teeth aren't kept, only how the lower teeth move in each
-shape (a rigid transform fitted to ICT's lower teeth), which drives teeth SubTools. Units: centimetres, Y up, the
+tongue itself is a Part's job, see core/Face.cpp). The teeth aren't kept, only how the lower teeth move in each
+shape (a rigid transform fitted to ICT's lower teeth), which drives teeth Parts. Units: centimetres, Y up, the
face looking down +Z.
File layout (little endian):
diff --git a/tools/guide/README.md b/tools/guide/README.md
index 52680a7c..032a1069 100644
--- a/tools/guide/README.md
+++ b/tools/guide/README.md
@@ -35,7 +35,7 @@ adjust them. Re-run cmake after adding or removing guide files so the app embeds
The guide names the default **SculptForge layout**'s menus: **Edit > Preferences > Input**, **Sculpt > Stroke**,
**Render > Materials**. **Tool > ...** paths stay, since the Tool palette is in the right tray in both layouts.
-`python3 tools/guide/menu_paths.py` rewrites ZBrush-style palette paths (**Preferences > Input**) in every
+`python3 tools/guide/menu_paths.py` rewrites classic palette paths (**Preferences > Input**) in every
chapter; ctest `guide_menu_paths` fails while any are left.
## Feature panels
diff --git a/tools/guide/build_site.py b/tools/guide/build_site.py
index 3b00c154..3fdea2dd 100644
--- a/tools/guide/build_site.py
+++ b/tools/guide/build_site.py
@@ -25,9 +25,8 @@ ROOT = pathlib.Path(__file__).resolve().parents[2]
SRC = ROOT / "docs" / "guide"
SITE = "https://sculptforge.app/"
# Chapters that were renamed: the old page stays as a small redirect so links from elsewhere keep working.
-REDIRECTS = {"subtools.html": "parts.html", "zspheres.html": "forge-spheres.html", "polypaint.html": "vertex-paint.html",
- "polygroups.html": "face-groups.html"}
-CALLOUTS = {"tip": "Tip", "note": "Note", "zbrush": "ZBrush", "not-yet": "Not yet", "warning": "Warning",
+REDIRECTS: dict[str, str] = {}
+CALLOUTS = {"tip": "Tip", "note": "Note", "experienced": "Experienced sculptor?", "not-yet": "Not yet", "warning": "Warning",
"important": "Important"}
# ---------------------------------------------------------------------------
@@ -769,7 +768,7 @@ def page_html(page: Page, index: Page, chapters, position: int) -> str:
<meta property="og:type" content="article">
<meta property="og:title" content="{html.escape(title)}">
<meta property="og:description" content="{desc}">
- <meta property="og:image" content="{SITE}img/social-preview.png?v=3">
+ <meta property="og:image" content="{SITE}img/social-preview.png?v=4">
<meta property="og:url" content="{url}">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -829,8 +828,7 @@ def page_html(page: Page, index: Page, chapters, position: int) -> str:
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
@@ -1060,8 +1058,7 @@ def main() -> int:
SUPPORTERS_PAGE.write_text(supporters_html(), encoding="utf-8")
if wn:
write_home(wn, False)
- urls = [SITE, SITE + "brushes.html", SITE + "mudbox-alternative.html",
- SITE + "zbrush-alternative.html", SITE + "zbrush-linux.html", SITE + "press.html",
+ urls = [SITE, SITE + "brushes.html", SITE + "press.html",
SITE + "studios.html", SITE + "support.html", SITE + "supporters.html"] + [f"{SITE}guide/{p.name[:-3]}.html" for p in pages]
(ROOT / "website" / "sitemap.xml").write_text(
'<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n'
diff --git a/tools/guide/kelvinlet_shots.sfui b/tools/guide/kelvinlet_shots.sfui
index 8577f973..c585a57a 100644
--- a/tools/guide/kelvinlet_shots.sfui
+++ b/tools/guide/kelvinlet_shots.sfui
@@ -14,7 +14,7 @@ shot kelvinlet-brushes
run new_sphere subdivisions=8
run vdm_set name=horn
run vdm_stamp point=0,0,2 view=0,0,-1 radius=0.18 angle=30
-run stroke brush=DamStandard points="-0.12,-0.1,2 0.12,-0.14,2" radius=0.03
+run stroke brush=SharpCrease points="-0.12,-0.1,2 0.12,-0.14,2" radius=0.03
wait_idle 30
key ctrl+alt+c
view_drag 0.355 0.42 0.47 0.6
diff --git a/tools/guide/make_images.py b/tools/guide/make_images.py
index 1d1cb8bd..c4379039 100644
--- a/tools/guide/make_images.py
+++ b/tools/guide/make_images.py
@@ -27,12 +27,12 @@ CROPS = {
"palette-dropdown": ("palette-dropdown", (140, 0, 770, 295), 630),
"palette-tray": ("palette-tray", (1280, 560, 1600, 960), 320),
"draw-palette": ("draw-palette", (140, 0, 770, 600), 630),
- "lightbox": ("lightbox", (90, 85, 1020, 230), 930),
+ "library": ("library", (90, 85, 1020, 230), 930),
"brush-picker": ("brush-picker", (250, 82, 725, 414), 475),
"stroke-picker": ("stroke-picker", (0, 190, 420, 450), 420),
"alpha-picker": ("alpha-picker", (0, 295, 575, 668), 575),
"material-picker": ("material-picker", (25, 320, 505, 545), 480),
- "custom-matcaps": ("custom-matcaps", (436, 0, 980, 700), 544),
+ "custom-lit-spheres": ("custom-lit-spheres", (436, 0, 980, 700), 544),
"ctrl-help": ("ctrl-help", (1060, 500, 1600, 740), 540),
"command-palette": ("command-palette", (355, 100, 960, 500), 605),
"console": ("console", (0, 698, 1275, 866), MAX_WIDTH),
@@ -46,11 +46,11 @@ CROPS = {
"generate-3d": ("generate-3d", (882, 102, 1198, 830), 316),
"export": ("export", (1280, 40, 1600, 780), 320),
"masking": ("masking", (300, 46, 1600, 800), 960),
- "polypaint": ("polypaint", (230, 20, 1100, 800), 870),
+ "vertex-paint": ("vertex-paint", (230, 20, 1100, 800), 870),
"layers": ("layers", (1280, 40, 1600, 560), 320),
"paint-layers": ("paint-layers", (300, 46, 1600, 800), 960),
- "subtools": ("subtools", (380, 46, 1600, 900), 960),
- "polygroups": ("polygroups", (300, 100, 1600, 860), 960),
+ "parts": ("parts", (380, 46, 1600, 900), 960),
+ "face-groups": ("face-groups", (300, 100, 1600, 860), 960),
"splats": ("splats", (300, 90, 1280, 865), 980),
"user-guide": ("user-guide", (138, 108, 1180, 842), 1042),
"extract": ("extract", (380, 140, 1000, 740), 620),
diff --git a/tools/guide/menu_paths.py b/tools/guide/menu_paths.py
index 5e225ddb..737212a1 100644
--- a/tools/guide/menu_paths.py
+++ b/tools/guide/menu_paths.py
@@ -1,7 +1,7 @@
#!/usr/bin/env python3
# SculptForge - open source digital sculpting
# SPDX-License-Identifier: GPL-3.0-or-later
-"""Rewrite ZBrush-style palette paths in the guide to the SculptForge layout's task menus.
+"""Rewrite Classic-layout palette paths in the guide to the SculptForge layout's task menus.
"Preferences > Input" becomes "Edit > Preferences > Input", "Material > Load Lit Sphere..." becomes
"Render > Materials > Load Lit Sphere...", and so on (src/app/Palettes.cpp, taskMenus). Tool paths stay: the Tool
@@ -65,8 +65,8 @@ def convert(text: str) -> str:
if generated:
out.append(line)
continue
- # "> **ZBrush-style layout:** ..." notes name the palettes of that layout on purpose.
- zbrush_note = line.startswith("> **ZBrush-style layout") or (zbrush_note and line.startswith(">"))
+ # "> **Classic layout:** ..." notes name the palettes of that layout on purpose.
+ zbrush_note = line.startswith("> **Classic layout") or (zbrush_note and line.startswith(">"))
if zbrush_note:
out.append(line)
continue
@@ -104,7 +104,7 @@ def main() -> int:
else:
md.write_text(new, encoding="latin-1")
if args.check and stale:
- print(f"{stale} line(s) use ZBrush-style palette paths; run tools/guide/menu_paths.py", file=sys.stderr)
+ print(f"{stale} line(s) use Classic-layout palette paths; run tools/guide/menu_paths.py", file=sys.stderr)
return 1
return 0
diff --git a/tools/guide/shots.sfui b/tools/guide/shots.sfui
index bba6b40a..479c6941 100644
--- a/tools/guide/shots.sfui
+++ b/tools/guide/shots.sfui
@@ -25,7 +25,7 @@ key comma
click "Library/Tool"
wait_idle 20
wait 1
-shot lightbox
+shot library
key comma
key b
wait_idle 20
@@ -140,7 +140,7 @@ run paint_fill color=bone
run paint_from_cavity color=4a2c18 strength=0.9
click "Paint##menu.paint"
wait 0.2
-shot polypaint
+shot vertex-paint
key escape
run undo
run undo
@@ -178,7 +178,7 @@ run subtool_append type=cube name=Crate size=0.3
key f
click "Tool/Parts"
wait 0.3
-shot subtools
+shot parts
# Face Groups on a cube.
run new_cube
@@ -188,7 +188,7 @@ click "Tool/Face Groups"
key f
drag_item "Rotate##nav.rotate" -160 60
wait 0.3
-shot polygroups
+shot face-groups
click "Groups##view.polygroups"
# Remesh: an uneven mesh, then voxel remeshed.
@@ -266,7 +266,7 @@ shot sdiv-6
run new_sphere subdivisions=3
click "Dynamic##draw.dynamic"
run dyntopo detail=60
-click "Tendril##brush.snakehook"
+click "Tendril##brush.tendril"
drag_path 0.76 0.32 0.85 0.25 0.95 0.17 1.05 0.08 1.12 0.0 S=1.5
drag_path 0.5 0.2 0.5 0.05 0.5 -0.1 S=1.0
click "Standard##brush.standard"
@@ -293,7 +293,7 @@ run stroke points="0.35,0.25,2 0.3,0.25,2" brush=Clay radius=0.2 strength=1 inve
run stroke points="0.35,0.25,2 0.3,0.25,2" brush=Clay radius=0.2 strength=1 invert=true
run stroke points="0,0.15,2 0,-0.15,2" brush=Standard radius=0.12 strength=1
run stroke points="0,0.15,2 0,-0.15,2" brush=Standard radius=0.12 strength=1
-run stroke points="-0.3,-0.42,2 0,-0.46,2 0.3,-0.42,2" brush=DamStandard radius=0.08 strength=1
+run stroke points="-0.3,-0.42,2 0,-0.46,2 0.3,-0.42,2" brush=SharpCrease radius=0.08 strength=1
run stroke points="-0.25,-0.36,2 0,-0.38,2 0.25,-0.36,2" brush=Standard radius=0.08 strength=0.6
run stroke points="-0.25,-0.5,2 0,-0.53,2 0.25,-0.5,2" brush=Standard radius=0.08 strength=0.6
run qremesh target=1500 symmetry=x keep_original=true
@@ -369,7 +369,7 @@ click "Render##menu.render"
click "Materials##section.material"
wait_idle 20
wait 0.2
-shot custom-matcaps
+shot custom-lit-spheres
key escape
run set_material name="Soft Clay"
diff --git a/tools/marks_allow.txt b/tools/marks_allow.txt
new file mode 100644
index 00000000..0de233a7
--- /dev/null
+++ b/tools/marks_allow.txt
@@ -0,0 +1,8 @@
+# Permanent exceptions to tools/check_marks.py. Keep this list as short as it is; see docs/legal/trademarks.md.
+docs/legal/trademarks.md # the trademark notice itself: the one place the marks are named
+integrations/bridge-plugin/** # the exchange plug-in runs inside the other application and must call its commands
+src/io/BridgeProtocol.h # folder and file names the exchange protocol needs on disk, and old-file read aliases
+src/core/LegacyNames.h # old on-disk names, read only, so old projects, brushes and configs load
+addons/blender/sculptforge_bridge/bridge_protocol.py # the Bridge file header bytes, for the Blender add-on
+tools/check_marks.py # the check has to spell the patterns it looks for
+tools/marks_pending.txt # names the files still waiting for the rename
diff --git a/tools/marks_pending.txt b/tools/marks_pending.txt
new file mode 100644
index 00000000..6af74950
--- /dev/null
+++ b/tools/marks_pending.txt
@@ -0,0 +1,15 @@
+# Files not fully renamed yet (tools/check_marks.py). This list only shrinks; empty it, don't add to it.
+# Phase 2 of fix/ip-audit renames code identifiers, comments, command names and on-disk keys (with read aliases).
+src/app/ZBrushNames.h skip # feat/quick-tour replaces it with SearchAliases.h (generic words)
+website/guide/search-index.js skip # built from docs/guide, which is checked; command names follow phase 2
+src/** strings
+tests/** skip # test code and data: phase 2 (identifiers, comments, fixtures)
+addons/** strings
+tools/guide/** strings
+tools/looks/** strings
+tools/export_check/** strings
+CMakeLists.txt strings
+docs/project-format.md skip # documents on-disk keys; renamed with read aliases in phase 2
+docs/** prose
+website/guide/** prose
+CHANGELOG.md prose
diff --git a/tools/publish/setup-channels.sh b/tools/publish/setup-channels.sh
index 076de698..137f0e7c 100755
--- a/tools/publish/setup-channels.sh
+++ b/tools/publish/setup-channels.sh
@@ -81,7 +81,7 @@ cask "sculptforge" do
url "https://github.com/$REPO/releases/download/v#{version}/SculptForge-#{version}-darwin-universal.dmg",
verified: "github.com/$REPO/"
name "SculptForge"
- desc "Free, open-source digital sculpting, an alternative to ZBrush"
+ desc "Free, open-source digital sculpting, a free, open-source sculpting app"
homepage "https://sculptforge.app/"
livecheck do
@@ -149,14 +149,14 @@ PackageUrl: https://sculptforge.app/
License: GPL-3.0-or-later
LicenseUrl: https://github.com/$REPO/blob/main/LICENSE
Copyright: Copyright (C) 2026 The SculptForge contributors
-ShortDescription: Free, open-source digital sculpting, an alternative to ZBrush and Mudbox.
-Description: SculptForge is a free, open-source digital sculpting app for artists and studios, with SubTools, layers, dynamic topology, remeshing, polypaint, baking and AI-assisted image-to-3D.
+ShortDescription: Free, open-source digital sculpting.
+Description: SculptForge is a free, open-source digital sculpting app for artists and studios, with Parts, layers, dynamic topology, remeshing, vertex paint, baking and AI-assisted image-to-3D.
Moniker: sculptforge
Tags:
- 3d
- sculpting
- modeling
-- zbrush-alternative
+- digital-sculpting
- open-source
ReleaseNotesUrl: https://github.com/$REPO/releases/tag/$tag
ManifestType: defaultLocale
diff --git a/tools/release/scrub_old_releases.sh b/tools/release/scrub_old_releases.sh
new file mode 100755
index 00000000..d6180101
--- /dev/null
+++ b/tools/release/scrub_old_releases.sh
@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+# Lists what still carries an old version once a release is live, so the coordinator can remove it:
+# - every GitHub release (page + assets) older than KEEP (tags and git history stay),
+# - every website page, download link or feed entry that still names a version older than KEEP.
+# Dry run by default: prints what it would do. --apply deletes the old GitHub releases (not their tags);
+# website hits are only listed, fix them in the repo and let pages.yml publish.
+# tools/release/scrub_old_releases.sh 0.10.11 # list
+# tools/release/scrub_old_releases.sh 0.10.11 --apply # delete old release pages and assets
+set -euo pipefail
+KEEP=${1:?usage: scrub_old_releases.sh <version to keep, e.g. 0.10.11> [--apply]}
+APPLY=${2:-}
+REPO=${REPO:-islandmed/SculptForge}
+ROOT=$(cd "$(dirname "$0")/../.." && pwd)
+
+older() { # older A B: is version A older than B (sort -V; pre-releases like 0.11.0-beta.1 count as older than 0.11.0)
+ [ "$1" != "$2" ] && [ "$(printf '%s\n%s\n' "$1" "$2" | sort -V | head -1)" = "$1" ]
+}
+
+command -v gh >/dev/null || { echo "gh is needed (GitHub CLI)" >&2; exit 1; }
+gh release view "v$KEEP" -R "$REPO" >/dev/null 2>&1 || { echo "v$KEEP isn't released yet: nothing removed before it is live" >&2; exit 1; }
+
+echo "== GitHub releases older than v$KEEP ($REPO)"
+old=()
+while IFS=$'\t' read -r tag; do
+ v=${tag#v}
+ older "$v" "$KEEP" && old+=("$tag")
+done < <(gh release list -R "$REPO" --limit 1000 --json tagName --jq '.[].tagName')
+for tag in "${old[@]}"; do
+ assets=$(gh release view "$tag" -R "$REPO" --json assets --jq '.assets | length')
+ echo " $tag ($assets assets)"
+done
+echo " ${#old[@]} release(s)"
+
+echo "== Website pages, downloads and feeds that name an older version"
+hits=0
+while IFS= read -r line; do
+ file=${line%%:*}; rest=${line#*:}
+ for v in $(grep -oE '\b[0-9]+\.[0-9]+\.[0-9]+(-[a-z]+\.[0-9]+)?\b' <<<"$rest" | sort -u); do
+ if older "$v" "$KEEP"; then echo " $file: $v"; hits=$((hits + 1)); fi
+ done
+done < <(cd "$ROOT" && git grep -n -I -E '\b0\.[0-9]+\.[0-9]+' -- website ':!website/guide/whats-new.html' \
+ ':!website/guide/search-index.js' ':!website/guide/images' ':!website/benchmarks' | \
+ grep -E 'releases/(download|tag)/v|"version"|softwareVersion|Version [0-9]|New in [0-9]|<enclosure|sparkle:version' || true)
+echo " $hits hit(s) (What's New history and benchmark records keep their versions on purpose)"
+
+if [ "$APPLY" = "--apply" ]; then
+ for tag in "${old[@]}"; do
+ echo "deleting release $tag (the tag stays)"
+ gh release delete "$tag" -R "$REPO" --yes
+ done
+else
+ echo "Dry run. Add --apply to delete the ${#old[@]} old release page(s) and their assets; tags and history stay."
+fi
diff --git a/tools/wintest.sh b/tools/wintest.sh
index 8b7e6cd6..8d50b6d4 100755
--- a/tools/wintest.sh
+++ b/tools/wintest.sh
@@ -5,7 +5,7 @@
# SPDX-License-Identifier: GPL-3.0-or-later
#
# tools/wintest.sh build build-win<arch>, run every test
-# tools/wintest.sh -R ui_subtools extra arguments go to ctest
+# tools/wintest.sh -R ui_mask_lasso extra arguments go to ctest
# tools/wintest.sh --x64 build for x64 (on an ARM machine: build only, for tools/winvm/winvm.sh)
#
# The Windows architecture follows the host: ARM64 on an ARM machine (Wine runs ARM64 Windows programs
diff --git a/website/benchmarks/index.html b/website/benchmarks/index.html
index 3e528d7f..ddf63272 100644
--- a/website/benchmarks/index.html
+++ b/website/benchmarks/index.html
@@ -149,8 +149,8 @@ python3 tools/benchmark/submit.py add result.json \
applications' numbers or output. If you use another app, sculpt a similar mesh there and judge for yourself.</p>
<footer>
- <p class="muted small">SculptForge is an independent open-source project, not affiliated with or endorsed by Maxon.
- ZBrush, GoZ, MatCap, FiberMesh, LightCap and other ZBrush feature names are trademarks of Maxon Computer GmbH.
+ <p class="muted small">SculptForge is an independent open-source project.
+ Product names are trademarks of their respective owners.
All other trademarks belong to their owners.</p>
</footer>
</main>
diff --git a/website/brushes.html b/website/brushes.html
index 0ba721c2..a390c075 100644
--- a/website/brushes.html
+++ b/website/brushes.html
@@ -162,8 +162,7 @@
<a href="supporters.html">Supporters</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/CODE_OF_CONDUCT.md">Code of conduct</a>
</div>
- <p class="fine trademarks">SculptForge is an independent project, not affiliated with or endorsed by Maxon.
- ZBrush, GoZ, MatCap, FiberMesh, LightCap and other ZBrush feature names are trademarks of Maxon Computer GmbH. The site uses the Inter typeface (SIL Open Font License), self-hosted, and
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners. The site uses the Inter typeface (SIL Open Font License), self-hosted, and
no cookies. Visits and download clicks are counted anonymously with
<a href="https://www.goatcounter.com/">GoatCounter</a> (no cookies, no personal data).</p>
</div>
diff --git a/website/guide/baking.html b/website/guide/baking.html
index c0aed17a..989501cb 100644
--- a/website/guide/baking.html
+++ b/website/guide/baking.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Baking normal and displacement maps - SculptForge User Guide">
<meta property="og:description" content="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, c">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/baking.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html" class="current" aria-current="page">Baking normal and displacement maps</a><ul class="toc-sections"><li><a href="#what-you-need">What you need</a></li><li><a href="#bake-in-five-steps">Bake in five steps</a></li><li><a href="#the-maps">The maps</a></li><li><a href="#settings">Settings</a></li><li><a href="#how-the-bake-works">How the bake works</a></li><li><a href="#send-to-unreal-with-the-normal-map">Send to Unreal with the normal map</a></li><li><a href="#commands">Commands</a></li></ul></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html" class="current" aria-current="page">Baking normal and displacement maps</a><ul class="toc-sections"><li><a href="#what-you-need">What you need</a></li><li><a href="#bake-in-five-steps">Bake in five steps</a></li><li><a href="#the-maps">The maps</a></li><li><a href="#settings">Settings</a></li><li><a href="#how-the-bake-works">How the bake works</a></li><li><a href="#send-to-unreal-with-the-normal-map">Send to Unreal with the normal map</a></li><li><a href="#commands">Commands</a></li></ul></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -104,7 +104,7 @@ When it is done, the status line reports what was baked and where the files went
<h3 id="displacement-mid-grey-is-zero">Displacement: mid-grey is zero<a class="anchor" href="#displacement-mid-grey-is-zero" aria-label="Link to this section">#</a></h3>
<p>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 <strong>+scale</strong> and black <strong>-scale</strong> in world units; the scale is the largest distance found, shown under the Bake button (&quot;Displacement: mid-grey = 0, white = +0.0143&quot;) and in the status line. Use it as the displacement strength in your renderer (with a midlevel of 0.5). With <strong>EXR displacement</strong> ticked, a 32-bit float OpenEXR holds the real distances in world units, with no scale to set.</p>
<h2 id="settings">Settings<a class="anchor" href="#settings" aria-label="Link to this section">#</a></h2>
-<div class="table-wrap"><table><thead><tr><th>Setting</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Source</strong></td><td>The high-poly: one Part, or every visible Part except the active one. Hidden faces of the source are ignored</td></tr><tr><td><strong>Size</strong></td><td>1K, 2K (default), 4K or 8K square</td></tr><tr><td><strong>AA</strong></td><td>Anti-aliasing: 1 to 4 means 1, 4, 9 or 16 rays per texel, averaged. 2 (the default) gives clean edges</td></tr><tr><td><strong>Auto distance</strong></td><td>Measure how far the high-poly lies in front of and behind the low-poly, and cast rays just that far. After a bake, <strong>Front</strong> and <strong>Rear</strong> show what it measured</td></tr><tr><td><strong>Front</strong> / <strong>Rear</strong></td><td>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&#x27;s size (its bounding-box diagonal). ZBrush and Substance call these the max frontal and rear distances</td></tr><tr><td><strong>Padding</strong></td><td>Texels around each UV island filled with the island&#x27;s edge colours, so seams don&#x27;t show once an engine mipmaps the map. 8 suits 2K; use 16 for 4K and 8K</td></tr><tr><td><strong>OpenGL / DirectX</strong></td><td>The normal map&#x27;s green channel convention (see above)</td></tr><tr><td><strong>AO rays</strong>, <strong>AO reach</strong></td><td>Ambient occlusion quality, and how far away geometry still darkens a point (a percentage of the model&#x27;s size)</td></tr><tr><td><strong>Output folder</strong></td><td>Where the files go. Empty: beside your last export, else the project&#x27;s folder, else <strong>Bakes</strong> in your library folder. <strong>Open Folder</strong> shows it after a bake</td></tr><tr><td><strong>EXR displacement</strong></td><td>Also write the displacement as a 32-bit float EXR</td></tr></tbody></table></div>
+<div class="table-wrap"><table><thead><tr><th>Setting</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Source</strong></td><td>The high-poly: one Part, or every visible Part except the active one. Hidden faces of the source are ignored</td></tr><tr><td><strong>Size</strong></td><td>1K, 2K (default), 4K or 8K square</td></tr><tr><td><strong>AA</strong></td><td>Anti-aliasing: 1 to 4 means 1, 4, 9 or 16 rays per texel, averaged. 2 (the default) gives clean edges</td></tr><tr><td><strong>Auto distance</strong></td><td>Measure how far the high-poly lies in front of and behind the low-poly, and cast rays just that far. After a bake, <strong>Front</strong> and <strong>Rear</strong> show what it measured</td></tr><tr><td><strong>Front</strong> / <strong>Rear</strong></td><td>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&#x27;s size (its bounding-box diagonal). Other bakers call these the max frontal and rear distances</td></tr><tr><td><strong>Padding</strong></td><td>Texels around each UV island filled with the island&#x27;s edge colours, so seams don&#x27;t show once an engine mipmaps the map. 8 suits 2K; use 16 for 4K and 8K</td></tr><tr><td><strong>OpenGL / DirectX</strong></td><td>The normal map&#x27;s green channel convention (see above)</td></tr><tr><td><strong>AO rays</strong>, <strong>AO reach</strong></td><td>Ambient occlusion quality, and how far away geometry still darkens a point (a percentage of the model&#x27;s size)</td></tr><tr><td><strong>Output folder</strong></td><td>Where the files go. Empty: beside your last export, else the project&#x27;s folder, else <strong>Bakes</strong> in your library folder. <strong>Open Folder</strong> shows it after a bake</td></tr><tr><td><strong>EXR displacement</strong></td><td>Also write the displacement as a 32-bit float EXR</td></tr></tbody></table></div>
<h2 id="how-the-bake-works">How the bake works<a class="anchor" href="#how-the-bake-works" aria-label="Link to this section">#</a></h2>
<p>For every texel of the low-poly&#x27;s UVs, SculptForge finds the matching point on the low-poly and casts a ray along its smoothed normal, from <strong>Front</strong> outside the surface to <strong>Rear</strong> inside it (a &quot;cage&quot;), 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&#x27;t leave gaps.</p>
<ul>
@@ -120,14 +120,14 @@ The bake works on copies, so you can keep sculpting meanwhile. If the low-poly&#
</ul>
<aside class="callout callout-tip"><p><strong>Tip:</strong> 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></aside>
<h2 id="send-to-unreal-with-the-normal-map">Send to Unreal with the normal map<a class="anchor" href="#send-to-unreal-with-the-normal-map" aria-label="Link to this section">#</a></h2>
-<p>When the last bake made a normal map, its low-poly Part is shown and still fits the map, <strong>Send to Unreal</strong> (<strong>Tool &gt; Export</strong>) imports the map too, as <code>T_&lt;Name&gt;_N</code> next to the mesh, set up as a normal map (linear, normal map compression), with Unreal&#x27;s <strong>Flip Green Channel</strong> 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 <a href="exporting.html#send-to-unreal">Exporting, Unreal and ZBrush</a>.</p>
+<p>When the last bake made a normal map, its low-poly Part is shown and still fits the map, <strong>Send to Unreal</strong> (<strong>Tool &gt; Export</strong>) imports the map too, as <code>T_&lt;Name&gt;_N</code> next to the mesh, set up as a normal map (linear, normal map compression), with Unreal&#x27;s <strong>Flip Green Channel</strong> 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 <a href="exporting.html#send-to-unreal">Exporting, Unreal and Bridge</a>.</p>
<h2 id="commands">Commands<a class="anchor" href="#commands" aria-label="Link to this section">#</a></h2>
<div class="table-wrap"><table><thead><tr><th>Command</th><th>What it does</th></tr></thead><tbody><tr><td><code>bake</code></td><td>Bake onto the active Part and write the maps. Options: <code>source=all</code>, a Part name, <code>subdivision</code> or <code>micro</code>, <code>maps=normal,object_normal,displacement,ao,cavity,color,curvature,thickness,position,id</code> (or <code>all</code>), <code>udim=true</code>, <code>thickness_rays=24</code>, <code>thickness_distance=0.1</code>, <code>curvature_radius=0.02</code>, <code>id=polygroups</code> or <code>parts</code>, <code>size=2048</code> (512 to 8192, or <code>1k</code>...<code>8k</code>), <code>out=folder</code>, <code>name=prefix</code>, <code>front=0.02</code> and <code>rear=0.02</code> (fractions of the model&#x27;s size, or <code>auto</code>), <code>samples=2</code>, <code>padding=8</code>, <code>ao_rays=48</code>, <code>ao_distance=0.05</code>, <code>green=opengl</code> or <code>directx</code>, <code>displacement_scale=</code> (world units at white), <code>exr=true</code></td></tr></tbody></table></div>
<p>For example, from the console or <code>sculptforge-cli</code>:</p>
-<div class="code-block"><pre class="code"><code>subtool_select name=Body_low; bake source=Body maps=normal,ao,displacement size=4096 out=maps</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
+<div class="code-block"><pre class="code"><code>part_select name=Body_low; bake source=Body maps=normal,ao,displacement size=4096 out=maps</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
<p>The command runs in the foreground (scripts wait for it); the <strong>Bake</strong> button runs the same bake in the background. See <a href="scripting.html">Scripting and automation</a>.</p>
</article>
- <nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="phone-capture.html"><span>Previous</span>Phone capture and AR</a><a class="next" rel="next" href="exporting.html"><span>Next</span>Exporting, Unreal and ZBrush</a></nav>
+ <nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="phone-capture.html"><span>Previous</span>Phone capture and AR</a><a class="next" rel="next" href="exporting.html"><span>Next</span>Exporting, Unreal and Bridge</a></nav>
<p class="guide-meta fine">Also in the app: <strong>Help &gt; User Guide</strong> (<kbd>Shift</kbd>+<kbd>F1</kbd>).
Found a mistake? <a href="https://github.com/islandmed/SculptForge/edit/main/docs/guide/baking.md">Edit this page on GitHub</a>.</p>
</main>
@@ -148,8 +148,7 @@ The bake works on copies, so you can keep sculpting meanwhile. If the low-poly&#
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/blender.html b/website/guide/blender.html
index 7c52589c..633bfe8c 100644
--- a/website/guide/blender.html
+++ b/website/guide/blender.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Working with Blender - SculptForge User Guide">
<meta property="og:description" content="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">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/blender.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,13 +46,13 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html" class="current" aria-current="page">Working with Blender</a><ul class="toc-sections"><li><a href="#install-the-add-on">Install the add-on</a></li><li><a href="#a-round-trip">A round trip</a></li><li><a href="#what-comes-across">What comes across</a></li><li><a href="#modifiers">Modifiers</a></li><li><a href="#settings">Settings</a></li><li><a href="#zbrush-style-keys-in-sculpt-mode">ZBrush-style keys in Sculpt Mode</a></li><li><a href="#vector-displacement-maps">Vector displacement maps</a></li><li><a href="#how-it-works">How it works</a></li><li><a href="#limits-and-troubleshooting">Limits and troubleshooting</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html" class="current" aria-current="page">Working with Blender</a><ul class="toc-sections"><li><a href="#install-the-add-on">Install the add-on</a></li><li><a href="#a-round-trip">A round trip</a></li><li><a href="#what-comes-across">What comes across</a></li><li><a href="#modifiers">Modifiers</a></li><li><a href="#settings">Settings</a></li><li><a href="#classic-sculpting-keys-in-sculpt-mode">Classic sculpting keys in Sculpt Mode</a></li><li><a href="#vector-displacement-maps">Vector displacement maps</a></li><li><a href="#how-it-works">How it works</a></li><li><a href="#limits-and-troubleshooting">Limits and troubleshooting</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
<article class="guide-article">
<h1 id="working-with-blender">Working with Blender</h1>
-<p>Keep Blender for the scene, rigging, shading and animation, and sculpt in SculptForge: the <strong>SculptForge Bridge</strong> add-on sends the selected objects from Blender to SculptForge with one click, and one click in SculptForge sends them back. The objects update in place in Blender: their transform, materials and modifiers stay as they were. It works like ZBrush&#x27;s GoZ between ZBrush and other apps, on Linux, Windows and macOS, with Blender 4.2 or newer.</p>
+<p>Keep Blender for the scene, rigging, shading and animation, and sculpt in SculptForge: the <strong>SculptForge Bridge</strong> 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>
<h2 id="install-the-add-on">Install the add-on<a class="anchor" href="#install-the-add-on" aria-label="Link to this section">#</a></h2>
<ol>
<li>
@@ -113,11 +113,11 @@ Blender picks it up by itself within a second (or click <strong>Receive from Scu
</li>
</ul>
<p>The add-on&#x27;s preferences add the path of SculptForge and the exchange folder (below).</p>
-<h2 id="zbrush-style-keys-in-sculpt-mode">ZBrush-style keys in Sculpt Mode<a class="anchor" href="#zbrush-style-keys-in-sculpt-mode" aria-label="Link to this section">#</a></h2>
-<p>Sculpting in Blender too? Turn on <strong>ZBrush-style keys in Sculpt Mode</strong> in the add-on&#x27;s preferences (<strong>Edit &gt; Preferences &gt; Add-ons &gt; SculptForge Bridge</strong>) and Blender&#x27;s Sculpt Mode answers to ZBrush&#x27;s keys where Blender has the same thing. Turning it off removes them again, and Blender&#x27;s own keys are back; so does disabling the add-on. The preferences list every key while it&#x27;s on.</p>
-<div class="table-wrap"><table><thead><tr><th>ZBrush key</th><th>In Blender&#x27;s Sculpt Mode</th></tr></thead><tbody><tr><td><kbd>S</kbd> / <kbd>U</kbd> / <kbd>O</kbd></td><td>Draw Size / Intensity (Strength) / Falloff (Hardness), dragged at the cursor</td></tr><tr><td><kbd>Space</kbd></td><td>Blender&#x27;s Sculpt quick menu at the cursor (brush, size, strength)</td></tr><tr><td><kbd>B</kbd></td><td>The brush list by ZBrush brush name (Standard, DamStandard, Clay, ClayBuildup, Move, SnakeHook...): type a few letters, <kbd>Enter</kbd> picks</td></tr><tr><td><kbd>Alt</kbd>+drag</td><td>Sub: the brush digs in</td></tr><tr><td><kbd>Ctrl</kbd>+drag / <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+drag</td><td>Mask / unmask, drawn as a lasso</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+drag / <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Alt</kbd>+drag</td><td>Show only what&#x27;s inside / hide what&#x27;s inside</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>W</kbd></td><td>Group the masked part as a face set and clear the mask (with nothing masked: the visible part)</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>D</kbd> / <kbd>D</kbd> / <kbd>Shift</kbd>+<kbd>D</kbd></td><td>Divide (a Multires level) / SDiv up / SDiv down (never adds a level)</td></tr><tr><td><kbd>X</kbd></td><td>Symmetry X</td></tr><tr><td><kbd>Shift</kbd>+<kbd>F</kbd></td><td>Wireframe (the wireframe overlay)</td></tr><tr><td><kbd>F</kbd> / <kbd>P</kbd></td><td>Frame the model / perspective on and off</td></tr><tr><td><kbd>L</kbd></td><td>Steady Stroke (Blender: Stabilize Stroke)</td></tr><tr><td><kbd>W</kbd> / <kbd>E</kbd> / <kbd>R</kbd></td><td>Move / Scale / Rotate</td></tr><tr><td><kbd>Shift</kbd>+drag</td><td>Smooth (Blender already does this)</td></tr></tbody></table></div>
-<p>ZBrush&#x27;s brushes map to Blender&#x27;s closest: Standard = Draw, DamStandard = Draw Sharp, ClayBuildup = Clay Strips, Move = Grab, Move Elastic = Elastic Grab, TrimDynamic = Trim (Scrape in Blender 4.2), Crease = Crease Sharp, MaskPen = Mask.</p>
-<p>What Blender has no key for, or can&#x27;t do the ZBrush way:</p>
+<h2 id="classic-sculpting-keys-in-sculpt-mode">Classic sculpting keys in Sculpt Mode<a class="anchor" href="#classic-sculpting-keys-in-sculpt-mode" aria-label="Link to this section">#</a></h2>
+<p>Sculpting in Blender too? Turn on <strong>The Classic sculpting keys in Sculpt Mode</strong> in the add-on&#x27;s preferences (<strong>Edit &gt; Preferences &gt; Add-ons &gt; SculptForge Bridge</strong>) and Blender&#x27;s Sculpt Mode answers to the Classic sculpting keys where Blender has the same thing. Turning it off removes them again, and Blender&#x27;s own keys are back; so does disabling the add-on. The preferences list every key while it&#x27;s on.</p>
+<div class="table-wrap"><table><thead><tr><th>Classic key</th><th>In Blender&#x27;s Sculpt Mode</th></tr></thead><tbody><tr><td><kbd>S</kbd> / <kbd>U</kbd> / <kbd>O</kbd></td><td>Draw Size / Intensity (Strength) / Falloff (Hardness), dragged at the cursor</td></tr><tr><td><kbd>Space</kbd></td><td>Blender&#x27;s Sculpt quick menu at the cursor (brush, size, strength)</td></tr><tr><td><kbd>B</kbd></td><td>The brush list by name (Standard, Sharp Crease, Clay, Clay Block, Move, Tendril...): type a few letters, <kbd>Enter</kbd> picks</td></tr><tr><td><kbd>Alt</kbd>+drag</td><td>Sub: the brush digs in</td></tr><tr><td><kbd>Ctrl</kbd>+drag / <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+drag</td><td>Mask / unmask, drawn as a lasso</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+drag / <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Alt</kbd>+drag</td><td>Show only what&#x27;s inside / hide what&#x27;s inside</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>W</kbd></td><td>Group the masked part as a face set and clear the mask (with nothing masked: the visible part)</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>D</kbd> / <kbd>D</kbd> / <kbd>Shift</kbd>+<kbd>D</kbd></td><td>Divide (a Multires level) / SDiv up / SDiv down (never adds a level)</td></tr><tr><td><kbd>X</kbd></td><td>Symmetry X</td></tr><tr><td><kbd>Shift</kbd>+<kbd>F</kbd></td><td>Wireframe (the wireframe overlay)</td></tr><tr><td><kbd>F</kbd> / <kbd>P</kbd></td><td>Frame the model / perspective on and off</td></tr><tr><td><kbd>L</kbd></td><td>Steady Stroke (Blender: Stabilize Stroke)</td></tr><tr><td><kbd>W</kbd> / <kbd>E</kbd> / <kbd>R</kbd></td><td>Move / Scale / Rotate</td></tr><tr><td><kbd>Shift</kbd>+drag</td><td>Smooth (Blender already does this)</td></tr></tbody></table></div>
+<p>brushes map to Blender&#x27;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.</p>
+<p>What Blender has no key for, or can&#x27;t do:</p>
<ul>
<li>
<kbd>I</kbd> (RGB Intensity): Blender&#x27;s sculpt brushes don&#x27;t paint.
@@ -153,7 +153,7 @@ Stroke types (Drag Stamp, Spray...): each Blender brush sets its stroke method i
</li>
</ul>
<h2 id="how-it-works">How it works<a class="anchor" href="#how-it-works" aria-label="Link to this section">#</a></h2>
-<p>The two programs share a folder in your user data: <code>~/.local/share/SculptForge/SculptForge/blender</code> on Linux, <code>%APPDATA%\SculptForge\SculptForge\blender</code> on Windows, <code>~/Library/Application Support/SculptForge/SculptForge/blender</code> on macOS. Each side writes its meshes there as <code>.GoZ</code> files (the format SculptForge also uses with ZBrush) with a small list of the objects, and checks the other side&#x27;s list once a second. Nothing goes over the network.</p>
+<p>The two programs share a folder in your user data: <code>~/.local/share/SculptForge/SculptForge/blender</code> on Linux, <code>%APPDATA%\SculptForge\SculptForge\blender</code> on Windows, <code>~/Library/Application Support/SculptForge/SculptForge/blender</code> on macOS. Each side writes its meshes there as <code>.GoZ</code> files with a small list of the objects, and checks the other side&#x27;s list once a second. Nothing goes over the network.</p>
<p>To use another folder, set it in the add-on&#x27;s preferences and start SculptForge with the environment variable <code>SCULPTFORGE_BLENDER_EXCHANGE</code> set to the same folder.</p>
<p>From scripts and the MCP server: <code>blender_send</code> and <code>blender_receive</code> (both take <code>folder=</code>). Starting SculptForge with <code>--blender</code> loads what Blender last sent.</p>
<h2 id="limits-and-troubleshooting">Limits and troubleshooting<a class="anchor" href="#limits-and-troubleshooting" aria-label="Link to this section">#</a></h2>
@@ -168,7 +168,7 @@ Stroke types (Drag Stamp, Spray...): each Blender brush sets its stroke method i
<strong>Shape keys</strong>: the Basis and the keys named like SculptForge&#x27;s layers are updated; other keys keep their shapes.
</li>
<li>
-<strong>Subdivision levels</strong> don&#x27;t go to Blender: it receives the level you&#x27;re on (like ZBrush&#x27;s GoZ).
+<strong>Subdivision levels</strong> don&#x27;t go to Blender: it receives the level you&#x27;re on (like Bridge files).
</li>
<li>
<strong>Sculpt layers</strong> arrive as <strong>shape keys</strong> (Basis plus one key per layer, with its name and weight), so the 52 <a href="facial-shapes.html">facial shapes</a> keep their ARKit names. Shape keys don&#x27;t come back from Blender, and textures stay in SculptForge.
@@ -183,7 +183,7 @@ Objects in Edit Mode or Sculpt Mode are updated too: the add-on switches to Obje
<h2 id="see-also">See also<a class="anchor" href="#see-also" aria-label="Link to this section">#</a></h2>
<ul>
<li>
-<a href="exporting.html">Exporting, Unreal and ZBrush</a>: files, game engines and Send to ZBrush
+<a href="exporting.html">Exporting, Unreal and Bridge</a>: files, game engines and Bridge
</li>
<li>
<a href="parts.html">Parts</a>: each Blender object is a Part
@@ -197,7 +197,7 @@ Objects in Edit Mode or Sculpt Mode are updated too: the add-on switches to Obje
<p class="guide-meta fine">Also in the app: <strong>Help &gt; User Guide</strong> (<kbd>Shift</kbd>+<kbd>F1</kbd>).
Found a mistake? <a href="https://github.com/islandmed/SculptForge/edit/main/docs/guide/blender.md">Edit this page on GitHub</a>.</p>
</main>
- <aside class="on-page" aria-label="On this page"><p>On this page</p><ul><li><a href="#install-the-add-on">Install the add-on</a></li><li><a href="#a-round-trip">A round trip</a></li><li><a href="#what-comes-across">What comes across</a></li><li><a href="#modifiers">Modifiers</a></li><li><a href="#settings">Settings</a></li><li><a href="#zbrush-style-keys-in-sculpt-mode">ZBrush-style keys in Sculpt Mode</a></li><li><a href="#vector-displacement-maps">Vector displacement maps</a></li><li><a href="#how-it-works">How it works</a></li><li><a href="#limits-and-troubleshooting">Limits and troubleshooting</a></li><li><a href="#see-also">See also</a></li></ul></aside>
+ <aside class="on-page" aria-label="On this page"><p>On this page</p><ul><li><a href="#install-the-add-on">Install the add-on</a></li><li><a href="#a-round-trip">A round trip</a></li><li><a href="#what-comes-across">What comes across</a></li><li><a href="#modifiers">Modifiers</a></li><li><a href="#settings">Settings</a></li><li><a href="#classic-sculpting-keys-in-sculpt-mode">Classic sculpting keys in Sculpt Mode</a></li><li><a href="#vector-displacement-maps">Vector displacement maps</a></li><li><a href="#how-it-works">How it works</a></li><li><a href="#limits-and-troubleshooting">Limits and troubleshooting</a></li><li><a href="#see-also">See also</a></li></ul></aside>
</div>
<footer class="footer">
<div class="wrap footer-grid">
@@ -214,8 +214,7 @@ Objects in Edit Mode or Sculpt Mode are updated too: the add-on switches to Obje
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/brush-lab.html b/website/guide/brush-lab.html
index ece7276d..6023a213 100644
--- a/website/guide/brush-lab.html
+++ b/website/guide/brush-lab.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Brush Lab and sharing brushes - SculptForge User Guide">
<meta property="og:description" content="Brush Lab designs sculpting brushes from a description: type &quot;dry cracked mud&quot; 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 f">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/brush-lab.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html" class="current" aria-current="page">Brush Lab and sharing brushes</a><ul class="toc-sections"><li><a href="#what-a-custom-brush-is">What a custom brush is</a></li><li><a href="#open-brush-lab">Open Brush Lab</a></li><li><a href="#design-a-brush">Design a brush</a></li><li><a href="#choose-an-ai-provider">Choose an AI provider</a></li><li><a href="#your-brush-library">Your brush library</a></li><li><a href="#share-brushes">Share brushes</a></li><li><a href="#the-community-gallery">The community gallery</a></li><li><a href="#brushes-from-scripts">Brushes from scripts</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html" class="current" aria-current="page">Brush Lab and sharing brushes</a><ul class="toc-sections"><li><a href="#what-a-custom-brush-is">What a custom brush is</a></li><li><a href="#open-brush-lab">Open Brush Lab</a></li><li><a href="#design-a-brush">Design a brush</a></li><li><a href="#choose-an-ai-provider">Choose an AI provider</a></li><li><a href="#your-brush-library">Your brush library</a></li><li><a href="#share-brushes">Share brushes</a></li><li><a href="#the-community-gallery">The community gallery</a></li><li><a href="#brushes-from-scripts">Brushes from scripts</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -223,8 +223,7 @@ sculptforge-cli -c &#x27;brush_gallery_install name=&quot;Snake Scales&quot;; ne
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/coming-from-zbrush.html b/website/guide/coming-from-zbrush.html
deleted file mode 100644
index 1ff90038..00000000
--- a/website/guide/coming-from-zbrush.html
+++ /dev/null
@@ -1,163 +0,0 @@
-<!doctype html>
-<html lang="en">
-<head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width, initial-scale=1">
- <title>Coming from ZBrush - SculptForge User Guide</title>
- <meta name="description" content="This chapter is for sculptors whose hands already know ZBrush. It lists what SculptForge calls the things you know, what works the same, what is different, and the shortcuts side by side, so you can start sculpting instead of relearning. SculptForge has its own keymap and offers ZBrush-style, Blende">
- <meta name="theme-color" content="#111114">
- <meta name="color-scheme" content="dark">
- <link rel="icon" type="image/svg+xml" href="../img/favicon.svg?v=2">
- <link rel="icon" type="image/png" href="../img/favicon-64.png?v=2">
- <link rel="apple-touch-icon" href="../img/icon-256.png?v=2">
- <link rel="canonical" href="https://sculptforge.app/guide/coming-from-zbrush.html">
- <meta property="og:type" content="article">
- <meta property="og:title" content="Coming from ZBrush - SculptForge User Guide">
- <meta property="og:description" content="This chapter is for sculptors whose hands already know ZBrush. It lists what SculptForge calls the things you know, what works the same, what is different, and the shortcuts side by side, so you can start sculpting instead of relearning. SculptForge has its own keymap and offers ZBrush-style, Blende">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
- <meta property="og:url" content="https://sculptforge.app/guide/coming-from-zbrush.html">
- <link rel="stylesheet" href="../style.css?v=19">
- <script src="../motion.js?v=11" defer></script>
- <script data-goatcounter="https://sculptforge.goatcounter.com/count" async src="https://gc.zgo.at/count.js"></script>
- <script src="search-index.js?v=47" defer></script>
-</head>
-<body class="guide-page" data-prev="whats-new.html" data-next="installing.html">
- <div class="scroll-progress" aria-hidden="true"></div>
- <header class="nav">
- <div class="wrap nav-inner">
- <a class="brand" href="../index.html"><img src="../img/logo.svg?v=2" alt="" width="34" height="34"><span>SculptForge</span></a>
- <nav aria-label="Main">
- <a href="../index.html#features">Features</a>
- <a href="../index.html#demos">Demos</a>
- <a href="../brushes.html">Brushes</a>
- <a href="index.html" aria-current="page">Guide</a>
- <a class="nav-dl" href="../index.html#download">Download</a>
- <a class="gh" href="https://discord.gg/gWrYkEmQhH">Discord</a>
- <a class="gh" href="https://github.com/islandmed/SculptForge">GitHub</a>
- </nav>
- </div>
- </header>
- <div class="wrap guide-layout">
- <div class="guide-side">
- <button class="toc-toggle" type="button" aria-expanded="false" aria-controls="guide-toc">
- <span>Contents</span><span class="toc-current">Coming from ZBrush</span></button>
- <div id="guide-toc" class="toc-panel">
- <div class="guide-search" role="search">
- <input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
- <div class="search-results" id="guide-results" hidden></div>
- </div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html" class="current" aria-current="page">Coming from ZBrush</a><ul class="toc-sections"><li><a href="#zbrush-terms-in-sculptforge">ZBrush terms in SculptForge</a></li><li><a href="#zbrush-style-keys">ZBrush-style keys</a></li><li><a href="#whats-the-same">What&#x27;s the same</a></li><li><a href="#bring-your-ztools-over">Bring your ZTools over</a></li><li><a href="#whats-different">What&#x27;s different</a></li><li><a href="#shortcuts-side-by-side">Shortcuts side by side</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
- </div>
- </div>
- <main class="guide-main" id="top">
- <article class="guide-article">
-<h1 id="coming-from-zbrush">Coming from ZBrush</h1>
-<p>This chapter is for sculptors whose hands already know ZBrush. It lists what SculptForge calls the things you know, what works the same, what is different, and the shortcuts side by side, so you can start sculpting instead of relearning. SculptForge has its own keymap and offers ZBrush-style, Blender and Maya styles; turn on the <strong>ZBrush-style</strong> keys first (see <a href="#zbrush-style-keys">ZBrush-style keys</a>) and your hands will feel at home.</p>
-<p>New installs start in SculptForge&#x27;s own layout, with menus by task. For the alphabetical palette bar and the two-row top shelf you know, pick <strong>Coming from: ZBrush</strong> (keys and layout) or the <strong>ZBrush-style layout</strong> card in the welcome, or pick <strong>Edit &gt; Preferences &gt; Interface &gt; Look &gt; Layout &gt; ZBrush-style</strong> (see <a href="interface.html#looks-and-layouts">Looks and layouts</a>). Paths in this guide name the SculptForge layout&#x27;s menus. In the ZBrush-style layout, leave out the menu: <strong>Edit &gt; Preferences &gt; Input</strong> is the palette named <strong>Preferences</strong>, <strong>Sculpt &gt; Stroke</strong> the palette named <strong>Stroke</strong>; <strong>Tool &gt; Parts</strong> is the same in both. See <a href="interface.html#menus-and-palettes">Menus and palettes</a> for every palette&#x27;s menu, and <kbd>F3</kbd> finds any of them by name.</p>
-<h2 id="zbrush-terms-in-sculptforge">ZBrush terms in SculptForge<a class="anchor" href="#zbrush-terms-in-sculptforge" aria-label="Link to this section">#</a></h2>
-<p>Features use SculptForge&#x27;s own names. The ideas are the ones you know; here is what to look for:</p>
-<div class="table-wrap"><table><thead><tr><th>ZBrush</th><th>SculptForge</th><th>Where</th></tr></thead><tbody><tr><td>SubTools</td><td><strong>Parts</strong></td><td><strong>Tool &gt; Parts</strong>; <kbd>Alt</kbd>+click one in the viewport. See <a href="parts.html">Parts</a></td></tr><tr><td>ZSpheres</td><td><strong>Forge Spheres</strong></td><td><strong>Tool &gt; Forge Spheres</strong>. See <a href="forge-spheres.html">Forge Spheres</a></td></tr><tr><td>Polypaint</td><td><strong>Vertex Paint</strong></td><td>The Paint brush (<kbd>P</kbd>), <strong>Rgb</strong>, the <strong>Paint</strong> menu. See <a href="vertex-paint.html">Vertex Paint and materials</a></td></tr><tr><td>Polygroups</td><td><strong>Face Groups</strong></td><td><strong>Tool &gt; Face Groups</strong>. See <a href="face-groups.html">Face Groups and visibility</a></td></tr><tr><td>LightBox</td><td><strong>Library</strong></td><td><kbd>,</kbd> (comma). See <a href="interface.html#the-library">The interface</a></td></tr><tr><td>GoZ</td><td><strong>Send to ZBrush</strong> (GoZ-compatible)</td><td><strong>File &gt; Send to ZBrush</strong>. See <a href="exporting.html#exchange-models-with-zbrush-send-to-zbrush">Exporting</a></td></tr><tr><td>MatCap</td><td><strong>Lit Sphere</strong></td><td><strong>Render &gt; Materials</strong>, <kbd>M</kbd>. See <a href="vertex-paint.html#materials-lit-spheres">Materials</a></td></tr><tr><td>Zadd / Zsub</td><td><strong>Add</strong> / <strong>Sub</strong></td><td>Top shelf; <kbd>Alt</kbd> flips for one stroke</td></tr><tr><td>Z Intensity</td><td><strong>Intensity</strong></td><td>Top shelf, <kbd>U</kbd></td></tr><tr><td>Focal Shift</td><td><strong>Falloff</strong></td><td><strong>Sculpt &gt; Draw &amp; Tablet</strong>, <kbd>O</kbd></td></tr><tr><td>DynaMesh</td><td><strong>Voxel Remesh</strong></td><td><strong>Tool &gt; Remesh</strong>. See <a href="geometry.html#voxel-remesh">Geometry</a></td></tr><tr><td>ZRemesher, ZRemesher Guides</td><td><strong>Quad Remesh</strong>, <strong>Quad Remesh Guides</strong></td><td><strong>Tool &gt; Geometry &gt; Quad Remesh</strong>. See <a href="retopology.html">Quad retopology</a></td></tr><tr><td>ProjectAll, ZProject</td><td><strong>Project All</strong>, <strong>Project</strong></td><td><strong>Tool &gt; Parts &gt; Project</strong>. See <a href="retopology.html#project-all">Quad retopology</a></td></tr><tr><td>Sculptris Pro</td><td><strong>Dynamic Topology</strong></td><td><strong>Dynamic</strong> on the top shelf. See <a href="dynamic-topology.html">Dynamic topology</a></td></tr><tr><td>QuickSave</td><td><strong>Snapshot</strong></td><td><strong>File &gt; Save Snapshot</strong>, the Library&#x27;s <strong>Snapshots</strong> tab. See <a href="projects.html#snapshots">Projects</a></td></tr><tr><td>Transpose, Gizmo 3D, Transpose All</td><td><strong>Gizmo</strong>, <strong>All Parts</strong></td><td><kbd>W</kbd> <kbd>E</kbd> <kbd>R</kbd>. See <a href="gizmo.html">Gizmo</a></td></tr><tr><td>LazyMouse</td><td><strong>Steady Stroke</strong> (every stroke type)</td><td><strong>Sculpt &gt; Stroke</strong>, <kbd>L</kbd></td></tr><tr><td>PolyFrame (PolyF)</td><td><strong>Wireframe</strong> (<strong>Wire</strong> on the shelf)</td><td>Right shelf, <kbd>Shift</kbd>+<kbd>F</kbd></td></tr><tr><td>QuickMenu</td><td><strong>Quick Menu</strong></td><td><kbd>Space</kbd> or a right click</td></tr><tr><td>DamStandard</td><td><strong>Sharp Crease</strong> brush</td><td><kbd>B</kbd> <kbd>D</kbd> <kbd>S</kbd>. See <a href="sculpting.html">Sculpting</a></td></tr><tr><td>ClayBuildup</td><td><strong>Clay Block</strong> brush</td><td><kbd>B</kbd> <kbd>C</kbd> <kbd>B</kbd></td></tr><tr><td>SnakeHook</td><td><strong>Tendril</strong> brush</td><td><kbd>B</kbd> <kbd>S</kbd> <kbd>H</kbd></td></tr><tr><td>KelvinSnake</td><td><strong>Elastic Tendril</strong> brush</td><td>Brush picker (KelvinGrab, KelvinTwist and KelvinScale keep their names)</td></tr><tr><td>Trim Dynamic</td><td><strong>Trim</strong> brush</td><td>Brush picker</td></tr><tr><td>hPolish</td><td><strong>Hard Polish</strong></td><td>Not built in yet; a <a href="brush-lab.html">Brush Lab</a> recipe gets close</td></tr><tr><td>DragRect, DragDot</td><td><strong>Drag Stamp</strong>, <strong>Slide Stamp</strong> strokes</td><td><strong>Sculpt &gt; Stroke</strong></td></tr><tr><td>MaskPen, MaskLasso, MaskRect</td><td><strong>Mask Pen</strong>, <strong>Mask Lasso</strong>, <strong>Mask Rectangle</strong></td><td><strong>Tool &gt; Masking</strong>. See <a href="masking.html">Masking</a></td></tr><tr><td>SelectRect, SelectLasso</td><td><strong>Select Rectangle</strong>, <strong>Select Lasso</strong></td><td><strong>Tool &gt; Visibility</strong></td></tr><tr><td>FiberMesh, LightCap</td><td>Not yet</td><td></td></tr><tr><td>ZScript, ZPlugin</td><td>Script commands and the Python module</td><td>See <a href="scripting.html">Scripting</a></td></tr><tr><td>Decimation Master, UV Master, Projection Master</td><td><strong>Decimate</strong>, the <strong>UV Editor</strong> (and <strong>Auto UV</strong>), <strong>Mesh &gt; Generate 3D &gt; Stamp</strong></td><td>See <a href="geometry.html#decimate">Geometry</a>, <a href="uv-editor.html">UV Editor</a> and <a href="texture-painting.html">Texture painting</a></td></tr></tbody></table></div>
-<p>The command palette (<kbd>F3</kbd>) finds every feature by its ZBrush name too: type <code>SubTool</code>, <code>ZSphere</code>, <code>Polypaint</code> or <code>MatCap</code> and it shows the SculptForge command, as in &quot;Forge Spheres (ZBrush users: ZSpheres)&quot;. The <a href="glossary.html">Glossary</a> maps many more ZBrush terms.</p>
-<p>ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer GmbH. SculptForge is not affiliated with or endorsed by Maxon.</p>
-<h2 id="zbrush-style-keys">ZBrush-style keys<a class="anchor" href="#zbrush-style-keys" aria-label="Link to this section">#</a></h2>
-<p>New installs start with the <strong>SculptForge</strong> keys. The first time SculptForge starts it asks what you are <strong>Coming from</strong>: pick <strong>ZBrush</strong> and it turns on the ZBrush-style keys for you. To switch at any time, open <strong>Edit &gt; Preferences &gt; Input</strong> and choose <strong>ZBrush-style</strong> under <strong>Style</strong>, then press <strong>Store Config</strong> (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd>) to keep it. If you used an earlier version, your saved choice is kept.</p>
-<p>What the ZBrush-style keys change:</p>
-<div class="table-wrap"><table><thead><tr><th></th><th><strong>ZBrush-style</strong></th><th><strong>SculptForge</strong> (default)</th></tr></thead><tbody><tr><td><kbd>1</kbd> to <kbd>9</kbd>, <kbd>0</kbd></td><td>Free (<kbd>9</kbd> is <strong>Save Snapshot</strong>, ZBrush&#x27;s QuickSave)</td><td>Pick the ten first brushes (Standard, Clay, Smooth, Move ...)</td></tr><tr><td><kbd>I</kbd></td><td>RGB Intensity at the cursor</td><td>Intensity at the cursor (as <kbd>U</kbd>)</td></tr><tr><td><kbd>Ctrl</kbd>+drag on the background with nothing masked</td><td>Draws a mask rectangle</td><td>Zooms</td></tr><tr><td>Zoom drags (<kbd>Ctrl</kbd>+right-drag, <kbd>Alt</kbd> then release)</td><td>Up zooms out</td><td>Up zooms in</td></tr></tbody></table></div>
-<p>Everything else in this chapter works in both styles. <strong>Edit &gt; Preferences &gt; Input &gt; Rotation</strong> chooses free rotation (as in ZBrush) or a turntable that keeps the model upright, as in Blender or Maya. Press <strong>Store Config</strong> to keep either. See <a href="shortcuts.html#zbrush-style-keys">Keyboard and mouse</a> for the full list.</p>
-<h2 id="whats-the-same">What&#x27;s the same<a class="anchor" href="#whats-the-same" aria-label="Link to this section">#</a></h2>
-<ul>
-<li>
-<strong>The layout</strong> (in the ZBrush-style layout). Shelves around the canvas, palettes in alphabetical order in the palette bar and the trays, sub-palettes that fold, the Library on <kbd>,</kbd>, Ctrl-hover help on every control, Ctrl+Alt+click to assign a hotkey, <strong>Store Config</strong> on <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd>. See <a href="interface.html">The interface</a>.
-</li>
-<li>
-<strong>Navigation.</strong> Drag on the background to rotate freely (over the top, too), <kbd>Alt</kbd>+drag to move, <kbd>Alt</kbd>+click, let go of <kbd>Alt</kbd> and drag to scale, <kbd>Shift</kbd> during a rotation to snap to a side view, <kbd>Shift</kbd>+click, let go of <kbd>Shift</kbd> and drag to roll. Right-drag navigation works as with ZBrush&#x27;s RightClick Navigation turned on, over the model too. <kbd>F</kbd> frames the model. See <a href="navigation.html">Navigating the view</a>.
-</li>
-<li>
-<strong>Sculpting modifiers.</strong> <kbd>Alt</kbd> swaps Add and Sub (ZBrush&#x27;s Zadd and Zsub), <kbd>Shift</kbd> smooths (Smooth keeps its own Intensity; let go of <kbd>Shift</kbd> mid-stroke for the alternate smooth that keeps the volume), <kbd>Shift</kbd> pressed after a stroke starts draws a straight line.
-</li>
-<li>
-<strong>Brush keys.</strong> <kbd>B</kbd> then two letters, with ZBrush&#x27;s letters: <kbd>B</kbd> <kbd>S</kbd> <kbd>T</kbd> Standard, <kbd>B</kbd> <kbd>C</kbd> <kbd>B</kbd> Clay Block, <kbd>B</kbd> <kbd>D</kbd> <kbd>S</kbd> Sharp Crease, <kbd>B</kbd> <kbd>M</kbd> <kbd>V</kbd> Move, <kbd>B</kbd> <kbd>I</kbd> <kbd>N</kbd> Inflate, <kbd>B</kbd> <kbd>S</kbd> <kbd>M</kbd> Smooth, <kbd>B</kbd> <kbd>S</kbd> <kbd>H</kbd> Tendril, <kbd>B</kbd> <kbd>P</kbd> <kbd>I</kbd> Pinch.
-</li>
-<li>
-<strong>Brush settings.</strong> <kbd>S</kbd> Draw Size, <kbd>U</kbd> Intensity, <kbd>I</kbd> RGB Intensity (ZBrush-style keys), <kbd>O</kbd> Falloff, each as a slider under the cursor; <kbd>[</kbd> and <kbd>]</kbd> step the size; <kbd>Space</kbd> opens the Quick Menu; <kbd>L</kbd> toggles Steady Stroke. The cursor&#x27;s outer ring is the Draw Size, the inner ring the Falloff. See <a href="sculpting.html">Sculpting and brushes</a>.
-</li>
-<li>
-<strong>Masking.</strong> <kbd>Ctrl</kbd> paints a mask and <kbd>Ctrl</kbd>+<kbd>Alt</kbd> erases it; <kbd>Ctrl</kbd>+click the model blurs it and <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+click sharpens it; <kbd>Ctrl</kbd>+click the background inverts it and <kbd>Ctrl</kbd>+drag there draws a mask rectangle (ZBrush-style keys; one that misses the model clears the mask). Mask Lasso and Mask Rectangle follow the symmetry: with <kbd>Ctrl</kbd> held the shelf shows the mask brush, and the Brush (<kbd>B</kbd>) and Stroke pickers pick it. See <a href="masking.html">Masking</a>.
-</li>
-<li>
-<strong>Visibility and face groups.</strong> <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+drag keeps the inside (press <kbd>Alt</kbd> to hide it instead), <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+click a group to isolate it (on a partly hidden mesh: to hide it), <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+click the background to show everything, <kbd>Ctrl</kbd>+<kbd>W</kbd> to group the masked part. Select Rectangle and Select Lasso, also from the Brush and Stroke pickers with <kbd>Ctrl</kbd>+<kbd>Shift</kbd> held. <strong>Group by UVs</strong> is UV Groups. See <a href="face-groups.html">Face Groups and visibility</a>.
-</li>
-<li>
-<strong>Parts</strong> with <kbd>Alt</kbd>+click to select one and <kbd>Shift</kbd>+<kbd>Alt</kbd>+click to select and frame it; <strong>subdivision levels</strong> with <kbd>Ctrl</kbd>+<kbd>D</kbd>, <kbd>D</kbd> and <kbd>Shift</kbd>+<kbd>D</kbd>; <strong>Wireframe</strong> on <kbd>Shift</kbd>+<kbd>F</kbd>; <strong>Save Snapshot</strong> on <kbd>9</kbd> (ZBrush-style keys). See <a href="parts.html">Parts</a> and <a href="subdivision-levels.html">Subdivision levels</a>.
-</li>
-<li>
-<strong>Send to ZBrush</strong> (GoZ-compatible). Send models to and from ZBrush. See <a href="exporting.html#exchange-models-with-zbrush-send-to-zbrush">Exporting, Unreal and ZBrush</a>.
-</li>
-<li>
-<strong>VDM brushes</strong> with Drag Stamp and Slide Stamp, and your own made from a VDM plane. See <a href="sculpting.html#vector-displacement-brushes">Vector displacement brushes</a>.
-</li>
-<li>
-<strong>Sculpting in Blender too?</strong> The Blender add-on can give Blender&#x27;s Sculpt Mode ZBrush&#x27;s keys. See <a href="blender.html#zbrush-style-keys-in-sculpt-mode">Working with Blender</a>.
-</li>
-</ul>
-<h2 id="bring-your-ztools-over">Bring your ZTools over<a class="anchor" href="#bring-your-ztools-over" aria-label="Link to this section">#</a></h2>
-<p>ZBrush&#x27;s <code>.ZTL</code> files are proprietary, so SculptForge can&#x27;t read them directly. The free <strong>SculptForge ZTL Export</strong> plug-in runs inside ZBrush and converts them once:</p>
-<ol>
-<li>
-Download <a href="https://github.com/islandmed/SculptForge/blob/main/integrations/zbrush/SculptForgeZToolExport.txt" rel="noopener">SculptForgeZToolExport.txt</a> (also attached to every release) and copy it into ZBrush&#x27;s <code>ZStartup/ZPlugs64</code> folder, then restart ZBrush. Or load it once with <strong>ZScript &gt; Load</strong>.
-</li>
-<li>
-In ZBrush, <strong>ZPlugin &gt; SculptForge &gt; Convert ZTL</strong> asks for a <code>.ZTL</code>, loads it and writes each SubTool next to it as a GoZ-compatible file (<code>Dragon.ZTL</code> gives <code>Dragon.sf001_Body.GoZ</code>, <code>Dragon.sf002_Horns.GoZ</code>...). <strong>Save for SculptForge</strong> does the same for the ZTool you have open, saving the <code>.ZTL</code> where you choose.
-</li>
-<li>
-In SculptForge, open the <code>.ZTL</code> (<strong>File &gt; Open</strong>, or drop it on the window). Its SubTools open as Parts in the same order with the same names, face groups, vertex paint, mask and UVs.
-</li>
-</ol>
-<p>Each SubTool comes over at its highest subdivision level; the lower levels, sculpt layers and ZBrush materials don&#x27;t. If you change the ZTool in ZBrush later, convert it again: SculptForge warns when the <code>.ZTL</code> is newer than its conversion. <code>.ZPR</code> projects can&#x27;t be converted; save their ZTools first.</p>
-<aside class="callout callout-note"><p><strong>Note:</strong> the plug-in is new and hasn&#x27;t been tested in every ZBrush version yet. If it stops with an error or a SubTool is missing, please <a href="https://github.com/islandmed/SculptForge/issues" rel="noopener">report it</a> with your ZBrush version; exporting each SubTool from ZBrush as a <code>.GoZ</code> or <code>.OBJ</code> file works in the meantime.</p></aside>
-<h2 id="whats-different">What&#x27;s different<a class="anchor" href="#whats-different" aria-label="Link to this section">#</a></h2>
-<div class="table-wrap"><table><thead><tr><th>ZBrush</th><th>SculptForge</th><th>Why</th></tr></thead><tbody><tr><td>Transpose action line (<kbd>W</kbd> <kbd>E</kbd> <kbd>R</kbd>)</td><td>The Gizmo on the same keys; mask what should stay, and <kbd>Alt</kbd>+click to put the pivot on the model</td><td>Simpler to learn; ZBrush has a Gizmo 3D too. See <a href="gizmo.html">Gizmo</a></td></tr><tr><td>Edit mode (<kbd>T</kbd>) and the 2.5D canvas</td><td>Always in Edit mode</td><td>SculptForge is a 3D sculpting app only</td></tr><tr><td>Perspective toggle (<kbd>P</kbd>)</td><td>Always perspective; <kbd>P</kbd> is the Paint brush (colour only: Rgb on, Add off)</td><td></td></tr><tr><td>Stroke replay (<kbd>1</kbd>, <kbd>2</kbd>, <kbd>3</kbd>)</td><td>Not yet</td><td></td></tr><tr><td><kbd>N</kbd> lists the SubTools</td><td>The Parts sub-palette in the right tray</td><td></td></tr><tr><td>DynaMesh, ZRemesher</td><td><strong>Voxel Remesh</strong> and <strong>Quad Remesh</strong> in <strong>Tool &gt; Geometry</strong></td><td>See <a href="geometry.html">Geometry</a> and <a href="retopology.html">Retopology</a></td></tr><tr><td>Sculptris Pro</td><td><strong>Dynamic</strong> on the top shelf, with its <strong>Detail</strong> slider</td><td>See <a href="dynamic-topology.html">Dynamic topology</a></td></tr><tr><td>Open edges hold their shape when smoothed</td><td>Smooth pulls an open border in a little with each pass</td><td>Mask the border first when it matters</td></tr><tr><td>Values 0-100 everywhere</td><td>The same for Intensity, RGB Intensity and Falloff; Draw Size is the radius in pixels</td><td></td></tr></tbody></table></div>
-<h2 id="shortcuts-side-by-side">Shortcuts side by side<a class="anchor" href="#shortcuts-side-by-side" aria-label="Link to this section">#</a></h2>
-<p>The SculptForge column is with the ZBrush-style keys on.</p>
-<div class="table-wrap"><table><thead><tr><th>Action</th><th>ZBrush</th><th>SculptForge</th></tr></thead><tbody><tr><td>Rotate / move / scale the view</td><td>Drag / <kbd>Alt</kbd>+drag / <kbd>Alt</kbd>, release, drag on the background</td><td>Same</td></tr><tr><td>Snap to a side view / roll</td><td><kbd>Shift</kbd> while rotating / <kbd>Shift</kbd>+click, release, drag</td><td>Same</td></tr><tr><td>Frame</td><td><kbd>F</kbd></td><td><kbd>F</kbd></td></tr><tr><td>Brush pop-up</td><td><kbd>B</kbd></td><td><kbd>B</kbd></td></tr><tr><td>Draw Size / Z Intensity / RGB Intensity / Focal Shift</td><td><kbd>S</kbd> / <kbd>U</kbd> / <kbd>I</kbd> / <kbd>O</kbd></td><td>Same keys: Draw Size / Intensity / RGB Intensity / Falloff</td></tr><tr><td>QuickMenu</td><td><kbd>Space</kbd> or right-click</td><td>Quick Menu: <kbd>Space</kbd> or right-click (a right drag navigates)</td></tr><tr><td>LazyMouse</td><td><kbd>L</kbd></td><td>Steady Stroke: <kbd>L</kbd></td></tr><tr><td>Pick colour / switch colour</td><td><kbd>C</kbd> / <kbd>V</kbd></td><td>Same</td></tr><tr><td>Symmetry</td><td><kbd>X</kbd></td><td><kbd>X</kbd></td></tr><tr><td>Undo / redo</td><td><kbd>Ctrl</kbd>+<kbd>Z</kbd> / <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Z</kbd></td><td>Same (also <kbd>Ctrl</kbd>+<kbd>Y</kbd>)</td></tr><tr><td>Divide / higher / lower res</td><td><kbd>Ctrl</kbd>+<kbd>D</kbd> / <kbd>D</kbd> / <kbd>Shift</kbd>+<kbd>D</kbd></td><td>Same</td></tr><tr><td>Mask all / clear / invert / view</td><td><kbd>Ctrl</kbd>+<kbd>A</kbd> / <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>A</kbd> / <kbd>Ctrl</kbd>+<kbd>I</kbd> / <kbd>Ctrl</kbd>+<kbd>H</kbd></td><td>Same</td></tr><tr><td>Group masked</td><td><kbd>Ctrl</kbd>+<kbd>W</kbd></td><td><kbd>Ctrl</kbd>+<kbd>W</kbd></td></tr><tr><td>PolyFrame</td><td><kbd>Shift</kbd>+<kbd>F</kbd></td><td>Wireframe: <kbd>Shift</kbd>+<kbd>F</kbd></td></tr><tr><td>Draw / Move / Scale / Rotate</td><td><kbd>Q</kbd> / <kbd>W</kbd> / <kbd>E</kbd> / <kbd>R</kbd></td><td>Same keys, Gizmo</td></tr><tr><td>LightBox</td><td><kbd>,</kbd></td><td>Library: <kbd>,</kbd></td></tr><tr><td>Hide the palettes</td><td><kbd>Tab</kbd></td><td><kbd>Tab</kbd></td></tr><tr><td>QuickSave</td><td><kbd>9</kbd></td><td>Save Snapshot: <kbd>9</kbd></td></tr><tr><td>Store Config / Load UI / Save UI</td><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd> / <kbd>Ctrl</kbd>+<kbd>L</kbd> / <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Alt</kbd>+<kbd>I</kbd></td><td>Same</td></tr><tr><td>Perspective</td><td><kbd>P</kbd></td><td>Always on (<kbd>P</kbd> is Paint)</td></tr><tr><td>Search every command</td><td></td><td><kbd>F3</kbd> (ZBrush names work too)</td></tr></tbody></table></div>
-<p>Every shortcut is in <a href="shortcuts.html">Keyboard and mouse</a>, generated from the app itself, and can be changed with <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+click or <strong>Edit &gt; Preferences &gt; Hotkeys</strong>.</p>
-<h2 id="see-also">See also<a class="anchor" href="#see-also" aria-label="Link to this section">#</a></h2>
-<ul>
-<li>
-<a href="shortcuts.html">Keyboard and mouse</a>
-</li>
-<li>
-<a href="glossary.html">Glossary</a>: more ZBrush terms and their SculptForge names
-</li>
-<li>
-<a href="exporting.html">Exporting, Unreal and ZBrush</a>: Send to ZBrush
-</li>
-</ul>
- </article>
- <nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="whats-new.html"><span>Previous</span>What&#x27;s new</a><a class="next" rel="next" href="installing.html"><span>Next</span>Install SculptForge on Windows, macOS and Linux</a></nav>
- <p class="guide-meta fine">Also in the app: <strong>Help &gt; User Guide</strong> (<kbd>Shift</kbd>+<kbd>F1</kbd>).
- Found a mistake? <a href="https://github.com/islandmed/SculptForge/edit/main/docs/guide/coming-from-zbrush.md">Edit this page on GitHub</a>.</p>
- </main>
- <aside class="on-page" aria-label="On this page"><p>On this page</p><ul><li><a href="#zbrush-terms-in-sculptforge">ZBrush terms in SculptForge</a></li><li><a href="#zbrush-style-keys">ZBrush-style keys</a></li><li><a href="#whats-the-same">What&#x27;s the same</a></li><li><a href="#bring-your-ztools-over">Bring your ZTools over</a></li><li><a href="#whats-different">What&#x27;s different</a></li><li><a href="#shortcuts-side-by-side">Shortcuts side by side</a></li><li><a href="#see-also">See also</a></li></ul></aside>
- </div>
- <footer class="footer">
- <div class="wrap footer-grid">
- <div>
- <a class="brand" href="../index.html"><img src="../img/logo.svg?v=2" alt="" width="28" height="28"><span>SculptForge</span></a>
- <p class="fine">Copyright © 2026 The SculptForge contributors.<br>The SculptForge User Guide is part of
- SculptForge, licensed under the <a href="https://github.com/islandmed/SculptForge/blob/main/LICENSE">GNU GPL v3.0 or later</a>.</p>
- </div>
- <div class="links">
- <a href="index.html">User guide</a>
- <a href="../supporters.html">Supporters</a>
- <a href="https://github.com/islandmed/SculptForge">Source code</a>
- <a href="https://discord.gg/gWrYkEmQhH">Community Discord</a>
- <a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
- <a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
- </div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
- </div>
- </footer>
-</body>
-</html>
diff --git a/website/guide/cut.html b/website/guide/cut.html
index 0cb9f45c..de303663 100644
--- a/website/guide/cut.html
+++ b/website/guide/cut.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Cut: line, lasso, rectangle and polyline - SculptForge User Guide">
<meta property="og:description" content="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.">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/cut.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html" class="current" aria-current="page">Cut: line, lasso, rectangle and polyline</a><ul class="toc-sections"><li><a href="#pick-a-shape">Pick a shape</a></li><li><a href="#pick-a-mode">Pick a mode</a></li><li><a href="#what-the-cut-keeps">What the cut keeps</a></li><li><a href="#scripting">Scripting</a></li></ul></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html" class="current" aria-current="page">Cut: line, lasso, rectangle and polyline</a><ul class="toc-sections"><li><a href="#pick-a-shape">Pick a shape</a></li><li><a href="#pick-a-mode">Pick a mode</a></li><li><a href="#what-the-cut-keeps">What the cut keeps</a></li><li><a href="#scripting">Scripting</a></li></ul></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -80,7 +80,6 @@ With symmetry on (<strong>X</strong>, <strong>Y</strong>, <strong>Z</strong> or
</li>
</ul>
<p>An open Part (a plane, a scan with holes) is trimmed without a cap. <strong>Add</strong> needs a closed Part. Forge Spheres and Parts with a micro level must be made into a plain mesh first.</p>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> this covers what the trim, clip and slice curve brushes and Live Boolean are used for, as one tool. SculptForge is not affiliated with Maxon or ZBrush.</p></aside>
<h2 id="scripting">Scripting<a class="anchor" href="#scripting" aria-label="Link to this section">#</a></h2>
<p>The <code>cut</code> command takes the shape (<code>line</code>, <code>lasso</code>, <code>rect</code>, <code>polyline</code>), its <code>points</code> in normalised screen coordinates, the <code>mode</code> (<code>away</code>, <code>in</code>, <code>add</code>), <code>depth</code>, <code>flip</code>, <code>closed</code> and an optional <code>view_proj</code> matrix; see <a href="scripting.html">Scripting</a>.</p>
</article>
@@ -105,8 +104,7 @@ With symmetry on (<strong>X</strong>, <strong>Y</strong>, <strong>Z</strong> or
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/dynamic-topology.html b/website/guide/dynamic-topology.html
index 89d1b2c0..1cb74030 100644
--- a/website/guide/dynamic-topology.html
+++ b/website/guide/dynamic-topology.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Dynamic topology - SculptForge User Guide</title>
- <meta name="description" content="With Dynamic on, the brush adds triangles where it needs detail and removes them where it doesn&#x27;t, as ZBrush&#x27;s Sculptris Pro and Blender&#x27;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 bal">
+ <meta name="description" content="With Dynamic on, the brush adds triangles where it needs detail and removes them where it doesn&#x27;t, as dynamic topology and Blender&#x27;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 with">
<meta name="theme-color" content="#111114">
<meta name="color-scheme" content="dark">
<link rel="icon" type="image/svg+xml" href="../img/favicon.svg?v=2">
@@ -13,8 +13,8 @@
<link rel="canonical" href="https://sculptforge.app/guide/dynamic-topology.html">
<meta property="og:type" content="article">
<meta property="og:title" content="Dynamic topology - SculptForge User Guide">
- <meta property="og:description" content="With Dynamic on, the brush adds triangles where it needs detail and removes them where it doesn&#x27;t, as ZBrush&#x27;s Sculptris Pro and Blender&#x27;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 bal">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:description" content="With Dynamic on, the brush adds triangles where it needs detail and removes them where it doesn&#x27;t, as dynamic topology and Blender&#x27;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 with">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/dynamic-topology.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,24 +46,24 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html" class="current" aria-current="page">Dynamic topology</a><ul class="toc-sections"><li><a href="#turn-it-on">Turn it on</a></li><li><a href="#how-big-the-triangles-get">How big the triangles get</a></li><li><a href="#smooth-remesh">Smooth remesh</a></li><li><a href="#what-it-keeps-and-what-it-doesnt">What it keeps and what it doesn&#x27;t</a></li><li><a href="#subdivision-levels">Subdivision levels</a></li><li><a href="#undo-and-speed">Undo and speed</a></li><li><a href="#from-a-script">From a script</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html" class="current" aria-current="page">Dynamic topology</a><ul class="toc-sections"><li><a href="#turn-it-on">Turn it on</a></li><li><a href="#how-big-the-triangles-get">How big the triangles get</a></li><li><a href="#smooth-remesh">Smooth remesh</a></li><li><a href="#what-it-keeps-and-what-it-doesnt">What it keeps and what it doesn&#x27;t</a></li><li><a href="#subdivision-levels">Subdivision levels</a></li><li><a href="#undo-and-speed">Undo and speed</a></li><li><a href="#from-a-script">From a script</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
<article class="guide-article">
<h1 id="dynamic-topology">Dynamic topology</h1>
-<p>With <strong>Dynamic</strong> on, the brush adds triangles where it needs detail and removes them where it doesn&#x27;t, as ZBrush&#x27;s <strong>Sculptris Pro</strong> and Blender&#x27;s <strong>Dyntopo</strong> 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.</p>
+<p>With <strong>Dynamic</strong> on, the brush adds triangles where it needs detail and removes them where it doesn&#x27;t, as <strong>dynamic topology</strong> and Blender&#x27;s <strong>Dyntopo</strong> 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.</p>
<figure class="shot"><a href="images/dynamic-topology.jpg" class="zoom"><img src="images/dynamic-topology.jpg" alt="A sphere with horns pulled out by Tendril with Dynamic on, as wireframe and shaded" width="1000" height="496" loading="lazy" decoding="async"></a><figcaption>A sphere with horns pulled out by Tendril with Dynamic on, as wireframe and shaded</figcaption></figure>
<h2 id="turn-it-on">Turn it on<a class="anchor" href="#turn-it-on" aria-label="Link to this section">#</a></h2>
-<div class="table-wrap"><table><thead><tr><th>Control</th><th>Where</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Dynamic</strong></td><td>Top shelf, <strong>Sculpt &gt; Draw &amp; Tablet</strong></td><td>Turns dynamic topology on or off (ZBrush&#x27;s Sculptris Pro button)</td></tr><tr><td><strong>Detail</strong></td><td>Top shelf (while Dynamic is on), <strong>Sculpt &gt; Draw &amp; Tablet</strong></td><td>How small the triangles get: 0 coarse, 100 fine (default 50)</td></tr><tr><td><strong>Constant detail</strong></td><td><strong>Sculpt &gt; Draw &amp; Tablet</strong></td><td>Off: the size follows the brush. On: one size for the whole mesh</td></tr></tbody></table></div>
-<p>Then sculpt as usual. Every brush works with it except <strong>Move</strong> (it drags the surface without remeshing), the mask and paint brushes, and the stamping strokes <strong>Drag Stamp</strong> and <strong>Slide Stamp</strong> (so VDM stamps don&#x27;t remesh either). <strong>Smooth</strong> remeshes towards larger triangles, so smoothing also simplifies, as in ZBrush.</p>
+<div class="table-wrap"><table><thead><tr><th>Control</th><th>Where</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Dynamic</strong></td><td>Top shelf, <strong>Sculpt &gt; Draw &amp; Tablet</strong></td><td>Turns dynamic topology on or off</td></tr><tr><td><strong>Detail</strong></td><td>Top shelf (while Dynamic is on), <strong>Sculpt &gt; Draw &amp; Tablet</strong></td><td>How small the triangles get: 0 coarse, 100 fine (default 50)</td></tr><tr><td><strong>Constant detail</strong></td><td><strong>Sculpt &gt; Draw &amp; Tablet</strong></td><td>Off: the size follows the brush. On: one size for the whole mesh</td></tr></tbody></table></div>
+<p>Then sculpt as usual. Every brush works with it except <strong>Move</strong> (it drags the surface without remeshing), the mask and paint brushes, and the stamping strokes <strong>Drag Stamp</strong> and <strong>Slide Stamp</strong> (so VDM stamps don&#x27;t remesh either). <strong>Smooth</strong> remeshes towards larger triangles, so smoothing also simplifies.</p>
<aside class="callout callout-tip"><p><strong>Tip:</strong> Turn on <strong>Wire</strong> (<kbd>Shift</kbd>+<kbd>F</kbd>) to see the triangles appear under the brush.</p></aside>
<h2 id="how-big-the-triangles-get">How big the triangles get<a class="anchor" href="#how-big-the-triangles-get" aria-label="Link to this section">#</a></h2>
-<p>By default the triangle size follows the brush size on screen, as in Sculptris Pro: <strong>zoom in or make the brush smaller for finer triangles</strong>, 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.</p>
+<p>By default the triangle size follows the brush size on screen, as in dynamic topology: <strong>zoom in or make the brush smaller for finer triangles</strong>, 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.</p>
<p>With <strong>Constant detail</strong> on, every stroke aims for the same size whatever the zoom and brush, set by Detail relative to the size of the mesh (at 50, about a hundredth of its bounding box diagonal). Use it to bring a whole model to an even density, or to keep the density while you change brush sizes. It is a preference: Store Config (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd>) keeps it.</p>
<p>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>
<h2 id="smooth-remesh">Smooth remesh<a class="anchor" href="#smooth-remesh" aria-label="Link to this section">#</a></h2>
-<p>Smoothing (<kbd>Shift</kbd>) with Dynamic on also simplifies by default: it remeshes toward triangles twice the size, so the smoothed area gets coarser, as in Sculptris Pro. <strong>Smooth remesh</strong> under <strong>Sculpt &gt; Draw &amp; Tablet &gt; Dynamic topology</strong> sets how much (from the discussions):</p>
+<p>Smoothing (<kbd>Shift</kbd>) with Dynamic on also simplifies by default: it remeshes toward triangles twice the size, so the smoothed area gets coarser, as in dynamic topology. <strong>Smooth remesh</strong> under <strong>Sculpt &gt; Draw &amp; Tablet &gt; Dynamic topology</strong> sets how much (from the discussions):</p>
<ul>
<li>
<strong>Smooth only</strong> (0): Shift only smooths; the triangles stay as they are.
@@ -98,7 +98,7 @@
</li>
</ul>
<h2 id="subdivision-levels">Subdivision levels<a class="anchor" href="#subdivision-levels" aria-label="Link to this section">#</a></h2>
-<p>Dynamic topology works on meshes without <a href="subdivision-levels.html">subdivision levels</a>, as in ZBrush. On a Part with levels, <strong>Dynamic</strong> stays off and the status bar says why: go to the level you want to keep and use <strong>Del Lower</strong> and <strong>Del Higher</strong> in <strong>Tool &gt; Geometry</strong> first. If you turn it on and then pick a Part that has levels, strokes sculpt it without remeshing.</p>
+<p>Dynamic topology works on meshes without <a href="subdivision-levels.html">subdivision levels</a>. On a Part with levels, <strong>Dynamic</strong> stays off and the status bar says why: go to the level you want to keep and use <strong>Del Lower</strong> and <strong>Del Higher</strong> in <strong>Tool &gt; Geometry</strong> first. If you turn it on and then pick a Part that has levels, strokes sculpt it without remeshing.</p>
<p>A good workflow: block in with Dynamic, then <a href="retopology.html">Quad Remesh</a> or <a href="geometry.html">Voxel Remesh</a> for an even base, <strong>Divide</strong> for levels, and sculpt the fine detail on them.</p>
<h2 id="undo-and-speed">Undo and speed<a class="anchor" href="#undo-and-speed" aria-label="Link to this section">#</a></h2>
<p>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).</p>
@@ -120,7 +120,7 @@ dyntopo enabled=false</code></pre><button class="copy" type="button" aria-label=
<a href="geometry.html">Subdivide, remesh, decimate and LODs</a>
</li>
<li>
-<a href="coming-from-zbrush.html">Coming from ZBrush</a>
+<a href="quick-tour.html">Quick tour for experienced sculptors</a>
</li>
</ul>
</article>
@@ -145,8 +145,7 @@ dyntopo enabled=false</code></pre><button class="copy" type="button" aria-label=
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/export-presets.html b/website/guide/export-presets.html
index ef378f7d..6e01d9ff 100644
--- a/website/guide/export-presets.html
+++ b/website/guide/export-presets.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Export presets - SculptForge User Guide">
<meta property="og:description" content="Export Maps writes a texture&#x27;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 ">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/export-presets.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html" class="current" aria-current="page">Export presets</a><ul class="toc-sections"><li><a href="#export-maps">Export maps</a></li><li><a href="#built-in-presets">Built-in presets</a></li><li><a href="#material-slots-in-model-files">Material slots in model files</a></li><li><a href="#your-own-presets">Your own presets</a></li></ul></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html" class="current" aria-current="page">Export presets</a><ul class="toc-sections"><li><a href="#export-maps">Export maps</a></li><li><a href="#built-in-presets">Built-in presets</a></li><li><a href="#material-slots-in-model-files">Material slots in model files</a></li><li><a href="#your-own-presets">Your own presets</a></li></ul></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -107,7 +107,7 @@ A <code>?</code> after a source drops that component when its channel isn&#x27;t
</ul>
<p>A preset with a mistake is refused with a message saying what is wrong.</p>
</article>
- <nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="exporting.html"><span>Previous</span>Exporting, Unreal and ZBrush</a><a class="next" rel="next" href="blender.html"><span>Next</span>Working with Blender</a></nav>
+ <nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="exporting.html"><span>Previous</span>Exporting, Unreal and Bridge</a><a class="next" rel="next" href="blender.html"><span>Next</span>Working with Blender</a></nav>
<p class="guide-meta fine">Also in the app: <strong>Help &gt; User Guide</strong> (<kbd>Shift</kbd>+<kbd>F1</kbd>).
Found a mistake? <a href="https://github.com/islandmed/SculptForge/edit/main/docs/guide/export-presets.md">Edit this page on GitHub</a>.</p>
</main>
@@ -128,8 +128,7 @@ A <code>?</code> after a source drops that component when its channel isn&#x27;t
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/exporting.html b/website/guide/exporting.html
index 0052a9ed..57d700bb 100644
--- a/website/guide/exporting.html
+++ b/website/guide/exporting.html
@@ -3,8 +3,8 @@
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
- <title>Exporting, Unreal and ZBrush - SculptForge User Guide</title>
- <meta name="description" content="This chapter covers getting your sculpt out of SculptForge: the export formats and what each one keeps, LOD chains for games, sending a mesh straight into a running Unreal Editor, and exchanging models with ZBrush with Send to ZBrush. To keep everything (Parts, layers, mask, vertex paint, brushes) u">
+ <title>Exporting, Unreal and Bridge - SculptForge User Guide</title>
+ <meta name="description" content="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, ve">
<meta name="theme-color" content="#111114">
<meta name="color-scheme" content="dark">
<link rel="icon" type="image/svg+xml" href="../img/favicon.svg?v=2">
@@ -12,9 +12,9 @@
<link rel="apple-touch-icon" href="../img/icon-256.png?v=2">
<link rel="canonical" href="https://sculptforge.app/guide/exporting.html">
<meta property="og:type" content="article">
- <meta property="og:title" content="Exporting, Unreal and ZBrush - SculptForge User Guide">
- <meta property="og:description" content="This chapter covers getting your sculpt out of SculptForge: the export formats and what each one keeps, LOD chains for games, sending a mesh straight into a running Unreal Editor, and exchanging models with ZBrush with Send to ZBrush. To keep everything (Parts, layers, mask, vertex paint, brushes) u">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:title" content="Exporting, Unreal and Bridge - SculptForge User Guide">
+ <meta property="og:description" content="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, ve">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/exporting.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -40,26 +40,26 @@
<div class="wrap guide-layout">
<div class="guide-side">
<button class="toc-toggle" type="button" aria-expanded="false" aria-controls="guide-toc">
- <span>Contents</span><span class="toc-current">Exporting, Unreal and ZBrush</span></button>
+ <span>Contents</span><span class="toc-current">Exporting, Unreal and Bridge</span></button>
<div id="guide-toc" class="toc-panel">
<div class="guide-search" role="search">
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html" class="current" aria-current="page">Exporting, Unreal and ZBrush</a><ul class="toc-sections"><li><a href="#export-formats-at-a-glance">Export formats at a glance</a></li><li><a href="#export-a-model">Export a model</a></li><li><a href="#3d-printing">3D printing</a></li><li><a href="#lod-chains-for-games">LOD chains for games</a></li><li><a href="#send-to-unreal">Send to Unreal</a></li><li><a href="#exchange-models-with-zbrush-send-to-zbrush">Exchange models with ZBrush (Send to ZBrush)</a></li><li><a href="#blender">Blender</a></li><li><a href="#maya">Maya</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html" class="current" aria-current="page">Exporting, Unreal and Bridge</a><ul class="toc-sections"><li><a href="#export-formats-at-a-glance">Export formats at a glance</a></li><li><a href="#export-a-model">Export a model</a></li><li><a href="#3d-printing">3D printing</a></li><li><a href="#lod-chains-for-games">LOD chains for games</a></li><li><a href="#send-to-unreal">Send to Unreal</a></li><li><a href="#exchange-models-through-the-bridge">Exchange models through the Bridge</a></li><li><a href="#blender">Blender</a></li><li><a href="#maya">Maya</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
<article class="guide-article">
-<h1 id="exporting-unreal-and-zbrush">Exporting, Unreal and ZBrush</h1>
-<p>This chapter covers getting your sculpt out of SculptForge: the export formats and what each one keeps, LOD chains for games, sending a mesh straight into a running Unreal Editor, and exchanging models with ZBrush with Send to ZBrush. To keep everything (Parts, layers, mask, vertex paint, brushes) use a project file instead; see <a href="projects.html">Projects, autosave and snapshots</a>.</p>
+<h1 id="exporting-unreal-and-bridge">Exporting, Unreal and Bridge</h1>
+<p>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 <a href="projects.html">Projects, autosave and snapshots</a>.</p>
<h2 id="export-formats-at-a-glance">Export formats at a glance<a class="anchor" href="#export-formats-at-a-glance" aria-label="Link to this section">#</a></h2>
<p>Exports write every <strong>visible</strong> Part. Hidden Parts are left out. Exporting doesn&#x27;t rename the document or mark it saved, so your next <kbd>Ctrl</kbd>+<kbd>S</kbd> still saves the project.</p>
-<div class="table-wrap"><table><thead><tr><th>Format</th><th>Where in the app</th><th>Keeps</th><th>Use it for</th></tr></thead><tbody><tr><td>glTF binary (<code>.glb</code>)</td><td><strong>File &gt; Export GLB...</strong> (<kbd>Ctrl</kbd>+<kbd>E</kbd>)</td><td>One node per Part, sculpt layers as morph targets, vertex paint as vertex colour, UVs and the painted texture (embedded)</td><td>Games, Blender, three.js, web viewers</td></tr><tr><td>LOD chain (<code>.glb</code> per level)</td><td><strong>File &gt; Export LOD Chain...</strong></td><td>As GLB, one file per level, blend shapes on every level</td><td>Game engines</td></tr><tr><td>OpenUSD (<code>.usda</code>, <code>.usdz</code>)</td><td><strong>File &gt; Export USD / USDZ...</strong></td><td>One Mesh prim per Part, quads, layers as UsdSkel blend shapes, vertex paint as <code>displayColor</code>, UVs (<code>primvars:st</code>) and the painted texture through a preview material (inside a USDZ), loaded splats</td><td>Film pipelines, Omniverse, Apple AR Quick Look</td></tr><tr><td>FBX for Unreal (<code>.fbx</code>)</td><td><strong>File &gt; Export FBX for Unreal...</strong></td><td>Unreal naming and scale, quads, UVs, LOD group, layers as blend shapes, the painted texture as a PNG beside it</td><td>Unreal Engine (by hand)</td></tr><tr><td>Wavefront OBJ (<code>.obj</code>)</td><td><strong>File &gt; Export OBJ...</strong></td><td>One <code>o</code> object per Part, quads, face groups as <code>g</code> groups, vertex paint as vertex colour, UVs, the painted texture through a <code>.mtl</code> (<code>map_Kd</code>) and a PNG beside it. Layers are baked into the current blend</td><td>Any 3D app, ZBrush</td></tr><tr><td>ZBrush GoZ-compatible (<code>.GoZ</code>)</td><td><strong>File &gt; Send to ZBrush &gt; Export GoZ-compatible file...</strong></td><td>Quads, face groups, mask, vertex paint, UVs, the painted texture as a PNG beside it</td><td>ZBrush</td></tr><tr><td>STL (<code>.stl</code>)</td><td><strong>File &gt; Send to ZBrush &gt; Export STL...</strong></td><td>Geometry only (triangles), visible Parts merged, in millimetres with Z up</td><td><a href="#3d-printing">3D printing</a></td></tr><tr><td>PLY (<code>.ply</code>)</td><td><code>export_ply</code> command</td><td>Geometry, quads and vertex paint, visible Parts merged</td><td>Scan tools, MeshLab, Blender</td></tr><tr><td>FBX (general)</td><td><code>export_fbx</code> command</td><td>One model per Part, quads, UVs, blend shapes, optional LOD groups, the painted texture</td><td>Other FBX pipelines</td></tr></tbody></table></div>
+<div class="table-wrap"><table><thead><tr><th>Format</th><th>Where in the app</th><th>Keeps</th><th>Use it for</th></tr></thead><tbody><tr><td>glTF binary (<code>.glb</code>)</td><td><strong>File &gt; Export GLB...</strong> (<kbd>Ctrl</kbd>+<kbd>E</kbd>)</td><td>One node per Part, sculpt layers as morph targets, vertex paint as vertex colour, UVs and the painted texture (embedded)</td><td>Games, Blender, three.js, web viewers</td></tr><tr><td>LOD chain (<code>.glb</code> per level)</td><td><strong>File &gt; Export LOD Chain...</strong></td><td>As GLB, one file per level, blend shapes on every level</td><td>Game engines</td></tr><tr><td>OpenUSD (<code>.usda</code>, <code>.usdz</code>)</td><td><strong>File &gt; Export USD / USDZ...</strong></td><td>One Mesh prim per Part, quads, layers as UsdSkel blend shapes, vertex paint as <code>displayColor</code>, UVs (<code>primvars:st</code>) and the painted texture through a preview material (inside a USDZ), loaded splats</td><td>Film pipelines, Omniverse, Apple AR Quick Look</td></tr><tr><td>FBX for Unreal (<code>.fbx</code>)</td><td><strong>File &gt; Export FBX for Unreal...</strong></td><td>Unreal naming and scale, quads, UVs, LOD group, layers as blend shapes, the painted texture as a PNG beside it</td><td>Unreal Engine (by hand)</td></tr><tr><td>Wavefront OBJ (<code>.obj</code>)</td><td><strong>File &gt; Export OBJ...</strong></td><td>One <code>o</code> object per Part, quads, face groups as <code>g</code> groups, vertex paint as vertex colour, UVs, the painted texture through a <code>.mtl</code> (<code>map_Kd</code>) and a PNG beside it. Layers are baked into the current blend</td><td>Any 3D app</td></tr><tr><td>Bridge file</td><td><strong>File &gt; Bridge &gt; Export Bridge file...</strong></td><td>Quads, face groups, mask, vertex paint, UVs, the painted texture as a PNG beside it</td><td>The <a href="#exchange-models-through-the-bridge">Bridge</a></td></tr><tr><td>STL (<code>.stl</code>)</td><td><strong>File &gt; Bridge &gt; Export STL...</strong></td><td>Geometry only (triangles), visible Parts merged, in millimetres with Z up</td><td><a href="#3d-printing">3D printing</a></td></tr><tr><td>PLY (<code>.ply</code>)</td><td><code>export_ply</code> command</td><td>Geometry, quads and vertex paint, visible Parts merged</td><td>Scan tools, MeshLab, Blender</td></tr><tr><td>FBX (general)</td><td><code>export_fbx</code> command</td><td>One model per Part, quads, UVs, blend shapes, optional LOD groups, the painted texture</td><td>Other FBX pipelines</td></tr></tbody></table></div>
<p>The GLB, LOD chain and FBX for Unreal exports are also in the <strong>Tool</strong> palette under <strong>Export</strong>, together with the LOD and Unreal settings.</p>
<p>&quot;Quads&quot; 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 <a href="geometry.html#quads-and-triangles">Quads and triangles</a>. glTF and STL can only hold triangles.</p>
<figure class="shot"><a href="images/export.jpg" class="zoom"><img src="images/export.jpg" alt="The Tool &gt; Export sub-palette with a generated LOD chain and the Unreal Engine settings" width="320" height="740" loading="lazy" decoding="async"></a><figcaption>The Tool &gt; Export sub-palette with a generated LOD chain and the Unreal Engine settings</figcaption></figure>
-<p>UVs are kept through OBJ, FBX, USD, glTF and GoZ-compatible files, in and out. A Part with a painted <a href="texture-painting.html">texture</a> is exported with it: the PNG is written next to the file as <code>&lt;name&gt;_color.png</code> (<code>&lt;name&gt;_&lt;Part&gt;_color.png</code> with several Parts) and referenced by the model, or embedded in GLB and USDZ files. Spaces in the file name become <code>_</code> in the names of the files written beside it (<code>my scene.obj</code> gets <code>my_scene.mtl</code> and <code>my_scene_color.png</code>), because OBJ and MTL separate file names with spaces. <strong>Tool &gt; Texture Map &gt; Auto UV</strong> gives any sculpt UVs before export. Normal, displacement and other maps come from <a href="baking.html">Tool &gt; Bake</a> as separate image files.</p>
+<p>UVs are kept through OBJ, FBX, USD, glTF and Bridge files, in and out. A Part with a painted <a href="texture-painting.html">texture</a> is exported with it: the PNG is written next to the file as <code>&lt;name&gt;_color.png</code> (<code>&lt;name&gt;_&lt;Part&gt;_color.png</code> with several Parts) and referenced by the model, or embedded in GLB and USDZ files. Spaces in the file name become <code>_</code> in the names of the files written beside it (<code>my scene.obj</code> gets <code>my_scene.mtl</code> and <code>my_scene_color.png</code>), because OBJ and MTL separate file names with spaces. <strong>Tool &gt; Texture Map &gt; Auto UV</strong> gives any sculpt UVs before export. Normal, displacement and other maps come from <a href="baking.html">Tool &gt; Bake</a> as separate image files.</p>
<p>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&#x27;s validators (the USDZ files are uncompressed, 64-byte aligned and have the root layer first); FBX files load in ufbx&#x27;s strict mode with their textures connected; and in all four formats plus OBJ, the texture is sampled the right way up (each format&#x27;s UV convention), checked colour by colour against SculptForge&#x27;s own sampling. The scripts are in <code>tools/export_check/</code> in the source tree.</p>
<h3 id="scale-and-axes">Scale and axes<a class="anchor" href="#scale-and-axes" aria-label="Link to this section">#</a></h3>
<ul>
@@ -99,7 +99,7 @@ sculptforge-cli -c &#x27;open path=bust.sfproj; save_obj path=bust.obj&#x27;
sculptforge-cli -c &#x27;open path=bust.sfproj; export_fbx path=bust.fbx lods=3 ratio=0.5&#x27;
sculptforge-cli -c &#x27;open path=bust.sfproj; export_stl path=bust.stl; export_ply path=bust.ply&#x27;</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
<h2 id="3d-printing">3D printing<a class="anchor" href="#3d-printing" aria-label="Link to this section">#</a></h2>
-<p><strong>File &gt; Send to ZBrush &gt; Export STL...</strong> 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 &quot;Exported lion.stl (47214 triangles, 320.8 x 206.6 x 436.4 mm)&quot;: width, depth and height as the slicer shows them.</p>
+<p><strong>File &gt; Bridge &gt; Export STL...</strong> 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 &quot;Exported lion.stl (47214 triangles, 320.8 x 206.6 x 436.4 mm)&quot;: width, depth and height as the slicer shows them.</p>
<ul>
<li>
<strong>Size:</strong> 1 unit in SculptForge is 1 m, so 1 unit becomes 1000 mm. To print at a given height, use <code>export_stl path=lion.stl height_mm=80</code>, or scale the model in the slicer.
@@ -185,25 +185,24 @@ sculptforge-cli -c &#x27;unreal_editors network=true&#x27; # li
sculptforge-cli -c &#x27;open path=statue.obj; export_unreal folder=out height_cm=200&#x27;</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
<p><code>unreal_send</code> also takes <code>name=</code>, <code>project=</code> (pick one editor when several are open) and <code>network=true</code>.</p>
<aside class="callout callout-note"><p><strong>Note:</strong> Layered sculpts are sent as skeletal meshes without the LOD chain, because Unreal&#x27;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&#x27;s <strong>Output Log</strong> shows the importer&#x27;s messages.</p></aside>
-<h2 id="exchange-models-with-zbrush-send-to-zbrush">Exchange models with ZBrush (Send to ZBrush)<a class="anchor" href="#exchange-models-with-zbrush-send-to-zbrush" aria-label="Link to this section">#</a></h2>
-<p>SculptForge reads and writes ZBrush&#x27;s GoZ format and can talk to a running ZBrush through the <strong>Send to ZBrush</strong> on Windows and macOS. The commands are in <strong>File &gt; Send to ZBrush</strong>:</p>
-<div class="table-wrap"><table><thead><tr><th>Item</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Send to ZBrush</strong></td><td>Writes every visible Part to the shared bridge folder and tells ZBrush (starting it if needed). Each Part arrives as its own ZBrush SubTool. Turns on <strong>Receive automatically</strong></td></tr><tr><td><strong>Receive from ZBrush</strong></td><td>Loads what ZBrush last sent. Each object updates the Part it was sent from (one undo step), or becomes a new Part</td></tr><tr><td><strong>Receive automatically</strong></td><td>Checks once a second for a new send from ZBrush and receives it</td></tr><tr><td><strong>Custom bridge folder (optional)</strong></td><td>Use another bridge folder, for example inside a Wine prefix</td></tr><tr><td><strong>Import GoZ-compatible file...</strong></td><td>Opens a <code>.GoZ</code> file, replacing the scene</td></tr><tr><td><strong>Export GoZ-compatible file...</strong></td><td>Writes a <code>.GoZ</code> file. With several visible Parts, one file per Part next to the path</td></tr><tr><td><strong>Export STL...</strong></td><td>Writes a binary STL of the visible Parts</td></tr></tbody></table></div>
-<p>The default bridge folder is <code>C:\Users\Public\Pixologic</code> on Windows and <code>/Users/Shared/Pixologic</code> on macOS. ZBrush doesn&#x27;t run on Linux, so there the bridge needs a custom folder; GoZ-compatible files still import and export.</p>
+<h2 id="exchange-models-through-the-bridge">Exchange models through the Bridge<a class="anchor" href="#exchange-models-through-the-bridge" aria-label="Link to this section">#</a></h2>
+<p>The <strong>Bridge</strong> exchanges Parts with another sculpting application through a shared bridge folder, the way that application&#x27;s own exchange plug-in does, on Windows and macOS. The commands are in <strong>File &gt; Bridge</strong>:</p>
+<div class="table-wrap"><table><thead><tr><th>Item</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Send</strong></td><td>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 <strong>Receive automatically</strong></td></tr><tr><td><strong>Receive</strong></td><td>Loads what the other application last sent. Each object updates the Part it was sent from (one undo step), or becomes a new Part</td></tr><tr><td><strong>Receive automatically</strong></td><td>Checks once a second for a new send and receives it</td></tr><tr><td><strong>Custom bridge folder (optional)</strong></td><td>Use another bridge folder, for example inside a Wine prefix</td></tr><tr><td><strong>Import Bridge file...</strong></td><td>Opens a Bridge file, replacing the scene</td></tr><tr><td><strong>Export Bridge file...</strong></td><td>Writes a Bridge file. With several visible Parts, one file per Part next to the path</td></tr><tr><td><strong>Export STL...</strong></td><td>Writes a binary STL of the visible Parts</td></tr></tbody></table></div>
+<p>The default bridge folder and the one-time setup are on the <a href="https://github.com/islandmed/SculptForge/blob/main/integrations/bridge-plugin/README.md" rel="noopener">Bridge setup page</a>. On Linux the Bridge needs a custom folder; Bridge files still import and export.</p>
<h3 id="a-round-trip">A round trip<a class="anchor" href="#a-round-trip" aria-label="Link to this section">#</a></h3>
<ol>
<li>
-In SculptForge, choose <strong>File &gt; Send to ZBrush &gt; Send</strong>. ZBrush starts or comes forward with the Parts. If ZBrush was not running and does not import them, press <strong>GoZ</strong> in ZBrush.
+In SculptForge, choose <strong>File &gt; Bridge &gt; Send</strong>. 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.
</li>
<li>
-Work in ZBrush, then press <strong>GoZ</strong> there to send the model back.
+Work there, then send the model back with its exchange plug-in.
</li>
<li>
SculptForge receives it automatically and updates the matching Parts. Each update is an undo step on that Part.
</li>
</ol>
-<p>The bridge keeps face groups, mask, vertex paint and UVs. Quads from ZBrush stay quads: Wire shows them as quads, and they go back to ZBrush as the same quads. The format has no hidden-face flag, so hidden faces are sent like any others.</p>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> SculptForge can&#x27;t read ZBrush&#x27;s own <code>.ZTL</code> and <code>.ZPR</code> files (they are proprietary and undocumented). Bring models over with Send to ZBrush, export OBJ or FBX from ZBrush, or convert your ZTools once with the <strong>SculptForge ZTL Export</strong> plug-in for ZBrush, after which SculptForge opens the <code>.ZTL</code> itself (see <a href="coming-from-zbrush.html#bring-your-ztools-over">Coming from ZBrush</a>). Subdivision levels don&#x27;t come across: SculptForge receives the mesh at the level you sent.</p></aside>
-<aside class="callout callout-note"><p><strong>Note:</strong> Send to ZBrush follows the format of the open-source Blender GoZ add-on (GoB) and is tested with files, but has not yet been tested against a live ZBrush. If a send does not arrive, export a <code>.GoZ</code> file and import it in ZBrush by hand, and please report it (<strong>Help &gt; Report a problem</strong>).</p></aside>
+<p>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.</p>
+<aside class="callout callout-note"><p><strong>Note:</strong> 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 (<strong>Help &gt; Report a problem</strong>).</p></aside>
<p>From scripts: <code>goz_export path=</code>, <code>goz_import path=</code>, <code>goz_send</code>, <code>goz_receive</code> and <code>export_stl path=</code> (see <a href="#3d-printing">3D printing</a> for its options).</p>
<h2 id="blender">Blender<a class="anchor" href="#blender" aria-label="Link to this section">#</a></h2>
<p>To sculpt Blender objects in SculptForge and send them back into the same objects, use the SculptForge Bridge add-on and <strong>File &gt; Blender</strong>: see <a href="blender.html">Working with Blender</a>. For a one-off exchange, OBJ, FBX and glTF all carry Parts, UVs and quads both ways.</p>
@@ -241,7 +240,7 @@ SculptForge receives it automatically and updates the matching Parts. Each updat
<p class="guide-meta fine">Also in the app: <strong>Help &gt; User Guide</strong> (<kbd>Shift</kbd>+<kbd>F1</kbd>).
Found a mistake? <a href="https://github.com/islandmed/SculptForge/edit/main/docs/guide/exporting.md">Edit this page on GitHub</a>.</p>
</main>
- <aside class="on-page" aria-label="On this page"><p>On this page</p><ul><li><a href="#export-formats-at-a-glance">Export formats at a glance</a></li><li><a href="#export-a-model">Export a model</a></li><li><a href="#3d-printing">3D printing</a></li><li><a href="#lod-chains-for-games">LOD chains for games</a></li><li><a href="#send-to-unreal">Send to Unreal</a></li><li><a href="#exchange-models-with-zbrush-send-to-zbrush">Exchange models with ZBrush (Send to ZBrush)</a></li><li><a href="#blender">Blender</a></li><li><a href="#maya">Maya</a></li><li><a href="#see-also">See also</a></li></ul></aside>
+ <aside class="on-page" aria-label="On this page"><p>On this page</p><ul><li><a href="#export-formats-at-a-glance">Export formats at a glance</a></li><li><a href="#export-a-model">Export a model</a></li><li><a href="#3d-printing">3D printing</a></li><li><a href="#lod-chains-for-games">LOD chains for games</a></li><li><a href="#send-to-unreal">Send to Unreal</a></li><li><a href="#exchange-models-through-the-bridge">Exchange models through the Bridge</a></li><li><a href="#blender">Blender</a></li><li><a href="#maya">Maya</a></li><li><a href="#see-also">See also</a></li></ul></aside>
</div>
<footer class="footer">
<div class="wrap footer-grid">
@@ -258,8 +257,7 @@ SculptForge receives it automatically and updates the matching Parts. Each updat
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/face-groups.html b/website/guide/face-groups.html
index e3d65bcd..c0aadb57 100644
--- a/website/guide/face-groups.html
+++ b/website/guide/face-groups.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Face Groups and visibility - SculptForge User Guide</title>
- <meta name="description" content="Face Groups (ZBrush users: Polygroups) divide a Part&#x27;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 fa">
+ <meta name="description" content="Face Groups (experienced sculptors: Face groups) divide a Part&#x27;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 c">
<meta name="theme-color" content="#111114">
<meta name="color-scheme" content="dark">
<link rel="icon" type="image/svg+xml" href="../img/favicon.svg?v=2">
@@ -13,8 +13,8 @@
<link rel="canonical" href="https://sculptforge.app/guide/face-groups.html">
<meta property="og:type" content="article">
<meta property="og:title" content="Face Groups and visibility - SculptForge User Guide">
- <meta property="og:description" content="Face Groups (ZBrush users: Polygroups) divide a Part&#x27;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 fa">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:description" content="Face Groups (experienced sculptors: Face groups) divide a Part&#x27;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 c">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/face-groups.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,14 +46,14 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html" class="current" aria-current="page">Face Groups and visibility</a><ul class="toc-sections"><li><a href="#show-face-groups">Show face groups</a></li><li><a href="#create-face-groups">Create face groups</a></li><li><a href="#hide-and-show-parts">Hide and show parts</a></li><li><a href="#typical-workflows">Typical workflows</a></li><li><a href="#face-groups-and-other-tools">Face Groups and other tools</a></li><li><a href="#face-groups-from-a-script">Face Groups from a script</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html" class="current" aria-current="page">Face Groups and visibility</a><ul class="toc-sections"><li><a href="#show-face-groups">Show face groups</a></li><li><a href="#create-face-groups">Create face groups</a></li><li><a href="#hide-and-show-parts">Hide and show parts</a></li><li><a href="#typical-workflows">Typical workflows</a></li><li><a href="#face-groups-and-other-tools">Face Groups and other tools</a></li><li><a href="#face-groups-from-a-script">Face Groups from a script</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
<article class="guide-article">
<h1 id="face-groups-and-visibility">Face Groups and visibility</h1>
-<p>Face Groups (ZBrush users: Polygroups) divide a Part&#x27;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 <kbd>Ctrl</kbd>+<kbd>Shift</kbd> visibility gestures and the <strong>Tool &gt; Face Groups</strong> and <strong>Tool &gt; Visibility</strong> controls.</p>
-<figure class="shot"><a href="images/polygroups.jpg" class="zoom"><img src="images/polygroups.jpg" alt="Face Groups shown as colours, with the Face Groups sub-palette" width="960" height="561" loading="lazy" decoding="async"></a><figcaption>Face Groups shown as colours, with the Face Groups sub-palette</figcaption></figure>
+<p>Face Groups (experienced sculptors: Face groups) divide a Part&#x27;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 <kbd>Ctrl</kbd>+<kbd>Shift</kbd> visibility gestures and the <strong>Tool &gt; Face Groups</strong> and <strong>Tool &gt; Visibility</strong> controls.</p>
+<figure class="shot"><a href="images/face-groups.jpg" class="zoom"><img src="images/face-groups.jpg" alt="Face Groups shown as colours, with the Face Groups sub-palette" width="960" height="561" loading="lazy" decoding="async"></a><figcaption>Face Groups shown as colours, with the Face Groups sub-palette</figcaption></figure>
<h2 id="show-face-groups">Show face groups<a class="anchor" href="#show-face-groups" aria-label="Link to this section">#</a></h2>
<p>Click <strong>Groups</strong> in the right shelf to colour each face group of the active Part. The same toggle is <strong>Show face groups</strong> in <strong>Tool &gt; Face Groups</strong> and <strong>Show Face Groups</strong> in the <strong>View</strong> menu. The grouping buttons turn the colours on for you, so you see the result straight away.</p>
<p>The number next to <strong>Show face groups</strong> is how many face groups are visible right now.</p>
@@ -63,17 +63,16 @@
the grouping buttons below;
</li>
<li>
-OBJ files: each <code>g</code> group becomes a face group, as ZBrush writes them (SculptForge also writes face groups as <code>g</code> groups when it exports OBJ);
+OBJ files: each <code>g</code> group becomes a face group (SculptForge also writes face groups as <code>g</code> groups when it exports OBJ);
</li>
<li>
-<code>.GoZ</code> files from ZBrush and SculptForge projects, which keep face groups.
+Bridge files and SculptForge projects, which keep face groups.
</li>
</ul>
<h2 id="create-face-groups">Create face groups<a class="anchor" href="#create-face-groups" aria-label="Link to this section">#</a></h2>
<p>Open <strong>Tool &gt; Face Groups</strong>. Grouping works on the <strong>visible</strong> part of the Part only; hidden parts keep their groups. So you can isolate one part and regroup just that part.</p>
<div class="table-wrap"><table><thead><tr><th>Control</th><th>What it does</th><th>Command</th></tr></thead><tbody><tr><td><strong>By normals</strong></td><td>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.</td><td><code>polygroup_auto_by_normals</code></td></tr><tr><td><strong>By pieces</strong></td><td>One group per disconnected piece, such as separate eyes or buttons in one mesh.</td><td><code>polygroup_by_connectivity</code></td></tr><tr><td><strong>From mask</strong></td><td>Masked triangles move into a new group.</td><td><code>polygroup_from_mask</code></td></tr><tr><td><strong>Group by UVs</strong></td><td>One group per UV island: triangles that touch without a UV seam between them share a group. Needs UVs (<strong>Tool &gt; Texture Map &gt; Auto UV</strong> or an imported model&#x27;s).</td><td><code>polygroup_uv</code></td></tr><tr><td><strong>Merge visible</strong></td><td>Everything visible becomes one group.</td><td><code>polygroup_merge_visible</code></td></tr><tr><td><strong>Clear groups</strong></td><td>Remove all face groups; the whole Part becomes one group again.</td><td><code>polygroup_clear</code></td></tr></tbody></table></div>
<p>Each button is one undo step.</p>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> <strong>By normals</strong> is Auto Groups / Groups By Normals, <strong>By pieces</strong> is Auto Groups on a mesh with separate parts, <strong>From mask</strong> is Group Masked, <strong>Group by UVs</strong> is UV Groups, and <strong>Merge visible</strong> is Group Visible. <kbd>Ctrl</kbd>+<kbd>W</kbd> works as in ZBrush: the masked part becomes a new group and the mask is cleared (with nothing masked, everything visible becomes one group).</p></aside>
<h3 id="group-a-region-you-painted">Group a region you painted<a class="anchor" href="#group-a-region-you-painted" aria-label="Link to this section">#</a></h3>
<ol>
<li>
@@ -89,12 +88,11 @@ Click <strong>From mask</strong> in <strong>Tool &gt; Face Groups</strong>.
<h2 id="hide-and-show-parts">Hide and show parts<a class="anchor" href="#hide-and-show-parts" aria-label="Link to this section">#</a></h2>
<p>Visibility is the main reason to have face groups: hide what is in the way, sculpt what&#x27;s left, then show everything again. Hidden parts can&#x27;t be sculpted, painted or masked, so hiding also protects them.</p>
<p>All of the gestures use <kbd>Ctrl</kbd>+<kbd>Shift</kbd> in the viewport (<kbd>Cmd</kbd>+<kbd>Shift</kbd> on macOS):</p>
-<div class="table-wrap"><table><thead><tr><th>Gesture</th><th>Effect</th></tr></thead><tbody><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd> + click a face group, everything shown</td><td>Isolate it: show only that group.</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd> + click a face group, something hidden</td><td>Hide that group (as in ZBrush).</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd> + click the isolated group again</td><td>Invert the visibility: show everything else instead.</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Alt</kbd> + click a face group</td><td>Hide that group.</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd> + click the background</td><td>Show everything.</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd> + drag a rectangle on the background, around nothing</td><td>Reverse the visibility.</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd> + drag</td><td>Keep what&#x27;s inside the rectangle (or lasso), hide the rest. The shape is drawn green.</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Alt</kbd> + drag</td><td>Hide what&#x27;s inside the rectangle (or lasso). The shape is drawn red.</td></tr></tbody></table></div>
-<p>Whether a drag draws a rectangle or a lasso is set by <strong>Select Rectangle</strong> and <strong>Select Lasso</strong> at the top of <strong>Tool &gt; Visibility</strong> (Select Rectangle by default), or, as in ZBrush, with <kbd>Ctrl</kbd>+<kbd>Shift</kbd> held: the left shelf then shows the selection brush, and clicking the brush tile (or pressing <kbd>B</kbd>) or the stroke tile picks <strong>Select Rectangle</strong> or <strong>Select Lasso</strong>. With <strong>Select Lasso</strong>, 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.</p>
+<div class="table-wrap"><table><thead><tr><th>Gesture</th><th>Effect</th></tr></thead><tbody><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd> + click a face group, everything shown</td><td>Isolate it: show only that group.</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd> + click a face group, something hidden</td><td>Hide that group.</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd> + click the isolated group again</td><td>Invert the visibility: show everything else instead.</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Alt</kbd> + click a face group</td><td>Hide that group.</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd> + click the background</td><td>Show everything.</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd> + drag a rectangle on the background, around nothing</td><td>Reverse the visibility.</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd> + drag</td><td>Keep what&#x27;s inside the rectangle (or lasso), hide the rest. The shape is drawn green.</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Alt</kbd> + drag</td><td>Hide what&#x27;s inside the rectangle (or lasso). The shape is drawn red.</td></tr></tbody></table></div>
+<p>Whether a drag draws a rectangle or a lasso is set by <strong>Select Rectangle</strong> and <strong>Select Lasso</strong> at the top of <strong>Tool &gt; Visibility</strong> (Select Rectangle by default), or, with <kbd>Ctrl</kbd>+<kbd>Shift</kbd> held: the left shelf then shows the selection brush, and clicking the brush tile (or pressing <kbd>B</kbd>) or the stroke tile picks <strong>Select Rectangle</strong> or <strong>Select Lasso</strong>. With <strong>Select Lasso</strong>, 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.</p>
<p>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 <kbd>Alt</kbd> while dragging; what counts is whether it is held when you let go.</p>
<p>With symmetry on (<strong>X</strong>, <strong>Y</strong>, <strong>Z</strong> 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 (<code>hide_rect</code> / <code>hide_lasso symmetry=x</code>).</p>
-<p>SculptForge refuses a change that would hide everything, as ZBrush does. Every visibility change is one undo step, so <kbd>Ctrl</kbd>+<kbd>Z</kbd> brings back what you just hid.</p>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> the gestures are the same as ZBrush&#x27;s SelectRect and SelectLasso with polygroups. Grow and Shrink visibility and hiding by clicking with the rectangle brush are not available yet.</p></aside>
+<p>SculptForge refuses a change that would hide everything. Every visibility change is one undo step, so <kbd>Ctrl</kbd>+<kbd>Z</kbd> brings back what you just hid.</p>
<h3 id="the-visibility-sub-palette">The Visibility sub-palette<a class="anchor" href="#the-visibility-sub-palette" aria-label="Link to this section">#</a></h3>
<p>Open <strong>Tool &gt; Visibility</strong>:</p>
<div class="table-wrap"><table><thead><tr><th>Control</th><th>What it does</th><th>Command</th></tr></thead><tbody><tr><td><strong>Select Rectangle</strong> / <strong>Select Lasso</strong></td><td>The shape <kbd>Ctrl</kbd>+<kbd>Shift</kbd> + drag draws: a rectangle or a free-hand lasso.</td><td><code>hide_rect</code> / <code>hide_lasso</code></td></tr><tr><td><strong>Show all</strong></td><td>Show every hidden part again. Available when something is hidden.</td><td><code>show_all</code></td></tr><tr><td><strong>Invert visible</strong></td><td>Hide what is visible and show what is hidden.</td><td><code>invert_visibility</code></td></tr><tr><td><strong>Delete hidden</strong></td><td>Permanently remove the hidden triangles from the mesh. Undoable.</td><td><code>delete_hidden</code></td></tr></tbody></table></div>
@@ -138,7 +136,7 @@ Click <strong>Delete hidden</strong> in <strong>Tool &gt; Visibility</strong>.
<strong>Brushes and vertex paint</strong> skip hidden faces.
</li>
<li>
-<strong>Projects</strong> save face groups and what&#x27;s hidden; <strong>Send to ZBrush</strong> and <strong>OBJ</strong> carry face groups to and from ZBrush.
+<strong>Projects</strong> save face groups and what&#x27;s hidden; <strong>Bridge</strong> and <strong>OBJ</strong> carry face groups in and out.
</li>
<li>
Each Part has its own face groups and visibility. To show and hide whole Parts, use the eye icons and <strong>Solo</strong> in <strong>Tool &gt; Parts</strong>.
@@ -147,8 +145,8 @@ Each Part has its own face groups and visibility. To show and hide whole Parts,
<h2 id="face-groups-from-a-script">Face Groups from a script<a class="anchor" href="#face-groups-from-a-script" aria-label="Link to this section">#</a></h2>
<div class="table-wrap"><table><thead><tr><th>Command</th><th>Options</th></tr></thead><tbody><tr><td><code>polygroup_auto_by_normals</code></td><td><code>angle</code> (1-180 degrees, default 30)</td></tr><tr><td><code>polygroup_by_connectivity</code>, <code>polygroup_uv</code>, <code>polygroup_from_mask</code>, <code>polygroup_merge_visible</code>, <code>polygroup_clear</code></td><td></td></tr><tr><td><code>isolate_polygroup</code>, <code>hide_polygroup</code></td><td><code>group</code> (required): the face group id</td></tr><tr><td><code>show_all</code>, <code>invert_visibility</code>, <code>delete_hidden</code></td><td></td></tr><tr><td><code>hide_rect</code></td><td><code>x0 y0 x1 y1</code> (-1 to 1, y up), <code>inside</code>, optional <code>view_proj</code> matrix; without a view the rectangle spans the mesh seen from the front</td></tr><tr><td><code>hide_lasso</code></td><td><code>points</code> (required): the outline as <code>&quot;x0 y0 x1 y1 ...&quot;</code>, at least 3 points in the same -1 to 1 space; <code>inside</code>, <code>view_proj</code> as for <code>hide_rect</code></td></tr></tbody></table></div>
<p>When you isolate or hide a group in the viewport, the console (<kbd>`</kbd>) shows the command with the group&#x27;s id, for example <code>isolate_polygroup group=3</code>, which you can reuse in scripts.</p>
-<div class="code-block"><pre class="code"><code class="language-sh">sculptforge-cli -c &#x27;open path=robot.obj; polygroup_by_connectivity; subtool_split_groups; save_project path=robot.sfproj&#x27;</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
-<aside class="callout callout-not-yet"><p><strong>Not yet:</strong> a face group paint brush, Group Front, face groups from UV islands or PolyPaint, and face group-based crease edges are not available yet.</p></aside>
+<div class="code-block"><pre class="code"><code class="language-sh">sculptforge-cli -c &#x27;open path=robot.obj; face group_by_connectivity; part_split_groups; save_project path=robot.sfproj&#x27;</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
+<aside class="callout callout-not-yet"><p><strong>Not yet:</strong> 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></aside>
<h2 id="see-also">See also<a class="anchor" href="#see-also" aria-label="Link to this section">#</a></h2>
<ul>
<li>
@@ -183,8 +181,7 @@ Each Part has its own face groups and visibility. To show and hide whole Parts,
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/facial-shapes.html b/website/guide/facial-shapes.html
index 47bc2a62..d19f034d 100644
--- a/website/guide/facial-shapes.html
+++ b/website/guide/facial-shapes.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Facial shapes and live face - SculptForge User Guide">
<meta property="og:description" content="Generate Facial Shapes gives a sculpted head the 52 blend shapes Apple ARKit and Google&#x27;s MediaPipe use for face capture (eyeBlinkLeft, jawOpen, mouthSmileRight and the rest), fitted to that head&#x27;s own proportions. They are ordinary sculpt layers: you fix any of them by sculpting, test them with exp">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/facial-shapes.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html" class="current" aria-current="page">Facial shapes and live face</a><ul class="toc-sections"><li><a href="#what-you-need">What you need</a></li><li><a href="#generate-the-shapes">Generate the shapes</a></li><li><a href="#how-it-works">How it works</a></li><li><a href="#landmarks">Landmarks</a></li><li><a href="#parts">Parts</a></li><li><a href="#mouth-and-eyes-what-to-expect">Mouth and eyes: what to expect</a></li><li><a href="#fix-a-shape-by-sculpting">Fix a shape by sculpting</a></li><li><a href="#face-test">Face test</a></li><li><a href="#all-52-shapes">All 52 shapes</a></li><li><a href="#live-face">Live face</a></li><li><a href="#takes">Takes</a></li><li><a href="#export-the-shapes">Export the shapes</a></li><li><a href="#commands">Commands</a></li><li><a href="#subdivision-levels">Subdivision levels</a></li><li><a href="#memory">Memory</a></li><li><a href="#limits">Limits</a></li></ul></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html" class="current" aria-current="page">Facial shapes and live face</a><ul class="toc-sections"><li><a href="#what-you-need">What you need</a></li><li><a href="#generate-the-shapes">Generate the shapes</a></li><li><a href="#how-it-works">How it works</a></li><li><a href="#landmarks">Landmarks</a></li><li><a href="#parts">Parts</a></li><li><a href="#mouth-and-eyes-what-to-expect">Mouth and eyes: what to expect</a></li><li><a href="#fix-a-shape-by-sculpting">Fix a shape by sculpting</a></li><li><a href="#face-test">Face test</a></li><li><a href="#all-52-shapes">All 52 shapes</a></li><li><a href="#live-face">Live face</a></li><li><a href="#takes">Takes</a></li><li><a href="#export-the-shapes">Export the shapes</a></li><li><a href="#commands">Commands</a></li><li><a href="#subdivision-levels">Subdivision levels</a></li><li><a href="#memory">Memory</a></li><li><a href="#limits">Limits</a></li></ul></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -237,8 +237,7 @@ Landmarks are placed by hand or found by the fit itself; there is no image-based
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/fill-layers.html b/website/guide/fill-layers.html
index f9d37aa6..6f1fd342 100644
--- a/website/guide/fill-layers.html
+++ b/website/guide/fill-layers.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Fill layers, Mesh Maps and Material Recipes - SculptForge User Guide">
<meta property="og:description" content="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&#x27;s Mesh Maps (its ambient occlusion, curvature, thickness and more, ba">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/fill-layers.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html" class="current" aria-current="page">Fill layers, Mesh Maps and Material Recipes</a><ul class="toc-sections"><li><a href="#lay-a-material-recipe">Lay a Material Recipe</a></li><li><a href="#make-a-fill-layer">Make a Fill layer</a></li><li><a href="#mesh-maps">Mesh Maps</a></li><li><a href="#save-your-own-recipe">Save your own recipe</a></li><li><a href="#projects">Projects</a></li><li><a href="#commands">Commands</a></li></ul></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html" class="current" aria-current="page">Fill layers, Mesh Maps and Material Recipes</a><ul class="toc-sections"><li><a href="#lay-a-material-recipe">Lay a Material Recipe</a></li><li><a href="#make-a-fill-layer">Make a Fill layer</a></li><li><a href="#mesh-maps">Mesh Maps</a></li><li><a href="#save-your-own-recipe">Save your own recipe</a></li><li><a href="#projects">Projects</a></li><li><a href="#commands">Commands</a></li></ul></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -136,8 +136,7 @@ The recipe adds its Fill layers on top of your layers, turning on the material c
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/first-sculpt.html b/website/guide/first-sculpt.html
index f12c259a..87b19b2b 100644
--- a/website/guide/first-sculpt.html
+++ b/website/guide/first-sculpt.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Your first sculpt in 10 minutes - SculptForge User Guide">
<meta property="og:description" content="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, b">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/first-sculpt.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html" class="current" aria-current="page">Your first sculpt in 10 minutes</a><ul class="toc-sections"><li><a href="#1-start-with-a-sphere">1. Start with a sphere</a></li><li><a href="#2-pull-up-the-ear-tufts">2. Pull up the ear tufts</a></li><li><a href="#3-dig-the-face">3. Dig the face</a></li><li><a href="#4-shape-the-beak">4. Shape the beak</a></li><li><a href="#5-divide-three-times">5. Divide three times</a></li><li><a href="#6-add-the-eyes">6. Add the eyes</a></li><li><a href="#7-give-it-brows">7. Give it brows</a></li><li><a href="#8-colour-it-brown">8. Colour it brown</a></li><li><a href="#9-paint-the-face">9. Paint the face</a></li><li><a href="#10-paint-the-eyes">10. Paint the eyes</a></li><li><a href="#11-paint-the-beak-and-tufts">11. Paint the beak and tufts</a></li><li><a href="#12-shade-it-and-save-a-render">12. Shade it and save a render</a></li><li><a href="#whats-next">What&#x27;s next</a></li></ul></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html" class="current" aria-current="page">Your first sculpt in 10 minutes</a><ul class="toc-sections"><li><a href="#1-start-with-a-sphere">1. Start with a sphere</a></li><li><a href="#2-pull-up-the-ear-tufts">2. Pull up the ear tufts</a></li><li><a href="#3-dig-the-face">3. Dig the face</a></li><li><a href="#4-shape-the-beak">4. Shape the beak</a></li><li><a href="#5-divide-three-times">5. Divide three times</a></li><li><a href="#6-add-the-eyes">6. Add the eyes</a></li><li><a href="#7-give-it-brows">7. Give it brows</a></li><li><a href="#8-colour-it-brown">8. Colour it brown</a></li><li><a href="#9-paint-the-face">9. Paint the face</a></li><li><a href="#10-paint-the-eyes">10. Paint the eyes</a></li><li><a href="#11-paint-the-beak-and-tufts">11. Paint the beak and tufts</a></li><li><a href="#12-shade-it-and-save-a-render">12. Shade it and save a render</a></li><li><a href="#whats-next">What&#x27;s next</a></li></ul></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -54,7 +54,7 @@
<h1 id="your-first-sculpt-in-10-minutes">Your first sculpt in 10 minutes</h1>
<p>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.</p>
<figure class="shot"><a href="images/first-sculpt/12-render.jpg" class="zoom"><img src="images/first-sculpt/12-render.jpg" alt="The finished owl" width="960" height="1171" loading="lazy" decoding="async"></a><figcaption>The finished owl</figcaption></figure>
-<p>The lesson uses the default look: the <strong>SculptForge layout</strong>, with the menus <strong>File, Edit, Sculpt, Paint, Mesh, View, Render, Help</strong> along the top, a tool shelf under them, the brushes along the bottom and the <strong>Tool</strong> panel on the right. If you switched to the <strong>ZBrush-style layout</strong>, the <strong>ZBrush-style layout</strong> notes say where things are there. Every step can be undone with <kbd>Ctrl</kbd>+<kbd>Z</kbd>, so experiment freely.</p>
+<p>The lesson uses the default look: the <strong>SculptForge layout</strong>, with the menus <strong>File, Edit, Sculpt, Paint, Mesh, View, Render, Help</strong> along the top, a tool shelf under them, the brushes along the bottom and the <strong>Tool</strong> panel on the right. If you switched to the <strong>Classic layout</strong>, the <strong>Classic layout</strong> notes say where things are there. Every step can be undone with <kbd>Ctrl</kbd>+<kbd>Z</kbd>, so experiment freely.</p>
<p>Each brush remembers its own size. To set it, hold the cursor over the canvas, press <kbd>S</kbd>, type the number the step gives and press <kbd>Enter</kbd> (or drag the slider that appears). <kbd>[</kbd> and <kbd>]</kbd> make it smaller and bigger.</p>
<aside class="callout callout-tip"><p><strong>Tip:</strong> <strong>Help &gt; Your first sculpt (10 min)</strong> opens this lesson inside SculptForge any time; <kbd>Shift</kbd>+<kbd>F1</kbd> hides it and shows it again where you left off.</p></aside>
<h2 id="1-start-with-a-sphere">1. Start with a sphere<a class="anchor" href="#1-start-with-a-sphere" aria-label="Link to this section">#</a></h2>
@@ -152,7 +152,6 @@ Open <strong>Paint</strong>. In <strong>Vertex Paint &amp; Color</strong>, pick
</li>
</ol>
<figure class="shot"><a href="images/first-sculpt/08-fill.jpg" class="zoom"><img src="images/first-sculpt/08-fill.jpg" alt="The owl filled brown" width="720" height="458" loading="lazy" decoding="async"></a><figcaption>The owl filled brown</figcaption></figure>
-<aside class="callout callout-note"><p><strong>ZBrush-style layout:</strong> the colour controls are in the <strong>Color</strong> palette on the palette bar.</p></aside>
<h2 id="9-paint-the-face">9. Paint the face<a class="anchor" href="#9-paint-the-face" aria-label="Link to this section">#</a></h2>
<p><strong>Goal:</strong> soft cream face discs.</p>
<ol>
@@ -220,7 +219,6 @@ Press <kbd>Ctrl</kbd>+<kbd>S</kbd> to save the project.
</li>
</ol>
<figure class="shot"><a href="images/first-sculpt/12-material.jpg" class="zoom"><img src="images/first-sculpt/12-material.jpg" alt="Render &gt; Materials with PBR shading and Save Render" width="960" height="682" loading="lazy" decoding="async"></a><figcaption>Render &gt; Materials with PBR shading and Save Render</figcaption></figure>
-<aside class="callout callout-note"><p><strong>ZBrush-style layout:</strong> <strong>PBR</strong> and <strong>Save Render</strong> are in the <strong>Material</strong> palette.</p></aside>
<p>Well done: that&#x27;s a sculpt, painted and rendered.</p>
<h2 id="whats-next">What&#x27;s next<a class="anchor" href="#whats-next" aria-label="Link to this section">#</a></h2>
<ul>
@@ -262,8 +260,7 @@ Find your way around the menus and shelves: <a href="interface.html">The interfa
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/forge-spheres.html b/website/guide/forge-spheres.html
index 80dc6ee1..4df95185 100644
--- a/website/guide/forge-spheres.html
+++ b/website/guide/forge-spheres.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Forge Spheres - SculptForge User Guide</title>
- <meta name="description" content="Forge Spheres (ZBrush users: ZSpheres) 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 quickes">
+ <meta name="description" content="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 ">
<meta name="theme-color" content="#111114">
<meta name="color-scheme" content="dark">
<link rel="icon" type="image/svg+xml" href="../img/favicon.svg?v=2">
@@ -13,8 +13,8 @@
<link rel="canonical" href="https://sculptforge.app/guide/forge-spheres.html">
<meta property="og:type" content="article">
<meta property="og:title" content="Forge Spheres - SculptForge User Guide">
- <meta property="og:description" content="Forge Spheres (ZBrush users: ZSpheres) 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 quickes">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:description" content="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 ">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/forge-spheres.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,14 +46,13 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html" class="current" aria-current="page">Forge Spheres</a><ul class="toc-sections"><li><a href="#make-a-forge-sphere-part">Make a Forge Sphere Part</a></li><li><a href="#edit-the-spheres">Edit the spheres</a></li><li><a href="#pointer-only">Pointer only</a></li><li><a href="#preview-the-skin">Preview the skin</a></li><li><a href="#make-mesh">Make Mesh</a></li><li><a href="#scripting">Scripting</a></li></ul></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html" class="current" aria-current="page">Forge Spheres</a><ul class="toc-sections"><li><a href="#make-a-forge-sphere-part">Make a Forge Sphere Part</a></li><li><a href="#edit-the-spheres">Edit the spheres</a></li><li><a href="#pointer-only">Pointer only</a></li><li><a href="#preview-the-skin">Preview the skin</a></li><li><a href="#make-mesh">Make Mesh</a></li><li><a href="#scripting">Scripting</a></li></ul></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
<article class="guide-article">
<h1 id="forge-spheres">Forge Spheres</h1>
-<p>Forge Spheres (ZBrush users: ZSpheres) 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>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> this works like ZBrush&#x27;s ZSpheres with Adaptive Skin: Draw, Move and Scale on the spheres, Alt+click to delete, <strong>A</strong> to preview the skin, and <strong>Make Mesh</strong> in place of Make Adaptive Skin. Rotate mode, ZSketch, the Topology and Rigging uses of ZSpheres and the link-sphere (magnet) tricks are not there.</p></aside>
+<p>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>
<h2 id="make-a-forge-sphere-part">Make a Forge Sphere Part<a class="anchor" href="#make-a-forge-sphere-part" aria-label="Link to this section">#</a></h2>
<p><strong>Tool &gt; Forge Spheres &gt; New Forge Sphere</strong> 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.</p>
<p>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>
@@ -123,8 +122,7 @@ zsphere_make_mesh resolution=160</code></pre><button class="copy" type="button"
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/generate-3d.html b/website/guide/generate-3d.html
index 75527201..cf06784c 100644
--- a/website/guide/generate-3d.html
+++ b/website/guide/generate-3d.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Image and text to 3D - SculptForge User Guide">
<meta property="og:description" content="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)">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/generate-3d.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html" class="current" aria-current="page">Image and text to 3D</a><ul class="toc-sections"><li><a href="#how-it-works">How it works</a></li><li><a href="#open-the-generate-3d-window">Open the Generate 3D window</a></li><li><a href="#generate-from-an-image">Generate from an image</a></li><li><a href="#generate-from-text">Generate from text</a></li><li><a href="#services">Services</a></li><li><a href="#save-your-settings">Save your settings</a></li><li><a href="#quick-shapes-from-an-image-offline">Quick shapes from an image (offline)</a></li><li><a href="#after-generating">After generating</a></li><li><a href="#from-scripts-and-agents">From scripts and agents</a></li><li><a href="#privacy-and-model-licences">Privacy and model licences</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html" class="current" aria-current="page">Image and text to 3D</a><ul class="toc-sections"><li><a href="#how-it-works">How it works</a></li><li><a href="#open-the-generate-3d-window">Open the Generate 3D window</a></li><li><a href="#generate-from-an-image">Generate from an image</a></li><li><a href="#generate-from-text">Generate from text</a></li><li><a href="#services">Services</a></li><li><a href="#save-your-settings">Save your settings</a></li><li><a href="#quick-shapes-from-an-image-offline">Quick shapes from an image (offline)</a></li><li><a href="#after-generating">After generating</a></li><li><a href="#from-scripts-and-agents">From scripts and agents</a></li><li><a href="#privacy-and-model-licences">Privacy and model licences</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -67,7 +67,6 @@ SculptForge opens the result as a new scene and, unless you choose otherwise, <s
</li>
</ol>
<p>Nothing leaves your computer until you choose a hosted service and press <strong>Generate 3D model</strong>. For exactly what is sent where, see <a href="#privacy-and-model-licences">AI services and privacy</a> below.</p>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> ZBrush has no built-in image-to-3D. The closest workflow is blocking out a base mesh by hand with DynaMesh or Forge Spheres; here you get a starting shape in seconds and refine it with the usual brushes.</p></aside>
<h2 id="open-the-generate-3d-window">Open the Generate 3D window<a class="anchor" href="#open-the-generate-3d-window" aria-label="Link to this section">#</a></h2>
<p>Any of these opens it:</p>
<ul>
@@ -309,8 +308,7 @@ With ComfyUI, the picture goes only to the server address you entered.
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/geometry.html b/website/guide/geometry.html
index 64f1f88b..a25d40a5 100644
--- a/website/guide/geometry.html
+++ b/website/guide/geometry.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Subdivide, remesh, decimate and LODs - SculptForge User Guide">
<meta property="og:description" content="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.">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/geometry.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html" class="current" aria-current="page">Subdivide, remesh, decimate and LODs</a><ul class="toc-sections"><li><a href="#at-a-glance">At a glance</a></li><li><a href="#quads-and-triangles">Quads and triangles</a></li><li><a href="#subdivide">Subdivide</a></li><li><a href="#voxel-remesh">Voxel remesh</a></li><li><a href="#quad-remesh">Quad Remesh</a></li><li><a href="#close-holes">Close Holes</a></li><li><a href="#decimate">Decimate</a></li><li><a href="#mirror-and-weld">Mirror And Weld</a></li><li><a href="#mirror">Mirror</a></li><li><a href="#lod-chains">LOD chains</a></li><li><a href="#undo-and-safety">Undo and safety</a></li><li><a href="#scripting">Scripting</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html" class="current" aria-current="page">Subdivide, remesh, decimate and LODs</a><ul class="toc-sections"><li><a href="#at-a-glance">At a glance</a></li><li><a href="#quads-and-triangles">Quads and triangles</a></li><li><a href="#subdivide">Subdivide</a></li><li><a href="#voxel-remesh">Voxel remesh</a></li><li><a href="#quad-remesh">Quad Remesh</a></li><li><a href="#close-holes">Close Holes</a></li><li><a href="#decimate">Decimate</a></li><li><a href="#mirror-and-weld">Mirror And Weld</a></li><li><a href="#mirror">Mirror</a></li><li><a href="#lod-chains">LOD chains</a></li><li><a href="#undo-and-safety">Undo and safety</a></li><li><a href="#scripting">Scripting</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -57,7 +57,7 @@
<h2 id="at-a-glance">At a glance<a class="anchor" href="#at-a-glance" aria-label="Link to this section">#</a></h2>
<div class="table-wrap"><table><thead><tr><th>Tool</th><th>Where</th><th>Triangles</th><th>Quads</th><th>Keeps sculpt layers</th><th>Keeps mask and vertex paint</th><th>Keeps face groups, hidden faces, UVs</th></tr></thead><tbody><tr><td>Divide (levels)</td><td><strong>Tool &gt; Geometry &gt; Divide</strong>, <kbd>Ctrl</kbd>+<kbd>D</kbd></td><td>x4 per level, lower levels kept</td><td>Each quad becomes four (Catmull-Clark)</td><td>Yes</td><td>Yes (interpolated)</td><td>Yes</td></tr><tr><td>Subdivide</td><td><strong>Tool &gt; Geometry &gt; Subdivide</strong></td><td>x4 per level</td><td>Each quad becomes four</td><td>Yes</td><td>Yes (interpolated)</td><td>Yes</td></tr><tr><td>Voxel Remesh</td><td><strong>Tool &gt; Remesh &gt; Voxel Remesh</strong></td><td>Set by resolution</td><td>All quads (new ones)</td><td>Baked in</td><td>Yes (transferred)</td><td>No (reset); a texture is kept on new UVs with Keep Texture</td></tr><tr><td>Quad Remesh</td><td><strong>Tool &gt; Geometry &gt; Quad Remesh</strong></td><td>Set by Target Polygons</td><td>All quads, with edge loops</td><td>Baked in</td><td>Yes (transferred)</td><td>Face Groups with Keep Groups; no hidden faces; a texture is kept on new UVs with Keep Texture</td></tr><tr><td>Decimate</td><td><strong>Tool &gt; Geometry &gt; Decimate</strong></td><td>Reduced</td><td>No, all triangles</td><td>Yes</td><td>Yes</td><td>Yes</td></tr><tr><td>Mirror And Weld</td><td><strong>Tool &gt; Geometry &gt; Modify Topology</strong></td><td>Twice the kept side</td><td>Yes</td><td>Yes</td><td>Yes (mirrored)</td><td>Yes (mirrored)</td></tr><tr><td>LOD chain</td><td><strong>Tool &gt; Export</strong></td><td>One level per ratio step</td><td>LOD0 keeps them; lower levels are triangles</td><td>Yes, on every level</td><td>Yes</td><td>Yes</td></tr></tbody></table></div>
<h2 id="quads-and-triangles">Quads and triangles<a class="anchor" href="#quads-and-triangles" aria-label="Link to this section">#</a></h2>
-<p>SculptForge sculpts on triangles, but it remembers which pairs of triangles were one quad. A model you open from ZBrush (Send to ZBrush), Blender or Maya (OBJ, FBX, PLY, USD) keeps its quads: <strong>Wire</strong> draws them as quads, without the diagonal, and OBJ, FBX, PLY, USD and GoZ-compatible exports write them back as quads, corner for corner. Polygons with more than four sides are split into triangles. The new <strong>Plane</strong> and <strong>Cube</strong> are made of quads, and so is the result of a voxel remesh.</p>
+<p>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: <strong>Wire</strong> 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 <strong>Plane</strong> and <strong>Cube</strong> are made of quads, and so is the result of a voxel remesh.</p>
<p>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:</p>
<ul>
<li>
@@ -68,10 +68,9 @@ When the two halves of a quad end up in different face groups, or one half is de
</li>
</ul>
<p>glTF (<code>.glb</code>) and STL only hold triangles, so those exports always write triangles.</p>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> Besides keeping the quads you bring in, SculptForge can make new ones from any mesh: <strong>Quad Remesh</strong> (like ZRemesher) builds quads with flowing edge loops. See <a href="retopology.html">Quad retopology</a>.</p></aside>
<h2 id="subdivide">Subdivide<a class="anchor" href="#subdivide" aria-label="Link to this section">#</a></h2>
<p>For sculpting at several resolutions use <strong>Divide</strong> (<kbd>Ctrl</kbd>+<kbd>D</kbd>), which keeps the lower levels to step back to: see <a href="subdivision-levels.html">Subdivision levels</a>. <strong>Subdivide</strong> is the one-way version.</p>
-<p><strong>Tool &gt; Geometry &gt; Subdivide</strong> smooths the mesh with Loop subdivision. Each level multiplies the triangle count by four and rounds off the shape slightly, like ZBrush&#x27;s Divide with Smt on.</p>
+<p><strong>Tool &gt; Geometry &gt; Subdivide</strong> smooths the mesh with Loop subdivision. Each level multiplies the triangle count by four and rounds off the shape slightly.</p>
<ul>
<li>
Sculpt layers are subdivided with the mesh, so blend shapes keep working.
@@ -89,7 +88,7 @@ SculptForge refuses to subdivide past 50 million triangles.
<aside class="callout callout-note"><p><strong>Note:</strong> Subdivide replaces the mesh with a denser one and drops any <a href="subdivision-levels.html">subdivision levels</a>: 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 <a href="dynamic-topology.html">Dynamic topology</a>.</p></aside>
<aside class="callout callout-tip"><p><strong>Tip:</strong> 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></aside>
<h2 id="voxel-remesh">Voxel remesh<a class="anchor" href="#voxel-remesh" aria-label="Link to this section">#</a></h2>
-<p><strong>Tool &gt; Remesh &gt; Voxel Remesh</strong> rebuilds the active Part as an even, watertight surface, like ZBrush&#x27;s DynaMesh. Use it to:</p>
+<p><strong>Tool &gt; Remesh &gt; Voxel Remesh</strong> rebuilds the active Part as an even, watertight surface. Use it to:</p>
<ul>
<li>
fuse overlapping pieces into one surface (append a sphere, overlap it, merge, remesh);
@@ -128,13 +127,12 @@ The new surface is made of even quads (the original&#x27;s quads are rebuilt, no
</li>
</ul>
<p>To remesh several Parts into one, first combine them with <strong>Merge visible...</strong> or <strong>Merge down...</strong> in <a href="parts.html#merge-parts">Parts</a>.</p>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> There is no Project option, Groups-aware remesh or Blur slider yet. Like ZBrush&#x27;s DynaMesh, the remesh produces an even grid of quads, not flowing edge loops. For quads with edge loops that follow the forms, use <a href="retopology.html">Quad Remesh</a> (like ZRemesher), and Project All to get the detail back.</p></aside>
<h2 id="quad-remesh">Quad Remesh<a class="anchor" href="#quad-remesh" aria-label="Link to this section">#</a></h2>
-<p><strong>Tool &gt; Geometry &gt; Quad Remesh</strong> is automatic quad retopology, like ZBrush&#x27;s ZRemesher: 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. <strong>Project All</strong> (<strong>Tool &gt; Parts &gt; Project</strong>) brings the sculpted detail back onto the new topology after you divide it. Both have their own chapter: <a href="retopology.html">Quad retopology and detail projection</a>.</p>
+<p><strong>Tool &gt; Geometry &gt; Quad Remesh</strong> 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. <strong>Project All</strong> (<strong>Tool &gt; Parts &gt; Project</strong>) brings the sculpted detail back onto the new topology after you divide it. Both have their own chapter: <a href="retopology.html">Quad retopology and detail projection</a>.</p>
<h2 id="close-holes">Close Holes<a class="anchor" href="#close-holes" aria-label="Link to this section">#</a></h2>
<p><strong>Tool &gt; Geometry &gt; Close Holes</strong> 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&#x27;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 <a href="face-groups.html">face group</a> 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. <kbd>Ctrl</kbd>+<kbd>Z</kbd> brings the holes back.</p>
<h2 id="decimate">Decimate<a class="anchor" href="#decimate" aria-label="Link to this section">#</a></h2>
-<p><strong>Tool &gt; Geometry &gt; Decimate</strong> reduces the triangle count while keeping the shape, using quadric edge collapse (the same family of algorithm as ZBrush&#x27;s Decimation Master). The <strong>Keep</strong> slider next to the button sets the fraction of triangles to keep (0.05 to 0.95, default 0.50).</p>
+<p><strong>Tool &gt; Geometry &gt; Decimate</strong> reduces the triangle count while keeping the shape, using quadric edge collapse. The <strong>Keep</strong> slider next to the button sets the fraction of triangles to keep (0.05 to 0.95, default 0.50).</p>
<p>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.</p>
<p>With <strong>Keep Masked</strong> (under the button, off by default) masked vertices are never removed, so masked areas keep their triangles exactly and only the rest is decimated (<code>decimate keep_masked=true</code>).</p>
<p>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.</p>
@@ -244,8 +242,7 @@ Click <strong>Generate LOD chain</strong>.
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/gizmo.html b/website/guide/gizmo.html
index 31bb67c4..7899f232 100644
--- a/website/guide/gizmo.html
+++ b/website/guide/gizmo.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Moving, rotating and posing (Gizmo) - SculptForge User Guide</title>
- <meta name="description" content="The Gizmo moves, rotates and scales a whole Part, or only the part of it you haven&#x27;t masked. Use it to place parts (an eye in its socket, a sword in a hand), to fix proportions, and to pose: mask the body, put the pivot at the shoulder and swing the arm. It works like ZBrush&#x27;s Gizmo 3D, with the sam">
+ <meta name="description" content="The Gizmo moves, rotates and scales a whole Part, or only the part of it you haven&#x27;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.">
<meta name="theme-color" content="#111114">
<meta name="color-scheme" content="dark">
<link rel="icon" type="image/svg+xml" href="../img/favicon.svg?v=2">
@@ -13,8 +13,8 @@
<link rel="canonical" href="https://sculptforge.app/guide/gizmo.html">
<meta property="og:type" content="article">
<meta property="og:title" content="Moving, rotating and posing (Gizmo) - SculptForge User Guide">
- <meta property="og:description" content="The Gizmo moves, rotates and scales a whole Part, or only the part of it you haven&#x27;t masked. Use it to place parts (an eye in its socket, a sword in a hand), to fix proportions, and to pose: mask the body, put the pivot at the shoulder and swing the arm. It works like ZBrush&#x27;s Gizmo 3D, with the sam">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:description" content="The Gizmo moves, rotates and scales a whole Part, or only the part of it you haven&#x27;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.">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/gizmo.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,13 +46,13 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html" class="current" aria-current="page">Moving, rotating and posing (Gizmo)</a><ul class="toc-sections"><li><a href="#the-three-modes">The three modes</a></li><li><a href="#moving-only-part-of-a-part">Moving only part of a Part</a></li><li><a href="#posing-a-limb">Posing a limb</a></li><li><a href="#the-pivot">The pivot</a></li><li><a href="#typing-exact-values">Typing exact values</a></li><li><a href="#all-parts">All Parts</a></li><li><a href="#what-a-transform-keeps">What a transform keeps</a></li><li><a href="#scripting">Scripting</a></li><li><a href="#speed">Speed</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html" class="current" aria-current="page">Moving, rotating and posing (Gizmo)</a><ul class="toc-sections"><li><a href="#the-three-modes">The three modes</a></li><li><a href="#moving-only-part-of-a-part">Moving only part of a Part</a></li><li><a href="#posing-a-limb">Posing a limb</a></li><li><a href="#the-pivot">The pivot</a></li><li><a href="#typing-exact-values">Typing exact values</a></li><li><a href="#all-parts">All Parts</a></li><li><a href="#what-a-transform-keeps">What a transform keeps</a></li><li><a href="#scripting">Scripting</a></li><li><a href="#speed">Speed</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
<article class="guide-article">
<h1 id="moving-rotating-and-posing-gizmo">Moving, rotating and posing (Gizmo)</h1>
-<p>The Gizmo moves, rotates and scales a whole Part, or only the part of it you haven&#x27;t masked. Use it to place parts (an eye in its socket, a sword in a hand), to fix proportions, and to pose: mask the body, put the pivot at the shoulder and swing the arm. It works like ZBrush&#x27;s Gizmo 3D, with the same keys.</p>
+<p>The Gizmo moves, rotates and scales a whole Part, or only the part of it you haven&#x27;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.</p>
<figure class="shot"><a href="images/gizmo-modes.jpg" class="zoom"><img src="images/gizmo-modes.jpg" alt="The Gizmo&#x27;s Move, Scale and Rotate modes; the handle under the cursor turns yellow" width="1096" height="330" loading="lazy" decoding="async"></a><figcaption>The Gizmo&#x27;s Move, Scale and Rotate modes; the handle under the cursor turns yellow</figcaption></figure>
<h2 id="the-three-modes">The three modes<a class="anchor" href="#the-three-modes" aria-label="Link to this section">#</a></h2>
<p>Press a key, or click the button on the top shelf (they&#x27;re also in <strong>Sculpt &gt; Symmetry &amp; Gizmo</strong>):</p>
@@ -107,7 +107,7 @@ Drag a ring. Release, then drag again to refine; each drag is its own undo step.
<h2 id="typing-exact-values">Typing exact values<a class="anchor" href="#typing-exact-values" aria-label="Link to this section">#</a></h2>
<p>The <strong>Gizmo</strong> panel opens in the corner of the canvas while the gizmo is on. Under the options it has <strong>Move</strong> (X, Y, Z), <strong>Rotate</strong> (degrees about X, then Y, then Z) and <strong>Scale</strong> (percent). Type the amounts and click <strong>Apply</strong>: the model moves, turns and scales by them about the pivot, along the gizmo&#x27;s axes, in one undo step. <strong>Clear</strong> 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>
<h2 id="all-parts">All Parts<a class="anchor" href="#all-parts" aria-label="Link to this section">#</a></h2>
-<p>Turn on <strong>All Parts</strong> in the panel to move every visible Part together (ZBrush&#x27;s Transpose All), for example to turn a whole character with its eyes, teeth and clothes. The pivot is the centre of all of them. Each Part gets its own undo step: undo goes back in the active Part, and selecting another Part undoes its part.</p>
+<p>Turn on <strong>All Parts</strong> 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.</p>
<h2 id="what-a-transform-keeps">What a transform keeps<a class="anchor" href="#what-a-transform-keeps" aria-label="Link to this section">#</a></h2>
<p>A transform only changes where the vertices are. Face Groups, quads, UVs, vertex paint, textures, the mask and the topology stay as they are. <a href="layers.html">Sculpt layers</a> move with the surface: the base and every layer&#x27;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 href="subdivision-levels.html">subdivision levels</a> 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&#x27;s pivot and options too.</p>
<h2 id="scripting">Scripting<a class="anchor" href="#scripting" aria-label="Link to this section">#</a></h2>
@@ -155,8 +155,7 @@ transform scale=2 all=true</code></pre><button class="copy" type="button" aria-l
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/glossary.html b/website/guide/glossary.html
index dda49fc1..857c6228 100644
--- a/website/guide/glossary.html
+++ b/website/guide/glossary.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Glossary - SculptForge User Guide</title>
- <meta name="description" content="This chapter maps ZBrush terms to their SculptForge equivalents, so you can find a familiar tool quickly, and explains the terms that only SculptForge uses. Features use SculptForge&#x27;s own names (Parts, Forge Spheres, Vertex Paint, Library...); the short list is in Coming from ZBrush, and the command">
+ <meta name="description" content="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 &quot;remesh&quot;, &quot;groups&quot; or &quot;folders&quot;. See also the Quick tour for experienced sculptors.">
<meta name="theme-color" content="#111114">
<meta name="color-scheme" content="dark">
<link rel="icon" type="image/svg+xml" href="../img/favicon.svg?v=2">
@@ -13,8 +13,8 @@
<link rel="canonical" href="https://sculptforge.app/guide/glossary.html">
<meta property="og:type" content="article">
<meta property="og:title" content="Glossary - SculptForge User Guide">
- <meta property="og:description" content="This chapter maps ZBrush terms to their SculptForge equivalents, so you can find a familiar tool quickly, and explains the terms that only SculptForge uses. Features use SculptForge&#x27;s own names (Parts, Forge Spheres, Vertex Paint, Library...); the short list is in Coming from ZBrush, and the command">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:description" content="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 &quot;remesh&quot;, &quot;groups&quot; or &quot;folders&quot;. See also the Quick tour for experienced sculptors.">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/glossary.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,17 +46,15 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html" class="current" aria-current="page">Glossary</a><ul class="toc-sections"><li><a href="#zbrush-terms-in-sculptforge">ZBrush terms in SculptForge</a></li><li><a href="#sculptforge-terms">SculptForge terms</a></li><li><a href="#see-also">See also</a></li></ul></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html" class="current" aria-current="page">Glossary</a><ul class="toc-sections"><li><a href="#sculptforge-terms">SculptForge terms</a></li><li><a href="#see-also">See also</a></li></ul></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
<article class="guide-article">
<h1 id="glossary">Glossary</h1>
-<p>This chapter maps ZBrush terms to their SculptForge equivalents, so you can find a familiar tool quickly, and explains the terms that only SculptForge uses. Features use SculptForge&#x27;s own names (Parts, Forge Spheres, Vertex Paint, Library...); the short list is in <a href="coming-from-zbrush.html#zbrush-terms-in-sculptforge">Coming from ZBrush</a>, and the command palette (<kbd>F3</kbd>) finds every feature by its ZBrush name too. &quot;Not yet&quot; means SculptForge doesn&#x27;t have it today; see the roadmap for what is planned.</p>
-<h2 id="zbrush-terms-in-sculptforge">ZBrush terms in SculptForge<a class="anchor" href="#zbrush-terms-in-sculptforge" aria-label="Link to this section">#</a></h2>
-<div class="table-wrap"><table><thead><tr><th>ZBrush</th><th>SculptForge</th></tr></thead><tbody><tr><td>Alpha</td><td><strong>Alpha</strong>: built-in round, square and noise, or any grayscale image. Left shelf, <strong>Sculpt &gt; Alpha</strong>. See <a href="sculpting.html">Sculpting</a></td></tr><tr><td>Auto Groups</td><td><strong>Tool &gt; Face Groups &gt; By pieces</strong> (<code>polygroup_by_connectivity</code>)</td></tr><tr><td>BPR render</td><td>Not yet as a renderer. Headless renders and turntables with <code>sculptforge --render</code> (<a href="scripting.html">Scripting</a>)</td></tr><tr><td>Brush pop-up (B)</td><td><strong>Brush picker</strong>, <kbd>B</kbd>, then type letters (B S T = Standard)</td></tr><tr><td>Clip brushes</td><td>Not yet. The <strong>Trim</strong> brush shaves to a plane</td></tr><tr><td>Curve brushes, IMM, ZModeler</td><td>Not yet</td></tr><tr><td>Decimation Master</td><td><strong>Tool &gt; Geometry &gt; Decimate</strong> (<code>decimate</code>). See <a href="geometry.html#decimate">Geometry</a></td></tr><tr><td>Del Hidden</td><td><strong>Tool &gt; Visibility &gt; Delete hidden</strong> (<code>delete_hidden</code>)</td></tr><tr><td>Del Lower, Del Higher</td><td><strong>Tool &gt; Geometry &gt; Del Lower / Del Higher</strong> (<code>subdiv_delete_lower</code>, <code>subdiv_delete_higher</code>). See <a href="subdivision-levels.html">Subdivision levels</a></td></tr><tr><td>Divide (Ctrl+D), Smt</td><td><strong>Tool &gt; Geometry &gt; Divide</strong>, <kbd>Ctrl</kbd>+<kbd>D</kbd>, with <strong>Smt</strong> beside it (<code>subdiv_divide</code>). See <a href="subdivision-levels.html">Subdivision levels</a></td></tr><tr><td>Document, 2.5D canvas, pixols</td><td>Not planned: SculptForge is a 3D sculpting app only</td></tr><tr><td>Draw Size</td><td><strong>Draw Size</strong> (top shelf, <kbd>S</kbd>, <kbd>[</kbd> / <kbd>]</kbd>)</td></tr><tr><td>DynaMesh</td><td><strong>Voxel Remesh</strong> (<strong>Tool &gt; Remesh</strong>, <code>remesh</code>). See <a href="geometry.html#voxel-remesh">Geometry</a></td></tr><tr><td>Extract (Tool &gt; SubTool &gt; Extract)</td><td><strong>Tool &gt; Parts &gt; Extract</strong>: the masked part becomes a shell Part, with <strong>Thick</strong>, <strong>E Smt</strong> and <strong>Double</strong>; <strong>Extract</strong> previews, <strong>Accept</strong> keeps it (<code>extract</code>, <code>extract_accept</code>). See <a href="parts.html#extract-a-shell">Parts</a></td></tr><tr><td>Focal Shift</td><td>No slider for the built-in brushes. Custom brushes have <strong>Hardness</strong> and <strong>Tip sharpness</strong> in their recipe</td></tr><tr><td>Ghost, Transp</td><td>Not yet. Inactive Parts are drawn slightly dimmed</td></tr><tr><td>GoZ</td><td><strong>Send to ZBrush</strong> (GoZ-compatible): send to and receive from ZBrush, and import or export GoZ-compatible files (<strong>File &gt; Send to ZBrush</strong>). See <a href="exporting.html#exchange-models-with-zbrush-send-to-zbrush">Exporting</a></td></tr><tr><td>Group Masked</td><td><strong>Tool &gt; Face Groups &gt; From mask</strong> (<code>polygroup_from_mask</code>)</td></tr><tr><td>Group Visible</td><td><strong>Tool &gt; Face Groups &gt; Merge visible</strong> (<code>polygroup_merge_visible</code>)</td></tr><tr><td>Groups By Normals</td><td><strong>Tool &gt; Face Groups &gt; By normals</strong> with an angle (<code>polygroup_auto_by_normals</code>)</td></tr><tr><td>Bake, Multi Map Exporter (normal / displacement / AO maps)</td><td><strong>Tool &gt; Bake</strong> (<code>bake</code>): tangent and object-space normal, displacement, AO, cavity and colour maps from a high-poly Part onto a low-poly&#x27;s UVs. See <a href="baking.html">Baking</a></td></tr><tr><td>Layers (sculpt layers)</td><td><strong>Tool &gt; Layers</strong>: sculpt layers with weights, exported as blend shapes. See <a href="layers.html">Layers</a></td></tr><tr><td>LazyMouse</td><td><strong>Steady Stroke</strong> (<kbd>L</kbd>, every stroke type) and the <strong>Lazy Stroke</strong> stroke type</td></tr><tr><td>LightBox</td><td><strong>Library</strong>, <kbd>,</kbd> (comma)</td></tr><tr><td>Live Boolean</td><td>Not yet</td></tr><tr><td>Local symmetry, radial symmetry</td><td><strong>Sculpt &gt; Symmetry &amp; Gizmo &gt; Symmetry</strong>: <strong>R</strong> (radial symmetry, Radial Count 2-64 around X, Y or Z, combined with the X / Y / Z mirrors) and <strong>Local</strong> (about the active Part&#x27;s centre). See <a href="sculpting.html#radial-symmetry">Sculpting</a></td></tr><tr><td>Mask by Cavity</td><td><strong>Tool &gt; Masking &gt; By cavity</strong> (<code>mask_by_cavity</code>)</td></tr><tr><td>Masking (Ctrl)</td><td>Hold <kbd>Ctrl</kbd> to paint the mask, <kbd>Ctrl</kbd>+<kbd>Alt</kbd> to erase. See <a href="masking.html">Masking</a></td></tr><tr><td>MaskLasso, MaskRect</td><td><strong>Tool &gt; Masking</strong>: pick the shape, then <kbd>Ctrl</kbd>+drag (add <kbd>Alt</kbd> to unmask). See <a href="masking.html">Masking</a></td></tr><tr><td>MatCap</td><td><strong>Material</strong>: the built-in Lit Spheres, Soft Clay the default, plus Studio (<kbd>M</kbd>), and your own with <strong>Load Lit Sphere...</strong> (<code>load_matcap</code>). See <a href="vertex-paint.html">Vertex Paint</a></td></tr><tr><td>Mirror (Tool &gt; Deformation)</td><td><strong>Tool &gt; Deformation &gt; Mirror</strong> with X Y Z (<code>mirror</code>): flips the Part across the plane through the origin. See <a href="geometry.html#mirror">Geometry</a></td></tr><tr><td>Mirror And Weld</td><td><strong>Tool &gt; Geometry &gt; Modify Topology &gt; Mirror And Weld</strong> with X Y Z (<code>mirror_and_weld</code>): the + side mirrored onto the - side and welded into one watertight mesh, keeping face groups and vertex paint. See <a href="geometry.html#mirror-and-weld">Geometry</a></td></tr><tr><td>Morph target</td><td>A <a href="layers.html">sculpt layer</a>; exported as glTF morph targets and FBX/USD blend shapes</td></tr><tr><td>Mrgb, M (material channel)</td><td>Not yet: there is no per-vertex material channel</td></tr><tr><td>Polyframe (PolyF, Shift+F)</td><td><strong>Wire</strong> on the right shelf, or <kbd>Shift</kbd>+<kbd>F</kbd></td></tr><tr><td>Polygroups</td><td><strong>Face Groups</strong>: same idea, same Ctrl+Shift gestures. See <a href="face-groups.html">Face Groups and visibility</a></td></tr><tr><td>Polypaint</td><td><strong>Vertex Paint</strong>: Paint brush (<kbd>P</kbd>), Rgb, fills, cavity paint. See <a href="vertex-paint.html">Vertex Paint</a></td></tr><tr><td>Polypaint layers</td><td><strong>Tool &gt; Paint Layers</strong>: Photoshop-style colour layers with blend modes. See <a href="vertex-paint.html#paint-layers">Paint layers</a></td></tr><tr><td>Project All (ProjectAll)</td><td><strong>Tool &gt; Parts &gt; Project &gt; Project All</strong> (<code>project_all</code>), with Dist, Mean and PA Blur; respects the mask. See <a href="retopology.html#project-all">Quad retopology</a></td></tr><tr><td>Projection Master</td><td>Not yet. <strong>Mesh &gt; Generate 3D &gt; Stamp</strong> projects an image onto the model from the view</td></tr><tr><td>QuickSave</td><td><strong>File &gt; Save Snapshot</strong> (<kbd>9</kbd> in the ZBrush-style keys); the last 10 are kept in the Library <strong>Snapshots</strong> tab. See <a href="projects.html#snapshots">Projects</a></td></tr><tr><td>Rgb</td><td><strong>Rgb</strong> on the top shelf (paint while sculpting)</td></tr><tr><td>Rgb Intensity, Z Intensity, Focal Shift</td><td>Same keys: <strong>RGB Intensity</strong> (<kbd>I</kbd>), <strong>Intensity</strong> (<kbd>U</kbd>), <strong>Falloff</strong> (<kbd>O</kbd>) in <strong>Sculpt &gt; Draw &amp; Tablet</strong> and the Quick Menu</td></tr><tr><td>Sculptris Pro, dynamic topology</td><td><strong>Dynamic</strong> on the top shelf, with <strong>Detail</strong> (<code>dyntopo</code>). See <a href="dynamic-topology.html">Dynamic topology</a></td></tr><tr><td>Reconstruct Subdiv</td><td><strong>Tool &gt; Geometry &gt; Reconstruct Subdiv</strong> (<code>subdiv_reconstruct</code>)</td></tr><tr><td>SDiv, Lower Res / Higher Res (Shift+D / D)</td><td><strong>Tool &gt; Geometry</strong>: the <strong>SDiv</strong> slider, <strong>Lower Res</strong> <kbd>Shift</kbd>+<kbd>D</kbd>, <strong>Higher Res</strong> <kbd>D</kbd> (<code>subdiv_level</code>). See <a href="subdivision-levels.html">Subdivision levels</a></td></tr><tr><td>SelectLasso, SelectRect</td><td><strong>Tool &gt; Visibility</strong>: pick the shape, then <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+drag (add <kbd>Alt</kbd> to hide). See <a href="face-groups.html">Face Groups</a></td></tr><tr><td>Solo</td><td><strong>Solo</strong> on the right shelf or in <strong>Tool &gt; Parts</strong></td></tr><tr><td>Spotlight</td><td>Not yet</td></tr><tr><td>Edit &gt; Preferences &gt; Performance, Edit &gt; Preferences &gt; Mem</td><td><strong>Edit &gt; Preferences &gt; Performance</strong>: Antialiasing, Fast Navigation, Multithreading, the last stroke&#x27;s cost and memory. See <a href="performance.html">Performance</a></td></tr><tr><td>Store Config</td><td><strong>Store Config</strong>, <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd> (<strong>Edit &gt; Preferences &gt; Config</strong>)</td></tr><tr><td>Stroke (Dots, DragRect, DragDot, Spray)</td><td><strong>Stroke</strong> types Dots, Drag Stamp, Slide Stamp, Spray, Lazy Stroke (<kbd>L</kbd> toggles Steady Stroke)</td></tr><tr><td>SubTool</td><td><strong>Part</strong>: same idea, <kbd>Alt</kbd>+click to select. See <a href="parts.html">Parts</a></td></tr><tr><td>Texture Map, New From Polypaint</td><td><strong>Tool &gt; Texture Map</strong>: <strong>New Texture</strong> (1K-8K) and paint straight into it, or <strong>Vertex Paint &gt; Texture</strong>. See <a href="texture-painting.html">Texture painting</a></td></tr><tr><td>Texture palette</td><td>Not yet as a palette of texture images. <strong>Tool &gt; Texture Map &gt; Import Texture</strong> loads an image onto the UVs</td></tr><tr><td>Transpose, Gizmo 3D (Move W, Scale E, Rotate R)</td><td><strong>Gizmo</strong>: same keys, arrows, rings and boxes; masked parts stay, Falloff softens the joint. See <a href="gizmo.html">Gizmo</a></td></tr><tr><td>Transpose All</td><td><strong>All Parts</strong> in the Gizmo panel. See <a href="gizmo.html#all-parts">Gizmo</a></td></tr><tr><td>UV Master (Unwrap), UV editing</td><td>The <strong>UV Editor</strong> (<kbd>Alt</kbd>+<kbd>U</kbd>): seams on the model, Least Stretch, Conformal, By Face Groups, Planar and Unfold unwraps, UDIM packing, texel density, trim sheets (<code>uv_unwrap</code>, <code>uv_pack</code>...). <strong>Tool &gt; Texture Map &gt; Auto UV</strong> (<code>uv_auto</code>) is the one-click unwrap. See <a href="uv-editor.html">UV Editor</a></td></tr><tr><td>VDM brush, 3D alpha, Create VDM brush from the VDM plane</td><td>The <strong>VDM</strong> brush and <strong>Sculpt &gt; Brush &gt; Vector Displacement</strong>: built-in maps, <strong>Load VDM...</strong> (EXR), <strong>New VDM Plane</strong>, <strong>Create VDM</strong>, <strong>Export EXR...</strong>. See <a href="sculpting.html#vector-displacement-brushes">Vector displacement brushes</a></td></tr><tr><td>Zadd / Zsub</td><td><strong>Add</strong> / <strong>Sub</strong> on the top shelf; <kbd>Alt</kbd> flips for one stroke</td></tr><tr><td>ZPlugin</td><td>No in-app plugin system yet. Automate with the Python module, <code>sculptforge-cli</code> and MCP (<a href="scripting.html">Scripting</a>)</td></tr><tr><td>ZRemesher</td><td><strong>Tool &gt; Geometry &gt; Quad Remesh</strong> (<code>qremesh</code>): Target Polygons, Half / Same / Double, Adaptive Size, Keep Groups, Use Vertex Paint, symmetry. No curve guides yet. See <a href="retopology.html">Quad retopology</a></td></tr><tr><td>ZScript</td><td>Script commands: the console (backtick key), script files, <code>sculptforge-cli</code>. See <a href="scripting.html">Scripting</a></td></tr><tr><td>ZSpheres, Adaptive Skin, Preview (A)</td><td><strong>Tool &gt; Forge Spheres</strong>: Draw, Move, Scale, Alt+click deletes, <strong>Preview</strong> (<kbd>A</kbd>), <strong>Make Mesh</strong> (<code>zsphere_make_mesh</code>). See <a href="forge-spheres.html">Forge Spheres</a></td></tr><tr><td>ZTL, ZPR files</td><td>Not read directly. Convert ZTools with the SculptForge ZTL Export plug-in for ZBrush (then open the <code>.ZTL</code>), or use Send to ZBrush, OBJ, FBX or GLB; save work as <code>.sfproj</code></td></tr></tbody></table></div>
+<p>This chapter explains the terms SculptForge uses (Parts, Forge Spheres, Vertex Paint, Library...). The command palette (<kbd>F3</kbd>) also finds a feature by what it does: type &quot;remesh&quot;, &quot;groups&quot; or &quot;folders&quot;. See also the <a href="quick-tour.html">Quick tour for experienced sculptors</a>.</p>
<h2 id="sculptforge-terms">SculptForge terms<a class="anchor" href="#sculptforge-terms" aria-label="Link to this section">#</a></h2>
-<div class="table-wrap"><table><thead><tr><th>Term</th><th>Meaning</th></tr></thead><tbody><tr><td>Brush Lab</td><td>The AI brush creator: describe a brush in words and it builds a recipe you can tweak. Opens from <strong>AI Brush</strong>. See <a href="brush-lab.html">Brush Lab</a></td></tr><tr><td>Brush code</td><td>One line of text (<code>sfbrush1:...</code>) that holds a whole brush, for sharing in chat or a forum. Paste with <kbd>Ctrl</kbd>+<kbd>V</kbd></td></tr><tr><td>Brush library</td><td>Your saved custom brushes, loaded at every start</td></tr><tr><td>Brush recipe</td><td>The data that defines a custom brush (direction, depth, plane, pinch, pattern and so on): values, never code</td></tr><tr><td><code>.sfbrush</code></td><td>A file holding one brush recipe</td></tr><tr><td><code>.sfproj</code></td><td>A SculptForge project file: the whole scene. See <a href="projects.html">Projects</a></td></tr><tr><td>Cross field</td><td>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</td></tr><tr><td>Command palette</td><td><kbd>F3</kbd>: search every command, brush and setting by name and run it</td></tr><tr><td>Community gallery</td><td>Shared CC0 brushes you can install in one click (<strong>Community brushes</strong>)</td></tr><tr><td>Console</td><td>The script console (backtick key): every action appears as a script line</td></tr><tr><td>Ctrl help</td><td>Hold <kbd>Ctrl</kbd> and point at a control to see what it does, its shortcut and its command</td></tr><tr><td>Gaussian splat</td><td>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 <a href="splats.html">Gaussian splats</a> and <a href="scan-to-sculptable.html">From scan to sculptable mesh</a></td></tr><tr><td>Falloff (Gizmo)</td><td>How far a gizmo move eases in from the mask&#x27;s edge, as a share of the Part&#x27;s size: a soft joint when posing. See <a href="gizmo.html#posing-a-limb">Gizmo</a></td></tr><tr><td>Generate 3D</td><td>Turn an image or a description into a sculptable model. See <a href="generate-3d.html">Image and text to 3D</a></td></tr><tr><td>Gizmo</td><td>The Move / Scale / Rotate handles (<kbd>W</kbd> <kbd>E</kbd> <kbd>R</kbd>) for placing and posing a Part or its unmasked part. See <a href="gizmo.html">Gizmo</a></td></tr><tr><td>LOD chain</td><td>A series of lighter copies of a model (LOD0, LOD1...) for game engines. See <a href="geometry.html#lod-chains">Geometry</a></td></tr><tr><td>MCP</td><td>Model Context Protocol: <code>sculptforge-cli --mcp</code> lets AI agents such as Claude run SculptForge commands</td></tr><tr><td>Pivot</td><td>The point the Gizmo turns and scales about. <kbd>Alt</kbd>+click the model to put it there. See <a href="gizmo.html#the-pivot">The pivot</a></td></tr><tr><td>Subdivide</td><td>One-way subdivision without levels (<strong>Tool &gt; Geometry &gt; Subdivide</strong>, <code>subdivide</code>); <strong>Divide</strong> keeps the levels</td></tr><tr><td>Send to Unreal</td><td>Export and import a model into a running Unreal Editor in one step (<kbd>Ctrl</kbd>+<kbd>U</kbd>)</td></tr><tr><td>Shelves, palettes, trays</td><td>The interface around the canvas: shelves hold the most-used controls, palettes hold everything, trays hold pinned palettes. See <a href="interface.html">The interface</a></td></tr><tr><td>Studio brush folder</td><td>A shared, read-only brush folder for a team (<code>SCULPTFORGE_BRUSH_PATH</code>). See <a href="studios.html">For studios</a></td></tr><tr><td>Paint target (Vertex / Texture)</td><td>Where painting goes on a Part that has a texture: its vertices (vertex paint) or its texture. Top shelf, next to <strong>Rgb</strong>. See <a href="texture-painting.html#vertex-or-texture">Texture painting</a></td></tr><tr><td>Quad Remesh</td><td>SculptForge&#x27;s automatic quad retopology (ZBrush&#x27;s ZRemesher), in <strong>Tool &gt; Geometry</strong>. See <a href="retopology.html">Quad retopology</a></td></tr><tr><td>Mirror plane (Quad Remesh)</td><td>The plane Quad Remesh&#x27;s <strong>Symmetry</strong> mirrors across: the model&#x27;s own middle (the world&#x27;s centre plane when the model is symmetric about it), found from the model. Like ZBrush&#x27;s local symmetry. See <a href="retopology.html#quad-remesh">Quad retopology</a></td></tr><tr><td>Padding (gutter)</td><td>The few texels around each UV island that texture painting and baking also fill, so seams don&#x27;t show. See <a href="texture-painting.html">Texture painting</a> and <a href="baking.html">Baking</a></td></tr><tr><td>Bake</td><td>Capture a high-poly&#x27;s detail as images (maps) on a low-poly&#x27;s UVs. See <a href="baking.html">Baking</a></td></tr><tr><td>Cage (front / rear distance)</td><td>How far in front of and behind the low-poly the bake&#x27;s rays look for the high-poly. See <a href="baking.html#how-the-bake-works">Baking</a></td></tr><tr><td>Displacement map</td><td>A map of how far the high-poly lies from the low-poly along its normal; mid-grey = 0. See <a href="baking.html#displacement-mid-grey-is-zero">Baking</a></td></tr><tr><td>Keep Texture</td><td>Remesh option (Voxel Remesh, Quad Remesh): give the new surface Auto UVs and project the painted texture onto it, so the paint survives. See <a href="texture-painting.html#uvs-and-geometry">Texture painting</a></td></tr><tr><td>MikkTSpace</td><td>The standard way of computing tangents that game engines share, so tangent-space normal maps look the same everywhere. See <a href="baking.html">Baking</a></td></tr><tr><td>Normal map</td><td>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 <a href="baking.html">Baking</a></td></tr><tr><td>Texel</td><td>One pixel of a texture. Texture painting paints texels; their 3D position on the model decides the brush falloff</td></tr><tr><td>UV island</td><td>A piece of the surface flattened into the texture square. Unwrap and Auto UV cut the model into islands along seams. See <a href="uv-editor.html">UV Editor</a></td></tr><tr><td>UDIM tile</td><td>One unit square of UV space, numbered 1001 (u and v between 0 and 1), 1002 to its right, ten per row: a Part&#x27;s islands can spread over several, each its own texture. See <a href="uv-editor.html#packing-and-udim-tiles">UV Editor</a></td></tr><tr><td>Texel density</td><td>Texels of the texture per unit of surface length: equal density makes detail look the same size everywhere. See <a href="uv-editor.html#texel-density">UV Editor</a></td></tr><tr><td>Trim sheet</td><td>A texture of horizontal strips that repeat left to right; islands are laid into a strip. See <a href="uv-editor.html#trim-sheets">UV Editor</a></td></tr><tr><td>Antialiasing (AA)</td><td>Smoothing the 3D view&#x27;s edges with several samples per pixel (Off, 2x, 4x, 8x in <strong>Edit &gt; Preferences &gt; Performance</strong>). See <a href="performance.html">Performance</a></td></tr><tr><td>BVH</td><td>Bounding volume hierarchy: the structure SculptForge uses to find the surface under the cursor and the vertices under a brush. Its update time is shown per dab in <strong>Edit &gt; Preferences &gt; Performance</strong></td></tr><tr><td>Dab</td><td>One step of a brush along a stroke. Its cost per dab decides whether a stroke keeps up with the display (under 16 ms at 60 Hz). See <a href="performance.html">Performance</a></td></tr><tr><td>Fast Navigation</td><td>Drawing scenes of 10 million triangles or more without antialiasing while the view moves, so it keeps up. See <a href="performance.html">Performance</a></td></tr><tr><td>Multithreading</td><td>Brushes, normal and BVH updates and saving spread over every processor core; same results either way. See <a href="performance.html">Performance</a></td></tr></tbody></table></div>
+<div class="table-wrap"><table><thead><tr><th>Term</th><th>Meaning</th></tr></thead><tbody><tr><td>Brush Lab</td><td>The AI brush creator: describe a brush in words and it builds a recipe you can tweak. Opens from <strong>AI Brush</strong>. See <a href="brush-lab.html">Brush Lab</a></td></tr><tr><td>Brush code</td><td>One line of text (<code>sfbrush1:...</code>) that holds a whole brush, for sharing in chat or a forum. Paste with <kbd>Ctrl</kbd>+<kbd>V</kbd></td></tr><tr><td>Brush library</td><td>Your saved custom brushes, loaded at every start</td></tr><tr><td>Brush recipe</td><td>The data that defines a custom brush (direction, depth, plane, pinch, pattern and so on): values, never code</td></tr><tr><td><code>.sfbrush</code></td><td>A file holding one brush recipe</td></tr><tr><td><code>.sfproj</code></td><td>A SculptForge project file: the whole scene. See <a href="projects.html">Projects</a></td></tr><tr><td>Cross field</td><td>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</td></tr><tr><td>Command palette</td><td><kbd>F3</kbd>: search every command, brush and setting by name and run it</td></tr><tr><td>Community gallery</td><td>Shared CC0 brushes you can install in one click (<strong>Community brushes</strong>)</td></tr><tr><td>Console</td><td>The script console (backtick key): every action appears as a script line</td></tr><tr><td>Ctrl help</td><td>Hold <kbd>Ctrl</kbd> and point at a control to see what it does, its shortcut and its command</td></tr><tr><td>Gaussian splat</td><td>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 <a href="splats.html">Gaussian splats</a> and <a href="scan-to-sculptable.html">From scan to sculptable mesh</a></td></tr><tr><td>Falloff (Gizmo)</td><td>How far a gizmo move eases in from the mask&#x27;s edge, as a share of the Part&#x27;s size: a soft joint when posing. See <a href="gizmo.html#posing-a-limb">Gizmo</a></td></tr><tr><td>Generate 3D</td><td>Turn an image or a description into a sculptable model. See <a href="generate-3d.html">Image and text to 3D</a></td></tr><tr><td>Gizmo</td><td>The Move / Scale / Rotate handles (<kbd>W</kbd> <kbd>E</kbd> <kbd>R</kbd>) for placing and posing a Part or its unmasked part. See <a href="gizmo.html">Gizmo</a></td></tr><tr><td>LOD chain</td><td>A series of lighter copies of a model (LOD0, LOD1...) for game engines. See <a href="geometry.html#lod-chains">Geometry</a></td></tr><tr><td>MCP</td><td>Model Context Protocol: <code>sculptforge-cli --mcp</code> lets AI agents such as Claude run SculptForge commands</td></tr><tr><td>Pivot</td><td>The point the Gizmo turns and scales about. <kbd>Alt</kbd>+click the model to put it there. See <a href="gizmo.html#the-pivot">The pivot</a></td></tr><tr><td>Subdivide</td><td>One-way subdivision without levels (<strong>Tool &gt; Geometry &gt; Subdivide</strong>, <code>subdivide</code>); <strong>Divide</strong> keeps the levels</td></tr><tr><td>Send to Unreal</td><td>Export and import a model into a running Unreal Editor in one step (<kbd>Ctrl</kbd>+<kbd>U</kbd>)</td></tr><tr><td>Shelves, palettes, trays</td><td>The interface around the canvas: shelves hold the most-used controls, palettes hold everything, trays hold pinned palettes. See <a href="interface.html">The interface</a></td></tr><tr><td>Studio brush folder</td><td>A shared, read-only brush folder for a team (<code>SCULPTFORGE_BRUSH_PATH</code>). See <a href="studios.html">For studios</a></td></tr><tr><td>Paint target (Vertex / Texture)</td><td>Where painting goes on a Part that has a texture: its vertices (vertex paint) or its texture. Top shelf, next to <strong>Rgb</strong>. See <a href="texture-painting.html#vertex-or-texture">Texture painting</a></td></tr><tr><td>Quad Remesh</td><td>SculptForge&#x27;s automatic quad retopology, in <strong>Tool &gt; Geometry</strong>. See <a href="retopology.html">Quad retopology</a></td></tr><tr><td>Mirror plane (Quad Remesh)</td><td>The plane Quad Remesh&#x27;s <strong>Symmetry</strong> mirrors across: the model&#x27;s own middle (the world&#x27;s centre plane when the model is symmetric about it), found from the model. Like local symmetry. See <a href="retopology.html#quad-remesh">Quad retopology</a></td></tr><tr><td>Padding (gutter)</td><td>The few texels around each UV island that texture painting and baking also fill, so seams don&#x27;t show. See <a href="texture-painting.html">Texture painting</a> and <a href="baking.html">Baking</a></td></tr><tr><td>Bake</td><td>Capture a high-poly&#x27;s detail as images (maps) on a low-poly&#x27;s UVs. See <a href="baking.html">Baking</a></td></tr><tr><td>Cage (front / rear distance)</td><td>How far in front of and behind the low-poly the bake&#x27;s rays look for the high-poly. See <a href="baking.html#how-the-bake-works">Baking</a></td></tr><tr><td>Displacement map</td><td>A map of how far the high-poly lies from the low-poly along its normal; mid-grey = 0. See <a href="baking.html#displacement-mid-grey-is-zero">Baking</a></td></tr><tr><td>Keep Texture</td><td>Remesh option (Voxel Remesh, Quad Remesh): give the new surface Auto UVs and project the painted texture onto it, so the paint survives. See <a href="texture-painting.html#uvs-and-geometry">Texture painting</a></td></tr><tr><td>MikkTSpace</td><td>The standard way of computing tangents that game engines share, so tangent-space normal maps look the same everywhere. See <a href="baking.html">Baking</a></td></tr><tr><td>Normal map</td><td>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 <a href="baking.html">Baking</a></td></tr><tr><td>Texel</td><td>One pixel of a texture. Texture painting paints texels; their 3D position on the model decides the brush falloff</td></tr><tr><td>UV island</td><td>A piece of the surface flattened into the texture square. Unwrap and Auto UV cut the model into islands along seams. See <a href="uv-editor.html">UV Editor</a></td></tr><tr><td>UDIM tile</td><td>One unit square of UV space, numbered 1001 (u and v between 0 and 1), 1002 to its right, ten per row: a Part&#x27;s islands can spread over several, each its own texture. See <a href="uv-editor.html#packing-and-udim-tiles">UV Editor</a></td></tr><tr><td>Texel density</td><td>Texels of the texture per unit of surface length: equal density makes detail look the same size everywhere. See <a href="uv-editor.html#texel-density">UV Editor</a></td></tr><tr><td>Trim sheet</td><td>A texture of horizontal strips that repeat left to right; islands are laid into a strip. See <a href="uv-editor.html#trim-sheets">UV Editor</a></td></tr><tr><td>Antialiasing (AA)</td><td>Smoothing the 3D view&#x27;s edges with several samples per pixel (Off, 2x, 4x, 8x in <strong>Edit &gt; Preferences &gt; Performance</strong>). See <a href="performance.html">Performance</a></td></tr><tr><td>BVH</td><td>Bounding volume hierarchy: the structure SculptForge uses to find the surface under the cursor and the vertices under a brush. Its update time is shown per dab in <strong>Edit &gt; Preferences &gt; Performance</strong></td></tr><tr><td>Dab</td><td>One step of a brush along a stroke. Its cost per dab decides whether a stroke keeps up with the display (under 16 ms at 60 Hz). See <a href="performance.html">Performance</a></td></tr><tr><td>Fast Navigation</td><td>Drawing scenes of 10 million triangles or more without antialiasing while the view moves, so it keeps up. See <a href="performance.html">Performance</a></td></tr><tr><td>Multithreading</td><td>Brushes, normal and BVH updates and saving spread over every processor core; same results either way. See <a href="performance.html">Performance</a></td></tr></tbody></table></div>
<h2 id="see-also">See also<a class="anchor" href="#see-also" aria-label="Link to this section">#</a></h2>
<ul>
<li>
@@ -74,7 +72,7 @@
<p class="guide-meta fine">Also in the app: <strong>Help &gt; User Guide</strong> (<kbd>Shift</kbd>+<kbd>F1</kbd>).
Found a mistake? <a href="https://github.com/islandmed/SculptForge/edit/main/docs/guide/glossary.md">Edit this page on GitHub</a>.</p>
</main>
- <aside class="on-page" aria-label="On this page"><p>On this page</p><ul><li><a href="#zbrush-terms-in-sculptforge">ZBrush terms in SculptForge</a></li><li><a href="#sculptforge-terms">SculptForge terms</a></li><li><a href="#see-also">See also</a></li></ul></aside>
+
</div>
<footer class="footer">
<div class="wrap footer-grid">
@@ -91,8 +89,7 @@
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/images/custom-matcaps.jpg b/website/guide/images/custom-lit-spheres.jpg
similarity index 100%
rename from website/guide/images/custom-matcaps.jpg
rename to website/guide/images/custom-lit-spheres.jpg
diff --git a/website/guide/images/polygroups.jpg b/website/guide/images/face-groups.jpg
similarity index 100%
rename from website/guide/images/polygroups.jpg
rename to website/guide/images/face-groups.jpg
diff --git a/website/guide/images/lightbox.jpg b/website/guide/images/library.jpg
similarity index 100%
rename from website/guide/images/lightbox.jpg
rename to website/guide/images/library.jpg
diff --git a/website/guide/images/subtools.jpg b/website/guide/images/parts.jpg
similarity index 100%
rename from website/guide/images/subtools.jpg
rename to website/guide/images/parts.jpg
diff --git a/website/guide/images/polypaint.jpg b/website/guide/images/vertex-paint.jpg
similarity index 100%
rename from website/guide/images/polypaint.jpg
rename to website/guide/images/vertex-paint.jpg
diff --git a/website/guide/index.html b/website/guide/index.html
index 3762b8dd..e597724b 100644
--- a/website/guide/index.html
+++ b/website/guide/index.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="SculptForge User Guide">
<meta property="og:description" content="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 ">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/index.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,16 +46,16 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home current" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home current" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
<article class="guide-article">
<h1 id="sculptforge-user-guide">SculptForge User Guide</h1>
-<p>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 ZBrush. It is updated with every release; <a href="whats-new.html">What&#x27;s new</a> lists what changed.</p>
+<p>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; <a href="whats-new.html">What&#x27;s new</a> lists what changed.</p>
<p>Read it inside SculptForge (<strong>Help &gt; User Guide</strong>, or <kbd>Shift</kbd>+<kbd>F1</kbd>) or on the <a href="https://sculptforge.app/guide/" rel="noopener">SculptForge website</a>.</p>
<h2 id="start-here">Start here<a class="anchor" href="#start-here" aria-label="Link to this section">#</a></h2>
-<div class="table-wrap"><table><thead><tr><th>You want to</th><th>Read</th></tr></thead><tbody><tr><td>Install it</td><td><a href="installing.html">Install SculptForge</a>: downloads for Windows, macOS and Linux</td></tr><tr><td>Set it up on Windows</td><td><a href="installing.html#windows">The Windows notes</a>: SmartScreen, pen tablets (Windows Ink, Mouse mode), screen scaling</td></tr><tr><td>Make your first sculpt</td><td><a href="first-sculpt.html">Your first sculpt in 10 minutes</a>: a cute owl head from the default sphere</td></tr><tr><td>Start from a head or body</td><td><a href="projects.html#start-from-a-starter-mesh">Starter meshes</a>: base meshes with clean quads, <strong>File &gt; New from Starter Mesh</strong></td></tr><tr><td>Find your way around</td><td><a href="interface.html">The interface</a>: the menus <strong>File, Edit, Sculpt, Paint, Mesh, View, Render, Help</strong>, the shelves and the Tool panel; <a href="navigation.html">Navigating the view</a></td></tr><tr><td>Learn the brushes</td><td><a href="sculpting.html">Sculpting and brushes</a></td></tr><tr><td>Switch from ZBrush</td><td><a href="coming-from-zbrush.html">Coming from ZBrush</a> (the ZBrush-style layout and keys) and the <a href="glossary.html">Glossary</a></td></tr><tr><td>Switch from Blender</td><td><a href="shortcuts.html#blender-keys">Blender keys</a>, and <a href="blender.html">Working with Blender</a> for the bridge add-on</td></tr><tr><td>Fix a problem</td><td><a href="troubleshooting.html">Troubleshooting</a></td></tr></tbody></table></div>
+<div class="table-wrap"><table><thead><tr><th>You want to</th><th>Read</th></tr></thead><tbody><tr><td>Install it</td><td><a href="installing.html">Install SculptForge</a>: downloads for Windows, macOS and Linux</td></tr><tr><td>Set it up on Windows</td><td><a href="installing.html#windows">The Windows notes</a>: SmartScreen, pen tablets (Windows Ink, Mouse mode), screen scaling</td></tr><tr><td>Make your first sculpt</td><td><a href="first-sculpt.html">Your first sculpt in 10 minutes</a>: a cute owl head from the default sphere</td></tr><tr><td>Start from a head or body</td><td><a href="projects.html#start-from-a-starter-mesh">Starter meshes</a>: base meshes with clean quads, <strong>File &gt; New from Starter Mesh</strong></td></tr><tr><td>Find your way around</td><td><a href="interface.html">The interface</a>: the menus <strong>File, Edit, Sculpt, Paint, Mesh, View, Render, Help</strong>, the shelves and the Tool panel; <a href="navigation.html">Navigating the view</a></td></tr><tr><td>Learn the brushes</td><td><a href="sculpting.html">Sculpting and brushes</a></td></tr><tr><td>Switch from another sculpting app</td><td><a href="quick-tour.html">Quick tour for experienced sculptors</a> (the Classic layout and keys) and the <a href="glossary.html">Glossary</a></td></tr><tr><td>Switch from Blender</td><td><a href="shortcuts.html#blender-keys">Blender keys</a>, and <a href="blender.html">Working with Blender</a> for the bridge add-on</td></tr><tr><td>Fix a problem</td><td><a href="troubleshooting.html">Troubleshooting</a></td></tr></tbody></table></div>
<figure class="shot"><a href="images/interface-overview.jpg" class="zoom"><img src="images/interface-overview.jpg" alt="The SculptForge window with its main regions labelled" width="1280" height="768" loading="lazy" decoding="async"></a><figcaption>The SculptForge window with its main regions labelled</figcaption></figure>
<h2 id="getting-started">Getting started<a class="anchor" href="#getting-started" aria-label="Link to this section">#</a></h2>
<ol>
@@ -69,7 +69,7 @@
<a href="whats-new.html">What&#x27;s new</a>
</li>
<li>
-<a href="coming-from-zbrush.html">Coming from ZBrush</a>
+<a href="quick-tour.html">Quick tour for experienced sculptors</a>
</li>
<li>
<a href="installing.html">Install SculptForge on Windows, macOS and Linux</a>
@@ -182,7 +182,7 @@
<a href="baking.html">Baking normal and displacement maps</a>
</li>
<li>
-<a href="exporting.html">Exporting, Unreal and ZBrush</a>
+<a href="exporting.html">Exporting, Unreal and Bridge</a>
</li>
<li>
<a href="export-presets.html">Export presets</a>
@@ -256,8 +256,7 @@ Ask questions and report problems on the <a href="https://github.com/islandmed/S
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/installing.html b/website/guide/installing.html
index 95336ac9..0594c801 100644
--- a/website/guide/installing.html
+++ b/website/guide/installing.html
@@ -14,14 +14,14 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Install SculptForge on Windows, macOS and Linux - SculptForge User Guide">
<meta property="og:description" content="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.">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/installing.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
<script data-goatcounter="https://sculptforge.goatcounter.com/count" async src="https://gc.zgo.at/count.js"></script>
<script src="search-index.js?v=47" defer></script>
</head>
-<body class="guide-page" data-prev="coming-from-zbrush.html" data-next="interface.html">
+<body class="guide-page" data-prev="quick-tour.html" data-next="interface.html">
<div class="scroll-progress" aria-hidden="true"></div>
<header class="nav">
<div class="wrap nav-inner">
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html" class="current" aria-current="page">Install SculptForge on Windows, macOS and Linux</a><ul class="toc-sections"><li><a href="#system-requirements">System requirements</a></li><li><a href="#download">Download</a></li><li><a href="#windows">Windows</a></li><li><a href="#opening-sculptforge-for-the-first-time">Opening SculptForge for the first time</a></li><li><a href="#what-you-see-at-start-up">What you see at start-up</a></li><li><a href="#updating-and-uninstalling">Updating and uninstalling</a></li><li><a href="#building-from-source">Building from source</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html" class="current" aria-current="page">Install SculptForge on Windows, macOS and Linux</a><ul class="toc-sections"><li><a href="#system-requirements">System requirements</a></li><li><a href="#download">Download</a></li><li><a href="#windows">Windows</a></li><li><a href="#opening-sculptforge-for-the-first-time">Opening SculptForge for the first time</a></li><li><a href="#what-you-see-at-start-up">What you see at start-up</a></li><li><a href="#updating-and-uninstalling">Updating and uninstalling</a></li><li><a href="#building-from-source">Building from source</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -177,8 +177,8 @@ Click <strong>Open</strong> in the dialog that appears.
<div class="code-block"><pre class="code"><code class="language-sh">SDL_VIDEO_DRIVER=x11 sculptforge</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
<p>Pen tablets work on both. On Wayland, pressure, tilt, the eraser end and side buttons come through the desktop&#x27;s tablet protocol (tablet-v2), so the tablet must be set up in your desktop&#x27;s settings rather than through X11 tools such as <code>xsetwacom</code>. If pressure doesn&#x27;t respond, check <strong>Edit &gt; Preferences &gt; Tablet</strong> for the live pressure reading.</p>
<h2 id="what-you-see-at-start-up">What you see at start-up<a class="anchor" href="#what-you-see-at-start-up" aria-label="Link to this section">#</a></h2>
-<p>SculptForge opens a 1600 x 960 window with a sphere ready to sculpt and the <strong>Library</strong> open along the top of the canvas on its <strong>Project</strong> tab, so you can reopen recent work with a double-click. Press <kbd>,</kbd> (comma) to close it, or turn off <strong>Edit &gt; Preferences &gt; Library &gt; Show at startup</strong>. The first start also creates your library folder (<strong>Documents/SculptForge</strong>, with Projects, Tools, Brushes, Alphas, MatCaps, Images, Splats and QuickSave (snapshots) sub-folders), which the Library shows as <strong>User</strong>.</p>
-<p>The first start also asks what you are <strong>Coming from</strong>: <strong>ZBrush</strong>, <strong>Blender</strong>, <strong>Maya</strong> or <strong>New to sculpting</strong>. Your answer picks the key style: <strong>ZBrush</strong> turns on the ZBrush-style keys, <strong>Blender</strong> and <strong>Maya</strong> their own styles, and <strong>New to sculpting</strong> keeps the SculptForge keys (the default). Change it any time in <strong>Edit &gt; Preferences &gt; Input &gt; Style</strong> (see <a href="shortcuts.html">Keyboard and mouse</a>); if you are updating from an earlier version, your saved style is kept and the question isn&#x27;t asked.</p>
+<p>SculptForge opens a 1600 x 960 window with a sphere ready to sculpt and the <strong>Library</strong> open along the top of the canvas on its <strong>Project</strong> tab, so you can reopen recent work with a double-click. Press <kbd>,</kbd> (comma) to close it, or turn off <strong>Edit &gt; Preferences &gt; Library &gt; Show at startup</strong>. The first start also creates your library folder (<strong>Documents/SculptForge</strong>, with Projects, Tools, Brushes, Alphas, Lit Spheres, Images, Splats and QuickSave (snapshots) sub-folders), which the Library shows as <strong>User</strong>.</p>
+<p>The first start also asks what you are <strong>Coming from</strong>: <strong>Classic sculpting keys</strong>, <strong>Blender</strong>, <strong>Maya</strong> or <strong>New to sculpting</strong>. Your answer picks the key style: <strong>Classic sculpting keys</strong> turns on the Classic sculpting keys, <strong>Blender</strong> and <strong>Maya</strong> their own styles, and <strong>New to sculpting</strong> keeps the SculptForge keys (the default). Change it any time in <strong>Edit &gt; Preferences &gt; Input &gt; Style</strong> (see <a href="shortcuts.html">Keyboard and mouse</a>); if you are updating from an earlier version, your saved style is kept and the question isn&#x27;t asked.</p>
<p>You can open a file directly from the command line, too: <code>sculptforge model.obj</code> (or a <code>.glb</code>, <code>.sfproj</code>, splat capture or image). <code>sculptforge --fullscreen</code> starts filling the screen; <code>sculptforge --help</code> lists every option.</p>
<p>The next chapter, <a href="interface.html">The interface</a>, explains what everything on screen does.</p>
<h2 id="updating-and-uninstalling">Updating and uninstalling<a class="anchor" href="#updating-and-uninstalling" aria-label="Link to this section">#</a></h2>
@@ -214,7 +214,7 @@ ctest --test-dir build --output-on-failure
</li>
</ul>
</article>
- <nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="coming-from-zbrush.html"><span>Previous</span>Coming from ZBrush</a><a class="next" rel="next" href="interface.html"><span>Next</span>The interface</a></nav>
+ <nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="quick-tour.html"><span>Previous</span>Quick tour for experienced sculptors</a><a class="next" rel="next" href="interface.html"><span>Next</span>The interface</a></nav>
<p class="guide-meta fine">Also in the app: <strong>Help &gt; User Guide</strong> (<kbd>Shift</kbd>+<kbd>F1</kbd>).
Found a mistake? <a href="https://github.com/islandmed/SculptForge/edit/main/docs/guide/installing.md">Edit this page on GitHub</a>.</p>
</main>
@@ -235,8 +235,7 @@ ctest --test-dir build --output-on-failure
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/interface.html b/website/guide/interface.html
index 8b48ea16..5560e95e 100644
--- a/website/guide/interface.html
+++ b/website/guide/interface.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>The interface - SculptForge User Guide</title>
- <meta name="description" content="SculptForge&#x27;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 ZB">
+ <meta name="description" content="SculptForge&#x27;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 Cl">
<meta name="theme-color" content="#111114">
<meta name="color-scheme" content="dark">
<link rel="icon" type="image/svg+xml" href="../img/favicon.svg?v=2">
@@ -13,8 +13,8 @@
<link rel="canonical" href="https://sculptforge.app/guide/interface.html">
<meta property="og:type" content="article">
<meta property="og:title" content="The interface - SculptForge User Guide">
- <meta property="og:description" content="SculptForge&#x27;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 ZB">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:description" content="SculptForge&#x27;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 Cl">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/interface.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,18 +46,18 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html" class="current" aria-current="page">The interface</a><ul class="toc-sections"><li><a href="#the-regions-at-a-glance">The regions at a glance</a></li><li><a href="#looks-and-layouts">Looks and layouts</a></li><li><a href="#turning-ai-off">Turning AI off</a></li><li><a href="#the-menu-bar">The menu bar</a></li><li><a href="#the-title-strip-zbrush-style-layout">The title strip (ZBrush-style layout)</a></li><li><a href="#menus-and-palettes">Menus and palettes</a></li><li><a href="#trays">Trays</a></li><li><a href="#the-shelves">The shelves</a></li><li><a href="#pop-up-pickers">Pop-up pickers</a></li><li><a href="#the-library">The Library</a></li><li><a href="#getting-help-on-anything">Getting help on anything</a></li><li><a href="#the-command-palette">The command palette</a></li><li><a href="#the-console">The console</a></li><li><a href="#customizing-the-interface">Customizing the interface</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html" class="current" aria-current="page">The interface</a><ul class="toc-sections"><li><a href="#the-regions-at-a-glance">The regions at a glance</a></li><li><a href="#looks-and-layouts">Looks and layouts</a></li><li><a href="#turning-ai-off">Turning AI off</a></li><li><a href="#the-menu-bar">The menu bar</a></li><li><a href="#the-title-strip-classic-layout">The title strip (Classic layout)</a></li><li><a href="#menus-and-palettes">Menus and palettes</a></li><li><a href="#trays">Trays</a></li><li><a href="#the-shelves">The shelves</a></li><li><a href="#pop-up-pickers">Pop-up pickers</a></li><li><a href="#the-library">The Library</a></li><li><a href="#getting-help-on-anything">Getting help on anything</a></li><li><a href="#the-command-palette">The command palette</a></li><li><a href="#the-console">The console</a></li><li><a href="#customizing-the-interface">Customizing the interface</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
<article class="guide-article">
<h1 id="the-interface">The interface</h1>
-<p>SculptForge&#x27;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 <strong>SculptForge layout</strong> (the default), with menus by task, and the <strong>ZBrush-style layout</strong>, with a bar of alphabetical palettes. Both hold the same controls; see <a href="#looks-and-layouts">Looks and layouts</a> 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.</p>
+<p>SculptForge&#x27;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 <strong>SculptForge layout</strong> (the default), with menus by task, and the <strong>Classic layout</strong>, with a bar of alphabetical palettes. Both hold the same controls; see <a href="#looks-and-layouts">Looks and layouts</a> 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.</p>
<figure class="shot"><a href="images/interface-overview.jpg" class="zoom"><img src="images/interface-overview.jpg" alt="The SculptForge window with its main regions labelled" width="1280" height="768" loading="lazy" decoding="async"></a><figcaption>The SculptForge window with its main regions labelled</figcaption></figure>
<h2 id="the-regions-at-a-glance">The regions at a glance<a class="anchor" href="#the-regions-at-a-glance" aria-label="Link to this section">#</a></h2>
<div class="table-wrap"><table><thead><tr><th>Region</th><th>Where</th><th>What it holds</th></tr></thead><tbody><tr><td>Menu bar</td><td>Top edge</td><td>The menus <strong>File, Edit, Sculpt, Paint, Mesh, View, Render, Help</strong>; the status message; mode, brush, file name, triangles and frame rate; layout presets <strong>1 2 3</strong>; <strong>Search</strong></td></tr><tr><td>Top shelf</td><td>Under the menu bar</td><td>Sculpt/Paint, Draw/Move/Scale/Rotate, Add/Sub, Rgb, Draw Size, Intensity, Dynamic, symmetry</td></tr><tr><td>Left shelf</td><td>Left of the canvas</td><td>Brush, Stroke, Alpha and Material tiles, the colour picker, Fill</td></tr><tr><td>Canvas</td><td>Centre</td><td>The 3D view, with the Sculpt Timeline along its top; strokes and navigation start only here</td></tr><tr><td>Right shelf</td><td>Right of the canvas</td><td>Undo and Redo, Frame, Move, Zoom and Rotate, display toggles, Solo</td></tr><tr><td>Right tray</td><td>Far right</td><td>The <strong>Tool</strong> panel: the active Part, Parts, Layers, Geometry, Masking and more</td></tr><tr><td>Bottom shelf</td><td>Below the canvas</td><td>Your quick brushes</td></tr></tbody></table></div>
<p>Press <kbd>Tab</kbd> 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.</p>
-<p>The <strong>ZBrush-style layout</strong> 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 <a href="#the-title-strip-zbrush-style-layout">The title strip</a> and <a href="#menus-and-palettes">Palettes</a>.</p>
+<p>The <strong>Classic layout</strong> 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 <a href="#the-title-strip-classic-layout">The title strip</a> and <a href="#menus-and-palettes">Palettes</a>.</p>
<h2 id="looks-and-layouts">Looks and layouts<a class="anchor" href="#looks-and-layouts" aria-label="Link to this section">#</a></h2>
<p><strong>Edit &gt; Preferences &gt; Interface &gt; Look</strong> sets how the interface looks and how it is laid out. Neither changes your models, brushes or shortcuts.</p>
<p><strong>Layout</strong>:</p>
@@ -66,7 +66,7 @@
<strong>SculptForge</strong> (the default for new installs): a status bar along the top with the task menus <strong>File, Edit, Sculpt, Paint, Mesh, View, Render</strong> and <strong>Help</strong>, the document name and scene statistics; a one-row top shelf (Sculpt/Paint, Draw, Move, Scale, Rotate, Add/Sub, Rgb, Draw Size, Intensity, Dynamic, symmetry). Every palette is a section of one menu: <strong>File</strong> (File, Script), <strong>Edit</strong> (Edit, Preferences), <strong>Sculpt</strong> (Brush, Draw &amp; Tablet, Stroke, Alpha, Symmetry &amp; Gizmo), <strong>Paint</strong> (Vertex Paint &amp; Color), <strong>Mesh</strong> (Parts &amp; Geometry, which is the Tool palette, and Generate 3D), <strong>View</strong> (Display), <strong>Render</strong> (Materials, Gaussian Splats) and <strong>Help</strong>. Pin a section to a tray as you would a palette. Brush Lab, Front and the pressure options are under <strong>Sculpt</strong>, the Library and the console under <strong>View &gt; Display</strong>, and <kbd>F3</kbd> finds everything.
</li>
<li>
-<strong>ZBrush-style</strong>: the alphabetical palette bar under a title strip, and a two-row top shelf (see <a href="#the-title-strip-zbrush-style-layout">The title strip</a> and <a href="#top-shelf">Top shelf</a>). Coming from ZBrush? In the welcome shown at the first start, pick the <strong>ZBrush-style layout</strong> card or <strong>Coming from: ZBrush</strong> (which also sets the ZBrush-style keys).
+<strong>Classic</strong>: the alphabetical palette bar under a title strip, and a two-row top shelf (see <a href="#the-title-strip-classic-layout">The title strip</a> and <a href="#top-shelf">Top shelf</a>). Experienced sculptor? In the welcome shown at the first start, pick the <strong>Classic layout</strong> card or <strong>Coming from: Classic sculpting keys</strong> (which also sets the keys).
</li>
</ul>
<p>Switching the layout swaps the shelves for that layout&#x27;s standard ones; the trays and what is in them stay.</p>
@@ -86,8 +86,8 @@
</li>
</ul>
<p><strong>Outlines</strong> (Forge Terminal, Phosphor and Blueprint) sets the panels&#x27; borders: <strong>Subtle</strong> (the default: faint borders, and nothing lights up under the pointer), <strong>Off</strong> (no borders; the gaps alone separate the panels) or <strong>On</strong> (clear borders, the panel under the pointer a faint step lighter). <strong>Outline opacity</strong> (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.</p>
-<p><strong>The first start</strong> shows three looks to pick from in the welcome: <strong>Neutral</strong>, <strong>Forge Terminal</strong> (Tokyo Night) and <strong>ZBrush-style layout</strong> (Classic with the palette bar). <strong>Coming from</strong> sets the keys and the layout together: ZBrush (ZBrush-style keys and layout), Blender, Maya or New to sculpting (their keys, the SculptForge layout). Help &gt; Welcome shows it again.</p>
-<p>Choosing Forge Terminal, Phosphor or Blueprint also switches to the SculptForge layout; you can pick the ZBrush-style layout again right after. The look and layout are remembered for the next start without <a href="#store-config-and-friends">Store Config</a> (Store Config keeps them in your UI configuration too).</p>
+<p><strong>The first start</strong> shows three looks to pick from in the welcome: <strong>Neutral</strong>, <strong>Forge Terminal</strong> (Tokyo Night) and <strong>Classic layout</strong> (Classic with the palette bar). <strong>Coming from</strong> 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 &gt; Welcome shows it again.</p>
+<p>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 without <a href="#store-config-and-friends">Store Config</a> (Store Config keeps them in your UI configuration too).</p>
<p><strong>Updating from an older version</strong> keeps the look and layout you had. A card, <strong>SculptForge has a new look</strong>, shows once: <strong>Try it</strong> switches to Forge Terminal with the Neutral colours and the SculptForge layout; <strong>Keep my layout</strong> changes nothing. Either way, Edit &gt; Preferences &gt; Interface &gt; Look changes it later.</p>
<p>In scripts: <code>ui_look look=forge scheme=neutral outlines=subtle layout=sculptforge</code> (or <code>look=classic layout=zbrush</code>).</p>
<h2 id="turning-ai-off">Turning AI off<a class="anchor" href="#turning-ai-off" aria-label="Link to this section">#</a></h2>
@@ -116,8 +116,8 @@
<strong>Minimize</strong> and <strong>Close</strong> at the far right. Close asks to save changes first, as <kbd>Ctrl</kbd>+<kbd>Q</kbd> does.
</li>
</ul>
-<h2 id="the-title-strip-zbrush-style-layout">The title strip (ZBrush-style layout)<a class="anchor" href="#the-title-strip-zbrush-style-layout" aria-label="Link to this section">#</a></h2>
-<p>In the ZBrush-style layout the top edge is a title strip instead, with the palette bar under it. From left to right:</p>
+<h2 id="the-title-strip-classic-layout">The title strip (Classic layout)<a class="anchor" href="#the-title-strip-classic-layout" aria-label="Link to this section">#</a></h2>
+<p>In the Classic layout the top edge is a title strip instead, with the palette bar under it. From left to right:</p>
<ul>
<li>
<strong>SculptForge</strong> and the <strong>document name</strong> (&quot;Untitled&quot; until you save). A <code>*</code> after the name means there are unsaved changes; click the name to save (<kbd>Ctrl</kbd>+<kbd>S</kbd>).
@@ -145,14 +145,13 @@
</li>
</ul>
<h2 id="menus-and-palettes">Menus and palettes<a class="anchor" href="#menus-and-palettes" aria-label="Link to this section">#</a></h2>
-<p>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 ZBrush-style 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 <kbd>Esc</kbd> or click outside to close it.</p>
+<p>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 <kbd>Esc</kbd> or click outside to close it.</p>
<figure class="shot"><a href="images/palette-dropdown.jpg" class="zoom"><img src="images/palette-dropdown.jpg" alt="The Sculpt menu open on its Stroke section" width="630" height="295" loading="lazy" decoding="async"></a><figcaption>The Sculpt menu open on its Stroke section</figcaption></figure>
-<p>Menu paths in this guide name what you click in the SculptForge layout: <strong>Edit &gt; Preferences &gt; Input</strong> is the <strong>Edit</strong> menu, its <strong>Preferences</strong> section, then the <strong>Input</strong> sub-palette. <strong>File</strong> and <strong>Edit</strong> have a section of the same name, which paths leave out (<strong>File &gt; Save</strong>). Paths starting with <strong>Tool</strong> are in the Tool panel in the right tray, in both layouts (it is also <strong>Mesh &gt; Parts &amp; Geometry</strong>). In the ZBrush-style layout, drop the menu: <strong>Edit &gt; Preferences &gt; Input</strong> is <strong>Input</strong> in the palette named <strong>Preferences</strong>, and <strong>Sculpt &gt; Stroke</strong> is the palette named <strong>Stroke</strong>.</p>
-<p>In the ZBrush-style layout, the palette bar lists <strong>File</strong> and <strong>Edit</strong> first and <strong>Help</strong> last, where other desktop applications put them, and the rest in alphabetical order. If you prefer ZBrush&#x27;s strict A to Z order, turn on <strong>Edit &gt; Preferences &gt; Interface &gt; Palettes strictly A-Z (ZBrush order)</strong>.</p>
-<div class="table-wrap"><table><thead><tr><th>Palette</th><th>In the SculptForge layout</th><th>What&#x27;s in it</th></tr></thead><tbody><tr><td><strong>File</strong></td><td>File</td><td>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), Send to ZBrush, Quit</td></tr><tr><td><strong>Edit</strong></td><td>Edit</td><td>Undo and Redo (with the name of the step), Paste brush</td></tr><tr><td><strong>Alpha</strong></td><td>Sculpt &gt; Alpha</td><td>The brush alphas: Round, Square, Noise and twelve patterns (Pores, Cracks, Scales...), images from your library, Load image, Invert loaded image</td></tr><tr><td><strong>Brush</strong></td><td>Sculpt &gt; Brush</td><td>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</td></tr><tr><td><strong>Color</strong></td><td>Paint</td><td>The Paint brush, RGB while sculpting, the paint colour and swatches, Fill, Fill masked, Cavity, Clear, Show vertex paint</td></tr><tr><td><strong>Draw</strong></td><td>Sculpt &gt; Draw &amp; Tablet</td><td>Draw Size, Intensity, RGB Intensity, Falloff, Sculpt/Paint, Add/Sub, Rgb, Front, and the tablet options (Pressure &gt; strength, Pressure &gt; size) with a pen readout</td></tr><tr><td><strong>Generate</strong></td><td>Mesh &gt; Generate 3D</td><td>Generate 3D (image or text to 3D), Relief, Inflate and Stamp from an image, and the AI brush provider settings</td></tr><tr><td><strong>Material</strong></td><td>Render &gt; Materials</td><td>The Lit Sphere materials (Soft Clay, the default, first), your own (<strong>Load Lit Sphere...</strong>) and Studio, Base colour, Smooth / Flat shading for the scene and the active Part</td></tr><tr><td><strong>Preferences</strong></td><td>Edit &gt; Preferences</td><td>Config, Interface, Input, Hotkeys, Display, Library, Tablet, Performance, Updates and Autosave sub-palettes (see <a href="#customizing-the-interface">Customizing the interface</a>)</td></tr><tr><td><strong>Render</strong></td><td>View</td><td>Wireframe, Show Mesh, Show Vertex Paint, Show Mask, Show Face Groups, Show Splats, Background, Frame, Fullscreen</td></tr><tr><td><strong>Script</strong></td><td>File &gt; Script</td><td>Console, Run script file, Copy session as script, Clear console</td></tr><tr><td><strong>Splats</strong></td><td>Render &gt; Gaussian Splats</td><td>Gaussian splat tools: show, flip, turn, fit, clean floaters, Make sculptable, sculpt to splats, save, clear</td></tr><tr><td><strong>Stroke</strong></td><td>Sculpt &gt; Stroke</td><td>The stroke types (Dots, Drag Stamp, Spray, Lazy Stroke) and their settings</td></tr><tr><td><strong>Tool</strong></td><td>Mesh &gt; Parts &amp; Geometry, and the right tray</td><td>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</td></tr><tr><td><strong>Transform</strong></td><td>Sculpt &gt; Symmetry &amp; Gizmo</td><td>Draw, Move, Scale and Rotate (the <a href="gizmo.html">Gizmo</a> with its pivot, axes, options and numeric entry), Symmetry X, Y and Z, Frame, Solo, Wire</td></tr><tr><td><strong>Help</strong></td><td>Help</td><td>Controls, User Guide, What&#x27;s New, Command palette, Website &amp; documentation, Report a problem, Support SculptForge..., About SculptForge</td></tr></tbody></table></div>
+<p>Menu paths in this guide name what you click in the SculptForge layout: <strong>Edit &gt; Preferences &gt; Input</strong> is the <strong>Edit</strong> menu, its <strong>Preferences</strong> section, then the <strong>Input</strong> sub-palette. <strong>File</strong> and <strong>Edit</strong> have a section of the same name, which paths leave out (<strong>File &gt; Save</strong>). Paths starting with <strong>Tool</strong> are in the Tool panel in the right tray, in both layouts (it is also <strong>Mesh &gt; Parts &amp; Geometry</strong>). In the Classic layout, drop the menu: <strong>Edit &gt; Preferences &gt; Input</strong> is <strong>Input</strong> in the palette named <strong>Preferences</strong>, and <strong>Sculpt &gt; Stroke</strong> is the palette named <strong>Stroke</strong>.</p>
+<p>In the Classic layout, the palette bar lists <strong>File</strong> and <strong>Edit</strong> first and <strong>Help</strong> last, where other desktop applications put them, and the rest in alphabetical order. If you prefer strict A to Z order, turn on <strong>Edit &gt; Preferences &gt; Interface &gt; Palettes strictly A-Z (strict order)</strong>.</p>
+<div class="table-wrap"><table><thead><tr><th>Palette</th><th>In the SculptForge layout</th><th>What&#x27;s in it</th></tr></thead><tbody><tr><td><strong>File</strong></td><td>File</td><td>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</td></tr><tr><td><strong>Edit</strong></td><td>Edit</td><td>Undo and Redo (with the name of the step), Paste brush</td></tr><tr><td><strong>Alpha</strong></td><td>Sculpt &gt; Alpha</td><td>The brush alphas: Round, Square, Noise and twelve patterns (Pores, Cracks, Scales...), images from your library, Load image, Invert loaded image</td></tr><tr><td><strong>Brush</strong></td><td>Sculpt &gt; Brush</td><td>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</td></tr><tr><td><strong>Color</strong></td><td>Paint</td><td>The Paint brush, RGB while sculpting, the paint colour and swatches, Fill, Fill masked, Cavity, Clear, Show vertex paint</td></tr><tr><td><strong>Draw</strong></td><td>Sculpt &gt; Draw &amp; Tablet</td><td>Draw Size, Intensity, RGB Intensity, Falloff, Sculpt/Paint, Add/Sub, Rgb, Front, and the tablet options (Pressure &gt; strength, Pressure &gt; size) with a pen readout</td></tr><tr><td><strong>Generate</strong></td><td>Mesh &gt; Generate 3D</td><td>Generate 3D (image or text to 3D), Relief, Inflate and Stamp from an image, and the AI brush provider settings</td></tr><tr><td><strong>Material</strong></td><td>Render &gt; Materials</td><td>The Lit Sphere materials (Soft Clay, the default, first), your own (<strong>Load Lit Sphere...</strong>) and Studio, Base colour, Smooth / Flat shading for the scene and the active Part</td></tr><tr><td><strong>Preferences</strong></td><td>Edit &gt; Preferences</td><td>Config, Interface, Input, Hotkeys, Display, Library, Tablet, Performance, Updates and Autosave sub-palettes (see <a href="#customizing-the-interface">Customizing the interface</a>)</td></tr><tr><td><strong>Render</strong></td><td>View</td><td>Wireframe, Show Mesh, Show Vertex Paint, Show Mask, Show Face Groups, Show Splats, Background, Frame, Fullscreen</td></tr><tr><td><strong>Script</strong></td><td>File &gt; Script</td><td>Console, Run script file, Copy session as script, Clear console</td></tr><tr><td><strong>Splats</strong></td><td>Render &gt; Gaussian Splats</td><td>Gaussian splat tools: show, flip, turn, fit, clean floaters, Make sculptable, sculpt to splats, save, clear</td></tr><tr><td><strong>Stroke</strong></td><td>Sculpt &gt; Stroke</td><td>The stroke types (Dots, Drag Stamp, Spray, Lazy Stroke) and their settings</td></tr><tr><td><strong>Tool</strong></td><td>Mesh &gt; Parts &amp; Geometry, and the right tray</td><td>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</td></tr><tr><td><strong>Transform</strong></td><td>Sculpt &gt; Symmetry &amp; Gizmo</td><td>Draw, Move, Scale and Rotate (the <a href="gizmo.html">Gizmo</a> with its pivot, axes, options and numeric entry), Symmetry X, Y and Z, Frame, Solo, Wire</td></tr><tr><td><strong>Help</strong></td><td>Help</td><td>Controls, User Guide, What&#x27;s New, Command palette, Website &amp; documentation, Report a problem, Support SculptForge..., About SculptForge</td></tr></tbody></table></div>
<h3 id="sub-palettes">Sub-palettes<a class="anchor" href="#sub-palettes" aria-label="Link to this section">#</a></h3>
<p>Large palettes are divided into <strong>sub-palettes</strong>: 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. <strong>Shift</strong>+click a header to open it without closing the others, or turn off <strong>Edit &gt; Preferences &gt; Interface &gt; One sub-palette open</strong>.</p>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> as in ZBrush, Parts (ZBrush&#x27;s SubTool), Layers, Masking, Face Groups (Polygroups) and Visibility are sub-palettes of the Tool palette rather than palettes of their own. SculptForge&#x27;s Remesh sub-palette is where ZBrush&#x27;s DynaMesh would be.</p></aside>
<h2 id="trays">Trays<a class="anchor" href="#trays" aria-label="Link to this section">#</a></h2>
<p>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 <strong>Tool</strong> palette; the left tray starts closed and empty.</p>
<ul>
@@ -166,7 +165,7 @@
<strong>Collapse it in place</strong>: click its title (or the arrow at the right of the header).
</li>
<li>
-<strong>Find it</strong>: a palette that is in a tray shows a tray icon beside its name in its menu (in the palette bar of the ZBrush-style layout, its name in the accent colour). Clicking the name scrolls the tray to the palette and flashes its header.
+<strong>Find it</strong>: 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.
</li>
<li>
<strong>Open or close a tray</strong>: click its divider, the thin strip with a grip between the tray and the shelves. <strong>Drag</strong> the divider to make the tray wider or narrower (240 to 480 pixels).
@@ -205,8 +204,8 @@
<strong>X</strong>, <strong>Y</strong>, <strong>Z</strong>: symmetry across each axis (<kbd>X</kbd> toggles X); <strong>R</strong> is radial symmetry.
</li>
</ul>
-<p>The ZBrush-style layout&#x27;s top shelf has two rows: <strong>Library</strong> (<kbd>,</kbd>), Sculpt/Paint, Add/Sub, Rgb, Draw Size and Intensity on the first; <strong>AI Brush</strong>, <strong>Front</strong>, symmetry, <strong>Pressure &gt; Strength</strong> and <strong>Pressure &gt; Size</strong>, and the <strong>ActiveTris / TotalTris</strong> count on the second. In the SculptForge layout these are in the <strong>Sculpt</strong> menu (AI Brush, Front, pressure) and <strong>View</strong> menu (Library).</p>
-<p>Draw Size and Intensity are sliders with the label inside, as in ZBrush: drag along them, or <kbd>Ctrl</kbd>+click to type a value.</p>
+<p>The Classic layout&#x27;s top shelf has two rows: <strong>Library</strong> (<kbd>,</kbd>), Sculpt/Paint, Add/Sub, Rgb, Draw Size and Intensity on the first; <strong>AI Brush</strong>, <strong>Front</strong>, symmetry, <strong>Pressure &gt; Strength</strong> and <strong>Pressure &gt; Size</strong>, and the <strong>ActiveTris / TotalTris</strong> count on the second. In the SculptForge layout these are in the <strong>Sculpt</strong> menu (AI Brush, Front, pressure) and <strong>View</strong> menu (Library).</p>
+<p>Draw Size and Intensity are sliders with the label inside: drag along them, or <kbd>Ctrl</kbd>+click to type a value.</p>
<h3 id="left-shelf">Left shelf<a class="anchor" href="#left-shelf" aria-label="Link to this section">#</a></h3>
<p>Four large tiles, each showing the current choice. Click one to open its <a href="#pop-up-pickers">pop-up picker</a>:</p>
<ul>
@@ -223,7 +222,7 @@
<strong>Material</strong>: how the model is shaded in the view.
</li>
</ul>
-<p>Under them is the <strong>colour picker</strong> for vertex paint (a saturation/value square and a hue strip), two swatches (the main and second colour; click either to swap them, like ZBrush&#x27;s Alternate) and <strong>Fill</strong>, which fills the unmasked area with the main colour.</p>
+<p>Under them is the <strong>colour picker</strong> for vertex paint (a saturation/value square and a hue strip), two swatches and <strong>Fill</strong>, which fills the unmasked area with the main colour.</p>
<h3 id="right-shelf">Right shelf<a class="anchor" href="#right-shelf" aria-label="Link to this section">#</a></h3>
<ul>
<li>
@@ -233,7 +232,7 @@
<strong>Frame</strong> (<kbd>F</kbd>): fits the model in the view.
</li>
<li>
-<strong>Move</strong>, <strong>Zoom</strong>, <strong>Rotate</strong>: drag on these buttons to pan, zoom and orbit the view, as in ZBrush.
+<strong>Move</strong>, <strong>Zoom</strong>, <strong>Rotate</strong>: drag on these buttons to pan, zoom and orbit the view.
</li>
<li>
<strong>Wire</strong> (<kbd>Shift</kbd>+<kbd>F</kbd>): shows the mesh&#x27;s polygons: quads as quads, triangles as triangles.
@@ -274,7 +273,7 @@
<h3 id="brush-picker">Brush picker<a class="anchor" href="#brush-picker" aria-label="Link to this section">#</a></h3>
<p>Press <kbd>B</kbd> (or click the Brush tile). The picker shows a <strong>Recent</strong> row, then <strong>Built-in</strong>, <strong>Custom</strong> (your brushes and Brush Lab creations) and <strong>Library</strong> (<code>.sfbrush</code> files in your library that aren&#x27;t loaded yet; picking one loads it).</p>
<figure class="shot"><a href="images/brush-picker.jpg" class="zoom"><img src="images/brush-picker.jpg" alt="The brush picker after pressing B and typing S" width="475" height="332" loading="lazy" decoding="async"></a><figcaption>The brush picker after pressing B and typing S</figcaption></figure>
-<p>Choose a brush with the keyboard the ZBrush way:</p>
+<p>Choose a brush with the keyboard:</p>
<ol>
<li>
Press <kbd>B</kbd>.
@@ -301,10 +300,10 @@ Press that orange letter to pick the brush. For example <kbd>B</kbd> <kbd>S</kbd
</li>
</ul>
<h3 id="sliders-at-the-cursor-and-the-quick-menu">Sliders at the cursor and the Quick Menu<a class="anchor" href="#sliders-at-the-cursor-and-the-quick-menu" aria-label="Link to this section">#</a></h3>
-<p>As in ZBrush, press <kbd>S</kbd> for a Draw Size slider under the mouse, <kbd>U</kbd> for Intensity, <kbd>I</kbd> for RGB Intensity or <kbd>O</kbd> for Falloff. Drag the slider, or type a number and press <kbd>Enter</kbd> (<kbd>Esc</kbd> cancels). The pop-up closes when you release the slider. <kbd>[</kbd> and <kbd>]</kbd> make the brush 10% smaller or larger at any time. <kbd>Space</kbd> (or a right click on the canvas) opens the Quick Menu with all of them and the brush, stroke, alpha and material (see <a href="sculpting.html#the-quick-menu">The Quick Menu</a>).</p>
+<p>Press <kbd>S</kbd> for a Draw Size slider under the mouse, <kbd>U</kbd> for Intensity, <kbd>I</kbd> for RGB Intensity or <kbd>O</kbd> for Falloff. Drag the slider, or type a number and press <kbd>Enter</kbd> (<kbd>Esc</kbd> cancels). The pop-up closes when you release the slider. <kbd>[</kbd> and <kbd>]</kbd> make the brush 10% smaller or larger at any time. <kbd>Space</kbd> (or a right click on the canvas) opens the Quick Menu with all of them and the brush, stroke, alpha and material (see <a href="sculpting.html#the-quick-menu">The Quick Menu</a>).</p>
<h2 id="the-library">The Library<a class="anchor" href="#the-library" aria-label="Link to this section">#</a></h2>
<p>The Library is a strip of thumbnails across the top of the canvas for browsing everything you can load. Press <kbd>,</kbd> (comma) or click <strong>Library</strong> on the top shelf to show or hide it. It opens on its own at start-up (see <a href="#interface-preferences">Preferences</a>).</p>
-<figure class="shot"><a href="images/lightbox.jpg" class="zoom"><img src="images/lightbox.jpg" alt="The Library on the Tool tab" width="930" height="145" loading="lazy" decoding="async"></a><figcaption>The Library on the Tool tab</figcaption></figure>
+<figure class="shot"><a href="images/library.jpg" class="zoom"><img src="images/library.jpg" alt="The Library on the Tool tab" width="930" height="145" loading="lazy" decoding="async"></a><figcaption>The Library on the Tool tab</figcaption></figure>
<div class="table-wrap"><table><thead><tr><th>Tab</th><th>Shows</th><th>Double-click</th></tr></thead><tbody><tr><td><strong>Project</strong></td><td>Projects (<code>.sfproj</code>) in your library and recently opened projects</td><td>Open the project</td></tr><tr><td><strong>Tool</strong></td><td>Sphere, Plane and Cube, and model files in your library</td><td>Open (replaces the scene)</td></tr><tr><td><strong>Brush</strong></td><td>Every brush: built-in, custom and <code>.sfbrush</code> files, and the VDM brushes (built-in ones too)</td><td>Select or load the brush</td></tr><tr><td><strong>Alpha</strong></td><td>Round, Square, Noise, the twelve built-in patterns and images in your Alphas folder</td><td>Use as the brush alpha</td></tr><tr><td><strong>Material</strong></td><td>The Lit Spheres (your own included) and Studio</td><td>Use the material</td></tr><tr><td><strong>Image</strong></td><td>Reference images in your library</td><td>A menu: Generate 3D, relief, inflate, project onto the model, use as alpha</td></tr><tr><td><strong>Splats</strong></td><td>Gaussian splat captures (<code>.ply</code>, <code>.splat</code>)</td><td>Open the capture as a reference</td></tr><tr><td><strong>Snapshots</strong></td><td>The autosave and your snapshots, newest first</td><td>Open it</td></tr><tr><td><strong>Recent</strong></td><td>Recently opened files of every kind</td><td>Open it</td></tr></tbody></table></div>
<p>Working with the strip:</p>
<ul>
@@ -340,7 +339,6 @@ Right-click a tile for <strong>Open</strong>, <strong>Append as Part</strong>, t
</li>
</ul>
<p>At the root of the Tool and Image tabs is a <strong>Built-in</strong> 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 <strong>User</strong> folder, your library folder (<strong>Documents/SculptForge</strong> by default). To use a different library folder, choose it in <strong>Edit &gt; Preferences &gt; Library &gt; Library folder</strong>.</p>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> the Library works like ZBrush&#x27;s LightBox: comma toggles it, double-click loads, and Built-in and User folders play the part of ZBrush&#x27;s Maxon and User folders.</p></aside>
<h2 id="getting-help-on-anything">Getting help on anything<a class="anchor" href="#getting-help-on-anything" aria-label="Link to this section">#</a></h2>
<h3 id="ctrl-hover-help">Ctrl-hover help<a class="anchor" href="#ctrl-hover-help" aria-label="Link to this section">#</a></h3>
<p>Hold <kbd>Ctrl</kbd> and point at any button, slider, tile or shelf item. A box shows the item&#x27;s name, its shortcut as keycaps, what it does, where it lives (for example &quot;Tool &gt; Geometry&quot;) and the script command it runs.</p>
@@ -389,7 +387,7 @@ Commands with a required parameter (for example <code>image_relief path=</code>)
</ul>
<p>Everything scriptable is in the command palette, including commands that have no button in the interface.</p>
<h2 id="the-console">The console<a class="anchor" href="#the-console" aria-label="Link to this section">#</a></h2>
-<p>Press <kbd>`</kbd> (the backtick key, left of <kbd>1</kbd> on US keyboards) to open the console, a strip between the canvas and the bottom shelf. It works like ZBrush&#x27;s ZScript window:</p>
+<p>Press <kbd>`</kbd> (the backtick key, left of <kbd>1</kbd> on US keyboards) to open the console, a strip between the canvas and the bottom shelf. It works:</p>
<ul>
<li>
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.
@@ -407,7 +405,7 @@ Drag the console&#x27;s top edge to make it taller or shorter.
<figure class="shot"><a href="images/console.jpg" class="zoom"><img src="images/console.jpg" alt="The console after a few commands" width="1100" height="145" loading="lazy" decoding="async"></a><figcaption>The console after a few commands</figcaption></figure>
<p>See <a href="scripting.html">Scripting and automation</a> for the command language, scripts and headless use.</p>
<h2 id="customizing-the-interface">Customizing the interface<a class="anchor" href="#customizing-the-interface" aria-label="Link to this section">#</a></h2>
-<p>Everything about the layout can change: which palettes sit in the trays, what&#x27;s on each shelf, and which keys do what. As in ZBrush, <strong>changes last until you quit</strong> unless you store them with <strong>Store Config</strong>.</p>
+<p>Everything about the layout can change: which palettes sit in the trays, what&#x27;s on each shelf, and which keys do what. <strong>Changes last until you quit</strong> unless you store them with <strong>Store Config</strong>.</p>
<h3 id="move-add-and-remove-shelf-items">Move, add and remove shelf items<a class="anchor" href="#move-add-and-remove-shelf-items" aria-label="Link to this section">#</a></h3>
<ol>
<li>
@@ -446,12 +444,11 @@ Or open <strong>Edit &gt; Preferences &gt; Hotkeys</strong>, find the action (th
Or double-click a row in the Controls window (<kbd>F1</kbd>).
</li>
</ul>
-<p>If the key already belongs to another action, it moves to the new one (as in ZBrush) and the status line says which action lost it.</p>
+<p>If the key already belongs to another action, it moves to the new one and the status line says which action lost it.</p>
<h3 id="store-config-and-friends">Store Config and friends<a class="anchor" href="#store-config-and-friends" aria-label="Link to this section">#</a></h3>
<p>All in <strong>Edit &gt; Preferences &gt; Config</strong>:</p>
<div class="table-wrap"><table><thead><tr><th>Item</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Store Config</strong> (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd>)</td><td>Keeps the current layout, shortcuts and interface preferences for future sessions</td></tr><tr><td><strong>Restore Custom UI</strong></td><td>Goes back to what the last Store Config saved</td></tr><tr><td><strong>Restore Standard UI</strong></td><td>Goes back to the built-in layout and default shortcuts (Store Config afterwards to make it stick)</td></tr><tr><td><strong>Save UI...</strong></td><td>Saves the layout, shortcuts and preferences to a <code>.json</code> file you can share</td></tr><tr><td><strong>Load UI...</strong> (<kbd>Ctrl</kbd>+<kbd>L</kbd>)</td><td>Loads such a file (Store Config afterwards to keep it)</td></tr></tbody></table></div>
<p>The first time you change the layout in a session, the status line reminds you once: &quot;Layout changed - Ctrl+Shift+I to keep it&quot;. What a session changes by itself (the console and Library being open, the Library tab) doesn&#x27;t count as a layout change.</p>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> Store Config has the same shortcut as in ZBrush, and SculptForge never saves the layout on its own either.</p></aside>
<h3 id="layout-presets">Layout presets<a class="anchor" href="#layout-presets" aria-label="Link to this section">#</a></h3>
<p>The <strong>1</strong>, <strong>2</strong> and <strong>3</strong> buttons at the top right (also in <strong>Edit &gt; Preferences &gt; Config</strong>) switch between three arrangements of the current layout:</p>
<ol>
@@ -468,17 +465,16 @@ Or double-click a row in the Controls window (<kbd>F1</kbd>).
<p>A preset changes the layout only (the console, Library and left-handed setting stay as they are). Store Config keeps it.</p>
<h3 id="interface-preferences">Interface preferences<a class="anchor" href="#interface-preferences" aria-label="Link to this section">#</a></h3>
<p><strong>Edit &gt; Preferences &gt; Interface</strong>:</p>
-<div class="table-wrap"><table><thead><tr><th>Setting</th><th>Default</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Look</strong>, <strong>Outlines</strong> and <strong>Layout</strong></td><td>Forge Terminal, Neutral, Subtle, SculptForge</td><td>See <a href="#looks-and-layouts">Looks and layouts</a></td></tr><tr><td><strong>Language</strong></td><td>English</td><td>The interface language: <strong>English</strong> or <strong>Español</strong> (see below)</td></tr><tr><td><strong>Popup Info (Ctrl+hover help)</strong></td><td>On</td><td>Ctrl-hover help boxes</td></tr><tr><td><strong>Popup Info opacity</strong></td><td>0.97</td><td>How solid the help box is</td></tr><tr><td><strong>Tooltip delay</strong></td><td>0.5 s</td><td>How long to point at an icon-only button before its name appears</td></tr><tr><td><strong>Reduce motion</strong></td><td>Off</td><td>Hover and focus highlights change colour only: no easing, and tiles don&#x27;t lift</td></tr><tr><td><strong>One sub-palette open</strong></td><td>On</td><td>Opening a sub-palette closes the others in that palette</td></tr><tr><td><strong>Auto collapse left tray</strong> / <strong>right tray</strong></td><td>On / Off</td><td>Collapse other palettes in the tray when one wouldn&#x27;t fit</td></tr><tr><td><strong>Palettes strictly A-Z (ZBrush order)</strong></td><td>Off</td><td>ZBrush-style layout: strict alphabetical palette bar instead of File and Edit first, Help last</td></tr><tr><td><strong>Left-handed layout</strong></td><td>Off</td><td>Mirrors the shelves and trays: tools on the right, navigation on the left</td></tr><tr><td><strong>UI scale</strong></td><td>Automatic</td><td>Size of text and controls (100% to 200%), applied at once; Automatic follows the monitor (see below)</td></tr><tr><td><strong>Camera notch</strong></td><td>Automatic</td><td>Keeps the interface below a laptop&#x27;s camera notch in fullscreen (see below)</td></tr></tbody></table></div>
+<div class="table-wrap"><table><thead><tr><th>Setting</th><th>Default</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Look</strong>, <strong>Outlines</strong> and <strong>Layout</strong></td><td>Forge Terminal, Neutral, Subtle, SculptForge</td><td>See <a href="#looks-and-layouts">Looks and layouts</a></td></tr><tr><td><strong>Language</strong></td><td>English</td><td>The interface language: <strong>English</strong> or <strong>Español</strong> (see below)</td></tr><tr><td><strong>Popup Info (Ctrl+hover help)</strong></td><td>On</td><td>Ctrl-hover help boxes</td></tr><tr><td><strong>Popup Info opacity</strong></td><td>0.97</td><td>How solid the help box is</td></tr><tr><td><strong>Tooltip delay</strong></td><td>0.5 s</td><td>How long to point at an icon-only button before its name appears</td></tr><tr><td><strong>Reduce motion</strong></td><td>Off</td><td>Hover and focus highlights change colour only: no easing, and tiles don&#x27;t lift</td></tr><tr><td><strong>One sub-palette open</strong></td><td>On</td><td>Opening a sub-palette closes the others in that palette</td></tr><tr><td><strong>Auto collapse left tray</strong> / <strong>right tray</strong></td><td>On / Off</td><td>Collapse other palettes in the tray when one wouldn&#x27;t fit</td></tr><tr><td><strong>Palettes strictly A-Z (strict order)</strong></td><td>Off</td><td>Classic layout: strict alphabetical palette bar instead of File and Edit first, Help last</td></tr><tr><td><strong>Left-handed layout</strong></td><td>Off</td><td>Mirrors the shelves and trays: tools on the right, navigation on the left</td></tr><tr><td><strong>UI scale</strong></td><td>Automatic</td><td>Size of text and controls (100% to 200%), applied at once; Automatic follows the monitor (see below)</td></tr><tr><td><strong>Camera notch</strong></td><td>Automatic</td><td>Keeps the interface below a laptop&#x27;s camera notch in fullscreen (see below)</td></tr></tbody></table></div>
<p><strong>Language</strong> changes the interface at once, without a restart; Store Config keeps it for the next start. In <strong>Español</strong> 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. Anything not translated yet (most Ctrl-help descriptions, this guide) shows in English. Scripts and <code>sculptforge-cli</code> commands are the same in every language.</p>
<p><strong>UI scale</strong> also applies at once: text, buttons, shelves and trays resize on the next frame; Store Config keeps it. <strong>Automatic</strong> uses the scale of the monitor the window is on (Windows: <strong>Settings &gt; Display &gt; Scale</strong>; macOS and Wayland: the display&#x27;s scaling; X11: the desktop&#x27;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.</p>
<p><strong>Edit &gt; Preferences &gt; Cursor</strong>:</p>
<div class="table-wrap"><table><thead><tr><th>Setting</th><th>Default</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Viewport cursor</strong></td><td>Crosshair</td><td>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</td></tr><tr><td><strong>Cursor follows surface</strong></td><td>On</td><td>The brush ring lies on the model: a true circle at the brush&#x27;s real size, in the plane of the surface (averaged over the brush, so bumps don&#x27;t bend it), with a short line along the surface&#x27;s direction. Symmetry and radial copies show as dots where their dabs land. Off: a flat ring on the screen</td></tr><tr><td><strong>Hide ring while stroking</strong></td><td>Off</td><td>While a stroke runs, only the dot where the brush touches (and the symmetry dots) shows, not the ring</td></tr></tbody></table></div>
<p><strong>Edit &gt; Preferences &gt; Hints</strong>: <strong>Show hints in the viewport</strong> (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 <strong>Don&#x27;t show again</strong>; <strong>Show all hints again</strong> brings them all back. Store Config keeps them.</p>
<p><strong>Scrolling panels with a pen</strong>: on small screens a palette or tray that doesn&#x27;t fit scrolls with the mouse wheel, and also with a <strong>left-drag on empty space</strong> in it (between and beside the controls) or a <strong>middle-drag anywhere</strong> on it, as you would scroll a list with a finger (#100).</p>
-<p><strong>Edit &gt; Preferences &gt; Input</strong> sets the key <strong>Style</strong> (the first start sets it from your <strong>Coming from</strong> answer): <strong>SculptForge</strong> (the default for new installs): <kbd>1</kbd> to <kbd>9</kbd> and <kbd>0</kbd> pick the first ten brushes, <kbd>I</kbd> opens Intensity like <kbd>U</kbd>, and <kbd>Ctrl</kbd>+drag on the background zooms when nothing is masked; <strong>ZBrush-style</strong>: ZBrush&#x27;s keys, with the number keys free (<kbd>9</kbd> is Save Snapshot), <kbd>I</kbd> for RGB Intensity and <kbd>Ctrl</kbd>+drag on the background for a mask rectangle (see <a href="shortcuts.html#zbrush-style-keys">ZBrush-style keys</a>); <strong>Maya</strong>: Maya&#x27;s view controls; or <strong>Blender</strong>: middle-drag navigation, the numpad views and Blender&#x27;s sculpt-mode keys (see <a href="shortcuts.html#blender-keys">Blender keys</a>). In the Blender style, <strong>Emulate Numpad</strong> makes the number row work as the numpad, and <strong>Import Blender keymap...</strong> takes the keys from a keymap you exported in Blender. <strong>Right click opens the Quick Menu</strong> (on by default, in every style) opens the <a href="sculpting.html#the-quick-menu">Quick Menu</a> with a right click on the canvas; a right drag navigates either way. <strong>Hold Space and drag to move the camera</strong> (off by default) turns <kbd>Space</kbd> into a camera key: held, left-drag rotates, right- or middle-drag pans and <kbd>Ctrl</kbd>+drag zooms (see <a href="navigation.html#mouse-and-pen">Navigation</a>). <strong>Radial Menus</strong> edits your pie menus and their keys (see <a href="sculpting.html#radial-menus">Radial menus</a>). <strong>Cursor follows surface</strong> (on by default) lays the brush rings on the model under the pointer (see <a href="sculpting.html#draw-size-intensity-rgb-intensity-and-falloff">Draw Size and Falloff</a>); off, they are flat circles on the screen. <strong>Rotation</strong> chooses free rotation (ZBrush) or a turntable. See <a href="coming-from-zbrush.html">Coming from ZBrush</a>.</p>
+<p><strong>Edit &gt; Preferences &gt; Input</strong> sets the key <strong>Style</strong> (the first start sets it from your <strong>Coming from</strong> answer): <strong>SculptForge</strong> (the default for new installs): <kbd>1</kbd> to <kbd>9</kbd> and <kbd>0</kbd> pick the first ten brushes, <kbd>I</kbd> opens Intensity like <kbd>U</kbd>, and <kbd>Ctrl</kbd>+drag on the background zooms when nothing is masked; <strong>Classic</strong>: the Classic sculpting keys, with the number keys free (<kbd>9</kbd> is Save Snapshot), <kbd>I</kbd> for RGB Intensity and <kbd>Ctrl</kbd>+drag on the background for a mask rectangle (see <a href="shortcuts.html#classic-sculpting-keys">the Classic sculpting keys</a>); <strong>Maya</strong>: Maya&#x27;s view controls; or <strong>Blender</strong>: middle-drag navigation, the numpad views and Blender&#x27;s sculpt-mode keys (see <a href="shortcuts.html#blender-keys">Blender keys</a>). In the Blender style, <strong>Emulate Numpad</strong> makes the number row work as the numpad, and <strong>Import Blender keymap...</strong> takes the keys from a keymap you exported in Blender. <strong>Right click opens the Quick Menu</strong> (on by default, in every style) opens the <a href="sculpting.html#the-quick-menu">Quick Menu</a> with a right click on the canvas; a right drag navigates either way. <strong>Hold Space and drag to move the camera</strong> (off by default) turns <kbd>Space</kbd> into a camera key: held, left-drag rotates, right- or middle-drag pans and <kbd>Ctrl</kbd>+drag zooms (see <a href="navigation.html#mouse-and-pen">Navigation</a>). <strong>Radial Menus</strong> edits your pie menus and their keys (see <a href="sculpting.html#radial-menus">Radial menus</a>). <strong>Cursor follows surface</strong> (on by default) lays the brush rings on the model under the pointer (see <a href="sculpting.html#draw-size-intensity-rgb-intensity-and-falloff">Draw Size and Falloff</a>); off, they are flat circles on the screen. <strong>Rotation</strong> chooses free rotation or a turntable. See <a href="quick-tour.html">Quick tour for experienced sculptors</a>.</p>
<h3 id="the-background">The background<a class="anchor" href="#the-background" aria-label="Link to this section">#</a></h3>
<p><strong>Edit &gt; Preferences &gt; Display</strong> (and the <strong>View</strong> menu) sets the view&#x27;s <strong>Background</strong>: <strong>Gradient</strong>, the charcoal radial gradient (the default), or <strong>Flat Colour</strong>, one solid colour without the gradient. Click the <strong>Background colour</strong> swatch to pick the colour; picking one switches to Flat Colour. <strong>Store Config</strong> keeps the choice for the next session, and each project keeps the background it was saved with. From a script: <code>set_background mode=flat</code>, <code>set_background color=60,70,80</code> or <code>set_background mode=gradient</code>.</p>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> like turning the gradient off in the Document palette (<strong>Range</strong> 0) and choosing the <strong>Back</strong> colour.</p></aside>
<p><strong>Edit &gt; Preferences &gt; Library</strong> has <strong>Show at startup</strong> (on by default), the number of <strong>Rows</strong>, <strong>Placement</strong> (along the top of the canvas, or at the bottom above the bottom shelf) and the <strong>Library folder</strong>. <strong>Edit &gt; Preferences &gt; Autosave</strong> sets how often a recovery copy is saved (see <a href="projects.html">Projects, autosave and snapshots</a>).</p>
<figure class="shot"><a href="images/preferences.jpg" class="zoom"><img src="images/preferences.jpg" alt="Edit &gt; Preferences with the Config and Interface sub-palettes" width="535" height="960" loading="lazy" decoding="async"></a><figcaption>Edit &gt; Preferences with the Config and Interface sub-palettes</figcaption></figure>
<h3 id="fullscreen-hiding-panels-and-the-camera-notch">Fullscreen, hiding panels and the camera notch<a class="anchor" href="#fullscreen-hiding-panels-and-the-camera-notch" aria-label="Link to this section">#</a></h3>
@@ -487,7 +483,7 @@ Or double-click a row in the Controls window (<kbd>F1</kbd>).
<kbd>F11</kbd> (or <strong>View &gt; Fullscreen</strong>) fills the screen with SculptForge; press it again to go back to a window. <code>sculptforge --fullscreen</code> 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 <kbd>F11</kbd> or the green button to go full screen again).
</li>
<li>
-In the ZBrush-style layout, <strong>Menus</strong> in the title strip hides the palette bar; click it again to bring it back.
+In the Classic layout, <strong>Menus</strong> in the title strip hides the palette bar; click it again to bring it back.
</li>
<li>
<kbd>Tab</kbd> hides the shelves and trays.
@@ -516,7 +512,7 @@ On MacBooks with a camera notch, SculptForge keeps the interface below the notch
<p class="guide-meta fine">Also in the app: <strong>Help &gt; User Guide</strong> (<kbd>Shift</kbd>+<kbd>F1</kbd>).
Found a mistake? <a href="https://github.com/islandmed/SculptForge/edit/main/docs/guide/interface.md">Edit this page on GitHub</a>.</p>
</main>
- <aside class="on-page" aria-label="On this page"><p>On this page</p><ul><li><a href="#the-regions-at-a-glance">The regions at a glance</a></li><li><a href="#looks-and-layouts">Looks and layouts</a></li><li><a href="#turning-ai-off">Turning AI off</a></li><li><a href="#the-menu-bar">The menu bar</a></li><li><a href="#the-title-strip-zbrush-style-layout">The title strip (ZBrush-style layout)</a></li><li><a href="#menus-and-palettes">Menus and palettes</a></li><li><a href="#trays">Trays</a></li><li><a href="#the-shelves">The shelves</a></li><li><a href="#pop-up-pickers">Pop-up pickers</a></li><li><a href="#the-library">The Library</a></li><li><a href="#getting-help-on-anything">Getting help on anything</a></li><li><a href="#the-command-palette">The command palette</a></li><li><a href="#the-console">The console</a></li><li><a href="#customizing-the-interface">Customizing the interface</a></li><li><a href="#see-also">See also</a></li></ul></aside>
+ <aside class="on-page" aria-label="On this page"><p>On this page</p><ul><li><a href="#the-regions-at-a-glance">The regions at a glance</a></li><li><a href="#looks-and-layouts">Looks and layouts</a></li><li><a href="#turning-ai-off">Turning AI off</a></li><li><a href="#the-menu-bar">The menu bar</a></li><li><a href="#the-title-strip-classic-layout">The title strip (Classic layout)</a></li><li><a href="#menus-and-palettes">Menus and palettes</a></li><li><a href="#trays">Trays</a></li><li><a href="#the-shelves">The shelves</a></li><li><a href="#pop-up-pickers">Pop-up pickers</a></li><li><a href="#the-library">The Library</a></li><li><a href="#getting-help-on-anything">Getting help on anything</a></li><li><a href="#the-command-palette">The command palette</a></li><li><a href="#the-console">The console</a></li><li><a href="#customizing-the-interface">Customizing the interface</a></li><li><a href="#see-also">See also</a></li></ul></aside>
</div>
<footer class="footer">
<div class="wrap footer-grid">
@@ -533,8 +529,7 @@ On MacBooks with a camera notch, SculptForge keeps the interface below the notch
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/layers.html b/website/guide/layers.html
index 6b593229..477b0255 100644
--- a/website/guide/layers.html
+++ b/website/guide/layers.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Sculpt layers and blend shapes - SculptForge User Guide">
<meta property="og:description" content="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 chapt">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/layers.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html" class="current" aria-current="page">Sculpt layers and blend shapes</a><ul class="toc-sections"><li><a href="#how-layers-work">How layers work</a></li><li><a href="#the-layers-sub-palette">The Layers sub-palette</a></li><li><a href="#add-a-layer-and-sculpt-into-it">Add a layer and sculpt into it</a></li><li><a href="#adjust-and-preview-weights">Adjust and preview weights</a></li><li><a href="#delete-a-layer">Delete a layer</a></li><li><a href="#layers-and-subdivision-levels">Layers and subdivision levels</a></li><li><a href="#export-blend-shapes">Export blend shapes</a></li><li><a href="#scripting">Scripting</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html" class="current" aria-current="page">Sculpt layers and blend shapes</a><ul class="toc-sections"><li><a href="#how-layers-work">How layers work</a></li><li><a href="#the-layers-sub-palette">The Layers sub-palette</a></li><li><a href="#add-a-layer-and-sculpt-into-it">Add a layer and sculpt into it</a></li><li><a href="#adjust-and-preview-weights">Adjust and preview weights</a></li><li><a href="#delete-a-layer">Delete a layer</a></li><li><a href="#layers-and-subdivision-levels">Layers and subdivision levels</a></li><li><a href="#export-blend-shapes">Export blend shapes</a></li><li><a href="#scripting">Scripting</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -68,7 +68,7 @@ Layers belong to a <a href="parts.html">Part</a>: each Part has its own list of
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.
</li>
<li>
-Layers work on every <a href="subdivision-levels.html">subdivision level</a>, like ZBrush&#x27;s 3D Layers: see <a href="#layers-and-subdivision-levels">Layers and subdivision levels</a>.
+Layers work on every <a href="subdivision-levels.html">subdivision level</a>: see <a href="#layers-and-subdivision-levels">Layers and subdivision levels</a>.
</li>
<li>
Layers survive <a href="geometry.html#subdivide">subdividing</a>, <a href="geometry.html#decimate">decimating</a> and <a href="geometry.html#lod-chains">LOD chains</a>. A <a href="geometry.html#voxel-remesh">voxel remesh</a> bakes them into the surface (the layers are gone afterwards).
@@ -90,7 +90,7 @@ One block per layer: a radio button with the layer&#x27;s name (select it to scu
A name field and <strong>+ Add</strong> at the bottom.
</li>
</ul>
-<p>The Layers list highlights the active layer; in the ZBrush-style layout the title strip also shows it (<code>Layer Smile</code>, or <code>Layer Base</code>).</p>
+<p>The Layers list highlights the active layer; in the Classic layout the title strip also shows it (<code>Layer Smile</code>, or <code>Layer Base</code>).</p>
<h2 id="add-a-layer-and-sculpt-into-it">Add a layer and sculpt into it<a class="anchor" href="#add-a-layer-and-sculpt-into-it" aria-label="Link to this section">#</a></h2>
<ol>
<li>
@@ -118,7 +118,7 @@ Drag a layer&#x27;s <strong>weight</strong> slider to blend it in and out.
<h2 id="delete-a-layer">Delete a layer<a class="anchor" href="#delete-a-layer" aria-label="Link to this section">#</a></h2>
<p>Click <strong>X</strong> 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>
<h2 id="layers-and-subdivision-levels">Layers and subdivision levels<a class="anchor" href="#layers-and-subdivision-levels" aria-label="Link to this section">#</a></h2>
-<p>With <a href="subdivision-levels.html">subdivision levels</a> a layer works the way ZBrush&#x27;s 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.</p>
+<p>With <a href="subdivision-levels.html">subdivision levels</a> 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.</p>
<ul>
<li>
<strong>Each layer has its own detail on every level.</strong> Step down with <strong>Lower Res</strong> (<kbd>Shift</kbd>+<kbd>D</kbd>) 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.
@@ -146,7 +146,6 @@ Drag a layer&#x27;s <strong>weight</strong> slider to blend it in and out.
<h2 id="export-blend-shapes">Export blend shapes<a class="anchor" href="#export-blend-shapes" aria-label="Link to this section">#</a></h2>
<div class="table-wrap"><table><thead><tr><th>Format</th><th>What layers become</th></tr></thead><tbody><tr><td>glTF / GLB (<strong>File &gt; Export GLB...</strong>, <kbd>Ctrl</kbd>+<kbd>E</kbd>)</td><td>Morph targets</td></tr><tr><td>FBX</td><td>Blend shapes</td></tr><tr><td>USD / USDZ</td><td>UsdSkel blend shapes, with their current weights</td></tr><tr><td>Send to Unreal / Export FBX for Unreal</td><td>A skeletal mesh with morph targets</td></tr><tr><td>LOD chain</td><td>Blend shapes are kept on every LOD</td></tr><tr><td>Project (<code>.sfproj</code>)</td><td>Everything: layers, weights and the active layer</td></tr><tr><td>OBJ, PLY, STL</td><td>The current blended shape only</td></tr></tbody></table></div>
<p>Importing works the other way: glTF morph targets and FBX or USD blend shapes open as sculpt layers. See <a href="exporting.html">Exporting</a>.</p>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> Layers here are close to ZBrush&#x27;s 3D Layers with the slider used as a morph, and they follow subdivision levels the same way. Selecting a layer is its REC; a weight of 0 is its eye. There are no layer folders and no per-layer mask yet.</p></aside>
<h2 id="scripting">Scripting<a class="anchor" href="#scripting" aria-label="Link to this section">#</a></h2>
<div class="table-wrap"><table><thead><tr><th>Command</th><th>What it does</th></tr></thead><tbody><tr><td><code>layer_add name=Smile</code></td><td>Add a layer and make it active</td></tr><tr><td><code>layer_set_active index=0</code></td><td>Choose the layer strokes go into (<code>-1</code> = base mesh)</td></tr><tr><td><code>layer_set_weight index=0 weight=0.5</code></td><td>Set a layer&#x27;s weight (negative or above 1 exaggerates)</td></tr><tr><td><code>layer_remove index=0</code></td><td>Delete a layer</td></tr></tbody></table></div>
<p>Layers are addressed by index, starting at 0 for the top layer.</p>
@@ -185,8 +184,7 @@ Drag a layer&#x27;s <strong>weight</strong> slider to blend it in and out.
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/masking.html b/website/guide/masking.html
index 8a138c2c..334997c7 100644
--- a/website/guide/masking.html
+++ b/website/guide/masking.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Masking - SculptForge User Guide">
<meta property="og:description" content="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 &gt; Masking controls for inverting, b">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/masking.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html" class="current" aria-current="page">Masking</a><ul class="toc-sections"><li><a href="#how-masks-work">How masks work</a></li><li><a href="#paint-a-mask">Paint a mask</a></li><li><a href="#mask-with-a-lasso-or-rectangle">Mask with a lasso or rectangle</a></li><li><a href="#background-gestures">Background gestures</a></li><li><a href="#mask-keys">Mask keys</a></li><li><a href="#the-masking-sub-palette">The Masking sub-palette</a></li><li><a href="#common-tasks">Common tasks</a></li><li><a href="#masks-and-painting">Masks and painting</a></li><li><a href="#masking-from-a-script">Masking from a script</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html" class="current" aria-current="page">Masking</a><ul class="toc-sections"><li><a href="#how-masks-work">How masks work</a></li><li><a href="#paint-a-mask">Paint a mask</a></li><li><a href="#mask-with-a-lasso-or-rectangle">Mask with a lasso or rectangle</a></li><li><a href="#background-gestures">Background gestures</a></li><li><a href="#mask-keys">Mask keys</a></li><li><a href="#the-masking-sub-palette">The Masking sub-palette</a></li><li><a href="#common-tasks">Common tasks</a></li><li><a href="#masks-and-painting">Masks and painting</a></li><li><a href="#masking-from-a-script">Masking from a script</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -63,7 +63,7 @@ A mask is a value per vertex from 0 (free) to 1 (fully masked). Values in betwee
Masks belong to a Part: each Part has its own mask.
</li>
<li>
-Masks are saved in projects (<code>.sfproj</code>) and in <code>.GoZ</code> files, so they survive a round trip to ZBrush.
+Masks are saved in projects (<code>.sfproj</code>) and in Bridge files, so they survive a round trip through the Bridge.
</li>
<li>
Masking is not a layer and isn&#x27;t affected by sculpt layers: a mask stroke always works on the model itself.
@@ -72,7 +72,7 @@ Masking is not a layer and isn&#x27;t affected by sculpt layers: a mask stroke a
Mask strokes and mask commands are undoable like any other change.
</li>
</ul>
-<p>To see the mask, keep <strong>Mask</strong> on in the right shelf (it is on by default; <kbd>Ctrl</kbd>+<kbd>H</kbd> toggles it, as ZBrush&#x27;s View Mask). The same toggle is <strong>Show mask</strong> in <strong>Tool &gt; Masking</strong>, and <strong>Show Mask</strong> in the <strong>Render</strong> 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. <strong>Clear Mask</strong> (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>A</kbd>) is what removes it.</p>
+<p>To see the mask, keep <strong>Mask</strong> on in the right shelf. The same toggle is <strong>Show mask</strong> in <strong>Tool &gt; Masking</strong>, and <strong>Show Mask</strong> in the <strong>Render</strong> 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. <strong>Clear Mask</strong> (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>A</kbd>) is what removes it.</p>
<h2 id="paint-a-mask">Paint a mask<a class="anchor" href="#paint-a-mask" aria-label="Link to this section">#</a></h2>
<ol>
<li>
@@ -84,9 +84,8 @@ Hold <kbd>Ctrl</kbd>+<kbd>Alt</kbd> and drag to erase the mask.
</ol>
<p>Mask strokes use the current <strong>Draw Size</strong>, symmetry and, with a pen, pressure (when <strong>Pressure &gt; Strength</strong> is on). How much each stroke masks is set by <strong>Mask Strength</strong> in <strong>Tool &gt; Masking</strong> (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 <strong>Drag Stamp</strong> stroke masks with dabs along the path instead of one stamp.</p>
<p>On macOS, <kbd>Cmd</kbd> works wherever this guide says <kbd>Ctrl</kbd>.</p>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> this is ZBrush&#x27;s Ctrl-masking with its MaskPen brush, the default. Mask Lasso and Mask Rectangle are described next.</p></aside>
<h2 id="mask-with-a-lasso-or-rectangle">Mask with a lasso or rectangle<a class="anchor" href="#mask-with-a-lasso-or-rectangle" aria-label="Link to this section">#</a></h2>
-<p>To mask a large or sharply outlined area in one go, pick a mask selection shape. As in ZBrush, holding <kbd>Ctrl</kbd> turns the brush on the left shelf into the mask brush: with <kbd>Ctrl</kbd> held, click the brush tile (or press <kbd>B</kbd>) to pick <strong>Mask Pen</strong>, <strong>Mask Lasso</strong> or <strong>Mask Rectangle</strong>, or click the stroke tile to pick the stroke (<strong>Dots</strong>, <strong>Lasso</strong> or <strong>Rect</strong>). The same shapes sit at the top of <strong>Tool &gt; Masking</strong>:</p>
+<p>To mask a large or sharply outlined area in one go, pick a mask selection shape. Holding <kbd>Ctrl</kbd> turns the brush on the left shelf into the mask brush: with <kbd>Ctrl</kbd> held, click the brush tile (or press <kbd>B</kbd>) to pick <strong>Mask Pen</strong>, <strong>Mask Lasso</strong> or <strong>Mask Rectangle</strong>, or click the stroke tile to pick the stroke (<strong>Dots</strong>, <strong>Lasso</strong> or <strong>Rect</strong>). The same shapes sit at the top of <strong>Tool &gt; Masking</strong>:</p>
<div class="table-wrap"><table><thead><tr><th>Shape</th><th><kbd>Ctrl</kbd> + drag</th></tr></thead><tbody><tr><td><strong>Mask Pen</strong> (default)</td><td>Paints the mask with the brush, as described above.</td></tr><tr><td><strong>Mask Lasso</strong></td><td>Draws a free-hand outline that closes back to where you started. Everything inside is masked.</td></tr><tr><td><strong>Mask Rectangle</strong></td><td>Draws a rectangle. Everything inside is masked.</td></tr></tbody></table></div>
<p>With <strong>Mask Lasso</strong> or <strong>Mask Rectangle</strong>:</p>
<ol>
@@ -97,22 +96,20 @@ Hold <kbd>Ctrl</kbd> and drag around the area. The drag can start on the model o
Let go to mask what&#x27;s inside. Hold <kbd>Ctrl</kbd>+<kbd>Alt</kbd> instead to unmask what&#x27;s inside (the shape is drawn blue). You can press or release <kbd>Alt</kbd> while dragging; what counts is whether it is held when you let go.
</li>
</ol>
-<p>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 (<strong>X</strong>, <strong>Y</strong>, <strong>Z</strong> on the top shelf), the mirror image of what&#x27;s inside is masked too, as a mask stroke mirrors. A shape that covers none of the model clears the mask instead (as in ZBrush). <strong>Mask Strength</strong> 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.</p>
+<p>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 (<strong>X</strong>, <strong>Y</strong>, <strong>Z</strong> on the top shelf), the mirror image of what&#x27;s inside is masked too, as a mask stroke mirrors. A shape that covers none of the model clears the mask instead. <strong>Mask Strength</strong> 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.</p>
<p>Turn on <strong>Front faces only</strong> (under the shape buttons, shown for Mask Lasso and Mask Rectangle) 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.</p>
<p>The cursor turns into a small cross while <kbd>Ctrl</kbd> is held, since the brush size doesn&#x27;t matter for a selection.</p>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> these are ZBrush&#x27;s MaskLasso and MaskRect brushes. Like ZBrush, the shape stays selected until you pick another one, so switch back to <strong>Mask Pen</strong> to paint masks again. Holding <kbd>Ctrl</kbd> shows the mask brush on the shelf and <kbd>Ctrl</kbd> with the Brush or Stroke picker picks it, as in ZBrush. MaskCurve is not available yet.</p></aside>
<h2 id="background-gestures">Background gestures<a class="anchor" href="#background-gestures" aria-label="Link to this section">#</a></h2>
<p>With <kbd>Ctrl</kbd> held, clicks and drags on the empty background act on the whole mask:</p>
-<div class="table-wrap"><table><thead><tr><th>Gesture</th><th>Effect</th></tr></thead><tbody><tr><td><kbd>Ctrl</kbd> + click the background</td><td>Invert the mask</td></tr><tr><td><kbd>Ctrl</kbd> + drag on the background</td><td>Draw a mask rectangle (Mask Pen; Mask Lasso draws a lasso): what it covers is masked, mirrored by the symmetry. A shape that covers none of the model clears the mask.</td></tr><tr><td><kbd>Ctrl</kbd> + drag on the background, with nothing masked</td><td>Zoom the view in the SculptForge style (the default); with the ZBrush-style keys it draws the mask rectangle above (see <a href="shortcuts.html#zbrush-style-keys">Keyboard and mouse</a>)</td></tr></tbody></table></div>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> with DynaMesh on, ZBrush also remeshes when a <kbd>Ctrl</kbd> + drag on the background misses the model. SculptForge doesn&#x27;t: remesh with <strong>Tool &gt; Remesh</strong> instead.</p></aside>
-<p>On the model, a <kbd>Ctrl</kbd> + click that doesn&#x27;t drag works on the mask&#x27;s edges, as in ZBrush, whichever mask shape is picked:</p>
+<div class="table-wrap"><table><thead><tr><th>Gesture</th><th>Effect</th></tr></thead><tbody><tr><td><kbd>Ctrl</kbd> + click the background</td><td>Invert the mask</td></tr><tr><td><kbd>Ctrl</kbd> + drag on the background</td><td>Draw a mask rectangle (Mask Pen; Mask Lasso draws a lasso): what it covers is masked, mirrored by the symmetry. A shape that covers none of the model clears the mask.</td></tr><tr><td><kbd>Ctrl</kbd> + drag on the background, with nothing masked</td><td>Zoom the view in the SculptForge style (the default); with the Classic sculpting keys it draws the mask rectangle above (see <a href="shortcuts.html#classic-sculpting-keys">Keyboard and mouse</a>)</td></tr></tbody></table></div>
+<p>On the model, a <kbd>Ctrl</kbd> + click that doesn&#x27;t drag works on the mask&#x27;s edges, whichever mask shape is picked:</p>
<div class="table-wrap"><table><thead><tr><th>Gesture</th><th>Effect</th></tr></thead><tbody><tr><td><kbd>Ctrl</kbd> + click the model</td><td>Blur the mask (once per click; same as <strong>Blur</strong>)</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Alt</kbd> + click the model</td><td>Sharpen the mask (same as <strong>Sharpen</strong>)</td></tr></tbody></table></div>
<h2 id="mask-keys">Mask keys<a class="anchor" href="#mask-keys" aria-label="Link to this section">#</a></h2>
<div class="table-wrap"><table><thead><tr><th>Key</th><th>Effect</th></tr></thead><tbody><tr><td><kbd>Ctrl</kbd>+<kbd>A</kbd></td><td>Mask All</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>A</kbd></td><td>Clear Mask</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>I</kbd></td><td>Invert Mask</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>H</kbd></td><td>Show or hide the mask&#x27;s shading (View Mask)</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>W</kbd></td><td>Group Masked: the masked part becomes a new face group and the mask is cleared (see <a href="face-groups.html">Face Groups</a>)</td></tr></tbody></table></div>
<p>A drag starts after the cursor moves a few pixels, so a slightly shaky click still inverts. With <strong>Mask Lasso</strong> or <strong>Mask Rectangle</strong>, a <kbd>Ctrl</kbd> + drag on the background draws that shape; to clear the mask, draw it away from the model, or use <strong>Clear</strong>.</p>
<h2 id="the-masking-sub-palette">The Masking sub-palette<a class="anchor" href="#the-masking-sub-palette" aria-label="Link to this section">#</a></h2>
<p>Open <strong>Tool &gt; Masking</strong> (the Tool palette is in the right tray by default). Every button is one undo step.</p>
-<div class="table-wrap"><table><thead><tr><th>Control</th><th>What it does</th><th>Command</th></tr></thead><tbody><tr><td><strong>Show mask</strong></td><td>Darken masked areas in the viewport.</td><td></td></tr><tr><td><strong>Mask Pen</strong> / <strong>Mask Lasso</strong> / <strong>Mask Rectangle</strong></td><td>What <kbd>Ctrl</kbd> + drag does: paint with the brush, or mask inside a lasso or rectangle.</td><td><code>mask_lasso</code> / <code>mask_rect</code></td></tr><tr><td><strong>Mask Strength</strong></td><td>How much each mask stroke or selection masks (0.01 to 1), and the mask value <strong>By cavity</strong> gives the deepest cavities.</td><td></td></tr><tr><td><strong>Clear</strong></td><td>Unmask everything.</td><td><code>mask_clear</code></td></tr><tr><td><strong>Invert</strong></td><td>Masked becomes free and free becomes masked.</td><td><code>mask_invert</code></td></tr><tr><td><strong>All</strong></td><td>Mask every visible vertex.</td><td><code>mask_all</code></td></tr><tr><td><strong>Blur</strong></td><td>Soften the mask edges by averaging with neighbouring vertices.</td><td><code>mask_blur</code></td></tr><tr><td><strong>Sharpen</strong></td><td>Tighten soft edges, pushing values toward fully masked or free.</td><td><code>mask_sharpen</code></td></tr><tr><td><strong>Grow</strong></td><td>Expand the masked region by one ring of edges per pass.</td><td><code>mask_grow</code></td></tr><tr><td><strong>Shrink</strong></td><td>Contract the masked region by one ring of edges per pass.</td><td><code>mask_shrink</code></td></tr><tr><td><strong>passes</strong></td><td>How many times Blur, Sharpen, Grow and Shrink run (1 to 20 here, default 1).</td><td><code>iterations=</code></td></tr><tr><td><strong>By cavity</strong></td><td>Mask concave areas (creases, folds, pores), replacing the current mask.</td><td><code>mask_by_cavity</code></td></tr><tr><td><strong>threshold</strong></td><td>How concave a spot must be for <strong>By cavity</strong> (-0.2 to 0.5, default 0.02). 0 masks anything concave; higher values keep only deep creases.</td><td><code>threshold=</code></td></tr><tr><td><strong>By face group</strong></td><td>Mask one face group, replacing the current mask. The number field next to it is the face group id.</td><td><code>mask_by_polygroup</code></td></tr><tr><td><strong>By border</strong></td><td>Mask the open edges of the mesh (edges with only one face) and the rings of edges inside them, replacing the current mask, so sculpting keeps the border in place. Uses <strong>Mask Strength</strong>. A closed mesh has no open edges, and the status bar says so.</td><td><code>mask_border</code></td></tr><tr><td><strong>Rings</strong></td><td>How wide <strong>By border</strong> masks, in rings of edges from the border (1 to 20, default 2; 1 masks the border vertices only).</td><td><code>rings=</code></td></tr><tr><td><strong>Face Group borders</strong></td><td><strong>By border</strong> also masks where face groups meet (ZBrush: Mask by Polygroups border).</td><td><code>polygroups=true</code></td></tr><tr><td><strong>Soft</strong></td><td><strong>By border</strong> fades the mask from the border towards the innermost ring.</td><td><code>soft=true</code></td></tr></tbody></table></div>
+<div class="table-wrap"><table><thead><tr><th>Control</th><th>What it does</th><th>Command</th></tr></thead><tbody><tr><td><strong>Show mask</strong></td><td>Darken masked areas in the viewport.</td><td></td></tr><tr><td><strong>Mask Pen</strong> / <strong>Mask Lasso</strong> / <strong>Mask Rectangle</strong></td><td>What <kbd>Ctrl</kbd> + drag does: paint with the brush, or mask inside a lasso or rectangle.</td><td><code>mask_lasso</code> / <code>mask_rect</code></td></tr><tr><td><strong>Mask Strength</strong></td><td>How much each mask stroke or selection masks (0.01 to 1), and the mask value <strong>By cavity</strong> gives the deepest cavities.</td><td></td></tr><tr><td><strong>Clear</strong></td><td>Unmask everything.</td><td><code>mask_clear</code></td></tr><tr><td><strong>Invert</strong></td><td>Masked becomes free and free becomes masked.</td><td><code>mask_invert</code></td></tr><tr><td><strong>All</strong></td><td>Mask every visible vertex.</td><td><code>mask_all</code></td></tr><tr><td><strong>Blur</strong></td><td>Soften the mask edges by averaging with neighbouring vertices.</td><td><code>mask_blur</code></td></tr><tr><td><strong>Sharpen</strong></td><td>Tighten soft edges, pushing values toward fully masked or free.</td><td><code>mask_sharpen</code></td></tr><tr><td><strong>Grow</strong></td><td>Expand the masked region by one ring of edges per pass.</td><td><code>mask_grow</code></td></tr><tr><td><strong>Shrink</strong></td><td>Contract the masked region by one ring of edges per pass.</td><td><code>mask_shrink</code></td></tr><tr><td><strong>passes</strong></td><td>How many times Blur, Sharpen, Grow and Shrink run (1 to 20 here, default 1).</td><td><code>iterations=</code></td></tr><tr><td><strong>By cavity</strong></td><td>Mask concave areas (creases, folds, pores), replacing the current mask.</td><td><code>mask_by_cavity</code></td></tr><tr><td><strong>threshold</strong></td><td>How concave a spot must be for <strong>By cavity</strong> (-0.2 to 0.5, default 0.02). 0 masks anything concave; higher values keep only deep creases.</td><td><code>threshold=</code></td></tr><tr><td><strong>By face group</strong></td><td>Mask one face group, replacing the current mask. The number field next to it is the face group id.</td><td><code>mask_by_polygroup</code></td></tr><tr><td><strong>By border</strong></td><td>Mask the open edges of the mesh (edges with only one face) and the rings of edges inside them, replacing the current mask, so sculpting keeps the border in place. Uses <strong>Mask Strength</strong>. A closed mesh has no open edges, and the status bar says so.</td><td><code>mask_border</code></td></tr><tr><td><strong>Rings</strong></td><td>How wide <strong>By border</strong> masks, in rings of edges from the border (1 to 20, default 2; 1 masks the border vertices only).</td><td><code>rings=</code></td></tr><tr><td><strong>Face Group borders</strong></td><td><strong>By border</strong> also masks where face groups meet.</td><td><code>polygroups=true</code></td></tr><tr><td><strong>Soft</strong></td><td><strong>By border</strong> fades the mask from the border towards the innermost ring.</td><td><code>soft=true</code></td></tr></tbody></table></div>
<p>Mask operations only change visible parts of the model; hidden parts keep their mask. <strong>Clear</strong> is the exception and frees everything.</p>
<h2 id="common-tasks">Common tasks<a class="anchor" href="#common-tasks" aria-label="Link to this section">#</a></h2>
<h3 id="protect-detail-while-smoothing">Protect detail while smoothing<a class="anchor" href="#protect-detail-while-smoothing" aria-label="Link to this section">#</a></h3>
@@ -153,7 +150,7 @@ Click <strong>All</strong>: only visible vertices are masked.
<kbd>Ctrl</kbd>+<kbd>Shift</kbd> + click the background to show everything again. The mask stays.
</li>
</ol>
-<p><strong>By face group</strong> masks a group by its id. The viewport doesn&#x27;t show ids, but the console does: isolate the group, then open the console (<kbd>`</kbd>) and read the <code>isolate_polygroup group=N</code> line. Enter that number in the field next to <strong>By face group</strong> and click it.</p>
+<p><strong>By face group</strong> masks a group by its id. The viewport doesn&#x27;t show ids, but the console does: isolate the group, then open the console (<kbd>`</kbd>) and read the <code>isolate_face group group=N</code> line. Enter that number in the field next to <strong>By face group</strong> and click it.</p>
<h3 id="sculpt-without-breaking-the-border">Sculpt without breaking the border<a class="anchor" href="#sculpt-without-breaking-the-border" aria-label="Link to this section">#</a></h3>
<p>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:</p>
<ol>
@@ -212,8 +209,7 @@ Sculpt freely; the border doesn&#x27;t move. Tick <strong>Soft</strong> first fo
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/maya.html b/website/guide/maya.html
index 5a4093c5..957a27c5 100644
--- a/website/guide/maya.html
+++ b/website/guide/maya.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Working with Maya - SculptForge User Guide</title>
- <meta name="description" content="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 &gt; Maya &gt; Send to Maya sends them back, replacing each Maya object&#x27;s mesh by name. It works like ZBrush&#x27;s GoZ between ZBrush and other apps, on ">
+ <meta name="description" content="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 &gt; Maya &gt; Send to Maya sends them back, replacing each Maya object&#x27;s mesh by name. It works through files in a shared folder, on Linux, Windows ">
<meta name="theme-color" content="#111114">
<meta name="color-scheme" content="dark">
<link rel="icon" type="image/svg+xml" href="../img/favicon.svg?v=2">
@@ -13,8 +13,8 @@
<link rel="canonical" href="https://sculptforge.app/guide/maya.html">
<meta property="og:type" content="article">
<meta property="og:title" content="Working with Maya - SculptForge User Guide">
- <meta property="og:description" content="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 &gt; Maya &gt; Send to Maya sends them back, replacing each Maya object&#x27;s mesh by name. It works like ZBrush&#x27;s GoZ between ZBrush and other apps, on ">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:description" content="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 &gt; Maya &gt; Send to Maya sends them back, replacing each Maya object&#x27;s mesh by name. It works through files in a shared folder, on Linux, Windows ">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/maya.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,13 +46,13 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html" class="current" aria-current="page">Working with Maya</a><ul class="toc-sections"><li><a href="#install-the-shelf-in-maya">Install the shelf in Maya</a></li><li><a href="#choose-the-exchange-folder">Choose the exchange folder</a></li><li><a href="#a-round-trip">A round trip</a></li><li><a href="#what-comes-across">What comes across</a></li><li><a href="#the-exchange-folder">The exchange folder</a></li><li><a href="#troubleshooting">Troubleshooting</a></li></ul></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html" class="current" aria-current="page">Working with Maya</a><ul class="toc-sections"><li><a href="#install-the-shelf-in-maya">Install the shelf in Maya</a></li><li><a href="#choose-the-exchange-folder">Choose the exchange folder</a></li><li><a href="#a-round-trip">A round trip</a></li><li><a href="#what-comes-across">What comes across</a></li><li><a href="#the-exchange-folder">The exchange folder</a></li><li><a href="#troubleshooting">Troubleshooting</a></li></ul></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
<article class="guide-article">
<h1 id="working-with-maya">Working with Maya</h1>
-<p>Keep Maya for the scene, rigging and animation, and sculpt in SculptForge: the <strong>SculptForge shelf</strong> for Maya sends the selected meshes to SculptForge, and <strong>File &gt; Maya &gt; Send to Maya</strong> sends them back, replacing each Maya object&#x27;s mesh by name. It works like ZBrush&#x27;s GoZ between ZBrush and other apps, on Linux, Windows and macOS.</p>
+<p>Keep Maya for the scene, rigging and animation, and sculpt in SculptForge: the <strong>SculptForge shelf</strong> for Maya sends the selected meshes to SculptForge, and <strong>File &gt; Maya &gt; Send to Maya</strong> sends them back, replacing each Maya object&#x27;s mesh by name. It works through files in a shared folder, on Linux, Windows and macOS.</p>
<p>The two apps exchange files through <strong>one folder that you choose in both</strong>, 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.</p>
<h2 id="install-the-shelf-in-maya">Install the shelf in Maya<a class="anchor" href="#install-the-shelf-in-maya" aria-label="Link to this section">#</a></h2>
<ol>
@@ -138,8 +138,7 @@ In Maya click <strong>Get</strong>. Each object that came from Maya gets the new
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/micro-levels.html b/website/guide/micro-levels.html
index 2f3a2894..ae2c304c 100644
--- a/website/guide/micro-levels.html
+++ b/website/guide/micro-levels.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Micro levels: hundreds of millions of polygons - SculptForge User Guide">
<meta property="og:description" content="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">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/micro-levels.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html" class="current" aria-current="page">Micro levels: hundreds of millions of polygons</a><ul class="toc-sections"><li><a href="#making-a-micro-level">Making a micro level</a></li><li><a href="#sculpting">Sculpting</a></li><li><a href="#baking-down-and-exporting">Baking down and exporting</a></li><li><a href="#very-large-levels-and-laptops">Very large levels and laptops</a></li><li><a href="#scripting">Scripting</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html" class="current" aria-current="page">Micro levels: hundreds of millions of polygons</a><ul class="toc-sections"><li><a href="#making-a-micro-level">Making a micro level</a></li><li><a href="#sculpting">Sculpting</a></li><li><a href="#baking-down-and-exporting">Baking down and exporting</a></li><li><a href="#very-large-levels-and-laptops">Very large levels and laptops</a></li><li><a href="#scripting">Scripting</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -54,7 +54,6 @@
<h1 id="micro-levels-hundreds-of-millions-of-polygons">Micro levels: hundreds of millions of polygons</h1>
<p>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. <strong>Micro levels</strong> 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.</p>
<figure class="shot"><a href="images/micro-300m.jpg" class="zoom"><img src="images/micro-300m.jpg" alt="A sphere with 335 million micro triangles: surface noise, a Clay Block band, Crease and Sharp Crease lines (Micro 4, 420 MB)" width="1200" height="825" loading="lazy" decoding="async"></a><figcaption>A sphere with 335 million micro triangles: surface noise, a Clay Block band, Crease and Sharp Crease lines (Micro 4, 420 MB)</figcaption></figure>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> HD Geometry also goes past the subdivision levels, but you sculpt it one small region at a time. A micro level is the whole model, all the time: every brush stroke, every view, every Part at once.</p></aside>
<h2 id="making-a-micro-level">Making a micro level<a class="anchor" href="#making-a-micro-level" aria-label="Link to this section">#</a></h2>
<ol>
<li>
@@ -137,8 +136,7 @@ Brushes that slide the surface (Tendril, Nudge, VDM stamps) and custom recipe br
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/navigation.html b/website/guide/navigation.html
index ae4af60a..91c5c7ef 100644
--- a/website/guide/navigation.html
+++ b/website/guide/navigation.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Navigating the view - SculptForge User Guide">
<meta property="og:description" content="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.">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/navigation.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html" class="current" aria-current="page">Navigating the view</a><ul class="toc-sections"><li><a href="#how-the-camera-works">How the camera works</a></li><li><a href="#mouse-and-pen">Mouse and pen</a></li><li><a href="#the-right-shelf-navigation-buttons">The right-shelf navigation buttons</a></li><li><a href="#spacemouse-experimental">SpaceMouse (experimental)</a></li><li><a href="#framing">Framing</a></li><li><a href="#display-toggles-that-help-navigation">Display toggles that help navigation</a></li><li><a href="#not-yet">Not yet</a></li><li><a href="#see-also">See also</a></li></ul></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html" class="current" aria-current="page">Navigating the view</a><ul class="toc-sections"><li><a href="#how-the-camera-works">How the camera works</a></li><li><a href="#mouse-and-pen">Mouse and pen</a></li><li><a href="#the-right-shelf-navigation-buttons">The right-shelf navigation buttons</a></li><li><a href="#spacemouse-experimental">SpaceMouse (experimental)</a></li><li><a href="#framing">Framing</a></li><li><a href="#display-toggles-that-help-navigation">Display toggles that help navigation</a></li><li><a href="#not-yet">Not yet</a></li><li><a href="#see-also">See also</a></li></ul></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -54,23 +54,22 @@
<h1 id="navigating-the-view">Navigating the view</h1>
<p>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>
<h2 id="how-the-camera-works">How the camera works<a class="anchor" href="#how-the-camera-works" aria-label="Link to this section">#</a></h2>
-<p>The camera orbits around a target point. By default rotation is <strong>free</strong>, as in ZBrush: dragging turns the model about the screen&#x27;s own axes, so it follows the cursor and can roll right over the top. Hold <kbd>Shift</kbd> while rotating to snap to the nearest front, back, side, top or bottom view; let go of <kbd>Shift</kbd> and the drag carries on from where the cursor is. If you prefer the model to stay upright, as in Blender or Maya, set <strong>Edit &gt; Preferences &gt; Interface &gt; Rotation</strong> to <strong>Turntable</strong>: 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>
+<p>The camera orbits around a target point. By default rotation is <strong>free</strong>: dragging turns the model about the screen&#x27;s own axes, so it follows the cursor and can roll right over the top. Hold <kbd>Shift</kbd> while rotating to snap to the nearest front, back, side, top or bottom view; let go of <kbd>Shift</kbd> and the drag carries on from where the cursor is. If you prefer the model to stay upright, as in Blender or Maya, set <strong>Edit &gt; Preferences &gt; Interface &gt; Rotation</strong> to <strong>Turntable</strong>: 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>
<p>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 (<kbd>Numpad 5</kbd>): no foreshortening, so sizes don&#x27;t shrink with depth. The front, side and top views (<kbd>Numpad 1</kbd>, <kbd>3</kbd>, <kbd>7</kbd>) switch to orthographic until you rotate again, as in Blender.</p>
<p>The X / Y / Z gizmo in the top left of the canvas (<strong>Sculpt &gt; Draw &amp; Tablet &gt; Camera &gt; Axes</strong>) shows the world axes as the camera sees them. Click an end to look from that side, as in Blender: <strong>X</strong> the right view, <strong>Y</strong> the top, <strong>Z</strong> the front, and the plain dot at the other end of each axis the left, bottom or back view. These are orthographic like the numpad views. The end under the pointer gets a ring.</p>
<p><strong>Sculpt &gt; Draw &amp; Tablet &gt; Camera &gt; Gizmo size</strong> makes the axes <strong>Small</strong>, <strong>Medium</strong> (the default) or <strong>Large</strong>; they grow with the UI scale too, and clicking an end works at every size. <strong>View Figure</strong> (beside <strong>Axes</strong>, 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.</p>
<p>Navigation starts only on the canvas. A drag that begins on a shelf, a tray or a palette never moves the camera.</p>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> the gestures are ZBrush&#x27;s. Dragging on the background (or right-dragging) rotates, with <kbd>Shift</kbd> to snap; <kbd>Alt</kbd>+drag pans, and letting go of <kbd>Alt</kbd> while still dragging zooms; <kbd>Ctrl</kbd>+right-drag zooms and <kbd>Alt</kbd>+right-drag pans, as with ZBrush&#x27;s right-click navigation. As in ZBrush, dragging up (forward) zooms out and dragging down zooms in, and when you rotate or pan the model follows the cursor. The right-shelf Move, Zoom and Rotate buttons work as in ZBrush.</p></aside>
<aside class="callout callout-note"><p><strong>Blender:</strong> with <strong>Edit &gt; Preferences &gt; Input &gt; Style</strong> on <strong>Blender</strong>, middle-drag rotates, <kbd>Shift</kbd>+middle-drag pans and <kbd>Ctrl</kbd>+middle-drag zooms. With a pen or a trackpad, <kbd>Alt</kbd>+left-drag beside the model does the same (add <kbd>Shift</kbd> to pan, anywhere; <kbd>Ctrl</kbd> to zoom); on the model it masks, as in Blender 5.1 and later. Turn on <strong>Edit &gt; Preferences &gt; Input &gt; Emulate 3 Button Mouse</strong> to make <kbd>Alt</kbd>+left-drag turn the view everywhere, as that Blender preference does. The numpad views, <kbd>Numpad .</kbd> and <kbd>Home</kbd> frame as in Blender. See <a href="shortcuts.html#blender-keys">Blender keys</a>.</p></aside>
<h2 id="mouse-and-pen">Mouse and pen<a class="anchor" href="#mouse-and-pen" aria-label="Link to this section">#</a></h2>
-<div class="table-wrap"><table><thead><tr><th>To</th><th>Do this</th></tr></thead><tbody><tr><td>Rotate</td><td>Left-drag on the background, or right-drag anywhere on the canvas; add <kbd>Shift</kbd> to snap to an axis view</td></tr><tr><td>Roll (turn about the view axis)</td><td><kbd>Shift</kbd>+click the background, let go of <kbd>Shift</kbd>, then drag (ZBrush)</td></tr><tr><td>Pan</td><td><kbd>Alt</kbd>+left-drag on the background, <kbd>Alt</kbd>+right-drag, or middle-drag</td></tr><tr><td>Zoom</td><td>Mouse wheel; <kbd>Alt</kbd>+left-drag on the background, then let go of <kbd>Alt</kbd> and keep dragging; <kbd>Ctrl</kbd>+right-drag; <kbd>Ctrl</kbd>+middle-drag; <kbd>Ctrl</kbd>+left-drag on the background when nothing is masked (not with the ZBrush-style keys)</td></tr><tr><td>Frame the model</td><td><kbd>F</kbd> (Blender style: <kbd>Home</kbd>), or <strong>Frame</strong> on the right shelf</td></tr><tr><td>Front, right, top view</td><td><kbd>Numpad 1</kbd>, <kbd>Numpad 3</kbd>, <kbd>Numpad 7</kbd>; <kbd>Ctrl</kbd> for the back, left and bottom</td></tr><tr><td>Front, side, top or bottom view with the mouse</td><td>Click an end of the axis gizmo in the canvas corner</td></tr><tr><td>Orthographic on or off</td><td><kbd>Numpad 5</kbd></td></tr><tr><td>Turn in 15 degree steps</td><td><kbd>Numpad 4</kbd> / <kbd>Numpad 6</kbd> (around), <kbd>Numpad 8</kbd> / <kbd>Numpad 2</kbd> (over); <kbd>Numpad 9</kbd>: the other side</td></tr><tr><td>Frame the active Part</td><td><kbd>Numpad .</kbd></td></tr><tr><td>Frame one Part</td><td><kbd>Shift</kbd>+<kbd>Alt</kbd>+click it, or triple-click another Part (it becomes the active Part)</td></tr><tr><td>Sculpt from the background</td><td>Turn on <strong>Edit &gt; Preferences &gt; Input &gt; Start strokes off the model</strong>, <strong>View &gt; Lock camera</strong>, or press <kbd>Shift</kbd>+<kbd>L</kbd>: a left-drag that starts beside the model sculpts once it reaches the surface</td></tr><tr><td>Move the camera with Space held</td><td>Turn on <strong>Edit &gt; Preferences &gt; Input &gt; Hold Space and drag to move the camera</strong>, then hold <kbd>Space</kbd>: left-drag rotates, right- or middle-drag pans, <kbd>Ctrl</kbd>+drag zooms, anywhere on the canvas (on the model too)</td></tr></tbody></table></div>
-<p>Zoom drags: drag up to come closer, down to back away. With the ZBrush-style keys (<strong>Edit &gt; Preferences &gt; Input</strong>) they go the ZBrush way: drag up to zoom out, down to zoom in.</p>
-<p><strong>Hold Space and drag to move the camera</strong> is off by default, because in ZBrush <kbd>Space</kbd> opens the Quick Menu. With it on, <kbd>Space</kbd> no longer opens the Quick Menu (a right click still does), and a space typed in a text field is never taken.</p>
-<p><strong>Start strokes off the model</strong> (also <strong>View &gt; Lock camera</strong>) 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 <strong>CAMERA LOCKED</strong>), 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. <kbd>Ctrl</kbd> (mask) and <kbd>Shift</kbd> (smooth) strokes start the same way, and a <kbd>Ctrl</kbd>+click on the background still inverts the mask. To move the view, right-drag (a pen&#x27;s lower button is a right click by default), <kbd>Alt</kbd>+drag to pan, middle-drag, or hold <kbd>Space</kbd> if <strong>Hold Space and drag to move the camera</strong> is on; with the Blender or Maya style, <kbd>Alt</kbd>+left-drag rotates as before. With a pen that has no buttons and the ZBrush or SculptForge style, press <kbd>Shift</kbd>+<kbd>L</kbd> to turn it off while you rotate, or turn on Hold Space. Mask Lasso, Mask Rectangle and the <kbd>Ctrl</kbd>+<kbd>Shift</kbd> hide and show shapes work as before.</p>
+<div class="table-wrap"><table><thead><tr><th>To</th><th>Do this</th></tr></thead><tbody><tr><td>Rotate</td><td>Left-drag on the background, or right-drag anywhere on the canvas; add <kbd>Shift</kbd> to snap to an axis view</td></tr><tr><td>Roll (turn about the view axis)</td><td><kbd>Shift</kbd>+click the background, let go of <kbd>Shift</kbd>, then drag</td></tr><tr><td>Pan</td><td><kbd>Alt</kbd>+left-drag on the background, <kbd>Alt</kbd>+right-drag, or middle-drag</td></tr><tr><td>Zoom</td><td>Mouse wheel; <kbd>Alt</kbd>+left-drag on the background, then let go of <kbd>Alt</kbd> and keep dragging; <kbd>Ctrl</kbd>+right-drag; <kbd>Ctrl</kbd>+middle-drag; <kbd>Ctrl</kbd>+left-drag on the background when nothing is masked (not with the Classic sculpting keys)</td></tr><tr><td>Frame the model</td><td><kbd>F</kbd> (Blender style: <kbd>Home</kbd>), or <strong>Frame</strong> on the right shelf</td></tr><tr><td>Front, right, top view</td><td><kbd>Numpad 1</kbd>, <kbd>Numpad 3</kbd>, <kbd>Numpad 7</kbd>; <kbd>Ctrl</kbd> for the back, left and bottom</td></tr><tr><td>Front, side, top or bottom view with the mouse</td><td>Click an end of the axis gizmo in the canvas corner</td></tr><tr><td>Orthographic on or off</td><td><kbd>Numpad 5</kbd></td></tr><tr><td>Turn in 15 degree steps</td><td><kbd>Numpad 4</kbd> / <kbd>Numpad 6</kbd> (around), <kbd>Numpad 8</kbd> / <kbd>Numpad 2</kbd> (over); <kbd>Numpad 9</kbd>: the other side</td></tr><tr><td>Frame the active Part</td><td><kbd>Numpad .</kbd></td></tr><tr><td>Frame one Part</td><td><kbd>Shift</kbd>+<kbd>Alt</kbd>+click it, or triple-click another Part (it becomes the active Part)</td></tr><tr><td>Sculpt from the background</td><td>Turn on <strong>Edit &gt; Preferences &gt; Input &gt; Start strokes off the model</strong>, <strong>View &gt; Lock camera</strong>, or press <kbd>Shift</kbd>+<kbd>L</kbd>: a left-drag that starts beside the model sculpts once it reaches the surface</td></tr><tr><td>Move the camera with Space held</td><td>Turn on <strong>Edit &gt; Preferences &gt; Input &gt; Hold Space and drag to move the camera</strong>, then hold <kbd>Space</kbd>: left-drag rotates, right- or middle-drag pans, <kbd>Ctrl</kbd>+drag zooms, anywhere on the canvas (on the model too)</td></tr></tbody></table></div>
+<p>Zoom drags: drag up to come closer, down to back away. With the Classic sculpting keys (<strong>Edit &gt; Preferences &gt; Input</strong>) they go: drag up to zoom out, down to zoom in.</p>
+<p><strong>Hold Space and drag to move the camera</strong> is off by default, because with the Classic sculpting keys <kbd>Space</kbd> opens the Quick Menu. With it on, <kbd>Space</kbd> no longer opens the Quick Menu (a right click still does), and a space typed in a text field is never taken.</p>
+<p><strong>Start strokes off the model</strong> (also <strong>View &gt; Lock camera</strong>) 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 <strong>CAMERA LOCKED</strong>), 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. <kbd>Ctrl</kbd> (mask) and <kbd>Shift</kbd> (smooth) strokes start the same way, and a <kbd>Ctrl</kbd>+click on the background still inverts the mask. To move the view, right-drag (a pen&#x27;s lower button is a right click by default), <kbd>Alt</kbd>+drag to pan, middle-drag, or hold <kbd>Space</kbd> if <strong>Hold Space and drag to move the camera</strong> is on; with the Blender or Maya style, <kbd>Alt</kbd>+left-drag rotates as before. With a pen that has no buttons and the Classic or SculptForge style, press <kbd>Shift</kbd>+<kbd>L</kbd> to turn it off while you rotate, or turn on Hold Space. Mask Lasso, Mask Rectangle and the <kbd>Ctrl</kbd>+<kbd>Shift</kbd> hide and show shapes work as before.</p>
<p>&quot;Background&quot; means any part of the canvas where the cursor isn&#x27;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.</p>
-<aside class="callout callout-note"><p><strong>Note:</strong> <kbd>Ctrl</kbd>+left-drag on the background clears the mask when something is masked (and <kbd>Ctrl</kbd>+click there inverts it); while nothing is masked it zooms (with the ZBrush-style keys it draws a mask rectangle instead). Use the wheel or <kbd>Ctrl</kbd>+middle-drag to zoom on a masked model. See <a href="masking.html">Masking</a>.</p></aside>
+<aside class="callout callout-note"><p><strong>Note:</strong> <kbd>Ctrl</kbd>+left-drag on the background clears the mask when something is masked (and <kbd>Ctrl</kbd>+click there inverts it); while nothing is masked it zooms (with the Classic sculpting keys it draws a mask rectangle instead). Use the wheel or <kbd>Ctrl</kbd>+middle-drag to zoom on a masked model. See <a href="masking.html">Masking</a>.</p></aside>
<p>On macOS, <kbd>Cmd</kbd> works wherever this guide says <kbd>Ctrl</kbd> for these gestures, except <kbd>Ctrl</kbd>+middle-drag, which needs <kbd>Ctrl</kbd> itself.</p>
<h2 id="the-right-shelf-navigation-buttons">The right-shelf navigation buttons<a class="anchor" href="#the-right-shelf-navigation-buttons" aria-label="Link to this section">#</a></h2>
-<p>The right shelf has three buttons you <strong>drag on</strong> rather than click, as in ZBrush. They are handy with a pen, on a laptop trackpad, or when the model fills the canvas and there is no background to drag on.</p>
+<p>The right shelf has three buttons you <strong>drag on</strong> 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.</p>
<figure class="shot"><a href="images/right-shelf.jpg" class="zoom"><img src="images/right-shelf.jpg" alt="The right shelf: Frame, Move, Zoom and Rotate, then the display toggles" width="60" height="535" loading="lazy" decoding="async"></a><figcaption>The right shelf: Frame, Move, Zoom and Rotate, then the display toggles</figcaption></figure>
<div class="table-wrap"><table><thead><tr><th>Button</th><th>Drag on it to</th></tr></thead><tbody><tr><td><strong>Frame</strong></td><td>(click) Fit the whole scene in the view (<kbd>F</kbd>)</td></tr><tr><td><strong>Move</strong></td><td>Pan the view</td></tr><tr><td><strong>Zoom</strong></td><td>Zoom: drag up to come closer, down to move away</td></tr><tr><td><strong>Rotate</strong></td><td>Orbit the view</td></tr></tbody></table></div>
<p>The button stays orange while you drag. <strong>Frame</strong> is also in the <strong>View</strong> menu and <strong>Sculpt &gt; Symmetry &amp; Gizmo</strong>.</p>
@@ -78,7 +77,7 @@
<p>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&#x27;s driver or SDK, so this is <strong>experimental</strong>: it has been tested with simulated input only, not yet with a real SpaceMouse. Tell us how it works with yours (<a href="https://github.com/islandmed/SculptForge/issues/6" rel="noopener">GitHub issue #6</a>).</p>
<p>Plug it in and it works: <strong>Edit &gt; Preferences &gt; Input</strong> shows its name under <strong>SpaceMouse (experimental)</strong>, 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&#x27;s target: <strong>Frame</strong> sets it to the scene&#x27;s centre, and panning moves it).</p>
<div class="table-wrap"><table><thead><tr><th>Move the cap</th><th>The view</th></tr></thead><tbody><tr><td>Push left / right</td><td>Pans left / right</td></tr><tr><td>Pull up / push down</td><td>Pans up / down</td></tr><tr><td>Pull towards you / push away</td><td>Zooms in / out</td></tr><tr><td>Twist</td><td>Turns the model around</td></tr><tr><td>Tilt towards you / away</td><td>Tips the model&#x27;s top towards you / away</td></tr><tr><td>Roll left / right</td><td>Rolls the model on screen (not with <strong>Lock rotation to turntable</strong>)</td></tr><tr><td>Left side button</td><td><strong>Frame</strong></td></tr><tr><td>Right side button</td><td><strong>Front view</strong></td></tr></tbody></table></div>
-<p>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, ZBrush-style, 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&#x27;t have to.</p>
+<p>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&#x27;t have to.</p>
<p><strong>Edit &gt; Preferences &gt; Input &gt; SpaceMouse:</strong></p>
<ul>
<li>
@@ -128,7 +127,7 @@
<p>These live on the right shelf and in the <strong>View</strong> menu:</p>
<ul>
<li>
-<strong>Wire</strong> (<kbd>Shift</kbd>+<kbd>F</kbd>): shows the polygons of the active Part over the surface, ZBrush&#x27;s PolyFrame. Quads show as quads (see <a href="geometry.html#quads-and-triangles">Quads and triangles</a>). Useful for judging mesh density before you subdivide or remesh.
+<strong>Wire</strong> (<kbd>Shift</kbd>+<kbd>F</kbd>): shows the polygons of the active Part over the surface, PolyFrame. Quads show as quads (see <a href="geometry.html#quads-and-triangles">Quads and triangles</a>). Useful for judging mesh density before you subdivide or remesh.
</li>
<li>
<strong>Groups</strong>: colours each face group.
@@ -183,8 +182,7 @@
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/packs-and-macros.html b/website/guide/packs-and-macros.html
index b115f0d8..1a49d3ad 100644
--- a/website/guide/packs-and-macros.html
+++ b/website/guide/packs-and-macros.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Packs and macros - SculptForge User Guide">
<meta property="og:description" content="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 pac">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/packs-and-macros.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html" class="current" aria-current="page">Packs and macros</a><ul class="toc-sections"><li><a href="#install-a-pack">Install a pack</a></li><li><a href="#where-pack-items-show-up">Where pack items show up</a></li><li><a href="#library--packs">Library &gt; Packs</a></li><li><a href="#make-a-pack">Make a pack</a></li><li><a href="#record-a-macro">Record a macro</a></li><li><a href="#write-or-change-a-macro">Write or change a macro</a></li><li><a href="#run-a-macro">Run a macro</a></li><li><a href="#what-a-macro-can-do">What a macro can do</a></li><li><a href="#scripts-and-python">Scripts and Python</a></li></ul></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html" class="current" aria-current="page">Packs and macros</a><ul class="toc-sections"><li><a href="#install-a-pack">Install a pack</a></li><li><a href="#where-pack-items-show-up">Where pack items show up</a></li><li><a href="#library--packs">Library &gt; Packs</a></li><li><a href="#make-a-pack">Make a pack</a></li><li><a href="#record-a-macro">Record a macro</a></li><li><a href="#write-or-change-a-macro">Write or change a macro</a></li><li><a href="#run-a-macro">Run a macro</a></li><li><a href="#what-a-macro-can-do">What a macro can do</a></li><li><a href="#scripts-and-python">Scripts and Python</a></li></ul></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -76,7 +76,7 @@ The <strong>check box</strong> turns the pack off or on. Off, its items leave ev
</ul>
<p>Start SculptForge with <code>--no-packs</code> to leave every pack out for one session (safe mode), for example to check whether a problem comes from a pack. <code>sculptforge-cli --no-packs</code> does the same for scripts.</p>
<h2 id="make-a-pack">Make a pack<a class="anchor" href="#make-a-pack" aria-label="Link to this section">#</a></h2>
-<p><strong>Library &gt; Packs &gt; New Pack...</strong> lists what you made yourself: brushes in your library, images in your Library&#x27;s Alphas and MatCaps folders, the active Part&#x27;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 <strong>Save Pack...</strong>. The file is checked exactly as an install would check it before it is written.</p>
+<p><strong>Library &gt; Packs &gt; New Pack...</strong> lists what you made yourself: brushes in your library, images in your Library&#x27;s Alphas and Lit Spheres folders, the active Part&#x27;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 <strong>Save Pack...</strong>. The file is checked exactly as an install would check it before it is written.</p>
<p>Tick <strong>Member pack (insider channel)</strong> for the monthly pack or an Insider drop. It only changes the label shown in the review and the pack list; anyone can install the file.</p>
<p>To build a pack from a folder in a script, lay the folder out like a pack (<code>brushes/</code>, <code>alphas/</code>, <code>matcaps/</code>, <code>materials/</code>, <code>vdms/</code>, <code>keymaps/</code>, <code>piemenus/</code>, <code>macros/</code>, plus <code>LICENSE.txt</code> and <code>preview.png</code>) and run:</p>
<div class="code-block"><pre class="code"><code>sculptforge-cli -c &#x27;pack_create folder=MyPack path=MyPack.sfpack id=my-pack name=&quot;My Pack&quot; author=Me license=CC-BY-4.0&#x27;</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
@@ -123,7 +123,7 @@ export_glb path=exports/clean.glb</code></pre><button class="copy" type="button"
<p>A macro only runs SculptForge&#x27;s own commands, in order. It can&#x27;t run programs or scripts, and it can&#x27;t:</p>
<ul>
<li>
-reach the network (AI services, the brush gallery, Unreal, the phone link) or send to Blender, Maya or ZBrush;
+reach the network (AI services, the brush gallery, Unreal, the phone link) or send to Blender, Maya or the Bridge;
</li>
<li>
install, remove or switch packs, or run another macro;
@@ -159,8 +159,7 @@ name a file outside the project folder. File values are either a path inside the
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/parts.html b/website/guide/parts.html
index b6772afd..801b1c80 100644
--- a/website/guide/parts.html
+++ b/website/guide/parts.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Parts - SculptForge User Guide</title>
- <meta name="description" content="A scene in SculptForge can hold several separate meshes, called Parts (ZBrush users: SubTools): 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 throu">
+ <meta name="description" content="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">
<meta name="theme-color" content="#111114">
<meta name="color-scheme" content="dark">
<link rel="icon" type="image/svg+xml" href="../img/favicon.svg?v=2">
@@ -13,8 +13,8 @@
<link rel="canonical" href="https://sculptforge.app/guide/parts.html">
<meta property="og:type" content="article">
<meta property="og:title" content="Parts - SculptForge User Guide">
- <meta property="og:description" content="A scene in SculptForge can hold several separate meshes, called Parts (ZBrush users: SubTools): 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 throu">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:description" content="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">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/parts.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,13 +46,13 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html" class="current" aria-current="page">Parts</a><ul class="toc-sections"><li><a href="#how-parts-work">How Parts work</a></li><li><a href="#the-parts-list">The Parts list</a></li><li><a href="#add-a-part">Add a Part</a></li><li><a href="#show-hide-and-solo">Show, hide and solo</a></li><li><a href="#reorder-parts">Reorder Parts</a></li><li><a href="#merge-parts">Merge Parts</a></li><li><a href="#split-a-part">Split a Part</a></li><li><a href="#extract-a-shell">Extract a shell</a></li><li><a href="#delete-a-part">Delete a Part</a></li><li><a href="#parts-in-files">Parts in files</a></li><li><a href="#scripting">Scripting</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html" class="current" aria-current="page">Parts</a><ul class="toc-sections"><li><a href="#how-parts-work">How Parts work</a></li><li><a href="#the-parts-list">The Parts list</a></li><li><a href="#add-a-part">Add a Part</a></li><li><a href="#show-hide-and-solo">Show, hide and solo</a></li><li><a href="#reorder-parts">Reorder Parts</a></li><li><a href="#merge-parts">Merge Parts</a></li><li><a href="#split-a-part">Split a Part</a></li><li><a href="#extract-a-shell">Extract a shell</a></li><li><a href="#delete-a-part">Delete a Part</a></li><li><a href="#parts-in-files">Parts in files</a></li><li><a href="#scripting">Scripting</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
<article class="guide-article">
<h1 id="parts">Parts</h1>
-<p>A scene in SculptForge can hold several separate meshes, called Parts (ZBrush users: SubTools): 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>
+<p>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>
<h2 id="how-parts-work">How Parts work<a class="anchor" href="#how-parts-work" aria-label="Link to this section">#</a></h2>
<ul>
<li>
@@ -65,16 +65,15 @@ Each Part keeps its own mesh, mask, vertex paint, face groups, hidden faces, UVs
Each Part has its own undo history. <kbd>Ctrl</kbd>+<kbd>Z</kbd> undoes the last change in the active Part, and switching Parts doesn&#x27;t lose the history of the others.
</li>
<li>
-Adding, deleting, reordering, merging and splitting Parts are <strong>not undoable</strong>, as in ZBrush. Merges and deletes ask for confirmation first.
+Adding, deleting, reordering, merging and splitting Parts are <strong>not undoable</strong>. Merges and deletes ask for confirmation first.
</li>
<li>
-The Parts list highlights the active Part. In the ZBrush-style layout the title strip also shows it and its place in the list, for example <code>Part Helmet (2/5)</code>.
+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 <code>Part Helmet (2/5)</code>.
</li>
</ul>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> Parts work the way you expect: one active Part, the rest dimmed, Alt+click in the viewport to switch. There is no folder grouping of Parts yet.</p></aside>
<h2 id="the-parts-list">The Parts list<a class="anchor" href="#the-parts-list" aria-label="Link to this section">#</a></h2>
<p>The list is in <strong>Tool &gt; Parts</strong>, which is open in the right tray by default.</p>
-<figure class="shot"><a href="images/subtools.jpg" class="zoom"><img src="images/subtools.jpg" alt="The Parts sub-palette with several Parts, the active one highlighted" width="960" height="672" loading="lazy" decoding="async"></a><figcaption>The Parts sub-palette with several Parts, the active one highlighted</figcaption></figure>
+<figure class="shot"><a href="images/parts.jpg" class="zoom"><img src="images/parts.jpg" alt="The Parts sub-palette with several Parts, the active one highlighted" width="960" height="672" loading="lazy" decoding="async"></a><figcaption>The Parts sub-palette with several Parts, the active one highlighted</figcaption></figure>
<p>Each row shows a small picture of the Part, its name, its triangle count 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).</p>
<div class="table-wrap"><table><thead><tr><th>To</th><th>Do this</th></tr></thead><tbody><tr><td>Select a Part</td><td>Click its row, or <kbd>Alt</kbd>+click it in the viewport; triple-click another Part in the viewport to select it and frame it</td></tr><tr><td>Rename it</td><td>Double-click the row (or right-click &gt; <strong>Rename</strong>), type, press <kbd>Enter</kbd></td></tr><tr><td>Hide or show it</td><td>Click the eye at the end of the row</td></tr><tr><td>Duplicate or delete it</td><td>Right-click the row &gt; <strong>Duplicate</strong> (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>D</kbd>) or <strong>Delete...</strong></td></tr><tr><td>See its vertex and triangle counts</td><td>Point at the row for a moment</td></tr></tbody></table></div>
<p>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.</p>
@@ -148,7 +147,7 @@ The eye on each row shows or hides that Part.
</ul>
<p>Both replace the active Part with the pieces. Because a merge keeps each original mesh in its own face group, <strong>Split groups</strong> undoes a merge.</p>
<h2 id="extract-a-shell">Extract a shell<a class="anchor" href="#extract-a-shell" aria-label="Link to this section">#</a></h2>
-<p><strong>Extract</strong>, in <strong>Tool &gt; Parts</strong>, 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 as in ZBrush:</p>
+<p><strong>Extract</strong>, in <strong>Tool &gt; Parts</strong>, 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:</p>
<ol>
<li>
Mask the part (hold <kbd>Ctrl</kbd> and paint, or use <strong>Mask Rectangle</strong> / <strong>Mask Lasso</strong>; see <a href="masking.html">Masking</a>).
@@ -163,16 +162,15 @@ Change <strong>Thick</strong>, <strong>E Smt</strong>, <strong>Double</strong>,
<div class="table-wrap"><table><thead><tr><th>Setting</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Thick</strong></td><td>The shell&#x27;s thickness as a share of the Part&#x27;s size: 0.015 (the default) is 1.5%. Negative grows it inward; 0 makes a single-sided surface</td></tr><tr><td><strong>E Smt</strong></td><td>Smooths the extracted edge, which otherwise follows the mask&#x27;s triangles in steps. 0 keeps it as masked</td></tr><tr><td><strong>Double</strong></td><td>Grows the shell both inward and outward from the surface</td></tr><tr><td><strong>TCorne</strong></td><td>Triangles instead of quads in the rim where the edge turns sharply (over 50 degrees), so tight corners don&#x27;t get twisted quads</td></tr><tr><td><strong>TBorder</strong></td><td>The whole rim is triangles instead of quads</td></tr></tbody></table></div>
<figure class="shot"><a href="images/extract.jpg" class="zoom"><img src="images/extract.jpg" alt="A cap extracted from the masked top of a sphere, shown with its face groups: outer, inner and rim" width="620" height="600" loading="lazy" decoding="async"></a><figcaption>A cap extracted from the masked top of a sphere, shown with its face groups: outer, inner and rim</figcaption></figure>
<p>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 <a href="#split-a-part">split</a> them apart. Vertex Paint comes with it; hidden faces are left out. Accept is one undo step: <kbd>Ctrl</kbd>+<kbd>Z</kbd> on the source Part takes the extracted one away again, and redo brings it back. A preview you don&#x27;t accept goes away as soon as you change the source Part or pick another one, and it is never saved.</p>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> the same Extract, E Smt, Thick, Double, TCorne, TBorder and Accept.</p></aside>
<h2 id="delete-a-part">Delete a Part<a class="anchor" href="#delete-a-part" aria-label="Link to this section">#</a></h2>
<p>Click <strong>Delete...</strong> (or right-click a row &gt; <strong>Delete...</strong>) and confirm. The last Part can&#x27;t be deleted, and a delete can&#x27;t be undone.</p>
<h2 id="parts-in-files">Parts in files<a class="anchor" href="#parts-in-files" aria-label="Link to this section">#</a></h2>
-<div class="table-wrap"><table><thead><tr><th>Format</th><th>What happens to Parts</th></tr></thead><tbody><tr><td>Project (<code>.sfproj</code>)</td><td>Every Part is saved with its name, visibility, attributes, layers and active layer</td></tr><tr><td>OBJ</td><td>Each visible Part is an <code>o</code> object; on import, <code>o</code> objects become Parts and <code>g</code> groups become face groups</td></tr><tr><td>glTF / GLB</td><td>One node and mesh per visible Part, both ways</td></tr><tr><td>FBX</td><td>One model per visible Part (with LODs, an LOD group each), both ways</td></tr><tr><td>USD</td><td>One Mesh prim per visible Part, both ways</td></tr><tr><td>Send to ZBrush (GoZ-compatible exchange)</td><td>Each visible Part is sent to ZBrush as its own SubTool</td></tr><tr><td>PLY, STL, splat conversion</td><td>The visible Parts are merged into one mesh</td></tr></tbody></table></div>
+<div class="table-wrap"><table><thead><tr><th>Format</th><th>What happens to Parts</th></tr></thead><tbody><tr><td>Project (<code>.sfproj</code>)</td><td>Every Part is saved with its name, visibility, attributes, layers and active layer</td></tr><tr><td>OBJ</td><td>Each visible Part is an <code>o</code> object; on import, <code>o</code> objects become Parts and <code>g</code> groups become face groups</td></tr><tr><td>glTF / GLB</td><td>One node and mesh per visible Part, both ways</td></tr><tr><td>FBX</td><td>One model per visible Part (with LODs, an LOD group each), both ways</td></tr><tr><td>USD</td><td>One Mesh prim per visible Part, both ways</td></tr><tr><td>Bridge</td><td>Each visible Part is sent as its own object</td></tr><tr><td>PLY, STL, splat conversion</td><td>The visible Parts are merged into one mesh</td></tr></tbody></table></div>
<p>Opening a multi-object file replaces the scene with one Part per object. See <a href="exporting.html">Exporting</a> for the details of each format.</p>
<h2 id="scripting">Scripting<a class="anchor" href="#scripting" aria-label="Link to this section">#</a></h2>
<p>Every Part action is a command, so you can use them in the <a href="scripting.html">console</a>, scripts, Python and MCP agents. Parts are addressed by <code>index</code> (0 is the top of the list) or <code>name</code>; without either, the active one is used.</p>
<div class="table-wrap"><table><thead><tr><th>Command</th><th>What it does</th></tr></thead><tbody><tr><td><code>subtool_list</code></td><td>List the Parts</td></tr><tr><td><code>subtool_select index=1</code></td><td>Make a Part active</td></tr><tr><td><code>subtool_append type=cube</code></td><td>Add a primitive (<code>sphere</code>, <code>cube</code>, <code>plane</code>); <code>path=</code> adds a file; <code>size=</code> (0.05-2, default 0.35)</td></tr><tr><td><code>subtool_duplicate</code></td><td>Copy a Part</td></tr><tr><td><code>subtool_delete name=Helmet</code></td><td>Delete a Part</td></tr><tr><td><code>subtool_rename to=Body</code></td><td>Rename a Part</td></tr><tr><td><code>subtool_visibility visible=false</code></td><td>Show or hide (toggles when <code>visible</code> is left out)</td></tr><tr><td><code>subtool_solo</code> / <code>subtool_show_all</code></td><td>Solo the active Part / show every Part</td></tr><tr><td><code>subtool_move direction=up</code></td><td>Move a Part up or down the list</td></tr><tr><td><code>subtool_merge_down</code> / <code>subtool_merge_visible</code></td><td>Merge</td></tr><tr><td><code>subtool_split_groups</code> / <code>subtool_split_parts</code></td><td>Split</td></tr><tr><td><code>extract thickness=0.02 smooth=5 double=false</code></td><td>Preview an Extract shell from the mask; <code>tcorne</code> / <code>tborder</code> for a triangle rim; <code>accept=true</code> keeps it at once</td></tr><tr><td><code>extract_accept</code> / <code>extract_cancel</code></td><td>Keep or remove the Extract preview</td></tr></tbody></table></div>
-<div class="code-block"><pre class="code"><code class="language-text">subtool_append type=sphere name=EyeL size=0.12; subtool_duplicate; subtool_rename to=EyeR</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
+<div class="code-block"><pre class="code"><code class="language-text">part_append type=sphere name=EyeL size=0.12; part_duplicate; part_rename to=EyeR</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
<h2 id="see-also">See also<a class="anchor" href="#see-also" aria-label="Link to this section">#</a></h2>
<ul>
<li>
@@ -210,8 +208,7 @@ Change <strong>Thick</strong>, <strong>E Smt</strong>, <strong>Double</strong>,
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/pbr-painting.html b/website/guide/pbr-painting.html
index 146b4927..4f0312f5 100644
--- a/website/guide/pbr-painting.html
+++ b/website/guide/pbr-painting.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Material painting (PBR) - SculptForge User Guide">
<meta property="og:description" content="A painted texture can carry more than colour. Turn on material channels and the Paint brush paints how rough, how metallic, how bumpy and how bright the surface is, all in one stroke, the way game engines and renderers describe materials (physically based rendering, PBR). Every channel lives on the ">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/pbr-painting.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html" class="current" aria-current="page">Material painting (PBR)</a><ul class="toc-sections"><li><a href="#the-channels">The channels</a></li><li><a href="#turn-channels-on">Turn channels on</a></li><li><a href="#paint-a-material">Paint a material</a></li><li><a href="#layers-and-channels">Layers and channels</a></li><li><a href="#the-pbr-viewport">The PBR viewport</a></li><li><a href="#see-one-channel-on-its-own">See one channel on its own</a></li><li><a href="#height-and-normals">Height and normals</a></li><li><a href="#carrying-channels-through-geometry-changes">Carrying channels through geometry changes</a></li><li><a href="#projects">Projects</a></li><li><a href="#commands">Commands</a></li><li><a href="#limitations">Limitations</a></li></ul></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html" class="current" aria-current="page">Material painting (PBR)</a><ul class="toc-sections"><li><a href="#the-channels">The channels</a></li><li><a href="#turn-channels-on">Turn channels on</a></li><li><a href="#paint-a-material">Paint a material</a></li><li><a href="#layers-and-channels">Layers and channels</a></li><li><a href="#the-pbr-viewport">The PBR viewport</a></li><li><a href="#see-one-channel-on-its-own">See one channel on its own</a></li><li><a href="#height-and-normals">Height and normals</a></li><li><a href="#carrying-channels-through-geometry-changes">Carrying channels through geometry changes</a></li><li><a href="#projects">Projects</a></li><li><a href="#commands">Commands</a></li><li><a href="#limitations">Limitations</a></li></ul></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -165,8 +165,7 @@ Export Maps takes a few seconds at 4K and about ten at 8K (PNG compression).
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/performance.html b/website/guide/performance.html
index 7806ebab..13e226ee 100644
--- a/website/guide/performance.html
+++ b/website/guide/performance.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Performance and big meshes - SculptForge User Guide">
<meta property="og:description" content="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">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/performance.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html" class="current" aria-current="page">Performance and big meshes</a><ul class="toc-sections"><li><a href="#what-to-expect">What to expect</a></li><li><a href="#edit--preferences--performance">Edit &gt; Preferences &gt; Performance</a></li><li><a href="#the-hardware-profile">The hardware profile</a></li><li><a href="#working-with-big-meshes">Working with big meshes</a></li><li><a href="#dynamic-topology">Dynamic topology</a></li><li><a href="#proof-mode-see-it-for-yourself">Proof mode: see it for yourself</a></li><li><a href="#measuring-your-own-machine">Measuring your own machine</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html" class="current" aria-current="page">Performance and big meshes</a><ul class="toc-sections"><li><a href="#what-to-expect">What to expect</a></li><li><a href="#edit--preferences--performance">Edit &gt; Preferences &gt; Performance</a></li><li><a href="#the-hardware-profile">The hardware profile</a></li><li><a href="#working-with-big-meshes">Working with big meshes</a></li><li><a href="#dynamic-topology">Dynamic topology</a></li><li><a href="#proof-mode-see-it-for-yourself">Proof mode: see it for yourself</a></li><li><a href="#measuring-your-own-machine">Measuring your own machine</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -157,8 +157,7 @@ sculptforge --benchmark --benchmark-sizes 5,20,33 --benchmark-out spheres.json</
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/phone-capture.html b/website/guide/phone-capture.html
index 4919408a..a4e08685 100644
--- a/website/guide/phone-capture.html
+++ b/website/guide/phone-capture.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Phone capture and AR - SculptForge User Guide">
<meta property="og:description" content="Your phone becomes SculptForge&#x27;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&#x27;s face with your own. There is no app to install and no">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/phone-capture.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html" class="current" aria-current="page">Phone capture and AR</a><ul class="toc-sections"><li><a href="#pair-your-phone">Pair your phone</a></li><li><a href="#scan-an-object">Scan an object</a></li><li><a href="#one-photo-to-3d">One photo to 3D</a></li><li><a href="#send-a-splat-file">Send a splat file</a></li><li><a href="#view-in-ar">View in AR</a></li><li><a href="#face-capture">Face capture</a></li><li><a href="#the-captures-folder">The Captures folder</a></li><li><a href="#privacy-and-security">Privacy and security</a></li></ul></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html" class="current" aria-current="page">Phone capture and AR</a><ul class="toc-sections"><li><a href="#pair-your-phone">Pair your phone</a></li><li><a href="#scan-an-object">Scan an object</a></li><li><a href="#one-photo-to-3d">One photo to 3D</a></li><li><a href="#send-a-splat-file">Send a splat file</a></li><li><a href="#view-in-ar">View in AR</a></li><li><a href="#face-capture">Face capture</a></li><li><a href="#the-captures-folder">The Captures folder</a></li><li><a href="#privacy-and-security">Privacy and security</a></li></ul></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -153,8 +153,7 @@ Nothing you capture is uploaded anywhere except to your computer. A photo goes o
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/polygroups.html b/website/guide/polygroups.html
deleted file mode 100644
index 96650936..00000000
--- a/website/guide/polygroups.html
+++ /dev/null
@@ -1,13 +0,0 @@
-<!doctype html>
-<html lang="en">
-<head>
- <meta charset="utf-8">
- <title>Moved - SculptForge User Guide</title>
- <meta name="robots" content="noindex">
- <link rel="canonical" href="https://sculptforge.app/guide/face-groups.html">
- <meta http-equiv="refresh" content="0; url=face-groups.html">
-</head>
-<body>
- <p>This chapter has moved to <a href="face-groups.html">https://sculptforge.app/guide/face-groups.html</a>.</p>
-</body>
-</html>
diff --git a/website/guide/polypaint.html b/website/guide/polypaint.html
deleted file mode 100644
index be2bf7e1..00000000
--- a/website/guide/polypaint.html
+++ /dev/null
@@ -1,13 +0,0 @@
-<!doctype html>
-<html lang="en">
-<head>
- <meta charset="utf-8">
- <title>Moved - SculptForge User Guide</title>
- <meta name="robots" content="noindex">
- <link rel="canonical" href="https://sculptforge.app/guide/vertex-paint.html">
- <meta http-equiv="refresh" content="0; url=vertex-paint.html">
-</head>
-<body>
- <p>This chapter has moved to <a href="vertex-paint.html">https://sculptforge.app/guide/vertex-paint.html</a>.</p>
-</body>
-</html>
diff --git a/website/guide/projects.html b/website/guide/projects.html
index d488964f..b32179f4 100644
--- a/website/guide/projects.html
+++ b/website/guide/projects.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Projects, autosave and snapshots - SculptForge User Guide">
<meta property="og:description" content="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 ">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/projects.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html" class="current" aria-current="page">Projects, autosave and snapshots</a><ul class="toc-sections"><li><a href="#what-a-project-keeps">What a project keeps</a></li><li><a href="#save-a-project">Save a project</a></li><li><a href="#open-a-project-or-model">Open a project or model</a></li><li><a href="#start-from-a-starter-mesh">Start from a starter mesh</a></li><li><a href="#the-unsaved-changes-prompt">The unsaved-changes prompt</a></li><li><a href="#autosave-and-crash-recovery">Autosave and crash recovery</a></li><li><a href="#snapshots">Snapshots</a></li><li><a href="#your-library-folder-and-the-library">Your library folder and the Library</a></li><li><a href="#scripting">Scripting</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html" class="current" aria-current="page">Projects, autosave and snapshots</a><ul class="toc-sections"><li><a href="#what-a-project-keeps">What a project keeps</a></li><li><a href="#save-a-project">Save a project</a></li><li><a href="#open-a-project-or-model">Open a project or model</a></li><li><a href="#start-from-a-starter-mesh">Start from a starter mesh</a></li><li><a href="#the-unsaved-changes-prompt">The unsaved-changes prompt</a></li><li><a href="#autosave-and-crash-recovery">Autosave and crash recovery</a></li><li><a href="#snapshots">Snapshots</a></li><li><a href="#your-library-folder-and-the-library">Your library folder and the Library</a></li><li><a href="#scripting">Scripting</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -80,7 +80,6 @@ a thumbnail, shown in the Library.
</ul>
<p>Undo history isn&#x27;t saved: an opened project starts with a clean history.</p>
<p>Model formats such as OBJ, GLB or FBX can&#x27;t hold all of this (masks, hidden faces, splats, brushes), so writing them is an export, not a save. See <a href="exporting.html">Exporting</a>.</p>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> A <code>.sfproj</code> is the equivalent of a ZBrush project (<code>.ZPR</code>), and saving a single Part scene is close to saving a <code>.ZTL</code>. SculptForge can&#x27;t read <code>.ZPR</code> files, and opens a <code>.ZTL</code> only after the <a href="coming-from-zbrush.html#bring-your-ztools-over">ZTL Export plug-in</a> converted it in ZBrush; otherwise bring models over with <a href="exporting.html">Send to ZBrush</a> or as OBJ, FBX or GLB.</p></aside>
<h2 id="save-a-project">Save a project<a class="anchor" href="#save-a-project" aria-label="Link to this section">#</a></h2>
<ul>
<li>
@@ -90,7 +89,7 @@ a thumbnail, shown in the Library.
<strong>File &gt; Save As...</strong> (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>S</kbd>) saves under a new name.
</li>
<li>
-In the ZBrush-style layout, clicking the document name in the title strip also saves.
+In the Classic layout, clicking the document name in the title strip also saves.
</li>
</ul>
<p>The bar along the top shows the file name with <code>*</code> after it while there are unsaved changes, and the window title starts with <code>*</code>. Any edit in any Part counts, as do splat edits and layer weight changes.</p>
@@ -147,7 +146,7 @@ In the <a href="interface.html">Library</a>, double-click a project or model.
<p>The autosave also appears first in the Library <strong>Snapshots</strong> tab while it exists.</p>
<aside class="callout callout-note"><p><strong>Note:</strong> 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></aside>
<h2 id="snapshots">Snapshots<a class="anchor" href="#snapshots" aria-label="Link to this section">#</a></h2>
-<p><strong>File &gt; Save Snapshot</strong> (also the <strong>Snapshot</strong> button in the ZBrush-style layout&#x27;s title strip) saves a timestamped copy of the whole scene (ZBrush users: QuickSave). Your project file, its name and its unsaved state are not changed, so a snapshot is safe to take before any risky step.</p>
+<p><strong>File &gt; Save Snapshot</strong> (also the <strong>Snapshot</strong> button in the Classic layout&#x27;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.</p>
<ul>
<li>
Copies go to the <code>QuickSave</code> folder of your library (by default <code>Documents/SculptForge/QuickSave</code>), named like <code>Snapshot 2026-10-21 23-15-04.sfproj</code> (older <code>QuickSave ...</code> files are listed too).
@@ -159,7 +158,7 @@ The last 10 snapshots are kept; older ones are deleted.
They appear in the Library <strong>Snapshots</strong> tab, newest first, labelled with their date and time. Double-click one to open it. The tab also has a <strong>Save now</strong> button.
</li>
</ul>
-<p>With the ZBrush-style keys (<strong>Edit &gt; Preferences &gt; Input</strong>) <kbd>9</kbd> takes a snapshot; otherwise it has no default shortcut. To give it one, hold <kbd>Ctrl</kbd>+<kbd>Alt</kbd>, click the <strong>Snapshot</strong> button and press a key (see <a href="interface.html">The interface</a>).</p>
+<p>With the Classic sculpting keys (<strong>Edit &gt; Preferences &gt; Input</strong>) <kbd>9</kbd> takes a snapshot; otherwise it has no default shortcut. To give it one, hold <kbd>Ctrl</kbd>+<kbd>Alt</kbd>, click the <strong>Snapshot</strong> button and press a key (see <a href="interface.html">The interface</a>).</p>
<h2 id="your-library-folder-and-the-library">Your library folder and the Library<a class="anchor" href="#your-library-folder-and-the-library" aria-label="Link to this section">#</a></h2>
<p>SculptForge keeps a library folder for your work, by default <code>SculptForge</code> in your Documents folder. It is created on first use with these sub-folders:</p>
<div class="table-wrap"><table><thead><tr><th>Folder</th><th>Library tab</th><th>What goes there</th></tr></thead><tbody><tr><td><code>Projects</code></td><td>Project</td><td>Your <code>.sfproj</code> files</td></tr><tr><td><code>Tools</code></td><td>Tool</td><td>Models to open or append as Parts</td></tr><tr><td><code>Brushes</code></td><td>Brush</td><td><code>.sfbrush</code> files</td></tr><tr><td><code>Alphas</code></td><td>Alpha</td><td>Grayscale images for brush alphas</td></tr><tr><td><code>MatCaps</code></td><td>Material</td><td>Lit Sphere images, loaded as materials at start-up</td></tr><tr><td><code>Images</code></td><td>Image</td><td>Sketches and concept art for Generate 3D</td></tr><tr><td><code>Splats</code></td><td>Splats</td><td>Gaussian splat captures</td></tr><tr><td><code>QuickSave</code></td><td>Snapshots</td><td>Snapshots</td></tr></tbody></table></div>
@@ -177,7 +176,7 @@ They appear in the Library <strong>Snapshots</strong> tab, newest first, labelle
</li>
</ul>
<p>Double-click a tile to open it (you are asked about unsaved changes first). In the <strong>Tool</strong> tab, <kbd>Shift</kbd>+double-click a model to append it as a Part instead.</p>
-<figure class="shot"><a href="images/lightbox.jpg" class="zoom"><img src="images/lightbox.jpg" alt="The Library showing project thumbnails" width="930" height="145" loading="lazy" decoding="async"></a><figcaption>The Library showing project thumbnails</figcaption></figure>
+<figure class="shot"><a href="images/library.jpg" class="zoom"><img src="images/library.jpg" alt="The Library showing project thumbnails" width="930" height="145" loading="lazy" decoding="async"></a><figcaption>The Library showing project thumbnails</figcaption></figure>
<h2 id="scripting">Scripting<a class="anchor" href="#scripting" aria-label="Link to this section">#</a></h2>
<div class="table-wrap"><table><thead><tr><th>Command</th><th>What it does</th></tr></thead><tbody><tr><td><code>save_project path=work/dragon.sfproj</code></td><td>Save the project (without <code>path</code>, to the current project)</td></tr><tr><td><code>open_project path=work/dragon.sfproj</code></td><td>Open a project (<code>open</code> also recognises <code>.sfproj</code>)</td></tr><tr><td><code>open path=scan.obj</code></td><td>Open a model, splat capture or project</td></tr><tr><td><code>new_sphere subdivisions=6</code> / <code>new_plane resolution=128</code></td><td>Start a new scene</td></tr><tr><td><code>new_starter_mesh name=human-head</code></td><td>Start from a starter mesh (<code>levels=0</code> for the bare base cage)</td></tr></tbody></table></div>
<p>Projects saved by <code>sculptforge-cli</code> or Python open in the app too. For the file layout, see <a href="https://github.com/islandmed/SculptForge/blob/main/docs/project-format.md" rel="noopener">docs/project-format.md</a>.</p>
@@ -218,8 +217,7 @@ They appear in the Library <strong>Snapshots</strong> tab, newest first, labelle
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/quick-tour.html b/website/guide/quick-tour.html
new file mode 100644
index 00000000..f31bc976
--- /dev/null
+++ b/website/guide/quick-tour.html
@@ -0,0 +1,102 @@
+<!doctype html>
+<html lang="en">
+<head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <title>Quick tour for experienced sculptors - SculptForge User Guide</title>
+ <meta name="description" content="If you have sculpted in another app, most habits carry over. This page shows where things are and how to set SculptForge up the way your hands expect.">
+ <meta name="theme-color" content="#111114">
+ <meta name="color-scheme" content="dark">
+ <link rel="icon" type="image/svg+xml" href="../img/favicon.svg?v=2">
+ <link rel="icon" type="image/png" href="../img/favicon-64.png?v=2">
+ <link rel="apple-touch-icon" href="../img/icon-256.png?v=2">
+ <link rel="canonical" href="https://sculptforge.app/guide/quick-tour.html">
+ <meta property="og:type" content="article">
+ <meta property="og:title" content="Quick tour for experienced sculptors - SculptForge User Guide">
+ <meta property="og:description" content="If you have sculpted in another app, most habits carry over. This page shows where things are and how to set SculptForge up the way your hands expect.">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
+ <meta property="og:url" content="https://sculptforge.app/guide/quick-tour.html">
+ <link rel="stylesheet" href="../style.css?v=19">
+ <script src="../motion.js?v=11" defer></script>
+ <script data-goatcounter="https://sculptforge.goatcounter.com/count" async src="https://gc.zgo.at/count.js"></script>
+ <script src="search-index.js?v=47" defer></script>
+</head>
+<body class="guide-page" data-prev="whats-new.html" data-next="installing.html">
+ <div class="scroll-progress" aria-hidden="true"></div>
+ <header class="nav">
+ <div class="wrap nav-inner">
+ <a class="brand" href="../index.html"><img src="../img/logo.svg?v=2" alt="" width="34" height="34"><span>SculptForge</span></a>
+ <nav aria-label="Main">
+ <a href="../index.html#features">Features</a>
+ <a href="../index.html#demos">Demos</a>
+ <a href="../brushes.html">Brushes</a>
+ <a href="index.html" aria-current="page">Guide</a>
+ <a class="nav-dl" href="../index.html#download">Download</a>
+ <a class="gh" href="https://discord.gg/gWrYkEmQhH">Discord</a>
+ <a class="gh" href="https://github.com/islandmed/SculptForge">GitHub</a>
+ </nav>
+ </div>
+ </header>
+ <div class="wrap guide-layout">
+ <div class="guide-side">
+ <button class="toc-toggle" type="button" aria-expanded="false" aria-controls="guide-toc">
+ <span>Contents</span><span class="toc-current">Quick tour for experienced sculptors</span></button>
+ <div id="guide-toc" class="toc-panel">
+ <div class="guide-search" role="search">
+ <input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
+ <div class="search-results" id="guide-results" hidden></div>
+ </div>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html" class="current" aria-current="page">Quick tour for experienced sculptors</a><ul class="toc-sections"><li><a href="#keys-and-layout">Keys and layout</a></li><li><a href="#where-things-are">Where things are</a></li><li><a href="#bringing-your-work-over">Bringing your work over</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ </div>
+ </div>
+ <main class="guide-main" id="top">
+ <article class="guide-article">
+<h1 id="quick-tour-for-experienced-sculptors">Quick tour for experienced sculptors</h1>
+<p>If you have sculpted in another app, most habits carry over. This page shows where things are and how to set SculptForge up the way your hands expect.</p>
+<h2 id="keys-and-layout">Keys and layout<a class="anchor" href="#keys-and-layout" aria-label="Link to this section">#</a></h2>
+<p>At the first start, pick <strong>Classic sculpting keys</strong> when SculptForge asks what you are coming from. It turns on the classic keys and gestures and the <strong>Classic layout</strong>: a title strip, the alphabetical palette bar and a two-row top shelf. Change either later in <strong>Edit &gt; Preferences &gt; Input</strong> and <strong>Edit &gt; Preferences &gt; Interface &gt; Look</strong>.</p>
+<p>With the Classic sculpting keys you sculpt with a left drag, hold <kbd>Alt</kbd> to subtract and <kbd>Shift</kbd> to smooth, drag on the background to rotate, <kbd>Alt</kbd>+drag to pan, and hold <kbd>Ctrl</kbd> to mask. <kbd>S</kbd>, <kbd>U</kbd>, <kbd>I</kbd> and <kbd>O</kbd> put the Draw Size, Intensity, RGB Intensity and Falloff sliders under the cursor, <kbd>Space</kbd> opens the Quick Menu, <kbd>B</kbd> opens the brush pop-up with the same letter keys (B, S, T picks Standard), <kbd>,</kbd> opens the Library and <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd> stores your interface. Every key is listed in <a href="shortcuts.html#classic-sculpting-keys">Keyboard and mouse</a>.</p>
+<h2 id="where-things-are">Where things are<a class="anchor" href="#where-things-are" aria-label="Link to this section">#</a></h2>
+<div class="table-wrap"><table><thead><tr><th>Looking for</th><th>In SculptForge</th></tr></thead><tbody><tr><td>Separate meshes in one scene</td><td><strong>Parts</strong>: <strong>Tool &gt; Parts</strong> (<a href="parts.html">Parts</a>)</td></tr><tr><td>Blocking out from spheres</td><td><strong>Forge Spheres</strong>: <strong>Tool &gt; Forge Spheres</strong> (<a href="forge-spheres.html">Forge Spheres</a>)</td></tr><tr><td>Colour on the vertices</td><td><strong>Vertex Paint</strong> (<a href="vertex-paint.html">Vertex paint and materials</a>)</td></tr><tr><td>Groups of faces to mask, hide and split by</td><td><strong>Face Groups</strong> (<a href="face-groups.html">Face groups and visibility</a>)</td></tr><tr><td>Viewport materials from a lit-sphere image</td><td><strong>Lit Spheres</strong> (<strong>Material</strong>)</td></tr><tr><td>Your projects, brushes, alphas and materials</td><td><strong>Library</strong> (<kbd>,</kbd>)</td></tr><tr><td>An even, watertight remesh</td><td><strong>Tool &gt; Remesh &gt; Voxel Remesh</strong> (<a href="geometry.html">Geometry</a>)</td></tr><tr><td>Automatic quad retopology</td><td><strong>Tool &gt; Geometry &gt; Quad Remesh</strong> (<a href="retopology.html">Retopology</a>)</td></tr><tr><td>Sculpting that adds detail where the brush goes</td><td><strong>Dynamic topology</strong> (<a href="dynamic-topology.html">Dynamic topology</a>)</td></tr><tr><td>Subdivision levels</td><td><strong>Tool &gt; Geometry &gt; Divide</strong> (<a href="subdivision-levels.html">Subdivision levels</a>)</td></tr></tbody></table></div>
+<p>The command palette (<kbd>F3</kbd>) finds any feature by what it does: type &quot;remesh&quot;, &quot;groups&quot; or &quot;folders&quot;.</p>
+<h2 id="bringing-your-work-over">Bringing your work over<a class="anchor" href="#bringing-your-work-over" aria-label="Link to this section">#</a></h2>
+<p>Export OBJ, FBX, glTF or USD from the other app and open it here: quads, UVs and groups come along. Or use the <strong>Bridge</strong> (<strong>File &gt; Bridge</strong>) to send Parts back and forth with face groups, mask and vertex paint; see <a href="exporting.html#exchange-models-through-the-bridge">Exporting, Unreal and Bridge</a>.</p>
+<h2 id="see-also">See also<a class="anchor" href="#see-also" aria-label="Link to this section">#</a></h2>
+<ul>
+<li>
+<a href="interface.html">The interface</a>
+</li>
+<li>
+<a href="shortcuts.html">Keyboard and mouse</a>
+</li>
+<li>
+<a href="glossary.html">Glossary</a>
+</li>
+</ul>
+ </article>
+ <nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="whats-new.html"><span>Previous</span>What&#x27;s new</a><a class="next" rel="next" href="installing.html"><span>Next</span>Install SculptForge on Windows, macOS and Linux</a></nav>
+ <p class="guide-meta fine">Also in the app: <strong>Help &gt; User Guide</strong> (<kbd>Shift</kbd>+<kbd>F1</kbd>).
+ Found a mistake? <a href="https://github.com/islandmed/SculptForge/edit/main/docs/guide/quick-tour.md">Edit this page on GitHub</a>.</p>
+ </main>
+ <aside class="on-page" aria-label="On this page"><p>On this page</p><ul><li><a href="#keys-and-layout">Keys and layout</a></li><li><a href="#where-things-are">Where things are</a></li><li><a href="#bringing-your-work-over">Bringing your work over</a></li><li><a href="#see-also">See also</a></li></ul></aside>
+ </div>
+ <footer class="footer">
+ <div class="wrap footer-grid">
+ <div>
+ <a class="brand" href="../index.html"><img src="../img/logo.svg?v=2" alt="" width="28" height="28"><span>SculptForge</span></a>
+ <p class="fine">Copyright © 2026 The SculptForge contributors.<br>The SculptForge User Guide is part of
+ SculptForge, licensed under the <a href="https://github.com/islandmed/SculptForge/blob/main/LICENSE">GNU GPL v3.0 or later</a>.</p>
+ </div>
+ <div class="links">
+ <a href="index.html">User guide</a>
+ <a href="../supporters.html">Supporters</a>
+ <a href="https://github.com/islandmed/SculptForge">Source code</a>
+ <a href="https://discord.gg/gWrYkEmQhH">Community Discord</a>
+ <a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
+ <a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
+ </div>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
+ </div>
+ </footer>
+</body>
+</html>
diff --git a/website/guide/retopology.html b/website/guide/retopology.html
index 6d49eb61..8887648f 100644
--- a/website/guide/retopology.html
+++ b/website/guide/retopology.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Quad retopology and detail projection - SculptForge User Guide</title>
- <meta name="description" content="Quad Remesh rebuilds a sculpt as clean, all-quad topology whose edge loops follow the forms, like ZBrush&#x27;s ZRemesher. Project All then moves a mesh onto the surface of other Parts, so the detail of the original sculpt comes back onto the new topology, like ZBrush&#x27;s Project All. Together they turn a ">
+ <meta name="description" content="Quad Remesh rebuilds a sculpt as clean, all-quad topology whose edge loops follow the forms. Project All 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-g">
<meta name="theme-color" content="#111114">
<meta name="color-scheme" content="dark">
<link rel="icon" type="image/svg+xml" href="../img/favicon.svg?v=2">
@@ -13,8 +13,8 @@
<link rel="canonical" href="https://sculptforge.app/guide/retopology.html">
<meta property="og:type" content="article">
<meta property="og:title" content="Quad retopology and detail projection - SculptForge User Guide">
- <meta property="og:description" content="Quad Remesh rebuilds a sculpt as clean, all-quad topology whose edge loops follow the forms, like ZBrush&#x27;s ZRemesher. Project All then moves a mesh onto the surface of other Parts, so the detail of the original sculpt comes back onto the new topology, like ZBrush&#x27;s Project All. Together they turn a ">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:description" content="Quad Remesh rebuilds a sculpt as clean, all-quad topology whose edge loops follow the forms. Project All 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-g">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/retopology.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,13 +46,13 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html" class="current" aria-current="page">Quad retopology and detail projection</a><ul class="toc-sections"><li><a href="#the-usual-workflow">The usual workflow</a></li><li><a href="#quad-remesh">Quad Remesh</a></li><li><a href="#quad-remesh-guides">Quad Remesh Guides</a></li><li><a href="#project-all">Project All</a></li><li><a href="#scripting">Scripting</a></li><li><a href="#see-also">See also</a></li></ul></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html" class="current" aria-current="page">Quad retopology and detail projection</a><ul class="toc-sections"><li><a href="#the-usual-workflow">The usual workflow</a></li><li><a href="#quad-remesh">Quad Remesh</a></li><li><a href="#quad-remesh-guides">Quad Remesh Guides</a></li><li><a href="#project-all">Project All</a></li><li><a href="#scripting">Scripting</a></li><li><a href="#see-also">See also</a></li></ul></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
<article class="guide-article">
<h1 id="quad-retopology-and-detail-projection">Quad retopology and detail projection</h1>
-<p><strong>Quad Remesh</strong> rebuilds a sculpt as clean, all-quad topology whose edge loops follow the forms, like ZBrush&#x27;s ZRemesher. <strong>Project All</strong> then moves a mesh onto the surface of other Parts, so the detail of the original sculpt comes back onto the new topology, like ZBrush&#x27;s Project All. Together they turn a dense, messy sculpt (a voxel remesh, a scan, an AI-generated model) into a light quad mesh you can divide, sculpt on, unwrap and animate.</p>
+<p><strong>Quad Remesh</strong> rebuilds a sculpt as clean, all-quad topology whose edge loops follow the forms. <strong>Project All</strong> 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.</p>
<figure class="shot"><a href="images/qremesh.jpg" class="zoom"><img src="images/qremesh.jpg" alt="A lion bust after Quad Remesh: 5,000 quads whose loops follow the mane, shown with Wire" width="1100" height="660" loading="lazy" decoding="async"></a><figcaption>A lion bust after Quad Remesh: 5,000 quads whose loops follow the mane, shown with Wire</figcaption></figure>
<h2 id="the-usual-workflow">The usual workflow<a class="anchor" href="#the-usual-workflow" aria-label="Link to this section">#</a></h2>
<ol>
@@ -76,11 +76,11 @@ Hide or delete the original. You now have the same sculpt on clean quads.
<p>Both steps are single undo steps (<kbd>Ctrl</kbd>+<kbd>Z</kbd>).</p>
<h2 id="quad-remesh">Quad Remesh<a class="anchor" href="#quad-remesh" aria-label="Link to this section">#</a></h2>
<p><strong>Tool &gt; Remesh &gt; Quad Remesh</strong> (also under <strong>Tool &gt; Geometry</strong>) works on the active Part.</p>
-<div class="table-wrap"><table><thead><tr><th>Control</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Quad Remesh</strong></td><td>Starts the retopology. The status line reports the result and its quality, e.g. &quot;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&quot;</td></tr><tr><td><strong>Method</strong></td><td><strong>Quad Remesh 2</strong> (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. <strong>Legacy</strong>: the method of SculptForge 0.9, kept for comparison and for closed guide loops</td></tr><tr><td><strong>Target Polygons</strong></td><td>About how many quads to make (100 to 200,000 on the slider, more from scripts). The result is usually within 5% of it</td></tr><tr><td><strong>Half / Same / Double</strong></td><td>Set the target to half, the same as or twice the Part&#x27;s current polygon count</td></tr><tr><td><strong>Adaptive Size</strong></td><td>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</td></tr><tr><td><strong>Keep Groups</strong></td><td>Edge loops run exactly along the face group borders, and the result keeps the face groups</td></tr><tr><td><strong>Detect Edges</strong></td><td>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&#x27;s or a sculpt&#x27;s deep creases are left to the flow); the legacy method any edge over 50 degrees</td></tr><tr><td><strong>Use Vertex Paint</strong></td><td>Paint where you want density: red areas get up to four times the quads, blue areas down to a quarter, white areas are unchanged</td></tr><tr><td><strong>Symmetry</strong></td><td>Remesh one half and mirror it, welded on the seam, for exactly symmetric topology (on by default). It mirrors on the axis chosen in <strong>Sculpt &gt; Symmetry &amp; Gizmo</strong> (X if none), across the model&#x27;s own middle plane: the world&#x27;s centre plane when the model is symmetric about it, otherwise the plane through the model&#x27;s middle, so a model moved away from the centre works too. A model that isn&#x27;t mirror-symmetric is remeshed whole instead, and the status line says &quot;Symmetry off: the model isn&#x27;t mirror-symmetric&quot;; one that is nearly symmetric (a bump on one side) gets mirrored topology that follows each side&#x27;s own surface</td></tr><tr><td><strong>Keep Original</strong></td><td>Keep the Part as it was, hidden, below the new one, ready for Project All. Off: the Part is replaced, as in ZBrush (undo brings it back)</td></tr><tr><td><strong>Keep Masked</strong></td><td>Masked areas keep their triangles exactly, as a fixed piece: only the unmasked part is remeshed (the target counts its quads), and it&#x27;s joined to the masked part along the mask&#x27;s edge with a strip of triangles, so the model stays closed. If the mask&#x27;s edge can&#x27;t be joined up, the status line says so and nothing changes (off by default; <code>qremesh keep_masked=true</code>)</td></tr><tr><td><strong>Keep Texture</strong></td><td>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</td></tr><tr><td><strong>Quad Remesh Guides</strong></td><td>Picks the guides brush: draw curves on the model for the edge loops to follow. See <a href="#quad-remesh-guides">Quad Remesh Guides</a></td></tr><tr><td><strong>Delete Last</strong> / <strong>Clear</strong></td><td>Delete the last guide curve drawn (with its mirror copies), or all of them</td></tr><tr><td><strong>Curves Strength</strong></td><td>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)</td></tr><tr><td><strong>Quality Report</strong></td><td>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)</td></tr></tbody></table></div>
+<div class="table-wrap"><table><thead><tr><th>Control</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Quad Remesh</strong></td><td>Starts the retopology. The status line reports the result and its quality, e.g. &quot;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&quot;</td></tr><tr><td><strong>Method</strong></td><td><strong>Quad Remesh 2</strong> (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. <strong>Legacy</strong>: the method of SculptForge 0.9, kept for comparison and for closed guide loops</td></tr><tr><td><strong>Target Polygons</strong></td><td>About how many quads to make (100 to 200,000 on the slider, more from scripts). The result is usually within 5% of it</td></tr><tr><td><strong>Half / Same / Double</strong></td><td>Set the target to half, the same as or twice the Part&#x27;s current polygon count</td></tr><tr><td><strong>Adaptive Size</strong></td><td>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</td></tr><tr><td><strong>Keep Groups</strong></td><td>Edge loops run exactly along the face group borders, and the result keeps the face groups</td></tr><tr><td><strong>Detect Edges</strong></td><td>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&#x27;s or a sculpt&#x27;s deep creases are left to the flow); the legacy method any edge over 50 degrees</td></tr><tr><td><strong>Use Vertex Paint</strong></td><td>Paint where you want density: red areas get up to four times the quads, blue areas down to a quarter, white areas are unchanged</td></tr><tr><td><strong>Symmetry</strong></td><td>Remesh one half and mirror it, welded on the seam, for exactly symmetric topology (on by default). It mirrors on the axis chosen in <strong>Sculpt &gt; Symmetry &amp; Gizmo</strong> (X if none), across the model&#x27;s own middle plane: the world&#x27;s centre plane when the model is symmetric about it, otherwise the plane through the model&#x27;s middle, so a model moved away from the centre works too. A model that isn&#x27;t mirror-symmetric is remeshed whole instead, and the status line says &quot;Symmetry off: the model isn&#x27;t mirror-symmetric&quot;; one that is nearly symmetric (a bump on one side) gets mirrored topology that follows each side&#x27;s own surface</td></tr><tr><td><strong>Keep Original</strong></td><td>Keep the Part as it was, hidden, below the new one, ready for Project All. Off: the Part is replaced (undo brings it back)</td></tr><tr><td><strong>Keep Masked</strong></td><td>Masked areas keep their triangles exactly, as a fixed piece: only the unmasked part is remeshed (the target counts its quads), and it&#x27;s joined to the masked part along the mask&#x27;s edge with a strip of triangles, so the model stays closed. If the mask&#x27;s edge can&#x27;t be joined up, the status line says so and nothing changes (off by default; <code>qremesh keep_masked=true</code>)</td></tr><tr><td><strong>Keep Texture</strong></td><td>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</td></tr><tr><td><strong>Quad Remesh Guides</strong></td><td>Picks the guides brush: draw curves on the model for the edge loops to follow. See <a href="#quad-remesh-guides">Quad Remesh Guides</a></td></tr><tr><td><strong>Delete Last</strong> / <strong>Clear</strong></td><td>Delete the last guide curve drawn (with its mirror copies), or all of them</td></tr><tr><td><strong>Curves Strength</strong></td><td>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)</td></tr><tr><td><strong>Quality Report</strong></td><td>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)</td></tr></tbody></table></div>
<p>What happens to your data:</p>
<ul>
<li>
-The result is all quads (stored as pairs of triangles, so <strong>Wire</strong> draws quads and OBJ, FBX, PLY, USD and GoZ-compatible export them as quads), closed wherever the sculpt is closed. Open edges of the sculpt stay open, along the same outline.
+The result is all quads (stored as pairs of triangles, so <strong>Wire</strong> 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.
</li>
<li>
Sculpt layers are baked into the surface: the result has no layers.
@@ -142,9 +142,8 @@ Thin parts (a blade, a fin, a slab thinner than a quad) keep both their sides, a
<p>On smooth sculpts with Adaptive Size the corners are a few degrees further from square than the legacy method&#x27;s: the grid bends to vary the quad size instead of adding poles. Set Adaptive Size to 0 for the squarest grid.</p>
<p>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.</p>
<p>The legacy method (<strong>Method &gt; Legacy</strong>, <code>method=legacy</code>) 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 the spacing and split, which shows as paired loops.</p>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> Quad Remesh Guides work like ZBrush&#x27;s ZRemesher Guides brush, and Curves Strength like its slider of that name. Keep Groups, Use Vertex Paint, Adaptive Size, Half / Same / Double and symmetry work as you know them. There is no Freeze Border / Freeze Groups yet, and the mask doesn&#x27;t steer Quad Remesh: use vertex paint for density.</p></aside>
<h2 id="quad-remesh-guides">Quad Remesh Guides<a class="anchor" href="#quad-remesh-guides" aria-label="Link to this section">#</a></h2>
-<p>Draw curves on the sculpt and Quad Remesh puts an edge loop along each one, and turns the flow around it to follow, like ZBrush&#x27;s ZRemesher 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.</p>
+<p>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.</p>
<figure class="shot"><a href="images/qremesh-guides.jpg" class="zoom"><img src="images/qremesh-guides.jpg" alt="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" width="1200" height="384" loading="lazy" decoding="async"></a><figcaption>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</figcaption></figure>
<ol>
<li>
@@ -204,7 +203,7 @@ Project All is fast enough to use on dense meshes: about 0.6 seconds to project
<aside class="callout callout-tip"><p><strong>Tip:</strong> Project after each division, not only at the end: divide once, Project All, divide again, Project All. Each pass starts closer to the sculpt, so a small <strong>Dist</strong> is enough and thin parts don&#x27;t jump to the wrong surface.</p></aside>
<h2 id="scripting">Scripting<a class="anchor" href="#scripting" aria-label="Link to this section">#</a></h2>
<div class="table-wrap"><table><thead><tr><th>Command</th><th>Options</th></tr></thead><tbody><tr><td><code>qremesh</code></td><td><code>method</code> (<code>v2</code>, the default, or <code>legacy</code>), <code>quality</code> (report poles, corner angles and the distance to the sculpt, default true), <code>target</code> (16 to 2,000,000, default 5000), <code>adaptive</code> (0-1, default 0.5), <code>keep_groups</code>, <code>detect_edges</code> (default true), <code>use_polypaint</code>, <code>symmetry</code> (<code>x</code>, <code>y</code> or <code>z</code>; off by default in scripts; the mirror plane is found from the model), <code>symmetry_center</code> (use this plane instead, e.g. <code>0</code> for the world&#x27;s centre), <code>keep_original</code>, <code>smooth</code> (relaxation passes, default 6), <code>seed</code> (legacy method only; Quad Remesh 2 has no random start), <code>keep_texture</code> (default true), <code>guides</code> (follow the Part&#x27;s Quad Remesh Guides, default true), <code>curves_strength</code> (0-100, default 50)</td></tr><tr><td><code>qremesh_guide</code></td><td><code>points</code> (the curve, <code>&quot;x,y,z x,y,z ...&quot;</code>), <code>view</code> (project the points onto the surface along this direction, as a stroke from the camera; default: each point to the closest surface point), <code>symmetry</code> (<code>x</code>, <code>xz</code>...; mirror the curve)</td></tr><tr><td><code>qremesh_guide_delete_last</code>, <code>qremesh_guides_clear</code>, <code>qremesh_guides_info</code></td><td>Delete the last curve, delete all, list them</td></tr><tr><td><code>project_all</code></td><td><code>distance</code> (0.001-1, default 0.02), <code>mean</code>, <code>blur</code> (0-20), <code>geometry</code> (default true), <code>polypaint</code> (default true), <code>source</code> (one Part&#x27;s name instead of all visible ones)</td></tr></tbody></table></div>
-<div class="code-block"><pre class="code"><code class="language-sh">sculptforge-cli -c &#x27;open path=scan.glb; qremesh target=8000 adaptive=0.3 keep_original=true; subdivide levels=2; subtool_visibility index=1 visible=true; project_all distance=0.02; export_fbx path=retopo.fbx&#x27;</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
+<div class="code-block"><pre class="code"><code class="language-sh">sculptforge-cli -c &#x27;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&#x27;</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
<div class="code-block"><pre class="code"><code class="language-sh">sculptforge-cli -c &#x27;open path=head.glb; qremesh_guide points=&quot;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&quot; view=0,0,-1 symmetry=x; qremesh target=4000 symmetry=x curves_strength=70&#x27;</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
<p>From scripts <code>qremesh</code> runs straight away (it doesn&#x27;t return until it&#x27;s done); in the app the button runs it in the background.</p>
<h2 id="see-also">See also<a class="anchor" href="#see-also" aria-label="Link to this section">#</a></h2>
@@ -247,8 +246,7 @@ Project All is fast enough to use on dense meshes: about 0.6 seconds to project
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/scan-to-sculptable.html b/website/guide/scan-to-sculptable.html
index 93da357c..3e7eb264 100644
--- a/website/guide/scan-to-sculptable.html
+++ b/website/guide/scan-to-sculptable.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="From scan to sculptable mesh - SculptForge User Guide">
<meta property="og:description" content="A Gaussian-splat capture looks great but you can&#x27;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">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/scan-to-sculptable.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html" class="current" aria-current="page">From scan to sculptable mesh</a><ul class="toc-sections"><li><a href="#one-click">One click</a></li><li><a href="#the-options">The options</a></li><li><a href="#face-loops-animation-topology-for-heads">Face loops: animation topology for heads</a></li><li><a href="#the-crop-box">The crop box</a></li><li><a href="#what-happens-inside">What happens inside</a></li><li><a href="#speed">Speed</a></li><li><a href="#how-good-is-it">How good is it?</a></li><li><a href="#from-scripts">From scripts</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html" class="current" aria-current="page">From scan to sculptable mesh</a><ul class="toc-sections"><li><a href="#one-click">One click</a></li><li><a href="#the-options">The options</a></li><li><a href="#face-loops-animation-topology-for-heads">Face loops: animation topology for heads</a></li><li><a href="#the-crop-box">The crop box</a></li><li><a href="#what-happens-inside">What happens inside</a></li><li><a href="#speed">Speed</a></li><li><a href="#how-good-is-it">How good is it?</a></li><li><a href="#from-scripts">From scripts</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -223,8 +223,7 @@ sculptforge-cli -c &#x27;open path=head.ply; splat_to_mesh stage=scan preset=fil
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/scan-to-splat.html b/website/guide/scan-to-splat.html
index 56f4ef17..630ed625 100644
--- a/website/guide/scan-to-splat.html
+++ b/website/guide/scan-to-splat.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Scan an object into a splat - SculptForge User Guide">
<meta property="og:description" content="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 ">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/scan-to-splat.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html" class="current" aria-current="page">Scan an object into a splat</a><ul class="toc-sections"><li><a href="#what-you-need">What you need</a></li><li><a href="#capture-tips">Capture tips</a></li><li><a href="#train-a-splat">Train a splat</a></li><li><a href="#presets">Presets</a></li><li><a href="#where-the-result-goes">Where the result goes</a></li><li><a href="#tools-and-settings">Tools and settings</a></li><li><a href="#from-the-command-line">From the command line</a></li><li><a href="#captures-with-camera-positions">Captures with camera positions</a></li><li><a href="#if-it-goes-wrong">If it goes wrong</a></li></ul></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html" class="current" aria-current="page">Scan an object into a splat</a><ul class="toc-sections"><li><a href="#what-you-need">What you need</a></li><li><a href="#capture-tips">Capture tips</a></li><li><a href="#train-a-splat">Train a splat</a></li><li><a href="#presets">Presets</a></li><li><a href="#where-the-result-goes">Where the result goes</a></li><li><a href="#tools-and-settings">Tools and settings</a></li><li><a href="#from-the-command-line">From the command line</a></li><li><a href="#captures-with-camera-positions">Captures with camera positions</a></li><li><a href="#if-it-goes-wrong">If it goes wrong</a></li></ul></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -216,8 +216,7 @@ A download made by SculptForge, in the <code>tools</code> folder of SculptForge&
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/scripting.html b/website/guide/scripting.html
index e2c9f6a4..203f1fad 100644
--- a/website/guide/scripting.html
+++ b/website/guide/scripting.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Scripting and automation - SculptForge User Guide">
<meta property="og:description" content="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 langu">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/scripting.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,14 +46,13 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html" class="current" aria-current="page">Scripting and automation</a><ul class="toc-sections"><li><a href="#the-script-language">The script language</a></li><li><a href="#the-console">The console</a></li><li><a href="#the-command-palette">The command palette</a></li><li><a href="#commonly-used-commands">Commonly used commands</a></li><li><a href="#sculptforge-cli">sculptforge-cli</a></li><li><a href="#the-sculptforge-app-on-the-command-line">The SculptForge app on the command line</a></li><li><a href="#python">Python</a></li><li><a href="#ai-agents-mcp">AI agents (MCP)</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html" class="current" aria-current="page">Scripting and automation</a><ul class="toc-sections"><li><a href="#the-script-language">The script language</a></li><li><a href="#the-console">The console</a></li><li><a href="#the-command-palette">The command palette</a></li><li><a href="#commonly-used-commands">Commonly used commands</a></li><li><a href="#sculptforge-cli">sculptforge-cli</a></li><li><a href="#the-sculptforge-app-on-the-command-line">The SculptForge app on the command line</a></li><li><a href="#python">Python</a></li><li><a href="#ai-agents-mcp">AI agents (MCP)</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
<article class="guide-article">
<h1 id="scripting-and-automation">Scripting and automation</h1>
<p>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 <code>sculptforge-cli</code> tool on a build farm, from Python, and from AI agents through the Model Context Protocol (MCP). This chapter explains the script language, the console, both command-line programs, the Python module and MCP setup.</p>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> The console plays the role of ZBrush&#x27;s ZScript window, and <strong>Copy session as script</strong> is a macro recorder. The language is much simpler than ZScript: one command per statement, with named parameters.</p></aside>
<h2 id="the-script-language">The script language<a class="anchor" href="#the-script-language" aria-label="Link to this section">#</a></h2>
<p>A script is a list of statements. Each statement is a command name followed by <code>name=value</code> parameters:</p>
<div class="code-block"><pre class="code"><code class="language-text">new_sphere subdivisions=5
@@ -117,7 +116,7 @@ Type a statement and press <kbd>Enter</kbd> to run it. Several statements separa
<aside class="callout callout-tip"><p><strong>Tip:</strong> Hold <kbd>Ctrl</kbd>+<kbd>Alt</kbd> and point at a button to see the scripting parameters of the command behind it.</p></aside>
<h2 id="commonly-used-commands">Commonly used commands<a class="anchor" href="#commonly-used-commands" aria-label="Link to this section">#</a></h2>
<p><code>sculptforge-cli --list</code> (or <code>help</code> in the console) prints every command with all its parameters. These are the ones you will use most:</p>
-<div class="table-wrap"><table><thead><tr><th>Area</th><th>Command</th><th>Key parameters</th></tr></thead><tbody><tr><td>Scene</td><td><code>new_sphere</code></td><td><code>subdivisions</code> (0 to 8, default 6)</td></tr><tr><td>Scene</td><td><code>new_plane</code></td><td><code>resolution</code> (cells per side, default 128)</td></tr><tr><td>Files</td><td><code>open</code></td><td><code>path</code>: models, projects, splats, GoZ-compatible files</td></tr><tr><td>Files</td><td><code>save_project</code></td><td><code>path</code> (default: the current project)</td></tr><tr><td>Files</td><td><code>open_project</code></td><td><code>path</code></td></tr><tr><td>Geometry</td><td><code>subdivide</code></td><td><code>levels</code> (1 to 4, default 1)</td></tr><tr><td>Geometry</td><td><code>remesh</code></td><td><code>resolution</code> (32 to 512, default 200)</td></tr><tr><td>Geometry</td><td><code>decimate</code></td><td><code>ratio</code> (default 0.5) or <code>triangles</code></td></tr><tr><td>Geometry</td><td><code>qremesh</code></td><td><code>target</code> (default 5000), <code>adaptive</code>, <code>keep_groups</code>, <code>detect_edges</code>, <code>use_polypaint</code>, <code>symmetry</code>, <code>keep_original</code></td></tr><tr><td>Parts</td><td><code>project_all</code></td><td><code>distance</code> (default 0.02), <code>mean</code>, <code>blur</code>, <code>geometry</code>, <code>polypaint</code>, <code>source</code></td></tr><tr><td>Geometry</td><td><code>mesh_info</code></td><td></td></tr><tr><td>Sculpting</td><td><code>stroke</code></td><td><code>points</code> (required), <code>brush</code>, <code>radius</code>, <code>strength</code>, <code>invert</code>, <code>symmetry</code>, <code>radial</code>, <code>radial_axis</code>, <code>local</code></td></tr><tr><td>Brushes</td><td><code>brush_set_alpha</code></td><td><code>name</code> (round, square, noise) or <code>path</code>, <code>invert</code></td></tr><tr><td>Brushes</td><td><code>brush_ai</code></td><td><code>prompt</code> (required), <code>provider</code>, <code>model</code>, <code>endpoint</code></td></tr><tr><td>Brushes</td><td><code>brush_install</code></td><td><code>path</code>, <code>code</code> or <code>json</code></td></tr><tr><td>Brushes</td><td><code>brush_save</code></td><td><code>path</code> (required), <code>name</code></td></tr><tr><td>Layers</td><td><code>layer_add</code></td><td><code>name</code></td></tr><tr><td>Layers</td><td><code>layer_set_weight</code></td><td><code>index</code>, <code>weight</code> (both required)</td></tr><tr><td>Masking</td><td><code>mask_by_cavity</code></td><td><code>strength</code>, <code>threshold</code></td></tr><tr><td>Masking</td><td><code>mask_invert</code>, <code>mask_clear</code>, <code>mask_blur</code>, <code>mask_grow</code></td><td><code>iterations</code> where it applies</td></tr><tr><td>Face Groups</td><td><code>polygroup_auto_by_normals</code></td><td><code>angle</code> (default 30)</td></tr><tr><td>Visibility</td><td><code>isolate_polygroup</code>, <code>hide_polygroup</code></td><td><code>group</code> (required)</td></tr><tr><td>Visibility</td><td><code>show_all</code>, <code>delete_hidden</code></td><td></td></tr><tr><td>Transform</td><td><code>transform</code></td><td><code>translate</code>, <code>rotate</code>, <code>scale</code>, <code>pivot</code>, <code>orient</code>, <code>masked</code>, <code>falloff</code>, <code>symmetry</code>, <code>all</code> (<a href="gizmo.html#scripting">Gizmo</a>)</td></tr><tr><td>Parts</td><td><code>subtool_append</code></td><td><code>type</code> (sphere, cube, plane) or <code>path</code>, <code>name</code>, <code>size</code></td></tr><tr><td>Parts</td><td><code>subtool_select</code></td><td><code>index</code> or <code>name</code></td></tr><tr><td>Vertex Paint</td><td><code>set_color</code>, <code>paint_fill</code></td><td><code>color</code>, <code>area</code> (unmasked, masked, all)</td></tr><tr><td>Vertex Paint</td><td><code>paint_from_cavity</code></td><td><code>color</code>, <code>strength</code>, <code>smoothing</code></td></tr><tr><td>AI</td><td><code>image_to_3d</code></td><td><code>path</code> (required), <code>service</code>, <code>model</code>, <code>remesh</code>, <code>resolution</code></td></tr><tr><td>AI</td><td><code>text_to_3d</code></td><td><code>prompt</code> (required), <code>service</code>, <code>model</code></td></tr><tr><td>Export</td><td><code>export_glb</code>, <code>export_usd</code>, <code>export_stl</code>, <code>export_ply</code></td><td><code>path</code> (required); <code>export_stl</code> also <code>height_mm</code>, <code>scale</code>, <code>z_up</code></td></tr><tr><td>Export</td><td><code>export_fbx</code></td><td><code>path</code> (required), <code>lods</code>, <code>ratio</code>, <code>scale</code></td></tr><tr><td>Export</td><td><code>export_lods</code></td><td><code>path</code> (required), <code>levels</code>, <code>ratio</code></td></tr><tr><td>Unreal</td><td><code>unreal_send</code></td><td><code>destination</code>, <code>height_cm</code>, <code>lods</code>, <code>network</code></td></tr><tr><td>Splats</td><td><code>splat_to_mesh</code> (Make sculptable)</td><td><code>detail</code>, <code>preset</code>, <code>color</code>, <code>crop</code>, <code>face_guides</code>, <code>stage</code></td></tr><tr><td>Splats</td><td><code>face_guides</code></td><td><code>landmarks</code>, <code>front</code>, <code>up</code>, <code>target</code></td></tr><tr><td>Edit</td><td><code>undo</code>, <code>redo</code></td><td></td></tr></tbody></table></div>
+<div class="table-wrap"><table><thead><tr><th>Area</th><th>Command</th><th>Key parameters</th></tr></thead><tbody><tr><td>Scene</td><td><code>new_sphere</code></td><td><code>subdivisions</code> (0 to 8, default 6)</td></tr><tr><td>Scene</td><td><code>new_plane</code></td><td><code>resolution</code> (cells per side, default 128)</td></tr><tr><td>Files</td><td><code>open</code></td><td><code>path</code>: models, projects, splats, Bridge files</td></tr><tr><td>Files</td><td><code>save_project</code></td><td><code>path</code> (default: the current project)</td></tr><tr><td>Files</td><td><code>open_project</code></td><td><code>path</code></td></tr><tr><td>Geometry</td><td><code>subdivide</code></td><td><code>levels</code> (1 to 4, default 1)</td></tr><tr><td>Geometry</td><td><code>remesh</code></td><td><code>resolution</code> (32 to 512, default 200)</td></tr><tr><td>Geometry</td><td><code>decimate</code></td><td><code>ratio</code> (default 0.5) or <code>triangles</code></td></tr><tr><td>Geometry</td><td><code>qremesh</code></td><td><code>target</code> (default 5000), <code>adaptive</code>, <code>keep_groups</code>, <code>detect_edges</code>, <code>use_polypaint</code>, <code>symmetry</code>, <code>keep_original</code></td></tr><tr><td>Parts</td><td><code>project_all</code></td><td><code>distance</code> (default 0.02), <code>mean</code>, <code>blur</code>, <code>geometry</code>, <code>polypaint</code>, <code>source</code></td></tr><tr><td>Geometry</td><td><code>mesh_info</code></td><td></td></tr><tr><td>Sculpting</td><td><code>stroke</code></td><td><code>points</code> (required), <code>brush</code>, <code>radius</code>, <code>strength</code>, <code>invert</code>, <code>symmetry</code>, <code>radial</code>, <code>radial_axis</code>, <code>local</code></td></tr><tr><td>Brushes</td><td><code>brush_set_alpha</code></td><td><code>name</code> (round, square, noise) or <code>path</code>, <code>invert</code></td></tr><tr><td>Brushes</td><td><code>brush_ai</code></td><td><code>prompt</code> (required), <code>provider</code>, <code>model</code>, <code>endpoint</code></td></tr><tr><td>Brushes</td><td><code>brush_install</code></td><td><code>path</code>, <code>code</code> or <code>json</code></td></tr><tr><td>Brushes</td><td><code>brush_save</code></td><td><code>path</code> (required), <code>name</code></td></tr><tr><td>Layers</td><td><code>layer_add</code></td><td><code>name</code></td></tr><tr><td>Layers</td><td><code>layer_set_weight</code></td><td><code>index</code>, <code>weight</code> (both required)</td></tr><tr><td>Masking</td><td><code>mask_by_cavity</code></td><td><code>strength</code>, <code>threshold</code></td></tr><tr><td>Masking</td><td><code>mask_invert</code>, <code>mask_clear</code>, <code>mask_blur</code>, <code>mask_grow</code></td><td><code>iterations</code> where it applies</td></tr><tr><td>Face Groups</td><td><code>polygroup_auto_by_normals</code></td><td><code>angle</code> (default 30)</td></tr><tr><td>Visibility</td><td><code>isolate_polygroup</code>, <code>hide_polygroup</code></td><td><code>group</code> (required)</td></tr><tr><td>Visibility</td><td><code>show_all</code>, <code>delete_hidden</code></td><td></td></tr><tr><td>Transform</td><td><code>transform</code></td><td><code>translate</code>, <code>rotate</code>, <code>scale</code>, <code>pivot</code>, <code>orient</code>, <code>masked</code>, <code>falloff</code>, <code>symmetry</code>, <code>all</code> (<a href="gizmo.html#scripting">Gizmo</a>)</td></tr><tr><td>Parts</td><td><code>subtool_append</code></td><td><code>type</code> (sphere, cube, plane) or <code>path</code>, <code>name</code>, <code>size</code></td></tr><tr><td>Parts</td><td><code>subtool_select</code></td><td><code>index</code> or <code>name</code></td></tr><tr><td>Vertex Paint</td><td><code>set_color</code>, <code>paint_fill</code></td><td><code>color</code>, <code>area</code> (unmasked, masked, all)</td></tr><tr><td>Vertex Paint</td><td><code>paint_from_cavity</code></td><td><code>color</code>, <code>strength</code>, <code>smoothing</code></td></tr><tr><td>AI</td><td><code>image_to_3d</code></td><td><code>path</code> (required), <code>service</code>, <code>model</code>, <code>remesh</code>, <code>resolution</code></td></tr><tr><td>AI</td><td><code>text_to_3d</code></td><td><code>prompt</code> (required), <code>service</code>, <code>model</code></td></tr><tr><td>Export</td><td><code>export_glb</code>, <code>export_usd</code>, <code>export_stl</code>, <code>export_ply</code></td><td><code>path</code> (required); <code>export_stl</code> also <code>height_mm</code>, <code>scale</code>, <code>z_up</code></td></tr><tr><td>Export</td><td><code>export_fbx</code></td><td><code>path</code> (required), <code>lods</code>, <code>ratio</code>, <code>scale</code></td></tr><tr><td>Export</td><td><code>export_lods</code></td><td><code>path</code> (required), <code>levels</code>, <code>ratio</code></td></tr><tr><td>Unreal</td><td><code>unreal_send</code></td><td><code>destination</code>, <code>height_cm</code>, <code>lods</code>, <code>network</code></td></tr><tr><td>Splats</td><td><code>splat_to_mesh</code> (Make sculptable)</td><td><code>detail</code>, <code>preset</code>, <code>color</code>, <code>crop</code>, <code>face_guides</code>, <code>stage</code></td></tr><tr><td>Splats</td><td><code>face_guides</code></td><td><code>landmarks</code>, <code>front</code>, <code>up</code>, <code>target</code></td></tr><tr><td>Edit</td><td><code>undo</code>, <code>redo</code></td><td></td></tr></tbody></table></div>
<p>A few commands exist only inside the app, because they change the view rather than the model: <code>set_material</code> (<code>name=</code> a Lit Sphere such as Sculpt, or Studio) and <code>new_cube</code>.</p>
<h2 id="sculptforge-cli">sculptforge-cli<a class="anchor" href="#sculptforge-cli" aria-label="Link to this section">#</a></h2>
<p><code>sculptforge-cli</code> 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 <code>ai.json</code> settings as the app.</p>
@@ -169,8 +168,8 @@ sf.run_script(doc, &quot;decimate ratio=0.25; export_lods path=/out/troll.glb le
verts, tris = doc.vertices, doc.triangles # NumPy (N, 3) float32 and (M, 3) uint32
doc.set_mesh(verts * 1.1, tris) # bring in a mesh from your own tools (clears undo)
-print(doc.subtools) # [{&#x27;name&#x27;: ..., &#x27;visible&#x27;: ..., &#x27;triangles&#x27;: ...}]
-doc.active_subtool = &quot;Helmet&quot; # select by index or name
+print(doc.parts) # [{&#x27;name&#x27;: ..., &#x27;visible&#x27;: ..., &#x27;triangles&#x27;: ...}]
+doc.active_part = &quot;Helmet&quot; # select by index or name
for name, weight in doc.layers: # sculpt layers (blend shapes)
print(name, weight)
@@ -226,8 +225,7 @@ print([c[&quot;name&quot;] for c in sf.commands()]) # every command w
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/sculpting.html b/website/guide/sculpting.html
index 9551b9ef..bdd543a8 100644
--- a/website/guide/sculpting.html
+++ b/website/guide/sculpting.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Sculpting and brushes - SculptForge User Guide">
<meta property="og:description" content="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 bru">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/sculpting.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html" class="current" aria-current="page">Sculpting and brushes</a><ul class="toc-sections"><li><a href="#your-first-stroke">Your first stroke</a></li><li><a href="#built-in-brushes">Built-in brushes</a></li><li><a href="#custom-brushes-that-ship-with-sculptforge">Custom brushes that ship with SculptForge</a></li><li><a href="#pick-a-brush">Pick a brush</a></li><li><a href="#draw-size-intensity-rgb-intensity-and-falloff">Draw Size, Intensity, RGB Intensity and Falloff</a></li><li><a href="#sculpt-paint-add-sub-rgb-and-front">Sculpt, Paint, Add, Sub, Rgb and Front</a></li><li><a href="#modifier-keys-while-sculpting">Modifier keys while sculpting</a></li><li><a href="#the-quick-menu">The Quick Menu</a></li><li><a href="#radial-menus">Radial menus</a></li><li><a href="#whole-part-deformations">Whole-Part deformations</a></li><li><a href="#strokes">Strokes</a></li><li><a href="#precision-work">Precision work</a></li><li><a href="#alphas">Alphas</a></li><li><a href="#vector-displacement-brushes">Vector displacement brushes</a></li><li><a href="#kelvinlet-brushes">Kelvinlet brushes</a></li><li><a href="#capture-an-alpha-or-a-vdm-from-the-model">Capture an alpha or a VDM from the model</a></li><li><a href="#symmetry">Symmetry</a></li><li><a href="#pen-pressure-and-tablets">Pen pressure and tablets</a></li><li><a href="#customize-the-bottom-shelf">Customize the bottom shelf</a></li><li><a href="#sculpt-from-a-script">Sculpt from a script</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html" class="current" aria-current="page">Sculpting and brushes</a><ul class="toc-sections"><li><a href="#your-first-stroke">Your first stroke</a></li><li><a href="#built-in-brushes">Built-in brushes</a></li><li><a href="#custom-brushes-that-ship-with-sculptforge">Custom brushes that ship with SculptForge</a></li><li><a href="#pick-a-brush">Pick a brush</a></li><li><a href="#draw-size-intensity-rgb-intensity-and-falloff">Draw Size, Intensity, RGB Intensity and Falloff</a></li><li><a href="#sculpt-paint-add-sub-rgb-and-front">Sculpt, Paint, Add, Sub, Rgb and Front</a></li><li><a href="#modifier-keys-while-sculpting">Modifier keys while sculpting</a></li><li><a href="#the-quick-menu">The Quick Menu</a></li><li><a href="#radial-menus">Radial menus</a></li><li><a href="#whole-part-deformations">Whole-Part deformations</a></li><li><a href="#strokes">Strokes</a></li><li><a href="#precision-work">Precision work</a></li><li><a href="#alphas">Alphas</a></li><li><a href="#vector-displacement-brushes">Vector displacement brushes</a></li><li><a href="#kelvinlet-brushes">Kelvinlet brushes</a></li><li><a href="#capture-an-alpha-or-a-vdm-from-the-model">Capture an alpha or a VDM from the model</a></li><li><a href="#symmetry">Symmetry</a></li><li><a href="#pen-pressure-and-tablets">Pen pressure and tablets</a></li><li><a href="#customize-the-bottom-shelf">Customize the bottom shelf</a></li><li><a href="#sculpt-from-a-script">Sculpt from a script</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -70,7 +70,6 @@ Press <kbd>Ctrl</kbd>+<kbd>Z</kbd> to undo a stroke, <kbd>Ctrl</kbd>+<kbd>Shift<
</li>
</ol>
<p>Dragging on the background never sculpts: it rotates the view (see <a href="navigation.html">Navigation</a>). 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>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> the modifiers are the ones you know. <kbd>Alt</kbd> flips Add and Sub for one stroke, <kbd>Shift</kbd> smooths with any brush, <kbd>Ctrl</kbd> paints a mask (see <a href="masking.html">Masking</a>).</p></aside>
<h2 id="built-in-brushes">Built-in brushes<a class="anchor" href="#built-in-brushes" aria-label="Link to this section">#</a></h2>
<p>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.</p>
<div class="table-wrap"><table><thead><tr><th>Brush</th><th>Key</th><th>What it does</th><th>With <kbd>Alt</kbd></th></tr></thead><tbody><tr><td><strong>Standard</strong></td><td><kbd>1</kbd></td><td>Raises the surface along the stroke, the all-purpose brush.</td><td>Digs in</td></tr><tr><td><strong>Clay</strong></td><td><kbd>2</kbd></td><td>Builds up clay that fills the hollows first, with a slightly flat top. Intensity and pen pressure set how fast it builds.</td><td>Carves away</td></tr><tr><td><strong>Smooth</strong></td><td><kbd>3</kbd></td><td>Relaxes the surface, evening out bumps. The same brush <kbd>Shift</kbd> gives you.</td><td>No change</td></tr><tr><td><strong>Move</strong></td><td><kbd>4</kbd></td><td>Grabs the surface under the cursor and pulls it along, parallel to the screen.</td><td>No change</td></tr><tr><td><strong>Inflate</strong></td><td><kbd>5</kbd></td><td>Swells the surface outward along its normals.</td><td>Deflates</td></tr><tr><td><strong>Crease</strong></td><td><kbd>6</kbd></td><td>Cuts a sharp crease and pinches its sides in.</td><td>Raises a ridge</td></tr><tr><td><strong>Flatten</strong></td><td><kbd>7</kbd></td><td>Presses the surface toward a plane through the brush area.</td><td>Pushes away from the plane</td></tr><tr><td><strong>Pinch</strong></td><td><kbd>8</kbd></td><td>Pulls the surface toward the stroke to tighten edges.</td><td>Spreads it apart</td></tr><tr><td><strong>Sharp Crease</strong></td><td><kbd>9</kbd></td><td>A narrow, deep V-shaped crease with the sides pinched in.</td><td>A sharp ridge</td></tr><tr><td><strong>Clay Block</strong></td><td><kbd>0</kbd></td><td>Square, flat-topped clay strokes for blocking in forms.</td><td>Carves flat-bottomed</td></tr><tr><td><strong>Tendril</strong></td><td></td><td>Pulls the surface out into horns and tendrils that taper as you drag.</td><td>No change</td></tr><tr><td><strong>Trim</strong></td><td></td><td>Trim: shaves away everything above a plane for hard surfaces.</td><td>Fills up to the plane</td></tr><tr><td><strong>Layer</strong></td><td></td><td>Raises the surface to one fixed height per stroke; overlapping passes never stack.</td><td>Lowers to a fixed depth</td></tr><tr><td><strong>Nudge</strong></td><td></td><td>Slides the surface sideways along the stroke without lifting it.</td><td>No change</td></tr><tr><td><strong>VDM</strong></td><td></td><td>Stamps a vector displacement map, overhangs and all (see <a href="#vector-displacement-brushes">below</a>).</td><td>Digs the shape in</td></tr><tr><td><strong>KelvinGrab</strong></td><td></td><td>Elastic move: drags the surface like real clay, with no falloff edge (see <a href="#kelvinlet-brushes">Kelvinlet brushes</a>).</td><td>No change</td></tr><tr><td><strong>KelvinTwist</strong></td><td></td><td>Press and drag right to turn the surface clockwise around that point, left to turn it back.</td><td>Turns the other way</td></tr><tr><td><strong>KelvinScale</strong></td><td></td><td>Press and drag left to pinch the surface toward that point, right to swell it.</td><td>The other way</td></tr><tr><td><strong>Elastic Tendril</strong></td><td></td><td>An elastic Tendril: smooth horns and tendrils that taper as they stretch.</td><td>No change</td></tr><tr><td><strong>DetailClone</strong></td><td></td><td>Paints copies of a captured detail (the VDM brush&#x27;s map) along the stroke, each turned to follow it.</td><td>Digs them in</td></tr><tr><td><strong>Morph</strong></td><td></td><td>Pulls the surface back toward the morph target, a selection set with its shape (<a href="selection-sets.html#morph-targets">Selection sets</a>). Does nothing until you pick one.</td><td>Pushes away from it</td></tr><tr><td><strong>Paint</strong></td><td><kbd>P</kbd></td><td>Paints colour without sculpting. See <a href="vertex-paint.html">Vertex Paint and materials</a>.</td><td>Paints back to white</td></tr></tbody></table></div>
@@ -86,7 +85,6 @@ Press <kbd>Ctrl</kbd>+<kbd>Z</kbd> to undo a stroke, <kbd>Ctrl</kbd>+<kbd>Shift<
<strong>Trim</strong> gives crisp planes on cylinders and edges. Use it with <strong>Front</strong> on when you work on thin shapes.
</li>
</ul>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> Sharp Crease (ZBrush&#x27;s DamStandard), Clay Block (ClayBuildup), Tendril (SnakeHook), Trim (Trim Dynamic), Layer and Nudge behave like their ZBrush counterparts. Brushes such as ZBrush&#x27;s hPolish, ClayTubes, Slash or the IMM and curve brushes are not built in; you can get close to several of them with a custom brush in <a href="brush-lab.html">Brush Lab</a>.</p></aside>
<h2 id="custom-brushes-that-ship-with-sculptforge">Custom brushes that ship with SculptForge<a class="anchor" href="#custom-brushes-that-ship-with-sculptforge" aria-label="Link to this section">#</a></h2>
<p>Besides the built-in brushes, SculptForge ships seven custom brushes. They are <em>recipes</em>: data that you can open and change in <a href="brush-lab.html">Brush Lab</a>. They appear in the <strong>Custom</strong> section of the brush picker and in <strong>Sculpt &gt; Brush &gt; Custom brushes</strong>.</p>
<div class="table-wrap"><table><thead><tr><th>Brush</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Wrinkle</strong></td><td>Fine, sharp creases for skin folds and fabric wrinkles.</td></tr><tr><td><strong>Palette Knife</strong></td><td>Flattens and drags clay sideways like a sculptor&#x27;s knife.</td></tr><tr><td><strong>Dragon Scales</strong></td><td>Stamps rounded overlapping scales along the stroke.</td></tr><tr><td><strong>Stone Chisel</strong></td><td>Scrapes hard planes and breaks them up with cracks for rocks and ruins.</td></tr><tr><td><strong>Skin Pores</strong></td><td>Sprinkles tiny pores for close-up skin detail.</td></tr><tr><td><strong>Clay Slab</strong></td><td>Builds up flat-topped strokes of clay for blocking in forms.</td></tr><tr><td><strong>Edge Wear</strong></td><td>Chips and softens only the sharp edges and ridges, for weathered props.</td></tr></tbody></table></div>
@@ -113,7 +111,7 @@ Press <kbd>Ctrl</kbd>+<kbd>Z</kbd> to undo a stroke, <kbd>Ctrl</kbd>+<kbd>Shift<
<h3 id="the-brush-picker">The brush picker<a class="anchor" href="#the-brush-picker" aria-label="Link to this section">#</a></h3>
<p>Press <kbd>B</kbd> to open the brush picker under the mouse. It shows a <strong>Recent</strong> row (once you have picked brushes), then <strong>Built-in</strong>, <strong>Custom</strong> and <strong>Library</strong> sections. The Library section lists <code>.sfbrush</code> files in the <code>Brushes</code> folder of your Library library that aren&#x27;t loaded yet; picking one loads it.</p>
<figure class="shot"><a href="images/brush-picker.jpg" class="zoom"><img src="images/brush-picker.jpg" alt="The brush picker after pressing B, with letter badges" width="475" height="332" loading="lazy" decoding="async"></a><figcaption>The brush picker after pressing B, with letter badges</figcaption></figure>
-<p>The picker works the ZBrush way, by typing letters:</p>
+<p>The picker works, by typing letters:</p>
<ol>
<li>
Press <kbd>B</kbd>.
@@ -127,13 +125,12 @@ Press the letter on the badge to pick that brush. For example <kbd>B</kbd>, <kbd
</ol>
<p>If no brush name starts with what you typed, the picker falls back to names that <em>contain</em> it. <kbd>Backspace</kbd> removes the last letter, <kbd>Enter</kbd> picks the first match, and <kbd>Esc</kbd> 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.</p>
<p>Hover a tile for a large preview and the brush&#x27;s description. Right-click a tile for <strong>Add to bottom shelf</strong>, and on custom brushes also <strong>Copy brush code</strong>, <strong>Rename...</strong>, <strong>Save as .sfbrush...</strong>, <strong>Delete...</strong> and <strong>Reveal in folder</strong> (see <a href="brush-lab.html">Brush Lab and sharing brushes</a>).</p>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> <kbd>B</kbd> then two letters is the same muscle memory. Holding <kbd>Ctrl</kbd> while picking to choose a masking brush is not supported; mask strokes always use <kbd>Ctrl</kbd> with the current settings.</p></aside>
<h2 id="draw-size-intensity-rgb-intensity-and-falloff">Draw Size, Intensity, RGB Intensity and Falloff<a class="anchor" href="#draw-size-intensity-rgb-intensity-and-falloff" aria-label="Link to this section">#</a></h2>
<p>These values control every brush. Draw Size and Intensity are on the top shelf; all four are in <strong>Sculpt &gt; Draw &amp; Tablet</strong> and the <a href="#the-quick-menu">Quick Menu</a>.</p>
<div class="table-wrap"><table><thead><tr><th>Setting</th><th>Range</th><th>Default</th><th>How to change it</th></tr></thead><tbody><tr><td><strong>Draw Size</strong></td><td>2 to 800</td><td>60</td><td>Brush radius in screen pixels. <kbd>[</kbd> and <kbd>]</kbd> make it 10% smaller or larger (hold to repeat). <kbd>S</kbd> opens a slider at the cursor.</td></tr><tr><td><strong>Intensity</strong></td><td>1 to 100</td><td>50</td><td>How strongly each dab changes the surface. <kbd>U</kbd> opens a slider at the cursor.</td></tr><tr><td><strong>RGB Intensity</strong></td><td>1 to 100</td><td>100</td><td>How strongly painting colours the surface (the Paint brush, and sculpting with Rgb on). <kbd>I</kbd> opens a slider at the cursor.</td></tr><tr><td><strong>Falloff</strong></td><td>-100 to 100</td><td>0</td><td>The brush falloff. Below 0 the full-strength centre widens into a broad, hard tip; above 0 it narrows to a soft point. <kbd>O</kbd> opens a slider at the cursor.</td></tr></tbody></table></div>
<p>Because <strong>Draw Size</strong> is measured on screen, the brush covers less of the model as you zoom in, which is what you want for detail work.</p>
-<p>The brush cursor shows two rings, as in ZBrush: the outer one is the Draw 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&#x27;s square tip keep their own tip shape at 0 and shift it like the others.</p>
-<p>With an <a href="#alphas">alpha</a>, Falloff works as in ZBrush: 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&#x27;s corners; at +100 only a soft point in the middle is left.</p>
+<p>The brush cursor shows two rings: the outer one is the Draw 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&#x27;s square tip keep their own tip shape at 0 and shift it like the others.</p>
+<p>With an <a href="#alphas">alpha</a>, 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&#x27;s corners; at +100 only a soft point in the middle is left.</p>
<p>Over the model, the rings lie on the surface: true circles in the plane of the surface under the pointer, at the brush&#x27;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. <strong>Edit &gt; Preferences &gt; Cursor</strong>: <strong>Cursor follows surface</strong> (on by default) switches back to flat rings everywhere, and <strong>Hide ring while stroking</strong> (off by default) shows only the dot while a stroke runs. The crosshair pointer stays while you turn the view.</p>
<p>The <kbd>S</kbd>, <kbd>U</kbd>, <kbd>I</kbd> and <kbd>O</kbd> pop-ups take the mouse or the keyboard: drag the slider and release to close it, or type a number and press <kbd>Enter</kbd> (a minus first for a negative Falloff). <kbd>Esc</kbd> closes the pop-up without typing anything new.</p>
<h3 id="each-brush-keeps-its-own-settings">Each brush keeps its own settings<a class="anchor" href="#each-brush-keeps-its-own-settings" aria-label="Link to this section">#</a></h3>
@@ -150,12 +147,12 @@ Press the letter on the badge to pick that brush. For example <kbd>B</kbd>, <kbd
</li>
</ul>
<h3 id="smooths-own-intensity">Smooth&#x27;s own Intensity<a class="anchor" href="#smooths-own-intensity" aria-label="Link to this section">#</a></h3>
-<p>Smooth keeps an Intensity of its own, as in ZBrush, so a gentle Standard stroke at 10 still smooths at full speed. Hold <kbd>Shift</kbd> (or pick the Smooth brush) and the Intensity slider shows <strong>Smooth Intensity</strong>: change it there, or hold <kbd>Shift</kbd> and press <kbd>U</kbd>. It starts at 50.</p>
+<p>Smooth keeps an Intensity of its own, so a gentle Standard stroke at 10 still smooths at full speed. Hold <kbd>Shift</kbd> (or pick the Smooth brush) and the Intensity slider shows <strong>Smooth Intensity</strong>: change it there, or hold <kbd>Shift</kbd> and press <kbd>U</kbd>. It starts at 50.</p>
<h3 id="smooth-that-keeps-the-volume">Smooth that keeps the volume<a class="anchor" href="#smooth-that-keeps-the-volume" aria-label="Link to this section">#</a></h3>
<p>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).</p>
<ul>
<li>
-<strong>Alternate smooth</strong>, as in ZBrush: start a stroke with <kbd>Shift</kbd> held, then let go of <kbd>Shift</kbd> while still pressing. The rest of the stroke uses the other smooth, and the status line says which.
+<strong>Alternate smooth</strong>: start a stroke with <kbd>Shift</kbd> held, then let go of <kbd>Shift</kbd> while still pressing. The rest of the stroke uses the other smooth, and the status line says which.
</li>
<li>
<strong>Smooth keeps volume</strong> in <strong>Sculpt &gt; Brush</strong> makes the volume-keeping smooth the one <kbd>Shift</kbd> and the Smooth brush use; letting go of <kbd>Shift</kbd> mid-stroke then switches to the plain one. Saved with the project.
@@ -167,7 +164,7 @@ Press the letter on the badge to pick that brush. For example <kbd>B</kbd>, <kbd
<figure class="shot"><a href="images/draw-palette.jpg" class="zoom"><img src="images/draw-palette.jpg" alt="Sculpt &gt; Draw &amp; Tablet" width="630" height="600" loading="lazy" decoding="async"></a><figcaption>Sculpt &gt; Draw &amp; Tablet</figcaption></figure>
<h2 id="sculpt-paint-add-sub-rgb-and-front">Sculpt, Paint, Add, Sub, Rgb and Front<a class="anchor" href="#sculpt-paint-add-sub-rgb-and-front" aria-label="Link to this section">#</a></h2>
<p>These toggles sit on the top shelf and in <strong>Sculpt &gt; Draw &amp; Tablet</strong>:</p>
-<div class="table-wrap"><table><thead><tr><th>Control</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Sculpt</strong> / <strong>Paint</strong></td><td><strong>Sculpt</strong> makes brushes change the shape. <strong>Paint</strong> (<kbd>P</kbd>) paints colour only.</td></tr><tr><td><strong>Add</strong> / <strong>Sub</strong></td><td><strong>Add</strong> makes brushes add (the default), <strong>Sub</strong> makes them subtract. <kbd>Alt</kbd> flips the current choice for one stroke.</td></tr><tr><td><strong>Rgb</strong></td><td>Sculpt brushes also paint the current colour as they sculpt (ZBrush: Rgb with Zadd).</td></tr><tr><td><strong>Front</strong></td><td>Front faces only: brushes leave the far side of thin parts alone, such as the back of an ear or a cape.</td></tr></tbody></table></div>
+<div class="table-wrap"><table><thead><tr><th>Control</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Sculpt</strong> / <strong>Paint</strong></td><td><strong>Sculpt</strong> makes brushes change the shape. <strong>Paint</strong> (<kbd>P</kbd>) paints colour only.</td></tr><tr><td><strong>Add</strong> / <strong>Sub</strong></td><td><strong>Add</strong> makes brushes add (the default), <strong>Sub</strong> makes them subtract. <kbd>Alt</kbd> flips the current choice for one stroke.</td></tr><tr><td><strong>Rgb</strong></td><td>Sculpt brushes also paint the current colour as they sculpt.</td></tr><tr><td><strong>Front</strong></td><td>Front faces only: brushes leave the far side of thin parts alone, such as the back of an ear or a cape.</td></tr></tbody></table></div>
<p><strong>Sculpt &gt; Brush</strong> has the same Front and invert settings as the checkboxes <strong>Front faces only</strong> and <strong>Invert (Alt)</strong>.</p>
<h3 id="falloff-options">Falloff options<a class="anchor" href="#falloff-options" aria-label="Link to this section">#</a></h3>
<p>Two more checkboxes in <strong>Sculpt &gt; Brush</strong> change what a brush reaches, as Blender&#x27;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):</p>
@@ -178,8 +175,8 @@ Press the letter on the badge to pick that brush. For example <kbd>B</kbd>, <kbd
<h3 id="along-the-normal">Along the normal<a class="anchor" href="#along-the-normal" aria-label="Link to this section">#</a></h3>
<p>Move, Tendril, Elastic Tendril and KelvinGrab normally move the surface across the screen. Hold <kbd>Alt</kbd> as you start the stroke (<kbd>Ctrl</kbd> 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. <strong>Edit &gt; Preferences &gt; Input &gt; Along the normal</strong> can make it <strong>Always</strong> (no key needed, handy with a pen) or <strong>Never</strong>.</p>
<h2 id="the-quick-menu">The Quick Menu<a class="anchor" href="#the-quick-menu" aria-label="Link to this section">#</a></h2>
-<p>Press <kbd>Space</kbd> for ZBrush&#x27;s QuickMenu under the cursor: the Brush, Stroke, Alpha and Material tiles, Draw Size, Falloff, Intensity and RGB Intensity, Add / Sub, Sculpt / Paint, Rgb and X symmetry. Hold <kbd>Space</kbd> and let go to close it again (it stays while the pointer is on it), or tap <kbd>Space</kbd> to keep it open until you click elsewhere or press <kbd>Esc</kbd>. Clicking a tile opens its picker.</p>
-<p>A right click on the canvas opens it too, as in ZBrush: 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 <kbd>Alt</kbd> or <kbd>Ctrl</kbd>), and a pen button set to <strong>Right click</strong> (Edit &gt; Preferences &gt; Tablet) works the same way. Turn it off with <strong>Edit &gt; Preferences &gt; Input &gt; Right click opens the Quick Menu</strong>.</p>
+<p>Press <kbd>Space</kbd> for the Quick Menu under the cursor: the Brush, Stroke, Alpha and Material tiles, Draw Size, Falloff, Intensity and RGB Intensity, Add / Sub, Sculpt / Paint, Rgb and X symmetry. Hold <kbd>Space</kbd> and let go to close it again (it stays while the pointer is on it), or tap <kbd>Space</kbd> to keep it open until you click elsewhere or press <kbd>Esc</kbd>. Clicking a tile opens its picker.</p>
+<p>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 <kbd>Alt</kbd> or <kbd>Ctrl</kbd>), and a pen button set to <strong>Right click</strong> (Edit &gt; Preferences &gt; Tablet) works the same way. Turn it off with <strong>Edit &gt; Preferences &gt; Input &gt; Right click opens the Quick Menu</strong>.</p>
<h2 id="radial-menus">Radial menus<a class="anchor" href="#radial-menus" aria-label="Link to this section">#</a></h2>
<p>Radial (pie) menus put the tools you use most around the cursor. Hold a menu&#x27;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 <kbd>Esc</kbd> to close it. Three menus are built in:</p>
<div class="table-wrap"><table><thead><tr><th>Key</th><th>Menu</th><th>Items</th></tr></thead><tbody><tr><td><kbd>T</kbd></td><td><strong>Brushes</strong></td><td>Standard, Clay Block, Move, Sharp Crease, Inflate, Pinch, Flatten, Tendril</td></tr><tr><td><kbd>Y</kbd></td><td><strong>Masking</strong></td><td>Invert Mask, Mask Lasso, Clear Mask, Mask Rectangle, Mask All, Mask Pen, View Mask, Group Masked</td></tr><tr><td><kbd>J</kbd></td><td><strong>Strokes</strong></td><td>Dots, Drag Stamp, Slide Stamp, Spray, Lazy Stroke (see <a href="#strokes">Strokes</a>)</td></tr></tbody></table></div>
@@ -205,7 +202,7 @@ Click an item to give it your own <strong>label</strong> and <strong>icon</stron
<p><strong>Store Config</strong> (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd>) keeps your menus.</p>
<h2 id="whole-part-deformations">Whole-Part deformations<a class="anchor" href="#whole-part-deformations" aria-label="Link to this section">#</a></h2>
<p><strong>Tool &gt; Deformation</strong> 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:</p>
-<div class="table-wrap"><table><thead><tr><th>Operation</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Polish</strong></td><td>Flattens fine noise and small bumps while flat areas and sharp edges stay sharp: a scan&#x27;s grain, or the ripples a voxel remesh leaves on a hard-surface piece.</td></tr><tr><td><strong>Relax</strong></td><td>Evens out the spacing of the vertices along the surface without changing its shape, for areas a big Move or Tendril stretched.</td></tr><tr><td><strong>Smooth</strong></td><td>Smooths everything; with <strong>Smooth keeps volume</strong> it doesn&#x27;t shrink the form.</td></tr><tr><td><strong>Balloon</strong></td><td>Fills the form out toward a rounder volume, like blowing into it (ZBrush users: Inflate Balloon). A negative amount lets the air out.</td></tr></tbody></table></div>
+<div class="table-wrap"><table><thead><tr><th>Operation</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Polish</strong></td><td>Flattens fine noise and small bumps while flat areas and sharp edges stay sharp: a scan&#x27;s grain, or the ripples a voxel remesh leaves on a hard-surface piece.</td></tr><tr><td><strong>Relax</strong></td><td>Evens out the spacing of the vertices along the surface without changing its shape, for areas a big Move or Tendril stretched.</td></tr><tr><td><strong>Smooth</strong></td><td>Smooths everything; with <strong>Smooth keeps volume</strong> it doesn&#x27;t shrink the form.</td></tr><tr><td><strong>Balloon</strong></td><td>Fills the form out toward a rounder volume, like blowing into it (experienced sculptors: Inflate Balloon). A negative amount lets the air out.</td></tr></tbody></table></div>
<p>They are commands too: <code>deform_polish amount=60</code>, <code>deform_relax</code>, <code>deform_smooth amount=30 keep_volume=true</code>, <code>deform_balloon amount=-20</code> (add <code>masked=false</code> 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>
<h2 id="strokes">Strokes<a class="anchor" href="#strokes" aria-label="Link to this section">#</a></h2>
<p>The stroke type decides how cursor movement becomes brush dabs. Choose it from the <strong>Stroke</strong> tile on the left shelf, which opens the stroke picker, or from <strong>Sculpt &gt; Stroke</strong>.</p>
@@ -249,7 +246,6 @@ The <strong>Strokes</strong> radial menu (<kbd>J</kbd>, see <a href="#radial-men
Change the key in <strong>Edit &gt; Preferences &gt; Hotkeys</strong> (<em>Stroke popup</em>), or hold <kbd>Ctrl</kbd>+<kbd>Alt</kbd> and click the shelf button, then press the new key.
</li>
</ul>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> Drag Stamp, Slide Stamp, Spray and Steady Stroke match ZBrush&#x27;s DragRect, DragDot, Spray and LazyMouse. Freehand and Dots are the same thing here. Roll and curve strokes are not available yet.</p></aside>
<h2 id="precision-work">Precision work<a class="anchor" href="#precision-work" aria-label="Link to this section">#</a></h2>
<p>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.</p>
<p><strong>Steady Stroke</strong> (<kbd>L</kbd>, 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. <strong>Steady radius</strong> sets the length (longer is steadier). <strong>Catch up on release</strong> (on by default) finishes the line to where the cursor is when you let go; turn it off to end the line a string&#x27;s length behind.</p>
@@ -257,11 +253,11 @@ Change the key in <strong>Edit &gt; Preferences &gt; Hotkeys</strong> (<em>Strok
<p><strong>Finer size control.</strong></p>
<div class="table-wrap"><table><thead><tr><th>Do this</th><th>Change</th></tr></thead><tbody><tr><td><kbd>[</kbd> / <kbd>]</kbd></td><td>10% smaller / larger</td></tr><tr><td><kbd>Shift</kbd>+<kbd>[</kbd> / <kbd>Shift</kbd>+<kbd>]</kbd></td><td>1 px smaller / larger (0.5 px below 2 px)</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+right-drag</td><td>Scrub the size finely: 100 px to the right is about 1.5 times larger</td></tr></tbody></table></div>
<p>Draw 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).</p>
-<p><strong>Precision drag</strong> (<kbd>Shift</kbd>+<kbd>Alt</kbd>, held while drawing). Start the stroke, then hold <kbd>Shift</kbd>+<kbd>Alt</kbd>: the brush moves at a quarter of the pen&#x27;s speed, drawn as a blue ring with a line back to the pen, and works at <strong>Precision Intensity</strong> (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, <kbd>Shift</kbd>+<kbd>Alt</kbd> still selects and frames a Part (ZBrush and SculptForge styles), and in the Blender style <kbd>Alt</kbd>+click still navigates. The same works in every input style.</p>
+<p><strong>Precision drag</strong> (<kbd>Shift</kbd>+<kbd>Alt</kbd>, held while drawing). Start the stroke, then hold <kbd>Shift</kbd>+<kbd>Alt</kbd>: the brush moves at a quarter of the pen&#x27;s speed, drawn as a blue ring with a line back to the pen, and works at <strong>Precision Intensity</strong> (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, <kbd>Shift</kbd>+<kbd>Alt</kbd> still selects and frames a Part, and in the Blender style <kbd>Alt</kbd>+click still navigates. The same works in every input style.</p>
<p><strong>A pressure curve for each brush.</strong> Every brush keeps its own pen pressure curve, applied after the tablet&#x27;s curve. Edit it in <strong>Brush Lab</strong> (under the recipe sliders) or in <strong>Edit &gt; Preferences &gt; Tablet</strong> (under the tablet&#x27;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 <strong>Soft</strong>, <strong>Linear</strong>, <strong>Firm</strong> and <strong>Fine detail</strong>: 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.</p>
<p><strong>Accuracy.</strong> 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&#x27;t wobble with every tiny bump. A real step in the surface is followed at once.</p>
<h2 id="alphas">Alphas<a class="anchor" href="#alphas" aria-label="Link to this section">#</a></h2>
-<p>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 <strong>Alpha</strong> tile on the left shelf (the alpha picker) or the <strong>Sculpt &gt; Alpha</strong>, which also shows a large preview of the current alpha. <a href="#draw-size-intensity-rgb-intensity-and-falloff">Falloff</a> fades it as in ZBrush: 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 <a href="micro-levels.html">micro levels</a> too, with every stroke type including Drag Stamp.</p>
+<p>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 <strong>Alpha</strong> tile on the left shelf (the alpha picker) or the <strong>Sculpt &gt; Alpha</strong>, which also shows a large preview of the current alpha. <a href="#draw-size-intensity-rgb-intensity-and-falloff">Falloff</a> 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 <a href="micro-levels.html">micro levels</a> too, with every stroke type including Drag Stamp.</p>
<figure class="shot"><a href="images/alpha-picker.jpg" class="zoom"><img src="images/alpha-picker.jpg" alt="The alpha picker" width="575" height="373" loading="lazy" decoding="async"></a><figcaption>The alpha picker</figcaption></figure>
<div class="table-wrap"><table><thead><tr><th>Alpha</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Round</strong></td><td>The plain round falloff (no alpha). The default.</td></tr><tr><td><strong>Square</strong></td><td>A square stamp with soft edges.</td></tr><tr><td><strong>Noise</strong></td><td>A noisy stamp for rough, organic texture.</td></tr><tr><td><strong>Pores</strong></td><td>Scattered skin pores of mixed sizes (use with Sub to press them in).</td></tr><tr><td><strong>Cracks</strong></td><td>A web of thin cracks, as in dry earth, old paint or stone.</td></tr><tr><td><strong>Scales</strong></td><td>Overlapping rounded scales in offset rows, for reptiles and fish.</td></tr><tr><td><strong>Rivets</strong></td><td>A three by three grid of round rivet heads, for armour and machines.</td></tr><tr><td><strong>Stitches</strong></td><td>A seam with cross stitches along it (drag along the seam with Drag Stamp or a stroke).</td></tr><tr><td><strong>Fabric Weave</strong></td><td>Threads woven over and under, for cloth and canvas.</td></tr><tr><td><strong>Bark</strong></td><td>Rough vertical ridges and furrows, as on tree bark.</td></tr><tr><td><strong>Rock Strata</strong></td><td>Stepped layers of rock, wavy and broken, for cliffs and stone.</td></tr><tr><td><strong>Wrinkles</strong></td><td>Fine parallel wrinkle lines, for skin around eyes, knuckles and necks.</td></tr><tr><td><strong>Skin Folds</strong></td><td>Soft, broad folds of skin, for bellies, elbows and heavy brows.</td></tr><tr><td><strong>Hair Strands</strong></td><td>Long flowing strands, for hair, fur and feathers (drag along the flow).</td></tr><tr><td><strong>Dot Grid</strong></td><td>An even grid of soft dots, for studs, textures and patterns.</td></tr></tbody></table></div>
<p>All of them are made by SculptForge itself the first time they&#x27;re needed (no image files are downloaded or shipped). They show in the alpha picker and in the Library&#x27;s <strong>Alpha</strong> tab (<code>brush_set_alpha name=cracks</code>).</p>
@@ -283,9 +279,8 @@ Turn on <strong>Invert loaded image</strong> <em>before</em> loading if your ima
<p>Under the preview in <strong>Sculpt &gt; Alpha</strong>:</p>
<div class="table-wrap"><table><thead><tr><th>Option</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Follow stroke direction</strong></td><td>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&#x27;s Rake: the direction is taken again each time the cursor has gone 20 pixels.</td></tr><tr><td><strong>Angle</strong></td><td>Turns the alpha by a fixed angle (-180 to 180 degrees, counter-clockwise), on its own or on top of the stroke&#x27;s direction.</td></tr><tr><td><strong>Angle jitter</strong></td><td>Turns each dab by a random angle, up to this many degrees either way, to break up repeats.</td></tr><tr><td><strong>Tile across</strong> / <strong>Tile down</strong></td><td>Repeats the alpha 1 to 8 times across and down inside the brush; the preview shows the result.</td></tr></tbody></table></div>
<p>They work with every brush, custom and Community brushes included, and each brush keeps its own (see <a href="#each-brush-keeps-its-own-settings">Each brush keeps its own settings</a>). From a script: <code>brush_alpha_options follow_stroke=true angle=30 angle_jitter=10 tile_x=2 tile_y=2</code>.</p>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> there is no alpha library browser with hundreds of alphas yet, and alpha options such as MidValue or Rf (radial fade) are not available. Any grayscale image works, including alphas you already have as PNG.</p></aside>
<h2 id="vector-displacement-brushes">Vector displacement brushes<a class="anchor" href="#vector-displacement-brushes" aria-label="Link to this section">#</a></h2>
-<p>A vector displacement brush (ZBrush&#x27;s VDM brushes, Blender&#x27;s &quot;VDM brushes&quot;) 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.</p>
+<p>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.</p>
<figure class="shot"><a href="images/vdm-brushes.jpg" class="zoom"><img src="images/vdm-brushes.jpg" alt="Horns, an ear curl, scales and two nostrils, one stamp each, and Sculpt &gt; Brush &gt; Vector Displacement" width="960" height="679" loading="lazy" decoding="async"></a><figcaption>Horns, an ear curl, scales and two nostrils, one stamp each, and Sculpt &gt; Brush &gt; Vector Displacement</figcaption></figure>
<h3 id="stamp-a-vdm">Stamp a VDM<a class="anchor" href="#stamp-a-vdm" aria-label="Link to this section">#</a></h3>
<ol>
@@ -330,14 +325,13 @@ Show your model again in the <a href="parts.html">Part</a> palette (its eye) and
</li>
</ol>
<p>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&#x27;s UVs record where each point started, so what Create VDM captures is how far each point moved, sideways and up.</p>
-<h3 id="load-and-export-maps-blender-zbrush">Load and export maps (Blender, ZBrush)<a class="anchor" href="#load-and-export-maps-blender-zbrush" aria-label="Link to this section">#</a></h3>
+<h3 id="load-and-export-maps">Load and export maps<a class="anchor" href="#load-and-export-maps" aria-label="Link to this section">#</a></h3>
<p><strong>Load VDM...</strong> reads an OpenEXR (16- or 32-bit, any compression) or a <code>.sfvdm</code>; dropping an <code>.exr</code> on the window does the same. A loaded EXR is kept in your brush library as a <code>.sfvdm</code>, so it&#x27;s there next time. <strong>Export EXR...</strong> writes the brush&#x27;s map as a 32-bit float EXR. Right-click a map you made or loaded to delete it.</p>
<p>Maps use the convention of Blender&#x27;s <strong>VDM Brush Baker</strong> and its Draw brush with <em>Vector Displacement</em>:</p>
<div class="table-wrap"><table><thead><tr><th>Channel</th><th>Means</th></tr></thead><tbody><tr><td>R</td><td>X: toward the stamp&#x27;s right</td></tr><tr><td>G</td><td>Y: toward the stamp&#x27;s top (the image&#x27;s top row; the drag direction of Drag Stamp)</td></tr><tr><td>B</td><td>Z: out of the surface</td></tr><tr><td>Units</td><td>brush radii: (0, 0, 0.5) lifts the surface by half the radius; the map covers the brush&#x27;s square</td></tr></tbody></table></div>
<p>So maps from Blender&#x27;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&#x27;s <strong>Mapping</strong> to <strong>Area Plane</strong>, turn on <strong>Vector Displacement</strong> in the brush&#x27;s Texture panel, and use the <strong>Anchored</strong> stroke at Strength 1 (see <a href="blender.html#vector-displacement-maps">Working with Blender</a>). Blender&#x27;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.</p>
-<p>ZBrush keeps its VDMs inside brushes (as 3D alphas) and doesn&#x27;t export them as EXR by itself; maps made with <strong>Tool &gt; Vector Displacement Map</strong> or third-party exporters use axes set by ZBrush&#x27;s <em>Vector Displacement Flip</em> options. If a map from ZBrush stamps lying on its side, load it again with <strong>Swap Y/Z</strong>; if it is mirrored or leans the wrong way, with <strong>Flip X</strong> or <strong>Flip Y</strong> (<strong>Flip Z</strong> for a map that digs in where it should rise). <strong>Scale</strong> multiplies a map made in other units.</p>
+<p>Maps made in other applications may use other axes. If a map stamps lying on its side, load it again with <strong>Swap Y/Z</strong>; if it is mirrored or leans the wrong way, with <strong>Flip X</strong> or <strong>Flip Y</strong> (<strong>Flip Z</strong> for a map that digs in where it should rise). <strong>Scale</strong> multiplies a map made in other units.</p>
<p>From a script: <code>vdm_set name=horn</code> or <code>vdm_set path=ear.exr swap_yz=true</code>, <code>vdm_stamp point=0,0.5,0 radius=0.3 angle=30</code>, <code>vdm_new_plane</code>, <code>vdm_capture name=&quot;My horn&quot; exr=horn.exr</code>, <code>vdm_export path=horn.exr</code>, <code>vdm_list</code>, <code>vdm_delete name=&quot;My horn&quot;</code>.</p>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> the VDM brush works like ZBrush&#x27;s VDM brushes with DragRect or DragDot. Not available yet: several VDMs in one brush (ZBrush&#x27;s <em>Create Multiple Alpha Brush</em>), MidValue and the alpha options for 3D alphas, and reading ZBrush&#x27;s own brush files.</p></aside>
<h2 id="kelvinlet-brushes">Kelvinlet brushes<a class="anchor" href="#kelvinlet-brushes" aria-label="Link to this section">#</a></h2>
<p><strong>KelvinGrab</strong>, <strong>KelvinTwist</strong>, <strong>KelvinScale</strong> and <strong>Elastic Tendril</strong> 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 &quot;regularized Kelvinlets&quot; 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.</p>
<figure class="shot"><a href="images/kelvinlet-brushes.jpg" class="zoom"><img src="images/kelvinlet-brushes.jpg" alt="KelvinGrab pulls with symmetry and Squash at 100, and a KelvinTwist in the middle: no falloff edge anywhere" width="680" height="520" loading="lazy" decoding="async"></a><figcaption>KelvinGrab pulls with symmetry and Squash at 100, and a KelvinTwist in the middle: no falloff edge anywhere</figcaption></figure>
@@ -394,7 +388,6 @@ Use it: <strong>Use as Alpha</strong> (it shapes every brush), <strong>Use as VD
</li>
</ol>
<p>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>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> this is &quot;GrabDoc&quot; for alphas, and more: ZBrush can only make a VDM from its special VDM plane, here any detail on any model becomes one. The commands <code>capture_alpha</code> and <code>capture_vdm</code> do the same from a script.</p></aside>
<h3 id="detail-clone">Detail Clone<a class="anchor" href="#detail-clone" aria-label="Link to this section">#</a></h3>
<p><strong>DetailClone</strong> stamps the VDM brush&#x27;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. <strong>Clone Spacing</strong> sets the distance between copies (1 = edge to edge) and <strong>Clone follows stroke</strong> can keep every copy upright instead. Draw Size sets their size and Intensity their depth; a click without moving stamps one. Each copy is shaped to the surface under it.</p>
<h2 id="symmetry">Symmetry<a class="anchor" href="#symmetry" aria-label="Link to this section">#</a></h2>
@@ -423,7 +416,6 @@ Use it: <strong>Use as Alpha</strong> (it shapes every brush), <strong>Use as VD
<h3 id="local-symmetry">Local symmetry<a class="anchor" href="#local-symmetry" aria-label="Link to this section">#</a></h3>
<p><strong>Local</strong> (next to <strong>R</strong> in <strong>Sculpt &gt; Symmetry &amp; Gizmo &gt; Symmetry</strong>) 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&#x27;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.</p>
<p><strong>R</strong> and <strong>Local</strong> have no default key; you can assign one (see <a href="interface.html">The interface</a>). Projects save the symmetry settings, radial and local included. Scripts and <code>sculptforge-cli</code> use the same settings: commands that take <code>symmetry</code> (<code>stroke</code>, <code>vdm_stamp</code>, <code>mask_rect</code>, <code>mask_lasso</code>, <code>hide_rect</code>, <code>hide_lasso</code>, <code>insert_primitive</code>, <code>insert_mesh</code>) also take <code>radial</code> (the count), <code>radial_axis</code> (<code>x</code>, <code>y</code> or <code>z</code>) and <code>local</code> (<code>true</code> for the Part&#x27;s centre), for example <code>stroke points=... symmetry=x radial=8 radial_axis=y</code>.</p>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> <strong>R</strong> is ZBrush&#x27;s (R) radial symmetry with Radial Count, and <strong>Local</strong> is its Local Symmetry (about the Part&#x27;s centre). Topological (poseable) symmetry is not available yet.</p></aside>
<h2 id="pen-pressure-and-tablets">Pen pressure and tablets<a class="anchor" href="#pen-pressure-and-tablets" aria-label="Link to this section">#</a></h2>
<p>SculptForge reads pen pressure from graphics tablets and pen displays through the operating system. When it receives pen input, <strong>Sculpt &gt; Draw &amp; Tablet</strong> shows <strong>Pen pressure</strong> with the current value; before that it says <strong>No pen detected</strong>.</p>
<p>Two toggles decide what pressure does. They are on the top shelf and in <strong>Sculpt &gt; Draw &amp; Tablet &gt; Tablet</strong>:</p>
@@ -482,7 +474,7 @@ the eraser end (default <strong>Invert</strong>, like holding <kbd>Alt</kbd>) an
<a href="layers.html">Sculpt layers and blend shapes</a>: sculpt into a layer you can dial in and out
</li>
<li>
-<a href="dynamic-topology.html">Dynamic topology</a>: brushes that add triangles where they need them (Sculptris Pro)
+<a href="dynamic-topology.html">Dynamic topology</a>: brushes that add triangles where they need them (dynamic topology)
</li>
<li>
<a href="shortcuts.html">Keyboard and mouse reference</a>
@@ -510,8 +502,7 @@ the eraser end (default <strong>Invert</strong>, like holding <kbd>Alt</kbd>) an
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/search-index.js b/website/guide/search-index.js
index 1c0711b5..a38533b2 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 ZBrush. 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 ZBrush Coming from ZBrush (the ZBrush-style 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 Coming from ZBrush 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 Masking Face Groups and visibility Selection sets and morph targets Parts Forge Spheres 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 ZBrush Export presets Working with Blender Working with Maya Projects, autosave and Snapshots Scripting and automation Packs and macros SculptForge for studios"},{"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"},{"p":"index.html","c":"SculptForge User Guide","a":"getting-help","h":"Getting help","t":"Hold Ctrl and point at any button for what it does, its shortcut and its script command. Press F1 for every shortcut and mouse gesture, and F3 to find any command by name. Ask questions and report problems on the issue tracker (Help > Report a problem). SculptForge is free software under the GNU General Public License v3.0 or later. This guide is part of SculptForge and is covered by the same licence."},{"p":"welcome.html","c":"Welcome to SculptForge","a":"","h":"Welcome to SculptForge","t":"SculptForge is a free, open-source digital sculpting application for VFX, animation and games. This chapter explains what it is, what it can and can't do yet, and how the rest of this guide is organised."},{"p":"welcome.html","c":"Welcome to SculptForge","a":"what-sculptforge-is","h":"What SculptForge is","t":"SculptForge is a focused sculpting tool with the brushes, symmetry, masking and navigation that ZBrush artists already know. 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 ZBrush-style 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. ZBrush's keys and gestures are one choice away: answer ZBrush when the first start asks what you are coming from, or pick ZBrush-style in Edit > Preferences > Input. See Coming from ZBrush. There is no account, no subscription, no licence server and no telemetry. It is free software under the GNU General Public License v3.0 or later. You own everything you make with it: the GPL covers the program, not your models. SculptForge stays free and works the same for everyone; nothing is ever paywalled. Memberships add your name to the credits, the monthly pack and a vote on what gets built. Insiders will get each release about two weeks early, starting with SculptForge 1.0 (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. Supporters are thanked by name in Help > About. While SculptForge starts (the first time, after an update, and at most once a week otherwise) a card shows the memberships; I'm already a supporter hides it for good and Edit > Preferences > Support turns it off. After about ten hours of sculpting, SculptForge also shows one small note about this along the bottom of the canvas, once, and never again after you close it."},{"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 the ZBrush way: 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 DynaMesh), decimation and one-click LOD chains. See Subdivide, remesh, decimate and LODs. Generate a model from a sketch, concept art or a description, free through Hugging Face or on your own ComfyUI server. See Image and text to 3D. Work with Gaussian splats from phone captures: sculpt against them or turn them into meshes. See Gaussian splats. Export to glTF/GLB, FBX, OpenUSD, OBJ, STL and PLY, send models straight into Unreal Engine, and exchange them with ZBrush through Send to ZBrush (GoZ-compatible exchange). See Exporting, Unreal and ZBrush. Automate everything: every action is a command you can type in the console, run headless with sculptforge-cli, script from Python or hand to an AI agent over MCP. See Scripting and automation."},{"p":"welcome.html","c":"Welcome to SculptForge","a":"what-it-doesnt-do-yet","h":"What it doesn't do yet","t":"SculptForge is young (version 0.10; see What's new). Some things ZBrush artists 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: ZModeler, the 2.5D canvas, and reading ZBrush's own .ZTL and .ZPR files directly (bring models over with Send to ZBrush, the ZTL Export plug-in for ZBrush, or as OBJ, FBX or GLB). Not yet: where a chapter describes a ZBrush feature SculptForge doesn't have, it says so in a callout like this one. The project's ROADMAP.md lists what is planned and in which order."},{"p":"welcome.html","c":"Welcome to SculptForge","a":"coming-from-zbrush","h":"Coming from ZBrush","t":"Most habits carry over, and Edit > Preferences > Interface > Look > Layout > ZBrush-style 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 (ZBrush's SubTool), Masking and Face Groups (Polygroups) sub-palettes, B opens the brush pop-up with the same letter keys (B, S, T picks Standard), , opens the Library and Ctrl+Shift+I stores your interface, and S U I O, Space, Ctrl+W and the mask keys do what your hands expect with the ZBrush-style keys on (Edit > Preferences > Input). Coming from ZBrush lists SculptForge's names for ZBrush terms, what is the same, what differs and every shortcut side by side; the Glossary maps ZBrush terms to SculptForge ones."},{"p":"welcome.html","c":"Welcome to SculptForge","a":"how-this-guide-is-organised","h":"How this guide is organised","t":"Getting started: installing (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 ZBrush-style layout, the ZBrush-style layout notes say where things are there. 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 ZBrush-style layout: the colour controls are in the Color palette on the palette bar."},{"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 ZBrush-style layout: PBR and Save Render are in the Material palette. 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-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: Draw Size, Intensity, Falloff, RGB 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 Focal Shift -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. Coming from ZBrush? Preferences > Interface > Look > ZBrush-style 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, Send to ZBrush, Snapshot...); searching for ZBrush terms still finds them, and MatCaps are now Lit Spheres. The table is in Coming from ZBrush. New installs start with the SculptForge keys, and the first start asks what you are coming from (ZBrush, Blender, Maya or new to sculpting) to pick the key style. Your saved style is kept; ZBrush's keys are ZBrush-style 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 Count), 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; Store Config keeps the choice. 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, as in ZBrush (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. Store Config keeps it, and 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, the ZBrush way: 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/MatCaps 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 ZBrush artist's testing, and a way to bring your ZTools over."},{"p":"whats-new.html","c":"What's new","a":"more-like-zbrush","h":"More like ZBrush","t":"ZBrush zoom direction. With the ZBrush input style, dragging up zooms out on every zoom drag, as in ZBrush. See Navigation. Ctrl and Ctrl+Shift brushes. Hold Ctrl and the left shelf shows the mask brush; with Ctrl held the Brush and Stroke pickers pick Mask Pen, Mask Lasso or Mask Rectangle. 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-your-ztools-over","h":"Bring your ZTools over","t":"ZBrush's .ZTL files are proprietary, but a free plug-in for ZBrush now converts them once, and then SculptForge opens the .ZTL itself, every Part with its face groups, vertex paint, mask and UVs. See Coming from ZBrush."},{"p":"whats-new.html","c":"What's new","a":"version-08","h":"Version 0.8","t":"Dynamic topology, vector displacement brushes, Quad Remesh Guides, and sculpt layers on every subdivision level."},{"p":"whats-new.html","c":"What's new","a":"dynamic-topology-sculptris-pro","h":"Dynamic topology (Sculptris Pro)","t":"Turn on Dynamic on the top shelf and the brush adds triangles where it needs detail and removes them where it doesn't: pull a sphere into horns or fingers without stretching, block in from a ball without remeshing. Detail sets how small the triangles get, relative to the brush (zoom in for finer ones) or, with Constant detail, one size for the whole mesh. Symmetry makes mirrored triangles, borders and masks are kept, and each stroke is one small undo step. See Dynamic topology."},{"p":"whats-new.html","c":"What's new","a":"vector-displacement-brushes","h":"Vector displacement brushes","t":"One drag stamps a whole shape, overhangs and all: the new VDM brush presses a vector displacement map, so a horn can lean over, an ear can curl and scales can overlap, which no alpha can do. Four maps come with it (Horn, Ear Curl, Scales, Nostril); make your own by sculpting on a VDM Plane and clicking Create VDM, or load the EXRs Blender's VDM Brush Baker makes (and export yours for Blender). The new Slide Stamp stroke slides a stamp into place. See Vector displacement brushes."},{"p":"whats-new.html","c":"What's new","a":"zbrush-keys-in-blenders-sculpt-mode","h":"ZBrush keys in Blender's Sculpt Mode","t":"The Blender add-on has a new preference, ZBrush-style keys in Sculpt Mode: S, U and O for Draw Size, Strength and Falloff, B for the brushes by their ZBrush names, Space for the quick menu, Alt to dig in, Ctrl to mask, Ctrl+Shift to hide, D and Shift+D for subdivision levels, and more. See Working with Blender."},{"p":"whats-new.html","c":"What's new","a":"draw-the-edge-loops-you-want","h":"Draw the edge loops you want","t":"Quad Remesh Guides work like ZBrush's ZRemesher Guides brush: 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, like ZBrush's 3D Layers: record a layer at the top, step down and up, divide, reconstruct or delete levels, save, and it's still there, with one weight for every level. See Layers and subdivision levels."},{"p":"whats-new.html","c":"What's new","a":"version-07","h":"Version 0.7","t":"ZBrush's keys and gestures by default, and a bridge that sends models between Blender and SculptForge."},{"p":"whats-new.html","c":"What's new","a":"your-zbrush-hands-just-work","h":"Your ZBrush hands just work","t":"SculptForge now follows ZBrush's keys and gestures by default. A ZBrush sculptor tried an earlier version and put it down because it didn't feel like ZBrush; this release goes through every habit of the first hour. Coming from ZBrush lists what's the same, what's different and every shortcut side by side. S, U, I, O open Draw Size, Intensity, RGB 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. RGB Intensity gives painting a strength of its own, and Smooth keeps its own Intensity, so a gentle brush still smooths properly. ZBrush's 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 masked) work as in ZBrush. Strokes and the view: Shift pressed mid-stroke draws a straight line; Shift+click, let go and drag rolls the view; Shift+Alt+click frames a Part; L toggles Lazy Stroke and V swaps colours. Visibility: Ctrl+Shift+click on a partly hidden mesh hides the group, as in ZBrush. Prefer the old keys? Preferences > Input > Style > SculptForge brings back the number keys for brushes, I for 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 ZBrush 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, as with ZBrush's SDiv: big forms low, fine detail high, and back down without losing anything. Divide (Ctrl+D) adds a level and keeps the ones below. Quads stay quads (Catmull-Clark); Smt off divides without smoothing. Lower Res / Higher Res (Shift+D / D) and the SDiv slider step between levels. Detail sculpted high rides along when you reshape low, and edits high show up softened below. Stepping back and forth is instant, even at millions of polygons. Mask, vertex paint, paint layers, face groups, hidden faces, UVs and sculpt layers follow the levels. Del Lower, Del Higher and Reconstruct Subdiv (find the lower levels of a model subdivided elsewhere). Undo walks back through strokes and level changes; projects save every level; the 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":"ZBrush's Gizmo 3D, with the same keys: W Move, E Scale, R Rotate, Q back to Draw (also on the top shelf and in the Transform palette). Handles over the model. Arrows, plane squares and a free-move centre; axis rings and a view ring; axis boxes and a uniform centre. Shift snaps to 15 degrees, the grid or 10% steps. Only the unmasked part moves, so posing is: mask the body, Alt+click the shoulder to put the pivot there, raise Falloff for a soft joint, turn the arm. With X symmetry both arms move together. Pivot tools: Alt+drag the gizmo to move it alone, Reset, To Surface, World or Surface axes. Numeric entry in the Gizmo panel, All Parts (Transpose All), one undo step per drag, sculpt layers move with the surface, and the transform command for scripts. Fast on big models: a drag frame on 1.3 million triangles takes about 10 ms. W no longer toggles the wireframe: use Shift+F (as in ZBrush) or 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. ZBrush-style controls: 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 ZRemesher) rebuilds a sculpt as clean quads whose edge loops follow the forms, near a Target Polygons count, in the background. Keep Groups, Adaptive Size, Use Vertex Paint, Symmetry and Half / Same / Double work as in ZBrush. Project All (Tool > Parts > Project) puts the sculpted detail and vertex paint back onto the divided quads, with Dist, Mean and PA Blur, and respects the mask. See Quad retopology and detail projection."},{"p":"whats-new.html","c":"What's new","a":"performance-at-tens-of-millions-of-polygons","h":"Performance at tens of millions of polygons","t":"Sculpting a 33 million triangle model on a laptop now keeps up with the display: a medium brush costs about 10 ms per dab instead of 400, and turning the view runs at 50-70 frames a second instead of 32. Brushes use every core: every brush, mask and paint stroke, the normal updates and the picking structure. Results are exactly the same as on one core. Strokes send the graphics card only what they changed. Before, a dab with symmetry on a subdivided model re-sent most of the mesh. Fast undo: undo keeps only the vertices a stroke changed, and the first 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, GoZ-compatible 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 ZBrush artists. It was shaped by feedback from a working ZBrush modeler and by what sculptors say on the ZBrush and Mudbox forums."},{"p":"whats-new.html","c":"What's new","a":"navigation-that-works-like-zbrush","h":"Navigation that works like ZBrush","t":"Free rotation. Dragging turns the model the way the cursor moves and can roll it right over the top, as in ZBrush. If you prefer the model to stay upright, set Preferences > Interface > Rotation to Turntable. Snap to a view. Hold Shift while rotating to snap to the nearest front, back, side, top or bottom view. ZBrush zoom. Alt+drag on the background pans; let go of Alt while still dragging and the rest of the drag zooms. With the right mouse button, Alt pans and Ctrl zooms. See Navigating the view."},{"p":"whats-new.html","c":"What's new","a":"mask-and-isolate-with-a-lasso-or-rectangle","h":"Mask and isolate with a lasso or rectangle","t":"Mask Lasso and Mask Rectangle. 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 ZBrush (Send to ZBrush) 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 DynaMesh), and new cubes and planes are made of quads. See Quads and triangles."},{"p":"whats-new.html","c":"What's new","a":"paint-layers","h":"Paint layers","t":"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. ZBrush has never had this. Find it in Tool > Paint Layers, and see Paint layers. The Paint Layers sub-palette with three layers and their blend modes"},{"p":"whats-new.html","c":"What's new","a":"easier-to-install","h":"Easier to install","t":"The download links now always get the newest version, and there are one-command installers for Windows, macOS and Linux."},{"p":"whats-new.html","c":"What's new","a":"version-03","h":"Version 0.3","t":"Parts: several separate meshes in one scene. Append, duplicate, split, merge, solo, and Alt+click to select. See Parts. A ZBrush-style 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 ZBrush (Send to ZBrush)."},{"p":"whats-new.html","c":"What's new","a":"version-01","h":"Version 0.1","t":"The first release: sculpting with symmetry and sculpt layers, voxel remesh and decimation, game-ready LOD chains and Send to Unreal, image and text to 3D with free AI models, Gaussian splats, OpenUSD, and scripting from the command line, Python and AI agents."},{"p":"coming-from-zbrush.html","c":"Coming from ZBrush","a":"","h":"Coming from ZBrush","t":"This chapter is for sculptors whose hands already know ZBrush. It lists what SculptForge calls the things you know, what works the same, what is different, and the shortcuts side by side, so you can start sculpting instead of relearning. SculptForge has its own keymap and offers ZBrush-style, Blender and Maya styles; turn on the ZBrush-style keys first (see ZBrush-style keys) and your hands will feel at home. New installs start in SculptForge's own layout, with menus by task. For the alphabetical palette bar and the two-row top shelf you know, pick Coming from: ZBrush (keys and layout) or the ZBrush-style layout card in the welcome, or pick Edit > Preferences > Interface > Look > Layout > ZBrush-style (see Looks and layouts). Paths in this guide name the SculptForge layout's menus. In the ZBrush-style layout, leave out the menu: Edit > Preferences > Input is the palette named Preferences, Sculpt > Stroke the palette named Stroke; Tool > Parts is the same in both. See Menus and palettes for every palette's menu, and F3 finds any of them by name."},{"p":"coming-from-zbrush.html","c":"Coming from ZBrush","a":"zbrush-terms-in-sculptforge","h":"ZBrush terms in SculptForge","t":"Features use SculptForge's own names. The ideas are the ones you know; here is what to look for: ZBrush SculptForge Where SubTools Parts Tool > Parts; Alt+click one in the viewport. See Parts ZSpheres Forge Spheres Tool > Forge Spheres. See Forge Spheres Polypaint Vertex Paint The Paint brush (P), Rgb, the Paint menu. See Vertex Paint and materials Polygroups Face Groups Tool > Face Groups. See Face Groups and visibility LightBox Library , (comma). See The interface GoZ Send to ZBrush (GoZ-compatible) File > Send to ZBrush. See Exporting MatCap Lit Sphere Render > Materials, M. See Materials Zadd / Zsub Add / Sub Top shelf; Alt flips for one stroke Z Intensity Intensity Top shelf, U Focal Shift Falloff Sculpt > Draw & Tablet, O DynaMesh Voxel Remesh Tool > Remesh. See Geometry ZRemesher, ZRemesher Guides Quad Remesh, Quad Remesh Guides Tool > Geometry > Quad Remesh. See Quad retopology ProjectAll, ZProject Project All, Project Tool > Parts > Project. See Quad retopology Sculptris Pro Dynamic Topology Dynamic on the top shelf. See Dynamic topology QuickSave Snapshot File > Save Snapshot, the Library's Snapshots tab. See Projects Transpose, Gizmo 3D, Transpose All Gizmo, All Parts W E R. See Gizmo LazyMouse Steady Stroke (every stroke type) Sculpt > Stroke, L PolyFrame (PolyF) Wireframe (Wire on the shelf) Right shelf, Shift+F QuickMenu Quick Menu Space or a right click DamStandard Sharp Crease brush B D S. See Sculpting ClayBuildup Clay Block brush B C B SnakeHook Tendril brush B S H KelvinSnake Elastic Tendril brush Brush picker (KelvinGrab, KelvinTwist and KelvinScale keep their names) Trim Dynamic Trim brush Brush picker hPolish Hard Polish Not built in yet; a Brush Lab recipe gets close DragRect, DragDot Drag Stamp, Slide Stamp strokes Sculpt > Stroke MaskPen, MaskLasso, MaskRect Mask Pen, Mask Lasso, Mask Rectangle Tool > Masking. See Masking SelectRect, SelectLasso Select Rectangle, Select Lasso Tool > Visibility FiberMesh, LightCap Not yet ZScript, ZPlugin Script commands and the Python module See Scripting Decimation Master, UV Master, Projection Master Decimate, the UV Editor (and Auto UV), Mesh > Generate 3D > Stamp See Geometry, UV Editor and Texture painting The command palette (F3) finds every feature by its ZBrush name too: type SubTool, ZSphere, Polypaint or MatCap and it shows the SculptForge command, as in \"Forge Spheres (ZBrush users: ZSpheres)\". The Glossary maps many more ZBrush terms. ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer GmbH. SculptForge is not affiliated with or endorsed by Maxon."},{"p":"coming-from-zbrush.html","c":"Coming from ZBrush","a":"zbrush-style-keys","h":"ZBrush-style keys","t":"New installs start with the SculptForge keys. The first time SculptForge starts it asks what you are Coming from: pick ZBrush and it turns on the ZBrush-style keys for you. To switch at any time, open Edit > Preferences > Input and choose ZBrush-style under Style, then press Store Config (Ctrl+Shift+I) to keep it. If you used an earlier version, your saved choice is kept. What the ZBrush-style keys change: ZBrush-style SculptForge (default) 1 to 9, 0 Free (9 is Save Snapshot, ZBrush's QuickSave) Pick the ten first brushes (Standard, Clay, Smooth, Move ...) I RGB Intensity at the cursor Intensity at the cursor (as U) Ctrl+drag on the background with nothing masked Draws a mask rectangle Zooms Zoom drags (Ctrl+right-drag, Alt then release) Up zooms out Up zooms in Everything else in this chapter works in both styles. Edit > Preferences > Input > Rotation chooses free rotation (as in ZBrush) or a turntable that keeps the model upright, as in Blender or Maya. Press Store Config to keep either. See Keyboard and mouse for the full list."},{"p":"coming-from-zbrush.html","c":"Coming from ZBrush","a":"whats-the-same","h":"What's the same","t":"The layout (in the ZBrush-style layout). Shelves around the canvas, palettes in alphabetical order in the palette bar and the trays, sub-palettes that fold, the Library on ,, Ctrl-hover help on every control, Ctrl+Alt+click to assign a hotkey, Store Config on Ctrl+Shift+I. See The interface. Navigation. Drag on the background to rotate freely (over the top, too), Alt+drag to move, Alt+click, let go of Alt and drag to scale, Shift during a rotation to snap to a side view, Shift+click, let go of Shift and drag to roll. Right-drag navigation works as with ZBrush's RightClick Navigation turned on, over the model too. F frames the model. See Navigating the view. Sculpting modifiers. Alt swaps Add and Sub (ZBrush's Zadd and Zsub), Shift smooths (Smooth keeps its own Intensity; let go of Shift mid-stroke for the alternate smooth that keeps the volume), Shift pressed after a stroke starts draws a straight line. Brush keys. B then two letters, with ZBrush's letters: B S T Standard, B C B Clay Block, B D S Sharp Crease, B M V Move, B I N Inflate, B S M Smooth, B S H Tendril, B P I Pinch. Brush settings. S Draw Size, U Intensity, I RGB Intensity (ZBrush-style keys), O Falloff, each as a slider under the cursor; [ and ] step the size; Space opens the Quick Menu; L toggles Steady Stroke. The cursor's outer ring is the Draw Size, the inner ring the Falloff. See Sculpting and brushes. Masking. Ctrl paints a mask and Ctrl+Alt erases it; Ctrl+click the model blurs it and Ctrl+Alt+click sharpens it; Ctrl+click the background inverts it and Ctrl+drag there draws a mask rectangle (ZBrush-style keys; one that misses the model clears the mask). Mask Lasso and Mask Rectangle follow the symmetry: with Ctrl held the shelf shows the mask brush, and the Brush (B) and Stroke pickers pick it. See Masking. Visibility and face groups. Ctrl+Shift+drag keeps the inside (press Alt to hide it instead), Ctrl+Shift+click a group to isolate it (on a partly hidden mesh: to hide it), Ctrl+Shift+click the background to show everything, Ctrl+W to group the masked part. Select Rectangle and Select Lasso, also from the Brush and Stroke pickers with Ctrl+Shift held. Group by UVs is UV Groups. See Face Groups and visibility. Parts with Alt+click to select one and Shift+Alt+click to select and frame it; subdivision levels with Ctrl+D, D and Shift+D; Wireframe on Shift+F; Save Snapshot on 9 (ZBrush-style keys). See Parts and Subdivision levels. Send to ZBrush (GoZ-compatible). Send models to and from ZBrush. See Exporting, Unreal and ZBrush. VDM brushes with Drag Stamp and Slide Stamp, and your own made from a VDM plane. See Vector displacement brushes. Sculpting in Blender too? The Blender add-on can give Blender's Sculpt Mode ZBrush's keys. See Working with Blender."},{"p":"coming-from-zbrush.html","c":"Coming from ZBrush","a":"bring-your-ztools-over","h":"Bring your ZTools over","t":"ZBrush's .ZTL files are proprietary, so SculptForge can't read them directly. The free SculptForge ZTL Export plug-in runs inside ZBrush and converts them once: Download SculptForgeZToolExport.txt (also attached to every release) and copy it into ZBrush's ZStartup/ZPlugs64 folder, then restart ZBrush. Or load it once with ZScript > Load. In ZBrush, ZPlugin > SculptForge > Convert ZTL asks for a .ZTL, loads it and writes each SubTool next to it as a GoZ-compatible file (Dragon.ZTL gives Dragon.sf001_Body.GoZ, Dragon.sf002_Horns.GoZ...). Save for SculptForge does the same for the ZTool you have open, saving the .ZTL where you choose. In SculptForge, open the .ZTL (File > Open, or drop it on the window). Its SubTools open as Parts in the same order with the same names, face groups, vertex paint, mask and UVs. Each SubTool comes over at its highest subdivision level; the lower levels, sculpt layers and ZBrush materials don't. If you change the ZTool in ZBrush later, convert it again: SculptForge warns when the .ZTL is newer than its conversion. .ZPR projects can't be converted; save their ZTools first. Note: the plug-in is new and hasn't been tested in every ZBrush version yet. If it stops with an error or a SubTool is missing, please report it with your ZBrush version; exporting each SubTool from ZBrush as a .GoZ or .OBJ file works in the meantime."},{"p":"coming-from-zbrush.html","c":"Coming from ZBrush","a":"whats-different","h":"What's different","t":"ZBrush SculptForge Why Transpose action line (W E R) The Gizmo on the same keys; mask what should stay, and Alt+click to put the pivot on the model Simpler to learn; ZBrush has a Gizmo 3D too. See Gizmo Edit mode (T) and the 2.5D canvas Always in Edit mode SculptForge is a 3D sculpting app only Perspective toggle (P) Always perspective; P is the Paint brush (colour only: Rgb on, Add off) Stroke replay (1, 2, 3) Not yet N lists the SubTools The Parts sub-palette in the right tray DynaMesh, ZRemesher Voxel Remesh and Quad Remesh in Tool > Geometry See Geometry and Retopology Sculptris Pro Dynamic on the top shelf, with its Detail slider See Dynamic topology Open edges hold their shape when smoothed Smooth pulls an open border in a little with each pass Mask the border first when it matters Values 0-100 everywhere The same for Intensity, RGB Intensity and Falloff; Draw Size is the radius in pixels "},{"p":"coming-from-zbrush.html","c":"Coming from ZBrush","a":"shortcuts-side-by-side","h":"Shortcuts side by side","t":"The SculptForge column is with the ZBrush-style keys on. Action ZBrush SculptForge Rotate / move / scale the view Drag / Alt+drag / Alt, release, drag on the background Same Snap to a side view / roll Shift while rotating / Shift+click, release, drag Same Frame F F Brush pop-up B B Draw Size / Z Intensity / RGB Intensity / Focal Shift S / U / I / O Same keys: Draw Size / Intensity / RGB Intensity / Falloff QuickMenu Space or right-click Quick Menu: Space or right-click (a right drag navigates) LazyMouse L Steady Stroke: L Pick colour / switch colour C / V Same Symmetry X X Undo / redo Ctrl+Z / Ctrl+Shift+Z Same (also Ctrl+Y) Divide / higher / lower res Ctrl+D / D / Shift+D Same Mask all / clear / invert / view Ctrl+A / Ctrl+Shift+A / Ctrl+I / Ctrl+H Same Group masked Ctrl+W Ctrl+W PolyFrame Shift+F Wireframe: Shift+F Draw / Move / Scale / Rotate Q / W / E / R Same keys, Gizmo LightBox , Library: , Hide the palettes Tab Tab QuickSave 9 Save Snapshot: 9 Store Config / Load UI / Save UI Ctrl+Shift+I / Ctrl+L / Ctrl+Shift+Alt+I Same Perspective P Always on (P is Paint) Search every command F3 (ZBrush names work too) Every shortcut is in Keyboard and mouse, generated from the app itself, and can be changed with Ctrl+Alt+click or Edit > Preferences > Hotkeys."},{"p":"coming-from-zbrush.html","c":"Coming from ZBrush","a":"see-also","h":"See also","t":"Keyboard and mouse Glossary: more ZBrush terms and their SculptForge names Exporting, Unreal and ZBrush: Send to ZBrush"},{"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 (see Flatpak) Arch Linux packaging/arch/PKGBUILD in the source makepkg -si in that folder (an AUR package is planned) Studio pipelines SculptForge--...-vfx2026.tar.gz or ...-vfx2027.tar.gz See SculptForge for studios Most PCs are x86_64; ARM64 is for ARM laptops, Raspberry Pi and Apple Silicon Macs running Linux. Older versions are on the releases page."},{"p":"installing.html","c":"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. 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). It is a single file: download it, then flatpak install --user ./SculptForge-linux-x86_64.flatpak # or ...-linux-arm64.flatpak flatpak run org.sculptforge.SculptForge 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; the file adds Flathub for that if it isn't set up. Only the runtime comes from Flathub: SculptForge itself is not published there. Updating: SculptForge tells you when there is a new version, as the other packages do. Download the new .flatpak and install it the same way; your settings are kept. flatpak update updates the runtime but not a SculptForge installed from a file. 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, MatCaps, Images, Splats and QuickSave (snapshots) sub-folders), which the Library shows as User. The first start also asks what you are Coming from: ZBrush, Blender, Maya or New to sculpting. Your answer picks the key style: ZBrush turns on the ZBrush-style 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 doesn't install updates by itself, but it tells you when there is one. Once a day at start-up it downloads a small file from its website that names the newest version; if yours is older, a banner at the top of the 3D view says what's new, with What's new, Download, Later and Skip this version. Nothing about you or your computer is sent. Help > Check for updates asks right away, and Edit > Preferences > Updates turns the daily check off. Builds from a package manager (such as the AUR package) leave updates to the package manager and don't check. To update, download the new release and install it over the old one. Your settings, brushes and library are kept: they live in your user folders, not next to the program (see Troubleshooting and FAQ for where). To uninstall, use your system's usual method (Settings > Apps on Windows, dragging the app to the Bin on macOS, sudo apt remove sculptforge or sudo dnf remove sculptforge on Linux, 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 ZBrush-style 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, Draw 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 ZBrush-style 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. 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, Draw 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. ZBrush-style: the alphabetical palette bar under a title strip, and a two-row top shelf (see The title strip and Top shelf). Coming from ZBrush? In the welcome shown at the first start, pick the ZBrush-style layout card or Coming from: ZBrush (which also sets the ZBrush-style 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 ZBrush-style layout (Classic with the palette bar). Coming from sets the keys and the layout together: ZBrush (ZBrush-style keys and 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 ZBrush-style layout again right after. The look and layout are remembered for the next start without Store Config (Store Config keeps them in your UI configuration too). 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=zbrush)."},{"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-zbrush-style-layout","h":"The title strip (ZBrush-style layout)","t":"In the ZBrush-style 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 ZBrush-style 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 ZBrush-style layout, drop the menu: Edit > Preferences > Input is Input in the palette named Preferences, and Sculpt > Stroke is the palette named Stroke. In the ZBrush-style 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 ZBrush's strict A to Z order, turn on Edit > Preferences > Interface > Palettes strictly A-Z (ZBrush 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), Send to ZBrush, 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, Show vertex paint Draw Sculpt > Draw & Tablet Draw Size, Intensity, RGB Intensity, Falloff, Sculpt/Paint, Add/Sub, Rgb, Front, and the tablet options (Pressure > strength, Pressure > size) with a pen readout Generate Mesh > Generate 3D Generate 3D (image or text to 3D), Relief, Inflate and Stamp from an image, and the AI brush provider settings 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, 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. ZBrush: as in ZBrush, Parts (ZBrush's SubTool), Layers, Masking, Face Groups (Polygroups) and Visibility are sub-palettes of the Tool palette rather than palettes of their own. SculptForge's Remesh sub-palette is where ZBrush's DynaMesh would be."},{"p":"interface.html","c":"The interface","a":"trays","h":"Trays","t":"The trays are columns at the far left and far right of the window where palettes stay open while you work. The right tray is open by default and holds the Tool palette; the left tray starts closed and empty. Put a palette in a tray: open it from 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 ZBrush-style 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. Draw 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 ZBrush-style layout's top shelf has two rows: Library (,), Sculpt/Paint, Add/Sub, Rgb, Draw 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). Draw Size and Intensity are sliders with the label inside, as in ZBrush: drag along them, or Ctrl+click to type a value."},{"p":"interface.html","c":"The interface","a":"left-shelf","h":"Left shelf","t":"Four large tiles, each showing the current choice. Click one to open its pop-up picker: Brush: the active brush, with a rendered preview. Stroke: Dots, 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 (the main and second colour; click either to swap them, like ZBrush's Alternate) and Fill, which fills the unmasked area with the main colour."},{"p":"interface.html","c":"The interface","a":"right-shelf","h":"Right shelf","t":"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, as in ZBrush. 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."},{"p":"interface.html","c":"The interface","a":"pop-up-pickers","h":"Pop-up pickers","t":"Pickers are pop-up grids of thumbnails. They open beside the left-shelf tile you click, or under the mouse when you use a key. They close when you pick something, press Esc or click elsewhere. Pointing at a tile for a moment shows Quick Info: a large preview and a description."},{"p":"interface.html","c":"The interface","a":"brush-picker","h":"Brush picker","t":"Press B (or click the Brush tile). The picker shows a Recent row, then Built-in, Custom (your brushes and Brush Lab creations) and Library (.sfbrush files in your library that aren't loaded yet; picking one loads it). The brush picker after pressing B and typing S Choose a brush with the keyboard the ZBrush way: Press B. Type the first letter of the brush. Only the brushes starting with that letter stay, and each shows an orange letter: the next key that tells it apart. Press that orange letter to pick the brush. For example B S T picks Standard. Backspace takes back a letter and Enter picks the first match. If no name starts with what you typed, the picker falls back to names that contain it. The letter chips along the top (with a count for each letter) filter by a click as well. Right-click a brush for Add to bottom shelf and, for custom brushes, Copy brush code, Rename..., Save as .sfbrush..., Delete... and Reveal in folder (see Brush Lab and sharing brushes)."},{"p":"interface.html","c":"The interface","a":"stroke-alpha-and-material-pickers","h":"Stroke, Alpha and Material pickers","t":"Stroke (click the Stroke tile): Dots, 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":"As in ZBrush, press S for a Draw Size slider under the mouse, U for Intensity, I for RGB 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 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 Alpha Round, Square, Noise, the twelve built-in patterns and images in your Alphas folder Use as the brush alpha Material The Lit Spheres (your own included) and Studio Use the material Image Reference images in your library A menu: Generate 3D, relief, inflate, project onto the model, use as alpha Splats Gaussian splat captures (.ply, .splat) Open the capture as a reference 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. 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. 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. ZBrush: the Library works like ZBrush's LightBox: comma toggles it, double-click loads, and Built-in and User folders play the part of ZBrush's Maxon and User folders."},{"p":"interface.html","c":"The interface","a":"ctrl-hover-help","h":"Ctrl-hover help","t":"Hold Ctrl and point at any button, slider, tile or shelf item. A box shows the item's name, its shortcut as keycaps, what it does, where it lives (for example \"Tool > Geometry\") and the script command it runs. Ctrl-hover help on the Subdivide button Hold Ctrl+Alt instead to see the scripting reference for items that run a command: the command's usage line and each parameter with its type and description. This is the same information the console, sculptforge-cli and AI agents use. Without Ctrl, icon-only buttons and labels that don't fit show their name after a short delay (Edit > Preferences > Interface > Tooltip delay). Turn Ctrl-hover help off with Edit > Preferences > Interface > Popup Info (Ctrl+hover help), and make the box more or less see-through with Popup Info opacity."},{"p":"interface.html","c":"The interface","a":"the-controls-sheet","h":"The Controls sheet","t":"Press F1 (or Help > Controls) for the Controls window. The Keyboard tab lists every action that has a shortcut, grouped by palette and generated from the actions themselves, so it always shows your current keys. The Mouse & pen tab lists the gestures. Type in the filter field to search both. Double-click a row on the Keyboard tab to give that action a new key."},{"p":"interface.html","c":"The interface","a":"this-guide","h":"This guide","t":"Help > User Guide (Shift+F1) opens this guide in its own window: the contents on the left (the open chapter lists its sections), the chapter on the right, and links between chapters. The User Guide window on the Masking chapter Search: type in the search box (Ctrl+F) to find every section that mentions all of your words. Click a result to jump there; the words are marked on the page. Esc clears it. Back and forward: the arrow buttons, Alt+Left / Alt+Right, or the back and forward buttons of your mouse. From any control: while Ctrl-hover help is showing, press F1 (keep Ctrl held) to open the chapter about that control. The help box shows which chapter it is (\"Learn more: ...\"). Code blocks have a Copy button, and Open in browser shows the same page on the SculptForge website. The guide is built into SculptForge, so it works offline and always matches your version."},{"p":"interface.html","c":"The interface","a":"the-command-palette","h":"The command palette","t":"Press F3 (or Ctrl+Shift+P, or click Search 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 like ZBrush's ZScript window: Every command you run, from a button, a key, the command palette, a script or an AI agent, appears as a script line followed by its result. Errors show in red. Type a command and press Enter: for example remesh resolution=200 or subdivide; decimate ratio=0.5. Tab completes command and parameter names, Up and Down recall earlier lines, and help (or help remesh) explains commands. Drag the console's top edge to make it taller or shorter. 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. As in ZBrush, changes last until you quit unless you store them with Store Config."},{"p":"interface.html","c":"The interface","a":"move-add-and-remove-shelf-items","h":"Move, add and remove shelf items","t":"Open Edit > Preferences > Config and turn on Enable Customize. The shelves get a dashed orange outline and the status line reads \"Customize: Ctrl+Alt+drag to move or remove items\". Hold Ctrl+Alt and drag any button, slider or tile: onto a shelf to put it there (an orange line shows where it will go), which is how you add buttons from palettes to a shelf; along its shelf, or to another shelf, to move it; off the shelves (onto the canvas, for example) to remove it. Turn Enable Customize off when you're done, and press Ctrl+Shift+I to keep the result. Right-clicking a shelf item and choosing Remove from shelf works without Customize mode."},{"p":"interface.html","c":"The interface","a":"assign-shortcuts","h":"Assign shortcuts","t":"Hold Ctrl+Alt and click any button (with Customize off), then press the key you want. Esc cancels and Backspace removes the button's shortcut. Or open 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 (as in ZBrush) and the status line says which action lost it."},{"p":"interface.html","c":"The interface","a":"store-config-and-friends","h":"Store Config and friends","t":"All in Edit > Preferences > Config: Item What it does Store Config (Ctrl+Shift+I) Keeps the current layout, shortcuts and interface preferences for future sessions Restore Custom UI Goes back to what the last Store Config saved Restore Standard UI Goes back to the built-in layout and default shortcuts (Store Config afterwards to make it stick) Save UI... Saves the layout, shortcuts and preferences to a .json file you can share Load UI... (Ctrl+L) Loads such a file (Store Config afterwards to keep it) The first time you change the layout in a session, the status line reminds you once: \"Layout changed - Ctrl+Shift+I to keep it\". What a session changes by itself (the console and Library being open, the Library tab) doesn't count as a layout change. ZBrush: Store Config has the same shortcut as in ZBrush, and SculptForge never saves the layout on its own either."},{"p":"interface.html","c":"The interface","a":"layout-presets","h":"Layout presets","t":"The 1, 2 and 3 buttons 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). Store Config keeps it."},{"p":"interface.html","c":"The interface","a":"interface-preferences","h":"Interface preferences","t":"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 or Español (see below) Popup Info (Ctrl+hover help) On Ctrl-hover help boxes Popup Info opacity 0.97 How solid the help box is Tooltip delay 0.5 s How long to point at an icon-only button before its name appears 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 (ZBrush order) Off ZBrush-style 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; Store Config keeps it 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. 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; Store Config keeps it. 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. Store Config keeps them. 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). Edit > Preferences > Input sets the key Style (the first start sets it from your Coming from answer): SculptForge (the default for new installs): 1 to 9 and 0 pick the first ten brushes, I opens Intensity like U, and Ctrl+drag on the background zooms when nothing is masked; ZBrush-style: ZBrush's keys, with the number keys free (9 is Save Snapshot), I for RGB Intensity and Ctrl+drag on the background for a mask rectangle (see ZBrush-style keys); Maya: Maya's view controls; or Blender: middle-drag navigation, the numpad "},{"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. Store Config keeps the choice 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. ZBrush: like turning the gradient off in the Document palette (Range 0) and choosing the Back colour. Edit > Preferences > Library has Show at startup (on by default), the number of Rows, Placement (along the top of the canvas, or at the bottom above the bottom shelf) and the Library folder. 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 ZBrush-style 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, as in ZBrush: dragging turns the model about the screen's own axes, so it follows the cursor and can roll right over the top. Hold Shift while rotating to snap to the nearest front, back, side, top or bottom view; let go of Shift and the drag carries on from where the cursor is. If you prefer the model to stay upright, as in Blender or Maya, set 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. 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. Click an end to look from that side, as in Blender: X the right view, Y the top, Z the front, and the plain dot at the other end of each axis the left, bottom or back view. These are orthographic like the numpad views. The end under the pointer gets a ring. 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. ZBrush: the gestures are ZBrush's. Dragging on the background (or right-dragging) rotates, with Shift to snap; Alt+drag pans, and letting go of Alt while still dragging zooms; Ctrl+right-drag zooms and Alt+right-drag pans, as with ZBrush's right-click navigation. As in ZBrush, dragging up (forward) zooms out and dragging down zooms in, and when you rotate or pan the model follows the cursor. The right-shelf Move, Zoom and Rotate buttons work as in ZBrush. 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 (ZBrush) Pan Alt+left-drag on the background, Alt+right-drag, or middle-drag Zoom Mouse wheel; Alt+left-drag on the background, then let go of Alt and keep dragging; Ctrl+right-drag; Ctrl+middle-drag; Ctrl+left-drag on the background when nothing is masked (not with the ZBrush-style 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 . 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 ZBrush-style keys (Edit > Preferences > Input) they go the ZBrush way: drag up to zoom out, down to zoom in. Hold Space and drag to move the camera is off by default, because in ZBrush 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 ZBrush or SculptForge style, press Shift+L to turn it off while you rotate, or turn on Hold Space. Mask Lasso, Mask Rectangle and the Ctrl+Shift hide and show shapes work as before. \"Background\" means any part of the canvas where the cursor isn't over the model. A left-drag that starts on the model sculpts instead, so with a pen or a one-button mouse, start rotations beside the model. When the model fills the view, zoom out a little or use the right-shelf buttons. Note: Ctrl+left-drag on the background clears the mask when something is masked (and Ctrl+click there inverts it); while nothing is masked it zooms (with the ZBrush-style keys it draws a mask rectangle instead). Use the wheel or Ctrl+middle-drag to zoom on a masked model. See Masking. On macOS, Cmd works wherever this guide says Ctrl for these gestures, except Ctrl+middle-drag, which needs Ctrl itself."},{"p":"navigation.html","c":"Navigating the view","a":"the-right-shelf-navigation-buttons","h":"The right-shelf navigation buttons","t":"The right shelf has three buttons you drag on rather than click, as in ZBrush. They are handy with a pen, on a laptop trackpad, or when the model fills the canvas and there is no background to drag on. The right shelf: Frame, Move, Zoom and Rotate, then the display toggles Button Drag on it to Frame (click) Fit the whole scene in the view (F) Move Pan the view Zoom Zoom: drag up to come closer, down to move away Rotate Orbit the view The button stays orange while you drag. Frame is also in the 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, ZBrush-style, 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. 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. Store Config (Ctrl+Shift+I) keeps these settings. 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. 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), another program holds the device: quit 3DxWare (or spacenavd on Linux) as above, then unplug and plug the SpaceMouse back in. To report a problem, open Edit > Preferences > Input > SpaceMouse and click Copy device report (shown until the cap has moved the view): it puts every joystick SculptForge sees on the clipboard, wit"},{"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":"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, ZBrush's PolyFrame. Quads show as quads (see Quads and triangles). Useful for judging mesh density before you subdivide or remesh. Groups: colours each face group. Mask: darkens masked areas. 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), no floor grid and no saved camera views. Pan the target onto the area you're working on to orbit around it."},{"p":"navigation.html","c":"Navigating the view","a":"see-also","h":"See also","t":"The interface Keyboard and mouse Sculpting and brushes"},{"p":"sculpting.html","c":"Sculpting and brushes","a":"","h":"Sculpting and brushes","t":"This chapter covers everything that happens when you drag a brush across a model: the built-in brushes and the custom brushes that ship with SculptForge, brush size and strength, modifier keys, stroke types, alphas, symmetry and pen pressure. To design your own brushes, see Brush Lab and sharing brushes. Sculpting the lion head with X symmetry"},{"p":"sculpting.html","c":"Sculpting and brushes","a":"your-first-stroke","h":"Your first stroke","t":"Pick a brush: click it on the bottom shelf, press its number key, or press B to open the brush picker. Left-drag on the model. The brush works on the surface under the cursor. Hold Alt while dragging to invert the brush (dig in instead of building up), or hold Shift to smooth. Press Ctrl+Z to undo a stroke, Ctrl+Shift+Z (or Ctrl+Y) to redo it. Each 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). ZBrush: the modifiers are the ones you know. Alt flips Add and Sub for one stroke, Shift smooths with any brush, Ctrl paints a mask (see Masking)."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"built-in-brushes","h":"Built-in brushes","t":"SculptForge has 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. ZBrush: Sharp Crease (ZBrush's DamStandard), Clay Block (ClayBuildup), Tendril (SnakeHook), Trim (Trim Dynamic), Layer and Nudge behave like their ZBrush counterparts. Brushes such as ZBrush's hPolish, ClayTubes, Slash or the IMM and curve brushes are not built in; you can get close to several of them with a custom brush in Brush Lab."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"custom-brushes-that-ship-with-sculptforge","h":"Custom brushes that ship with SculptForge","t":"Besides the built-in brushes, SculptForge ships seven custom brushes. They are recipes: data that you can open and change in Brush Lab. They appear in the Custom section of the brush picker and in 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 Chisel Scrapes hard planes and breaks them up with cracks for rocks and ruins. Skin Pores Sprinkles tiny pores for close-up skin detail. Clay 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 the ZBrush way, by typing letters: Press B. Type the first letter of the brush. Only brushes starting with that letter stay, and each shows 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). ZBrush: B then two letters is the same muscle memory. Holding Ctrl while picking to choose a masking brush is not supported; mask strokes always use Ctrl with the current settings."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"draw-size-intensity-rgb-intensity-and-falloff","h":"Draw Size, Intensity, RGB Intensity and Falloff","t":"These values control every brush. Draw 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 Draw Size 2 to 800 60 Brush radius in screen pixels. [ and ] make it 10% smaller or larger (hold to repeat). S opens a slider at the cursor. Intensity 1 to 100 50 How strongly each dab changes the surface. U opens a slider at the cursor. RGB Intensity 1 to 100 100 How strongly painting colours the surface (the Paint brush, and sculpting with Rgb on). I opens a slider at the cursor. 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 Draw Size is measured on screen, the brush covers less of the model as you zoom in, which is what you want for detail work. The brush cursor shows two rings, as in ZBrush: the outer one is the Draw Size, the inner one is 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 as in ZBrush: 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 Draw Size, Intensity, Falloff, RGB 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 Draw Size and Intensity the same for every brush, as before 0.10.8. Falloff, RGB 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, as in ZBrush, 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, as in ZBrush: 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 masked 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 (ZBrush: Rgb with Zadd). Front Front faces only: brushes leave the far side of thin parts alone, such as the back of an ear or a cape. 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 ZBrush's QuickMenu under the cursor: the Brush, Stroke, Alpha and Material tiles, Draw Size, Falloff, Intensity and RGB 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, as in ZBrush: 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, Mask Lasso, Clear Mask, Mask Rectangle, Mask All, Mask Pen, View Mask, Group Masked 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. Store Config (Ctrl+Shift+I) keeps your menus."},{"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 (ZBrush users: 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":"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 Draw Size: it slides over the surface under the cursor and lands where you let go. Great for VDMs. None Spray Scattered dabs of random size, strength and rotation, for organic texture. Scatter (0 to 2, default 1): how far dabs land from the cursor, as a fraction of the brush size. 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, Mask Lasso and Mask Rect 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. ZBrush: Drag Stamp, Slide Stamp, Spray and Steady Stroke match ZBrush's DragRect, DragDot, Spray and LazyMouse. Freehand and Dots are the same thing here. Roll and curve strokes are not available yet."},{"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). Draw 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 Draw Size slider shows both numbers, for example Draw 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 Draw 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 (ZBrush and SculptForge styles), 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 as in ZBrush: 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). From a script: brush_alpha_options follow_stroke=true angle=30 angle_jitter=10 tile_x=2 tile_y=2. ZBrush: there is no alpha library browser with hundreds of alphas yet, and alpha options such as MidValue or Rf (radial fade) are not available. Any grayscale image works, including alphas you already have as PNG."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"vector-displacement-brushes","h":"Vector displacement brushes","t":"A vector displacement brush (ZBrush's VDM brushes, Blender's \"VDM brushes\") stamps a whole 3D shape in one click: a horn, an ear, a cluster of scales, a nostril. An alpha can only push the surface up or down; a vector displacement map (VDM) moves every point of the stamp in any direction, so the shape can lean over, curl and overhang, as nothing made with a height ever can. Horns, an ear curl, scales and two nostrils, one stamp each, and 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 Draw 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. 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-blender-zbrush","h":"Load and export maps (Blender, ZBrush)","t":"Load VDM... reads an OpenEXR (16- or 32-bit, any compression) or a .sfvdm; dropping an .exr on the window does the same. A loaded EXR is kept in your brush library as a .sfvdm, so it's there next time. Export EXR... writes the brush's map as a 32-bit float EXR. Right-click a map you made or loaded to delete it. Maps use the convention of Blender's VDM Brush Baker and its Draw brush with Vector Displacement: Channel Means R X: toward the stamp's right G Y: toward the stamp's top (the image's top row; the drag direction of 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. ZBrush keeps its VDMs inside brushes (as 3D alphas) and doesn't export them as EXR by itself; maps made with Tool > Vector Displacement Map or third-party exporters use axes set by ZBrush's Vector Displacement Flip options. If a map from ZBrush stamps lying on its side, load it again with Swap Y/Z; if it is mirrored or leans the wrong way, with Flip X or Flip Y (Flip Z for a map that digs in where it should rise). Scale multiplies a map made in other units. From a script: vdm_set name=horn or vdm_set path=ear.exr swap_yz=true, vdm_stamp point=0,0.5,0 radius=0.3 angle=30, vdm_new_plane, vdm_capture name=\"My horn\" exr=horn.exr, vdm_export path=horn.exr, vdm_list, vdm_delete name=\"My horn\". ZBrush: the VDM brush works like ZBrush's VDM brushes with DragRect or DragDot. Not available yet: several VDMs in one brush (ZBrush's Create Multiple Alpha Brush), MidValue and the alpha options for 3D alphas, and reading ZBrush's own brush files."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"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. ZBrush: this is \"GrabDoc\" for alphas, and more: ZBrush can only make a VDM from its special VDM plane, here any detail on any model becomes one. The commands capture_alpha and capture_vdm do the same from a script."},{"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. Draw 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 Count: 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, Mask Rectangle / Mask Lasso 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. ZBrush: R is ZBrush's (R) radial symmetry with Radial Count, and Local is its Local Symmetry (about the Part's centre). Topological (poseable) symmetry is not available yet."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"pen-pressure-and-tablets","h":"Pen pressure and tablets","t":"SculptForge reads pen pressure from graphics tablets and pen displays through the operating system. When it receives pen input, 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). 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). Store Config (Ctrl+Shift+I) keeps these settings. Setup notes for Windows Ink, macOS and Linux are in docs/tablet.md."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"customize-the-bottom-shelf","h":"Customize the bottom shelf","t":"The bottom shelf holds your most-used brushes. By default it shows Standard, Clay, 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 > Enable Customize, then Ctrl+Alt+drag a tile to a new place. Change a brush's key: Ctrl+Alt+click its tile, then press the new key. Shelf changes last until you quit. Press Ctrl+Shift+I (Store Config) to keep them. See The interface for more on customizing."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"sculpt-from-a-script","h":"Sculpt from a script","t":"The stroke command applies a brush along a path on the active 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 (Sculptris Pro) Keyboard and mouse reference"},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"","h":"Brush Lab and sharing brushes","t":"Brush Lab designs sculpting brushes from a description: type \"dry cracked mud\" and an AI model builds the brush, then you refine it in words or with sliders. This chapter covers Brush Lab, the AI providers it can use, the recipe settings, your brush library, and the ways to share brushes: .sfbrush files, one-line brush codes, studio folders and the community gallery. Brush Lab with a brush designed from a description"},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"what-a-custom-brush-is","h":"What a custom brush is","t":"A custom brush is a recipe: about twenty named values that describe how the brush moves the surface, the shape of its tip, a surface pattern, stroke spacing and masking. A recipe is data, never code, so brushes are safe to download and share. The AI only fills in these values; you can see and change every one of them. Custom brushes work everywhere built-in brushes do: on the bottom shelf, in the brush picker (B), with Alt, Shift, masks, symmetry, strokes and alphas."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"open-brush-lab","h":"Open Brush Lab","t":"Click AI Brush on the top shelf, or AI Brush at the top of 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. 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) to choose another service. Provider What you need Notes Free - no account or key (default) Nothing An open model (GPT-OSS 20B) hosted by Pollinations.ai. Only your description and settings are sent. Rate limited to about one request every few seconds. If it can't be reached, a running local Ollama is used instead. Anthropic (Claude) - your key An Anthropic API key Uses claude-opus-5-5 by default. Effort (low, medium, high) trades speed for more considered brushes. OpenAI-compatible (OpenAI, Ollama, LM Studio...) An endpoint, a model name and, for hosted services, a key Any server that speaks the OpenAI chat completions API, including local models. For Anthropic and OpenAI-compatible providers you can edit the Endpoint, Model and API key fields. Leave the key empty to use the ANTHROPIC_API_KEY or OPENAI_API_KEY environment variable. Click Save settings to keep your choice; settings and keys are stored only on your computer, in ai.json in the SculptForge settings folder (readable only by you). Requests go only to the endpoint you set."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"run-a-model-on-your-own-computer","h":"Run a model on your own computer","t":"For private, offline use with no rate limits, run a local model with Ollama or LM Studio: Install Ollama and download the recommended model: ollama pull qwen3:4b-instruct (2.5 GB, works without a graphics card). In AI provider, choose OpenAI-compatible (OpenAI, Ollama, LM Studio...). Click Ollama (or LM Studio) to fill in the local endpoint. Click Find models. SculptForge checks the connection, shows \"Connected\" with the number of installed models, and lets you pick one from the Model list. Click Save settings. The Run a model on this computer section in the panel shows the install steps for your operating system. The model needs about 4 GB of free memory; expect 10-20 seconds per brush on a laptop CPU and a few seconds with a GPU. The full walkthrough for Windows, macOS, Linux and LM Studio is in docs/local-ai.md."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"your-brush-library","h":"Your brush library","t":"Every brush you create or refine in Brush Lab is saved to your brush library automatically, a moment after your last change (slider edits save when you release the slider). The library loads at every start, in the app, in sculptforge-cli and in the Python module, so your brushes are always there. The library is a folder of .sfbrush files in the SculptForge settings folder: System Brush library Linux ~/.local/share/SculptForge/SculptForge/brushes macOS ~/Library/Application Support/SculptForge/SculptForge/brushes Windows %APPDATA%\\SculptForge\\SculptForge\\brushes The Custom brushes list in 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":"masking.html","c":"Masking","a":"","h":"Masking","t":"A mask protects part of the model from change. Masked areas are drawn darker, and every brush, the Paint brush and colour fills leave them alone. This chapter covers painting masks with Ctrl, masking with a lasso or rectangle, the background gestures, and the Tool > Masking controls for inverting, blurring, growing and building masks from cavities, face groups 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 .GoZ files, so they survive a round trip to ZBrush. Masking is not a layer and isn't affected by sculpt layers: a mask stroke always works on the model itself. Mask strokes and mask commands are undoable like any other change. To see the mask, keep Mask on in the right shelf (it is on by default; Ctrl+H toggles it, as ZBrush's View Mask). 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 Draw Size, symmetry and, with a pen, pressure (when Pressure > Strength is on). How much each stroke masks is set by Mask Strength in Tool > Masking (0.01 to 1, default 1): lower values build up a soft, partial mask over several strokes. Mask strokes always use a round tip, whatever alpha you have selected, and a Drag Stamp stroke masks with dabs along the path instead of one stamp. On macOS, Cmd works wherever this guide says Ctrl. ZBrush: this is ZBrush's Ctrl-masking with its MaskPen brush, the default. Mask Lasso and Mask Rectangle are described next."},{"p":"masking.html","c":"Masking","a":"mask-with-a-lasso-or-rectangle","h":"Mask with a lasso or rectangle","t":"To mask a large or sharply outlined area in one go, pick a mask selection shape. As in ZBrush, holding Ctrl turns the brush on the left shelf into the mask brush: with Ctrl held, click the brush tile (or press B) to pick Mask Pen, Mask Lasso or Mask Rectangle, 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. Mask Lasso Draws a free-hand outline that closes back to where you started. Everything inside is masked. Mask Rectangle Draws a rectangle. Everything inside is masked. With Mask Lasso or Mask Rectangle: 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 (as in ZBrush). 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 Mask Lasso and Mask Rectangle) 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. ZBrush: these are ZBrush's MaskLasso and MaskRect brushes. Like ZBrush, the shape stays selected until you pick another one, so switch back to Mask Pen to paint masks again. Holding Ctrl shows the mask brush on the shelf and Ctrl with the Brush or Stroke picker picks it, as in ZBrush. MaskCurve is not available yet."},{"p":"masking.html","c":"Masking","a":"background-gestures","h":"Background gestures","t":"With Ctrl held, clicks and drags on the empty background act on the whole mask: Gesture Effect Ctrl + click the background Invert the mask Ctrl + drag on the background Draw a mask rectangle (Mask Pen; Mask Lasso 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 ZBrush-style keys it draws the mask rectangle above (see Keyboard and mouse) ZBrush: with DynaMesh on, ZBrush also remeshes when a Ctrl + drag on the background misses the model. SculptForge doesn't: remesh with Tool > Remesh instead. On the model, a Ctrl + click that doesn't drag works on the mask's edges, as in ZBrush, 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 Masked: 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 Mask Lasso or Mask Rectangle, 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-sub-palette","h":"The Masking sub-palette","t":"Open Tool > Masking (the Tool palette is in the right tray by default). Every button is one undo step. Control What it does Command Show mask Darken masked areas in the viewport. Mask Pen / Mask Lasso / Mask Rectangle What Ctrl + drag does: paint with the brush, or mask inside a lasso or rectangle. mask_lasso / mask_rect Mask Strength How much each mask stroke or selection masks (0.01 to 1), and the mask value By cavity gives the deepest cavities. Clear Unmask everything. mask_clear Invert Masked becomes free and free becomes masked. mask_invert All Mask every visible vertex. mask_all Blur Soften the mask edges by averaging with neighbouring vertices. mask_blur Sharpen Tighten soft edges, pushing values toward fully masked or free. mask_sharpen Grow Expand the masked region by one ring of edges per pass. mask_grow Shrink Contract the masked region by one ring of edges per pass. mask_shrink passes How many times Blur, Sharpen, Grow and Shrink run (1 to 20 here, default 1). iterations= By cavity Mask concave areas (creases, folds, pores), replacing the current mask. mask_by_cavity threshold How concave a spot must be for By cavity (-0.2 to 0.5, default 0.02). 0 masks anything concave; higher values keep only deep creases. threshold= By face group Mask one face group, replacing the current mask. The number field next to it is the face group id. mask_by_polygroup By border Mask the open edges of the mesh (edges with only one face) and the rings of edges inside them, replacing the current mask, so sculpting keeps the border in place. Uses Mask Strength. A closed mesh has no open edges, and the status bar says so. mask_border Rings How wide By border masks, in rings of edges from the border (1 to 20, default 2; 1 masks the border vertices only). rings= Face Group borders By border also masks where face groups meet (ZBrush: Mask by Polygroups border). polygroups=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_polygroup group=N line. Enter that number in the field next to By face group and click it."},{"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_polygroup group (required), add=true to add to the current mask instead of replacing it mask_border rings (1-20, default 1), polygroups=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 (ZBrush users: Polygroups) 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, as ZBrush writes them (SculptForge also writes face groups as g groups when it exports OBJ); .GoZ files from ZBrush 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. polygroup_auto_by_normals By pieces One group per disconnected piece, such as separate eyes or buttons in one mesh. polygroup_by_connectivity From mask Masked triangles move into a new group. polygroup_from_mask Group by UVs One group per UV island: triangles that touch without a UV seam between them share a group. Needs UVs (Tool > Texture Map > Auto UV or an imported model's). polygroup_uv Merge visible Everything visible becomes one group. polygroup_merge_visible Clear groups Remove all face groups; the whole Part becomes one group again. polygroup_clear Each button is one undo step. ZBrush: By normals is Auto Groups / Groups By Normals, By pieces is Auto Groups on a mesh with separate parts, From mask is Group Masked, Group by UVs is UV Groups, and Merge visible is Group Visible. Ctrl+W works as in ZBrush: the masked part becomes a new group and the mask is cleared (with nothing masked, everything visible becomes one group)."},{"p":"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 (as in ZBrush). 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, as in ZBrush, with Ctrl+Shift held: the left shelf then shows the selection brush, and clicking the brush tile (or pressing B) or the stroke tile picks 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, as ZBrush does. Every visibility change is one undo step, so Ctrl+Z brings back what you just hid. ZBrush: the gestures are the same as ZBrush's SelectRect and SelectLasso with polygroups. Grow and Shrink visibility and hiding by clicking with the rectangle brush are not available yet."},{"p":"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 hidden keeps 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; Send to ZBrush and OBJ carry face groups to and from ZBrush. 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 polygroup_auto_by_normals angle (1-180 degrees, default 30) polygroup_by_connectivity, polygroup_uv, polygroup_from_mask, polygroup_merge_visible, polygroup_clear isolate_polygroup, hide_polygroup group (required): the 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_polygroup group=3, which you can reuse in scripts. sculptforge-cli -c 'open path=robot.obj; polygroup_by_connectivity; subtool_split_groups; save_project path=robot.sfproj' Not yet: a face group paint brush, Group Front, face groups from UV islands or PolyPaint, 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. polygroups 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, Del Lower, Del 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, polygroups, 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 (ZBrush users: SubTools): 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, as in ZBrush. Merges and deletes ask for confirmation first. The Parts list highlights the active Part. In the ZBrush-style layout the title strip also shows it and its place in the list, for example Part Helmet (2/5). ZBrush: Parts work the way you expect: one active Part, the rest dimmed, Alt+click in the viewport to switch. There is no folder grouping of Parts yet."},{"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 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 Rename it Double-click the row (or right-click > Rename), type, press Enter Hide or show it Click the eye at the end of the row Duplicate or delete it Right-click the row > Duplicate (Ctrl+Shift+D) or Delete... See its vertex and triangle counts Point at the row for a moment The list shows six rows and scrolls when there are more. Names are kept unique: renaming a 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 subtool= or insert_mesh file=.) From file...: a model (.obj, .fbx, .glb, .gltf, .ply, .stl, .GoZ, .usda, .usd, .usdz) or a project (.sfproj). A file with several objects adds one Part per object. The new Part becomes the active one. 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."},{"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":"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":"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 as in ZBrush: Mask the part (hold Ctrl and paint, or use Mask Rectangle / Mask Lasso; 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. ZBrush: the same Extract, E Smt, Thick, Double, TCorne, TBorder and Accept."},{"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, attributes, layers and active layer 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 Send to ZBrush (GoZ-compatible exchange) Each visible Part is sent to ZBrush as its own SubTool 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 subtool_list List the Parts subtool_select index=1 Make a Part active subtool_append type=cube Add a primitive (sphere, cube, plane); path= adds a file; size= (0.05-2, default 0.35) subtool_duplicate Copy a Part subtool_delete name=Helmet Delete a Part subtool_rename to=Body Rename a Part subtool_visibility visible=false Show or hide (toggles when visible is left out) subtool_solo / subtool_show_all Solo the active Part / show every Part subtool_move direction=up Move a Part up or down the list subtool_merge_down / subtool_merge_visible Merge subtool_split_groups / subtool_split_parts Split 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 subtool_append type=sphere name=EyeL size=0.12; subtool_duplicate; subtool_rename to=EyeR"},{"p":"parts.html","c":"Parts","a":"see-also","h":"See also","t":"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":"forge-spheres.html","c":"Forge Spheres","a":"","h":"Forge Spheres","t":"Forge Spheres (ZBrush users: ZSpheres) 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. ZBrush: this works like ZBrush's ZSpheres with Adaptive Skin: Draw, Move and Scale on the spheres, Alt+click to delete, A to preview the skin, and Make Mesh in place of Make Adaptive Skin. Rotate mode, ZSketch, the Topology and Rigging uses of ZSpheres and the link-sphere (magnet) tricks are not there."},{"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. 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: zsphere_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): zsphere_new, zsphere_list, zsphere_add, zsphere_set, zsphere_delete, zsphere_insert, zsphere_preview and zsphere_make_mesh. For example, a simple figure: zsphere_new radius=0.5 zsphere_add parent=0 position=0,0.8,0 radius=0.3 zsphere_add parent=0 position=0.9,0.1,0 radius=0.2 symmetry=x zsphere_make_mesh resolution=160"},{"p":"vertex-paint.html","c":"Vertex Paint and materials","a":"","h":"Vertex Paint and materials","t":"Vertex Paint (ZBrush users: Polypaint) 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 GoZ-compatible 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. Draw Size, the stroke type and the alpha work as they do for sculpting; RGB Intensity (I) sets how strongly the colour goes on. While the Paint brush is active: Alt paints back towards white. Shift still smooths the shape, as in ZBrush. The surface isn't changed. Press P again, or click Sculpt on the top shelf, to go back to sculpting. Vertex Paint on a sculpt with the Paint menu open ZBrush: Paint is ZBrush's Rgb on with Zadd off. Sculpt with Rgb on is Rgb with Zadd: the brush sculpts and paints at once."},{"p":"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, like ZBrush's Alternate. 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":"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, GoZ-compatible) 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. ZBrush and Mudbox: ZBrush's polypaint layers only have opacity. Here every layer also has a blend mode, its own coverage and a lock, like the paint layers in Mudbox and Photoshop."},{"p":"vertex-paint.html","c":"Vertex Paint and materials","a":"materials-lit-spheres","h":"Materials (Lit Spheres)","t":"Materials 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, as in ZBrush, 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":"A Lit Sphere is a picture of a lit sphere (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 made for ZBrush, Blender or Nomad 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 MatCaps folder of your library (Documents/SculptForge/MatCaps, or the folder set in Edit > Preferences > Library), so it is there next time. Or put images into that MatCaps 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_MATCAP_PATH environment variable (separated by :, ; on Windows); those load when SculptForge starts. To remove one, right-click it in the material picker or palette and choose Remove. An image from your MatCaps 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 Your Lit Spheres appear in the material picker (M), Render > Materials and the Library, after the built-in ones. 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 once you Store Config (Ctrl+Shift+I). Smooth and Flat have no default shortcut, so no ZBrush key changes meaning; assign one under Edit > Preferences > Hotkeys if you switch often. Not yet: loading your own Lit Sphere images, and physically based materials or BPR-style renders."},{"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_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_matcap path=gold.png Load a Lit Sphere image and use it; keep=false doesn't copy it into the MatCaps folder (desktop app only) remove_matcap name=Gold Remove one of your Lit Spheres; its image in the MatCaps 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) subtool_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: Draw 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 (from ZBrush, Maya, Blender...) already have them: skip this step. Choose a size (1K, 2K, 4K or 8K; 2K is the default) and click New Texture. The model now carries a white texture, and painting goes into it: Texture lights up next to Vertex on the top shelf. Press P and paint. Draw Size, RGB Intensity, pen pressure, the stroke type, the alpha, symmetry and the mask work as they do for 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 GoZ-compatible 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. ZBrush: ZBrush paints polypaint and converts it to a texture afterwards (Texture Map > New From Polypaint). SculptForge can do both: paint the texture directly, or bake vertex paint with Vertex Paint > Texture. Auto UV plays the part of UV Master's Unwrap."},{"p":"texture-painting.html","c":"Texture painting","a":"scripting","h":"Scripting","t":"Command What it does uv_auto Unwrap the active 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_polypaint=true starts from the vertex paint paint_target target=texture Where painting goes: vertex or texture texture_from_polypaint Bake the vertex paint into the active texture layer polypaint_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, subtool_merge_down and subtool_merge_visible keep a texture unless you add keep_texture=false. paint_fill, paint_from_cavity, paint_clear and every paint_layer_* command work on the texture while paint_target is texture. See Scripting and automation."},{"p":"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. UDIM Tiles spreads the islands over that many tiles, 1001, 1002 and on (ten per row, as UDIM numbers go), each island at the same texel density: more tiles, more texels for everything. Pack at Density instead keeps exactly the target texel density and opens as many tiles as it needs. 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, polygroups (By Face Groups), planar, unfold or auto; iterations=, selected=, tiles=, margin=, rotate=, density=, pack=false (fit in place), keep_texture= uv_pack Pack: margin= (texels), tiles= (UDIM tiles), 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), polygroups, islands, angle angle=60, clear_all uv_select op=all, none, invert, island face=, face face=, polygroup 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=polygroups 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). Coming from ZBrush? The UV Editor does what ZBrush 2027's UV editing and UV Master do: 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, like ZBrush's 3D Layers: see Layers and subdivision levels. Layers survive subdividing, decimating and LOD chains. A voxel remesh bakes them into the surface (the layers are gone afterwards). Note: Sculpt layers are not the Layer brush. The Layer brush raises the surface to a fixed height; sculpt layers are the blend-shape stack described here."},{"p":"layers.html","c":"Sculpt layers and blend shapes","a":"the-layers-sub-palette","h":"The Layers sub-palette","t":"Open Tool > Layers in the right tray. The Layers sub-palette with a base mesh and two blend shapes From top to bottom: Base mesh: select it to sculpt the base shape. One block per layer: a radio button with the layer's name (select it to sculpt into that layer), Play, X (delete) and a weight slider from 0 to 1. A name field and + Add at the bottom. The Layers list highlights the active layer; in the ZBrush-style 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. A layer whose weight is 0 can't be sculpted into: SculptForge tells you to raise the weight first. Tip: Name layers the way your engine or rig expects (jawOpen, BlinkL): the names become the blend shape and morph target names in exported files. For a face, Tool > Facial Shapes makes all 52 ARKit shapes for you: see Facial shapes and live face."},{"p":"layers.html","c":"Sculpt layers and blend shapes","a":"adjust-and-preview-weights","h":"Adjust and preview weights","t":"Drag a layer's weight slider to blend it in and out. Play animates the layer from 0 to 1 and back, over and over, so you can judge the motion. Click Stop to end it; the weight returns to 1. Starting a stroke also stops playback. Weights are saved with the project and used by exports that keep weights (USD writes the current weights)."},{"p":"layers.html","c":"Sculpt layers and blend shapes","a":"delete-a-layer","h":"Delete a layer","t":"Click X next to the layer. Its offsets are removed from the mesh and the base mesh becomes the active target. Deleting a layer is undoable."},{"p":"layers.html","c":"Sculpt layers and blend shapes","a":"layers-and-subdivision-levels","h":"Layers and subdivision levels","t":"With subdivision levels a layer works the way ZBrush's 3D Layers do: record it at the top level for the fine detail of an expression, and it stays with the Part whatever level you work on. Each layer has its own detail on every level. Step down with Lower Res (Shift+D) and a lower level shows the broad part of the layer, exactly as it would show the same strokes made in the base. Step back up and the layer is there as you recorded it, to the last vertex. Weights are shared by all levels. Turn a layer off (weight 0) or blend it at a low level and the top shows the same when you go back up; the slider and Play work at every level. Sculpt into a layer at any level. At a low level a stroke into a layer makes a broad change that the higher levels follow smoothly; the detail recorded above it stays. A layer added at a low level shows on every level above it too. Reshape the base at a low level (or turn it with the Gizmo) and each layer's detail rides on the new shape: its offsets turn with the surface instead of pointing the old way. Divide carries the layers to the new level. Reconstruct Subdiv keeps them, exact at the top. Del Lower and Del Higher keep the current level's layers as they are. Deleting a layer removes it from every level. Undo steps back through strokes, level changes and divisions with their layers. Projects keep every level's layers. Exports write the current level with its layers as blend shapes, so export from the top for the game mesh; subdiv_export path=face_low.glb level=1 writes the base cage with its blend shapes instead. The tools that rebuild the mesh (Voxel Remesh, 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. ZBrush: Layers here are close to ZBrush's 3D Layers with the slider used as a morph, and they follow subdivision levels the same way. Selecting a layer is its REC; a weight of 0 is its eye. There are no layer folders and no per-layer mask yet."},{"p":"layers.html","c":"Sculpt layers and blend shapes","a":"scripting","h":"Scripting","t":"Command What it does layer_add name=Smile Add a layer and make it active layer_set_active index=0 Choose the layer strokes go into (-1 = base mesh) layer_set_weight index=0 weight=0.5 Set a layer's weight (negative or above 1 exaggerates) layer_remove index=0 Delete a layer Layers are addressed by index, starting at 0 for the top layer. layer_add name=jawOpen; stroke points=\"0,-0.3,1 0,-0.5,1\" brush=Inflate; export_glb path=head.glb"},{"p":"layers.html","c":"Sculpt layers and blend shapes","a":"see-also","h":"See also","t":"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] [subtools=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, as with ZBrush's SDiv: block in the big forms on a light version of the mesh, add pores and wrinkles on a dense one, and go back down to change the silhouette without losing the detail. Every 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 Res Shift+D Steps one level down Higher Res D Steps one level up SDiv slider Steps to any level (1 is the base cage) Del Lower Deletes the levels below the current one Del Higher Deletes the levels above the current one Reconstruct Subdiv Finds a lower level for a mesh that was subdivided elsewhere Under the buttons the palette says where you are (\"SDiv 3 of 5\") and how many triangles the base and the top have. The 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 the way ZBrush does. Turn it off to divide flat: the new level keeps the hard edges and flat faces of the one below, for hard-surface pieces. Divide always adds the level on top. If you are at a lower level it steps to the highest first. Mask, 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":"del-lower-and-del-higher","h":"Del Lower and Del Higher","t":"Del Lower deletes the levels below the current one: the current level becomes the new base cage (SDiv 1). Del Higher deletes the levels above, and the detail sculpted on them. Both are undoable. Deleting down to a single level leaves an ordinary mesh."},{"p":"subdivision-levels.html","c":"Subdivision levels","a":"reconstruct-subdiv","h":"Reconstruct Subdiv","t":"A model that was subdivided in another application (or exported from SculptForge at its top level) comes in as one dense mesh. Reconstruct Subdiv finds the mesh it was subdivided from and adds it as a new lowest level, keeping the dense mesh exactly as it was. Press it again for more levels. It works at the lowest level (SDiv 1). The mesh must be a regular subdivision: all quads from Catmull-Clark subdivision (Blender's Subdivision Surface, Maya's Smooth, ZBrush's Divide), or all triangles from Loop subdivision. Otherwise it says so and leaves the mesh alone. The vertices of the new lower level sit on the dense mesh's corner vertices, as in ZBrush. Tip: The Cube from Tool > 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, Del Lower, Del Higher and Reconstruct are single undo steps. Steps share the levels they didn't change, so they cost little memory. Projects (.sfproj) save every level of every 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 Send to ZBrush 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 (as in ZBrush), so step to the level you want to keep first, or save before. Note: Subdivide (in Tool > Geometry, below Divide) is still there: it replaces the mesh with a denser one and keeps no levels. Use Divide unless you want exactly that."},{"p":"subdivision-levels.html","c":"Subdivision levels","a":"commands","h":"Commands","t":"Every control is a command you can run in the console, from a script or over MCP (see Scripting): Command What it does subdiv_divide smooth=true Divide; smooth=false divides flat (Smt off) subdiv_level level=2 Step to a level (1 = base) subdiv_lower, subdiv_higher Lower Res, Higher Res subdiv_delete_lower, subdiv_delete_higher Del Lower, Del Higher subdiv_reconstruct Reconstruct Subdiv subdiv_info List the levels and their triangle counts subdiv_export path=base.obj level=1 Export the visible 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. ZBrush: Divide, Smt, Lower Res, Higher Res, SDiv, Del Lower, Del Higher and Reconstruct Subdiv work as in ZBrush. Not yet: Freeze SubDivision Levels, Cage, Rstr, Suv (UV smoothing on divide) and creased edges."},{"p":"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) ZBrush: HD Geometry also goes past the subdivision levels, but you sculpt it one small region at a time. A micro level is the whole model, all the time: every brush stroke, every view, every Part at once."},{"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 sharpen the height profile instead of pulling points together (the result looks the same for creases and folds). 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 ZBrush's Sculptris Pro and Blender's Dyntopo do. Pull a sphere out into horns, ears or fingers and the new shapes get triangles of their own instead of stretched ones; block in a creature from a ball without remeshing first. A sphere with horns pulled out by 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 (ZBrush's Sculptris Pro button) 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, as in ZBrush. 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 Sculptris Pro: zoom in or make the brush smaller for finer triangles, zoom out or make it bigger for coarser ones. At Detail 50 an edge is about an eighth of the brush radius; Detail 100 makes them about three times smaller, Detail 0 three times bigger. With Constant detail on, every stroke aims for the same size whatever the zoom and brush, set by Detail relative to the size of the mesh (at 50, about a hundredth of its bounding box diagonal). Use it to bring a whole model to an even density, or to keep the density while you change brush sizes. It is a preference: Store Config (Ctrl+Shift+I) keeps it. Under the brush, edges longer than the target are split, edges much shorter are merged away, and the new triangles are evened out. Outside the brush nothing changes, so you can have big triangles on the back of a head and fine ones around the eyes."},{"p":"dynamic-topology.html","c":"Dynamic topology","a":"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 Sculptris Pro. 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 (Store Config keeps it) 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, as in ZBrush. On a Part with levels, Dynamic stays off and the status bar says why: go to the level you want to keep and use Del Lower and Del Higher in Tool > Geometry first. If you turn it on and then pick a Part that has levels, strokes sculpt it without remeshing. 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 Coming from ZBrush"},{"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 header shows the step you are at, the number of branches and the step's name. Save with project keeps the history with the project, the film icon exports a timelapse, 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":"Tick Save with project in the strip's header 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 like ZBrush's Gizmo 3D, 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 Mask Lasso). 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 (ZBrush's Transpose All), for example to turn a whole character with its eyes, teeth and clothes. The pivot is the centre of all of them. Each Part gets its own undo step: undo goes back in the active Part, and selecting another Part undoes its part."},{"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. Sculpt layers move with the surface: the base and every layer's offsets are transformed together, so a layer you sculpted on a forearm stays on it after posing, and layer sliders keep working. With subdivision levels you can pose at a low level: the detail of the higher levels, sculpt layers included, turns with it when you step back up. Projects save the result, and the gizmo's pivot and options too."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo)","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 (Transpose All)"},{"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 ZBrush (Send to ZBrush), Blender or Maya (OBJ, FBX, PLY, USD) keeps its quads: Wire draws them as quads, without the diagonal, and OBJ, FBX, PLY, USD and GoZ-compatible 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. ZBrush: Besides keeping the quads you bring in, SculptForge can make new ones from any mesh: Quad Remesh (like ZRemesher) builds quads with flowing edge loops. See Quad retopology."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"subdivide","h":"Subdivide","t":"For sculpting at several resolutions use Divide (Ctrl+D), which keeps the lower levels to step back to: see Subdivision levels. Subdivide is the one-way version. Tool > Geometry > Subdivide smooths the mesh with Loop subdivision. Each level multiplies the triangle count by four and rounds off the shape slightly, like ZBrush's Divide with Smt on. Sculpt layers are subdivided with the mesh, so blend shapes keep working. Mask, 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, like ZBrush's DynaMesh. Use it to: fuse overlapping pieces into one surface (append a sphere, overlap it, merge, remesh); even out stretched triangles after heavy Move or 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 (64 to 400 in the palette, default 200). Higher keeps more detail and makes more triangles. Wireframe of a model before and after a voxel remesh What happens to your data: Sculpt layers are baked into the surface: the result has no layers. Mask and 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. ZBrush: There is no Project option, Groups-aware remesh or Blur slider yet. Like ZBrush's DynaMesh, the remesh produces an even grid of quads, not flowing edge loops. For quads with edge loops that follow the forms, use Quad Remesh (like ZRemesher), and Project All to get the detail back."},{"p":"geometry.html","c":"Subdivide, remesh, decimate and LODs","a":"quad-remesh","h":"Quad Remesh","t":"Tool > Geometry > Quad Remesh is automatic quad retopology, like ZBrush's ZRemesher: 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 All (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 same family of algorithm as ZBrush's Decimation Master). The Keep slider next to the button sets the fraction of triangles to keep (0.05 to 0.95, default 0.50). Decimation keeps open borders in place, and because it only removes vertices, every remaining vertex keeps its exact sculpt layer offsets, mask and 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":"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 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_polypaint, 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 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 All 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. ZBrush: this covers what the trim, clip and slice curve brushes and Live Boolean are used for, as one tool. SculptForge is not affiliated with Maxon or ZBrush."},{"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, like ZBrush's ZRemesher. Project All then moves a mesh onto the surface of other Parts, so the detail of the original sculpt comes back onto the new topology, like ZBrush's Project All. Together they turn a dense, messy sculpt (a voxel remesh, a scan, an AI-generated model) into a light quad mesh you can divide, sculpt on, unwrap and animate. A lion bust after 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 All 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 All. Off: the Part is replaced, as in ZBrush (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 GoZ-compatible 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 "},{"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 ZBrush's ZRemesher 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-all","h":"Project All","t":"Tool > Parts > Project > Project All 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 All 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) PA Blur Smooths the projected result this many times, to soften noise from the source Mean Where there is surface on both sides of a vertex, settle halfway between them instead of on the nearest Geometry Project the shape (into the active sculpt layer, if you have layers) 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 All 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 All, divide again, Project All. 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_polypaint, symmetry (x, y or z; off by default in scripts; the mirror plane is found from the model), symmetry_center (use this plane instead, e.g. 0 for the world's centre), keep_original, smooth (relaxation passes, default 6), seed (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), polypaint (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; subtool_visibility index=1 visible=true; project_all distance=0.02; export_fbx path=retopo.fbx' sculptforge-cli -c 'open path=head.glb; qremesh_guide points=\"0.2,0.3,2 0.3,0.4,2 0.4,0.3,2 0.3,0.2,2 0.2,0.3,2\" view=0,0,-1 symmetry=x; qremesh target=4000 symmetry=x curves_strength=70' From scripts qremesh runs straight away (it doesn't return until it's done); in the app the button runs it in the background."},{"p":"retopology.html","c":"Quad retopology and detail projection","a":"see-also","h":"See also","t":"Subdivide, remesh, decimate and LODs: voxel remesh first to fuse pieces, subdivide after 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. ZBrush: ZBrush has no built-in image-to-3D. The closest workflow is blocking out a base mesh by hand with DynaMesh or Forge Spheres; here you get a starting shape in seconds and refine it with the usual brushes."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"open-the-generate-3d-window","h":"Open the Generate 3D window","t":"Any of these opens it: Drop an image file (PNG, JPG, BMP, TGA, PSD or GIF) onto the SculptForge window. The image is loaded as the picture for the From image tab and the window opens. Open 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. 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 Hunyuan3D 3.1 Rapid (Tencent) Meshy Meshy's own text-to-3D model ComfyUI The text workflow you choose (the bundled text-to-3d uses FLUX.1 schnell and Hunyuan3D 2.1)"},{"p":"generate-3d.html","c":"Image and text to 3D","a":"services","h":"Services","t":"Service Cost and setup Good for Hugging Face - free models Free, no account. A free token raises the daily allowance Trying things out, personal work fal.ai - paid, your key Paid per generation, needs a fal.ai key Reliable capacity, newer models Meshy - paid, your key Paid, needs a Meshy key Meshy's own models ComfyUI - your server Free, runs on your own GPU or a studio server Privacy, custom workflows, studios My generator command Free, any program you run locally Your own model or a studio service Offline blockout (inflate silhouette) Free and instant, no network Simple shapes, a quick start"},{"p":"generate-3d.html","c":"Image and text to 3D","a":"hugging-face-free","h":"Hugging Face (free)","t":"This runs each model author's own public demo on Hugging Face's shared ZeroGPU hardware. Pick a Model: Model Notes Hunyuan3D 2.1 (Tencent) The default. Detailed shapes, about 20 seconds, 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-and-meshy-paid","h":"fal.ai and Meshy (paid)","t":"fal.ai: choose a Model (TRELLIS.2, Hunyuan3D 3.1 Pro, Hunyuan3D 3.1 Rapid or Meshy 6) or type any fal model id into Model id. Paste your key from fal.ai/dashboard/keys into API key, or set FAL_KEY. Meshy: paste your key from meshy.ai (API settings) into API key, or set MESHY_API_KEY. Generations are billed to your account with that service. Errors such as \"The API key was rejected\", \"Out of credits on this account\" or \"Rate limited\" come from the service."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"comfyui-your-own-server","h":"ComfyUI (your own server)","t":"Runs any ComfyUI workflow on your own computer or a studio GPU server, with whatever models it has. Nothing is sent anywhere else. Start ComfyUI. It listens on http://127.0.0.1:8188 by default. If SculptForge runs on another computer, start ComfyUI with --listen (only on a network you trust: ComfyUI has no login). Install the models your workflow needs. The bundled Hunyuan3D 2.1 workflow needs hunyuan_3d_v2.1.safetensors in ComfyUI/models/checkpoints. In Generate 3D, pick ComfyUI - your server, enter the Server address and click Test connection. A good answer looks like \"Connected: ComfyUI 0.42.0 - NVIDIA GeForce RTX 4090 (24.0 GB)\". Choose a Workflow: a bundled one, or Other file (API format)... for your own. Click Generate 3D model. The progress bar shows your place in ComfyUI's queue. Bundled workflows: Workflow Tab Needs hunyuan3d-image-to-3d From image The Hunyuan3D 2.1 checkpoint (7.4 GB) and a GPU with about 10 GB of memory text-to-3d From text FLUX.1 schnell, BiRefNet and Hunyuan3D 2.1 (about 25 GB of downloads) and a GPU sculptforge-inflate From image The ComfyUI-SculptForge node pack; no GPU. A quick blockout to check your setup Your own workflows must be saved in ComfyUI's API format (in ComfyUI: Workflow > Export (API)). To tell SculptForge where the inputs go, give nodes these titles: Node title What SculptForge does sf_image Puts the uploaded picture into this Load Image node. Without one, the first Load Image node is used sf_prompt Puts your description into this node's text, prompt or string input. Without one, the first CLIP Text Encode not titled \"negative\" is used sf_seed Sets the seed. Inputs named seed or noise_seed get it too SculptForge imports the first mesh file the workflow saves (Save GLB, Preview 3D and most 3D node packs work). For error messages and their fixes, see Troubleshooting."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"my-generator-command","h":"My generator command","t":"Runs any command line on your computer: a local open-source model, a studio service, or a script that calls a cloud API. Type the command into the box. It must contain {input} (replaced with the image path) and {output} (replaced with the path to write, ending in .glb). Both are quoted for you, so don't add quotes. The command must write a GLB file to {output} and exit with status 0. The box starts with a command that runs SculptForge's own silhouette inflation, which is a quick way to check that the pipeline works: sculptforge-cli --set input={input} --set output={output} -c 'image_inflate path=$input subdivisions=2; export_glb path=$output' A wrapper for your own model can be as small as this: # my_generator.py {input} {output} import sys image_path, output_path = sys.argv[1], sys.argv[2] # load your model, run it on image_path, write a .glb to output_path Keep API keys in environment variables that your script reads, not in the command line."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"offline-blockout","h":"Offline blockout","t":"Offline blockout (inflate silhouette) inflates the outline of the picture into a rounded, closed mesh. It is instant and needs no network, but it is a puffy blockout, not a reconstruction: fine for simple shapes, not for characters."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"save-your-settings","h":"Save your settings","t":"Save settings (the small button under Generate 3D model) stores the service, model, keys, token, ComfyUI address and generator command in your ai.json settings file, so they are set the next time you start SculptForge. Keys in ai.json are readable only by your user account. See where settings live."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"quick-shapes-from-an-image-offline","h":"Quick shapes from an image (offline)","t":"The From image tab also has three offline tools under Quick shapes (offline). They need no network and run instantly. The same tools are in 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' # 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 All 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 All 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 All 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). ZBrush and Substance call these the max frontal and rear distances Padding Texels around each UV island filled with the island's edge colours, so seams don't show once an engine mipmaps the map. 8 suits 2K; use 16 for 4K and 8K OpenGL / DirectX The normal map's green channel convention (see above) AO rays, AO reach Ambient occlusion quality, and how far away geometry still darkens a point (a percentage of the model's size) Output folder Where the files go. Empty: beside your last export, else the project's folder, else Bakes in your library folder. Open Folder shows it after a bake EXR displacement Also write the displacement as a 32-bit float EXR"},{"p":"baking.html","c":"Baking normal and displacement maps","a":"how-the-bake-works","h":"How the bake works","t":"For every texel of the low-poly's UVs, SculptForge finds the matching point on the low-poly and casts a ray along its smoothed normal, from Front outside the surface to Rear inside it (a \"cage\"), and keeps the high-poly hit nearest to the low-poly. The normal, distance, occlusion and colour found there go into the maps. Rays follow the smoothed normals, so hard edges of the low-poly don't leave gaps. Missing detail (\"x% of texels found no surface\" in red under the Bake button): rays didn't reach the high-poly. Turn off Auto distance and raise Front and Rear. Detail from the wrong place (for example the inside of an ear showing on its back): the rays reach too far. Lower Rear (or Front), or bake the parts from separate 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 ZBrush."},{"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=polygroups 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: subtool_select name=Body_low; bake source=Body maps=normal,ao,displacement size=4096 out=maps The command runs in the foreground (scripts wait for it); the Bake button runs the same bake in the background. See Scripting and automation."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"","h":"Exporting, Unreal and ZBrush","t":"This chapter covers getting your sculpt out of SculptForge: the export formats and what each one keeps, LOD chains for games, sending a mesh straight into a running Unreal Editor, and exchanging models with ZBrush with Send to ZBrush. 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 ZBrush","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, ZBrush ZBrush GoZ-compatible (.GoZ) File > Send to ZBrush > Export GoZ-compatible file... Quads, face groups, mask, vertex paint, UVs, the painted texture as a PNG beside it ZBrush STL (.stl) File > Send to ZBrush > 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 GoZ-compatible 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 ZBrush","a":"scale-and-axes","h":"Scale and axes","t":"glTF, USD and OBJ are written Y-up with 1 unit = 1 metre, the same space you sculpt in. FBX uses centimetres: export_fbx multiplies positions by 100 by default (scale=), so 1 unit = 1 m. STL is written in millimetres with Z up, as slicers expect: a 0.3 m sculpt prints 300 mm tall, standing upright. export_stl height_mm=80 scales it to a print height instead (see 3D printing). Opening an STL converts back, so a downloaded print model comes in upright and at its real size. STL files from SculptForge 0.5 and earlier (metres, Y up) are recognised and open as they were saved. PLY keeps positions as they are (no unit conversion). For Unreal, Height sets the real-world size directly (see below)."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"export-a-model","h":"Export a model","t":"Show the 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 ZBrush","a":"3d-printing","h":"3D printing","t":"File > Send to ZBrush > 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 ZBrush","a":"lod-chains-for-games","h":"LOD chains for games","t":"A LOD (level of detail) chain is the same model at decreasing triangle counts, so an engine can draw distant objects cheaply. SculptForge builds it with quadric decimation, keeping blend shapes on every level. Open Tool > Export. Set LODs (2 to 6 levels, including LOD0) and Reduction (0.1 to 0.9: the triangle ratio from one level to the next, default 0.5). Click Generate LOD chain. A table lists each level with its triangle count and its share of LOD0. Click a level (LOD0, LOD1 ...) to inspect it in the viewport; the wireframe turns on. Click Sculpt to go back to the editable mesh. Export with LOD chain (GLB per level), or send it to Unreal (below). Changing the sliders clears the preview; click Generate LOD chain to build it again. The LOD chain export writes _LOD0.glb, _LOD1.glb and so on next to the path you choose. With several visible 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 ZBrush","a":"send-to-unreal","h":"Send to Unreal","t":"Send to Unreal exports an Unreal-ready FBX and imports it into a running Unreal Editor (5.x) on this computer or another one on your network. Nothing is installed into your project: it uses Unreal's built-in Python remote execution. Your sculpt What arrives in Unreal No sculpt layers A static mesh SM_ with the LOD chain from Tool > Export Sculpt layers A skeletal mesh SK_ with one morph target per layer (Unreal adds a single root bone) Several visible 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 ZBrush","a":"one-time-setup-in-unreal","h":"One-time setup in Unreal","t":"Edit > Plugins: enable Python Editor Script Plugin, then restart the editor. Edit > Project Settings > Plugins > Python: tick Enable Remote Execution?. That's all when Unreal runs on the same computer."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"send","h":"Send","t":"Open Tool > Export and find the Unreal Engine section. Set Folder (the content folder, default /Game/SculptForge) and Height (the model's height in Unreal, in centimetres; it starts at the model's current height with 1 unit = 1 m). For a static mesh, set LODs and Reduction above (default 4 levels). Click Send to Unreal, or press Ctrl+U. The status line reports the result. The line under the buttons tells you what will be sent: \"Static mesh with 4 LODs\" or \"Skeletal mesh with 2 morph targets\"."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"unreal-on-another-computer","h":"Unreal on another computer","t":"On the Unreal machine, in Project Settings > Plugins > Python, open Advanced and set Multicast Time-To-Live to 1 and Multicast Bind Address to 0.0.0.0. In SculptForge, tick Unreal is on another computer. Both computers must be on the same network, and the SculptForge computer's firewall must allow incoming connections from the Unreal machine: the editor connects back to SculptForge to fetch the file."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"import-by-hand","h":"Import by hand","t":"Export FBX for Unreal... (in the File palette and in Tool > Export) writes the same file. The file name becomes the asset name. Drag it into the Content Browser: static meshes pick up their LODs from the file's LOD group; for skeletal meshes choose Skeletal Mesh and tick Import Morph Targets."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"from-scripts","h":"From scripts","t":"sculptforge-cli -c 'open path=statue.obj; unreal_send destination=/Game/Props height_cm=200 lods=4' sculptforge-cli -c 'unreal_editors network=true' # list editors on the network sculptforge-cli -c 'open path=statue.obj; export_unreal folder=out height_cm=200' unreal_send also takes name=, project= (pick one editor when several are open) and network=true. Note: Layered sculpts are sent as skeletal meshes without the LOD chain, because Unreal's morph targets need a skeletal mesh (Unreal can generate skeletal LODs itself). The Unreal link has been tested against a stand-in editor that speaks the same protocol but not yet against every Unreal version. If an import fails, Unreal's Output Log shows the importer's messages."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"exchange-models-with-zbrush-send-to-zbrush","h":"Exchange models with ZBrush (Send to ZBrush)","t":"SculptForge reads and writes ZBrush's GoZ format and can talk to a running ZBrush through the Send to ZBrush on Windows and macOS. The commands are in File > Send to ZBrush: Item What it does Send to ZBrush Writes every visible Part to the shared bridge folder and tells ZBrush (starting it if needed). Each Part arrives as its own ZBrush SubTool. Turns on Receive automatically Receive from ZBrush Loads what ZBrush 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 from ZBrush and receives it Custom bridge folder (optional) Use another bridge folder, for example inside a Wine prefix Import GoZ-compatible file... Opens a .GoZ file, replacing the scene Export GoZ-compatible file... Writes a .GoZ file. With several visible Parts, one file per Part next to the path Export STL... Writes a binary STL of the visible Parts The default bridge folder is C:\\Users\\Public\\Pixologic on Windows and /Users/Shared/Pixologic on macOS. ZBrush doesn't run on Linux, so there the bridge needs a custom folder; GoZ-compatible files still import and export."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"a-round-trip","h":"A round trip","t":"In SculptForge, choose File > Send to ZBrush > Send. ZBrush starts or comes forward with the Parts. If ZBrush was not running and does not import them, press GoZ in ZBrush. Work in ZBrush, then press GoZ there to send the model back. SculptForge receives it automatically and updates the matching Parts. Each update is an undo step on that Part. The bridge keeps face groups, mask, vertex paint and UVs. Quads from ZBrush stay quads: Wire shows them as quads, and they go back to ZBrush as the same quads. The format has no hidden-face flag, so hidden faces are sent like any others. ZBrush: SculptForge can't read ZBrush's own .ZTL and .ZPR files (they are proprietary and undocumented). Bring models over with Send to ZBrush, export OBJ or FBX from ZBrush, or convert your ZTools once with the SculptForge ZTL Export plug-in for ZBrush, after which SculptForge opens the .ZTL itself (see Coming from ZBrush). Subdivision levels don't come across: SculptForge receives the mesh at the level you sent. Note: Send to ZBrush follows the format of the open-source Blender GoZ add-on (GoB) and is tested with files, but has not yet been tested against a live ZBrush. If a send does not arrive, export a .GoZ file and import it in ZBrush by hand, and please report it (Help > Report a problem). From scripts: goz_export path=, goz_import path=, goz_send, goz_receive and export_stl path= (see 3D printing for its options)."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","a":"blender","h":"Blender","t":"To sculpt Blender objects in SculptForge and send them back into the same objects, use the SculptForge Bridge add-on and File > Blender: see Working with Blender. For a one-off exchange, OBJ, FBX and glTF all carry Parts, UVs and quads both ways."},{"p":"exporting.html","c":"Exporting, Unreal and ZBrush","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 ZBrush","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 like ZBrush's GoZ between ZBrush and other apps, on Linux, Windows and macOS, with Blender 4.2 or newer."},{"p":"blender.html","c":"Working with Blender","a":"install-the-add-on","h":"Install the add-on","t":"Download sculptforge_bridge.zip from the latest release (or the SculptForge website). In Blender choose Edit > Preferences > Get Extensions, open the menu at the top right and choose Install from Disk..., then pick the zip. (You can also drag the zip into Blender's window.) The SculptForge tab appears in the 3D View's sidebar (press N). Send and Receive are also in the Object menu and in File > Import / Export. Start SculptForge once after installing it: it records where it is installed, so the add-on can start it for you. If the add-on still can't find it (for example an AppImage you keep somewhere unusual), set its path in the add-on's preferences (Edit > Preferences > Add-ons > SculptForge Bridge). Tip: Older Blender versions or a classic add-on install: sculptforge_bridge--legacy.zip installs through Edit > Preferences > Add-ons > Install from Disk. The add-on needs Blender 4.2 or newer either way."},{"p":"blender.html","c":"Working with Blender","a":"a-round-trip","h":"A round trip","t":"In Blender, select one or more mesh objects and click Send to SculptForge in the SculptForge tab. SculptForge starts, or, if it's already open, loads them within a second. Each object becomes a 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":"zbrush-style-keys-in-sculpt-mode","h":"ZBrush-style keys in Sculpt Mode","t":"Sculpting in Blender too? Turn on ZBrush-style keys in Sculpt Mode in the add-on's preferences (Edit > Preferences > Add-ons > SculptForge Bridge) and Blender's Sculpt Mode answers to ZBrush's keys where Blender has the same thing. Turning it off removes them again, and Blender's own keys are back; so does disabling the add-on. The preferences list every key while it's on. ZBrush key In Blender's Sculpt Mode S / U / O Draw Size / 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 ZBrush brush name (Standard, DamStandard, Clay, ClayBuildup, Move, SnakeHook...): 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) ZBrush's brushes map to Blender's closest: Standard = Draw, DamStandard = Draw Sharp, ClayBuildup = Clay Strips, Move = Grab, Move Elastic = Elastic Grab, TrimDynamic = Trim (Scrape in Blender 4.2), Crease = Crease Sharp, MaskPen = Mask. What Blender has no key for, or can't do the ZBrush way: I (RGB Intensity): Blender's sculpt brushes don't paint. Ctrl+drag on the model doesn't paint the mask with a round brush: Blender can't switch to the Mask brush for one stroke, so it draws a mask lasso (pick the Mask brush with B to paint it). Dragging on the empty background doesn't rotate: a keymap can't tell the model from the background. Use the middle mouse button, or Blender's Emulate 3 Button Mouse. Ctrl+click on the background (invert or clear the mask) and Ctrl+Shift+click (show all): use Ctrl+I, Alt+M and Alt+H. B then two letters: a Blender menu takes one key at a time, so B opens the list and the letters filter it. Alt+click a 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 .GoZ files (the format SculptForge also uses with ZBrush) with a small list of the objects, and checks the other side's list once a second. Nothing goes over the network. To use another folder, set it in the add-on's preferences and start SculptForge with the environment variable SCULPTFORGE_BLENDER_EXCHANGE set to the same folder. From scripts and the MCP server: blender_send and blender_receive (both take folder=). Starting SculptForge with --blender loads what Blender last sent."},{"p":"blender.html","c":"Working with Blender","a":"limits-and-troubleshooting","h":"Limits and troubleshooting","t":"Blender as a Flatpak or Snap sees a different user data folder and may not be allowed to start other programs. Set the add-on's exchange folder to a folder both can reach, start SculptForge yourself with SCULPTFORGE_BLENDER_EXCHANGE set to it, and send. Linked duplicates (objects sharing one mesh) all show the last one received. Shape keys: the Basis and the keys named like SculptForge's layers are updated; other keys keep their shapes. Subdivision levels don't go to Blender: it receives the level you're on (like ZBrush's GoZ). Sculpt layers arrive as shape keys (Basis plus one key per layer, with its name and weight), so the 52 facial shapes keep their ARKit names. Shape keys don't come back from Blender, and textures stay in SculptForge. Nothing arrives in SculptForge? Check File > Blender > Receive automatically, or choose Receive from Blender. Nothing arrives in Blender? Click Receive from SculptForge; automatic receiving starts after the first send from that Blender session. Objects in Edit Mode or Sculpt Mode are updated too: the add-on switches to Object Mode for the update and back."},{"p":"blender.html","c":"Working with Blender","a":"see-also","h":"See also","t":"Exporting, Unreal and ZBrush: files, game engines and Send to ZBrush 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 like ZBrush's GoZ between ZBrush and other apps, 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."},{"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 and Folder. The script uses plain maya.cmds and Maya's own OBJ exporter; 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)."},{"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. In SculptForge choose File > Maya > Get from Maya. 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. Choose File > Maya > Send to Maya. Every visible Part goes. In Maya click Get. 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. Get automatically (in File > Maya, off by default) loads what Maya sends as soon as it arrives: SculptForge checks the folder's manifest once a second."},{"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. 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, Draw Size, Intensity (and Smooth's), RGB 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. ZBrush: A .sfproj is the equivalent of a ZBrush project (.ZPR), and saving a single Part scene is close to saving a .ZTL. SculptForge can't read .ZPR files, and opens a .ZTL only after the ZTL Export plug-in converted it in ZBrush; otherwise bring models over with Send to ZBrush or as OBJ, FBX or GLB."},{"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 ZBrush-style 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 the window title starts with *. Any edit in any Part counts, as do splat edits and layer weight changes. If you opened a model file (an OBJ, say) rather than a project, Save asks where to save a new .sfproj; the original model file is left alone."},{"p":"projects.html","c":"Projects, autosave and 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 ZBrush-style layout's title strip) saves a timestamped copy of the whole scene (ZBrush users: 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 ZBrush-style 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 MatCaps 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, then Store Config (Ctrl+Shift+I) to keep the setting. 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 Store Config 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 MCP setup. ZBrush: The console plays the role of ZBrush's ZScript window, and Copy session as script is a macro recorder. The language is much simpler than ZScript: one command per statement, with named parameters."},{"p":"scripting.html","c":"Scripting and automation","a":"the-script-language","h":"The script language","t":"A script is a list of statements. Each statement is a command name followed by name=value parameters: new_sphere subdivisions=5 subdivide levels=1 remesh resolution=256; decimate ratio=0.5 # two statements on one line export_glb path=\"My Sculpts/bust.glb\" The rules: Statements are separated by new lines or by ;. # starts a comment that runs to the end of the line (outside quotes). Parameters are name=value with no spaces around =. true and false are booleans; numbers are numbers; anything else is text. Put text in double quotes when it contains spaces, ;, # or \", or when it must stay text even though it looks like a number. Inside quotes only \\\" and \\\\ are escapes, so Windows paths such as \"C:\\Users\\me\\head.obj\" work as written. Colours with a # must be quoted: set_color color=\"#d9a07a\". Paths are UTF-8. Relative paths are relative to the current folder of the program running the script. Scripts stop at the first command that fails."},{"p":"scripting.html","c":"Scripting and automation","a":"the-console","h":"The console","t":"Press the backtick key (left of 1), or choose 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, GoZ-compatible 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_polypaint, symmetry, keep_original Parts project_all distance (default 0.02), mean, blur, geometry, polypaint, 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 polygroup_auto_by_normals angle (default 30) Visibility isolate_polygroup, hide_polygroup group (required) Visibility show_all, delete_hidden Transform transform translate, rotate, scale, pivot, orient, masked, falloff, symmetry, all (Gizmo) Parts subtool_append type (sphere, cube, plane) or path, name, size Parts subtool_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, --polygroups 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.subtools) # [{'name': ..., 'visible': ..., 'triangles': ...}] doc.active_subtool = \"Helmet\" # select by index or name for name, weight in doc.layers: # sculpt layers (blend shapes) print(name, weight) print([c[\"name\"] for c in sf.commands()]) # every command with its parameters Function or property What it does sf.run(doc, command, **params) Runs one command and returns its message sf.run_script(doc, script) Runs a script in the syntax above and returns the messages sf.commands() Lists every command with its parameters sf.tool_schema() The commands as LLM tool definitions (JSON) doc.vertices, doc.base_vertices, doc.normals, doc.triangles Mesh arrays of the active Part (copies) doc.mask, doc.colors, doc.polygroups, doc.hidden Attribute arrays you can read and assign (None if absent) doc.layers, doc.layer_delta(i) Sculpt layers as (name, weight) and their per-vertex offsets doc.subtools, doc.active_subtool The 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":"sculptforge-cli --mcp runs SculptForge as an MCP server. An AI agent (Claude Code, Claude Desktop or any MCP client) gets every command as a tool and works on one scene for the session: it can open files, generate models, sculpt strokes, remesh, paint and export. Claude Code: claude mcp add sculptforge -- /path/to/sculptforge-cli --mcp Claude Desktop or another client: add a stdio server whose command is the full path to sculptforge-cli and whose argument is --mcp. For Claude Desktop that is an entry in its configuration file like this: { \"mcpServers\": { \"sculptforge\": { \"command\": \"/path/to/sculptforge-cli\", \"args\": [\"--mcp\"] } } } Then ask for something like \"make a sphere, remesh it at 128 and export it to ~/Desktop/ball.glb\". File paths are on your machine. The agent works headless; to see the result, open the exported file in SculptForge. sculptforge-cli --schema prints the same tool definitions as JSON, for wiring SculptForge into your own agent."},{"p":"scripting.html","c":"Scripting and automation","a":"see-also","h":"See also","t":"The interface: the command palette and Ctrl-hover help For studios: Rez, the VFX builds and farm rendering Image and text to 3D and Exporting: the commands in context Keyboard and mouse reference"},{"p":"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 the monthly pack or an Insider drop. 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. Store Config keeps the result."},{"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 MatCaps 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 the monthly pack or an Insider drop. 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/, matcaps/, 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 ZBrush; 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 and licensing."},{"p":"studios.html","c":"SculptForge for studios","a":"vfx-reference-platform-builds","h":"VFX Reference Platform builds","t":"SculptForge tracks the VFX Reference Platform. Every commit is built and tested in the platform's reference environments: CY2026 CY2027 SculptForge Linux compiler GCC 14.2 GCC 14.2 Built and tested with gcc-toolset-14 glibc 2.28 (EL8) 2.34 (EL9) Rocky Linux 8 and 9 builds; CI checks that no newer glibc symbols are used C++ C++20 C++20 C++20 Python 3.13 3.13 The sculptforge module is built and tested against 3.13 Windows VS 2022 17.6+ VS build tools 14.44+ Visual Studio 2022 macOS minimum 14.0 14.0 Universal binary with deployment target 11.0 FBX 2020.x 2020.x Writes FBX 7.4 binary, which FBX SDK 2020 reads SculptForge doesn't depend on Qt, OpenEXR, Boost, TBB or other platform libraries, so it can't conflict with the versions your other tools load. Its few dependencies (SDL3, Dear ImGui, GLM, ufbx) are linked into the binaries. Each release includes SculptForge--linux--vfx2026.tar.gz (Rocky 8, glibc 2.28) and ...-vfx2027.tar.gz (Rocky 9, glibc 2.34), for x86_64 and ARM64, with the Python module under lib/sculptforge/python."},{"p":"studios.html","c":"SculptForge for studios","a":"deploy-with-rez","h":"Deploy with Rez","t":"packaging/rez/package.py in the source tree builds and installs a Rez package: cd packaging/rez SCULPTFORGE_PYTHON=$(which python3.13) rez-build --install # or --release for your release repository rez-env sculptforge -- sculptforge # the app rez-env sculptforge -- sculptforge-cli --list # every pipeline command rez-env sculptforge python-3.13 -- python -c \"import sculptforge\" The package puts bin/ on PATH and the Python module on PYTHONPATH, and sets SCULPTFORGE_ROOT. The Python module is built for the first python3 found unless SCULPTFORGE_PYTHON names an interpreter."},{"p":"studios.html","c":"SculptForge for studios","a":"studio-brush-libraries","h":"Studio brush libraries","t":"Each artist's own brushes live in their user brush library, one .sfbrush file per brush (see Brush Lab and sharing brushes). To give a whole team the same brushes, put .sfbrush files on a share and list it in SCULPTFORGE_BRUSH_PATH: export SCULPTFORGE_BRUSH_PATH=/studio/brushes:/show/troll/brushes # ';' between folders on Windows sculptforge-cli -c 'brush_library' # every brush, where it comes from and its file, plus the folders The app, sculptforge-cli and the Python module load these folders at start-up, read-only: SculptForge never writes into them, so the share can be mounted read-only. Studio brushes show a studio tag in the Custom brushes list. When brushes share a name, the artist's own wins over a studio one, which wins over a built-in. Among studio folders, the first one listed wins. Refining a studio brush in Brush Lab saves the artist's own version (tagged yours) without touching the share. Deleting that version brings the studio brush back. To publish a brush, copy its .sfbrush file into the share: right-click it in the Custom brushes list > Save .sfbrush..., or take it from an artist's user library. With Rez, set the share once for everyone: when SCULPTFORGE_STUDIO_BRUSHES is set as the package resolves (in a site package, your rezconfig or the launcher), it is appended to SCULPTFORGE_BRUSH_PATH. export SCULPTFORGE_STUDIO_BRUSHES=/studio/brushes rez-env sculptforge -- sculptforge"},{"p":"studios.html","c":"SculptForge for studios","a":"environment-variables","h":"Environment variables","t":"Variable Effect 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 SCULPTFORGE_BRUSH_PATH Read-only studio brush folders (:-separated, ; on Windows) SCULPTFORGE_STUDIO_BRUSHES With the Rez package: appended to SCULPTFORGE_BRUSH_PATH SCULPTFORGE_BRUSH_GALLERY Use another community brush gallery index (a URL or a folder), for example an in-house mirror HF_TOKEN (or HUGGING_FACE_HUB_TOKEN) Hugging Face token for the free image-to-3D models FAL_KEY, MESHY_API_KEY Keys for the paid generation services ANTHROPIC_API_KEY, OPENAI_API_KEY Keys for Brush Lab providers XDG_DATA_HOME (Linux), APPDATA (Windows) Move the settings folder (see where settings live) Keys from the environment are used when none is saved in the app, so a launcher can supply them without writing them to each artist's settings."},{"p":"studios.html","c":"SculptForge for studios","a":"headless-and-farm-use","h":"Headless and farm use","t":"sculptforge-cli runs every editing operation without a display: imports, remeshing, decimation, LOD chains, FBX, USD and glTF export, splat conversion and AI generation. See Scripting and automation. sculptforge --render out.png --turntable 8 renders review images and turntables offscreen. It needs an OpenGL 3.3 context; on a headless Linux node, run it under Xvfb. sculptforge-cli --mcp exposes the same operations to AI agents through the Model Context Protocol. import sculptforge gives Python the same commands plus NumPy arrays of the mesh, for your own tools. A typical farm job turns incoming scans into game-ready assets: sculptforge-cli --set in=/ingest/scan_042.ply --set usd=/assets/scan_042.usda --set glb=/assets/scan_042.glb -c ' open path=$in splat_transform rotate_x=180 fit=true splat_clean splat_to_mesh detail=320 preset=game color=texture export_usd path=$usd export_lods path=$glb levels=4 ratio=0.5 ' A --set variable replaces a whole value, so pass complete paths (with their extensions) as variables."},{"p":"studios.html","c":"SculptForge for studios","a":"formats-in-a-pipeline","h":"Formats in a pipeline","t":"Format Read Write Notes OpenUSD (.usda, .usdz) Yes Yes Meshes, xform ops, Z-up stages, UsdSkel blend shapes, ParticleField Gaussian splats, textures; checked with OpenUSD's validators FBX Yes (any version) Yes (7.4 binary) LOD groups, blend shapes, centimetre units, textures; checked with ufbx's strict mode glTF / GLB Yes Yes Morph targets, vertex colours, KHR_gaussian_splatting, embedded textures; checked with the Khronos validator OBJ Yes Yes Objects as 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) Send to ZBrush (GoZ-compatible exchange) 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 ($300 a month; Founding Studio: the first 10 studios lock in $150 a month for as long as they stay subscribed) covers your whole company, with no seat count: Insider for every artist: the monthly pack, daily drops (a brush, alpha or VDM almost every day), the feature vote and the monthly dev Q&A. Insiders will get each release about two weeks early, starting with SculptForge 1.0. A custom studio build with your presets, keymaps, packs, shelves and pipeline defaults baked in. Custom content: brushes, alphas, VDMs, macros and pipeline presets made for your team. Guided development: your requests go to the front of the roadmap, with a monthly call or async review with the developer. Priority triage: reviewed within 2 business days (no fix-time guarantee). A private team channel on Discord, and your logo on the website and in the README. Every release stays free for everyone; bug-fix and security releases go out to everyone the same day. Larger custom features are quoted separately. Join at sculptforge.app/studios.html."},{"p":"studios.html","c":"SculptForge for studios","a":"studio-onboarding","h":"Studio onboarding","t":"After checkout, email [email protected] from a studio address with the GitHub usernames that should get the private repository (as many artists as you like) and who should join the team channel."},{"p":"studios.html","c":"SculptForge for studios","a":"custom-content","h":"Custom content","t":"Studios can ask for their own content, made to order: Brushes tuned to your style. Alphas and VDMs made from your own references or scans (only material you own). Macros and one-click workflows. Pipeline presets: export settings, naming, scale, axis, texture packing and ZBrush Bridge setup. Keymaps and layouts. All of it is baked into your custom studio build. Up to 5 custom items a month (brushes, alphas, macros or presets); larger features are quoted separately. Your assets stay private to your studio and are never used for anything else."},{"p":"studios.html","c":"SculptForge for studios","a":"requesting-a-custom-build","h":"Requesting a custom build","t":"Send, in one email or a message in your team channel: What to bake in: your exported keymap and layout (Edit > Preferences > Interface), brush presets and packs (.sfbrush, .sfpack), shelf setup, and the pipeline defaults you want (export format and preset, units and scale, up axis, naming pattern, texture packing, ZBrush Bridge folder). 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. Files are treated as data only: scripts and executables you send are never run. Your build is published as a release in the private repository, built by the same pipeline and tests as public builds, with its source (it is GPL like every SculptForge build). Each new release brings an updated studio build."},{"p":"studios.html","c":"SculptForge for studios","a":"guided-development","h":"Guided development","t":"Tell us what your team needs most, in the team channel or on the monthly call (or an async review, if a call doesn't suit your time zone). Studio requests go to the front of the roadmap: each month we agree what comes next, and you see it in preview builds about a week before the release. Requests that are bigger than a normal release's work are quoted separately before anything starts."},{"p":"studios.html","c":"SculptForge for studios","a":"not-yet","h":"Not yet","t":"Planned pipeline features, roughly in order: OpenColorIO viewport display, Alembic export, fuller USD authoring (layers, variants, references, .usdc), UVs and texture baking, multiresolution sculpting. Pipeline requests are welcome as issues on the project's GitHub page."},{"p":"studios.html","c":"SculptForge for studios","a":"see-also","h":"See also","t":"Scripting and automation Exporting, Send to Unreal and ZBrush Brush Lab and sharing brushes Image and text to 3D: running models on your own ComfyUI server Troubleshooting"},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"","h":"Keyboard and mouse","t":"This chapter is the reference for every default keyboard shortcut and mouse gesture in SculptForge. Inside the app, F1 opens the same list as the Controls window, showing your own keys if you've changed any. 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), ZBrush-style, Blender and Maya. The main table shows the SculptForge style; the sections after it list what the ZBrush-style 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. Press Ctrl+Shift+I (Store Config) to keep your changes. See Customizing the interface. On macOS, Cmd works wherever a shortcut says Ctrl. Single-letter shortcuts don't fire while you type in a text field."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"keyboard-shortcuts","h":"Keyboard shortcuts","t":"The table lists the default shortcut of every action 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 (ZBrush DamStandard). 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 Draw Size at cursor S A Draw Size slider under the cursor: drag it, or type a number and press Enter. Falloff at cursor O 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 or I A 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 (ZBrush Rgb on, Zadd off). Alt paints back to white, Shift still smooths. 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 ZBrush's QuickMenu under the cursor: brush, stroke, alpha, material, colour, Draw 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":"preferences","h":"Preferences","t":"Action Keys What it does Load UI... Ctrl+L Load a layout file someone shared (or you saved with Save UI). 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. Save UI... Ctrl+Alt+Shift+I Save the layout, shortcuts and interface preferences to a file you can share. Shelves Tab Hide or show the shelves and trays around the canvas. Store Config Ctrl+Shift+I Keep the current layout, shortcuts and interface preferences for future sessions. Like ZBrush, SculptForge never saves them on its own."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"render","h":"Render","t":"Action Keys What it does Fullscreen F11 Fill the screen with SculptForge (again: back to a window). Mask Ctrl+H 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 (ZBrush PolyFrame)."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"script","h":"Script","t":"Action Keys What it does Console ` The script console: every command you run appears as a script line, and you can type commands yourself."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"stroke","h":"Stroke","t":"Action Keys What it does 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 Ctrl+D Add a subdivision level: four times the polygons, and the lower levels are kept, so you can step down to shape big forms and back up to the detail. Quads stay quads (Catmull-Clark). Smt off divides without smoothing. 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 Masked Ctrl+W Turn the masked part into a new face group and clear the mask (ZBrush Ctrl+W). With nothing masked, everything visible becomes one group. Higher Res D Step one subdivision level up (more polygons, for detail). Edits made below carry the detail along. Invert Mask Ctrl+I Mask what is unmasked and unmask what is masked (also: Ctrl+click the background). Lower Res Shift+D Step one subdivision level down (fewer polygons, for big forms). The detail of the higher levels is kept. Mask All Ctrl+A Mask the whole visible Part. Preview A Show the skin Make Mesh would build instead of the spheres (ZBrush's Preview). Turn it off to edit the spheres again."},{"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). 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). 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. 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 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."},{"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 ZBrush style) 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 Mask Lasso or Mask Rectangle 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) 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 Enable Customize on) Tablet pressure Used automatically when a pen is detected (Pressure > Strength / Pressure > Size) Open files Drop a model (.obj, .glb ...), project, brush (.sfbrush), splat capture or image onto the window"},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"keys-inside-pop-ups-and-panels","h":"Keys inside pop-ups and panels","t":"Some keys only mean something while a pop-up or panel has the keyboard."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"brush-picker-b","h":"Brush picker (B)","t":"Key Action A letter Keep the brushes whose names start with the letters typed so far The 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":"zbrush-style-keys","h":"ZBrush-style keys","t":"With Edit > Preferences > Input > Style on ZBrush-style (also at the top of the Controls window, F1, or ZBrush in the first-start Coming from question), the keys and gestures work as in ZBrush. Store Config (Ctrl+Shift+I) keeps the choice. Compared with the table above, these change: To SculptForge style ZBrush-style 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 (ZBrush's QuickSave) Slider at the cursor on I Intensity (as U) RGB 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 ZBrush-style 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 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 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. Ctrl+Shift+I (Store Config) keeps the keys; Restore Standard UI goes back to the defaults."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"zbrush-keys-that-work-differently","h":"ZBrush keys that work differently","t":"ZBrush's keys and gestures work in SculptForge with the ZBrush-style keys. The few that differ even then, because the feature works differently or doesn't exist yet: ZBrush 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 (Transpose line) The Gizmo (see Gizmo) 1, 2, 3 (replay and record strokes) Not yet N (list the SubTools) 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 ZScript) Export GLB and Send to Unreal H (hide the ZScript window) ` toggles the console See Coming from ZBrush for the whole list."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"see-also","h":"See also","t":"The interface Navigating the view Masking 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. 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 Draw Size: Mesh One dab of a medium brush Turning the view 4 million triangles about 2 ms about 350 frames a second 16 million triangles about 4.5 ms about 170 frames a second 33 million triangles about 7.5 ms about 110 (4x antialiasing), 270 with Fast Navigation Turning the view stays smooth at 100 million triangles: about 50 frames a second with 4x antialiasing, 100 with Fast Navigation. These figures are for closed models (no holes); see \"Closed meshes draw faster\" below. A dab is one step of the brush along the stroke; the app draws several per frame when you move fast. Under 16 ms per dab a stroke keeps up with a 60 Hz display. Very large brushes cost more, since they move more vertices: a brush covering a tenth of a 33 million triangle sphere (about a million vertices per dab with symmetry) takes about 45 ms per dab with Standard, 21 ms with Smooth and 15 ms with Move, of which sending the change to the graphics card is about a third. Performance figures has the full measurements, and how to run the same benchmark on your own machine."},{"p":"performance.html","c":"Performance and big meshes","a":"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 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":"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 last until you quit; Edit > Preferences > Config > Store Config keeps them. Every setting is also in the F3 command palette (type \"antialiasing\", \"fast navigation\" or \"multithreading\")."},{"p":"performance.html","c":"Performance and big meshes","a":"working-with-big-meshes","h":"Working with big meshes","t":"Sculpt at the lowest level that holds the detail. With subdivision levels you can shape the forms a few levels down and only go to the top for fine detail. Each level down is four times lighter. Hide what you're not working on. Hidden 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 > Restore Standard UI (Reset the interface) Sculpting feels slow The viewport is slow Lost work after a crash Recovering work after a crash Want the ZBrush layout back Edit > Preferences > Interface > Look > Layout > ZBrush-style"},{"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. 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":"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, 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. Press Store Config (Ctrl+Shift+I) to keep 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-or-shortcuts-are-gone-after-a-restart","h":"My layout or shortcuts are gone after a restart","t":"Like ZBrush, SculptForge never saves the layout on its own. Press Store Config (Ctrl+Shift+I) to keep the current layout, shortcuts and interface preferences. See The interface."},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes and FAQ","a":"reset-the-interface","h":"Reset the interface","t":"Edit > Preferences > Config > Restore Standard UI returns to the built-in layout and default shortcuts. Press Store Config afterwards to make it stick. Restore Custom UI goes back to what the last Store Config saved. To start completely fresh, quit SculptForge and delete ui.json (layout, shortcuts, interface preferences) and imgui.ini (positions of floating windows such as Brush Lab) from the settings folder below."},{"p":"troubleshooting.html","c":"Troubleshooting: 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 Layout, shortcut changes and interface preferences, written by Store Config imgui.ini Positions and sizes of floating windows ai.json AI settings: providers, models, keys, ComfyUI address (readable only by your account) project.json Recent files and the autosave interval autosave.sfproj The autosaved copy of unsaved work (removed once you save) clean_exit Marks a normal exit; without it, the autosave is offered for restore 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 > Save UI... and Load UI... 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":"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 ZBrush files (.ZTL, .ZPR)? Not directly: they are proprietary and undocumented. Convert ZTools once in ZBrush with the free SculptForge ZTL Export plug-in, then open the .ZTL in SculptForge (see Coming from ZBrush). Or use Send to ZBrush, or export OBJ or FBX from ZBrush (see Exporting, Send to Unreal and ZBrush). .ZPR projects can't be converted; open their ZTools instead. Does it have subdivision levels, DynaMesh, ZRemesher or UVs? Voxel remesh works like DynaMesh, Quad Remesh like ZRemesher (with Project All to bring the detail back; see Quad retopology), Auto UV unwraps any model, and Divide adds subdivision levels you can step up and down (see Subdivision levels). Dynamic on the top shelf is dynamic topology, like Sculptris Pro (see Dynamic topology). Is it really free? Can I sell what I make? Yes and yes. SculptForge is GPL-3.0-or-later free software; the licence covers the program, not your models. The AI models have their own licences (see Image and text to 3D). Does SculptForge send anything about me anywhere? No. There is no telemetry and no account. AI features talk only to the service you choose, when you use them. Does it work offline? Yes. Everything except the hosted AI services works offline, and Brush Lab and image-to-3D can run on local models (Ollama, LM Studio, your own ComfyUI or generator command). Where are my brushes? In the brushes folder in the settings folder above. Brush Lab saves every brush you make or refine there."},{"p":"troubleshooting.html","c":"Troubleshooting: 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). 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 maps ZBrush terms to their SculptForge equivalents, so you can find a familiar tool quickly, and explains the terms that only SculptForge uses. Features use SculptForge's own names (Parts, Forge Spheres, Vertex Paint, Library...); the short list is in Coming from ZBrush, and the command palette (F3) finds every feature by its ZBrush name too. \"Not yet\" means SculptForge doesn't have it today; see the roadmap for what is planned."},{"p":"glossary.html","c":"Glossary","a":"zbrush-terms-in-sculptforge","h":"ZBrush terms in SculptForge","t":"ZBrush SculptForge Alpha Alpha: built-in round, square and noise, or any grayscale image. Left shelf, Sculpt > Alpha. See Sculpting Auto Groups Tool > Face Groups > By pieces (polygroup_by_connectivity) BPR render Not yet as a renderer. Headless renders and turntables with sculptforge --render (Scripting) Brush pop-up (B) Brush picker, B, then type letters (B S T = Standard) Clip brushes Not yet. The Trim brush shaves to a plane Curve brushes, IMM, ZModeler Not yet Decimation Master Tool > Geometry > Decimate (decimate). See Geometry Del Hidden Tool > Visibility > Delete hidden (delete_hidden) Del Lower, Del Higher Tool > Geometry > Del Lower / Del Higher (subdiv_delete_lower, subdiv_delete_higher). See Subdivision levels Divide (Ctrl+D), Smt Tool > Geometry > Divide, Ctrl+D, with Smt beside it (subdiv_divide). See Subdivision levels Document, 2.5D canvas, pixols Not planned: SculptForge is a 3D sculpting app only Draw Size Draw Size (top shelf, S, [ / ]) DynaMesh Voxel Remesh (Tool > Remesh, remesh). See Geometry Extract (Tool > SubTool > Extract) Tool > Parts > Extract: the masked part becomes a shell Part, with Thick, E Smt and Double; Extract previews, Accept keeps it (extract, extract_accept). See Parts Focal Shift No slider for the built-in brushes. Custom brushes have Hardness and Tip sharpness in their recipe Ghost, Transp Not yet. Inactive Parts are drawn slightly dimmed GoZ Send to ZBrush (GoZ-compatible): send to and receive from ZBrush, and import or export GoZ-compatible files (File > Send to ZBrush). See Exporting Group Masked Tool > Face Groups > From mask (polygroup_from_mask) Group Visible Tool > Face Groups > Merge visible (polygroup_merge_visible) Groups By Normals Tool > Face Groups > By normals with an angle (polygroup_auto_by_normals) Bake, Multi Map Exporter (normal / displacement / AO maps) Tool > Bake (bake): tangent and object-space normal, displacement, AO, cavity and colour maps from a high-poly Part onto a low-poly's UVs. See Baking Layers (sculpt layers) Tool > Layers: sculpt layers with weights, exported as blend shapes. See Layers LazyMouse Steady Stroke (L, every stroke type) and the Lazy Stroke stroke type LightBox Library, , (comma) Live Boolean Not yet Local symmetry, radial symmetry Sculpt > Symmetry & Gizmo > Symmetry: R (radial symmetry, Radial Count 2-64 around X, Y or Z, combined with the X / Y / Z mirrors) and Local (about the active Part's centre). See Sculpting Mask by Cavity Tool > Masking > By cavity (mask_by_cavity) Masking (Ctrl) Hold Ctrl to paint the mask, Ctrl+Alt to erase. See Masking MaskLasso, MaskRect Tool > Masking: pick the shape, then Ctrl+drag (add Alt to unmask). See Masking MatCap Material: the built-in Lit Spheres, Soft Clay the default, plus Studio (M), and your own with Load Lit Sphere... (load_matcap). See Vertex Paint Mirror (Tool > Deformation) Tool > Deformation > Mirror with X Y Z (mirror): flips the Part across the plane through the origin. See Geometry Mirror And Weld Tool > Geometry > Modify Topology > Mirror And Weld with X Y Z (mirror_and_weld): the + side mirrored onto the - side and welded into one watertight mesh, keeping face groups and vertex paint. See Geometry Morph target A sculpt layer; exported as glTF morph targets and FBX/USD blend shapes Mrgb, M (material channel) Not yet: there is no per-vertex material channel Polyframe (PolyF, Shift+F) Wire on the right shelf, or Shift+F Polygroups Face Groups: same idea, same Ctrl+Shift gestures. See Face Groups and visibility Polypaint Vertex Paint: Paint brush (P), Rgb, fills, cavity paint. See Vertex Paint Polypaint layers Tool > Paint Layers: Photoshop-style colour layers with blend modes. See Paint layers Project All (ProjectAll) Tool > Parts > Project > Project All (project_all), with Dist, Mean and PA Blur; respects the mask. See Quad retopology Projection Master Not yet. Mesh > Generate 3D > Stamp projects an image onto the model from the view QuickSave File > Save Snapshot (9 in the ZBrush-style"},{"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 (ZBrush's ZRemesher), 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 ZBrush's local symmetry. See Quad retopology Padding (gutter) The few texels around each UV island that texture painting and baking also fill, so seams don't show. See Texture painting and Baking Bake Capture a high-poly's detail as images (maps) on a low-poly's UVs. See Baking Cage (front / rear distance) How far in front of and behind the low-poly the bake's rays look for the high-poly. See Baking Displacement map A map of how far the high-poly lies from the low-poly along its normal; mid-grey = 0. See Baking Keep Texture Remesh option (Voxel Remesh, 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 "},{"p":"glossary.html","c":"Glossary","a":"see-also","h":"See also","t":"Welcome to SculptForge The interface Keyboard and mouse reference"}];
+window.GUIDE_INDEX=[{"p":"index.html","c":"SculptForge User Guide","a":"","h":"SculptForge User Guide","t":"This guide explains every part of SculptForge, the free, open-source sculpting app for VFX, animation and games: how the interface is organised, how to sculpt, mask, paint (on vertices or textures) and manage 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 Masking Face Groups and visibility Selection sets and morph targets Parts Forge Spheres 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"},{"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"},{"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. Memberships add your name to the credits, the monthly pack and a vote on what gets built. Insiders will get each release about two weeks early, starting with SculptForge 1.0 (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. Supporters are thanked by name in Help > About. While SculptForge starts (the first time, after an update, and at most once a week otherwise) a card shows the memberships; I'm already a supporter hides it for good and Edit > Preferences > Support turns it off. After about ten hours of sculpting, SculptForge also shows one small note about this along the bottom of the canvas, once, and never again after you close it."},{"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 and Ctrl+Shift+I stores your interface, 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. 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-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: Draw Size, Intensity, Falloff, RGB 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 Focal Shift -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 Count), 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; Store Config keeps the choice. 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. Store Config keeps it, and 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, Mask Lasso or Mask Rectangle. 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":"Another app's library files are proprietary, but a free export plug-in now converts them once, and then SculptForge opens the library file itself, every Part with its face groups, vertex paint, mask and UVs. See the Bridge setup page."},{"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 Draw 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 Draw Size, Intensity, RGB 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. RGB 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 masked) 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 Res / Higher Res (Shift+D / D) and the SDiv slider step between levels. Detail sculpted high rides along when you reshape low, and edits high show up softened below. Stepping back and forth is instant, even at millions of polygons. Mask, vertex paint, paint layers, face groups, hidden faces, UVs and sculpt layers follow the levels. Del Lower, Del Higher and Reconstruct Subdiv (find the lower levels of a model subdivided elsewhere). Undo walks back through strokes and level changes; projects save every level; the 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":"Gizmo 3D, with the same keys: W Move, E Scale, R Rotate, Q back to Draw (also on the top shelf and in the Transform palette). Handles over the model. Arrows, plane squares and a free-move centre; axis rings and a view ring; axis boxes and a uniform centre. Shift snaps to 15 degrees, the grid or 10% steps. Only the unmasked part moves, so posing is: mask the body, Alt+click the shoulder to put the pivot there, raise Falloff for a soft joint, turn the arm. With X symmetry both arms move together. Pivot tools: Alt+drag the gizmo to move it alone, Reset, To Surface, World or Surface axes. Numeric entry in the Gizmo panel, All Parts (Transpose All), one undo step per drag, sculpt layers move with the surface, and the transform command for scripts. Fast on big models: a drag frame on 1.3 million triangles takes about 10 ms. W no longer toggles the wireframe: use Shift+F 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 All (Tool > Parts > Project) puts the sculpted detail and vertex paint back onto the divided quads, with Dist, Mean and PA Blur, and respects the mask. See Quad retopology and detail projection."},{"p":"whats-new.html","c":"What's new","a":"performance-at-tens-of-millions-of-polygons","h":"Performance at tens of millions of polygons","t":"Sculpting a 33 million triangle model on a laptop now keeps up with the display: a medium brush costs about 10 ms per dab instead of 400, and turning the view runs at 50-70 frames a second instead of 32. Brushes use every core: every brush, mask and paint stroke, the normal updates and the picking structure. Results are exactly the same as on one core. Strokes send the graphics card only what they changed. Before, a dab with symmetry on a subdivided model re-sent most of the mesh. Fast undo: undo keeps only the vertices a stroke changed, and the first 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":"Mask Lasso and Mask Rectangle. 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":"If you have sculpted in another app, most habits carry over. This page shows where things are and how to set SculptForge up the way your hands expect."},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"keys-and-layout","h":"Keys and layout","t":"At the first start, pick Classic sculpting keys when SculptForge asks what you are coming from. It turns on the classic keys and gestures and the Classic layout: a title strip, the alphabetical palette bar and a two-row top shelf. Change either later in Edit > Preferences > Input and Edit > Preferences > Interface > Look. With the Classic sculpting keys 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. S, U, I and O put the Draw Size, Intensity, RGB Intensity and Falloff sliders under the cursor, Space opens the Quick Menu, B opens the brush pop-up with the same letter keys (B, S, T picks Standard), , opens the Library and Ctrl+Shift+I stores your interface. Every key is listed in Keyboard and mouse."},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"where-things-are","h":"Where things are","t":"Looking for In SculptForge Separate meshes in one scene Parts: Tool > Parts (Parts) Blocking out from spheres Forge Spheres: Tool > Forge Spheres (Forge Spheres) Colour on the vertices Vertex Paint (Vertex paint and materials) Groups of faces to mask, hide and split by Face Groups (Face groups and visibility) Viewport materials from a lit-sphere image Lit Spheres (Material) Your projects, brushes, alphas and materials Library (,) An even, watertight remesh Tool > Remesh > Voxel Remesh (Geometry) Automatic quad retopology Tool > Geometry > Quad Remesh (Retopology) Sculpting that adds detail where the brush goes Dynamic topology (Dynamic topology) Subdivision levels Tool > Geometry > Divide (Subdivision levels) The command palette (F3) finds any feature by what it does: type \"remesh\", \"groups\" or \"folders\"."},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"bringing-your-work-over","h":"Bringing your work over","t":"Export OBJ, FBX, glTF or USD from the other app and open it here: quads, UVs and groups come along. Or use the Bridge (File > Bridge) to send Parts back and forth with face groups, mask and vertex paint; see Exporting, Unreal and Bridge."},{"p":"quick-tour.html","c":"Quick tour for experienced sculptors","a":"see-also","h":"See also","t":"The interface Keyboard and mouse 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 (see Flatpak) Arch Linux packaging/arch/PKGBUILD in the source makepkg -si in that folder (an AUR package is planned) Studio pipelines SculptForge--...-vfx2026.tar.gz or ...-vfx2027.tar.gz See SculptForge for studios Most PCs are x86_64; ARM64 is for ARM laptops, Raspberry Pi and Apple Silicon Macs running Linux. Older versions are on the releases page."},{"p":"installing.html","c":"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. 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). It is a single file: download it, then flatpak install --user ./SculptForge-linux-x86_64.flatpak # or ...-linux-arm64.flatpak flatpak run org.sculptforge.SculptForge 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; the file adds Flathub for that if it isn't set up. Only the runtime comes from Flathub: SculptForge itself is not published there. Updating: SculptForge tells you when there is a new version, as the other packages do. Download the new .flatpak and install it the same way; your settings are kept. flatpak update updates the runtime but not a SculptForge installed from a file. 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 doesn't install updates by itself, but it tells you when there is one. Once a day at start-up it downloads a small file from its website that names the newest version; if yours is older, a banner at the top of the 3D view says what's new, with What's new, Download, Later and Skip this version. Nothing about you or your computer is sent. Help > Check for updates asks right away, and Edit > Preferences > Updates turns the daily check off. Builds from a package manager (such as the AUR package) leave updates to the package manager and don't check. To update, download the new release and install it over the old one. Your settings, brushes and library are kept: they live in your user folders, not next to the program (see Troubleshooting and FAQ for where). To uninstall, use your system's usual method (Settings > Apps on Windows, dragging the app to the Bin on macOS, sudo apt remove sculptforge or sudo dnf remove sculptforge on Linux, 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, Draw 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. 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, Draw 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 without Store Config (Store Config keeps them in your UI configuration too). 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=zbrush)."},{"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, Show vertex paint Draw Sculpt > Draw & Tablet Draw Size, Intensity, RGB Intensity, Falloff, Sculpt/Paint, Add/Sub, Rgb, Front, and the tablet options (Pressure > strength, Pressure > size) with a pen readout Generate Mesh > Generate 3D Generate 3D (image or text to 3D), Relief, Inflate and Stamp from an image, and the AI brush provider settings 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, 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. Draw 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, Draw 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). Draw 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."},{"p":"interface.html","c":"The interface","a":"pop-up-pickers","h":"Pop-up pickers","t":"Pickers are pop-up grids of thumbnails. They open beside the left-shelf tile you click, or under the mouse when you use a key. They close when you pick something, press Esc or click elsewhere. Pointing at a tile for a moment shows Quick Info: a large preview and a description."},{"p":"interface.html","c":"The interface","a":"brush-picker","h":"Brush picker","t":"Press B (or click the Brush tile). The picker shows a Recent row, then Built-in, Custom (your brushes and Brush Lab creations) and Library (.sfbrush files in your library that aren't loaded yet; picking one loads it). The brush picker after pressing B and typing S Choose a brush with the keyboard: 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 Draw Size slider under the mouse, U for Intensity, I for RGB 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 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 Alpha Round, Square, Noise, the twelve built-in patterns and images in your Alphas folder Use as the brush alpha Material The Lit Spheres (your own included) and Studio Use the material Image Reference images in your library A menu: Generate 3D, relief, inflate, project onto the model, use as alpha Splats Gaussian splat captures (.ply, .splat) Open the capture as a reference 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. 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. 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 > Popup Info (Ctrl+hover help), and make the box more or less see-through with Popup Info opacity."},{"p":"interface.html","c":"The interface","a":"the-controls-sheet","h":"The Controls sheet","t":"Press F1 (or Help > Controls) for the Controls window. The Keyboard tab lists every action that has a shortcut, grouped by palette and generated from the actions themselves, so it always shows your current keys. The Mouse & pen tab lists the gestures. Type in the filter field to search both. Double-click a row on the Keyboard tab to give that action a new key."},{"p":"interface.html","c":"The interface","a":"this-guide","h":"This guide","t":"Help > User Guide (Shift+F1) opens this guide in its own window: the contents on the left (the open chapter lists its sections), the chapter on the right, and links between chapters. The User Guide window on the Masking chapter Search: type in the search box (Ctrl+F) to find every section that mentions all of your words. Click a result to jump there; the words are marked on the page. Esc clears it. Back and forward: the arrow buttons, Alt+Left / Alt+Right, or the back and forward buttons of your mouse. From any control: while Ctrl-hover help is showing, press F1 (keep Ctrl held) to open the chapter about that control. The help box shows which chapter it is (\"Learn more: ...\"). Code blocks have a Copy button, and Open in browser shows the same page on the SculptForge website. The guide is built into SculptForge, so it works offline and always matches your version."},{"p":"interface.html","c":"The interface","a":"the-command-palette","h":"The command palette","t":"Press F3 (or Ctrl+Shift+P, or click Search 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. Changes last until you quit unless you store them with Store Config."},{"p":"interface.html","c":"The interface","a":"move-add-and-remove-shelf-items","h":"Move, add and remove shelf items","t":"Open Edit > Preferences > Config and turn on Enable Customize. The shelves get a dashed orange outline and the status line reads \"Customize: Ctrl+Alt+drag to move or remove items\". Hold Ctrl+Alt and drag any button, slider or tile: onto a shelf to put it there (an orange line shows where it will go), which is how you add buttons from palettes to a shelf; along its shelf, or to another shelf, to move it; off the shelves (onto the canvas, for example) to remove it. Turn Enable Customize off when you're done, and press Ctrl+Shift+I to keep the result. Right-clicking a shelf item and choosing Remove from shelf works without Customize mode."},{"p":"interface.html","c":"The interface","a":"assign-shortcuts","h":"Assign shortcuts","t":"Hold Ctrl+Alt and click any button (with Customize off), then press the key you want. Esc cancels and Backspace removes the button's shortcut. Or open 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":"store-config-and-friends","h":"Store Config and friends","t":"All in Edit > Preferences > Config: Item What it does Store Config (Ctrl+Shift+I) Keeps the current layout, shortcuts and interface preferences for future sessions Restore Custom UI Goes back to what the last Store Config saved Restore Standard UI Goes back to the built-in layout and default shortcuts (Store Config afterwards to make it stick) Save UI... Saves the layout, shortcuts and preferences to a .json file you can share Load UI... (Ctrl+L) Loads such a file (Store Config afterwards to keep it) The first time you change the layout in a session, the status line reminds you once: \"Layout changed - Ctrl+Shift+I to keep it\". What a session changes by itself (the console and 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). Store Config keeps it."},{"p":"interface.html","c":"The interface","a":"interface-preferences","h":"Interface preferences","t":"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 or Español (see below) Popup Info (Ctrl+hover help) On Ctrl-hover help boxes Popup Info opacity 0.97 How solid the help box is Tooltip delay 0.5 s How long to point at an icon-only button before its name appears 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; Store Config keeps it 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. 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; Store Config keeps it. 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. Store Config keeps them. 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). Edit > Preferences > Input sets the key Style (the first start sets it from your Coming from answer): SculptForge (the default for new installs): 1 to 9 and 0 pick the first ten brushes, I opens Intensity like U, and Ctrl+drag on the background zooms when nothing is masked; Classic: the Classic sculpting keys, with the number keys free (9 is Save Snapshot), I for RGB Intensity and Ctrl+drag on the background for a mask rectangle (see the Classic sculpting keys); Maya: Maya's view controls; or Blender: middle-drag navigation,"},{"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. Store Config keeps the choice 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, 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. 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. Click an end to look from that side, as in Blender: X the right view, Y the top, Z the front, and the plain dot at the other end of each axis the left, bottom or back view. These are orthographic like the numpad views. The end under the pointer gets a ring. 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 Pan Alt+left-drag on the background, Alt+right-drag, or middle-drag Zoom Mouse wheel; Alt+left-drag on the background, then let go of Alt and keep dragging; Ctrl+right-drag; Ctrl+middle-drag; 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 . 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. Mask Lasso, Mask Rectangle and the Ctrl+Shift hide and show shapes work as before. \"Background\" means any part of the canvas where the cursor isn't over the model. A left-drag that starts on the model sculpts instead, so with a pen or a one-button mouse, start rotations beside the model. When the model fills the view, zoom out a little or use the right-shelf buttons. Note: Ctrl+left-drag on the background clears the mask when something is masked (and Ctrl+click there inverts it); while nothing is masked it zooms (with the Classic sculpting keys it draws a mask rectangle instead). Use the wheel or Ctrl+middle-drag to zoom on a masked model. See Masking. On macOS, Cmd works wherever this guide says Ctrl for these gestures, except Ctrl+middle-drag, which needs Ctrl itself."},{"p":"navigation.html","c":"Navigating the view","a":"the-right-shelf-navigation-buttons","h":"The right-shelf navigation buttons","t":"The right shelf has three buttons you drag on rather than click. 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. 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. Store Config (Ctrl+Shift+I) keeps these settings. 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. 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), another program holds the device: quit 3DxWare (or spacenavd on Linux) as above, then unplug and plug the SpaceMouse back in. To report a problem, open Edit > Preferences > Input > SpaceMouse and click Copy device report (shown until the cap has moved the view): it puts every joystick SculptForge sees on the clipboard, with its"},{"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":"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, PolyFrame. Quads show as quads (see Quads and triangles). Useful for judging mesh density before you subdivide or remesh. Groups: colours each face group. Mask: darkens masked areas. 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), no floor grid and no saved camera views. Pan the target onto the area you're working on to orbit around it."},{"p":"navigation.html","c":"Navigating the view","a":"see-also","h":"See also","t":"The interface Keyboard and mouse Sculpting and brushes"},{"p":"sculpting.html","c":"Sculpting and brushes","a":"","h":"Sculpting and brushes","t":"This chapter covers everything that happens when you drag a brush across a model: the built-in brushes and the custom brushes that ship with SculptForge, brush size and strength, modifier keys, stroke types, alphas, symmetry and pen pressure. To design your own brushes, see Brush Lab and sharing brushes. Sculpting the lion head with X symmetry"},{"p":"sculpting.html","c":"Sculpting and brushes","a":"your-first-stroke","h":"Your first stroke","t":"Pick a brush: click it on the bottom shelf, press its number key, or press B to open the brush picker. Left-drag on the model. The brush works on the surface under the cursor. Hold Alt while dragging to invert the brush (dig in instead of building up), or hold Shift to smooth. Press Ctrl+Z to undo a stroke, Ctrl+Shift+Z (or Ctrl+Y) to redo it. Each 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 Chisel Scrapes hard planes and breaks them up with cracks for rocks and ruins. Skin Pores Sprinkles tiny pores for close-up skin detail. Clay 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":"draw-size-intensity-rgb-intensity-and-falloff","h":"Draw Size, Intensity, RGB Intensity and Falloff","t":"These values control every brush. Draw 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 Draw Size 2 to 800 60 Brush radius in screen pixels. [ and ] make it 10% smaller or larger (hold to repeat). S opens a slider at the cursor. Intensity 1 to 100 50 How strongly each dab changes the surface. U opens a slider at the cursor. RGB Intensity 1 to 100 100 How strongly painting colours the surface (the Paint brush, and sculpting with Rgb on). I opens a slider at the cursor. 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 Draw Size is measured on screen, the brush covers less of the model as you zoom in, which is what you want for detail work. The brush cursor shows two rings: the outer one is the Draw 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 Draw Size, Intensity, Falloff, RGB 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 Draw Size and Intensity the same for every brush, as before 0.10.8. Falloff, RGB 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 masked 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, Draw Size, Falloff, Intensity and RGB 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, Mask Lasso, Clear Mask, Mask Rectangle, Mask All, Mask Pen, View Mask, Group Masked 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. Store Config (Ctrl+Shift+I) keeps your menus."},{"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":"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 Draw Size: it slides over the surface under the cursor and lands where you let go. Great for VDMs. None Spray Scattered dabs of random size, strength and rotation, for organic texture. Scatter (0 to 2, default 1): how far dabs land from the cursor, as a fraction of the brush size. 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, Mask Lasso and Mask Rect 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). Draw 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 Draw Size slider shows both numbers, for example Draw 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 Draw 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). 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":"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 Draw 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. 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. Draw 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 Count: 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, Mask Rectangle / Mask Lasso 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). 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). Store Config (Ctrl+Shift+I) keeps these settings. Setup notes for Windows Ink, macOS and Linux are in docs/tablet.md."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"customize-the-bottom-shelf","h":"Customize the bottom shelf","t":"The bottom shelf holds your most-used brushes. By default it shows Standard, Clay, 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 > Enable Customize, then Ctrl+Alt+drag a tile to a new place. Change a brush's key: Ctrl+Alt+click its tile, then press the new key. Shelf changes last until you quit. Press Ctrl+Shift+I (Store Config) to keep them. See The interface for more on customizing."},{"p":"sculpting.html","c":"Sculpting and brushes","a":"sculpt-from-a-script","h":"Sculpt from a script","t":"The stroke command applies a brush along a path on the active 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. 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) to choose another service. Provider What you need Notes Free - no account or key (default) Nothing An open model (GPT-OSS 20B) hosted by Pollinations.ai. Only your description and settings are sent. Rate limited to about one request every few seconds. If it can't be reached, a running local Ollama is used instead. Anthropic (Claude) - your key An Anthropic API key Uses claude-opus-5-5 by default. Effort (low, medium, high) trades speed for more considered brushes. OpenAI-compatible (OpenAI, Ollama, LM Studio...) An endpoint, a model name and, for hosted services, a key Any server that speaks the OpenAI chat completions API, including local models. For Anthropic and OpenAI-compatible providers you can edit the Endpoint, Model and API key fields. Leave the key empty to use the ANTHROPIC_API_KEY or OPENAI_API_KEY environment variable. Click Save settings to keep your choice; settings and keys are stored only on your computer, in ai.json in the SculptForge settings folder (readable only by you). Requests go only to the endpoint you set."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"run-a-model-on-your-own-computer","h":"Run a model on your own computer","t":"For private, offline use with no rate limits, run a local model with Ollama or LM Studio: Install Ollama and download the recommended model: ollama pull qwen3:4b-instruct (2.5 GB, works without a graphics card). In AI provider, choose OpenAI-compatible (OpenAI, Ollama, LM Studio...). Click Ollama (or LM Studio) to fill in the local endpoint. Click Find models. SculptForge checks the connection, shows \"Connected\" with the number of installed models, and lets you pick one from the Model list. Click Save settings. The Run a model on this computer section in the panel shows the install steps for your operating system. The model needs about 4 GB of free memory; expect 10-20 seconds per brush on a laptop CPU and a few seconds with a GPU. The full walkthrough for Windows, macOS, Linux and LM Studio is in docs/local-ai.md."},{"p":"brush-lab.html","c":"Brush Lab and sharing brushes","a":"your-brush-library","h":"Your brush library","t":"Every brush you create or refine in Brush Lab is saved to your brush library automatically, a moment after your last change (slider edits save when you release the slider). The library loads at every start, in the app, in sculptforge-cli and in the Python module, so your brushes are always there. The library is a folder of .sfbrush files in the SculptForge settings folder: System Brush library Linux ~/.local/share/SculptForge/SculptForge/brushes macOS ~/Library/Application Support/SculptForge/SculptForge/brushes Windows %APPDATA%\\SculptForge\\SculptForge\\brushes The Custom brushes list in 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":"masking.html","c":"Masking","a":"","h":"Masking","t":"A mask protects part of the model from change. Masked areas are drawn darker, and every brush, the Paint brush and colour fills leave them alone. This chapter covers painting masks with Ctrl, masking with a lasso or rectangle, the background gestures, and the Tool > Masking controls for inverting, blurring, growing and building masks from cavities, face groups 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 Draw Size, symmetry and, with a pen, pressure (when Pressure > Strength is on). How much each stroke masks is set by Mask Strength in Tool > Masking (0.01 to 1, default 1): lower values build up a soft, partial mask over several strokes. Mask strokes always use a round tip, whatever alpha you have selected, and a 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, Mask Lasso or Mask Rectangle, 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. Mask Lasso Draws a free-hand outline that closes back to where you started. Everything inside is masked. Mask Rectangle Draws a rectangle. Everything inside is masked. With Mask Lasso or Mask Rectangle: 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 Mask Lasso and Mask Rectangle) 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; Mask Lasso 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 Masked: 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 Mask Lasso or Mask Rectangle, 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-sub-palette","h":"The Masking sub-palette","t":"Open Tool > Masking (the Tool palette is in the right tray by default). Every button is one undo step. Control What it does Command Show mask Darken masked areas in the viewport. Mask Pen / Mask Lasso / Mask Rectangle What Ctrl + drag does: paint with the brush, or mask inside a lasso or rectangle. mask_lasso / mask_rect Mask Strength How much each mask stroke or selection masks (0.01 to 1), and the mask value By cavity gives the deepest cavities. Clear Unmask everything. mask_clear Invert Masked becomes free and free becomes masked. mask_invert All Mask every visible vertex. mask_all Blur Soften the mask edges by averaging with neighbouring vertices. mask_blur Sharpen Tighten soft edges, pushing values toward fully masked or free. mask_sharpen Grow Expand the masked region by one ring of edges per pass. mask_grow Shrink Contract the masked region by one ring of edges per pass. mask_shrink passes How many times Blur, Sharpen, Grow and Shrink run (1 to 20 here, default 1). iterations= By cavity Mask concave areas (creases, folds, pores), replacing the current mask. mask_by_cavity threshold How concave a spot must be for By cavity (-0.2 to 0.5, default 0.02). 0 masks anything concave; higher values keep only deep creases. threshold= By face group Mask one face group, replacing the current mask. The number field next to it is the face group id. mask_by_polygroup By border Mask the open edges of the mesh (edges with only one face) and the rings of edges inside them, replacing the current mask, so sculpting keeps the border in place. Uses Mask Strength. A closed mesh has no open edges, and the status bar says so. mask_border Rings How wide By border masks, in rings of edges from the border (1 to 20, default 2; 1 masks the border vertices only). rings= Face Group borders By border also masks where face groups meet. polygroups=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 the field next to By face group and click it."},{"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_polygroup group (required), add=true to add to the current mask instead of replacing it mask_border rings (1-20, default 1), polygroups=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. polygroup_auto_by_normals By pieces One group per disconnected piece, such as separate eyes or buttons in one mesh. polygroup_by_connectivity From mask Masked triangles move into a new group. polygroup_from_mask Group by UVs One group per UV island: triangles that touch without a UV seam between them share a group. Needs UVs (Tool > Texture Map > Auto UV or an imported model's). polygroup_uv Merge visible Everything visible becomes one group. polygroup_merge_visible Clear groups Remove all face groups; the whole Part becomes one group again. polygroup_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 hidden keeps 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 polygroup_auto_by_normals angle (1-180 degrees, default 30) polygroup_by_connectivity, polygroup_uv, polygroup_from_mask, polygroup_merge_visible, polygroup_clear isolate_polygroup, hide_polygroup group (required): the 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_polygroup 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. polygroups 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, Del Lower, Del 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, polygroups, 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. 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 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 Rename it Double-click the row (or right-click > Rename), type, press Enter Hide or show it Click the eye at the end of the row Duplicate or delete it Right-click the row > Duplicate (Ctrl+Shift+D) or Delete... See its vertex and triangle counts Point at the row for a moment The list shows six rows and scrolls when there are more. Names are kept unique: renaming a 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 subtool= or insert_mesh file=.) From file...: a model (.obj, .fbx, .glb, .gltf, .ply, .stl, .GoZ, .usda, .usd, .usdz) or a project (.sfproj). A file with several objects adds one Part per object. The new Part becomes the active one. 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."},{"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":"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":"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 Mask Rectangle / Mask Lasso; 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, attributes, layers and active layer 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 subtool_list List the Parts subtool_select index=1 Make a Part active subtool_append type=cube Add a primitive (sphere, cube, plane); path= adds a file; size= (0.05-2, default 0.35) subtool_duplicate Copy a Part subtool_delete name=Helmet Delete a Part subtool_rename to=Body Rename a Part subtool_visibility visible=false Show or hide (toggles when visible is left out) subtool_solo / subtool_show_all Solo the active Part / show every Part subtool_move direction=up Move a Part up or down the list subtool_merge_down / subtool_merge_visible Merge subtool_split_groups / subtool_split_parts Split 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":"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":"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. 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: zsphere_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): zsphere_new, zsphere_list, zsphere_add, zsphere_set, zsphere_delete, zsphere_insert, zsphere_preview and zsphere_make_mesh. For example, a simple figure: zsphere_new radius=0.5 zsphere_add parent=0 position=0,0.8,0 radius=0.3 zsphere_add parent=0 position=0.9,0.1,0 radius=0.2 symmetry=x zsphere_make_mesh resolution=160"},{"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. Draw Size, the stroke type and the alpha work as they do for sculpting; RGB Intensity (I) sets how strongly the colour goes on. While the Paint brush is active: Alt paints back towards white. Shift still smooths the shape. 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. 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":"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":"Materials 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":"A Lit Sphere is a picture of a lit sphere (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_MATCAP_PATH environment variable (separated by :, ; on Windows); those load when SculptForge starts. To remove one, right-click it in the material picker or palette 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 Your Lit Spheres appear in the material picker (M), Render > Materials and the Library, after the built-in ones. 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 once you Store Config (Ctrl+Shift+I). Smooth and Flat have no default shortcut, so no classic key changes meaning; assign one under Edit > Preferences > Hotkeys if you switch often. Not yet: loading your own Lit Sphere images, and physically based materials or BPR-style renders."},{"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_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_matcap 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) remove_matcap 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) subtool_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: Draw 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. Draw Size, RGB 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_polypaint=true starts from the vertex paint paint_target target=texture Where painting goes: vertex or texture texture_from_polypaint Bake the vertex paint into the active texture layer polypaint_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, subtool_merge_down and subtool_merge_visible keep a texture unless you add keep_texture=false. paint_fill, paint_from_cavity, paint_clear and every paint_layer_* command work on the texture while paint_target is texture. See Scripting and automation."},{"p":"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. UDIM Tiles spreads the islands over that many tiles, 1001, 1002 and on (ten per row, as UDIM numbers go), each island at the same texel density: more tiles, more texels for everything. Pack at Density instead keeps exactly the target texel density and opens as many tiles as it needs. 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, polygroups (By Face Groups), planar, unfold or auto; iterations=, selected=, tiles=, margin=, rotate=, density=, pack=false (fit in place), keep_texture= uv_pack Pack: margin= (texels), tiles= (UDIM tiles), 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), polygroups, islands, angle angle=60, clear_all uv_select op=all, none, invert, island face=, face face=, polygroup 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. 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 Res (Shift+D) and a lower level shows the broad part of the layer, exactly as it would show the same strokes made in the base. Step back up and the layer is there as you recorded it, to the last vertex. Weights are shared by all levels. Turn a layer off (weight 0) or blend it at a low level and the top shows the same when you go back up; the slider and Play work at every level. Sculpt into a layer at any level. At a low level a stroke into a layer makes a broad change that the higher levels follow smoothly; the detail recorded above it stays. A layer added at a low level shows on every level above it too. Reshape the base at a low level (or turn it with the Gizmo) and each layer's detail rides on the new shape: its offsets turn with the surface instead of pointing the old way. Divide carries the layers to the new level. Reconstruct Subdiv keeps them, exact at the top. Del Lower and Del Higher keep the current level's layers as they are. Deleting a layer removes it from every level. Undo steps back through strokes, level changes and divisions with their layers. Projects keep every level's layers. Exports write the current level with its layers as blend shapes, so export from the top for the game mesh; subdiv_export path=face_low.glb level=1 writes the base cage with its blend shapes instead. The tools that rebuild the mesh (Voxel Remesh, 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] [subtools=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 Res Shift+D Steps one level down Higher Res D Steps one level up SDiv slider Steps to any level (1 is the base cage) Del Lower Deletes the levels below the current one Del Higher Deletes the levels above the current one Reconstruct Subdiv Finds a lower level for a mesh that was subdivided elsewhere Under the buttons the palette says where you are (\"SDiv 3 of 5\") and how many triangles the base and the top have. The 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":"del-lower-and-del-higher","h":"Del Lower and Del Higher","t":"Del Lower deletes the levels below the current one: the current level becomes the new base cage (SDiv 1). Del Higher deletes the levels above, and the detail sculpted on them. Both are undoable. Deleting down to a single level leaves an ordinary mesh."},{"p":"subdivision-levels.html","c":"Subdivision levels","a":"reconstruct-subdiv","h":"Reconstruct Subdiv","t":"A model that was subdivided in another application (or exported from SculptForge at its top level) comes in as one dense mesh. Reconstruct Subdiv finds the mesh it was subdivided from and adds it as a new lowest level, keeping the dense mesh exactly as it was. Press it again for more levels. It works at the lowest level (SDiv 1). The mesh must be a regular subdivision: all quads from Catmull-Clark subdivision, 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, Del Lower, Del Higher and Reconstruct are single undo steps. Steps share the levels they didn't change, so they cost little memory. Projects (.sfproj) save every level of every 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 (in Tool > Geometry, below Divide) is still there: it replaces the mesh with a denser one and keeps no levels. Use Divide unless you want exactly that."},{"p":"subdivision-levels.html","c":"Subdivision levels","a":"commands","h":"Commands","t":"Every control is a command you can run in the console, from a script or over MCP (see Scripting): Command What it does subdiv_divide smooth=true Divide; smooth=false divides flat (Smt off) subdiv_level level=2 Step to a level (1 = base) subdiv_lower, subdiv_higher Lower Res, Higher Res subdiv_delete_lower, subdiv_delete_higher Del Lower, Del Higher subdiv_reconstruct Reconstruct Subdiv subdiv_info List the levels and their triangle counts subdiv_export path=base.obj level=1 Export the visible 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 sharpen the height profile instead of pulling points together (the result looks the same for creases and folds). 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: Store Config (Ctrl+Shift+I) keeps it. Under the brush, edges longer than the target are split, edges much shorter are merged away, and the new triangles are evened out. Outside the brush nothing changes, so you can have big triangles on the back of a head and fine ones around the eyes."},{"p":"dynamic-topology.html","c":"Dynamic topology","a":"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 (Store Config keeps it) 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, Dynamic stays off and the status bar says why: go to the level you want to keep and use Del Lower and Del Higher in Tool > Geometry first. If you turn it on and then pick a Part that has levels, strokes sculpt it without remeshing. 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 header shows the step you are at, the number of branches and the step's name. Save with project keeps the history with the project, the film icon exports a timelapse, 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":"Tick Save with project in the strip's header 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 Mask Lasso). 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."},{"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. Sculpt layers move with the surface: the base and every layer's offsets are transformed together, so a layer you sculpted on a forearm stays on it after posing, and layer sliders keep working. With subdivision levels you can pose at a low level: the detail of the higher levels, sculpt layers included, turns with it when you step back up. Projects save the result, and the gizmo's pivot and options too."},{"p":"gizmo.html","c":"Moving, rotating and posing (Gizmo)","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 (Transpose All)"},{"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 is the one-way version. Tool > Geometry > Subdivide smooths the mesh with Loop subdivision. Each level multiplies the triangle count by four and rounds off the shape slightly. 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 (64 to 400 in the palette, default 200). Higher keeps more detail and makes more triangles. Wireframe of a model before and after a voxel remesh What happens to your data: Sculpt layers are baked into the surface: the result has no layers. Mask and 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":"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 All (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":"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 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_polypaint, 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 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 All 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 All 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 All 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 All. 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 co"},{"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-all","h":"Project All","t":"Tool > Parts > Project > Project All 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 All 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) PA Blur Smooths the projected result this many times, to soften noise from the source Mean Where there is surface on both sides of a vertex, settle halfway between them instead of on the nearest Geometry Project the shape (into the active sculpt layer, if you have layers) 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 All 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 All, divide again, Project All. 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_polypaint, symmetry (x, y or z; off by default in scripts; the mirror plane is found from the model), symmetry_center (use this plane instead, e.g. 0 for the world's centre), keep_original, smooth (relaxation passes, default 6), seed (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), polypaint (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. 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 Hunyuan3D 3.1 Rapid (Tencent) Meshy Meshy's own text-to-3D model ComfyUI The text workflow you choose (the bundled text-to-3d uses FLUX.1 schnell and Hunyuan3D 2.1)"},{"p":"generate-3d.html","c":"Image and text to 3D","a":"services","h":"Services","t":"Service Cost and setup Good for Hugging Face - free models Free, no account. A free token raises the daily allowance Trying things out, personal work fal.ai - paid, your key Paid per generation, needs a fal.ai key Reliable capacity, newer models Meshy - paid, your key Paid, needs a Meshy key Meshy's own models ComfyUI - your server Free, runs on your own GPU or a studio server Privacy, custom workflows, studios My generator command Free, any program you run locally Your own model or a studio service Offline blockout (inflate silhouette) Free and instant, no network Simple shapes, a quick start"},{"p":"generate-3d.html","c":"Image and text to 3D","a":"hugging-face-free","h":"Hugging Face (free)","t":"This runs each model author's own public demo on Hugging Face's shared ZeroGPU hardware. Pick a Model: Model Notes Hunyuan3D 2.1 (Tencent) The default. Detailed shapes, about 20 seconds, 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-and-meshy-paid","h":"fal.ai and Meshy (paid)","t":"fal.ai: choose a Model (TRELLIS.2, Hunyuan3D 3.1 Pro, Hunyuan3D 3.1 Rapid or Meshy 6) or type any fal model id into Model id. Paste your key from fal.ai/dashboard/keys into API key, or set FAL_KEY. Meshy: paste your key from meshy.ai (API settings) into API key, or set MESHY_API_KEY. Generations are billed to your account with that service. Errors such as \"The API key was rejected\", \"Out of credits on this account\" or \"Rate limited\" come from the service."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"comfyui-your-own-server","h":"ComfyUI (your own server)","t":"Runs any ComfyUI workflow on your own computer or a studio GPU server, with whatever models it has. Nothing is sent anywhere else. Start ComfyUI. It listens on http://127.0.0.1:8188 by default. If SculptForge runs on another computer, start ComfyUI with --listen (only on a network you trust: ComfyUI has no login). Install the models your workflow needs. The bundled Hunyuan3D 2.1 workflow needs hunyuan_3d_v2.1.safetensors in ComfyUI/models/checkpoints. In Generate 3D, pick ComfyUI - your server, enter the Server address and click Test connection. A good answer looks like \"Connected: ComfyUI 0.42.0 - NVIDIA GeForce RTX 4090 (24.0 GB)\". Choose a Workflow: a bundled one, or Other file (API format)... for your own. Click Generate 3D model. The progress bar shows your place in ComfyUI's queue. Bundled workflows: Workflow Tab Needs hunyuan3d-image-to-3d From image The Hunyuan3D 2.1 checkpoint (7.4 GB) and a GPU with about 10 GB of memory text-to-3d From text FLUX.1 schnell, BiRefNet and Hunyuan3D 2.1 (about 25 GB of downloads) and a GPU sculptforge-inflate From image The ComfyUI-SculptForge node pack; no GPU. A quick blockout to check your setup Your own workflows must be saved in ComfyUI's API format (in ComfyUI: Workflow > Export (API)). To tell SculptForge where the inputs go, give nodes these titles: Node title What SculptForge does sf_image Puts the uploaded picture into this Load Image node. Without one, the first Load Image node is used sf_prompt Puts your description into this node's text, prompt or string input. Without one, the first CLIP Text Encode not titled \"negative\" is used sf_seed Sets the seed. Inputs named seed or noise_seed get it too SculptForge imports the first mesh file the workflow saves (Save GLB, Preview 3D and most 3D node packs work). For error messages and their fixes, see Troubleshooting."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"my-generator-command","h":"My generator command","t":"Runs any command line on your computer: a local open-source model, a studio service, or a script that calls a cloud API. Type the command into the box. It must contain {input} (replaced with the image path) and {output} (replaced with the path to write, ending in .glb). Both are quoted for you, so don't add quotes. The command must write a GLB file to {output} and exit with status 0. The box starts with a command that runs SculptForge's own silhouette inflation, which is a quick way to check that the pipeline works: sculptforge-cli --set input={input} --set output={output} -c 'image_inflate path=$input subdivisions=2; export_glb path=$output' A wrapper for your own model can be as small as this: # my_generator.py {input} {output} import sys image_path, output_path = sys.argv[1], sys.argv[2] # load your model, run it on image_path, write a .glb to output_path Keep API keys in environment variables that your script reads, not in the command line."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"offline-blockout","h":"Offline blockout","t":"Offline blockout (inflate silhouette) inflates the outline of the picture into a rounded, closed mesh. It is instant and needs no network, but it is a puffy blockout, not a reconstruction: fine for simple shapes, not for characters."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"save-your-settings","h":"Save your settings","t":"Save settings (the small button under Generate 3D model) stores the service, model, keys, token, ComfyUI address and generator command in your ai.json settings file, so they are set the next time you start SculptForge. Keys in ai.json are readable only by your user account. See where settings live."},{"p":"generate-3d.html","c":"Image and text to 3D","a":"quick-shapes-from-an-image-offline","h":"Quick shapes from an image (offline)","t":"The From image tab also has three offline tools under Quick shapes (offline). They need no network and run instantly. The same tools are in 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' # 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 All 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 All 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 All 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=polygroups 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). For Unreal, Height sets the real-world size directly (see below)."},{"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 The default bridge folder and the one-time setup are on the Bridge setup page. On Linux the Bridge 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: goz_export path=, goz_import path=, goz_send, goz_receive and export_stl path= (see 3D printing for its options)."},{"p":"exporting.html","c":"Exporting, Unreal and 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 Draw 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 (RGB Intensity): Blender's sculpt brushes don't paint. Ctrl+drag on the model doesn't paint the mask with a round brush: Blender can't switch to the Mask brush for one stroke, so it draws a mask lasso (pick the Mask brush with B to paint it). Dragging on the empty background doesn't rotate: a keymap can't tell the model from the background. Use the middle mouse button, or Blender's Emulate 3 Button Mouse. Ctrl+click on the background (invert or clear the mask) and Ctrl+Shift+click (show all): use Ctrl+I, Alt+M and Alt+H. B then two letters: a Blender menu takes one key at a time, so B opens the list and the letters filter it. Alt+click a 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 .GoZ 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."},{"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 and Folder. The script uses plain maya.cmds and Maya's own OBJ exporter; 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)."},{"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. In SculptForge choose File > Maya > Get from Maya. 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. Choose File > Maya > Send to Maya. Every visible Part goes. In Maya click Get. 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. Get automatically (in File > Maya, off by default) loads what Maya sends as soon as it arrives: SculptForge checks the folder's manifest once a second."},{"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. 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, Draw Size, Intensity (and Smooth's), RGB 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 the window title starts with *. Any edit in any Part counts, as do splat edits and layer weight changes. If you opened a model file (an OBJ, say) rather than a project, Save asks where to save a new .sfproj; the original model file is left alone."},{"p":"projects.html","c":"Projects, autosave and 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 MatCaps 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, then Store Config (Ctrl+Shift+I) to keep the setting. 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 Store Config 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 MCP setup."},{"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_polypaint, symmetry, keep_original Parts project_all distance (default 0.02), mean, blur, geometry, polypaint, 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 polygroup_auto_by_normals angle (default 30) Visibility isolate_polygroup, hide_polygroup group (required) Visibility show_all, delete_hidden Transform transform translate, rotate, scale, pivot, orient, masked, falloff, symmetry, all (Gizmo) Parts subtool_append type (sphere, cube, plane) or path, name, size Parts subtool_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, --polygroups 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.polygroups, doc.hidden Attribute arrays you can read and assign (None if absent) doc.layers, doc.layer_delta(i) Sculpt layers as (name, weight) and their per-vertex offsets doc.subtools, doc.active_subtool The 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":"sculptforge-cli --mcp runs SculptForge as an MCP server. An AI agent (Claude Code, Claude Desktop or any MCP client) gets every command as a tool and works on one scene for the session: it can open files, generate models, sculpt strokes, remesh, paint and export. Claude Code: claude mcp add sculptforge -- /path/to/sculptforge-cli --mcp Claude Desktop or another client: add a stdio server whose command is the full path to sculptforge-cli and whose argument is --mcp. For Claude Desktop that is an entry in its configuration file like this: { \"mcpServers\": { \"sculptforge\": { \"command\": \"/path/to/sculptforge-cli\", \"args\": [\"--mcp\"] } } } Then ask for something like \"make a sphere, remesh it at 128 and export it to ~/Desktop/ball.glb\". File paths are on your machine. The agent works headless; to see the result, open the exported file in SculptForge. sculptforge-cli --schema prints the same tool definitions as JSON, for wiring SculptForge into your own agent."},{"p":"scripting.html","c":"Scripting and automation","a":"see-also","h":"See also","t":"The interface: the command palette and Ctrl-hover help For studios: Rez, the VFX builds and farm rendering Image and text to 3D and Exporting: the commands in context Keyboard and mouse reference"},{"p":"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 the monthly pack or an Insider drop. 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. Store Config keeps the result."},{"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 the monthly pack or an Insider drop. 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/, matcaps/, 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 and licensing."},{"p":"studios.html","c":"SculptForge for studios","a":"vfx-reference-platform-builds","h":"VFX Reference Platform builds","t":"SculptForge tracks the VFX Reference Platform. Every commit is built and tested in the platform's reference environments: CY2026 CY2027 SculptForge Linux compiler GCC 14.2 GCC 14.2 Built and tested with gcc-toolset-14 glibc 2.28 (EL8) 2.34 (EL9) Rocky Linux 8 and 9 builds; CI checks that no newer glibc symbols are used C++ C++20 C++20 C++20 Python 3.13 3.13 The sculptforge module is built and tested against 3.13 Windows VS 2022 17.6+ VS build tools 14.44+ Visual Studio 2022 macOS minimum 14.0 14.0 Universal binary with deployment target 11.0 FBX 2020.x 2020.x Writes FBX 7.4 binary, which FBX SDK 2020 reads SculptForge doesn't depend on Qt, OpenEXR, Boost, TBB or other platform libraries, so it can't conflict with the versions your other tools load. Its few dependencies (SDL3, Dear ImGui, GLM, ufbx) are linked into the binaries. Each release includes SculptForge--linux--vfx2026.tar.gz (Rocky 8, glibc 2.28) and ...-vfx2027.tar.gz (Rocky 9, glibc 2.34), for x86_64 and ARM64, with the Python module under lib/sculptforge/python."},{"p":"studios.html","c":"SculptForge for studios","a":"deploy-with-rez","h":"Deploy with Rez","t":"packaging/rez/package.py in the source tree builds and installs a Rez package: cd packaging/rez SCULPTFORGE_PYTHON=$(which python3.13) rez-build --install # or --release for your release repository rez-env sculptforge -- sculptforge # the app rez-env sculptforge -- sculptforge-cli --list # every pipeline command rez-env sculptforge python-3.13 -- python -c \"import sculptforge\" The package puts bin/ on PATH and the Python module on PYTHONPATH, and sets SCULPTFORGE_ROOT. The Python module is built for the first python3 found unless SCULPTFORGE_PYTHON names an interpreter."},{"p":"studios.html","c":"SculptForge for studios","a":"studio-brush-libraries","h":"Studio brush libraries","t":"Each artist's own brushes live in their user brush library, one .sfbrush file per brush (see Brush Lab and sharing brushes). To give a whole team the same brushes, put .sfbrush files on a share and list it in SCULPTFORGE_BRUSH_PATH: export SCULPTFORGE_BRUSH_PATH=/studio/brushes:/show/troll/brushes # ';' between folders on Windows sculptforge-cli -c 'brush_library' # every brush, where it comes from and its file, plus the folders The app, sculptforge-cli and the Python module load these folders at start-up, read-only: SculptForge never writes into them, so the share can be mounted read-only. Studio brushes show a studio tag in the Custom brushes list. When brushes share a name, the artist's own wins over a studio one, which wins over a built-in. Among studio folders, the first one listed wins. Refining a studio brush in Brush Lab saves the artist's own version (tagged yours) without touching the share. Deleting that version brings the studio brush back. To publish a brush, copy its .sfbrush file into the share: right-click it in the Custom brushes list > Save .sfbrush..., or take it from an artist's user library. With Rez, set the share once for everyone: when SCULPTFORGE_STUDIO_BRUSHES is set as the package resolves (in a site package, your rezconfig or the launcher), it is appended to SCULPTFORGE_BRUSH_PATH. export SCULPTFORGE_STUDIO_BRUSHES=/studio/brushes rez-env sculptforge -- sculptforge"},{"p":"studios.html","c":"SculptForge for studios","a":"environment-variables","h":"Environment variables","t":"Variable Effect 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 SCULPTFORGE_BRUSH_PATH Read-only studio brush folders (:-separated, ; on Windows) SCULPTFORGE_STUDIO_BRUSHES With the Rez package: appended to SCULPTFORGE_BRUSH_PATH SCULPTFORGE_BRUSH_GALLERY Use another community brush gallery index (a URL or a folder), for example an in-house mirror HF_TOKEN (or HUGGING_FACE_HUB_TOKEN) Hugging Face token for the free image-to-3D models FAL_KEY, MESHY_API_KEY Keys for the paid generation services ANTHROPIC_API_KEY, OPENAI_API_KEY Keys for Brush Lab providers XDG_DATA_HOME (Linux), APPDATA (Windows) Move the settings folder (see where settings live) Keys from the environment are used when none is saved in the app, so a launcher can supply them without writing them to each artist's settings."},{"p":"studios.html","c":"SculptForge for studios","a":"headless-and-farm-use","h":"Headless and farm use","t":"sculptforge-cli runs every editing operation without a display: imports, remeshing, decimation, LOD chains, FBX, USD and glTF export, splat conversion and AI generation. See Scripting and automation. sculptforge --render out.png --turntable 8 renders review images and turntables offscreen. It needs an OpenGL 3.3 context; on a headless Linux node, run it under Xvfb. sculptforge-cli --mcp exposes the same operations to AI agents through the Model Context Protocol. import sculptforge gives Python the same commands plus NumPy arrays of the mesh, for your own tools. A typical farm job turns incoming scans into game-ready assets: sculptforge-cli --set in=/ingest/scan_042.ply --set usd=/assets/scan_042.usda --set glb=/assets/scan_042.glb -c ' open path=$in splat_transform rotate_x=180 fit=true splat_clean splat_to_mesh detail=320 preset=game color=texture export_usd path=$usd export_lods path=$glb levels=4 ratio=0.5 ' A --set variable replaces a whole value, so pass complete paths (with their extensions) as variables."},{"p":"studios.html","c":"SculptForge for studios","a":"formats-in-a-pipeline","h":"Formats in a pipeline","t":"Format Read Write Notes OpenUSD (.usda, .usdz) Yes Yes Meshes, xform ops, Z-up stages, UsdSkel blend shapes, ParticleField Gaussian splats, textures; checked with OpenUSD's validators FBX Yes (any version) Yes (7.4 binary) LOD groups, blend shapes, centimetre units, textures; checked with ufbx's strict mode glTF / GLB Yes Yes Morph targets, vertex colours, KHR_gaussian_splatting, embedded textures; checked with the Khronos validator OBJ Yes Yes Objects as 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 ($300 a month; Founding Studio: the first 10 studios lock in $150 a month for as long as they stay subscribed) covers your whole company, with no seat count: Insider for every artist: the monthly pack, daily drops (a brush, alpha or VDM almost every day), the feature vote and the monthly dev Q&A. Insiders will get each release about two weeks early, starting with SculptForge 1.0. A custom studio build with your presets, keymaps, packs, shelves and pipeline defaults baked in. Custom content: brushes, alphas, VDMs, macros and pipeline presets made for your team. Guided development: your requests go to the front of the roadmap, with a monthly call or async review with the developer. Priority triage: reviewed within 2 business days (no fix-time guarantee). A private team channel on Discord, and your logo on the website and in the README. Every release stays free for everyone; bug-fix and security releases go out to everyone the same day. Larger custom features are quoted separately. Join at sculptforge.app/studios.html."},{"p":"studios.html","c":"SculptForge for studios","a":"studio-onboarding","h":"Studio onboarding","t":"After checkout, email [email protected] from a studio address with the GitHub usernames that should get the private repository (as many artists as you like) and who should join the team channel."},{"p":"studios.html","c":"SculptForge for studios","a":"custom-content","h":"Custom content","t":"Studios can ask for their own content, made to order: Brushes tuned to your style. Alphas and VDMs made from your own references or scans (only material you own). Macros and one-click workflows. Pipeline presets: export settings, naming, scale, axis, texture packing and Bridge setup. Keymaps and layouts. All of it is baked into your custom studio build. Up to 5 custom items a month (brushes, alphas, macros or presets); larger features are quoted separately. Your assets stay private to your studio and are never used for anything else."},{"p":"studios.html","c":"SculptForge for studios","a":"requesting-a-custom-build","h":"Requesting a custom build","t":"Send, in one email or a message in your team channel: What to bake in: your exported keymap and layout (Edit > Preferences > Interface), brush presets and packs (.sfbrush, .sfpack), shelf setup, 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. Files are treated as data only: scripts and executables you send are never run. Your build is published as a release in the private repository, built by the same pipeline and tests as public builds, with its source (it is GPL like every SculptForge build). Each new release brings an updated studio build."},{"p":"studios.html","c":"SculptForge for studios","a":"guided-development","h":"Guided development","t":"Tell us what your team needs most, in the team channel or on the monthly call (or an async review, if a call doesn't suit your time zone). Studio requests go to the front of the roadmap: each month we agree what comes next, and you see it in preview builds about a week before the release. Requests that are bigger than a normal release's work are quoted separately before anything starts."},{"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"},{"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. Press Ctrl+Shift+I (Store Config) to keep your changes. See Customizing the interface. On macOS, Cmd works wherever a shortcut says Ctrl. Single-letter shortcuts don't fire while you type in a text field."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"keyboard-shortcuts","h":"Keyboard shortcuts","t":"The table lists the default shortcut of every action 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 Draw Size at cursor S A Draw Size slider under the cursor: drag it, or type a number and press Enter. Falloff at cursor O 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 or I A 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. 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, Draw 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":"preferences","h":"Preferences","t":"Action Keys What it does Load UI... Ctrl+L Load a layout file someone shared (or you saved with Save UI). 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. Save UI... Ctrl+Alt+Shift+I Save the layout, shortcuts and interface preferences to a file you can share. Shelves Tab Hide or show the shelves and trays around the canvas. Store Config Ctrl+Shift+I Keep the current layout, shortcuts and interface preferences for future sessions. SculptForge never saves them on its own."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"render","h":"Render","t":"Action Keys What it does Fullscreen F11 Fill the screen with SculptForge (again: back to a window). Mask Ctrl+H 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 Ctrl+D Add a subdivision level: four times the polygons, and the lower levels are kept, so you can step down to shape big forms and back up to the detail. Quads stay quads (Catmull-Clark). Smt off divides without smoothing. 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 Masked Ctrl+W Turn the masked part into a new face group and clear the mask. With nothing masked, everything visible becomes one group. Higher Res D Step one subdivision level up (more polygons, for detail). Edits made below carry the detail along. Invert Mask Ctrl+I Mask what is unmasked and unmask what is masked (also: Ctrl+click the background). Lower Res Shift+D Step one subdivision level down (fewer polygons, for big forms). The detail of the higher levels is kept. Mask All Ctrl+A Mask the whole visible Part. Preview A Show the skin Make Mesh would build instead of the spheres. Turn it off to edit the spheres again."},{"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). 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). 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. 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 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."},{"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 Mask Lasso or Mask Rectangle 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) 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 Enable Customize on) Tablet pressure Used automatically when a pen is detected (Pressure > Strength / Pressure > Size) Open files Drop a model (.obj, .glb ...), project, brush (.sfbrush), splat capture or image onto the window"},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"keys-inside-pop-ups-and-panels","h":"Keys inside pop-ups and panels","t":"Some keys only mean something while a pop-up or panel has the keyboard."},{"p":"shortcuts.html","c":"Keyboard and mouse","a":"brush-picker-b","h":"Brush picker (B)","t":"Key Action A letter Keep the brushes whose names start with the letters typed so far The 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. Store Config (Ctrl+Shift+I) keeps the choice. 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 Intensity (as U) RGB 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 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 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. Ctrl+Shift+I (Store Config) keeps the keys; Restore Standard UI 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 (Transpose 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. 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 Draw Size: Mesh One dab of a medium brush Turning the view 4 million triangles about 2 ms about 350 frames a second 16 million triangles about 4.5 ms about 170 frames a second 33 million triangles about 7.5 ms about 110 (4x antialiasing), 270 with Fast Navigation Turning the view stays smooth at 100 million triangles: about 50 frames a second with 4x antialiasing, 100 with Fast Navigation. These figures are for closed models (no holes); see \"Closed meshes draw faster\" below. A dab is one step of the brush along the stroke; the app draws several per frame when you move fast. Under 16 ms per dab a stroke keeps up with a 60 Hz display. Very large brushes cost more, since they move more vertices: a brush covering a tenth of a 33 million triangle sphere (about a million vertices per dab with symmetry) takes about 45 ms per dab with Standard, 21 ms with Smooth and 15 ms with Move, of which sending the change to the graphics card is about a third. Performance figures has the full measurements, and how to run the same benchmark on your own machine."},{"p":"performance.html","c":"Performance and big meshes","a":"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 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":"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 last until you quit; Edit > Preferences > Config > Store Config keeps them. Every setting is also in the F3 command palette (type \"antialiasing\", \"fast navigation\" or \"multithreading\")."},{"p":"performance.html","c":"Performance and big meshes","a":"working-with-big-meshes","h":"Working with big meshes","t":"Sculpt at the lowest level that holds the detail. With subdivision levels you can shape the forms a few levels down and only go to the top for fine detail. Each level down is four times lighter. Hide what you're not working on. Hidden 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 > Restore Standard UI (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. 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":"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, 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. Press Store Config (Ctrl+Shift+I) to keep 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-or-shortcuts-are-gone-after-a-restart","h":"My layout or shortcuts are gone after a restart","t":"SculptForge never saves the layout on its own. Press Store Config (Ctrl+Shift+I) to keep the current layout, shortcuts and interface preferences. See The interface."},{"p":"troubleshooting.html","c":"Troubleshooting: tablets, display, crashes and FAQ","a":"reset-the-interface","h":"Reset the interface","t":"Edit > Preferences > Config > Restore Standard UI returns to the built-in layout and default shortcuts. Press Store Config afterwards to make it stick. Restore Custom UI goes back to what the last Store Config saved. To start completely fresh, quit SculptForge and delete ui.json (layout, shortcuts, interface preferences) and imgui.ini (positions of floating windows such as Brush Lab) from the settings folder below."},{"p":"troubleshooting.html","c":"Troubleshooting: 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 Layout, shortcut changes and interface preferences, written by Store Config imgui.ini Positions and sizes of floating windows ai.json AI settings: providers, models, keys, ComfyUI address (readable only by your account) project.json Recent files and the autosave interval autosave.sfproj The autosaved copy of unsaved work (removed once you save) clean_exit Marks a normal exit; without it, the autosave is offered for restore 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 > Save UI... and Load UI... 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":"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, use the Bridge, or convert a whole library once with the free Bridge export plug-in (see the Bridge setup page). Does it have subdivision levels, voxel remesh, quad remesh or UVs? Yes: Voxel Remesh, Quad Remesh (with Project All 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). 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"}];
diff --git a/website/guide/selection-sets.html b/website/guide/selection-sets.html
index 87d7dbf6..77155559 100644
--- a/website/guide/selection-sets.html
+++ b/website/guide/selection-sets.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Selection sets and morph targets - SculptForge User Guide">
<meta property="og:description" content="A selection set is a named snapshot of a Part&#x27;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 th">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/selection-sets.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html" class="current" aria-current="page">Selection sets and morph targets</a><ul class="toc-sections"><li><a href="#store-a-set">Store a set</a></li><li><a href="#restore-rename-and-delete">Restore, rename and delete</a></li><li><a href="#combine-sets">Combine sets</a></li><li><a href="#subdivision-levels">Subdivision levels</a></li><li><a href="#morph-targets">Morph targets</a></li><li><a href="#projects-files-and-other-apps">Projects, files and other apps</a></li><li><a href="#scripting">Scripting</a></li></ul></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html" class="current" aria-current="page">Selection sets and morph targets</a><ul class="toc-sections"><li><a href="#store-a-set">Store a set</a></li><li><a href="#restore-rename-and-delete">Restore, rename and delete</a></li><li><a href="#combine-sets">Combine sets</a></li><li><a href="#subdivision-levels">Subdivision levels</a></li><li><a href="#morph-targets">Morph targets</a></li><li><a href="#projects-files-and-other-apps">Projects, files and other apps</a></li><li><a href="#scripting">Scripting</a></li></ul></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -150,8 +150,7 @@ sf.run(doc, &quot;selection_set_restore&quot;, name=&quot;Eyes&quot;)</code></pr
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/shortcuts.html b/website/guide/shortcuts.html
index de6c7fde..660a9df8 100644
--- a/website/guide/shortcuts.html
+++ b/website/guide/shortcuts.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Keyboard and mouse - SculptForge User Guide">
<meta property="og:description" content="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&#x27;ve changed any.">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/shortcuts.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,45 +46,45 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html" class="current" aria-current="page">Keyboard and mouse</a><ul class="toc-sections"><li><a href="#changing-shortcuts">Changing shortcuts</a></li><li><a href="#keyboard-shortcuts">Keyboard shortcuts</a></li><li><a href="#mouse-and-pen-gestures">Mouse and pen gestures</a></li><li><a href="#keys-inside-pop-ups-and-panels">Keys inside pop-ups and panels</a></li><li><a href="#zbrush-style-keys">ZBrush-style keys</a></li><li><a href="#maya-keys">Maya keys</a></li><li><a href="#blender-keys">Blender keys</a></li><li><a href="#zbrush-keys-that-work-differently">ZBrush keys that work differently</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html" class="current" aria-current="page">Keyboard and mouse</a><ul class="toc-sections"><li><a href="#changing-shortcuts">Changing shortcuts</a></li><li><a href="#keyboard-shortcuts">Keyboard shortcuts</a></li><li><a href="#mouse-and-pen-gestures">Mouse and pen gestures</a></li><li><a href="#keys-inside-pop-ups-and-panels">Keys inside pop-ups and panels</a></li><li><a href="#classic-sculpting-keys">Classic sculpting keys</a></li><li><a href="#maya-keys">Maya keys</a></li><li><a href="#blender-keys">Blender keys</a></li><li><a href="#classic-sculpting-keys-that-work-differently">Classic sculpting keys that work differently</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
<article class="guide-article">
<h1 id="keyboard-and-mouse">Keyboard and mouse</h1>
<p>This chapter is the reference for every default keyboard shortcut and mouse gesture in SculptForge. Inside the app, <kbd>F1</kbd> opens the same list as the Controls window, showing your own keys if you&#x27;ve changed any.</p>
-<p>SculptForge has four key styles, chosen in <strong>Edit &gt; Preferences &gt; Input &gt; Style</strong> (and by the <strong>Coming from</strong> question the first time SculptForge starts): <strong>SculptForge</strong> (the default for new installs), <strong>ZBrush-style</strong>, <strong>Blender</strong> and <strong>Maya</strong>. The main table shows the SculptForge style; the sections after it list what the <a href="#zbrush-style-keys">ZBrush-style</a> and <a href="#blender-keys">Blender</a> styles change. If you used an earlier version, your saved style is kept.</p>
+<p>SculptForge has four key styles, chosen in <strong>Edit &gt; Preferences &gt; Input &gt; Style</strong> (and by the <strong>Coming from</strong> question the first time SculptForge starts): <strong>SculptForge</strong> (the default for new installs), <strong>Classic</strong>, <strong>Blender</strong> and <strong>Maya</strong>. The main table shows the SculptForge style; the sections after it list what the <a href="#classic-sculpting-keys">classic</a> and <a href="#blender-keys">Blender</a> styles change. If you used an earlier version, your saved style is kept.</p>
<h2 id="changing-shortcuts">Changing shortcuts<a class="anchor" href="#changing-shortcuts" aria-label="Link to this section">#</a></h2>
<p>Every key below can be reassigned: hold <kbd>Ctrl</kbd>+<kbd>Alt</kbd> and click a button, then press the new key, or use <strong>Edit &gt; Preferences &gt; Hotkeys</strong>. Press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd> (Store Config) to keep your changes. See <a href="interface.html#customizing-the-interface">Customizing the interface</a>.</p>
<p>On macOS, <kbd>Cmd</kbd> works wherever a shortcut says <kbd>Ctrl</kbd>. Single-letter shortcuts don&#x27;t fire while you type in a text field.</p>
<h2 id="keyboard-shortcuts">Keyboard shortcuts<a class="anchor" href="#keyboard-shortcuts" aria-label="Link to this section">#</a></h2>
<p>The table lists the default shortcut of every action in the SculptForge style, grouped by palette. It is generated from SculptForge&#x27;s action registry, the same source as the Controls window.</p>
<h3 id="brush">Brush<a class="anchor" href="#brush" aria-label="Link to this section">#</a></h3>
-<div class="table-wrap"><table><thead><tr><th>Action</th><th>Keys</th><th>What it does</th></tr></thead><tbody><tr><td>Brush picker</td><td><kbd>B</kbd></td><td>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).</td></tr><tr><td>Capture from view</td><td><kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>C</kbd></td><td>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.</td></tr><tr><td>Clay</td><td><kbd>2</kbd></td><td>Builds up clay that fills the hollows first.</td></tr><tr><td>Clay Block</td><td><kbd>0</kbd></td><td>Square, flat-topped clay strokes for blocking in forms.</td></tr><tr><td>Crease</td><td><kbd>6</kbd></td><td>Cuts a sharp crease; Alt raises a ridge.</td></tr><tr><td>Flatten</td><td><kbd>7</kbd></td><td>Presses the surface toward a plane.</td></tr><tr><td>Inflate</td><td><kbd>5</kbd></td><td>Swells the surface outward along its normals.</td></tr><tr><td>Move</td><td><kbd>4</kbd></td><td>Grabs the surface under the cursor and pulls it along.</td></tr><tr><td>Paste brush</td><td><kbd>Ctrl</kbd>+<kbd>V</kbd></td><td>Add the brush on the clipboard: a brush code someone shared, or the text of a .sfbrush file.</td></tr><tr><td>Pinch</td><td><kbd>8</kbd></td><td>Pulls the surface toward the stroke to tighten edges.</td></tr><tr><td>Sharp Crease</td><td><kbd>9</kbd></td><td>A sharp V-shaped crease with the sides pinched in (ZBrush DamStandard).</td></tr><tr><td>Smooth</td><td><kbd>3</kbd></td><td>Relaxes the surface. Hold Shift to smooth with any brush.</td></tr><tr><td>Standard</td><td><kbd>1</kbd></td><td>Raises the surface along the stroke; Alt digs in.</td></tr></tbody></table></div>
+<div class="table-wrap"><table><thead><tr><th>Action</th><th>Keys</th><th>What it does</th></tr></thead><tbody><tr><td>Brush picker</td><td><kbd>B</kbd></td><td>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).</td></tr><tr><td>Capture from view</td><td><kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>C</kbd></td><td>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.</td></tr><tr><td>Clay</td><td><kbd>2</kbd></td><td>Builds up clay that fills the hollows first.</td></tr><tr><td>Clay Block</td><td><kbd>0</kbd></td><td>Square, flat-topped clay strokes for blocking in forms.</td></tr><tr><td>Crease</td><td><kbd>6</kbd></td><td>Cuts a sharp crease; Alt raises a ridge.</td></tr><tr><td>Flatten</td><td><kbd>7</kbd></td><td>Presses the surface toward a plane.</td></tr><tr><td>Inflate</td><td><kbd>5</kbd></td><td>Swells the surface outward along its normals.</td></tr><tr><td>Move</td><td><kbd>4</kbd></td><td>Grabs the surface under the cursor and pulls it along.</td></tr><tr><td>Paste brush</td><td><kbd>Ctrl</kbd>+<kbd>V</kbd></td><td>Add the brush on the clipboard: a brush code someone shared, or the text of a .sfbrush file.</td></tr><tr><td>Pinch</td><td><kbd>8</kbd></td><td>Pulls the surface toward the stroke to tighten edges.</td></tr><tr><td>Sharp Crease</td><td><kbd>9</kbd></td><td>A sharp V-shaped crease with the sides pinched in.</td></tr><tr><td>Smooth</td><td><kbd>3</kbd></td><td>Relaxes the surface. Hold Shift to smooth with any brush.</td></tr><tr><td>Standard</td><td><kbd>1</kbd></td><td>Raises the surface along the stroke; Alt digs in.</td></tr></tbody></table></div>
<h3 id="color">Color<a class="anchor" href="#color" aria-label="Link to this section">#</a></h3>
<div class="table-wrap"><table><thead><tr><th>Action</th><th>Keys</th><th>What it does</th></tr></thead><tbody><tr><td>Pick colour</td><td><kbd>C</kbd></td><td>Take the paint colour from the model under the cursor.</td></tr><tr><td>Switch Color</td><td><kbd>V</kbd></td><td>Swap the main and the secondary colour.</td></tr></tbody></table></div>
<h3 id="draw">Draw<a class="anchor" href="#draw" aria-label="Link to this section">#</a></h3>
-<div class="table-wrap"><table><thead><tr><th>Action</th><th>Keys</th><th>What it does</th></tr></thead><tbody><tr><td>Draw Size at cursor</td><td><kbd>S</kbd></td><td>A Draw Size slider under the cursor: drag it, or type a number and press Enter.</td></tr><tr><td>Falloff at cursor</td><td><kbd>O</kbd></td><td>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.</td></tr><tr><td>Intensity at cursor</td><td><kbd>U</kbd> or <kbd>I</kbd></td><td>A Intensity slider under the cursor: drag it, or type a number (1-100) and press Enter. Hold Shift (or pick Smooth) to set Smooth&#x27;s own Intensity.</td></tr><tr><td>Larger brush</td><td><kbd>]</kbd></td><td>Make the brush 10% larger (hold to repeat; Shift+] steps one pixel).</td></tr><tr><td>Larger brush by 1 px</td><td><kbd>Shift</kbd>+<kbd>]</kbd></td><td>Make the brush one pixel larger (half a pixel below 2 px).</td></tr><tr><td>Paint</td><td><kbd>P</kbd></td><td>Paint colour without sculpting (ZBrush Rgb on, Zadd off). Alt paints back to white, Shift still smooths.</td></tr><tr><td>Smaller brush</td><td><kbd>[</kbd></td><td>Make the brush 10% smaller (hold to repeat; Shift+[ steps one pixel).</td></tr><tr><td>Smaller brush by 1 px</td><td><kbd>Shift</kbd>+<kbd>[</kbd></td><td>Make the brush one pixel smaller (half a pixel below 2 px), down to 0.5 px.</td></tr></tbody></table></div>
+<div class="table-wrap"><table><thead><tr><th>Action</th><th>Keys</th><th>What it does</th></tr></thead><tbody><tr><td>Draw Size at cursor</td><td><kbd>S</kbd></td><td>A Draw Size slider under the cursor: drag it, or type a number and press Enter.</td></tr><tr><td>Falloff at cursor</td><td><kbd>O</kbd></td><td>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.</td></tr><tr><td>Intensity at cursor</td><td><kbd>U</kbd> or <kbd>I</kbd></td><td>A Intensity slider under the cursor: drag it, or type a number (1-100) and press Enter. Hold Shift (or pick Smooth) to set Smooth&#x27;s own Intensity.</td></tr><tr><td>Larger brush</td><td><kbd>]</kbd></td><td>Make the brush 10% larger (hold to repeat; Shift+] steps one pixel).</td></tr><tr><td>Larger brush by 1 px</td><td><kbd>Shift</kbd>+<kbd>]</kbd></td><td>Make the brush one pixel larger (half a pixel below 2 px).</td></tr><tr><td>Paint</td><td><kbd>P</kbd></td><td>Paint colour without sculpting. Alt paints back to white, Shift still smooths.</td></tr><tr><td>Smaller brush</td><td><kbd>[</kbd></td><td>Make the brush 10% smaller (hold to repeat; Shift+[ steps one pixel).</td></tr><tr><td>Smaller brush by 1 px</td><td><kbd>Shift</kbd>+<kbd>[</kbd></td><td>Make the brush one pixel smaller (half a pixel below 2 px), down to 0.5 px.</td></tr></tbody></table></div>
<h3 id="edit">Edit<a class="anchor" href="#edit" aria-label="Link to this section">#</a></h3>
<div class="table-wrap"><table><thead><tr><th>Action</th><th>Keys</th><th>What it does</th></tr></thead><tbody><tr><td>Redo</td><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Z</kbd> or <kbd>Ctrl</kbd>+<kbd>Y</kbd></td><td>Redo the last undone action.</td></tr><tr><td>Undo</td><td><kbd>Ctrl</kbd>+<kbd>Z</kbd></td><td>Undo the last action.</td></tr></tbody></table></div>
<h3 id="file">File<a class="anchor" href="#file" aria-label="Link to this section">#</a></h3>
<div class="table-wrap"><table><thead><tr><th>Action</th><th>Keys</th><th>What it does</th></tr></thead><tbody><tr><td>Export GLB...</td><td><kbd>Ctrl</kbd>+<kbd>E</kbd></td><td>Export the model as glTF binary, with sculpt layers as blend shapes (morph targets).</td></tr><tr><td>New Sphere</td><td><kbd>Ctrl</kbd>+<kbd>N</kbd></td><td>Replace the scene with a new sphere ready for sculpting.</td></tr><tr><td>Open...</td><td><kbd>Ctrl</kbd>+<kbd>O</kbd></td><td>Open a project (.sfproj), a model (.obj, .glb, .fbx, .stl, .ply, .usd ...) or splats.</td></tr><tr><td>Quit</td><td><kbd>Ctrl</kbd>+<kbd>Q</kbd></td><td>Close SculptForge (asks to save changes first).</td></tr><tr><td>Save</td><td><kbd>Ctrl</kbd>+<kbd>S</kbd></td><td>Save the project (.sfproj: every Part, layer, brush and setting). Asks for a name the first time.</td></tr><tr><td>Save As...</td><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>S</kbd></td><td>Save the project under a new name.</td></tr><tr><td>Send to Unreal</td><td><kbd>Ctrl</kbd>+<kbd>U</kbd></td><td>Export a game-ready FBX and import it into the running Unreal Editor (Python remote execution).</td></tr></tbody></table></div>
<h3 id="help">Help<a class="anchor" href="#help" aria-label="Link to this section">#</a></h3>
-<div class="table-wrap"><table><thead><tr><th>Action</th><th>Keys</th><th>What it does</th></tr></thead><tbody><tr><td>Command palette</td><td><kbd>F3</kbd> or <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd></td><td>Search every command, brush and setting by name and run it. Commands that need parameters open in the console.</td></tr><tr><td>Controls</td><td><kbd>F1</kbd></td><td>Every shortcut and mouse gesture, generated from the commands themselves.</td></tr><tr><td>Quick Menu</td><td><kbd>Space</kbd></td><td>ZBrush&#x27;s QuickMenu under the cursor: brush, stroke, alpha, material, colour, Draw Size, Falloff and the intensities. Hold Space and let go to close it, or tap Space to keep it open.</td></tr><tr><td>User Guide</td><td><kbd>Shift</kbd>+<kbd>F1</kbd></td><td>The SculptForge user guide: every tool explained, with search. Hold Ctrl over a control and press F1 to open the chapter about it.</td></tr></tbody></table></div>
+<div class="table-wrap"><table><thead><tr><th>Action</th><th>Keys</th><th>What it does</th></tr></thead><tbody><tr><td>Command palette</td><td><kbd>F3</kbd> or <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd></td><td>Search every command, brush and setting by name and run it. Commands that need parameters open in the console.</td></tr><tr><td>Controls</td><td><kbd>F1</kbd></td><td>Every shortcut and mouse gesture, generated from the commands themselves.</td></tr><tr><td>Quick Menu</td><td><kbd>Space</kbd></td><td>The Quick Menu under the cursor: brush, stroke, alpha, material, colour, Draw Size, Falloff and the intensities. Hold Space and let go to close it, or tap Space to keep it open.</td></tr><tr><td>User Guide</td><td><kbd>Shift</kbd>+<kbd>F1</kbd></td><td>The SculptForge user guide: every tool explained, with search. Hold Ctrl over a control and press F1 to open the chapter about it.</td></tr></tbody></table></div>
<h3 id="library">Library<a class="anchor" href="#library" aria-label="Link to this section">#</a></h3>
<div class="table-wrap"><table><thead><tr><th>Action</th><th>Keys</th><th>What it does</th></tr></thead><tbody><tr><td>Library</td><td><kbd>,</kbd></td><td>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.</td></tr></tbody></table></div>
<h3 id="material">Material<a class="anchor" href="#material" aria-label="Link to this section">#</a></h3>
<div class="table-wrap"><table><thead><tr><th>Action</th><th>Keys</th><th>What it does</th></tr></thead><tbody><tr><td>Material picker</td><td><kbd>M</kbd></td><td>Pop up the materials under the cursor. Hover one to preview it on the model; click to keep it.</td></tr></tbody></table></div>
<h3 id="preferences">Preferences<a class="anchor" href="#preferences" aria-label="Link to this section">#</a></h3>
-<div class="table-wrap"><table><thead><tr><th>Action</th><th>Keys</th><th>What it does</th></tr></thead><tbody><tr><td>Load UI...</td><td><kbd>Ctrl</kbd>+<kbd>L</kbd></td><td>Load a layout file someone shared (or you saved with Save UI).</td></tr><tr><td>Radial menu 1: Brushes</td><td><kbd>T</kbd></td><td>Hold the key, flick toward an item and let go to run it; or tap the key and click one. Edit it in Preferences &gt; Input &gt; Radial Menus.</td></tr><tr><td>Radial menu 2: Masking</td><td><kbd>Y</kbd></td><td>Hold the key, flick toward an item and let go to run it; or tap the key and click one. Edit it in Preferences &gt; Input &gt; Radial Menus.</td></tr><tr><td>Radial menu 3: Strokes</td><td><kbd>J</kbd></td><td>Hold the key, flick toward an item and let go to run it; or tap the key and click one. Edit it in Preferences &gt; Input &gt; Radial Menus.</td></tr><tr><td>Save UI...</td><td><kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd></td><td>Save the layout, shortcuts and interface preferences to a file you can share.</td></tr><tr><td>Shelves</td><td><kbd>Tab</kbd></td><td>Hide or show the shelves and trays around the canvas.</td></tr><tr><td>Store Config</td><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd></td><td>Keep the current layout, shortcuts and interface preferences for future sessions. Like ZBrush, SculptForge never saves them on its own.</td></tr></tbody></table></div>
+<div class="table-wrap"><table><thead><tr><th>Action</th><th>Keys</th><th>What it does</th></tr></thead><tbody><tr><td>Load UI...</td><td><kbd>Ctrl</kbd>+<kbd>L</kbd></td><td>Load a layout file someone shared (or you saved with Save UI).</td></tr><tr><td>Radial menu 1: Brushes</td><td><kbd>T</kbd></td><td>Hold the key, flick toward an item and let go to run it; or tap the key and click one. Edit it in Preferences &gt; Input &gt; Radial Menus.</td></tr><tr><td>Radial menu 2: Masking</td><td><kbd>Y</kbd></td><td>Hold the key, flick toward an item and let go to run it; or tap the key and click one. Edit it in Preferences &gt; Input &gt; Radial Menus.</td></tr><tr><td>Radial menu 3: Strokes</td><td><kbd>J</kbd></td><td>Hold the key, flick toward an item and let go to run it; or tap the key and click one. Edit it in Preferences &gt; Input &gt; Radial Menus.</td></tr><tr><td>Save UI...</td><td><kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd></td><td>Save the layout, shortcuts and interface preferences to a file you can share.</td></tr><tr><td>Shelves</td><td><kbd>Tab</kbd></td><td>Hide or show the shelves and trays around the canvas.</td></tr><tr><td>Store Config</td><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd></td><td>Keep the current layout, shortcuts and interface preferences for future sessions. SculptForge never saves them on its own.</td></tr></tbody></table></div>
<h3 id="render">Render<a class="anchor" href="#render" aria-label="Link to this section">#</a></h3>
-<div class="table-wrap"><table><thead><tr><th>Action</th><th>Keys</th><th>What it does</th></tr></thead><tbody><tr><td>Fullscreen</td><td><kbd>F11</kbd></td><td>Fill the screen with SculptForge (again: back to a window).</td></tr><tr><td>Mask</td><td><kbd>Ctrl</kbd>+<kbd>H</kbd></td><td>Show or hide the mask (masked areas drawn darker). Hiding it keeps the mask: masked areas stay protected from brushes until you clear it.</td></tr><tr><td>Wireframe</td><td><kbd>Shift</kbd>+<kbd>F</kbd></td><td>Show the mesh&#x27;s polygons (quads and triangles) over the surface (ZBrush PolyFrame).</td></tr></tbody></table></div>
+<div class="table-wrap"><table><thead><tr><th>Action</th><th>Keys</th><th>What it does</th></tr></thead><tbody><tr><td>Fullscreen</td><td><kbd>F11</kbd></td><td>Fill the screen with SculptForge (again: back to a window).</td></tr><tr><td>Mask</td><td><kbd>Ctrl</kbd>+<kbd>H</kbd></td><td>Show or hide the mask (masked areas drawn darker). Hiding it keeps the mask: masked areas stay protected from brushes until you clear it.</td></tr><tr><td>Wireframe</td><td><kbd>Shift</kbd>+<kbd>F</kbd></td><td>Show the mesh&#x27;s polygons (quads and triangles) over the surface.</td></tr></tbody></table></div>
<h3 id="script">Script<a class="anchor" href="#script" aria-label="Link to this section">#</a></h3>
<div class="table-wrap"><table><thead><tr><th>Action</th><th>Keys</th><th>What it does</th></tr></thead><tbody><tr><td>Console</td><td><kbd>`</kbd></td><td>The script console: every command you run appears as a script line, and you can type commands yourself.</td></tr></tbody></table></div>
<h3 id="stroke">Stroke<a class="anchor" href="#stroke" aria-label="Link to this section">#</a></h3>
<div class="table-wrap"><table><thead><tr><th>Action</th><th>Keys</th><th>What it does</th></tr></thead><tbody><tr><td>Steady Stroke</td><td><kbd>L</kbd></td><td>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.</td></tr><tr><td>Stroke popup</td><td><kbd>G</kbd></td><td>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.</td></tr></tbody></table></div>
<h3 id="tool">Tool<a class="anchor" href="#tool" aria-label="Link to this section">#</a></h3>
-<div class="table-wrap"><table><thead><tr><th>Action</th><th>Keys</th><th>What it does</th></tr></thead><tbody><tr><td>Clear Mask</td><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>A</kbd></td><td>Unmask everything (also: Ctrl+drag on the background, away from the model).</td></tr><tr><td>Divide</td><td><kbd>Ctrl</kbd>+<kbd>D</kbd></td><td>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.</td></tr><tr><td>Duplicate Part</td><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>D</kbd></td><td>Copy the active Part, with its layers and attributes, and make the copy active (also in the Parts list&#x27;s right-click menu).</td></tr><tr><td>Group Masked</td><td><kbd>Ctrl</kbd>+<kbd>W</kbd></td><td>Turn the masked part into a new face group and clear the mask (ZBrush Ctrl+W). With nothing masked, everything visible becomes one group.</td></tr><tr><td>Higher Res</td><td><kbd>D</kbd></td><td>Step one subdivision level up (more polygons, for detail). Edits made below carry the detail along.</td></tr><tr><td>Invert Mask</td><td><kbd>Ctrl</kbd>+<kbd>I</kbd></td><td>Mask what is unmasked and unmask what is masked (also: Ctrl+click the background).</td></tr><tr><td>Lower Res</td><td><kbd>Shift</kbd>+<kbd>D</kbd></td><td>Step one subdivision level down (fewer polygons, for big forms). The detail of the higher levels is kept.</td></tr><tr><td>Mask All</td><td><kbd>Ctrl</kbd>+<kbd>A</kbd></td><td>Mask the whole visible Part.</td></tr><tr><td>Preview</td><td><kbd>A</kbd></td><td>Show the skin Make Mesh would build instead of the spheres (ZBrush&#x27;s Preview). Turn it off to edit the spheres again.</td></tr></tbody></table></div>
+<div class="table-wrap"><table><thead><tr><th>Action</th><th>Keys</th><th>What it does</th></tr></thead><tbody><tr><td>Clear Mask</td><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>A</kbd></td><td>Unmask everything (also: Ctrl+drag on the background, away from the model).</td></tr><tr><td>Divide</td><td><kbd>Ctrl</kbd>+<kbd>D</kbd></td><td>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.</td></tr><tr><td>Duplicate Part</td><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>D</kbd></td><td>Copy the active Part, with its layers and attributes, and make the copy active (also in the Parts list&#x27;s right-click menu).</td></tr><tr><td>Group Masked</td><td><kbd>Ctrl</kbd>+<kbd>W</kbd></td><td>Turn the masked part into a new face group and clear the mask. With nothing masked, everything visible becomes one group.</td></tr><tr><td>Higher Res</td><td><kbd>D</kbd></td><td>Step one subdivision level up (more polygons, for detail). Edits made below carry the detail along.</td></tr><tr><td>Invert Mask</td><td><kbd>Ctrl</kbd>+<kbd>I</kbd></td><td>Mask what is unmasked and unmask what is masked (also: Ctrl+click the background).</td></tr><tr><td>Lower Res</td><td><kbd>Shift</kbd>+<kbd>D</kbd></td><td>Step one subdivision level down (fewer polygons, for big forms). The detail of the higher levels is kept.</td></tr><tr><td>Mask All</td><td><kbd>Ctrl</kbd>+<kbd>A</kbd></td><td>Mask the whole visible Part.</td></tr><tr><td>Preview</td><td><kbd>A</kbd></td><td>Show the skin Make Mesh would build instead of the spheres. Turn it off to edit the spheres again.</td></tr></tbody></table></div>
<h3 id="transform">Transform<a class="anchor" href="#transform" aria-label="Link to this section">#</a></h3>
<div class="table-wrap"><table><thead><tr><th>Action</th><th>Keys</th><th>What it does</th></tr></thead><tbody><tr><td>Back view</td><td><kbd>Ctrl</kbd>+<kbd>Numpad 1</kbd></td><td>Look at the model from behind (orthographic).</td></tr><tr><td>Bottom view</td><td><kbd>Ctrl</kbd>+<kbd>Numpad 7</kbd></td><td>Look up at the model from below (orthographic).</td></tr><tr><td>Draw</td><td><kbd>Q</kbd></td><td>Draw mode: brushes sculpt and paint (leaves the Gizmo).</td></tr><tr><td>Frame</td><td><kbd>F</kbd></td><td>Fit the whole model in the view.</td></tr><tr><td>Frame Part</td><td><kbd>Numpad .</kbd></td><td>Fit the active Part in the view (Blender: View Selected).</td></tr><tr><td>Front view</td><td><kbd>Numpad 1</kbd></td><td>Look at the model from the front (orthographic).</td></tr><tr><td>Left view</td><td><kbd>Ctrl</kbd>+<kbd>Numpad 3</kbd></td><td>Look at the model&#x27;s left side (orthographic).</td></tr><tr><td>Move</td><td><kbd>W</kbd></td><td>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.</td></tr><tr><td>Opposite side</td><td><kbd>Numpad 9</kbd></td><td>Look at the model from the other side.</td></tr><tr><td>Orbit down</td><td><kbd>Numpad 2</kbd></td><td>Turn the view 15 degrees down under the model.</td></tr><tr><td>Orbit left</td><td><kbd>Numpad 4</kbd></td><td>Turn the view 15 degrees to the left around the model.</td></tr><tr><td>Orbit right</td><td><kbd>Numpad 6</kbd></td><td>Turn the view 15 degrees to the right around the model.</td></tr><tr><td>Orbit up</td><td><kbd>Numpad 8</kbd></td><td>Turn the view 15 degrees up over the model.</td></tr><tr><td>Orthographic</td><td><kbd>Numpad 5</kbd></td><td>Switch between a perspective and an orthographic view (no foreshortening: sizes don&#x27;t shrink with depth).</td></tr><tr><td>Right view</td><td><kbd>Numpad 3</kbd></td><td>Look at the model&#x27;s right side (orthographic).</td></tr><tr><td>Rotate</td><td><kbd>R</kbd></td><td>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.</td></tr><tr><td>Scale</td><td><kbd>E</kbd></td><td>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.</td></tr><tr><td>Top view</td><td><kbd>Numpad 7</kbd></td><td>Look down on the model (orthographic).</td></tr><tr><td>X</td><td><kbd>X</kbd></td><td>Mirror strokes across X (left and right).</td></tr><tr><td>Zoom in</td><td><kbd>Numpad Plus</kbd></td><td>Move the view closer.</td></tr><tr><td>Zoom out</td><td><kbd>Numpad Minus</kbd></td><td>Move the view back.</td></tr></tbody></table></div>
<h3 id="uv-editor">UV Editor<a class="anchor" href="#uv-editor" aria-label="Link to this section">#</a></h3>
@@ -92,7 +92,7 @@
<h3 id="view">View<a class="anchor" href="#view" aria-label="Link to this section">#</a></h3>
<div class="table-wrap"><table><thead><tr><th>Action</th><th>Keys</th><th>What it does</th></tr></thead><tbody><tr><td>Lock camera</td><td><kbd>Shift</kbd>+<kbd>L</kbd></td><td>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 &gt; Input &gt; 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.</td></tr></tbody></table></div>
<h2 id="mouse-and-pen-gestures">Mouse and pen gestures<a class="anchor" href="#mouse-and-pen-gestures" aria-label="Link to this section">#</a></h2>
-<div class="table-wrap"><table><thead><tr><th>Action</th><th>Gesture</th></tr></thead><tbody><tr><td>Sculpt</td><td>Left-drag on the model</td></tr><tr><td>Sculpt from beside the model</td><td>Turn on <strong>Edit &gt; Preferences &gt; Input &gt; Start strokes off the model</strong> (or press <kbd>Shift</kbd>+<kbd>L</kbd>), then left-drag from the background onto the model; the view then turns with a right-drag (see <a href="navigation.html#mouse-and-pen">Navigation</a>)</td></tr><tr><td>Invert the brush (subtract)</td><td>Hold <kbd>Alt</kbd> while sculpting</td></tr><tr><td>Smooth</td><td>Hold <kbd>Shift</kbd> while sculpting (works with any brush, and with Paint)</td></tr><tr><td>Straight line</td><td>Press <kbd>Shift</kbd> after a stroke has started (45 degree steps)</td></tr><tr><td>Roll the view</td><td><kbd>Shift</kbd>+click the background, let go of <kbd>Shift</kbd>, drag</td></tr><tr><td>Rotate</td><td>Left-drag on the background, or right-drag; hold <kbd>Shift</kbd> to snap to an axis view</td></tr><tr><td>Pan</td><td><kbd>Alt</kbd>+left-drag on the background, <kbd>Alt</kbd>+right-drag, or middle-drag</td></tr><tr><td>Zoom</td><td>Mouse wheel; <kbd>Alt</kbd>+drag on the background then release <kbd>Alt</kbd>; <kbd>Ctrl</kbd>+right-drag; <kbd>Ctrl</kbd>+middle-drag; <kbd>Ctrl</kbd>+left-drag on the background when nothing is masked (not in the ZBrush style)</td></tr><tr><td>Paint the mask</td><td>Hold <kbd>Ctrl</kbd> while stroking on the model</td></tr><tr><td>Erase the mask</td><td>Hold <kbd>Ctrl</kbd>+<kbd>Alt</kbd> while stroking on the model</td></tr><tr><td>Blur / sharpen the mask</td><td><kbd>Ctrl</kbd>+click / <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+click the model</td></tr><tr><td>Invert the mask</td><td><kbd>Ctrl</kbd>+click the background</td></tr><tr><td>Clear the mask</td><td><kbd>Ctrl</kbd>+drag on the background with something masked (with <strong>Mask Pen</strong>), or <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>A</kbd></td></tr><tr><td>Mask inside a lasso or rectangle</td><td><kbd>Ctrl</kbd>+drag with <strong>Mask Lasso</strong> or <strong>Mask Rectangle</strong> picked in <strong>Tool &gt; Masking</strong> (add <kbd>Alt</kbd>: unmask)</td></tr><tr><td>Isolate a face group</td><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+click it (again: invert the visibility; with something hidden already: hide it)</td></tr><tr><td>Hide a face group</td><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Alt</kbd>+click it</td></tr><tr><td>Show everything</td><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+click the background</td></tr><tr><td>Hide outside a rectangle or lasso</td><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+drag (add <kbd>Alt</kbd>: hide inside); <strong>Select Rectangle</strong> or <strong>Select Lasso</strong> in <strong>Tool &gt; Visibility</strong></td></tr><tr><td>Select a Part</td><td><kbd>Alt</kbd>+click it in the view (<kbd>Shift</kbd>+<kbd>Alt</kbd>+click, or a triple-click on another Part: select and frame it)</td></tr><tr><td>Move, scale or rotate with the Gizmo</td><td><kbd>W</kbd>, <kbd>E</kbd> or <kbd>R</kbd>, then drag a handle; hold <kbd>Shift</kbd> to snap (15 degrees, the grid, 10%)</td></tr><tr><td>Move the gizmo only</td><td><kbd>Alt</kbd>+drag a gizmo handle</td></tr><tr><td>Put the gizmo&#x27;s pivot on the model</td><td><kbd>Alt</kbd>+click the model in Move, Scale or Rotate mode</td></tr><tr><td>Pan, zoom or orbit with a button</td><td>Drag on <strong>Move</strong>, <strong>Zoom</strong> or <strong>Rotate</strong> on the right shelf</td></tr><tr><td>Help on any control</td><td>Hold <kbd>Ctrl</kbd> and point at it (<kbd>Ctrl</kbd>+<kbd>Alt</kbd>: scripting parameters)</td></tr><tr><td>Assign a shortcut</td><td><kbd>Ctrl</kbd>+<kbd>Alt</kbd>+click any button, then press the key</td></tr><tr><td>Move or remove shelf items</td><td><kbd>Ctrl</kbd>+<kbd>Alt</kbd>+drag (with <strong>Enable Customize</strong> on)</td></tr><tr><td>Tablet pressure</td><td>Used automatically when a pen is detected (<strong>Pressure &gt; Strength</strong> / <strong>Pressure &gt; Size</strong>)</td></tr><tr><td>Open files</td><td>Drop a model (<code>.obj</code>, <code>.glb</code> ...), project, brush (<code>.sfbrush</code>), splat capture or image onto the window</td></tr></tbody></table></div>
+<div class="table-wrap"><table><thead><tr><th>Action</th><th>Gesture</th></tr></thead><tbody><tr><td>Sculpt</td><td>Left-drag on the model</td></tr><tr><td>Sculpt from beside the model</td><td>Turn on <strong>Edit &gt; Preferences &gt; Input &gt; Start strokes off the model</strong> (or press <kbd>Shift</kbd>+<kbd>L</kbd>), then left-drag from the background onto the model; the view then turns with a right-drag (see <a href="navigation.html#mouse-and-pen">Navigation</a>)</td></tr><tr><td>Invert the brush (subtract)</td><td>Hold <kbd>Alt</kbd> while sculpting</td></tr><tr><td>Smooth</td><td>Hold <kbd>Shift</kbd> while sculpting (works with any brush, and with Paint)</td></tr><tr><td>Straight line</td><td>Press <kbd>Shift</kbd> after a stroke has started (45 degree steps)</td></tr><tr><td>Roll the view</td><td><kbd>Shift</kbd>+click the background, let go of <kbd>Shift</kbd>, drag</td></tr><tr><td>Rotate</td><td>Left-drag on the background, or right-drag; hold <kbd>Shift</kbd> to snap to an axis view</td></tr><tr><td>Pan</td><td><kbd>Alt</kbd>+left-drag on the background, <kbd>Alt</kbd>+right-drag, or middle-drag</td></tr><tr><td>Zoom</td><td>Mouse wheel; <kbd>Alt</kbd>+drag on the background then release <kbd>Alt</kbd>; <kbd>Ctrl</kbd>+right-drag; <kbd>Ctrl</kbd>+middle-drag; <kbd>Ctrl</kbd>+left-drag on the background when nothing is masked (not in the classic)</td></tr><tr><td>Paint the mask</td><td>Hold <kbd>Ctrl</kbd> while stroking on the model</td></tr><tr><td>Erase the mask</td><td>Hold <kbd>Ctrl</kbd>+<kbd>Alt</kbd> while stroking on the model</td></tr><tr><td>Blur / sharpen the mask</td><td><kbd>Ctrl</kbd>+click / <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+click the model</td></tr><tr><td>Invert the mask</td><td><kbd>Ctrl</kbd>+click the background</td></tr><tr><td>Clear the mask</td><td><kbd>Ctrl</kbd>+drag on the background with something masked (with <strong>Mask Pen</strong>), or <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>A</kbd></td></tr><tr><td>Mask inside a lasso or rectangle</td><td><kbd>Ctrl</kbd>+drag with <strong>Mask Lasso</strong> or <strong>Mask Rectangle</strong> picked in <strong>Tool &gt; Masking</strong> (add <kbd>Alt</kbd>: unmask)</td></tr><tr><td>Isolate a face group</td><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+click it (again: invert the visibility; with something hidden already: hide it)</td></tr><tr><td>Hide a face group</td><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Alt</kbd>+click it</td></tr><tr><td>Show everything</td><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+click the background</td></tr><tr><td>Hide outside a rectangle or lasso</td><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+drag (add <kbd>Alt</kbd>: hide inside); <strong>Select Rectangle</strong> or <strong>Select Lasso</strong> in <strong>Tool &gt; Visibility</strong></td></tr><tr><td>Select a Part</td><td><kbd>Alt</kbd>+click it in the view (<kbd>Shift</kbd>+<kbd>Alt</kbd>+click, or a triple-click on another Part: select and frame it)</td></tr><tr><td>Move, scale or rotate with the Gizmo</td><td><kbd>W</kbd>, <kbd>E</kbd> or <kbd>R</kbd>, then drag a handle; hold <kbd>Shift</kbd> to snap (15 degrees, the grid, 10%)</td></tr><tr><td>Move the gizmo only</td><td><kbd>Alt</kbd>+drag a gizmo handle</td></tr><tr><td>Put the gizmo&#x27;s pivot on the model</td><td><kbd>Alt</kbd>+click the model in Move, Scale or Rotate mode</td></tr><tr><td>Pan, zoom or orbit with a button</td><td>Drag on <strong>Move</strong>, <strong>Zoom</strong> or <strong>Rotate</strong> on the right shelf</td></tr><tr><td>Help on any control</td><td>Hold <kbd>Ctrl</kbd> and point at it (<kbd>Ctrl</kbd>+<kbd>Alt</kbd>: scripting parameters)</td></tr><tr><td>Assign a shortcut</td><td><kbd>Ctrl</kbd>+<kbd>Alt</kbd>+click any button, then press the key</td></tr><tr><td>Move or remove shelf items</td><td><kbd>Ctrl</kbd>+<kbd>Alt</kbd>+drag (with <strong>Enable Customize</strong> on)</td></tr><tr><td>Tablet pressure</td><td>Used automatically when a pen is detected (<strong>Pressure &gt; Strength</strong> / <strong>Pressure &gt; Size</strong>)</td></tr><tr><td>Open files</td><td>Drop a model (<code>.obj</code>, <code>.glb</code> ...), project, brush (<code>.sfbrush</code>), splat capture or image onto the window</td></tr></tbody></table></div>
<h2 id="keys-inside-pop-ups-and-panels">Keys inside pop-ups and panels<a class="anchor" href="#keys-inside-pop-ups-and-panels" aria-label="Link to this section">#</a></h2>
<p>Some keys only mean something while a pop-up or panel has the keyboard.</p>
<h3 id="brush-picker-b">Brush picker (B)<a class="anchor" href="#brush-picker-b" aria-label="Link to this section">#</a></h3>
@@ -105,10 +105,10 @@
<div class="table-wrap"><table><thead><tr><th>Key</th><th>Action</th></tr></thead><tbody><tr><td><kbd>Enter</kbd></td><td>Run the line (statements separated by <code>;</code>)</td></tr><tr><td><kbd>Tab</kbd></td><td>Complete a command or parameter name; press again to list the candidates</td></tr><tr><td><kbd>Up</kbd> / <kbd>Down</kbd></td><td>Walk through earlier lines (the last 200 are remembered between sessions)</td></tr></tbody></table></div>
<h3 id="shortcut-capture-ctrlaltclick">Shortcut capture (Ctrl+Alt+click)<a class="anchor" href="#shortcut-capture-ctrlaltclick" aria-label="Link to this section">#</a></h3>
<div class="table-wrap"><table><thead><tr><th>Key</th><th>Action</th></tr></thead><tbody><tr><td>Any key or chord</td><td>Becomes the new shortcut (taken from another action if it had it)</td></tr><tr><td><kbd>Backspace</kbd> or <kbd>Delete</kbd></td><td>Remove the shortcut</td></tr><tr><td><kbd>Esc</kbd></td><td>Cancel</td></tr></tbody></table></div>
-<h2 id="zbrush-style-keys">ZBrush-style keys<a class="anchor" href="#zbrush-style-keys" aria-label="Link to this section">#</a></h2>
-<p>With <strong>Edit &gt; Preferences &gt; Input &gt; Style</strong> on <strong>ZBrush-style</strong> (also at the top of the Controls window, <kbd>F1</kbd>, or <strong>ZBrush</strong> in the first-start <strong>Coming from</strong> question), the keys and gestures work as in ZBrush. Store Config (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd>) keeps the choice. Compared with the table above, these change:</p>
-<div class="table-wrap"><table><thead><tr><th>To</th><th>SculptForge style</th><th>ZBrush-style</th></tr></thead><tbody><tr><td>Pick one of the first ten brushes</td><td><kbd>1</kbd> to <kbd>9</kbd>, <kbd>0</kbd> (Standard, Clay, Smooth, Move ...)</td><td>No key: the number keys are free</td></tr><tr><td>Save Snapshot</td><td>No key</td><td><kbd>9</kbd> (ZBrush&#x27;s QuickSave)</td></tr><tr><td>Slider at the cursor on <kbd>I</kbd></td><td>Intensity (as <kbd>U</kbd>)</td><td>RGB Intensity</td></tr><tr><td><kbd>Ctrl</kbd>+drag on the background with nothing masked</td><td>Zooms</td><td>Draws a mask rectangle (one that misses the model clears the mask)</td></tr><tr><td>Zoom drags (<kbd>Ctrl</kbd>+right-drag, <kbd>Alt</kbd>+drag then release)</td><td>Up zooms in</td><td>Up zooms out</td></tr></tbody></table></div>
-<p>Everything else, from the <kbd>B</kbd> brush letters and <kbd>S</kbd> / <kbd>U</kbd> / <kbd>O</kbd> to the <kbd>Ctrl</kbd> and <kbd>Ctrl</kbd>+<kbd>Shift</kbd> gestures, is the same in both styles. The <strong>Maya</strong> style keeps these ZBrush-style keys and changes only the view controls (<kbd>Alt</kbd>+left, middle and right drags).</p>
+<h2 id="classic-sculpting-keys">Classic sculpting keys<a class="anchor" href="#classic-sculpting-keys" aria-label="Link to this section">#</a></h2>
+<p>With <strong>Edit &gt; Preferences &gt; Input &gt; Style</strong> on <strong>Classic</strong>, the keys and gestures work. Store Config (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd>) keeps the choice. Compared with the table above, these change:</p>
+<div class="table-wrap"><table><thead><tr><th>To</th><th>SculptForge style</th><th>classic</th></tr></thead><tbody><tr><td>Pick one of the first ten brushes</td><td><kbd>1</kbd> to <kbd>9</kbd>, <kbd>0</kbd> (Standard, Clay, Smooth, Move ...)</td><td>No key: the number keys are free</td></tr><tr><td>Save Snapshot</td><td>No key</td><td><kbd>9</kbd></td></tr><tr><td>Slider at the cursor on <kbd>I</kbd></td><td>Intensity (as <kbd>U</kbd>)</td><td>RGB Intensity</td></tr><tr><td><kbd>Ctrl</kbd>+drag on the background with nothing masked</td><td>Zooms</td><td>Draws a mask rectangle (one that misses the model clears the mask)</td></tr><tr><td>Zoom drags (<kbd>Ctrl</kbd>+right-drag, <kbd>Alt</kbd>+drag then release)</td><td>Up zooms in</td><td>Up zooms out</td></tr></tbody></table></div>
+<p>Everything else, from the <kbd>B</kbd> brush letters and <kbd>S</kbd> / <kbd>U</kbd> / <kbd>O</kbd> to the <kbd>Ctrl</kbd> and <kbd>Ctrl</kbd>+<kbd>Shift</kbd> gestures, is the same in both styles. The <strong>Maya</strong> style keeps these the Classic sculpting keys and changes only the view controls (<kbd>Alt</kbd>+left, middle and right drags).</p>
<h2 id="maya-keys">Maya keys<a class="anchor" href="#maya-keys" aria-label="Link to this section">#</a></h2>
<p>With <strong>Edit &gt; Preferences &gt; Input &gt; Style</strong> on <strong>Maya</strong> (#32), the view works as in Maya, on the model or beside it, as long as <kbd>Alt</kbd> is the only key held:</p>
<div class="table-wrap"><table><thead><tr><th>To</th><th>Maya style</th></tr></thead><tbody><tr><td>Rotate</td><td><kbd>Alt</kbd>+left-drag</td></tr><tr><td>Pan</td><td><kbd>Alt</kbd>+middle-drag</td></tr><tr><td>Zoom</td><td><kbd>Alt</kbd>+right-drag <strong>sideways</strong>: right zooms in, left zooms out, as Maya&#x27;s own dolly</td></tr><tr><td>Invert the brush (subtract)</td><td>Hold <kbd>Ctrl</kbd> while sculpting</td></tr><tr><td>Paint a mask / erase it</td><td><kbd>Ctrl</kbd>+<kbd>Alt</kbd>+drag / <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Shift</kbd>+drag</td></tr><tr><td>Smooth</td><td>Hold <kbd>Shift</kbd> while sculpting</td></tr><tr><td>Visibility gestures</td><td><kbd>Ctrl</kbd>+<kbd>Shift</kbd>, as in the other styles</td></tr></tbody></table></div>
@@ -120,10 +120,10 @@
<p>The numpad views (<kbd>Numpad 1</kbd>, <kbd>3</kbd>, <kbd>7</kbd>, <kbd>5</kbd> ...) work in every style.</p>
<h3 id="your-own-blender-keymap">Your own Blender keymap<a class="anchor" href="#your-own-blender-keymap" aria-label="Link to this section">#</a></h3>
<p>If you changed Blender&#x27;s keys, export them in Blender (<strong>Edit &gt; Preferences &gt; Keymap</strong>, the <strong>Export...</strong> button next to the keymap name) and in SculptForge choose <strong>Import Blender keymap...</strong> under <strong>Edit &gt; Preferences &gt; Input</strong> or at the top of the Controls window. SculptForge switches to the Blender style and takes, from the file&#x27;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&#x27;t have are left alone; the status bar says how many keys it took. The file is read as text and never run. <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd> (Store Config) keeps the keys; <strong>Restore Standard UI</strong> goes back to the defaults.</p>
-<h2 id="zbrush-keys-that-work-differently">ZBrush keys that work differently<a class="anchor" href="#zbrush-keys-that-work-differently" aria-label="Link to this section">#</a></h2>
-<p>ZBrush&#x27;s keys and gestures work in SculptForge with the <a href="#zbrush-style-keys">ZBrush-style keys</a>. The few that differ even then, because the feature works differently or doesn&#x27;t exist yet:</p>
-<div class="table-wrap"><table><thead><tr><th>ZBrush</th><th>SculptForge</th></tr></thead><tbody><tr><td><kbd>P</kbd> (perspective)</td><td><kbd>P</kbd> is the Paint brush; <kbd>Numpad 5</kbd> switches to an orthographic view</td></tr><tr><td><kbd>T</kbd> (Edit mode)</td><td>Always in Edit mode: there is no 2.5D canvas</td></tr><tr><td><kbd>W</kbd> / <kbd>E</kbd> / <kbd>R</kbd> (Transpose line)</td><td>The Gizmo (see <a href="gizmo.html">Gizmo</a>)</td></tr><tr><td><kbd>1</kbd>, <kbd>2</kbd>, <kbd>3</kbd> (replay and record strokes)</td><td>Not yet</td></tr><tr><td><kbd>N</kbd> (list the SubTools)</td><td><strong>Tool &gt; Parts</strong> in the right tray</td></tr><tr><td><kbd>F1</kbd> to <kbd>F6</kbd> (pop-ups)</td><td><kbd>F1</kbd> is the Controls window, <kbd>F3</kbd> the command palette; <kbd>B</kbd>, <kbd>M</kbd> and the left-shelf tiles pop up brushes, strokes, alphas and materials</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>E</kbd> (edge loop), <kbd>Ctrl</kbd>+<kbd>U</kbd> (reload ZScript)</td><td>Export GLB and Send to Unreal</td></tr><tr><td><kbd>H</kbd> (hide the ZScript window)</td><td><kbd>`</kbd> toggles the console</td></tr></tbody></table></div>
-<p>See <a href="coming-from-zbrush.html">Coming from ZBrush</a> for the whole list.</p>
+<h2 id="classic-sculpting-keys-that-work-differently">Classic sculpting keys that work differently<a class="anchor" href="#classic-sculpting-keys-that-work-differently" aria-label="Link to this section">#</a></h2>
+<p>Most classic sculpting keys and gestures work in SculptForge with the <a href="#classic-sculpting-keys">Classic sculpting keys</a>. The few that differ even then, because the feature works differently or doesn&#x27;t exist yet:</p>
+<div class="table-wrap"><table><thead><tr><th>Classic key</th><th>SculptForge</th></tr></thead><tbody><tr><td><kbd>P</kbd> (perspective)</td><td><kbd>P</kbd> is the Paint brush; <kbd>Numpad 5</kbd> switches to an orthographic view</td></tr><tr><td><kbd>T</kbd> (Edit mode)</td><td>Always in Edit mode: there is no 2.5D canvas</td></tr><tr><td><kbd>W</kbd> / <kbd>E</kbd> / <kbd>R</kbd> (Transpose line)</td><td>The Gizmo (see <a href="gizmo.html">Gizmo</a>)</td></tr><tr><td><kbd>1</kbd>, <kbd>2</kbd>, <kbd>3</kbd> (replay and record strokes)</td><td>Not yet</td></tr><tr><td><kbd>N</kbd> (list the Parts)</td><td><strong>Tool &gt; Parts</strong> in the right tray</td></tr><tr><td><kbd>F1</kbd> to <kbd>F6</kbd> (pop-ups)</td><td><kbd>F1</kbd> is the Controls window, <kbd>F3</kbd> the command palette; <kbd>B</kbd>, <kbd>M</kbd> and the left-shelf tiles pop up brushes, strokes, alphas and materials</td></tr><tr><td><kbd>Ctrl</kbd>+<kbd>E</kbd> (edge loop), <kbd>Ctrl</kbd>+<kbd>U</kbd> (reload script)</td><td>Export GLB and Send to Unreal</td></tr><tr><td><kbd>H</kbd> (hide the script window)</td><td><kbd>`</kbd> toggles the console</td></tr></tbody></table></div>
+<p>See <a href="quick-tour.html">Quick tour for experienced sculptors</a> for the whole list.</p>
<h2 id="see-also">See also<a class="anchor" href="#see-also" aria-label="Link to this section">#</a></h2>
<ul>
<li>
@@ -144,7 +144,7 @@
<p class="guide-meta fine">Also in the app: <strong>Help &gt; User Guide</strong> (<kbd>Shift</kbd>+<kbd>F1</kbd>).
Found a mistake? <a href="https://github.com/islandmed/SculptForge/edit/main/docs/guide/shortcuts.md">Edit this page on GitHub</a>.</p>
</main>
- <aside class="on-page" aria-label="On this page"><p>On this page</p><ul><li><a href="#changing-shortcuts">Changing shortcuts</a></li><li><a href="#keyboard-shortcuts">Keyboard shortcuts</a></li><li><a href="#mouse-and-pen-gestures">Mouse and pen gestures</a></li><li><a href="#keys-inside-pop-ups-and-panels">Keys inside pop-ups and panels</a></li><li><a href="#zbrush-style-keys">ZBrush-style keys</a></li><li><a href="#maya-keys">Maya keys</a></li><li><a href="#blender-keys">Blender keys</a></li><li><a href="#zbrush-keys-that-work-differently">ZBrush keys that work differently</a></li><li><a href="#see-also">See also</a></li></ul></aside>
+ <aside class="on-page" aria-label="On this page"><p>On this page</p><ul><li><a href="#changing-shortcuts">Changing shortcuts</a></li><li><a href="#keyboard-shortcuts">Keyboard shortcuts</a></li><li><a href="#mouse-and-pen-gestures">Mouse and pen gestures</a></li><li><a href="#keys-inside-pop-ups-and-panels">Keys inside pop-ups and panels</a></li><li><a href="#classic-sculpting-keys">Classic sculpting keys</a></li><li><a href="#maya-keys">Maya keys</a></li><li><a href="#blender-keys">Blender keys</a></li><li><a href="#classic-sculpting-keys-that-work-differently">Classic sculpting keys that work differently</a></li><li><a href="#see-also">See also</a></li></ul></aside>
</div>
<footer class="footer">
<div class="wrap footer-grid">
@@ -161,8 +161,7 @@
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/splats.html b/website/guide/splats.html
index a6cb1dbe..dba408bd 100644
--- a/website/guide/splats.html
+++ b/website/guide/splats.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Gaussian splats - SculptForge User Guide">
<meta property="og:description" content="Gaussian splats are the format behind phone and photogrammetry captures from apps such as Polycam, Luma, Postshot, Scaniverse and KIRI. SculptForge uses them three ways: as a reference to sculpt against, as a source for a sculptable, animation-ready mesh with its colours, and as an output when you t">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/splats.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html" class="current" aria-current="page">Gaussian splats</a><ul class="toc-sections"><li><a href="#supported-files">Supported files</a></li><li><a href="#load-a-capture-as-a-reference">Load a capture as a reference</a></li><li><a href="#make-a-capture-sculptable">Make a capture sculptable</a></li><li><a href="#turn-a-sculpt-into-splats">Turn a sculpt into splats</a></li><li><a href="#save-splats">Save splats</a></li><li><a href="#from-scripts">From scripts</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html" class="current" aria-current="page">Gaussian splats</a><ul class="toc-sections"><li><a href="#supported-files">Supported files</a></li><li><a href="#load-a-capture-as-a-reference">Load a capture as a reference</a></li><li><a href="#make-a-capture-sculptable">Make a capture sculptable</a></li><li><a href="#turn-a-sculpt-into-splats">Turn a sculpt into splats</a></li><li><a href="#save-splats">Save splats</a></li><li><a href="#from-scripts">From scripts</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -136,8 +136,7 @@ An <strong>opacity</strong> slider (0.05 to 1) to see the sculpt through the cap
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/studios.html b/website/guide/studios.html
index c61c1ddf..e7a933ae 100644
--- a/website/guide/studios.html
+++ b/website/guide/studios.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="SculptForge for studios - SculptForge User Guide">
<meta property="og:description" content="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 ">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/studios.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html" class="current" aria-current="page">SculptForge for studios</a><ul class="toc-sections"><li><a href="#vfx-reference-platform-builds">VFX Reference Platform builds</a></li><li><a href="#deploy-with-rez">Deploy with Rez</a></li><li><a href="#studio-brush-libraries">Studio brush libraries</a></li><li><a href="#environment-variables">Environment variables</a></li><li><a href="#headless-and-farm-use">Headless and farm use</a></li><li><a href="#formats-in-a-pipeline">Formats in a pipeline</a></li><li><a href="#licensing">Licensing</a></li><li><a href="#studio-membership">Studio membership</a></li><li><a href="#studio-onboarding">Studio onboarding</a></li><li><a href="#not-yet">Not yet</a></li><li><a href="#see-also">See also</a></li></ul></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html" class="current" aria-current="page">SculptForge for studios</a><ul class="toc-sections"><li><a href="#vfx-reference-platform-builds">VFX Reference Platform builds</a></li><li><a href="#deploy-with-rez">Deploy with Rez</a></li><li><a href="#studio-brush-libraries">Studio brush libraries</a></li><li><a href="#environment-variables">Environment variables</a></li><li><a href="#headless-and-farm-use">Headless and farm use</a></li><li><a href="#formats-in-a-pipeline">Formats in a pipeline</a></li><li><a href="#licensing">Licensing</a></li><li><a href="#studio-membership">Studio membership</a></li><li><a href="#studio-onboarding">Studio onboarding</a></li><li><a href="#not-yet">Not yet</a></li><li><a href="#see-also">See also</a></li></ul></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -119,7 +119,7 @@ rez-env sculptforge -- sculptforge</code></pre><button class="copy" type="button
&#x27;</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
<p>A <code>--set</code> variable replaces a whole value, so pass complete paths (with their extensions) as variables.</p>
<h2 id="formats-in-a-pipeline">Formats in a pipeline<a class="anchor" href="#formats-in-a-pipeline" aria-label="Link to this section">#</a></h2>
-<div class="table-wrap"><table><thead><tr><th>Format</th><th>Read</th><th>Write</th><th>Notes</th></tr></thead><tbody><tr><td>OpenUSD (<code>.usda</code>, <code>.usdz</code>)</td><td>Yes</td><td>Yes</td><td>Meshes, xform ops, Z-up stages, UsdSkel blend shapes, ParticleField Gaussian splats, textures; checked with OpenUSD&#x27;s validators</td></tr><tr><td>FBX</td><td>Yes (any version)</td><td>Yes (7.4 binary)</td><td>LOD groups, blend shapes, centimetre units, textures; checked with ufbx&#x27;s strict mode</td></tr><tr><td>glTF / GLB</td><td>Yes</td><td>Yes</td><td>Morph targets, vertex colours, <code>KHR_gaussian_splatting</code>, embedded textures; checked with the Khronos validator</td></tr><tr><td>OBJ</td><td>Yes</td><td>Yes</td><td>Objects as Parts, groups as face groups, vertex colours, textures through <code>.mtl</code></td></tr><tr><td>PLY</td><td>Yes</td><td>Yes</td><td>Meshes with vertex colours, Gaussian splats</td></tr><tr><td>STL</td><td>Yes (binary and ASCII)</td><td>Yes (binary)</td><td></td></tr><tr><td>Send to ZBrush (GoZ-compatible exchange)</td><td>Yes</td><td>Yes</td><td>Face Groups, mask, vertex paint, UVs</td></tr><tr><td>SculptForge project (<code>.sfproj</code>)</td><td>Yes</td><td>Yes</td><td>Everything; a documented ZIP of JSON and binary arrays</td></tr></tbody></table></div>
+<div class="table-wrap"><table><thead><tr><th>Format</th><th>Read</th><th>Write</th><th>Notes</th></tr></thead><tbody><tr><td>OpenUSD (<code>.usda</code>, <code>.usdz</code>)</td><td>Yes</td><td>Yes</td><td>Meshes, xform ops, Z-up stages, UsdSkel blend shapes, ParticleField Gaussian splats, textures; checked with OpenUSD&#x27;s validators</td></tr><tr><td>FBX</td><td>Yes (any version)</td><td>Yes (7.4 binary)</td><td>LOD groups, blend shapes, centimetre units, textures; checked with ufbx&#x27;s strict mode</td></tr><tr><td>glTF / GLB</td><td>Yes</td><td>Yes</td><td>Morph targets, vertex colours, <code>KHR_gaussian_splatting</code>, embedded textures; checked with the Khronos validator</td></tr><tr><td>OBJ</td><td>Yes</td><td>Yes</td><td>Objects as Parts, groups as face groups, vertex colours, textures through <code>.mtl</code></td></tr><tr><td>PLY</td><td>Yes</td><td>Yes</td><td>Meshes with vertex colours, Gaussian splats</td></tr><tr><td>STL</td><td>Yes (binary and ASCII)</td><td>Yes (binary)</td><td></td></tr><tr><td>Bridge</td><td>Yes</td><td>Yes</td><td>Face Groups, mask, vertex paint, UVs</td></tr><tr><td>SculptForge project (<code>.sfproj</code>)</td><td>Yes</td><td>Yes</td><td>Everything; a documented ZIP of JSON and binary arrays</td></tr></tbody></table></div>
<p>Binary <code>.usdc</code> files and USD references or payloads aren&#x27;t read yet; convert with <code>usdcat in.usd -o out.usda</code>. The project format is described in <code>docs/project-format.md</code> in the source tree, so pipeline tools can read it without SculptForge.</p>
<h2 id="licensing">Licensing<a class="anchor" href="#licensing" aria-label="Link to this section">#</a></h2>
<p>SculptForge is free software under the GNU General Public License, version 3 or later. In practice:</p>
@@ -175,7 +175,7 @@ A <strong>private team channel</strong> on Discord, and your <strong>logo</stron
<strong>Macros</strong> and one-click workflows.
</li>
<li>
-<strong>Pipeline presets:</strong> export settings, naming, scale, axis, texture packing and ZBrush Bridge setup.
+<strong>Pipeline presets:</strong> export settings, naming, scale, axis, texture packing and Bridge setup.
</li>
<li>
<strong>Keymaps and layouts.</strong>
@@ -186,7 +186,7 @@ A <strong>private team channel</strong> on Discord, and your <strong>logo</stron
<p>Send, in one email or a message in your team channel:</p>
<ul>
<li>
-<strong>What to bake in:</strong> your exported keymap and layout (<strong>Edit &gt; Preferences &gt; Interface</strong>), brush presets and packs (<code>.sfbrush</code>, <code>.sfpack</code>), shelf setup, and the pipeline defaults you want (export format and preset, units and scale, up axis, naming pattern, texture packing, ZBrush Bridge folder).
+<strong>What to bake in:</strong> your exported keymap and layout (<strong>Edit &gt; Preferences &gt; Interface</strong>), brush presets and packs (<code>.sfbrush</code>, <code>.sfpack</code>), shelf setup, and the pipeline defaults you want.
</li>
<li>
<strong>References for custom content:</strong> images or scans you own, with a line on what each item should do.
@@ -206,7 +206,7 @@ A <strong>private team channel</strong> on Discord, and your <strong>logo</stron
<a href="scripting.html">Scripting and automation</a>
</li>
<li>
-<a href="exporting.html">Exporting, Send to Unreal and ZBrush</a>
+<a href="exporting.html">Exporting, Unreal and Bridge</a>
</li>
<li>
<a href="brush-lab.html">Brush Lab and sharing brushes</a>
@@ -240,8 +240,7 @@ A <strong>private team channel</strong> on Discord, and your <strong>logo</stron
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/subdivision-levels.html b/website/guide/subdivision-levels.html
index 7910b5ea..522028d9 100644
--- a/website/guide/subdivision-levels.html
+++ b/website/guide/subdivision-levels.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Subdivision levels - SculptForge User Guide</title>
- <meta name="description" content="Subdivision levels let you sculpt one model at several resolutions, as with ZBrush&#x27;s SDiv: block in the big forms on a light version of the mesh, add pores and wrinkles on a dense one, and go back down to change the silhouette without losing the detail. Every Part has its own levels.">
+ <meta name="description" content="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.">
<meta name="theme-color" content="#111114">
<meta name="color-scheme" content="dark">
<link rel="icon" type="image/svg+xml" href="../img/favicon.svg?v=2">
@@ -13,8 +13,8 @@
<link rel="canonical" href="https://sculptforge.app/guide/subdivision-levels.html">
<meta property="og:type" content="article">
<meta property="og:title" content="Subdivision levels - SculptForge User Guide">
- <meta property="og:description" content="Subdivision levels let you sculpt one model at several resolutions, as with ZBrush&#x27;s SDiv: block in the big forms on a light version of the mesh, add pores and wrinkles on a dense one, and go back down to change the silhouette without losing the detail. Every Part has its own levels.">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:description" content="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.">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/subdivision-levels.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,13 +46,13 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html" class="current" aria-current="page">Subdivision levels</a><ul class="toc-sections"><li><a href="#divide">Divide</a></li><li><a href="#stepping-between-levels">Stepping between levels</a></li><li><a href="#what-follows-the-levels">What follows the levels</a></li><li><a href="#del-lower-and-del-higher">Del Lower and Del Higher</a></li><li><a href="#reconstruct-subdiv">Reconstruct Subdiv</a></li><li><a href="#undo-projects-and-exporting">Undo, projects and exporting</a></li><li><a href="#commands">Commands</a></li><li><a href="#speed-and-memory">Speed and memory</a></li><li><a href="#past-the-highest-level">Past the highest level</a></li></ul></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html" class="current" aria-current="page">Subdivision levels</a><ul class="toc-sections"><li><a href="#divide">Divide</a></li><li><a href="#stepping-between-levels">Stepping between levels</a></li><li><a href="#what-follows-the-levels">What follows the levels</a></li><li><a href="#del-lower-and-del-higher">Del Lower and Del Higher</a></li><li><a href="#reconstruct-subdiv">Reconstruct Subdiv</a></li><li><a href="#undo-projects-and-exporting">Undo, projects and exporting</a></li><li><a href="#commands">Commands</a></li><li><a href="#speed-and-memory">Speed and memory</a></li><li><a href="#past-the-highest-level">Past the highest level</a></li></ul></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
<article class="guide-article">
<h1 id="subdivision-levels">Subdivision levels</h1>
-<p>Subdivision levels let you sculpt one model at several resolutions, as with ZBrush&#x27;s <strong>SDiv</strong>: 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.</p>
+<p>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.</p>
<figure class="shot"><a href="images/subdivision-levels.jpg" class="zoom"><img src="images/subdivision-levels.jpg" alt="A cube cage, a middle level and the top level of the same sculpt" width="1200" height="370" loading="lazy" decoding="async"></a><figcaption>A cube cage, a middle level and the top level of the same sculpt</figcaption></figure>
<p>Everything is in <strong>Tool &gt; Geometry</strong>:</p>
<div class="table-wrap"><table><thead><tr><th>Control</th><th>Shortcut</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Divide</strong></td><td><kbd>Ctrl</kbd>+<kbd>D</kbd></td><td>Adds a level above the highest one and steps to it</td></tr><tr><td><strong>Smt</strong></td><td></td><td>Smooths the next Divide (on by default)</td></tr><tr><td><strong>Lower Res</strong></td><td><kbd>Shift</kbd>+<kbd>D</kbd></td><td>Steps one level down</td></tr><tr><td><strong>Higher Res</strong></td><td><kbd>D</kbd></td><td>Steps one level up</td></tr><tr><td><strong>SDiv</strong> slider</td><td></td><td>Steps to any level (1 is the base cage)</td></tr><tr><td><strong>Del Lower</strong></td><td></td><td>Deletes the levels below the current one</td></tr><tr><td><strong>Del Higher</strong></td><td></td><td>Deletes the levels above the current one</td></tr><tr><td><strong>Reconstruct Subdiv</strong></td><td></td><td>Finds a lower level for a mesh that was subdivided elsewhere</td></tr></tbody></table></div>
@@ -64,7 +64,7 @@
<strong>Quads stay quads.</strong> 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 <strong>New Sphere</strong>, a scan) is divided with Loop subdivision: each triangle becomes four.
</li>
<li>
-<strong>Smt</strong> (next to Divide) smooths the new level, rounding off the shape the way ZBrush does. Turn it off to divide flat: the new level keeps the hard edges and flat faces of the one below, for hard-surface pieces.
+<strong>Smt</strong> (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.
</li>
<li>
Divide always adds the level on top. If you are at a lower level it steps to the highest first.
@@ -103,10 +103,10 @@ How far you can divide depends on your computer&#x27;s memory: about 160 million
It works at the lowest level (SDiv 1).
</li>
<li>
-The mesh must be a regular subdivision: all quads from Catmull-Clark subdivision (Blender&#x27;s Subdivision Surface, Maya&#x27;s Smooth, ZBrush&#x27;s Divide), or all triangles from Loop subdivision. Otherwise it says so and leaves the mesh alone.
+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.
</li>
<li>
-The vertices of the new lower level sit on the dense mesh&#x27;s corner vertices, as in ZBrush.
+The vertices of the new lower level sit on the dense mesh&#x27;s corner vertices.
</li>
</ul>
<aside class="callout callout-tip"><p><strong>Tip:</strong> The <strong>Cube</strong> from <strong>Tool &gt; Parts &gt; Append</strong> is a regular quad grid, so Reconstruct Subdiv takes it down to a 3 x 3 cube in four steps.</p></aside>
@@ -119,10 +119,10 @@ The vertices of the new lower level sit on the dense mesh&#x27;s corner vertices
<strong>Projects</strong> (<code>.sfproj</code>) 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.
</li>
<li>
-<strong>Exports and Send to ZBrush</strong> write the current level. To write another one, step to it first, or use the <code>subdiv_export</code> command (<code>subdiv_export path=base.obj level=1</code> writes the base cage of every visible Part, in any export format). LODs and <strong>Send to Unreal</strong> start from the current level too.
+<strong>Exports and Bridge</strong> write the current level. To write another one, step to it first, or use the <code>subdiv_export</code> command (<code>subdiv_export path=base.obj level=1</code> writes the base cage of every visible Part, in any export format). LODs and <strong>Send to Unreal</strong> start from the current level too.
</li>
<li>
-<strong>Tools that rebuild the mesh</strong> (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. <em>Subdivision levels removed: SDiv 3 of 5 kept as the new base (undo restores them)</em>. <kbd>Ctrl</kbd>+<kbd>Z</kbd> brings every level back, at the level you were on. Merging and splitting Parts can&#x27;t be undone (as in ZBrush), so step to the level you want to keep first, or save before.
+<strong>Tools that rebuild the mesh</strong> (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. <em>Subdivision levels removed: SDiv 3 of 5 kept as the new base (undo restores them)</em>. <kbd>Ctrl</kbd>+<kbd>Z</kbd> brings every level back, at the level you were on. Merging and splitting Parts can&#x27;t be undone, so step to the level you want to keep first, or save before.
</li>
</ul>
<aside class="callout callout-note"><p><strong>Note:</strong> <strong>Subdivide</strong> (in <strong>Tool &gt; Geometry</strong>, below Divide) is still there: it replaces the mesh with a denser one and keeps no levels. Use Divide unless you want exactly that.</p></aside>
@@ -133,7 +133,6 @@ The vertices of the new lower level sit on the dense mesh&#x27;s corner vertices
<p>Measured on an Apple M1 Pro (Asahi Linux), a cube divided four times to 6.5 million triangles:</p>
<div class="table-wrap"><table><thead><tr><th></th><th>1.6M triangles at the top</th><th>6.5M triangles at the top</th></tr></thead><tbody><tr><td>Divide to the top level</td><td>0.4 s</td><td>4.3 s</td></tr><tr><td>Step down / up between visited levels</td><td>1-4 ms</td><td>0.1-45 ms</td></tr><tr><td>Step down right after sculpting the top</td><td>0.05-0.13 s</td><td>0.2-0.6 s</td></tr><tr><td>Step up after reshaping the base</td><td>0.05-0.15 s</td><td>0.6 s</td></tr><tr><td>Memory for all levels</td><td>120 MB</td><td>480 MB</td></tr></tbody></table></div>
<p>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>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> Divide, Smt, Lower Res, Higher Res, SDiv, Del Lower, Del Higher and Reconstruct Subdiv work as in ZBrush. Not yet: Freeze SubDivision Levels, Cage, Rstr, Suv (UV smoothing on divide) and creased edges.</p></aside>
<h2 id="past-the-highest-level">Past the highest level<a class="anchor" href="#past-the-highest-level" aria-label="Link to this section">#</a></h2>
<p>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 <a href="micro-levels.html">Micro levels</a>.</p>
</article>
@@ -158,8 +157,7 @@ The vertices of the new lower level sit on the dense mesh&#x27;s corner vertices
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/subtools.html b/website/guide/subtools.html
deleted file mode 100644
index 3074c181..00000000
--- a/website/guide/subtools.html
+++ /dev/null
@@ -1,13 +0,0 @@
-<!doctype html>
-<html lang="en">
-<head>
- <meta charset="utf-8">
- <title>Moved - SculptForge User Guide</title>
- <meta name="robots" content="noindex">
- <link rel="canonical" href="https://sculptforge.app/guide/parts.html">
- <meta http-equiv="refresh" content="0; url=parts.html">
-</head>
-<body>
- <p>This chapter has moved to <a href="parts.html">https://sculptforge.app/guide/parts.html</a>.</p>
-</body>
-</html>
diff --git a/website/guide/texture-painting.html b/website/guide/texture-painting.html
index d91a0cac..03a8a842 100644
--- a/website/guide/texture-painting.html
+++ b/website/guide/texture-painting.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Texture painting - SculptForge User Guide">
<meta property="og:description" content="Texture painting puts the colour into an image laid over the model&#x27;s UVs, instead of on its vertices. The detail you can paint then comes from the texture&#x27;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 c">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/texture-painting.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html" class="current" aria-current="page">Texture painting</a><ul class="toc-sections"><li><a href="#start-in-one-click">Start in one click</a></li><li><a href="#paint-a-texture-in-four-steps">Paint a texture in four steps</a></li><li><a href="#vertex-or-texture">Vertex or Texture</a></li><li><a href="#how-texture-painting-works">How texture painting works</a></li><li><a href="#paint-layers-on-a-texture">Paint layers on a texture</a></li><li><a href="#convert-between-vertex-paint-and-texture">Convert between vertex paint and texture</a></li><li><a href="#import-and-export">Import and export</a></li><li><a href="#uvs-and-geometry">UVs and geometry</a></li><li><a href="#scripting">Scripting</a></li></ul></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html" class="current" aria-current="page">Texture painting</a><ul class="toc-sections"><li><a href="#start-in-one-click">Start in one click</a></li><li><a href="#paint-a-texture-in-four-steps">Paint a texture in four steps</a></li><li><a href="#vertex-or-texture">Vertex or Texture</a></li><li><a href="#how-texture-painting-works">How texture painting works</a></li><li><a href="#paint-layers-on-a-texture">Paint layers on a texture</a></li><li><a href="#convert-between-vertex-paint-and-texture">Convert between vertex paint and texture</a></li><li><a href="#import-and-export">Import and export</a></li><li><a href="#uvs-and-geometry">UVs and geometry</a></li><li><a href="#scripting">Scripting</a></li></ul></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -63,7 +63,7 @@
Open <strong>Tool &gt; Texture Map</strong> in the right tray.
</li>
<li>
-If the Part has no UVs (the sub-palette says &quot;No UVs&quot;), click <strong>Auto UV</strong>. SculptForge cuts the model into UV islands and packs them into the texture square. It works in the background with a progress bar; on a few hundred thousand triangles it takes seconds, on millions it can take a minute or more. Models imported with UVs (from ZBrush, Maya, Blender...) already have them: skip this step.
+If the Part has no UVs (the sub-palette says &quot;No UVs&quot;), click <strong>Auto UV</strong>. 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.
</li>
<li>
Choose a size (<strong>1K</strong>, <strong>2K</strong>, <strong>4K</strong> or <strong>8K</strong>; 2K is the default) and click <strong>New Texture</strong>. The model now carries a white texture, and painting goes into it: <strong>Texture</strong> lights up next to <strong>Vertex</strong> on the top shelf.
@@ -129,7 +129,7 @@ One stroke is one undo step. SculptForge stores only the 64x64-texel tiles the s
Projects (<code>.sfproj</code>) save the texture with all its layers, blend modes and settings.
</li>
<li>
-Exporting the model writes the texture next to it as a PNG and references it, so other apps pick it up: OBJ writes a <code>.mtl</code> material with <code>map_Kd</code>; glTF/GLB embeds it as the base colour texture; USD binds a preview material that reads it; FBX and GoZ-compatible export write the PNG beside the file. See <a href="exporting.html">Exporting</a>.
+Exporting the model writes the texture next to it as a PNG and references it, so other apps pick it up: OBJ writes a <code>.mtl</code> material with <code>map_Kd</code>; 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 <a href="exporting.html">Exporting</a>.
</li>
<li>
<strong>Delete Texture</strong> removes it (undoable); painting goes back to the vertices.
@@ -156,7 +156,6 @@ Auto UV on dense meshes: the islands are kept to about 4,000 triangles each, so
UVs outside the 0-1 square (other UDIM tiles) aren&#x27;t painted yet; the <a href="uv-editor.html">UV Editor</a> lays them out.
</li>
</ul>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> ZBrush paints polypaint and converts it to a texture afterwards (<strong>Texture Map &gt; New From Polypaint</strong>). SculptForge can do both: paint the texture directly, or bake vertex paint with <strong>Vertex Paint &gt; Texture</strong>. <strong>Auto UV</strong> plays the part of UV Master&#x27;s Unwrap.</p></aside>
<h2 id="scripting">Scripting<a class="anchor" href="#scripting" aria-label="Link to this section">#</a></h2>
<div class="table-wrap"><table><thead><tr><th>Command</th><th>What it does</th></tr></thead><tbody><tr><td><code>uv_auto</code></td><td>Unwrap the active Part (xatlas); <code>resolution=4096</code> packs the islands for that texture size. A painted texture moves onto the new UVs (<code>keep_texture=false</code> leaves it as it was)</td></tr><tr><td><code>texture_create size=2048</code></td><td>Give the Part a texture (1024, 2048, 4096, 8192 or <code>1k</code>...<code>8k</code>) and paint into it; <code>from_polypaint=true</code> starts from the vertex paint</td></tr><tr><td><code>paint_target target=texture</code></td><td>Where painting goes: <code>vertex</code> or <code>texture</code></td></tr><tr><td><code>texture_from_polypaint</code></td><td>Bake the vertex paint into the active texture layer</td></tr><tr><td><code>polypaint_from_texture</code></td><td>Copy the texture into the vertex paint</td></tr><tr><td><code>texture_export path=skin.png</code></td><td>Save the texture as a PNG</td></tr><tr><td><code>texture_import path=skin.png</code></td><td>Load an image as the texture</td></tr><tr><td><code>texture_delete</code></td><td>Remove the texture</td></tr></tbody></table></div>
<p><code>remesh</code>, <code>qremesh</code>, <code>subtool_merge_down</code> and <code>subtool_merge_visible</code> keep a texture unless you add <code>keep_texture=false</code>.</p>
@@ -183,8 +182,7 @@ UVs outside the 0-1 square (other UDIM tiles) aren&#x27;t painted yet; the <a hr
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/timeline.html b/website/guide/timeline.html
index 045f1b95..5eee167c 100644
--- a/website/guide/timeline.html
+++ b/website/guide/timeline.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Sculpt Timeline and timelapse - SculptForge User Guide">
<meta property="og:description" content="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 &gt; Preferences &gt; Interface &gt; 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: ">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/timeline.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html" class="current" aria-current="page">Sculpt Timeline and timelapse</a><ul class="toc-sections"><li><a href="#the-strip">The strip</a></li><li><a href="#branches-undo-without-losing-anything">Branches: undo without losing anything</a></li><li><a href="#re-tuning-a-past-stroke">Re-tuning a past stroke</a></li><li><a href="#big-meshes">Big meshes</a></li><li><a href="#saving-the-history">Saving the history</a></li><li><a href="#timelapse-video">Timelapse video</a></li><li><a href="#scripting">Scripting</a></li></ul></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html" class="current" aria-current="page">Sculpt Timeline and timelapse</a><ul class="toc-sections"><li><a href="#the-strip">The strip</a></li><li><a href="#branches-undo-without-losing-anything">Branches: undo without losing anything</a></li><li><a href="#re-tuning-a-past-stroke">Re-tuning a past stroke</a></li><li><a href="#big-meshes">Big meshes</a></li><li><a href="#saving-the-history">Saving the history</a></li><li><a href="#timelapse-video">Timelapse video</a></li><li><a href="#scripting">Scripting</a></li></ul></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -115,8 +115,7 @@ The header shows the step you are at, the number of branches and the step&#x27;s
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/troubleshooting.html b/website/guide/troubleshooting.html
index c6cb2d20..01da8b89 100644
--- a/website/guide/troubleshooting.html
+++ b/website/guide/troubleshooting.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Troubleshooting: tablets, display, crashes and FAQ - SculptForge User Guide">
<meta property="og:description" content="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.">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/troubleshooting.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html" class="current" aria-current="page">Troubleshooting: tablets, display, crashes and FAQ</a><ul class="toc-sections"><li><a href="#sculptforge-doesnt-start">SculptForge doesn&#x27;t start</a></li><li><a href="#first-launch-warnings-on-macos-and-windows">First launch warnings on macOS and Windows</a></li><li><a href="#the-viewport-is-slow">The viewport is slow</a></li><li><a href="#pen-tablets">Pen tablets</a></li><li><a href="#ai-services">AI services</a></li><li><a href="#comfyui-errors">ComfyUI errors</a></li><li><a href="#the-interface">The interface</a></li><li><a href="#where-settings-live">Where settings live</a></li><li><a href="#the-log-file">The log file</a></li><li><a href="#recovering-work-after-a-crash">Recovering work after a crash</a></li><li><a href="#frequently-asked-questions">Frequently asked questions</a></li><li><a href="#report-a-problem">Report a problem</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html" class="current" aria-current="page">Troubleshooting: tablets, display, crashes and FAQ</a><ul class="toc-sections"><li><a href="#sculptforge-doesnt-start">SculptForge doesn&#x27;t start</a></li><li><a href="#first-launch-warnings-on-macos-and-windows">First launch warnings on macOS and Windows</a></li><li><a href="#the-viewport-is-slow">The viewport is slow</a></li><li><a href="#pen-tablets">Pen tablets</a></li><li><a href="#ai-services">AI services</a></li><li><a href="#comfyui-errors">ComfyUI errors</a></li><li><a href="#the-interface">The interface</a></li><li><a href="#where-settings-live">Where settings live</a></li><li><a href="#the-log-file">The log file</a></li><li><a href="#recovering-work-after-a-crash">Recovering work after a crash</a></li><li><a href="#frequently-asked-questions">Frequently asked questions</a></li><li><a href="#report-a-problem">Report a problem</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -54,7 +54,7 @@
<h1 id="troubleshooting-tablets-display-crashes-and-faq">Troubleshooting: tablets, display, crashes and FAQ</h1>
<p>This chapter collects fixes for common problems: start-up and graphics errors, tablets, AI service messages, ComfyUI errors, the camera notch, first-launch warnings on macOS and Windows, where SculptForge keeps its settings, how to reset the interface, and how to report a bug.</p>
<p>Quick answers:</p>
-<div class="table-wrap"><table><thead><tr><th>Problem</th><th>Fix</th></tr></thead><tbody><tr><td>No pen pressure on Windows</td><td>Switch <strong>Windows Ink</strong> in the tablet driver and bring the pen back (<a href="#pen-tablets">Pen tablets</a>)</td></tr><tr><td>The cursor jumps when the pen touches down</td><td><strong>Edit &gt; Preferences &gt; Tablet &gt; Mouse mode (relative)</strong></td></tr><tr><td>&quot;Windows protected your PC&quot;</td><td><strong>More info</strong>, then <strong>Run anyway</strong> (<a href="#first-launch-warnings-on-macos-and-windows">First launch warnings</a>)</td></tr><tr><td>Text and buttons too small or too large</td><td><strong>Edit &gt; Preferences &gt; Interface &gt; UI scale</strong> (<a href="#text-and-buttons-are-too-small-or-too-large">details</a>)</td></tr><tr><td>Menus or shelves look wrong after an update</td><td><strong>Edit &gt; Preferences &gt; Config &gt; Restore Standard UI</strong> (<a href="#reset-the-interface">Reset the interface</a>)</td></tr><tr><td>Sculpting feels slow</td><td><a href="#the-viewport-is-slow">The viewport is slow</a></td></tr><tr><td>Lost work after a crash</td><td><a href="#recovering-work-after-a-crash">Recovering work after a crash</a></td></tr><tr><td>Want the ZBrush layout back</td><td><strong>Edit &gt; Preferences &gt; Interface &gt; Look &gt; Layout &gt; ZBrush-style</strong></td></tr></tbody></table></div>
+<div class="table-wrap"><table><thead><tr><th>Problem</th><th>Fix</th></tr></thead><tbody><tr><td>No pen pressure on Windows</td><td>Switch <strong>Windows Ink</strong> in the tablet driver and bring the pen back (<a href="#pen-tablets">Pen tablets</a>)</td></tr><tr><td>The cursor jumps when the pen touches down</td><td><strong>Edit &gt; Preferences &gt; Tablet &gt; Mouse mode (relative)</strong></td></tr><tr><td>&quot;Windows protected your PC&quot;</td><td><strong>More info</strong>, then <strong>Run anyway</strong> (<a href="#first-launch-warnings-on-macos-and-windows">First launch warnings</a>)</td></tr><tr><td>Text and buttons too small or too large</td><td><strong>Edit &gt; Preferences &gt; Interface &gt; UI scale</strong> (<a href="#text-and-buttons-are-too-small-or-too-large">details</a>)</td></tr><tr><td>Menus or shelves look wrong after an update</td><td><strong>Edit &gt; Preferences &gt; Config &gt; Restore Standard UI</strong> (<a href="#reset-the-interface">Reset the interface</a>)</td></tr><tr><td>Sculpting feels slow</td><td><a href="#the-viewport-is-slow">The viewport is slow</a></td></tr><tr><td>Lost work after a crash</td><td><a href="#recovering-work-after-a-crash">Recovering work after a crash</a></td></tr><tr><td>Want the Classic layout back</td><td><strong>Edit &gt; Preferences &gt; Interface &gt; Look &gt; Layout &gt; Classic</strong></td></tr></tbody></table></div>
<h2 id="sculptforge-doesnt-start">SculptForge doesn&#x27;t start<a class="anchor" href="#sculptforge-doesnt-start" aria-label="Link to this section">#</a></h2>
<p>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.</p>
<ol>
@@ -180,7 +180,7 @@ If the cursor moves but strokes have no pressure, test in another application to
<h3 id="text-and-buttons-are-too-small-or-too-large">Text and buttons are too small or too large<a class="anchor" href="#text-and-buttons-are-too-small-or-too-large" aria-label="Link to this section">#</a></h3>
<p><strong>Edit &gt; Preferences &gt; Interface &gt; UI scale</strong> sets the size (Automatic, 100% to 200%) and applies it at once. Press <strong>Store Config</strong> (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd>) to keep it for the next start. <strong>Automatic</strong> uses the scale of the monitor the window is on: on Windows that is <strong>Settings &gt; Display &gt; Scale</strong>, per monitor, and the interface follows when you drag the window to another monitor. On Linux under X11 it comes from the desktop&#x27;s font DPI (Xft.dpi); if Automatic looks wrong there, pick a size.</p>
<h3 id="my-layout-or-shortcuts-are-gone-after-a-restart">My layout or shortcuts are gone after a restart<a class="anchor" href="#my-layout-or-shortcuts-are-gone-after-a-restart" aria-label="Link to this section">#</a></h3>
-<p>Like ZBrush, SculptForge never saves the layout on its own. Press <strong>Store Config</strong> (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd>) to keep the current layout, shortcuts and interface preferences. See <a href="interface.html">The interface</a>.</p>
+<p>SculptForge never saves the layout on its own. Press <strong>Store Config</strong> (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd>) to keep the current layout, shortcuts and interface preferences. See <a href="interface.html">The interface</a>.</p>
<h3 id="reset-the-interface">Reset the interface<a class="anchor" href="#reset-the-interface" aria-label="Link to this section">#</a></h3>
<ul>
<li>
@@ -208,8 +208,8 @@ To start completely fresh, quit SculptForge and delete <code>ui.json</code> (lay
<h2 id="recovering-work-after-a-crash">Recovering work after a crash<a class="anchor" href="#recovering-work-after-a-crash" aria-label="Link to this section">#</a></h2>
<p>SculptForge autosaves unsaved work every 5 minutes by default (<strong>Edit &gt; Preferences &gt; Autosave</strong>, 0 turns it off). After a crash, the next start asks &quot;SculptForge did not close normally last time. Restore the autosaved work?&quot;. <strong>Restore</strong> opens it as unsaved work (save it under a name); <strong>Discard</strong> deletes it. See <a href="projects.html">Projects, autosave and snapshots</a>. The dialog also points to the crashed session&#x27;s <a href="#the-log-file">log file</a>.</p>
<h2 id="frequently-asked-questions">Frequently asked questions<a class="anchor" href="#frequently-asked-questions" aria-label="Link to this section">#</a></h2>
-<p><strong>Can SculptForge open ZBrush files (.ZTL, .ZPR)?</strong> Not directly: they are proprietary and undocumented. Convert ZTools once in ZBrush with the free <strong>SculptForge ZTL Export</strong> plug-in, then open the <code>.ZTL</code> in SculptForge (see <a href="coming-from-zbrush.html#bring-your-ztools-over">Coming from ZBrush</a>). Or use Send to ZBrush, or export OBJ or FBX from ZBrush (see <a href="exporting.html#exchange-models-with-zbrush-send-to-zbrush">Exporting, Send to Unreal and ZBrush</a>). <code>.ZPR</code> projects can&#x27;t be converted; open their ZTools instead.</p>
-<p><strong>Does it have subdivision levels, DynaMesh, ZRemesher or UVs?</strong> Voxel remesh works like DynaMesh, <strong>Quad Remesh</strong> like ZRemesher (with <strong>Project All</strong> to bring the detail back; see <a href="retopology.html">Quad retopology</a>), <strong>Auto UV</strong> unwraps any model, and Divide adds subdivision levels you can step up and down (see <a href="subdivision-levels.html">Subdivision levels</a>). <strong>Dynamic</strong> on the top shelf is dynamic topology, like Sculptris Pro (see <a href="dynamic-topology.html">Dynamic topology</a>).</p>
+<p><strong>Can SculptForge open another sculpting app&#x27;s own project files?</strong> Not directly: those formats are proprietary and undocumented. Export OBJ or FBX from that app, use the <a href="exporting.html#exchange-models-through-the-bridge">Bridge</a>, or convert a whole library once with the free Bridge export plug-in (see the <a href="https://github.com/islandmed/SculptForge/blob/main/integrations/bridge-plugin/README.md" rel="noopener">Bridge setup page</a>).</p>
+<p><strong>Does it have subdivision levels, voxel remesh, quad remesh or UVs?</strong> Yes: <strong>Voxel Remesh</strong>, <strong>Quad Remesh</strong> (with <strong>Project All</strong> to bring the detail back; see <a href="retopology.html">Quad retopology</a>), <strong>Auto UV</strong> unwraps any model, and Divide adds subdivision levels you can step up and down (see <a href="subdivision-levels.html">Subdivision levels</a>). <strong>Dynamic</strong> on the top shelf is dynamic topology, like dynamic topology (see <a href="dynamic-topology.html">Dynamic topology</a>).</p>
<p><strong>Is it really free? Can I sell what I make?</strong> 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 <a href="generate-3d.html#privacy-and-model-licences">Image and text to 3D</a>).</p>
<p><strong>Does SculptForge send anything about me anywhere?</strong> No. There is no telemetry and no account. AI features talk only to the service you choose, when you use them.</p>
<p><strong>Does it work offline?</strong> 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).</p>
@@ -271,8 +271,7 @@ To start completely fresh, quit SculptForge and delete <code>ui.json</code> (lay
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/uv-editor.html b/website/guide/uv-editor.html
index 2b12a187..77cab02c 100644
--- a/website/guide/uv-editor.html
+++ b/website/guide/uv-editor.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="UV Editor - SculptForge User Guide">
<meta property="og:description" content="The UV Editor shows a Part&#x27;s UVs flat, over the texture&#x27;s tiles, and gives you everything to make them: seams drawn on the model, unwrapping that keeps the surface&#x27;s shape, packing into one tile or across UDIM tiles, texel density, trim sheets, and hand editing of vertices, edges, faces and islands.">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/uv-editor.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html" class="current" aria-current="page">UV Editor</a><ul class="toc-sections"><li><a href="#the-window">The window</a></li><li><a href="#selecting">Selecting</a></li><li><a href="#moving-rotating-and-scaling">Moving, rotating and scaling</a></li><li><a href="#seams">Seams</a></li><li><a href="#unwrapping">Unwrapping</a></li><li><a href="#packing-and-udim-tiles">Packing and UDIM tiles</a></li><li><a href="#texel-density">Texel density</a></li><li><a href="#trim-sheets">Trim sheets</a></li><li><a href="#editing">Editing</a></li><li><a href="#paint-stays-on-the-model">Paint stays on the model</a></li><li><a href="#undo">Undo</a></li><li><a href="#scripting">Scripting</a></li><li><a href="#limits">Limits</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html" class="current" aria-current="page">UV Editor</a><ul class="toc-sections"><li><a href="#the-window">The window</a></li><li><a href="#selecting">Selecting</a></li><li><a href="#moving-rotating-and-scaling">Moving, rotating and scaling</a></li><li><a href="#seams">Seams</a></li><li><a href="#unwrapping">Unwrapping</a></li><li><a href="#packing-and-udim-tiles">Packing and UDIM tiles</a></li><li><a href="#texel-density">Texel density</a></li><li><a href="#trim-sheets">Trim sheets</a></li><li><a href="#editing">Editing</a></li><li><a href="#paint-stays-on-the-model">Paint stays on the model</a></li><li><a href="#undo">Undo</a></li><li><a href="#scripting">Scripting</a></li><li><a href="#limits">Limits</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -158,7 +158,7 @@ Click to select (<kbd>Shift</kbd> adds, <kbd>Ctrl</kbd> removes); drag on an emp
<h2 id="scripting">Scripting<a class="anchor" href="#scripting" aria-label="Link to this section">#</a></h2>
<p>Every operation is a command, for scripts, <code>sculptforge-cli</code>, Python (<code>sf.run(doc, &quot;uv_unwrap&quot;, method=&quot;isometric&quot;)</code>) and the AI assistant. &quot;The selection&quot; is the UV Editor&#x27;s (set it with <code>uv_select</code>); with nothing selected the commands work on the whole Part.</p>
<div class="table-wrap"><table><thead><tr><th>Command</th><th>What it does</th></tr></thead><tbody><tr><td><code>uv_unwrap</code></td><td>Unwrap: <code>method=isometric</code> (Least Stretch), <code>conformal</code>, <code>polygroups</code> (By Face Groups), <code>planar</code>, <code>unfold</code> or <code>auto</code>; <code>iterations=</code>, <code>selected=</code>, <code>tiles=</code>, <code>margin=</code>, <code>rotate=</code>, <code>density=</code>, <code>pack=false</code> (fit in place), <code>keep_texture=</code></td></tr><tr><td><code>uv_pack</code></td><td>Pack: <code>margin=</code> (texels), <code>tiles=</code> (UDIM tiles), <code>first_tile=</code>, <code>rotate=</code>, <code>equal_density=</code>, <code>density=</code> (texels per unit, as many tiles as needed), <code>resolution=</code>, <code>keep_texture=</code></td></tr><tr><td><code>uv_seam</code></td><td>Seams: <code>op=mark</code> / <code>clear</code> (the selection), <code>path from= to=</code> (shortest edge path between two vertices; <code>clear=true</code>), <code>polygroups</code>, <code>islands</code>, <code>angle angle=60</code>, <code>clear_all</code></td></tr><tr><td><code>uv_select</code></td><td><code>op=all</code>, <code>none</code>, <code>invert</code>, <code>island face=</code>, <code>face face=</code>, <code>polygroup group=</code>, <code>rect u0= v0= u1= v1=</code>, <code>seams</code>, <code>mode</code>; <code>mode=vertex/edge/face/island</code>, <code>add=true</code></td></tr><tr><td><code>uv_transform</code></td><td><code>move_u=</code>, <code>move_v=</code>, <code>rotate=</code> (degrees), <code>scale=</code>, <code>scale_u=</code>, <code>scale_v=</code> about the selection&#x27;s centre</td></tr><tr><td><code>uv_edit</code></td><td><code>op=pin</code>, <code>unpin</code>, <code>clear_pins</code>, <code>weld</code>, <code>split</code>, <code>straighten</code>, <code>flip_u</code>, <code>flip_v</code></td></tr><tr><td><code>uv_density</code></td><td><code>op=set value=</code>, <code>op=match</code> (<code>match=mean</code> or <code>first</code>), <code>op=info</code>; <code>resolution=</code></td></tr><tr><td><code>uv_trim</code></td><td><code>strip=2 strips=4</code> (or <code>0.5,0.25,0.25</code> or <code>0-0.5;0.5-1</code>), <code>fit_width=</code>, <code>margin=</code></td></tr><tr><td><code>uv_info</code></td><td>Islands, seams, pins, texel density, the UDIM tiles in use and the mean stretch</td></tr></tbody></table></div>
-<div class="code-block"><pre class="code"><code>uv_seam op=polygroups
+<div class="code-block"><pre class="code"><code>uv_seam op=face groups
uv_unwrap method=isometric
uv_pack tiles=2 margin=8
uv_density op=match
@@ -172,7 +172,7 @@ Texture painting paints tile 1001 (UVs between 0 and 1); islands in other UDIM t
Packing works on islands&#x27; outlines when there are enough of them and the mesh isn&#x27;t huge; otherwise on their boxes (a little less tight).
</li>
</ul>
-<aside class="callout callout-note"><p><strong>Coming from ZBrush?</strong> The UV Editor does what ZBrush 2027&#x27;s UV editing and UV Master do: 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></aside>
+<aside class="callout callout-experienced"><p><strong>Experienced sculptor?</strong> 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></aside>
<h2 id="see-also">See also<a class="anchor" href="#see-also" aria-label="Link to this section">#</a></h2>
<ul>
<li>
@@ -207,8 +207,7 @@ Packing works on islands&#x27; outlines when there are enough of them and the me
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/vertex-paint.html b/website/guide/vertex-paint.html
index f5aee708..0c99e23f 100644
--- a/website/guide/vertex-paint.html
+++ b/website/guide/vertex-paint.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Vertex Paint and materials - SculptForge User Guide</title>
- <meta name="description" content="Vertex Paint (ZBrush users: Polypaint) 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 ">
+ <meta name="description" content="Vertex Paint (experienced sculptors: Vertex Paint) stores a colour on every vertex of the mesh, so you can paint a sculpt without UVs or textures. This chapter covers the Paint brush, painting while you sculpt, fills and cavity paint, picking colours, paint layers with blend modes, and the Lit Spher">
<meta name="theme-color" content="#111114">
<meta name="color-scheme" content="dark">
<link rel="icon" type="image/svg+xml" href="../img/favicon.svg?v=2">
@@ -13,8 +13,8 @@
<link rel="canonical" href="https://sculptforge.app/guide/vertex-paint.html">
<meta property="og:type" content="article">
<meta property="og:title" content="Vertex Paint and materials - SculptForge User Guide">
- <meta property="og:description" content="Vertex Paint (ZBrush users: Polypaint) 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 ">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:description" content="Vertex Paint (experienced sculptors: Vertex Paint) stores a colour on every vertex of the mesh, so you can paint a sculpt without UVs or textures. This chapter covers the Paint brush, painting while you sculpt, fills and cavity paint, picking colours, paint layers with blend modes, and the Lit Spher">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/vertex-paint.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,13 +46,13 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html" class="current" aria-current="page">Vertex Paint and materials</a><ul class="toc-sections"><li><a href="#how-vertex-paint-works">How vertex paint works</a></li><li><a href="#paint-with-the-paint-brush">Paint with the Paint brush</a></li><li><a href="#paint-while-sculpting">Paint while sculpting</a></li><li><a href="#choose-a-colour">Choose a colour</a></li><li><a href="#fill-cavity-paint-and-clear">Fill, cavity paint and clear</a></li><li><a href="#paint-layers">Paint layers</a></li><li><a href="#materials-lit-spheres">Materials (Lit Spheres)</a></li><li><a href="#smooth-and-flat-shading">Smooth and flat shading</a></li><li><a href="#scripting">Scripting</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html" class="current" aria-current="page">Vertex Paint and materials</a><ul class="toc-sections"><li><a href="#how-vertex-paint-works">How vertex paint works</a></li><li><a href="#paint-with-the-paint-brush">Paint with the Paint brush</a></li><li><a href="#paint-while-sculpting">Paint while sculpting</a></li><li><a href="#choose-a-colour">Choose a colour</a></li><li><a href="#fill-cavity-paint-and-clear">Fill, cavity paint and clear</a></li><li><a href="#paint-layers">Paint layers</a></li><li><a href="#materials-lit-spheres">Materials (Lit Spheres)</a></li><li><a href="#smooth-and-flat-shading">Smooth and flat shading</a></li><li><a href="#scripting">Scripting</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
<article class="guide-article">
<h1 id="vertex-paint-and-materials">Vertex Paint and materials</h1>
-<p>Vertex Paint (ZBrush users: Polypaint) 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>
+<p>Vertex Paint (experienced sculptors: Vertex Paint) stores a colour on every vertex of the mesh, so you can paint a sculpt without UVs or textures. This chapter covers the Paint brush, painting while you sculpt, fills and cavity paint, picking colours, paint layers with blend modes, and the Lit Sphere materials that change how the model is shaded in the viewport.</p>
<h2 id="how-vertex-paint-works">How vertex paint works<a class="anchor" href="#how-vertex-paint-works" aria-label="Link to this section">#</a></h2>
<ul>
<li>
@@ -65,7 +65,7 @@ Painting respects the <a href="masking.html">mask</a> (masked areas keep their c
Symmetry works for painting as it does for sculpting.
</li>
<li>
-Vertex Paint is per Part and is saved in projects. It is exported as vertex colours to PLY, glTF/GLB, OBJ, USD (<code>displayColor</code>) and GoZ-compatible files. FBX export doesn&#x27;t include it.
+Vertex Paint is per Part and is saved in projects. It is exported as vertex colours to PLY, glTF/GLB, OBJ, USD (<code>displayColor</code>) and Bridge files. FBX export doesn&#x27;t include it.
</li>
<li>
A mesh starts without vertex paint. The first paint stroke or fill adds it (white everywhere you haven&#x27;t painted).
@@ -90,21 +90,20 @@ Stroke over the model. Draw Size, the stroke type and the alpha work as they do
<kbd>Alt</kbd> paints back towards white.
</li>
<li>
-<kbd>Shift</kbd> still smooths the shape, as in ZBrush.
+<kbd>Shift</kbd> still smooths the shape.
</li>
<li>
The surface isn&#x27;t changed.
</li>
</ul>
<p>Press <kbd>P</kbd> again, or click <strong>Sculpt</strong> on the top shelf, to go back to sculpting.</p>
-<figure class="shot"><a href="images/polypaint.jpg" class="zoom"><img src="images/polypaint.jpg" alt="Vertex Paint on a sculpt with the Paint menu open" width="870" height="780" loading="lazy" decoding="async"></a><figcaption>Vertex Paint on a sculpt with the Paint menu open</figcaption></figure>
-<aside class="callout callout-zbrush"><p><strong>ZBrush:</strong> <strong>Paint</strong> is ZBrush&#x27;s Rgb on with Zadd off. <strong>Sculpt</strong> with <strong>Rgb</strong> on is Rgb with Zadd: the brush sculpts and paints at once.</p></aside>
+<figure class="shot"><a href="images/vertex-paint.jpg" class="zoom"><img src="images/vertex-paint.jpg" alt="Vertex Paint on a sculpt with the Paint menu open" width="870" height="780" loading="lazy" decoding="async"></a><figcaption>Vertex Paint on a sculpt with the Paint menu open</figcaption></figure>
<h2 id="paint-while-sculpting">Paint while sculpting<a class="anchor" href="#paint-while-sculpting" aria-label="Link to this section">#</a></h2>
<p>Turn on <strong>Rgb</strong> on the top shelf (or <strong>RGB while sculpting</strong> in the <strong>Paint</strong> menu). Every sculpt brush then also paints the current colour along its stroke. The Smooth brush and <kbd>Shift</kbd>-smoothing never paint.</p>
<h2 id="choose-a-colour">Choose a colour<a class="anchor" href="#choose-a-colour" aria-label="Link to this section">#</a></h2>
<ul>
<li>
-The <strong>left shelf</strong> has a colour picker (a square plus a hue strip), two swatches and a <strong>Fill</strong> button. Clicking the second swatch swaps it with the main colour, like ZBrush&#x27;s Alternate.
+The <strong>left shelf</strong> has a colour picker (a square plus a hue strip), two swatches and a <strong>Fill</strong> button. Clicking the second swatch swaps it with the main colour.
</li>
<li>
The <strong>Paint</strong> menu has a larger hue wheel with a hex value, ten preset swatches (white, near black, red, orange, yellow, green, blue, purple, skin and brown) and the fill buttons.
@@ -179,7 +178,7 @@ The arrows move the active layer up or down. <strong>Merge down</strong> merges
Paint layers are saved in projects (<code>.sfproj</code>) with their names, blend modes, opacity, visibility, lock and the active layer. Older versions of SculptForge open these projects with the paint flattened.
</li>
<li>
-Exports (OBJ, PLY, glTF/GLB, USD, GoZ-compatible) write the composited colours, exactly what the viewport shows.
+Exports (OBJ, PLY, glTF/GLB, USD, Bridge) write the composited colours, exactly what the viewport shows.
</li>
<li>
<a href="parts.html">Duplicating</a> a Part copies its layers, and <a href="parts.html#split-a-part">Split</a> keeps them on each piece. <a href="geometry.html#subdivide">Subdividing</a> and <a href="geometry.html#decimate">decimating</a> keep them too.
@@ -188,7 +187,6 @@ Exports (OBJ, PLY, glTF/GLB, USD, GoZ-compatible) write the composited colours,
<a href="parts.html#merge-parts">Merging</a> Parts, a <a href="geometry.html#voxel-remesh">voxel remesh</a> and other rebuilds keep the look but flatten the layers into Base.
</li>
</ul>
-<aside class="callout callout-note"><p><strong>ZBrush and Mudbox:</strong> ZBrush&#x27;s polypaint layers only have opacity. Here every layer also has a blend mode, its own coverage and a lock, like the paint layers in Mudbox and Photoshop.</p></aside>
<h2 id="materials-lit-spheres">Materials (Lit Spheres)<a class="anchor" href="#materials-lit-spheres" aria-label="Link to this section">#</a></h2>
<p>Materials change only how the model is shaded in the viewport. They aren&#x27;t exported and don&#x27;t change vertex paint.</p>
<div class="table-wrap"><table><thead><tr><th>Material</th><th>Look</th></tr></thead><tbody><tr><td>Soft Clay</td><td>The default: a matte warm light grey with a clear light and shadow side and a soft rim</td></tr><tr><td>Sculpt</td><td>Made for sculpting: neutral warm clay under a strong key light from the upper left, a crisp highlight and deep cavity shading, so small strokes and undulations stay readable</td></tr><tr><td>Red Wax</td><td>Glossy deep red wax, the classic sculpting look</td></tr><tr><td>Clay</td><td>Matte grey-brown clay</td></tr><tr><td>Skin</td><td>Warm, soft skin tones</td></tr><tr><td>Chrome</td><td>Mirror-like metal, good for checking surface flow</td></tr><tr><td>White</td><td>Neutral off-white for judging forms</td></tr><tr><td>Bronze</td><td>Polished bronze</td></tr><tr><td>Studio</td><td>Softer clay shading with studio lighting (the default in earlier versions). Its colour is <strong>Base colour</strong> in <strong>Render &gt; Materials</strong></td></tr></tbody></table></div>
@@ -203,22 +201,22 @@ Open <strong>Render &gt; Materials</strong>, or the <strong>Material</strong> ta
</ul>
<figure class="shot"><a href="images/material-picker.jpg" class="zoom"><img src="images/material-picker.jpg" alt="The material picker with the built-in Lit Spheres and Studio" width="480" height="225" loading="lazy" decoding="async"></a><figcaption>The material picker with the built-in Lit Spheres and Studio</figcaption></figure>
<p>Vertex Paint multiplies the material, and cavity shading stays on with every material (strongest with Sculpt). The material is saved with the project: projects saved with Studio open with Studio.</p>
-<p><strong>Colour tints the material</strong> (in the <strong>Paint</strong> menu, on by default): on a Part with no vertex paint yet, the current colour tints its Lit Sphere material, as in ZBrush, so you can try a skin, stone or bronze tone without painting anything. The colour&#x27;s hue and saturation tint it; grey (the starting colour) and black leave the material as it is, and the material keeps its own light and shade. Once a Part has vertex paint, the paint shows instead. PBR shading uses the material channels and is not tinted. Saved with the project.</p>
+<p><strong>Colour tints the material</strong> (in the <strong>Paint</strong> menu, on by default): on a Part with no vertex paint yet, the current colour tints its Lit Sphere material, so you can try a skin, stone or bronze tone without painting anything. The colour&#x27;s hue and saturation tint it; grey (the starting colour) and black leave the material as it is, and the material keeps its own light and shade. Once a Part has vertex paint, the paint shows instead. PBR shading uses the material channels and is not tinted. Saved with the project.</p>
<aside class="callout callout-tip"><p><strong>Tip:</strong> <strong>Sculpt</strong> is the material to judge strokes with. The prettier ones (Skin, Red Wax) soften small detail; switch to them for presenting.</p></aside>
<h3 id="your-own-lit-spheres">Your own Lit Spheres<a class="anchor" href="#your-own-lit-spheres" aria-label="Link to this section">#</a></h3>
-<p>A Lit Sphere is a picture of a lit sphere (Sloan and others, 2001): the view colours each point of the model with the sphere&#x27;s colour where its surface faces the same way. Any lit-sphere image made for ZBrush, Blender or Nomad works: a square PNG, JPG or EXR with the sphere filling it (a non-square image is cropped to its centre; big ones are scaled to 1024 pixels).</p>
+<p>A Lit Sphere is a picture of a lit sphere (Sloan and others, 2001): the view colours each point of the model with the sphere&#x27;s colour where its surface faces the same way. Any lit-sphere image works: a square PNG, JPG or EXR with the sphere filling it (a non-square image is cropped to its centre; big ones are scaled to 1024 pixels).</p>
<ul>
<li>
-<strong>Render &gt; Materials &gt; Load Lit Sphere...</strong> picks an image. It joins the material list under its file name, the view uses it, and a copy goes into the <strong>MatCaps</strong> folder of your library (<strong>Documents/SculptForge/MatCaps</strong>, or the folder set in <strong>Edit &gt; Preferences &gt; Library</strong>), so it is there next time.
+<strong>Render &gt; Materials &gt; Load Lit Sphere...</strong> picks an image. It joins the material list under its file name, the view uses it, and a copy goes into the <strong>Lit Spheres</strong> folder of your library (<strong>Documents/SculptForge/Lit Spheres</strong>, or the folder set in <strong>Edit &gt; Preferences &gt; Library</strong>), so it is there next time.
</li>
<li>
-Or put images into that <strong>MatCaps</strong> folder yourself: they show up the next time you open the material picker, <strong>Render &gt; Materials</strong> or the Library&#x27;s Material tab, no restart needed. Studios can share a read-only folder by listing it in the <code>SCULPTFORGE_MATCAP_PATH</code> environment variable (separated by <code>:</code>, <code>;</code> on Windows); those load when SculptForge starts.
+Or put images into that <strong>Lit Spheres</strong> folder yourself: they show up the next time you open the material picker, <strong>Render &gt; Materials</strong> or the Library&#x27;s Material tab, no restart needed. Studios can share a read-only folder by listing it in the <code>SCULPTFORGE_MATCAP_PATH</code> environment variable (separated by <code>:</code>, <code>;</code> on Windows); those load when SculptForge starts.
</li>
<li>
-To remove one, right-click it in the material picker or palette and choose <strong>Remove</strong>. An image from your MatCaps 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&#x27;t be removed.
+To remove one, right-click it in the material picker or palette and choose <strong>Remove</strong>. An image from your Lit Spheres folder goes to the trash (the Recycle Bin on Windows), so you can still get it back. On macOS it is only hidden until you restart, and the message says where its file is so you can delete it yourself. Built-in materials can&#x27;t be removed.
</li>
</ul>
-<figure class="shot"><a href="images/custom-matcaps.jpg" class="zoom"><img src="images/custom-matcaps.jpg" alt="A Lit Sphere loaded from an image (Gold) in Render &gt; Materials" width="544" height="700" loading="lazy" decoding="async"></a><figcaption>A Lit Sphere loaded from an image (Gold) in Render &gt; Materials</figcaption></figure>
+<figure class="shot"><a href="images/custom-lit-spheres.jpg" class="zoom"><img src="images/custom-lit-spheres.jpg" alt="A Lit Sphere loaded from an image (Gold) in Render &gt; Materials" width="544" height="700" loading="lazy" decoding="async"></a><figcaption>A Lit Sphere loaded from an image (Gold) in Render &gt; Materials</figcaption></figure>
<p>Your Lit Spheres appear in the material picker (<kbd>M</kbd>), <strong>Render &gt; Materials</strong> and the Library, after the built-in ones. A project that uses one carries a copy of the image, so it opens with the same look on another computer (or after you delete the file). Loading an image with the same name again replaces it. EXR images are read as linear light, so very bright highlights clip to white.</p>
<h2 id="smooth-and-flat-shading">Smooth and flat shading<a class="anchor" href="#smooth-and-flat-shading" aria-label="Link to this section">#</a></h2>
<p><strong>Smooth</strong> shading (the default) blends the light across polygons, so the surface reads as one form. <strong>Flat</strong> shading lights every polygon on its own, so you see the faces: how the mesh is built, where its vertices sit, and exactly what a stroke, crease or pinch did to the geometry, without smooth blending hiding small lumps. It helps most when blocking out forms on a low-poly base mesh.</p>
@@ -231,10 +229,10 @@ To remove one, right-click it in the material picker or palette and choose <stro
</li>
</ul>
<figure class="shot"><a href="images/shading.jpg" class="zoom"><img src="images/shading.jpg" alt="Smooth and Flat shading on the template head, with its eyes kept smooth" width="960" height="621" loading="lazy" decoding="async"></a><figcaption>Smooth and Flat shading on the template head, with its eyes kept smooth</figcaption></figure>
-<p>Shading works with every material, vertex paint, textures and the mask. Like the material, it only changes the view: exports are unaffected. Projects save the scene&#x27;s shading and each Part&#x27;s own; projects from before open with your preferred shading. The scene&#x27;s shading you choose is also the preference for the next session once you <strong>Store Config</strong> (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd>). Smooth and Flat have no default shortcut, so no ZBrush key changes meaning; assign one under <strong>Edit &gt; Preferences &gt; Hotkeys</strong> if you switch often.</p>
+<p>Shading works with every material, vertex paint, textures and the mask. Like the material, it only changes the view: exports are unaffected. Projects save the scene&#x27;s shading and each Part&#x27;s own; projects from before open with your preferred shading. The scene&#x27;s shading you choose is also the preference for the next session once you <strong>Store Config</strong> (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd>). Smooth and Flat have no default shortcut, so no classic key changes meaning; assign one under <strong>Edit &gt; Preferences &gt; Hotkeys</strong> if you switch often.</p>
<aside class="callout callout-not-yet"><p><strong>Not yet:</strong> loading your own Lit Sphere images, and physically based materials or BPR-style renders.</p></aside>
<h2 id="scripting">Scripting<a class="anchor" href="#scripting" aria-label="Link to this section">#</a></h2>
-<div class="table-wrap"><table><thead><tr><th>Command</th><th>What it does</th></tr></thead><tbody><tr><td><code>set_color color=#c08060</code></td><td>Set the paint colour: <code>rrggbb</code>, <code>#rrggbb</code> (quote it in scripts), <code>r,g,b</code> or a name such as <code>white</code>, <code>skin</code>, <code>bone</code></td></tr><tr><td><code>paint_fill area=unmasked</code></td><td>Fill; <code>area</code> is <code>unmasked</code> (default), <code>masked</code> or <code>all</code>; <code>strength</code> 0-1</td></tr><tr><td><code>paint_from_cavity color=#202020 strength=0.7 smoothing=2</code></td><td>Cavity paint (defaults: dark brown, 0.7, 2 blur passes)</td></tr><tr><td><code>paint_clear</code></td><td>Remove all vertex paint, paint layers included</td></tr><tr><td><code>paint_layer_add name=Dirt blend=multiply opacity=0.8</code></td><td>Add a paint layer above the active one and paint on it</td></tr><tr><td><code>paint_layer_set index=0 opacity=0.5 blend=overlay visible=false locked=true name=Grime</code></td><td>Change a layer (<code>layer=Dirt</code> picks it by name; default: the active layer)</td></tr><tr><td><code>paint_layer_select layer=Base</code></td><td>Paint on another layer (<code>index=-1</code> is Base, 0 the first layer above it)</td></tr><tr><td><code>paint_layer_duplicate</code>, <code>paint_layer_delete</code>, <code>paint_layer_clear</code></td><td>Copy, delete or clear the active (or given) layer</td></tr><tr><td><code>paint_layer_move direction=up</code></td><td>Move a layer up or down the stack</td></tr><tr><td><code>paint_layer_merge</code> / <code>paint_layer_flatten</code></td><td>Merge down / bake every visible layer into Base</td></tr><tr><td><code>paint_layer_list</code></td><td>List the layers, top first (<code>*</code> marks the active one)</td></tr><tr><td><code>set_material name=Chrome</code></td><td>Viewport material: a Lit Sphere name (<code>Soft Clay</code> is the default, your own Lit Spheres included) or <code>studio</code> (desktop app only)</td></tr><tr><td><code>load_matcap path=gold.png</code></td><td>Load a Lit Sphere image and use it; <code>keep=false</code> doesn&#x27;t copy it into the MatCaps folder (desktop app only)</td></tr><tr><td><code>remove_matcap name=Gold</code></td><td>Remove one of your Lit Spheres; its image in the MatCaps folder goes to the trash (desktop app only)</td></tr><tr><td><code>set_background mode=flat color=60,70,80</code></td><td>The view&#x27;s background: <code>gradient</code> (the default) or <code>flat</code> with a colour (<code>#rrggbb</code>, <code>r,g,b</code> or a name); see <a href="interface.html#the-background">The background</a> (desktop app only)</td></tr><tr><td><code>set_shading mode=flat</code></td><td>The scene&#x27;s shading: <code>smooth</code> (the default) or <code>flat</code> (desktop app only)</td></tr><tr><td><code>subtool_shading mode=smooth name=Eyes</code></td><td>A Part&#x27;s own shading: <code>default</code> (follow the scene), <code>smooth</code> or <code>flat</code>; <code>index</code> or <code>name</code> picks the Part (default: the active one)</td></tr></tbody></table></div>
+<div class="table-wrap"><table><thead><tr><th>Command</th><th>What it does</th></tr></thead><tbody><tr><td><code>set_color color=#c08060</code></td><td>Set the paint colour: <code>rrggbb</code>, <code>#rrggbb</code> (quote it in scripts), <code>r,g,b</code> or a name such as <code>white</code>, <code>skin</code>, <code>bone</code></td></tr><tr><td><code>paint_fill area=unmasked</code></td><td>Fill; <code>area</code> is <code>unmasked</code> (default), <code>masked</code> or <code>all</code>; <code>strength</code> 0-1</td></tr><tr><td><code>paint_from_cavity color=#202020 strength=0.7 smoothing=2</code></td><td>Cavity paint (defaults: dark brown, 0.7, 2 blur passes)</td></tr><tr><td><code>paint_clear</code></td><td>Remove all vertex paint, paint layers included</td></tr><tr><td><code>paint_layer_add name=Dirt blend=multiply opacity=0.8</code></td><td>Add a paint layer above the active one and paint on it</td></tr><tr><td><code>paint_layer_set index=0 opacity=0.5 blend=overlay visible=false locked=true name=Grime</code></td><td>Change a layer (<code>layer=Dirt</code> picks it by name; default: the active layer)</td></tr><tr><td><code>paint_layer_select layer=Base</code></td><td>Paint on another layer (<code>index=-1</code> is Base, 0 the first layer above it)</td></tr><tr><td><code>paint_layer_duplicate</code>, <code>paint_layer_delete</code>, <code>paint_layer_clear</code></td><td>Copy, delete or clear the active (or given) layer</td></tr><tr><td><code>paint_layer_move direction=up</code></td><td>Move a layer up or down the stack</td></tr><tr><td><code>paint_layer_merge</code> / <code>paint_layer_flatten</code></td><td>Merge down / bake every visible layer into Base</td></tr><tr><td><code>paint_layer_list</code></td><td>List the layers, top first (<code>*</code> marks the active one)</td></tr><tr><td><code>set_material name=Chrome</code></td><td>Viewport material: a Lit Sphere name (<code>Soft Clay</code> is the default, your own Lit Spheres included) or <code>studio</code> (desktop app only)</td></tr><tr><td><code>load_matcap path=gold.png</code></td><td>Load a Lit Sphere image and use it; <code>keep=false</code> doesn&#x27;t copy it into the Lit Spheres folder (desktop app only)</td></tr><tr><td><code>remove_matcap name=Gold</code></td><td>Remove one of your Lit Spheres; its image in the Lit Spheres folder goes to the trash (desktop app only)</td></tr><tr><td><code>set_background mode=flat color=60,70,80</code></td><td>The view&#x27;s background: <code>gradient</code> (the default) or <code>flat</code> with a colour (<code>#rrggbb</code>, <code>r,g,b</code> or a name); see <a href="interface.html#the-background">The background</a> (desktop app only)</td></tr><tr><td><code>set_shading mode=flat</code></td><td>The scene&#x27;s shading: <code>smooth</code> (the default) or <code>flat</code> (desktop app only)</td></tr><tr><td><code>subtool_shading mode=smooth name=Eyes</code></td><td>A Part&#x27;s own shading: <code>default</code> (follow the scene), <code>smooth</code> or <code>flat</code>; <code>index</code> or <code>name</code> picks the Part (default: the active one)</td></tr></tbody></table></div>
<div class="code-block"><pre class="code"><code class="language-text">set_color color=&quot;#d9b38c&quot;; paint_fill; paint_from_cavity strength=0.5
paint_layer_add name=Dirt blend=multiply opacity=0.8; paint_from_cavity color=4a2c18 strength=0.9</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
<h2 id="see-also">See also<a class="anchor" href="#see-also" aria-label="Link to this section">#</a></h2>
@@ -274,8 +272,7 @@ paint_layer_add name=Dirt blend=multiply opacity=0.8; paint_from_cavity color=4a
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/welcome.html b/website/guide/welcome.html
index be3dcd51..55354eaa 100644
--- a/website/guide/welcome.html
+++ b/website/guide/welcome.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="article">
<meta property="og:title" content="Welcome to SculptForge - SculptForge User Guide">
<meta property="og:description" content="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&#x27;t do yet, and how the rest of this guide is organised.">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/welcome.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html" class="current" aria-current="page">Welcome to SculptForge</a><ul class="toc-sections"><li><a href="#what-sculptforge-is">What SculptForge is</a></li><li><a href="#what-you-can-do-with-it">What you can do with it</a></li><li><a href="#what-it-doesnt-do-yet">What it doesn&#x27;t do yet</a></li><li><a href="#coming-from-zbrush">Coming from ZBrush</a></li><li><a href="#how-this-guide-is-organised">How this guide is organised</a></li><li><a href="#getting-help-and-reporting-problems">Getting help and reporting problems</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html" class="current" aria-current="page">Welcome to SculptForge</a><ul class="toc-sections"><li><a href="#what-sculptforge-is">What SculptForge is</a></li><li><a href="#what-you-can-do-with-it">What you can do with it</a></li><li><a href="#what-it-doesnt-do-yet">What it doesn&#x27;t do yet</a></li><li><a href="#quick-tour-for-experienced-sculptors">Quick tour for experienced sculptors</a></li><li><a href="#how-this-guide-is-organised">How this guide is organised</a></li><li><a href="#getting-help-and-reporting-problems">Getting help and reporting problems</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What&#x27;s new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -54,7 +54,7 @@
<h1 id="welcome-to-sculptforge">Welcome to SculptForge</h1>
<p>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&#x27;t do yet, and how the rest of this guide is organised.</p>
<h2 id="what-sculptforge-is">What SculptForge is<a class="anchor" href="#what-sculptforge-is" aria-label="Link to this section">#</a></h2>
-<p>SculptForge is a focused sculpting tool with the brushes, symmetry, masking and navigation that ZBrush artists already know. Its menus are grouped by task (<strong>File, Edit, Sculpt, Paint, Mesh, View, Render, Help</strong>), with shelves around the canvas, a Library of thumbnails and pop-up pickers; a ZBrush-style 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. ZBrush&#x27;s keys and gestures are one choice away: answer <strong>ZBrush</strong> when the first start asks what you are coming from, or pick <strong>ZBrush-style</strong> in <strong>Edit &gt; Preferences &gt; Input</strong>. See <a href="coming-from-zbrush.html">Coming from ZBrush</a>. There is no account, no subscription, no licence server and no telemetry.</p>
+<p>SculptForge is a focused sculpting tool with the brushes, symmetry, masking and navigation that experienced sculptors already know. Its menus are grouped by task (<strong>File, Edit, Sculpt, Paint, Mesh, View, Render, Help</strong>), 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 <strong>Classic sculpting keys</strong> when the first start asks what you are coming from, or pick <strong>Classic</strong> in <strong>Edit &gt; Preferences &gt; Input</strong>. See <a href="quick-tour.html">Quick tour for experienced sculptors</a>. There is no account, no subscription, no licence server and no telemetry.</p>
<p>It is free software under the GNU General Public License v3.0 or later. You own everything you make with it: the GPL covers the program, not your models.</p>
<p>SculptForge stays free and works the same for everyone; nothing is ever paywalled. Memberships add your name to the credits, the monthly pack and a vote on what gets built. Insiders will get each release about two weeks early, starting with SculptForge 1.0 (every release stays free for everyone; bug-fix and security releases go out to everyone the same day): <strong>Help &gt; Support SculptForge...</strong> opens <a href="https://sculptforge.app/support.html" rel="noopener">sculptforge.app/support.html</a> 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. Supporters are thanked by name in <strong>Help &gt; About</strong>. While SculptForge starts (the first time, after an update, and at most once a week otherwise) a card shows the memberships; <strong>I&#x27;m already a supporter</strong> hides it for good and <strong>Edit &gt; Preferences &gt; Support</strong> turns it off. After about ten hours of sculpting, SculptForge also shows one small note about this along the bottom of the canvas, once, and never again after you close it.</p>
<h2 id="what-you-can-do-with-it">What you can do with it<a class="anchor" href="#what-you-can-do-with-it" aria-label="Link to this section">#</a></h2>
@@ -66,7 +66,7 @@
<strong>Design brushes in words</strong> with Brush Lab: describe &quot;dry cracked mud&quot; 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 <a href="brush-lab.html">Brush Lab and sharing brushes</a>.
</li>
<li>
-<strong>Mask, group and hide</strong> parts of the model the ZBrush way: Ctrl to paint a mask, Ctrl+Shift to isolate a face group. See <a href="masking.html">Masking</a> and <a href="face-groups.html">Face Groups and visibility</a>.
+<strong>Mask, group and hide</strong> parts of the model: Ctrl to paint a mask, Ctrl+Shift to isolate a face group. See <a href="masking.html">Masking</a> and <a href="face-groups.html">Face Groups and visibility</a>.
</li>
<li>
<strong>Keep separate meshes</strong> as Parts (body, eyes, teeth, armour), each with its own undo history. See <a href="parts.html">Parts</a>.
@@ -78,7 +78,7 @@
<strong>Sculpt layers</strong> that double as blend shapes (morph targets), with live weights. See <a href="layers.html">Sculpt layers and blend shapes</a>.
</li>
<li>
-<strong>Rebuild the mesh</strong>: Loop subdivision, voxel remesh (similar to DynaMesh), decimation and one-click LOD chains. See <a href="geometry.html">Subdivide, remesh, decimate and LODs</a>.
+<strong>Rebuild the mesh</strong>: Loop subdivision, voxel remesh (similar to voxel remesh), decimation and one-click LOD chains. See <a href="geometry.html">Subdivide, remesh, decimate and LODs</a>.
</li>
<li>
<strong>Generate a model</strong> from a sketch, concept art or a description, free through Hugging Face or on your own ComfyUI server. See <a href="generate-3d.html">Image and text to 3D</a>.
@@ -87,14 +87,14 @@
<strong>Work with Gaussian splats</strong> from phone captures: sculpt against them or turn them into meshes. See <a href="splats.html">Gaussian splats</a>.
</li>
<li>
-<strong>Export</strong> to glTF/GLB, FBX, OpenUSD, OBJ, STL and PLY, send models straight into Unreal Engine, and exchange them with ZBrush through Send to ZBrush (GoZ-compatible exchange). See <a href="exporting.html">Exporting, Unreal and ZBrush</a>.
+<strong>Export</strong> 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 <a href="exporting.html">Exporting, Unreal and Bridge</a>.
</li>
<li>
<strong>Automate</strong> everything: every action is a command you can type in the console, run headless with <code>sculptforge-cli</code>, script from Python or hand to an AI agent over MCP. See <a href="scripting.html">Scripting and automation</a>.
</li>
</ul>
<h2 id="what-it-doesnt-do-yet">What it doesn&#x27;t do yet<a class="anchor" href="#what-it-doesnt-do-yet" aria-label="Link to this section">#</a></h2>
-<p>SculptForge is young (version 0.10; see <a href="whats-new.html">What&#x27;s new</a>). Some things ZBrush artists rely on are still on the roadmap:</p>
+<p>SculptForge is young (version 0.10; see <a href="whats-new.html">What&#x27;s new</a>). Some things experienced sculptors rely on are still on the roadmap:</p>
<ul>
<li>
Painting across UDIM tiles (the <a href="uv-editor.html">UV Editor</a> lays them out; painting covers tile 1001).
@@ -103,10 +103,10 @@ Painting across UDIM tiles (the <a href="uv-editor.html">UV Editor</a> lays them
Booleans and stencils.
</li>
</ul>
-<p>Others are not on the roadmap: ZModeler, the 2.5D canvas, and reading ZBrush&#x27;s own <code>.ZTL</code> and <code>.ZPR</code> files directly (bring models over with Send to ZBrush, the ZTL Export plug-in for ZBrush, or as OBJ, FBX or GLB).</p>
-<aside class="callout callout-not-yet"><p><strong>Not yet:</strong> where a chapter describes a ZBrush feature SculptForge doesn&#x27;t have, it says so in a callout like this one. The project&#x27;s ROADMAP.md lists what is planned and in which order.</p></aside>
-<h2 id="coming-from-zbrush">Coming from ZBrush<a class="anchor" href="#coming-from-zbrush" aria-label="Link to this section">#</a></h2>
-<p>Most habits carry over, and <strong>Edit &gt; Preferences &gt; Interface &gt; Look &gt; Layout &gt; ZBrush-style</strong> brings back the alphabetical palette bar. You sculpt with a left drag, hold <kbd>Alt</kbd> to subtract and <kbd>Shift</kbd> to smooth, drag on the background to rotate, <kbd>Alt</kbd>+drag to pan, and hold <kbd>Ctrl</kbd> to mask. The palettes have the names you expect (Alpha, Brush, Stroke, Tool, Transform...), the Tool palette holds the Parts (ZBrush&#x27;s SubTool), Masking and Face Groups (Polygroups) sub-palettes, <kbd>B</kbd> opens the brush pop-up with the same letter keys (B, S, T picks Standard), <kbd>,</kbd> opens the Library and <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd> stores your interface, and <kbd>S</kbd> <kbd>U</kbd> <kbd>I</kbd> <kbd>O</kbd>, <kbd>Space</kbd>, <kbd>Ctrl</kbd>+<kbd>W</kbd> and the mask keys do what your hands expect with the ZBrush-style keys on (<strong>Edit &gt; Preferences &gt; Input</strong>). <a href="coming-from-zbrush.html">Coming from ZBrush</a> lists SculptForge&#x27;s names for ZBrush terms, what is the same, what differs and every shortcut side by side; the <a href="glossary.html">Glossary</a> maps ZBrush terms to SculptForge ones.</p>
+<p>Others are not on the roadmap: poly modeling, the 2.5D canvas, and reading other sculpting apps&#x27; own project files directly.</p>
+<aside class="callout callout-not-yet"><p><strong>Not yet:</strong> where a chapter describes a feature SculptForge doesn&#x27;t have, it says so in a callout like this one. The project&#x27;s ROADMAP.md lists what is planned and in which order.</p></aside>
+<h2 id="quick-tour-for-experienced-sculptors">Quick tour for experienced sculptors<a class="anchor" href="#quick-tour-for-experienced-sculptors" aria-label="Link to this section">#</a></h2>
+<p>Most habits carry over, and <strong>Edit &gt; Preferences &gt; Interface &gt; Look &gt; Layout &gt; Classic</strong> brings back the alphabetical palette bar. You sculpt with a left drag, hold <kbd>Alt</kbd> to subtract and <kbd>Shift</kbd> to smooth, drag on the background to rotate, <kbd>Alt</kbd>+drag to pan, and hold <kbd>Ctrl</kbd> 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, <kbd>B</kbd> opens the brush pop-up with the same letter keys (B, S, T picks Standard), <kbd>,</kbd> opens the Library and <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd> stores your interface, and <kbd>S</kbd> <kbd>U</kbd> <kbd>I</kbd> <kbd>O</kbd>, <kbd>Space</kbd>, <kbd>Ctrl</kbd>+<kbd>W</kbd> and the mask keys do what your hands expect with the Classic sculpting keys on (<strong>Edit &gt; Preferences &gt; Input</strong>). <a href="quick-tour.html">Quick tour for experienced sculptors</a> lists what is the same, what differs and every shortcut side by side; the <a href="glossary.html">Glossary</a> explains SculptForge&#x27;s terms.</p>
<h2 id="how-this-guide-is-organised">How this guide is organised<a class="anchor" href="#how-this-guide-is-organised" aria-label="Link to this section">#</a></h2>
<ul>
<li>
@@ -154,7 +154,7 @@ Press <kbd>F1</kbd> for the Controls sheet (every shortcut and mouse gesture) or
<p class="guide-meta fine">Also in the app: <strong>Help &gt; User Guide</strong> (<kbd>Shift</kbd>+<kbd>F1</kbd>).
Found a mistake? <a href="https://github.com/islandmed/SculptForge/edit/main/docs/guide/welcome.md">Edit this page on GitHub</a>.</p>
</main>
- <aside class="on-page" aria-label="On this page"><p>On this page</p><ul><li><a href="#what-sculptforge-is">What SculptForge is</a></li><li><a href="#what-you-can-do-with-it">What you can do with it</a></li><li><a href="#what-it-doesnt-do-yet">What it doesn&#x27;t do yet</a></li><li><a href="#coming-from-zbrush">Coming from ZBrush</a></li><li><a href="#how-this-guide-is-organised">How this guide is organised</a></li><li><a href="#getting-help-and-reporting-problems">Getting help and reporting problems</a></li><li><a href="#see-also">See also</a></li></ul></aside>
+ <aside class="on-page" aria-label="On this page"><p>On this page</p><ul><li><a href="#what-sculptforge-is">What SculptForge is</a></li><li><a href="#what-you-can-do-with-it">What you can do with it</a></li><li><a href="#what-it-doesnt-do-yet">What it doesn&#x27;t do yet</a></li><li><a href="#quick-tour-for-experienced-sculptors">Quick tour for experienced sculptors</a></li><li><a href="#how-this-guide-is-organised">How this guide is organised</a></li><li><a href="#getting-help-and-reporting-problems">Getting help and reporting problems</a></li><li><a href="#see-also">See also</a></li></ul></aside>
</div>
<footer class="footer">
<div class="wrap footer-grid">
@@ -171,8 +171,7 @@ Press <kbd>F1</kbd> for the Controls sheet (every shortcut and mouse gesture) or
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/whats-new.html b/website/guide/whats-new.html
index ec5a48dc..f3b0a9ed 100644
--- a/website/guide/whats-new.html
+++ b/website/guide/whats-new.html
@@ -14,14 +14,14 @@
<meta property="og:type" content="article">
<meta property="og:title" content="What&#x27;s new - SculptForge User Guide">
<meta property="og:description" content="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 &gt; What&#x27;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">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/guide/whats-new.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=11" defer></script>
<script data-goatcounter="https://sculptforge.goatcounter.com/count" async src="https://gc.zgo.at/count.js"></script>
<script src="search-index.js?v=47" defer></script>
</head>
-<body class="guide-page" data-prev="first-sculpt.html" data-next="coming-from-zbrush.html">
+<body class="guide-page" data-prev="first-sculpt.html" data-next="quick-tour.html">
<div class="scroll-progress" aria-hidden="true"></div>
<header class="nav">
<div class="wrap nav-inner">
@@ -46,7 +46,7 @@
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
- <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html" class="current" aria-current="page">What&#x27;s new</a><ul class="toc-sections"><li><a href="#version-01010">Version 0.10.10</a></li><li><a href="#version-0109">Version 0.10.9</a></li><li><a href="#version-0108">Version 0.10.8</a></li><li><a href="#versions-0101-to-0107">0.10.1 to 0.10.7</a></li><li><a href="#versions-09x">0.9.x</a></li><li><a href="#versions-08-and-earlier">0.8 and earlier</a></li></ul></li><li><a href="coming-from-zbrush.html">Coming from ZBrush</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and ZBrush</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
+ <nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html" class="current" aria-current="page">What&#x27;s new</a><ul class="toc-sections"><li><a href="#version-01010">Version 0.10.10</a></li><li><a href="#version-0109">Version 0.10.9</a></li><li><a href="#version-0108">Version 0.10.8</a></li><li><a href="#versions-0101-to-0107">0.10.1 to 0.10.7</a></li><li><a href="#versions-09x">0.9.x</a></li><li><a href="#versions-08-and-earlier">0.8 and earlier</a></li></ul></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
@@ -227,7 +227,7 @@
<strong>Full alphas on custom brushes</strong>: at Focal Shift -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).
</li>
<li>
-<strong>A new look</strong>: new installs start in <strong>Forge Terminal</strong> with the Tokyo Night colours and the <strong>SculptForge layout</strong>: 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 <strong>Try it</strong> or <strong>Keep my layout</strong>. Coming from ZBrush? <strong>Preferences &gt; Interface &gt; Look &gt; ZBrush-style layout</strong> (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 <a href="interface.html#looks-and-layouts">The interface</a>.
+<strong>A new look</strong>: new installs start in <strong>Forge Terminal</strong> with the Tokyo Night colours and the <strong>SculptForge layout</strong>: 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 <strong>Try it</strong> or <strong>Keep my layout</strong>. Experienced sculptor? <strong>Preferences &gt; Interface &gt; Look &gt; Classic layout</strong> (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 <a href="interface.html#looks-and-layouts">The interface</a>.
</li>
<li>
<strong>Native Wayland on Linux</strong>: 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 <a href="installing.html#wayland-and-x11">Wayland and X11</a>.
@@ -312,10 +312,10 @@
<strong>Fixed: the viewport on some Windows PCs</strong> (#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.
</li>
<li>
-<strong>Features use SculptForge&#x27;s own names</strong> (Parts, Forge Spheres, Vertex Paint, Face Groups, Library, Lit Spheres, Quad Remesh, Send to ZBrush, Snapshot...); searching for ZBrush terms still finds them, and MatCaps are now Lit Spheres. The table is in <a href="coming-from-zbrush.html#zbrush-terms-in-sculptforge">Coming from ZBrush</a>.
+<strong>Features use SculptForge&#x27;s own names</strong> (Parts, Forge Spheres, Vertex Paint, Face Groups, Library, Lit Spheres, Quad Remesh, Bridge, Snapshot...); the command palette finds them by what they do. See <a href="quick-tour.html">Quick tour for experienced sculptors</a>.
</li>
<li>
-<strong>New installs start with the SculptForge keys</strong>, and the first start asks what you are coming from (ZBrush, Blender, Maya or new to sculpting) to pick the key style. Your saved style is kept; ZBrush&#x27;s keys are <strong>ZBrush-style</strong> in <strong>Preferences &gt; Input</strong>. See <a href="shortcuts.html#zbrush-style-keys">Keyboard and mouse</a>.
+<strong>New installs start with the SculptForge keys</strong>, 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 <strong>Classic</strong> in <strong>Preferences &gt; Input</strong>. See <a href="shortcuts.html#classic-sculpting-keys">Keyboard and mouse</a>.
</li>
</ul>
<h4 id="from-your-requests-on-github">From your requests on GitHub<a class="anchor" href="#from-your-requests-on-github" aria-label="Link to this section">#</a></h4>
@@ -445,7 +445,7 @@ The status bar shows only the file name of what you open.
<section class="wn-group" id="versions-09x"><header class="wn-band wn-band-small"><h2>0.9.x<a class="anchor" href="#versions-09x" aria-label="Link to these versions">#</a></h2></header><ul class="wn-highlights"><li><strong>Faster big brushes</strong>: half the lag for a 200-pixel brush on 21 million triangles</li><li><strong>Extract</strong>: a masked area becomes a shell that fits the surface exactly</li><li><strong>Mirror And Weld</strong>: one side mirrored onto the other as one watertight mesh</li><li><strong>Forge Spheres</strong>: block out bodies and creatures from connected spheres</li><li><strong>Blender keys</strong>: Blender&#x27;s navigation and Sculpt Mode keys</li><li><strong>Scan to sculptable</strong>: a phone scan becomes a clean, animatable quad mesh</li></ul><details class="wn-all"><summary>All changes</summary><div class="wn-body"><h3 id="version-097" class="wn-ver">Version 0.9.7<time datetime="2026-10-31">2026-10-31</time></h3><h4 id="faster-big-brushes-on-dense-meshes">Faster big brushes on dense meshes<a class="anchor" href="#faster-big-brushes-on-dense-meshes" aria-label="Link to this section">#</a></h4>
<p>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 <a href="performance.html">Performance</a>.</p>
<h4 id="right-click-for-the-quick-menu">Right click for the Quick Menu<a class="anchor" href="#right-click-for-the-quick-menu" aria-label="Link to this section">#</a></h4>
-<p>A right click on the canvas opens the Quick Menu under the cursor, as in ZBrush (Space still does too). A right drag turns the view as before, and <strong>Preferences &gt; Input &gt; Right click opens the Quick Menu</strong> turns it off. See <a href="sculpting.html#the-quick-menu">The Quick Menu</a>.</p>
+<p>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 <strong>Preferences &gt; Input &gt; Right click opens the Quick Menu</strong> turns it off. See <a href="sculpting.html#the-quick-menu">The Quick Menu</a>.</p>
<h4 id="fixes">Fixes<a class="anchor" href="#fixes" aria-label="Link to this section">#</a></h4>
<ul>
<li>
@@ -480,7 +480,7 @@ Generating with a <a href="generate-3d.html">ComfyUI</a> workflow and a fixed se
SculptForge now keeps a log file, <code>sculptforge.log</code>, in its settings folder (<strong>Help &gt; Open log folder</strong>). After a crash it says what crashed and what you did last; attach it when you report a problem. See <a href="troubleshooting.html#the-log-file">The log file</a>.
</li>
</ul><h3 id="version-095" class="wn-ver">Version 0.9.5<time datetime="2026-10-31">2026-10-31</time></h3><h4 id="forge-spheres">Forge Spheres<a class="anchor" href="#forge-spheres" aria-label="Link to this section">#</a></h4>
-<p>Block out a body, creature or plant from connected spheres, the ZBrush way: <strong>Tool &gt; Forge Spheres &gt; New Forge Sphere</strong>, drag on a sphere to grow a limb, Move and Scale it into proportion, Alt+click to delete, with Symmetry mirroring every edit. <strong>Preview</strong> (<kbd>A</kbd>) shows the skin, and <strong>Make Mesh</strong> turns it into a sculptable, all-quad Part with a face group per limb, keeping the Forge Spheres to change later. See <a href="forge-spheres.html">Forge Spheres</a>.</p>
+<p>Block out a body, creature or plant from connected spheres: <strong>Tool &gt; Forge Spheres &gt; New Forge Sphere</strong>, drag on a sphere to grow a limb, Move and Scale it into proportion, Alt+click to delete, with Symmetry mirroring every edit. <strong>Preview</strong> (<kbd>A</kbd>) shows the skin, and <strong>Make Mesh</strong> turns it into a sculptable, all-quad Part with a face group per limb, keeping the Forge Spheres to change later. See <a href="forge-spheres.html">Forge Spheres</a>.</p>
<h4 id="blender-keys">Blender keys<a class="anchor" href="#blender-keys" aria-label="Link to this section">#</a></h4>
<p><strong>Preferences &gt; Input &gt; Style &gt; Blender</strong> brings Blender&#x27;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 <a href="shortcuts.html#blender-keys">Blender keys</a>.</p>
<h4 id="flat-shading">Flat shading<a class="anchor" href="#flat-shading" aria-label="Link to this section">#</a></h4>
@@ -488,7 +488,7 @@ SculptForge now keeps a log file, <code>sculptforge.log</code>, in its settings
<h4 id="spacemouse-experimental">SpaceMouse (experimental)<a class="anchor" href="#spacemouse-experimental" aria-label="Link to this section">#</a></h4>
<p>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. <strong>Preferences &gt; Input &gt; SpaceMouse</strong> 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&#x27;s driver, and hasn&#x27;t been tried on real hardware yet: see <a href="navigation.html#spacemouse-experimental">SpaceMouse</a> if yours doesn&#x27;t show up.</p>
<h4 id="your-own-lit-spheres">Your own Lit Spheres<a class="anchor" href="#your-own-lit-spheres" aria-label="Link to this section">#</a></h4>
-<p><strong>Material &gt; Load Lit Sphere...</strong> turns any image (PNG, JPG or EXR) into a material, and images you put in <strong>Documents/SculptForge/MatCaps</strong> show up in the material list, even while SculptForge is running. Right-click one and choose <strong>Remove</strong> to send it to the trash. Projects carry the Lit Sphere they use, so they look the same on any computer. See <a href="vertex-paint.html#your-own-lit-spheres">Your own Lit Spheres</a>.</p>
+<p><strong>Material &gt; Load Lit Sphere...</strong> turns any image (PNG, JPG or EXR) into a material, and images you put in <strong>Documents/SculptForge/Lit Spheres</strong> show up in the material list, even while SculptForge is running. Right-click one and choose <strong>Remove</strong> to send it to the trash. Projects carry the Lit Sphere they use, so they look the same on any computer. See <a href="vertex-paint.html#your-own-lit-spheres">Your own Lit Spheres</a>.</p>
<h4 id="fixes-2">Fixes<a class="anchor" href="#fixes-2" aria-label="Link to this section">#</a></h4>
<ul>
<li>
@@ -530,11 +530,11 @@ Idle, SculptForge no longer keeps your graphics card busy: it draws a new frame
<p>One click in the <strong>Splats</strong> 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&#x27;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 <a href="scan-to-sculptable.html">From scan to sculptable mesh</a>.</p>
<h4 id="your-phone-as-sculptforges-camera">Your phone as SculptForge&#x27;s camera<a class="anchor" href="#your-phone-as-sculptforges-camera" aria-label="Link to this section">#</a></h4>
<p><strong>File &gt; Capture from phone</strong> shows a QR code: scan it and your phone&#x27;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 <strong>View in AR</strong> to see your sculpt standing on your desk, updated as you sculpt, and <strong>Face capture</strong> to drive a character&#x27;s facial shapes with your own face, live. No app to install. See <a href="phone-capture.html">Phone capture and AR</a>.</p></div></details></section>
-<section class="wn-group" id="versions-08-and-earlier"><header class="wn-band wn-band-small"><h2>0.8 and earlier<a class="anchor" href="#versions-08-and-earlier" aria-label="Link to these versions">#</a></h2></header><ul class="wn-highlights"><li><strong>Dynamic topology</strong>: the brush adds triangles where it needs detail</li><li><strong>Vector displacement brushes</strong>: stamp whole shapes, overhangs and all</li><li><strong>Blender bridge</strong>: send models between Blender and SculptForge in one click</li><li><strong>Half the memory</strong>: 100 million triangles and more on a 32 GB laptop</li><li><strong>Subdivision levels</strong>: big forms low, fine detail high, without losing anything</li><li><strong>Map baking</strong>: normal, displacement and AO maps for game engines and renderers</li></ul><details class="wn-all"><summary>All changes</summary><div class="wn-body"><h3 id="version-081" class="wn-ver">Version 0.8.1<time datetime="2026-10-25">2026-10-25</time></h3><p>Fixes from a ZBrush artist&#x27;s testing, and a way to bring your ZTools over.</p>
-<h4 id="more-like-zbrush">More like ZBrush<a class="anchor" href="#more-like-zbrush" aria-label="Link to this section">#</a></h4>
+<section class="wn-group" id="versions-08-and-earlier"><header class="wn-band wn-band-small"><h2>0.8 and earlier<a class="anchor" href="#versions-08-and-earlier" aria-label="Link to these versions">#</a></h2></header><ul class="wn-highlights"><li><strong>Dynamic topology</strong>: the brush adds triangles where it needs detail</li><li><strong>Vector displacement brushes</strong>: stamp whole shapes, overhangs and all</li><li><strong>Blender bridge</strong>: send models between Blender and SculptForge in one click</li><li><strong>Half the memory</strong>: 100 million triangles and more on a 32 GB laptop</li><li><strong>Subdivision levels</strong>: big forms low, fine detail high, without losing anything</li><li><strong>Map baking</strong>: normal, displacement and AO maps for game engines and renderers</li></ul><details class="wn-all"><summary>All changes</summary><div class="wn-body"><h3 id="version-081" class="wn-ver">Version 0.8.1<time datetime="2026-10-25">2026-10-25</time></h3><p>Fixes from a professional sculptor&#x27;s testing, and a way to bring a library over.</p>
+<h4 id="more-classic">More classic<a class="anchor" href="#more-classic" aria-label="Link to this section">#</a></h4>
<ul>
<li>
-<strong>ZBrush zoom direction.</strong> With the ZBrush input style, dragging up zooms out on every zoom drag, as in ZBrush. See <a href="navigation.html">Navigation</a>.
+<strong>Classic zoom direction.</strong> With the Classic input style, dragging up zooms out on every zoom drag. See <a href="navigation.html">Navigation</a>.
</li>
<li>
<strong>Ctrl and Ctrl+Shift brushes.</strong> Hold <kbd>Ctrl</kbd> and the left shelf shows the mask brush; with <kbd>Ctrl</kbd> held the Brush and Stroke pickers pick Mask Pen, Mask Lasso or Mask Rectangle. <kbd>Ctrl</kbd>+<kbd>Shift</kbd> does the same for Select Rectangle and Select Lasso. See <a href="masking.html">Masking</a>.
@@ -545,20 +545,20 @@ Idle, SculptForge no longer keeps your graphics card busy: it draws a new frame
</ul>
<h4 id="texture-painting-one-click-to-start-and-faster">Texture painting: one click to start, and faster<a class="anchor" href="#texture-painting-one-click-to-start-and-faster" aria-label="Link to this section">#</a></h4>
<p>With the Paint brush on, a Part without a texture now shows <strong>New Texture</strong> 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 <a href="texture-painting.html">Texture painting</a>.</p>
-<h4 id="bring-your-ztools-over">Bring your ZTools over<a class="anchor" href="#bring-your-ztools-over" aria-label="Link to this section">#</a></h4>
-<p>ZBrush&#x27;s <code>.ZTL</code> files are proprietary, but a free plug-in for ZBrush now converts them once, and then SculptForge opens the <code>.ZTL</code> itself, every Part with its face groups, vertex paint, mask and UVs. See <a href="coming-from-zbrush.html#bring-your-ztools-over">Coming from ZBrush</a>.</p><h3 id="version-08" class="wn-ver">Version 0.8<time datetime="2026-10-25">2026-10-25</time></h3><p>Dynamic topology, vector displacement brushes, Quad Remesh Guides, and sculpt layers on every subdivision level.</p>
-<h4 id="dynamic-topology-sculptris-pro">Dynamic topology (Sculptris Pro)<a class="anchor" href="#dynamic-topology-sculptris-pro" aria-label="Link to this section">#</a></h4>
+<h4 id="bring-a-library-over">Bring a library over<a class="anchor" href="#bring-a-library-over" aria-label="Link to this section">#</a></h4>
+<p>Another app&#x27;s library files are proprietary, but a free export plug-in now converts them once, and then SculptForge opens the library file itself, every Part with its face groups, vertex paint, mask and UVs. See the <a href="https://github.com/islandmed/SculptForge/blob/main/integrations/bridge-plugin/README.md" rel="noopener">Bridge setup page</a>.</p><h3 id="version-08" class="wn-ver">Version 0.8<time datetime="2026-10-25">2026-10-25</time></h3><p>Dynamic topology, vector displacement brushes, Quad Remesh Guides, and sculpt layers on every subdivision level.</p>
+<h4 id="dynamic-topology">Dynamic topology<a class="anchor" href="#dynamic-topology" aria-label="Link to this section">#</a></h4>
<p>Turn on <strong>Dynamic</strong> on the top shelf and the brush adds triangles where it needs detail and removes them where it doesn&#x27;t: pull a sphere into horns or fingers without stretching, block in from a ball without remeshing. <strong>Detail</strong> sets how small the triangles get, relative to the brush (zoom in for finer ones) or, with <strong>Constant detail</strong>, one size for the whole mesh. Symmetry makes mirrored triangles, borders and masks are kept, and each stroke is one small undo step. See <a href="dynamic-topology.html">Dynamic topology</a>.</p>
<h4 id="vector-displacement-brushes">Vector displacement brushes<a class="anchor" href="#vector-displacement-brushes" aria-label="Link to this section">#</a></h4>
<p>One drag stamps a whole shape, overhangs and all: the new <strong>VDM</strong> 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 <strong>VDM Plane</strong> and clicking <strong>Create VDM</strong>, or load the EXRs Blender&#x27;s VDM Brush Baker makes (and export yours for Blender). The new <strong>Slide Stamp</strong> stroke slides a stamp into place. See <a href="sculpting.html#vector-displacement-brushes">Vector displacement brushes</a>.</p>
-<h4 id="zbrush-keys-in-blenders-sculpt-mode">ZBrush keys in Blender&#x27;s Sculpt Mode<a class="anchor" href="#zbrush-keys-in-blenders-sculpt-mode" aria-label="Link to this section">#</a></h4>
-<p>The Blender add-on has a new preference, <strong>ZBrush-style keys in Sculpt Mode</strong>: S, U and O for Draw Size, Strength and Falloff, B for the brushes by their ZBrush names, Space for the quick menu, Alt to dig in, Ctrl to mask, Ctrl+Shift to hide, D and Shift+D for subdivision levels, and more. See <a href="blender.html#zbrush-style-keys-in-sculpt-mode">Working with Blender</a>.</p>
+<h4 id="classic-sculpting-keys-in-blenders-sculpt-mode">Classic sculpting keys in Blender&#x27;s Sculpt Mode<a class="anchor" href="#classic-sculpting-keys-in-blenders-sculpt-mode" aria-label="Link to this section">#</a></h4>
+<p>The Blender add-on has a new preference, <strong>The Classic sculpting keys in Sculpt Mode</strong>: S, U and O for Draw 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 <a href="blender.html#classic-sculpting-keys-in-sculpt-mode">Working with Blender</a>.</p>
<h4 id="draw-the-edge-loops-you-want">Draw the edge loops you want<a class="anchor" href="#draw-the-edge-loops-you-want" aria-label="Link to this section">#</a></h4>
-<p><strong>Quad Remesh Guides</strong> work like ZBrush&#x27;s ZRemesher Guides brush: 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 <strong>Curves Strength</strong> sets how far around a curve the flow follows it. Guides are kept with each Part and saved in the project. See <a href="retopology.html#quad-remesh-guides">Quad Remesh Guides</a>.</p>
+<p><strong>Quad Remesh Guides</strong> 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 <strong>Curves Strength</strong> sets how far around a curve the flow follows it. Guides are kept with each Part and saved in the project. See <a href="retopology.html#quad-remesh-guides">Quad Remesh Guides</a>.</p>
<h4 id="sculpt-layers-on-every-subdivision-level">Sculpt layers on every subdivision level<a class="anchor" href="#sculpt-layers-on-every-subdivision-level" aria-label="Link to this section">#</a></h4>
-<p>Sculpt layers now have a guide section on how they work with subdivision levels, like ZBrush&#x27;s 3D Layers: record a layer at the top, step down and up, divide, reconstruct or delete levels, save, and it&#x27;s still there, with one weight for every level. See <a href="layers.html#layers-and-subdivision-levels">Layers and subdivision levels</a>.</p><h3 id="version-07" class="wn-ver">Version 0.7<time datetime="2026-10-25">2026-10-25</time></h3><p>ZBrush&#x27;s keys and gestures by default, and a bridge that sends models between Blender and SculptForge.</p>
-<h4 id="your-zbrush-hands-just-work">Your ZBrush hands just work<a class="anchor" href="#your-zbrush-hands-just-work" aria-label="Link to this section">#</a></h4>
-<p>SculptForge now follows ZBrush&#x27;s keys and gestures by default. A ZBrush sculptor tried an earlier version and put it down because it didn&#x27;t feel like ZBrush; this release goes through every habit of the first hour. <a href="coming-from-zbrush.html">Coming from ZBrush</a> lists what&#x27;s the same, what&#x27;s different and every shortcut side by side.</p>
+<p>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&#x27;s still there, with one weight for every level. See <a href="layers.html#layers-and-subdivision-levels">Layers and subdivision levels</a>.</p><h3 id="version-07" class="wn-ver">Version 0.7<time datetime="2026-10-25">2026-10-25</time></h3><p>The Classic sculpting keys and gestures by default, and a bridge that sends models between Blender and SculptForge.</p>
+<h4 id="your-hands-just-work">Your hands just work<a class="anchor" href="#your-hands-just-work" aria-label="Link to this section">#</a></h4>
+<p>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&#x27;t feel; this release goes through every habit of the first hour. <a href="quick-tour.html">Quick tour for experienced sculptors</a> lists what&#x27;s the same, what&#x27;s different and every shortcut side by side.</p>
<ul>
<li>
<strong>S, U, I, O</strong> open Draw Size, Intensity, RGB Intensity and Falloff under the cursor, and <kbd>Space</kbd> opens the Quick Menu with all of them plus the brush, stroke, alpha and material.
@@ -567,16 +567,16 @@ Idle, SculptForge no longer keeps your graphics card busy: it draws a new frame
<strong>Falloff</strong> shapes the brush falloff, shown as the cursor&#x27;s inner ring. <strong>RGB Intensity</strong> gives painting a strength of its own, and <strong>Smooth keeps its own Intensity</strong>, so a gentle brush still smooths properly.
</li>
<li>
-<strong>ZBrush&#x27;s brush letters</strong>: B C B Clay Block, B D S Sharp Crease, B M V Move, B I N Inflate...
+<strong>brush letters</strong>: B C B Clay Block, B D S Sharp Crease, B M V Move, B I N Inflate...
</li>
<li>
-<strong>Masking</strong>: <kbd>Ctrl</kbd>+click the model blurs the mask, <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+click sharpens it; <kbd>Ctrl</kbd>+<kbd>A</kbd>, <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>A</kbd>, <kbd>Ctrl</kbd>+<kbd>I</kbd>, <kbd>Ctrl</kbd>+<kbd>H</kbd> and <kbd>Ctrl</kbd>+<kbd>W</kbd> (group masked) work as in ZBrush.
+<strong>Masking</strong>: <kbd>Ctrl</kbd>+click the model blurs the mask, <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+click sharpens it; <kbd>Ctrl</kbd>+<kbd>A</kbd>, <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>A</kbd>, <kbd>Ctrl</kbd>+<kbd>I</kbd>, <kbd>Ctrl</kbd>+<kbd>H</kbd> and <kbd>Ctrl</kbd>+<kbd>W</kbd> (group masked) work.
</li>
<li>
<strong>Strokes and the view</strong>: <kbd>Shift</kbd> pressed mid-stroke draws a straight line; <kbd>Shift</kbd>+click, let go and drag rolls the view; <kbd>Shift</kbd>+<kbd>Alt</kbd>+click frames a Part; <kbd>L</kbd> toggles Lazy Stroke and <kbd>V</kbd> swaps colours.
</li>
<li>
-<strong>Visibility</strong>: <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+click on a partly hidden mesh hides the group, as in ZBrush.
+<strong>Visibility</strong>: <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+click on a partly hidden mesh hides the group.
</li>
<li>
<strong>Prefer the old keys?</strong> <strong>Preferences &gt; Input &gt; Style &gt; SculptForge</strong> brings back the number keys for brushes, <kbd>I</kbd> for Intensity and the <kbd>Ctrl</kbd>+drag zoom.
@@ -621,9 +621,9 @@ Opening a big model or dividing it sends it to the graphics card about 40% faste
<h4 id="stl-files-print-at-the-right-size">STL files print at the right size<a class="anchor" href="#stl-files-print-at-the-right-size" aria-label="Link to this section">#</a></h4>
<p>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 <a href="exporting.html#3d-printing">Exporting</a>.</p>
<h4 id="update-notifications">Update notifications<a class="anchor" href="#update-notifications" aria-label="Link to this section">#</a></h4>
-<p>Once a day SculptForge looks on its website for a newer version, and if there is one, a small banner says what&#x27;s in it, with <strong>What&#x27;s new</strong>, <strong>Download</strong>, <strong>Later</strong> and <strong>Skip this version</strong>. It downloads one small file and sends nothing about you or your computer. Turn it off under <strong>Preferences &gt; Updates</strong>, or check by hand with <strong>Help &gt; Check for updates</strong>. Builds from a package manager (such as the AUR package) leave the checking to the package manager.</p><h3 id="version-05" class="wn-ver">Version 0.5<time datetime="2026-10-23">2026-10-23</time></h3><p>The ZBrush workflow core: subdivision levels, quad retopology, map baking, the Gizmo, and speed at tens of millions of polygons.</p>
+<p>Once a day SculptForge looks on its website for a newer version, and if there is one, a small banner says what&#x27;s in it, with <strong>What&#x27;s new</strong>, <strong>Download</strong>, <strong>Later</strong> and <strong>Skip this version</strong>. It downloads one small file and sends nothing about you or your computer. Turn it off under <strong>Preferences &gt; Updates</strong>, or check by hand with <strong>Help &gt; Check for updates</strong>. Builds from a package manager (such as the AUR package) leave the checking to the package manager.</p><h3 id="version-05" class="wn-ver">Version 0.5<time datetime="2026-10-23">2026-10-23</time></h3><p>The sculpting workflow core: subdivision levels, quad retopology, map baking, the Gizmo, and speed at tens of millions of polygons.</p>
<h4 id="subdivision-levels">Subdivision levels<a class="anchor" href="#subdivision-levels" aria-label="Link to this section">#</a></h4>
-<p>Sculpt one model at several resolutions, as with ZBrush&#x27;s SDiv: big forms low, fine detail high, and back down without losing anything.</p>
+<p>Sculpt one model at several resolutions: big forms low, fine detail high, and back down without losing anything.</p>
<ul>
<li>
<strong>Divide</strong> (<kbd>Ctrl</kbd>+<kbd>D</kbd>) adds a level and keeps the ones below. Quads stay quads (Catmull-Clark); <strong>Smt</strong> off divides without smoothing.
@@ -643,7 +643,7 @@ Mask, vertex paint, paint layers, face groups, hidden faces, UVs and sculpt laye
</ul>
<p>See <a href="subdivision-levels.html">Subdivision levels</a>.</p>
<h4 id="gizmo-move-scale-rotate-and-pose">Gizmo: move, scale, rotate and pose<a class="anchor" href="#gizmo-move-scale-rotate-and-pose" aria-label="Link to this section">#</a></h4>
-<p>ZBrush&#x27;s Gizmo 3D, with the same keys: <kbd>W</kbd> Move, <kbd>E</kbd> Scale, <kbd>R</kbd> Rotate, <kbd>Q</kbd> back to Draw (also on the top shelf and in the <strong>Transform</strong> palette).</p>
+<p>Gizmo 3D, with the same keys: <kbd>W</kbd> Move, <kbd>E</kbd> Scale, <kbd>R</kbd> Rotate, <kbd>Q</kbd> back to Draw (also on the top shelf and in the <strong>Transform</strong> palette).</p>
<ul>
<li>
<strong>Handles over the model.</strong> Arrows, plane squares and a free-move centre; axis rings and a view ring; axis boxes and a uniform centre. <kbd>Shift</kbd> snaps to 15 degrees, the grid or 10% steps.
@@ -661,7 +661,7 @@ Mask, vertex paint, paint layers, face groups, hidden faces, UVs and sculpt laye
Fast on big models: a drag frame on 1.3 million triangles takes about 10 ms.
</li>
</ul>
-<p><kbd>W</kbd> no longer toggles the wireframe: use <kbd>Shift</kbd>+<kbd>F</kbd> (as in ZBrush) or <strong>Wire</strong> on the right shelf. See <a href="gizmo.html">Moving, rotating and posing</a>.</p>
+<p><kbd>W</kbd> no longer toggles the wireframe: use <kbd>Shift</kbd>+<kbd>F</kbd> or <strong>Wire</strong> on the right shelf. See <a href="gizmo.html">Moving, rotating and posing</a>.</p>
<h4 id="normal-displacement-and-ao-map-baking">Normal, displacement and AO map baking<a class="anchor" href="#normal-displacement-and-ao-map-baking" aria-label="Link to this section">#</a></h4>
<p>Bake the detail of a high-poly sculpt into maps on a low-poly&#x27;s UVs, for game engines and renderers: <strong>Tool &gt; Bake</strong>.</p>
<ul>
@@ -675,7 +675,7 @@ Fast on big models: a drag frame on 1.3 million triangles takes about 10 ms.
<strong>Check it on the model.</strong> The low-poly shows its baked normal map in the viewport as soon as the bake ends, next to the high-poly.
</li>
<li>
-<strong>ZBrush-style controls</strong>: 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.
+<strong>The Classic sculpting keys</strong>: 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.
</li>
<li>
<strong>Send to Unreal</strong> brings the normal map along, set up as a normal map. The <code>bake</code> command does it all from scripts.
@@ -685,7 +685,7 @@ Fast on big models: a drag frame on 1.3 million triangles takes about 10 ms.
<h4 id="quad-retopology-and-detail-projection">Quad retopology and detail projection<a class="anchor" href="#quad-retopology-and-detail-projection" aria-label="Link to this section">#</a></h4>
<ul>
<li>
-<strong>Quad Remesh</strong> (<strong>Tool &gt; Geometry</strong>, like ZRemesher) rebuilds a sculpt as clean quads whose edge loops follow the forms, near a <strong>Target Polygons</strong> count, in the background. <strong>Keep Groups</strong>, <strong>Adaptive Size</strong>, <strong>Use Vertex Paint</strong>, <strong>Symmetry</strong> and <strong>Half / Same / Double</strong> work as in ZBrush.
+<strong>Quad Remesh</strong> (<strong>Tool &gt; Geometry</strong>, like quad remesh) rebuilds a sculpt as clean quads whose edge loops follow the forms, near a <strong>Target Polygons</strong> count, in the background. <strong>Keep Groups</strong>, <strong>Adaptive Size</strong>, <strong>Use Vertex Paint</strong>, <strong>Symmetry</strong> and <strong>Half / Same / Double</strong> work.
</li>
<li>
<strong>Project All</strong> (<strong>Tool &gt; Parts &gt; Project</strong>) puts the sculpted detail and vertex paint back onto the divided quads, with <strong>Dist</strong>, <strong>Mean</strong> and <strong>PA Blur</strong>, and respects the mask.
@@ -754,20 +754,20 @@ Fast on big models: a drag frame on 1.3 million triangles takes about 10 ms.
<strong>The same paint layers.</strong> <strong>Tool &gt; Paint Layers</strong> works on the texture&#x27;s layers: blend modes, opacity, merge, flatten, all undoable.
</li>
<li>
-<strong>Convert both ways</strong>, <strong>Show UVs</strong>, <strong>Import / Export Texture</strong> (PNG). Projects save textures and their layers, and model exports write the texture next to the model (OBJ <code>.mtl</code>, glTF, USD, FBX, GoZ-compatible files).
+<strong>Convert both ways</strong>, <strong>Show UVs</strong>, <strong>Import / Export Texture</strong> (PNG). Projects save textures and their layers, and model exports write the texture next to the model (OBJ <code>.mtl</code>, glTF, USD, FBX, Bridge files).
</li>
</ul>
-<p>See <a href="texture-painting.html">Texture painting</a>.</p><h3 id="version-041" class="wn-ver">Version 0.4.1<time datetime="2026-10-23">2026-10-23</time></h3><p>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&#x27;s; now, while the pen is in range, only the pen moves the brush. See <a href="troubleshooting.html#pen-tablets">Pen tablets</a> if your pen still misbehaves.</p><h3 id="version-04" class="wn-ver">Version 0.4<time datetime="2026-10-22">2026-10-22</time></h3><p>Version 0.4 is about making SculptForge feel like home to ZBrush artists. It was shaped by feedback from a working ZBrush modeler and by what sculptors say on the ZBrush and Mudbox forums.</p>
-<h4 id="navigation-that-works-like-zbrush">Navigation that works like ZBrush<a class="anchor" href="#navigation-that-works-like-zbrush" aria-label="Link to this section">#</a></h4>
+<p>See <a href="texture-painting.html">Texture painting</a>.</p><h3 id="version-041" class="wn-ver">Version 0.4.1<time datetime="2026-10-23">2026-10-23</time></h3><p>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&#x27;s; now, while the pen is in range, only the pen moves the brush. See <a href="troubleshooting.html#pen-tablets">Pen tablets</a> if your pen still misbehaves.</p><h3 id="version-04" class="wn-ver">Version 0.4<time datetime="2026-10-22">2026-10-22</time></h3><p>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>
+<h4 id="classic-navigation">Classic navigation<a class="anchor" href="#classic-navigation" aria-label="Link to this section">#</a></h4>
<ul>
<li>
-<strong>Free rotation.</strong> Dragging turns the model the way the cursor moves and can roll it right over the top, as in ZBrush. If you prefer the model to stay upright, set <strong>Preferences &gt; Interface &gt; Rotation</strong> to <strong>Turntable</strong>.
+<strong>Free rotation.</strong> 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 <strong>Preferences &gt; Interface &gt; Rotation</strong> to <strong>Turntable</strong>.
</li>
<li>
<strong>Snap to a view.</strong> Hold <kbd>Shift</kbd> while rotating to snap to the nearest front, back, side, top or bottom view.
</li>
<li>
-<strong>ZBrush zoom.</strong> <kbd>Alt</kbd>+drag on the background pans; let go of <kbd>Alt</kbd> while still dragging and the rest of the drag zooms. With the right mouse button, <kbd>Alt</kbd> pans and <kbd>Ctrl</kbd> zooms.
+<strong>Classic zoom.</strong> <kbd>Alt</kbd>+drag on the background pans; let go of <kbd>Alt</kbd> while still dragging and the rest of the drag zooms. With the right mouse button, <kbd>Alt</kbd> pans and <kbd>Ctrl</kbd> zooms.
</li>
</ul>
<p>See <a href="navigation.html">Navigating the view</a>.</p>
@@ -784,9 +784,9 @@ Fast on big models: a drag frame on 1.3 million triangles takes about 10 ms.
<h4 id="a-material-made-for-sculpting">A material made for sculpting<a class="anchor" href="#a-material-made-for-sculpting" aria-label="Link to this section">#</a></h4>
<p>The new <strong>Sculpt</strong> 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 (<kbd>M</kbd>), and projects keep the material they were saved with. See <a href="vertex-paint.html">Vertex Paint and materials</a>.</p>
<h4 id="quads-stay-quads">Quads stay quads<a class="anchor" href="#quads-stay-quads" aria-label="Link to this section">#</a></h4>
-<p>Models you bring in from ZBrush (Send to ZBrush) or as OBJ, FBX, PLY or USD keep their quads: <strong>Wire</strong> shows them as quads, and exporting writes them back as quads. Subdivide turns each quad into four, voxel remesh now gives an even grid of quads (like DynaMesh), and new cubes and planes are made of quads. See <a href="geometry.html#quads-and-triangles">Quads and triangles</a>.</p>
+<p>Models you bring in from the other app (Bridge) or as OBJ, FBX, PLY or USD keep their quads: <strong>Wire</strong> 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 <a href="geometry.html#quads-and-triangles">Quads and triangles</a>.</p>
<h4 id="paint-layers">Paint layers<a class="anchor" href="#paint-layers" aria-label="Link to this section">#</a></h4>
-<p>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&#x27;s underneath, and you can merge, flatten, duplicate and reorder layers. ZBrush has never had this. Find it in <strong>Tool &gt; Paint Layers</strong>, and see <a href="vertex-paint.html#paint-layers">Paint layers</a>.</p>
+<p>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&#x27;s underneath, and you can merge, flatten, duplicate and reorder layers. Find it in <strong>Tool &gt; Paint Layers</strong>, and see <a href="vertex-paint.html#paint-layers">Paint layers</a>.</p>
<figure class="shot"><a href="images/paint-layers.jpg" class="zoom"><img src="images/paint-layers.jpg" alt="The Paint Layers sub-palette with three layers and their blend modes" width="960" height="557" loading="lazy" decoding="async"></a><figcaption>The Paint Layers sub-palette with three layers and their blend modes</figcaption></figure>
<h4 id="easier-to-install">Easier to install<a class="anchor" href="#easier-to-install" aria-label="Link to this section">#</a></h4>
<p>The <a href="installing.html">download links</a> now always get the newest version, and there are one-command installers for Windows, macOS and Linux.</p><h3 id="version-03" class="wn-ver">Version 0.3<time datetime="2026-10-22">2026-10-22</time></h3><ul>
@@ -794,7 +794,7 @@ Fast on big models: a drag frame on 1.3 million triangles takes about 10 ms.
<strong>Parts</strong>: several separate meshes in one scene. Append, duplicate, split, merge, solo, and <kbd>Alt</kbd>+click to select. See <a href="parts.html">Parts</a>.
</li>
<li>
-<strong>A ZBrush-style interface</strong>: shelves around the canvas, alphabetical palettes, the Library (<kbd>,</kbd>), the brush, stroke, alpha and material pickers, hold-<kbd>Ctrl</kbd> help on every control and a command palette (<kbd>F3</kbd>). See <a href="interface.html">The interface</a>.
+<strong>A classic interface</strong>: shelves around the canvas, alphabetical palettes, the Library (<kbd>,</kbd>), the brush, stroke, alpha and material pickers, hold-<kbd>Ctrl</kbd> help on every control and a command palette (<kbd>F3</kbd>). See <a href="interface.html">The interface</a>.
</li>
<li>
<strong>Graphics tablets</strong>: pen pressure, the eraser end and pen buttons. See <a href="sculpting.html">Sculpting and brushes</a>.
@@ -816,12 +816,12 @@ Fast on big models: a drag frame on 1.3 million triangles takes about 10 ms.
New brushes: Sharp Crease, Clay Block, Tendril, Trim, Layer and Nudge, with strokes and alphas.
</li>
<li>
-<a href="projects.html">Project files</a> with autosave, recent files and snapshots, and <a href="exporting.html">exchange with ZBrush (Send to ZBrush)</a>.
+<a href="projects.html">Project files</a> with autosave, recent files and snapshots, and <a href="exporting.html">exchange with the other app (Bridge)</a>.
</li>
</ul><h3 id="version-01" class="wn-ver">Version 0.1<time datetime="2026-10-20">2026-10-20</time></h3><p>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></div></details></section>
<script>(function(){function o(){var h=location.hash.slice(1);if(!h)return;var e=document.getElementById(h);for(var p=e;p;p=p.parentElement)if(p.tagName==='DETAILS')p.open=true;if(e)e.scrollIntoView();}addEventListener('hashchange',o);o();})();</script>
</article>
- <nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="first-sculpt.html"><span>Previous</span>Your first sculpt in 10 minutes</a><a class="next" rel="next" href="coming-from-zbrush.html"><span>Next</span>Coming from ZBrush</a></nav>
+ <nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="first-sculpt.html"><span>Previous</span>Your first sculpt in 10 minutes</a><a class="next" rel="next" href="quick-tour.html"><span>Next</span>Quick tour for experienced sculptors</a></nav>
<p class="guide-meta fine">Also in the app: <strong>Help &gt; User Guide</strong> (<kbd>Shift</kbd>+<kbd>F1</kbd>).
Found a mistake? <a href="https://github.com/islandmed/SculptForge/edit/main/docs/guide/whats-new.md">Edit this page on GitHub</a>.</p>
</main>
@@ -842,8 +842,7 @@ New brushes: Sharp Crease, Clay Block, Tendril, Trim, Layer and Nudge, with stro
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services &amp; privacy</a>
</div>
- <p class="fine trademarks">ZBrush, GoZ, MatCap and other ZBrush feature names are trademarks of Maxon Computer
- GmbH. SculptForge is not affiliated with or endorsed by Maxon. All other trademarks belong to their owners.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
diff --git a/website/guide/zspheres.html b/website/guide/zspheres.html
deleted file mode 100644
index fe87eb2c..00000000
--- a/website/guide/zspheres.html
+++ /dev/null
@@ -1,13 +0,0 @@
-<!doctype html>
-<html lang="en">
-<head>
- <meta charset="utf-8">
- <title>Moved - SculptForge User Guide</title>
- <meta name="robots" content="noindex">
- <link rel="canonical" href="https://sculptforge.app/guide/forge-spheres.html">
- <meta http-equiv="refresh" content="0; url=forge-spheres.html">
-</head>
-<body>
- <p>This chapter has moved to <a href="forge-spheres.html">https://sculptforge.app/guide/forge-spheres.html</a>.</p>
-</body>
-</html>
diff --git a/website/img/social-preview.png b/website/img/social-preview.png
index 91c44d3d..46bc3d00 100644
Binary files a/website/img/social-preview.png and b/website/img/social-preview.png differ
diff --git a/website/index.html b/website/index.html
index 2c5b8ccf..140acb27 100644
--- a/website/index.html
+++ b/website/index.html
@@ -3,21 +3,21 @@
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
- <title>SculptForge - the free, open-source ZBrush and Mudbox alternative for VFX, animation and games</title>
- <meta name="description" content="SculptForge is a free, open-source alternative to ZBrush and Mudbox for VFX, animation and game studios: VFX Reference Platform CY2026 and CY2027 builds, OpenUSD, a Python API, Send to Unreal, Gaussian splats and free built-in AI (an AI brush creator and image or text to 3D), on Linux, macOS and Windows.">
+ <title>SculptForge - the free, open-source sculpting app for VFX, animation and games</title>
+ <meta name="description" content="SculptForge is a free, open-source sculpting app for VFX, animation and game studios: VFX Reference Platform CY2026 and CY2027 builds, OpenUSD, a Python API, Send to Unreal, Gaussian splats and free built-in AI (an AI brush creator and image or text to 3D), on Linux, macOS and Windows.">
<meta name="theme-color" content="#111114">
<meta name="color-scheme" content="dark">
<link rel="icon" type="image/svg+xml" href="img/favicon.svg?v=2">
<link rel="icon" type="image/png" href="img/favicon-64.png?v=2">
<link rel="apple-touch-icon" href="img/icon-256.png?v=2">
<meta property="og:type" content="website">
- <meta property="og:title" content="SculptForge - the free, open-source ZBrush and Mudbox alternative for VFX, animation and games">
- <meta property="og:description" content="Sculpting for VFX, animation and games, with ZBrush-style keys available. VFX Reference Platform CY2026 and CY2027 builds, OpenUSD, a Python API and Send to Unreal. Free built-in AI: describe a brush and get it, or turn a sketch into a model.">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:title" content="SculptForge - the free, open-source sculpting app for VFX, animation and games">
+ <meta property="og:description" content="Sculpting for VFX, animation and games, with classic sculpting keys available. VFX Reference Platform CY2026 and CY2027 builds, OpenUSD, a Python API and Send to Unreal. Free built-in AI: describe a brush and get it, or turn a sketch into a model.">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/">
<link rel="canonical" href="https://sculptforge.app/">
<script type="application/ld+json">
- {"@context": "https://schema.org", "@type": "SoftwareApplication", "name": "SculptForge", "url": "https://sculptforge.app/", "applicationCategory": "MultimediaApplication", "applicationSubCategory": "3D sculpting", "operatingSystem": "Windows 10, Windows 11, macOS, Linux", "softwareVersion": "0.10.10", "description": "Free, open-source digital sculpting: an alternative to ZBrush and Mudbox for VFX, animation and game studios.", "license": "https://www.gnu.org/licenses/gpl-3.0.html", "isAccessibleForFree": true, "offers": {"@type": "Offer", "price": "0", "priceCurrency": "USD"}, "downloadUrl": "https://github.com/islandmed/SculptForge/releases/latest", "image": "https://sculptforge.app/img/social-preview.png?v=3", "sameAs": ["https://github.com/islandmed/SculptForge"]}
+ {"@context": "https://schema.org", "@type": "SoftwareApplication", "name": "SculptForge", "url": "https://sculptforge.app/", "applicationCategory": "MultimediaApplication", "applicationSubCategory": "3D sculpting", "operatingSystem": "Windows 10, Windows 11, macOS, Linux", "softwareVersion": "0.10.10", "description": "Free, open-source digital sculpting for VFX, animation and game studios.", "license": "https://www.gnu.org/licenses/gpl-3.0.html", "isAccessibleForFree": true, "offers": {"@type": "Offer", "price": "0", "priceCurrency": "USD"}, "downloadUrl": "https://github.com/islandmed/SculptForge/releases/latest", "image": "https://sculptforge.app/img/social-preview.png?v=4", "sameAs": ["https://github.com/islandmed/SculptForge"]}
</script>
<meta name="twitter:card" content="summary_large_image">
<link rel="stylesheet" href="style.css?v=19">
@@ -51,14 +51,14 @@
<div class="hero-copy">
<a class="new-badge" href="#whats-new"><span>New in 0.10</span>
Quad Remesh 2, elastic Kelvinlet brushes, hundreds of millions of polygons →</a>
- <p class="eyebrow">The free, open-source alternative to ZBrush and Mudbox</p>
+ <p class="eyebrow">The free, open-source sculpting app</p>
<h1><span class="nowrap">Sculpt it.</span> <span class="nowrap">Forge it.</span><br><span class="accent">Ship it.</span></h1>
<p class="lede">Digital sculpting for <strong>VFX, animation and game studios</strong> on Linux, macOS and
- Windows, with a ZBrush-style keymap (and Blender and Maya styles) for artists switching over, and no subscription. It
+ Windows, with a the Classic sculpting keys (and Blender and Maya styles) for artists switching over, and no subscription. It
ships <strong>VFX Reference Platform</strong> builds, OpenUSD and a Python API for studio pipelines,
one-click game-ready LODs and Send to Unreal, plus <strong>free built-in AI</strong>: describe a brush and
Brush Lab builds it, or turn a sketch or a sentence into a model you can sculpt.</p>
- <p class="lede-short">Sculpting for VFX, animation and games, with ZBrush-style keys available, VFX Reference Platform
+ <p class="lede-short">Sculpting for VFX, animation and games, with the Classic sculpting keys available, VFX Reference Platform
builds, OpenUSD and Python, plus free built-in AI: an AI brush creator and sketch to 3D.</p>
<div class="ctas">
<a class="btn primary" href="#download">Download</a>
@@ -127,7 +127,7 @@
<article class="card">
<h3>Sculpt the way you already do</h3>
<p>Fourteen brushes including Clay Block, Sharp Crease, Tendril, Trim and Move, with alphas, Lazy
- Stroke, symmetry, tablet pressure, ZBrush, Blender and Maya-style navigation, subdivision and voxel remesh.</p>
+ Stroke, symmetry, tablet pressure, classic, Blender and Maya-style navigation, subdivision and voxel remesh.</p>
</article>
<article class="card">
<h3>Masking and face groups</h3>
@@ -137,7 +137,7 @@
<article class="card">
<h3>Parts</h3>
<p>Keep the body, eyes, teeth and armour as separate meshes. Append, split, merge and solo them, Alt+click
- to pick one, and export each as its own object to glTF, FBX, USD or straight back to ZBrush.</p>
+ to pick one, and export each as its own object to glTF, FBX, USD or through the Bridge.</p>
</article>
<article class="card">
<h3>Vertex paint, layers and lit spheres</h3>
@@ -152,9 +152,9 @@
the add-on</a> · <a href="guide/blender.html">how it works</a></p>
</article>
<article class="card">
- <h3>Works with ZBrush</h3>
- <p>Open and save .GoZ files with face groups, masks, UVs and vertex paint, and send models to and from
- ZBrush on Windows and macOS. Project files keep everything, with autosave and crash recovery.</p>
+ <h3>Works with your other apps</h3>
+ <p>Exchange models with another sculpting app through the Bridge, with face groups, masks, UVs and vertex
+ paint, on Windows and macOS. Project files keep everything, with autosave and crash recovery.</p>
</article>
<article class="card">
<h3>Brush Lab: describe a brush</h3>
@@ -336,25 +336,6 @@ rez-env sculptforge -- sculptforge troll.usda \
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">See the AI services and privacy guide</a>.</p>
</div>
<div>
- <h2>How it compares</h2>
- <div class="table-wrap">
- <table class="compare">
- <thead><tr><th></th><th>SculptForge</th><th>ZBrush</th><th>Mudbox</th><th>Blender</th><th>Nomad</th></tr></thead>
- <tbody>
- <tr><td>Price</td><td class="yes">Free</td><td>Subscription</td><td>Subscription (sales end Nov 2026)</td><td class="yes">Free</td><td>Paid</td></tr>
- <tr><td>Built for sculpting</td><td class="yes">Yes</td><td>Yes</td><td>Yes</td><td>General 3D suite</td><td>Yes (mobile first)</td></tr>
- <tr><td>Actively developed</td><td class="yes">Yes</td><td>Yes</td><td>No (being retired)</td><td class="yes">Yes</td><td>Yes</td></tr>
- <tr><td>Open source</td><td class="yes">GPL</td><td>No</td><td>No</td><td class="yes">GPL</td><td>No</td></tr>
- <tr><td>Native Linux</td><td class="yes">Yes</td><td>No</td><td>RHEL / Rocky</td><td class="yes">Yes</td><td>No</td></tr>
- <tr><td>Send to Unreal</td><td class="yes">Built in</td><td>Plugin</td><td>No (FBX export)</td><td>Add-on</td><td>No</td></tr>
- <tr><td>Image / text to 3D</td><td class="yes">Built in</td><td>No</td><td>No</td><td>Add-ons</td><td>No</td></tr>
- <tr><td>Gaussian splats</td><td class="yes">Built in</td><td>No</td><td>No</td><td>Add-ons</td><td>No</td></tr>
- <tr><td>AI agent control (MCP)</td><td class="yes">Built in</td><td>No</td><td>No</td><td>Add-ons</td><td>No</td></tr>
- <tr><td>VFX Reference Platform builds</td><td class="yes">CY2026/27</td><td>No</td><td>Not stated</td><td class="yes">Yes</td><td>No</td></tr>
- </tbody>
- </table>
- </div>
- <p class="fine">Other products' columns: as of November 2026, from each product's public pages; <a href="https://github.com/islandmed/SculptForge/issues">tell us</a> if something changed.</p>
<p class="fine">SculptForge is young: UDIMs, Ptex and separate texture channels aren't there yet.
<a href="https://github.com/islandmed/SculptForge/blob/main/ROADMAP.md">See the roadmap</a>.</p>
</div>
@@ -412,24 +393,12 @@ rez-env sculptforge -- sculptforge troll.usda \
<p>It targets Unreal Engine 5. It uses Unreal's built-in Python remote execution, so you only enable
the Python plugin and tick "Enable Remote Execution"; there's nothing to install in your project.
You can always export an Unreal-ready FBX instead.</p></details>
- <details><summary>Can SculptForge replace ZBrush for me?</summary>
- <p>For many sculpting and game-asset jobs, yes. Blocking out, sculpting forms and detail, blend shapes,
- LODs and getting assets into Unreal, glTF or USD all work today, with familiar brushes and controls.
- Masking, face groups and hide/show, vertex paint, lit spheres, project files and Send to ZBrush (GoZ-compatible exchange) exchange with ZBrush work
- too, with a ZBrush-style keymap for ZBrush users. Subdivision levels, dynamic
- topology, Quad Remesh retopology with guides, UVs and vector displacement brushes are in
- too. It can't read ZBrush's .ZTL files directly: use Send to ZBrush, or convert your ZTools once with the free
- SculptForge ZTL Export plug-in for ZBrush. It's an independent
- project, not affiliated with or endorsed by Maxon.</p></details>
- <details><summary>Mudbox is being retired. Can SculptForge replace it?</summary>
- <p>For sculpting, largely yes. Autodesk ends new Mudbox subscription sales on 7 November 2026 and says it has had no
- significant feature enhancements since Mudbox 2019 (<a href="https://www.autodesk.com/products/mudbox/overview">Autodesk's notice</a>). SculptForge is free, open source, actively developed
- and runs natively on Windows, macOS and Linux (including RHEL and Rocky). It opens OBJ, FBX, glTF and
- USD exported from Mudbox, and has layers, masking, vertex paint and Send to Unreal. It also has what
- Mudbox users rely on: subdivision levels, sculpt layers, texture painting with paint layers and blend
- modes, normal and displacement baking, and quad retopology. It doesn't have UDIMs, Ptex or separate
- texture channels yet. <a href="mudbox-alternative.html">SculptForge for Mudbox users</a>. It's an independent project, not affiliated
- with Autodesk.</p></details>
+ <details><summary>I already sculpt in another app. Will my habits carry over?</summary>
+ <p>Mostly, yes. Blocking out, sculpting forms and detail, blend shapes, LODs and getting assets into Unreal,
+ glTF or USD all work today, with familiar brushes and controls. Masking, face groups and hide/show, vertex
+ paint, lit spheres, project files, subdivision levels, dynamic topology, Quad Remesh retopology with guides,
+ UVs and vector displacement brushes are in too. Pick <strong>Classic sculpting keys</strong> at the first
+ start, and bring models over as OBJ, FBX, glTF or USD, or through the Bridge.</p></details>
<details><summary>Does it fit a VFX studio pipeline?</summary>
<p>Yes. Every release includes VFX Reference Platform CY2026 and CY2027 builds (Rocky Linux 8 and 9, GCC
14.2, Python 3.13), there's a Rez package, and everything the app does can be scripted from Python or the
@@ -452,9 +421,6 @@ rez-env sculptforge -- sculptforge troll.usda \
</div>
<div class="links">
<a href="guide/index.html">User guide</a>
- <a href="zbrush-alternative.html">For ZBrush users</a>
- <a href="mudbox-alternative.html">For Mudbox users</a>
- <a href="zbrush-linux.html">Sculpting on Linux</a>
<a href="benchmarks/">Benchmarks: 15M and 33M</a>
<a href="https://github.com/islandmed/SculptForge">Source code</a>
<a href="https://discord.gg/gWrYkEmQhH">Community Discord</a>
@@ -465,10 +431,8 @@ rez-env sculptforge -- sculptforge troll.usda \
<a href="https://github.com/islandmed/SculptForge/blob/main/SECURITY.md">Security</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/CODE_OF_CONDUCT.md">Code of conduct</a>
</div>
- <p class="fine trademarks">SculptForge is an independent project, not affiliated with or endorsed by Maxon,
- Epic Games, Autodesk, Pixar, the Khronos Group, Hugging Face, Tencent, Microsoft, Stability AI,
- Anthropic, fal or Meshy. ZBrush, GoZ, MatCap, FiberMesh, LightCap and other ZBrush feature names are trademarks of Maxon Computer GmbH. Unreal and Unreal Engine are trademarks of Epic
- Games, Inc. FBX is a trademark of Autodesk, Inc. glTF is a trademark of the Khronos Group Inc. All other
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners. Unreal and Unreal Engine are trademarks of Epic
+ Games, Inc. glTF is a trademark of the Khronos Group Inc. All other
trademarks belong to their owners. The site uses the Inter typeface (SIL Open Font License), self-hosted,
and no cookies. Visits and download clicks are counted anonymously with
<a href="https://www.goatcounter.com/">GoatCounter</a> (no cookies, no personal data).</p>
diff --git a/website/link/ar.html b/website/link/ar.html
index 24059547..facfdc9a 100644
--- a/website/link/ar.html
+++ b/website/link/ar.html
@@ -82,7 +82,7 @@ footer { text-align:center; color:#6f6f78; font-size:12px; padding:20px 18px 30p
</section>
<a class="secondary hidden" id="back" href="#">Back to capture</a>
</main>
-<footer>AR view: &lt;model-viewer&gt; (Apache-2.0) with WebXR, on this phone. The model comes straight from your computer over your Wi-Fi.<br>ZBrush, GoZ, MatCap, FiberMesh, LightCap and other ZBrush feature names are trademarks of Maxon Computer GmbH. SculptForge is not affiliated with or endorsed by Maxon.</footer>
+<footer>AR view: &lt;model-viewer&gt; (Apache-2.0) with WebXR, on this phone. The model comes straight from your computer over your Wi-Fi.<br>Product names are trademarks of their respective owners.</footer>
<script type="module">
"use strict";
@@ -96,7 +96,7 @@ const fullUrl = location.href;
const frag = new URLSearchParams(location.hash.slice(1));
const token = frag.get("k"), desktop = frag.get("d");
const desktopName = frag.get("n") || "your computer";
-const scope = frag.get("s") === "scene" ? "scene" : "subtool";
+const scope = frag.get("s") === "scene" ? "scene" : "part";
const sizeCm = Number(frag.get("z")) || 20;
const blobUrl = frag.get("b"); // the model through our relay, encrypted (for browsers that can't reach the computer)
history.replaceState(null, "", location.pathname); // keep the secrets out of history
diff --git a/website/link/index.html b/website/link/index.html
index 9fbd6719..18f78430 100644
--- a/website/link/index.html
+++ b/website/link/index.html
@@ -69,7 +69,7 @@ footer { text-align:center; color:#6f6f78; font-size:12px; padding:20px 18px 30p
</section>
<a class="secondary hidden" id="back" href="#">Back to capture</a>
</main>
-<footer>Face tracking: MediaPipe Face Landmarker (Apache-2.0), running on this phone. Only 52 numbers and a rotation per frame are sent, to your computer.<br>ZBrush, GoZ, MatCap, FiberMesh, LightCap and other ZBrush feature names are trademarks of Maxon Computer GmbH. SculptForge is not affiliated with or endorsed by Maxon.</footer>
+<footer>Face tracking: MediaPipe Face Landmarker (Apache-2.0), running on this phone. Only 52 numbers and a rotation per frame are sent, to your computer.<br>Product names are trademarks of their respective owners.</footer>
<script type="module">
"use strict";
diff --git a/website/mudbox-alternative.html b/website/mudbox-alternative.html
deleted file mode 100644
index 75c8b919..00000000
--- a/website/mudbox-alternative.html
+++ /dev/null
@@ -1,237 +0,0 @@
-<!doctype html>
-<html lang="en">
-<head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width, initial-scale=1">
- <title>A free Mudbox alternative, still in development - SculptForge</title>
- <meta name="description" content="Autodesk ends Mudbox sales on 7 November 2026. SculptForge is a free, open-source replacement with subdivision levels, sculpt layers, texture painting with paint layers, normal and displacement baking and Maya-friendly FBX and USD, on Windows, macOS and Linux.">
- <meta name="theme-color" content="#111114">
- <meta name="color-scheme" content="dark">
- <link rel="icon" type="image/svg+xml" href="img/favicon.svg?v=2">
- <link rel="icon" type="image/png" href="img/favicon-64.png?v=2">
- <link rel="apple-touch-icon" href="img/icon-256.png?v=2">
- <meta property="og:type" content="article">
- <meta property="og:title" content="A free Mudbox alternative: SculptForge">
- <meta property="og:description" content="Mudbox sales end on 7 November 2026. SculptForge keeps the Mudbox way of working: subdivision levels, sculpt layers, paint layers, baking, FBX and USD. Free and open source.">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
- <meta property="og:url" content="https://sculptforge.app/mudbox-alternative.html">
- <link rel="canonical" href="https://sculptforge.app/mudbox-alternative.html">
- <meta name="twitter:card" content="summary_large_image">
- <link rel="stylesheet" href="style.css?v=19">
- <script src="motion.js?v=11" defer></script>
- <script data-goatcounter="https://sculptforge.goatcounter.com/count" async src="https://gc.zgo.at/count.js"></script>
- <script type="application/ld+json">
- {"@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [
- {"@type": "Question", "name": "Is Mudbox being discontinued?",
- "acceptedAnswer": {"@type": "Answer", "text": "Autodesk ends new Mudbox subscription sales on 7 November 2026 and says Mudbox has had no significant feature enhancements since Mudbox 2019 (autodesk.com/products/mudbox)."}},
- {"@type": "Question", "name": "Is there a free alternative to Mudbox?",
- "acceptedAnswer": {"@type": "Answer", "text": "SculptForge is free and open source (GPL-3.0) for Windows, macOS and Linux. It has subdivision levels, sculpt layers, texture painting with paint layers and blend modes, normal and displacement baking, quad retopology, and FBX, USD and OBJ with UVs for Maya and game engines."}},
- {"@type": "Question", "name": "Can SculptForge open Mudbox files?",
- "acceptedAnswer": {"@type": "Answer", "text": "Not .mud files. Export from Mudbox as FBX or OBJ (and your textures as PNG or PSD) and open those; Reconstruct Subdiv rebuilds the lower subdivision levels of a dense mesh."}}
- ]}
- </script>
-</head>
-<body>
- <div class="scroll-progress" aria-hidden="true"></div>
- <header class="nav">
- <div class="wrap nav-inner">
- <a class="brand" href="index.html"><img src="img/logo.svg?v=2" alt="" width="34" height="34"><span>SculptForge</span></a>
- <nav aria-label="Main">
- <a href="index.html#features">Features</a>
- <a href="index.html#demos">Demos</a>
- <a href="brushes.html">Brushes</a>
- <a href="guide/index.html">Guide</a>
- <a href="studios.html">Studios</a>
- <a class="nav-support" href="support.html">Support</a>
- <a class="nav-dl" href="index.html#download">Download</a>
- <a class="gh" href="https://discord.gg/gWrYkEmQhH">Discord</a>
- <a class="gh" href="https://github.com/islandmed/SculptForge">GitHub</a>
- </nav>
- </div>
- </header>
-
- <main id="top">
- <section class="hero">
- <div class="wrap">
- <p class="eyebrow">Mudbox alternative</p>
- <h1>Mudbox is ending. <span class="accent">Keep sculpting, for free.</span></h1>
- <p class="lede">Autodesk ends new Mudbox subscription sales on <strong>7 November 2026</strong> and says Mudbox
- hasn't had significant feature enhancements since Mudbox 2019 (<a href="https://www.autodesk.com/products/mudbox/overview">Autodesk's notice</a>). SculptForge is a free, open-source sculpting app that keeps the way
- Mudbox users work: subdivision levels, sculpt layers, painting on textures with layers, and baking maps
- for Maya and game engines. It runs natively on Windows, macOS and Linux, and it's updated every few
- days.</p>
- <div class="ctas">
- <a class="btn primary" href="index.html#download">Download free</a>
- <a class="btn" href="#compare">Compare with Mudbox</a>
- </div>
- </div>
- </section>
-
- <section class="section alt">
- <div class="wrap">
- <h2>What you keep from Mudbox</h2>
- <p class="section-lede">The parts of Mudbox people actually use every day, and where to find them in
- SculptForge.</p>
- <div class="grid">
- <article class="card">
- <h3>Subdivision levels</h3>
- <p>Divide, step up and down between levels, and sculpt big shapes low and pores high; changes carry to
- every level. Reconstruct Subdiv rebuilds the lower levels of a dense mesh you exported.
- <a href="guide/subdivision-levels.html">Subdivision levels</a></p>
- </article>
- <article class="card">
- <h3>Sculpt layers</h3>
- <p>Sculpt into layers with a weight slider, preview them on and off, and keep them on any subdivision
- level. Layers export as blend shapes to FBX and USD. <a href="guide/layers.html">Sculpt layers</a></p>
- </article>
- <article class="card">
- <h3>Paint layers on textures</h3>
- <p>Auto UV in one click, then paint a 1K to 8K texture with layers, blend modes, opacity and locks,
- like Mudbox and Photoshop. Import PNG, JPEG, TGA or PSD. <a href="guide/texture-painting.html">Texture
- painting</a></p>
- </article>
- <article class="card">
- <h3>Normal and displacement maps</h3>
- <p>Bake normal, displacement (PNG and 32-bit EXR), ambient occlusion and cavity maps from the high-res
- sculpt onto a low-poly mesh. <a href="guide/baking.html">Baking</a></p>
- </article>
- <article class="card">
- <h3>Clean quads</h3>
- <p>Quad Remesh turns any sculpt into clean quads, with guides for where the edge loops go, and Project All
- carries the detail back. <a href="guide/retopology.html">Retopology</a></p>
- </article>
- <article class="card">
- <h3>Maya-friendly files</h3>
- <p>OBJ, FBX and USD in and out, with quads, UVs and blend shapes kept. Choose Turntable rotation in
- Preferences to orbit the way Maya does. <a href="guide/exporting.html">Exporting</a></p>
- </article>
- <article class="card">
- <h3>Linux, including Rocky and RHEL</h3>
- <p>Native builds for Windows, macOS and every major Linux, plus VFX Reference Platform CY2026 and CY2027
- builds for studio pipelines. <a href="guide/studios.html">For studios</a></p>
- </article>
- <article class="card">
- <h3>Free, for good</h3>
- <p>No subscription and no account. SculptForge is GPL open source: nobody can take it away, and you own
- everything you make, commercial work included.</p>
- </article>
- </div>
- </div>
- </section>
-
- <section class="section" id="compare">
- <div class="wrap">
- <h2>SculptForge and Mudbox side by side</h2>
- <div class="table-wrap">
- <table class="compare">
- <thead><tr><th></th><th>SculptForge</th><th>Mudbox</th></tr></thead>
- <tbody>
- <tr><td>Price</td><td class="yes">Free</td><td>Subscription, sales end 7 Nov 2026</td></tr>
- <tr><td>Still being developed</td><td class="yes">Yes, weekly releases</td><td>No significant new features since 2019 (<a href="https://www.autodesk.com/products/mudbox/overview">Autodesk</a>)</td></tr>
- <tr><td>Windows / macOS / Linux</td><td class="yes">All three</td><td>Windows, macOS, RHEL / Rocky</td></tr>
- <tr><td>Subdivision levels</td><td class="yes">Yes</td><td>Yes</td></tr>
- <tr><td>Sculpt layers</td><td class="yes">Yes</td><td>Yes</td></tr>
- <tr><td>Paint layers with blend modes</td><td class="yes">Yes</td><td>Yes</td></tr>
- <tr><td>Texture channels</td><td>One colour texture per object</td><td>Many (diffuse, specular, gloss...)</td></tr>
- <tr><td>UDIMs / Ptex</td><td>Not yet</td><td>Yes</td></tr>
- <tr><td>Quad retopology</td><td class="yes">Quad Remesh with guides</td><td>Retopology tools</td></tr>
- <tr><td>Normal / displacement baking</td><td class="yes">Yes (EXR)</td><td>Yes</td></tr>
- <tr><td>Send to Unreal</td><td class="yes">Built in</td><td>FBX export</td></tr>
- <tr><td>Image or text to 3D, phone scanning</td><td class="yes">Built in, free</td><td>No</td></tr>
- <tr><td>Open source</td><td class="yes">GPL-3.0</td><td>No</td></tr>
- </tbody>
- </table>
- </div>
- <p class="fine">Other products' columns: as of November 2026, from each product's public pages; <a href="https://github.com/islandmed/SculptForge/issues">tell us</a> if something changed.</p>
- </div>
- </section>
-
- <section class="section alt">
- <div class="wrap">
- <h2>Bring your Mudbox work over</h2>
- <div class="grid">
- <article class="card">
- <h3>1. Export from Mudbox</h3>
- <p>Export the mesh as FBX or OBJ. For a model with levels, export the highest level, or every level as
- its own OBJ.</p>
- </article>
- <article class="card">
- <h3>2. Open in SculptForge</h3>
- <p>File &gt; Open, or drop the file on the window. Quads and UVs come through. Tool &gt; Geometry &gt;
- Reconstruct Subdiv rebuilds the lower levels.</p>
- </article>
- <article class="card">
- <h3>3. Bring the textures</h3>
- <p>Export your paint layers from Mudbox as PNG or PSD and load them with Tool &gt; Texture Map &gt;
- Import Texture, then keep painting in layers.</p>
- </article>
- <article class="card">
- <h3>4. Feel at home</h3>
- <p>Set Preferences &gt; Interface &gt; Rotation to Turntable for Maya-style orbiting. The
- <a href="guide/index.html">User Guide</a> is in the app under Help.</p>
- </article>
- </div>
- </div>
- </section>
-
- <section class="section">
- <div class="wrap faq">
- <h2>Honest answers</h2>
- <details open><summary>What can't SculptForge do yet that Mudbox can?</summary>
- <p>It can't open .mud files (export FBX or OBJ instead). Each object has one colour texture rather than
- separate specular, gloss or other channels. UVs outside the 0 to 1 square (UDIMs) aren't painted, and
- there's no Ptex or painting through image stencils yet. If one of these stops you, tell us at
- <a href="mailto:[email protected]">[email protected]</a>: it helps us decide what comes
- next.</p></details>
- <details><summary>Is it really free for commercial work?</summary>
- <p>Yes. SculptForge is free under the GPL-3.0 and you own everything you make with it. The licence covers
- the program, not your models.</p></details>
- <details><summary>Will my Mudbox keep working?</summary>
- <p>Autodesk stops selling new Mudbox subscriptions on 7 November 2026 (<a href="https://www.autodesk.com/products/mudbox/overview">Autodesk's notice</a>). What happens to a subscription you
- already have is Autodesk's decision, so check your Autodesk account. SculptForge doesn't depend on
- Mudbox, so you can try it alongside.</p></details>
- <details><summary>What about ZBrush users?</summary>
- <p>SculptForge offers a ZBrush-style keymap for ZBrush users, plus Blender and Maya styles. Mudbox users
- mostly need the Maya-style orbit (above), the brush picker (B) and the Layers sub-palette. The
- <a href="guide/navigation.html">navigation guide</a> covers the rest.</p></details>
- </div>
- </section>
-
- <section class="section alt">
- <div class="wrap">
- <h2>Try it before your Mudbox runs out</h2>
- <p class="section-lede">Free for Windows 10 and 11, macOS 11 and later, and Linux.</p>
- <div class="ctas">
- <a class="btn primary" href="index.html#download">Download SculptForge</a>
- <a class="btn" href="guide/index.html">Read the guide</a>
- </div>
- </div>
- </section>
- </main>
-
- <footer class="footer">
- <div class="wrap footer-grid">
- <div>
- <a class="brand" href="index.html"><img src="img/logo.svg?v=2" alt="" width="28" height="28"><span>SculptForge</span></a>
- <p class="fine">Copyright © 2026 The SculptForge contributors. SculptForge is licensed under the
- <a href="https://github.com/islandmed/SculptForge/blob/main/LICENSE">GNU GPL v3.0 or later</a>.</p>
- </div>
- <div class="links">
- <a href="guide/index.html">User Guide</a>
- <a href="brushes.html">Community brushes</a>
- <a href="zbrush-alternative.html">For ZBrush users</a>
- <a href="mudbox-alternative.html">For Mudbox users</a>
- <a href="zbrush-linux.html">Sculpting on Linux</a>
- <a href="benchmarks/">Benchmarks: 15M and 33M</a>
- <a href="https://github.com/islandmed/SculptForge">Source code</a>
- <a href="https://discord.gg/gWrYkEmQhH">Community Discord</a>
- <a href="support.html">Membership</a>
- <a href="supporters.html">Supporters</a>
- </div>
- <p class="fine trademarks">SculptForge is an independent project, not affiliated with or endorsed by Autodesk or
- Maxon. Mudbox and Maya are trademarks of Autodesk; ZBrush, GoZ, MatCap, FiberMesh, LightCap and other ZBrush feature names are trademarks of Maxon Computer GmbH. The site uses no cookies.
- Visits are counted anonymously with <a href="https://www.goatcounter.com/">GoatCounter</a>.</p>
- </div>
- </footer>
-</body>
-</html>
diff --git a/website/press.html b/website/press.html
index 8344bc9a..4eedf248 100644
--- a/website/press.html
+++ b/website/press.html
@@ -13,7 +13,7 @@
<meta property="og:type" content="website">
<meta property="og:title" content="SculptForge press kit">
<meta property="og:description" content="Facts, descriptions, screenshots and logos for SculptForge, the free, open-source digital sculpting app.">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/press.html">
<link rel="canonical" href="https://sculptforge.app/press.html">
<meta name="twitter:card" content="summary_large_image">
@@ -54,7 +54,7 @@
<div class="wrap">
<h2>Facts</h2>
<ul>
- <li><strong>What:</strong> a free, open-source digital sculpting application, an alternative to ZBrush and Mudbox</li>
+ <li><strong>What:</strong> a free, open-source digital sculpting application, a free, open-source sculpting app</li>
<li><strong>Platforms:</strong> Windows 10 and 11, macOS 11 or later (Apple silicon and Intel), Linux (x86_64 and ARM64; AppImage, .deb, .rpm, AUR)</li>
<li><strong>Install:</strong> <a href="https://github.com/islandmed/SculptForge/releases/latest">GitHub releases</a>,
<code>brew install --cask islandmed/tap/sculptforge</code> on macOS</li>
@@ -73,12 +73,12 @@
<div class="wrap">
<h2>Short description</h2>
<p>SculptForge is a free, open-source digital sculpting app for Windows, macOS and Linux, with keymaps for
- artists coming from ZBrush, Blender or Maya.</p>
+ artists coming from the other app, Blender or Maya.</p>
<h2>Long description</h2>
<p>SculptForge is a free, open-source (GPL) digital sculpting application for artists, students and studios.
- It offers a ZBrush-style keymap (and Blender and Maya styles), and covers the whole sculpting workflow: Parts, subdivision levels
+ It offers a the Classic sculpting keys (and Blender and Maya styles), and covers the whole sculpting workflow: Parts, subdivision levels
and sculpt layers, dynamic topology, voxel remeshing and Quad Remesh retopology, vertex paint with
- layers, normal and displacement map baking, and facial blend shapes. It exchanges models with ZBrush (GoZ-compatible),
+ layers, normal and displacement map baking, and facial blend shapes. It exchanges models with the other app (Bridge),
Blender (a two-way bridge), Unreal Engine and OpenUSD, exports STL for 3D printing, and can turn a phone
scan or a single image into a sculptable model. It runs natively on Linux as well as Windows and macOS,
with builds for the VFX Reference Platform.</p>
@@ -117,9 +117,6 @@
<div class="links">
<a href="guide/index.html">User Guide</a>
<a href="brushes.html">Community brushes</a>
- <a href="zbrush-alternative.html">For ZBrush users</a>
- <a href="mudbox-alternative.html">For Mudbox users</a>
- <a href="zbrush-linux.html">Sculpting on Linux</a>
<a href="benchmarks/">Benchmarks: 15M and 33M</a>
<a href="press.html">Press kit</a>
<a href="support.html">Membership</a>
@@ -127,9 +124,7 @@
<a href="https://github.com/islandmed/SculptForge">Source code</a>
<a href="https://discord.gg/gWrYkEmQhH">Community Discord</a>
</div>
- <p class="fine trademarks">SculptForge is an independent project, not affiliated with or endorsed by Autodesk or
- Maxon. Mudbox and Maya are trademarks of Autodesk; ZBrush, GoZ, MatCap, FiberMesh, LightCap and other ZBrush feature names are trademarks of Maxon Computer GmbH. The site uses no cookies.
- Visits are counted anonymously with <a href="https://www.goatcounter.com/">GoatCounter</a>.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners. The site uses no cookies. Visits are counted anonymously with <a href="https://www.goatcounter.com/">GoatCounter</a>.</p>
</div>
</footer>
</body>
diff --git a/website/sitemap.xml b/website/sitemap.xml
index 59fc0029..1f6ef315 100644
--- a/website/sitemap.xml
+++ b/website/sitemap.xml
@@ -2,9 +2,6 @@
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url><loc>https://sculptforge.app/</loc></url>
<url><loc>https://sculptforge.app/brushes.html</loc></url>
- <url><loc>https://sculptforge.app/mudbox-alternative.html</loc></url>
- <url><loc>https://sculptforge.app/zbrush-alternative.html</loc></url>
- <url><loc>https://sculptforge.app/zbrush-linux.html</loc></url>
<url><loc>https://sculptforge.app/press.html</loc></url>
<url><loc>https://sculptforge.app/studios.html</loc></url>
<url><loc>https://sculptforge.app/support.html</loc></url>
@@ -13,7 +10,7 @@
<url><loc>https://sculptforge.app/guide/welcome.html</loc></url>
<url><loc>https://sculptforge.app/guide/first-sculpt.html</loc></url>
<url><loc>https://sculptforge.app/guide/whats-new.html</loc></url>
- <url><loc>https://sculptforge.app/guide/coming-from-zbrush.html</loc></url>
+ <url><loc>https://sculptforge.app/guide/quick-tour.html</loc></url>
<url><loc>https://sculptforge.app/guide/installing.html</loc></url>
<url><loc>https://sculptforge.app/guide/interface.html</loc></url>
<url><loc>https://sculptforge.app/guide/navigation.html</loc></url>
diff --git a/website/stats/index.html b/website/stats/index.html
index f4133237..938b7ca8 100644
--- a/website/stats/index.html
+++ b/website/stats/index.html
@@ -87,7 +87,7 @@
<p class="muted small">Counts are GitHub release downloads (checksum files left out), refreshed every hour; "today"
is Pacific time. A download is not an install: someone who grabs two formats counts twice. Days are known from
<span id="since"></span>; earlier downloads are in "All time" only.</p>
- <p class="muted small">ZBrush, GoZ, MatCap, FiberMesh, LightCap and other ZBrush feature names are trademarks of Maxon Computer GmbH. SculptForge is not affiliated with or endorsed by Maxon.</p>
+ <p class="muted small">Product names are trademarks of their respective owners.</p>
</main>
<script>
const DATA = "https://raw.githubusercontent.com/islandmed/SculptForge/download-stats/history.json";
@@ -99,7 +99,7 @@ const fmt = (n) => n.toLocaleString("en-US");
function platform(file) {
if (/bridge/i.test(file)) return "Blender add-on";
- if (/ZToolExport/i.test(file)) return "ZBrush plug-in";
+ if (/Export\.txt$/i.test(file)) return "Bridge plug-in";
if (/windows|\.exe$/i.test(file)) return "Windows";
if (/darwin|macos|\.dmg$/i.test(file)) return "macOS";
return "Linux";
diff --git a/website/studios.html b/website/studios.html
index b7ca0c90..a3dda749 100644
--- a/website/studios.html
+++ b/website/studios.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>SculptForge for Studios</title>
- <meta name="description" content="SculptForge is free for any number of artists: no seats, no licence server, no accounts. It fits studio pipelines with Blender, Maya and Unreal bridges, GoZ-compatible ZBrush exchange, USD/FBX/glTF and VFX Reference Platform builds.">
+ <meta name="description" content="SculptForge is free for any number of artists: no seats, no licence server, no accounts. It fits studio pipelines with Blender, Maya and Unreal bridges, the Bridge exchange, USD/FBX/glTF and VFX Reference Platform builds.">
<meta name="theme-color" content="#111114" media="(prefers-color-scheme: dark)">
<meta name="theme-color" content="#f6f5f3" media="(prefers-color-scheme: light)">
<meta name="color-scheme" content="dark light">
@@ -14,7 +14,7 @@
<meta property="og:type" content="website">
<meta property="og:title" content="SculptForge for Studios: 20 artists, $0 in licenses">
<meta property="og:description" content="A free, open-source sculpting app for any number of artists, built to fit studio pipelines.">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/studios.html">
<link rel="canonical" href="https://sculptforge.app/studios.html">
<meta name="twitter:card" content="summary_large_image">
@@ -231,7 +231,7 @@
<h1 id="studio-title">20 artists. <span class="accent">$0 in licenses.</span></h1>
<p class="lede">SculptForge is free and open source for any number of artists: no seats, no licence server,
no accounts and no telemetry. It runs on Linux, Windows and macOS, works offline, and talks to Blender,
- Maya, Unreal and ZBrush.</p>
+ Maya, Unreal and other sculpting apps.</p>
<div class="stage-ctas">
<a class="btn btn-hot" href="#membership">Studio membership</a>
<a class="btn btn-ghost" href="#pipeline">Pipeline details</a>
@@ -240,100 +240,6 @@
</div>
</section>
- <section class="costs-wrap" aria-labelledby="costs-title">
- <div class="wrap">
- <h2 id="costs-title" class="visually-hidden">Yearly software cost by team size</h2>
- <ul class="costs">
- <li class="cost" style="--i: 0">
- <h2>5 artists <span>· per year</span></h2>
- <p class="zero">$0<small>for SculptForge itself</small></p>
- <div class="bars">
- <div class="bar-row">
- <div class="bar-label"><span>ZBrush, Teams seats*</span><b>$2,475–$4,195</b></div>
- <div class="track" aria-hidden="true"><span class="fill them-hi" style="width: 24.7%"></span><span class="fill them" style="width: 14.6%"></span></div>
- </div>
- <div class="bar-row">
- <div class="bar-label"><span>SculptForge + Studio membership</span><b>$1,800</b></div>
- <div class="track" aria-hidden="true"><span class="fill us" style="width: 10.6%"></span></div>
- </div>
- </div>
- <p class="cost-note">One membership covers the whole company.</p>
- </li>
- <li class="cost" style="--i: 1">
- <h2>10 artists <span>· per year</span></h2>
- <p class="zero">$0<small>for SculptForge itself</small></p>
- <div class="bars">
- <div class="bar-row">
- <div class="bar-label"><span>ZBrush, Teams seats*</span><b>$4,950–$8,390</b></div>
- <div class="track" aria-hidden="true"><span class="fill them-hi" style="width: 49.4%"></span><span class="fill them" style="width: 29.1%"></span></div>
- </div>
- <div class="bar-row">
- <div class="bar-label"><span>SculptForge + Studio membership</span><b>$1,800</b></div>
- <div class="track" aria-hidden="true"><span class="fill us" style="width: 10.6%"></span></div>
- </div>
- </div>
- <p class="cost-note">One membership covers the whole company.</p>
- </li>
- <li class="cost featured" style="--i: 2">
- <h2>20 artists <span>· per year</span></h2>
- <p class="zero">$0<small>for SculptForge itself</small></p>
- <div class="bars">
- <div class="bar-row">
- <div class="bar-label"><span>ZBrush, Teams seats*</span><b>$9,900–$16,780</b></div>
- <div class="track" aria-hidden="true"><span class="fill them-hi" style="width: 98.7%"></span><span class="fill them" style="width: 58.2%"></span></div>
- </div>
- <div class="bar-row">
- <div class="bar-label"><span>SculptForge + Studio membership</span><b>$1,800</b></div>
- <div class="track" aria-hidden="true"><span class="fill us" style="width: 10.6%"></span></div>
- </div>
- </div>
- <p class="cost-note">Still one membership: no seat count.</p>
- </li>
- </ul>
- <p class="legend" aria-hidden="true">
- <span><i class="k-them"></i>ZBrush, low end of the range*</span>
- <span><i class="k-them-hi"></i>up to the high end*</span>
- <span><i class="k-us"></i>SculptForge with the optional Studio membership</span>
- </p>
- </div>
- </section>
-
- <section class="section" aria-labelledby="table-title">
- <div class="wrap">
- <h2 id="table-title">What the software costs a year</h2>
- <p>The software is free for every artist, whether you have 5 or 500. A Studio membership is optional: it
- covers the whole company, funds development and gets your team preview builds, a custom studio build and
- priority on pipeline bugs.</p>
- <div class="table-scroll" tabindex="0" role="region" aria-labelledby="table-title">
- <table class="costs-table" role="table">
- <caption>US dollars per year. ZBrush figures are approximate*.</caption>
- <thead>
- <tr>
- <th scope="col">Team</th>
- <th scope="col">ZBrush, Teams named seats*<br>($495–$839 per seat)</th>
- <th scope="col">SculptForge software</th>
- <th scope="col">SculptForge with Studio membership</th>
- </tr>
- </thead>
- <tbody role="rowgroup">
- <tr role="row"><th scope="row" role="rowheader">5 artists</th><td role="cell" data-label="ZBrush, Teams seats*">$2,475–$4,195</td><td role="cell" data-label="SculptForge software" class="us">$0</td><td role="cell" data-label="With Studio membership">$1,800</td></tr>
- <tr role="row"><th scope="row" role="rowheader">10 artists</th><td role="cell" data-label="ZBrush, Teams seats*">$4,950–$8,390</td><td role="cell" data-label="SculptForge software" class="us">$0</td><td role="cell" data-label="With Studio membership">$1,800</td></tr>
- <tr role="row"><th scope="row" role="rowheader">20 artists</th><td role="cell" data-label="ZBrush, Teams seats*">$9,900–$16,780</td><td role="cell" data-label="SculptForge software" class="us">$0</td><td role="cell" data-label="With Studio membership">$1,800</td></tr>
- </tbody>
- </table>
- </div>
- <div class="footnotes fine">
- <p>* Approximate, from reseller listings in November 2026 (for example ZBrush Teams annual renewals listed at
- $495 to $839 per seat); <a href="https://www.maxon.net/en/buy">Maxon's buy page</a> has current prices and
- quotes. An individual ZBrush subscription is about $480 a year, and floating seats cost extra. Prices vary by region, term and
- reseller.</p>
- <p>A Studio membership is $300 a month for the whole company, with no seat count. Founding Studio: the first
- 10 studios lock in $150 a month ($1,800 a year, the figure above) for as long as they stay subscribed.
- SculptForge itself costs $0 with or without one.</p>
- </div>
- </div>
- </section>
-
<section class="section alt" id="pipeline" aria-labelledby="pipeline-title">
<div class="wrap">
<p class="eyebrow">Pipeline</p>
@@ -350,9 +256,9 @@
transform, parent and shading groups, in one undo step. Early: reports from Maya users are welcome.</p>
</article>
<article class="card">
- <h3>Send to ZBrush (GoZ-compatible exchange)</h3>
- <p>Reads and writes .GoZ and sends to and receives from a running ZBrush. A small ZBrush plug-in turns
- .ZTL files into Parts SculptForge opens directly.</p>
+ <h3>Bridge</h3>
+ <p>Exchanges Parts with another sculpting app through a shared bridge folder, with face groups, mask, vertex
+ paint and UVs. A small export plug-in converts a whole library once.</p>
</article>
<article class="card">
<h3>Unreal Engine</h3>
@@ -362,7 +268,7 @@
<article class="card">
<h3>File formats</h3>
<p>OpenUSD (.usda, .usdz), FBX (reads any version, writes 7.4 binary), glTF / GLB, OBJ, PLY, STL and
- .GoZ. Exports are checked with OpenUSD's usdchecker and the Khronos glTF validator.</p>
+ .Bridge files. Exports are checked with OpenUSD's usdchecker and the Khronos glTF validator.</p>
</article>
<article class="card">
<h3>Linux, Windows, macOS</h3>
@@ -446,8 +352,6 @@
<a href="guide/index.html">User Guide</a>
<a href="guide/studios.html">Studio guide</a>
<a href="brushes.html">Community brushes</a>
- <a href="zbrush-alternative.html">For ZBrush users</a>
- <a href="zbrush-linux.html">Sculpting on Linux</a>
<a href="benchmarks/">Benchmarks: 15M and 33M</a>
<a href="press.html">Press kit</a>
<a href="support.html">Membership</a>
@@ -455,9 +359,7 @@
<a href="https://github.com/islandmed/SculptForge">Source code</a>
<a href="https://discord.gg/gWrYkEmQhH">Community Discord</a>
</div>
- <p class="fine trademarks">SculptForge is an independent project, not affiliated with or endorsed by Maxon,
- Autodesk, Epic Games or the Blender Foundation. ZBrush, GoZ, MatCap, FiberMesh, LightCap and other ZBrush feature names are trademarks of Maxon Computer GmbH; Maya is a trademark of
- Autodesk; Unreal Engine is a trademark of Epic Games; Blender is a trademark of the Blender Foundation. Names
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners. Names
are used only to describe compatibility and for price comparison. The site uses no cookies. Visits are
counted anonymously with <a href="https://www.goatcounter.com/">GoatCounter</a>.</p>
</div>
diff --git a/website/style.css b/website/style.css
index 61c39219..fe76918c 100644
--- a/website/style.css
+++ b/website/style.css
@@ -483,8 +483,8 @@ kbd { display: inline-block; min-width: 1.5em; padding: 0.05em 0.45em; border: 1
.callout p { margin: 0; }
.callout-tip { border-left-color: #62c07e; } .callout-tip strong:first-child { color: #7fd497; }
.callout-note { border-left-color: #6fa8e6; } .callout-note strong:first-child { color: #8dbcf0; }
-.callout-zbrush { border-left-color: var(--accent); background: linear-gradient(90deg, rgba(242, 140, 60, 0.07), #1b1b21 40%); }
-.callout-zbrush strong:first-child { color: var(--accent-2); }
+.callout-experienced { border-left-color: var(--accent); background: linear-gradient(90deg, rgba(242, 140, 60, 0.07), #1b1b21 40%); }
+.callout-experienced strong:first-child { color: var(--accent-2); }
.callout-not-yet { border-left-color: #a990dc; } .callout-not-yet strong:first-child { color: #c1aef0; }
.callout-warning, .callout-important { border-left-color: #e5604a; } .callout-warning strong:first-child { color: #f08a78; }
.code-block { position: relative; margin: 0 0 1.3em; }
diff --git a/website/support.html b/website/support.html
index 59aa431d..baf45353 100644
--- a/website/support.html
+++ b/website/support.html
@@ -14,7 +14,7 @@
<meta property="og:type" content="website">
<meta property="og:title" content="SculptForge Membership">
<meta property="og:description" content="Memberships from $5 a month: credits, a monthly pack, a vote on what we build next, Insider daily drops and preview builds, and Studio custom builds.">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
+ <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=4">
<meta property="og:url" content="https://sculptforge.app/support.html">
<link rel="canonical" href="https://sculptforge.app/support.html">
<meta name="twitter:card" content="summary_large_image">
@@ -327,9 +327,6 @@
<div class="links">
<a href="guide/index.html">User Guide</a>
<a href="brushes.html">Community brushes</a>
- <a href="zbrush-alternative.html">For ZBrush users</a>
- <a href="mudbox-alternative.html">For Mudbox users</a>
- <a href="zbrush-linux.html">Sculpting on Linux</a>
<a href="benchmarks/">Benchmarks: 15M and 33M</a>
<a href="press.html">Press kit</a>
<a href="support.html">Membership</a>
@@ -337,9 +334,7 @@
<a href="https://github.com/islandmed/SculptForge">Source code</a>
<a href="https://discord.gg/gWrYkEmQhH">Community Discord</a>
</div>
- <p class="fine trademarks">SculptForge is an independent project, not affiliated with or endorsed by Autodesk or
- Maxon. Mudbox and Maya are trademarks of Autodesk; ZBrush, GoZ, MatCap, FiberMesh, LightCap and other ZBrush feature names are trademarks of Maxon Computer GmbH. The site uses no cookies.
- Visits are counted anonymously with <a href="https://www.goatcounter.com/">GoatCounter</a>.</p>
+ <p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners. The site uses no cookies. Visits are counted anonymously with <a href="https://www.goatcounter.com/">GoatCounter</a>.</p>
</div>
</footer>
<script>
diff --git a/website/zbrush-alternative.html b/website/zbrush-alternative.html
deleted file mode 100644
index 1e2bd3f0..00000000
--- a/website/zbrush-alternative.html
+++ /dev/null
@@ -1,222 +0,0 @@
-<!doctype html>
-<html lang="en">
-<head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width, initial-scale=1">
- <title>A free ZBrush alternative with a ZBrush-style keymap - SculptForge</title>
- <meta name="description" content="SculptForge is a free, open-source ZBrush alternative for Windows, macOS and Linux. A ZBrush-style keymap option, Parts, subdivision levels, layers, dynamic topology, Quad Remesh retopology, VDM brushes, GoZ-compatible exchange with ZBrush and a plug-in that brings your ZTools over.">
- <meta name="theme-color" content="#111114">
- <meta name="color-scheme" content="dark">
- <link rel="icon" type="image/svg+xml" href="img/favicon.svg?v=2">
- <link rel="icon" type="image/png" href="img/favicon-64.png?v=2">
- <link rel="apple-touch-icon" href="img/icon-256.png?v=2">
- <meta property="og:type" content="article">
- <meta property="og:title" content="A free ZBrush alternative: SculptForge">
- <meta property="og:description" content="A ZBrush-style keymap option, Parts, subdivision levels, layers, dynamic topology and GoZ-compatible exchange with ZBrush, free and open source on Windows, macOS and Linux.">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
- <meta property="og:url" content="https://sculptforge.app/zbrush-alternative.html">
- <link rel="canonical" href="https://sculptforge.app/zbrush-alternative.html">
- <meta name="twitter:card" content="summary_large_image">
- <link rel="stylesheet" href="style.css?v=19">
- <script src="motion.js?v=11" defer></script>
- <script data-goatcounter="https://sculptforge.goatcounter.com/count" async src="https://gc.zgo.at/count.js"></script>
- <script type="application/ld+json">
- {"@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [{"@type": "Question", "name": "Is there a free alternative to ZBrush?", "acceptedAnswer": {"@type": "Answer", "text": "SculptForge is free and open source (GPL-3.0) for Windows, macOS and Linux. It offers a ZBrush-style keymap (and Blender and Maya styles) and has Parts, subdivision levels, sculpt layers, dynamic topology, quad remeshing, vertex paint, texture painting, baking and VDM brushes."}}, {"@type": "Question", "name": "Can SculptForge open ZBrush ZTL files?", "acceptedAnswer": {"@type": "Answer", "text": "Yes, through a free plug-in that runs inside ZBrush and converts each ZTool once; SculptForge then opens the .ZTL with its SubTools as Parts, with names, face groups, vertex paint, mask and UVs. Lower subdivision levels, layers and ZBrush materials don't come over, and .ZPR projects can't be converted."}}, {"@type": "Question", "name": "Does SculptForge have ZBrush-style shortcuts?", "acceptedAnswer": {"@type": "Answer", "text": "Yes, as an option: choose ZBrush when SculptForge asks what you are coming from (or switch in Preferences). Then B plus two letters picks a brush, S, U, I and O set size and intensities, Ctrl masks, Ctrl+Shift hides and isolates, D and Shift+D step subdivision levels, and navigation works the ZBrush-style way."}}]}
- </script>
-</head>
-<body>
- <div class="scroll-progress" aria-hidden="true"></div>
- <header class="nav">
- <div class="wrap nav-inner">
- <a class="brand" href="index.html"><img src="img/logo.svg?v=2" alt="" width="34" height="34"><span>SculptForge</span></a>
- <nav aria-label="Main">
- <a href="index.html#features">Features</a>
- <a href="index.html#demos">Demos</a>
- <a href="brushes.html">Brushes</a>
- <a href="guide/index.html">Guide</a>
- <a href="studios.html">Studios</a>
- <a class="nav-support" href="support.html">Support</a>
- <a class="nav-dl" href="index.html#download">Download</a>
- <a class="gh" href="https://discord.gg/gWrYkEmQhH">Discord</a>
- <a class="gh" href="https://github.com/islandmed/SculptForge">GitHub</a>
- </nav>
- </div>
- </header>
-
- <main id="top">
- <section class="hero">
- <div class="wrap">
- <p class="eyebrow">ZBrush alternative</p>
- <h1>For ZBrush users, <span class="accent">a free app.</span></h1>
- <p class="lede">SculptForge is a free, open-source sculpting app with a ZBrush-style keymap and gestures
- you can switch on at first run, so you can start sculpting instead of relearning. It brings your ZTools over, exchanges models
- with ZBrush through GoZ-compatible exchange (Send to ZBrush), and runs natively on Windows, macOS and Linux. No subscription, no account.</p>
- <div class="ctas">
- <a class="btn primary" href="index.html#download">Download free</a>
- <a class="btn" href="guide/coming-from-zbrush.html">Coming from ZBrush</a>
- </div>
- </div>
- </section>
-
- <section class="section alt">
- <div class="wrap">
- <h2>What works the way you expect</h2>
- <p class="section-lede">Choose ZBrush when SculptForge first asks what you're coming from, and these work
- as you'd expect. Blender and Maya styles are there too, and you can switch any time in Preferences.</p>
- <div class="grid">
- <article class="card">
- <h3>Keys and gestures</h3>
- <p>B then two letters for brushes (B S T, B C B, B D S), S U I O sliders under the cursor, Alt for Sub,
- Shift to smooth, free rotation with Shift to snap. <a href="guide/shortcuts.html">Shortcuts</a></p>
- </article>
- <article class="card">
- <h3>Masking and visibility</h3>
- <p>Ctrl to mask, Ctrl+Alt to erase, click to blur or sharpen, Mask Lasso and Mask Rectangle, Ctrl+Shift to
- hide and isolate face groups, Ctrl+W to group. <a href="guide/masking.html">Masking</a></p>
- </article>
- <article class="card">
- <h3>Parts and levels</h3>
- <p>Parts (ZBrush's SubTools) with Alt+click, subdivision levels on Ctrl+D, D and Shift+D, Reconstruct Subdiv, sculpt
- layers on any level, Wireframe and Save Snapshot. <a href="guide/parts.html">Parts</a></p>
- </article>
- <article class="card">
- <h3>Remeshing</h3>
- <p>Voxel Remesh for blocking out (the job of ZBrush's DynaMesh), Quad Remesh with guides for clean quad loops, and Project All
- to carry the detail back. <a href="guide/retopology.html">Retopology</a></p>
- </article>
- <article class="card">
- <h3>Dynamic topology</h3>
- <p>Detail where the brush goes, as with ZBrush's Sculptris Pro: switch on Dynamic in the top shelf and set the
- Detail. <a href="guide/dynamic-topology.html">Dynamic topology</a></p>
- </article>
- <article class="card">
- <h3>VDM brushes and alphas</h3>
- <p>Vector displacement brushes with Drag Stamp and Slide Stamp, your own made from a VDM plane, plus alphas,
- strokes and a community brush gallery. <a href="brushes.html">Brushes</a></p>
- </article>
- <article class="card">
- <h3>Vertex paint, textures and baking</h3>
- <p>Vertex paint with layers and blend modes, texture painting on UVs, and normal, displacement and AO
- bakes. <a href="guide/texture-painting.html">Texture painting</a></p>
- </article>
- <article class="card">
- <h3>Extras built in</h3>
- <p>Native Linux, Send to Unreal built in, phone scanning to a sculptable mesh, and free built-in AI
- that makes a brush from a sentence or a model from a sketch. <a href="index.html#features">Features</a></p>
- </article>
- </div>
- </div>
- </section>
-
- <section class="section">
- <div class="wrap">
- <h2>Bring your ZTools over</h2>
- <p class="section-lede">ZBrush's .ZTL format is closed, so a free plug-in converts each ZTool once, inside
- ZBrush. The plug-in is new: if your ZBrush version trips it up, export OBJ or .GoZ meanwhile and
- <a href="https://github.com/islandmed/SculptForge/issues">tell us</a>.</p>
- <div class="grid">
- <article class="card">
- <h3>1. Install the plug-in</h3>
- <p>Copy <a href="https://github.com/islandmed/SculptForge/blob/main/integrations/zbrush/SculptForgeZToolExport.txt">SculptForgeZToolExport.txt</a>
- into ZBrush's ZStartup/ZPlugs64 folder and restart ZBrush.</p>
- </article>
- <article class="card">
- <h3>2. Convert</h3>
- <p>ZPlugin &gt; SculptForge &gt; Convert ZTL, then pick your .ZTL. Each SubTool is written beside it.</p>
- </article>
- <article class="card">
- <h3>3. Open it</h3>
- <p>Open the .ZTL in SculptForge: SubTools come over as Parts, with names, face groups, vertex paint, mask and UVs.</p>
- </article>
- <article class="card">
- <h3>Or use Send to ZBrush</h3>
- <p>Send single models back and forth with GoZ-compatible exchange (Send to ZBrush), or export OBJ or .GoZ from ZBrush's Tool palette.
- <a href="guide/exporting.html#exchange-models-with-zbrush-send-to-zbrush">Send to ZBrush</a></p>
- </article>
- </div>
- </div>
- </section>
-
- <section class="section alt">
- <div class="wrap">
- <h2>SculptForge and ZBrush side by side</h2>
- <div class="table-wrap">
- <table class="compare">
- <thead><tr><th></th><th>SculptForge</th><th>ZBrush</th></tr></thead>
- <tbody>
- <tr><td>Price</td><td class="yes">Free</td><td>Subscription</td></tr>
- <tr><td>Open source</td><td class="yes">GPL-3.0</td><td>No</td></tr>
- <tr><td>Linux</td><td class="yes">Native</td><td>No</td></tr>
- <tr><td>ZBrush-style keys and gestures</td><td class="yes">Optional keymap</td><td>Yes</td></tr>
- <tr><td>Parts (ZBrush: SubTools), levels, layers</td><td class="yes">Yes</td><td>Yes</td></tr>
- <tr><td>ZBrush's DynaMesh / ZRemesher</td><td>Voxel Remesh / Quad Remesh</td><td>Yes</td></tr>
- <tr><td>ZBrush's Sculptris Pro</td><td>Dynamic Topology</td><td>Yes</td></tr>
- <tr><td>ZBrush's Transpose line</td><td>Gizmo on W E R</td><td>Yes</td></tr>
- <tr><td>Send to Unreal</td><td class="yes">Built in</td><td>Plug-in</td></tr>
- <tr><td>Image or text to 3D</td><td class="yes">Built in, free</td><td>No</td></tr>
- </tbody>
- </table>
- </div>
- <p class="fine">Other products' columns: as of November 2026, from each product's public pages; <a href="https://github.com/islandmed/SculptForge/issues">tell us</a> if something changed.</p>
- </div>
- </section>
-
- <section class="section">
- <div class="wrap faq">
- <h2>Honest answers</h2>
- <details open><summary>What's missing compared with ZBrush?</summary>
- <p>ZBrush has had more than twenty years of features, and SculptForge is young. There's no 2.5D canvas,
- no equivalent of ZBrush's Transpose action line (the Gizmo does that job), no stroke replay and no poly modeling like ZBrush's ZModeler yet. ZTools
- come over at their highest subdivision level, without sculpt layers or ZBrush materials, and .ZPR
- projects can't be converted. The <a href="guide/coming-from-zbrush.html">Coming from ZBrush</a>
- chapter lists every difference.</p></details>
- <details><summary>Is it really free for commercial work?</summary>
- <p>Yes. SculptForge is free under the GPL-3.0 and you own what you make. The licence covers the program,
- not your models.</p></details>
- <details><summary>Can I keep ZBrush and use both?</summary>
- <p>Yes. The Send to ZBrush (GoZ-compatible exchange) and the SculptForge ZTL Export plug-in move models between them, and SculptForge doesn't change anything in
- ZBrush.</p></details>
- <details><summary>Does it run on Linux?</summary>
- <p>Natively, with .deb, .rpm and AppImage builds for x86_64 and ARM64.
- <a href="zbrush-linux.html">Sculpting on Linux</a>
- <a href="benchmarks/">Benchmarks: 15M and 33M</a></p></details>
- </div>
- </section>
-
- <section class="section alt">
- <div class="wrap">
- <h2>Try it with the keys you already know</h2>
- <p class="section-lede">Free for Windows 10 and 11, macOS 11 and later, and Linux.</p>
- <div class="ctas">
- <a class="btn primary" href="index.html#download">Download SculptForge</a>
- <a class="btn" href="guide/coming-from-zbrush.html">Coming from ZBrush</a>
- </div>
- </div>
- </section>
- </main>
-
- <footer class="footer">
- <div class="wrap footer-grid">
- <div>
- <a class="brand" href="index.html"><img src="img/logo.svg?v=2" alt="" width="28" height="28"><span>SculptForge</span></a>
- <p class="fine">Copyright © 2026 The SculptForge contributors. SculptForge is licensed under the
- <a href="https://github.com/islandmed/SculptForge/blob/main/LICENSE">GNU GPL v3.0 or later</a>.</p>
- </div>
- <div class="links">
- <a href="guide/index.html">User Guide</a>
- <a href="brushes.html">Community brushes</a>
- <a href="zbrush-alternative.html">For ZBrush users</a>
- <a href="mudbox-alternative.html">For Mudbox users</a>
- <a href="zbrush-linux.html">Sculpting on Linux</a>
- <a href="https://github.com/islandmed/SculptForge">Source code</a>
- <a href="https://discord.gg/gWrYkEmQhH">Community Discord</a>
- <a href="support.html">Membership</a>
- <a href="supporters.html">Supporters</a>
- </div>
- <p class="fine trademarks">SculptForge is an independent project, not affiliated with or endorsed by Autodesk or
- Maxon. Mudbox and Maya are trademarks of Autodesk; ZBrush, GoZ, MatCap, FiberMesh, LightCap and other ZBrush feature names are trademarks of Maxon Computer GmbH. The site uses no cookies.
- Visits are counted anonymously with <a href="https://www.goatcounter.com/">GoatCounter</a>.</p>
- </div>
- </footer>
-</body>
-</html>
diff --git a/website/zbrush-linux.html b/website/zbrush-linux.html
deleted file mode 100644
index b202c7c7..00000000
--- a/website/zbrush-linux.html
+++ /dev/null
@@ -1,162 +0,0 @@
-<!doctype html>
-<html lang="en">
-<head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width, initial-scale=1">
- <title>ZBrush on Linux? A native sculpting app instead - SculptForge</title>
- <meta name="description" content="ZBrush has no Linux version. SculptForge is a free, open-source sculpting app with a ZBrush-style keymap option that runs natively on Ubuntu, Debian, Fedora, RHEL, Rocky and any Linux, x86_64 and ARM64, X11 and Wayland, with pen pressure.">
- <meta name="theme-color" content="#111114">
- <meta name="color-scheme" content="dark">
- <link rel="icon" type="image/svg+xml" href="img/favicon.svg?v=2">
- <link rel="icon" type="image/png" href="img/favicon-64.png?v=2">
- <link rel="apple-touch-icon" href="img/icon-256.png?v=2">
- <meta property="og:type" content="article">
- <meta property="og:title" content="ZBrush for Linux? Try SculptForge">
- <meta property="og:description" content="A native, free, open-source sculpting app with a ZBrush-style keymap option for Ubuntu, Fedora, Rocky and any Linux.">
- <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=3">
- <meta property="og:url" content="https://sculptforge.app/zbrush-linux.html">
- <link rel="canonical" href="https://sculptforge.app/zbrush-linux.html">
- <meta name="twitter:card" content="summary_large_image">
- <link rel="stylesheet" href="style.css?v=19">
- <script src="motion.js?v=11" defer></script>
- <script data-goatcounter="https://sculptforge.goatcounter.com/count" async src="https://gc.zgo.at/count.js"></script>
- <script type="application/ld+json">
- {"@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [{"@type": "Question", "name": "Is there a Linux version of ZBrush?", "acceptedAnswer": {"@type": "Answer", "text": "No. ZBrush runs on Windows and macOS only, and Maxon doesn't support running it on Linux."}}, {"@type": "Question", "name": "What is the best ZBrush alternative on Linux?", "acceptedAnswer": {"@type": "Answer", "text": "SculptForge is a free, open-source sculpting app that runs natively on Linux and offers a ZBrush-style keymap (and Blender and Maya styles). Blender's Sculpt Mode is the other native option; it is a general 3D suite rather than a dedicated sculpting app."}}, {"@type": "Question", "name": "How do I install SculptForge on Linux?", "acceptedAnswer": {"@type": "Answer", "text": "Download the .deb (Ubuntu, Debian, Mint, Pop!_OS), the .rpm (Fedora, RHEL, Rocky, Alma) or the AppImage (any distribution), for x86_64 or ARM64, from sculptforge.app."}}]}
- </script>
-</head>
-<body>
- <div class="scroll-progress" aria-hidden="true"></div>
- <header class="nav">
- <div class="wrap nav-inner">
- <a class="brand" href="index.html"><img src="img/logo.svg?v=2" alt="" width="34" height="34"><span>SculptForge</span></a>
- <nav aria-label="Main">
- <a href="index.html#features">Features</a>
- <a href="index.html#demos">Demos</a>
- <a href="brushes.html">Brushes</a>
- <a href="guide/index.html">Guide</a>
- <a href="studios.html">Studios</a>
- <a class="nav-support" href="support.html">Support</a>
- <a class="nav-dl" href="index.html#download">Download</a>
- <a class="gh" href="https://discord.gg/gWrYkEmQhH">Discord</a>
- <a class="gh" href="https://github.com/islandmed/SculptForge">GitHub</a>
- </nav>
- </div>
- </header>
-
- <main id="top">
- <section class="hero">
- <div class="wrap">
- <p class="eyebrow">Sculpting on Linux</p>
- <h1>ZBrush doesn't run on Linux. <span class="accent">This does.</span></h1>
- <p class="lede">ZBrush is Windows and macOS only, and Maxon doesn't support running it on Linux.
- SculptForge is a free, open-source sculpting app built for Linux as much as for Windows and macOS. It
- offers a ZBrush-style keymap (and Blender and Maya styles), so you can sculpt natively instead of fighting a compatibility layer.</p>
- <div class="ctas">
- <a class="btn primary" href="#install">Install on Linux</a>
- <a class="btn" href="zbrush-alternative.html">Coming from ZBrush</a>
- </div>
- </div>
- </section>
-
- <section class="section alt" id="install">
- <div class="wrap">
- <h2>Install</h2>
- <p class="section-lede">Every build is x86_64 or ARM64 and works on X11 and Wayland. You need a graphics
- driver with OpenGL 3.3, which any GPU from the last ten years has.</p>
- <div class="downloads">
- <a class="dl" href="https://github.com/islandmed/SculptForge/releases/latest/download/sculptforge_amd64.deb">
- <strong>Ubuntu, Debian, Mint, Pop!_OS</strong><span>.deb · x86_64</span></a>
- <a class="dl" href="https://github.com/islandmed/SculptForge/releases/latest/download/sculptforge.x86_64.rpm">
- <strong>Fedora, RHEL, Rocky, Alma</strong><span>.rpm · x86_64</span></a>
- <a class="dl" href="https://github.com/islandmed/SculptForge/releases/latest/download/SculptForge-linux-x86_64.AppImage">
- <strong>Any Linux</strong><span>AppImage · x86_64</span></a>
- <a class="dl" href="https://github.com/islandmed/SculptForge/releases/latest">
- <strong>ARM64 and VFX builds</strong><span>.deb, .rpm, AppImage for ARM64; CY2026 / CY2027 tarballs</span></a>
- </div>
- <p class="fine">Or in a terminal: <code>curl -fsSL https://raw.githubusercontent.com/islandmed/SculptForge/main/install/install.sh | sh</code>.
- On Arch, build it from <code>packaging/arch/PKGBUILD</code> with <code>makepkg -si</code>.
- <a href="guide/installing.html">Installing</a></p>
- </div>
- </section>
-
- <section class="section">
- <div class="wrap">
- <h2>Made to feel at home on Linux</h2>
- <div class="grid">
- <article class="card">
- <h3>Native, not emulated</h3>
- <p>A C++ app built for Linux every release and tested on it, so there's no Wine, no virtual machine and
- no licence server to work around.</p>
- </article>
- <article class="card">
- <h3>Pen tablets</h3>
- <p>Pressure, the eraser end and pen buttons, with a global pressure curve in Preferences &gt; Tablet.
- <a href="guide/sculpting.html">Sculpting</a></p>
- </article>
- <article class="card">
- <h3>Studio Linux</h3>
- <p>VFX Reference Platform CY2026 (Rocky 8) and CY2027 (Rocky 9) builds with a Python module, and a Rez
- package. <a href="guide/studios.html">For studios</a></p>
- </article>
- <article class="card">
- <h3>Works with Blender</h3>
- <p>A free add-on sends models between Blender and SculptForge and can give Blender's Sculpt Mode
- ZBrush-style keys. <a href="guide/blender.html">Blender</a></p>
- </article>
- </div>
- </div>
- </section>
-
- <section class="section alt">
- <div class="wrap">
- <h2>For ZBrush users</h2>
- <p class="section-lede">Pick the ZBrush-style keymap on first run (or later in Preferences): brushes on B and two letters, S U I O sliders,
- Ctrl to mask, Ctrl+Shift for face groups, Parts, subdivision levels, layers, dynamic topology,
- Quad Remesh retopology, VDM brushes, vertex paint, texture painting and baking. A free ZBrush plug-in
- converts your ZTools, and GoZ-compatible exchange (Send to ZBrush) moves models back and forth.
- <a href="zbrush-alternative.html">SculptForge for ZBrush users</a></p>
- </div>
- </section>
-
- <section class="section">
- <div class="wrap faq">
- <h2>Questions</h2>
- <details open><summary>Can't I just run ZBrush in Wine?</summary>
- <p>Some people try. Maxon doesn't support it, so updates, plug-ins and licensing can break without
- warning, and you're on your own when they do. SculptForge is native and supported on Linux.</p></details>
- <details><summary>What about Blender?</summary>
- <p>Blender's Sculpt Mode is excellent and native too. It's a whole 3D suite, though, and sculpts its own
- way. SculptForge is only a sculpting app, with ZBrush-style, Blender and Maya keymaps, and works alongside Blender through the
- add-on.</p></details>
- <details><summary>Is it free?</summary>
- <p>Yes, free and open source under the GPL-3.0, for commercial work too.</p></details>
- </div>
- </section>
- </main>
-
- <footer class="footer">
- <div class="wrap footer-grid">
- <div>
- <a class="brand" href="index.html"><img src="img/logo.svg?v=2" alt="" width="28" height="28"><span>SculptForge</span></a>
- <p class="fine">Copyright © 2026 The SculptForge contributors. SculptForge is licensed under the
- <a href="https://github.com/islandmed/SculptForge/blob/main/LICENSE">GNU GPL v3.0 or later</a>.</p>
- </div>
- <div class="links">
- <a href="guide/index.html">User Guide</a>
- <a href="brushes.html">Community brushes</a>
- <a href="zbrush-alternative.html">For ZBrush users</a>
- <a href="mudbox-alternative.html">For Mudbox users</a>
- <a href="zbrush-linux.html">Sculpting on Linux</a>
- <a href="benchmarks/">Benchmarks: 15M and 33M</a>
- <a href="https://github.com/islandmed/SculptForge">Source code</a>
- <a href="https://discord.gg/gWrYkEmQhH">Community Discord</a>
- <a href="support.html">Membership</a>
- <a href="supporters.html">Supporters</a>
- </div>
- <p class="fine trademarks">SculptForge is an independent project, not affiliated with or endorsed by Autodesk or
- Maxon. Mudbox and Maya are trademarks of Autodesk; ZBrush, GoZ, MatCap, FiberMesh, LightCap and other ZBrush feature names are trademarks of Maxon Computer GmbH. The site uses no cookies.
- Visits are counted anonymously with <a href="https://www.goatcounter.com/">GoatCounter</a>.</p>
- </div>
- </footer>
-</body>
-</html>