mirror of
https://github.com/lucaspalomodevelop/meshlab.git
synced 2026-03-13 16:14:38 +00:00
Merge pull request #556 from oleg-alexandrov/master
Update the documentation
This commit is contained in:
Alessandro Muntoni
GitHub
commit
f91ec79881
@ -9,11 +9,9 @@
|
||||
|
||||
This is the official repository for the sources and the binaries of MeshLab.
|
||||
|
||||
MeshLab is an open source, portable, and extensible system for the processing and editing of unstructured large 3D triangular meshes. The source is released under the GPL license.
|
||||
The system is aimed to help the processing of the typical not-so-small unstructured models arising in 3D scanning, providing a set of tools for editing, cleaning, healing, inspecting, rendering and converting this kind of meshes.
|
||||
MeshLab is an open source, portable, and extensible system for the processing and editing of unstructured large 3D triangular meshes. The source is released under the GPL license. The system is aimed to help the processing of the typical not-so-small unstructured models arising in 3D scanning, providing a set of tools for editing, cleaning, healing, inspecting, rendering and converting this kind of meshes. These tools include MeshLab proper, a versatile program with a graphical user interface, and [meshlabserver](https://github.com/cnr-isti-vclab/meshlab/blob/master/src/meshlabserver/meshlabserver.txt), a program that can perform mesh processing tasks in batch mode, without a GUI.
|
||||
|
||||
MeshLab is mostly based on the open source C++ mesh processing library [VCGlib](http://www.vcglib.net) developed at the [Visual Computing Lab](http://vcg.isti.cnr.it) of [ISTI - CNR](http://www.isti.cnr.it) for all the core mesh processing tasks, and it is available for Windows, MacOSX, and Linux.
|
||||
|
||||
Compiling instructions can be found in the [src](https://github.com/cnr-isti-vclab/meshlab/tree/master/src) folder or simply looking at the continous integration setup on [Github Actions](https://github.com/cnr-isti-vclab/meshlab/actions), [travis](https://travis-ci.org/cnr-isti-vclab/meshlab/builds) and [appveyor](https://ci.appveyor.com/project/cignoni/meshlab/history).
|
||||
|
||||
|
||||
|
||||
@ -1,78 +0,0 @@
|
||||
Meshlab Linux Howto
|
||||
|
||||
Requirements:
|
||||
Qt 4.x.x
|
||||
lib3ds (lib3ds.sf.net)
|
||||
GLEW (glew.sf.net)
|
||||
VCG (vcg.sf.net)
|
||||
|
||||
To compile meshlab on linux you need the development packages of the above libreries. Qt, lib3ds and glew are probably packaged with your distribution. On Debian for example you must install them with
|
||||
|
||||
apt-get install libglew-dev libqt4-dev lib3ds-dev
|
||||
|
||||
VCG library (from vcg.sf.net) instead is distributed only in source form . In order to download this library you can follow SourceForge CVS instructions. For example :
|
||||
|
||||
mario@ath64:~/src$ cvs -d:pserver:anonymous@vcg.cvs.sourceforge.net:/cvsroot/vcg login
|
||||
Logging in to :pserver:anonymous@vcg.cvs.sourceforge.net:2401/cvsroot/vcg
|
||||
CVS password: [empty password]
|
||||
|
||||
mario@ath64:~/src$ cvs -z3 -d:pserver:anonymous@vcg.cvs.sourceforge.net:/cvsroot/vcg co -P vcg
|
||||
cvs checkout: Updating vcg
|
||||
cvs checkout: Updating vcg/apps
|
||||
cvs checkout: Updating vcg/apps/borland
|
||||
U vcg/apps/borland/metro.bpf
|
||||
...
|
||||
[other files]
|
||||
...
|
||||
|
||||
Now you have the VCG library source files downloaded in local (in this example ~/src/vcg), however
|
||||
the VCG directory must be at the same level of meshlab directory and named "sf". This can be a symbolic link, as
|
||||
in this case :
|
||||
|
||||
mario@ath64:~/src$ ls -l sf
|
||||
lrwxrwxrwx 1 mario mario 3 2005-10-19 19:59 sf -> vcg
|
||||
|
||||
Alternatively you can rename vcg directory to sf.
|
||||
|
||||
Now you can download meshlab either from CVS or from sources (the instructions to get sources from CVS are similar to VCG ones). Place meshlab sources at the same level of "sf" directory, for example:
|
||||
|
||||
mario@ath64:~/src$ ls -l -d meshlab sf
|
||||
drwx------ 7 mario mario 200 2005-12-22 15:02 meshlab
|
||||
lrwxrwxrwx 1 mario mario 3 2005-10-19 19:59 sf -> vcg
|
||||
|
||||
- Compilation, Plugins
|
||||
|
||||
First you need to compile plugins, so switch to meshlab/src/meshlabplugins directory:
|
||||
|
||||
mario@ath64:~/src/meshlab/src$ cd meshlabplugins/
|
||||
mario@ath64:~/src/meshlab/src/meshlabplugins$ ls
|
||||
CVS meshdecorate meshio meshrender
|
||||
dummy meshcolorize meshfilter meshlabplugins.pro
|
||||
|
||||
the run qmake to create the Makefile
|
||||
|
||||
mario@ath64:~/src/meshlab/src/meshlabplugins$ ls
|
||||
CVS Makefile meshdecorate meshio meshrender
|
||||
dummy meshcolorize meshfilter meshlabplugins.pro
|
||||
|
||||
now run make to build the plugins in ../meshlab/plugins directory
|
||||
(in this example ~/src/meshlab/src/meshlab/plugins)
|
||||
|
||||
When the compilation process finishes you should have the following files in ../meshlab/plugins
|
||||
|
||||
libmeshfilter.so
|
||||
libmeshcolorize.so
|
||||
libmeshio.so
|
||||
libmeshdecorate.so
|
||||
libmeshrender.so
|
||||
|
||||
- Compilation, Meshlab
|
||||
|
||||
After compiling plugins, compile the main program (stored in directory ~/src/meshlab/src/meshlab in this example):
|
||||
|
||||
mario@ath64:~/src/meshlab/src/meshlab$ qmake
|
||||
mario@ath64:~/src/meshlab/src/meshlab$ make
|
||||
|
||||
Now you should have an executable file named meshlab in the current directory. Let's start it:
|
||||
|
||||
mario@ath64:~/src/meshlab/src/meshlab$ ./meshlab
|
||||
@ -1,26 +0,0 @@
|
||||
.TH MeshLab Version 1.2.0
|
||||
.SH NAME
|
||||
MeshLab - a tool for mesh inspection, processing, and conversion
|
||||
.SH SYNOPSYS
|
||||
meshlab [filename]
|
||||
.SH DESCRIPTION
|
||||
MeshLab is an open source, portable, and extensible system for the processing and editing of unstructured 3D triangular meshes.
The system is aimed to help the processing of the typical not-so-small unstructured models arising in 3D scanning, providing a set of tools for editing, cleaning, healing, inspecting, rendering and converting this kind of meshes.
The system is based on the VCG library developed at the Visual Computing Lab of ISTI - CNR.
|
||||
.SH SEE ALSO
|
||||
meshlabserver (1)
|
||||
|
||||
.SH COPYRIGHT
|
||||
MeshLab Copyright \(co 2005-2008 by Visual Computing Lab - ISTI CNR
|
||||
.PP
|
||||
This program is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation; either version 2 of the License, or (at
|
||||
your option) any later version.
|
||||
.PP
|
||||
This program is distributed in the hope that it will be useful, but
|
||||
WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||||
General Public License for more details.
|
||||
.PP
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program; if not, write to the Free Software
|
||||
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
||||
@ -1,53 +0,0 @@
|
||||
MESHLAB(1)
|
||||
==========
|
||||
|
||||
NAME
|
||||
----
|
||||
meshlab - a tool for mesh inspection, processing, and conversion
|
||||
|
||||
|
||||
SYNOPSIS
|
||||
--------
|
||||
meshlab [-h] [--help] [meshfile]
|
||||
|
||||
|
||||
DESCRIPTION
|
||||
-----------
|
||||
MeshLab is an open source, portable, and extensible system for the
|
||||
processing and editing of unstructured 3D triangular meshes. The system is
|
||||
aimed to help the processing of the typical not-so-small unstructured models
|
||||
arising in 3D scanning, providing a set of tools for editing, cleaning,
|
||||
healing, inspecting, rendering and converting this kind of meshes.
|
||||
The system is based on the VCG library developed at the Visual Computing Lab
|
||||
of ISTI - CNR.
|
||||
|
||||
|
||||
OPTIONS
|
||||
-------
|
||||
-h, --help::
|
||||
Show summary of options.
|
||||
|
||||
|
||||
SEE ALSO
|
||||
--------
|
||||
meshlabserver (1)
|
||||
|
||||
|
||||
RESOURCES
|
||||
---------
|
||||
Documentation wiki: http://meshlab.sourceforge.net/wiki[]
|
||||
|
||||
|
||||
COPYING
|
||||
-------
|
||||
MeshLab Copyright 2005-2008 by Visual Computing Lab - ISTI CNR
|
||||
|
||||
This program is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation; either version 2 of the License, or (at
|
||||
your option) any later version.
|
||||
|
||||
This program is distributed in the hope that it will be useful, but
|
||||
WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||||
General Public License for more details.
|
||||
@ -1,38 +0,0 @@
|
||||
.TH MeshLab Version 1.2.0
|
||||
.SH NAME
|
||||
MeshLab - a tool for mesh inspection, processing, and conversion
|
||||
.SH SYNOPSYS
|
||||
meshlabserver [args]
|
||||
.SH DESCRIPTION
|
||||
MeshLab is an open source, portable, and extensible system for the processing and editing of unstructured 3D triangular meshes.
The system is aimed to help the processing of the typical not-so-small unstructured models arising in 3D scanning, providing a set of tools for editing, cleaning, healing, inspecting, rendering and converting this kind of meshes.
The system is based on the VCG library developed at the Visual Computing Lab of ISTI - CNR.
|
||||
|
||||
.SH OPTIONS
|
||||
.l
|
||||
\fI meshlabserver\fP accepts the following options:
|
||||
.TP 8
|
||||
.B \-i meshfilename
|
||||
The mesh that has to be loaded
|
||||
.B \-o meshfilename
|
||||
The mesh where to write the result
|
||||
.B \-s scriptfilename
|
||||
an optional script to be applied to the mesh before saving it.
|
||||
|
||||
.SH SEE ALSO
|
||||
meshlab (1)
|
||||
|
||||
.SH COPYRIGHT
|
||||
MeshLab Copyright \(co 2005-2008 by Visual Computing Lab - ISTI CNR
|
||||
.PP
|
||||
This program is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation; either version 2 of the License, or (at
|
||||
your option) any later version.
|
||||
.PP
|
||||
This program is distributed in the hope that it will be useful, but
|
||||
WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||||
General Public License for more details.
|
||||
.PP
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program; if not, write to the Free Software
|
||||
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
||||
@ -1,65 +0,0 @@
|
||||
MESHLABSERVER(1)
|
||||
================
|
||||
|
||||
|
||||
NAME
|
||||
----
|
||||
meshlabserver - a tool for mesh inspection, processing, and conversion
|
||||
|
||||
|
||||
SYNOPSIS
|
||||
--------
|
||||
meshlabserver [-i inputmesh] [-o outputmesh] [-s scriptfile]
|
||||
|
||||
|
||||
DESCRIPTION
|
||||
-----------
|
||||
MeshLab is an open source, portable, and extensible system for the
|
||||
processing and editing of unstructured 3D triangular meshes. The system is
|
||||
aimed to help the processing of the typical not-so-small unstructured models
|
||||
arising in 3D scanning, providing a set of tools for editing, cleaning,
|
||||
healing, inspecting, rendering and converting this kind of meshes.
|
||||
The system is based on the VCG library developed at the Visual Computing Lab
|
||||
of ISTI - CNR.
|
||||
|
||||
|
||||
OPTIONS
|
||||
-------
|
||||
-i inputmesh::
|
||||
The mesh file to be loaded.
|
||||
|
||||
-o outputmesh::
|
||||
The mesh file where to write the result.
|
||||
|
||||
-s script::
|
||||
The script to be applied.
|
||||
|
||||
|
||||
There must be exactly one input mesh and at most one output mesh. Script is
|
||||
optional and must be in the format saved by meshlabserver. The format of the
|
||||
output mesh is guessed from the used extension.
|
||||
|
||||
|
||||
SEE ALSO
|
||||
--------
|
||||
meshlab (1)
|
||||
|
||||
|
||||
RESOURCES
|
||||
---------
|
||||
Documentation wiki: http://meshlab.sourceforge.net/wiki[]
|
||||
|
||||
|
||||
COPYING
|
||||
-------
|
||||
MeshLab Copyright 2005-2008 by Visual Computing Lab - ISTI CNR
|
||||
|
||||
This program is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation; either version 2 of the License, or (at
|
||||
your option) any later version.
|
||||
|
||||
This program is distributed in the hope that it will be useful, but
|
||||
WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||||
General Public License for more details.
|
||||
Loading…
x
Reference in New Issue
Block a user