FBANIM(1)

NAME
fbanim - animate small images on framebuffer using hardware pan and zoom

SYNOPSIS
fbanim [-hirv] [-S screen squaresize] [-W screen width] [-N screen height] [-s file squaresize] [-w file width] [-n file height] [-p npasses] width nframes [fps]

DESCRIPTION
Fbanim assumes that the current framebuffer (determined by environment variable FB_FILE) contains a collection of small square images ``tiled'' together by pixtile(1). This permits a limited sequence of low resolution images to be viewed at various speeds, to create the sensation of motion, or to highlight the differences between the frames. The typical use of this program is to animate sequences of 64x64 or 128x128 tiles generated by animation studies. It can also be used to create ``blink comparisons'' between a small number of large images.

The width of each tile is specified by the width argument, and the number of tiles is specified by the nframes argument. The optional argument fps specifies the number of frames (tiles) per second to be displayed. 24 fps is the standard movie rate, 30 the standard video rate. Slower rates may also be used. The default is 8 frames/second.

By default, the framebuffer is assumed to be loaded with a 512x512 pixel image. Specifying the -h flag, changes the default to 1024x1024. Alternatively, the -SWN flags can be used in the normal way to specify the size of the screen (see brlcad(1)).

By default, the sequence of tiles is considered to be a circular (repeating) sequence, ie, the first tile immediately follows the last one. If this is not the case, the -r flag will cause the sequence to ``rock'' from beginning to end to beginning, which is sometimes more pleasing.

The -v flag will cause the frame number and center coordinates of each frame to be printed as they are passed to fb_window(), for debugging purposes.

By default, the fbanim program repeats for 100 passes. When creating demonstration scripts, it may be desirable to specify the number of passes through the animation. The -p npasses option is used to indicate this.

For compatability with old animation images which were generated by fourth-quadrant programs, where the first image starts in the upper left corner of the screen rather than the lower left corner, the -i flag is used to indicate this inverse order.

SEE ALSO
brlcad(1), pixtile(1), pix-fb(1), pix(5)

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