Initial commit

3 files changed, 155 insertions, 0 deletions

diff --git a/.SRCINFO b/.SRCINFO
new file mode 100644
index 000000000000..e7d520f9417c
--- /dev/null
+++ b/.SRCINFO
@@ -0,0 +1,13 @@
+pkgbase = stripe
+	pkgdesc = A software tool which converts a polygonal model into triangle strips
+	pkgver = 2.0
+	pkgrel = 1
+	url = http://www3.cs.stonybrook.edu/~stripe/
+	arch = any
+	license = custom:stripe
+	source = http://www3.cs.stonybrook.edu/~stripe/stripe.tar.gz
+	md5sums = 1315c175d95b56f1a9b6a25e942775d5
+	sha256sums = 96af9841e3d22f3e1b5238d0c21fe3db3b28d2e030c6eeffd19e4a595fd8ac1f
+
+pkgname = stripe
+
diff --git a/PKGBUILD b/PKGBUILD
new file mode 100644
index 000000000000..99db782669ee
--- /dev/null
+++ b/PKGBUILD
@@ -0,0 +1,26 @@
+# Maintainer: Megameneer (Dennis Holierhoek) <dennis.hh@hotmail.com>
+pkgname=stripe
+pkgver=2.0
+pkgrel=1
+pkgdesc="A software tool which converts a polygonal model into triangle strips"
+arch=('any')
+url=http://www3.cs.stonybrook.edu/~stripe/
+license=('custom:stripe')
+depends=()
+makedepends=()
+source=(http://www3.cs.stonybrook.edu/~stripe/stripe.tar.gz)
+md5sums=('1315c175d95b56f1a9b6a25e942775d5')
+sha256sums=('96af9841e3d22f3e1b5238d0c21fe3db3b28d2e030c6eeffd19e4a595fd8ac1f')
+
+build() {
+	cd "$srcdir"/Stripe
+	make
+}
+
+package() {
+	cd "$srcdir"/..
+	gzip stripe.1
+	install -Dm644 stripe.1.gz "$pkgdir"/usr/share/man/man1/stripe.1.gz
+	cd "$srcdir"/Stripe
+	install -Dm644 stripe "$pkgdir"/usr/bin/stripe
+}
diff --git a/stripe.1 b/stripe.1
new file mode 100644
index 000000000000..4cbed21e42ab
--- /dev/null
+++ b/stripe.1
@@ -0,0 +1,116 @@
+.\" Text automatically generated by txt2man
+.TH STRIPE "1" "04 september 2015" "" "User Commands"
+
+.SH NAME
+stripe - converts a .obj file to a .objf file. (converts a polygonal model to triangle strips) 
+.SH SYNOPSIS
+.nf
+.fam C
+\fBstripe\fP [\fIoptions\fP] [file.obj]
+
+
+.SH DESCRIPTION
+
+The purpose of \fBstripe\fP is to speed up rendering time by converting a
+polygonal model to triangle strips. This manual describes the implementation
+of \fBstripe\fP, which was written by Francine Evans under the guidance of Steven
+Skiena and Amitabh Varshney, SUNY at Stony Brook.
+.PP
+Stripe's input is a .obj file in binary or ascii (default) and its output is
+a objf file in ascii, which contains the model represented by triangle
+strips. You can then use the objf file to render the model. We provide a
+viewer called viewobjf which uses opengl to render the model.
+.PP
+There are two phases to \fBstripe\fP: a global and local phase. In the first
+phase, the global phase, \fBstripe\fP finds patches of quadrilaterals and converts
+them to triangle strips, while also trying to extend off of the ends of the
+patches. \fBstripe\fP works especially well with models with quadrilaterals, since
+there will be many patches, and the patches form good sequential triangle
+strips. However, \fBstripe\fP does not only work with models containing
+quadrilaterals. It works on any model consisting of polygons.
+.PP
+The second phase, the local phase, uses a local algorithm to determine
+strips on the polygons that are left after the global phase cannot find any
+more suitable patches. This local algorithm uses adjacency information to
+determine which polygon to use next in a strip, and also triangulates the
+polygons on the fly to produce better strips.
+.PP
+The default \fIoptions\fP are the \fIoptions\fP that we observed to work the best. You
+can specify different \fIoptions\fP other than the ones that are set as the
+default, or simply leave off any \fIoptions\fP to use the ones that we found to be
+the best.
+.SH OPTIONS
+.TP
+.B
+\fB-a\fP
+In case there is a tie as to choosing the next polygon in a strip
+during the local phase, this option will alternate left-right direction
+in choosing the next polygon in a strip during successive tie-breaks.
+.TP
+.B
+\fB-b\fP
+This specifies that the input file is in binary.
+.TP
+.B
+\fB-f\fP
+In case there is a tie as to choosing the next polygin in a strip
+during the local phase, this option will simply choose the first
+polygon that it found.
+.TP
+.B
+\fB-g\fP
+This option specifies to find triangle strips only within the groups
+that are specified in the data file.
+.TP
+.B
+\fB-l\fP
+In case there is a tie as to choosing the next polygon in a strip
+during the local phase, this option will look ahead to the next level:
+it will examine the neighbors of each of the polygon's that tied and
+choose the next polygon in the strip based on which one has the best
+neighbor to put in the strip at the next evel.
+.TP
+.B
+\fB-o\fP
+This option allows you to turn off Stripes orientation 
+checking algorithm.
+.TP
+.B
+\fB-p\fP
+This option specifies that during the local phase we will be partially
+triangulating faces when we use them in a strip, saving the rest of the
+face for later and only using what we need for the current strip. This
+is the default option, if no triangulation option is specified.
+.TP
+.B
+\fB-q\fP
+In case there is a tie as to choosing the next polygon in a strip
+during the local phase, this option will choose the next face that does
+not produce a swap (degenerate triangle). If this is not
+possible, then the lookahead method is used (option \fB-l\fP). This is the
+default option for tie breaking, if no tie breaking option is
+specified.
+.TP
+.B
+\fB-r\fP
+In case there is a tie as to choosing the next polygon in a strip
+during the local phase, this option will randomly choose the next face
+from the list of tied faces.
+.TP
+.B
+\fB-w\fP
+This option specifies that during the local phase we will be fully
+triangulating a face as we come to it in a strip, without saving any of
+it for another strip.
+.SH SEE ALSO
+\fBviewobjf\fP(1)
+.SH BUGS
+Stripe assumes models consisting of convex polygons.
+Stripe assumes no more than 254 characters on a line.
+Stripe assumes polygons of 3 sides or greater.
+Stripe assumes that your file system supports extensions greater than 3.
+Please report any bugs to \fBstripe\fP@cs.sunysb.edu
+.SH AUTHOR
+This manual page contributed by Francine Evans of Stony Brook University. It
+has been reviewed by Steven Skiena and Amitabh Varshney of Stony Brook
+University.