home *** CD-ROM | disk | FTP | other *** search
/ Shareware 1 2 the Maxx / sw_1.zip / sw_1 / GAMES / KOOLAH10.ZIP / KOOLAH.DOC next >
Text File  |  1991-11-27  |  11KB  |  233 lines
  1.                                                   
  2.                                KOOLAH
  3.  
  4.       Version 1.0, Nov 27 1991, (c) Copyright Marko Teittinen 1991
  5.  
  6.  
  7.     KOOLAH is a freeware program. That means that it bears my 
  8.     copyright notice, but you are encouraged to copy it to your 
  9.     friends and to anybody else who wants it, provided you obey the 
  10.     following four rules: 
  11.         1) You may not sell the program or take any money for copying
  12.         2) You may not use the program commercially 
  13.         3) You may not modify any files of the package
  14.         4) You must copy all the files of the package:
  15.            KOOLAH.EXE, KOOLAH.PIC, KOOLAH.LVL and KOOLAH.DOC
  16.     If you have suggestions or questions about the program, contact 
  17.     the address in the end of this file. 
  18.  
  19.     
  20.     
  21.     1. HARDWARE REQUIREMENTS
  22.  
  23.     KOOLAH requires a PC-compatible computer running MS-DOS or PC-DOS. 
  24.     There must be an MCGA or VGA graphics adapter (or compatible) 
  25.     installed in the computer. KOOLAH does not make any requirements 
  26.     for the microprocessor, but I'm not sure if it runs fast enough 
  27.     with an 8086. I just don't have access to any computer with such 
  28.     a processor. KOOLAH checks the speed of the computer and adjusts 
  29.     its speed on fast computers so that it is convenient to play.
  30.     
  31.  
  32.     2. INSTALLING KOOLAH
  33.  
  34.     Installing KOOLAH is very easy. Just copy all the files of this 
  35.     package (KOOLAH.EXE, KOOLAH.PIC, KOOLAH.LVL and KOOLAH.DOC) in one 
  36.     directory. Then you can start KOOLAH from any directory, because 
  37.     KOOLAH always tries to find its datafiles in the directory it 
  38.     resides itself. KOOLAH creates file KOOLAH.TOP in the directory 
  39.     that was your current directory when you started it.
  40.  
  41.  
  42.     3. QUICK START
  43.  
  44.     This is for you that don't want to read long explanations of the 
  45.     game, but want to get into the game as soon as possible. Shortly, 
  46.     the idea of KOOLAH is to guide the ball through the maze to the 
  47.     red goal area. If the ball gets too close to a hole, it falls into 
  48.     the hole and you lose it. You can also lose a ball if the time 
  49.     runs out. The yellow pillar on the right of the maze show you the 
  50.     remaining time. When you lose a ball, you have to start from the 
  51.     starting point of the maze with a new ball. At the beginning of 
  52.     the game you have three balls. 
  53.     
  54.     You control the ball with the arrow keys or with A, Z, M and N 
  55.     keys. A and Z change the speed of your ball up and down 
  56.     respectively, and N and M change it left and right respectively. 
  57.     Notice that you don't have as direct control of the ball as you 
  58.     probably expect, but after a while you get used to it. That is the 
  59.     idea behind KOOLAH. Now you you know enough to start the game. 
  60.     Just type KOOLAH at your DOS prompt. 
  61.     
  62.     If you want to learn more details about how the controls affect 
  63.     the movement of the ball, or how KOOLAH got its name, read on. 
  64.  
  65.  
  66.     4. THE IDEA OF KOOLAH
  67.  
  68.     Now that the hasty ones have gone playing I'll explain this game 
  69.     in bit more detail. I got the idea for this game from a children's 
  70.     game where one tries to guide a metal ball through a wooden maze 
  71.     without touching the ball. The ball is controlled with two knobs 
  72.     on the side of the maze. One of the knobs leans the maze 
  73.     horizontally and the other vertically. The route through the maze 
  74.     is drawn on it, but there are holes along the route that easily 
  75.     swallow the ball. I played it myself when I was a kid and I liked 
  76.     it very much. So I got this idea of taking that game to computer 
  77.     age. 
  78.     
  79.     The idea of KOOLAH is the same as in that children's game I 
  80.     explained, to move the ball through the maze without direct 
  81.     control of its movement. The children's version used knobs, this 
  82.     computer version uses arrow keys. But to take advantage of 
  83.     computer technology and to make things a bit more interesting I 
  84.     added different mazes, scoring (what is a computer game without a 
  85.     high score list?) and time limits for the mazes. So in this game 
  86.     you try to guide the ball through the maze before the time runs 
  87.     out. 
  88.     
  89.  
  90.     5. HOW TO USE KOOLAH
  91.  
  92.     When you start KOOLAH, the startup screen is displayed. During 
  93.     that time the speed of the computer is tested, so that the game 
  94.     is not run too fast on fast computers. You get to game screen by 
  95.     pressing any key on the keyboard.
  96.  
  97.     The game screen looks roughly as follows:
  98.     ┌──────┬───────────────────┬─┬────────┐
  99.     │      │                   │ │ Koolah │
  100.     │      │                   │ │        │
  101.     │      │      ┌──────      │ │        │
  102.     │      │      │            │ │        │
  103.     │      │      │            │ │        │
  104.     │             │      ──────┤ │        │   
  105.     │             │            │ │        │
  106.     │             │            │ │ Level  │
  107.     ├─────────────┴──────      │ │   1    │
  108.     │                          │ │ Score  │
  109.     │                          │ │   0    │
  110.     └──────────────────────────┴─┴────────┘
  111.     The leftmost part of the screen is the maze area where the ball is 
  112.     moved. The narrow column is for the indicator of remaining time 
  113.     and the rightmost area is the informational area that displays 
  114.     the menu choices available for you and the scores of the players. 
  115.  
  116.     When you are not playing a game, the menu in the informational area 
  117.     shows the following choices: Help, Play, Resume, Sound, Top-10 and 
  118.     Quit. The choice to resume is displayed only if you have played at 
  119.     least one game and you cleared the first maze but not the last in 
  120.     the previous game. You can select an action by pressing the first 
  121.     letter of the menu item. Below I list the keys and their 
  122.     alternatives and explain what they do.
  123.         H, ?        Displays the help screen. Gives you a short 
  124.                     overview what the game is about.
  125.         P, space    Starts a new game.
  126.         R           (Only if displayed on the screen) Starts a new 
  127.                     game at the level where you lost your last ball in 
  128.                     the previous game.
  129.         S           Toggles the sound on/off. When the sound is on, a 
  130.                     small note is displayed in the informational area.
  131.         T           Shows you the top ten high score list.
  132.         Q, X, esc   Exits the program.
  133.     
  134.     During a game you control the ball with arrow keys or with A, Z, N 
  135.     and M. A is equivalent to up arrow, Z with down arrow, N with left 
  136.     arrow and M with right arrow. Because Y and Z are swapped in 
  137.     German keyboards, Y can also be used to replace down arrow. And 
  138.     now the effects of the controls. When you press a key once, the 
  139.     speed of the ball is increased to that direction a little bit. 
  140.     It means that if your koolah is not moving and you press down 
  141.     arrow, it starts to move down slowly. If you press down arrow 
  142.     repeatedly, the speed is increased every time you press the down 
  143.     arrow. If you then start pressing up arrow repeatedly, the speed 
  144.     is decreased with each keypress until the koolah stops. If you 
  145.     continue pressing the up arrow, the ball starts to move up. It 
  146.     sounds quite simple, but when you combine both vertical and 
  147.     horizontal movements and let the ball bounce off the walls, it 
  148.     becomes quite difficult.
  149.     
  150.     When you start a game, the menu in the informational area changes 
  151.     and displays choices for pausing the game and toggling the sound 
  152.     effects on and off. In addition to that, you can abort the game if 
  153.     you need to. Here's the list of choices during the game. 
  154.         S           Toggles the sound on/off. Again a small note 
  155.                     indicates whether the sound is on or off.
  156.         P           Pauses the game. The movement of the koolah is 
  157.                     suspended until a key is pressed. Also the timing 
  158.                     is interrupted during the pause. When you press a 
  159.                     key to continue the game, the koolah continues with 
  160.                     the same speed and direction as it had when you 
  161.                     paused the game.
  162.         esc         Aborts the game and displays the 'game over' text.
  163.     
  164.  
  165.     6. SCORING
  166.  
  167.     If the ball falls into a hole, you get one point for each hole 
  168.     you have successfully left behind. It means that if your koolah 
  169.     falls into the first hole, you get no points, the second hole 
  170.     gives you one point, the third hole three points and so on. If the 
  171.     time runs out before you reach the goal, you get as many points as 
  172.     there are holes in that maze. But if you manage to clear the maze 
  173.     in the given time, you get 150 points plus the remaining time is 
  174.     turned into points. The more time you have left, the more points 
  175.     you gain.
  176.  
  177.     
  178.     7. THE NAME OF THE GAME
  179.  
  180.     It was difficult for me to find a good name for this game. The 
  181.     idea of the game suggests names like Maze, Labyrinth, Ballmaze 
  182.     etc. However, world is full of games named like that and I wanted 
  183.     to have something different. Then it came to my mind that in 
  184.     Finnish we have two different words for a ball. One is 'pallo' 
  185.     that can be used when one is talking about balls that are used in 
  186.     sports. Balls that are soft so that they can be squeezed a little 
  187.     bit. 'Pallo' is also used in mathematics when talking about 
  188.     spheres. The other word is 'kuula' and it is used when one is 
  189.     talking about metal balls that can't be squeezed and are used e.g. 
  190.     in ball-bearings. That's exactly the kind of ball that was used 
  191.     in the children's game. So 'kuula' would be something different, 
  192.     but then again almost nobody who can't speak Finnish would be able 
  193.     to pronounce it right. And then I decided to make pronouncing the 
  194.     name easier for you. I decided to spell the word 'kuula' so that 
  195.     you would get it at least almost right the first time you see it. 
  196.     I spelled it KOOLAH. Now if you pronounce it the way most English 
  197.     speaking people do, it sounds very much like the Finnish word 
  198.     'kuula'. 
  199.  
  200.  
  201.     8. DEVELOPMENT INFORMATION
  202.  
  203.     This program was developed on IBM PS/2 model 50 and on Alfaskop 
  204.     Desktop m346 (MM4 m346), using DOS versions 4.0 and 5.0. The 
  205.     program is written in C++ (using TC++ 1.01). The MCGA graphics 
  206.     functions are my own.
  207.  
  208.  
  209.  
  210.     I hope you enjoy this program!
  211.  
  212.                 Marko Teittinen, graduate student of computer science 
  213.  
  214.  
  215.     P.S. If you have any questions or comments on the game, I'd be 
  216.          pleased to hear from you. Contact me through the addresses 
  217.          below. 
  218.  
  219.  
  220.     NOTICE: The address below is valid until the end of August 1992. 
  221.             After that I don't know where I'll be living. The E-Mail 
  222.             address is valid longer. Though I can't tell you how long 
  223.             exactly.
  224.  
  225.     Address:  Marko Teittinen
  226.               Porvoonkatu 39 B 30
  227.               00520 Helsinki
  228.               FINLAND
  229.  
  230.     E-Mail:   teittine@cs.helsinki.fi
  231.               teittinen@cc.helsinki.fi
  232.  
  233.