README Version 0.4.0 - Geodesic Dome Verify
Copyright (C) 2004-2010 dondalah721@yahoo.com (Dondalah)

Xdome 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.

Xdome 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:

        Free Software Foundation, Inc.
        51 Franklin St, Fifth Floor,
        Boston, MA  02110-1301  USA
-------------------------------------------------------------------

Verify, spin, and spinecc are three programs that verify the
output of the strlen program through visualization.  To compile
these programs, you must first compile xdome, and then strlen.
Finally, you can compile and test the verify, spin, and spinecc
programs.

Verify, spin, and spinecc read the output of strlen through
standard input (stdin).  Verify and spin extract the phi and
theta values for each vertex of a strut.  Spinecc extracts
the x, y, and z cartesian coordinates for each vertex of a
strut.

They then paint each strut on an X Windows screen after
rotating the strut from zero to 360 degrees.  After every
foreground strut in the sphere has been painted on the
screen, the resulting image should look like a valid
geodesic dome.  This is a visual means of verifying that
the output of the strlen program is correct.

As you rotate the sphere, struts in the background become
foreground struts.  For example if strlen has produced
the data for an icosahedron, you may rotate the sphere
72 degrees, 144 degrees, 216 degrees, and 288 degrees
to see all 5 views of the icosahedron.  The icosahedron
is symmetric 5 ways, every 72 degrees.  The octahedron
is symmetric 4 ways, every 90 degrees.  And the tetrahedron
is symmetric 3 ways, every 120 degrees.

Verify uses a simple algorithm to rotate the output of
strlen horizontally.  Spin and spinecc use a more
complicated algorithm to rotate the sphere horizontally
and vertically and then allow you to spin the globe
on its axis.

Example of using strlen and verify:

	start X windows
        strlen -c1 -pi -f3 -s | verify

In this example, the output of strlen is piped into
verify.  Follow the menu on the screen to rotate the
sphere.

Example of using strlen and spin:

	start X windows
        strlen -c1 -pi -f3 -s | spin

In this example, the output of strlen is piped into
spin.  Follow the menu on the screen to rotate the
sphere.

Example of using strlen and spinecc:

	start X windows
        strlen -c1 -pi -f3 -e1.5 -s | spinecc

In this example, the output of strlen is piped into
spinecc.  Follow the menu on the screen to rotate the
sphere.

The previous examples take much longer to process when
the frequency is high.  At first you see a blank screen.
Then there is a waiting period before the image shows on
the screen.

Press the 'q' key to quit from verify, spin, and spinecc.

To install verify, spin, and spinecc,
	First, install xdome  in the xdome        directory.
	Then,  install strlen in the strut_length directory.
	Run instvfy

To de-install verify, spin, and spinecc, run deinst.

Browse doc/xdome.html to read more documentation
about the xdome programs.

If you encounter problems, please send me:

	A detailed description of your compile steps.
	A detailed description of the problem.
