admesh 0.1.0

data/ext/admesh/admesh/admesh.1

@@ -0,0 +1,173 @@
+.TH ADMESH "1" 21/10/2013 "User Commands"
+.SH NAME
+ADMesh - a program for processing triangulated solid meshes
+.SH SYNOPSIS
+.B admesh
+[\fIOPTION\fR]... \fIfile\fR
+.SH DESCRIPTION
+ADMesh is a program for processing triangulated solid meshes. Currently, ADMesh only reads the STL file format that is used for rapid prototyping applications, although it can write STL, VRML, OFF, and DXF files.
+
+By default, ADMesh performs all of the mesh checking and repairing options
+on the input file.  This means that is checks exact, nearby,
+remove-unconnected, fill-holes, normal-directions, and normal-values.  The
+file type (ASCII or binary) is automatically detected.  The input file is
+not modified unless it is specified by the \fB--write\fP option.  If the following
+command line was input:
+
+.B admesh sphere.stl
+
+The file sphere.stl would be opened and read, it would be checked and fixed
+if necessary, and the results of processing would be printed out.  The
+results would not be saved.
+
+The default value for tolerance is the length of the shortest edge of the
+mesh.  The default number of iterations is 2, and the default increment is
+0.01% of the diameter of a sphere that encloses the entire mesh.
+
+If any of the options \fB--exact\fP, \fB--nearby\fP, \fB--remove-unconnected\fP, \fB--fill-holes\fP,
+\fB--normal-directions\fP, \fB--reverse-all\fP, \fB--normal-values\fP, or \fB--no-check\fP are
+given, then no other checks besides that one will be done unless they are
+specified or unless they are required by ADMesh before the specified check
+can be done.  For example the following command line:
+
+.B admesh --remove-unconnected sphere.stl
+
+would first do an exact check because it is required, and then the
+unconnected facets would be removed.  The results would be printed and no
+other checks would be done.
+.SH OPTIONS
+.TP
+\fB\-\-x\-rotate\fR=\fIangle\fR
+Rotate CCW about x\-axis by angle degrees
+.TP
+\fB\-\-y\-rotate\fR=\fIangle\fR
+Rotate CCW about y\-axis by angle degrees
+.TP
+\fB\-\-z\-rotate\fR=\fIangle\fR
+Rotate CCW about z\-axis by angle degrees
+.TP
+\fB\-\-xy\-mirror\fR
+Mirror about the xy plane
+.TP
+\fB\-\-yz\-mirror\fR
+Mirror about the yz plane
+.TP
+\fB\-\-xz\-mirror\fR
+Mirror about the xz plane
+.TP
+\fB\-\-scale\fR=\fIfactor\fR
+Scale the file by factor (multiply by factor)
+.TP
+\fB\-\-translate\fR=\fIx\fR,y,z
+Translate the file to x, y, and z
+.TP
+\fB\-\-merge\fR=\fIname\fR
+Merge file called name with input file
+.TP
+\fB\-e\fR, \fB\-\-exact\fR
+Only check for perfectly matched edges
+.TP
+\fB\-n\fR, \fB\-\-nearby\fR
+Find and connect nearby facets. Correct bad facets
+.TP
+\fB\-t\fR, \fB\-\-tolerance\fR=\fItol\fR
+Initial tolerance to use for nearby check = tol
+.TP
+\fB\-i\fR, \fB\-\-iterations\fR=\fIi\fR
+Number of iterations for nearby check = i
+.TP
+\fB\-m\fR, \fB\-\-increment\fR=\fIinc\fR
+Amount to increment tolerance after iteration=inc
+.HP
+\fB\-u\fR, \fB\-\-remove\-unconnected\fR Remove facets that have 0 neighbors
+.TP
+\fB\-f\fR, \fB\-\-fill\-holes\fR
+Add facets to fill holes
+.TP
+\fB\-d\fR, \fB\-\-normal\-directions\fR
+Check and fix direction of normals(ie cw, ccw)
+.TP
+\fB\-\-reverse\-all\fR
+Reverse the directions of all facets and normals
+.TP
+\fB\-v\fR, \fB\-\-normal\-values\fR
+Check and fix normal values
+.TP
+\fB\-c\fR, \fB\-\-no\-check\fR
+Don't do any check on input file
+.TP
+\fB\-b\fR, \fB\-\-write\-binary\-stl\fR=\fIname\fR
+Output a binary STL file called name
+.TP
+\fB\-a\fR, \fB\-\-write\-ascii\-stl\fR=\fIname\fR
+Output an ascii STL file called name
+.TP
+\fB\-\-write\-off\fR=\fIname\fR
+Output a Geomview OFF format file called name
+.TP
+\fB\-\-write\-dxf\fR=\fIname\fR
+Output a DXF format file called name
+.TP
+\fB\-\-write\-vrml\fR=\fIname\fR
+Output a VRML format file called name
+.TP
+\fB\-\-help\fR
+Display this help and exit
+.TP
+\fB\-\-version\fR
+Output version information and exit
+.PP
+The functions are executed in the same order as the options shown here.
+So check here to find what happens if, for example, \fB\-\-translate\fR and \fB\-\-merge\fR
+options are specified together.  The order of the options specified on the
+command line is not important.
+.SH EXAMPLES
+To perform all checks except for nearby, the following command line would be
+used:
+
+.B admesh --exact --remove-unconnected --fill-holes --normal-directions --normal-values sphere.stl
+
+Actually, since the \fBexact\fP check is required by ADMesh before
+\fBremove-unconnected\fP, and \fBremove-unconnected\fP is required before \fB--fill-holes\fP,
+the above command line could be shortened as follows with the same results:
+
+.B admesh --fill-holes --normal-directions --normal-values sphere.stl
+
+And again the same results could be achieved using the short options:
+
+.B admesh -fudev sphere.stl
+
+or
+
+.B admesh -fdv sphere.stl
+   
+The following command lines do the same thing:
+
+.B admesh sphere.stl
+
+.B admesh -fundev sphere.stl
+
+.B admesh -f -u -n -d -e -v sphere.stl
+
+since the \fB-fundev\fP options are implied by default.  To eliminate one of the
+checks, just remove the letter of the check to eliminate from the "word" fundev.
+.SH SEE ALSO
+For more information about the options and output read
+.B admesh-doc.txt
+- it is usually located in /usr/share/doc/admesh-x.xx dir.
+.SH COPYRIGHT
+Copyright (C) 1995, 1996  Anthony D. Martin <amartin@engr.csulb.edu>
+
+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 for more details.
+
+You should have received a copy of the GNU General Public License along
+with this program; if not, write to the Free Software Foundation, Inc.,
+51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

data/ext/admesh/admesh/block.stl

@@ -0,0 +1,86 @@
+SOLID  Untitled1
+  FACET NORMAL  0.00000000E+00  0.00000000E+00  1.00000000E+00
+    OUTER LOOP
+      VERTEX -1.96850394E+00  1.96850394E+00  1.96850394E+00
+      VERTEX -1.96850394E+00 -1.96850394E+00  1.96850394E+00
+      VERTEX  1.96850394E+00 -1.96850394E+00  1.96850394E+00
+    ENDLOOP
+  ENDFACET
+  FACET NORMAL  0.00000000E+00 -0.00000000E+00  1.00000000E+00
+    OUTER LOOP
+      VERTEX  1.96850394E+00 -1.96850394E+00  1.96850394E+00
+      VERTEX  1.96850394E+00  1.96850394E+00  1.96850394E+00
+      VERTEX -1.96850394E+00  1.96850394E+00  1.96850394E+00
+    ENDLOOP
+  ENDFACET
+  FACET NORMAL  0.00000000E+00 -0.00000000E+00 -1.00000000E+00
+    OUTER LOOP
+      VERTEX  1.96850394E+00  1.96850394E+00 -1.96850394E+00
+      VERTEX  1.96850394E+00 -1.96850394E+00 -1.96850394E+00
+      VERTEX -1.96850394E+00 -1.96850394E+00 -1.96850394E+00
+    ENDLOOP
+  ENDFACET
+  FACET NORMAL  0.00000000E+00  0.00000000E+00 -1.00000000E+00
+    OUTER LOOP
+      VERTEX -1.96850394E+00 -1.96850394E+00 -1.96850394E+00
+      VERTEX -1.96850394E+00  1.96850394E+00 -1.96850394E+00
+      VERTEX  1.96850394E+00  1.96850394E+00 -1.96850394E+00
+    ENDLOOP
+  ENDFACET
+  FACET NORMAL -1.00000000E+00  0.00000000E+00  0.00000000E+00
+    OUTER LOOP
+      VERTEX -1.96850394E+00  1.96850394E+00 -1.96850394E+00
+      VERTEX -1.96850394E+00 -1.96850394E+00 -1.96850394E+00
+      VERTEX -1.96850394E+00 -1.96850394E+00  1.96850394E+00
+    ENDLOOP
+  ENDFACET
+  FACET NORMAL -1.00000000E+00  0.00000000E+00  0.00000000E+00
+    OUTER LOOP
+      VERTEX -1.96850394E+00 -1.96850394E+00  1.96850394E+00
+      VERTEX -1.96850394E+00  1.96850394E+00  1.96850394E+00
+      VERTEX -1.96850394E+00  1.96850394E+00 -1.96850394E+00
+    ENDLOOP
+  ENDFACET
+  FACET NORMAL  1.00000000E+00  0.00000000E+00  0.00000000E+00
+    OUTER LOOP
+      VERTEX  1.96850394E+00  1.96850394E+00  1.96850394E+00
+      VERTEX  1.96850394E+00 -1.96850394E+00  1.96850394E+00
+      VERTEX  1.96850394E+00 -1.96850394E+00 -1.96850394E+00
+    ENDLOOP
+  ENDFACET
+  FACET NORMAL  1.00000000E+00  0.00000000E+00  0.00000000E+00
+    OUTER LOOP
+      VERTEX  1.96850394E+00 -1.96850394E+00 -1.96850394E+00
+      VERTEX  1.96850394E+00  1.96850394E+00 -1.96850394E+00
+      VERTEX  1.96850394E+00  1.96850394E+00  1.96850394E+00
+    ENDLOOP
+  ENDFACET
+  FACET NORMAL  0.00000000E+00 -1.00000000E+00  0.00000000E+00
+    OUTER LOOP
+      VERTEX -1.96850394E+00 -1.96850394E+00  1.96850394E+00
+      VERTEX -1.96850394E+00 -1.96850394E+00 -1.96850394E+00
+      VERTEX  1.96850394E+00 -1.96850394E+00 -1.96850394E+00
+    ENDLOOP
+  ENDFACET
+  FACET NORMAL  0.00000000E+00 -1.00000000E+00  0.00000000E+00
+    OUTER LOOP
+      VERTEX  1.96850394E+00 -1.96850394E+00 -1.96850394E+00
+      VERTEX  1.96850394E+00 -1.96850394E+00  1.96850394E+00
+      VERTEX -1.96850394E+00 -1.96850394E+00  1.96850394E+00
+    ENDLOOP
+  ENDFACET
+  FACET NORMAL  0.00000000E+00  1.00000000E+00  0.00000000E+00
+    OUTER LOOP
+      VERTEX -1.96850394E+00  1.96850394E+00 -1.96850394E+00
+      VERTEX -1.96850394E+00  1.96850394E+00  1.96850394E+00
+      VERTEX  1.96850394E+00  1.96850394E+00  1.96850394E+00
+    ENDLOOP
+  ENDFACET
+  FACET NORMAL  0.00000000E+00  1.00000000E+00  0.00000000E+00
+    OUTER LOOP
+      VERTEX  1.96850394E+00  1.96850394E+00  1.96850394E+00
+      VERTEX  1.96850394E+00  1.96850394E+00 -1.96850394E+00
+      VERTEX -1.96850394E+00  1.96850394E+00 -1.96850394E+00
+    ENDLOOP
+  ENDFACET
+ENDSOLID  Untitled1

data/ext/admesh/admesh/compile

@@ -0,0 +1,347 @@
+#! /bin/sh
+# Wrapper for compilers which do not understand '-c -o'.
+
+scriptversion=2012-10-14.11; # UTC
+
+# Copyright (C) 1999-2013 Free Software Foundation, Inc.
+# Written by Tom Tromey <tromey@cygnus.com>.
+#
+# 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, 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 for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+# As a special exception to the GNU General Public License, if you
+# distribute this file as part of a program that contains a
+# configuration script generated by Autoconf, you may include it under
+# the same distribution terms that you use for the rest of that program.
+
+# This file is maintained in Automake, please report
+# bugs to <bug-automake@gnu.org> or send patches to
+# <automake-patches@gnu.org>.
+
+nl='
+'
+
+# We need space, tab and new line, in precisely that order.  Quoting is
+# there to prevent tools from complaining about whitespace usage.
+IFS=" ""	$nl"
+
+file_conv=
+
+# func_file_conv build_file lazy
+# Convert a $build file to $host form and store it in $file
+# Currently only supports Windows hosts. If the determined conversion
+# type is listed in (the comma separated) LAZY, no conversion will
+# take place.
+func_file_conv ()
+{
+  file=$1
+  case $file in
+    / | /[!/]*) # absolute file, and not a UNC file
+      if test -z "$file_conv"; then
+	# lazily determine how to convert abs files
+	case `uname -s` in
+	  MINGW*)
+	    file_conv=mingw
+	    ;;
+	  CYGWIN*)
+	    file_conv=cygwin
+	    ;;
+	  *)
+	    file_conv=wine
+	    ;;
+	esac
+      fi
+      case $file_conv/,$2, in
+	*,$file_conv,*)
+	  ;;
+	mingw/*)
+	  file=`cmd //C echo "$file " | sed -e 's/"\(.*\) " *$/\1/'`
+	  ;;
+	cygwin/*)
+	  file=`cygpath -m "$file" || echo "$file"`
+	  ;;
+	wine/*)
+	  file=`winepath -w "$file" || echo "$file"`
+	  ;;
+      esac
+      ;;
+  esac
+}
+
+# func_cl_dashL linkdir
+# Make cl look for libraries in LINKDIR
+func_cl_dashL ()
+{
+  func_file_conv "$1"
+  if test -z "$lib_path"; then
+    lib_path=$file
+  else
+    lib_path="$lib_path;$file"
+  fi
+  linker_opts="$linker_opts -LIBPATH:$file"
+}
+
+# func_cl_dashl library
+# Do a library search-path lookup for cl
+func_cl_dashl ()
+{
+  lib=$1
+  found=no
+  save_IFS=$IFS
+  IFS=';'
+  for dir in $lib_path $LIB
+  do
+    IFS=$save_IFS
+    if $shared && test -f "$dir/$lib.dll.lib"; then
+      found=yes
+      lib=$dir/$lib.dll.lib
+      break
+    fi
+    if test -f "$dir/$lib.lib"; then
+      found=yes
+      lib=$dir/$lib.lib
+      break
+    fi
+    if test -f "$dir/lib$lib.a"; then
+      found=yes
+      lib=$dir/lib$lib.a
+      break
+    fi
+  done
+  IFS=$save_IFS
+
+  if test "$found" != yes; then
+    lib=$lib.lib
+  fi
+}
+
+# func_cl_wrapper cl arg...
+# Adjust compile command to suit cl
+func_cl_wrapper ()
+{
+  # Assume a capable shell
+  lib_path=
+  shared=:
+  linker_opts=
+  for arg
+  do
+    if test -n "$eat"; then
+      eat=
+    else
+      case $1 in
+	-o)
+	  # configure might choose to run compile as 'compile cc -o foo foo.c'.
+	  eat=1
+	  case $2 in
+	    *.o | *.[oO][bB][jJ])
+	      func_file_conv "$2"
+	      set x "$@" -Fo"$file"
+	      shift
+	      ;;
+	    *)
+	      func_file_conv "$2"
+	      set x "$@" -Fe"$file"
+	      shift
+	      ;;
+	  esac
+	  ;;
+	-I)
+	  eat=1
+	  func_file_conv "$2" mingw
+	  set x "$@" -I"$file"
+	  shift
+	  ;;
+	-I*)
+	  func_file_conv "${1#-I}" mingw
+	  set x "$@" -I"$file"
+	  shift
+	  ;;
+	-l)
+	  eat=1
+	  func_cl_dashl "$2"
+	  set x "$@" "$lib"
+	  shift
+	  ;;
+	-l*)
+	  func_cl_dashl "${1#-l}"
+	  set x "$@" "$lib"
+	  shift
+	  ;;
+	-L)
+	  eat=1
+	  func_cl_dashL "$2"
+	  ;;
+	-L*)
+	  func_cl_dashL "${1#-L}"
+	  ;;
+	-static)
+	  shared=false
+	  ;;
+	-Wl,*)
+	  arg=${1#-Wl,}
+	  save_ifs="$IFS"; IFS=','
+	  for flag in $arg; do
+	    IFS="$save_ifs"
+	    linker_opts="$linker_opts $flag"
+	  done
+	  IFS="$save_ifs"
+	  ;;
+	-Xlinker)
+	  eat=1
+	  linker_opts="$linker_opts $2"
+	  ;;
+	-*)
+	  set x "$@" "$1"
+	  shift
+	  ;;
+	*.cc | *.CC | *.cxx | *.CXX | *.[cC]++)
+	  func_file_conv "$1"
+	  set x "$@" -Tp"$file"
+	  shift
+	  ;;
+	*.c | *.cpp | *.CPP | *.lib | *.LIB | *.Lib | *.OBJ | *.obj | *.[oO])
+	  func_file_conv "$1" mingw
+	  set x "$@" "$file"
+	  shift
+	  ;;
+	*)
+	  set x "$@" "$1"
+	  shift
+	  ;;
+      esac
+    fi
+    shift
+  done
+  if test -n "$linker_opts"; then
+    linker_opts="-link$linker_opts"
+  fi
+  exec "$@" $linker_opts
+  exit 1
+}
+
+eat=
+
+case $1 in
+  '')
+     echo "$0: No command.  Try '$0 --help' for more information." 1>&2
+     exit 1;
+     ;;
+  -h | --h*)
+    cat <<\EOF
+Usage: compile [--help] [--version] PROGRAM [ARGS]
+
+Wrapper for compilers which do not understand '-c -o'.
+Remove '-o dest.o' from ARGS, run PROGRAM with the remaining
+arguments, and rename the output as expected.
+
+If you are trying to build a whole package this is not the
+right script to run: please start by reading the file 'INSTALL'.
+
+Report bugs to <bug-automake@gnu.org>.
+EOF
+    exit $?
+    ;;
+  -v | --v*)
+    echo "compile $scriptversion"
+    exit $?
+    ;;
+  cl | *[/\\]cl | cl.exe | *[/\\]cl.exe )
+    func_cl_wrapper "$@"      # Doesn't return...
+    ;;
+esac
+
+ofile=
+cfile=
+
+for arg
+do
+  if test -n "$eat"; then
+    eat=
+  else
+    case $1 in
+      -o)
+	# configure might choose to run compile as 'compile cc -o foo foo.c'.
+	# So we strip '-o arg' only if arg is an object.
+	eat=1
+	case $2 in
+	  *.o | *.obj)
+	    ofile=$2
+	    ;;
+	  *)
+	    set x "$@" -o "$2"
+	    shift
+	    ;;
+	esac
+	;;
+      *.c)
+	cfile=$1
+	set x "$@" "$1"
+	shift
+	;;
+      *)
+	set x "$@" "$1"
+	shift
+	;;
+    esac
+  fi
+  shift
+done
+
+if test -z "$ofile" || test -z "$cfile"; then
+  # If no '-o' option was seen then we might have been invoked from a
+  # pattern rule where we don't need one.  That is ok -- this is a
+  # normal compilation that the losing compiler can handle.  If no
+  # '.c' file was seen then we are probably linking.  That is also
+  # ok.
+  exec "$@"
+fi
+
+# Name of file we expect compiler to create.
+cofile=`echo "$cfile" | sed 's|^.*[\\/]||; s|^[a-zA-Z]:||; s/\.c$/.o/'`
+
+# Create the lock directory.
+# Note: use '[/\\:.-]' here to ensure that we don't use the same name
+# that we are using for the .o file.  Also, base the name on the expected
+# object file name, since that is what matters with a parallel build.
+lockdir=`echo "$cofile" | sed -e 's|[/\\:.-]|_|g'`.d
+while true; do
+  if mkdir "$lockdir" >/dev/null 2>&1; then
+    break
+  fi
+  sleep 1
+done
+# FIXME: race condition here if user kills between mkdir and trap.
+trap "rmdir '$lockdir'; exit 1" 1 2 15
+
+# Run the compile.
+"$@"
+ret=$?
+
+if test -f "$cofile"; then
+  test "$cofile" = "$ofile" || mv "$cofile" "$ofile"
+elif test -f "${cofile}bj"; then
+  test "${cofile}bj" = "$ofile" || mv "${cofile}bj" "$ofile"
+fi
+
+rmdir "$lockdir"
+exit $ret
+
+# Local Variables:
+# mode: shell-script
+# sh-indentation: 2
+# eval: (add-hook 'write-file-hooks 'time-stamp)
+# time-stamp-start: "scriptversion="
+# time-stamp-format: "%:y-%02m-%02d.%02H"
+# time-stamp-time-zone: "UTC"
+# time-stamp-end: "; # UTC"
+# End: