home *** CD-ROM | disk | FTP | other *** search
/ The Best of Select: Games Special 10 / SPSP10.ISO / dosgames / columns / columns.doc < prev    next >
Text File  |  1994-10-14  |  20KB  |  426 lines
  1.                           ___     _                    
  2.                          / __|___| |_  _ _ __  _ _  ___
  3.                         | (__/ _ \ | || | '  \| ' \(_-<
  4.                          \___\___/_|\_,_|_|_|_|_||_/__/
  5.                          ==============================        
  6.                  __               version 1.1
  7.                 (_ |_  _  _ _      _  _ _   |  | _  _ _ . _  _ 
  8.                 __)| |(_|| (/_\/\/(_|| (/_   \/ (/_| _> |(_)| |
  9.  
  10.       __     _ ___  ___ _ _     ___     _             ___                   
  11.     / __ \  / / _ \/ _ \ | |_  | _ )_ _(_)__ _ _ _   | _ ) ___  ___ ___ ___ 
  12.    | / _| | | \_, /\_, /_   _| | _ \ '_| / _` | ' \  | _ \/ _ \/ -_|_-</ -_)
  13.    | \__| | |_|/_/  /_/  |_|   |___/_| |_\__,_|_||_| |___/\___/\___/__/\___|
  14.     \____/        _       _                _                                
  15.                  /_\ ||  |_). _ |_ _|_ _  |_) _  _ _  _   _  _|
  16.                 /   \||  | \|(_|| | |__>  | \(/__>(/_| \/(/_(_|
  17.                               _|                               
  18.  
  19. Basic Information
  20. =================
  21. Columns is a falling tile game similar in nature to Tetris, played in a 6x18
  22. grid.  Rather than filling up horizontal rows to erase lines, in Columns you
  23. are required to put tiles of the same color or pattern in rows of three or
  24. more.  Well, not _required_ exactly, but if you don't then you won't really
  25. last too long...
  26.  
  27.  
  28. System Requirements
  29. ===================
  30. Columns was written for a 386 or better with a VGA card or better.  (If you
  31. have an MCGA card it will probably still work.)  A joystick and Soundblaster
  32. card are optional.  Columns should work with just about any version of DOS,
  33. but so far I have only been able to test it under DOS 5.0 through DOS 6.2.
  34. If you run into problems with earlier versions of DOS, feel free to write to
  35. me at the address listed at the end of this file, and I will see what I can
  36. do to fix the problem.
  37.  
  38. The sound and music library I am using requires a 386 or better, and should
  39. work with the Sound Blaster series of cards, a Gravis UltraSound card, or
  40. a ProAudio Spectrum card with SB emulation.  (Sorry, there is no Adlib
  41. support.)
  42.  
  43. If disk space is at a crunch for you, then you can delete any of the sound
  44. and/or music files (the *.SFX or *.DSM files).  You can also delete the
  45. SETSOUND.EXE program; just be sure to run it at least once to configure
  46. the sound for your particular system first.
  47.  
  48.  
  49. Legal BS
  50. ========
  51. This software is provided as is, without warranty of any kind.  The author
  52. shall not be liable for damages of any kind.  Use of this software
  53. indicates you agree to this.
  54.  
  55. (Don't mind me.  I just have to cover my legal behind.  PC compatibles are
  56. just way too incompatible to deserve the name.)
  57.  
  58.  
  59. Changes From Version 1.0 to 1.1
  60. ===============================
  61. A few things have changed since my initial release of Columns.  First, it
  62. is now possible to toggle the sound and music while the game is paused.
  63. Of course, this was only noticeable in the registered version of Columns;
  64. but since *nobody* has registered yet, this bug didn't affect anybody.
  65. [Don't worry...  version 1.0 was only released a month ago with a low
  66. distribution.]
  67.  
  68. Second, a new version of DSIK was released which allows me to determine
  69. whether a sound sample has finished playing yet.  Previously, I simply
  70. used a long-enough delay.
  71.  
  72. Third, there was also a minor problem with releasing memory for the music
  73. and sound effects.  This only affected my machine when I quit playing on
  74. the 2nd level (or the 12th), where the music is 100K.  And of course, all
  75. my beta testers were just more interested in playing the game then they
  76. were in reporting any problems...  :^)
  77.  
  78. Finally, I made a few more additions to the FAQ section.  If you have had
  79. problems running Columns then be sure to look at this section.  (Just
  80. search for the string "FAQ".)
  81.  
  82.  
  83. Starting Columns
  84. ================
  85. First, run the SETSOUND program to configure your sound and music.  If you
  86. only want to use the PC speaker, then choose "None" for your soundcard.
  87.  
  88. When you first run Columns, it will try to create a configuration file with
  89. the default settings.  This file (and the score file) will be stored in the
  90. same directory as your Columns executable, so if you want you can put
  91. Columns into your path and it will keep everything together for you.  After
  92. starting, you should then see the Columns Menu:
  93.  
  94.                             Columns Menu
  95.                             ------------
  96.                       1. Play Columns
  97.                       2. Change User Settings
  98.                       3. View Scores
  99.                       4. Instructions
  100.                       Q. Quit to DOS
  101.  
  102. The menu system is fairly simple:  Select a menu item by pressing its
  103. corresponding key, or highlight it using the up and down cursor keys and
  104. select it by pressing the [Enter] key.  Alternatively, you can use your
  105. joystick (if you have one) to highlight and select any menu item.
  106.  
  107.  
  108. Playing Columns
  109. ===============
  110. Select option 1 from the Columns Menu and the game will start immediately.
  111. A column is comprised of three tiles stacked in a vertical row.  The three
  112. tiles are selected randomly from any of six different colors or patterns.
  113. Move the column of tiles left and right with the left/right cursor keys or
  114. your joystick.  Rotate the colors/patterns on the column with the up/down
  115. cursor keys or your joystick.  Drop the column into position with the space
  116. bar or your joystick's fire button.
  117.  
  118. Other keys available during the game are:
  119.    P/Esc: Pause the game temporarily.  This blanks the playing field to help
  120.       prevent cheating.
  121.    S: Toggle the sound on and off.
  122.    M: Toggle the music on and off.
  123.    N: Toggle the display of the next piece.
  124.    Q: Quit the current game.
  125.  
  126. Three matching tiles in a straight line forms a triple.  Four in a row forms
  127. _two_ triples, five forms three, and so on.
  128.  
  129. Whenever you line up three or more tiles of the same color/pattern they will
  130. explode, points will be awarded (see below), and all tiles above will drop
  131. down into postion.  If more triples are formed after falling, they too will
  132. explode and more points will be awarded.  This continues until no more
  133. triples are formed.
  134.  
  135. The level increses by one every time 50 triples are formed.
  136.  
  137. The column will slowly fall if you don't drop it yourself.  At level 1, it
  138. moves down once every second, at level 2 it moves down twice a second, at
  139. level 3 it moves down three times a second, and so on.  While you might not
  140. be able to tell much difference between levels (say) 5 and 6, I am sure you
  141. _will_ be able to tell the difference between 5 and 10!
  142.  
  143. The game is over when one of the falling tiles is still sticking up above
  144. the 6x18 playing field after all triples have been completed.  A column
  145. which is wholly or partially sticking out can still form part of a triple
  146. though.  If your score is one of the ten best then you can enter your name
  147. to be put into the high score list.
  148.  
  149.  
  150. Scoring
  151. =======
  152. For each triple formed, you get as many points as the level you are
  153. currently playing.  But when the triples start ricocheting their value
  154. increases by the playing level.  So if you are playing at level 5, the
  155. initial triples are worth 5 points each, and the richocheted triples are
  156. worth 10, 15, 20, 25, and so on.
  157.  
  158. Depending on your ability, you may be able to get higher scores by starting
  159. at higher levels.  Although you may be able to reach the same level easlily,
  160. by the time you get there the playing field could be half-filled with
  161. misplaced tiles and you may not be able to line up as many ricochets.
  162. Remember that you get more points for the ricochets!
  163.  
  164.  
  165. Changing User Settings
  166. ======================
  167. Select option 2 from the Columns Menu and you will be presented with a
  168. submenu:
  169.  
  170.                               User Settings
  171.                               -------------
  172.                          1. Starting Level: 1
  173.                          2. Sound: ON
  174.                          3. Music: ON
  175.                          4. Sound Vol: ||||||||
  176.                          5. Music Vol: |||
  177.                          6. Show Next Piece: ON
  178.                          7. Use Bitmaps: OFF
  179.                          Q. Return to Main Menu
  180.  
  181. Highlight and select each item as you did for the Columns Menu, but with a
  182. small difference.  You can now also use the left/right cursor keys or your
  183. joystick to adjust any setting.
  184.  
  185. The settings shown here are the default ones, if you are playing Columns for
  186. the first time.  You can change the default settings to reflect your own
  187. preferences. (see below)
  188.  
  189. The starting level is the playing level at which your game will start.  The
  190. other items show whether or not you want the sound on, whether or not you
  191. want to see the next piece, how loud you want the sound effects and music,
  192. and whether you want to use colors or patterns.  Some people cannot
  193. distinguish between all six colors for various reasons (such as color
  194. blindness, or you may be playing on a monochrome monitor), and so I have put
  195. in six distinct bitmap patterns you can use instead of color.
  196.  
  197.  
  198. Configuration
  199. =============
  200. Your favorite user settings can be stored in a configuration file called
  201. "COLUMNS.CFG".  The default contents of the file is:
  202.  
  203. JOY=AUTO
  204. LEVEL=1
  205. SOUND=ON
  206. MUSIC=ON
  207. SOUNDVOL=16
  208. MUSICVOL=4
  209. NEXT=ON
  210. BM=OFF
  211.  
  212. This reflects the default settings Columns will use if you are running it
  213. for the first time.  These items may be specified in any order, and they are
  214. not case sensitive.  (If any are missing then it will assume the default
  215. value.)  You may also specify any option on the command line, superceding
  216. the value in the configuration file.  Type "columns /?" to see all available
  217. options.
  218.  
  219. The first item tells Columns how to choose which joystick will be used.
  220. JOY=AUTO means that it will try to use a joystick in port 1 if it is
  221. available, but if it is not then it will try to use a joystick in port 2.
  222. Otherwise, if none are plugged in, it will ignore the joystick.  Other
  223. options are JOY=1, which automatically selects game port 1, or JOY=2 which
  224. selects game port 2.  If you picked either of these two options and the
  225. joystick is not available, then it will behave as if you used JOY=AUTO to
  226. pick a game port.  One last option is JOY=OFF which tells Columns to
  227. completely ignore any joystick which may be connected.
  228.  
  229. The second item specifies the default starting level, which can be from 1 to
  230. 10.  LEVEL=5 will start the game at level 5, for instance.  
  231.  
  232. The next four items are used to adjust your sound and music volumes.
  233.  
  234. The last two items show whether to default to showing the next piece visible
  235. ON or OFF, and the bitmaps vs. colors ON or OFF.
  236.  
  237.  
  238. Technical Information
  239. =====================
  240. You can substitute your own sound effects for my default ones if you want.
  241. "All you have to do" is convert your sound into raw unsigned 8-bit data
  242. sampled at 8192 Hz.  Simple, no?  If you don't already have it, I recommend
  243. the SOX program.  (If you have access to FTP on the Internet, you can get
  244. the file "sox7dos.zip" from oak.oakland.edu in the /pub/msdos/sound
  245. directory.  If you _don't_ have access to the Internet then it is probably
  246. also available through the BBS circuit, with a similar filename.)  The basic
  247. syntax for using SOX to convert one of your own samples is:
  248.  
  249.         sox inputfilename -b -u -r 8192 sound.raw
  250.  
  251. SOX should automatically handle .WAV, .AU, .AIFF files for you.  Just make
  252. sure you read the documentation first, though.  Make sure you rename your
  253. resulting sound.raw file to the appropriate .SFX file.
  254.  
  255. The music files are MOD files converted to a special format for easier use
  256. in programming.  You can convert MOD files of your own with the CONV program
  257. (included in the archive DSIKDEMO.ZIP).  This program will handle file of
  258. types MOD/669/STM/S3M/MTM.  Note that I have only allowed for up to
  259. 8-channel MOD files.
  260.  
  261. If your MOD file is of another format, then I recommend that you use
  262. ScreamTracker (scrmt301.zip is the latest version I am aware of), and save
  263. the file in ProTracker format, and then convert it again with CONV.  Some of
  264. the songs included with Columns were originally MIDI files, which I
  265. converted to MOD files (ptmid3.zip), then to ProTracker files
  266. (scrmt301.zip), and finally to their present form.  (Whew!)  Mind you, ptmid
  267. only handles *most* MIDI files of types 0 and 1.  Many of the MIDI files I
  268. tried ptmid couldn't handle at all and locked up my machine completely.  And
  269. once, due to a conflict with a disk write cache, it managed to corrupt half
  270. of the games on my hard drive.  Ah well, it was all for a noble cause.  :^)
  271.  
  272. The songs I chose were mostly piano ragtime, with a few snappy classical
  273. pieces to boot.  The reason for this is that Columns really *needs* a light
  274. snappy music score.  Not only that, but these songs mostly are old enough to
  275. be completely in the public domain, so I didn't have to pay a musician to
  276. write music from scratch.  The song names are (to the best of my knowledge):
  277.  
  278. music0:   The Entertainer
  279. music1:   Black and White Rag
  280. music2:   Maple Leaf Rag
  281. music3:   Hungarian Rag
  282. music4:   The 12th Street Rag
  283. music5:   St. Louis Rag
  284. music6:   Blue Goose (?)
  285. music7:   Flight of the Bumblebee
  286. music8:   Dizzy Fingers
  287. music9:   Moonlight Sonata Movement III
  288. congrats: Hallelujah
  289. menu:     (?)
  290.  
  291.  
  292. Programming Columns
  293. ===================
  294. Many thanks should go to the following authors:
  295.  
  296. Scott Ramsays, who wrote SPX.  I got my keyboard and joystick handling
  297. routines from his library, which is available on the internet at
  298. ftp.digex.net in the /pub/access/ramsays/Spx directory, as spx30.zip.  This
  299. is in fact a complete game programmer's library for Turbo/Borland Pascal 7.0.
  300. If you are still using Pascal 6.0, then version 2.0 of SPX should work,
  301. although I don't happen to know where it can be obtained.
  302.  
  303. Carlos Hasan, who did DSIK.  This is a "Digital Sound Interface Kit", and
  304. versions are available for both C and Pascal.  A demo of this wonderful
  305. product is available at ftp.eng.ufl.edu in the /pub/msdos/demos/music/code
  306. directory, as dsikdemo.zip.  In my opinion, I fully recommend this library
  307. for all game and demo programmers.  It only costs about $30USD, and is a
  308. royalty-free system.
  309.  
  310. Jordan Hargrave, who put the SVGA BGI driver package together.  These BGI
  311. drivers have been placed into to public domain, and work on probably just
  312. about every SVGA video card on just about every possible video 
  313. mode.  This is available at oak.oakland.edu in the /pub/msdos/borland
  314. directory as svgabg52.zip.  Well sure, Columns is only using the MCGA
  315. 320x200 video mode, but by using these drivers it will be fairly simple to
  316. make new versions of Columns at SVGA video modes.  Mind you, I'm a
  317. programmer and not an artist, but I made sure that the potential is there.
  318. But if I don't get any postcards (or registrations) then I don't see the
  319. point of bothering.  Write to me!
  320.  
  321. Andrew Scott, who wrote PTMID.  This is a wonderful program which can
  322. convert most type 0 and 1 MIDI files into MOD files.  And as per your
  323. license, if Columns actually manages to turn a profit for me, I'll be sure
  324. to send you something.  Perhaps a registered version of Columns?  :^)
  325. PTMID is available at oak.oakland.edu in the /pub/msdos/music directory as
  326. ptmid3.zip.
  327.  
  328. The Future Crew demo group, who wrote ScreamTracker.  This was used to
  329. convert the MOD files converted by PTMID into a form which could be
  330. converted to the final DSM format.  You can find this on the internet at
  331. ftp.eng.ufl.edu in the /pub/msdos/demos/music/programs/trackers directory
  332. as scrmt301.zip.
  333.  
  334. Chris S. Craig, who wrote SCOPTRAX.  I used this program to tweak a few of
  335. the SFX samples, such as eliminating extra white noise from the start and
  336. end of some of the samples.  SCOPTRAX can be found on the internet at
  337. oak.oakland.edu in the /pub/msdos/sound directory as scoptrax.zip.
  338.  
  339.  
  340. Columns FAQ
  341. ===========
  342. Q. How about adding bombs to Columns?
  343.  
  344. A. Nope!  Columns is and should always be just one of those Simple Mindless
  345.    Games.  The pure simplicity of game play is in fact one of the best
  346.    features of Columns.  I call this the "Super Tetris" phenomenon.
  347.  
  348.    Tetris was my all-time favourite Simple Mindless Game.  In fact, I would
  349.    have written Yet Another Tetris Clone instead of Columns, except for the
  350.    fact that there are already so darned many of them out there.
  351.    
  352.    Then came Super Tetris.  Into pure simplicity they went and added bombs
  353.    and bells and whistles.  It was no longer a quiet refreshing break; it
  354.    was chaos.
  355.    
  356.    If you don't believe me, just ask your girlfriend which game she prefers:
  357.    Tetris or Super Tetris.  Or if you already happen to be someone's
  358.    girlfriend, go ahead and explain to your boyfriend which is better.  I
  359.    don't mean to be sexist (or homophobic), but for some reason most guys
  360.    don't realize how making a game simpler can make it better.  Must be all
  361.    that testosterone or something.
  362.  
  363.  
  364. Q. What are the cheat codes for Columns?
  365.  
  366. A. There aren't any!  Cheat codes are for wimpy DOOM players.  :^)
  367.  
  368.  
  369. Q. The music works fine on level one, but disappears when level two
  370.    starts.  And it comes back on level three...
  371.  
  372. A. The sound and music libraries need to use your conventional memory for 
  373.    storing the data.  If you are running Columns from within some kind
  374.    of DOS shell, then usually all you need to do is exit the shell program
  375.    and *then* run Columns.  If this doesn't work, then all you need to do
  376.    is boot "clean".  Make a boot floppy (format a: /s) with no CONFIG.SYS
  377.    or AUTOEXEC.BAT files, and the Columns should work just fine.  I am
  378.    using MS-DOS 6.22 at home, and my system has 617K free under most
  379.    circumstances.  But don't worry *too* much about this...  If there isn't
  380.    enough memory to load in the sound or music files, then Columns simply
  381.    doesn't play them.
  382.  
  383.  
  384. Q. Where did "Possum Enterprises" come from?
  385.  
  386. A. The day after one particular Married With Children episode, the guys were
  387.    in the computer lab talking and laughing about it.  I walked into the
  388.    room with a completely dumbfounded look on my face wondering what the
  389.    heck was so funny, just as one of them exclaimed "Possum Boy!"  And for
  390.    some reason that managed to stick, and now I've used "The Possum" as my
  391.    alias ever since.  (Previous aliases ranged from "Parsley" in the good
  392.    ol' Commodore 64 days, to "Game Master" when nobody ever managed to
  393.    catch me doing any work doing the school year, playing things like
  394.    Tetris and Wolfenstein 3D in the computer labs.)
  395.  
  396.  
  397. Write To Me
  398. ===========
  399. Problems?  Questions?  Complaints?  Extreme joy?  Let me know!  If you don't
  400. tell me anything then I have no clue what you really want...  Whatever your
  401. opinion, write to me at:
  402.  
  403. Brian Boese
  404. #1 - 164 Niagara Street
  405. St. Catharines, ON, CANADA
  406. L2R 4L4
  407.  
  408. You can obtain a registered version of Columns by sending $10.00 and an SASE
  409. to the same address.  I think this is a reasonable amount.  (After all, how
  410. much did you pay for Tetris?)  I really can't afford to spend weeks creating
  411. a wonderful game like this without getting _something_ in return.  As added
  412. incentive besides peace of mind, the registered version of Columns has the
  413. following features:
  414.  
  415.     1. You can save your high scores to a file.  This is not available in
  416.        the shareware version.  (My current high score is 5914, but then
  417.        again I've already had more practice than you...)
  418.     2. You can run to the bathroom when the game is paused.  The
  419.        unregistered version requires that you hold the pause key down to
  420.        stay paused.
  421.     3. All annoying delays and screens are removed from the Registered
  422.        version.
  423.  
  424. PS. Even if you don't want to register please send me a postcard.  I still
  425.     want to know what you think about Columns.
  426.