QuadFix documentation

QuadFix panel reference: every option

Reference for every QuadFix control in Blender: Only Selected, Select Non-Quads & Holes, Fill Holes, Bridge, N-gons to Quads, Clean & Quad and Union to Quads.

Layout of the tab

The QuadFix tab in the 3D viewport sidebar (N) has three panels, from top to bottom:

  1. QuadFix: the Edit Mode tools, described below.
  2. Union (Object Mode): the Union to Quads tool.
  3. QuadFix v1.4.5: a footer with the version and the result of the last operation. Before any run it reads Last result: none yet.

In Object Mode the first panel shows Edit Mode tools: press Tab and its controls are greyed out. In Edit Mode the union panel shows Object Mode tool: press Tab and is greyed out. Every tool therefore stays visible, but only the ones that fit the current mode can be pressed.

All operations are normal Blender undo steps.

Only Selected

ControlWhat it doesDefault
Only SelectedRestricts the tools to the selected geometry. Off means the whole mesh.On

It applies to Fill Holes, N-gons to Quads and Clean & Quad. Select Non-Quads & Holes always looks at the whole mesh, and Bridge to Quads always uses the selected edges.

Select Non-Quads & Holes

ControlWhat it doesDefault
Select Non-Quads & HolesClears the selection, then selects every face that is not a quad (triangles and n-gons) and every boundary edge (open hole edges). The counts appear in the footer as N non-quad faces, N boundary edges.Button

Use it first to see what needs work, and again at the end to check what remains. Note that the outer rim of an open sheet counts as boundary edges too.

Holes

ControlWhat it doesDefault and range
Fill Holes with QuadsFills open holes and closed boundary loops with quads. It grows a grid across the hole, relaxes it onto the surface around it and checks the result for folds. Gaps between two loops (for example a cut band) are bridged. Odd loops are handled.Button
Grid SpanNumber of grid columns used for the grid fill. 0 lets QuadFix choose.0, minimum 0
Match Triangle MeshesWhen at least 70 percent of the faces around the filled area are triangles (a scan), the new patch is triangulated too, so it blends in. Turn it off to keep quads.On

What gets filled: with Only Selected on, a hole is filled only when its whole boundary loop is selected. A half-selected loop is skipped and counted in the report. The outer border of a flat open sheet, such as a plane, terrain or cloth, is skipped as not being a hole. Round holes on curved surfaces, band cuts, stepped holes and rings between two loops are rebuilt as grids.

The footer reads, for example, Filled 2 loop(s). Now: 1480 quads / 12 tris / 0 n-gons. If nothing qualifies you see No boundary edges (holes) in selection or Nothing to fill: with the reason (outer borders, partly selected holes).

Fill Holes fills every fully selected closed loop, including openings you may not think of as holes, such as eye sockets on a character mesh. Select only the holes you want.

Bridge

ControlWhat it doesDefault and range
Bridge to QuadsConnects two selected edge loops, or two selected open edge chains, with a strip of quads. Needs Edge select mode. Works with unequal edge counts up to 4 to 1.Button
Auto CutsAdds loops between the two sides so the quads come out roughly square.On
CutsNumber of loops added between the sides. Only used when Auto Cuts is off.0, range 0 to 64
Smoothness0 keeps the rows between the sides straight. 1 lets them follow the curvature of the surface around them.0, range 0 to 1

The three options appear in Blender's Adjust Last Operation panel after you run Bridge to Quads, so you can change them and see the result update. The panel itself shows the hint Select two edge loops or chains.

Notes on how it behaves:

  • Both sides must be the same kind: two closed loops or two open chains.
  • Where the counts differ, quads are reduced in rows of up to 3 to 1. A bigger ratio gets extra rows in between. If the total number of edges on both sides is odd, one triangle is unavoidable and it is selected with the strip.
  • On tubes the default straight strip (Smoothness 0) is the cleanest. Raise Smoothness where the two sides are tilted against each other. If a smoothed strip would fold, QuadFix falls back to the straight strip and says so in the report.
  • The result is checked for non-quads, non-manifold edges, zero-area faces, folds, twists and inconsistent winding. If a check fails, the strip is removed and the edges that caused the problem are selected.
  • Material and smooth shading of the new faces are copied from the faces beside each side.
  • A closed loop of only three edges cannot take a quad strip. Close it with Fill Holes instead.

The footer reads, for example, Bridge: 48 quads between 24 and 24 edges, 3 row(s), 0 reduction(s).

Quads

ControlWhat it doesDefault and range
N-gons to QuadsTriangulates the selected triangles and n-gons and joins the triangles into quads.Button
Face AngleLargest angle between the normals of two triangles that may be joined into a quad.90 degrees, range 0 to 180
Shape AngleLargest deviation from a rectangle that is accepted for a new quad.90 degrees, range 0 to 180
Keep Planar N-gonsLeaves flat n-gons alone. Only curved n-gons and triangles are converted. Turn it off for scans.On
Aggressive QuadsJoins any two triangles into a quad regardless of angle. Fewest triangles, less regular shapes.Off

Lower the two angles to get more regular quads and more leftover triangles. Raise them, or switch on Aggressive Quads, to get fewer triangles.

A large n-gon that came from dissolving a rectangular patch of a grid (a clean rectangle of at least 8 corners with equal opposite sides) is opened and refilled like a hole, so the grid is rebuilt instead of turning into a diamond pattern. If that fill fails, the n-gon is put back and converted the usual way.

The footer reads, for example, n-gons 4→0, tris 120→8, quads 300→412. With nothing to do you see Nothing to convert (all quads or flat n-gons).

Boolean / Import Cleanup

ControlWhat it doesDefault and range
Clean & Quad (Boolean Prep)Runs the cleanup chain described below.Button
Merge DistanceVertices closer than this are merged. Also the threshold for removing degenerate geometry.0.0001, minimum 0, shown with 5 decimals
Dissolve AngleAngle for the limited dissolve.5 degrees, range 0 to 90
Keep Sharp EdgesDoes not dissolve edges marked sharp or seam.On

The Face Angle, Shape Angle, Keep Planar N-gons and Aggressive Quads options from the Quads box also apply to the triangle-joining step of Clean & Quad.

In order, Clean & Quad:

  1. Merges doubles within Merge Distance.
  2. Dissolves degenerate geometry and deletes loose edges and vertices.
  3. Applies a limited dissolve at the Dissolve Angle, only around triangles and n-gons and open edges. Between two quads the grid is already clean and is left alone, and triangle fans at poles of spheres and cylinder caps are recognised as clean and kept.
  4. Triangulates the remaining non-quads and joins them into quads. Flat n-gons that were already in the mesh stay when Keep Planar N-gons is on, while n-gons created by the dissolve are always converted.
  5. Recalculates the face normals.

The footer reads, for example, verts 5200→4980, quads 3100→3720, tris 940→210, n-gons 55→0.

Union (Object Mode)

ControlWhat it doesDefault and range
Union to QuadsNeeds at least two selected mesh objects. The active object stays and receives the others. Runs an exact Boolean union and rebuilds every seam as a strip of quads.Button
RingsNumber of face rings removed around the seam before it is rebuilt. Auto tries 1, 2 and 3 and keeps the cleanest result.Auto, or 1, 2, 3
Max Shape Change %Largest distance the rebuilt seam may move from the plain Boolean surface, in percent of the object size. A seam that would move more is rejected and stays a plain Boolean.2.0, range 0.1 to 20
Keep Originals HiddenHides the other selected objects instead of deleting them.On

The three options appear in Adjust Last Operation after the run. The panel itself shows Select 2+ meshes, the active one stays.

How it works: each object gets its own marker materials during the Boolean so that the seam is exactly where faces from different objects meet. Materials are restored afterwards. The result replaces the mesh of the active object (the new mesh is named after the old one with _union at the end). The other objects are hidden, and Object > Show/Hide > Reveal Hidden (Alt+H) brings them back.

The footer reads, for example, Union: 2 seam loop(s) rebuilt. Mesh: quads 1820, tris 6, n-gons 0. If some seams could not be rebuilt cleanly the text adds N left as plain boolean and the message is a warning.

Limits: UVs are not generated for the new strip. Seams that run through holes in your input are skipped. On very dense meshes with different density on the two sides the strip is all quads but zig-zags. Closed, overlapping meshes work best.

Where to go next

Install QuadFix in Blender
Previous page
QuadFix workflows: step-by-step recipes
Next page