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>UV Editor - SculptForge User Guide</title>
<meta name="description" content="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.">
<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/uv-editor.html">
<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'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.">
<meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=5">
<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=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="texture-painting.html" data-next="pbr-painting.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">UV Editor</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" 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><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="uv-editor">UV Editor</h1>
<p>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.</p>
<p>Open it with <strong>Tool > Texture Map > UV Editor</strong>, or <kbd>Alt</kbd>+<kbd>U</kbd>. 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.</p>
<figure class="shot"><a href="images/uv-editor.jpg" class="zoom"><img src="images/uv-editor.jpg" alt="The UV Editor: the lion's islands after Unwrap, with island colours and a checker on the model" width="960" height="676" loading="lazy" decoding="async"></a><figcaption>The UV Editor: the lion's islands after Unwrap, with island colours and a checker on the model</figcaption></figure>
<h2 id="the-window">The window<a class="anchor" href="#the-window" aria-label="Link to this section">#</a></h2>
<ul>
<li>
<strong>Select</strong> (top left): what clicks pick, <strong>Vertex</strong>, <strong>Edge</strong>, <strong>Face</strong> or <strong>Island</strong> (<kbd>1</kbd>-<kbd>4</kbd> while the pointer is over the view). The selection converts when you switch.
</li>
<li>
<strong>Colours</strong>: what the faces show, in the view and on the model: <strong>Islands</strong> (a colour each), <strong>Stretch</strong>, <strong>Density</strong> (texel density) or <strong>Plain</strong>.
</li>
<li>
<strong>Image</strong>: what's behind the layout: nothing, a <strong>Checker</strong>, or the Part's painted <strong>Texture</strong> (tile 1001).
</li>
<li>
<strong>On model</strong>: <strong>Colours</strong> shows the same colours on the model, <strong>Checker</strong> 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.
</li>
<li>
<strong>Frame</strong> (<kbd>F</kbd> over the view) fits the selection, or the whole layout, in the view; <kbd>Home</kbd> shows tile 1001.
</li>
<li>
The status line under the view: islands, what's selected, the mean stretch, the texel density and the UDIM tiles in use.
</li>
<li>
The sections on the right: <strong>Unwrap</strong> (with the seams), <strong>Pack</strong>, <strong>Texel Density</strong>, <strong>Trim Sheet</strong>, <strong>Edit</strong> and <strong>Display</strong>.
</li>
</ul>
<p>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>
<h2 id="selecting">Selecting<a class="anchor" href="#selecting" aria-label="Link to this section">#</a></h2>
<ul>
<li>
Click to select (<kbd>Shift</kbd> adds, <kbd>Ctrl</kbd> 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.
</li>
<li>
<kbd>A</kbd> selects everything, <kbd>Alt</kbd>+<kbd>A</kbd> nothing, <kbd>Ctrl</kbd>+<kbd>I</kbd> inverts.
</li>
<li>
<strong>Select in 3D</strong> (Unwrap section): click or drag over the model to select there, in the current mode; <kbd>Shift</kbd> adds, <kbd>Alt</kbd> removes. The selection shows orange in both views.
</li>
</ul>
<p>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>
<h2 id="moving-rotating-and-scaling">Moving, rotating and scaling<a class="anchor" href="#moving-rotating-and-scaling" aria-label="Link to this section">#</a></h2>
<p>The selection has a box with handles: drag inside it to move, a corner to scale, the knob above it to rotate. Or press <kbd>G</kbd> (move), <kbd>R</kbd> (rotate) or <kbd>S</kbd> (scale) over the view, move the mouse, and click (or <kbd>Enter</kbd>) to finish; a right click or <kbd>Esc</kbd> puts it back. During <kbd>G</kbd> and <kbd>S</kbd>, <kbd>X</kbd> or <kbd>Y</kbd> locks to one axis; <kbd>Ctrl</kbd> 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>
<h2 id="seams">Seams<a class="anchor" href="#seams" aria-label="Link to this section">#</a></h2>
<p>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.</p>
<ul>
<li>
<strong>Seam Tool</strong>: 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. <kbd>Alt</kbd>+drag clears seams the same way. A ring under the pointer shows the vertex the next stretch starts from.
</li>
<li>
<strong>Mark Seam</strong> / <strong>Clear Seam</strong>: the selected edges, or the border of the selected faces.
</li>
<li>
<strong>Face Groups</strong>: every face group border becomes a seam.
</li>
<li>
<strong>Island Borders</strong>: the borders of the current UV islands become seams (keeps an imported layout's cuts).
</li>
<li>
<strong>Sharp Edges</strong>: every edge sharper than the angle beside it (hard-surface models).
</li>
<li>
<strong>Clear All</strong>.
</li>
</ul>
<figure class="shot"><a href="images/uv-editor-seams.jpg" class="zoom"><img src="images/uv-editor-seams.jpg" alt="Seams drawn with the Seam Tool across the mane, in red on the model" width="960" height="676" loading="lazy" decoding="async"></a><figcaption>Seams drawn with the Seam Tool across the mane, in red on the model</figcaption></figure>
<h2 id="unwrapping">Unwrapping<a class="anchor" href="#unwrapping" aria-label="Link to this section">#</a></h2>
<p>Pick a method and click <strong>Unwrap</strong>. With faces selected it says <strong>Unwrap Selected</strong>: only those are unwrapped, and their new islands are fitted where the old ones were; otherwise the whole Part is unwrapped and packed.</p>
<div class="table-wrap"><table><thead><tr><th>Method</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Least Stretch</strong> (the default)</td><td>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</td></tr><tr><td><strong>Conformal (LSCM)</strong></td><td>Keeps angles exactly; big curved pieces get smaller towards their ends</td></tr><tr><td><strong>By Face Groups</strong></td><td>Least Stretch, also cut along every face group border: group the model, then unwrap</td></tr><tr><td><strong>Planar</strong></td><td>Projects each piece flat along its mean direction: for flat panels and decals</td></tr><tr><td><strong>Unfold Islands</strong></td><td>Flattens the current islands again where they are, keeping pinned UVs in place: relax after editing</td></tr><tr><td><strong>Auto Seams</strong></td><td>Finds its own seams (as <strong>Auto UV</strong> does), for models you don't want to cut by hand</td></tr></tbody></table></div>
<p><strong>Refine</strong> sets how many least-stretch steps run (more keeps lengths better; 0 is plain conformal).</p>
<p>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>
<h2 id="packing-and-udim-tiles">Packing and UDIM tiles<a class="anchor" href="#packing-and-udim-tiles" aria-label="Link to this section">#</a></h2>
<p><strong>Pack</strong> lays the selected islands (or all) out as large as they fit: each turned to its smallest box, scaled to one texel density (<strong>Equal density</strong>; off keeps their sizes relative to each other), with <strong>Margin</strong> texels between them. <strong>Rotate</strong> also allows quarter turns. SculptForge tries packing by the islands' outlines and by their boxes and keeps whichever holds them larger.</p>
<p><strong>Columns</strong> and <strong>Rows</strong> set the grid of UDIM tiles to fill: Columns along u (1001, 1002 and on; ten make a full UDIM row) and Rows up v (1011 sits above 1001). <strong>10</strong> Columns x <strong>2</strong> Rows fills 1001-1020; <strong>4</strong> x <strong>3</strong> fills 1001-1004, 1011-1014 and 1021-1024 and never goes wider. Every island gets the same texel density: more tiles, more texels for everything; the view frames the grid after a pack. When the largest island sets the scale, fewer tiles than the grid holds get islands, and the status line says how many (Pack at Density fills more). <strong>Pack at Density</strong> instead keeps exactly the target texel density and opens as many tiles as it needs, Columns wide and then the next row up. Projects remember their grid; new ones start from the last one you used.</p>
<p>Baking writes one set of maps per tile, rows included (<code>name_normal.1011.png</code>, see <a href="baking.html">Baking</a>). Texture painting still covers tile 1001 only.</p>
<figure class="shot"><a href="images/uv-editor-udim.jpg" class="zoom"><img src="images/uv-editor-udim.jpg" alt="Packed across UDIM tiles 1001 and 1002" width="960" height="676" loading="lazy" decoding="async"></a><figcaption>Packed across UDIM tiles 1001 and 1002</figcaption></figure>
<h2 id="texel-density">Texel density<a class="anchor" href="#texel-density" aria-label="Link to this section">#</a></h2>
<p>Texel density is how many texels of the texture cover a unit of the surface. The <strong>Texel Density</strong> 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 <strong>Density</strong> colours show it on every face: green is the mean, blue fewer texels, red more.</p>
<ul>
<li>
<strong>Set</strong>: scale the selected islands (or all) to the target density (texels per unit).
</li>
<li>
<strong>Match</strong>: give them all their mean density, so a detail looks the same size everywhere.
</li>
<li>
<strong>Pick</strong>: take the target from the selection.
</li>
<li>
<strong>Pack at Density</strong>: pack at exactly the target (see above).
</li>
</ul>
<figure class="shot"><a href="images/uv-editor-stretch.jpg" class="zoom"><img src="images/uv-editor-stretch.jpg" alt="Stretch on the model and in the view while the UVs are edited" width="960" height="676" loading="lazy" decoding="async"></a><figcaption>Stretch on the model and in the view while the UVs are edited</figcaption></figure>
<h2 id="trim-sheets">Trim sheets<a class="anchor" href="#trim-sheets" aria-label="Link to this section">#</a></h2>
<p>A trim sheet is a texture made of horizontal strips (a moulding, a belt, a seam of rivets), each repeating left to right. In <strong>Trim Sheet</strong>, describe the strips: a count (<code>4</code> equal strips), heights from the top (<code>0.5,0.25,0.25</code>) or v ranges (<code>0-0.5;0.5-1</code>); they show over tile 1001 while the section is open. Pick a strip and click <strong>Assign to Strip</strong>: the selected islands are turned lengthwise, scaled to the strip's height and lined up along it from the left. <strong>Fit width</strong> 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.</p>
<p>The texture doesn't move for trims: the islands take on the strip's look.</p>
<figure class="shot"><a href="images/uv-editor-trim.jpg" class="zoom"><img src="images/uv-editor-trim.jpg" alt="An island laid into the second of four trim strips" width="960" height="676" loading="lazy" decoding="async"></a><figcaption>An island laid into the second of four trim strips</figcaption></figure>
<h2 id="editing">Editing<a class="anchor" href="#editing" aria-label="Link to this section">#</a></h2>
<div class="table-wrap"><table><thead><tr><th>Button</th><th>Over the view</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Pin</strong> / <strong>Unpin</strong></td><td><kbd>P</kbd> / <kbd>Alt</kbd>+<kbd>P</kbd></td><td>Pinned UVs (blue dots) stay where they are when you Unwrap or Unfold</td></tr><tr><td><strong>Weld</strong></td><td><kbd>W</kbd></td><td>Selected vertices that meet across a seam become one UV each, and the seam between them goes</td></tr><tr><td><strong>Split</strong></td><td><kbd>Y</kbd></td><td>The selected edges, or the border of the selected faces, become seams, so those faces move on their own</td></tr><tr><td><strong>Straighten</strong></td><td></td><td>The selected vertices (a border, an edge loop) line up on one horizontal or vertical line</td></tr><tr><td><strong>Rotate 90</strong></td><td></td><td>A quarter turn of the selection (or everything)</td></tr><tr><td><strong>Flip U</strong> / <strong>Flip V</strong></td><td></td><td>Mirror the selected islands left to right or top to bottom</td></tr></tbody></table></div>
<p>A good relax workflow: straighten or move the borders you care about, pin them, then <strong>Unfold Islands</strong>.</p>
<h2 id="paint-stays-on-the-model">Paint stays on the model<a class="anchor" href="#paint-stays-on-the-model" aria-label="Link to this section">#</a></h2>
<p><strong>Paint stays on the model</strong> (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>
<h2 id="undo">Undo<a class="anchor" href="#undo" aria-label="Link to this section">#</a></h2>
<p>Every UV operation is one undo step (<kbd>Ctrl</kbd>+<kbd>Z</kbd>), drags included: the UVs, seams and pins, and the texture when it moved with them. Seams and pins are saved with the project.</p>
<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, "uv_unwrap", method="isometric")</code>) and the AI assistant. "The selection" is the UV Editor'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>facegroups</code> (By Face Groups), <code>planar</code>, <code>unfold</code> or <code>auto</code>; <code>iterations=</code>, <code>selected=</code>, <code>tiles=</code>, <code>columns=</code>, <code>rows=</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>columns=</code> and <code>rows=</code> (the UDIM grid, e.g. <code>columns=10 rows=2</code> for 1001-1020), <code>tiles=</code> (UDIM tiles, ten per row), <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>facegroups</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>facegroup 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'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=face groups
uv_unwrap method=isometric
uv_pack tiles=2 margin=8
uv_density op=match
uv_info</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
<h2 id="limits">Limits<a class="anchor" href="#limits" aria-label="Link to this section">#</a></h2>
<ul>
<li>
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.
</li>
<li>
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).
</li>
</ul>
<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>
<a href="texture-painting.html">Texture painting</a>: paint on the UVs
</li>
<li>
<a href="baking.html">Baking</a>: bake maps onto them
</li>
<li>
<a href="exporting.html">Exporting</a>: UVs go out with OBJ, glTF, FBX and USD
</li>
</ul>
</article>
<nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="texture-painting.html"><span>Previous</span>Texture painting</a><a class="next" rel="next" href="pbr-painting.html"><span>Next</span>Material painting (PBR)</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/uv-editor.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-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></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>