README file for SDL-Toms, V0.2
==============================

 This is alpha-level software! It's incomplete! But playable!
 Latest versions can be found at:
 http://www.angelfire.com/super2/duologue/#sdl-toms

 I got an email from an old friend "Tom, do you remember the game Atoms?
Do you know where I can get a Windows version?"

 Well, I told him I didn't, but had written one for DOS ages ago using
Quickbasic. But I couldn't find it. A few hours later, I had V0.1 of
SDL-Toms (hehe), written in C using the SDL and SDL-Image libraries.

---------------------------------------------------------
 Downloading and running it:
 ===========================

 It generally seems to work in Linux and Windows now.

Linux users need to get the source package and type "make" (it'll then
create the program "sdl-toms" in the current directory. But you'll need
the SDL and SDL-image development libraries, from www.libsdl.org.

Windows users need to get the Windows binary package, which should have
everything they need in it. The program will be "sdl-toms.exe" in the
sdl-toms directory. The Windows binary package doesn't come with any
source code (but you can download it separately if you really want it).

The Windows version was made by a cross-compiler package, and hasn't
had much testing. Hopefully it has no viruses. You have been warned.

-------------------------------------------------------
 Gameplay
 ========

 NOTE: There's still no screen to say that a player has won- when someone
wins, it just goes back to the menu. You're expected to understand that
whoever's turn it had been when the game was won, was the winner.

 You can choose between 2 to 4 players, using a nice menu. You can
also set up Gamma Correction in the display menu (if both sides of the
grey bar are about the same tone, it's correct).

 Some instructions may be forthcoming in future versions, but so far
I'm writing this for friends who already know the game.
Controls:
 Menus are controlled with up and down cursor keys, and space or return
 (or right arrow) to choose a menu item.
 In the game, an atom is shown under the play grid, the same colour as
 the player whose turn it is. Click where you want to place your atom.
 Pressing q quits (doesn't work whilst the reactions are running).


 Other things you *might* eventually see include network play, and AI.


SDL-Toms is written by me, Tom Barnes-Lawrence, based on an
idea by some other people that we used to like about a decade ago.

It's distributed under the terms of the GPL. You should have a copy
with the program, even if you got the Windows binary version
(which comes without source).

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 5005    5025  99.6% -lh5- 0e46 Aug 30 12:32 sdl-toms-mos.info
[generic]                 1213    1213 100.0% -lh0- 2467 Aug 14  2003 sdl-toms_0.2/2p.png
[generic]                 1266    1266 100.0% -lh0- 5d0e Aug 14  2003 sdl-toms_0.2/3p.png
[generic]                 1210    1210 100.0% -lh0- 3273 Aug 14  2003 sdl-toms_0.2/4p.png
[generic]                  368     368 100.0% -lh0- 949d Aug 13  2003 sdl-toms_0.2/atom_p1_n1.png
[generic]                  625     635  98.4% -lh5- 187d Aug 13  2003 sdl-toms_0.2/atom_p1_n2.png
[generic]                  758     758 100.0% -lh0- 2270 Aug 13  2003 sdl-toms_0.2/atom_p1_n3.png
[generic]                  735     735 100.0% -lh0- 18a9 Aug 13  2003 sdl-toms_0.2/atom_p1_n4.png
[generic]                  729     729 100.0% -lh0- 4b4e Aug 13  2003 sdl-toms_0.2/atom_p1_n5.png
[generic]                  820     828  99.0% -lh5- c610 Aug 13  2003 sdl-toms_0.2/atom_p1_n6.png
[generic]                  582     585  99.5% -lh5- 2cd9 Aug 13  2003 sdl-toms_0.2/atom_p1_n7.png
[generic]                  374     374 100.0% -lh0- aa59 Aug 13  2003 sdl-toms_0.2/atom_p2_n1.png
[generic]                  654     654 100.0% -lh0- daf5 Aug 13  2003 sdl-toms_0.2/atom_p2_n2.png
[generic]                  805     805 100.0% -lh0- 3306 Aug 13  2003 sdl-toms_0.2/atom_p2_n3.png
[generic]                  788     788 100.0% -lh0- 254f Aug 13  2003 sdl-toms_0.2/atom_p2_n4.png
[generic]                  770     770 100.0% -lh0- 1471 Aug 13  2003 sdl-toms_0.2/atom_p2_n5.png
[generic]                  880     880 100.0% -lh0- 8cbd Aug 13  2003 sdl-toms_0.2/atom_p2_n6.png
[generic]                  621     621 100.0% -lh0- 6c93 Aug 13  2003 sdl-toms_0.2/atom_p2_n7.png
[generic]                  391     391 100.0% -lh0- 9975 Aug 13  2003 sdl-toms_0.2/atom_p3_n1.png
[generic]                  669     669 100.0% -lh0- 1cee Aug 13  2003 sdl-toms_0.2/atom_p3_n2.png
[generic]                  804     804 100.0% -lh0- 7e7e Aug 13  2003 sdl-toms_0.2/atom_p3_n3.png
[generic]                  774     774 100.0% -lh0- 4478 Aug 13  2003 sdl-toms_0.2/atom_p3_n4.png
[generic]                  782     782 100.0% -lh0- 6367 Aug 13  2003 sdl-toms_0.2/atom_p3_n5.png
[generic]                  873     873 100.0% -lh0- b012 Aug 13  2003 sdl-toms_0.2/atom_p3_n6.png
[generic]                  594     594 100.0% -lh0- 11e8 Aug 13  2003 sdl-toms_0.2/atom_p3_n7.png
[generic]                  389     389 100.0% -lh0- 7761 Aug 13  2003 sdl-toms_0.2/atom_p4_n1.png
[generic]                  670     670 100.0% -lh0- 82b4 Aug 13  2003 sdl-toms_0.2/atom_p4_n2.png
[generic]                  819     819 100.0% -lh0- 0c76 Aug 13  2003 sdl-toms_0.2/atom_p4_n3.png
[generic]                  805     805 100.0% -lh0- ccb1 Aug 13  2003 sdl-toms_0.2/atom_p4_n4.png
[generic]                  770     770 100.0% -lh0- 076d Aug 13  2003 sdl-toms_0.2/atom_p4_n5.png
[generic]                  910     910 100.0% -lh0- f7c1 Aug 13  2003 sdl-toms_0.2/atom_p4_n6.png
[generic]                  634     634 100.0% -lh0- 617e Aug 13  2003 sdl-toms_0.2/atom_p4_n7.png
[generic]                   97    1668   5.8% -lh5- 5704 Aug 13  2003 sdl-toms_0.2/backup/atom_p0_n0.xpm
[generic]                  347     347 100.0% -lh0- a0b0 Aug 13  2003 sdl-toms_0.2/backup/atom_p0_n1.png
[generic]                  165    1692   9.8% -lh5- 3c70 Aug 13  2003 sdl-toms_0.2/backup/atom_p0_n1.xpm
[generic]                  574     574 100.0% -lh0- d389 Aug 13  2003 sdl-toms_0.2/backup/atom_p0_n2.png
[generic]                  182    1692  10.8% -lh5- 08b7 Aug 13  2003 sdl-toms_0.2/backup/atom_p0_n2.xpm
[generic]                  775     775 100.0% -lh0- be00 Aug 13  2003 sdl-toms_0.2/backup/atom_p0_n3.png
[generic]                  176    1692  10.4% -lh5- 82d3 Aug 13  2003 sdl-toms_0.2/backup/atom_p0_n3.xpm
[generic]                  663     663 100.0% -lh0- b400 Aug 13  2003 sdl-toms_0.2/backup/atom_p0_n4.png
[generic]                  176    1692  10.4% -lh5- bc9d Aug 13  2003 sdl-toms_0.2/backup/atom_p0_n4.xpm
[generic]                  617     617 100.0% -lh0- 041c Aug 13  2003 sdl-toms_0.2/backup/atom_p0_n5.png
[generic]                  181    1692  10.7% -lh5- cdd1 Aug 13  2003 sdl-toms_0.2/backup/atom_p0_n5.xpm
[generic]                  830     830 100.0% -lh0- 24f4 Aug 13  2003 sdl-toms_0.2/backup/atom_p0_n6.png
[generic]                  574     574 100.0% -lh0- d389 Aug 13  2003 sdl-toms_0.2/backup/atom_p0_n7.png
[generic]                   69      69 100.0% -lh0- ca2e Aug 13  2003 sdl-toms_0.2/backup/atom_p1_n0.png
[generic]                   97    1668   5.8% -lh5- 8582 Aug 13  2003 sdl-toms_0.2/backup/atom_p1_n0.xpm
[generic]                  416     416 100.0% -lh0- 2e59 Aug 13  2003 sdl-toms_0.2/backup/atom_p1_n1.png
[generic]                  163    1693   9.6% -lh5- e2c2 Aug 13  2003 sdl-toms_0.2/backup/atom_p1_n1.xpm
[generic]                  679     679 100.0% -lh0- 31ae Aug 13  2003 sdl-toms_0.2/backup/atom_p1_n2.png
[generic]                  176    1693  10.4% -lh5- 58b4 Aug 13  2003 sdl-toms_0.2/backup/atom_p1_n2.xpm
[generic]                  948     951  99.7% -lh5- 8972 Aug 13  2003 sdl-toms_0.2/backup/atom_p1_n3.png
[generic]                  174    1693  10.3% -lh5- 52ca Aug 13  2003 sdl-toms_0.2/backup/atom_p1_n3.xpm
[generic]                  832     832 100.0% -lh0- de85 Aug 13  2003 sdl-toms_0.2/backup/atom_p1_n4.png
[generic]                  175    1693  10.3% -lh5- 9252 Aug 13  2003 sdl-toms_0.2/backup/atom_p1_n4.xpm
[generic]                  704     704 100.0% -lh0- caa0 Aug 13  2003 sdl-toms_0.2/backup/atom_p1_n5.png
[generic]                  180    1693  10.6% -lh5- f177 Aug 13  2003 sdl-toms_0.2/backup/atom_p1_n5.xpm
[generic]                 1046    1049  99.7% -lh5- 167a Aug 13  2003 sdl-toms_0.2/backup/atom_p1_n6.png
[generic]                  679     679 100.0% -lh0- 31ae Aug 13  2003 sdl-toms_0.2/backup/atom_p1_n7.png
[generic]                   69      69 100.0% -lh0- ca2e Aug 13  2003 sdl-toms_0.2/backup/atom_p2_n0.png
[generic]                   97    1668   5.8% -lh5- 8582 Aug 13  2003 sdl-toms_0.2/backup/atom_p2_n0.xpm
[generic]                  381     381 100.0% -lh0- 726a Aug 13  2003 sdl-toms_0.2/backup/atom_p2_n1.png
[generic]                  714     714 100.0% -lh0- 5bfc Aug 13  2003 sdl-toms_0.2/backup/atom_p2_n2.png
[generic]                  974     974 100.0% -lh0- 40f1 Aug 13  2003 sdl-toms_0.2/backup/atom_p2_n3.png
[generic]                  908     908 100.0% -lh0- 63fa Aug 13  2003 sdl-toms_0.2/backup/atom_p2_n4.png
[generic]                  721     721 100.0% -lh0- 50a1 Aug 13  2003 sdl-toms_0.2/backup/atom_p2_n5.png
[generic]                 1108    1108 100.0% -lh0- 34b7 Aug 13  2003 sdl-toms_0.2/backup/atom_p2_n6.png
[generic]                  714     714 100.0% -lh0- 5bfc Aug 13  2003 sdl-toms_0.2/backup/atom_p2_n7.png
[generic]                   69      69 100.0% -lh0- ca2e Aug 13  2003 sdl-toms_0.2/backup/atom_p3_n0.png
[generic]                   97    1668   5.8% -lh5- 8582 Aug 13  2003 sdl-toms_0.2/backup/atom_p3_n0.xpm
[generic]                  413     413 100.0% -lh0- 7413 Aug 13  2003 sdl-toms_0.2/backup/atom_p3_n1.png
[generic]                  790     790 100.0% -lh0- 4b9c Aug 13  2003 sdl-toms_0.2/backup/atom_p3_n2.png
[generic]                 1103    1103 100.0% -lh0- 504b Aug 13  2003 sdl-toms_0.2/backup/atom_p3_n3.png
[generic]                  979     979 100.0% -lh0- 9d28 Aug 13  2003 sdl-toms_0.2/backup/atom_p3_n4.png
[generic]                  757     757 100.0% -lh0- aa0c Aug 13  2003 sdl-toms_0.2/backup/atom_p3_n5.png
[generic]                 1206    1206 100.0% -lh0- dc18 Aug 13  2003 sdl-toms_0.2/backup/atom_p3_n6.png
[generic]                  790     790 100.0% -lh0- 4b9c Aug 13  2003 sdl-toms_0.2/backup/atom_p3_n7.png
[generic]                  502    1785  28.1% -lh5- d698 Aug 13  2003 sdl-toms_0.2/backup/explode.xpm
[generic]                  156    1676   9.3% -lh5- 3ceb Aug 13  2003 sdl-toms_0.2/backup/oneatom.xpm
[generic]                   69      69 100.0% -lh0- ca2e Aug 13  2003 sdl-toms_0.2/blanked.png
[generic]                 2623    7617  34.4% -lh5- 379d Aug 14  2003 sdl-toms_0.2/chain.c
[generic]                  579    1013  57.2% -lh5- 25e4 Aug 13  2003 sdl-toms_0.2/copyright
[generic]                 1714    1714 100.0% -lh0- d4a5 Aug 14  2003 sdl-toms_0.2/dgamma.png
[generic]                  140     163  85.9% -lh5- a541 Aug 15  2003 sdl-toms_0.2/dosify.pl
[generic]                 1885    1885 100.0% -lh0- 1e43 Aug 14  2003 sdl-toms_0.2/dsetup.png
[generic]                  509     509 100.0% -lh0- 592e Aug 13  2003 sdl-toms_0.2/explode.png
[generic]                 1770    1770 100.0% -lh0- ef2f Aug 14  2003 sdl-toms_0.2/fs.png
[generic]                  159     159 100.0% -lh0- 7589 Aug 14  2003 sdl-toms_0.2/gammaicon.png
[generic]                  657    1133  58.0% -lh5- 72d8 Aug 14  2003 sdl-toms_0.2/globals.c
[generic]                 7014   17992  39.0% -lh5- 4902 Aug 13  2003 sdl-toms_0.2/GPL
[generic]                 1653    4080  40.5% -lh5- 25c4 Aug 14  2003 sdl-toms_0.2/graphics.c
[generic]                 1627    1627 100.0% -lh0- 12f0 Aug 14  2003 sdl-toms_0.2/igamma.png
[generic]                 1599    3500  45.7% -lh5- 2b59 Aug 15  2003 sdl-toms_0.2/main.c
[generic]                  925    1875  49.3% -lh5- b6ae Aug 15  2003 sdl-toms_0.2/Makefile
[generic]                  249    3698   6.7% -lh5- 4f5f Aug 15  2003 sdl-toms_0.2/Makefile.dep
[generic]                13500   14154  95.4% -lh5- b6bd Aug 14  2003 sdl-toms_0.2/menubg.png
[generic]                 1783    5491  32.5% -lh5- d50e Aug 14  2003 sdl-toms_0.2/menus.c
[generic]                  122     171  71.3% -lh5- e627 Aug 15  2003 sdl-toms_0.2/NEWS
[generic]                 1610    1610 100.0% -lh0- c4f9 Aug 14  2003 sdl-toms_0.2/psetup.png
[generic]                 1273    1273 100.0% -lh0- 374b Aug 14  2003 sdl-toms_0.2/quit.png
[generic]                 1314    2647  49.6% -lh5- 122f Aug 15  2003 sdl-toms_0.2/README
[generic]                  100     140  71.4% -lh5- b737 Aug 13  2003 sdl-toms_0.2/renders/light.rad
[generic]                  141     223  63.2% -lh5- 8a56 Aug 14  2003 sdl-toms_0.2/renders/makemenuscene.sh
[generic]                  590    1166  50.6% -lh5- 9e96 Aug 13  2003 sdl-toms_0.2/renders/mats.rad
[generic]                  164     263  62.4% -lh5- e7fc Aug 14  2003 sdl-toms_0.2/renders/menuscene.rad
[generic]                   33      33 100.0% -lh0- d796 Aug 13  2003 sdl-toms_0.2/renders/player.rad
[generic]                  430     787  54.6% -lh5- ad2e Aug 13  2003 sdl-toms_0.2/renders/scene1.rad
[generic]                  161     274  58.8% -lh5- 7072 Aug 13  2003 sdl-toms_0.2/renders/scene2.rad
[generic]                  159     311  51.1% -lh5- 96d5 Aug 13  2003 sdl-toms_0.2/renders/scene3.rad
[generic]                  167     382  43.7% -lh5- 0019 Aug 13  2003 sdl-toms_0.2/renders/scene4.rad
[generic]                  173     431  40.1% -lh5- d55a Aug 13  2003 sdl-toms_0.2/renders/scene5.rad
[generic]                  184     480  38.3% -lh5- 45fb Aug 13  2003 sdl-toms_0.2/renders/scene6.rad
[generic]                  161     273  59.0% -lh5- f521 Aug 13  2003 sdl-toms_0.2/renders/scene7.rad
[generic]                  346     628  55.1% -lh5- 6247 Aug 13  2003 sdl-toms_0.2/renders/script.pl
[generic]                  191     282  67.7% -lh5- 41fc Aug 14  2003 sdl-toms_0.2/renders/TODO
[generic]                 1759    1759 100.0% -lh0- f6f3 Aug 14  2003 sdl-toms_0.2/return.png
[generic]                21390   58856  36.3% -lh5- 40cb Nov 23 19:30 sdl-toms_0.2/sdl-toms
[generic]                 1449    2907  49.8% -lh5- 0efe Nov 23 19:47 sdl-toms_0.2/sdl-toms-mos.readme
[generic]                 7161    7298  98.1% -lh5- fb01 Apr 29  2005 sdl-toms_0.2/sdl-toms-mos.readme.info
[generic]                 1394    2995  46.5% -lh5- e6b9 Aug 14  2003 sdl-toms_0.2/sdl-toms.h
[generic]                 5162    5162 100.0% -lh0- acca Apr 20  2005 sdl-toms_0.2/sdl-toms.info
[generic]                 1405    1405 100.0% -lh0- c009 Aug 14  2003 sdl-toms_0.2/start.png
[generic]                  593    1193  49.7% -lh5- 84cc Aug 13  2003 sdl-toms_0.2/STRUCTURE
[generic]                  998    2802  35.6% -lh5- 862d Aug 14  2003 sdl-toms_0.2/tags
[generic]                 1390    1390 100.0% -lh0- 5da4 Aug 14  2003 sdl-toms_0.2/temparrow.png
[generic]                 1213    1213 100.0% -lh0- 2467 Aug 14  2003 sdl-toms_0.2/text/2p.png
[generic]                   10      10 100.0% -lh0- 951f Aug 14  2003 sdl-toms_0.2/text/2p.txt
[generic]                 1266    1266 100.0% -lh0- 5d0e Aug 14  2003 sdl-toms_0.2/text/3p.png
[generic]                   10      10 100.0% -lh0- 504e Aug 14  2003 sdl-toms_0.2/text/3p.txt
[generic]                 1210    1210 100.0% -lh0- 3273 Aug 14  2003 sdl-toms_0.2/text/4p.png
[generic]                   10      10 100.0% -lh0- 8aff Aug 14  2003 sdl-toms_0.2/text/4p.txt
[generic]                 1714    1714 100.0% -lh0- d4a5 Aug 14  2003 sdl-toms_0.2/text/dgamma.png
[generic]                   15      15 100.0% -lh0- 85a0 Aug 14  2003 sdl-toms_0.2/text/dgamma.txt
[generic]                 1885    1885 100.0% -lh0- 1e43 Aug 14  2003 sdl-toms_0.2/text/dsetup.png
[generic]                   16      16 100.0% -lh0- c2cc Aug 14  2003 sdl-toms_0.2/text/dsetup.txt
[generic]                 1770    1770 100.0% -lh0- ef2f Aug 14  2003 sdl-toms_0.2/text/fs.png
[generic]                   18      18 100.0% -lh0- 6d13 Aug 14  2003 sdl-toms_0.2/text/fs.txt
[generic]                 1627    1627 100.0% -lh0- 12f0 Aug 14  2003 sdl-toms_0.2/text/igamma.png
[generic]                   15      15 100.0% -lh0- 4b67 Aug 14  2003 sdl-toms_0.2/text/igamma.txt
[generic]                 1610    1610 100.0% -lh0- c4f9 Aug 14  2003 sdl-toms_0.2/text/psetup.png
[generic]                   14      14 100.0% -lh0- c069 Aug 14  2003 sdl-toms_0.2/text/psetup.txt
[generic]                 1273    1273 100.0% -lh0- 374b Aug 14  2003 sdl-toms_0.2/text/quit.png
[generic]                   10      10 100.0% -lh0- 4a6c Aug 14  2003 sdl-toms_0.2/text/quit.txt
[generic]                 1759    1759 100.0% -lh0- f6f3 Aug 14  2003 sdl-toms_0.2/text/return.png
[generic]                   20      20 100.0% -lh0- 039d Aug 14  2003 sdl-toms_0.2/text/return.txt
[generic]                 1405    1405 100.0% -lh0- c009 Aug 14  2003 sdl-toms_0.2/text/start.png
[generic]                   11      11 100.0% -lh0- cacc Aug 14  2003 sdl-toms_0.2/text/start.txt
[generic]                  349     569  61.3% -lh5- 531c Aug 15  2003 sdl-toms_0.2/TODO
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total       148 files  158035  259681  60.9%            Nov 24 03:51