|gif-fb [-F frame buffer name] [-c] [-i image number] [-o] [-v] [-z] [GIF file name]|
Â gif-fb displays on a frame buffer the images described by a CompuServe GIF (Graphics Interchange Format) file.
-F frame buffer nameOutputs to the specified frame buffer instead of the one specified by the Â FB_FILE environment variable (or the default frame buffer, if Â FB_FILE 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.
Â -cUses 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.)
-i image numberDisplays just the specified image (starting counting with 1), rather than displaying all images as the GIF specification requires.
Â -o(â€śoverlayâ€ť)Skips the initial clearing of the frame buffer to the background color specified in the GIF file.
Â -v(â€śverboseâ€ť)Also prints information about the GIF images on the standard error output.
Â -z(â€ś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 nameSpecifies the GIF input file to be translated, rather than reading the file from the standard input.
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, Â gif-fb 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.
The following is a typical invocation:
$ â€‰gif-fb â€‰image.gif
â€śA Standard Defining a Mechanism for the Storage and Transmission of Raster-Based Graphics Informationâ€ť, June 15, 1987 (CompuServe Incorporated).
Error messages are intended to be self-explanatory.
Douglas A. Gwyn, BRL/VLD-VMB
This software is Copyright (c) 1989-2013 by the United States Government as represented by U.S. Army Research Laboratory.
Reports of bugs or problems should be submitted via electronic mail to <firstname.lastname@example.org>.