90 lines
3.9 KiB
Plaintext
90 lines
3.9 KiB
Plaintext
|
||
VCGLib http://vcg.sf.net o o
|
||
Visual and Computer Graphics Library o o
|
||
_ O _
|
||
Copyright(C) 2004-2005 \/)\/
|
||
Visual Computing Lab http://vcg.isti.cnr.it /\/|
|
||
ISTI - Italian National Research Council |
|
||
\
|
||
TriMeshInfo 1.2 2005/12/21
|
||
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 (Unreferenced vertices are listed separately)
|
||
* 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
|
||
|
||
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 two file formats ply (as described in the following document
|
||
http://vcg.sourceforge.net/img/wiki_up/plyformat.pdf)
|
||
and off (as described in http://www.geomview.org/docs/html/geomview_41.html#SEC44) .
|
||
|
||
|
||
--- 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 XML output produces an XML file with the same name of the mesh under
|
||
examination. This file summarize the mesh information.
|
||
Such xml-schema is designed to be processed by the
|
||
Prot<EFBFBD>g<EFBFBD> Ontology Editor and Knowledge Acquisition System.
|
||
For further details about Prot<6F>g<EFBFBD> see http://protege.stanford.edu .
|
||
|
||
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.
|
||
|