Free, open-source 3D sculpting for Linux, macOS and Windows: dense meshes, remeshing, painting, built-in AI (image/text to 3D), Send to Unreal, game-ready LODs, Gaussian splats and OpenUSD.
C++ 3d3d-sculptingcppdear-imguidigital-sculptingfbxgame-developmentgaussian-splattinggltfimage-to-3dmcpopenglopenusdsculptingtext-to-3dunreal-engine
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>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'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/png" sizes="32x32" href="../img/favicon-32.png?v=7">
<link rel="icon" type="image/png" sizes="64x64" href="../img/favicon-64.png?v=7">
<link rel="apple-touch-icon" href="../img/apple-touch-icon.png?v=7">
<link rel="canonical" href="https://sculptforge.app/guide/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'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=5">
<meta property="og:url" content="https://sculptforge.app/guide/gizmo.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=12" defer></script>
<script data-goatcounter="https://sculptforge.goatcounter.com/count" async src="https://gc.zgo.at/count.js"></script>
<script src="search-index.js?v=52" defer></script>
</head>
<body class="guide-page" data-prev="timeline.html" data-next="geometry.html">
<div class="scroll-progress" aria-hidden="true"></div>
<header class="nav">
<div class="wrap nav-inner">
<a class="brand" href="../index.html"><img class="brand-mark" src="../img/bust-mark-44.png" srcset="../img/bust-mark-88.png 2x, ../img/bust-mark-132.png 3x" width="44" height="44" alt=""><span>SculptForge</span></a>
<nav aria-label="Main">
<a href="../index.html#features">Features</a>
<a href="../index.html#demos">Demos</a>
<a href="../brushes.html">Brushes</a>
<a href="index.html" aria-current="page">Guide</a>
<a class="nav-dl" href="../index.html#download">Download</a>
<a class="gh" href="https://discord.gg/gWrYkEmQhH">Discord</a>
<a class="gh" href="https://github.com/islandmed/SculptForge">GitHub</a>
</nav>
</div>
</header>
<div class="wrap guide-layout">
<div class="guide-side">
<button class="toc-toggle" type="button" aria-expanded="false" aria-controls="guide-toc">
<span>Contents</span><span class="toc-current">Moving, rotating and posing (Gizmo)</span></button>
<div id="guide-toc" class="toc-panel">
<div class="guide-search" role="search">
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
<nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What's new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html">The interface</a></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="brush-packs.html">Brush packs</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="linked-duplicates.html">Linked Duplicates</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="tube.html">Tube: draw in 3D space</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">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-modes">The 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><li><a href="security.html">Security overview for IT reviews</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li><li><a href="discord.html">Show SculptForge on Discord</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
<article class="guide-article">
<h1 id="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'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'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's Move, Scale and Rotate modes; the handle under the cursor turns yellow</figcaption></figure>
<h2 id="the-modes">The modes<a class="anchor" href="#the-modes" aria-label="Link to this section">#</a></h2>
<p>Press a key, or click the button on the top shelf (they're also in <strong>Sculpt > Symmetry & Gizmo</strong>):</p>
<div class="table-wrap"><table><thead><tr><th>Key</th><th>Mode</th><th>What you drag</th></tr></thead><tbody><tr><td><kbd>W</kbd></td><td><strong>Move</strong></td><td>An <strong>arrow</strong> moves along that axis. A <strong>square</strong> moves in its plane. The <strong>ring in the centre</strong> moves freely in the view plane</td></tr><tr><td><kbd>E</kbd></td><td><strong>Scale</strong></td><td>A <strong>box</strong> stretches along that axis. The <strong>disc in the centre</strong> scales evenly: drag right or up to grow, left or down to shrink</td></tr><tr><td><kbd>R</kbd></td><td><strong>Rotate</strong></td><td>A <strong>ring</strong> turns about that axis. The <strong>outer white ring</strong> turns about the view direction</td></tr><tr><td><kbd>Shift</kbd>+<kbd>W</kbd></td><td><strong>All</strong></td><td>Every handle at once: see <a href="#all-handles-at-once">All handles at once</a></td></tr><tr><td><kbd>Q</kbd></td><td><strong>Draw</strong></td><td>Back to sculpting: brushes work again and the gizmo goes away</td></tr></tbody></table></div>
<p>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 <kbd>Ctrl</kbd> still paints the mask, so you can mask and move without leaving the gizmo.</p>
<p>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 <strong>one undo step</strong> (<kbd>Ctrl</kbd>+<kbd>Z</kbd>), and the gizmo goes back with it.</p>
<h3 id="all-handles-at-once">All handles at once<a class="anchor" href="#all-handles-at-once" aria-label="Link to this section">#</a></h3>
<p><strong>All</strong> (<kbd>Shift</kbd>+<kbd>W</kbd>, or <strong>All</strong> beside Rotate) puts move, rotate and scale on one gizmo, so you can place, turn and size a part without switching modes:</p>
<ul>
<li>
Short <strong>arrows</strong> and <strong>squares</strong> inside the rings move, and the <strong>ring in the centre</strong> moves freely, as in Move.
</li>
<li>
The <strong>rings</strong> turn about each axis and the <strong>white ring</strong> around them turns in the view, as in Rotate.
</li>
<li>
A <strong>box</strong> on an axis line, just outside the rings, stretches along that axis. It hides while its axis points straight at you (it would sit on the rings); turn the view a little to bring it back.
</li>
<li>
The four <strong>gold tabs</strong> on the outside scale evenly: drag right or up to grow, left or down to shrink.
</li>
</ul>
<figure class="shot"><a href="images/gizmo-all.jpg" class="zoom"><img src="images/gizmo-all.jpg" alt="All mode: arrows and squares inside the rings, the scale boxes past them (X lit up under the cursor), the white view ring, the gold even-scale tabs outermost" width="490" height="345" loading="lazy" decoding="async"></a><figcaption>All mode: arrows and squares inside the rings, the scale boxes past them (X lit up under the cursor), the white view ring, the gold even-scale tabs outermost</figcaption></figure>
<p>Where handles cross, the one you see on top is the one you get: the centre first, then the boxes and the tabs, then an arrow or a square over a ring. Snapping, the readout, posing with a mask, <kbd>Alt</kbd>+drag for the pivot and one undo step per drag all work as in the single modes. Scripts switch modes with <code>gizmo_mode mode=all</code> (or <code>move</code>, <code>scale</code>, <code>rotate</code>, <code>draw</code>); like every action, <strong>All</strong> can take another key in <strong>Edit > Preferences > Hotkeys</strong>.</p>
<h3 id="snapping">Snapping<a class="anchor" href="#snapping" aria-label="Link to this section">#</a></h3>
<p>Hold <kbd>Shift</kbd> while dragging to snap:</p>
<ul>
<li>
<strong>Rotate</strong>: 15 degree steps.
</li>
<li>
<strong>Move</strong>: whole steps of the grid, a round number about a twentieth of the model's size (0.1, 0.2, 0.5, 1...).
</li>
<li>
<strong>Scale</strong>: 10% steps.
</li>
</ul>
<p>You can press and release <kbd>Shift</kbd> during the drag.</p>
<h2 id="moving-only-part-of-a-part">Moving only part of a Part<a class="anchor" href="#moving-only-part-of-a-part" aria-label="Link to this section">#</a></h2>
<p>The gizmo respects the <a href="masking.html">mask</a>: 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 <kbd>Ctrl</kbd>+click on the background), then drag.</p>
<p>Turn <strong>Mask</strong> off in the Gizmo panel to move the whole Part whatever the mask.</p>
<h2 id="posing-a-limb">Posing a limb<a class="anchor" href="#posing-a-limb" aria-label="Link to this section">#</a></h2>
<ol>
<li>
Mask what should stay: for an arm, everything but the arm (<kbd>Ctrl</kbd>+paint, or <strong>Lasso Mask</strong>).
</li>
<li>
Press <kbd>R</kbd>. The gizmo jumps to the centre of the unmasked arm.
</li>
<li>
Put the pivot at the joint: hold <kbd>Alt</kbd> and click the model at the shoulder or elbow. (Or click <strong>To Surface</strong>, then click the model.)
</li>
<li>
Raise <strong>Falloff</strong> 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.
</li>
<li>
Drag a ring. Release, then drag again to refine; each drag is its own undo step.
</li>
</ol>
<figure class="shot"><a href="images/gizmo-pose.jpg" class="zoom"><img src="images/gizmo-pose.jpg" alt="Posing: upper arm masked, pivot at the elbow (left); the forearm turning with a 29% falloff (right)" width="890" height="660" loading="lazy" decoding="async"></a><figcaption>Posing: upper arm masked, pivot at the elbow (left); the forearm turning with a 29% falloff (right)</figcaption></figure>
<p>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>
<h3 id="symmetry">Symmetry<a class="anchor" href="#symmetry" aria-label="Link to this section">#</a></h3>
<p>With <strong>X</strong>, <strong>Y</strong> or <strong>Z</strong> 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>
<h2 id="the-pivot">The pivot<a class="anchor" href="#the-pivot" aria-label="Link to this section">#</a></h2>
<p>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.</p>
<div class="table-wrap"><table><thead><tr><th>To</th><th>Do this</th></tr></thead><tbody><tr><td>Move the gizmo without moving the model</td><td><kbd>Alt</kbd>+drag any Move handle</td></tr><tr><td>Turn the gizmo's axes without turning the model</td><td><kbd>Alt</kbd>+drag a Rotate ring (the axes switch to <strong>Surface</strong>)</td></tr><tr><td>Put the pivot on the surface</td><td><kbd>Alt</kbd>+click the model, or <strong>To Surface</strong> then click the model</td></tr><tr><td>Type the pivot</td><td>The three numbers under the mode buttons in the Gizmo panel</td></tr><tr><td>Go back to the centre, with world axes</td><td><strong>Reset</strong></td></tr></tbody></table></div>
<p>After a drag the gizmo moves (and with <strong>Surface</strong> axes, turns) with what it moved.</p>
<h3 id="world-or-surface-axes">World or Surface axes<a class="anchor" href="#world-or-surface-axes" aria-label="Link to this section">#</a></h3>
<p><strong>World</strong> keeps the gizmo's arrows and rings on the world's X, Y and Z. <strong>Surface</strong> 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>
<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'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, 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><strong>Folder</strong>, beside it, moves the visible Parts in the active Part's <a href="parts.html#folders">folder</a> together, for example both eyes. Right-click a folder's header in the Parts list > <strong>Move with the gizmo</strong> turns it on for you.</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. With <strong>Base mesh</strong> active, <a href="layers.html">sculpt layers</a> move with the surface: the base and every layer's offsets are transformed together, so a layer you sculpted on a forearm stays on it after posing, and layer sliders keep working. With a sculpt layer active, the transform goes into that layer, like a stroke: the base stays, and the layer's weight dials the move in and out (a pose as a blend shape). A layer whose weight is 0 can't be transformed into. With <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's pivot and options too.</p>
<h2 id="scripting">Scripting<a class="anchor" href="#scripting" aria-label="Link to this section">#</a></h2>
<p>Every gizmo drag appears in the console as the <code>transform</code> command that repeats it, so <strong>Copy session as script</strong> replays your posing. You can also type it, or use it in scripts and <code>sculptforge-cli</code>:</p>
<div class="code-block"><pre class="code"><code>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</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
<div class="table-wrap"><table><thead><tr><th>Parameter</th><th>Meaning</th></tr></thead><tbody><tr><td><code>translate</code></td><td>Movement x,y,z in world units</td></tr><tr><td><code>rotate</code></td><td>Degrees about X, then Y, then Z (of <code>orient</code>)</td></tr><tr><td><code>scale</code></td><td>One number, or x,y,z along the axes of <code>orient</code> (above 0)</td></tr><tr><td><code>pivot</code></td><td><code>center</code> (default: the centre of what moves), <code>origin</code>, or x,y,z</td></tr><tr><td><code>orient</code></td><td><code>world</code> (default), or the axes as x,y,z Euler degrees</td></tr><tr><td><code>masked</code></td><td><code>true</code> (default) leaves masked parts; <code>false</code> moves everything</td></tr><tr><td><code>falloff</code></td><td>Soft joint width as a share of the size, 0-1 (default 0)</td></tr><tr><td><code>symmetry</code></td><td>Mirror a masked transform across these planes, e.g. <code>x</code></td></tr><tr><td><code>all</code></td><td>Every visible Part, moved, rotated and scaled together</td></tr></tbody></table></div>
<h2 id="speed">Speed<a class="anchor" href="#speed" aria-label="Link to this section">#</a></h2>
<p>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>
<h2 id="see-also">See also<a class="anchor" href="#see-also" aria-label="Link to this section">#</a></h2>
<ul>
<li>
<a href="masking.html">Masking</a>
</li>
<li>
<a href="parts.html">Parts</a>
</li>
<li>
<a href="layers.html">Sculpt layers and blend shapes</a>
</li>
<li>
<a href="shortcuts.html">Keyboard and mouse</a>
</li>
</ul>
</article>
<nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="timeline.html"><span>Previous</span>Sculpt Timeline and timelapse</a><a class="next" rel="next" href="geometry.html"><span>Next</span>Subdivide, remesh, decimate and LODs</a></nav>
<p class="guide-meta fine">Also in the app: <strong>Help > User Guide</strong> (<kbd>Shift</kbd>+<kbd>F1</kbd>).
Found a mistake? <a href="https://github.com/islandmed/SculptForge/edit/main/docs/guide/gizmo.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-modes">The 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></aside>
</div>
<footer class="footer">
<div class="wrap footer-grid">
<div>
<a class="brand" href="../index.html"><img class="brand-mark" src="../img/bust-mark-44.png" srcset="../img/bust-mark-88.png 2x, ../img/bust-mark-132.png 3x" width="32" height="32" alt=""><span>SculptForge</span></a>
<p class="fine">Copyright © 2026 The SculptForge contributors.<br>The SculptForge User Guide is part of
SculptForge, licensed under the <a href="https://github.com/islandmed/SculptForge/blob/main/LICENSE">GNU GPL v3.0 or later</a>.</p>
</div>
<div class="links">
<a href="../performance/">Performance</a>
<a href="index.html">User guide</a>
<a href="../supporters.html">Members</a>
<a href="https://github.com/islandmed/SculptForge">Source code</a>
<a href="https://discord.gg/gWrYkEmQhH">Community Discord</a>
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services & privacy</a>
</div>
<p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
</html>