dwww Home | Manual pages | Find package

glslideshow(6x)               XScreenSaver manual              glslideshow(6x)

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  sec-
       onds]  [-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  up-
               per 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  sec-
               onds.).

       -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  ©  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, pro-
       vided that the above copyright notice appear in  all  copies  and  that
       both  that  copyright  notice and this permission notice appear in sup-
       porting documentation.  No representations are made about the suitabil-
       ity  of  this software for any purpose.  It is provided "as is" without
       express or implied warranty.

AUTHOR
       Jamie Zawinski and Mike Oliphant.

X Version 11                  5.45 (08-Dec-2020)               glslideshow(6x)

Generated by dwww version 1.14 on Mon Feb 3 08:23:14 CET 2025.