.. _bpy.types.RemeshModifier:

***************
Remesh Modifier
***************

The *Remesh* modifier is a tool for generating new mesh topology.
The output follows the surface curvature of the input, but its topology contains only quads.


Options
=======

.. figure:: /images/modeling_modifiers_generate_remesh_panel.png
   :align: right

   The Remesh modifier.

Mode
   There are three basic modes available in the *Remesh* modifier.
   The output topology is almost identical between the three modes, what changes is the smoothing.

   Blocks
      There is no smoothing at all.
   Smooth
      Output a smooth surface.
   Sharp
      Similar to *Smooth*, but preserves sharp edges and corners.

Octree Depth
   Sets the resolution of the output. Low values will generate larger faces relative to the input,
   higher values will generate a denser output.
Scale
   The result can be tweaked further by this, lower values effectively decrease the output resolution.
Sharpness
   Shown when using the *Sharp Mode*. Higher values produce edges more similar to the input,
   while lower values filter out noise.
Smooth Shading
   Output faces with smooth shading rather than flat shading.
   The smooth/flat shading of the input faces is not preserved.
Remove Disconnected Pieces
   Filter out small disconnected pieces of the output.

   Thin parts of the input mesh can become lose, and generate small isolated bits of mesh.
   This option will remove those.

   Threshold
      Use this to control how small a disconnected component must be to be removed.

.. note::

   The input mesh should have some thickness to it. If the input is completely flat,
   add a :doc:`Solidify Modifier </modeling/modifiers/generate/solidify>` above the *Remesh* one.


Examples
========

.. list-table::

   * - .. figure:: /images/modeling_modifiers_generate_remesh_example-none.png
          :width: 320px

          Unmodified mesh.

     - .. figure:: /images/modeling_modifiers_generate_remesh_example-blocks-depth-3.png
          :width: 320px

          Blocks mode with Octree Depth 3.

     - .. figure:: /images/modeling_modifiers_generate_remesh_example-smooth-depth-3.png
          :width: 320px

          Smooth mode with Octree Depth 3.

   * - .. figure:: /images/modeling_modifiers_generate_remesh_example-sharp-depth-2.png
          :width: 320px

          Sharp mode with Octree Depth 2.

     - .. figure:: /images/modeling_modifiers_generate_remesh_example-sharp-depth-3.png
          :width: 320px

          Sharp mode with Octree Depth 3.

     - .. figure:: /images/modeling_modifiers_generate_remesh_example-sharp-depth-4.png
          :width: 320px

          Sharp mode with Octree Depth 4.

.. figure:: /images/modeling_modifiers_generate_remesh_example-text-topology.png
   :width: 520px

   The Remesh Modifier applied to a text to improve its topology.

.. youtube:: Mh-gUnS2c0Y

.. vimeo:: 21096739