home *** CD-ROM | disk | FTP | other *** search
/ Desktop Works 1995 - 1996 / desktopworks1995-1996.iso / scrnsave / scrpeace / scrnpeac.doc < prev    next >
Text File  |  1996-01-01  |  20KB  |  421 lines
  1.                   Documentation for Screen Peace 1.2
  2.                          by Anthony Andersen
  3.                        Compuserve [72037,2474]
  4.  
  5.                       Program and documentation
  6.                     Copyright 1990 Anthony Andersen
  7.                         
  8.  
  9. [1.0 Introduction]
  10.  
  11.    Screen Peace is a screen saver for Microsoft Windows 3.0. "So what?", you
  12.    say, "I've seen lots of screen savers for Windows." Well... this one is 
  13.    different. Screen Peace by itself is not terribly flashy - it just
  14.    blanks the screen after a certain number of seconds, but it is extensible.
  15.    You can add additional screen savers just by putting more screen saver
  16.    files in the proper directory. If you have the Windows 3.0 SDK, the
  17.    Microsoft C 6.0 compiler and the Screen Peace saver kit, you can make your
  18.    own screen savers.
  19.  
  20.    Screen Peace screen savers are invoked in two ways: 
  21.       1. if you don't a) move the mouse or b) click a mouse button or 
  22.          c) hit a key during a period of time longer than the Saver Delay
  23.          time (default is 300 seconds).
  24.       2. if you move the mouse into the Saver Now Corner (default is the
  25.          upper left corner).
  26.  
  27.    See the configuration options (Section 4) for information on changing
  28.    these values.
  29.  
  30.    Screen Peace picks a saver extension randomly from the saver extensions
  31.    in the Saver Path directory.
  32.  
  33.    Screen Peace 1.2 may be freely distributed with the following three
  34.    conditions:
  35.       1. This file be distributed along with the SAVER.EXE and SAVERDLL.DLL
  36.          files.
  37.       2. No money may be charged for the Screen Peace program.
  38.       3. No more than $7 may be charged for the media it is shipped on.
  39.  
  40.    Screen Peace is CharityWare. Please see the note near the end of this
  41.    file about payment (don't worry, it's a VERY easy payment plan and you
  42.    can feel good about paying for this program). If you paid money to someone
  43.    other than me for a disk containing Screen Peace, you have NOT paid for
  44.    Screen Peace, but for the disk it came on.
  45.  
  46. [1.1 Screen Peace 1.1 additions]
  47.  
  48.    Screen Peace 1.1 will change the Wallpaper bitmap if you specify that it
  49.    should. It randomly picks a bitmap from the directory you specify as the
  50.    Bitmap Directory.
  51.  
  52.    Screen Peace 1.1 shows you which screen saver extensions are enabled. If
  53.    an extension is enabled, you will see a small circle ("degrees" mark - as
  54.    in temperature or portions of an angle) after the name of the saver in the
  55.    "Configure" list box in the Options dialog.
  56.  
  57. [1.2 Screen Peace 1.2 additions]
  58.  
  59.    Lots of bugs fixed!
  60.       1. Saver Now and Saver Never corners should now work properly in
  61.          all cases.
  62.       2. The problem with non-readable disks is fixed (if this happened to
  63.          you, you probably clicked on a floppy drive icon in the program
  64.          manager when there was no disk in the drive). This was a bad
  65.          bug and I apologize for releasing Screen Peace with it there. I
  66.          hope it didn't cause any major problems. The cause, in case you're
  67.          interested was a call to the C library time() function in a bad
  68.          place. Anyway, the DLL is about half its previous size.
  69.       3. The cursor not blanking (which only happened on certain video
  70.          boards) should be fixed. Let me know if you have any more problems
  71.          with this.
  72.  
  73.    Screen Peace now recognizes Windowed DOS boxes in 386 Enhanced mode and
  74.    allows you to choose not to blank the screen when one of the DOS boxes
  75.    is the active window. See the Advanced options in Section 4.2 below.
  76.  
  77.    Screen Peace now realizes a color table if you have a graphics adapter
  78.    with a 256 color driver. This should help several of the savers look 
  79.    better. In case you're interested, it realizes a table similar to the
  80.    Macintosh default color table for 256 color mode. This option can be
  81.    disabled. See the Advanced options Section in 4.2 below.
  82.  
  83.    The Saver Now and Saver Never corners are now 5x5 pixels instead of
  84.    a single pixel.
  85.  
  86.    Screen Peace now supports up to 80 saver extensions. (It also supported
  87.    this number in 1.1 but I neglected to mention it.)
  88.  
  89.    The Options dialog has changed its "look". If you have any suggestions
  90.    regarding the aesthetics of Screen Peace, please let me know.
  91.  
  92.    Even if you were using a previous version of Screen Peace, please read
  93.    this whole document as several things about Screen Peace have changed.
  94.  
  95. [2.0 What you need to run Screen Peace]
  96.  
  97.    1. Microsoft Windows 3.0.
  98.    2. Screen Peace. (you need both SAVER.EXE and SAVERDLL.DLL)
  99.    3. Screen Peace saver extensions. (OPTIONAL - They have a .SPX extension)
  100.  
  101. [3.0 How to run and/or install Screen Peace]
  102.  
  103.    NOTE: All directions below assume that you have a mouse or other pointing
  104.          device. If this is not so, see your Windows manual for the
  105.          appropiate keyboard equivalents.
  106.  
  107.    3.0.0 If you already know how to run Windows applications you can 
  108.       probably skip to the next section.
  109.  
  110.    3.1 Copy SAVER.EXE and SAVERDLL.DLL into your Windows directory
  111.       or another directory on your path. If you don't want to put
  112.       Screen Peace on your path, you will need to include the path
  113.       to SAVER.EXE in each of the following directions. I recommend
  114.       putting Screen Peace in your Windows directory if you are new
  115.       to Windows, it's the easiest way to get things running.
  116.  
  117.    3.2 Do one of the following:
  118.  
  119.         A. (Not a very good choice) Select Run from the Program Manager File
  120.            menu, type SAVER.EXE in the edit field, and click the OK button.
  121.            If you choose this method, you must repeat this every time you
  122.            want to run Screen Peace.
  123.  
  124.         B. (A better choice) Click on one of the program groups in the
  125.            Program Manager and Select New from the Program Manager File
  126.            menu. Make sure the Program Item radio button is checked and
  127.            click the OK button. Type anything in the description edit field
  128.            and type SAVER.EXE in the Command Line edit field. Then click 
  129.            the OK button. Now to run Screen Peace, you only need to double 
  130.            click the Screen Peace icon.
  131.  
  132.         C. (An even better choice) Insert SAVER.EXE in your WIN.INI file on
  133.            either the "load=" or the "run=" line.
  134.  
  135.            example:
  136.                load=SAVER.EXE 
  137.                         or
  138.                run=SAVER.EXE
  139.  
  140.            Just make sure to separate the file names on the line by a space.
  141.            This will load Screen Peace each time you run Windows. By the 
  142.            way, SYSEDIT.EXE is a good program to use for editing the Windows
  143.            system files.
  144.  
  145.            NOTE: This procedure alone will not run Screen Peace until
  146.                  you restart Windows.
  147.  
  148.         D. (The best choice) Do BOTH B. and C.
  149.  
  150.    3.3 Copy any screen saver extensions you may have into a directory named
  151.       C:\SAVER. If you don't want to use the name C:\SAVER, you can change
  152.       the name (referred to as the Saver Path). See the Configuration
  153.       instructions below.
  154.  
  155. [4.0 How to Configure Screen Peace]
  156.  
  157.    4.1 Edit the WIN.INI file - This is the most difficult way to configure
  158.       Screen Peace. I recommend using the Menu and Dialog method described
  159.       in Section 4.2. Screen Peace knows about the following entries in the
  160.       WIN.INI file. Find or create something that looks like this:
  161.  
  162.           [Screen Peace]
  163.           Saver Now Pos=A
  164.           Saver Never Pos=D
  165.           Saver Delay=300
  166.           Saver Path=C:\SAVER
  167.           Saver Enabled=y
  168.           Bmp Change Enab=n
  169.           Bitmap Path=\windows
  170.           Dos Active Disab=n
  171.           Realize Colors=y
  172.  
  173.       Each of the values in the above example is set to the default value.
  174.  
  175.       The "Saver Now Pos" entry tells where the Saver Now Corner is located.
  176.       The "Saver Never Pos" entry tells where the Saver Never Corner is
  177.       located. For these entries:
  178.  
  179.           A = Upper Left
  180.           B = Upper Right
  181.           C = Lower Left
  182.