Name
fbanim — animate small images on framebuffer using hardware pan and zoom
Synopsis
fbanim [-irv ] [ -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 fps argument 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.
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, i.e., 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 compatibility 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.
