home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / utils / explosiv.zip / EXPLOSIV.DOC < prev   
Text File  |  1990-05-10  |  11KB  |  274 lines
  1.         EXPLOSIV.COM - GRAPHICS SCREEN SAVER - VERSION 1.22
  2.  
  3.  
  4.                                       Reidar Gresseth and
  5.                                       Chris Hook
  6.                                       Februray 20 1990
  7.  
  8.  
  9. Explosiv copyright (c) Reidar Gresseth & Chris Hook 1989, 1990.
  10. This product may be distributed freely to users. It may not be
  11. sold or packaged, either individually, or as part of any other
  12. product without the express written consent of the authors. Any
  13. financial remunerations may be paid to the authors. This product
  14. may not be changed or altered and then distributed without the
  15. express written consent of the authors.
  16.  
  17. DISCLAIMER: Explosiv is offered on an as-is-basis without any
  18. guarantee as to the correct functioning or fitness for specific
  19. purpose. The authors believe this program to work as described
  20. but you use the program entirely at your own risk. The authors
  21. will not be responsible for any hardware or software damage, loss
  22. of data, or incidental or consequential damage that may result
  23. from its use, whether or not such use is in accordance with
  24. the instructions.
  25.  
  26. Any enquiries regarding this program should be sent to :
  27.  
  28.         Reidar Gresseth
  29.         #207 - 2345 W. 5th Ave.
  30.         Vancouver, B.C. Canada
  31.         V6K 1S6
  32.  
  33. As this is shareware and not freeware, a payment of 5 dollars is expected if 
  34. you find Explosiv to be at all useful. This amount would also encourage us to 
  35. write improved versions of this program.
  36.  
  37.  
  38. Explosiv is a screen saving utility which prevents pixel burn-in on your
  39. computer video display. Rather than simply turning the screen off while 
  40. the computer is running, Explosiv displays an always moving fireworks show.
  41. As a benefit, you never need wonder as to whether your computer is turned
  42. on or off (a typical problem with simple screen blankers), and you may
  43. even find the fireworks display to be somewhat enjoyable. This, of course,
  44. is a matter of personal taste.
  45.  
  46.  
  47. NOTE : Some features included in version 1.22 that were unavailable
  48.        in version 1.2 are :
  49.  
  50.             - The maximum time until activation of EXPLOSIV.COM is
  51.           now 30 minutes (i.e., the maximum value for the "m<n>"
  52.           parameter).
  53.  
  54.             - There is now a "novid" option which prevents explosiv
  55.               from reseting the counter when a program is writing
  56.               to the screen.  This means that explosiv will NOT be 
  57.           affected by things such as resident clocks, etc..
  58.  
  59.             - A bug with newer versions of mouse.sys and
  60.           DOS 4.0x ansi.sys was fixed.  Now the order in which
  61.               explosiv is loaded in memory should be unimportant.
  62.  
  63.  
  64. FILES INCLUDED WITH THIS UTILITY :
  65.  
  66.         <file>      <bytes>    <purpose>
  67.       EXPLOSIV.COM   9192      the screen saver utility
  68.       EXPLOSIV.DOC   11385     this document 
  69.  
  70.  
  71. NOTE: This program will not become a memory resident screen saver until the 
  72.       m<n> command line option is invoked. Without this option set, Explosiv
  73.       will simply be an amusing, but temporary display of fireworks. It is
  74.       suggested that you try out Explosiv in non-memory resident mode first
  75.       so that you may see what configuration of Explosiv suits your tastes
  76.       best (this is accomplished by trying out the other command line options,
  77.       which are spelled out in detail below).
  78.  
  79.  
  80. USAGE : 
  81.  
  82. To invoke Explosiv, type the following in the DOS command line :
  83.  
  84. To initially run or install Explosiv
  85.  
  86.    C >  explosiv [<mode>] [c<n>] [d<n>] [e<n>] [m<n>] [p<n>] [novid]
  87.  
  88. To change characteristics of memory resident Explosiv
  89.  
  90.    C >  explosiv new [c<n>] [d<n>] [e<n>] [m<n>] 
  91.  
  92. To turn Explosiv on or off type
  93.  
  94.    C >  explosiv on|off
  95.  
  96. To get help, type:
  97.  
  98.    C >  explosiv ?         
  99.  
  100.  
  101. Explosiv runs on many different video display adapters including
  102.  
  103.     MDA, CGA, EGA, VGA, MCGA, Hercules graphics card and Hercules graphics plus.
  104.  
  105. Once memory resident, explosiv can be turned on immediately as a screen saver 
  106. by pressing Ctrl-Alt-Shift. However, this should not be done during input/output
  107. operations in order to prevent possible I/O errors (such as during modem
  108. operations or when checking disk access time, etc.). 
  109.  
  110. When Explosiv is invoked as a screen saver it will halt the currently running
  111. program until a key is pressed.  If this will be problematic then Explosiv can 
  112. be deactivated by pressing Ctrl-Alt-E ( E for end ) and activated again by 
  113. pressing Ctrl-Alt-B ( B for begin ).  This feature is perhaps most useful
  114. when using Hercules graphics cards as there is no foolproof method of
  115. distinguishing graphics mode from text mode.
  116.  
  117.  
  118. OPTIONS :
  119.  
  120. Explosiv can be used with the following options ( Note : Not all options
  121. can be used with all video cards ) 
  122.  
  123.     d<n>    specifies a delay factor. n must be an integer in the 
  124.             range ( 1 - 255 ) where the default is n = 1.
  125.             For example,
  126.  
  127.                     C> explosiv d255 
  128.  
  129.             for slowest possible output
  130.  
  131.     e<n>    specifies number of simultaneous explosions. n must be an 
  132.             integer in the range ( 1 - 15 ) where the default is n = 6.
  133.             For example,
  134.  
  135.                     C> explosiv e1
  136.  
  137.             for most possible explosions
  138.  
  139.     m<n>    specifies number of minutes of inactivity before Explosiv is 
  140.             invoked. n must be an integer in the range ( 1 - 30 ).  If
  141.             this parameter is not specified Explosiv will not become
  142.             resident.  For example,
  143.  
  144.                     C> explosiv m1
  145.  
  146.             becomes a 1 minute screen saver
  147.  
  148.     c<n>    specifies the colour to use for each explosion. n must
  149.             be an integer in the range ( 1- 15 ) where the default
  150.             is n = 15.  This switch will ONLY work with the 'mono' 
  151.             option.  For example,
  152.  
  153.                     C> explosiv mono c4
  154.  
  155.             displays red fireworks
  156.  
  157.     p<n>    specifies number of text pages to save in memory. n must be
  158.             an integer in the range ( 1 - 4 ).  Each additional page
  159.             to be saved adds 4000 bytes to the amount of memory needed 
  160.             to run Explosiv.  By default Explosiv saves one page in 
  161.             memory. THE DEFAULT SETTING HAS BEEN FOUND TO BE SUFFICIENT
  162.             UNDER ALMOST ALL APPLICATIONS TESTED THUS FAR.  This switch 
  163.             only works when used with the m<n> option and does not work
  164.             with the 'herc' option.  For example,
  165.  
  166.                C> explosiv cga p4 m1 
  167.  
  168.          saves all text pages in memory
  169.  
  170.  
  171.     on      Turn the first deactivated Explosiv found in memory on.
  172.  
  173.     off     Turn the first activated Explosiv found in memory off.
  174.  
  175.     new     Change any of the following options on Explosiv once it is
  176.             memory resident.  
  177.  
  178.     novid   This option causes explosiv to ignore other programs 
  179.         writing to the screen.  This option can not be changed with
  180.         the new command.
  181.  
  182.     <mode>  By default, Explosiv will detect which card is present
  183.             and will determine which <mode> option to use.  Specifying 
  184.             one of the following options forces Explosiv to run in the 
  185.             indicated mode. 
  186.  
  187.         mda     Use 25 by 80 text mode ( assume that the video card has no
  188.                 graphics ability ).  
  189.  
  190.         cga     Use 640 by 200 two color graphics ( video mode 6 ).
  191.  
  192.         herc    Use 720 by 348 two color graphics ( Hercules graphics mode ).
  193.  
  194.         mono    Use 640 by 350 two color graphics ( EGA\VGA's video mode 16 ).
  195.                 This mode will display all explosions in the same colour.
  196.  
  197.         vga     Use 640 by 350 sixteen colour graphics ( video mode 16 )
  198.                 regardless of video system present.  This mode will display 
  199.                 each explosion as a different color ( one of the fifteen
  200.                 colors available to VGA/EGA color systems ).
  201.  
  202.  
  203. NOTES :  
  204.  
  205.       - By default the hardware is tested to determine exactly which
  206.         graphics card is in use.  The <mode> switches should be used
  207.         with care.  However, if you are in doubt as to which
  208.         graphics card are available to you, type
  209.  
  210.              C > explosiv ?
  211.  
  212.         This will inform you as to what graphics card has been
  213.         found.  If Explosiv cannot correctly determine the video 
  214.         system then you must specify one of <mode> each time
  215.         you run the program.
  216.  
  217.       - CGA simulating utilities for Hercules cards will not affect 
  218.         Explosiv in detecting which graphics card is present, however, 
  219.         Explosiv cannot be invoked for Hercules cards until Video mode 7 
  220.         is restored.
  221.  
  222.       - The CGA/EGA/MCGA/VGA adaptors uses the same memory area to store 
  223.         text and graphics.  This is a problem when Explosiv is used as a 
  224.         screen saver where memory usage should be minimized.  Explosiv 
  225.         reserves enough memory when it becomes resident to save from 1 to 4 
  226.         text pages ( 25 by 80 characters ).  This adds 4K for each page 
  227.         included.
  228.  
  229.       - Care should be taken when running a graphics program on a Hercules
  230.         driver as Explosiv has no reliable means of determining what state
  231.         the Hercules card is in.  It is suggested that Explosiv be deactived
  232.         before starting the graphics program and activated again once the
  233.         program has completed. This can be done using batch files such as 
  234.         following
  235.         
  236.             C > copy con run.bat
  237.             echo off
  238.             explosiv off
  239.             <program> 
  240.             explosiv on
  241.             ^Z
  242.  
  243.       - The mda option blanks the screen without the fireworks display.
  244.         This is done by saving the screen in its own internal buffer and
  245.         filling the screen in with spaces.  There are two motivations
  246.         for blanking the screen this way.  First is safety, many screen
  247.         savers directly access the video controller's write-only ports
  248.         and this could lead to a damaged monitor ( particularly Hercules 
  249.         monitors ).  Second, less hardware dependence means that Explosiv 
  250.         can be used on a wide variety of monitors ( MDA, Hercules, CGA, 
  251.         EGA, VGA, etc. )  Explosiv will not invoke with this option if it
  252.         finds that the computer is in graphics mode.
  253.  
  254.       - Multiple versions of Explosiv can be installed in memory and 
  255.         run by using the 'on/off' feature of Explosiv.  This is possible
  256.         since 'explosiv on' only affects the first 'off' Explosiv TSR
  257.         and 'explosiv off' only affects the first 'on' Explosiv TSR.
  258.         To illustrate, if two versions of Explosiv are installed then
  259.         the first can be enabled by typing
  260.  
  261.             C > rem the first TSR must be disabled to access the second
  262.             C > explosiv off     ( turn off first TSR )
  263.             C > explosiv off     ( turn off second TSR )
  264.             C > explosiv on      ( turn on first TSR )
  265.  
  266.          and the second can by enabled by typing
  267.  
  268.             C > rem the first TSR must be enabled to access the second
  269.             C > explosiv on      ( turn on first TSR )
  270.             C > explosiv on      ( turn on second TSR )
  271.             C > explosiv off     ( turn off first TSR )
  272.  
  273.  
  274.