FBFADE()

NAME
fbfade - fade a frame buffer image in or out

SYNOPSIS
[ ] [ input image name ] [ input square size ] [ input width ]
    [ input height ] [ output square size ] [ output width ] [ output height ]
    [ [ ] output frame buffer name ]

DESCRIPTION
gradually displays an image on a frame buffer, one randomly chosen pixel at a time.

  Options

(``high resolution'')Assumes 1024 by 1024 pixels for default input image size
    instead of 512 by 512. Explicitly specified sizes override the default, and if actual input image size is smaller than requested, the actual size will be used. If output frame buffer size is not specified, the revised input size will be requested for output. If actual output frame buffer size is greater than requested, only the lower-left portion of the frame buffer will be used. Actual sizes depend on details of specific frame buffers.

*(pf-f input image name
    Inputs the image to be displayed from the specified frame buffer or pix(5) file, instead of using pure background (which fades out the image already on the output frame buffer).

*(pf-s input square size
    Specifies input image width and height.

*(pf-w input width
    Specifies input image width.

*(pf-n input height
    Specifies input image height.

*(pf-S output square size
    Specifies output frame buffer width and height.

*(pf-W output width
    Specifies output frame buffer width.

*(pf-N output height
    Specifies output frame buffer height.

*(pf-F output frame buffer name
    Outputs to the specified frame buffer instead of the one specified by the environment variable (or the default, if is not set). If this is the last option specified, the is optional.

CAVEAT
works best in conjunction with a frame buffer having very fast access to pixels.

EXAMPLE
The following shell script can be used to produce a slick ``slide show'':
    *(pffbclear
    for i in *.pix
    do    fbfade -f $i
        sleep 15
    done
    fbfade

SEE ALSO
libfb(3), pix(5).

DIAGNOSTICS
Error messages are intended to be self-explanatory.

AUTHORS
Douglas A. Gwyn, BRL/VLD-VMB
Gary S. Moss, BRL/VLD-VMB