UV and baking
On this page
Baking transfers detail from the high-poly reference onto the retopology. QuadPen can unwrap UVs automatically (with your own seams if you mark them), edit them on a 0–1 canvas, and bake normal, ambient occlusion, curvature, cavity, transmission, color, and displacement maps.
Unwrap and Auto Unwrap#
Switch to the UV Layout tab at the top right. The UV editor docks beside the 3D view (drag its edge to resize), the inspector shows four sections (SEAMS, UNWRAP, PACK, TEXEL DENSITY), laid out as label / value rows with one highlighted main button each; hover a label for its explanation, and the tool dock on the left holds the UV tools. There are two unwrap buttons, side by side in UNWRAP and in the UV editor:
Unwrap cuts only where you marked seams (and at the mesh border). A closed part, or a ring, gets the fewest cuts that open it, and islands are never split on their own. Use it when you have placed your seams: what you marked is what you get.
Auto Unwrap lets QuadPen choose the islands, as described below.
Both run in the background, and the task panel at the bottom left of the 3D view shows the step (Finding islands, Flattening islands with a percentage, Packing); large meshes show Unwrapping UVs... until it finishes. The line under the button reports the number of islands, how much of the map they use, and whether anything folded over (the goal is no folds). Bake and export then use these UVs.
What Auto Unwrap does:
Cuts the mesh into islands at marked seams, at sharp edges, and where a region bends too far to flatten well. Only a disk (one border, no holes) can be flattened, so a ring or a closed part gets the fewest, shortest extra cuts that open it while staying one island. When an island must be divided (it would fold, overlap itself, or its density would vary more than 2×), the cut follows one of the mesh's own edge loops, so seams run straight.
Flattens each island so every quad keeps its shape as closely as possible (least squares conformal maps). An island that would fold over itself, or whose texel density would vary more than four times, is cut in two and flattened again.
Evens out texel density. Inside each island, Even density (on by default) balances every face's size and shape so one square of surface gets the same share of the map; it can never fold or squash a face. Then every island is scaled to the same density.
Packs the islands by their real outlines (drawn as bitmaps, so notches and gaps stay usable), so small islands fill the gaps around and inside big ones. Each island may be turned by quarter turns, which keeps its quad rows along U and V; several placement orders and map widths are tried and the tightest layout wins.
Checking UVs: Checker, Density, Shape#
Under Show (in UV UNWRAP and in the UV Editor) pick how the retopology displays its UVs. The choice is remembered.
Checker paints a checker from the UVs on the model. Squares that stay square have no stretch; squares of equal size have even texel density. The base colour shifts from blue to warm along U and gains green along V, so you can see how each island is turned. Checker squares sets how many squares cross the map.
Density colours each face by how many texels it gets compared with the typical face: blue gets fewer (the texture looks blurrier there), red gets more. Full colour means half or double.
Shape colours each face by how much its shape is skewed: green kept, yellow 1.5:1, red 2:1 or worse.
In the UV Editor, Density and Shape also colour the islands and a line reports the spread, for example 90% of faces: density within ±0.40 doublings (×1.32 area), shape ≤ 1.05:1.
Seams#
Seams are the edges where the mesh is cut open. They are drawn orange in the viewport and saved with the scene.
Mark seam marks the selected edges. In Vertex mode it uses the edges between selected vertices; in Face mode it uses the outline of the selected faces, which is the quickest way to cut out a region.
Clear seam removes seams from the same edges; Clear all removes every seam.
From Islands marks every cut of the current layout as a seam. Use it after Auto Unwrap to take over its seams: move or clear a few, then press Unwrap for a layout that follows your edited seams exactly.
From Sharp marks every edge whose faces meet at more than the Sharp angle angle (60° when that is off).
With Symmetry on, the mirrored edges are marked too. Marking and clearing can be undone.
You do not have to mark seams: without them the unwrap cuts automatically. Mark them where you want the cuts hidden (behind the ears, under the arms, along the inside of a sleeve).
Settings#
UNWRAP holds the buttons and the settings both unwraps use (Even density, Symmetric, Stack halves), then the ones only Auto Unwrap uses (Marked seams, Sharp angle, Bend limit, Straighten). PACK holds Padding (in pixels at the bake size), UV tiles, Align to U/V, Equalize scale and a Pack button.
Marked seams — cut at the orange seams.
Sharp angle — edges whose faces meet at more than this angle are cut (default 70°, 0 turns it off). Good for hard-surface parts.
Bend limit — how far one island may curve before it is split (default 85°). Raise it, up to 180°, for fewer, larger islands that follow only your seams; islands that would fold or stretch are still split.
Padding — gap around each island as a share of the map width (default 0.8%, about 8 pixels on a 1K map). Raise it for low-resolution bakes.
Even density — balance size and shape inside each island after flattening (see above). Turn it off for a pure angle-preserving layout, or on very large meshes if you need speed.
Align to U/V — turn every island so its quad rows run straight along U and V.
Symmetric (needs Symmetry on) — islands are grown on one half of the model. An island that reaches the symmetry plane is joined with its mirror image into one island; every other island gets an exact mirror twin on the other side. On a symmetric test head this gives 9 mirrored pairs. Vertices without a mirror partner are unwrapped normally, so a model that is only partly symmetric still unwraps, with more islands.
Stack halves — lay each mirror twin exactly on top of its partner. Both halves share texture space, so each gets twice the resolution; the two halves then carry identical texture. Stacked twins are not counted as folds.
Tiles — pack into 1 to 10 tiles side by side (1001, 1002, ...). Islands never cross a tile border. Bake then writes one image set per tile, named the UDIM way:
head_normal.1001.png,head_normal.1002.png, and so on. The UV editor outlines every tile.Straighten — snap quad islands into perfectly straight grids, every edge along U or V. Islands where this would fold, overlap or stretch keep their regular layout. Best for hard-surface parts: on the 431-face test part, 3 of 4 islands become straight grids; on the organic head only 1 of 13 qualifies. Off by default, because straight rows cost some density evenness.
Measured on the test models (density spread = how far 90% of faces stay from the typical texel density, in doublings of area):
| Model | Faces | Islands | Map used | Density spread | Time |
|---|---|---|---|---|---|
| Hard-surface part | 431 | 4 | 68% | ±0.02 | instant |
| Head | 4,948 | 13 | 53% | ±0.18 | 1.3 s |
| Body | 55,808 | 39 | 53% | ±0.14 | 32 s |
No island on these models overlaps itself. Auto Unwrap checks every island for parts lying on top of other parts of the same island (by drawing it on a fine grid and counting doubly covered area) and cuts such an island apart between the two layers. Packing turns islands in 90° steps; islands with no clear grid direction (organic patches) may also turn in 22.5° steps, which fits long curved islands much better.
None has folded triangles. If an island still overlaps itself after splitting, the summary says so; mark a seam there. The summary under Unwrap includes the texel density in pixels per scene unit at the bake resolution, so several objects can be matched by eye; every island of one unwrap has the same density. The summary under Unwrap also reports any small border overlaps: places where an island's jagged border touches itself within one quad. Large overlaps are always split away.
UV tools#
In UV Layout the tool dock on the left shows the UV tools. They work on the current layout, one click each, and every one can be undone. Tools marked picked islands act on the islands that hold picked UV points or selected faces, or on every island when nothing is picked.
Pick
UV editor tool: Select (Q), Move (W), Rotate (E) and Scale (R) decide what dragging in the UV editor does; see UV editor.
UV editor picks: Points (
F9), Edges (F10), Faces (F11) or Islands (F12) choose what a click or a box picks in the UV editor. 3D view picks: Edges / Faces choose what a click picks on the model.
Seams
Cut opens the layout along the picked edges: they become seams, and only the islands next to them are unfolded again, in place. Pick edges in the 3D view, faces to cut out their outline, or two neighbouring points in the UV editor.
Sew closes the picked edges: their seams go, and the islands on both sides join into one and unfold together.
Cut and Sew leave the rest of the layout where it is; press Pack afterwards to tidy up. With Symmetry on, the mirrored edges are cut or sewn too.
Unfold
Unfold flattens the picked islands again from their seams, keeping their place, turn and texel density.
Optimize relaxes the picked islands to even out stretch; pinned points stay put (this was Relax).
Straighten snaps the picked islands into straight quad grids, every edge along U or V. Islands that are not mostly quads, or that would fold, are left alone.
Pin / Unpin hold picked UV points in place for Optimize. Unpin with nothing picked releases every pin.
Arrange
Pack packs every island into the map without changing its shape, using Padding and UV tiles from UV UNWRAP. With Equalize scale (on by default) every island first gets the same texel density; turn it off to keep sizes you changed on purpose.
Rotate 90°, Flip U, Flip V act on the picked points, or the whole layout when nothing is picked. Fit scales the layout into the 0–1 square.
The UV tools run in the background, so the window never freezes; the task panel at the bottom left of the 3D view shows each one's step and progress (Unfold shows a percentage). Islands are flattened in parallel: unfolding every island of the 55,808-face body takes about 8 s, packing it about 1 s. Cut, Sew and Unfold of a few islands are instant. If you edit the layout while a tool runs, its result is dropped and the status bar says so.
Islands lying exactly on top of each other (stacked mirror halves) stay stacked when you Pack.
Texel density#
TEXEL DENSITY shows the density of the picked islands (or the whole layout) in pixels per scene unit at the bake resolution. To match islands: pick one island, press Get, pick the others, press Set. Set scales each picked island (or every island when nothing is picked) about its centre to the value in the box, which you can also type. To keep those sizes when packing, turn off Equalize scale.
Bake maps and explicit UVs#
In the BAKE MAPS section, Unwrap (UV Layout tab) runs the same automatic unwrap, the label shows Explicit UVs active while UVs exist, UV editor opens the layout, and Clear UVs returns to UVs generated at bake time.
If you imported a low-poly mesh with per-corner UVs, those UVs are used first and are preserved on export. When no explicit or imported UVs exist, baking generates them using the selected UV layout mode.
UV editor#
In UV Layout the UV editor is docked beside the 3D view. It shows the 0–1 tile as a checker.
Navigate: mouse wheel zooms about the pointer, middle-drag pans, Fit shows the whole tile again.
Pick: choose Points, Edges, Faces or Islands. The item a click would take is highlighted under the cursor. A click replaces the selection,
Shift-click toggles,Ctrl-click removes, Ctrl+Shift-click adds. Dragging empty space draws a selection box with the same rules (points inside it, edges and faces lying fully inside it, islands touching it). Double-click takes the whole island. Clicking empty space deselects; All and None select everything or nothing. Picked islands also select their faces in the 3D view, and faces selected in 3D are highlighted in UV.Move (W): drag a point, edge, face or island; something that is not selected yet is selected first. Corners that share a point move together, so dragging never tears the layout. Select (Q): dragging always draws a selection box. Rotate (E): drag to turn the selection about its centre;
Shiftsnaps to 15°. Scale (R): drag away from or towards the centre;Shiftscales along U or V only. The centre is marked with a small cross.Exact amounts: the row under the buttons has typed Move (U and V, where 1 is one whole tile), Rotate (degrees) and Scale (factor), each with Apply. They act on the selection, or on everything when nothing is picked.
Align: Left, Centre U, Right, Top, Centre V, Bottom line the picked items up. With Islands picked each island moves as a whole; otherwise every picked point is put on the line.
Pin / Unpin: pinned points (red squares) stay where they are when relaxing. Unpin with nothing selected clears all pins.
Relax (called Optimize in the UV tool dock): re-flattens the islands that hold the selection (or every island) with the density optimiser, keeping pins in place. Typical use: drag or pin a few points into place, then Relax to let the rest follow without stretch.
Rotate 90°, Flip U, Flip V act on the selection, or on the whole layout when nothing is selected. Normalize fits the layout into the 0–1 square.
Unwrap and Auto Unwrap unwrap again (see above); a new unwrap clears selection and pins. Every edit can be undone.
In UV Layout the pin, relax, rotate and flip buttons live in the UV tool dock on the left; the floating UV editor (from the Topo tab) keeps them above its canvas.
UVs survive undo and redo, mirror operations, and normal flips.
Bake layouts#
When the low poly has no UVs yet, the UVs setting decides what Bake does:
| Setting | Behavior |
|---|---|
| Auto Unwrap (default) | Runs the same Auto Unwrap as UV Layout first, then bakes. The UVs stay on the low poly, show in UV Layout and are exported, so the maps fit the exported mesh. |
| Per-face | One cell per face. Only for quick tests: the result cannot be painted on. |
Imported or explicit UVs take priority over either layout.
Bake settings#
The Maps section picks which maps to bake; Output holds the settings. Set the map size with Size (256–4096 px, square). Samples controls ambient occlusion quality. Edge extent extends map colors beyond island edges, and Search limits how far the bake searches for the reference surface; 0 means unlimited. Cage offset samples from a virtual cage offset along the retopology normals, from −10% to 10% of scene size.
| Map | Notes |
|---|---|
| Normal | Enable World space, or Flip R / G, as needed for your target renderer. |
| AO | Uses the Samples count. |
| Curvature | Writes convex (light) and concave (dark) detail, scaled to the range found on the model. |
| Cavity | Writes a cavity mask. |
| Transmission | Writes how thin the model is behind each point: bright where it is thin (ears, nostrils), dark where it is thick. Uses the Samples count. |
| Displacement | Writes a grayscale displacement PNG. Enable 32-bit float displacement (TIFF) to also write a TIFF. |
| Color | Uses the selected Color source. When that source is empty (no vertex colours, no texture), the Color map is skipped and the status bar says why. |
Skylight is available for AO and cavity.
Color sources are:
Vertex — OBJ or PLY vertex colors.
Mask — the painted reference mask.
Groups — imported material groups when present, otherwise connected components.
Texture — a loaded reference texture.
To use a texture, enter its path in the BAKE MAPS field and click Load. PNG, JPG, and TGA are supported. The Show texture checkbox in REFERENCE controls whether it is displayed. Texture display and transfer require an OBJ reference with UVs; without UVs, texture transfer is blank.
The baking cage#
The cage is the low poly pushed outward along its normals by Cage offset. The bake looks for the high poly from the cage, so the cage should lie just outside the high poly.
Turn on Show cage (under Cage offset) to see it: a see-through shell over the model. Drag the Cage offset value and the shell moves with it.
Green faces: the cage covers the high poly there.
Red faces: the high poly comes through the cage. The number beside Show cage counts them. Raise the offset until the red is gone, and no further: a cage that is too large can reach a neighbouring part.
At offset 0 the cage is the low poly itself, so most of it is red. That is normal. QuadPen takes the nearest point of the high poly rather than casting rays from the cage, so a bake at offset 0 works on most models. The cage matters where two surfaces lie close together, such as fingers or folds: there the nearest point can be on the wrong surface, and a small offset fixes it.
Shading: Smooth, Hard, By angle#
A tangent-space normal map only looks right on a mesh that is shaded the way it was during the bake. Shading in the Bake view's OUTPUT section sets that shading once, for the bake and for the exported file (the File → Export Low Poly… window shows the same setting):
| Shading | Meaning | Use for |
|---|---|---|
| Smooth | One normal per vertex. | Organic models: characters, creatures. |
| Hard | Every face flat. | Low-poly and blocky parts. |
| By angle | Smooth where two faces meet at less than Angle, hard above it. 30° is usual. | Hard-surface and mixed models. |
Hard at seams also splits the normals along UV seams (marked seams and the borders of UV islands). This is the usual rule for clean hard-surface bakes.
With Smooth on a hard-surface part, the normal map has to bend the shading back on every flat face next to a sharp edge: you see wide gradients in the map and dark shadows on the model in other programs. With By angle the flat faces stay flat and the map only holds the edges.
The exported OBJ, FBX, glTF / GLB and COLLADA files carry these normals, so Blender, Unreal, Unity and others show the mesh as it was baked without any setting on their side. PLY cannot store them. The tangents are computed the MikkTSpace way, as Blender, Unreal, Unity and Substance do; glTF and GLB also carry them. The setting is saved with the scene.
The green channel is OpenGL-style (Y+) as before; turn on Flip G for DirectX-style (Y−) targets such as Unreal.
Checking a bake on the model#
The Bake workspace shows the baked maps in a map view beside the 3D view. One button per baked map (Normal, AO, Curvature, …) picks the map to look at; only that one is shown. Under the image are its name, its size in pixels and the full path of the file, with Open folder and Copy path. Show on the low poly puts the picked map on the model in the 3D view, drawn with the low poly's UVs and light shading, so seams, smears and missed areas show where they are; turn it off to see the plain low poly. After a bake the view reloads by itself and shows the new normal map (or the map you were viewing). With UDIM tiles the first tile is shown.
The inspector's BAKED MAPS section shows Saved to, the folder the maps are written to, with Open folder, and a thumbnail of every map found there; click a thumbnail to pick that map. The maps go into the Folder shown in OUTPUT and are named after the low poly's export file (see Bake and output). Choose… next to the folder opens the system's folder window.
Bake and output#
Click Bake at the bottom of the inspector; it stays there while you scroll the settings. It needs a high poly and a low poly with faces, and the line under it says which one is missing. A progress card at the bottom left of the 3D view shows the maps being baked and the percentage. Maps are written into the Folder of OUTPUT, named after the low poly's export file:
<name>_normal.png<name>_ao.png<name>_curvature.png<name>_cavity.png<name>_transmission.png<name>_color.png<name>_displacement.png<name>_displacement.tiffwhen 32-bit float displacement is enabled
<name> is the name of the export file without its extension, and the folder is the folder of the export file. The Bake button's tooltip and the BAKED MAPS section both name the folder.
The status bar lists the files that were written. If the bake cannot find the reference surface within the search distance, increase Search or Cage offset and bake again.