1ADMESH(1) General Commands Manual ADMESH(1)
2
6 ADMesh - a program for processing triangulated solid meshes
7
9 admesh [OPTION]... file
10
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 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 admesh sphere.stl
25 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 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 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 admesh --remove-unconnected sphere.stl
43 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
49 --x-rotate=angle
50 Rotate CCW about x-axis by angle degrees
51 --y-rotate=angle
53 Rotate CCW about y-axis by angle degrees
54 --z-rotate=angle
56 Rotate CCW about z-axis by angle degrees
57 --xy-mirror
59 Mirror about the xy plane
60 --yz-mirror
62 Mirror about the yz plane
63 --xz-mirror
65 Mirror about the xz plane
66 --scale=factor
68 Scale the file by factor (multiply by factor)
69 --translate=x,y,z
71 Translate the file to x, y, and z
72 --merge=name
74 Merge file called name with input file
75 -e, --exact
77 Only check for perfectly matched edges
78 -n, --nearby
80 Find and connect nearby facets. Correct bad facets
81 -t, --tolerance=tol
83 Initial tolerance to use for nearby check = tol
84 -i, --iterations=i
86 Number of iterations for nearby check = i
87 -m, --increment=inc
89 Amount to increment tolerance after iteration=inc
90 -u, --remove-unconnected Remove facets that have 0 neighbors
92 -f, --fill-holes
94 Add facets to fill holes
95 -d, --normal-directions
97 Check and fix direction of normals(ie cw, ccw)
98 --reverse-all
100 Reverse the directions of all facets and normals
101 -v, --normal-values
103 Check and fix normal values
104 -c, --no-check
106 Don't do any check on input file
107 -b, --write-binary-stl=name
109 Output a binary STL file called name
110 -a, --write-ascii-stl=name
112 Output an ascii STL file called name
113 --write-off=name
115 Output a Geomview OFF format file called name
116 --write-dxf=name
118 Output a DXF format file called name
119 --write-vrml=name
121 Output a VRML format file called name
122 --help Display this help and exit
124 --version
126 Output version information and exit
127 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
134 To perform all checks except for nearby, the following command line
135 would be used:
136 admesh --exact --remove-unconnected --fill-holes --normal-directions
138 --normal-values sphere.stl
139 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 admesh --fill-holes --normal-directions --normal-values sphere.stl
146 And again the same results could be achieved using the short options:
148 admesh -fudev sphere.stl
150 or
152 admesh -fdv sphere.stl
154 The following command lines do the same thing:
156 admesh sphere.stl
158 admesh -fundev sphere.stl
160 admesh -f -u -n -d -e -v sphere.stl
162 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
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 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 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 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.
187User Commands 21/10/2013 ADMESH(1)