Convert to Mesh
=======================

The algorithm converts a depth image into a mesh

Input
-----

Takes one to three 2D image set(s) as input. The first image set must be representing depth data, i.e. it must contain float single channel images.  
The second image set is an optional set of corresponding RGB/greyscale images, only data of unsigned char or unsigned short type is supported.
Both image sets need a :ref:`camera calibration data component<cameracalibrationdatacomponent>`. When depth and color are provided together, an optional :ref:`RGB-D calibration data component<rgbdcalibrationdatacomponent>` on the color set supplies the depth-to-color transform; otherwise it is derived from the camera poses.
Third image set is also optional but recommended to provide as input. This image is used to mask out background regions (identified by pixels contain zeros) in the depth map before meshing.  


Output
------

Mesh, possibly with colored vertices

Description
-----------

The algorithm takes depth, color (optional) and mask(optional) images and converts them to mesh. It has following parameters:

**decimateEdgeDist** — the resulting mesh is decimated (simplified) through this parameter. Mesh edges above this value are not simplified.

**decimatePreserveColors** — whether to try to preserve colors during decimation.

**maxEdgeDist** — the algorithm performs triangulation on the 2D grid. This value is the maximum distance between vertices (pixels) for them to be treated as neighbours during triangulation.