Manual for QuadPen 0.14.0

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:

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:

  1. 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.

  2. 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.

  3. 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.

  4. 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.

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.

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.

Measured on the test models (density spread = how far 90% of faces stay from the typical texel density, in doublings of area):

ModelFacesIslandsMap usedDensity spreadTime
Hard-surface part431468%±0.02instant
Head4,9481353%±0.181.3 s
Body55,8083953%±0.1432 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

Seams

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

Arrange

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.

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:

SettingBehavior
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-faceOne 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.

MapNotes
NormalEnable World space, or Flip R / G, as needed for your target renderer.
AOUses the Samples count.
CurvatureWrites convex (light) and concave (dark) detail, scaled to the range found on the model.
CavityWrites a cavity mask.
TransmissionWrites how thin the model is behind each point: bright where it is thin (ears, nostrils), dark where it is thick. Uses the Samples count.
DisplacementWrites a grayscale displacement PNG. Enable 32-bit float displacement (TIFF) to also write a TIFF.
ColorUses 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:

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.

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):

ShadingMeaningUse for
SmoothOne normal per vertex.Organic models: characters, creatures.
HardEvery face flat.Low-poly and blocky parts.
By angleSmooth 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> 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.