
README for Propo 0.1.1
12.1.2003


1. Introduction

Propo is a Java 2 program for training the eye 
to see proportions. 

When the program runs it shows a window divided into two 
areas (area A and area B). In area A, the program shows a 
geometric configuration of black dots, lines and circles
with one dot painted red. In area B, the same configuration 
is shown slightly scaled with the red dot removed. The idea 
of the program is to click on the location of the red dot 
in area B. The top row of the window shows some statistics. 
It also shows a happy face if the last click was correct, 
a sad face, if it was not, and a face with sunglasses if
the last click was a "bull's eye". 

After completing 50 exercises your game will be added to 
the high-score list if your score was a high-score. 


2. Dependencies and Installation

a) To run Propo you need a Java 2 interpreter. For example, Sun's 
JRE or SDK. See http://java.sun.com

b) After installing a java interpreter,  you also need to put java 
in your PATH. On Debian Linux that is done for you. If you run Red Hat 
Linux, Mandrake or others, you can do this by adding the line 
	export PATH=$PATH:/usr/java/j2sdk1.4.1_01/bin/ 
to your .bashrc file (found in your home directory). 
Here, /usr/java/j2sdk1.4.1_01/bin/ is the location of your 
java interpreter. 

Alternatively you can use the script javasti
(see http://www.gnuskole.dk/index.php?ID=38 or 
http://www.gnuskole.dk/javasti) as an easy way to put java 
to your PATH.

You should also set the TZ environment variable to your local
timezone. Otherwise the dates in the high score list might be off
by one day. For more information see the tzselect command. 

c) After this (on computers running Unix/Linux) run the script 
'install'. It should be run as root. For instance, as 
	su -c'./install'
Then, to run Propo simply write 'propo' in a terminal window.
On Red Hat and Mandrake systems, Propo will also show in the 
start menu under the Applications folder.  

On non-unix systems (or if you do not have root access to you unix 
box), you can run propo by typing 'java -jar Propo.jar' in the 
main directory.

- To compile propo, type 
      	javac *.java
in the source directory. Then run by typing 'java Propo'

- To make the jar file Propo.jar, type 
	jar -cmfv MANIFEST.MF ../Propo.jar *.class bitmaps/*.jpg
in the source directory.


3. Credits

The source code is released under the GPL. See the file COPYING 
for details. The pictures of the happy faces are drawn by 
Andreas Zehender (az -at- azweb.de), and they are used by permission. 
The install script for propo is written by Gunner Poulsen 
(gunner -at- gnuskole.dk). 


4. Contact 

You can contact me at matias.dahl -at- hut.fi. 
The homepage for Propo is at www.kolumbus.fi/matias.dahl

