Perigee Slideshow

v1.1, last updated December 9 2003
(C) 2003 by Jeremy Stanley

Perigee Slideshow is a command line program that searches a directory for supported graphic files and displays them in a slideshow. It has the ability to search subdirectories, as well as to sort files by creation date, modification date, or path name. Alternatively, it will accept a prebuilt list of image files from a file or standard input.

DOWNLOAD

The latest version of this document can be found here.

RUNTIME CONTROLS

Next slide Page Down, Enter, Space, right arrow key, left mouse button, or mouse wheel down
Prev slide Page Up, left arrow key, right mouse button, or mouse wheel up
First slide Home
Last slide End
Toggle timer t
Exit Esc

Note that the auto-advance timer will automatically stop if you manually change slides. You can press 't' to start it up again.

COMMAND LINE USAGE

slideshow [options] picture_path

picture_path is either a directory or a text file containing a list of image files, with one image file per line.

Specify - for picture_path to read a list of files on stdin.

Options:
-width X Set screen width to X pixels (default 800)
-height Y Set screen height to Y pixels (default 600)
-window Run in a window (dimensions specified by -width and -height)
-name Display image filename
-advance X Automatically advance images every X seconds
-random Randomize picture order
-ready Show indicator (small green square) when next image is ready
-tran XXX Use transition effect between slides, where XXX is one of the following:
 
  • fade
  • checkers
  • blinds
  • uncover
  • random
The following options apply only when picture_path is a directory:
-recurse Recurse into subdirectories
-sort S Sort file list, where S is one of the following:
 
n+ Name ascending (a-z)
n- Name descending (z-a)
cd+ Create date ascending (oldest first)
cd- Create date descending (newest first)
md+ Modify date ascending (oldest first)
md- Modify date descending (newest first)

SUPPORTED IMAGE FORMATS

Perigee Slideshow uses the SDL_image library to load pictures. When searching directories, it looks for files matching these extensions (case insensitively):

COMPILING

Visual C++ 6.0 project files and a Makefile for UNIX-like systems are included. slideshow has been compiled and tested successfully using VC6++ on Windows 2000, and gcc 3.2 on Red Hat Linux.

SDL 1.2.5 and SDL_image 1.2.3 development libraries are required on both platforms.

A Win32 graphical front end is also provided in the ssfront subdirectory. I have no plans to create a graphical front end for any other platform, but you're more than welcome to do so if you want to.

LICENSE

This program is free software licensed under the terms of the GNU General Public License. As such, it comes with no warranty. See license.txt, enclosed in the source distribution, for details.

Note to The SCO Group:
Since you're opposed to the whole "free lunch" idea, I, as the copyright holder of this program, will graciously allow you to purchase a proprietary license for this program for the paltry sum of $699 per CPU. That way, you can be safe from the evils of the General Public License. Of course, you'll need to sign an NDA to see the terms of the license before you buy it. Oh, and you should be aware that this program uses libraries licensed under the GNU LGPL, and I'm not going to indemnify you against any potential IP violations in them.

CONTACT INFORMATION

http://www.xmission.com/~jstanley/mail.html