packages icon
README file
Hitchhiker 2000
Author:  Aaron Worley
Web page:  http://hirame.hiram.edu/~worleyam/
Email:  aaron-w@earthling.net

Thank you for downloading Hitchhiker 2000!

Hitchhiker 2000 is an astronomical simulation and visualization program; 
a digital orrery. It originally started out as a graphics project from 
my college studies at Hiram College. I now work on it occasionally in my 
spare time. Maybe people will find it interesting or educational or maybe 
even useful? Let me know, I always like to hear from people who use my 
program. 


How to Use Hitchhiker 2000

Use the mouse to change the field of view.  Move the mouse pointer over
the window and drag the mouse around in different directions, while
pressing the left mouse button.  You'll notice the scene rotates based on
your mouse movements.  To zoom in or out, press the right mouse button and
move the mouse up or down.  To identify and object (a planet, asteroid,
etc.) on the screen, click on it with the middle mouse button (it my help
to pause the simulation; clicking a moving target can be difficult.)


Notes on the Movie Builder

The movie builder function will create an MPEG-formatted movie file based
on the current Hitchhiker scene.  It's currenty very crude; it will be
made more polished in future releases.  If you are going to us it, I
suggest running it from an xterm window, so you can watch for error
messages.  Basically, you select "start recording" from the menu, then
select "build movie" when you are done recording.  Hh2000 will create a
directory "/tmp/hhtmp" and build the movie file in it - the finish file
will be called "/tmp/hhtmp/hh_output.mpg".  You can delete the "hhtmp"
directory after the movie is finished building.  Hh2000 relies on the MPEG
and libgr-progs packages to build the movie, see the web page for links to
them. 


Known bugs in the current release:

Show-Stopping Bugs
* odd-numbered pixel/mpeg bug (?)

Moderate Bugs
* corona broken in linked camera modes

Accuracy Bugs
* fix sky rotation in 1 mode
* There were 14 rows in stars.csv that had zeros in all the fields