A suite of retopology tools for Blender

RetopoFlow Warnings

RetopoFlow might present a warning if it detects a situation which is not ideal to start in.

Setup: Source / Target Meshes

RetopoFlow requires at least source mesh to start. A source mesh can be any visible mesh that is not being edited.

RetopoFlow assumes that the edited mesh is the target mesh. If the edited mesh is not visible, RetopoFlow cannot start.

See Quick Start Guide for more details.

Setup: Non-Invertible Matrix

RetopoFlow is designed to work with sources and targets that have invertible transformation matrices. RetopoFlow will warn if a source object or the target object has a transformation matrix that is not invertible (ex: one of the scale transform values is near 0).

While RetopoFlow will still start and operate when an object has a non-invertible matrix, the results and behaviors are undefined.

Layout: Quad View / Multiple 3D Views

RetopoFlow is designed to work in a single 3D view. Running RetopoFlow with Quad View turned on or with multiple 3D Views can result in RetopoFlow showing up in every 3D View, but only allowing interaction in one.

If either Lock to Object or Lock to 3D View are enabled, navigating in RetopoFlow can be incorrect. Disable either of these settings in the 3D View Sidebar (N) before starting RetopoFlow.

View Locks

Auto Save / Save

If Blender’s auto save is disabled, any work done since the last time you saved can be lost if Blender crashes. To enable auto save, go Edit > Preferences > Save & Load > Auto Save.

If you are working on an unsaved blend file, your changes will be saved to a temporary file (see path below) when you press Ctrl+S.

Temporary file path: {options.get_auto_save_filepath()}

Performance: Target/Sources Too Large

RetopoFlow is designed to perform well on typical production retopology scenarios. Running RetopoFlow on source/target meshes beyond a reasonable range is possible, but it will result in slower performance and a poorer experience.

A typical retopology workflow would involve <1m polygons in total for all source meshes and <20k polygons for the target mesh. That’s the point at which Blender starts to slow down, and there’s not a lot we can do to be faster than Blender itself.

If your retopology target polygon count exceeds the 20k count threshold, please try the following:

If your total source mesh(es) polygon count exceeds the 1m count threshold, try the following:

Inverted Normals

If a source mesh is detected to have inward facing normals, RetopoFlow will report a warning. Inward facing normals will cause new geometry to be created incorrectly or to prevent it from being selected.

Possible fix: exit RetopoFlow, switch to Edit Mode on the source mesh, recalculate normals, then try RetopoFlow again.