Scroll to navigation

mia-meshfilter(1) USER COMMANDS mia-meshfilter(1)

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)
input mesh to be filtered For supported file types see PLUGINS:mesh/io
-o --out-file=(output,required)
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:
info ‐ Low level messages
trace ‐ Function call trace
fail ‐ Report test failures
warning ‐ Warnings
error ‐ Report errors
debug ‐ Debug output
message ‐ Normal messages
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
--help-filters
give some help about the filter plugins

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

scale
This plug-in provides a filter to scale triangulat meshes by a given strategy, supported parameters are:
anisoscale = [[1,1,1]] (streamable)
Ansiotropic scaling parameter..
box-end = [[256,256,256]] (streamable)
Box end for fitbox scaling..
box-start = [[0,0,0]] (streamable)
Box start for fitbox scaling..
isoscale = 1 (streamable)
Isotropic scaling parameter..
shift = [[0,0,0]] (streamable)
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'
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-linear ‐ Scale and shirt the mesh by scaling it anisotropically as given by parameter 'anisoscale' and apply a shift as given by parameter 'shift'
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
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]] (streamable)
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
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‐2013 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'.
17 October 2014 2.0.10