1ADMESH(1)                   General Commands Manual                  ADMESH(1)
2
3
4

NAME

6       ADMesh - a program for processing triangulated solid meshes
7

SYNOPSIS

9       admesh [OPTION]... file
10

DESCRIPTION

12       ADMesh  is  a  program  for  processing triangulated solid meshes. Cur‐
13       rently, ADMesh only reads the STL file format that is  used  for  rapid
14       prototyping applications, although it can write STL, VRML, OFF, and DXF
15       files.
16
17       By default, ADMesh performs all of  the  mesh  checking  and  repairing
18       options  on  the  input file.  This means that is checks exact, nearby,
19       remove-unconnected, fill-holes, normal-directions,  and  normal-values.
20       The  file  type (ASCII or binary) is automatically detected.  The input
21       file is not modified unless it is specified by the --write option.   If
22       the following command line was input:
23
24       admesh sphere.stl
25
26       The  file  sphere.stl would be opened and read, it would be checked and
27       fixed if necessary, and the results of processing would be printed out.
28       The results would not be saved.
29
30       The  default  value for tolerance is the length of the shortest edge of
31       the mesh.  The default number of  iterations  is  2,  and  the  default
32       increment is 0.01% of the diameter of a sphere that encloses the entire
33       mesh.
34
35       If any of the options --exact, --nearby, --remove-unconnected,  --fill-
36       holes,  --normal-directions,  --reverse-all,  --normal-values, or --no-
37       check are given, then no other checks besides that  one  will  be  done
38       unless  they are specified or unless they are required by ADMesh before
39       the specified check can be done.  For  example  the  following  command
40       line:
41
42       admesh --remove-unconnected sphere.stl
43
44       would  first  do  an  exact  check because it is required, and then the
45       unconnected facets would be removed.  The results would be printed  and
46       no other checks would be done.
47

OPTIONS

49       --x-rotate=angle
50              Rotate CCW about x-axis by angle degrees
51
52       --y-rotate=angle
53              Rotate CCW about y-axis by angle degrees
54
55       --z-rotate=angle
56              Rotate CCW about z-axis by angle degrees
57
58       --xy-mirror
59              Mirror about the xy plane
60
61       --yz-mirror
62              Mirror about the yz plane
63
64       --xz-mirror
65              Mirror about the xz plane
66
67       --scale=factor
68              Scale the file by factor (multiply by factor)
69
70       --translate=x,y,z
71              Translate the file to x, y, and z
72
73       --merge=name
74              Merge file called name with input file
75
76       -e, --exact
77              Only check for perfectly matched edges
78
79       -n, --nearby
80              Find and connect nearby facets. Correct bad facets
81
82       -t, --tolerance=tol
83              Initial tolerance to use for nearby check = tol
84
85       -i, --iterations=i
86              Number of iterations for nearby check = i
87
88       -m, --increment=inc
89              Amount to increment tolerance after iteration=inc
90
91       -u, --remove-unconnected Remove facets that have 0 neighbors
92
93       -f, --fill-holes
94              Add facets to fill holes
95
96       -d, --normal-directions
97              Check and fix direction of normals(ie cw, ccw)
98
99       --reverse-all
100              Reverse the directions of all facets and normals
101
102       -v, --normal-values
103              Check and fix normal values
104
105       -c, --no-check
106              Don't do any check on input file
107
108       -b, --write-binary-stl=name
109              Output a binary STL file called name
110
111       -a, --write-ascii-stl=name
112              Output an ascii STL file called name
113
114       --write-off=name
115              Output a Geomview OFF format file called name
116
117       --write-dxf=name
118              Output a DXF format file called name
119
120       --write-vrml=name
121              Output a VRML format file called name
122
123       --help Display this help and exit
124
125       --version
126              Output version information and exit
127
128       The functions are executed in the same order as the options shown here.
129       So check here to find what happens if,  for  example,  --translate  and
130       --merge options are specified together.  The order of the options spec‐
131       ified on the command line is not important.
132

EXAMPLES

134       To perform all checks except for nearby,  the  following  command  line
135       would be used:
136
137       admesh  --exact  --remove-unconnected  --fill-holes --normal-directions
138       --normal-values sphere.stl
139
140       Actually, since the exact check is required by  ADMesh  before  remove-
141       unconnected,  and  remove-unconnected  is required before --fill-holes,
142       the above command line could be shortened  as  follows  with  the  same
143       results:
144
145       admesh --fill-holes --normal-directions --normal-values sphere.stl
146
147       And again the same results could be achieved using the short options:
148
149       admesh -fudev sphere.stl
150
151       or
152
153       admesh -fdv sphere.stl
154
155       The following command lines do the same thing:
156
157       admesh sphere.stl
158
159       admesh -fundev sphere.stl
160
161       admesh -f -u -n -d -e -v sphere.stl
162
163       since  the -fundev options are implied by default.  To eliminate one of
164       the checks, just remove the letter of the check to eliminate  from  the
165       "word" fundev.
166

SEE ALSO

168       For more information about the options and output read admesh-doc.txt -
169       it is usually located in /usr/share/doc/admesh-x.xx dir.
170
172       Copyright (C) 1995, 1996  Anthony D. Martin <amartin@engr.csulb.edu>
173
174       This program is free software; you can redistribute it and/or modify it
175       under  the  terms of the GNU General Public License as published by the
176       Free Software Foundation; either version 2 of the License, or (at  your
177       option) any later version.
178
179       This  program  is  distributed  in the hope that it will be useful, but
180       WITHOUT ANY  WARRANTY;  without  even  the  implied  warranty  of  MER‐
181       CHANTABILITY  or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
182       Public License for more details.
183
184       You should have received a copy of the GNU General Public License along
185       with this program; if not, write to the Free Software Foundation, Inc.,
186       51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
187
188
189
190User Commands                     21/10/2013                         ADMESH(1)
Impressum