**********
Retopology
**********

Retopology is the process of simplifying the topology of a mesh to make it cleaner and easier to work with.
Retopology is need for mangled topology resulting from sculpting or generated topology, for example from a 3D scan.
Meshes often need to be retopologized if the mesh is going to be deformed in some way.
Deformations can include rigging or physics simulations such as cloth or soft body.
Retopology can be done by hand by manipulating geometry in Edit Mode or through automated methods.


Using the Poly Build Tool
=========================

Todo 2.81.


.. _bpy.types.Mesh.remesh:
.. _bpy.ops.object.voxel_remesh:
.. _bpy.ops.object.quadriflow_remesh:

Remeshing
=========

.. admonition:: Reference
   :class: refbox

   :Mode:      Object Mode, Sculpt Mode
   :Panel:     :menuselection:`Properties --> Object Data --> Remesh`

Remeshing is a technique that automatically rebuilds the geometry with a more uniform topology.
Remeshing can either add or remove the amount of topology depending on a defined resolution.
This technique is especially useful for :doc:`sculpting </sculpt_paint/sculpting/index>`,
to generate better topology after blocking out the initial shape.

.. seealso::

   :doc:`Remesh modifier </modeling/modifiers/generate/remesh>`


Voxel
-----

The Voxel Remesher uses an OpenVDB to generate a new manifold mesh from the current geometry.
It produces a mesh with perfectly even distributed topology and
it does not have any performance penalty once the new mesh is calculated.
This makes the voxel remesher great for sculpting has it is possible to
sculpt at a much higher level of detail than using other features
like dyntopo which often adds more performance overhead.

Voxel Size
   The resolution or the amount of detail the remeshed mesh will have.
   The value is used to define the size, in object space, of the :term:`Voxel`.
   These voxels are assembled around the mesh and are used to determine the new geometry.
   For example a value of 0.5m will create topological patches that are about 0.5m
   (assuming *Preserve Volume* is enabled).
   Lower values preserve finer details but will result in a mesh with a much more dense topology.

Adaptivity
   Todo 2.81.
Fix Poles
   Todo 2.81.
Smooth Normals
   Applies the :ref:`Smooth Normals <bpy.ops.object.shade_smooth>` operator to the resulting mesh.

Preserve Volume
   Todo 2.81.
Preserve Paint Mask
   Todo 2.81.
Voxel Remesh
   Todo 2.81.


Quad
----

Quadriflow Remesh
   Todo 2.81.
Use Paint Symmetry
   Todo 2.81.
Preserve Sharp
   Todo 2.81.
Preserve Mesh Boundary
   Todo 2.81.
Use Mesh Curvature
   Todo 2.81.
Preserve Paint Mask
   Todo 2.81.
Smooth Normals
   Applies the :ref:`Smooth Normals <bpy.ops.object.shade_smooth>` operator to the resulting mesh.

Modes
   Todo 2.81.
Number of Faces
   Todo 2.81.