oracular (1) meshlabserver.1.gz

NAME

     meshlabserver — The open source batch mesh processing system

SYNOPSIS

     meshlabserver [-d output]
     meshlabserver [-l logfile] [-p projectfile] [-w outputprojectfile [-x]] [-i meshfile] ... [-o outfile
                   [-l opt_layer] [-m opt_mask]] [-s scriptfile]

DESCRIPTION

     meshlabserver allows batch-processing usage of functionality available in the interactive meshlab(1)
     application.

     The arguments are as follows:

     -d output
             dump on a text file a list of all the filtering functions

     -l logfile
             log of the filters is output on a file

     -p projectfile
             meshlab project ( .mlp ) to be loaded

     -w outputprojectfile [-x]
             output meshlab project (.mlp) to be saved.  If -x flag is specified, any 3D model file(s)
             meshfile.ext contained in the input project will be overwritten.  Otherwise, for an input filename
             of meshfile.ext, the model will be saved in the same directory of input mesh as a new file called
             meshfile_out.ext.  ALL the mesh attributes will be exported in the saved files.

     -i file
             mesh that has to be loaded

     -o outfile [-l opt_layer] [-m opt_mask]
             the name of the file where to write the current layer of the project.

             -l opt_layer
                     Save the specified layer to the chosen filename. Valid values for opt_layer can be

                     A number in the range [0, last_layer_in_the_project]
                             to indicate the desired layer by its index.

                     ‘c’     indicate the CURRENT layer in the project

                     ‘x’     indicate the LAST layer in the project

             -m opt_mask
                     the listed mesh attributes will be saved in the output file.  The parameter opt_mask can be
                     a space-separated list of the following attributes:

                     ‘vc’    vertex colors

                     ‘vf’    vertex flags

                     ‘vq’    vertex quality

                     ‘vn’    vertex normals

                     ‘vt’    vertex texture coords

                     ‘vr’    vertex radius

                     ‘fc’    face colors

                     ‘ff’    face flags

                     ‘fq’    face quality

                     ‘fn’    face normals

                     ‘wc’    wedge colors

                     ‘wn’    wedge normals

                     ‘wt’    wedge texture coords

                     ‘mp’    polygonal mesh info

                     ‘sa’    save in ascii format

     -s scriptfile
             the script to be applied.  Must be in the xml format saved by MeshLab.

NOTES

     There can be multiple meshes loaded and the order they are listed matters because filters that use meshes
     as parameters choose the mesh based on the order.

     The format of the output mesh is guessed by the used extension.

EXIT STATUS

     The meshlabserver utility exits 0 on success, and >0 if an error occurs.

EXAMPLES

     Apply the script contained in the file meshclean.mlx to the mesh contained in input.obj.  Save the per-
     vertex-color, the per-face-quality, and the per-wedge-texture attributes contained in the current layer
     into output.ply.
           $ meshlabserver -i input.obj -o output.ply -m vc fq wt -s meshclean.mlx

     Apply the script contained in the file meshclean.mlx to the mesh contained in input.obj.  Save the per-
     vertex-color, the per-face-quality and the per-wedge-texture attributes contained in the layer 2 (if it
     exists!) into output.ply.  Save the last layer of the project to output_last with the default geometric
     attributes.
           $ meshlabserver -i input.obj -o output.ply -l 2 -m vc fq wt -o output_last.ply -l l -s meshclean.mlx

     Apply the script contained in the file meshclean.mlx to the mesh composed of input0.obj and input1.ply.
     Make input1.ply the current mesh of the project (i.e. the mesh to which the filters operating on a single
     model will be applied).  Generate a new output project outproj.mlp containing references to input0.obj and
     input1.ply.  The files input0.obj and input1.ply will be overwritten.  A log will be written to
     logfile.txt.
           $ meshlabserver -l logfile.txt -p proj.mlp -i input.obj -w outproj.mlp -s meshclean.mlx

SEE ALSO

     meshlab(1)

AUTHOR

     Paolo Cignoni - Visual Computing Lab - ISTI - CNR