FBFADE 1 BRL-CAD BRL-CAD
fbfade fade a frame buffer image in or out
`fbfade` -H -f input_image_name -s input_square_size -w input_width
-n input_height -S output_square_size -W output_width -N output_height
-F output_frame_buffer_name

## DESCRIPTION

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

### Options

-H

  (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.

-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).

-s input_square_size

  Specifies input image width and height.

-w input_width

  Specifies input image width.

-n input_height

  Specifies input image height.

-S output_square_size

  Specifies output frame buffer width and height.

-W output_width

  Specifies output frame buffer width.

-N output_height

  Specifies output frame buffer height.

-F output_frame_buffer_name

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

## CAVEAT

`fbfade` 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:

> fbclear

> 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

## COPYRIGHT

This software is Copyright (c) 1989-2024 by the United States Government as represented by U.S. Army Research Laboratory.

## BUG REPORTS

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org