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

   Remesh Modifier panel.

Mode
   There are three basic modes available in the Remesh Modifier: Blocks, Smooth and Sharp.

   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.
      In the above image, the circular bottom of the cone and the top
      point of the cone are more accurately reproduced in Sharp mode.

Octree Depth
   The 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 setting the Scale;
   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.

   Threshold
      Use this to control how small a disconnected component must 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 Modifier.


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