RLE-FB(1V)

NAME
rle-fb - restore run-length encoded image onto a frame buffer

SYNOPSIS
rle-fb [ -Ov ] [ -b { rgbBG } ] [ -p x y ] [ file.rle ]

DESCRIPTION
Rle-fb restores an Alpha_1 standard format Run-Length Encoded (RLE) file (saved with fb-rle(1V) or a similar program) to a frame buffer device or a file. If file.rle is not specified, the standard input is read. By default, the device /dev/ik0l is used to display the decoded image. This may be changed by setting the environment variable FB_FILE to the name of another device or file and exporting it before execution of rle-fb. Rle-fb determines the type and size of the saved file (color or B&W) and acts accordingly.

-v  Provides a verbose description of the parameters of the saved image on the standard error output.

-O  Restores the image data in overlay mode. Only areas of the original image which were not the background color are restored. The rest of the image already in the frame buffer is undisturbed. Note that this mode uses twice as many DMAs to the frame buffer as the normal mode, as the previous image must be read back into the host.

-bx If the image is not being restored in overlay mode, the background is normally set to the value recorded in the RLE file. This option permits the user to specify an alternate background color from a limited set of colors. The character x can be any of r (red), g (green), b (blue), B (black), or G (18% grey).

-px y
    Reposition the image. The original upper left corner is positioned at (x, y) before restoring the image. Warning: a saved image should not be repositioned so that any saved data wraps around the X borders. If the image was originally saved in LORES (512x512x24) mode, and it is positioned beyond the limits of low resolution memory, it will be written to HIRES (1024x1024x24) memory.

file.rle
    Name of file to restore. The file must be in Alpha_1 RLE format.

EXAMPLE
    $ FB_FILE=/dev/ik1l export FB_FILE
    $ rle-fb -O tank.rle

FILES
/vld/lib/librle.a
/vld/lib/libfb.a

SEE ALSO
fb-rle(1V).

AUTHORS
Gary S. Moss, BRL-VLD
Michael John Muuss, BRL-SECAD