Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
glslideshow(6)		      XScreenSaver manual		glslideshow(6)

NAME
       glslideshow - slideshow of images using smooth zooming and fades

SYNOPSIS
       glslideshow  [--display	host:display.screen] [--visual visual] [--win-
       dow] [--root] [--window-id number] [--duration  seconds]	 [--zoom  per-
       cent]  [--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  xscreen-
       saver-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  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.

       XSCREENSAVER_WINDOW
	       The window ID to	use with --root.

SEE ALSO
       X(1),  xscreensaver-settings(1),	  xscreensaver-getimage(6),   xscreen-
       saver(1), carousel(6) photopile(6)

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,  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		      6.09 (07-Jun-2024)		glslideshow(6)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=glslideshow&sektion=6&manpath=FreeBSD+Ports+14.3.quarterly>

home | help