home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Programming / Basic / OTL-BBU3.DMS / in.adf / BlitzBlank / BlitzBlank.doc < prev    next >
Encoding:
Text File  |  1993-10-07  |  7.0 KB  |  239 lines
  1. Editors Note:
  2.  
  3. Due to space restrictions I can't include the executables so
  4. first loadup source/blitzblank.bb and create the blitzblank
  5. executable. You need to keep the BlitzBlank.info icon as
  6. is, once you get this working (must be run from workbench)
  7. so you need to create modules with each of the source codes
  8. in Blitz2. You should be able to create the following modules
  9. in the modules drawer when finished:
  10.  
  11.   BB.Aquarium                      BB.Crumble
  12.   BB.Fade                          BB.Flash
  13.   BB.Lines                         BB.Melt
  14.   BB.Modules.config                BB.Mosaic
  15.   BB.Pyro                          BB.Pyro_GC
  16.   BB.Random                        BB.Spot
  17.   BB.Tiles
  18.  
  19. Sorry about the inconvenience, now over to Thomas...
  20.  
  21.  
  22. BlitzBlank 1.01
  23. ===============
  24.  
  25. ***************************************************
  26. * My FIDO-address has changed to 2:2476/506.11 !! *
  27. ***************************************************
  28.  
  29. What is it?
  30. -----------
  31.  
  32. Well, yet another screenblanker. But this one has the following features:
  33.  
  34. - AGA/OS 3.0 compatible
  35. - most modules graphic-cards compatible (tested with Picasso II)
  36. - modular (more modules to come, maybe one from YOU?)
  37. - fancy modules ;-)
  38. - nice GUI-interface
  39. - screenmode-requester built-in (because 2.0 ASL doesn`t have one)
  40. - ASL-filerequester
  41. - system-friendly
  42. - Commodity
  43. - mouseblanker included
  44. - copyrighted FreeWare
  45. - sourcecodes in BlitzBasic 2 included. Look at it, get ideas from it but
  46.   don`t change it!
  47.  
  48. Copyright and warranty notice:
  49. ------------------------------
  50.  
  51. BlitzBlank is copyrighted by Thomas Boerkel. It must not be included with
  52. commercial programs (exception: BlitzBasic 2) and may not appear on
  53. PD/FD-disks with a cost of more than $5/DM 5.-.
  54. The right to include BlitzBlank in the Fred Fish Library is especially
  55. granted (and wanted ;-) ). This also applies to possible CD-ROM releases
  56. of the Library.
  57. You may copy and use BlitzBlank free with no cost (FreeWare).
  58. You may only distribute BlitzBlank with all files from the original archive.
  59. There is NO warranty! Use BlitzBlank at your own risk. The author is NOT
  60. responsible for ANY damage caused by BlitzBlank.
  61.  
  62. The same applies to all modules with the exception that they are
  63. copyrighted by their respective authors.
  64.  
  65.  
  66. What you need:
  67. --------------
  68.  
  69. - an Amiga ;-)
  70. - AmigaOS 2.04 or higher (if you have 1.x then upgrade NOW!)
  71.  
  72.  
  73. How to install:
  74. ---------------
  75.  
  76. It`s simple. Just copy BlitzBlank and BlitzBlank.info in your SYS:WbStartup
  77. drawer and the module-directory somewhere you like.
  78.  
  79. In this module-directory the BlitzBlank module-config-file
  80. "BB.Modules.config" will be automatically created.
  81.  
  82. BlitzBlank will then be started automatically at bootup.
  83.  
  84. Currently, BlitzBlank can only be started from WB.
  85.  
  86.  
  87. How to use:
  88. -----------
  89.  
  90. The first time you start BlitzBlank it will popup it`s window immediatly.
  91. You should change this after you made your configuration.
  92.  
  93. First, choose the correct path to the module-directory.
  94.  
  95. If you close BlitzBlank`s window, your changes will be remembered by
  96. BlitzBlank as long as it is not terminated.
  97. If you wish to make the changes permanent, click on the "Save"-button.
  98.  
  99. You can move through the different string-gadgets (text-fields) by pressing
  100. <TAB> and <SHIFT-TAB>.
  101.  
  102. All gadgets can be reached/used with the underlined key in the gadget`s
  103. label.
  104.  
  105. Because BlitzBlank is a commodity, you can also popup/close it`s window and
  106. terminate it with the System-Commodity "Exchange".
  107.  
  108. After you have configured a module, you HAVE to close the module`s
  109. config-window to make changes active.
  110.  
  111.  
  112. The GUI and its gadgets:
  113. ------------------------
  114.  
  115. Screen (key s/S):
  116. This pops up the Screenmoderequester where you choose your
  117. favourite screenmode and number of colors. Please note that all modules
  118. use the chosen screenmode but not all modules will use the chosen
  119. number of colors.
  120.  
  121. Test (key t/T):
  122. This lets you test the chosen module.
  123.  
  124. Config (key c/C):
  125. This calls the chosen module`s config-window.
  126.  
  127. Info (key i/I):
  128. This pops up a window with information about the chosen module.
  129.  
  130. Hide (key h/H/ESC):
  131. This closes BlitzBlank`s window.
  132.  
  133. Save (key s/S):
  134. This saves BlitzBlank`s current settings.
  135.  
  136. About (key a/A):
  137. This displays information about BlitzBlank.
  138.  
  139. Quit (key q/Q):
  140. This quits BlitzBlank.
  141.  
  142. Modules (key m/M):
  143. In this list you choose your module. Doubleclick on an entry calls
  144. the module`s config-window.
  145.  
  146. ModPri (key d/D):
  147. With this slider you choose the module`s task-priority.
  148.  
  149. Blankkey (key b/B):
  150. In this field you type in the key that should blank immediatly.
  151.  
  152. Path (key p/P):
  153. In this field you type in the path to the modules. You can also click
  154. on the drawer-gadget left from the field to get a filerequester. Or
  155. you press <HELP> while the field is activated.
  156.  
  157. Popup at startuptime (key u/U):
  158. Here you choose wether BlitzBlank should popup its window automatically
  159. at start.
  160.  
  161. Blank Mouse (key l/L):
  162. Here you choose whether your mousepointer should be blanked at a keypress
  163. and/or after a selectable amount of seconds.
  164.  
  165. Time (key e/E):
  166. In this field you type in the amount of seconds till the mousepointer
  167. should be blanked.
  168.  
  169. Popkey (key k/K):
  170. In this field you type in the key that should pop up BlitzBlank`s window.
  171.  
  172. Timeout (key o/O):
  173. In this field you type the number of seconds till BlitzBlank should
  174. activate a blankmodule. A number of 0 means that BlitzBlank will never
  175. blank.
  176.  
  177.  
  178.  
  179. How to program modules:
  180. -----------------------
  181.  
  182. Please refer to the Programmers.doc.
  183.  
  184.  
  185. Troubleshooting:
  186. ----------------
  187.  
  188. If a module seems not to work, then a lack of memory might be the cause,
  189. making it impossible for the module to open it's screen.
  190.  
  191. If BlitzBlank displays a requester telling you, that a module is not
  192. working, then maybe the module isn`t present any more or is damaged.
  193.  
  194. If you`re using XPK-XFH and you`ve problems with the saving of the
  195. module-configurations then get yourself the newest XPK-package
  196. (thanks to Brian Larson for telling me this)
  197.  
  198.  
  199. Bugs and suggestions:
  200. ---------------------
  201.  
  202. If you find any bugs or if you have any suggestions then please let me
  203. know. Tell me your EXACT configuration and the EXACT circumstances
  204. where you found the bug.
  205.  
  206.  
  207. The author:
  208. -----------
  209. Thomas Boerkel
  210. Gartenstrasse 16
  211. D-76761 Ruelzheim
  212. Germany
  213.  
  214. Mailbox:  Amiga Inside II, 07272/76611
  215. (Magicname "BLITZBLANK" for frequests)
  216.  
  217. FidoNet:  Thomas Boerkel, 2:2476/506.11
  218. AmyNet:   Thomas Boerkel, 39:172/302.0
  219. LifeNet:  Thomas Boerkel, 77:7700/11.11
  220. Usenet:   Thomas.Boerkel@mil.ka.sub.org
  221. RallyBox: Tom
  222.  
  223.  
  224. Thanks go to (in alphabetical order):
  225. -------------------------------------
  226. - Acid Software for the powerful BlitzBasic 2.
  227. - Andre Bergmann for betatesting, advice and the pre-V39-busypointer.
  228. - Wolfgang Boerkel for the Pyro-algorithm.
  229. - Commodore for the wonderful Amiga and it`s mighty OS.
  230. - Juergen Denner for betatesting, advice and the Lines-algorithm.
  231. - Michael Eberle for betatesting.
  232. - Bernd Ernesti for betatesting and ideas.
  233. - Stefan Scholl for betatesting and the tests on Picasso II.
  234. - Mathias Supp for betatesting and ideas.
  235. - Michael Weber for betatesting, ideas and the Aquarium-graphics.
  236. - Alexander Wiggert for betatesting, ideas, advice, correction-read of the
  237.   english docs and for pushing me forward.
  238.  
  239.