home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 8 / amigaformatcd08.iso / screenplay / shareware / side_1.2 / files / docs / side_english.guide (.txt) next >
Amigaguide Document  |  1996-09-12  |  16KB  |  246 lines

  1. @database side_1.1
  2. @wordwrap
  3. @font Courier.font 13
  4. @node main "Side V 1.1
  5.  F. Dispot 1996"
  6. @{b}SIDE@{ub} - A full-color mouse-killing game...
  7. @{"Why Side    " LINK "Why_?"} Why I wrote Side
  8. @{"How to play " Link "How_?"} Rules of the game
  9. @{"Tooltypes   " Link "Tooltypes"} Parameters & preferences
  10. @{"Libraries   " Link "Libraries"} More about 2 useful libraries
  11. @{"Music       " Link "Music"} Music used in the game
  12. @{"Graphics    " Link "Graphics"} How to include your own pictures
  13. @{"More        " Link "More"} More about side
  14. @{"Distribution" Link "Distribution"} Shareware notice
  15. @endnode
  16. @node Why_? "Why Side ?"
  17. @{b}WHY ?@{ub}
  18.         This little programme could have been called "yamk" for Yet Another Mouse Killer. It was written when my wife asked for a Tetris game. Believe it or not, I had none of the 12946782 commercial versions, excluding the 7861236254686 PD ones...
  19.         This is why I decided to mix three games I knew: Tetris, an old board game called Push-Over, and Atominos.
  20.         The shareware version allows to play a restricted (25) number of games before blocking. Please @{"Register" Link "Distribution"} to use the full-game.
  21. @{b}HISTORY@{ub}
  22. V 1.0   12/93 - released 11/95
  23.         System 1.3, OCS chipset
  24.         Own version.
  25.         No music.
  26.         32 colors internal gfx, 320x200.
  27.         Menu bugs.
  28. V 1.1
  29.   05/96
  30.         System 3.0, AGA chipset
  31.         Test release, spread over Rx
  32.         External music through ST modules.
  33.         256 colors external gfx externes, 640x240.
  34.         Localization.
  35. V 1.11
  36.         Added music toggle menu
  37.         Fixed a bug in menu handling
  38. V 1.12
  39.         Added "About" menu
  40.         Added "SFX" menu
  41.         Minor gfx changes
  42. V 1.13
  43.         Added "Merge" menu
  44.         Game over animation
  45.         Fixed a bug in menu creation
  46. V 1.2
  47.         First public release
  48.         Archive cleanup
  49. @endnode
  50. @node How_? "How to play Side"
  51. @{b}HOW TO PLAY@{ub}
  52.         You have a rectangular 4x8 squares "well" in the middle and a 6 squares "stack" on the right. The aim of the game is to make lines of 4 or more identical squares, in any direction. When such a line is met, its squares disappear. New squares appear at an increasing rate on the right. When time comes for the sixth square to appear at the top of the stack, the game is over.
  53.         To place a square into the well, just place the mouse at the point you want it to enter. The square then enters the well on the side, and falls until there is another square right under itself (1), or it reaches the "ground" (2):
  54.                 !  !  !  !  !                 !  !  !  !  !
  55.                 +--+--+--+--+                 +--+--+--+--+
  56.          YY _\  !  !  !  !  !                 !  !  !  !  !
  57.          YY  /  !  !  !  !  !                 !  !  !  !  !
  58.                 +--+--+--+--+                 +--+--+--+--+
  59.                 !  !  !  !  !       (1)       !YY!  !  !  !
  60.                 !  !  !  !  !                 !YY!  !  !  !
  61.                 +--+--+--+--+                 +--+--+--+--+
  62.                 !XX!  !  !  !                 !XX!  !  !  !
  63.                 !XX!  !  !  !                 !XX!  !  !  !
  64.                 +--+--+--+--+                 +--+--+--+--+
  65.                 !  !  !  !  !                 !  !  !  !  !
  66.                 !  !  !  !  !                 !  !  !  !  !
  67.                 +--+--+--+--+                 +--+--+--+--+
  68.          YY _\  !  !  !  !  !       (2)       !  !  !  !  !
  69.          YY  /  !  !  !  !  !                 !  !  !  !  !
  70.                 +--+--+--+--+                 +--+--+--+--+
  71.                 !  !  !  !  !                 !YY!  !  !  !
  72.                 !  !  !  !  !                 !YY!  !  !  !
  73.                 +--+--+--+--+                 +--+--+--+--+
  74.         The square added this way disappears from the stack. If it is empty, another one comes.
  75.         If you make a square appear at a point where there is already one, the incoming square "pushes" the other one, which may stay there (3), fall (4), or push its own neighbour (5), etc...
  76.                 !  !  !  !  !                 !  !  !  !  !
  77.                 +--+--+--+--+                 +--+--+--+--+
  78.                 !  !  !  !  !                 !  !  !  !  !
  79.                 !  !  !  !  !                 !  !  !  !  !
  80.                 +--+--+--+--+                 +--+--+--+--+
  81.          YY _\  !ZZ!  !  !  !       (3)       !YY!ZZ!  !  !
  82.          YY  /  !ZZ!  !  !  !                 !YY!ZZ!  !  !
  83.                 +--+--+--+--+                 +--+--+--+--+
  84.                 !XX!XX!  !  !                 !XX!XX!  !  !
  85.                 !XX!XX!  !  !                 !XX!XX!  !  !
  86.                 +--+--+--+--+                 +--+--+--+--+
  87.                 !  !  !  !  !                 !  !  !  !  !
  88.                 !  !  !  !  !                 !  !  !  !  !
  89.                 +--+--+--+--+                 +--+--+--+--+
  90.                 !  !  !  !  !                 !  !  !  !  !
  91.                 !  !  !  !  !                 !  !  !  !  !
  92.                 +--+--+--+--+                 +--+--+--+--+
  93.          YY _\  !ZZ!  !  !  !       (4)       !YY!  !  !  !
  94.          YY  /  !ZZ!  !  !  !                 !YY!  !  !  !
  95.                 +--+--+--+--+                 +--+--+--+--+
  96.                 !XX!  !  !  !                 !XX!ZZ!  !  !
  97.                 !XX!  !  !  !                 !XX!ZZ!  !  !
  98.                 +--+--+--+--+                 +--+--+--+--+
  99.                 !  !  !  !  !
  100.                 !  !  !  !  !                 !  !  !  !  !
  101.                 +--+--+--+--+                 +--+--+--+--+
  102.                 !  !  !  !  !                 !  !  !  !  !
  103.                 !  !  !  !  !                 !  !  !  !  !
  104.                 +--+--+--+--+                 +--+--+--+--+
  105.          YY _\  !ZZ!WW!  !  !       (5)       !YY!ZZ!WW!  !
  106.          YY  /  !ZZ!WW!  !  !                 !YY!ZZ!WW!  !
  107.                 +--+--+--+--+                 +--+--+--+--+
  108.                 !XX!XX!XX!  !                 !XX!XX!XX!  !
  109.                 !XX!XX!XX!  !                 !XX!XX!XX!  !
  110.                 +--+--+--+--+                 +--+--+--+--+
  111.                 !  !  !  !  !                 !  !  !  !  !
  112.         If there are already 4 squares in the row you want to introduce a new square, all of them slide as above, and the fourth one replaces the one you have added, at the bottom of the stack (6).
  113.                 !  !  !  !  !                 !  !  !  !  !
  114.                 +--+--+--+--+                 +--+--+--+--+
  115.                 !  !  !  !  !                 !  !  !  !  !
  116.                 !  !  !  !  !                 !  !  !  !  !
  117.                 +--+--+--+--+                 +--+--+--+--+
  118.          YY _\  !ZZ!WW!AA!BB!       (6)       !YY!ZZ!WW!AA! _\  BB
  119.          YY  /  !ZZ!WW!AA!BB!                 !YY!ZZ!WW!AA!  /  BB
  120.                 +--+--+--+--+                 +--+--+--+--+
  121.         Scoring is an important feature of this game, maybe THE main point. Each square move gives 1 point. When you make a line and make n squares disappear, you score 2^n (Basic lovers), 2**n (Fortran fanatics), or better, 1<<n points. For example, the smallest line, 4 squares long, scores 16 points. Now, the nice point: n is the TOTAL number of ALL alligned squares at the same time; if you align twice 4 squares at the same time, you score 256... So to make a nice score, try to combine squares so that a single one, added at the right place, will align as many squares as possible. Have a look at the demo for more.
  122.         The known record at this is over 258,000,000 points: it includes a 28-squares move !
  123.         The absolute high score would be the longest C unsigned integer: 2^32-1. This would imply a large amount of fairly good moves !
  124.         Note that 4 colours is quite simple at start, but large moves are quite hard to perform, 5 is more interesting but still playable, while 6 is very hard.
  125. @{b}RUNNING THE GAME@{ub}
  126. After installing the game, double-click the "Side" icon.
  127. After a few seconds, a high socres list appears. A few inactive seconds later, a demo game starts. Click to resume.
  128. Available menus are:
  129. Game -> Start/Stop: Begin or stop a new game
  130. Game -> Pause (only when playing): The current game pauses. Select this menu again to resume the game.
  131. Game -> Merge (registered users only): this enables you to merge several hi-scores tables. Select the file to merge with yours (.sidescores) and click "Merge".
  132. Game -> About: displays some information concerning the game
  133. Game -> Quit: Leave the game
  134. Colors -> 4, 5 or 6: number of colors available for squares.
  135. Sounds -> Music: intro music is played between games, "game" music during them.
  136. Sounds -> Silent: the game remains silent.
  137. Sounds -> SFX: the game plays samples (see TOOLTYPES) when a new square falls, when a square is pushed or when a line is made.
  138. @{b}PROBLEMES@{ub}
  139. * An alert saying "Error strating Side" appears, then the game ends: check that everything Side needs is present (cf @{"More" Link "More"}).
  140. * The game starts, but remains silent: turn the volume up (!) and check that the Tooltypes "SONG_START" and/or "SONG_GAME" link to soundtracker modules.
  141. @endnode
  142. @node Tooltypes
  143. @{b}TOOLTYPES@{ub}
  144.         The 'Side' icon has the following tooltypes:
  145.             @{b}COVER@{ub} is the path to the IFF/ILBM file containing the cover picture.
  146.             @{b}PICTURE@{ub} is the path to the IFF/ILBM file containing all the graphics you want to play with.
  147.             @{b}SCREEN_MODE@{ub} is the hex value of the kind of screen you want. By default, this is set to 8000, a standard PAL screen. Set to 39020 to use 31 kHz multiscan (i.e. VGA). Set to A9000 to use 29 kHz DBLPAL (i.e.... idiomatic Amiga mode).
  148.             @{b}SONG_START@{ub} is the path to the tune played why displaying the hi-scores table. You may leave this tooltype empty or commented; in this case there will be no music between the games.
  149.             @{b}SONG_GAME@{ub} is the path to the tune played why you play the game. You may leave this tooltype empty or commented; in this case there will be no music during the game.
  150.             @{b}SOUND_LINE@{ub} is the path to the sample played when a line is made.
  151.             @{b}SOUND_LOST@{ub} is the path to the sample played when a game is over.
  152.             @{b}SOUND_NEW@{ub} is the path to the sample played when a new square appears.
  153.             @{b}SOUND_PUSH@{ub} is the path to the sample played when a square is pushed.
  154. @endnode
  155. @node Libraries
  156. @{b}LIBRARIES@{ub}
  157.         Since I am quite lazy, I had two people I never met do a large part of the boring job for me:
  158.             C.A. Weber wrote easy iff library
  159.             T. Kinnunen wrote medplayer library
  160.                 This OctaMED V2 - V6 material is Copyright RBF Software
  161.                 (
  162.  Teijo Kinnunen and Ray Burt-Frost)
  163.         This is why I only had to write the game itself. Thanks, guys!
  164. @endnode
  165. @node Music
  166. @{b}MUSIC@{ub}
  167.         Music tunes included here were written by Arnaud G. Gibert. They use the Med soundtracker format, 4 tracks, samples included in the file.
  168. @endnode
  169. @node Graphics
  170. @{b}GRAPHICS@{ub}
  171.         This game needs the AGA chipset, and uses 256 colours. This is why the included graphics are so beautiful (!). If you want to use your own background, follow these steps:
  172.             - design a nice 640x240 , 256-colours picture (the background). The palette should respect these conditions:
  173.                     * Color 0 is black
  174.                     * Color 1 is white, but @{b}DO NOT USE IT, KEEP IT RESERVED !!!@{ub}
  175.                     * Color 9 is blue
  176.                     * Color 15 is yellow
  177.                     * Color 255 is "very different" from black
  178.                     * Color 254 is "very different" from color 255
  179.             - design six 32x16 blocks using the same picture, horizontally following each other, starting at coordinates (32, 240).
  180.             - design eight 32x16 "explosion" images to form an animation, using the same picture, horizontally following each other, starting at coordinates (256, 240).
  181.             - Put all this stuff on the same picture.
  182.             - Place the picture in the 'gfx' drawer (this is not an obligation)
  183.             - Set the PICTURE tooltype in the Side icon to the path of your work.
  184.             - Enjoy !
  185. @endnode
  186. @node More "More about Side"
  187. @{b}USING Side@{ub}
  188.         Side is all written in C, and fully respects intuition, which is not the case of all these AMOS-shits that think they are the only interesting programme in the world. I HATE THEM, for I can't play while ray-tracing. This kind of things make an amiga look like a PC, and should be forbidden.
  189.         To use Side, you need:
  190.             * Any 680x0
  191.             * Kickstart 3.x
  192.             * A fair amount of free Chip Ram (1 Mb is a minimum when using music)
  193.             * Some space on a hard or floppy disk drive (about 750 kb)
  194.             * Commodore's @{i}Installer@{ui} program
  195.             * Courier 13 and CGTriumvirate fonts. The latter will be loaded faster if you create a size 30 bitmap version with IntelliFont.
  196.         This distribution includes localisation for French-speaking people. Please contact me if you have translated the tiny catalog into your own language.
  197. This game has been tested with the following machines:
  198.         Wozzeck: A4000/030 + 68882, 16+2Mb
  199.         Dwarf:   A1200, 2+2Mb PCMCIA
  200.         Zargon:  A4000/030 + 68882, 16+16+2Mb, GVP SCSI
  201.         Topaz:   A4000/040, 16+2Mb
  202.         Ruby:    A1200
  203.         Gizeh:   A1200
  204.         Flicka:  A4000/040
  205. Details above might be unaccurate, but anyway, thanks to all Rx
  206.  people above.
  207. @endnode
  208. @node Distribution
  209. @{b}DISTRIBUTION@{ub}
  210.         Shareware is a way of getting good software in a cheap way. You get hold of the software for almost nothing, and can test it for a while before deciding if you want to pay the programmer for his/her hard work. But remember that if you don't pay and nobody else pays, then it's pretty sure that the programmer will NOT make any more shareware software.
  211.         And that will in the end lead to no software for your machine!!!! So, please pay the author of the software.
  212.         If you use @{b}Side@{ub} and like it, then I would be eternally grateful to you if you would send me the shareware fee (or any amount you like), as payment for the game. You will then become a registered user of the game!
  213.         Registered users may use the game fully, i.e. they can play more than 25 games per color.
  214.         If you have too much money, I will accept a part of it: 50 FRF would be very kind, but I will also accept Cyberstorm 060 boards, 64-bits gfx enhancers, Minolta AF 300mm f/2.8 lenses...
  215.         If you have a valid e-mail address, I will send you the keyfile (42 bytes) through this way. Otherwise please enclose a disk with your fee. In both cases, please send me your @{"registration form" link Reg_Form}.
  216.         Of course, Side is restricted to a personnal use, and should only be distributed for a low fee.
  217.         Anyway, if you think you have found a bug (??), please do not hesitate to contact me, precising with the highest accuracy what the bug is, and everything special about your configuration.
  218.         My current address is:
  219.                 Fran
  220. ois DISPOT
  221.                 Les Poissons 1122
  222.                 20 ter rue de Bezons
  223.                 92400     COURBEVOIE
  224.                           FRANCE
  225. E-Mail: francois.wozzeck@zargon.frmug.fr.net   (long, isn't it?)
  226. @endnode
  227. @node Reg_Form
  228. Registration form
  229. Yes, please let me use the wonderful 'SIDE' game with no limit.
  230. I enclose the really cheap fee of 50 FRF with this form.
  231. NAME:
  232. ADDRESS:
  233. CITY:
  234. COUNTRY:
  235. I prefer to receive:
  236.     o   An E-Mailed keyfile at the following address:
  237.     o   An S-Mailed keyfile on the disk I enclose
  238. My Amiga in a few words:
  239.     Kind (A1000 - A4000/060T):
  240.     Board(s):
  241.     OS Version:
  242.     Fast Ram:
  243.     HDisks:
  244.     Misc:
  245. @endnode
  246.