home *** CD-ROM | disk | FTP | other *** search
/ norge.freeshell.org (192.94.73.8) / 192.94.73.8.tar / 192.94.73.8 / pub / computers / pcjr / games / VGAMAGIC.LZH / MAGIC.DOC next >
Text File  |  1990-10-01  |  8KB  |  192 lines
  1.  
  2.  
  3.  
  4.                              VGA Magic V1.00
  5.  
  6.                             ShareWare Release
  7.  
  8.  
  9.  
  10.                          Program and Documentation
  11.                             Copyright (C) 1990
  12.                            BulletProof Software,
  13.                             Mark I Manning III
  14.                                    and
  15.                             Mark I Manning IV
  16.  
  17.                             7611 Autumnal Lane
  18.                             Liverpool, NY 13088
  19.                             Tel: (315) 451-2087
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27. THE LEGALITIES
  28.  
  29. The entire contents of this software package are Copyright 1990 by
  30. BulletProof Software, Mark I Manning III and Mark I Manning IV.  All
  31. rights are reserved world wide.  You may not disassemble or otherwise
  32. reverse engineer or modify it in any way.  You may freely copy and
  33. distribute the package under the ShareWare concept as long as all files 
  34. are included in unmodified form and no fee is charged beyond a
  35. reasonable ammount for the media and handling ($10 maximum suggested).
  36.  
  37. This version of VGA Magic is a ShareWare Version of a commercial
  38. software package.  You may make personal, non-commercial use of it
  39. without charge, but if you appreciate the program and wish to support
  40. further developement of it and other fine software products from
  41. BulletProof Software, you are encouraged to register it for a fee of
  42. $20.00.  In return for registration, you will receive a personal,
  43. serialized copy of the full commercial version of VGA Magic which has
  44. additional graphics capabilities.  In addition, you will be notified
  45. of all major updates to the program and given the opportunity to
  46. recieve any update for $5.00, which is the cost of the media plus
  47. shipping and handling.
  48.  
  49. If you wish to make commercial use of VGA Magic, such as to
  50. demonstrate Microcomputer Hardware, you must purchase a commercial
  51. license from BulletProof Software for a fee of $65.00 per copy.
  52. Holders of commercial licenses can have their copies of VGA Magic
  53. personalized with the inclusion of thier own business advertisements
  54. and other special features.  Please contact BulletProof Software if
  55. you are interested in doing so.
  56.  
  57.  
  58.  
  59. WHAT IS VGA MAGIC
  60.  
  61. VGA Magic is a graphics program which utilizes many of the advanced
  62. features of VGA Boards to display spectacular fast action 256 color
  63. 320x200 resolution (mode 13h) Kaleidoscopes as well as exceptionally
  64. fast 16 color 640x480 (mode 12h) line drawing.  It is intended as a
  65. fun program to watch and play with as well as the ideal program for
  66. showing off or demonstrating VGA based Microcomputers.
  67.  
  68. The user interacts with the program through an easy to use two tiered
  69. menu system plus a few special "Hot Keys" that are active during
  70. graphic displays.  The user has control over various parameters, such
  71. as type of kaleidoscope, color palette selection, color palette
  72. rotations, how fast the color increments, horizontal and vertical line
  73. limits, the number of line reflections (3 or 15), and wether to use
  74. BIOS or direct screen writes.
  75.  
  76.  
  77.  
  78. RUNNING VGA MAGIC
  79.  
  80. VGA Magic uses graphics modes that work only with VGA Hardware, and
  81. could damage any other type of video board if it were run on it.  To
  82. prevent this possibility, VGA Magic has the ability to test the video
  83. hardware to insure that it is compatible, and will abort with an error
  84. message if it is not.  While this test is beleived to be definitive,
  85. please do not run VGA Magic on anything other than a VGA based system.
  86.  
  87. When VGA Magic is executed, it will first display it's Logo and
  88. Copyright Screen until any key is pressed.  When a key is pressed, it
  89. immediately starts running the authors' favorite Kaleidoscope routine.
  90. Pressing any key other than the special "Hot Keys" (see below) will
  91. bring up the Kaleidoscope Menu.  The Kaleidoscope menu is pretty well
  92. self explanatory and a little experimentation will quickly demonstrate
  93. the function of all selections, so we won't explain these in detail.
  94.  
  95. While at the Kaleidoscope Menu, pressing the <ESC> key will activate
  96. the Pop Up/Pull Down Main Menu.  You can navigate around this menu
  97. using the Cursor Arrow Keys along with the <Home> and <End> keys to
  98. move the red Menu Bar over your selection.  From the Main Menu, you
  99. can display information screens, go to the 640x480 PolyDiags line
  100. drawing section, the 320x200 Kaleidoscope section, or QUIT the
  101. program.
  102.  
  103.  
  104.  
  105. PALETTE MANIPULATIONS
  106.  
  107. During Kaleidoscope displays, the special "Hot Keys" that are used to
  108. dynamically manipulate the color palettes are active.  Pressing any of
  109. the keys <1> through <9> will select one of the nine pre-defined
  110. palettes and down load it to the video board.   This causes the graphics 
  111. display to immediately change to the new palette.  Pressing one of the 
  112. keys <R>, <D> or <H> turns on dynamic palette rotation, using one of 
  113. three manipulation methods (see below for full explanation).  Pressing 
  114. the <Q> key will turn off palette rotation.
  115.  
  116. VGA Magic maintains a buffer in user memory to hold the color palettes 
  117. that are being manipulated.  This buffer has the capacity to hold two 
  118. complete 256 color palettes.  When VGA Magic initializes, the default 
  119. color palette is loaded into both the upper and lower halves of the 
  120. buffer.  Whenever a new palette is selected, it is loaded into the lower 
  121. half of the palette buffer, and all palette downloads to the VGA Board 
  122. are from the lower half of the palette buffer. 
  123.  
  124. When the <R> key is pressed during Kaleidoscope displays, the contents 
  125. of the lower half of the palette buffer (one complete palette) is 
  126. rotated and then downloaded to the VGA Board at frequent intervals in 
  127. synchronization with the horizontal scan so as to avoid interference.
  128.  
  129. When the <D> key is pressed during Kaleidoscope displays, the contents
  130. of both the upper and lower halves of the palette buffer (two complete 
  131. palettes) are rotated and then the new contents of the lower half of the 
  132. buffer is downloaded to the VGA Board.
  133.  
  134. When the <H> key is pressed during Kaleidoscope displays, the contents 
  135. of the lower 128 colors in the lower half of the palette buffer are
  136. rotated (one half of a complete palette) and then the lower half of the 
  137. palette buffer (one complete palette) is downloaded to the VGA Board.
  138.  
  139. It may be difficult at first to digest all the above information and
  140. visualize the effects that these manipulations allow, so experimentation
  141. is the key to understanding.  As an aid to getting started, consider
  142. this; since you can load fresh palettes only into the lower half of the
  143. buffer, the only way you can change the upper half is by rotating into
  144. it from the lower half.    
  145.  
  146. If you press the <D> key to turn on full buffer rotation and then hit 
  147. some combination of the <1> to <9> keys, you will rotate a mixed palette 
  148. into the upper half of the buffer.  This mixed palette will rotate 
  149. around and back into the lower half of the buffer and then be downloaded 
  150. to the VGA Board.  An infinite variety of visual effects can be obtained 
  151. by hitting different sequences of the <R>, <D> and <H> keys in 
  152. combination with different sequences of the palette select keys <1> to 
  153. <9> at different key stroke intervals.
  154.  
  155.  
  156.  
  157. PROGRAM SOURCE AVAILABILITY
  158.  
  159. VGA Magic is coded in the FORTH 83 Standard Language.  However, all
  160. the graphics routines used within VGA Magic are coded in 8086 Family
  161. Assembly Language and are therefor useable by programmers that are
  162. familiar with 8086 Assembly as well as those familiar with FORTH.
  163. Anyone interested in obtaining the well commented source code for
  164. VGA Magic can purchase it for unrestricted recycling for $30 if
  165. purchased alone or $45 for the combined registration fee and source
  166. code purchase.
  167.  
  168.  
  169.  
  170. REGISTERING VGA MAGIC
  171.  
  172. To make registering VGA Magic as painless as possible, an order form
  173. is included with this package which you can use if you have a printer
  174. available to print it out with.  If you don't have a printer available
  175. just write the necessary information on any old piece of paper that
  176. you have handy.  Then mail both the order and a check made out to
  177. Mark I Manning to:
  178.  
  179.                         Mark I Manning
  180.                         BulletProff Software
  181.                         7611 Autumnal Lane
  182.                         Liverpool, NY 13088
  183.  
  184.  
  185.  
  186. REVISION HISTORY
  187.  
  188.         Version 1.00    Initial release         1-10-90
  189.  
  190.  
  191.  
  192.