home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PASCAL / KABLOO.ZIP / KABLOOIE.DOC < prev    next >
Encoding:
Text File  |  1991-06-19  |  5.2 KB  |  105 lines
  1. Kablooie (c) 1991 Daniel Egnor
  2.  
  3. Kablooie is a pseudo-programmable fireworks simulator that works on an IBM
  4. AT or better with MCGA/VGA/SVGA.  In order to use the high-resolution SVGA
  5. modes Kablooie requires a VESA-compatible SVGA system or the appropriate
  6. VESA TSR loaded.
  7.  
  8. To start Kablooie type "kablooie" from the DOS prompt.  It will display
  9. an introductory screen and inform you of the video mode selection you
  10. may make on the command line.  After pressing <return> you should see
  11. a fireworks display.  If not, check the video mode table and see if it's
  12. picking an impossible mode for your adapter as default (it sometimes
  13. does this).  If so, pick a more likely mode to work and start with that
  14. as instructed.
  15.  
  16. When you get tired of watching the fireworks I have created you may make
  17. your own.  This is done by editing the "kablooie.kab" file, which must
  18. be in the current directory when kablooie is run.  This file consists
  19. of the descriptions of the various kinds of firework that will be launched.
  20. Note that any blank line or line that begins with a space is a comment
  21. and will be ignored by kablooie.
  22.  
  23. The file consists of a number of entries, each beginning with "firework"
  24. or "packing" and ending with "end."  All keywords must be on an otherwise
  25. blank line.  Kablooie will pick an entry from among those designated
  26. "firework"s at launch time.  Those starting with "packing" must be started
  27. as part of a "firework."  "Firework"s may also contain other "firework"s,
  28. but "packing"s will not be launched independently.
  29.  
  30. The next line after "firework" or "packing" is the name.  This should be
  31. unique and may be any string up to thirty chars long.  After thirty chars
  32. the name will be truncated.  It will be used to refer to the entry later,
  33. as part of another entry.
  34.  
  35. The line after the name is either "noflash" or "flash."  This line
  36. determines whether, when this particular firework (or piece of one)
  37. terminates (completes, fades out), it will flash the screen or not.
  38. Sparks that just fade out and do nothing should not flash; however,
  39. it is recommended that fireworks which will explode and launch others
  40. should flash the screen.
  41.  
  42. On the next line after "flash" or "noflash" is the color of the firework.
  43. This must be "red," "blue," "green," or "yellow."  This determines (can you
  44. guess?) the color of the firework as it travels through the "air."
  45.  
  46. After that (yet another line down) comes the longevity of the firework.
  47. This is measured in simulation-clock ticks; 10 is almost instant death (with
  48. possible explosion), 200 allows a launched firework to travel a graceful
  49. arc before releasing its contents.
  50.  
  51. The next line is the gravitational pull.  Usually this ought to be three,
  52. however, you may want to change this value to suit your needs.  The higher
  53. the number, the faster the firework will fall.
  54.  
  55. If the firework will not release anything-like, say, a spark-the next line
  56. should be "end," and another "firework" or "packing" would come after that.
  57. If, however, you want it to explode and shoot off other fireworks, you will
  58. now list those before the "end."
  59.  
  60. If that is the case, then the next line will be the name of the first 
  61. firework (usually a packing, actually) that will be launched.  This is the
  62. name you specified after "packing" or "firework" when originally describing
  63. the sub-firework; its entry must precede the entry of the firework containing
  64. it.  (Kablooie _will_ allow recursive fireworks which launch more of them-
  65. selves, but this is not recommended.)
  66.  
  67. The next line in the sub-launch description is the average number of
  68. fireworks of that type you want launched.  If you are launching sparks,
  69. one hundred to three hundred makes a nice chrysanthemum; if you are launching
  70. fireworks which will themselves launch other things, keep the number low
  71. or else you may slow down the simulator with a large number of flying
  72. objects.
  73.  
  74. The line after that is the maximum random variation from the average number.
  75. zero will allow no variation; there will always be as many fireworks launched
  76. from the explosion as you specify.
  77.  
  78. After that, on the next line, is the strength with which the sub-fireworks
  79. will be launched.  Five fairly propels them across the screen; one keeps them
  80. in a tight little bunch; and zero will cause any launched fireworks to follow
  81. "in the footsteps" of the (now defunct) launching firework.
  82.  
  83. After that will either be "end," if there are no more kinds of firework to
  84. be launched upon termination, or the name of another sub-firework if not,
  85. followed by the relevant data, and so on until finally there will be an
  86. "end."  The last non-comment line in the file should be "end."  (Without the
  87. period.)
  88.  
  89. This is all very confusing, I know.  To get the hang of it, look at the
  90. included kablooie.kab file; it has some comments explaining what is what.
  91.  
  92. Kablooie is in the public domain.  Do what you want with it.
  93.  
  94. Files in the ZIP should be:
  95.  
  96. kablooie.exe - the main .exe file (run it!)
  97. kablooie.doc - this file
  98. kablooie.kab - the included firework definition file
  99.  
  100. kablooie.pas - main source file (TP 6.0)
  101. colour.pas   - MCGA/VGA+ color handler unit
  102. bgi256.obj   - MCGA/VGA/VESA graphics driver by Michael Day
  103. bgi256.pas   - TP unit which links in the graphics driver
  104.  
  105. - Dan Egnor