Provided by: mia-tools_2.4.7-13_amd64 
NAME
mia-meshfilter - Run filters on a 3D mesh.
SYNOPSIS
mia-meshfilter -i <in-file> -o <out-file> [options] <PLUGINS:mesh/filter>
DESCRIPTION
mia-meshfilter This program runs a series filters on a given input mesh. The filters are
given as extra parameters on the command line and are run in the order in which they are
given. To obtain a list of available filters you may run
'mia-plugin-help mesh/filter' from the command line
OPTIONS
-i --in-file=(input, required); io
input mesh to be filtered
For supported file types see PLUGINS:mesh/io
-o --out-file=(required, output); io
output mesh that have been filtered
For supported file types see PLUGINS:mesh/io
Help & Info
-V --verbose=warning
verbosity of output, print messages of given level and higher priorities.
Supported priorities starting at lowest level are:
trace ‐ Function call trace
debug ‐ Debug output
info ‐ Low level messages
message ‐ Normal messages
warning ‐ Warnings
fail ‐ Report test failures
error ‐ Report errors
fatal ‐ Report only fatal errors
--copyright
print copyright information
-h --help
print this help
-? --usage
print a short help
--version
print the version number and exit
Processing
--threads=-1
Maxiumum number of threads to use for processing,This number should be lower
or equal to the number of logical processor cores in the machine. (-1:
automatic estimation).
PLUGINS: mesh/filter
addscale This filter sorts sets the scale parameter for each vertex from a 3D image.
Image and mesh are expected to be in the same physical coordinate space.,
supported parameters are:
img =(required, string)
3DImage that contains the scale values as a volume image..
deltribynormal
This filter deletes all triangles that have a normal that differs by the given
angle from the provided direction., supported parameters are:
angle = 5; float
Tolerance angle (in degree) that the normal can diviate from the provided
direction..
dir =(required, 3dfvector)
Direction the triangle normals are expected to point to. The orientation
of the vector is taken into account..
scale This plug-in provides a filter to scale triangulat meshes by a given strategy,
supported parameters are:
anisoscale = [[1,1,1]]; 3dfvector
Ansiotropic scaling parameter..
box-end = [[256,256,256]]; 3dfvector
Box end for fitbox scaling..
box-start = [[0,0,0]]; 3dfvector
Box start for fitbox scaling..
isoscale = 1; float
Isotropic scaling parameter..
shift = [[0,0,0]]; 3dfvector
Shift mesh after scaling..
strategy = iso-linear; dict
Isotropic scaling parameter.. Supported values are:
iso-linear ‐ Scale and shirt the mesh by scaling it isotropically as
given by parameter 'isoscale' and apply a shift as given by parameter
'shift'
aniso-linear ‐ Scale and shirt the mesh by scaling it anisotropically
as given by parameter 'anisoscale' and apply a shift as given by
parameter 'shift'
iso-fitbox ‐ Fit the mesh into the given box by shifting it and apply
isotropic scaling. The box is given by the parameters 'box-start' for
upper, left, frontal corner, and 'box-end' for the lower, right back
corner
aniso-fitbox ‐ Fit the mesh into the given box by shifting it and
apply anisotropic scaling. The box is given by the parameters 'box-
start' for upper, left, frontal corner, and 'box-end' for the lower,
right back corner
selectbig This filter selects the component with the highest number of triangles from a
mesh that is actually composed of disconnected components. Components are
considered to be disconnected if they don't share a common edge (they might
share a common vertex though
(no parameters)
vtxsort This filter sorts the vertices of a mesh according to the given direction.
Specifically, the dot product between the given direction and the vertices will
be ordered ascending, supported parameters are:
dir = [[0,0,1]]; 3dfvector
Sorting direction,.
PLUGINS: mesh/io
datapool Virtual IO to and from the internal data pool
Recognized file extensions: .@
off plugin to load/store some Geomview OFF files. Supported is only the ASCII format
3D meshes with normales and per-vertex RGB colors. Alpha values and texture
coordinates, as well as per face properties are ignored. Polygons are read and
triangulated.
Recognized file extensions: .OFF, .off
ply Ply triangle mesh input/output support
Recognized file extensions: .PLY, .ply
stl STL mesh io plugin
Recognized file extensions: .STL, .stl
vista Vista/Simbio triangle mesh input/output support
Recognized file extensions: .-, .V, .VMESH, .v, .vmesh
vtk A subset of VTK mesh in-and output: Triangle meshes are written, and triangle
meshes and triangle strips are read. Additional per-vertex attributes are
supported: 'normals', 'colors' for three component colors, and 'scale' for a
scalar value attached to each vertex. The data is written by the
vtkPolyDataWriter in binary format.
Recognized file extensions: .VTK, .VTKMESH, .vtk, .vtkmesh
EXAMPLE
Run an isotropic scaling on input.vmesh to fit it into the box defined by the corners
<0,0,0> - <128,128,128> and save the result to output.vmesh
mia-meshfilter -i input.vmesh -o output.vmesh
scale:strategy=iso-fitbox,box-start=[<0,0,0>],box-end=[<128,128,128>]
AUTHOR(s)
Gert Wollny
COPYRIGHT
This software is Copyright (c) 1999‐2015 Leipzig, Germany and Madrid, Spain. It comes
with ABSOLUTELY NO WARRANTY and you may redistribute it under the terms of the GNU
GENERAL PUBLIC LICENSE Version 3 (or later). For more information run the program with the
option '--copyright'.