WWPlus 2.51 <ASP>
1992-1995 All rights reserved
                          _______
By Don Bradner       ____|__     |               (R)
Arcata Pet        --|       |    |-------------------
600 F Street        |   ____|__  |  Association of
Arcata, CA  95521   |  |       |_|  Shareware
                    |__|   o   |    Professionals
                  -----|   |   |---------------------
                       |___|___|    MEMBER
Compuserve: 76130,1007
America OnLine: DBirdMan
Internet: dbirdman@redshift.com
http://www.redshift.com/~arcatpet

The online help file is the primary documentation for WWPlus.  
This text document is meant primarily to get you started.

Contents of this file:

   I.  Program Description
  II.  Program Requirements
 III.  Installing WWPlus
  IV.  Getting Started
   V.  Files that make up WWPlus
  VI.  Troubleshooting
 VII.  UnInstalling WWPlus
VIII.  Obtaining wallpaper images
  IX.  Getting future upgrades
   X.  Registration and distribution
  XI.  ASP Ombudsman Statement

I. PROGRAM DESCRIPTION.

WWPlus is a program for organizing and displaying Windows 
wallpaper files. With this program you can easily maintain a 
collection of wallpapers, automatically change them at an interval you 
select, and use image formats (GIF, PCX, TGA, TIF, .ICO and .JPG) that 
would otherwise be unusable by Windows as wallpaper. GIF and PCX 
provide compression of 256-color images, and .JPG provides compression 
for 16-million color images, thus saving disk space.

There is a screen saver module that will turn your wallpaper files 
into a screen saver after a period of inactivity.  Extensive setup 
options, including password protection, are available both from the 
Windows Control Panel Desktop icon and from the main WWPlus screen.  
Sixteen transition effects are available.  Users may select a single 
effect or a menu of effects that will occur randomly.

WWPlus has editing features and file conversion routines built in, 
which allow you to change images to suit your wallpaper needs.  You 
can crop, resize, stretch, rotate, mirror, flip, sharpen, soften, and 
adjust brightness, contrast and gamma.

Wallpapers may be tiled (small images displayed in multiples to fill 
the entire screen) or not, individually determined.  Each non-tiled 
wallpaper may be precisely positioned anywhere on the screen, not just 
centered (the Windows default).  Non-tiled images may be resized 
on-the-fly to full screen or a user-set dimension.  A universal gamma 
correction option allows for display-time lightening or darkening of 
images.

Multiple sets of wallpapers called "queues" may be built, with easy 
changing of queues.  A wallpaper may appear in more than one queue.  
Some program configuration items are maintained with the queue, others 
are "Global."  Queues may be specified as command line options, and 
the .QUE extension may be associated with WWPlus to allow the program 
to start by running the queue from File Manager or Program Manager 
icons.

Full documentation is included in the form of a Windows Help file.  
When you desire help, press your F1 function key for context-sensitive 
help, or press the help key if you are in a file dialog box.

WWPlus contains functions which can read and right the .GIF format, 
which contains compression technology covered by U.S. Patent No. 
4,558,302, owned by the Unisys corporation.  The author of WWPlus has 
obtained a license from Unisys, and pays a royalty on each 
registration, to use this technology. The following statement is 
required by that license:

	"Use of this software is permitted only to the extent
	reasonably required to determine whether to purchase
	the software.

	"After payment is made, use of this software is limited
	to use on only a single personal computer or
	workstation which is not used as a server.  An
	additional payment is required for each use on
	another personal computer or workstation.

	"Only a single copy may be made of this software
	solely for backup or archival purposes.  The software
	may also be transferred to a single hard disk.

	"Any use of this software in violation of the above is
	not licensed.

	"For information concerning licensing the LZW
	compression and/or decompression capability, please
	contact:
		Unisys Corporation
		Welch Licensing Department - CISW19
		Township Line & Union Meeting Roads
		P.O. Box 500
		Blue Bell, Pennsylvania 19424"

II. Program requirements.

WWPlus requires an IBM compatible 386 or better, running 
Windows 3.1x, Windows 95, or Windows NT, with at least 8 megs 
of RAM and VGA or better graphics.  Recommended: 486DX with 12 
or more megs of RAM and accelerated graphics adapter.

Some operations require a mouse.

Graphics files can be quite large, particularly with true-color, so a 
large hard disk is recommended.  WWPlus will require under 2 
megs for program installation.

III. Installing WWPlus

If you obtained WWPlus by downloading it from a computer Bulletin 
Board (BBS) or another online source, one necessary file may not have 
been included.  You will need a file called VBRUN300.DLL, which is 
almost always available from any source that would have WWPlus.  On 
BBS systems the file will usually be called VBRUN300.ZIP or 
VBRUN3.ZIP.  If you obtained the program on disk, the file should be 
included.  If it is missing, contact the supplier of the program.  
Registered versions obtained from the author will always include 
VBRUN300.  If you are installing VBRUN300 separately, it MUST be put 
in the \Windows\System directory.

To install WWPlus, run the included setup program.  If the 
program is on a floppy disk, you can use File/Run in the 
Program Manager and type a:setup or b:setup, whichever drive is 
involved.  You can use the same technique to run setup from a 
directory on your hard drive by supplying the full path, such 
as c:\temp\setup.  Alternatively you can use File manager to 
find the files and double-click on SETUP.EXE.  Do not use any 
SETUP.EXE that is not in the same directory as the WWPlus files.

Windows 95 users can use the "Add/Remove Programs" item in the 
Control Panel to find and start SETUP.  Again make sure that 
the SETUP you are starting is in the directory where your 
WWPlus distribution files are located.

At the end of the setup operation you will be given the option of 
adding WWPlus to your Startup Group.  Doing so will cause the program 
to start whenever you start a Windows session.  This is the 
recommended procedure; you can always delete the icon from the group 
at a later time if you wish.

NOTE: Setup will not run if any other program is using VBRUN300.DLL or 
any other library file used by the program, including other versions 
of WWPlus.  An error message will be generated, and you must end all 
such applications before retrying the installation.  You may restart 
these programs after installation is completed - they will share the 
VBRUN module without problem.

IV.  Getting Started.

Double-click the WWPlus icon to start the program.  The first time 
that the program starts it will be a full program window. Click 
the "folder" icon at the left end of the icon bar, and then 
browse for image files to add to the wallpaper queue.  There 
will be normally be images in your Windows directory, and you 
may have others which you have obtained.  If the images are 
small ones which you would like to have "tiled," check that 
option in the dialog.  After you have selected OK in the 
dialog, you will see the files listed in the queue.  
Double-Click one and see it become your wallpaper.

In later sessions, once images have been added, the program will 
start as an icon which you may double-click at any time to 
show the main window.  If you have chosen the hidden icon 
option, the program will not be visible when started.  Simply 
start it a second time; the first instance will become visible 
and the second will end itself.

Take a moment to familiarize yourself with the program elements on 
screen.  If you press the F1 key, a help file will be displayed, and 
you may graphically choose different program elements to see an 
explanation of their function.

When you move your mouse pointer across the toolbar icons and some 
other screen elements a small "Tool Tip" will appear to give you 
a better idea about what the icon does.  You may turn these captions 
off when you no longer need them, via the Preferences menu.

There are a number of options for how an image may be 
displayed.  Look for these topics in the help file:
	Tiling.
	Resizing Wallpaper to fit Screen.
	Adjusting Wallapaper Placement.
	Gamma Adjustments.

You may perform a variety of editing functions on an image by 
selecting it in the Wallpaper Queue and then clicking the 
"Edit" button.  The first time you do this, press the F1 key 
when the editor is visible and browse through the help file for 
explanations of the editing functions.

You may set up a screen saver to use your wallpaper images.  
Choose "Screen Saver Setup" in the Screen Saver menu, or click 
the setup icon.  There will be three tabbed pages of entry, 
exit, and effect choices, with a test button to see what it is 
like.  Click the help button in this dialog for more 
information.

There are a number of items in the Wallpaper, Screen Saver, and 
Preferences menus that affect the way the program operates.

V.  FILES THAT MAKE UP WWPLUS.

The program files are compressed prior to setup.  They are listed here 
with their compressed and uncompressed names. The setup program only 
copies a file to your disk if it does not find the file already or if 
this file is newer.

References to the WWPlus directory refer to the directory selected at 
installation; default is C:\WWPLUS

Compressed      File Name        Type and where installed

WWPLUS.EX_     WWPLUS.EXE   Program, WWPlus directory
WWPSAVR.SC_    WWPSAVR.SCR  Screen Saver Bootstrap Windows directory
WWPLUS.HL_     WWPLUS.HLP   Help file WWPlus directory
SETUPWWP.EX_   SETUPWWP.EXE WWPlus Setup Windows directory
--             SETUP.EXE    Setup Program, not transferred
--             SETUP.LST    Used by Setup
IKCOL16.DL_    IKCOL16.DLL  Library File, Windows\System directory
IKENG16.DL_    IKENG16.DLL        Ditto
IKJPG16.DL_    IKJPG16.DLL        Ditto
IKDSP16.VB_    IKDSP16.VBX        Ditto
SETUPKIT.DL_   SETUPKIT.DLL       Ditto
VER.DL_        VER.DLL            Ditto
WWPLIBR.VB_    WWPLIBR.VBX        Ditto
CALL32.DL_     CALL32.DLL         Ditto
GAMMA.PC_      GAMMA.PCX    Gamma calibration target, WWPlus directory

--              WWP_REG.KEY       Registration key, WWPlus directory
***Note: WWP_REG.KEY included only with registered versions.

--	          README.TXT   This file WWPlus directory
HISTORY.TX_    HISTORY.TXT  version history   ditto
--             VENDINFO.DIZ program description for shareware vendors

VBRUN300.DL_   VBRUN300.DLL Library File, Windows\System directory 
***note:  VBRUN300.DLL may not be included if the program was obtained 
from an online source.  It will have to be obtained to run the program 
and the setup program.  From on-line sources, it is usually 
VBRUN300.ZIP or VBRUN3.ZIP.  If the program was obtained on disk then 
the file should be included; if not, contact the source of the disk.  
If the file is obtained separately, it must be installed in your 
Windows\System directory BEFORE you run setup.

FILES ALTERED BY WWPLUS:

CONTROL.INI  WWPlus will add a section called [ScreenSaver.WWPSaver].  
Global parameters for both the program and the screen saver module are 
stored here.

VI.  Troubleshooting.

If you receive a message which says something like "Unable to install 
VBRUN300.DL_" during the program install, it means that you have a 
version of WWPlus that originally included the VBRUN file but it is 
not present.  You can solve this two ways: copy VBRUN300.DLL to the 
directory where the rest of the distribution files are and rename it 
VBRUN300.DL_, or else use a text editor (such as Windows Notepad) to 
edit the file SETUP.LST.  Remove the listing for VBRUN300.DL_ and save 
the file.  The VBRUN file will still have to be located in your 
Windows\System directory, but the setup won't try to reinstall it.

If WWPlus has been working fine, but suddenly will not load, the queue 
file may have become corrupted.  Try starting WWPlus from the command 
line with a new queue selected (one that doesn't already exist).  
Choose Run from the Program Manager file menu, and type 
C:\WWPLUS\WWPLUS.EXE C:\WWPLUS\TEST1.QUE (if your wwplus directory has 
a different name, use that instead, and if the test1.que exists, use a 
different name).  If the program starts, try changing the queue to the 
one you were using before.  If it crashes at that point, the best 
solution is to delete that queue completely.  This will not 
remove the image files, just the index which you can manually 
rebuild.

A related problem can occur if a file has become corrupted and the 
Change Wallpaper at Startup preference is selected.  If that is the 
next file to be used, WWPlus may crash when trying to load a corrupt 
wallpaper.  The cure would be the same as shown above.

If you have an image that WWPlus will not display, it may be in a 
format that cannot be used.  There are some variations of .GIF and 
.PCX that are known to make problems for WWPlus.  There are many 
non-standard versions of JPEG that will cause problems.  If you can 
load them into another image editing program you may be able to save 
it in a usable format.

WWPlus expects image file names to match their formats. If you have a 
.BMP image but give it a .GIF name, the program will not be able to 
read it.

VII. Uninstalling WWPlus

The following information is provided if you would like to remove 
WWPlus from your computer.

If you have used WWPlus as a screen saver, the first thing to do is to 
change your Windows screen saver to another program or to "None."  
Open the Windows Control Panel in your Main Group, and open the 
Desktop item.  Look at the Screen Saver Name.  If WWPlus is the screen 
saver it will say "WWPSAVR."  Use the drop-down selection to pick 
another screen saver or (none).  Close the dialog.

Most of the files used by WWPlus are located in your WWPlus 
directory.  This will be C:\WWPLUS unless you chose another directory 
during installation.  Delete this directory using File Manager.  In 
your Windows directory will be a file named WWPSAVR.SCR, which is the 
screen saver startup.  Delete it.

In your Windows\System directory, delete WWPLIBR.VBX.  Five 
other files are installed to this directory: CALL32.DLL, 
IKCOL16.DLL, IKENG16.DLL, IKJPG16.DLL and IKDSP16.VBX.  These 
are files that may possibly be used by other programs.  If you 
delete them, make backup copies first so that they can be 
reinstalled if another program complains about their absence.

Make a backup copy of the file CONTROL.INI in your Windows directory.  
Open CONTROL.INI in NOTEPAD or another text-only editor.  Look for a 
section called [ScreenSaver.WWPSaver], which contains the global 
variables for WWPlus.  Delete the entire section and save the file.

Delete your WWPlus program group.  If WWPlus is set to start when you 
run Windows, open the Startup Group and delete the WWPlus icon.  Make 
sure that you have selected "Save Settings on Exit" in the Options 
menu, and close Windows.  WWPlus is now removed.

VIII. Obtaining wallpaper images.

Any image that can be displayed on your computer may be used as 
wallpaper.  If you regularly use Computer BBS systems or online 
sources such as Compuserve, America Online, or the internet, 
you will find a wealth of images that can be downloaded.  These images 
are usually in the .GIF or .JPG formats to reduce download time.

If you obtained this program on disk, there may be images included, 
usually in an \images directory.  A RIGHTS.TXT file may be included in 
this directory describing the user's rights to the images included.

The author is maintaining a small collection of his scans of his own 
photos and those of users where permission has been granted.  It is 
available by FTP from redshift.com/arcatpet/wwplus/images Files are in 
.JPG format.  Thumbnails are available at the website 
http://www.redshift.com/~arcatpet

IX.  Getting future Upgrades.

When you register WWPlus with the author, you will receive a copy of 
the latest version and a registration key that removes the startup 
screen.  That key file will work with future versions of the program, 
so no upgrade fee will be required.

Current versions of WWPlus can always be found on Compuserve in 
several forums, including WINAV, GRAPHSUP, PHOTOFORUM and EDRIVE.  
Current versions are also posted to America OnLine.  Use the keyword 
"Windows" and search the software library for "WWPlus."

The author maintains a current copy available for internet FTP. 
ftp://redshift.com/arcatpet/wwplus/wwplsxxx.zip where xxx is the version 
number.  If you find this address to be inaccurate in the future, 
E-Mail the author dbirdman@redshift.com or dbirdman@aol.com for a 
current address.  There is also a jump available from 
http://www.redshift.com/~arcatpet  

Current versions are also uploaded to two internet archival sites, 
CICA and SimTel.  Addresses respectively are 
ftp://ftp.cica.indiana.edu/pub/pc/win3/desktop and 
ftp://oak.oakland.edu/SimTel/win3/desktop.  These two sites have many 
mirror sites worldwide as well.

Registered users who do not have online access may get a disk copy 
from the author for a fee of $5 ($7 non-US).  Send a short note 
indicating your registered status and requesting the latest copy.  
Please use the same name under which you are registered.

X.  Registration and Distribution.

WWPlus is shareware.  Free use is extended to any user for a 
reasonable evaluation period;  typical idea of "reasonable" is 30 
days.  If use is continued, the program should be registered with the 
author.  Registration fee is $20.  California registrants please add 
$1.45 sales tax, and foreign registrants should include $1.00 for 
airmail shipping.  All funds should be drawn on a US Dollar account. A 
convenient form for registration is included in the Help 
file (and may be printed from there).  Until you register, there will 
be a startup screen asking you to register which you will have to 
respond to.  When you register, this annoyance will go away. 
Otherwise, this version is complete and un-crippled in any way.

As a registration incentive, the author will provide on request two 
free scanned images from your original prints or slides, when sent 
with the registration.

Commercial use:  WWPlus may be used commercially, as long as there is 
a registered copy for each computer/terminal that is using it.  
Bulk licensing is available.

You may freely distribute WWPlus as long as no fees are charged for 
the program, and all necessary files are included. If you are a 
registered user, do not distribute the file WWP_REG.KEY, which 
identifies you as the user (This identification shows up in the 
"About" box).

XI. ASP Ombudman Statement

This program is produced by a member of the Association of Shareware 
Professionals (ASP). ASP wants to make sure that the shareware principle 
works for you. If you are unable to resolve a shareware-related problem 
with an ASP member by contacting the member directly, ASP may be able to 
help. The ASP Ombudsman can help you resolve a dispute or problem with 
an ASP member, but does not provide technical support for members' 
products. Please write to the ASP Ombudsman at 545 Grover Road, 
Muskegon, MI 49442-9427 USA, FAX 616-788-2765 or send a CompuServe 
message via CompuServe Mail to ASP Ombudsman 70007,3536
