home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / w3_image / papers!.arj / PAPERS!.TXT < prev   
Encoding:
Text File  |  1992-06-19  |  5.8 KB  |  172 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                  PAPERS! v1.00
  10.                      The Random Wallpaper selection program
  11.                                      
  12.                   Copyright (c) 1992, Paragon Consulting Group
  13.  
  14.  
  15.  
  16.  
  17.    DISCLAIMER:
  18.  
  19.       Every  possible  precaution has been taken to insure that  PAPERS!  will
  20.    operate  without causing harm to your computer, however, Paragon Consulting
  21.    Group  and  its  employees are not responsible for any damage  directly  or
  22.    indirectly  caused by this program, to the hardware, software or  emotional
  23.    condition of the user.
  24.  
  25.  
  26.    FREEWARE:
  27.  
  28.       With  that  out  of  the  way, on with the program  itself.  PAPERS!  is
  29.    FREEWARE!  This means that you may keep and distribute it with no  cost  to
  30.    you  or  the people/places you distribute it to. However, I would ask  that
  31.    when distributing the PAPERS! archive you include this document with it.
  32.  
  33.  
  34.    ABOUT:
  35.  
  36.       PAPERS!  is  a  DOS based program meant to be run just  before  invoking
  37.    Windows  3.x. When invoked, it will read its configuration file  (discussed
  38.    later), modify the WIN.INI file setting the Wallpaper to a randomly  chosen
  39.    Wallpaper file (from a list of your choice), and exit.
  40.  
  41.       I wrote PAPERS! because I have a small set of Wallpapers which I like to
  42.    use, but get tired of manually changing them every time I would like to see
  43.    something  different.  I  wanted something  that  would  cause  windows  to
  44.    randomly  select  a  Wallpaper from a list of my  choice.  I  decided  that
  45.    modifying the WIN.INI file just before starting Windows was the best way of
  46.    achieving this goal.
  47.  
  48.  
  49.    SETUP:
  50.  
  51.    Setup is relatively simple. You need three things:
  52.  
  53.       1) A DOS environment variable pointing to the path where you have
  54.          WIN.INI and PAPERS!.CFG.
  55.      
  56.       2) The PAPERS!.CFG file.
  57.      
  58.       3) PAPERS!.EXE
  59.      
  60.  
  61.  
  62. PAPERS v1.00 - Copyright (c) 1992, Paragon Consulting Group             Page: 2
  63.  
  64.  
  65.  
  66.    I will now discuss each of these requirements in turn:
  67.  
  68.  
  69.    ENVIRONMENT VARIABLE:
  70.  
  71.       In  order for PAPERS! to find the various resources it needs,  you  must
  72.    have  a  DOS  environment  variable called PAPERS! defined  before  running
  73.    PAPERS!. The easiest way to make this happen is to place the following line
  74.    in your AUTOEXEC.BAT:
  75.  
  76.    set PAPERS!=c:\windows
  77.  
  78.    Note  that  you  would set it to the path where you have your  WIN.INI  and
  79.    PAPERS!.CFG   file.  These  two  files  must  be  in  the  same   directory.  
  80.    Since the WIN.INI  file is  normally  kept  in the \WINDOWS directory, it's
  81.    easiest  to  copy the  PAPERS!.CFG  file  to  that  directory, setting  the
  82.    environment   variable  appropriately.  For  instance, if you  have Windows
  83.    installed in D:\WIN31 then you would place this line in  your AUTOEXEC.BAT:
  84.  
  85.    set PAPERS!=d:\win31
  86.  
  87.    and  copy PAPERS!.CFG there. Note that PAPERS!.EXE can reside anywhere, but
  88.    should be somewhere in your PATH for ease of use.
  89.  
  90.  
  91.    PAPERS!.CFG FILE:
  92.  
  93.       The PAPERS!.CFG file is a simple text file containing the full paths  to
  94.    (up  to  100) Wallpaper files. An example PAPERS!.CFG file might look  like
  95.    this:
  96.  
  97.    d:\win31\cars.bmp
  98.    d:\win31\chitz.bmp
  99.    d:\win31\egypt.bmp
  100.    d:\win31\party.bmp
  101.  
  102.       You may use any editor which creates straight ASCII files to create your
  103.    PAPERS!.CFG file. Blank lines are ignored, but other than that  the  format
  104.    is  rigid.  Each line MUST be the full path to a Wallpaper file. Note  that
  105.    PAPERS!  will  not complain if the line is bad, but Windows  will  when  it
  106.    tries to use it to find the Wallpaper file.
  107.  
  108.       Again,  make  sure  you place this file in the path  specified  by  your
  109.    PAPERS! environment variable.
  110.  
  111.  
  112.    PAPERS!.EXE FILE:
  113.  
  114.       This is the program which does the work. How does it work? Pretty simple
  115.    actually.  Upon  starting PAPERS!, the program looks for its  configuration
  116.    file, and if it finds it reads in up to 100 lines from it. Keeping track of
  117.    how many paths it read, PAPERS! then creates a random number in the range 0
  118.    to  PATHS_READ. It then uses this random number to grab the  nth  Wallpaper
  119.    path.  Next,  it  parses  the  WIN.INI file looking  for  the  'Wallpaper='
  120.    variable. If PAPERS! finds it, it will substitute the random Wallpaper path
  121.    for the current setting. It's that simple.
  122.  
  123.  
  124. PAPERS v1.00 - Copyright (c) 1992, Paragon Consulting Group             Page: 3
  125.  
  126.  
  127.       Since it would be irritating to start PAPERS! manually each time you ran
  128.    Windows,  I  created a batch file that looks like this (call  it  what  you
  129.    like):
  130.  
  131.    papers!
  132.    win %1 %2 %3 %4 %5 %6
  133.  
  134.       Now,  if  you  decide to call the batch file 'WIND.BAT',  when  you  ran
  135.    WIND.BAT,  papers  would  run first, changing the  Wallpaper  to  a  random
  136.    selection, then Windows would run and read the new Wallpaper path  from  the
  137.    WIN.INI file which PAPERS! just modified.
  138.  
  139.  
  140.    THERE'S ONE CATCH:
  141.  
  142.       PAPERS!  does  not  change  the TileWallPaper  setting,  so  it  remains
  143.    whatever  you have it set to. All the Wallpapers I use are GIF's which  are
  144.    the  same size as the desktop, so I always have TileWallPaper off. If there
  145.    is  interest  in  being able to change the TileWallPaper setting  based  on
  146.    which Wallpaper is selected, I will add it.
  147.  
  148.    THAT'S IT!:
  149.  
  150.       That's  all  there  to  it. I hope you get some enjoyment  out  of  this
  151.    program.  Please  report any bugs/additions to me at one of  the  following
  152.    places:
  153.  
  154.    Snail-Mail:
  155.       Ron Cox
  156.       C/O Paragon Consulting Group
  157.       4212 West Cactus Road STE 1110-229
  158.       Phoenix, AZ  85029
  159.       (602) 437-9566
  160.  
  161.    Electronic Mail:
  162.  
  163.       Ron Cox
  164.       Paragon BBS
  165.       (602) 938-8288
  166.  
  167.       Ron Cox
  168.       Chandler C Connection
  169.       (602) 759-7789
  170.  
  171.  
  172.