vcglib/apps/trimeshinfo/readme.txt

88 lines
3.7 KiB
Plaintext
Raw Normal View History

2005-01-21 13:08:34 +01:00
VCGLib http://vcg.sf.net o o
Visual and Computer Graphics Library o o
_ O _
2006-03-27 09:33:28 +02:00
Copyright(C) 2004-2006 \/)\/
2005-01-21 13:08:34 +01:00
Visual Computing Lab http://vcg.isti.cnr.it /\/|
ISTI - Italian National Research Council |
\
2006-03-27 09:33:28 +02:00
TriMeshInfo 1.21 2006/03/27
2005-01-21 13:08:34 +01:00
All rights reserved.
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 (http://www.gnu.org/licenses/gpl.txt)
for more details.
--- Synopsis ---
TriMeshInfo is a tool designed to inspect 3D models and retrieve all the
topological related information. It can be used to automate the process
of decoding 3D mesh inherent properties and ease data classification
and retrieval.
For each analyzed dataset the following information are extracted:
2006-03-29 11:27:32 +02:00
* Number of Vertices
2005-01-21 13:08:34 +01:00
* Number of Faces
* Number of Edges
* Number of Connected Components
* Number of Boundaries
2005-12-21 14:54:19 +01:00
* Number of Isolated Vertices (i.e. Unreferenced)
* Number of Duplicated vertices (duplicated vertices are referenced vertices
which have the same positon in the space)
2005-01-21 13:08:34 +01:00
* Manifold
2005-12-21 14:54:19 +01:00
* Genus (computed only for Manifold Datasets)
* Self-Intersection (currently computed only for Datasets with less than 3M faces)
2005-01-21 13:08:34 +01:00
* Orientability
2005-12-21 15:41:49 +01:00
* Orientation
2005-12-21 14:54:19 +01:00
* Regularity (We consider REGULAR those meshes that have 6 incident edges
for each internal vertex, and 4 incident edges for each vertex on the
2005-12-21 15:41:49 +01:00
boundary. In all other cases we consider the mesh irregular.)
* Volume
2006-03-29 11:27:32 +02:00
* Attribute present on mesh (colors, texture coords etc);
2005-01-21 13:08:34 +01:00
The application has no graphical interface but works as the "Metro" tool on command line.
2005-12-21 14:54:19 +01:00
TriMeshInfo is written in C++ and makes use of the VCG library.
2006-03-27 09:33:28 +02:00
The tool supports the following file formats:
- PLY (http://vcg.sourceforge.net/img/wiki_up/plyformat.pdf)
- OFF (http://www.geomview.org/docs/html/geomview_41.html#SEC44)
- STL (http://astronomy.swin.edu.au/~pbourke/dataformats/stl/)
- OBJ (http://www.eg-models.de/formats/Format_Obj.html)
2005-12-21 14:54:19 +01:00
--- Command-line Reference ---
Usage:
TriMeshInfo <mesh> [options]
Valid options are the following:
-q Quiet (disable verbose mode that is enabled by default)
-x Enable XML output
-h Enable HTML output
-s <filename> Save the clean mesh
The HTML output creates in the directory where TriMeshInfo is launched a file
called "result.html". This file contains an hmtl table with the retrieved
mesh information.
If this file is just present in the working directory the output of the TriMeshInfo
is added to the existing table. In this way it is possible to summarize the results
obtained from several meshes.
If you choose to save the "clean" mesh, the mesh without its unreferenced vertices
and with the duplicated vertices merged is saved.