
README for Propo 0.1.2
3.2.2003


1. Introduction

Propo is a Java 2 program (or game if you like) 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
time zone. Otherwise the dates in the high score list might be off
by one day. For more information see the tzselect command. 

Setting the language. Propo supports English, Swedish, Finnish, and
Danish for output. To select your language, set the LANG environment
variable as follows:
	LANG=sv_SE   (for Swedish)
	LANG=da_DK   (for Danish)
	LANG=en_US   (for English)
	LANG=fi_FI   (for Finnish)
The default language for Propo is English. 

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 &'. The 
jar file for Propo is created by the makejar script in the source
directory. 

3. Credits

The source code is released under the GPL license. 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 installation script, .rpm packaging, and the Danish translation
are done 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
