fbanim — animate small images on framebuffer using hardware pan and zoom


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]


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.


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




This software is Copyright (c) 1989-2016 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 <>.