======================================================================
iSlideshow Screensaver
by: Eron Steger                                      December 25, 2005
http://www.cs.toronto.edu/~esteger/islideshow/
======================================================================

This slideshow screensaver transitions between images using the 
"Ken Burns Effect", slowly zooming and fading between images.

This is a preliminary version of the program, and may not work
well on some systems.

This code is licenced under the GNU GPL Version 2.
See "gpl.txt" for more information.

----------------------------------------------------------------------

Features:
- Zoom and fades between images from multiple directories
- Handles JPEGs, PNGs, TIFs, BMPs, and GIF files
- Stretches images to fit the screen if resolution is close
- Handle very high resolution images
- Works on multiple monitors

----------------------------------------------------------------------

To install, copy the .scr file to your windows system directory.
For Windows 9x and Me, this will likely be C:\windows\system.
For Windows 2000/xp, this will be likely be either
  c:\winnt\system32 or c:\Windows\system32

Once installed, go into the control panel display settings, and
choose the 'screen saver' tab.  From there, select the 'iSlideshow'
screen saver, and press the 'configure' button.

From here, you can add directories to search for images.  Directories
can be added either by clicking on 'add directory' or by dragging and
dropping them from Windows.

Once the images are properly setup, you should see images fading
between one another in the screensaver preview.  If checkerboards
are seen, then the program can't find any images it can load.

You can set the background color by using the sliders provided to
mix red, green, and blue as appropriate.

If you have multiple monitors and your video card supports hardware
accelerated OpenGL on both monitors, enabling this option will
display the screensaver in both monitors.  On some cards this may
not work, in which case you disable this option.

----------------------------------------------------------------------

Troubleshooting:

If the screen saver seems slow at some points, one of two things are
likely to be happening:

1) The images you are using are very large, and take a long time to
   load.  Ideally images should only get as large as your specified
   texture size, or else we have to resize images on the fly.

2) You don't have enough video ram for the specified texture settings.
   Try lowering the texture size or color depth.

On systems with dual monitors, you will need to have double the 
texture memory for any given setting.

If the screensaver seems fast when in the preview for the control
panel, but slow when shown fullscreen, OpenGL may not be setup.
Try some other OpenGL programs to see how fast they work.  If they
also are slow, try updating your display drivers.

----------------------------------------------------------------------

Support

There are still some bugs to be worked out.  Make sure you are running
the latest version of the slideshow before sending any bug reports.
The latest version of the program can be found at:

   http://www.cs.toronto.edu/~esteger/islideshow/

Send bug reports to: esteger@cs.toronto.edu
with the subject:    iSlideshow bug report

Please include the following information:
  1) The release date of the screensaver (at the top of this readme)
  2) Your video card, including:
     The manufacturer       (i.e. ATI, nVidia)
     The type               (i.e. Radeon 9600 Pro, Geforce 6800 Ultra)
     Amount of video RAM    (i.e. 128 MB)
  3) CPU type and speed     (i.e. Intel Pentium 4 2.6 Ghz)
  4) Amount of system ram   (i.e. 512 MB)
  5) Operating System       (i.e. Windows Me, Windows XP)
  6) Detailed description of the bug.

For the bug description, please describe:
  1) What happens         (i.e. black screen, frozen screensaver/computer)
  2) When it occurs       (i.e. screensaver start, end)
  3) How often it occurs  (i.e. randomly, always, for certain images)

----------------------------------------------------------------------

Todo:
- More automated support for lower-end video cards

Known Bugs:
- Doesn't work with with some types of GIFs.

----------------------------------------------------------------------

Uses code from the following:
Really Slick Screensavers, by Terry Welsh.
Corona, by Chad Austin.
libpng, zlib, gif-lib, IJG JPEG LIBRARY
Intel GLsdk library

