Play

What does it do

This program loads up a sequences of images and displays them. It uses classes from the Modular Renderer library.

It displays the bitmaps in a Windows window or XWindows window.

Its intended as a quick way of playing an animation constructed frame by frame, typically as the output of a raytracer.

The quality of display is constrained to that as implemented in the ViewerWin and ViewerXWin classes in the MR package.

Usage

  usage: play [-l] [-s] [-d delay] first last step fn.ext{,opt}
  flags: -l            loop
         -s            single step
         -d delay      extra delay in milliseconds between frames
         first         first frame
         last          one beyond last
         step          frame number step
         fn.ext{,opt}  input filename (with any format specific options)
                       ext's are used to deduce desired bitmap file formats
                       ... bitmap formats listed here
         opt's         bitmap format specific options

For example, to play cube0000.gif, cube0001.gif, .. cube0499.gif :-

  play 0 500 1 cube%04d.gif

In addition, the following keys are recognised :-

• - to go back one frame.
• s to enter single step mode.
• g to go (resume continual play mode).
• > to animate quicker (reduce interframe delay).
• < to animate slower (increase interframe delay).
• q, x or Esc to quit.
• 0..9 to jump to 0/10ths to 9/10ths of the way through the animation.

The package

This document, and the PLAY package are available from my home page at http://www.nyangau.org/.

The package contains this document and full source to the PLAY program. Also available from my site is the MR and GBM modules that this code uses.

The source code is highly portable C++ code.

The only UNIXes I've tested on are Linux and MacOSX. Other UNIXes probably need XOPTS changing in the makefile.

Copying

This program, including its source code, are public domain. Caveat Emptor.