NAME

       meshfix - a surface mesh cleaning and repairing utility

SYNOPSIS

       meshfix <file1> [<file2>] [OPTIONS]

DESCRIPTION

       Meshfix  is  a  surface  mesh repairing and cleaning tool. It was written by Marco Attene,
       Mirko Windhoff, Axel Thielscher. The details regarding this tool can be found in the below
       paper

       M.  Attene  -  A  lightweight  approach to repairing digitized polygon meshes.  The Visual
       Computer, 2010. (c) Springer.

       Meshfix processes file1 and saves the result to <file1>_fixed.off.  An  optionally  passed
       file2 is merged with the first one.

       Accepted input formats are OFF, PLY and STL.

OPTIONS

       This program accepts the following input parameters:

       -a <epsilon_angle>
              Allowed range: 0 < epsilon_angle < 2, default: 0 (degrees)

       -j     Join 2 biggest components if they overlap, remove the rest.

       -jc    Join the closest pair of components.

       -h|(--help)
              Print this help and exit.

       --shells <n>
              Only the n biggest shells are kept.

       -o <output>
              Set the output filename (without extension).

       -q     Quiet mode, don't write much to stdout.

       -u <steps>
              Uniform remeshing of the whole mesh, steps > 0

       --vertices <n>
              Constrain number of vertices to n (only with -u)

       --no-clean
              Don't clean.

       --smooth <n>
              Apply n laplacian smoothing steps.

       -s|(--stl)
              Result is saved in STL     format instead of OFF.

       -w|(--wrl)
              Result is saved in VRML1.0 format instead of OFF.

       --fsmesh <n>
              Result is saved in FreeSurfer format instead of OFF.

       --xshift <d>
              Shift x-coordinates of vertices by d when saving output.  Only works with --fsmesh;
              used to deal with small FreeSurfer glitch

       --msh  Result is saved in gmsh format for debugging (including vertex and triangle masks)

       --cut-outer <d>
              Remove triangles of 1st that are outside of the 2nd shell.

       --cut-inner <d>
              Remove triangles of 1st that are inside  of the 2nd shell.  Dilate 2nd by  d;  Fill
              holes and keep only 1st afterwards.

       --decouple-inin <d>
              Treat  1st  file as inner, 2nd file as outer component.  Resolve overlaps by moving
              inners triangles inwards.

       --decouple-outin <d>
              Treat 1st file as outer, 2nd file as inner component.  Resolve overlaps  by  moving
              outers triangles inwards.

       --decouple-outout <d>
              Treat  1st  file as outer, 2nd file as inner component.  Resolve overlaps by moving
              outers triangles outwards.  Constrain the min distance between the components > d.

       --fineTuneIn <d> <n>
              Used to fine-tune the minimal distance between surfaces A  minimal  distance  d  is
              ensured,  and  reached  in n substeps When using the surfaces for subsequent volume
              meshing by gmsh this step prevent too flat tetrahedra

       --fineTuneOut <d> <n>
              Similar to --fineTuneIn, but  ensures  minimal  distance  in  the  other  direction
              --dilate  <d>  Dilate  the surface by d. d < 0 means shrinking.  --intersect If the
              mesh contains intersections, return value = 1.  --intersect  -o  fname.msh  If  the
              mesh  contains  intersections,  return  value  =  1.   In  addtion,  save mesh with
              highlighted intersections in Gmsh format

SEE ALSO

       cgalmesh(7), cgalsurf(7), cgalsimp2(7), cgalpoly(7), cork(7), jmeshlib(7)

AUTHOR

       Marco Attene (attene@ge.imati.cnr.it), Mirko Windhoff, Axel Thielscher and  Qianqian  Fang
       (fangqq@gmail.com)