XSlideShow(1) X Version 11 XSlideShow(1)
24-jan-94
NAME
xslideshow - Image viewer on the X Window System.
SYNOPSIS
xslideshow [-animate string] [-root] [-private] [-color int] [-full]
[-override] [-resize] [filelist]
DESCRIPTION
Xslideshow is an image processing and display program. It can display
an image on any workstation display running an X server. The features
of Xslideshow are the animation display image files.
ANIMATION
xslideshow accepts one of the following animation options.
slide Slide show.
fade Fade-in, Fade-out.
flush Flush.
monotone
Fade-in, Monotone, Color, Fade-out.
reverse Fade-in, Reverse-color, Reverse-color, Fade-out.
wipe Wipe-in, Wipe-out.
block Divides the image into small blocks, and shows the blocks
randomly.
mosaic Displays a detailed mosaic image.
coloranim
Randomizes color index table and sorts by specified sorting
algorithm.
coloranim2
Take out one color from the color index table, and put it.
Repeat for all colors.
shuffle Divides the image into blocks and displays each block randomly
on the screen. The correct image is displayed by exchanging
the blocks.
puzzle Same as shuffle, except the image is formatted by solving the
sequence of the blocks as in 15 block puzzle.
move The image is brought into view slowly from right to left.
- 1 - Formatted: December 22, 2025
XSlideShow(1) X Version 11 XSlideShow(1)
24-jan-94
OPTIONS
The following options affect the global operation of xslideshow. They
may be specified anywhere on the command line.
-animate string
Specifies animation mode with one of the following options:
slide, fade, reverse, wipe, block, mosaic, coloranim, shuffle,
puzzle, move.
-root Displays on the Root Window.
-private
Forces to use the private colormap. Without this option, the
colors are allocated shared colormap unless there are not
enough colors available.
-color integer
Specifies the maximum number of colors to use in the image.
This is a way to forcibly reduce the depth of an image.
-full Uses the entire screen to display images.
-override
Create the override_redirect window when -full option is
specified.
-resize Uses the image size to display images.
filelist
Specifies the list of files.
X RESOURCES
xslideshow understands the following resources
readJPEG (class Boolean)
Specify to read JPEG file. If False, xslideshow pass by JPEG
files. Default boolean is True.
showFileName (class Boolean)
Specify to show the file name. Default boolean is True.
fontName (class String)
Specify the font name. Default string is "vr-40"
color (class Integer)
Specify the color number showing pictures. Default value is
254 (colors).
intervalTime (class Time)
Specify the interval time switching pictures. Default value
- 2 - Formatted: December 22, 2025
XSlideShow(1) X Version 11 XSlideShow(1)
24-jan-94
is 5 (sec).
fileSelectionMode (class String)
Specify the file selection mode. (sequent, random) Default
string is "random".
animate (class String)
Specify the animation mode. (slide, fade, flush, monotone,
reverse, wipe, block, mosaic, coloranim, coloranim2, shuffle,
puzzle, move) Default string is "slide".
fadeSteps (class Integer)
Specify the fading steps of color intense(0 to 256). Default
value is 2.
fadeTicks (class Integer)
Specify the fading ticks. Change intense by
(1000000/fadeTicks) micro sec. Default value is 35.
wipeSteps (class Integer)
Specify the wiping steps. Default value is 2.
wipeTicks (class Integer)
Specify the wiping ticks. Wipe by (1000000/wipeTicks) micro
sec. Default value is 35.
moveSteps (class Integer)
Specify the moving factor. Default value is 2 (pixel).
moveTicks (class Integer)
Specify the moving ticks. Move by (1000000/moveTicks) micro
sec. Default value is 250.
blockSteps (class Integer)
Specify the block size. Default value is 8 (pixels).
monotoneSteps (class Integer)
Specify the monotone steps of color intense(0 to 256).
Default value is 2.
monotoneTicks (class Integer)
Specify the monotone ticks. Change intense by
(1000000/monotoneTicks) micro sec. Default value is 15.
flushCount (class Integer)
Specify the flushing count. Default value is 3.
flushSteps (class Integer)
Specify the flushing steps of color intense(0 to 256).
Default value is 2.
- 3 - Formatted: December 22, 2025
XSlideShow(1) X Version 11 XSlideShow(1)
24-jan-94
flushTicks (class Integer)
Specify the flushing ticks. Change intense by
(1000000/flushTicks) micro sec. Default value is 150.
reverseSteps (class Integer)
Specify the reversing steps of color intense(0 to 256).
Default value is 2.
reverseTicks (class Integer)
Specify the reversing ticks. Change intense by
(1000000/reverseTicks) micro sec. Default value is 15.
colorAnimSort (class String)
Specify the sorting algorithm. (bubble,shell,quick) Default
string is "quick".
colorAnimTicks (class Integer)
Specify the color animation ticks. Sort color map index by
(1000000/colorAnimTicks) micro sec. Default value is 10.
shuffleSort (class String)
Specify the sorting algorithm. (bubble,shell,quick) Default
string is "quick".
shuffleSteps (class Integer)
Specify the block size. Default value is 100 (100x100
pixels).
shuffleTicks (class Integer)
Specify the shuffle ticks. Sort block by
(1000000/shuffleTicks) micro sec. Default value is 10.
puzzleSteps (class Integer)
Specify the block size. Default value is 100 (100x100
pixels).
fileList (class String)
Specify the file list of GIF and JPEG.
HOW TO USE
With the xscreensaver (Created by Jamie Zawinski <jwz@lucid.com>,
List the GIF and JPEG file names in XSlideshow.
Set xscreensaver's resource XScreenSaver as below.
*colorPrograms:\
xslideshow -animate slide -root \n\
xslideshow -animate fade -root \n\
xslideshow -animate flush -root \n\
xslideshow -animate monotone -root \n\
- 4 - Formatted: December 22, 2025
XSlideShow(1) X Version 11 XSlideShow(1)
24-jan-94
xslideshow -animate reverse -root \n\
xslideshow -animate wipe -root \n\
xslideshow -animate block -root \n\
xslideshow -animate mosaic -root \n\
xslideshow -animate coloranim -root \n\
xslideshow -animate coloranim2 -root \n\
xslideshow -animate shuffle -root \n\
xslideshow -animate puzzle -root \n\
xslideshow -animate move -root \n
COPYRIGHT
See vroot.h, reduce.c, gif2gimage.c, jpg2gimage.c. The others
Copyright by Susumu Shiohara. Permission to use, copy, modify,
distribute, and sell this software and its documentation for any
purposes are hereby granted without fee, provided that the above
copyright notice appears in all copies and that both copyright and
this permission notices appear in supporting documentation. No
representations are made about the suitability of this software for
any purposes. It is provided "as is" without express or implied
warranty.
SEE ALSO
xv(1), xloadimage(1), xscreensaver(1)
AUTHOR
Susumu Shiohara (shiohara@io.tpp.epson.co.jp). Please let me know if
you find any bugs or make any improvements. Thanks to
(yamaoka@ga.sony.co.jp) for debug xslideshow. Thanks to
(Yasuhiro.Suzuki@EBay.Sun.COM) for create SYSV patches, and this
manual.
- 5 - Formatted: December 22, 2025
