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

.. figure:: /images/modeling_modifiers_generate_remesh_screenshot-00.png
   :width: 600px


Options
=======

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

   .. figure:: /images/modeling_modifiers_generate_remesh_mode-cone-example.png

      This example shows a cone with each of the different remesh modes.
      From left to right: original cone, 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.

   .. figure:: /images/modeling_modifiers_generate_remesh_depth-cone-example.png

      Input mesh, and the low to high resolution output meshes.

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 to be removed.

   .. figure:: /images/modeling_modifiers_generate_remesh_remove-disconnected-example.png

      The input mesh (left) is fairly noisy,
      so the initial output of the Remesh Modifier (center) contains small disconnected pieces.
      Enabling Remove Disconnected Pieces (right) deletes those faces.


Usage
=====

In the Modifier panel, add a Remesh Modifier.
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
========

.. figure:: /images/modeling_modifiers_generate_remesh_text-00.png

   Remesh Modifier applied to text to improve topology.

.. only:: builder_html and (not singlehtml)

   .. youtube:: Mh-gUnS2c0Y

   .. vimeo:: 21096739

.. only:: not builder_html and (singlehtml)

   A video can be found at https://www.youtube.com/watch?v=Mh-gUnS2c0Y and https://vimeo.com/21096739