				+----------------------------------------------+
				|          Wallpaper Randomizer v. 1.2         |
				| Copyright  1997-1999. All Rights Reserved.  |
				|            Written by Mike Olson             |
				+----------------------------------------------+

----------------
About Randomizer
----------------
Randomizer is a program that will select and display a new image as your
wallpaper at periodic intervals.  Randomizer puts an icon in your notification
area to let you know that it's running, and to let you access a few menu items.
Currently, JPEG (JFIF), GIF, non-interlaced PNG, and Windows BMP files are
supported.  Non-bitmap files get converted to a bitmap called "random.bmp" and
placed in your Windows directory, so if you already use an image file called
"random.bmp" in your Windows directory, I suggest renaming, moving, or copying
it before it gets overwritten by this program.

------------
Installation
------------
Just unzip randomizer.zip into ints own directory.
To uninstall, just delete the directory and all of its files.

You will definitely want to customize the file "images.txt" and perhaps make
a few shortcuts or icons or something.

---------------------
Contacting the Author
---------------------
If you think this program is great and you want to stroke my ego, email me:
mike.olson@aureate.com
												   v v v
If you find a bug, email me and I'll squish it.  >8------   ( SPLAT! )
												   ^ ^ ^
----------
Legal Crap
----------
This program is mine, not yours, but you can use it all you want for free.
Don't sell this program; it's free.
Distribute it as much as you like.
Don't modify the distribution in any way.
This program causes death, unkind acts by the IRS, eternal damnation, etc.
You were warned, but you used it anyway!
I am responsible for nothing.

The Graphics Interchange Format is the Copyright property of CompuServe
Incorporated. GIF(sm) is a Service Mark property of CompuServe Incorporated.

--------------------
Command Line Options
--------------------
Usage: randomizer [list file] [delay] [o|n]

[list file] - The name of a file containing filenames of images - see below for
			  the file format specification.  This file is re-read before every
			  wallpaper change, unless the "no repeat" option is selected (see
			  the [o|n] option below), in which case it is re-read after all
			  images have been displayed.
			  default: images.txt

[delay]     - The delay (in minutes) between automatic wallpaper changes.  Using
			  a value of zero disables automatic wallpaper changes.
			  default: 60 minutes

[o|n]       - If this option begins with an o (upper or lower case), then
			  images will be displayed in the order they appear in the image
			  list, instead of being displayed in random order.  Once the end of
			  the list has been reached, the program will start at the
			  beginnning of the list again.
			  If this option begins with an n (upper or lower case), then
			  images will be displayed randomly, but will not repeat until all
			  of the images in the list file have been displayed.
			  default: neither (random order with repeats)

----------
Menu Items
----------
You can access a popup menu by right-clicking the randomizer icon.  You can
select from following menu items:

Automatic Wallpaper Changes - Enables/disables automatic wallpaper changes
							  (only appears if the delay option is not 0)
Change Wallpaper			- Selects a new image for your desktop wallpaper
							  and resets the time left until the next automatic
							  wallpaper change
Reload Image                - Reloads the current image
Open Image                  - Opens the image in its default viewer
Reinforce This Image        - Appends the current image file to the end of the
                              file list, thus causing it to be selected more
							  often.
Never Show Thie Image       - Removes all instances of the current file name
                              from the image file, so it won't appear again.
Cancel           			- Do nothing and dismiss the menu
Quit             			- Self explanatory

Double-left-clicking the randomizer icon is the same as selecting "Change
Wallpaper" from the menu.

----------------
System Tray Icon
----------------
You can change the icon that is placed in your system tray by placing an icon
called "randomizer.ico" in the working directory of the program.  If no such
file exists, randomizer will use a default icon.  Randomizer comes with an
admittedly lame icon for you to use.

----------
About JPEG
----------
Sometimes randomizer will die if it encounters a JPEG that it can't decode.  In
that case, you can see what file it was trying to decode by looking in the file
"last-decode.txt," which is created in the program's working directory.  You
should then remove that file from the image list, so randomizer won't die again.

----------------------------
Features for Future Versions
----------------------------
1. Weighting of files, so that you don't have to repeat list entries to see your
   favorite images more often.
2. No limit on the number of images (except for virtual memory limits, but
   that's absurdly large).

-----------------------------
Format of the Image File List
-----------------------------
Each line should contain the filename of a valid image file that you want to
use as wallpaper.

You may use fully-qualified pathnames; relative pathnames also work.  Any filename
that isn't qualified in some manner (i.e. contains no backslashes) is assumed to
reside in the main windows directory (e.g. c:\windows), NOT the current directory.

Lines beginning with whitespace (including blank lines) are ignored.

Lines beginning with # are ignored.

-----------------------
Example image list file
-----------------------
# this is a comment
 so is this because the line began with a space (tabs work the same way)
# blank lines are ignored, too!

# this is a really cluttered example :(
# but your file can look much nicer! :)

# this is a fully-qualified filename
c:\mike\make\piles\of\money\from\freeware-not.bmp

# this isn't, so it's assumed to be in the main windows directory
# (e.g. c:\windows, or c:\winnt, or i:\installed\windows\in\here\)
a-really-fast-car.bmp

# jpeg files are also supported
c:\mike\save\disk\space\with.jpg

# you can use GIF and non-interlaced PNG files also
c:\pics\of\someone.gif
c:\some.png

# you aren't required to have an extension on your files
# but the randomizer assumes .bmp if the extension isn't recognized
this_really_is_a_bitmap_even_though_it_has_a_funky_extension.funky
sometimes_bitmap_files_have_the_extension.dib

# but you still have to specify .bmp if that's what your file is named (it
# isn't assumed).
# i.e. the next line is NOT the same as smiley-face.bmp
smiley-face

# even cooler, long filenames are fully supported
c:\pics\stephanie seymour\wow wow wow.bmp
# is a valid file even though the name contains spaces (it's still okay!)

# ... which means you can use the .jpeg extension, too
c:\mike\save disk space\with.jpeg

# if you repeat a file, it will have a greater chance of being
# selected randomly (if you are using random selection)
# i.e. list your favorite files more than once and you'll see them more often!
c:\pics\stephanie seymour\wow wow wow.bmp
c:\pics\stephanie seymour\wow wow wow.bmp
c:\pics\stephanie seymour\wow wow wow.bmp
# means i'll be seeing a lot of stephanie seymour :)

# the program will select an image randomly or in the order that
# they appear in this file, depending upon the command-line options
# (see the command line options section above)

# Lastly, because I'm lazy with this program, there's a hard-coded limit
# of 16384 on the number of images that can be in a list file.
# If that's really a problem, email me and I'll increase the limit just for you!
# "640 K ought to be enough for anybody!" - famous wealthy guy

