home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR4 / PLANT120.ZIP / PLANT.DOC < prev    next >
Text File  |  1993-10-05  |  8KB  |  183 lines
  1.  
  2.                                   PLANT v1.20
  3.                   BMP, SCR, & WAV Swapping Utility for Windows
  4.  
  5.                         Copyright (c) 1993 Terry Matula
  6.                             Released October 5, 1993
  7.  
  8.  
  9.    Description
  10.    ===========
  11.    PLANT is a DOS application that will swap wallpaper, screen saver,  and/or
  12.    Windows system sounds.  All BMPs, SCRs, and WAVs are stored in  compressed
  13.    archives (PKZip format).   PLANT selects new files  directly from the  ar-
  14.    chives, decompresses them, gives them a standard name, and places them in
  15.    your Windows subdirectory.
  16.  
  17.    The name PLANT comes from the nature of  the swapping.  PLANT, as a  verb,
  18.    can mean 'To place for the purpose of deception.'  This is exactly the na-
  19.    ture of the swapping done by this program.  For example, Windows could  be
  20.    set to always use the wallpaper  file 'wpaper.bmp'.  PLANT  could then be
  21.    used to change 'wpaper.bmp'  from image to image.   This swapping is  com-
  22.    pletely invisible to Windows.
  23.  
  24.    As you may know, there are several other very similar programs that  basi-
  25.    cally do the same thing.  I looked at many  of them, but did not find  one
  26.    that operated exactly the way I wanted it to.  So, I wrote my own.  Listed
  27.    below are some of the things that I think make PLANT unique.
  28.  
  29.      1. It will operate in DOS or Windows.
  30.      2. It doesn't mess with Windows' *.ini files.
  31.      3. It can swap screen savers.
  32.      4. It stores unused BMPs, SCRs, and WAVs in compressed archives.
  33.      5. It uses PKZIP, a proven fast and reliable compression utility.
  34.      6. It is easily setup with a simple configuration file.
  35.      7. It supports sequential and random swapping.
  36.      8. It is a small and efficient executable.
  37.      9. It is FREEWARE.
  38.  
  39.    Although PLANT is  a relatively simple  little program that  I'm sure  any
  40.    halfway decent programmer could write, I  would like to publicly thank  my
  41.    lone beta-tester, Dewayne McNair.  It's always helpful to have someone not
  42.    involved in the program writing to do the testing.  Thanks, Dewayne.
  43.  
  44.  
  45.  
  46.    Requirements
  47.    ============
  48.    PLANT should work  with any version  of Windows that  uses BMPs, SCRs,  or
  49.    WAVs.
  50.  
  51.    PKZIP and PKUNZIP  from PKWARE,  Inc are also  required.   PLANT has  been
  52.    tested only with version 2.04g, but should work with other versions  with-
  53.    out problems.  The entire PKZIP package can be found on many BBS's and In-
  54.    ternet file archive sites, or you can contact PKWARE directly:
  55.               PKWARE, Inc
  56.               9025 N. Deerwood Drive
  57.               Brown Deer, WI 53223
  58.  
  59.    Windows is a trademark  of Microsoft Corporation.   PKZIP and PKUNZIP  are
  60.    trademarks of PKWARE Inc.
  61.  
  62.  
  63.  
  64.    Setup
  65.    =====
  66.    1. Place PLANT.EXE and PLANT.CFG together into any directory on your path.
  67.       If you wish to  execute PLANT from Windows,  create a new program  item
  68.       for it.  Change the properties to use PLANT.PIF as the command line and
  69.       PLANT.ICO as the icon.  Also, you will probably wish to check the  'Run
  70.       Minimized' box to allow PLANT to run as an icon.
  71.  
  72.    2. Manually compress (zip) your wallpaper, screen savers, and sound  files
  73.       into separate archives.  These archives can have any name you wish and
  74.       can be placed anywhere in  your file system that  you wish.  Note  that
  75.       PLANT supports individual sound archives for each of the different sys-
  76.       tem sounds.  You could  have an archive of  WAVs just for BEEP  sounds,
  77.       another for STOP  sounds, one  for EXIT sounds,  and so  on.   However,
  78.       PLANT also allows any and  all of the system  sounds to share the  same
  79.       archive.  For  example, in my  system, I have  one archive  made up  of
  80.       longer WAVs that I use just for the START sound.  I have one other  ar-
  81.       chive made up  of shorter  WAVs that  I use  for all  the other  system
  82.       sounds.
  83.  
  84.    3. Edit PLANT.CFG to define the location of various things on your system,
  85.       and to set the planting options.   I have provided a sample  configura-
  86.       tion file with clear (I hope) documentation.
  87.  
  88.    4. Execute PLANT once to produce the  standard-named BMP, SCR, and/or  WAV
  89.       files.  From Windows Control Panel select these standard-named files as
  90.       your wallpaper, screen saver, and/or system sounds.
  91.  
  92.  
  93.  
  94.    Usage
  95.    =====
  96.    Execute PLANT anytime you wish  to swap BMPs, SCRs,  and WAVs.  You  could
  97.    execute PLANT from your AUTOEXEC.BAT file if you want the swapping to  oc-
  98.    cur at bootup.  Or, you may wish to  create a batch file to execute PLANT
  99.    each time  you start  windows.   If  you do  create  a batch  file  called
  100.    WIN.BAT, then you may need to  rename your \WINDOWS\WIN.COM file to  some-
  101.    thing like \WINDOWS\WINSTART.COM to  allow the batch  file to execute  in-
  102.    stead of the com file.
  103.  
  104.    Also, if you wish to suppress  all those PKZip messages from appearing  on
  105.    the screen, you can redirect PLANT's standard output to the NUL device.
  106.  
  107.    For example, here is how a simple WIN.BAT might look:
  108.         @echo off
  109.         plant > nul
  110.         winstart
  111.  
  112.    Another acceptable method for using PLANT is to create a program item  for
  113.    it using PLANT.PIF  and PLANT.ICO  and place  it in  your STARTUP  program
  114.    group.
  115.  
  116.  
  117.  
  118.    Copyright Notice
  119.    ================
  120.    PLANT is Copyright (c) 1993 by Terry Matula.  No part of PLANT may be cop-
  121.    ied in part or in whole, except  as provided in the License Agreement  be-
  122.    low.
  123.  
  124.  
  125.  
  126.    License Agreement
  127.    =================
  128.    PLANT is distributed as FREEWARE.   This means that the  copyright holder
  129.    reserves all rights except the following three which are granted to you at
  130.    no charge.
  131.  
  132.      1. You may use PLANT in its unaltered form.
  133.      2. You may make as many unaltered copies of PLANT as you wish.
  134.      3. You may distribute unaltered copies of PLANT.
  135.  
  136.    You are specifically  prohibited from editing,  modifying, or  in any  way
  137.    changing PLANT.  (PLANT refers to both the executable, PLANT.EXE, and  the
  138.    documentation, PLANT.DOC.)   You  are  also specifically  prohibited  from
  139.    charging, or requesting donations, for any copies that you may distribute.
  140.    Exceptions are for BBS's and commercial on-line systems that charge a mem-
  141.    bership or time charge, and other distribution schemes that charge a fixed
  142.    fee for  distribution media  and/or  shipping.   As  long as  no  specific
  143.    charges are made for this program, this is allowed.
  144.  
  145.    By using, copying, or distributing PLANT,  you are indicating your  agree-
  146.    ment to the above terms.   If you do not agree  with the above terms,  you
  147.    should delete PLANT immediately.
  148.  
  149.  
  150.  
  151.    Registration
  152.    ============
  153.    Because PLANT is FREEWARE, no registration is required.  However, I  would
  154.    appreciate hearing from you anyway.  If you have any comments, ideas, sug-
  155.    gestions, or bug reports, then please contact me.  Even if you really have
  156.    nothing to say, I would  still like to receive  a little note from  anyone
  157.    who uses PLANT.
  158.  
  159.         Terry Matula
  160.         21-G Aiken Village
  161.         Starkville, MS  39759
  162.         e-mail address:  matula@ee.msstate.edu
  163.  
  164.  
  165.  
  166.    WARRANTY and DISCLAIMER
  167.    =======================
  168.    Because the program is  distributed free of charge,  there is no  warranty
  169.    for the program.  The copyright holder provides the program "as is"  with-
  170.    out warranty of any kind, either expressed or implied, including, but  not
  171.    limited to, the implied  warranties of merchantability  and fitness for  a
  172.    particular purpose.  The entire risk as to the quality and performance  of
  173.    the program is with you.   Should the program prove defective, you  assume
  174.    the cost of all necessary servicing, repair or correction.
  175.  
  176.    In no event will the copyright holder be liable for damages, including any
  177.    general, special, incidental or consequential  damages arising out of  the
  178.    use or inability to use the program.   These damages include, but are not
  179.    limited to loss of  data or information,  data being rendered  inaccurate,
  180.    loss of profits, business  interruption, other pecuniary losses  sustained
  181.    by you or third parties, or a failure  of the program to operate with  any
  182.    other programs.
  183.