GIF-FB(1)

NAME
gif-fb - display GIF file on frame buffer

SYNOPSIS
[ frame buffer name ] [ ] [ image number ] [ ] [ ] [ ] [ GIF file name ]

DESCRIPTION
displays on a frame buffer the images described by a CompuServe GIF (Graphics Interchange Format) file.

  Options

*(pf-F frame buffer name
    Outputs to the specified frame buffer instead of the one specified by the environment variable (or the default frame buffer, if is not set). The frame buffer size requested will be the same as the input GIF screen size. The actual size obtained depends on details of the specific frame buffer.

Uses all 8 bits per channel for color maps supplied in the GIF file,
    overriding the color resolution specified in the GIF file. (While technically a violation of the GIF ``standard'', apparently some GIF implementations assume this interpretation.)

*(pf-i image number
    Displays just the specified image (starting counting with 1), rather than displaying all images as the GIF specification requires.

(``overlay'')
    Skips the initial clearing of the frame buffer to the background color specified in the GIF file.

(``verbose'')
    Also prints information about the GIF images on the standard error output.

(``zoom'')
    Uses the zoom capability of the current framebuffer to make the image as large as possible on the screen while preserving a square aspect ratio to the pixels. This means that the zoom factor in X and Y will be equal to the smaller of the two possible zooms.

GIF file name
    Specifies the GIF input file to be translated, rather than reading the file from the standard input.

DISCUSSION
The GIF ``standard'' is far from an ideal specification for frame buffer images, but it has been widely accepted in the personal computer arena, and consequently there are a large number of images stored in GIF format on bulletin-board systems and other information services. Since most personal computer systems have GIF translators available for them, provides a means of converting most images from such systems into a form suitable for processing with other BRL-CAD utilities.

Notice that multiple images within a single GIF file can achieve animation effects.

EXAMPLE
The following is a typical invocation:
    $ *(pfgif-fb image.gif

SEE ALSO
``A Standard Defining a Mechanism for the Storage and Transmission of Raster-Based Graphics Information'', June 15, 1987 (CompuServe Incorporated).
libfb(3).

DIAGNOSTICS
Error messages are intended to be self-explanatory.

AUTHOR
Douglas A. Gwyn, BRL/VLD-VMB