vcglib/apps/trimeshinfo
ganovelli 95713e5723 updated to current version of the library 2011-04-15 14:02:55 +00:00
..
trimeshinfo1.00 First release of TriMeshinfo 2005-11-22 14:58:57 +00:00
trimeshinfo1.01 Ongoing Rearrangement of filepath 2011-04-01 17:09:03 +00:00
trimeshinfo1.02 Sample datasets 2005-11-22 15:26:43 +00:00
ClassesNode.h Removed Debug option 2005-11-04 15:37:58 +00:00
InstancesNode.h Removed Debug option 2005-11-04 15:37:58 +00:00
Node.h Enforced consistence of const parameters among all the funcs 2005-12-02 00:47:15 +00:00
SlotsNode.h fix memory leak in NodeValue 2006-01-27 13:35:10 +00:00
XMLTree.h fix memory leak in NodeValue 2006-01-27 13:35:10 +00:00
defs.h Fix indentation 2005-12-21 14:46:46 +00:00
history.txt Version 1.22 2006-11-07 07:57:26 +00:00
readme.txt Version 1.22 2006-11-07 07:57:26 +00:00
trimeshinfo.cpp updated to current version of the library 2011-04-15 14:02:55 +00:00
trimeshinfo.pro needed a pro file 2007-03-08 22:51:34 +00:00

readme.txt

   VCGLib  http://vcg.sf.net                                         o o     
   Visual and Computer Graphics Library                            o     o   
                                                                  _   O  _   
   Copyright(C) 2004-2006                                           \/)\/    
   Visual Computing Lab  http://vcg.isti.cnr.it                    /\/|      
   ISTI - Italian National Research Council                           |      
                                                                      \      
   TriMeshInfo 1.22 2006/10/30
   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: 

* Number of Vertices 
* Number of Faces 
* Number of Edges 
* Number of Connected Components 
* Number of Boundaries 
* Number of Isolated Vertices (i.e. Unreferenced)
* Number of Duplicated vertices (duplicated vertices are referenced vertices
                                 which have the same positon in the space)
* Manifold 
* Genus (computed only for Manifold Datasets) 
* Self-Intersection (currently computed only for Datasets with less than 3M faces) 
* Orientability 
* Orientation
* Regularity (We consider REGULAR those meshes that have 6 incident edges
  for each internal vertex, and 4 incident edges for each vertex on the 
  boundary. In all other cases we consider the mesh irregular.)
* Volume
* Attribute present on mesh (colors, texture coords etc);

The application has no graphical interface but works as the "Metro" tool on command line. 

TriMeshInfo is written in C++ and makes use of the VCG library. 
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)


--- 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.