NAME

       glslideshow - slideshow of images using smooth zooming and fades

SYNOPSIS

       glslideshow  [--display  host:display.screen]  [--visual visual] [--window] [--root] [--window-id number]
       [--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-settings(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.

       --window-id number
               Draw on the specified 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.

       XSCREENSAVER_WINDOW
               The window ID to use with --root.

SEE ALSO

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

COPYRIGHT

       Copyright © 2003-2005 by Jamie Zawinski, based on an earlier version that was Copyright ©  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.