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)