Provided by: xscreensaver-gl_5.15-2ubuntu1_i386 bug

NAME

       glslideshow - slideshow of images using smooth zooming and fades

SYNOPSIS

       glslideshow  [-display  host:display.screen] [-visual visual] [-window]
       [-root] [-duration  seconds]  [-zoom  percent]  [-pan  seconds]  [-fade
       seconds]  [-titles] [-letterbox | -clip] [-delay usecs] [-fps] [-debug]
       [-wireframe] [-cutoff int]

DESCRIPTION

       Loads a random sequence of images and smoothly scans and  zooms  around
       in each, fading from pan to pan.

       This  program  requires  a  good video card capable of supporting large
       textures.

       To specify the directory that images are loaded from, run xscreensaver-
       demo(1) and click on the "Advanced" tab.

OPTIONS

       -visual visual
               Specify  which  visual  to use.  Legal values are the name of a
               visual class, or the id number (decimal or hex) of  a  specific
               visual.

       -window Draw on a newly-created window.  This is the default.

       -root   Draw on the root window.

       -duration seconds
               How long each image will be displayed before loading a new one.
               Default 30 seconds.

       -pan seconds
               How long each pan-and-zoom should last.  Default 6 seconds.

               With the default settings of -pan 6 -duration  30,  each  image
               will  be displayed five times (30/6), and then a new image will
               be loaded.  If you want a new image to be loaded at each  fade,
               then set -pan and -duration to the same value.

       -fade seconds
               How long each cross-fade between images should last.  Default 2
               seconds.  If set to 0, then no cross-fading will be  done  (all
               transitions will be jump-cuts.)

               Note  that  fades are included in the pan time, so -fade cannot
               be larger than -pan.

       -zoom number
               Amount to zoom and pan as a percentage.  Default:  75,  meaning
               that  75% or more of each image will always be visible.  If set
               to 100%, then the images will always fill the  screen,  and  no
               panning  or  zooming  will  occur.  (Images will still smoothly
               fade from one to another if -fade is non-zero.)

       -titles Whether to print the file name of  the  current  image  in  the
               upper left corner.

       -letterbox
               In "letterbox" mode, when an image is not the same aspect ratio
               as the screen, black bars will  appear  at  the  top/bottom  or
               left/right  so  that the whole image can be displayed.  This is
               the default.

       -clip   In "clip" mode, when an image is not the same aspect  ratio  as
               the  screen,  we  will zoom in further until the image takes up
               the whole screen.  This is the opposite of -letterbox.

       -delay number
               Per-frame  delay,  in  microseconds.   Default:   20000   (0.02
               seconds.).

       -fps    Display the current frame rate, CPU load, and polygon count.

       -cutoff number
               If  the  frame  rate  we are achieving is lower than this, then
               panning, fading, and zooming will be disabled.  Default 5 FPS.

               The idea here is that if your machine can't maintain  a  decent
               frame rate, then it must not have fast 3D hardware, so we might
               as well behave in a simpler manner.  Set this to 0  to  disable
               this check.

       -debug  Prints debugging info to stderr.

       -wireframe
               Another debug mode.

ENVIRONMENT

       DISPLAY to get the default host and display number.

       XENVIRONMENT
               to  get  the  name of a resource file that overrides the global
               resources stored in the RESOURCE_MANAGER property.

SEE ALSO

       X(1), xscreensaver-demo(1), xscreensaver-getimage(1),  xscreensaver(1),
       carousel(6x) photopile(6x)

COPYRIGHT

       Copyright  (C) 2003-2005 by Jamie Zawinski, based on an earlier version
       that was Copyright (C) 2002 by Mike Oliphant.

       Permission to use, copy, modify, distribute, and sell this software and
       its  documentation  for  any  purpose  is  hereby  granted without fee,
       provided that the above copyright notice appear in all copies and  that
       both  that  copyright  notice  and  this  permission  notice  appear in
       supporting  documentation.   No  representations  are  made  about  the
       suitability  of  this software for any purpose.  It is provided "as is"
       without express or implied warranty.

AUTHOR

       Jamie Zawinski and Mike Oliphant.