home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 572.lha / Getem_v1.0 / Getem.English.Doc.pp / Getem.English.Doc
Encoding:
Text File  |  1991-11-12  |  10.6 KB  |  313 lines
  1.  
  2.  
  3.  
  4.      Get´em        User's Manual        Get´em V 1.0
  5.  
  6.  
  7.  
  8.      NAME
  9.           Get´em - New Idea of Game.
  10.  
  11.      SYPNOSIS
  12.           [RUN] GETEM [?][F Filename]
  13.  
  14.           Or double-click on Icon or LevelFile.
  15.  
  16.      DESCRIPTION
  17.  
  18.           Find the matching pieces. Pieces falling downto floor,
  19.           when moved over free space. This is a complete new idea
  20.           of a Game. Nothing common with Tetris or Shanghai.
  21.           There is even an existing Version before Gem'x was ever released,
  22.           With a bit Sound, controlled by Mouse and Keyboard.
  23.           Nice Graphics, completely written in Pascal. (Kick-Pascal 1.0 and 2.03)
  24.  
  25.      COPYRIGHT © by Markus Illenseer 1990,1991.
  26.  
  27.           The Source is moved into the Public-Domain. It may changed
  28.           and copied, as long as my Name and the Documentation stays in.
  29.           With this Source, with the resulting, runable Program and
  30.           the SoundFile NO profit should be gained. This requests especially the
  31.           socalled PD/FD/PW Dealers ! 
  32.  
  33.           Portations onto other Systems are allowed.
  34.           (And wanted! I am just preparing a X11 Version.)
  35.           I am requesting a Copy for any Portation for other systems !
  36.           And a Copy of a changed Source...
  37.  
  38.           Kickpascal ® is registered Trademark of the Maxon-GmBM ®
  39.           Kickpascal is a product of the Himpire.
  40.  
  41.      AUTHOR
  42.    
  43.           This Program was written by 
  44.           Markus Illenseer
  45.           Große Kurfürstenstraße 1
  46.           W-4800 Bielefeld 1
  47.           Germany
  48.  
  49.           The fastest way to contact me is to EMAIL me:
  50.  
  51.           markus@TechFak.Uni-Bielefeld.DE
  52.  
  53.      INSTALLATION
  54.  
  55.           Copy the file GETEM1.0 , GETEM.DOC (GETEM.UPDATES ,GETEM.DOC.GER)
  56.           GETEMLEVELS and the file GETEMSOUND anywhere you want, 
  57.           e.g. Harddisk, Disk or RAM.
  58.           You mustn't put these files together in one Directory, 
  59.           but it would be better.
  60.           The easiest will be to copy the whole Directory.
  61.           
  62.      START
  63.    
  64.       HOW TO START
  65.  
  66.             Start Getem in the Directory you put it in with the
  67.             Level-File as shown above.  
  68.  
  69.             (Getem likes to use the CLI ! Please have in mind to have at 
  70.              least a Stack of 5000 Bytes !
  71.             Use:  
  72.                  RUN GETEM1.0 
  73.             as you have a multitasked System !
  74.         
  75.             While using Workbench, double-click GETEM-Icon. 
  76.             (Nice Icon, isn´t it ?)
  77.  
  78.             If you start Getem from other Directories, where the Level-File   
  79.             is not present (or to start with other, self-made Levels), then 
  80.             you have to add the Parameter F with the name of the Level-File:   
  81.           
  82.             RUN GETEM F PATH_TO_LEVEL_FILE:LEVEL_FILE 
  83.  
  84.             (e.g. Level-File is in RAM:  RUN GETEM F RAM:LEVEL )
  85.  
  86.             From Workbench:
  87.  
  88.             Double-Click GETEM and Shift+LevelFile
  89.  
  90.             If you add the Parameter " ? " , Getem prints a short help on your 
  91.             Screen, but won´t get start. ( Only CLI )
  92.  
  93.  
  94.             If there was any Problem, Getem will open a new Window to 
  95.             run ...
  96.             
  97.  
  98.           Then you will see a chess-alike-field, where there are many little
  99.           boxes in the Window (In the colors of your Workbench-Screen).
  100.           On the top side, you see some Gadgets and the Logo.
  101.           Also there is a Gadget in the top of the Window, in the
  102.           Drag-Bar, named ICON.
  103.           
  104.           Getem will then open a small Window with the Text 
  105.           'Loading: LEVEL_FILE_NAME' 
  106.         
  107.           This will take a while. (Depends on the length of the File,
  108.            the used Computer and the busyness of it...)
  109.  
  110.           If Getem can´t find the Level-File, there will be the Message:
  111.           'Can´t find the File: LEVEL_FILE_NAME'
  112.  
  113.           If so, Getem will compute Random-Levels. These Random-Levels 
  114.           can be UNSOLVABLE ! This was build in to play the game
  115.           without any loaded levels and to test the game.
  116.  
  117.           IF for instance the Levelfile was of wrong Data-Strukture,
  118.           Getem breaks with a warning. ( Thought was usefull to do so)
  119.  
  120.           Now GETEM loads the SoundFile. This File is a standard
  121.           8SVX-File and can easily replaced. There will be an
  122.           Error-Message if the File couldn't be find. Then GETEM will use the
  123.           Flash instead of the Digital-Sound. When yuo have installed
  124.           'InstallBeep' don´t bother of the new Sounds.
  125.  
  126.  
  127.           If all was going wrong or if the Level-File could be loaded,
  128.           then,
  129.  
  130.      STARTED
  131.  
  132.           your´re in Demo-Mode. Getem waits for clicking any
  133.           Gadget or Key, while waiting, Getem shows the loaded Levels
  134.           and makes some Graphics FX.
  135.  
  136.      GADGETS
  137.       
  138.       CLOSE
  139.           
  140.           Must I explain this one ? Ends my Game...
  141.  
  142.  
  143.       START
  144.      
  145.           If you click the START Gadget, it starts the
  146.           Game. Only Gadget which is ON when you start.
  147.         
  148.       ReGo
  149.  
  150.           The ReGo is for playing the same level once more, if you like.
  151.           (And sometimes it is the only way to make the Level...)
  152.           This Function was added to be more succesful, if you made
  153.           an Error. But, beware of the Time ! (Not yet in this Version)
  154.           This Gadget is ON, when the Game was started.
  155.  
  156.       STOP
  157.     
  158.           The STOP is for stopping the Game. If you can´t see these
  159.           f*@#¡ng boxes anymore, this is the best Gadget.
  160.           Only ON, when Game was started.
  161.  
  162.       SCORE
  163.  
  164.           Opens or Close a Window showing the Score of the last 10
  165.           Levels. The higher the Score, the better you are. The less the Time,
  166.           the higher the Score: Score= 60 / Time (s) * 1000.
  167.           Can be clicked anytime. Bool-Gadget.
  168.  
  169.       ICON
  170.          
  171.           If you click the ICON-Gaget, the Window will be iconified.
  172.           The Window is shrinked and moved to the upper left top of the Screen. 
  173.           If the Window is shrinked, you can Resize it with the ICON-
  174.           Gadget once again. The Game is paused, also the Demo, and
  175.           will be continued at the same Level and build of the Plane.
  176.           This function was build in for reasons of Big-Brothers-
  177.           Watching-You-In-Your-Company...
  178.  
  179.      KEYS
  180.  
  181.           There are some Keys always needed and some others...
  182.  
  183.       ESC
  184.  
  185.           This key is for quitting Getem while in Demo-Mode, not
  186.           during the Game ! (Security) It is also to quit the
  187.           Help-Window.
  188.  
  189.       i   (The little 'i')
  190.           
  191.           Boss-Key. Iconifys the Window. (s.ab)
  192.  
  193.       HELP
  194.  
  195.           Opens a window with a short helptext like this one...
  196.  
  197.  
  198.  
  199.      HOW TO PLAY
  200.  
  201.           Well, it is easy. Move your Mousepointer to the box you
  202.           want to move. Then press the RIGHT Mousebutton to move
  203.           Box to right, and LEFT Mousebutton to move Box to the
  204.           left. 
  205.  
  206.           If there is free space under the box, the box falls automagically 
  207.           to the bottom. 
  208.           
  209.           If it find any neighbour, (Left, right or below)
  210.           having same type then himself, these two (three) boxes disappears. 
  211.           It could be possible, that three boxes at the time
  212.           may disappear ! Say the fallig box finds two (three ?) neighbours at
  213.           the time ! This is important !
  214.  
  215.           On the right side you see a list of each type of box in
  216.           the game. So there you can look, if there are any triples
  217.           of boxes (Odd Number).
  218.  
  219.           For the best strategy, you must improve yourself.
  220.           Use unmatching pieces to move other pieces to left,
  221.           right at higher places...
  222.           Before starting a level, look at the list, to detect any
  223.           odd-numbers, look for traps or holes.
  224.  
  225.  
  226.      TO BE REMEMBERED
  227.  
  228.           This is a Start Release of the Game. It is strongly
  229.           recommended to report ANY Bug !!!!!!
  230.  
  231.      KNOWN BUGS
  232.  
  233.           In special strange cases, it is possible, that you can´t dis-
  234.           appear three boxes at the time. This depends how you do
  235.           it. I am working on. The problem: complete new Routine...
  236.  
  237.           Sometimes the sound goes mad... Don't know why...
  238.  
  239.      LEVEL-FILE
  240.  
  241.           You can make your own Level-File !! As many as you want. The game
  242.           will not end at the last level, it'll begin at the first level
  243.           again. First, there are the Levels, then you can insert a name for
  244.           every Level. The name should not have more than 50 Chars. You can
  245.           insert any sort of name like these ones: Timecruncher, Old Trap, Big
  246.           Hole, Lonley One.
  247.  
  248.           Here the structure of a Level:
  249.  
  250.               00000000000000       14 Rows, and 14 Columns.
  251.               00000000000000
  252.               70000000000000       0 is white Background.
  253.               07000303030300       1 is Quader
  254.               00700202020200       2 is Cross
  255.               00070101010100       3 is Pyramid
  256.               02027007020250       4 is Circle
  257.               03030700030300       5 is Sand
  258.               04040000040400       6 is Rowy
  259.               77777777777077       7 is Black box (Wall)
  260.               00000000000050
  261.               00000000000000
  262.               00000000000000
  263.               77777777077777
  264.  
  265.           Do not insert the numbers 8 and 9 ! (IMPORTANT)
  266.  
  267.  
  268.           Then insert a blank line (CR) or the Level-Name, to seperate two Levels.
  269.  
  270.           Structure of Level-File:
  271.  
  272.           0123
  273.           1223       (Yeah, of course 14 Rows and Columns ! )
  274.           7771
  275.           LevelName1
  276.           3232
  277.           3421
  278.           7651
  279.           LevelName2
  280.         
  281.           etc.
  282.  
  283.  
  284.      THE SOUND-FILE
  285.  
  286.          The included Sound-file is GETEMSOUND. This is a Sound wich
  287.          makes a noice like a Drip of Water. If this does not seems to be good
  288.          enough to you, you can change this file. Copy any 8SVX-File you want
  289.          to GETEMSOUND and you get the new Sound! But be care! Don´t use a long
  290.          Sound! This may cause long waits during the game. Because of speed,
  291.          the Sound is played with the double speed than usual.
  292.     
  293.      WHAT LEFT TO DO ?
  294.  
  295.           Some better Levels.      YOU can make your own ones !
  296.           Better Sound.            Is done with 8SVX-Loader.
  297.           Highscores.              Not sure wheater it is necessary.(implemented)
  298.           Timelimitation.          Must be done, next thing I am doing.
  299.           FASTER.                  Surely posible...
  300.           Perhaps better Gfx.      Yo ! And 4096 colors...
  301.           Levelgenerator and Editor... (Up to 8 Meg of Levels avail...,
  302.                                           just kidding !)  
  303.  
  304.      
  305.       ENJOY !
  306.  
  307. (Sorry, no nroff manual-page !)
  308.  
  309. Markus Illenseer. 
  310.  
  311. Oh. When I have time enough, then there will be a version for X11-Windos
  312. for Sparcs and DECs.
  313.